@botiverse/raft-daemon 1.0.3 → 1.0.5

package/dist/cli/index.js

@@ -28051,6 +28051,48 @@ function toCliError(err) {
   return new InternalBugError(err);
 }
 
+// src/core/io.ts
+init_esm_shims();
+function defaultCliIo() {
+  return {
+    stdin: process.stdin,
+    stdout: process.stdout,
+    stderr: process.stderr
+  };
+}
+
+// src/core/renderer.ts
+init_esm_shims();
+function renderError(io, err) {
+  io.stderr.write(`Error: ${err.message}
+`);
+  io.stderr.write(`Code: ${err.code}
+`);
+  if (err.layer) {
+    io.stderr.write(`Layer: ${err.layer}
+`);
+  }
+  if (err.correlationId) {
+    io.stderr.write(`Correlation: ${err.correlationId}
+`);
+  }
+  if (err.draftSaved !== void 0) {
+    io.stderr.write(`Draft saved: ${err.draftSaved ? "yes" : "no"}
+`);
+  }
+  if (err.suggestedNextAction) {
+    io.stderr.write(`Next action: ${err.suggestedNextAction}
+`);
+  }
+}
+function writeText(io, text) {
+  io.stdout.write(text);
+}
+function writeJson(io, payload) {
+  io.stdout.write(`${JSON.stringify(payload)}
+`);
+}
+
 // src/version.ts
 init_esm_shims();
 import { readFileSync } from "fs";
@@ -28082,9 +28124,6 @@ init_esm_shims();
 // src/client.ts
 init_esm_shims();
 
-// src/agentApiPath.ts
-init_esm_shims();
-
 // ../shared/src/index.ts
 init_esm_shims();
 
@@ -28167,6 +28206,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "moonshotai/kimi-k2-thinking-turbo", label: "Kimi K2 Thinking Turbo" },
     { id: "moonshotai/kimi-k2-0905-preview", label: "Kimi K2 0905" },
     { id: "moonshotai/kimi-k2-0711-preview", label: "Kimi K2 0711" },
+    { id: "moonshotai/kimi-k3", label: "Kimi K3" },
     { id: "moonshotai/kimi-k2.6", label: "Kimi K2.6" },
     { id: "moonshotai/kimi-k2.5", label: "Kimi K2.5" },
     { id: "moonshotai/kimi-k2-turbo-preview", label: "Kimi K2 Turbo" }
@@ -28178,6 +28218,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "moonshotai-cn/kimi-k2-thinking-turbo", label: "Kimi K2 Thinking Turbo" },
     { id: "moonshotai-cn/kimi-k2-0905-preview", label: "Kimi K2 0905" },
     { id: "moonshotai-cn/kimi-k2-0711-preview", label: "Kimi K2 0711" },
+    { id: "moonshotai-cn/kimi-k3", label: "Kimi K3" },
     { id: "moonshotai-cn/kimi-k2.6", label: "Kimi K2.6" },
     { id: "moonshotai-cn/kimi-k2.5", label: "Kimi K2.5" },
     { id: "moonshotai-cn/kimi-k2-turbo-preview", label: "Kimi K2 Turbo" }
