open-multi-agent-kit 0.97.0 → 0.98.0

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+import type { ExtensionFlag } from "../core/extensions/types.ts";
+export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,wBAAgB,SAAS,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,CA8LhE","sourcesContent":["import chalk from \"chalk\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, ENV_SESSION_DIR } from \"../config.ts\";\nimport type { ExtensionFlag } from \"../core/extensions/types.ts\";\n\nexport function printHelp(extensionFlags?: ExtensionFlag[]): void {\n\tlet extensionFlagsText = \"\";\n\tif (extensionFlags && extensionFlags.length > 0) {\n\t\textensionFlagsText = `\\n${chalk.bold(\"Extension CLI Flags:\")}\\n${extensionFlags\n\t\t\t.map((flag) => {\n\t\t\t\tconst value = flag.type === \"string\" ? \" <value>\" : \"\";\n\t\t\t\tconst description = flag.description ?? `Registered by ${flag.extensionPath}`;\n\t\t\t\treturn `  --${flag.name}${value}`.padEnd(30) + description;\n\t\t\t})\n\t\t\t.join(\"\\n\")}\\n`;\n\t}\n\t// CLI help is intentional stdout, not application debug logging.\n\t// pi-lens-ignore: no-console-except-error\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n  ${APP_NAME} [options] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n  ${APP_NAME} install <source> [-l]     Install extension source and add to settings\n  ${APP_NAME} remove <source> [-l]      Remove extension source from settings\n  ${APP_NAME} uninstall <source> [-l]   Alias for remove\n  ${APP_NAME} update [source|self|omk]  Update OMK and installed extensions\n  ${APP_NAME} list                      List installed extensions from settings\n  ${APP_NAME} package doctor <source>   Diagnose omk/pi manifest and runtime compatibility as JSON\n  ${APP_NAME} config                    Open TUI to enable/disable package resources\n  ${APP_NAME} quota                     Manage CodexBar quota connector and summaries\n  ${APP_NAME} provider doctor <id>      Diagnose a provider as sanitized JSON (--probe-model adds an\n                                 opt-in Level-2 generative probe that may incur provider costs)\n  ${APP_NAME} session doctor            Inspect or safely repair one session (--session, --repair, --dry-run)\n  ${APP_NAME} doctor resources [--json] [--report] Inspect current pressure or aggregate local observations\n  ${APP_NAME} doctor adaptorch [--json]  Verify ADAPTORCH_API_KEY reaches the AdaptOrch API (0 ok, 1 unset, 2 failed)\n  ${APP_NAME} router-feedback compile-bias  Compile this repository's bounded router bias snapshot\n  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list\n\n${chalk.bold(\"Options:\")}\n  --provider <name>              Provider name (default: google)\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n  --api-key <key>                API key (defaults to env vars)\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\n  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)\n  --mode <mode>                  Output mode: text (default), json, or rpc\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --session <path|id>            Use specific session file or partial UUID\n  --session-id <id>              Use exact project session ID, creating it if missing\n  --fork <path|id>               Fork specific session file or partial UUID into a new session\n  --session-dir <dir>            Directory for session storage and lookup\n  --no-session                   Don't save session (ephemeral)\n  --name, -n <name>              Set session display name\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n  --no-tools, -nt                Disable all tools by default (built-in and extension)\n  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled\n  --tools, -t <tools>            Comma-separated allowlist of tool names to enable\n                                 Applies to built-in, extension, and custom tools\n  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable\n                                 Applies to built-in, extension, and custom tools\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max, ultra\n  --extension, -e <path>         Load an extension file (can be used multiple times)\n  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\n  --no-skills, -ns               Disable skills discovery and loading\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\n  --no-themes                    Disable theme discovery and loading\n  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading\n  --export <file>                Export session file to HTML and exit\n  --list-models [search]         List available models (with optional fuzzy search)\n  --verbose                      Force verbose startup (overrides quietStartup setting)\n  --offline                      Disable startup network operations (same as OMK_OFFLINE=1)\n  --help, -h                     Show this help\n  --version, -v                  Show version number\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}\n\n${chalk.bold(\"Examples:\")}\n  # Interactive mode\n  ${APP_NAME}\n\n  # Interactive mode with initial prompt\n  ${APP_NAME} \"List all .ts files in src/\"\n\n  # Include files in initial message\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n  # Non-interactive mode (process and exit)\n  ${APP_NAME} -p \"List all .ts files in src/\"\n\n  # Multiple messages (interactive)\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  ${APP_NAME} --continue \"What did we discuss?\"\n\n  # Start a named session\n  ${APP_NAME} --name \"Refactor auth module\"\n\n  # Use different model\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use model with provider prefix (no --provider needed)\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n  # Use model with thinking level shorthand\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n  # Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n  # Limit to a specific provider with glob pattern\n  ${APP_NAME} --models \"github-copilot/*\"\n\n  # Cycle models with fixed thinking levels\n  ${APP_NAME} --models sonnet:high,haiku:low\n\n  # Start with a specific thinking level\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n  # Read-only mode (no file modifications possible)\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n  # Disable one tool while keeping the rest available\n  ${APP_NAME} --exclude-tools ask_question\n\n  # Export a session file to HTML\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n  ${APP_NAME} --export session.jsonl output.html\n\n${chalk.bold(\"Environment Variables:\")}\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\n  ANT_LING_API_KEY                 - Ant Ling API key\n  OPENAI_API_KEY                   - OpenAI GPT API key\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n  DEEPSEEK_API_KEY                 - DeepSeek API key\n  NVIDIA_API_KEY                   - NVIDIA NIM API key\n  GEMINI_API_KEY                   - Google Gemini API key\n  GROQ_API_KEY                     - Groq API key\n  CEREBRAS_API_KEY                 - Cerebras API key\n  XAI_API_KEY                      - xAI Grok API key\n  FIREWORKS_API_KEY                - Fireworks API key\n  TOGETHER_API_KEY                 - Together AI API key\n  OPENROUTER_API_KEY               - OpenRouter API key\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\n  ZAI_API_KEY                      - ZAI API key\n  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)\n  MISTRAL_API_KEY                  - Mistral API key\n  MINIMAX_API_KEY                  - MiniMax API key\n  MOONSHOT_API_KEY                 - Moonshot AI API key\n  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key\n  KIMI_API_KEY                     - Kimi For Coding API key\n  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)\n  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)\n  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)\n  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)\n  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)\n  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)\n  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)\n  ZYLOO_API_KEY                    - Zyloo API key\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\n  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)\n  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)\n  OMK_PACKAGE_DIR                  - Override package directory (for Nix/Guix store paths)\n  OMK_TOOL_SCHEDULER               - Tool scheduler override: dag-v2 or waves-v1 rollback\n  OMK_OFFLINE                      - Disable startup network operations when set to 1/true/yes\n  OMK_TELEMETRY                    - Override install telemetry when set to 1/true/yes or 0/false/no\n  OMK_SHARE_VIEWER_URL             - Base URL for /share command (default: https://omk.dev/session/)\n  ADAPTORCH_API_KEY                - AdaptOrch API key (optional; enables the doctor adaptorch check)\n  ADAPTORCH_API_URL                - AdaptOrch API base URL (default: https://api.adaptorch.com)\n\n${chalk.bold(\"Built-in Tool Names:\")}\n  read   - Read file contents\n  bash   - Execute bash commands\n  edit   - Edit files with find/replace\n  write  - Write files (creates/overwrites)\n  grep   - Search file contents (read-only, off by default)\n  find   - Find files by glob pattern (read-only, off by default)\n  ls     - List directory contents (read-only, off by default)\n`);\n}\n"]}

package/dist/cli/help.js

