@scotthuang/agent-knock-knock 0.13.16 → 0.13.17

package/dist/src/semantic-tool-descriptions.js

@@ -0,0 +1,259 @@
+// Model-facing wording is data; execution and authority stay in the tool runtime.
+export const semanticToolDescriptions = {
+    akk: "Send coding work through existing Codex or Claude Code shared terminals, " +
+        "inspect managed Turns, observe a user-selected terminal with durable " +
+        "read-only Terminal Watch, manage native threads, and safely inspect or " +
+        "change an idle pane's native model selection or Codex permissions.",
+    watch: "Start one durable read-only Terminal Watch for the user's exact selected " +
+        "Codex or Claude Code terminal. AKK prefers an exact durable task anchor; if " +
+        "version, artifact, task, managed-ownership, or action-advertisement evidence " +
+        "is unavailable, it remains callable and returns warnings while using " +
+        "best-effort terminal activity. That fallback reports stable-idle activity, " +
+        "not proof of exact task completion. Watch creates no AKK Session or Turn, " +
+        "sends no terminal input, and never adopts or blocks the terminal task.",
+    unwatch: "Stop one exact durable Terminal Watch by its authoritative watch_id. This " +
+        "cancels observation only; it sends no terminal input and does not interrupt, " +
+        "adopt, or otherwise mutate the human's coding-agent task.",
+    list_resumable_threads: "List structurally verified native Codex or Claude Code threads for one exact " +
+        "terminal. A valid unverified agent version remains callable with a " +
+        "compatibility warning. Resume only a row with resumable=true by passing this " +
+        "terminal_id and that row's complete native_thread_id. AKK retains candidate " +
+        "and binding freshness evidence privately. Number and short-id fields are " +
+        "slash-command display aids, never tool arguments. This is read-only for " +
+        "Session/Turn state and creates no AKK Turn.",
+    native_inspect: "Execute one closed native status inspection in an exact Codex or Claude Code " +
+        "terminal. Verified versions use their regression-tested profile; unverified " +
+        "complete x.y.z versions remain callable through the generic runtime protocol " +
+        "and return a compatibility warning. Pass only terminal_id and " +
+        "inspection=status; AKK refreshes binding authority privately. Arbitrary " +
+        "slash commands remain unavailable. This creates no AKK Session, Turn, " +
+        "receipt, monitor, or callback.",
+    new_thread: "Start and verify a clean native coding-agent thread in the exact terminal_id " +
+        "after explicit user intent. A valid unverified agent version remains " +
+        "callable with a compatibility warning. AKK refreshes lifecycle authority " +
+        "privately. Never send /clear as ordinary task text. This creates a new AKK " +
+        "Session but no Turn.",
+    reconcile_binding: "Detach one exact conflicting managed Session binding without adopting the " +
+        "live replacement thread. Pass only the advertised terminal_id and " +
+        "conflicting_session_id after explicit user confirmation; AKK refreshes all " +
+        "revision and binding authority privately. This sends no coding-agent input " +
+        "and creates no Turn.",
+    resume_thread: "Resume one exact structurally verified historical native thread after " +
+        "explicit user intent. A valid unverified agent version remains callable with " +
+        "a compatibility warning. Pass only terminal_id and one complete " +
+        "native_thread_id from a resumable=true row; AKK refreshes binding and " +
+        "candidate evidence privately. This creates or reactivates an AKK Session but " +
+        "no Turn.",
+    status: "Inspect one exact AKK-managed Turn by its authoritative turn_id, one durable " +
+        "Terminal Watch by its authoritative watch_id, or use only a raw terminal " +
+        "row's own prefilled compatibility selector. These targets are mutually " +
+        "exclusive. The deprecated conversation_id remains a legacy Turn alias and " +
+        "the list-prefilled raw-terminal input; never construct it. User-selected " +
+        "Watch status reports whether it uses an exact task anchor or best-effort " +
+        "terminal activity without implying Watch sent or adopted the task; that task " +
+        "may independently be managed. Automatic terminal_user_explicit fallback " +
+        "Watch status describes the exact request AKK physically sent without " +
+        "claiming a managed Turn. AKK never starts a coding agent.",
+    send: "Start a new AKK Turn, use one advertised terminal_user_explicit " +
+        "user-priority send, or explicitly recover one current uncertain submission " +
+        "only through its advertised retry_submission action. Ordinary send requires " +
+        "request and may use session_id or terminal_id exactly as advertised. " +
+        "terminal_user_explicit requires one exact live physical terminal/process, a " +
+        "scanned non-blocked approval state, and no input-owning native " +
+        "questionnaire/editor, menu, or read-only viewer; parsed working activity, " +
+        "Codex rollout ambiguity, AKK management state, ordinary main-Composer " +
+        "visibility, stability, exactness, and existing draft contents do not veto " +
+        "physical delivery. Profiled Codex 0.154.0/0.155.1 exact collapsed " +
+        "async-question summaries remain sendable, while expanded, clipped, or " +
+        "ambiguous editors receive zero input. Codex sends C-u once to replace the " +
+        "current Composer; Claude Code uses a sentinel-backed native C-s stash-clear " +
+        "transaction that is independent of the cursor position and does not " +
+        "interrupt an active turn, then proves the main Composer empty. Each injects " +
+        "the request, waits through the paste window, and dispatches Enter exactly " +
+        "once without a post-text Composer veto. A source-less Codex terminal freezes " +
+        "all current rollout roots before input, then promotes a provisional " +
+        "Session/Turn only when exactly one anchored or newly opened rollout durably " +
+        "accepts the exact request hash; zero matches remain pending and ambiguity " +
+        "becomes uncertain without replay. If managed preparation fails before input, " +
+        "AKK still delivers once as unmanaged work, then best-effort attaches an " +
+        "exact Terminal Watch callback. After exact request acceptance and terminal " +
+        "attribution, a supported questionnaire on that Watch may expose owner-bound " +
+        "response authority through Status and its watch_id; terminal-activity " +
+        "observations and manual_required interactions remain notification-only. Read " +
+        "terminal_input_dispatched, agent_acceptance, management_mode, " +
+        "observation_mode, and capabilities independently. Watch attachment failure " +
+        "never changes a successful Send. Once the mutation sequence begins, an " +
+        "uncertain result must not be automatically retried. Retry submission is the " +
+        "mutually exclusive exact {turn_id} form and cannot change request text or " +
+        "routing. Draft text, composer digests, and opaque freshness authority stay " +
+        "private. A Turn id is never an ordinary-send destination. Managed acceptance " +
+        "is asynchronous: yield and wait for its callback or an explicit status " +
+        "request.",
+    respond: "Respond to a question or blocked callback in one exact in-flight AKK turn. " +
+        "This continues that turn and does not create a new turn; for later ordinary " +
+        "work refresh agent_knock_knock_list and use that terminal row's currently " +
+        "advertised send action.",
+    respond_interaction: "Answer exactly one current native interaction step shown by " +
+        "agent_knock_knock_status in this controller conversation. Supply exactly one " +
+        "authoritative subject target: turn_id for a managed Turn or watch_id for an " +
+        "interactive Terminal Watch, plus interaction_id and one typed semantic " +
+        "answer. single_select uses selected_option_ids with one advertised " +
+        "option_id; free_text uses text; confirm uses confirm. For async_question, " +
+        "delivery_mode defaults to steer_current_turn; select queue_next_turn " +
+        "explicitly only when advertised; omit it for a blocking questionnaire. AKK " +
+        "consumes only that subject's displayed private offer and revalidates the " +
+        "exact discriminator-specific shape, prompt, owner, task attribution, and " +
+        "terminal authority before any input. A displayed expiry is a freshness " +
+        "boundary: after it passes, AKK must prove the same exact live interaction " +
+        "again instead of rejecting an otherwise live prompt. Raw keys, menu indexes, " +
+        "rendered labels, fingerprints, versions, and terminal commands are never " +
+        "accepted. An uncertain response must never be retried blindly.",
+    approve: "Dispatch one closed semantic decision for the current exact permission " +
+        "request only after the user reviews and explicitly chooses it. decision " +
+        "defaults to approve_once for compatibility; reject is available only on a " +
+        "managed Turn when the adapter proves a safe native reject choice. Use " +
+        "turn_id for a managed Turn or terminal_id for a separately advertised " +
+        "approve_once-only terminal action. AKK privately refreshes the prompt and " +
+        "authority, then recaptures it under lock. Raw keys, indexes, and labels are " +
+        "not accepted. Never retry an interrupted decision blindly.",
+    renew: "Renew monitoring for one exact stalled turn_id without sending text or keys " +
+        "to the coding agent. Use this when the user wants a still-live long-running " +
+        "terminal task to keep monitoring after an inactivity stall.",
+    retry_callback: "Retry a persisted AKK callback for an exact turn that failed before reaching " +
+        "the controller Host. The original callback message id and turn identity are " +
+        "reused for idempotent delivery.",
+    cancel: "Interrupt one exact AKK turn_id, or use only an unmanaged raw terminal row's " +
+        "own prefilled cancel action. Claude sends Escape; Codex uses its declared " +
+        "interrupt key. The shared terminal pane remains open for human takeover.",
+    close: "Honor an explicit user request to close one managed turn_id and release AKK " +
+        "management. Raw orphan recovery may instead use conversation_id with " +
+        "expected_message_id or expected_transition_id. Close never sends terminal " +
+        "input, stops the coding agent, or closes the shared pane. Deferred transfer, " +
+        "Session, ledger, and callback cleanup is best-effort and cannot veto closing " +
+        "the Turn; warnings identify metadata AKK preserved. Refresh list afterward " +
+        "and use Watch if the coding agent is still working.",
+    list: "List live AKK terminal resources and Terminal Watches. The model-facing " +
+        "result is a compact projection: available_actions contains current semantic " +
+        "action names and action_inputs contains only their dynamic semantic inputs. " +
+        "Follow the installed agent-knock-knock skill for action meaning, target " +
+        "rules, safety boundaries, and recovery behavior; AKK privately revalidates " +
+        "every mutation.",
+    model_options: "Inspect the exact current native model catalog for one explicitly selected " +
+        "physical Codex or Claude Code pane. This is the required read-only first " +
+        "step before set_model. Profiled Codex 0.154.0/0.155.1 accepts one exact " +
+        "current native Session or a verified-zero-rollout pane without " +
+        "identify_foreground; Claude Code still requires one exact current native " +
+        "Session. AKK requires an exact live pane/process, no active Turn, and no " +
+        "approval, questionnaire/editor, or read-only viewer. The Composer must be " +
+        "empty unless current List privately binds this action to one exact stable " +
+        "profiled Codex 0.154.0/0.155.1 /model residual, which AKK may continue into " +
+        "the native picker without retyping it. That residual-bound authority is " +
+        "consumed by discovery; after restoring an exact empty Composer, AKK retains " +
+        "only fresh ordinary terminal/catalog authority for one set_model attempt in " +
+        "this exact controller conversation. It obtains model ids and " +
+        "reasoning-effort values from the native UI/runtime and exposes only semantic " +
+        "choices. Codex advertises scope=current_and_new_sessions; Claude Code " +
+        "advertises scope=current_session. Arbitrary commands, keys, menu indexes, " +
+        "labels, and hidden authority are never accepted.",
+    repair_model_control: "Clear one exact stale profiled Codex 0.154.0/0.155.1 /model completion " +
+        "surface, exact bare /model Composer, or exact open native model picker left " +
+        "by a failed native model-control attempt. This explicit one-shot repair is " +
+        "available only when the current AKK list proves the same exact pane/process, " +
+        "the closed profiled model-control residue, no active Turn, and no approval, " +
+        "questionnaire/editor, or read-only viewer. Pass only terminal_id; AKK " +
+        "privately derives and revalidates every physical, screen, and Composer fence " +
+        "before each reversible cleanup input. It never submits a task, selects a " +
+        "model, approves a prompt, accepts raw commands or keys, or automatically " +
+        "continues into model_options/set_model. An open picker receives dismissal " +
+        "authority only, never Enter authority. outcome=uncertain must never be " +
+        "retried automatically.",
+    set_model: "Change exactly one already-open physical coding-agent pane to one semantic " +
+        "model and reasoning-effort tuple from the immediately preceding " +
+        "model_options result in this same controller conversation. AKK consumes the " +
+        "private current-snapshot offer, revalidates the exact pane/process plus idle " +
+        "and empty native UI under lock, rejects active Turns and every input-owning " +
+        "prompt/viewer, and verifies the effective postcondition. Profiled Codex " +
+        "0.154.0/0.155.1 accepts one exact current native Session or a " +
+        "verified-zero-rollout pane without identify_foreground; Claude Code still " +
+        "requires one exact current native Session. Codex scope is " +
+        "current_and_new_sessions: the model and ordinary efforts (including max) are " +
+        "persisted, but ultra remains current-session-only; the future model is " +
+        "reported while the native TUI's unobservable fallback effort is omitted. " +
+        "Claude Code scope is current_session and leaves future defaults unchanged. " +
+        "Parameters never accept scope, raw commands, slash text, keys, menu indexes, " +
+        "display labels, fingerprints, or tokens. outcome=uncertain must never be " +
+        "retried automatically.",
+    identify_foreground: "Explicitly identify the foreground Codex native thread in one exact idle " +
+        "terminal by issuing the closed /status probe once. The result is a " +
+        "short-lived diagnostic bound to the current pane, process, cwd, and screen " +
+        "generation; it creates no Session or Turn and grants no later response, " +
+        "approval, lifecycle, or send authority. Ordinary list/status never runs this " +
+        "probe.",
+    identify_and_send: "Explicitly identify the foreground Codex native thread with one closed " +
+        "/status probe, then dispatch one task while retaining the same terminal " +
+        "lock. This is an optional managed-attachment enhancement, not a prerequisite " +
+        "for ordinary human Send. The short-lived status observation never becomes " +
+        "durable identity: only the rollout that uniquely accepts the exact task may " +
+        "own the resulting Session/Turn. If the probe or boundary becomes uncertain, " +
+        "AKK does not send or retry the task.",
+};
+export const semanticCommandGuidance = [
+    "Use /akk permissions on an advertised idle Codex terminal before /akk " +
+        "set-permissions. Read the current permission mode and returned built-in " +
+        "choices, then apply the requested or authorized mode. Full Access is an " +
+        "ordinary option with no additional user confirmation; AKK automatically " +
+        "handles its native confirmation inside the closed permission transaction, " +
+        "never through generic approve. Ordinary Send does not change permissions. " +
+        "Scope is the current session/thread and may survive Resume; global defaults " +
+        "remain unchanged. Send the task only after a verified matching effective " +
+        "mode. An uncertain result must not be retried automatically.",
+    "Use /akk <task> when exactly one send-ready coding-agent terminal pane " +
+        "should receive new work. Send-ready means an exact live process and terminal " +
+        "plus a scanned, non-blocked approval state. Parsed working activity and " +
+        "ordinary main-Composer visibility, stability, exactness, or existing draft " +
+        "contents do not veto this user-priority path. A proven input-owning native " +
+        "approval, questionnaire/editor, menu, or read-only viewer remains a " +
+        "zero-input boundary; profiled Codex 0.154.0/0.155.1 exact collapsed " +
+        "async-question summaries remain sendable, while expanded, clipped, or " +
+        "ambiguous editors do not. Codex sends C-u once to replace the current " +
+        "Composer; Claude Code uses a sentinel-backed native C-s stash-clear " +
+        "transaction that is independent of the cursor position and does not " +
+        "interrupt an active turn, then proves the main Composer empty. Each injects " +
+        "the request, waits through the paste window, and dispatches Enter exactly " +
+        "once; after text injection, no Composer observation may veto Enter. Managed " +
+        "Send may still require exact empty before input, while native inspection and " +
+        "native lifecycle input remain exact-empty-only. Broken or stale AKK " +
+        "management activity records do not veto the user's physical Send. Structured " +
+        "tools use only semantic identifiers returned by AKK: session_id for an exact " +
+        "managed context, terminal_id for the currently verified pane, turn_id for " +
+        "one managed Turn, watch_id for one Terminal Watch, and native_thread_id for " +
+        "one resumable native thread. Draft text, composer digests, and opaque " +
+        "freshness authority stay private; AKK revalidates them under its locks. Once " +
+        "the mutation sequence begins, an uncertain result must not be automatically " +
+        "retried. /akk watch is read-only and follows user intent: it prefers an " +
+        "exact task anchor, but version, artifact, managed ownership, and " +
+        "action-advertisement uncertainty degrade to a warning-bearing " +
+        "terminal-activity Watch instead of vetoing the request. New/clear/resume, " +
+        "approval, reconciliation, handoff, and recovery still require the documented " +
+        "user intent or explicit confirmation. AKK never starts a coding-agent " +
+        "process.",
+    "Use /akk models on one exact currently advertised physical pane before /akk " +
+        "set-model. Profiled Codex 0.154.0/0.155.1 may use either one exact current " +
+        "native Session or a verified-zero-rollout pane; identify_foreground is " +
+        "diagnostic and is never a prerequisite for that zero-rollout path. Claude " +
+        "Code still requires one exact current native Session. Both steps require no " +
+        "active Turn and no approval, questionnaire/editor, or read-only viewer. " +
+        "model_options normally requires an empty Composer; when List binds it to one " +
+        "exact stable Codex /model residual, it may continue only that residual into " +
+        "read-only catalog discovery. repair_model_control remains the separate " +
+        "clear-only alternative and never presses Enter or selects anything. Only ids " +
+        "and reasoning efforts from that current native catalog are valid. Codex " +
+        "changes the current session and persists the selected model for future " +
+        "sessions; ordinary efforts, including max, are also persisted, while ultra " +
+        "remains current-session-only and Codex chooses a non-ultra future fallback. " +
+        "Claude Code changes only the current session. Read effective and " +
+        "new_session_defaults separately. Model control never accepts slash text, raw " +
+        "keys, menu indexes, display labels, scope overrides, or private authority; " +
+        "an uncertain outcome must not be retried automatically."
+];
+//# sourceMappingURL=semantic-tool-descriptions.js.map