@@ -28185,7 +28226,9 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
   "kimi-coding": [
     { id: "kimi-coding/kimi-k2-thinking", label: "Kimi K2 Thinking" },
     { id: "kimi-coding/k2p7", label: "Kimi K2.7 Code" },
-    { id: "kimi-coding/kimi-for-coding", label: "Kimi For Coding" }
+    { id: "kimi-coding/k3", label: "Kimi K3" },
+    { id: "kimi-coding/kimi-for-coding", label: "Kimi For Coding" },
+    { id: "kimi-coding/kimi-for-coding-highspeed", label: "Kimi For Coding HighSpeed" }
   ],
   "openrouter": [
     { id: "openrouter/anthropic/claude-fable-5", label: "Anthropic: Claude Fable 5" },
@@ -28208,11 +28251,15 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/anthropic/claude-3-haiku", label: "Anthropic: Claude 3 Haiku" },
     { id: "openrouter/~anthropic/claude-haiku-latest", label: "Anthropic Claude Haiku Latest" },
     { id: "openrouter/openai/gpt-5.1-codex-max", label: "OpenAI: GPT-5.1-Codex-Max" },
+    { id: "openrouter/kwaipilot/kat-coder-pro-v2.5", label: "Kwaipilot: KAT-Coder-Pro V2.5" },
     { id: "openrouter/kwaipilot/kat-coder-pro-v2", label: "Kwaipilot: KAT-Coder-Pro V2" },
     { id: "openrouter/qwen/qwen3-max-thinking", label: "Qwen: Qwen3 Max Thinking" },
     { id: "openrouter/nvidia/nemotron-3-ultra-550b-a55b", label: "NVIDIA: Nemotron 3 Ultra" },
     { id: "openrouter/google/gemini-2.5-pro-preview", label: "Google: Gemini 2.5 Pro Preview 06-05" },
     { id: "openrouter/google/gemini-2.5-pro-preview-05-06", label: "Google: Gemini 2.5 Pro Preview 05-06" },
+    { id: "openrouter/openai/gpt-5.6-luna-pro", label: "OpenAI: GPT-5.6 Luna Pro" },
+    { id: "openrouter/openai/gpt-5.6-sol-pro", label: "OpenAI: GPT-5.6 Sol Pro" },
+    { id: "openrouter/openai/gpt-5.6-terra-pro", label: "OpenAI: GPT-5.6 Terra Pro" },
     { id: "openrouter/openai/gpt-5.5-pro", label: "OpenAI: GPT-5.5 Pro" },
     { id: "openrouter/openai/gpt-5.4-pro", label: "OpenAI: GPT-5.4 Pro" },
     { id: "openrouter/openai/gpt-5.2-pro", label: "OpenAI: GPT-5.2 Pro" },
@@ -28227,6 +28274,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/upstage/solar-pro-3", label: "Upstage: Solar Pro 3" },
     { id: "openrouter/google/gemini-2.5-pro", label: "Google: Gemini 2.5 Pro" },
     { id: "openrouter/xiaomi/mimo-v2.5-pro", label: "Xiaomi: MiMo-V2.5-Pro" },
+    { id: "openrouter/nex-agi/nex-n2-pro", label: "Nex AGI: Nex-N2-Pro" },
     { id: "openrouter/amazon/nova-premier-v1", label: "Amazon: Nova Premier 1.0" },
     { id: "openrouter/amazon/nova-pro-v1", label: "Amazon: Nova Pro 1.0" },
     { id: "openrouter/~google/gemini-pro-latest", label: "Google Gemini Pro Latest" },
@@ -28241,6 +28289,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/qwen/qwen3-coder-next", label: "Qwen: Qwen3 Coder Next" },
     { id: "openrouter/qwen/qwen3-coder-plus", label: "Qwen: Qwen3 Coder Plus" },
     { id: "openrouter/moonshotai/kimi-k2.7-code", label: "MoonshotAI: Kimi K2.7 Code" },
+    { id: "openrouter/kwaipilot/kat-coder-air-v2.5", label: "Kwaipilot: KAT-Coder-Air V2.5" },
     { id: "openrouter/qwen/qwen3-235b-a22b-thinking-2507", label: "Qwen: Qwen3 235B A22B Thinking 2507" },
     { id: "openrouter/qwen/qwen3-30b-a3b-thinking-2507", label: "Qwen: Qwen3 30B A3B Thinking 2507" },
     { id: "openrouter/qwen/qwen-plus-2025-07-28:thinking", label: "Qwen: Qwen Plus 0728 (thinking)" },
@@ -28313,6 +28362,9 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/qwen/qwen3-8b", label: "Qwen: Qwen3 8B" },
     { id: "openrouter/qwen/qwen3-vl-8b-instruct", label: "Qwen: Qwen3 VL 8B Instruct" },
     { id: "openrouter/qwen/qwen-2.5-7b-instruct", label: "Qwen: Qwen2.5 7B Instruct" },
+    { id: "openrouter/openai/gpt-5.6-luna", label: "OpenAI: GPT-5.6 Luna" },
+    { id: "openrouter/openai/gpt-5.6-sol", label: "OpenAI: GPT-5.6 Sol" },
+    { id: "openrouter/openai/gpt-5.6-terra", label: "OpenAI: GPT-5.6 Terra" },
     { id: "openrouter/openai/gpt-5.5", label: "OpenAI: GPT-5.5" },
     { id: "openrouter/openai/gpt-5.4", label: "OpenAI: GPT-5.4" },
     { id: "openrouter/openai/gpt-5.3-chat", label: "OpenAI: GPT-5.3 Chat" },
@@ -28328,6 +28380,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/z-ai/glm-4.7", label: "Z.ai: GLM 4.7" },
     { id: "openrouter/z-ai/glm-4.6", label: "Z.ai: GLM 4.6" },
     { id: "openrouter/z-ai/glm-4.6v", label: "Z.ai: GLM 4.6V" },
+    { id: "openrouter/x-ai/grok-4.5", label: "xAI: Grok 4.5" },
     { id: "openrouter/z-ai/glm-4.5", label: "Z.ai: GLM 4.5" },
     { id: "openrouter/z-ai/glm-4.5-air", label: "Z.ai: GLM 4.5 Air" },
     { id: "openrouter/z-ai/glm-4.5v", label: "Z.ai: GLM 4.5V" },
@@ -28348,11 +28401,14 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/deepseek/deepseek-chat-v3.1", label: "DeepSeek: DeepSeek V3.1" },
     { id: "openrouter/deepseek/deepseek-v3.1-terminus", label: "DeepSeek: DeepSeek V3.1 Terminus" },
     { id: "openrouter/mistralai/mistral-medium-3.1", label: "Mistral: Mistral Medium 3.1" },
+    { id: "openrouter/aion-labs/aion-3.0", label: "AionLabs: Aion-3.0" },
     { id: "openrouter/deepseek/deepseek-chat", label: "DeepSeek: DeepSeek V3" },
     { id: "openrouter/minimax/minimax-m3", label: "MiniMax: MiniMax M3" },
     { id: "openrouter/mistralai/mistral-medium-3", label: "Mistral: Mistral Medium 3" },
+    { id: "openrouter/moonshotai/kimi-k3", label: "MoonshotAI: Kimi K3" },
     { id: "openrouter/openai/o3", label: "OpenAI: o3" },
     { id: "openrouter/openai/o3-deep-research", label: "OpenAI: o3 Deep Research" },
+    { id: "openrouter/tencent/hy3", label: "Tencent: Hy3" },
     { id: "openrouter/tencent/hy3-preview", label: "Tencent: Hy3 preview" },
     { id: "openrouter/minimax/minimax-m2.7", label: "MiniMax: MiniMax M2.7" },
     { id: "openrouter/inclusionai/ling-2.6-1t", label: "inclusionAI: Ling-2.6-1T" },
@@ -28362,10 +28418,12 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/moonshotai/kimi-k2.5", label: "MoonshotAI: Kimi K2.5" },
     { id: "openrouter/xiaomi/mimo-v2.5", label: "Xiaomi: MiMo-V2.5" },
     { id: "openrouter/minimax/minimax-m2.1", label: "MiniMax: MiniMax M2.1" },
+    { id: "openrouter/poolside/laguna-xs-2.1", label: "Poolside: Laguna XS 2.1" },
+    { id: "openrouter/aion-labs/aion-2.0", label: "AionLabs: Aion-2.0" },
     { id: "openrouter/inception/mercury-2", label: "Inception: Mercury 2" },
     { id: "openrouter/minimax/minimax-m2", label: "MiniMax: MiniMax M2" },
-    { id: "openrouter/poolside/laguna-xs.2", label: "Poolside: Laguna XS.2" },
     { id: "openrouter/bytedance-seed/seed-1.6", label: "ByteDance Seed: Seed 1.6" },
+    { id: "openrouter/meta/muse-spark-1.1", label: "Meta: Muse Spark 1.1" },
     { id: "openrouter/deepseek/deepseek-r1", label: "DeepSeek: R1" },
     { id: "openrouter/minimax/minimax-m1", label: "MiniMax: MiniMax M1" },
     { id: "openrouter/openai/o1", label: "OpenAI: o1" },
@@ -28383,7 +28441,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/qwen/qwen-plus", label: "Qwen: Qwen-Plus" },
     { id: "openrouter/rekaai/reka-edge", label: "Reka Edge" },
     { id: "openrouter/relace/relace-search", label: "Relace: Relace Search" },
-    { id: "openrouter/liquid/lfm-2.5-1.2b-thinking:free", label: "LiquidAI: LFM2.5-1.2B-Thinking (free)" },
+    { id: "openrouter/~x-ai/grok-latest", label: "xAI: Grok Latest" },
     { id: "openrouter/openai/gpt-3.5-turbo-0613", label: "OpenAI: GPT-3.5 Turbo (older v0613)" },
     { id: "openrouter/openai/gpt-3.5-turbo-16k", label: "OpenAI: GPT-3.5 Turbo 16k" },
     { id: "openrouter/z-ai/glm-5-turbo", label: "Z.ai: GLM 5 Turbo" },
@@ -28416,28 +28474,28 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openrouter/openai/o4-mini", label: "OpenAI: o4 Mini" },
     { id: "openrouter/openai/o4-mini-deep-research", label: "OpenAI: o4 Mini Deep Research" },
     { id: "openrouter/openai/o4-mini-high", label: "OpenAI: o4 Mini High" },
+    { id: "openrouter/aion-labs/aion-3.0-mini", label: "AionLabs: Aion-3.0-Mini" },
     { id: "openrouter/openai/o3-mini", label: "OpenAI: o3 Mini" },
     { id: "openrouter/openai/o3-mini-high", label: "OpenAI: o3 Mini High" },
     { id: "openrouter/amazon/nova-2-lite-v1", label: "Amazon: Nova 2 Lite" },
     { id: "openrouter/bytedance-seed/seed-2.0-lite", label: "ByteDance Seed: Seed-2.0-Lite" },
     { id: "openrouter/bytedance-seed/seed-2.0-mini", label: "ByteDance Seed: Seed-2.0-Mini" },
+    { id: "openrouter/nex-agi/nex-n2-mini", label: "Nex AGI: Nex-N2-Mini" },
     { id: "openrouter/amazon/nova-lite-v1", label: "Amazon: Nova Lite 1.0" },
     { id: "openrouter/amazon/nova-micro-v1", label: "Amazon: Nova Micro 1.0" },
-    { id: "openrouter/arcee-ai/trinity-mini", label: "Arcee AI: Trinity Mini" },
     { id: "openrouter/cohere/north-mini-code:free", label: "Cohere: North Mini Code (free)" },
     { id: "openrouter/~openai/gpt-mini-latest", label: "OpenAI GPT Mini Latest" },
     { id: "openrouter/openai/gpt-audio-mini", label: "OpenAI: GPT Audio Mini" },
-    { id: "openrouter/openai/gpt-oss-120b:free", label: "OpenAI: gpt-oss-120b (free)" },
     { id: "openrouter/qwen/qwen3-next-80b-a3b-instruct:free", label: "Qwen: Qwen3 Next 80B A3B Instruct (free)" },
     { id: "openrouter/meta-llama/llama-3.3-70b-instruct:free", label: "Meta: Llama 3.3 70B Instruct (free)" },
     { id: "openrouter/google/gemma-4-31b-it:free", label: "Google: Gemma 4 31B (free)" },
     { id: "openrouter/nvidia/nemotron-3-nano-omni-30b-a3b-reasoning:free", label: "NVIDIA: Nemotron 3 Nano Omni (free)" },
     { id: "openrouter/google/gemma-4-26b-a4b-it:free", label: "Google: Gemma 4 26B A4B  (free)" },
     { id: "openrouter/openai/gpt-oss-20b:free", label: "OpenAI: gpt-oss-20b (free)" },
-    { id: "openrouter/poolside/laguna-xs.2:free", label: "Poolside: Laguna XS.2 (free)" },
+    { id: "openrouter/tencent/hy3:free", label: "Tencent: Hy3 (free)" },
+    { id: "openrouter/poolside/laguna-xs-2.1:free", label: "Poolside: Laguna XS 2.1 (free)" },
     { id: "openrouter/poolside/laguna-m.1:free", label: "Poolside: Laguna M.1 (free)" },
     { id: "openrouter/openrouter/free", label: "Free Models Router" },
-    { id: "openrouter/google/gemini-2.5-flash-lite-preview-09-2025", label: "Google: Gemini 2.5 Flash Lite Preview 09-2025" },
     { id: "openrouter/google/gemini-3.1-flash-lite", label: "Google: Gemini 3.1 Flash Lite" },
     { id: "openrouter/google/gemini-3.1-flash-lite-preview", label: "Google: Gemini 3.1 Flash Lite Preview" },
     { id: "openrouter/google/gemini-2.5-flash-lite", label: "Google: Gemini 2.5 Flash Lite" },
@@ -28462,6 +28520,9 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openai/gpt-4o-2024-11-20", label: "GPT-4o (2024-11-20)" },
     { id: "openai/gpt-4o-2024-08-06", label: "GPT-4o (2024-08-06)" },
     { id: "openai/gpt-4o-2024-05-13", label: "GPT-4o (2024-05-13)" },
+    { id: "openai/gpt-5.6-luna", label: "GPT-5.6 Luna" },
+    { id: "openai/gpt-5.6-sol", label: "GPT-5.6 Sol" },
+    { id: "openai/gpt-5.6-terra", label: "GPT-5.6 Terra" },
     { id: "openai/gpt-5.5", label: "GPT-5.5" },
     { id: "openai/gpt-5.4", label: "GPT-5.4" },
     { id: "openai/gpt-5.3-chat-latest", label: "GPT-5.3 Chat (latest)" },
@@ -28476,6 +28537,7 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "openai/gpt-4o", label: "GPT-4o" },
     { id: "openai/o3", label: "o3" },
     { id: "openai/o3-deep-research", label: "o3-deep-research" },
