콘텐츠로 이동

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

이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.

task 작업

각 task.* 작업이 받고 반환하는 정확한 필드입니다.

모든 작업은 HTTP에서는 POST /v1/<op>, MCP에서는 loom_<op> 도구로 호출합니다. 식별 필드(org, namespace, agent, user_id, session_id)는 전송 방식이 지원하는 경우 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, code.*와 tracker.*(각자 자신의 plane 값을 유지함)를 제외한 모든 작업에서 설치된 org가 사용되며, 일부 작업에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 식별자와 네임스페이스를 참고하세요. 작업 색인에서 role, kind, MCP all 목록을 설명합니다. 알 수 없는 입력 필드도 처리되며 ignored_args에 이름이 표시됩니다.

task.accept

분류(triage)가 끝난 태스크를 인박스의 백로그로 수락합니다(소유자 측). 필요하면 우선순위와 제약 조건을 함께 설정할 수 있습니다.

POST /v1/task.accept · MCP loom_task_accept · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 수락할 triage 태스크. 등록한 사람은 직접 수락할 수 없습니다(403).
priority int \| None None 승인자가 수락하면서 선택적으로 수정하는 값.
constraints str \| None None 브리프에 constraints로 저장되는 텍스트이며, 기존 값을 대체합니다. None이면 브리프를 그대로 둡니다.
note str '' accepted 이벤트에 저장되는 자유 형식 텍스트.
출력 필드 타입 의미
task TaskPayload 상태 전환 후의 태스크.
seq int 이 호출이 기록한 이벤트의 seq.

task.block

작업을 차단됨 상태로 표시하고 리스를 해제하며, 차단 사유와 무엇 때문에 차단되었는지를 함께 기록합니다.

POST /v1/task.block · MCP loom_task_block · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 작업입니다.
fence int 필수 클레임이 반환한 펜스 토큰입니다. 오래된 토큰(리스가 이미 넘어간 경우)이면 409로 응답합니다.
reason str 필수 작업을 진행할 수 없는 이유입니다. 행과 이벤트에 저장됩니다.
blocked_on Literal['sender', 'human', 'external'] 'human' 누가 조치해야 하는지를 나타냅니다. sender(이 경우 게시자가 차단을 해제할 수 있음), human, external 중 하나입니다.
출력 필드 타입 의미
task TaskPayload 전이 이후의 작업입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.

task.cancel

권한이 있는 누구나 사유와 함께 수행할 수 있는 전이입니다. fence는 호출자가 in_progress 상태 태스크의 현재 소유자일 때만 필수입니다.

POST /v1/task.cancel · MCP loom_task_cancel · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이동할 태스크입니다. 완료되지 않은 태스크이거나, task.reopen의 경우 failed, wont_do 또는 cancelled 상태의 태스크입니다.
reason str 필수 사유입니다. 행과 이벤트에 저장됩니다.
fence int \| None None 클레임의 fence입니다. 지정하면 in_progress 태스크에 대해 검사하며, None이면 검사를 건너뜁니다.
출력 필드 타입 의미
task TaskPayload 전이 후의 태스크입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.

task.claim

리스 아래에서 todo 작업을 클레임합니다. 반환된 펜스는 이후의 모든 진행, 차단, 완료 호출을 보호합니다.

POST /v1/task.claim · MCP loom_task_claim · 역할 writer · 쓰기 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 클레임할 todo 작업. not_before가 아직 미래인 작업은 409로 응답합니다.
lease_seconds int \| None None 리스 길이. None이면 인박스의 default_lease_seconds를 사용합니다.
출력 필드 타입 의미
task TaskPayload 상태 전환 후의 작업.
seq int 이 호출이 기록한 이벤트의 seq.

task.complete

무엇: 클레임한 태스크를 완료합니다. task.pull에서 받은 펜스와 결과(링크, id, 짧은 결과 요약)를 전달합니다.

POST /v1/task.complete · MCP loom_task_complete · role writer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 태스크.
fence int 필수 클레임이 반환한 펜스 토큰. 오래된 토큰(리스가 이미 넘어간 경우)이면 409로 응답합니다.
outcome dict[str, Any] (계산됨) 태스크에 저장되는 JSON 객체 형태의 결과.
note str '' done 이벤트에 저장되는 자유 텍스트.
출력 필드 타입 의미
task TaskPayload 전환 후의 태스크.
seq int 이 호출이 기록한 이벤트의 seq.

task.counts