@@ -0,0 +1,194 @@
+import chalk from "chalk";
+import { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, ENV_SESSION_DIR } from "../config.js";
+export function printHelp(extensionFlags) {
+    let extensionFlagsText = "";
+    if (extensionFlags && extensionFlags.length > 0) {
+        extensionFlagsText = `\n${chalk.bold("Extension CLI Flags:")}\n${extensionFlags
+            .map((flag) => {
+            const value = flag.type === "string" ? " <value>" : "";
+            const description = flag.description ?? `Registered by ${flag.extensionPath}`;
+            return `  --${flag.name}${value}`.padEnd(30) + description;
+        })
+            .join("\n")}\n`;
+    }
+    // CLI help is intentional stdout, not application debug logging.
+    // pi-lens-ignore: no-console-except-error
+    console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
+
+${chalk.bold("Usage:")}
+  ${APP_NAME} [options] [@files...] [messages...]
+
+${chalk.bold("Commands:")}
+  ${APP_NAME} install <source> [-l]     Install extension source and add to settings
+  ${APP_NAME} remove <source> [-l]      Remove extension source from settings
+  ${APP_NAME} uninstall <source> [-l]   Alias for remove
+  ${APP_NAME} update [source|self|omk]  Update OMK and installed extensions
+  ${APP_NAME} list                      List installed extensions from settings
+  ${APP_NAME} package doctor <source>   Diagnose omk/pi manifest and runtime compatibility as JSON
+  ${APP_NAME} config                    Open TUI to enable/disable package resources
+  ${APP_NAME} quota                     Manage CodexBar quota connector and summaries
+  ${APP_NAME} provider doctor <id>      Diagnose a provider as sanitized JSON (--probe-model adds an
+                                 opt-in Level-2 generative probe that may incur provider costs)
+  ${APP_NAME} session doctor            Inspect or safely repair one session (--session, --repair, --dry-run)
+  ${APP_NAME} doctor resources [--json] [--report] Inspect current pressure or aggregate local observations
+  ${APP_NAME} doctor adaptorch [--json]  Verify ADAPTORCH_API_KEY reaches the AdaptOrch API (0 ok, 1 unset, 2 failed)
+  ${APP_NAME} router-feedback compile-bias  Compile this repository's bounded router bias snapshot
+  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list
+
+${chalk.bold("Options:")}
+  --provider <name>              Provider name (default: google)
+  --model <pattern>              Model pattern or ID (supports "provider/id" and optional ":<thinking>")
+  --api-key <key>                API key (defaults to env vars)
+  --system-prompt <text>         System prompt (default: coding assistant prompt)
+  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)
+  --mode <mode>                  Output mode: text (default), json, or rpc
+  --print, -p                    Non-interactive mode: process prompt and exit
+  --continue, -c                 Continue previous session
+  --resume, -r                   Select a session to resume
+  --session <path|id>            Use specific session file or partial UUID
+  --session-id <id>              Use exact project session ID, creating it if missing
+  --fork <path|id>               Fork specific session file or partial UUID into a new session
+  --session-dir <dir>            Directory for session storage and lookup
+  --no-session                   Don't save session (ephemeral)
+  --name, -n <name>              Set session display name
+  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling
+                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching
+  --no-tools, -nt                Disable all tools by default (built-in and extension)
+  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled
+  --tools, -t <tools>            Comma-separated allowlist of tool names to enable
+                                 Applies to built-in, extension, and custom tools
+  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable
+                                 Applies to built-in, extension, and custom tools
+  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max, ultra
+  --extension, -e <path>         Load an extension file (can be used multiple times)
+  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)
+  --skill <path>                 Load a skill file or directory (can be used multiple times)
+  --no-skills, -ns               Disable skills discovery and loading
+  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)
+  --no-prompt-templates, -np     Disable prompt template discovery and loading
+  --theme <path>                 Load a theme file or directory (can be used multiple times)
+  --no-themes                    Disable theme discovery and loading
+  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading
+  --export <file>                Export session file to HTML and exit
+  --list-models [search]         List available models (with optional fuzzy search)
+  --verbose                      Force verbose startup (overrides quietStartup setting)
+  --offline                      Disable startup network operations (same as OMK_OFFLINE=1)
+  --help, -h                     Show this help
+  --version, -v                  Show version number
+
+Extensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}
+
+${chalk.bold("Examples:")}
+  # Interactive mode
+  ${APP_NAME}
+
+  # Interactive mode with initial prompt
+  ${APP_NAME} "List all .ts files in src/"
+
+  # Include files in initial message
+  ${APP_NAME} @prompt.md @image.png "What color is the sky?"
+
+  # Non-interactive mode (process and exit)
+  ${APP_NAME} -p "List all .ts files in src/"
+
+  # Multiple messages (interactive)
+  ${APP_NAME} "Read package.json" "What dependencies do we have?"
+
+  # Continue previous session
+  ${APP_NAME} --continue "What did we discuss?"
+
+  # Start a named session
+  ${APP_NAME} --name "Refactor auth module"
+
+  # Use different model
+  ${APP_NAME} --provider openai --model gpt-4o-mini "Help me refactor this code"
+
+  # Use model with provider prefix (no --provider needed)
+  ${APP_NAME} --model openai/gpt-4o "Help me refactor this code"
+
+  # Use model with thinking level shorthand
+  ${APP_NAME} --model sonnet:high "Solve this complex problem"
+
+  # Limit model cycling to specific models
+  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o
+
+  # Limit to a specific provider with glob pattern
+  ${APP_NAME} --models "github-copilot/*"
+
+  # Cycle models with fixed thinking levels
+  ${APP_NAME} --models sonnet:high,haiku:low
+
+  # Start with a specific thinking level
+  ${APP_NAME} --thinking high "Solve this complex problem"
+
+  # Read-only mode (no file modifications possible)
+  ${APP_NAME} --tools read,grep,find,ls -p "Review the code in src/"
+
+  # Disable one tool while keeping the rest available
+  ${APP_NAME} --exclude-tools ask_question
+
+  # Export a session file to HTML
+  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl
+  ${APP_NAME} --export session.jsonl output.html
+
+${chalk.bold("Environment Variables:")}
+  ANTHROPIC_API_KEY                - Anthropic Claude API key
+  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)
+  ANT_LING_API_KEY                 - Ant Ling API key
+  OPENAI_API_KEY                   - OpenAI GPT API key
+  AZURE_OPENAI_API_KEY             - Azure OpenAI API key
+  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)
+  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)
+  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)
+  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)
+  DEEPSEEK_API_KEY                 - DeepSeek API key
+  NVIDIA_API_KEY                   - NVIDIA NIM API key
+  GEMINI_API_KEY                   - Google Gemini API key
+  GROQ_API_KEY                     - Groq API key
+  CEREBRAS_API_KEY                 - Cerebras API key
+  XAI_API_KEY                      - xAI Grok API key
+  FIREWORKS_API_KEY                - Fireworks API key
+  TOGETHER_API_KEY                 - Together AI API key
+  OPENROUTER_API_KEY               - OpenRouter API key
+  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key
+  ZAI_API_KEY                      - ZAI API key
+  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)
+  MISTRAL_API_KEY                  - Mistral API key
+  MINIMAX_API_KEY                  - MiniMax API key
+  MOONSHOT_API_KEY                 - Moonshot AI API key
+  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key
+  KIMI_API_KEY                     - Kimi For Coding API key
+  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)
+  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)
+  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)
+  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)
+  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)
+  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)
+  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)
+  ZYLOO_API_KEY                    - Zyloo API key
+  AWS_PROFILE                      - AWS profile for Amazon Bedrock
+  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock
+  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock
+  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)
+  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)
+  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)
+  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)
+  OMK_PACKAGE_DIR                  - Override package directory (for Nix/Guix store paths)
+  OMK_TOOL_SCHEDULER               - Tool scheduler override: dag-v2 or waves-v1 rollback
+  OMK_OFFLINE                      - Disable startup network operations when set to 1/true/yes
+  OMK_TELEMETRY                    - Override install telemetry when set to 1/true/yes or 0/false/no
+  OMK_SHARE_VIEWER_URL             - Base URL for /share command (default: https://omk.dev/session/)
+  ADAPTORCH_API_KEY                - AdaptOrch API key (optional; enables the doctor adaptorch check)
+  ADAPTORCH_API_URL                - AdaptOrch API base URL (default: https://api.adaptorch.com)
+
+${chalk.bold("Built-in Tool Names:")}
+  read   - Read file contents
+  bash   - Execute bash commands
+  edit   - Edit files with find/replace
+  write  - Write files (creates/overwrites)
+  grep   - Search file contents (read-only, off by default)
+  find   - Find files by glob pattern (read-only, off by default)
+  ls     - List directory contents (read-only, off by default)
+`);
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGzF,MAAM,UAAU,SAAS,CAAC,cAAgC,EAAQ;IACjE,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAC5B,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,kBAAkB,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,cAAc;aAC7E,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,iBAAiB,IAAI,CAAC,aAAa,EAAE,CAAC;YAC9E,OAAO,OAAO,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC;QAAA,CAC3D,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IACD,iEAAiE;IACjE,0CAA0C;IAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;;EAElC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;IAClB,QAAQ;;EAEV,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;IACrB,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;;IAER,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,QAAQ;;EAEV,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFAyC2D,kBAAkB;;EAEnG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;IAErB,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ;;;IAGR,QAAQ,eAAe,eAAe;IACtC,QAAQ;;EAEV,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwClC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,mCAAmC,eAAe;IAC1E,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;;;;;;;;;EAS5B,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC;;;;;;;;CAQnC,CAAC,CAAC;AAAA,CACF","sourcesContent":["import chalk from \"chalk\";\nimport { APP_NAME, CONFIG_DIR_NAME, ENV_AGENT_DIR, ENV_SESSION_DIR } from \"../config.ts\";\nimport type { ExtensionFlag } from \"../core/extensions/types.ts\";\n\nexport function printHelp(extensionFlags?: ExtensionFlag[]): void {\n\tlet extensionFlagsText = \"\";\n\tif (extensionFlags && extensionFlags.length > 0) {\n\t\textensionFlagsText = `\\n${chalk.bold(\"Extension CLI Flags:\")}\\n${extensionFlags\n\t\t\t.map((flag) => {\n\t\t\t\tconst value = flag.type === \"string\" ? \" <value>\" : \"\";\n\t\t\t\tconst description = flag.description ?? `Registered by ${flag.extensionPath}`;\n\t\t\t\treturn `  --${flag.name}${value}`.padEnd(30) + description;\n\t\t\t})\n\t\t\t.join(\"\\n\")}\\n`;\n\t}\n\t// CLI help is intentional stdout, not application debug logging.\n\t// pi-lens-ignore: no-console-except-error\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n  ${APP_NAME} [options] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n  ${APP_NAME} install <source> [-l]     Install extension source and add to settings\n  ${APP_NAME} remove <source> [-l]      Remove extension source from settings\n  ${APP_NAME} uninstall <source> [-l]   Alias for remove\n  ${APP_NAME} update [source|self|omk]  Update OMK and installed extensions\n  ${APP_NAME} list                      List installed extensions from settings\n  ${APP_NAME} package doctor <source>   Diagnose omk/pi manifest and runtime compatibility as JSON\n  ${APP_NAME} config                    Open TUI to enable/disable package resources\n  ${APP_NAME} quota                     Manage CodexBar quota connector and summaries\n  ${APP_NAME} provider doctor <id>      Diagnose a provider as sanitized JSON (--probe-model adds an\n                                 opt-in Level-2 generative probe that may incur provider costs)\n  ${APP_NAME} session doctor            Inspect or safely repair one session (--session, --repair, --dry-run)\n  ${APP_NAME} doctor resources [--json] [--report] Inspect current pressure or aggregate local observations\n  ${APP_NAME} doctor adaptorch [--json]  Verify ADAPTORCH_API_KEY reaches the AdaptOrch API (0 ok, 1 unset, 2 failed)\n  ${APP_NAME} router-feedback compile-bias  Compile this repository's bounded router bias snapshot\n  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list\n\n${chalk.bold(\"Options:\")}\n  --provider <name>              Provider name (default: google)\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n  --api-key <key>                API key (defaults to env vars)\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\n  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)\n  --mode <mode>                  Output mode: text (default), json, or rpc\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --session <path|id>            Use specific session file or partial UUID\n  --session-id <id>              Use exact project session ID, creating it if missing\n  --fork <path|id>               Fork specific session file or partial UUID into a new session\n  --session-dir <dir>            Directory for session storage and lookup\n  --no-session                   Don't save session (ephemeral)\n  --name, -n <name>              Set session display name\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n  --no-tools, -nt                Disable all tools by default (built-in and extension)\n  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled\n  --tools, -t <tools>            Comma-separated allowlist of tool names to enable\n                                 Applies to built-in, extension, and custom tools\n  --exclude-tools, -xt <tools>   Comma-separated denylist of tool names to disable\n                                 Applies to built-in, extension, and custom tools\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh, max, ultra\n  --extension, -e <path>         Load an extension file (can be used multiple times)\n  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\n  --no-skills, -ns               Disable skills discovery and loading\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\n  --no-themes                    Disable theme discovery and loading\n  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading\n  --export <file>                Export session file to HTML and exit\n  --list-models [search]         List available models (with optional fuzzy search)\n  --verbose                      Force verbose startup (overrides quietStartup setting)\n  --offline                      Disable startup network operations (same as OMK_OFFLINE=1)\n  --help, -h                     Show this help\n  --version, -v                  Show version number\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}\n\n${chalk.bold(\"Examples:\")}\n  # Interactive mode\n  ${APP_NAME}\n\n  # Interactive mode with initial prompt\n  ${APP_NAME} \"List all .ts files in src/\"\n\n  # Include files in initial message\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n  # Non-interactive mode (process and exit)\n  ${APP_NAME} -p \"List all .ts files in src/\"\n\n  # Multiple messages (interactive)\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  ${APP_NAME} --continue \"What did we discuss?\"\n\n  # Start a named session\n  ${APP_NAME} --name \"Refactor auth module\"\n\n  # Use different model\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use model with provider prefix (no --provider needed)\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n  # Use model with thinking level shorthand\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n  # Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n  # Limit to a specific provider with glob pattern\n  ${APP_NAME} --models \"github-copilot/*\"\n\n  # Cycle models with fixed thinking levels\n  ${APP_NAME} --models sonnet:high,haiku:low\n\n  # Start with a specific thinking level\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n  # Read-only mode (no file modifications possible)\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n  # Disable one tool while keeping the rest available\n  ${APP_NAME} --exclude-tools ask_question\n\n  # Export a session file to HTML\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n  ${APP_NAME} --export session.jsonl output.html\n\n${chalk.bold(\"Environment Variables:\")}\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\n  ANT_LING_API_KEY                 - Ant Ling API key\n  OPENAI_API_KEY                   - OpenAI GPT API key\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n  DEEPSEEK_API_KEY                 - DeepSeek API key\n  NVIDIA_API_KEY                   - NVIDIA NIM API key\n  GEMINI_API_KEY                   - Google Gemini API key\n  GROQ_API_KEY                     - Groq API key\n  CEREBRAS_API_KEY                 - Cerebras API key\n  XAI_API_KEY                      - xAI Grok API key\n  FIREWORKS_API_KEY                - Fireworks API key\n  TOGETHER_API_KEY                 - Together AI API key\n  OPENROUTER_API_KEY               - OpenRouter API key\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\n  ZAI_API_KEY                      - ZAI API key\n  ZAI_CODING_CN_API_KEY            - ZAI Coding Plan API key (China)\n  MISTRAL_API_KEY                  - Mistral API key\n  MINIMAX_API_KEY                  - MiniMax API key\n  MOONSHOT_API_KEY                 - Moonshot AI API key\n  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key\n  KIMI_API_KEY                     - Kimi For Coding API key\n  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)\n  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)\n  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)\n  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)\n  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)\n  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)\n  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)\n  ZYLOO_API_KEY                    - Zyloo API key\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\n  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)\n  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)\n  OMK_PACKAGE_DIR                  - Override package directory (for Nix/Guix store paths)\n  OMK_TOOL_SCHEDULER               - Tool scheduler override: dag-v2 or waves-v1 rollback\n  OMK_OFFLINE                      - Disable startup network operations when set to 1/true/yes\n  OMK_TELEMETRY                    - Override install telemetry when set to 1/true/yes or 0/false/no\n  OMK_SHARE_VIEWER_URL             - Base URL for /share command (default: https://omk.dev/session/)\n  ADAPTORCH_API_KEY                - AdaptOrch API key (optional; enables the doctor adaptorch check)\n  ADAPTORCH_API_URL                - AdaptOrch API base URL (default: https://api.adaptorch.com)\n\n${chalk.bold(\"Built-in Tool Names:\")}\n  read   - Read file contents\n  bash   - Execute bash commands\n  edit   - Edit files with find/replace\n  write  - Write files (creates/overwrites)\n  grep   - Search file contents (read-only, off by default)\n  find   - Find files by glob pattern (read-only, off by default)\n  ls     - List directory contents (read-only, off by default)\n`);\n}\n"]}

package/dist/cli/initial-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initial-message.d.ts","sourceRoot":"","sources":["../../src/cli/initial-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,EAAE,mBAAmB,GAAG,oBAAoB,CAkB5C","sourcesContent":["import type { ImageContent } from \"omk-ai\";\nimport type { Args } from \"./args.ts\";\n\nexport interface InitialMessageInput {\n\tparsed: Args;\n\tfileText?: string;\n\tfileImages?: ImageContent[];\n\tstdinContent?: string;\n}\n\nexport interface InitialMessageResult {\n\tinitialMessage?: string;\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Combine stdin content, @file text, and the first CLI message into a single\n * initial prompt for non-interactive mode.\n */\nexport function buildInitialMessage({\n\tparsed,\n\tfileText,\n\tfileImages,\n\tstdinContent,\n}: InitialMessageInput): InitialMessageResult {\n\tconst parts: string[] = [];\n\tif (stdinContent !== undefined) {\n\t\tparts.push(stdinContent);\n\t}\n\tif (fileText) {\n\t\tparts.push(fileText);\n\t}\n\n\tif (parsed.messages.length > 0) {\n\t\tparts.push(parsed.messages[0]);\n\t\tparsed.messages.shift();\n\t}\n\n\treturn {\n\t\tinitialMessage: parts.length > 0 ? parts.join(\"\") : undefined,\n\t\tinitialImages: fileImages && fileImages.length > 0 ? fileImages : undefined,\n\t};\n}\n"]}
+{"version":3,"file":"initial-message.d.ts","sourceRoot":"","sources":["../../src/cli/initial-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,EAAE,mBAAmB,GAAG,oBAAoB,CAmB5C","sourcesContent":["import type { ImageContent } from \"omk-ai\";\nimport type { Args } from \"./args.ts\";\n\nexport interface InitialMessageInput {\n\tparsed: Args;\n\tfileText?: string;\n\tfileImages?: ImageContent[];\n\tstdinContent?: string;\n}\n\nexport interface InitialMessageResult {\n\tinitialMessage?: string;\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Combine stdin content, @file text, and the first CLI message into a single\n * initial prompt for non-interactive mode.\n */\nexport function buildInitialMessage({\n\tparsed,\n\tfileText,\n\tfileImages,\n\tstdinContent,\n}: InitialMessageInput): InitialMessageResult {\n\tconst parts: string[] = [];\n\tif (stdinContent !== undefined) {\n\t\tconst trailingNewline = stdinContent.endsWith(\"\\n\") ? \"\" : \"\\n\";\n\t\tparts.push(`<stdin>\\n${stdinContent}${trailingNewline}</stdin>\\n`);\n\t}\n\tif (fileText) {\n\t\tparts.push(fileText);\n\t}\n\n\tif (parsed.messages.length > 0) {\n\t\tparts.push(parsed.messages[0]);\n\t\tparsed.messages.shift();\n\t}\n\n\treturn {\n\t\tinitialMessage: parts.length > 0 ? parts.join(\"\") : undefined,\n\t\tinitialImages: fileImages && fileImages.length > 0 ? fileImages : undefined,\n\t};\n}\n"]}

package/dist/cli/initial-message.js

@@ -5,7 +5,8 @@
 export function buildInitialMessage({ parsed, fileText, fileImages, stdinContent, }) {
     const parts = [];
     if (stdinContent !== undefined) {
-        parts.push(stdinContent);
+        const trailingNewline = stdinContent.endsWith("\n") ? "" : "\n";
+        parts.push(`<stdin>\n${stdinContent}${trailingNewline}</stdin>\n`);
     }
     if (fileText) {
         parts.push(fileText);

package/dist/cli/initial-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"initial-message.js","sourceRoot":"","sources":["../../src/cli/initial-message.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EACnC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,GACS,EAAwB;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACN,cAAc,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,aAAa,EAAE,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KAC3E,CAAC;AAAA,CACF","sourcesContent":["import type { ImageContent } from \"omk-ai\";\nimport type { Args } from \"./args.ts\";\n\nexport interface InitialMessageInput {\n\tparsed: Args;\n\tfileText?: string;\n\tfileImages?: ImageContent[];\n\tstdinContent?: string;\n}\n\nexport interface InitialMessageResult {\n\tinitialMessage?: string;\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Combine stdin content, @file text, and the first CLI message into a single\n * initial prompt for non-interactive mode.\n */\nexport function buildInitialMessage({\n\tparsed,\n\tfileText,\n\tfileImages,\n\tstdinContent,\n}: InitialMessageInput): InitialMessageResult {\n\tconst parts: string[] = [];\n\tif (stdinContent !== undefined) {\n\t\tparts.push(stdinContent);\n\t}\n\tif (fileText) {\n\t\tparts.push(fileText);\n\t}\n\n\tif (parsed.messages.length > 0) {\n\t\tparts.push(parsed.messages[0]);\n\t\tparsed.messages.shift();\n\t}\n\n\treturn {\n\t\tinitialMessage: parts.length > 0 ? parts.join(\"\") : undefined,\n\t\tinitialImages: fileImages && fileImages.length > 0 ? fileImages : undefined,\n\t};\n}\n"]}
+{"version":3,"file":"initial-message.js","sourceRoot":"","sources":["../../src/cli/initial-message.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EACnC,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,GACS,EAAwB;IAC7C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,eAAe,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,YAAY,YAAY,GAAG,eAAe,YAAY,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACN,cAAc,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,aAAa,EAAE,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;KAC3E,CAAC;AAAA,CACF","sourcesContent":["import type { ImageContent } from \"omk-ai\";\nimport type { Args } from \"./args.ts\";\n\nexport interface InitialMessageInput {\n\tparsed: Args;\n\tfileText?: string;\n\tfileImages?: ImageContent[];\n\tstdinContent?: string;\n}\n\nexport interface InitialMessageResult {\n\tinitialMessage?: string;\n\tinitialImages?: ImageContent[];\n}\n\n/**\n * Combine stdin content, @file text, and the first CLI message into a single\n * initial prompt for non-interactive mode.\n */\nexport function buildInitialMessage({\n\tparsed,\n\tfileText,\n\tfileImages,\n\tstdinContent,\n}: InitialMessageInput): InitialMessageResult {\n\tconst parts: string[] = [];\n\tif (stdinContent !== undefined) {\n\t\tconst trailingNewline = stdinContent.endsWith(\"\\n\") ? \"\" : \"\\n\";\n\t\tparts.push(`<stdin>\\n${stdinContent}${trailingNewline}</stdin>\\n`);\n\t}\n\tif (fileText) {\n\t\tparts.push(fileText);\n\t}\n\n\tif (parsed.messages.length > 0) {\n\t\tparts.push(parsed.messages[0]);\n\t\tparsed.messages.shift();\n\t}\n\n\treturn {\n\t\tinitialMessage: parts.length > 0 ? parts.join(\"\") : undefined,\n\t\tinitialImages: fileImages && fileImages.length > 0 ? fileImages : undefined,\n\t};\n}\n"]}

package/dist/cli/resource-paths.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveCliPaths(cwd: string, paths: readonly string[] | undefined): string[] | undefined;
+/** Classify an extension load error against explicit CLI sources, failing closed for opaque package sources. */
+export declare function isExplicitExtensionDiagnostic(errorPath: string, explicitSources: readonly string[] | undefined): boolean;
+//# sourceMappingURL=resource-paths.d.ts.map

package/dist/cli/resource-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-paths.d.ts","sourceRoot":"","sources":["../../src/cli/resource-paths.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAEvG;AAED,gHAAgH;AAChH,wBAAgB,6BAA6B,CAC5C,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAC5C,OAAO,CAyBT","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { isLocalPath, resolvePath } from \"../utils/paths.ts\";\n\nexport function resolveCliPaths(cwd: string, paths: readonly string[] | undefined): string[] | undefined {\n\treturn paths?.map((value) => (isLocalPath(value) ? resolvePath(value, cwd) : value));\n}\n\n/** Classify an extension load error against explicit CLI sources, failing closed for opaque package sources. */\nexport function isExplicitExtensionDiagnostic(\n\terrorPath: string,\n\texplicitSources: readonly string[] | undefined,\n): boolean {\n\tif (/^<inline:\\d+>$/u.test(errorPath)) return true;\n\tif (!explicitSources || explicitSources.length === 0) return false;\n\tconst error = canonicalPath(errorPath);\n\tlet hasOpaqueSource = false;\n\tfor (const source of explicitSources) {\n\t\tif (!isLocalPath(source)) {\n\t\t\thasOpaqueSource = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconst resolvedSource = resolvePath(source);\n\t\tconst sourceStat = statOrNull(resolvedSource);\n\t\tif (sourceStat?.isDirectory()) {\n\t\t\tif (isWithin(canonicalPath(resolvedSource), error)) return true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (sourceStat?.isFile() && path.basename(resolvedSource) === \"package.json\") {\n\t\t\tif (isWithin(canonicalPath(path.dirname(resolvedSource)), error)) return true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (canonicalPath(resolvedSource) === error) return true;\n\t}\n\t// Provenance is unavailable for unmatched loader paths. When the user supplied\n\t// any explicit source, fail closed rather than downgrading its error.\n\treturn hasOpaqueSource || explicitSources.length > 0;\n}\n\nfunction canonicalPath(value: string): string {\n\ttry {\n\t\treturn fs.realpathSync(value);\n\t} catch {\n\t\treturn resolvePath(value);\n\t}\n}\n\nfunction statOrNull(value: string): fs.Stats | null {\n\ttry {\n\t\treturn fs.statSync(value);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction isWithin(root: string, candidate: string): boolean {\n\tconst relative = path.relative(root, candidate);\n\treturn relative === \"\" || (!relative.startsWith(\"..\") && !path.isAbsolute(relative));\n}\n"]}

package/dist/cli/resource-paths.js

@@ -0,0 +1,59 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isLocalPath, resolvePath } from "../utils/paths.js";
+export function resolveCliPaths(cwd, paths) {
+    return paths?.map((value) => (isLocalPath(value) ? resolvePath(value, cwd) : value));
+}
+/** Classify an extension load error against explicit CLI sources, failing closed for opaque package sources. */
+export function isExplicitExtensionDiagnostic(errorPath, explicitSources) {
+    if (/^<inline:\d+>$/u.test(errorPath))
+        return true;
+    if (!explicitSources || explicitSources.length === 0)
+        return false;
+    const error = canonicalPath(errorPath);
+    let hasOpaqueSource = false;
+    for (const source of explicitSources) {
+        if (!isLocalPath(source)) {
+            hasOpaqueSource = true;
+            continue;
+        }
+        const resolvedSource = resolvePath(source);
+        const sourceStat = statOrNull(resolvedSource);
+        if (sourceStat?.isDirectory()) {
+            if (isWithin(canonicalPath(resolvedSource), error))
+                return true;
+            continue;
+        }
+        if (sourceStat?.isFile() && path.basename(resolvedSource) === "package.json") {
+            if (isWithin(canonicalPath(path.dirname(resolvedSource)), error))
+                return true;
+            continue;
+        }
+        if (canonicalPath(resolvedSource) === error)
+            return true;
+    }
+    // Provenance is unavailable for unmatched loader paths. When the user supplied
+    // any explicit source, fail closed rather than downgrading its error.
+    return hasOpaqueSource || explicitSources.length > 0;
+}
+function canonicalPath(value) {
+    try {
+        return fs.realpathSync(value);
+    }
+    catch {
+        return resolvePath(value);
+    }
+}
+function statOrNull(value) {
+    try {
+        return fs.statSync(value);
+    }
+    catch {
+        return null;
+    }
+}
+function isWithin(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+//# sourceMappingURL=resource-paths.js.map

package/dist/cli/resource-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-paths.js","sourceRoot":"","sources":["../../src/cli/resource-paths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,KAAoC,EAAwB;IACxG,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAAA,CACrF;AAED,gHAAgH;AAChH,MAAM,UAAU,6BAA6B,CAC5C,SAAiB,EACjB,eAA8C,EACpC;IACV,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACtC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,eAAe,GAAG,IAAI,CAAC;YACvB,SAAS;QACV,CAAC;QACD,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,UAAU,EAAE,WAAW,EAAE,EAAE,CAAC;YAC/B,IAAI,QAAQ,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChE,SAAS;QACV,CAAC;QACD,IAAI,UAAU,EAAE,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,cAAc,EAAE,CAAC;YAC9E,IAAI,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC9E,SAAS;QACV,CAAC;QACD,IAAI,aAAa,CAAC,cAAc,CAAC,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;IAC1D,CAAC;IACD,+EAA+E;IAC/E,sEAAsE;IACtE,OAAO,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;AAAA,CACrD;AAED,SAAS,aAAa,CAAC,KAAa,EAAU;IAC7C,IAAI,CAAC;QACJ,OAAO,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AAAA,CACD;AAED,SAAS,UAAU,CAAC,KAAa,EAAmB;IACnD,IAAI,CAAC;QACJ,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AAAA,CACD;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,SAAiB,EAAW;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAChD,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAAA,CACrF","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { isLocalPath, resolvePath } from \"../utils/paths.ts\";\n\nexport function resolveCliPaths(cwd: string, paths: readonly string[] | undefined): string[] | undefined {\n\treturn paths?.map((value) => (isLocalPath(value) ? resolvePath(value, cwd) : value));\n}\n\n/** Classify an extension load error against explicit CLI sources, failing closed for opaque package sources. */\nexport function isExplicitExtensionDiagnostic(\n\terrorPath: string,\n\texplicitSources: readonly string[] | undefined,\n): boolean {\n\tif (/^<inline:\\d+>$/u.test(errorPath)) return true;\n\tif (!explicitSources || explicitSources.length === 0) return false;\n\tconst error = canonicalPath(errorPath);\n\tlet hasOpaqueSource = false;\n\tfor (const source of explicitSources) {\n\t\tif (!isLocalPath(source)) {\n\t\t\thasOpaqueSource = true;\n\t\t\tcontinue;\n\t\t}\n\t\tconst resolvedSource = resolvePath(source);\n\t\tconst sourceStat = statOrNull(resolvedSource);\n\t\tif (sourceStat?.isDirectory()) {\n\t\t\tif (isWithin(canonicalPath(resolvedSource), error)) return true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (sourceStat?.isFile() && path.basename(resolvedSource) === \"package.json\") {\n\t\t\tif (isWithin(canonicalPath(path.dirname(resolvedSource)), error)) return true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (canonicalPath(resolvedSource) === error) return true;\n\t}\n\t// Provenance is unavailable for unmatched loader paths. When the user supplied\n\t// any explicit source, fail closed rather than downgrading its error.\n\treturn hasOpaqueSource || explicitSources.length > 0;\n}\n\nfunction canonicalPath(value: string): string {\n\ttry {\n\t\treturn fs.realpathSync(value);\n\t} catch {\n\t\treturn resolvePath(value);\n\t}\n}\n\nfunction statOrNull(value: string): fs.Stats | null {\n\ttry {\n\t\treturn fs.statSync(value);\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nfunction isWithin(root: string, candidate: string): boolean {\n\tconst relative = path.relative(root, candidate);\n\treturn relative === \"\" || (!relative.startsWith(\"..\") && !path.isAbsolute(relative));\n}\n"]}