package/dist/src/semantic-tool-descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-tool-descriptions.js","sourceRoot":"","sources":["../../src/semantic-tool-descriptions.ts"],"names":[],"mappings":"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"}

package/dist/src/semantic-tool-runtime.js

@@ -1,3 +1,4 @@
+import { semanticCommandGuidance, semanticToolDescriptions } from "./semantic-tool-descriptions.js";
 import { createHash, randomUUID } from "node:crypto";
 import { isRecord, nonBlankString as stringValue } from "./value-guards.js";
 import { AKK_CALLBACK_METHOD, akkUsageText, buildAkkCommandCliArgs, compactAkkListModelProjection, formatAkkListCommandResult, formatAkkModelOptionsCommandResult, formatAkkRepairModelControlCommandResult, formatAkkRespondCommandResult, formatAkkSetModelCommandResult, formatAkkThreadsCommandResult, formatAkkThreadTransitionCommandResult, formatAkkUnwatchCommandResult, formatAkkWatchCommandResult, isAkkRepairModelControlSuccess, isAkkSetModelSuccess, isAkkThreadTransitionSuccess, parseAkkCommand, resolvePluginStoreDir } from "./semantic-tool-command-helpers.js";
@@ -27,21 +28,17 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     beginSemanticToolCatalog(api);
     const command = {
         name: "akk",
-        description: "Send coding work through existing Codex or Claude Code shared terminals, inspect managed Turns, observe a user-selected terminal with durable read-only Terminal Watch, manage native threads, and safely inspect or change an idle pane's native model selection or Codex permissions.",
+        description: semanticToolDescriptions.akk,
         acceptsArgs: true,
         requiresAuthentication: true,
         progressMessage: "AKK is handling the request...",
-        promptGuidance: [
-            "Use /akk permissions on an advertised idle Codex terminal before /akk set-permissions. Read the current permission mode and returned built-in choices, then apply the requested or authorized mode. Full Access is an ordinary option with no additional user confirmation; AKK automatically handles its native confirmation inside the closed permission transaction, never through generic approve. Ordinary Send does not change permissions. Scope is the current session/thread and may survive Resume; global defaults remain unchanged. Send the task only after a verified matching effective mode. An uncertain result must not be retried automatically.",
-            "Use /akk <task> when exactly one send-ready coding-agent terminal pane should receive new work. Send-ready means an exact live process and terminal plus a scanned, non-blocked approval state. Parsed working activity and ordinary main-Composer visibility, stability, exactness, or existing draft contents do not veto this user-priority path. A proven input-owning native approval, questionnaire/editor, menu, or read-only viewer remains a zero-input boundary; profiled Codex 0.154.0/0.155.1 exact collapsed async-question summaries remain sendable, while expanded, clipped, or ambiguous editors do not. Codex sends C-u once to replace the current Composer; Claude Code uses a sentinel-backed native C-s stash-clear transaction that is independent of the cursor position and does not interrupt an active turn, then proves the main Composer empty. Each injects the request, waits through the paste window, and dispatches Enter exactly once; after text injection, no Composer observation may veto Enter. Managed Send may still require exact empty before input, while native inspection and native lifecycle input remain exact-empty-only. Broken or stale AKK management activity records do not veto the user's physical Send. Structured tools use only semantic identifiers returned by AKK: session_id for an exact managed context, terminal_id for the currently verified pane, turn_id for one managed Turn, watch_id for one Terminal Watch, and native_thread_id for one resumable native thread. Draft text, composer digests, and opaque freshness authority stay private; AKK revalidates them under its locks. Once the mutation sequence begins, an uncertain result must not be automatically retried. /akk watch is read-only and follows user intent: it prefers an exact task anchor, but version, artifact, managed ownership, and action-advertisement uncertainty degrade to a warning-bearing terminal-activity Watch instead of vetoing the request. New/clear/resume, approval, reconciliation, handoff, and recovery still require the documented user intent or explicit confirmation. AKK never starts a coding-agent process.",
-            "Use /akk models on one exact currently advertised physical pane before /akk set-model. Profiled Codex 0.154.0/0.155.1 may use either one exact current native Session or a verified-zero-rollout pane; identify_foreground is diagnostic and is never a prerequisite for that zero-rollout path. Claude Code still requires one exact current native Session. Both steps require no active Turn and no approval, questionnaire/editor, or read-only viewer. model_options normally requires an empty Composer; when List binds it to one exact stable Codex /model residual, it may continue only that residual into read-only catalog discovery. repair_model_control remains the separate clear-only alternative and never presses Enter or selects anything. Only ids and reasoning efforts from that current native catalog are valid. Codex changes the current session and persists the selected model for future sessions; ordinary efforts, including max, are also persisted, while ultra remains current-session-only and Codex chooses a non-ultra future fallback. Claude Code changes only the current session. Read effective and new_session_defaults separately. Model control never accepts slash text, raw keys, menu indexes, display labels, scope overrides, or private authority; an uncertain outcome must not be retried automatically."
-        ],
+        promptGuidance: [...semanticCommandGuidance],
         execute: async (ctx) => handleAkkCommand(api, ctx, displayedResumeSnapshots)
     };
     registerSemanticListTool(api);
     registerCliTool(api, {
         name: "agent_knock_knock_watch",
-        description: "Start one durable read-only Terminal Watch for the user's exact selected Codex or Claude Code terminal. AKK prefers an exact durable task anchor; if version, artifact, task, managed-ownership, or action-advertisement evidence is unavailable, it remains callable and returns warnings while using best-effort terminal activity. That fallback reports stable-idle activity, not proof of exact task completion. Watch creates no AKK Session or Turn, sends no terminal input, and never adopts or blocks the terminal task.",
+        description: semanticToolDescriptions.watch,
         parameters: watchParameters,
         normalizeTurnIdentity: false,
         buildArgs: (params, toolContext) => {
@@ -63,7 +60,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_unwatch",
-        description: "Stop one exact durable Terminal Watch by its authoritative watch_id. This cancels observation only; it sends no terminal input and does not interrupt, adopt, or otherwise mutate the human's coding-agent task.",
+        description: semanticToolDescriptions.unwatch,
         parameters: unwatchParameters,
         normalizeTurnIdentity: false,
         buildArgs: (params) => {
@@ -79,7 +76,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_list_resumable_threads",
-        description: "List structurally verified native Codex or Claude Code threads for one exact terminal. A valid unverified agent version remains callable with a compatibility warning. Resume only a row with resumable=true by passing this terminal_id and that row's complete native_thread_id. AKK retains candidate and binding freshness evidence privately. Number and short-id fields are slash-command display aids, never tool arguments. This is read-only for Session/Turn state and creates no AKK Turn.",
+        description: semanticToolDescriptions.list_resumable_threads,
         parameters: listResumableThreadsParameters,
         normalizeTurnIdentity: false,
         buildArgs: (params) => {
@@ -96,7 +93,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_native_inspect",
-        description: "Execute one closed native status inspection in an exact Codex or Claude Code terminal. Verified versions use their regression-tested profile; unverified complete x.y.z versions remain callable through the generic runtime protocol and return a compatibility warning. Pass only terminal_id and inspection=status; AKK refreshes binding authority privately. Arbitrary slash commands remain unavailable. This creates no AKK Session, Turn, receipt, monitor, or callback.",
+        description: semanticToolDescriptions.native_inspect,
         parameters: nativeInspectParameters,
         normalizeTurnIdentity: false,
         buildArgs: async (params) => {
@@ -126,7 +123,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     registerForegroundIdentificationTools(api);
     registerCliTool(api, {
         name: "agent_knock_knock_new_thread",
-        description: "Start and verify a clean native coding-agent thread in the exact terminal_id after explicit user intent. A valid unverified agent version remains callable with a compatibility warning. AKK refreshes lifecycle authority privately. Never send /clear as ordinary task text. This creates a new AKK Session but no Turn.",
+        description: semanticToolDescriptions.new_thread,
         parameters: newThreadParameters,
         normalizeTurnIdentity: false,
         isErrorResult: (result) => !isAkkThreadTransitionSuccess(result),
@@ -148,7 +145,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_reconcile_binding",
-        description: "Detach one exact conflicting managed Session binding without adopting the live replacement thread. Pass only the advertised terminal_id and conflicting_session_id after explicit user confirmation; AKK refreshes all revision and binding authority privately. This sends no coding-agent input and creates no Turn.",
+        description: semanticToolDescriptions.reconcile_binding,
         parameters: reconcileBindingParameters,
         normalizeTurnIdentity: false,
         buildArgs: async (params, toolContext) => {
@@ -190,7 +187,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_resume_thread",
-        description: "Resume one exact structurally verified historical native thread after explicit user intent. A valid unverified agent version remains callable with a compatibility warning. Pass only terminal_id and one complete native_thread_id from a resumable=true row; AKK refreshes binding and candidate evidence privately. This creates or reactivates an AKK Session but no Turn.",
+        description: semanticToolDescriptions.resume_thread,
         parameters: resumeThreadParameters,
         normalizeTurnIdentity: false,
         isErrorResult: (result) => !isAkkThreadTransitionSuccess(result),
@@ -226,7 +223,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     defineSemanticCatalogTool(api, {
         label: "AKK Status",
         name: "agent_knock_knock_status",
-        description: "Inspect one exact AKK-managed Turn by its authoritative turn_id, one durable Terminal Watch by its authoritative watch_id, or use only a raw terminal row's own prefilled compatibility selector. These targets are mutually exclusive. The deprecated conversation_id remains a legacy Turn alias and the list-prefilled raw-terminal input; never construct it. User-selected Watch status reports whether it uses an exact task anchor or best-effort terminal activity without implying Watch sent or adopted the task; that task may independently be managed. Automatic terminal_user_explicit fallback Watch status describes the exact request AKK physically sent without claiming a managed Turn. AKK never starts a coding agent.",
+        description: semanticToolDescriptions.status,
         inputSchema: statusParameters,
         async execute(toolContext, _toolCallId, params, signal) {
             return withHostBridgeInvocationSignal(signal, async () => {
@@ -246,7 +243,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     defineSemanticCatalogTool(api, {
         label: "AKK Send",
         name: "agent_knock_knock_send",
-        description: "Start a new AKK Turn, use one advertised terminal_user_explicit user-priority send, or explicitly recover one current uncertain submission only through its advertised retry_submission action. Ordinary send requires request and may use session_id or terminal_id exactly as advertised. terminal_user_explicit requires one exact live physical terminal/process, a scanned non-blocked approval state, and no input-owning native questionnaire/editor, menu, or read-only viewer; parsed working activity, Codex rollout ambiguity, AKK management state, ordinary main-Composer visibility, stability, exactness, and existing draft contents do not veto physical delivery. Profiled Codex 0.154.0/0.155.1 exact collapsed async-question summaries remain sendable, while expanded, clipped, or ambiguous editors receive zero input. Codex sends C-u once to replace the current Composer; Claude Code uses a sentinel-backed native C-s stash-clear transaction that is independent of the cursor position and does not interrupt an active turn, then proves the main Composer empty. Each injects the request, waits through the paste window, and dispatches Enter exactly once without a post-text Composer veto. A source-less Codex terminal freezes all current rollout roots before input, then promotes a provisional Session/Turn only when exactly one anchored or newly opened rollout durably accepts the exact request hash; zero matches remain pending and ambiguity becomes uncertain without replay. If managed preparation fails before input, AKK still delivers once as unmanaged work, then best-effort attaches an exact Terminal Watch callback. After exact request acceptance and terminal attribution, a supported questionnaire on that Watch may expose owner-bound response authority through Status and its watch_id; terminal-activity observations and manual_required interactions remain notification-only. Read terminal_input_dispatched, agent_acceptance, management_mode, observation_mode, and capabilities independently. Watch attachment failure never changes a successful Send. Once the mutation sequence begins, an uncertain result must not be automatically retried. Retry submission is the mutually exclusive exact {turn_id} form and cannot change request text or routing. Draft text, composer digests, and opaque freshness authority stay private. A Turn id is never an ordinary-send destination. Managed acceptance is asynchronous: yield and wait for its callback or an explicit status request.",
+        description: semanticToolDescriptions.send,
         inputSchema: sendParameters,
         async execute(toolContext, toolCallId, params, signal) {
             return withHostBridgeInvocationSignal(signal, async () => {
@@ -267,7 +264,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_respond",
-        description: "Respond to a question or blocked callback in one exact in-flight AKK turn. This continues that turn and does not create a new turn; for later ordinary work refresh agent_knock_knock_list and use that terminal row's currently advertised send action.",
+        description: semanticToolDescriptions.respond,
         parameters: respondParameters,
         buildArgs: (params, toolContext, toolCallId) => {
             const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
@@ -292,7 +289,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_respond_interaction",
-        description: "Answer exactly one current native interaction step shown by agent_knock_knock_status in this controller conversation. Supply exactly one authoritative subject target: turn_id for a managed Turn or watch_id for an interactive Terminal Watch, plus interaction_id and one typed semantic answer. single_select uses selected_option_ids with one advertised option_id; free_text uses text; confirm uses confirm. For async_question, delivery_mode defaults to steer_current_turn; select queue_next_turn explicitly only when advertised; omit it for a blocking questionnaire. AKK consumes only that subject's displayed private offer and revalidates the exact discriminator-specific shape, prompt, owner, task attribution, and terminal authority before any input. A displayed expiry is a freshness boundary: after it passes, AKK must prove the same exact live interaction again instead of rejecting an otherwise live prompt. Raw keys, menu indexes, rendered labels, fingerprints, versions, and terminal commands are never accepted. An uncertain response must never be retried blindly.",
+        description: semanticToolDescriptions.respond_interaction,
         parameters: respondInteractionParameters,
         buildArgs: (params, toolContext) => buildPrivateInteractionResponseArgs(api, params, {
             sessionKey: requiredControllerSessionKey(toolContext?.sessionKey),
@@ -301,7 +298,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_approve",
-        description: "Dispatch one closed semantic decision for the current exact permission request only after the user reviews and explicitly chooses it. decision defaults to approve_once for compatibility; reject is available only on a managed Turn when the adapter proves a safe native reject choice. Use turn_id for a managed Turn or terminal_id for a separately advertised approve_once-only terminal action. AKK privately refreshes the prompt and authority, then recaptures it under lock. Raw keys, indexes, and labels are not accepted. Never retry an interrupted decision blindly.",
+        description: semanticToolDescriptions.approve,
         parameters: approveParameters,
         buildArgs: (params, toolContext) => buildPrivateApprovalArgs(api, params, {
             sessionKey: requiredControllerSessionKey(toolContext?.sessionKey),
@@ -310,7 +307,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_renew",
-        description: "Renew monitoring for one exact stalled turn_id without sending text or keys to the coding agent. Use this when the user wants a still-live long-running terminal task to keep monitoring after an inactivity stall.",
+        description: semanticToolDescriptions.renew,
         parameters: renewParameters,
         buildArgs: (params) => {
             const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
@@ -323,7 +320,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_retry_callback",
-        description: "Retry a persisted AKK callback for an exact turn that failed before reaching the controller Host. The original callback message id and turn identity are reused for idempotent delivery.",
+        description: semanticToolDescriptions.retry_callback,
         parameters: retryCallbackParameters,
         buildArgs: (params) => {
             const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
@@ -335,7 +332,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_cancel",
-        description: "Interrupt one exact AKK turn_id, or use only an unmanaged raw terminal row's own prefilled cancel action. Claude sends Escape; Codex uses its declared interrupt key. The shared terminal pane remains open for human takeover.",
+        description: semanticToolDescriptions.cancel,
         parameters: cancelParameters,
         buildArgs: (params) => {
             const config = isRecord(api.pluginConfig) ? api.pluginConfig : {};
@@ -348,7 +345,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_close",
-        description: "Honor an explicit user request to close one managed turn_id and release AKK management. Raw orphan recovery may instead use conversation_id with expected_message_id or expected_transition_id. Close never sends terminal input, stops the coding agent, or closes the shared pane. Deferred transfer, Session, ledger, and callback cleanup is best-effort and cannot veto closing the Turn; warnings identify metadata AKK preserved. Refresh list afterward and use Watch if the coding agent is still working.",
+        description: semanticToolDescriptions.close,
         parameters: closeParameters,
         isErrorResult: isBlockedTerminalDispatchResult,
         buildArgs: (params) => {
@@ -368,7 +365,7 @@ export function createAkkSemanticToolCatalog(api, displayedResumeSnapshots) {
 function registerSemanticListTool(api) {
     registerCliTool(api, {
         name: "agent_knock_knock_list",
-        description: "List live AKK terminal resources and Terminal Watches. The model-facing result is a compact projection: available_actions contains current semantic action names and action_inputs contains only their dynamic semantic inputs. Follow the installed agent-knock-knock skill for action meaning, target rules, safety boundaries, and recovery behavior; AKK privately revalidates every mutation.",
+        description: semanticToolDescriptions.list,
         parameters: listParameters,
         modelProjection: compactAkkListModelProjection,
         compactText: true,
@@ -393,7 +390,7 @@ function registerSemanticListTool(api) {
 function registerModelControlTools(api) {
     registerCliTool(api, {
         name: "agent_knock_knock_model_options",
-        description: "Inspect the exact current native model catalog for one explicitly selected physical Codex or Claude Code pane. This is the required read-only first step before set_model. Profiled Codex 0.154.0/0.155.1 accepts one exact current native Session or a verified-zero-rollout pane without identify_foreground; Claude Code still requires one exact current native Session. AKK requires an exact live pane/process, no active Turn, and no approval, questionnaire/editor, or read-only viewer. The Composer must be empty unless current List privately binds this action to one exact stable profiled Codex 0.154.0/0.155.1 /model residual, which AKK may continue into the native picker without retyping it. That residual-bound authority is consumed by discovery; after restoring an exact empty Composer, AKK retains only fresh ordinary terminal/catalog authority for one set_model attempt in this exact controller conversation. It obtains model ids and reasoning-effort values from the native UI/runtime and exposes only semantic choices. Codex advertises scope=current_and_new_sessions; Claude Code advertises scope=current_session. Arbitrary commands, keys, menu indexes, labels, and hidden authority are never accepted.",
+        description: semanticToolDescriptions.model_options,
         parameters: modelOptionsParameters,
         timeoutMs: MODEL_OPTIONS_CLI_TIMEOUT_MS,
         normalizeTurnIdentity: false,
@@ -417,7 +414,7 @@ function registerModelControlTools(api) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_repair_model_control",
-        description: "Clear one exact stale profiled Codex 0.154.0/0.155.1 /model completion surface, exact bare /model Composer, or exact open native model picker left by a failed native model-control attempt. This explicit one-shot repair is available only when the current AKK list proves the same exact pane/process, the closed profiled model-control residue, no active Turn, and no approval, questionnaire/editor, or read-only viewer. Pass only terminal_id; AKK privately derives and revalidates every physical, screen, and Composer fence before each reversible cleanup input. It never submits a task, selects a model, approves a prompt, accepts raw commands or keys, or automatically continues into model_options/set_model. An open picker receives dismissal authority only, never Enter authority. outcome=uncertain must never be retried automatically.",
+        description: semanticToolDescriptions.repair_model_control,
         parameters: repairModelControlParameters,
         timeoutMs: REPAIR_MODEL_CONTROL_CLI_TIMEOUT_MS,
         normalizeTurnIdentity: false,
@@ -441,7 +438,7 @@ function registerModelControlTools(api) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_set_model",
-        description: "Change exactly one already-open physical coding-agent pane to one semantic model and reasoning-effort tuple from the immediately preceding model_options result in this same controller conversation. AKK consumes the private current-snapshot offer, revalidates the exact pane/process plus idle and empty native UI under lock, rejects active Turns and every input-owning prompt/viewer, and verifies the effective postcondition. Profiled Codex 0.154.0/0.155.1 accepts one exact current native Session or a verified-zero-rollout pane without identify_foreground; Claude Code still requires one exact current native Session. Codex scope is current_and_new_sessions: the model and ordinary efforts (including max) are persisted, but ultra remains current-session-only; the future model is reported while the native TUI's unobservable fallback effort is omitted. Claude Code scope is current_session and leaves future defaults unchanged. Parameters never accept scope, raw commands, slash text, keys, menu indexes, display labels, fingerprints, or tokens. outcome=uncertain must never be retried automatically.",
+        description: semanticToolDescriptions.set_model,
         parameters: setModelParameters,
         timeoutMs: SET_MODEL_CLI_TIMEOUT_MS,
         normalizeTurnIdentity: false,
@@ -455,7 +452,7 @@ function registerModelControlTools(api) {
 function registerForegroundIdentificationTools(api) {
     registerCliTool(api, {
         name: "agent_knock_knock_identify_foreground",
-        description: "Explicitly identify the foreground Codex native thread in one exact idle terminal by issuing the closed /status probe once. The result is a short-lived diagnostic bound to the current pane, process, cwd, and screen generation; it creates no Session or Turn and grants no later response, approval, lifecycle, or send authority. Ordinary list/status never runs this probe.",
+        description: semanticToolDescriptions.identify_foreground,
         parameters: identifyForegroundParameters,
         normalizeTurnIdentity: false,
         buildArgs: async (params) => {
@@ -476,7 +473,7 @@ function registerForegroundIdentificationTools(api) {
     });
     registerCliTool(api, {
         name: "agent_knock_knock_identify_and_send",
-        description: "Explicitly identify the foreground Codex native thread with one closed /status probe, then dispatch one task while retaining the same terminal lock. This is an optional managed-attachment enhancement, not a prerequisite for ordinary human Send. The short-lived status observation never becomes durable identity: only the rollout that uniquely accepts the exact task may own the resulting Session/Turn. If the probe or boundary becomes uncertain, AKK does not send or retry the task.",
+        description: semanticToolDescriptions.identify_and_send,
         parameters: identifyAndSendParameters,
         isErrorResult: isSubmissionError,
         buildArgs: async (params, toolContext, toolCallId) => {
@@ -708,7 +705,9 @@ async function handleAkkLifecycleCommand(api, ctx, parsed, config, displayedResu
     if (parsed.action === "resume-thread" &&
         parsed.selection &&
         ["number", "short-id"].includes(parsed.selection.kind)) {
-        requiredString(ctx.sessionId, "Controller conversation incarnation is required for number or short-id Resume; run /akk threads again in the current conversation or use the complete UUID");
+        requiredString(ctx.sessionId, "Controller conversation incarnation is required for number or short-id " +
+            "Resume; run /akk threads again in the current conversation or use the " +
+            "complete UUID");
         const mutationArgs = buildAkkCommandCliArgs(parsed, config, {
             sessionKey: ctx.sessionKey,
             selectionScope,
@@ -853,7 +852,8 @@ async function runSendRequest(api, params, toolContext, messageId) {
     if (Object.hasOwn(params, "turn_id")) {
         const unexpected = Object.keys(params).filter((key) => key !== "turn_id");
         if (unexpected.length > 0) {
-            throw new Error("send retry_submission accepts exactly turn_id; do not pass request, terminal_id, session_id, timeout overrides, or callback route data");
+            throw new Error("send retry_submission accepts exactly turn_id; do not pass request, " +
+                "terminal_id, session_id, timeout overrides, or callback route data");
         }
         const turnId = authoritativeManagedId(params.turn_id, "turn_id");
         await privateActionArguments(api, {
@@ -1057,7 +1057,9 @@ async function runDelegate(api, params, toolContext) {
                 do_not_retry: true,
                 reason: parsed.reason,
                 openclaw_next_action: parsed.openclaw_next_action,
-                note: "AKK sent the terminal input but could not fence later side effects to an exact native session. Do not retry or continue automatically; inspect the pane and close this Turn."
+                note: "AKK sent the terminal input but could not fence later side effects to an " +
+                    "exact native session. Do not retry or continue automatically; inspect the " +
+                    "pane and close this Turn."
             }
             : submissionUncertain
                 ? {
@@ -1065,7 +1067,8 @@ async function runDelegate(api, params, toolContext) {
                     do_not_retry: true,
                     reason: parsed.reason,
                     openclaw_next_action: parsed.openclaw_next_action,
-                    note: "AKK could not prove whether the terminal accepted Enter. Do not retry automatically; inspect the exact AKK Turn record and shared terminal."
+                    note: "AKK could not prove whether the terminal accepted Enter. Do not retry " +
+                        "automatically; inspect the exact AKK Turn record and shared terminal."
                 }
                 : submissionAborted
                     ? parsed.safe_to_retry === true && parsed.do_not_retry !== true
@@ -1083,7 +1086,8 @@ async function runDelegate(api, params, toolContext) {
                             do_not_retry: true,
                             reason: parsed.reason,
                             openclaw_next_action: parsed.openclaw_next_action,
-                            note: "AKK could not prove a durable safe abort. Do not retry automatically; inspect the exact Turn and terminal dispatch ledger."
+                            note: "AKK could not prove a durable safe abort. Do not retry automatically; " +
+                                "inspect the exact Turn and terminal dispatch ledger."
                         }
                     : submissionNotAccepted
                         ? {
@@ -1091,7 +1095,8 @@ async function runDelegate(api, params, toolContext) {
                             do_not_retry: true,
                             reason: parsed.reason,
                             openclaw_next_action: parsed.openclaw_next_action,
-                            note: "AKK proved terminal transport but the exact draft is still present in the agent composer. Do not retry automatically; inspect the shared pane."
+                            note: "AKK proved terminal transport but the exact draft is still present in the " +
+                                "agent composer. Do not retry automatically; inspect the shared pane."
                         }
                         : submissionPending
                             ? {
@@ -1099,13 +1104,16 @@ async function runDelegate(api, params, toolContext) {
                                 do_not_retry: true,
                                 reason: parsed.reason,
                                 openclaw_next_action: parsed.openclaw_next_action,
-                                note: "AKK proved only terminal transport and is still waiting for native agent acceptance. Do not retry or report the task as accepted."
+                                note: "AKK proved only terminal transport and is still waiting for native agent " +
+                                    "acceptance. Do not retry or report the task as accepted."
                             }
                             : {
                                 openclaw_next_action: {
                                     action: "yield",
-                                    reason: "The coding agent is working in the shared terminal. End this controller turn now and wait for an Agent Knock Knock callback.",
-                                    do_not: "Do not poll terminal internals while waiting. Further communication must use Agent Knock Knock tools so the same shared terminal remains authoritative.",
+                                    reason: "The coding agent is working in the shared terminal. End this controller turn " +
+                                        "now and wait for an Agent Knock Knock callback.",
+                                    do_not: "Do not poll terminal internals while waiting. Further communication must use " +
+                                        "Agent Knock Knock tools so the same shared terminal remains authoritative.",
                                     expected_callback: "The callback will be injected into this controller session by its configured callback transport."
                                 },
                                 note: "The task was sent to the shared terminal. The controller Host should yield now and wait for the callback turn."