번역되지 않은 페이지는 영어로 열리며 영어로 표시됩니다.
이 페이지는 영어 원문을 기계 번역한 것이며, 영어 원문이 기준입니다. Machine-translated from the English page, which is authoritative.
context 작업
각 context.* 작업이 받고 반환하는 정확한 필드입니다.
모든 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에 이름이 표시됩니다.
context.fetch
보관된 결과를 키로 다시 읽습니다. 문자 단위 슬라이스(offset/limit)를 읽거나, 정규식과 일치하는 줄만(pattern, context_lines 사용) 읽을 수 있습니다.
POST /v1/context.fetch · MCP loom_context_fetch · role viewer · 읽기 · MCP all 툴셋에는 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스입니다. |
agent |
str |
필수 | 쓰거나 읽는 에이전트입니다. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
해당 행이 속한 최종 사용자입니다. 없으면 '-'입니다. |
session_id |
str |
'-' |
해당 행이 속한 세션 또는 대화입니다. 없으면 '-'입니다. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위)입니다. 없으면 '-'입니다. |
blob_key |
str |
필수 | context.offload가 반환한 키입니다. |
offset |
int |
0 |
슬라이스를 시작할 문자 오프셋입니다. pattern과 함께 쓰면 건너뛸 일치 항목 수입니다. |
limit |
int |
4000 |
호출당 최대 문자 수입니다(1-64000). |
pattern |
str |
'' |
정규식입니다(RE2 문법, 대소문자 구분 안 함, 역참조와 lookaround 불가). |
context_lines |
int |
0 |
pattern과 함께 쓰면 각 일치 항목 주변에 표시할 문맥 줄 수입니다(0-10). 문맥 줄은 lineno-, 일치 줄은 lineno:로 번호가 붙습니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
found |
bool |
네임스페이스에 이 키를 가진 유효하고 만료되지 않은 blob이 없으면 false입니다. |
blob_key |
str |
입력한 blob_key를 그대로 반환합니다. |
content |
str |
문자 슬라이스입니다. pattern을 쓰면 일치하는 줄이 lineno: text 형식으로 담깁니다. |
content_type |
str |
blob과 함께 저장된 미디어 타입입니다. |
summary |
str |
blob과 함께 저장된 요약입니다. |
total_chars |
int |
저장된 전체 내용의 문자 수입니다. |
total_lines |
int |
저장된 전체 내용의 줄 수입니다. |
offset |
int |
입력한 offset을 그대로 반환합니다. |
next_offset |
int |
슬라이스(또는 일치 목록)를 모두 읽었으면 -1입니다. |
matched_lines |
int |
pattern을 쓰면 전체 내용에서 일치하는 줄 수이고, 그렇지 않으면 0입니다. |
expires_at |
datetime \| None |
blob을 더 이상 가져올 수 없게 되는 시각입니다. 찾지 못하면 None입니다. |
context.offload
큰 도구 결과(로그, 페이지, diff, 쿼리 출력)를 모델 컨텍스트 밖에 보관합니다.
POST /v1/context.offload · MCP loom_context_offload · 역할 writer · 멱등 · MCP all 툴셋에는 나열되지 않음
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소). |
namespace |
str |
필수 | op가 읽거나 쓰는 네임스페이스. |
agent |
str |
필수 | 쓰기 또는 읽기를 수행하는 에이전트. op가 허용하는 경우 '-' 또는 '*'는 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
행이 속한 최종 사용자. 없으면 '-'. |
session_id |
str |
'-' |
행이 속한 세션 또는 대화. 없으면 '-'. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(태스크 범위). 없으면 '-'. |
content |
str |
필수 | 보관할 텍스트. LOOM_CONTEXT_OFFLOAD_MAX_BYTES(UTF-8 바이트)보다 크면 413이 반환됩니다. |
blob_key |
str |
'' |
비어 있으면 콘텐츠 주소 지정 방식(blob/<sha256 prefix>)을 사용합니다. 같은 출력을 두 번 보관해도 같은 키가 생성되고 저장되는 행은 하나입니다. |
content_type |
str |
'text/plain' |
콘텐츠와 함께 저장되며 context.fetch가 반환하는 미디어 타입. |
summary |
str |
'' |
호출자가 제공하는 한 줄 요약(도구 이름과 반환된 내용). |
ttl_seconds |
int |
604800 |
blob을 가져올 수 있는 기간(초). 1분에서 90일까지입니다. |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
blob_key |
str |
콘텐츠를 가져올 때 사용하는 키. 지정한 키 또는 blob/<sha256 prefix>입니다. |
content_bytes |
int |
저장된 콘텐츠의 크기(UTF-8 바이트). |
content_chars |
int |
저장된 콘텐츠의 길이(문자 수). |
sha256 |
str |
콘텐츠의 SHA-256 16진수 다이제스트. |
summary |
str |
blob과 함께 저장된 요약. 지정한 요약 또는 콘텐츠의 처음 200자입니다. |
expires_at |
datetime |
blob을 더 이상 가져올 수 없게 되는 시점. |
pointer |
str |
트랜스크립트에서 콘텐츠를 대신할 수 있도록 준비된 포인터. |
context.pack
작업에 필요한 메모리, 결정, 절차: Loom 훅이 이미 이 세션에 Loom 컨텍스트를 넣어 두었다면 예외이고, 그렇지 않으면 각 작업의 처음에 가장 먼저 호출하세요.
POST /v1/context.pack · MCP loom_context_pack · role viewer · read
| 입력 필드 | 타입 | 기본값 | 의미 |
|---|---|---|---|
org |
str |
필수 | 테넌트(식별 튜플의 첫 번째 요소). |
namespace |
str |
필수 | 이 op가 읽거나 쓰는 네임스페이스. |
agent |
str |
필수 | 쓰거나 읽는 에이전트. '-' 또는 '*'는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
user_id |
str |
'-' |
팩이 읽는 대상 사용자. "-"는 memories, profile, procedures, runs 섹션에서는 모든 사용자를 읽고, 스택 및 작업 메모리 섹션에서는 사용자에 속하지 않은 행을 읽습니다. |
session_id |
str |
'-' |
팩이 읽는 대상 세션. "-"는 memories 섹션에서는 모든 세션을 읽고, 스택 및 작업 메모리 섹션에서는 세션에 속하지 않은 행을 읽습니다. |
run_id |
str |
'-' |
호출이 속한 에이전트 실행(작업 범위). 없으면 '-'. |
query |
str |
'' |
관련 메모리와 문서를 고르는 데 쓰는 선택적 작업/질문. |
situation |
str |
'' |
절차를 매칭하는 데 쓰는 선택적 상황 설명. |
procedure_explore_rate |
float \| None |
None |
procedures 섹션의 탐색 비율. None = 0(탐색 안 함). |
token_budget |
int |
2000 |
렌더링된 전체 팩의 토큰 단위 크기 상한(토큰당 약 4자). 더 긴 팩은 잘리고 truncated가 설정됩니다. |
top_k |
int |
5 |
검색 기반 섹션이 각각 요청하는 결과 수(procedures와 스택의 지식 계층은 최대 5개). |
read_scope |
Literal['namespace', 'own_user', 'own_session'] |
'namespace' |
memory.search.read_scope와 의미가 같으며, 이 op의 user_id / session_id에 바인딩됩니다. |
mode |
Literal['startup', 'task', 'debug', 'handoff'] |
'task' |
섹션 예산과 검색 방식. 어떤 모드에서도 LLM 호출은 없습니다. startup(빠른 회상, query가 없으면 핀과 최근 메모리를 제공), task와 handoff(균형), debug(품질). |
include_knowledge |
bool |
False |
일치하는 문서 청크로 구성된 knowledge 섹션을 추가합니다. query가 필요합니다. |
include_conversations |
bool |
False |
일치하는 과거 메시지로 구성된 conversations 섹션을 추가합니다. query가 필요합니다. |
include_runs |
bool |
False |
runs 매니페스트. 이 식별자의 최근 세션마다 한 줄(날짜, 실행 상태와 목표, 종류별 도구 호출과 오류, 건드린 파일, 요약)을 최신순으로 runs_limit개 행까지 나열합니다. |
runs_limit |
int |
12 |
include_runs가 설정된 경우 runs 매니페스트에 나열할 최근 세션 수(1-50). |
include_chunks |
bool |
False |
memories 검색의 리랭커 풀을 최근 후보 20개로 넓힙니다. 리랭커가 없으면 효과가 없습니다. |
section_token_budgets |
dict[str, int] |
(계산됨) | 모드의 기본값을 덮어쓰는 섹션별 토큰 예산. 섹션 이름을 키로 하며, 섹션은 80토큰보다 적게 받지 않습니다. |
block_order |
list[str] |
(계산됨) | 호출자가 지정하는 선택적 블록 순서. |
session_block |
str |
'' |
호출자 자신의 세션 북마크(session:<project>, 플러그인의 Stop 훅 노트). |
only_sections |
list[Literal['working_memory', 'memory_stack', 'profile', 'memories', 'procedures', 'decisions', 'knowledge', 'conversations', 'runs', 'namespace_health', 'namespace_guide', 'mentor']] |
(계산됨) | 팩을 이 섹션들로 제한합니다. |
include_decisions |
bool |
True |
decision 타입 결과는 memories 블록에서 빠지고, 구조화된 레코드(시나리오, 결과, 실제 결과)를 담은 별도의 태그 |
| 출력 필드 | 타입 | 의미 |
|---|---|---|
rendered |
str |
하나의 텍스트로 된 팩. 비어 있지 않은 각 섹션이 <name> 태그로 감싸져 블록 순서대로 들어가며, token_budget에 맞춰 잘립니다. |
sections |
dict[str, str] |
블록 순서대로 정렬된, 이름별 각 섹션의 본문. 아무것도 렌더링되지 않은 섹션은 없습니다. |
blocks |
list[ContextBlock] |
비어 있지 않은 섹션마다 하나의 항목: 라벨, 본문, 토큰 추정치, 인용, 소스 수, priority(블록 순서에서의 위치). |
section_meta |
dict[str, dict[str, Any]] |
이름별 섹션 세부 정보: 소스 수, 인용, 잘렸는지 여부, 크기, 토큰 예산, 채움 비율(1.0을 넘으면 잘렸음을 의미). |
section_count |
int |
내용이 렌더링된 섹션 수. |
truncated |
bool |
어떤 섹션이나 전체 팩이 예산에 맞춰 잘렸으면 True. |
token_budget |
int |
입력 token_budget의 에코. |
mode |
str |
입력 mode의 에코. |
tokens_estimate |
int |
예산 압박도. |
fill_ratio |
float |
tokens_estimate / token_budget, 소수점 셋째 자리까지. |
stable_sections |
list[str] |
rendered의 맨 앞에서 query나 situation에 의존하지 않는 연속 구간. 이 식별자의 작업 메모리, 프로필, 핀이 바뀔 때까지는 어떤 질문을 해도 동일한 바이트입니다. |
stable_prefix_chars |
int |
rendered에서 그 앞부분의 문자 길이. 첫 섹션이 query에 의존하면 0. |
stable_hash |
str |
안정 접두부의 SHA-256. stable_prefix_chars가 0이면 빈 문자열. |
procedure_keys |
list[str] |
팩이 에이전트에게 보여 준 절차: 유틸리티에 필요한 원장의 "표시됨" 쪽. |
procedure_keys_withheld |
list[str] |
팩이 매칭했지만 의도적으로 보류한 절차: 같은 원장의 "표시되지 않음" 쪽. |