package/dist/commands/adaptorch-doctor-cli.d.ts

@@ -0,0 +1,13 @@
+import { type AdaptOrchFetch } from "omk-adaptorch-wpl";
+export interface AdaptOrchDoctorCliOverrides {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly writeLine?: (line: string) => void;
+    /** Test seam: replaces the injected HTTP boundary (defaults to global fetch). */
+    readonly fetch?: AdaptOrchFetch;
+}
+export interface AdaptOrchDoctorCliOutcome {
+    readonly handled: boolean;
+    readonly exitCode: number;
+}
+export declare function runAdaptOrchDoctorCli(args: readonly string[], overrides?: AdaptOrchDoctorCliOverrides): Promise<AdaptOrchDoctorCliOutcome>;
+//# sourceMappingURL=adaptorch-doctor-cli.d.ts.map

package/dist/commands/adaptorch-doctor-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-doctor-cli.d.ts","sourceRoot":"","sources":["../../src/commands/adaptorch-doctor-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,KAAK,cAAc,EAEnB,MAAM,mBAAmB,CAAC;AA+B3B,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AA0DD,wBAAsB,qBAAqB,CAC1C,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,GAAE,2BAAgC,GACzC,OAAO,CAAC,yBAAyB,CAAC,CA2CpC","sourcesContent":["import {\n\ttype AdaptOrchApiClient,\n\tAdaptOrchApiError,\n\ttype AdaptOrchFetch,\n\tcreateAdaptOrchApiClientFromEnv,\n} from \"omk-adaptorch-wpl\";\n\n/**\n * Headless AdaptOrch connectivity check:\n *\n *   omk doctor adaptorch [--json]\n *\n * One command answers the only question that blocks getting started: does the\n * configured key reach the hosted API? It calls `GET /v1/whoami`, which is the\n * cheapest authenticated read in the contract, and reports the principal it\n * resolved to.\n *\n * The exit code carries the verdict so a script can branch without parsing\n * prose: 0 verified, 1 not configured, 2 configured but unreachable. Those are\n * genuinely different states — \"no key\" is a setup step, while \"key rejected\"\n * is a broken setup, and collapsing them would make the command useless in CI.\n *\n * The credential is never printed. `omk-adaptorch-wpl` already scrubs it from\n * its own errors; this command additionally never echoes the configured value.\n */\n\nconst USAGE = \"Usage: omk doctor adaptorch [--json]\";\n\n/**\n * Where to obtain a key. This is the one moment in the CLI where the reader has\n * explicitly asked about AdaptOrch, so answering \"which key, from where\" here\n * is help rather than promotion. It carries its own attribution so this\n * touchpoint stays distinguishable from the README links.\n */\nconst ADAPTORCH_SIGNUP_URL = \"https://adaptorch.com/?utm_source=omk-cli&utm_medium=doctor&utm_campaign=omk#pricing\";\n\nexport interface AdaptOrchDoctorCliOverrides {\n\treadonly env?: NodeJS.ProcessEnv;\n\treadonly writeLine?: (line: string) => void;\n\t/** Test seam: replaces the injected HTTP boundary (defaults to global fetch). */\n\treadonly fetch?: AdaptOrchFetch;\n}\n\nexport interface AdaptOrchDoctorCliOutcome {\n\treadonly handled: boolean;\n\treadonly exitCode: number;\n}\n\n/** Bounded report shape. Carries no credential, URL credentials, or raw error bodies. */\ninterface AdaptOrchDoctorReport {\n\treadonly configured: boolean;\n\treadonly reachable: boolean;\n\treadonly subjectId?: string;\n\treadonly projectId?: string;\n\treadonly status?: number;\n\treadonly code?: string;\n\treadonly error?: string;\n}\n\nfunction describe(report: AdaptOrchDoctorReport): string[] {\n\tif (!report.configured) {\n\t\treturn [\n\t\t\t\"AdaptOrch: not configured\",\n\t\t\t\"  Set ADAPTORCH_API_KEY to enable it. Optionally set ADAPTORCH_API_URL.\",\n\t\t\t`  Get a key: ${ADAPTORCH_SIGNUP_URL}`,\n\t\t\t\"  AdaptOrch is a separate product; OMK does not require it.\",\n\t\t];\n\t}\n\tif (!report.reachable) {\n\t\tconst detail =\n\t\t\treport.status === undefined ? \"\" : ` (HTTP ${report.status}${report.code ? ` ${report.code}` : \"\"})`;\n\t\treturn [`AdaptOrch: unreachable${detail}`, `  ${report.error ?? \"the request did not complete\"}`];\n\t}\n\tconst scope = report.projectId ? `, project ${report.projectId}` : \"\";\n\treturn [`AdaptOrch: verified`, `  Authenticated as ${report.subjectId ?? \"(unknown subject)\"}${scope}`];\n}\n\nasync function probe(client: AdaptOrchApiClient): Promise<AdaptOrchDoctorReport> {\n\ttry {\n\t\tconst principal = await client.whoami();\n\t\treturn {\n\t\t\tconfigured: true,\n\t\t\treachable: true,\n\t\t\tsubjectId: principal.subject_id,\n\t\t\t...(principal.project_id === undefined ? {} : { projectId: principal.project_id }),\n\t\t};\n\t} catch (error) {\n\t\tif (error instanceof AdaptOrchApiError) {\n\t\t\treturn {\n\t\t\t\tconfigured: true,\n\t\t\t\treachable: false,\n\t\t\t\tstatus: error.status,\n\t\t\t\t...(error.code === undefined ? {} : { code: error.code }),\n\t\t\t\terror: error.message,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tconfigured: true,\n\t\t\treachable: false,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n}\n\nexport async function runAdaptOrchDoctorCli(\n\targs: readonly string[],\n\toverrides: AdaptOrchDoctorCliOverrides = {},\n): Promise<AdaptOrchDoctorCliOutcome> {\n\tif (args[0] !== \"doctor\" || args[1] !== \"adaptorch\") {\n\t\treturn { handled: false, exitCode: 0 };\n\t}\n\tconst writeLine = overrides.writeLine ?? ((line: string) => console.log(line));\n\n\tlet json = false;\n\tfor (const arg of args.slice(2)) {\n\t\tif (arg === \"--json\") {\n\t\t\tjson = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\twriteLine(USAGE);\n\t\t\treturn { handled: true, exitCode: 0 };\n\t\t}\n\t\twriteLine(`Unknown option: ${arg}`);\n\t\twriteLine(USAGE);\n\t\treturn { handled: true, exitCode: 2 };\n\t}\n\n\tconst env = overrides.env ?? process.env;\n\tconst fetchImpl = overrides.fetch ?? (globalThis.fetch as unknown as AdaptOrchFetch);\n\n\tlet report: AdaptOrchDoctorReport;\n\ttry {\n\t\tconst client = createAdaptOrchApiClientFromEnv(fetchImpl, env);\n\t\treport = client ? await probe(client) : { configured: false, reachable: false };\n\t} catch (error) {\n\t\t// A configured but invalid setup (an unsafe ADAPTORCH_API_URL, for\n\t\t// example) is a broken setup, not an absent one.\n\t\treport = {\n\t\t\tconfigured: true,\n\t\t\treachable: false,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n\n\tif (json) writeLine(JSON.stringify(report, null, 2));\n\telse for (const line of describe(report)) writeLine(line);\n\n\tif (!report.configured) return { handled: true, exitCode: 1 };\n\treturn { handled: true, exitCode: report.reachable ? 0 : 2 };\n}\n"]}