+    { id: "openai/gpt-realtime-2.1", label: "GPT-Realtime-2.1" },
     { id: "openai/o1", label: "o1" },
     { id: "openai/gpt-4-turbo", label: "GPT-4 Turbo" },
     { id: "openai/gpt-5.4-mini", label: "GPT-5.4 mini" },
@@ -28491,8 +28553,6 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
   ],
   "anthropic": [
     { id: "anthropic/claude-fable-5", label: "Claude Fable 5" },
-    { id: "anthropic/claude-3-opus-20240229", label: "Claude Opus 3" },
-    { id: "anthropic/claude-opus-4-20250514", label: "Claude Opus 4" },
     { id: "anthropic/claude-opus-4-5-20251101", label: "Claude Opus 4.5" },
     { id: "anthropic/claude-opus-4-1-20250805", label: "Claude Opus 4.1" },
     { id: "anthropic/claude-opus-4-8", label: "Claude Opus 4.8" },
@@ -28500,18 +28560,10 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "anthropic/claude-opus-4-6", label: "Claude Opus 4.6" },
     { id: "anthropic/claude-opus-4-5", label: "Claude Opus 4.5 (latest)" },
     { id: "anthropic/claude-opus-4-1", label: "Claude Opus 4.1 (latest)" },
-    { id: "anthropic/claude-opus-4-0", label: "Claude Opus 4 (latest)" },
-    { id: "anthropic/claude-3-7-sonnet-20250219", label: "Claude Sonnet 3.7" },
-    { id: "anthropic/claude-3-5-sonnet-20241022", label: "Claude Sonnet 3.5 v2" },
-    { id: "anthropic/claude-3-5-sonnet-20240620", label: "Claude Sonnet 3.5" },
-    { id: "anthropic/claude-3-sonnet-20240229", label: "Claude Sonnet 3" },
-    { id: "anthropic/claude-sonnet-4-20250514", label: "Claude Sonnet 4" },
     { id: "anthropic/claude-sonnet-4-5-20250929", label: "Claude Sonnet 4.5" },
     { id: "anthropic/claude-sonnet-5", label: "Claude Sonnet 5" },
     { id: "anthropic/claude-sonnet-4-6", label: "Claude Sonnet 4.6" },
     { id: "anthropic/claude-sonnet-4-5", label: "Claude Sonnet 4.5 (latest)" },
-    { id: "anthropic/claude-sonnet-4-0", label: "Claude Sonnet 4 (latest)" },
-    { id: "anthropic/claude-3-haiku-20240307", label: "Claude Haiku 3" },
     { id: "anthropic/claude-haiku-4-5-20251001", label: "Claude Haiku 4.5" },
     { id: "anthropic/claude-haiku-4-5", label: "Claude Haiku 4.5 (latest)" }
   ],
