번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. 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입니다. |