> Source: https://clickhouse.github.io/loom/ko/reference/operations/procedure/ (Markdown: https://clickhouse.github.io/loom/ko/reference/operations/procedure.md)

<!-- i18n: source=docs/reference/operations/procedure.md blob=7ffae765f4965c91d0da72b0ded6b8bb9483dfb3 model=claude-sonnet-5-5 -->
> 이 페이지는 [영어 원문](https://clickhouse.github.io/loom/reference/operations/procedure/)을 기계 번역한 것이며, 영어 원문이 기준입니다.
> Machine-translated from the [English page](https://clickhouse.github.io/loom/reference/operations/procedure/), which is authoritative.

<a id="procedure-operations"></a>

# `procedure` 연산

각 `procedure.*` 연산이 받고 반환하는 정확한 필드입니다.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

모든 연산은 HTTP에서는 `POST /v1/<op>`, MCP에서는 `loom_<op>` 도구로 제공됩니다. 식별 필드(`org`, `namespace`, `agent`, `user_id`, `session_id`)는 전송 방식이 지원하면 토큰과 MCP 세션에서 채워집니다. 단일 사용자 서버에서 토큰 없이 HTTP로 호출하면, `code.*`와 `tracker.*`(각자의 플레인 값을 유지함)를 제외한 모든 연산에서 설치된 org가 사용되고, [일부 연산](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request)에서는 네임스페이스와 에이전트도 채워집니다. 자세한 내용은 [아이덴티티와 네임스페이스](https://github.com/ClickHouse/loom/blob/main/docs/concepts/identities-and-namespaces.md)를 참조하세요. [연산 색인](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md)에서는 role, kind, MCP `all` 목록을 설명합니다. 알 수 없는 입력 필드는 그대로 처리되며 `ignored_args`에 이름이 표시됩니다.

<!-- prettier-ignore-start -->

<a id="procedureadd"></a>

## `procedure.add`

절차 메모리를 등록합니다. 구조화된 (name, situation, steps) 필드로 이루어진 'X를 하는 방법' 레시피입니다.

`POST /v1/procedure.add` · MCP `loom_procedure_add` · 역할 `writer` · 쓰기

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(ID 튜플의 첫 번째 요소)입니다. |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스입니다. |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트입니다. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자입니다. 없으면 `'-'`입니다. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화입니다. 없으면 `'-'`입니다. |
| `name` | `str` | 필수 | 절차 이름입니다. 메모리 키는 `procedure_<slug of name>`이므로 같은 이름이면 덮어씁니다. |
| `situation` | `str` | 필수 | 절차가 적용되는 상황(전제 조건)입니다. 이 텍스트가 `procedure.match`를 좌우합니다. |
| `steps` | `list[str]` | 필수 | 최소 두 개가 필요합니다. 단계가 하나뿐이면 절차가 아니라 교훈입니다(마이너도 같은 기준을 적용합니다). |
| `tags` | `list[str]` | *(계산됨)* | 절차에 저장되는 호출자 태그입니다. 행에는 태그 `procedure`도 추가됩니다. |
| `metadata` | `dict[str, Any]` | *(계산됨)* | 선택적 구조화 메타데이터입니다(키-값 형태의 전제 조건, 기대 출력 등). |
| `graph` | `dict[str, Any] \| None` | `None` | 선택적 실행 가능 그래프입니다(노드 = 단계 / 메모리 / 통합 / 결정, 엣지 = dep / dataflow / branch). |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 절차 행의 키입니다(`procedure_<slug>`). |
| `memory_id` | `str` | 기록된 메모리 버전의 ID입니다. |
| `version` | `int` | 기록된 행의 버전 번호입니다. |

<a id="procedureevolve"></a>

## `procedure.evolve`

프로시저에 누적된 실행 트레이스를 개선된 그래프로 통합합니다. 성공한 순회 횟수를 기준으로 검증된 경로의 순위를 매기고, 어떤 실행에서도 사용되지 않은 단계는 막다른 길로 표시하며, 위치한 단계와 전이도 표시합니다…

`POST /v1/procedure.evolve` · MCP `loom_procedure_evolve` · role `writer` · write · MCP `all` 툴셋에는 포함되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트입니다(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 이 op가 읽거나 쓰는 네임스페이스입니다. |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트입니다. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자입니다. 없으면 `'-'`입니다. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화입니다. 없으면 `'-'`입니다. |
| `memory_key` | `str` | 필수 | 발전시킬 프로시저의 키입니다(`procedure_<slug>`). |
| `min_runs` | `int` | `3` | 가지치기가 근거에 따라 동작하기 전에 반영되어야 하는 최소 실행 횟수입니다. |
| `gate_mode` | `Literal['sprt', 'margin']` | `'sprt'` | 보류 중인 리비전에 대한 수락 게이트입니다. |
| `gate_min_runs` | `int` | `3` | 어떤 판정이든 내리기 전에 검증 중인 리비전에서 필요한 실행 횟수입니다. |
| `gate_margin` | `float` | `0.05` | margin 모드: 되돌림을 일으키는 성공률 하락폭입니다. |
| `gate_min_drop` | `float` | `0.15` | sprt 모드: 되돌릴 만한 하락폭, 오류율, 그리고 그 실행 횟수를 넘으면 점추정값이 결정하는 기준입니다. |
| `gate_alpha` | `float` | `0.05` | sprt 모드: 잘못 되돌릴 오류율입니다. 낮을수록 되돌리기 전에 더 많은 근거가 필요합니다. |
| `gate_beta` | `float` | `0.2` | sprt 모드: 하락을 놓칠 오류율입니다. 낮을수록 수락하기 전에 더 많은 근거가 필요합니다. |
| `gate_max_runs` | `int` | `50` | sprt 모드: 이 리비전에서 이 실행 횟수에 도달하면 점추정값이 결정합니다. |
| `strike_limit` | `int \| None` | `None` | 프로시저를 격리하는 연속 실패 실행 횟수입니다. None = LOOM_PROCEDURE_STRIKE_LIMIT (3), 0 = 격리 안 함. |
| `gate_cost_tolerance` | `float` | `0.25` | 수락된 리비전에 대한 비용 동점 처리: 성공한 실행의 비용이 이전 리비전보다 이 비율을 초과하여 높으면 되돌립니다(소요 시간, 단계 수, 토큰 중 양쪽이 모두 보고하는 첫 번째 항목). 허용치와 정확히 같은 경우는 이 조건을 충족하지 않습니다. 양쪽 모두 `gate_cost_min_samples`만큼의 비용이 기록된 성공 실행이 필요합니다… |
| `gate_cost_min_samples` | `int \| None` | `None` | 비용 확인을 위해 각 쪽에 필요한 비용이 기록된 성공 실행 횟수입니다. `None` = `gate_min_runs`. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 발전된 프로시저의 키입니다. |
| `version` | `int` | 이 호출이 기록한 프로시저 행의 버전입니다. |
| `revision` | `int` | 이 호출 이후 프로시저의 토폴로지 리비전입니다(되돌리면 새 리비전이 열립니다). |
| `changed` | `bool` | 이 호출이 그래프의 플래그나 격리 상태를 변경했으면 True입니다. |
| `template` | `bool` | 프로시저가 이제 재사용 가능한 템플릿이면 True입니다(안정적이고, 대체로 성공하며, 격리되지 않음). |
| `folded_runs` | `int` | 이 호출로 그래프에 반영된 원장 행의 수입니다. |
| `gate` | `Literal['none', 'undecided', 'accept', 'revert']` | 보류 중인 리비전에 대한 수락 게이트: none(보류 중인 것 없음), undecided(아직 실행이 충분하지 않음), accept, revert. |
| `gate_mode` | `str` | 사용된 게이트 모드(`sprt` 또는 `margin`)입니다. 보류 중인 리비전이 없었으면 ""입니다. |
| `gate_llr` | `float` | sprt: 누적 로그 우도비입니다(양수이면 "리비전이 상황을 악화시켰다"를 지지). 경계를 넘으면 판정이 내려집니다. |
| `gate_before` | `dict[str, int]` | {total, ok} 이전 리비전 |
| `gate_after` | `dict[str, int]` | {total, ok} 검증 중인 리비전 |
| `gate_cost_before` | `dict[str, float]` | 각 쪽의 성공한 실행의 비용 중앙값, 그리고 성공 게이트를 통과한 리비전이 그래도 되돌려진 이유("cost")입니다. |
| `gate_cost_after` | `dict[str, float]` | 검증 중인 리비전에서 성공한 실행의 비용 중앙값입니다. |
| `gate_reason` | `str` | 되돌림 시 `success` 또는 `cost`, 그 외에는 ""입니다. |
| `dead_end_steps` | `list[str]` | 반영된 어떤 실행도 순회하지 않은 단계 텍스트입니다(선형 `steps`에서 강등됨). |
| `fail_prone_steps` | `list[str]` | 결과 대조: 실패한 실행에 불균형하게 많이 나타나는 단계 / 전이입니다(실패 비중 >= 프로시저 기본 실패율 + 마진, 충분한 실행 횟수). |
| `fail_prone_transitions` | `list[str]` | 실패한 실행에 불균형하게 많이 나타나는 전이로, `src -> dst` 노드 id로 표시됩니다. |
| `run_stats` | `dict[str, int]` | 이 호출 이후 프로시저에 반영된 `{total, ok}`입니다. |
| `strikes` | `int` | 트레이스 로그 끝에서의 연속 실패 실행 횟수, 그리고 프로시저가 아웃되었는지 여부입니다. |
| `quarantined` | `bool` | 프로시저가 아웃되어 격리되었으면 True입니다(`strike_limit` 참조). |
| `retention` | `dict[str, float]` | 트레이스 로그에 대한 성공 유지율: 첫 번째가 성공한 연속 실행 쌍, 그중 두 번째도 성공한 수, 그리고 비율입니다. |

<a id="procedurefork"></a>

## `procedure.fork`

호출자가 읽을 수 있는 네임스페이스의 프로시저를 요청 네임스페이스로 복사하고, 증거(evidence)는 초기화합니다.

`POST /v1/procedure.fork` · MCP `loom_procedure_fork` · 역할 `writer` · 쓰기 · 감사 대상 · MCP `all` 툴셋에는 포함되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | 대상(요청 네임스페이스. 연산이 WRITER 권한을 강제함) |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트. `'-'` 또는 `'*'`는 연산이 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자. 없으면 `'-'`. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화. 없으면 `'-'`. |
| `from_namespace` | `str` | 필수 | 복사해 올 네임스페이스. 호출자에게 읽기 권한이 필요합니다. |
| `from_org` | `str` | `''` | 기본값은 `org` |
| `memory_key` | `str` | 필수 | `from_namespace`에서 복사할 프로시저의 키. |
| `new_name` | `str` | `''` | 가져오면서 이름을 변경합니다(메모리 키는 이름에서 파생됩니다). |
| `reason` | `str` | `''` | 프로시저를 가져온 이유. `forked_from`에 저장됩니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 대상 네임스페이스에 생성된 새 프로시저의 키. |
| `version` | `int` | 기록된 행의 버전. |
| `name` | `str` | 새 프로시저의 이름(`new_name` 또는 원본의 이름). |
| `steps` | `list[str]` | 복사된 단계. |
| `forked_from` | `dict[str, Any]` | 계보 정보: 원본 org, 네임스페이스, 키, 리비전, 다이제스트, 템플릿 플래그, 실행 통계, 포크한 사람, 이유, 시각. |

<a id="procedurelist"></a>

## `procedure.list`

네임스페이스에 등록된 프로시저를 나열합니다(memory_key 접두사 또는 태그로 필터링할 수 있습니다).

`POST /v1/procedure.list` · MCP `loom_procedure_list` · 역할 `viewer` · 읽기 · MCP `all` 툴셋에는 포함되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | `'*'` | 쓰거나 읽는 에이전트. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자. 없으면 `'-'`. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화. 없으면 `'-'`. |
| `prefix` | `str` | `''` | 키가 `procedure_` + 이 값으로 시작하는 프로시저만 반환합니다. ""이면 모두 나열합니다. |
| `tags` | `list[str]` | *(계산됨)* | 이 태그 중 하나 이상을 가진 프로시저만 반환합니다. 비어 있으면 태그 필터가 없습니다. |
| `limit` | `int` | `50` | 읽을 프로시저 행의 최대 개수(서버에서 500으로 제한합니다). |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `procedures` | `list[_ProcedureSummary]` | 네임스페이스의 프로시저(이름, 상황, 태그, 키, 생성 시각). |

<a id="procedurelocate"></a>

## `procedure.locate`

이 절차에서 현재 어디에 있고, 다음에는 무엇이 오는가?

`POST /v1/procedure.locate` · MCP `loom_procedure_locate` · 역할 `viewer` · 읽기 · MCP `all` 툴셋에는 포함되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | `'*'` | 쓰거나 읽는 에이전트. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자. 없으면 `'-'`. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화. 없으면 `'-'`. |
| `memory_key` | `str` | 필수 | 에이전트가 따르고 있는 절차의 키(`procedure_<slug>`). |
| `at` | `str` | `''` | 에이전트의 현재 위치: 노드 id 또는 가장 최근 호출의 툴 이름. |
| `recent_path` | `list[str]` | *(계산됨)* | 이번 실행에서 에이전트가 최근에 거친 노드 id 또는 툴 이름. 오래된 것부터 나열하며 `revisits`와 `looping`에 사용됩니다. |
| `hops` | `int` | `2` | 앞으로 얼마나 멀리까지 보여줄지. 다음 결정에는 2면 충분하며, 더 크면 토큰이 더 듭니다. |
| `include_notes` | `bool` | `True` | 앞쪽 전이에 대해 원장(ledger)에 있는 최근 실패 노트를 첨부합니다. |
| `max_notes` | `int` | `5` | 실패 노트의 최대 개수. 0이면 첨부하지 않습니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 읽은 절차의 키. |
| `name` | `str` | 절차의 이름. |
| `status` | `Literal['template', 'exercised', 'authored', 'candidate', 'quarantined']` | `template`, `exercised`, `authored`, `candidate`, `quarantined` 중 하나. |
| `matched` | `bool` | `at`(또는 `recent_path`의 마지막 값)이 그래프의 노드를 가리키면 True. |
| `active` | `dict[str, Any] \| None` | 에이전트가 있는 노드. 일치하지 않으면 `None`. |
| `hops` | `list[list[dict[str, Any]]]` | hops[0] = 한 단계 앞, hops[1] = 두 단계 앞, ... (막다른 길은 제외). |
| `entry_nodes` | `list[str]` | 일치하지 않을 때: 들어오는 간선이 없는 노드 id, 즉 절차가 시작되는 지점. |
| `dominant_next` | `list[str]` | 현재 노드에서 검증된 경로를 따라 이어지는 다음 노드 id. |
| `revisits` | `dict[str, int]` | 궤적 윈도우: 이번 실행에서 노드별 방문 횟수, 현재 노드를 다시 방문하는 중인지 여부, 그 노드에서 택하지 않은 출구. |
| `looping` | `bool` | 현재 노드가 `recent_path`의 앞부분에 이미 나타나면 True. |
| `exits` | `list[str]` | 루프 중일 때: 현재 노드에서 도달할 수 있으나 이번 실행에서 아직 방문하지 않은 노드 id. 그 외에는 비어 있습니다. |
| `failure_notes` | `list[dict[str, Any]]` | 앞쪽 전이에서 실패한 실행에 에이전트가 남긴 노트. |
| `rendered` | `str` | 위 내용을 결정적으로 렌더링한 텍스트로, 프롬프트에 바로 넣을 수 있습니다. |
| `run_stats` | `dict[str, int]` | 절차의 집계된 `{total, ok}`. |
| `for_agent` | `dict[str, int]` | 호출한 에이전트의 `{total, ok}`. `*`, `-`이거나 실행 기록이 없으면 비어 있습니다. |

<a id="procedurematch"></a>

## `procedure.match`

호출자가 설명한 상황과 `situation` 필드가 의미상 가장 가까운 프로시저를 찾습니다.

`POST /v1/procedure.match` · MCP `loom_procedure_match` · role `viewer` · read

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | `'*'` | 기본 팬아웃 — 범위 안의 모든 에이전트의 프로시저 |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자. 없으면 `'-'`. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화. 없으면 `'-'`. |
| `situation` | `str` | 필수 | 에이전트가 처한 상태. 각 프로시저에 저장된 situation과 비교됩니다. |
| `top_k` | `int` | `5` | 검색하는 후보의 최대 개수(1–50). 필터 때문에 더 적게 반환될 수 있습니다. |
| `tags` | `list[str]` | *(계산됨)* | 이 태그 중 하나 이상을 가진 프로시저만 반환합니다. 비어 있으면 태그 필터를 적용하지 않습니다. |
| `namespace_scope` | `Literal['this', 'all_mine']` | `'all_mine'` | `all_mine`은 호출자 본인의 다른 네임스페이스까지(팬아웃 상한까지) 검색하고, `this`는 `namespace`만 검색합니다. |
| `templates_only` | `bool` | `False` | true이면 재사용 가능한 템플릿으로 승격된 프로시저(검증되고 충분히 실행된 워크플로 토폴로지)만 반환합니다. |
| `include_candidates` | `bool` | `True` | 후보는 아직 한 번도 실행되지 않았고 사람이 작성하지도 않은 프로시저입니다. |
| `include_quarantined` | `bool` | `False` | 격리된 프로시저(최근 `strike_limit`번의 실행이 모두 실패한 경우)는 요청하지 않으면 제외되며, 포함할 때는 표시와 함께 맨 마지막에 반환됩니다. |
| `recent_tools` | `list[str]` | *(계산됨)* | 에이전트가 이 작업에서 최근 호출한 도구. |
| `tool_boost` | `float` | `0.2` | 통합 `score`에서 `tool_overlap`이 차지하는 가중치. 0이면 `recent_tools`를 무시합니다. |
| `utility_weight` | `float \| None` | `None` | 통합 점수에서 원장(ledger)에서 파생된 유용성 항의 가중치: score = similarity + tool_boost*overlap + weight * ((ok+1)/(total+2) - 0.5). |
| `goal` | `str \| None` | `None` | 에이전트가 처한 상태와는 구별되는, 에이전트가 추구하는 목표. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `matches` | `list[_ProcedureMatch]` | 일치하는 프로시저. 상태 티어(후보와 격리된 항목이 마지막), 그다음 `score` 순으로 정렬됩니다. |
| `matched` | `int` | 원장에 기록되는 적중률 — 일치한 개수, 최상위 프로시저, 그 점수(out_matched / out_procedure_key / out_score). |
| `procedure_key` | `str` | 최상위 일치 항목의 메모리 키. 일치하는 항목이 없으면 "". |
| `score` | `float` | 최상위 일치 항목의 통합 점수. 일치하는 항목이 없으면 0. |

<a id="procedurerecord_run"></a>

## `procedure.record_run`

프로시저를 한 번 실행한 결과를 보고하여 loom이 실제로 어떤 경로가 잘 동작하는지 학습할 수 있게 합니다.

`POST /v1/procedure.record_run` · MCP `loom_procedure_record_run` · 역할 `writer` · 쓰기 · MCP `all` 툴셋에는 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소). |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스. |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 행이 속한 최종 사용자. 없으면 `'-'`. |
| `session_id` | `str` | `'-'` | 행이 속한 세션 또는 대화. 없으면 `'-'`. |
| `memory_key` | `str` | 필수 | 실행한 프로시저의 키(`procedure_<slug>`). |
| `path` | `list[str]` | *(계산됨)* | 에이전트가 이번 실행에서 실제로 방문한 노드 id를 순서대로 나열한 목록. |
| `ok` | `bool` | `True` | 실행이 성공했는지 여부. |
| `note` | `str` | `''` | 실행에 대한 자유 형식 메모(실패한 이유 등). `procedure.locate`는 실패한 실행의 메모를 보여 줍니다. |
| `ts` | `str` | `''` | 저장되지 않음: 원장이 각 실행에 서버 시간을 기록합니다. |
| `steps_taken` | `int \| None` | `None` | 실행에 든 비용. |
| `duration_ms` | `int` | `0` | 실행에 걸린 시간(밀리초). 0은 알 수 없음을 의미합니다. |
| `tokens` | `int` | `0` | 실행에 사용한 토큰 수. 0은 알 수 없음을 의미합니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 실행이 기록된 프로시저의 키. |
| `version` | `int` | 항상 0: 실행은 원장에 기록되며 프로시저 행은 다시 쓰이지 않습니다. |
| `run_stats` | `dict[str, int]` | 이번 실행을 포함한 `{total, ok, unfolded}`. `unfolded`는 `procedure.evolve`가 아직 반영하지 않은 원장 실행의 수입니다. |

<a id="procedurerevise"></a>

## `procedure.revise`

프로시저의 수정된 토폴로지를 제안합니다. 사용자가 정제자(refiner) 역할을 맡습니다.

`POST /v1/procedure.revise` · MCP `loom_procedure_revise` · 역할 `writer` · 쓰기 · 감사됨 · MCP `all` 툴셋에는 나열되지 않음

| 입력 필드 | 타입 | 기본값 | 의미 |
| --- | --- | --- | --- |
| `org` | `str` | 필수 | 테넌트(식별 튜플의 첫 번째 요소)입니다. |
| `namespace` | `str` | 필수 | op가 읽거나 쓰는 네임스페이스입니다. |
| `agent` | `str` | `'-'` | 쓰거나 읽는 에이전트입니다. `'-'` 또는 `'*'`는 op가 허용하는 경우 모든 에이전트를 의미합니다. |
| `user_id` | `str` | `'-'` | 해당 행이 속한 최종 사용자입니다. 없으면 `'-'`입니다. |
| `session_id` | `str` | `'-'` | 해당 행이 속한 세션 또는 대화입니다. 없으면 `'-'`입니다. |
| `memory_key` | `str` | 필수 | 수정할 프로시저의 키입니다(`procedure_<slug>`). |
| `graph` | `dict[str, Any]` | 필수 | 제안하는 토폴로지입니다(전체 그래프. 변경되지 않은 노드는 id를 그대로 유지하여 통계가 이어집니다). |
| `reason` | `str` | `''` | 수정 이유입니다. 실패한 실행에서 드러난 점과 이번 수정이 바꾸는 내용을 적습니다. |
| `force` | `bool` | `False` | 게이트가 이미 거부한 토폴로지라도 그대로 제안합니다. |

| 출력 필드 | 타입 | 의미 |
| --- | --- | --- |
| `memory_key` | `str` | 수정된 프로시저의 키입니다. |
| `version` | `int` | 이번 호출이 기록한 프로시저 행의 버전입니다. |
| `revision` | `int` | 새 리비전 번호입니다. 이후 기록되는 실행은 이 리비전에 집계됩니다. |
| `prior_revision` | `int` | 이 리비전이 대체하는 이전 리비전입니다(게이트가 되돌리면 복원됩니다). |
| `digest` | `str` | 제안된 토폴로지의 해시입니다. 게이트가 거부된 토폴로지를 알아보는 데 사용합니다. |
| `steps` | `list[str]` | 새 그래프에서 도출한 선형 단계 목록입니다. |

<!-- prettier-ignore-end -->
