콘텐츠로 이동

번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. 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.