하나의 인박스 또는 네임스페이스의 모든 인박스에 대해 상태별로 태스크 수를 집계합니다.

POST /v1/task.counts · MCP loom_task_counts · 역할 viewer · 읽기 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰기 또는 읽기를 수행하는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
inbox str \| None None 하나의 인박스를 집계합니다. None이면 namespace가 소유한 모든 인박스를 집계합니다.
출력 필드 타입 의미
counts list[InboxCount] (inbox, status, blocked_on)별로 한 행씩 반환하며, 각 행에 개수와 가장 오래된 created_at이 포함됩니다.

task.create

namespace는 게시자 자신의 네임스페이스이고, inbox는 대상입니다.

POST /v1/task.create · MCP loom_task_create · 역할 writer · 멱등 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
inbox str 필수 대상 인박스. 호출자가 게시할 수도 없고 읽을 수도 없는 인박스는 404를 반환합니다.
kind str 필수 게시자가 고르는 태스크 유형. 정책과 풀 필터가 이 값으로 일치 여부를 판단합니다.
title str 필수 목록에 표시되는 한 줄 요약.
brief dict[str, Any] (계산됨) JSON 객체로 된 태스크 본문. 일치하는 정책의 모든 require_evidence 경로가 여기서 비어 있지 않아야 합니다(아니면 422).
priority int 3 1(가장 긴급)부터 4까지. 풀은 낮은 숫자를 먼저, 그다음 가장 오래된 것을 먼저 가져갑니다.
disclosure Literal['confidential', 'internal', 'public_ok'] 'internal' brief의 민감도: confidential, internal, public_ok 중 하나. 인박스의 accept_disclosure에 포함되어 있어야 합니다.
not_before datetime \| None None 이 시각까지 풀과 클레임이 태스크를 건너뜁니다(시간대 없음 = UTC). None이면 즉시 사용할 수 있습니다.
deadline datetime \| None None 게시자가 작업 완료를 원하는 시각(시간대 없음 = UTC). 저장되고 표시되지만 강제되지는 않습니다.
origin str '' 태스크가 어디서 왔는지 적는 자유 텍스트. 저장되고 반환될 뿐 해석되지 않습니다.
parent_task_id str \| None None 이 태스크의 선행 태스크(태스크 id). 최상위 태스크이면 None.
idempotency_key str '' 같은 게시자가 같은 인박스에 같은 키로 재시도하면 첫 태스크를 created=false와 함께 반환합니다. 다른 게시자가 같은 키를 쓰면 자신의 태스크가 별도로 저장되며, ""는 중복을 제거하지 않습니다.
from_subject str '' 개발 모드 전용(토큰 없음): 게시하는 주체.
출력 필드 타입 의미
task TaskPayload 저장된 태스크. 멱등 재실행이면 이전 태스크.
created bool idempotency_key가 이전 태스크와 일치하면 False.
seq int 반환된 행의 버전. 새 태스크라면 해당 created 이벤트의 seq.
next str 태스크가 triage에 놓일 때 다음에 일어나는 일 — 인박스 소유자가 수락합니다. 게시자는 수락할 수 없으며, heartbeat / complete / defer는 triage 태스크를 거부합니다. todo에 놓였다면 "". 에이전트가 이를 다른 경로로 알아내는 대신 무엇을 해야 하는지 읽을 수 있도록 합니다…

task.defer

요약: 클레임된 태스크를 resume_at과 함께 다시 보류 상태로 돌려놓습니다. sweeper가 해당 시각에 태스크를 큐로 되돌립니다.

POST /v1/task.defer · MCP loom_task_defer · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 태스크.
fence int 필수 클레임이 반환한 fence 토큰. 오래된 토큰(리스가 다른 곳으로 넘어간 경우)은 409로 응답합니다.
reason str 필수 태스크를 보류하는 이유. 행과 이벤트에 저장됩니다.
resume_at datetime \| None None sweeper가 태스크를 todo로 되돌리는 시각. None이면 task.resume이 호출될 때까지 보류합니다.
출력 필드 타입 의미
task TaskPayload 전환 후의 태스크.
seq int 이 호출이 기록한 이벤트의 seq.

task.fail

요약: 클레임된 태스크를 사유와 함께 실패로 표시합니다. 소유자 측에서 다시 열 수 있으며, 사람의 확인이 필요해 차단되는 시점은 인박스의 max_attempts가 결정합니다.