package/dist/commands/adaptorch-doctor-cli.js

@@ -0,0 +1,115 @@
+import { AdaptOrchApiError, createAdaptOrchApiClientFromEnv, } from "omk-adaptorch-wpl";
+/**
+ * Headless AdaptOrch connectivity check:
+ *
+ *   omk doctor adaptorch [--json]
+ *
+ * One command answers the only question that blocks getting started: does the
+ * configured key reach the hosted API? It calls `GET /v1/whoami`, which is the
+ * cheapest authenticated read in the contract, and reports the principal it
+ * resolved to.
+ *
+ * The exit code carries the verdict so a script can branch without parsing
+ * prose: 0 verified, 1 not configured, 2 configured but unreachable. Those are
+ * genuinely different states — "no key" is a setup step, while "key rejected"
+ * is a broken setup, and collapsing them would make the command useless in CI.
+ *
+ * The credential is never printed. `omk-adaptorch-wpl` already scrubs it from
+ * its own errors; this command additionally never echoes the configured value.
+ */
+const USAGE = "Usage: omk doctor adaptorch [--json]";
+/**
+ * Where to obtain a key. This is the one moment in the CLI where the reader has
+ * explicitly asked about AdaptOrch, so answering "which key, from where" here
+ * is help rather than promotion. It carries its own attribution so this
+ * touchpoint stays distinguishable from the README links.
+ */
+const ADAPTORCH_SIGNUP_URL = "https://adaptorch.com/?utm_source=omk-cli&utm_medium=doctor&utm_campaign=omk#pricing";
+function describe(report) {
+    if (!report.configured) {
+        return [
+            "AdaptOrch: not configured",
+            "  Set ADAPTORCH_API_KEY to enable it. Optionally set ADAPTORCH_API_URL.",
+            `  Get a key: ${ADAPTORCH_SIGNUP_URL}`,
+            "  AdaptOrch is a separate product; OMK does not require it.",
+        ];
+    }
+    if (!report.reachable) {
+        const detail = report.status === undefined ? "" : ` (HTTP ${report.status}${report.code ? ` ${report.code}` : ""})`;
+        return [`AdaptOrch: unreachable${detail}`, `  ${report.error ?? "the request did not complete"}`];
+    }
+    const scope = report.projectId ? `, project ${report.projectId}` : "";
+    return [`AdaptOrch: verified`, `  Authenticated as ${report.subjectId ?? "(unknown subject)"}${scope}`];
+}
+async function probe(client) {
+    try {
+        const principal = await client.whoami();
+        return {
+            configured: true,
+            reachable: true,
+            subjectId: principal.subject_id,
+            ...(principal.project_id === undefined ? {} : { projectId: principal.project_id }),
+        };
+    }
+    catch (error) {
+        if (error instanceof AdaptOrchApiError) {
+            return {
+                configured: true,
+                reachable: false,
+                status: error.status,
+                ...(error.code === undefined ? {} : { code: error.code }),
+                error: error.message,
+            };
+        }
+        return {
+            configured: true,
+            reachable: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function runAdaptOrchDoctorCli(args, overrides = {}) {
+    if (args[0] !== "doctor" || args[1] !== "adaptorch") {
+        return { handled: false, exitCode: 0 };
+    }
+    const writeLine = overrides.writeLine ?? ((line) => console.log(line));
+    let json = false;
+    for (const arg of args.slice(2)) {
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            writeLine(USAGE);
+            return { handled: true, exitCode: 0 };
+        }
+        writeLine(`Unknown option: ${arg}`);
+        writeLine(USAGE);
+        return { handled: true, exitCode: 2 };
+    }
+    const env = overrides.env ?? process.env;
+    const fetchImpl = overrides.fetch ?? globalThis.fetch;
+    let report;
+    try {
+        const client = createAdaptOrchApiClientFromEnv(fetchImpl, env);
+        report = client ? await probe(client) : { configured: false, reachable: false };
+    }
+    catch (error) {
+        // A configured but invalid setup (an unsafe ADAPTORCH_API_URL, for
+        // example) is a broken setup, not an absent one.
+        report = {
+            configured: true,
+            reachable: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+    if (json)
+        writeLine(JSON.stringify(report, null, 2));
+    else
+        for (const line of describe(report))
+            writeLine(line);
+    if (!report.configured)
+        return { handled: true, exitCode: 1 };
+    return { handled: true, exitCode: report.reachable ? 0 : 2 };
+}
+//# sourceMappingURL=adaptorch-doctor-cli.js.map

package/dist/commands/adaptorch-doctor-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptorch-doctor-cli.js","sourceRoot":"","sources":["../../src/commands/adaptorch-doctor-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,iBAAiB,EAEjB,+BAA+B,GAC/B,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,KAAK,GAAG,sCAAsC,CAAC;AAErD;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,sFAAsF,CAAC;AAyBpH,SAAS,QAAQ,CAAC,MAA6B,EAAY;IAC1D,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO;YACN,2BAA2B;YAC3B,yEAAyE;YACzE,gBAAgB,oBAAoB,EAAE;YACtC,6DAA6D;SAC7D,CAAC;IACH,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,MAAM,GACX,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACtG,OAAO,CAAC,yBAAyB,MAAM,EAAE,EAAE,KAAK,MAAM,CAAC,KAAK,IAAI,8BAA8B,EAAE,CAAC,CAAC;IACnG,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,OAAO,CAAC,qBAAqB,EAAE,sBAAsB,MAAM,CAAC,SAAS,IAAI,mBAAmB,GAAG,KAAK,EAAE,CAAC,CAAC;AAAA,CACxG;AAED,KAAK,UAAU,KAAK,CAAC,MAA0B,EAAkC;IAChF,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO;YACN,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,SAAS,CAAC,UAAU;YAC/B,GAAG,CAAC,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;SAClF,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACxC,OAAO;gBACN,UAAU,EAAE,IAAI;gBAChB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;gBACzD,KAAK,EAAE,KAAK,CAAC,OAAO;aACpB,CAAC;QACH,CAAC;QACD,OAAO;YACN,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC7D,CAAC;IACH,CAAC;AAAA,CACD;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,IAAuB,EACvB,SAAS,GAAgC,EAAE,EACN;IACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACxC,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/E,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,CAAC;YACZ,SAAS;QACV,CAAC;QACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtC,SAAS,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QACvC,CAAC;QACD,SAAS,CAAC,mBAAmB,GAAG,EAAE,CAAC,CAAC;QACpC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACzC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,IAAK,UAAU,CAAC,KAAmC,CAAC;IAErF,IAAI,MAA6B,CAAC;IAClC,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,+BAA+B,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC/D,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,mEAAmE;QACnE,iDAAiD;QACjD,MAAM,GAAG;YACR,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,KAAK;YAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC7D,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;;QAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAE1D,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CAC7D","sourcesContent":["import {\n\ttype AdaptOrchApiClient,\n\tAdaptOrchApiError,\n\ttype AdaptOrchFetch,\n\tcreateAdaptOrchApiClientFromEnv,\n} from \"omk-adaptorch-wpl\";\n\n/**\n * Headless AdaptOrch connectivity check:\n *\n *   omk doctor adaptorch [--json]\n *\n * One command answers the only question that blocks getting started: does the\n * configured key reach the hosted API? It calls `GET /v1/whoami`, which is the\n * cheapest authenticated read in the contract, and reports the principal it\n * resolved to.\n *\n * The exit code carries the verdict so a script can branch without parsing\n * prose: 0 verified, 1 not configured, 2 configured but unreachable. Those are\n * genuinely different states — \"no key\" is a setup step, while \"key rejected\"\n * is a broken setup, and collapsing them would make the command useless in CI.\n *\n * The credential is never printed. `omk-adaptorch-wpl` already scrubs it from\n * its own errors; this command additionally never echoes the configured value.\n */\n\nconst USAGE = \"Usage: omk doctor adaptorch [--json]\";\n\n/**\n * Where to obtain a key. This is the one moment in the CLI where the reader has\n * explicitly asked about AdaptOrch, so answering \"which key, from where\" here\n * is help rather than promotion. It carries its own attribution so this\n * touchpoint stays distinguishable from the README links.\n */\nconst ADAPTORCH_SIGNUP_URL = \"https://adaptorch.com/?utm_source=omk-cli&utm_medium=doctor&utm_campaign=omk#pricing\";\n\nexport interface AdaptOrchDoctorCliOverrides {\n\treadonly env?: NodeJS.ProcessEnv;\n\treadonly writeLine?: (line: string) => void;\n\t/** Test seam: replaces the injected HTTP boundary (defaults to global fetch). */\n\treadonly fetch?: AdaptOrchFetch;\n}\n\nexport interface AdaptOrchDoctorCliOutcome {\n\treadonly handled: boolean;\n\treadonly exitCode: number;\n}\n\n/** Bounded report shape. Carries no credential, URL credentials, or raw error bodies. */\ninterface AdaptOrchDoctorReport {\n\treadonly configured: boolean;\n\treadonly reachable: boolean;\n\treadonly subjectId?: string;\n\treadonly projectId?: string;\n\treadonly status?: number;\n\treadonly code?: string;\n\treadonly error?: string;\n}\n\nfunction describe(report: AdaptOrchDoctorReport): string[] {\n\tif (!report.configured) {\n\t\treturn [\n\t\t\t\"AdaptOrch: not configured\",\n\t\t\t\"  Set ADAPTORCH_API_KEY to enable it. Optionally set ADAPTORCH_API_URL.\",\n\t\t\t`  Get a key: ${ADAPTORCH_SIGNUP_URL}`,\n\t\t\t\"  AdaptOrch is a separate product; OMK does not require it.\",\n\t\t];\n\t}\n\tif (!report.reachable) {\n\t\tconst detail =\n\t\t\treport.status === undefined ? \"\" : ` (HTTP ${report.status}${report.code ? ` ${report.code}` : \"\"})`;\n\t\treturn [`AdaptOrch: unreachable${detail}`, `  ${report.error ?? \"the request did not complete\"}`];\n\t}\n\tconst scope = report.projectId ? `, project ${report.projectId}` : \"\";\n\treturn [`AdaptOrch: verified`, `  Authenticated as ${report.subjectId ?? \"(unknown subject)\"}${scope}`];\n}\n\nasync function probe(client: AdaptOrchApiClient): Promise<AdaptOrchDoctorReport> {\n\ttry {\n\t\tconst principal = await client.whoami();\n\t\treturn {\n\t\t\tconfigured: true,\n\t\t\treachable: true,\n\t\t\tsubjectId: principal.subject_id,\n\t\t\t...(principal.project_id === undefined ? {} : { projectId: principal.project_id }),\n\t\t};\n\t} catch (error) {\n\t\tif (error instanceof AdaptOrchApiError) {\n\t\t\treturn {\n\t\t\t\tconfigured: true,\n\t\t\t\treachable: false,\n\t\t\t\tstatus: error.status,\n\t\t\t\t...(error.code === undefined ? {} : { code: error.code }),\n\t\t\t\terror: error.message,\n\t\t\t};\n\t\t}\n\t\treturn {\n\t\t\tconfigured: true,\n\t\t\treachable: false,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n}\n\nexport async function runAdaptOrchDoctorCli(\n\targs: readonly string[],\n\toverrides: AdaptOrchDoctorCliOverrides = {},\n): Promise<AdaptOrchDoctorCliOutcome> {\n\tif (args[0] !== \"doctor\" || args[1] !== \"adaptorch\") {\n\t\treturn { handled: false, exitCode: 0 };\n\t}\n\tconst writeLine = overrides.writeLine ?? ((line: string) => console.log(line));\n\n\tlet json = false;\n\tfor (const arg of args.slice(2)) {\n\t\tif (arg === \"--json\") {\n\t\t\tjson = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\twriteLine(USAGE);\n\t\t\treturn { handled: true, exitCode: 0 };\n\t\t}\n\t\twriteLine(`Unknown option: ${arg}`);\n\t\twriteLine(USAGE);\n\t\treturn { handled: true, exitCode: 2 };\n\t}\n\n\tconst env = overrides.env ?? process.env;\n\tconst fetchImpl = overrides.fetch ?? (globalThis.fetch as unknown as AdaptOrchFetch);\n\n\tlet report: AdaptOrchDoctorReport;\n\ttry {\n\t\tconst client = createAdaptOrchApiClientFromEnv(fetchImpl, env);\n\t\treport = client ? await probe(client) : { configured: false, reachable: false };\n\t} catch (error) {\n\t\t// A configured but invalid setup (an unsafe ADAPTORCH_API_URL, for\n\t\t// example) is a broken setup, not an absent one.\n\t\treport = {\n\t\t\tconfigured: true,\n\t\t\treachable: false,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n\n\tif (json) writeLine(JSON.stringify(report, null, 2));\n\telse for (const line of describe(report)) writeLine(line);\n\n\tif (!report.configured) return { handled: true, exitCode: 1 };\n\treturn { handled: true, exitCode: report.reachable ? 0 : 2 };\n}\n"]}

package/dist/commands/resource-doctor-cli.d.ts

@@ -1,5 +1,7 @@
 import { captureHostResourceSnapshot } from "../core/host-resource-snapshot.ts";
 import { type ResourceGovernorSettings } from "../core/resource-governor-settings.ts";
+import { collectResourceObservationReport, RESOURCE_REPORT_MIN_ADMISSIONS, type ResourceObservationReport } from "../core/resource-observation-report.ts";
+export { collectResourceObservationReport, RESOURCE_REPORT_MIN_ADMISSIONS, type ResourceObservationReport };
 export interface ResourceDoctorCliOverrides {
     readonly cwd?: string;
     readonly env?: NodeJS.ProcessEnv;
@@ -13,6 +15,8 @@ export interface ResourceDoctorCliOverrides {
     readonly capture?: typeof captureHostResourceSnapshot;
     /** Test seam: monotonic clock for probeDurationMs. */
     readonly now?: () => number;
+    /** Test seam: replaces local observation aggregation. */
+    readonly collectReport?: (cwd: string) => ResourceObservationReport;
 }
 export interface ResourceDoctorCliOutcome {
     readonly handled: boolean;

package/dist/commands/resource-doctor-cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-doctor-cli.d.ts","sourceRoot":"","sources":["../../src/commands/resource-doctor-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAA6B,MAAM,mCAAmC,CAAC;AAE3G,OAAO,EAIN,KAAK,wBAAwB,EAE7B,MAAM,uCAAuC,CAAC;AAiB/C,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;QAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QACrD,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,2BAA2B,CAAC;IACtD,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,GAAE,0BAA+B,GACxC,OAAO,CAAC,wBAAwB,CAAC,CAsCnC","sourcesContent":["import { captureHostResourceSnapshot, type HostResourceSnapshot } from \"../core/host-resource-snapshot.ts\";\nimport { decideResourceAdmission } from \"../core/resource-admission.ts\";\nimport {\n\tbuildResourceDoctorReport,\n\tformatResourceProbeLines,\n\tformatResourceSummaryLines,\n\ttype ResourceGovernorSettings,\n\tresolveResourceGovernorSettings,\n} from \"../core/resource-governor-settings.ts\";\nimport { SettingsManager } from \"../core/settings-manager.ts\";\n\n/**\n * Headless resource diagnostic (OMK v0.97.x roadmap §19.2, M1/PR2):\n *\n *   omk doctor resources [--json]\n *\n * Observe-only: probes the host, evaluates the admission policy, and prints\n * either aligned human output or the bounded §19.2 JSON schema. This command\n * is the sanctioned local surface for raw capacity values (§11.3); it still\n * never prints usernames, hostnames, or paths (§6.2). The doctor probes even\n * when the governor mode is `off` because it only runs on explicit request.\n */\n\nconst USAGE = \"Usage: omk doctor resources [--json]\";\n\nexport interface ResourceDoctorCliOverrides {\n\treadonly cwd?: string;\n\treadonly env?: NodeJS.ProcessEnv;\n\treadonly writeLine?: (line: string) => void;\n\t/** Test seam: replaces settings loading (defaults to SettingsManager.create(cwd)). */\n\treadonly loadSettings?: () => {\n\t\treadonly resourceGovernor?: ResourceGovernorSettings;\n\t\treadonly configuredMaxToolConcurrency?: number;\n\t};\n\t/** Test seam: replaces the host probe. */\n\treadonly capture?: typeof captureHostResourceSnapshot;\n\t/** Test seam: monotonic clock for probeDurationMs. */\n\treadonly now?: () => number;\n}\n\nexport interface ResourceDoctorCliOutcome {\n\treadonly handled: boolean;\n\treadonly exitCode: number;\n}\n\nexport async function runResourceDoctorCli(\n\targs: readonly string[],\n\toverrides: ResourceDoctorCliOverrides = {},\n): Promise<ResourceDoctorCliOutcome> {\n\tif (args[0] !== \"doctor\" || args[1] !== \"resources\") {\n\t\treturn { handled: false, exitCode: 0 };\n\t}\n\tconst writeLine = overrides.writeLine ?? ((line: string) => console.log(line));\n\n\tconst flags = parseDoctorFlags(args.slice(2), writeLine);\n\tif (flags.exit !== null) {\n\t\treturn { handled: true, exitCode: flags.exit };\n\t}\n\tconst json = flags.json;\n\n\tconst settings = (overrides.loadSettings ?? (() => loadSettingsFromDisk(overrides.cwd)))();\n\tconst resolved = resolveResourceGovernorSettings(settings.resourceGovernor, overrides.env ?? process.env);\n\n\tconst capture = overrides.capture ?? captureHostResourceSnapshot;\n\tconst now = overrides.now ?? (() => performance.now());\n\tconst startedAt = now();\n\tconst snapshot: HostResourceSnapshot = await capture({\n\t\tcwd: overrides.cwd,\n\t\tmaxProbeMs: resolved.maxProbeMs,\n\t\tcpuSampleMs: resolved.cpuSampleMs,\n\t});\n\tconst probeDurationMs = Math.max(0, now() - startedAt);\n\n\tconst decision = decideResourceAdmission({\n\t\tsnapshot,\n\t\tconfig: resolved.admission,\n\t\tconfiguredCaps: { maxToolConcurrency: settings.configuredMaxToolConcurrency },\n\t});\n\n\tif (json) {\n\t\tconst report = buildResourceDoctorReport({ snapshot, decision, resolved, probeDurationMs });\n\t\twriteLine(JSON.stringify(report, null, 2));\n\t\treturn { handled: true, exitCode: 0 };\n\t}\n\trenderHumanReport({ writeLine, resolved, decision, snapshot, probeDurationMs });\n\treturn { handled: true, exitCode: 0 };\n}\n\nfunction parseDoctorFlags(\n\targs: readonly string[],\n\twriteLine: (line: string) => void,\n): { readonly json: boolean; readonly exit: number | null } {\n\tlet json = false;\n\tfor (const arg of args) {\n\t\tif (arg === \"--json\") {\n\t\t\tjson = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\twriteLine(USAGE);\n\t\t\treturn { json, exit: 0 };\n\t\t}\n\t\twriteLine(`Unknown argument: ${arg}`);\n\t\twriteLine(USAGE);\n\t\treturn { json, exit: 2 };\n\t}\n\treturn { json, exit: null };\n}\n\nfunction renderHumanReport(input: {\n\treadonly writeLine: (line: string) => void;\n\treadonly resolved: ReturnType<typeof resolveResourceGovernorSettings>;\n\treadonly decision: ReturnType<typeof decideResourceAdmission>;\n\treadonly snapshot: HostResourceSnapshot;\n\treadonly probeDurationMs: number;\n}): void {\n\tconst { writeLine, resolved, decision, snapshot, probeDurationMs } = input;\n\twriteLine(\"Resource doctor\");\n\twriteLine(\"\");\n\tfor (const line of formatResourceSummaryLines(resolved.mode, decision)) {\n\t\twriteLine(line);\n\t}\n\twriteLine(\"\");\n\tfor (const line of formatResourceProbeLines(snapshot)) {\n\t\twriteLine(line);\n\t}\n\twriteLine(\"\");\n\twriteLine(`probe duration: ${Math.round(probeDurationMs)} ms`);\n\tfor (const error of resolved.errors) {\n\t\twriteLine(`settings error: ${error}`);\n\t}\n}\n\nfunction loadSettingsFromDisk(cwd: string | undefined): {\n\treadonly resourceGovernor?: ResourceGovernorSettings;\n\treadonly configuredMaxToolConcurrency?: number;\n} {\n\ttry {\n\t\tconst manager = SettingsManager.create(cwd ?? process.cwd());\n\t\treturn {\n\t\t\tresourceGovernor: manager.getResourceGovernorSettings(),\n\t\t\tconfiguredMaxToolConcurrency: manager.getAgentRuntimeSettings().maxToolConcurrency,\n\t\t};\n\t} catch {\n\t\t// A broken settings file must not block the diagnostic; defaults apply.\n\t\treturn {};\n\t}\n}\n"]}
+{"version":3,"file":"resource-doctor-cli.d.ts","sourceRoot":"","sources":["../../src/commands/resource-doctor-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAA6B,MAAM,mCAAmC,CAAC;AAE3G,OAAO,EAIN,KAAK,wBAAwB,EAE7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACN,gCAAgC,EAChC,8BAA8B,EAC9B,KAAK,yBAAyB,EAC9B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EAAE,gCAAgC,EAAE,8BAA8B,EAAE,KAAK,yBAAyB,EAAE,CAAC;AAgB5G,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;QAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QACrD,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,CAAC;KAC/C,CAAC;IACF,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,2BAA2B,CAAC;IACtD,sDAAsD;IACtD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,yDAAyD;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,yBAAyB,CAAC;CACpE;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,SAAS,GAAE,0BAA+B,GACxC,OAAO,CAAC,wBAAwB,CAAC,CA4CnC","sourcesContent":["import { captureHostResourceSnapshot, type HostResourceSnapshot } from \"../core/host-resource-snapshot.ts\";\nimport { decideResourceAdmission } from \"../core/resource-admission.ts\";\nimport {\n\tbuildResourceDoctorReport,\n\tformatResourceProbeLines,\n\tformatResourceSummaryLines,\n\ttype ResourceGovernorSettings,\n\tresolveResourceGovernorSettings,\n} from \"../core/resource-governor-settings.ts\";\nimport {\n\tcollectResourceObservationReport,\n\tRESOURCE_REPORT_MIN_ADMISSIONS,\n\ttype ResourceObservationReport,\n} from \"../core/resource-observation-report.ts\";\nimport { SettingsManager } from \"../core/settings-manager.ts\";\n\nexport { collectResourceObservationReport, RESOURCE_REPORT_MIN_ADMISSIONS, type ResourceObservationReport };\n\n/**\n * Headless resource diagnostic (OMK v0.97.x roadmap §19.2, M1/PR2):\n *\n *   omk doctor resources [--json] [--report]\n *\n * Observe-only: probes the host, evaluates the admission policy, and prints\n * either aligned human output or the bounded §19.2 JSON schema. This command\n * is the sanctioned local surface for raw capacity values (§11.3); it still\n * never prints usernames, hostnames, or paths (§6.2). The doctor probes even\n * when the governor mode is `off` because it only runs on explicit request.\n */\n\nconst USAGE = \"Usage: omk doctor resources [--json] [--report]\";\n\nexport interface ResourceDoctorCliOverrides {\n\treadonly cwd?: string;\n\treadonly env?: NodeJS.ProcessEnv;\n\treadonly writeLine?: (line: string) => void;\n\t/** Test seam: replaces settings loading (defaults to SettingsManager.create(cwd)). */\n\treadonly loadSettings?: () => {\n\t\treadonly resourceGovernor?: ResourceGovernorSettings;\n\t\treadonly configuredMaxToolConcurrency?: number;\n\t};\n\t/** Test seam: replaces the host probe. */\n\treadonly capture?: typeof captureHostResourceSnapshot;\n\t/** Test seam: monotonic clock for probeDurationMs. */\n\treadonly now?: () => number;\n\t/** Test seam: replaces local observation aggregation. */\n\treadonly collectReport?: (cwd: string) => ResourceObservationReport;\n}\n\nexport interface ResourceDoctorCliOutcome {\n\treadonly handled: boolean;\n\treadonly exitCode: number;\n}\n\nexport async function runResourceDoctorCli(\n\targs: readonly string[],\n\toverrides: ResourceDoctorCliOverrides = {},\n): Promise<ResourceDoctorCliOutcome> {\n\tif (args[0] !== \"doctor\" || args[1] !== \"resources\") {\n\t\treturn { handled: false, exitCode: 0 };\n\t}\n\tconst writeLine = overrides.writeLine ?? ((line: string) => console.log(line));\n\n\tconst flags = parseDoctorFlags(args.slice(2), writeLine);\n\tif (flags.exit !== null) {\n\t\treturn { handled: true, exitCode: flags.exit };\n\t}\n\tconst json = flags.json;\n\tif (flags.report) {\n\t\tconst report = (overrides.collectReport ?? collectResourceObservationReport)(overrides.cwd ?? process.cwd());\n\t\tif (json) writeLine(JSON.stringify(report, null, 2));\n\t\telse renderObservationReport(report, writeLine);\n\t\treturn { handled: true, exitCode: 0 };\n\t}\n\n\tconst settings = (overrides.loadSettings ?? (() => loadSettingsFromDisk(overrides.cwd)))();\n\tconst resolved = resolveResourceGovernorSettings(settings.resourceGovernor, overrides.env ?? process.env);\n\n\tconst capture = overrides.capture ?? captureHostResourceSnapshot;\n\tconst now = overrides.now ?? (() => performance.now());\n\tconst startedAt = now();\n\tconst snapshot: HostResourceSnapshot = await capture({\n\t\tcwd: overrides.cwd,\n\t\tmaxProbeMs: resolved.maxProbeMs,\n\t\tcpuSampleMs: resolved.cpuSampleMs,\n\t});\n\tconst probeDurationMs = Math.max(0, now() - startedAt);\n\n\tconst decision = decideResourceAdmission({\n\t\tsnapshot,\n\t\tconfig: resolved.admission,\n\t\tconfiguredCaps: { maxToolConcurrency: settings.configuredMaxToolConcurrency },\n\t});\n\n\tif (json) {\n\t\tconst report = buildResourceDoctorReport({ snapshot, decision, resolved, probeDurationMs });\n\t\twriteLine(JSON.stringify(report, null, 2));\n\t\treturn { handled: true, exitCode: 0 };\n\t}\n\trenderHumanReport({ writeLine, resolved, decision, snapshot, probeDurationMs });\n\treturn { handled: true, exitCode: 0 };\n}\n\nfunction parseDoctorFlags(\n\targs: readonly string[],\n\twriteLine: (line: string) => void,\n): { readonly json: boolean; readonly report: boolean; readonly exit: number | null } {\n\tlet json = false;\n\tlet report = false;\n\tfor (const arg of args) {\n\t\tif (arg === \"--json\") {\n\t\t\tjson = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--report\") {\n\t\t\treport = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (arg === \"--help\" || arg === \"-h\") {\n\t\t\twriteLine(USAGE);\n\t\t\treturn { json, report, exit: 0 };\n\t\t}\n\t\twriteLine(`Unknown argument: ${arg}`);\n\t\twriteLine(USAGE);\n\t\treturn { json, report, exit: 2 };\n\t}\n\treturn { json, report, exit: null };\n}\n\nfunction renderObservationReport(report: ResourceObservationReport, writeLine: (line: string) => void): void {\n\twriteLine(\"Resource observation report\");\n\twriteLine(`journals scanned: ${report.journalsScanned}${report.truncated ? \" (truncated)\" : \"\"}`);\n\twriteLine(`admission records: ${report.admissionRecords}`);\n\twriteLine(`reason-qualified records: ${report.reasonRecords}`);\n\twriteLine(\n\t\t`pressure: normal ${report.pressure.normal}, constrained ${report.pressure.constrained}, critical ${report.pressure.critical}`,\n\t);\n\twriteLine(\n\t\t`actions: allow ${report.actions.allow}, throttle ${report.actions.throttle}, defer-heavy ${report.actions[\"defer-heavy\"]}`,\n\t);\n\twriteLine(`would have throttled: ${report.wouldHaveThrottled}`);\n\twriteLine(`probe partial/timeout: ${report.probePartial}/${report.probeTimeout}`);\n\twriteLine(\n\t\t`minimum sample: ${report.reasonRecords}/${report.minimumSampleSize} (${report.minimumSampleMet ? \"met\" : \"not met\"})`,\n\t);\n\twriteLine(`reason coverage complete: ${report.reasonCoverageComplete ? \"yes\" : \"no\"}`);\n\twriteLine(\"human review: required\");\n\tif (report.diagnostics > 0) writeLine(`diagnostics: ${report.diagnostics}`);\n}\n\nfunction renderHumanReport(input: {\n\treadonly writeLine: (line: string) => void;\n\treadonly resolved: ReturnType<typeof resolveResourceGovernorSettings>;\n\treadonly decision: ReturnType<typeof decideResourceAdmission>;\n\treadonly snapshot: HostResourceSnapshot;\n\treadonly probeDurationMs: number;\n}): void {\n\tconst { writeLine, resolved, decision, snapshot, probeDurationMs } = input;\n\twriteLine(\"Resource doctor\");\n\twriteLine(\"\");\n\tfor (const line of formatResourceSummaryLines(resolved.mode, decision)) {\n\t\twriteLine(line);\n\t}\n\twriteLine(\"\");\n\tfor (const line of formatResourceProbeLines(snapshot)) {\n\t\twriteLine(line);\n\t}\n\twriteLine(\"\");\n\twriteLine(`probe duration: ${Math.round(probeDurationMs)} ms`);\n\tfor (const error of resolved.errors) {\n\t\twriteLine(`settings error: ${error}`);\n\t}\n}\n\nfunction loadSettingsFromDisk(cwd: string | undefined): {\n\treadonly resourceGovernor?: ResourceGovernorSettings;\n\treadonly configuredMaxToolConcurrency?: number;\n} {\n\ttry {\n\t\tconst manager = SettingsManager.create(cwd ?? process.cwd());\n\t\treturn {\n\t\t\tresourceGovernor: manager.getResourceGovernorSettings(),\n\t\t\tconfiguredMaxToolConcurrency: manager.getAgentRuntimeSettings().maxToolConcurrency,\n\t\t};\n\t} catch {\n\t\t// A broken settings file must not block the diagnostic; defaults apply.\n\t\treturn {};\n\t}\n}\n"]}