번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
conflicts 연산
각 conflicts.* 연산이 받고 반환하는 정확한 필드입니다.
모든 op는 HTTP의 POST /v1/<op>이자 MCP 도구 loom_<op>입니다. 신원 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 지원하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, code.*와 tracker.*(각 플레인의 값을 유지함)를 제외한 모든 op에서 설치의 org가 채워지고, 일부 op에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 신원과 네임스페이스를 참고하세요. 연산 색인에서 role, kind, MCP all 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 ignored_args에 이름이 표시됩니다.
conflicts.allowlist_list
충돌하지 않는 것으로 알려져 표시된 (memory_key, memory_key) 쌍을 나열하여, conflicts 워커가 더 이상 이를 충돌로 표시하지 않도록 합니다.
POST /v1/conflicts.allowlist_list · MCP loom_conflicts_allowlist_list · role viewer · read · MCP all 도구 세트에는 없음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(신원 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
limit |
int |
100 |
최대 이 개수만큼의 쌍, 1-1000, 최신순. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
rows |
list[_AllowlistRow] |
유효한 허용 키 쌍(memory_key_a가 memory_key_b보다 앞에 정렬됨), 최신순. |
conflicts.allowlist_remove
허용 결정을 취소합니다. 이후 쓰기에서 해당 쌍은 다시 충돌로 표시됩니다.
POST /v1/conflicts.allowlist_remove · MCP loom_conflicts_allowlist_remove · role admin · idempotent · audited · MCP all 도구 세트에는 없음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(신원 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
memory_key_a |
str |
필수 | 허용된 쌍의 한 키. 두 키의 순서는 상관없습니다. |
memory_key_b |
str |
필수 | 쌍의 다른 키. |
removed_by |
str |
'' |
취소한 주체. reason과 함께 해당 쌍의 저장된 사유에 덧붙여집니다. |
reason |
str |
'' |
사유. 해당 쌍의 저장된 사유에 덧붙여집니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
removed |
bool |
일치하는 유효한 허용 쌍이 없으면 False. |
conflicts.list
두 메모리가 서로 모순되는, 해결되지 않은 충돌을 나열합니다.
POST /v1/conflicts.list · MCP loom_conflicts_list · role viewer · read · MCP all 도구 세트에는 없음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(신원 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
limit |
int |
50 |
최대 이 개수만큼의 행, 1-500, 최신 버전순. |
before_version |
int \| None |
None |
키셋 커서. 페이지를 넘기려면 이전 응답의 가장 이른 버전을 전달하세요. |
count_only |
bool |
False |
배지에는 행이 아닌 숫자만 필요합니다. |
fresh |
bool |
False |
count_only와 함께 사용하면 1분간 유지되는 캐시를 읽는 대신 지금 집계합니다. 기본값은 꺼짐. |
keys_only |
bool |
False |
Memories 보기는 충돌이 있는 카드를 표시하는 데 키만 필요합니다. |
fields |
list[str] \| None |
None |
호출자가 읽는 출력 필드(행 모델에 대해 확인되는 허용 목록이며, 알 수 없는 이름은 422). 설정하지 않으면 모든 필드. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
rows |
list[_ConflictRow] |
충돌한 메모리, 최신 버전순. count_only 또는 keys_only 호출에서는 비어 있습니다. |
next_before_version |
int \| None |
다음 페이지를 위해 before_version으로 전달합니다. 마지막 페이지에서는 null. |
total |
int \| None |
네임스페이스의 현재 충돌 메모리 수. count_only 호출에서 설정됩니다. |
keys |
list[str] \| None |
네임스페이스의 충돌한 메모리 키. keys_only 호출에서 설정됩니다. |
conflicts.propose_revision
파괴적이지 않은 revise/contract/allow 제안을 반환합니다.
POST /v1/conflicts.propose_revision · MCP loom_conflicts_propose_revision · role viewer · read · MCP all 도구 세트에는 없음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(신원 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
memory_id |
str |
필수 | 조언 대상인 충돌한 메모리(org 전체 범위의 id). |
peer_id |
str \| None |
None |
조언을 conflict_with의 이 피어 하나로 제한합니다. None이면 모든 피어를 고려합니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
메모리 또는 그것이 가리키는 모든 행이 namespace에서 유효하지 않으면 False. |
memories |
list[_ConflictCandidateMemory] |
대상이 먼저(local_id 1), 그다음 유효한 피어가 최신순으로 옵니다. |
suggestions |
list[_ConflictRevisionSuggestion] |
로컬 id로 지정된 conflicts.resolve 제안 최대 하나. 대상이 고정되어 있거나 피어와 키를 공유하면 revise, 피어가 고정되어 있으면 contract, 그 외에는 allow. |
note |
str |
아무것도 적용되지 않았음을 항상 알립니다. 이 연산은 조언만 합니다. |
conflicts.resolve
충돌의 승자를 선택합니다(A 유지, B 유지, 둘 다 유지, 병합).
POST /v1/conflicts.resolve · MCP loom_conflicts_resolve · role admin · idempotent · audited · MCP all 도구 세트에는 없음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(신원 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
memory_id |
str |
필수 | 결정 대상인 충돌한 메모리(org 전체 범위의 id). namespace에 있어야 합니다. |
decision |
Literal['revise', 'contract', 'allow'] |
필수 | revise는 해당 메모리를 유지하고 피어를 툼스톤 처리합니다. contract는 해당 메모리를 툼스톤 처리하고 피어를 다시 활성화합니다. allow는 모두 다시 활성화하고 각 키 쌍을 허용 목록에 추가합니다. |
peer_id |
str \| None |
None |
선택 사항: 해결 범위를 특정 피어 하나로 한정합니다(그 피어에 대해서만 revise). |
reason |
str |
'' |
사유. 툼스톤 처리된 행의 source_trace에 덧붙여지고 허용 목록 행에 저장됩니다(처음 512자). |
resolved_by |
str |
'' |
해결한 주체. reason과 함께 기록됩니다(처음 128자). 토큰과 대조하여 확인하지 않습니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
resolved |
bool |
메모리 또는 지정한 피어를 알 수 없거나 메모리가 namespace에 없으면 False. 이 경우 아무것도 기록되지 않습니다. |
decision |
Literal['revise', 'contract', 'allow'] |
전달된 결정을 그대로 반환합니다. |
affected_memory_ids |
list[str] |
이 호출이 툼스톤 처리했거나 다시 활성화한 모든 메모리 id. |
resolved_at |
datetime \| None |
해결이 실행된 시각(UTC). 아무것도 해결되지 않았으면 null. |
total |
int \| None |
쓰기 이후에 집계한, 호출자의 읽기 범위에서의 네임스페이스 충돌 수. 아무것도 해결되지 않았거나 집계에 실패하면 null. |