POST /v1/task.fail · MCP loom_task_fail · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 태스크.
fence int 필수 클레임이 반환한 펜스 토큰. 오래된 토큰(리스가 이미 넘어간 경우)이면 409로 응답합니다.
reason str 필수 실패한 이유. 행과 이벤트에 저장됩니다.
outcome dict[str, Any] (계산됨) 부분 결과를 JSON 객체로 지정하며, 태스크에 저장됩니다.
출력 필드 타입 의미
task TaskPayload 전환 이후의 태스크.
seq int 이 호출이 기록한 이벤트의 seq.

task.get

task_id로 지정한 작업 하나의 상태, 리스, 게시자, 결과, 이력을 조회합니다.

POST /v1/task.get · MCP loom_task_get · 역할 viewer · 읽기 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별자 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 기록하거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 읽을 작업입니다.
출력 필드 타입 의미
found bool 작업이 존재하지 않거나 호출자가 읽을 수 없으면 False입니다.
task TaskPayload \| None 해당 작업입니다. 찾지 못하면 null입니다.

task.heartbeat

요약: 클레임한 태스크(task.pull에서 받은 fence)의 리스를 갱신하고, 필요하면 진행 메모를 남깁니다.

POST /v1/task.heartbeat · MCP loom_task_heartbeat · 역할 writer · 멱등 · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 태스크입니다.
fence int 필수 클레임이 반환한 fence 토큰입니다. 오래된 토큰(리스가 이미 다른 곳으로 넘어간 경우)은 409로 응답합니다.
lease_seconds int \| None None 지금부터 이 초 수만큼 리스를 연장합니다. None이면 인박스 기본값을 사용합니다.
출력 필드 타입 의미
task TaskPayload 전환 후의 태스크입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.

task.history

작업의 이벤트 기록(게시, 수락, 클레임, 진행, 완료 등)을 반환합니다.

POST /v1/task.history · MCP loom_task_history · 역할 viewer · 읽기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(ID 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이벤트를 읽을 작업입니다.
limit int 200 최대 이 개수만큼의 이벤트를 오래된 순으로 반환하며, 범위는 1-1000입니다.
출력 필드 타입 의미
found bool 작업이 존재하지 않거나 호출자가 읽을 수 없으면 False입니다.
events list[TaskEventPayload] seq 순서로 정렬된 작업의 이벤트입니다.

task.list

inbox에 있는 작업(소유자 측)을 반환합니다. posted_by_me를 지정하면 호출자가 조직 내 어디에든 게시한 작업을 반환합니다.

POST /v1/task.list · MCP loom_task_list · role viewer · 읽기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
inbox str \| None None 나열할 inbox(소유자 측)입니다. posted_by_me가 아니면 필수입니다.
posted_by_me bool False True이면 조직 전체에서 호출자 본인이 게시한 작업을 나열합니다. 이때 inbox, posted_by, owner는 무시됩니다.
posted_by str \| None None 소유자 측: 한 게시자(subject 또는 에이전트)가 inbox로 보낸 작업입니다. 분류(triage) 결정 옆에 표시되는 이력입니다.
statuses list[Literal['triage', 'todo', 'in_progress', 'blocked', 'deferred', 'done', 'wont_do', 'failed', 'cancelled']] (계산됨) 이 상태의 작업만 반환합니다. 비어 있으면 모든 상태를 나열합니다.
kinds list[str] (계산됨) 이 kind의 작업만 반환합니다. 비어 있으면 모든 kind를 나열합니다.
owner str \| None None 현재 이 에이전트가 맡고 있는 작업만 반환합니다.
limit int 100 최대 이 행 수까지 반환하며, 범위는 1-500입니다. truncated는 더 많은 항목이 일치했음을 나타냅니다.
fields list[str] (계산됨) 행마다 반환할 컬럼입니다(식별 컬럼은 항상 포함되며, 알 수 없는 이름은 제외됩니다). 비어 있으면 전체 작업 페이로드를 반환합니다.
newest_first bool False 작업 큐 순서 대신 최신순으로 반환합니다.
출력 필드 타입 의미
tasks list[dict[str, Any]] 작업당 하나의 객체이며, newest_first가 아니면 우선순위, 그다음 생성 시각 순입니다.
truncated bool limit보다 많은 작업이 일치하면 True입니다.

task.progress

클레임된 태스크에 진행 메모를 기록하고 리스를 연장합니다.

POST /v1/task.progress · MCP loom_task_progress · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소).
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이 소유자 쓰기가 대상으로 하는 in_progress 태스크.
fence int 필수 클레임이 반환한 펜스 토큰. 오래된 토큰(리스가 이미 넘어간 경우)은 409로 응답합니다.
note str 필수 progress 이벤트에 기록되는 진행 텍스트. 리스는 연장되지 않습니다.
출력 필드 타입 의미
task TaskPayload 전환 이후의 태스크.
seq int 이 호출이 기록한 이벤트의 seq.