@@ -28534,13 +28586,9 @@ var PI_BUILTIN_PROVIDER_MODELS_GENERATED = {
     { id: "google/gemini-flash-lite-latest", label: "Gemini Flash-Lite Latest" }
   ],
   "xai": [
-    { id: "xai/grok-4.20-0309-non-reasoning", label: "Grok 4.20 (Non-Reasoning)" },
-    { id: "xai/grok-4.20-0309-reasoning", label: "Grok 4.20 (Reasoning)" },
-    { id: "xai/grok-code-fast-1", label: "Grok Code Fast 1" },
+    { id: "xai/grok-4.5", label: "Grok 4.5" },
     { id: "xai/grok-4.3", label: "Grok 4.3" },
-    { id: "xai/grok-3", label: "Grok 3" },
-    { id: "xai/grok-build-0.1", label: "Grok Build 0.1" },
-    { id: "xai/grok-3-fast", label: "Grok 3 Fast" }
+    { id: "xai/grok-build-0.1", label: "Grok Build 0.1" }
   ],
   "xiaomi": [
     { id: "xiaomi/mimo-v2.5-pro", label: "MiMo-V2.5-Pro" },
@@ -28561,20 +28609,20 @@ var RUNTIME_PROVIDER_DISPLAY_NAMES = {
   "anthropic": "Anthropic",
   "deepseek": "DeepSeek",
   "fusecode": "FuseCode",
-  "google": "Google Gemini",
+  "google": "Google",
   "kimi-coding": "Kimi For Coding",
   "minimax": "MiniMax",
-  "minimax-cn": "MiniMax (China)",
+  "minimax-cn": "MiniMax CN",
   "moonshotai": "Moonshot AI",
-  "moonshotai-cn": "Moonshot AI (China)",
+  "moonshotai-cn": "Moonshot AI CN",
   "openai": "OpenAI",
   "opencode": "OpenCode Zen",
-  "opencode-go": "OpenCode Go",
+  "opencode-go": "OpenCode Zen Go",
   "openrouter": "OpenRouter",
   "xai": "xAI",
-  "xiaomi": "Xiaomi MiMo",
-  "zai": "ZAI Coding Plan (Global)",
-  "zai-coding-cn": "ZAI Coding Plan (China)"
+  "xiaomi": "Xiaomi",
+  "zai": "Z.AI",
+  "zai-coding-cn": "Z.AI Coding CN"
 };
 
 // ../shared/src/runtimeProviderDisplay.ts
@@ -28646,6 +28694,30 @@ var SLOCK_REF_DM_PEER_PATTERN = String.raw`[\w-]+`;
 var SLOCK_REF_THREAD_SHORT_ID_PATTERN = String.raw`[\da-f]{6,8}`;
 var SLOCK_REF_MESSAGE_ID_PATTERN = String.raw`[A-Za-z0-9][A-Za-z0-9-]{1,63}`;
 var SLOCK_REF_TASK_NUMBER_PATTERN = String.raw`[1-9]\d*`;
+function createSlockUserRefRegex() {
+  return new RegExp(`@(${SLOCK_REF_USER_NAME_PATTERN})`, "gu");
+}
+function createSlockChannelThreadRefRegex() {
+  return new RegExp(`#(${SLOCK_REF_CHANNEL_NAME_PATTERN}):(${SLOCK_REF_THREAD_SHORT_ID_PATTERN})`, "giu");
+}
+function createSlockChannelRefRegex() {
+  return new RegExp(`#(${SLOCK_REF_CHANNEL_NAME_PATTERN})`, "gu");
+}
+function createSlockDmThreadRefRegex() {
+  return new RegExp(`dm:@(${SLOCK_REF_DM_PEER_PATTERN}):(${SLOCK_REF_THREAD_SHORT_ID_PATTERN})`, "giu");
+}
+function createSlockDmRefRegex() {
+  return new RegExp(`dm:@(${SLOCK_REF_DM_PEER_PATTERN})`, "giu");
+}
+function createSlockMessageRefRegex() {
+  return new RegExp(
+    `#(${SLOCK_REF_CHANNEL_NAME_PATTERN})(?::(${SLOCK_REF_THREAD_SHORT_ID_PATTERN}))?\\s+msg=(${SLOCK_REF_MESSAGE_ID_PATTERN})`,
+    "giu"
+  );
+}
+function createSlockBareTaskRefRegex() {
+  return new RegExp(`(^|[^\\w/])(?:(task\\s+))?#(${SLOCK_REF_TASK_NUMBER_PATTERN})\\b`, "giu");
+}
 var USER_RE = new RegExp(String.raw`^@(${SLOCK_REF_USER_NAME_PATTERN})$`, "u");
 var CHANNEL_RE = new RegExp(String.raw`^#(${SLOCK_REF_CHANNEL_NAME_PATTERN})$`, "u");
 var CHANNEL_THREAD_RE = new RegExp(
@@ -28666,9 +28738,267 @@ var DM_MESSAGE_RE = new RegExp(
   String.raw`^dm:@(${SLOCK_REF_DM_PEER_PATTERN})(?::(${SLOCK_REF_THREAD_SHORT_ID_PATTERN}))?\s+msg=(${SLOCK_REF_MESSAGE_ID_PATTERN})$`,
   "iu"
 );
+function parseSlockRefTarget(rawTarget) {
+  const target = rawTarget.trim();
+  if (!target) return null;
+  const channelMessage = CHANNEL_MESSAGE_RE.exec(target);
+  if (channelMessage) {
+    return {
+      kind: "message",
+      channelName: channelMessage[1],
+      threadParentShortId: channelMessage[2] ?? null,
+      messageId: channelMessage[3]
+    };
+  }
+  const dmMessage = DM_MESSAGE_RE.exec(target);
+  if (dmMessage) {
+    return {
+      kind: "dm-message",
+      peerName: dmMessage[1],
+      threadParentShortId: dmMessage[2] ?? null,
+      messageId: dmMessage[3]
+    };
+  }
+  const channelThread = CHANNEL_THREAD_RE.exec(target);
+  if (channelThread) {
+    return { kind: "channel-thread", channelName: channelThread[1], threadShortId: channelThread[2] };
+  }
+  const dmThread = DM_THREAD_RE.exec(target);
+  if (dmThread) {
+    return { kind: "dm-thread", peerName: dmThread[1], threadShortId: dmThread[2] };
+  }
+  const task = TASK_RE.exec(target);
+  if (task) return { kind: "task", taskNumber: Number(task[1]) };
+  const user = USER_RE.exec(target);
+  if (user) return { kind: "user", name: user[1] };
+  const channel = CHANNEL_RE.exec(target);
+  if (channel) return { kind: "channel", channelName: channel[1] };
+  const dm = DM_RE.exec(target);
+  if (dm) return { kind: "dm", peerName: dm[1] };
+  return null;
+}
+function formatSlockRefTarget(target) {
+  switch (target.kind) {
+    case "user":
+      return `@${target.name}`;
+    case "channel":
+      return `#${target.channelName}`;
+    case "channel-thread":
+      return `#${target.channelName}:${target.threadShortId}`;
+    case "dm":
+      return `dm:@${target.peerName}`;
+    case "dm-thread":
+      return `dm:@${target.peerName}:${target.threadShortId}`;
+    case "task":
+      return `task #${target.taskNumber}`;
+    case "message":
+      return target.threadParentShortId ? `#${target.channelName}:${target.threadParentShortId} msg=${target.messageId}` : `#${target.channelName} msg=${target.messageId}`;
+    case "dm-message":
+      return target.threadParentShortId ? `dm:@${target.peerName}:${target.threadParentShortId} msg=${target.messageId}` : `dm:@${target.peerName} msg=${target.messageId}`;
+  }
+}
+function markdownCodeSpans(source) {
+  const spans = [];
+  const fenced = /```[\s\S]*?```/g;
+  for (const match of source.matchAll(fenced)) {
+    spans.push({ start: match.index ?? 0, end: (match.index ?? 0) + match[0].length });
+  }
+  const inline = /``[^`]+``|`[^`]+`/g;
+  for (const match of source.matchAll(inline)) {
+    const start = match.index ?? 0;
+    const end = start + match[0].length;
+    if (!spans.some((span) => start >= span.start && end <= span.end)) {
+      spans.push({ start, end });
+    }
+  }
+  return spans.sort((a, b) => a.start - b.start);
+}
+function visitMarkdownProseChunks(source, visitor) {
+  const spans = markdownCodeSpans(source);
+  if (spans.length === 0) {
+    visitor(source, 0);
+    return;
+  }
+  let cursor = 0;
+  for (const span of spans) {
+    if (span.start > cursor) visitor(source.slice(cursor, span.start), cursor);
+    cursor = span.end;
+  }
+  if (cursor < source.length) visitor(source.slice(cursor), cursor);
+}
+function collectParsedRef(refs, raw, start, end, dedupe) {
+  const target = parseSlockRefTarget(raw);
+  if (!target) return;
+  const canonical = formatSlockRefTarget(target);
+  refs.set(dedupe ? canonical : `${start}:${end}:${canonical}`, { raw, target, start, end });
+}
+function extractSlockRefTargetsFromChunk(chunk, chunkOffset, dedupe) {
+  const refs = /* @__PURE__ */ new Map();
+  const occupiedRanges = [];
+  function occupy(match) {
+    if (match.index === void 0) return;
+    occupiedRanges.push({ start: match.index, end: match.index + match[0].length });
+  }
+  function isInsideOccupied(match, offset = 0) {
+    if (match.index === void 0) return false;
+    const start = match.index + offset;
+    const end = start + match[0].length - offset;
+    return occupiedRanges.some((range) => start >= range.start && end <= range.end);
+  }
+  for (const match of chunk.matchAll(new RegExp(String.raw`<([^<>\n]+)>`, "gu"))) {
+    const raw = match[1] ?? "";
+    const rawStart = (match.index ?? 0) + 1;
+    collectParsedRef(refs, raw, chunkOffset + rawStart, chunkOffset + rawStart + raw.length, dedupe);
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockMessageRefRegex())) {
+    collectParsedRef(
+      refs,
+      match[2] ? `#${match[1]}:${match[2]} msg=${match[3]}` : `#${match[1]} msg=${match[3]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockDmThreadRefRegex())) {
+    collectParsedRef(
+      refs,
+      `dm:@${match[1]}:${match[2]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockDmRefRegex())) {
+    if (isInsideOccupied(match)) continue;
+    collectParsedRef(
+      refs,
+      `dm:@${match[1]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockChannelThreadRefRegex())) {
+    if (isInsideOccupied(match)) continue;
+    collectParsedRef(
+      refs,
+      `#${match[1]}:${match[2]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockBareTaskRefRegex())) {
+    const raw = `task #${match[3]}`;
+    const rawStart = (match.index ?? 0) + match[1].length;
+    collectParsedRef(
+      refs,
+      raw,
+      chunkOffset + rawStart,
+      chunkOffset + rawStart + match[0].length - match[1].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockUserRefRegex())) {
+    if (isInsideOccupied(match)) continue;
+    collectParsedRef(
+      refs,
+      `@${match[1]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  for (const match of chunk.matchAll(createSlockChannelRefRegex())) {
+    if (isInsideOccupied(match)) continue;
+    collectParsedRef(
+      refs,
+      `#${match[1]}`,
+      chunkOffset + (match.index ?? 0),
+      chunkOffset + (match.index ?? 0) + match[0].length,
+      dedupe
+    );
+    occupy(match);
+  }
+  return refs;
+}
+function extractSlockRefTargets(source, options = {}) {
+  const refs = /* @__PURE__ */ new Map();
+  const dedupe = options.dedupe ?? true;
+  const collectChunk = (chunk, offset) => {
+    const chunkRefs = extractSlockRefTargetsFromChunk(chunk, offset, dedupe);
+    for (const [key, value] of chunkRefs) refs.set(key, value);
+  };
+  if (options.includeMarkdownCode) {
+    collectChunk(source, 0);
+  } else {
+    visitMarkdownProseChunks(source, collectChunk);
+  }
+  return [...refs.values()].sort((a, b) => a.start - b.start || a.end - b.end);
+}
 
 // ../shared/src/thirdPartyInertRenderer.ts
 init_esm_shims();
+function escapeAgentMarkupLiterals(value) {
+  return value.replace(/<\/?(?:result|preview|match)\b[^>]*>|<omit\s*\/>/gi, (tag) => tag.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"));
+}
+function neutralizeSlockRefLiterals(value) {
+  const refs = extractSlockRefTargets(value, { dedupe: false, includeMarkdownCode: true }).filter((ref) => ref.start < ref.end).sort((a, b) => a.start - b.start || b.end - a.end);
+  if (refs.length === 0) return value;
+  let output = "";
+  let cursor = 0;
+  for (let index = 0; index < refs.length; ) {
+    const first = refs[index];
+    if (first.start < cursor) {
+      index++;
+      continue;
+    }
+    const cluster = [first];
+    let clusterEnd = first.end;
+    index++;
+    while (index < refs.length && refs[index].start < clusterEnd) {
+      const next = refs[index];
+      cluster.push(next);
+      clusterEnd = Math.max(clusterEnd, next.end);
+      index++;
+    }
+    output += value.slice(cursor, first.start);
+    output += cluster.map((ref) => neutralSlockRefLabel(ref.target)).join(" ");
+    cursor = clusterEnd;
+  }
+  output += value.slice(cursor);
+  return output;
+}
+function neutralSlockRefLabel(target) {
+  switch (target.kind) {
+    case "user":
+      return `user:${target.name}`;
+    case "channel":
+      return `channel:${target.channelName}`;
+    case "channel-thread":
+      return `channel:${target.channelName}:${target.threadShortId}`;
+    case "dm":
+      return `dm:user:${target.peerName}`;
+    case "dm-thread":
+      return `dm:user:${target.peerName}:${target.threadShortId}`;
+    case "task":
+      return `task:${target.taskNumber}`;
+    case "message":
+      return target.threadParentShortId ? `channel:${target.channelName}:${target.threadParentShortId} msg=${target.messageId}` : `channel:${target.channelName} msg=${target.messageId}`;
+    case "dm-message":
+      return target.threadParentShortId ? `dm:user:${target.peerName}:${target.threadParentShortId} msg=${target.messageId}` : `dm:user:${target.peerName} msg=${target.messageId}`;
+  }
+}
+function renderThirdPartyInertJson(value) {
+  return neutralizeSlockRefLiterals(escapeAgentMarkupLiterals(JSON.stringify(value, null, 2)));
+}
 
 // ../shared/src/producerFactLineage.ts
 init_esm_shims();
@@ -43107,6 +43437,53 @@ init_esm_shims();
 var ATTENTION_HINT_SCHEMA = "attention-dependency-hint.v1";
 var ATTENTION_HINT_DEFAULT_WINDOW_MS = 7 * 24 * 60 * 60 * 1e3;
 
+// ../shared/src/knowledgeContext.ts
+init_esm_shims();
+var MIN_KNOWLEDGE_CONTEXT_LENGTH = 12;
+var MAX_KNOWLEDGE_CONTEXT_LENGTH = 500;
+var RAFT_CLIENT_CAPABILITIES_HEADER = "X-Raft-Client-Capabilities";
+var MANUAL_CONTEXT_CAPABILITY = "manual-context-v1";
+var MANUAL_INDEX_COMMAND = 'raft manual get index --intent "Learn available Raft workflows" --reason "Browse the topic catalog after a missing topic"';
+function validateKnowledgeContext(raw, field) {
+  if (raw === void 0 || raw === null || raw === "") {
+    return { ok: false, value: null, error: `${field} is required` };
+  }
+  if (typeof raw !== "string") {
+    return { ok: false, value: null, error: `${field} must be a string` };
+  }
+  const value = raw.trim();
+  if (value.length < MIN_KNOWLEDGE_CONTEXT_LENGTH) {
+    return {
+      ok: false,
+      value: null,
+      error: `${field} must be at least ${MIN_KNOWLEDGE_CONTEXT_LENGTH} characters`
+    };
+  }
+  if (value.length > MAX_KNOWLEDGE_CONTEXT_LENGTH) {
+    return {
+      ok: false,
+      value: null,
+      error: `${field} must be at most ${MAX_KNOWLEDGE_CONTEXT_LENGTH} characters`
+    };
+  }
+  const unsafeError = classifyUnsafeKnowledgeContext(value, field);
+  if (unsafeError) return { ok: false, value: null, error: unsafeError };
+  return { ok: true, value };
+}
+function classifyUnsafeKnowledgeContext(value, field) {
+  if (/\[target=.*\bmsg=/.test(value)) return `${field} must not contain raw Slock message headers`;
+  if (/```[\s\S]*```/.test(value)) return `${field} must not contain raw prompts or code blocks`;
+  if (/https?:\/\//i.test(value)) return `${field} must not contain URLs`;
+  if (/\bsk_(?:agent|machine|computer)_[a-z0-9_-]+\b/i.test(value)) {
+    return `${field} must not contain credentials`;
+  }
+  if (/\bBearer\s+\S+/i.test(value) || /\b(?:api[_ -]?key|token|password|secret)\s*[:=]\s*\S+/i.test(value)) {
+    return `${field} must not contain credentials`;
+  }
+  if (value.split(/\r?\n/).length > 4) return `${field} must be a concise natural-language summary`;
+  return null;
+}
+
 // ../shared/src/agentApiContract.ts
 var AGENT_API_BASE_PATH = "/internal/agent-api";
 var optionalStringSchema = external_exports.string().trim().optional();
@@ -43136,7 +43513,11 @@ var agentApiHistoryQuerySchema = passthroughObject({
 });
 var agentApiKnowledgeGetQuerySchema = passthroughObject({
   topic: external_exports.string().trim().min(1),
-  reason: optionalStringSchema,
+  // Optional at the transport schema during the staged rollout. The current
+  // CLI advertises manual-context-v1 and requires both before sending; the
+  // server keeps legacy published clients compatible until the fleet gate.
+  intent: external_exports.string().trim().min(MIN_KNOWLEDGE_CONTEXT_LENGTH).max(MAX_KNOWLEDGE_CONTEXT_LENGTH).optional(),
+  reason: external_exports.string().trim().min(MIN_KNOWLEDGE_CONTEXT_LENGTH).max(MAX_KNOWLEDGE_CONTEXT_LENGTH).optional(),
   turn_id: optionalStringSchema,
   trace_id: optionalStringSchema
 });
@@ -43152,7 +43533,8 @@ var agentApiKnowledgeGetResponseSchema = passthroughObject({
 var agentApiKnowledgeSearchQuerySchema = passthroughObject({
   query: external_exports.string().trim().min(1),
   scope: optionalStringSchema,
-  reason: optionalStringSchema,
+  intent: external_exports.string().trim().min(MIN_KNOWLEDGE_CONTEXT_LENGTH).max(MAX_KNOWLEDGE_CONTEXT_LENGTH).optional(),
+  reason: external_exports.string().trim().min(MIN_KNOWLEDGE_CONTEXT_LENGTH).max(MAX_KNOWLEDGE_CONTEXT_LENGTH).optional(),
   turn_id: optionalStringSchema,
   trace_id: optionalStringSchema
 });
@@ -43640,6 +44022,8 @@ var agentApiMessageEnvelopeSchema = passthroughObject({
   task_assignee_id: external_exports.string().nullable().optional(),
   taskAssigneeType: external_exports.string().nullable().optional(),
   task_assignee_type: external_exports.string().nullable().optional(),
+  taskAssigneeName: external_exports.string().nullable().optional(),
+  task_assignee_name: external_exports.string().nullable().optional(),
   threadId: external_exports.string().nullable().optional(),
   replyCount: external_exports.number().int().nonnegative().nullable().optional()
 });
@@ -43824,6 +44208,7 @@ var agentApiCreatedTaskEnvelopeSchema = passthroughObject({
   status: taskStatusSchema,
   claimedByType: external_exports.enum(["user", "agent"]).nullable(),
   claimedById: external_exports.string().nullable(),
+  claimedByName: external_exports.string().nullable().optional(),
   claimedAt: external_exports.string().datetime().nullable()
 });
 var agentApiTaskAssignmentReceiptSchema = passthroughObject({
@@ -45406,6 +45791,9 @@ var SUPPORTED_TRANSLATION_LANGUAGE_SET = new Set(
   SUPPORTED_TRANSLATION_LANGUAGE_CODES
 );
 
+// ../shared/src/displayLocales.ts
+init_esm_shims();
+
 // ../shared/src/timeFormatPreference.ts
 init_esm_shims();
 
@@ -45653,7 +46041,7 @@ var CANONICAL_MESSAGE_EXCLUSIONS = Object.freeze({
    *  applyTarget=task-domain, messageFold=excluded. Fan out to the task
    *  consumer at ingress; message fold never applies these. */
   taskDomainProjection: Object.freeze({
-    fields: ["taskAssigneeId", "taskAssigneeType", "taskClaimedAt", "taskCompletedAt", "taskNumber", "taskStatus"],
+    fields: ["taskAssigneeId", "taskAssigneeName", "taskAssigneeType", "taskClaimedAt", "taskCompletedAt", "taskNumber", "taskStatus"],
     migrationStatus: "active-consumers (web taskStore / KMP task projection); dual-dispatch at ingress"
   }),
   /** Emitted but consumed by no canonical client surface. */
@@ -46045,6 +46433,7 @@ var TRIAL_END_DATE = /* @__PURE__ */ new Date("2026-06-23T12:00:00Z");
 var TRIAL_DURATION_DAYS = (TRIAL_END_DATE.getTime() - TRIAL_START_DATE.getTime()) / (24 * 60 * 60 * 1e3);
 
 // src/agentApiPath.ts
+init_esm_shims();
 function buildAgentApiRoutePath(routeKey, pathParams, query) {
   const path11 = buildAgentApiRawRoutePath(routeKey, { params: pathParams, query });
   if (typeof path11 === "string") return path11;
@@ -46663,6 +47052,7 @@ var ApiClient = class {
     const url2 = new URL(pathname, this.ctx.serverUrl);
     const headers = this.buildAuthHeaders();
     headers["Content-Type"] = "application/json";
+    headers[RAFT_CLIENT_CAPABILITIES_HEADER] = MANUAL_CONTEXT_CAPABILITY;
     if (this.ctx.activeCapabilities && this.ctx.activeCapabilities.length > 0) {
       headers["X-Slock-Agent-Active-Capabilities"] = this.ctx.activeCapabilities.join(",");
     }
@@ -46938,16 +47328,6 @@ function loadAgentContext(env = process.env) {
   );
 }
 
-// src/core/io.ts
-init_esm_shims();
-function defaultCliIo() {
-  return {
-    stdin: process.stdin,
-    stdout: process.stdout,
-    stderr: process.stderr
-  };
-}
-
 // src/core/context.ts
 function bootstrapSuggestedNextAction(code) {
   switch (code) {
@@ -46996,38 +47376,6 @@ function createCommandContext(options = {}) {
   };
 }
 
-// src/core/renderer.ts
-init_esm_shims();
-function renderError(io, err) {
-  io.stderr.write(`Error: ${err.message}
-`);
-  io.stderr.write(`Code: ${err.code}
-`);
-  if (err.layer) {
-    io.stderr.write(`Layer: ${err.layer}
-`);
-  }
-  if (err.correlationId) {
-    io.stderr.write(`Correlation: ${err.correlationId}
-`);
-  }
-  if (err.draftSaved !== void 0) {
-    io.stderr.write(`Draft saved: ${err.draftSaved ? "yes" : "no"}
-`);
-  }
-  if (err.suggestedNextAction) {
-    io.stderr.write(`Next action: ${err.suggestedNextAction}
-`);
-  }
-}
-function writeText(io, text) {
-  io.stdout.write(text);
-}
-function writeJson(io, payload) {
-  io.stdout.write(`${JSON.stringify(payload)}
-`);
-}
-
 // src/core/command.ts
 function defineCommand(spec, handler) {
   return { spec, handler };
@@ -47641,13 +47989,20 @@ async function mintAndPersist(ctx, options, accessToken, paths) {
     ) + "\n",
     { mode: 384 }
   );
-  ctx.io.stdout.write(
-    `state: authorized
-Logged in as '${minted.agentName}' on ${options.server}. Credential saved to ${paths.credentialPath}.
-Next (if you are the human operator): start your agent with RAFT_PROFILE=${paths.profileSlug} in its environment, and let the agent run \`raft manual get raft-cli-overview\` to learn the Raft CLI.
-Next (if you are the agent): run \`raft manual get raft-cli-overview\`, then use \`raft --profile ${paths.profileSlug} \u2026\` for all commands.
-`
-  );
+  ctx.io.stdout.write(formatAuthorizedLoginReport({
+    agentName: minted.agentName,
+    server: options.server,
+    credentialPath: paths.credentialPath,
+    profileSlug: paths.profileSlug
+  }));
+}
+function formatAuthorizedLoginReport(input) {
+  const manualCommand = 'raft manual get raft-cli-overview --intent "Get productive on Raft as a new agent" --reason "Just logged in, need the CLI basics"';
+  return `state: authorized
+Logged in as '${input.agentName}' on ${input.server}. Credential saved to ${input.credentialPath}.
+Next (if you are the human operator): start your agent with RAFT_PROFILE=${input.profileSlug} in its environment, and let the agent run \`${manualCommand}\` to learn the Raft CLI.
+Next (if you are the agent): run \`${manualCommand}\`, then use \`raft --profile ${input.profileSlug} \u2026\` for all commands.
+`;
 }
 function formatVerificationHandoff(action, options) {
   const mins = Math.max(0, Math.floor(action.expiresInSeconds / 60));
@@ -50921,6 +51276,47 @@ function registerUserInfoCommand(parent, runtimeOptions) {
 
 // src/commands/knowledge/get.ts
 init_esm_shims();
+
+// src/commands/knowledge/context.ts
+init_esm_shims();
+var INTENT_GUIDANCE = `Retry with --intent "Set up a multi-agent review pipeline for my team" \u2014 describe the user's ultimate goal in Raft, not the query or topic.`;
+var REASON_GUIDANCE = 'Retry with --reason "Unsure whether a muted channel still delivers @mentions to me" \u2014 describe why the Manual is needed now, not "need info" or a restatement of the query.';
+var SAFETY_GUIDANCE = "Don't include secrets, credentials, private URLs, or raw message content.";
+function contextGuidance(field) {
+  return field === "intent" ? INTENT_GUIDANCE : REASON_GUIDANCE;
+}
+function throwKnowledgeContextError(field, message) {
+  const code = field === "intent" ? "knowledge_intent_invalid" : "knowledge_reason_invalid";
+  throw new CliError({
+    code,
+    message,
+    suggestedNextAction: `${contextGuidance(field)} ${SAFETY_GUIDANCE}`
+  });
+}
+function requireKnowledgeContexts(rawIntent, rawReason) {
+  const intent = validateKnowledgeContext(rawIntent, "intent");
+  const reason = validateKnowledgeContext(rawReason, "reason");
+  if (!intent.ok) {
+    if (!reason.ok) {
+      throw new CliError({
+        code: "KNOWLEDGE_CONTEXT_INVALID",
+        message: `Both Manual context fields are invalid: ${intent.error}; ${reason.error}`,
+        suggestedNextAction: `Retry the same command with both required fields:
+  ${INTENT_GUIDANCE}
+  ${REASON_GUIDANCE}
+` + SAFETY_GUIDANCE
+      });
+    }
+    throwKnowledgeContextError("intent", intent.error);
+  }
+  if (!reason.ok) throwKnowledgeContextError("reason", reason.error);
+  return { intent: intent.value, reason: reason.value };
+}
+function formatManualIndexCommand() {
+  return MANUAL_INDEX_COMMAND;
+}
+
+// src/commands/knowledge/get.ts
 function formatKnowledgeStdout(content) {
   return content.endsWith("\n") ? content : `${content}
 `;
@@ -50931,6 +51327,7 @@ function toKnowledgeErrorCode(errorCode2, status) {
     case "SCOPE_DENIED":
     case "knowledge_agent_missing":
     case "knowledge_internal_error":
+    case "knowledge_intent_invalid":
     case "knowledge_not_found":
     case "knowledge_reason_invalid":
     case "knowledge_source_invalid":
@@ -50949,9 +51346,13 @@ var knowledgeGetCommand = defineCommand(
     description: "Fetch a Raft Manual for Agents topic from the current server",
     arguments: ["<topic>"],
     options: [
+      {
+        flags: "--intent <text>",
+        description: "Required: what the user ultimately wants to accomplish with Raft (12-500 chars)"
+      },
       {
         flags: "--reason <text>",
-        description: "Optional rationale for fetching this topic (>=12 chars when provided)"
+        description: "Required: why Manual is needed at this point (12-500 chars)"
       },
       {
         flags: "--turn-id <id>",
@@ -50964,14 +51365,16 @@ var knowledgeGetCommand = defineCommand(
         hidden: true
       }
     ],
-    helpAfter: "\nTopics:\n  Run `raft manual get index` to list available manual topics.\n"
+    helpAfter: '\nTopics:\n  Use this to list available manual topics:\n  raft manual get index --intent "Learn available Raft workflows" --reason "Need the topic catalog before answering"\n'
   },
   async (ctx, topic, opts) => {
+    const { intent, reason } = requireKnowledgeContexts(opts.intent, opts.reason);
     const agentContext = ctx.loadAgentContext();
     const client = ctx.createApiClient(agentContext);
     const res = await createAgentApiSurfaceClient(client).knowledge.get({
       topic,
-      reason: opts.reason,
+      intent,
+      reason,
       turn_id: opts.turnId,
       trace_id: opts.traceId
     });
@@ -50979,7 +51382,8 @@ var knowledgeGetCommand = defineCommand(
       throw new CliError({
         code: toKnowledgeErrorCode(res.errorCode, res.status),
         message: res.error ?? `HTTP ${res.status}`,
-        suggestedNextAction: res.suggestedNextAction ?? (res.errorCode === "knowledge_not_found" ? "Run `raft manual get index` to see all available manual topics." : void 0)
+        suggestedNextAction: res.suggestedNextAction ?? (res.errorCode === "knowledge_not_found" ? `No topic matched. Retry with a close topic id, keeping your --intent/--reason. To browse all topics, run:
+${formatManualIndexCommand()}` : void 0)
       });
     }
     const data = res.data;
@@ -51012,6 +51416,7 @@ function toKnowledgeSearchErrorCode(errorCode2, status) {
     case "SCOPE_DENIED":
     case "knowledge_agent_missing":
     case "knowledge_internal_error":
+    case "knowledge_intent_invalid":
     case "knowledge_not_found":
     case "knowledge_query_invalid":
     case "knowledge_reason_invalid":
@@ -51035,9 +51440,13 @@ var knowledgeSearchCommand = defineCommand(
         flags: "--scope <scope>",
         description: "Optional search scope. Currently supports: recipes"
       },
+      {
+        flags: "--intent <text>",
+        description: "Required: what the user ultimately wants to accomplish with Raft (12-500 chars)"
+      },
       {
         flags: "--reason <text>",
-        description: "Optional rationale for this search (>=12 chars when provided)"
+        description: "Required: why Manual is needed at this point (12-500 chars)"
       },
       {
         flags: "--turn-id <id>",
@@ -51050,15 +51459,17 @@ var knowledgeSearchCommand = defineCommand(
         hidden: true
       }
     ],
-    helpAfter: '\nExamples:\n  raft manual search "preview before merge" --scope recipes\n  raft manual get recipes/technique/preview-env\n'
+    helpAfter: '\nExamples:\n  raft manual search "preview before merge" --scope recipes --intent "Safely preview a change before merge" --reason "Need the recommended preview workflow now"\n  raft manual get recipes/technique/preview-env --intent "Safely preview a change before merge" --reason "Need exact preview setup steps now"\n'
   },
   async (ctx, keywords, opts) => {
+    const { intent, reason } = requireKnowledgeContexts(opts.intent, opts.reason);
     const agentContext = ctx.loadAgentContext();
     const client = ctx.createApiClient(agentContext);
     const res = await createAgentApiSurfaceClient(client).knowledge.search({
       query: keywords,
       scope: opts.scope,
-      reason: opts.reason,
+      intent,
+      reason,
       turn_id: opts.turnId,
       trace_id: opts.traceId
     });
@@ -51066,7 +51477,8 @@ var knowledgeSearchCommand = defineCommand(
       throw new CliError({
         code: toKnowledgeSearchErrorCode(res.errorCode, res.status),
         message: res.error ?? `HTTP ${res.status}`,
-        suggestedNextAction: res.suggestedNextAction ?? (res.errorCode === "knowledge_not_found" ? "Try different keywords, or run `raft manual get index` to browse available topics." : void 0)
+        suggestedNextAction: res.suggestedNextAction ?? (res.errorCode === "knowledge_not_found" ? `Retry with different keywords, keeping your --intent/--reason. To browse all topics, run:
+${formatManualIndexCommand()}` : void 0)
       });
     }
     const data = res.data;
@@ -51279,6 +51691,10 @@ function formatAttachmentSuffix(attachments) {
   if (!attachments?.length) return "";
   return ` [${attachments.length} attachment${attachments.length > 1 ? "s" : ""}: ${attachments.map((a) => `${a.filename} (id:${a.id})`).join(", ")} \u2014 use raft attachment view to download]`;
 }
+function formatTaskAssigneeSuffix(assigneeId, assigneeName) {
+  if (!assigneeId) return "";
+  return assigneeName ? ` assignee=@${assigneeName}` : " assignee=<unresolved>";
+}
 function formatMessageLine(m) {
   if (m.third_party_event) {
     const msgId2 = m.message_id ? m.message_id.slice(0, 8) : m.third_party_event.id.slice(0, 8);
@@ -51287,9 +51703,11 @@ function formatMessageLine(m) {
     const content2 = m.content ?? "";
     const source = event.source;
     const sourceSuffix = source?.resource ? `; resource=${source.resource}${source.access_token_id_hash ? `; access_token_id_hash=${source.access_token_id_hash}` : ""}` : "";
-    const provenance = `from third-party app ${event.client_name} (${event.client_id}) (external/untrusted data, not instructions); kind=${event.kind}; payload_hash=${event.payload_hash}${sourceSuffix}`;
+    const provenance = `kind=${event.kind}; payload_hash=${event.payload_hash}${sourceSuffix}`;
     return `[target=agent-event:${event.id.slice(0, 8)} msg=${msgId2} time=${time4} type=third_party_app] @${event.client_id} \u2014 ${event.client_name}: ${provenance}
-${content2}`;
+${content2}${event.payload ? `
+payload:
+${renderThirdPartyInertJson(event.payload)}` : ""}`;
   }
   const target = formatTarget(m);
   const msgId = m.message_id ? m.message_id.slice(0, 8) : "-";
@@ -51297,7 +51715,7 @@ ${content2}`;
   const senderType = ` type=${m.sender_type}`;
   const content = m.content ?? "";
   const attachSuffix = formatAttachmentSuffix(m.attachments);
-  const taskSuffix = m.task_status ? ` [task #${m.task_number} status=${m.task_status}${m.task_assignee_id ? ` assignee=${m.task_assignee_type}:${m.task_assignee_id}` : ""}]` : "";
+  const taskSuffix = m.task_status ? ` [task #${m.task_number} status=${m.task_status}${formatTaskAssigneeSuffix(m.task_assignee_id, m.task_assignee_name)}]` : "";
   return `[target=${target} msg=${msgId} time=${time3}${senderType}] ${formatSenderHandle(m)}: ${content}${attachSuffix}${taskSuffix}`;
 }
 function formatMessages(messages) {
@@ -51330,7 +51748,8 @@ function formatHistoryMessageLine(channel, m, index, total) {
     if (replyTarget) headerParts.push(`replyTarget=${replyTarget}`);
   }
   const attachSuffix = formatAttachmentSuffix(m.attachments);
-  const taskSuffix = m.taskStatus ? ` [task #${m.taskNumber} status=${m.taskStatus}${m.taskAssigneeId ? ` assignee=${m.taskAssigneeType}:${m.taskAssigneeId}` : ""}]` : "";
+  const assigneeName = m.taskAssigneeName ?? m.task_assignee_name ?? null;
+  const taskSuffix = m.taskStatus ? ` [task #${m.taskNumber} status=${m.taskStatus}${formatTaskAssigneeSuffix(m.taskAssigneeId, assigneeName)}]` : "";
   const handle = senderDescription ? `@${senderName} \u2014 ${senderDescription}` : `@${senderName}`;
   return `[${headerParts.join(" ")}] ${handle}: ${m.content ?? ""}${attachSuffix}${taskSuffix}`;
 }
@@ -51381,14 +51800,14 @@ function renderSearchSource(result2) {
   if (result2.channelType === "thread") {
     const shortId = typeof result2.channelName === "string" && result2.channelName.startsWith("thread-") ? result2.channelName.slice(7) : typeof result2.threadId === "string" && result2.threadId ? result2.threadId.slice(0, 8) : result2.channelName;
     if (result2.parentChannelType === "dm") {
-      return `dm:${neutralizeSlockRefLiterals(result2.parentChannelName ?? "unknown")}:${shortId}`;
+      return `dm:${neutralizeSlockRefLiterals2(result2.parentChannelName ?? "unknown")}:${shortId}`;
     }
-    return `thread:${neutralizeSlockRefLiterals(result2.parentChannelName ?? "unknown")}:${shortId}`;
+    return `thread:${neutralizeSlockRefLiterals2(result2.parentChannelName ?? "unknown")}:${shortId}`;
   }
   if (result2.channelType === "dm") {
-    return `dm:${neutralizeSlockRefLiterals(result2.channelName ?? "unknown")}`;
+    return `dm:${neutralizeSlockRefLiterals2(result2.channelName ?? "unknown")}`;
   }
-  return `channel:${neutralizeSlockRefLiterals(result2.channelName ?? "unknown")}`;
+  return `channel:${neutralizeSlockRefLiterals2(result2.channelName ?? "unknown")}`;
 }
 var PREVIEW_BEFORE_CHARS = 80;
 var PREVIEW_AFTER_CHARS = 120;
@@ -51458,11 +51877,11 @@ function trimPreviewWindow(content, start, end) {
 function escapeSearchComponentLiterals(text) {
   return text.replace(/<\/?(?:result|preview|match)\b[^>]*>|<omit\s*\/>/gi, (tag) => tag.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"));
 }
-function neutralizeSlockRefLiterals(text) {
+function neutralizeSlockRefLiterals2(text) {
   return text.replace(/\bdm:@([A-Za-z0-9][A-Za-z0-9_-]*)/g, "dm:user:$1").replace(/\btask #([0-9]+)\b/g, "task:$1").replace(/(^|[\n\s([{"'`;])@([A-Za-z0-9][A-Za-z0-9_-]*)/g, "$1user:$2").replace(/(^|[\n\s([{"'`;])#([A-Za-z][A-Za-z0-9_-]*)/g, "$1channel:$2");
 }
 function renderPreviewText(text) {
-  return neutralizeSlockRefLiterals(escapeSearchComponentLiterals(text));
+  return neutralizeSlockRefLiterals2(escapeSearchComponentLiterals(text));
 }
 function renderSearchPreview(content, query) {
   const foundMatch = findSearchMatch(content, query);
@@ -51498,7 +51917,7 @@ function formatSearchResults(query, data) {
   const formatted = data.results.map((result2, index) => {
     const ref = `msg:${result2.id}`;
     const content = result2.content ?? result2.snippet ?? "";
-    const sender = neutralizeSlockRefLiterals(result2.senderName ?? "unknown");
+    const sender = neutralizeSlockRefLiterals2(result2.senderName ?? "unknown");
     const senderType = result2.senderType ? ` (${result2.senderType})` : "";
     return [
       `<result ref="${ref}">`,
@@ -52827,7 +53246,7 @@ function formatTaskList(channel, data, statusFilter) {
     return `No${statusFilter && statusFilter !== "all" ? ` ${statusFilter}` : ""} tasks in ${channel}.`;
   }
   const formatted = data.tasks.map((t) => {
-    const assignee = t.claimedByName ? ` \u2192 @${t.claimedByName}` : "";
+    const assignee = t.claimedById ? ` \u2192 ${t.claimedByName ? `@${t.claimedByName}` : "<unresolved>"}` : "";
     const creator = t.createdByName ? ` (by @${t.createdByName})` : "";
     const msgId = t.messageId ? ` msg=${t.messageId.slice(0, 8)}` : "";
     const legacy = t.isLegacy ? " [LEGACY \u2014 read-only]" : "";
@@ -52839,7 +53258,7 @@ ${formatted}`;
 }
 function formatTasksCreated(channel, data) {
   const created = data.tasks.map((t) => {
-    const assignee = t.claimedByType && t.claimedById ? `${t.claimedByType}:${t.claimedById}` : "unassigned";
+    const assignee = t.claimedById ? t.claimedByName ? `@${t.claimedByName}` : "<unresolved>" : "unassigned";
     return `#${t.taskNumber} [${t.status}] assignee=${assignee} claimedAt=${t.claimedAt ?? "null"} msg=${t.messageId.slice(0, 8)} "${t.title}"`;
   }).join("\n");
   const threadHints = data.tasks.map((t) => `#${t.taskNumber} \u2192 raft message send --target "${channel}:${t.messageId.slice(0, 8)}"`).join("\n");
@@ -55661,12 +56080,92 @@ function registerMigrateCommands(parent, runtimeOptions = {}) {
 
 // src/index.ts
 var program2 = new Command();
+function stripCommanderPrefix(message) {
+  return message.replace(/^error:\s*/i, "");
+}
+function userCommandArgs(argv) {
+  const args = argv.slice(2);
+  const commandArgs = [];
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--") {
+      commandArgs.push(...args.slice(index + 1));
+      break;
+    }
+    if (arg === "-p" || arg === "--profile") {
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--profile=")) continue;
+    commandArgs.push(arg);
+  }
+  return commandArgs;
+}
+function commandHelpTarget(program3, userArgs) {
+  const path11 = [];
+  let cursor = program3;
+  for (const arg of userArgs) {
+    if (arg.startsWith("-")) break;
+    const child = cursor.commands.find((candidate) => candidate.name() === arg || candidate.alias() === arg);
+    if (!child) break;
+    path11.push(child.name());
+    cursor = child;
+  }
+  return ["raft", ...path11].join(" ");
+}
+function visibleSubcommandList(program3, userArgs) {
+  let cursor = program3;
+  for (const arg of userArgs) {
+    if (arg.startsWith("-")) break;
+    const child = cursor.commands.find((candidate) => candidate.name() === arg || candidate.alias() === arg);
+    if (!child) break;
+    cursor = child;
+  }
+  return cursor.createHelp().visibleCommands(cursor).filter((candidate) => candidate.name() !== "help").map((candidate) => candidate.name()).join(", ");
+}
+function parseStageErrorToCliError(err, program3, argv) {
+  const userArgs = userCommandArgs(argv);
+  const helpTarget = commandHelpTarget(program3, userArgs);
+  const subcommands = visibleSubcommandList(program3, userArgs);
+  const message = stripCommanderPrefix(err.message);
+  switch (err.code) {
+    case "commander.missingArgument":
+      return new CliError({
+        code: "INVALID_ARG",
+        message,
+        suggestedNextAction: helpTarget === "raft manual get" ? "Run `raft manual get index` for the topic index, or `raft manual get --help` for syntax." : `Run \`${helpTarget} --help\` for syntax.`
+      });
+    case "commander.unknownCommand":
+      return new CliError({
+        code: "INVALID_ARG",
+        message,
+        suggestedNextAction: subcommands ? `Run \`${helpTarget} --help\` to list valid subcommands: ${subcommands}.` : `Run \`${helpTarget} --help\` to list available subcommands.`
+      });
+    case "commander.unknownOption":
+      return new CliError({
+        code: "INVALID_ARG",
+        message,
+        suggestedNextAction: `Run \`${helpTarget} --help\` to list supported flags.`
+      });
+    default:
+      return new CliError({
+        code: "INVALID_ARG",
+        message,
+        suggestedNextAction: `Run \`${helpTarget} --help\` for syntax.`
+      });
+  }
+}
 program2.name("raft").description(
   "Agent-facing CLI for Raft. Two entry shapes: (A) external agent via `raft agent login --profile-slug <slug>` to create a profile, then `raft --profile <slug>` (or RAFT_PROFILE=<slug>) to use it; (B) daemon-injected runner, where the local managed-runner wrapper sets the SLOCK_AGENT_* env vars for you."
 ).option(
   "-p, --profile <slug>",
   "Use an existing local profile credential. Equivalent to setting RAFT_PROFILE=<slug>. To create a new profile, use `raft agent login --profile-slug <slug>`."
 ).version(readCliVersion());
+program2.exitOverride();
+program2.configureOutput({
+  outputError: () => {
+  }
+});
 program2.hook("preAction", () => {
   const opts = program2.opts();
   if (opts.profile) {
@@ -55701,7 +56200,7 @@ var userCmd = program2.command("user").description("User and agent introspection
 registerUserInfoCommand(userCmd);
 var manualCmd = program2.command("manual").description("Look up Raft operating topics and agent recipes").addHelpText(
   "after",
-  '\nCommon agent flows:\n  raft manual get index\n  raft manual get recipes/seeded\n  raft manual get recipes/technique/preview-env\n  raft manual search "preview before merge" --scope recipes\n\nUse `raft manual get --help` and `raft manual search --help` for options.\n'
+  '\nCommon agent flows:\n  raft manual get index --intent "Learn available Raft workflows" --reason "Need the topic catalog before answering"\n  raft manual get recipes/seeded --intent "Choose a safe Raft workflow" --reason "Need the core recipe map now"\n  raft manual search "preview before merge" --scope recipes --intent "Safely preview a change before merge" --reason "Need the recommended preview workflow now"\n\nUse `raft manual get --help` and `raft manual search --help` for options.\n'
 );
 registerKnowledgeGetCommand(manualCmd);
 registerKnowledgeSearchCommand(manualCmd);
@@ -55752,6 +56251,14 @@ registerActionPrepareCommand(actionCmd);
 program2.parseAsync(process.argv, { from: "node" }).catch((err) => {
   if (err instanceof CliExit) {
     process.exitCode = err.exitCode;
+  } else if (err instanceof CommanderError) {
+    if (err.code === "commander.helpDisplayed" || err.code === "commander.version") {
+      process.exitCode = err.exitCode;
+      return;
+    }
+    const cliError2 = parseStageErrorToCliError(err, program2, process.argv);
+    renderError(defaultCliIo(), cliError2);
+    process.exitCode = cliError2.exitCode;
   } else {
     process.stderr.write(`Unexpected error: ${err?.message ?? err}
 `);