task.pull

namespace는 인박스를 소유한 네임스페이스입니다. 호출자는 해당 네임스페이스의 writer여야 합니다.

POST /v1/task.pull · MCP loom_task_pull · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소)입니다.
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
inbox str 필수 태스크를 가져올 인박스입니다.
kinds list[str] (계산됨) 해당 kind의 태스크만 가져옵니다. 비어 있으면 모든 kind를 가져옵니다.
limit int 1 호출당 최대 태스크 수이며, 범위는 1-20입니다.
wait_seconds int 0 가져올 태스크가 없을 때 롱 폴링으로 대기하는 시간(초)이며, 최대 30입니다. 0이면 즉시 반환합니다.
lease_seconds int \| None None 각 클레임의 리스 길이입니다. None이면 인박스의 default_lease_seconds를 사용합니다.
status Literal['todo', 'triage'] 'todo' todo는 리스를 걸어 태스크를 클레임하고, triage는 클레임 없이 검토 항목을 나열합니다.
출력 필드 타입 의미
tasks list[TaskPayload] 클레임한 태스크(triage의 경우 나열한 태스크)이며, 우선순위순, 같으면 오래된 순입니다. 제시간에 도착한 태스크가 없으면 비어 있습니다.
waited_ms int 롱 폴링 대기 시간을 포함해 호출에 걸린 시간(밀리초)입니다.
backend str 클레임을 처리한 리스 중재자로, keeper 또는 log입니다.
note str todo 풀이 비어 있을 때 triage에 몇 건이 대기 중인지 알려 줍니다.

task.reassign

소유자 측: 여기서 취소하고, 하위 작업으로 다른 인박스에 다시 게시합니다(대상 인박스의 신뢰 정책은 원래 게시자에게 적용됩니다).

POST /v1/task.reassign · MCP loom_task_reassign · role writer · write · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(아이덴티티 튜플의 첫 번째 요소)입니다.
namespace str 필수 이 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰기 또는 읽기를 수행하는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이동할 미완료 작업입니다. 현재 인박스에서 취소됩니다.
to_inbox str 필수 대상 인박스입니다. 호출자가 이 인박스에 게시할 수 있어야 하며(task.create와 동일), 인박스가 해당 작업의 공개 범위를 허용해야 하고, 원래 게시자에 대한 인박스의 정책이 todo인지 triage인지를 결정합니다.
reason str 필수 사유입니다. 취소된 작업과 대체 작업 모두에 저장됩니다.
출력 필드 타입 의미
task TaskPayload 원래 작업이며, 이제 cancelled 상태입니다.
replacement TaskPayload to_inbox의 새 작업입니다. 이 작업의 parent_task_id는 원래 작업입니다.

task.reopen

권한이 있는 누구나 사유와 함께 수행할 수 있는 전환입니다. fence는 호출자가 in_progress 상태 태스크의 현재 소유자일 때만 필요합니다.

POST /v1/task.reopen · MCP loom_task_reopen · role writer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(ID 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이동할 태스크입니다. 완료되지 않은 태스크이거나, task.reopen의 경우 failed, wont_do 또는 cancelled 상태의 태스크입니다.
reason str 필수 사유입니다. 행과 이벤트에 저장됩니다.
fence int \| None None 클레임의 fence입니다. 값이 주어지면 in_progress 태스크에 대해 검사하며, None이면 검사를 건너뜁니다.
출력 필드 타입 의미
task TaskPayload 전환 후의 태스크입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.

task.resume

보류된 작업을 resume_at보다 먼저 지금 바로 todo 상태로 되돌립니다.

POST /v1/task.resume · MCP loom_task_resume · role writer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별자 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰기 또는 읽기를 수행하는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다.
task_id str 필수 todo로 되돌릴 deferred 작업.
note str '' resumed 이벤트에 저장되는 자유 텍스트.
출력 필드 타입 의미
task TaskPayload 전환 후의 작업.
seq int 이 호출이 기록한 이벤트의 seq.

task.unblock

소유자 측, 또는 작업이 발신자 때문에 차단된 경우 게시자가 사용합니다.

POST /v1/task.unblock · MCP loom_task_unblock · role writer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다.
task_id str 필수 todo로 되돌릴 blocked 작업입니다.
note str '' unblocked 이벤트에 저장되는 자유 형식 텍스트입니다.
출력 필드 타입 의미
task TaskPayload 전환 후의 작업입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.

task.update

브리프를 편집합니다.

POST /v1/task.update · MCP loom_task_update · role writer · write · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 뜻합니다.
task_id str 필수 편집할 태스크. triage, todo, blocked, deferred 상태일 때 허용됩니다.
if_match_version int 필수 편집의 기준이 되는 태스크 version. 일치하지 않으면 현재 행과 함께 409로 응답합니다.
title str \| None None 새 제목. None이면 그대로 유지합니다.
brief dict[str, Any] \| None None 브리프 전체를 교체합니다. None이면 그대로 유지합니다.
priority int \| None None 새 우선순위, 1-4. None이면 그대로 유지합니다.
deadline datetime \| None None 새 마감 시한. None이면 그대로 유지합니다(clear_deadline 참조).
not_before datetime \| None None 새 최초 시작 시각. None이면 그대로 유지합니다(clear_not_before 참조).
clear_deadline bool False True이면 마감 시한을 제거합니다. deadline보다 우선합니다.
clear_not_before bool False True이면 not_before를 제거합니다. not_before보다 우선합니다.
note str '' updated 이벤트에 저장되는 자유 형식 텍스트. 노트만으로도 유효한 업데이트입니다.
출력 필드 타입 의미
task TaskPayload 편집 후의 태스크.
seq int updated 이벤트의 seq.
conflict bool 항상 false입니다. 버전이 일치하지 않으면 대신 현재 행과 함께 409로 응답합니다.

task.updates

발신자의 커서: 이 호출자가 게시한 태스크의 이벤트(inbox를 지정하면 호출자가 소유한 인박스의 모든 이벤트)를 since_seq 이후부터 반환합니다.

POST /v1/task.updates · MCP loom_task_updates · role viewer · read · MCP all 툴셋에는 포함되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소).
namespace str 필수 op가 읽거나 쓰는 네임스페이스.
agent str '-' 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
since_seq int 0 이 seq 이후의 이벤트를 반환합니다. 이전 next_seq를 전달하며, 0이면 처음부터 시작합니다.
inbox str \| None None 호출자 자신의 게시물에 대한 이벤트 대신, 이 인박스(호출자가 읽을 수 있는 인박스)의 모든 이벤트를 읽습니다.
limit int 200 호출당 최대 이벤트 수, 1-1000.
wait_seconds int 0 사용 가능한 이벤트가 없을 때 롱 폴링으로 대기하는 시간(초), 최대 30. 0이면 즉시 반환합니다.
from_subject str '' 개발 모드 전용(토큰 없음): 누구의 게시물을 따라갈지 지정합니다. 토큰이 있으면 토큰의 subject가 우선합니다.
출력 필드 타입 의미
events list[TaskEventPayload] seq 순서의 이벤트. 다른 레플리카에 아직 기록 중인 행을 건너뛰지 않도록 최근 몇 초의 이벤트는 제외됩니다.
next_seq int 다음 호출을 위한 커서: 마지막 이벤트의 seq이며, 이벤트가 없으면 since_seq입니다.
waited_ms int 롱 폴링 대기 시간을 포함해 호출에 소요된 시간(밀리초).

task.wont_do

권한이 있는 누구나 사유를 붙여 수행할 수 있는 전환입니다. fence는 호출자가 in_progress 태스크의 현재 소유자일 때만 필요합니다.

POST /v1/task.wont_do · MCP loom_task_wont_do · 역할 writer · 쓰기 · MCP all 툴셋에는 나열되지 않음

입력 필드 타입 기본값 의미
org str 필수 테넌트(식별 튜플의 첫 번째 요소)입니다.
namespace str 필수 op가 읽거나 쓰는 네임스페이스입니다.
agent str '-' 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다.
task_id str 필수 이동할 태스크입니다. 완료되지 않은 태스크이거나, task.reopen의 경우 failed, wont_do 또는 cancelled 상태의 태스크입니다.
reason str 필수 사유입니다. 행과 이벤트에 저장됩니다.
fence int \| None None 클레임의 fence입니다. 지정하면 in_progress 태스크에 대해 검사하며, None이면 검사를 건너뜁니다.
출력 필드 타입 의미
task TaskPayload 전환 후의 태스크입니다.
seq int 이 호출이 기록한 이벤트의 seq입니다.