@lotagate/cli 0.1.24 → 0.1.26

package/dist/application/commands/command-catalog.js

@@ -0,0 +1 @@
+const e=["direct","tui"],r=["direct"],a=["tui"],s={name:"scope",valueName:"<user|project>",description:"Extension scope",allowedValues:["user","project"],requiredOn:r},u=[{name:"token-budget",valueName:"<n>",description:"Maximum token budget"},{name:"max-turns",valueName:"<n>",description:"Maximum goal turns"},{name:"max-duration-ms",valueName:"<n>",description:"Maximum goal duration"}],o={name:"model",valueName:"<model-id>",description:"Use this model for this request only"},i=[{name:"out",valueName:"<filename>",description:"Output filename without extension"},{name:"out-dir",valueName:"<directory>",description:"Local output directory, inside or outside the workspace"},{name:"force",description:"Allow --out to replace an existing generated file"}],n=[o,{name:"n",valueName:"<count>",description:"Number of images"},{name:"size",valueName:"<size>",description:"Requested image size"},{name:"quality",valueName:"<low|medium|high|auto>",description:"Image quality",allowedValues:["low","medium","high","auto"]},{name:"background",valueName:"<transparent|opaque|auto>",description:"Image background",allowedValues:["transparent","opaque","auto"]},{name:"output-format",valueName:"<png|jpeg|webp>",description:"Image output format",allowedValues:["png","jpeg","webp"]},{name:"output-compression",valueName:"<0-100>",description:"Image output compression"},{name:"moderation",valueName:"<mode>",description:"Image moderation mode"},{name:"user",valueName:"<id>",description:"End-user identifier"},...i],m={name:"kind",valueName:"<kind>",description:"Memory kind"};function d(t){return t}const c=[{id:"help",path:["help"],surfaces:e,summary:"Show available commands",executor:"help"},{id:"version",path:["version"],surfaces:e,summary:"Show the CLI version",executor:"version"},{id:"config.get.default",path:["config"],handlerPath:["get"],surfaces:e,summary:"Read effective configuration",arguments:[{name:"key",required:!1}],executor:"config",defaultAction:!0,hiddenFromHelp:!0},{id:"config.get",path:["config","get"],handlerPath:["get"],surfaces:e,summary:"Read effective configuration",arguments:[{name:"key",required:!1}],executor:"config"},{id:"config.set",path:["config","set"],handlerPath:["set"],surfaces:e,summary:"Update global configuration",arguments:[{name:"key",required:!0},{name:"value",required:!0}],executor:"config"},{id:"config.path",path:["config","path"],handlerPath:["path"],surfaces:e,summary:"Show configuration paths",executor:"config"},{id:"auth.status.default",path:["auth"],handlerPath:["status"],surfaces:e,summary:"Show authentication status",executor:"auth",defaultAction:!0,hiddenFromHelp:!0},{id:"auth.login.direct",path:["auth","login"],handlerPath:["login"],surfaces:r,summary:"Save an API-key profile",options:[{name:"profile",valueName:"<name>",description:"Profile name"},{name:"base-url",valueName:"<url>",description:"Provider base URL"}],executor:"auth",desktop:{exposed:!0}},{id:"auth.login.tui",path:["auth","login"],handlerPath:["login"],surfaces:a,summary:"Save an API-key profile",options:[{name:"profile",valueName:"<name>",description:"Profile name"},{name:"base-url",valueName:"<url>",description:"Provider base URL"}],executor:"tui-auth-login"},{id:"auth.logout",path:["auth","logout"],handlerPath:["logout"],surfaces:e,summary:"Remove an API-key profile",arguments:[{name:"profile",required:!1}],executor:"auth"},{id:"auth.list",path:["auth","list"],handlerPath:["list"],surfaces:e,summary:"List authentication profiles",executor:"auth"},{id:"auth.status",path:["auth","status"],handlerPath:["status"],surfaces:e,summary:"Show authentication status",executor:"auth"},{id:"auth.use",path:["auth","use"],handlerPath:["use"],surfaces:e,summary:"Select an authentication profile",arguments:[{name:"profile",required:!0}],executor:"auth"},{id:"model.current.direct",path:["model"],handlerPath:["current"],surfaces:r,summary:"Show the selected model",executor:"model",defaultAction:!0,hiddenFromHelp:!0},{id:"model.select.tui",path:["model"],surfaces:a,summary:"Select a model",executor:"tui-model-select",defaultAction:!0,hiddenFromHelp:!0},{id:"model.current",path:["model","current"],handlerPath:["current"],surfaces:e,summary:"Show the selected model",executor:"model"},{id:"model.use",path:["model","use"],handlerPath:["use"],surfaces:e,summary:"Select a model",arguments:[{name:"model",required:!0}],executor:"model"},{id:"model.list",path:["model","list"],handlerPath:["list"],surfaces:e,summary:"Fetch the model catalog",executor:"model"},{id:"model.refresh",path:["model","refresh"],handlerPath:["refresh"],surfaces:e,summary:"Refresh the model catalog",executor:"model"},{id:"model.doctor",path:["model","doctor"],handlerPath:["doctor"],surfaces:e,summary:"Inspect model configuration",executor:"model"},{id:"effort.current.direct",path:["effort"],handlerPath:["current"],surfaces:r,summary:"Show the selected reasoning effort",executor:"effort",defaultAction:!0,hiddenFromHelp:!0},{id:"effort.select.tui",path:["effort"],surfaces:a,summary:"Select a reasoning effort",executor:"tui-effort-select",defaultAction:!0,hiddenFromHelp:!0},{id:"effort.current",path:["effort","current"],handlerPath:["current"],surfaces:e,summary:"Show the selected reasoning effort",executor:"effort"},{id:"effort.use",path:["effort","use"],handlerPath:["use"],surfaces:e,summary:"Select a reasoning effort",arguments:[{name:"effort",required:!0}],executor:"effort"},{id:"trust.status.default",path:["trust"],handlerPath:["status"],surfaces:e,summary:"Show current project trust",executor:"trust",defaultAction:!0,hiddenFromHelp:!0},{id:"trust.status",path:["trust","status"],handlerPath:["status"],surfaces:e,summary:"Show current project trust",executor:"trust"},{id:"trust.list",path:["trust","list"],handlerPath:["list"],surfaces:e,summary:"List trusted projects",executor:"trust"},{id:"trust.grant",path:["trust","grant"],handlerPath:["grant"],surfaces:e,summary:"Trust the current project",executor:"trust"},{id:"trust.revoke",path:["trust","revoke"],handlerPath:["revoke"],surfaces:e,summary:"Revoke current project trust",executor:"trust"},{id:"inspect",path:["inspect"],surfaces:e,summary:"Inspect current project identity",executor:"inspect"},{id:"hook.list.default",path:["hook"],handlerPath:["list"],surfaces:e,summary:"List project and plugin hooks",executor:"hook",defaultAction:!0,hiddenFromHelp:!0},{id:"hook.list",path:["hook","list"],handlerPath:["list"],surfaces:e,summary:"List project and plugin hooks",executor:"hook"},{id:"mcp.list.default",path:["mcp"],surfaces:e,summary:"List configured MCP servers",executor:"mcp",defaultAction:!0,hiddenFromHelp:!0},{id:"mcp.list",path:["mcp","list"],handlerPath:["list"],surfaces:e,summary:"List configured MCP servers",executor:"mcp"},{id:"mcp.get",path:["mcp","get"],handlerPath:["get"],surfaces:e,summary:"Inspect an MCP server",arguments:[{name:"name",required:!0}],options:[s],executor:"mcp"},{id:"mcp.add",path:["mcp","add"],handlerPath:["add"],surfaces:e,summary:"Add an MCP server",arguments:[{name:"name",required:!0}],options:[{name:"type",valueName:"<stdio|http|sse>",description:"MCP transport type (defaults to stdio)",allowedValues:["stdio","http","sse"]},{name:"command",valueName:"<command>",description:"stdio command",requiredWhen:{option:"type",values:["stdio"],absent:!0}},{name:"url",valueName:"<url>",description:"HTTP or SSE URL",requiredWhen:{option:"type",values:["http","sse"]}},{name:"args",valueName:"<a,b>",description:"Comma-separated stdio arguments"},s],executor:"mcp",desktop:{mutationKey:"mcp"}},{id:"mcp.reload",path:["mcp","reload"],handlerPath:["reload"],surfaces:e,summary:"Reconnect configured MCP servers",executor:"mcp",desktop:{mutationKey:"mcp"}},{id:"mcp.doctor",path:["mcp","doctor"],handlerPath:["doctor"],surfaces:e,summary:"Validate MCP servers",executor:"mcp"},...["enable","disable","remove"].map(t=>({id:`mcp.${t}`,path:["mcp",t],handlerPath:[t],surfaces:e,summary:`${t[0].toUpperCase()}${t.slice(1)} an MCP server`,arguments:[{name:"name",required:!0}],options:[s],executor:"mcp",desktop:{mutationKey:"mcp"}})),{id:"plugin.list.default",path:["plugin"],surfaces:e,summary:"List installed plugins",executor:"plugin",defaultAction:!0,hiddenFromHelp:!0},{id:"plugin.list",path:["plugin","list"],handlerPath:["list"],surfaces:e,summary:"List installed plugins",executor:"plugin"},{id:"plugin.info",path:["plugin","info"],handlerPath:["info"],surfaces:e,summary:"Inspect a plugin and its contributions",executor:"plugin",arguments:[{name:"name",required:!0}],options:[s]},{id:"plugin.install",path:["plugin","install"],handlerPath:["install"],surfaces:e,summary:"Install a plugin or standalone skill",arguments:[{name:"source",required:!0}],options:[s,{name:"sha256",valueName:"<hex>",description:"Expected archive checksum"},{name:"signature",valueName:"<base64>",description:"Archive signature"},{name:"public-key",valueName:"<pem>",description:"Signature public key"}],executor:"plugin",desktop:{mutationKey:"extensions"}},...["enable","disable","uninstall"].map(t=>({id:`plugin.${t}`,path:["plugin",t],handlerPath:[t],surfaces:e,summary:`${t[0].toUpperCase()}${t.slice(1)} a plugin`,arguments:[{name:"name",required:!0}],options:[s],executor:"plugin",desktop:{mutationKey:"extensions"}})),{id:"skill.list.default",path:["skill"],surfaces:e,summary:"List available skills",executor:"skill",defaultAction:!0,hiddenFromHelp:!0},{id:"skill.list",path:["skill","list"],handlerPath:["list"],surfaces:e,summary:"List available skills",executor:"skill"},...["info","enable","disable","remove"].map(t=>({id:`skill.${t}`,path:["skill",t],handlerPath:[t],surfaces:e,summary:`${t[0].toUpperCase()}${t.slice(1)} a skill`,arguments:[{name:"name",required:!0}],options:[s],executor:"skill",...t==="info"?{}:{desktop:{mutationKey:"extensions"}}})),{id:"skill.run.direct",path:["skill","run"],handlerPath:["run"],surfaces:r,summary:"Print an enabled skill prompt",arguments:[{name:"name",required:!0}],options:[s],executor:"skill"},{id:"skill.run.tui",path:["skill","run"],surfaces:a,summary:"Run an enabled skill",arguments:[{name:"name",required:!0},{name:"arguments",required:!1,variadic:!0}],options:[s],executor:"tui-skill-run"},{id:"session.list.default",path:["session"],surfaces:e,summary:"List durable sessions",executor:"session",defaultAction:!0,hiddenFromHelp:!0},{id:"session.list",path:["session","list"],handlerPath:["list"],surfaces:e,summary:"List durable sessions",executor:"session"},{id:"session.show",path:["session","show"],handlerPath:["show"],surfaces:e,summary:"Show a session transcript",arguments:[{name:"id",required:!0}],executor:"session"},{id:"session.import",path:["session","import"],handlerPath:["import"],surfaces:e,summary:"Import a session bundle",options:[{name:"file",valueName:"<path>",description:"Session bundle path",required:!0}],executor:"session"},{id:"session.resume.direct",path:["session","resume"],handlerPath:["resume"],surfaces:r,summary:"Inspect or resume a session",arguments:[{name:"id",required:!0}],options:[{name:"interactive",description:"Open the session in the TUI"}],executor:"session"},{id:"session.resume.tui",path:["session","resume"],surfaces:a,summary:"Resume a session in this TUI",arguments:[{name:"id",required:!0}],executor:"tui-session-resume"},{id:"session.fork",path:["session","fork"],handlerPath:["fork"],surfaces:e,summary:"Fork a session",arguments:[{name:"id",required:!0}],executor:"session"},{id:"session.compact.direct",path:["session","compact"],handlerPath:["compact"],surfaces:r,summary:"Compact a session",arguments:[{name:"id",required:!0}],executor:"session"},{id:"session.compact.tui",path:["session","compact"],surfaces:a,summary:"Compact the active session",executor:"tui-session-compact"},{id:"session.export",path:["session","export"],handlerPath:["export"],surfaces:e,summary:"Export a session bundle",arguments:[{name:"id",required:!0}],options:[{name:"out",valueName:"<path>",description:"Output path"}],executor:"session"},...["recover","repair","delete"].map(t=>({id:`session.${t}`,path:["session",t],handlerPath:[t],surfaces:e,summary:`${t[0].toUpperCase()}${t.slice(1)} a session`,arguments:[{name:"id",required:!0}],executor:"session",...t==="delete"?{desktop:{mutationKey:"session"}}:{}})),{id:"session.rename",path:["session","rename"],surfaces:a,summary:"Rename the active session",arguments:[{name:"name",required:!0,variadic:!0}],executor:"tui-session-rename"},{id:"memory.list.default",path:["memory"],handlerPath:["list"],surfaces:e,summary:"List project memories",options:[m,{name:"state",valueName:"<active|superseded|expired>",description:"Memory lifecycle state",allowedValues:["active","superseded","expired"]}],executor:"memory",defaultAction:!0,hiddenFromHelp:!0},{id:"memory.list",path:["memory","list"],handlerPath:["list"],surfaces:e,summary:"List project memories",options:[m,{name:"state",valueName:"<active|superseded|expired>",description:"Memory lifecycle state",allowedValues:["active","superseded","expired"]}],executor:"memory"},{id:"memory.show",path:["memory","show"],handlerPath:["show"],surfaces:e,summary:"Show a project memory",arguments:[{name:"id",required:!0}],executor:"memory"},{id:"memory.forget",path:["memory","forget"],handlerPath:["forget"],surfaces:e,summary:"Forget a project memory",arguments:[{name:"id",required:!0}],executor:"memory"},{id:"memory.clear",path:["memory","clear"],handlerPath:["clear"],surfaces:e,summary:"Clear project memory",executor:"memory"},{id:"memory.export",path:["memory","export"],handlerPath:["export"],surfaces:e,summary:"Export project memory",options:[{name:"out",valueName:"<path>",description:"Output bundle path"}],executor:"memory"},{id:"memory.import",path:["memory","import"],handlerPath:["import"],surfaces:e,summary:"Validate or import a project memory bundle",options:[{name:"file",valueName:"<path>",description:"Memory bundle path",required:!0},{name:"apply",description:"Apply the validated import"}],executor:"memory"},{id:"goal.status.direct",path:["goal","status"],handlerPath:["status"],surfaces:r,summary:"Show a session goal",arguments:[{name:"id",required:!0}],options:[{name:"json",description:"Use JSON output"}],executor:"goal"},{id:"goal.set",path:["goal","set"],handlerPath:["set"],surfaces:r,summary:"Set a session goal",arguments:[{name:"id",required:!0},{name:"objective",required:!0,variadic:!0}],options:[...u,{name:"json",description:"Use JSON output"}],executor:"goal"},{id:"goal.pause.direct",path:["goal","pause"],handlerPath:["pause"],surfaces:r,summary:"Pause a session goal",arguments:[{name:"id",required:!0}],options:[{name:"json",description:"Use JSON output"}],executor:"goal"},{id:"goal.resume.direct",path:["goal","resume"],handlerPath:["resume"],surfaces:r,summary:"Resume a session goal",arguments:[{name:"id",required:!0}],options:[...u,{name:"json",description:"Use JSON output"}],executor:"goal"},{id:"goal.clear.direct",path:["goal","clear"],handlerPath:["clear"],surfaces:r,summary:"Clear a session goal",arguments:[{name:"id",required:!0}],executor:"goal"},{id:"goal.run",path:["goal","run"],handlerPath:["run"],surfaces:r,summary:"Run a durable multi-turn goal",arguments:[{name:"objective",required:!0,variadic:!0}],options:u,executor:"goal"},...["status","pause","resume","clear"].map(t=>({id:`goal.${t}.tui`,path:["goal",t],surfaces:a,summary:`${t[0].toUpperCase()}${t.slice(1)} the active goal`,executor:"tui-goal"})),{id:"goal.start.tui",path:["goal"],surfaces:a,summary:"Start a goal for the active session",arguments:[{name:"objective",required:!0,variadic:!0}],options:u,executor:"tui-goal",defaultAction:!0,hiddenFromHelp:!0},{id:"doctor",path:["doctor"],surfaces:e,summary:"Run local diagnostics",executor:"doctor"},{id:"chat.direct",path:["chat"],surfaces:r,summary:"Stream a chat completion",arguments:[{name:"prompt",required:!1,variadic:!0}],executor:"chat"},{id:"chat.tui",path:["chat"],surfaces:a,summary:"Send an interactive chat prompt",arguments:[{name:"prompt",required:!0,variadic:!0}],executor:"tui-prompt"},{id:"image.generate",path:["image"],surfaces:e,summary:"Generate image artifacts",arguments:[{name:"prompt",required:!0,variadic:!0}],options:n,executor:"media"},{id:"image.edit",path:["image","edit"],handlerPath:["edit"],surfaces:e,summary:"Edit image artifacts",arguments:[{name:"prompt",required:!0,variadic:!0}],options:[...n,{name:"image",valueName:"<path[,path]>",description:"Source local image files",required:!0},{name:"mask",valueName:"<path>",description:"Optional local mask image"},{name:"input-fidelity",valueName:"<low|high>",description:"Input image fidelity",allowedValues:["low","high"]}],executor:"media"},{id:"audio.speech",path:["audio","speech"],handlerPath:["speech"],surfaces:e,summary:"Generate speech audio",arguments:[{name:"input",required:!0,variadic:!0}],options:[o,{name:"voice",valueName:"<voice>",description:"Voice identifier",required:!0},{name:"instructions",valueName:"<text>",description:"Voice instructions"},{name:"response-format",valueName:"<mp3|opus|aac|flac|wav|pcm>",description:"Audio output format",allowedValues:["mp3","opus","aac","flac","wav","pcm"]},{name:"stream-format",valueName:"<audio|sse>",description:"Speech response transport format",allowedValues:["audio","sse"]},{name:"speed",valueName:"<number>",description:"Speech speed"},...i],executor:"media"},{id:"audio.transcribe",path:["audio","transcribe"],handlerPath:["transcribe"],surfaces:e,summary:"Transcribe an audio file",options:[o,{name:"file",valueName:"<path>",description:"Local audio file",required:!0},{name:"language",valueName:"<code>",description:"Input language code"},{name:"prompt",valueName:"<text>",description:"Transcript prompt"},{name:"response-format",valueName:"<json|text|srt|verbose_json|vtt|diarized_json>",description:"Transcript format",allowedValues:["json","text","srt","verbose_json","vtt","diarized_json"]},{name:"temperature",valueName:"<number>",description:"Sampling temperature"},{name:"timestamp-granularities",valueName:"<word,segment>",description:"Timestamp granularities"},{name:"include",valueName:"<value[,value]>",description:"Provider response fields"},...i],executor:"media"},{id:"audio.translate",path:["audio","translate"],handlerPath:["translate"],surfaces:e,summary:"Translate an audio file",options:[o,{name:"file",valueName:"<path>",description:"Local audio file",required:!0},{name:"prompt",valueName:"<text>",description:"Translation prompt"},{name:"response-format",valueName:"<json|text|srt|verbose_json|vtt>",description:"Translation format",allowedValues:["json","text","srt","verbose_json","vtt"]},{name:"temperature",valueName:"<number>",description:"Sampling temperature"},...i],executor:"media"},{id:"video.generate",path:["video"],surfaces:e,summary:"Create and retrieve a video artifact",arguments:[{name:"prompt",required:!0,variadic:!0}],options:[o,{name:"parameters",valueName:"<json>",description:"Provider video parameter object"},{name:"no-wait",description:"Return the operation id without waiting"},...i],executor:"media"},{id:"video.status",path:["video","status"],handlerPath:["status"],surfaces:e,summary:"Show a video operation status",arguments:[{name:"operation-id",required:!0}],executor:"media"},{id:"video.download",path:["video","download"],handlerPath:["download"],surfaces:e,summary:"Download a completed video artifact",arguments:[{name:"operation-id",required:!0}],options:i,executor:"media"},{id:"exec.direct",path:["exec"],surfaces:r,summary:"Run a headless agent prompt",arguments:[{name:"prompt",required:!0,variadic:!0}],options:[{name:"image",valueName:"<path[,path]>",description:"Image attachments"},{name:"json",description:"Use JSON events"},{name:"jsonl",description:"Use JSONL events"}],executor:"exec",desktop:{exposed:!1}},{id:"exec.tui",path:["exec"],surfaces:a,summary:"Run an interactive agent prompt",arguments:[{name:"prompt",required:!0,variadic:!0}],executor:"tui-prompt"},{id:"agent.stdio",path:["agent","stdio"],handlerPath:["stdio"],surfaces:r,summary:"Run the JSONL agent protocol",executor:"agent",desktop:{exposed:!1}},{id:"agent.desktop",path:["agent","desktop"],handlerPath:["desktop"],surfaces:r,summary:"Run the desktop application protocol",executor:"agent",desktop:{exposed:!1}},{id:"agent.info",path:["agent"],surfaces:a,summary:"Explain the direct JSONL agent protocol",executor:"tui-agent-info"},...["bash","zsh","powershell"].map(t=>({id:`completions.${t}`,path:["completions",t],handlerPath:[t],surfaces:e,summary:`Print ${t} completion definitions`,executor:"completions",desktop:{exposed:!1}})),{id:"completions.default",path:["completions"],surfaces:e,summary:"Print PowerShell completion definitions",executor:"completions",defaultAction:!0,hiddenFromHelp:!0,desktop:{exposed:!1}},{id:"update.check.default",path:["update"],handlerPath:["check"],surfaces:e,summary:"Check update policy",executor:"update",defaultAction:!0,hiddenFromHelp:!0},{id:"update.check",path:["update","check"],handlerPath:["check"],surfaces:e,summary:"Check update policy",executor:"update"},{id:"tui.clear",path:["clear"],surfaces:a,summary:"Clear the current transcript view",executor:"tui-clear"},{id:"tui.stop",path:["stop"],surfaces:a,summary:"Stop the active response",executor:"tui-stop"},{id:"tui.context",path:["context"],surfaces:a,summary:"Show context usage and session composition",executor:"tui-context"},{id:"tui.details",path:["details"],surfaces:a,summary:"Toggle tool execution details",executor:"tui-details"},{id:"tui.exit",path:["exit"],surfaces:a,summary:"Exit the interactive session",executor:"tui-exit"},{id:"attachments.list.default",path:["attachments"],surfaces:a,summary:"List pending attachments",executor:"tui-attachments",defaultAction:!0,hiddenFromHelp:!0},{id:"attachments.list",path:["attachments","list"],surfaces:a,summary:"List pending attachments",executor:"tui-attachments"},{id:"attachments.paste",path:["attachments","paste"],surfaces:a,summary:"Add an image from the clipboard",executor:"tui-attachments"},{id:"attachments.remove",path:["attachments","remove"],surfaces:a,summary:"Remove a pending attachment",arguments:[{name:"id",required:!0}],executor:"tui-attachments"}];export{c as COMMAND_ACTIONS};

package/dist/application/commands/command-contract.d.ts

@@ -0,0 +1,60 @@
+export type CommandSurface = 'direct' | 'tui';
+export type CommandExecutorId = 'help' | 'version' | 'config' | 'auth' | 'tui-auth-login' | 'trust' | 'inspect' | 'hook' | 'model' | 'tui-model-select' | 'effort' | 'tui-effort-select' | 'mcp' | 'plugin' | 'skill' | 'tui-skill-run' | 'session' | 'tui-session-resume' | 'tui-session-compact' | 'tui-session-rename' | 'goal' | 'memory' | 'tui-goal' | 'doctor' | 'chat' | 'exec' | 'media' | 'tui-prompt' | 'agent' | 'tui-agent-info' | 'completions' | 'update' | 'tui-clear' | 'tui-stop' | 'tui-context' | 'tui-details' | 'tui-attachments' | 'tui-exit';
+export interface CommandArgumentSpec {
+    readonly name: string;
+    readonly required: boolean;
+    readonly variadic?: boolean;
+}
+export interface CommandOptionRequirement {
+    readonly option: string;
+    readonly values?: readonly string[];
+    readonly absent?: boolean;
+}
+export interface CommandOptionSpec {
+    readonly name: string;
+    readonly valueName?: string;
+    readonly description: string;
+    readonly required?: boolean;
+    readonly requiredOn?: readonly CommandSurface[];
+    readonly requiredWhen?: CommandOptionRequirement;
+    readonly allowedValues?: readonly string[];
+}
+export interface CommandActionSpec {
+    readonly id: string;
+    /** Tokens used to select this action on a supported surface. */
+    readonly path: readonly string[];
+    /** Tokens the existing application handler expects before parsed arguments. */
+    readonly handlerPath?: readonly string[];
+    readonly surfaces: readonly CommandSurface[];
+    readonly summary: string;
+    readonly arguments?: readonly CommandArgumentSpec[];
+    readonly options?: readonly CommandOptionSpec[];
+    readonly executor: CommandExecutorId;
+    /**
+     * Optional exposure policy for the Desktop JSONL protocol. Direct and TUI
+     * users continue to resolve commands from `surfaces`; this metadata only
+     * controls whether a command is safe and meaningful for a non-terminal
+     * Desktop client.
+     */
+    readonly desktop?: {
+        readonly exposed?: boolean;
+        /** Resource domain that must not mutate concurrently with turns/commands. */
+        readonly mutationKey?: string;
+    };
+    /** Default action for a command group, such as `mcp` → `mcp list`. */
+    readonly defaultAction?: boolean;
+    /** Default routes are executable but excluded from command lists. */
+    readonly hiddenFromHelp?: boolean;
+}
+export interface CommandInvocation {
+    readonly surface: CommandSurface;
+    readonly action: CommandActionSpec;
+    readonly positionals: readonly string[];
+    readonly options: ReadonlyMap<string, string | boolean>;
+    readonly handlerPositionals: readonly string[];
+}
+export interface CommandSuggestion {
+    readonly value: string;
+    readonly label: string;
+    readonly description: string;
+}

package/dist/application/commands/command-hints.d.ts

@@ -0,0 +1,9 @@
+import type { CliError } from '../../domain/errors/cli-error.js';
+import type { CliCommandHint } from '../../domain/errors/cli-command-hint.js';
+export type CommandSurface = 'tui' | 'direct';
+export declare function commandHint(actionId: string, tuiActionId?: string): CliCommandHint;
+export declare const AUTH_LOGIN_HINT: CliCommandHint;
+export declare const MODEL_SELECT_HINT: CliCommandHint;
+export declare const TRUST_GRANT_HINT: CliCommandHint;
+export declare function formatCommandHint(hint: CliCommandHint, surface: CommandSurface): string;
+export declare function formatCliErrorMessage(error: CliError, surface: CommandSurface): string;

package/dist/application/commands/command-hints.js

@@ -0,0 +1 @@
+import{formatCommandUsage as r}from"./command-presentation.js";import{COMMAND_REGISTRY as i}from"./command-runtime.js";function e(t,n){return n===void 0?{actionId:t}:{actionId:t,tuiActionId:n}}const d=e("auth.login.direct","auth.login.tui"),s=e("model.use"),c=e("trust.grant");function m(t,n){const o=i.get(n==="tui"?t.tuiActionId??t.actionId:t.actionId);return o===void 0?"Try the relevant command from the command help.":`Try \`${r(o,n)}\`.`}function f(t,n){return t.hint===void 0?t.userMessage:`${t.userMessage} ${m(t.hint,n)}`}export{d as AUTH_LOGIN_HINT,s as MODEL_SELECT_HINT,c as TRUST_GRANT_HINT,e as commandHint,f as formatCliErrorMessage,m as formatCommandHint};

package/dist/application/commands/command-output.d.ts

@@ -0,0 +1,4 @@
+export interface CommandOutput {
+    write(value: string): unknown;
+    writeStructured?<T extends object>(value: T, fallbackText?: string): unknown;
+}

package/dist/application/commands/command-parser.d.ts

@@ -0,0 +1,10 @@
+import type { CommandInvocation, CommandSurface } from './command-contract.js';
+import type { CommandRegistry } from './command-registry.js';
+export declare function tokenizeCommandInput(value: string): readonly string[];
+export declare function parseCommandInvocation(tokens: readonly string[], surface: CommandSurface, registry: CommandRegistry): CommandInvocation;
+/**
+ * Validates an already selected action. Protocol callers use this when the
+ * action id and parsed values are transported separately from the command
+ * text, while direct and TUI callers continue to use token parsing above.
+ */
+export declare function parseCommandInvocationForAction(actionId: string, positionals: readonly string[], options: ReadonlyMap<string, string | boolean>, surface: CommandSurface, registry: CommandRegistry): CommandInvocation;

package/dist/application/commands/command-parser.js

@@ -0,0 +1 @@
+import{CliError as g}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as v}from"../../domain/errors/error-codes.js";function x(n){const o=[];let e="",i,t=!1;for(const r of n.trim()){if(t){e+=r,t=!1;continue}if(r==="\\"){i!==void 0?t=!0:e+=r;continue}if(i!==void 0){r===i?i=void 0:e+=r;continue}if(r==='"'||r==="'"){i=r;continue}if(/\s/u.test(r)){e.length>0&&(o.push(e),e="");continue}e+=r}return t&&(e+="\\"),e.length>0&&o.push(e),o}function A(n,o,e){const i=e.resolve(n,o),t=n.slice(i.path.length),{positionals:r,options:u}=$(t,i);return w(i,r,u,o)}function y(n,o,e,i,t){const r=t.get(n);if(r===void 0)throw f(`Unknown command action: ${n}.`);if(!r.surfaces.includes(i))throw f(`Command action ${n} is not available on the ${i} surface.`);return w(r,o,e,i)}function w(n,o,e,i){return q(n,o),M(n,e,i),{surface:i,action:n,positionals:o,options:e,handlerPositionals:[...n.handlerPath??n.path.slice(1),...o]}}function $(n,o){const e=[],i=new Map,t=new Map((o.options??[]).map(u=>[u.name,u]));let r=!0;for(let u=0;u<n.length;u+=1){const a=n[u];if(r&&a==="--"){r=!1;continue}if(!r||!a.startsWith("--")||a.length===2){e.push(a);continue}const c=a.indexOf("="),s=a.slice(2,c<0?void 0:c),p=t.get(s);if(p===void 0)throw f(`Unsupported option --${s} for ${o.path.join(" ")}.`);if(i.has(s))throw f(`Option --${s} was provided more than once.`);const d=c<0?void 0:a.slice(c+1);if(p.valueName===void 0){if(d!==void 0&&d!=="true")throw f(`Option --${s} does not accept a value.`);i.set(s,d===void 0?!0:d);continue}const l=n[u+1],h=d??(l===void 0||l==="--"||l.startsWith("--")?void 0:l);if(h===void 0||h.trim().length===0)throw m(`Missing value for --${s}.`);d===void 0&&(u+=1),i.set(s,h)}return{positionals:e,options:i}}function q(n,o){const e=n.arguments??[],i=e.filter(r=>r.required).length;if(o.length<i){const r=e[o.length];throw m(`Missing required argument: ${r?.name??"value"}.`)}if(!(e.at(-1)?.variadic===!0)&&o.length>e.length)throw f(`Too many arguments for ${n.path.join(" ")}.`)}function M(n,o,e){const i=new Map((n.options??[]).map(t=>[t.name,t]));for(const t of o.keys())if(!i.has(t))throw f(`Unsupported option --${t} for ${n.path.join(" ")}.`);for(const t of n.options??[]){const r=t.required===!0||t.requiredOn?.includes(e)===!0,u=t.requiredWhen===void 0?!1:C(t.requiredWhen,o);if((r||u)&&!o.has(t.name))throw m(`Missing required option --${t.name}.`);const a=o.get(t.name);if(t.allowedValues!==void 0&&typeof a=="string"&&!t.allowedValues.includes(a))throw f(`Invalid value for --${t.name}. Expected one of: ${t.allowedValues.join(", ")}.`)}}function C(n,o){const e=o.get(n.option),i=n.absent===!0&&e===void 0,t=n.values===void 0?e!==void 0:typeof e=="string"&&n.values.includes(e);return i||t}function m(n){return new g(v.MISSING_ARGUMENT,n,{category:"arguments",userMessage:n})}function f(n){return new g(v.INVALID_ARGUMENT,n,{category:"arguments",userMessage:n})}export{A as parseCommandInvocation,y as parseCommandInvocationForAction,x as tokenizeCommandInput};

package/dist/application/commands/command-presentation.d.ts

@@ -0,0 +1,7 @@
+import type { CommandActionSpec, CommandSuggestion, CommandSurface } from './command-contract.js';
+import type { CommandRegistry } from './command-registry.js';
+export declare function formatCommandReference(action: CommandActionSpec, surface: CommandSurface): string;
+export declare function formatCommandUsage(action: CommandActionSpec, surface: CommandSurface): string;
+export declare function formatCommandInvocation(action: CommandActionSpec, surface: CommandSurface, positionals?: readonly string[], options?: ReadonlyMap<string, string | boolean>): string;
+export declare function formatCommandHelp(registry: CommandRegistry, surface: CommandSurface): string;
+export declare function commandSuggestions(input: string, registry: CommandRegistry, surface: CommandSurface): readonly CommandSuggestion[];

package/dist/application/commands/command-presentation.js

@@ -0,0 +1,3 @@
+import{tokenizeCommandInput as A}from"./command-parser.js";function p(n,t){return`${t==="direct"?"lotagate ":"/"}${n.path.join(" ")}`}function L(n,t){const e=w(n),a=(n.options??[]).map(s=>{const o=s.valueName===void 0?`--${s.name}`:`--${s.name} ${s.valueName}`;return b(s,t)?o:`[${o}]`});return[p(n,t),...e,...a].join(" ")}function R(n,t,e=[],a=new Map){const s=[...a.entries()].flatMap(([o,r])=>r===!0?[`--${o}`]:[`--${o}`,r]);return[p(n,t),...e,...s].join(" ")}function W(n,t){const e=n.list(t).map(o=>({usage:L(o,t),summary:o.summary})),a=Math.max(...e.map(o=>o.usage.length),0);return`${t==="direct"?"LotaGate CLI commands:":"Interactive commands:"}
+${e.map(o=>`  ${o.usage.padEnd(a)}  ${o.summary}`).join(`
+`)}`}function q(n,t,e){const a=e==="tui"?"/":"",s=e==="tui"?n.trimStart().slice(1):n.trimStart(),o=/\s$/u.test(s),r=A(s);if(r.length===0)return S(a,t,e,"");if(r.length===1&&!o)return S(a,t,e,r[0]);const m=r[0].toLowerCase(),u=t.actionsForRoot(m,e),c=u.filter(d=>!d.hiddenFromHelp);if(u.length===0)return[];const i=o?"":r[1]??"";if(r.length<=2){const d=v(u),h=r.length===2&&c.some(f=>f.path.length===2&&f.path[1]===r[1]?.toLowerCase()),x=!o&&r.length===2&&c.some(f=>f.path.length===2&&f.path[1].startsWith(i.toLowerCase()));if(r.length===1||o&&r.length===1||h||x){if(!h)return g(a,m,i,t,e)}else return d!==void 0?C(n,d,e,r):g(a,m,i,t,e)}const l=j(r,t,e);return l===void 0?g(a,m,i,t,e):!o&&r.length===l.path.length?[$(l,e)]:C(n,l,e,r)}function S(n,t,e,a){const s=new Map;for(const o of t.list(e))s.has(o.path[0])||s.set(o.path[0],o);return[...s.entries()].filter(([o])=>o.startsWith(a.toLowerCase())).map(([o,r])=>({value:`${n}${o}`,label:`${n}${o}`,description:r.summary}))}function g(n,t,e,a,s){const o=new Map,r=a.actionsForRoot(t,s);for(const u of r){if(u.hiddenFromHelp||u.path.length<2)continue;const c=u.path[1];!c.startsWith(e.toLowerCase())||o.has(c)||o.set(c,u)}const m=v(r);return[...m===void 0||!(m.arguments?.some(u=>u.required)??!1)?[]:[$(m,s,n)],...[...o.values()].map(u=>$(u,s,n))]}function v(n){return n.find(t=>t.defaultAction===!0&&t.path.length===1)??n.find(t=>t.path.length===1&&!t.hiddenFromHelp)}function C(n,t,e,a){const s=e==="tui"?"/":"",o=new Set(a.filter(i=>i.startsWith("--")).map(i=>i.slice(2).split("=")[0])),r=e==="tui"?n.trimStart().slice(1):n.trimStart(),m=/\s$/u.test(r),u=m?"":a.at(-1)??"";if(!u.startsWith("--"))return[];const c=m?r.trimEnd():r.slice(0,Math.max(0,r.lastIndexOf(" "))).trimEnd();return(t.options??[]).filter(i=>!o.has(i.name)&&`--${i.name}`.startsWith(u)).map(i=>{const l=`--${i.name}`,d=`${s}${c}${c.length===0?"":" "}${l}`,h=i.valueName===void 0?l:`${l} ${i.valueName}`;return{value:d,label:b(i,e)?h:`[${h}]`,description:i.description}})}function j(n,t,e){try{return t.resolve(n,e)}catch{return}}function $(n,t,e){const a=e===void 0?p(n,t):`${e}${n.path.join(" ")}`,s=k(n,t);return{value:a,label:s,description:n.summary}}function k(n,t){return[p(n,t),...w(n)].join(" ")}function w(n){return(n.arguments??[]).map(t=>{const e=t.variadic?`${t.name}...`:t.name;return t.required?`<${e}>`:`[${e}]`})}function b(n,t){return n.required===!0||n.requiredOn?.includes(t)===!0}export{q as commandSuggestions,W as formatCommandHelp,R as formatCommandInvocation,p as formatCommandReference,L as formatCommandUsage};

package/dist/application/commands/command-registry.d.ts

@@ -0,0 +1,11 @@
+import type { CommandActionSpec, CommandSurface } from './command-contract.js';
+export declare class CommandRegistry {
+    private readonly actions;
+    private readonly byId;
+    constructor(actions: readonly CommandActionSpec[]);
+    get(id: string): CommandActionSpec | undefined;
+    list(surface: CommandSurface, includeHidden?: boolean): readonly CommandActionSpec[];
+    actionsForRoot(root: string, surface: CommandSurface): readonly CommandActionSpec[];
+    resolve(tokens: readonly string[], surface: CommandSurface): CommandActionSpec;
+    private assertNoSurfaceCollisions;
+}

package/dist/application/commands/command-registry.js

@@ -0,0 +1 @@
+import{CliError as d}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as h}from"../../domain/errors/error-codes.js";class p{actions;byId=new Map;constructor(o){this.actions=o;for(const t of o){if(t.path.length===0)throw new Error(`Command action ${t.id} has no path.`);if(this.byId.has(t.id))throw new Error(`Command action ${t.id} is already registered.`);this.byId.set(t.id,t)}for(const t of["direct","tui"])this.assertNoSurfaceCollisions(t)}get(o){return this.byId.get(o)}list(o,t=!1){return this.actions.filter(n=>n.surfaces.includes(o)&&(t||!n.hiddenFromHelp)).sort(f)}actionsForRoot(o,t){const n=o.toLowerCase();return this.actions.filter(r=>r.surfaces.includes(t)&&r.path[0]===n)}resolve(o,t){const n=o[0]?.toLowerCase();if(n===void 0)throw s("A command is required.");const a=this.actionsForRoot(n,t).filter(i=>l(i.path,o)).sort((i,c)=>c.path.length-i.path.length)[0];if(a!==void 0)return a;throw this.actionsForRoot(n,t).length===0?s(`Unknown command: ${n}.`):s(`Unsupported ${n} command.`)}assertNoSurfaceCollisions(o){const t=new Set;for(const n of this.actions.filter(r=>r.surfaces.includes(o))){const r=n.path.join(" ");if(t.has(r))throw new Error(`Command path collision on ${o}: ${r}.`);t.add(r)}}}function l(e,o){return o.length<e.length?!1:e.every((t,n)=>o[n]?.toLowerCase()===t)}function f(e,o){return e.path.join(" ").localeCompare(o.path.join(" "))}function s(e){return new d(h.INVALID_ARGUMENT,e,{category:"arguments",userMessage:e})}export{p as CommandRegistry};

package/dist/application/commands/command-runtime.d.ts

@@ -0,0 +1,2 @@
+import { CommandRegistry } from './command-registry.js';
+export declare const COMMAND_REGISTRY: CommandRegistry;

package/dist/application/commands/command-runtime.js

@@ -0,0 +1 @@
+import{COMMAND_ACTIONS as o}from"./command-catalog.js";import{CommandRegistry as m}from"./command-registry.js";const C=new m(o);export{C as COMMAND_REGISTRY};

package/dist/application/commands/goal-command-handlers.d.ts

@@ -0,0 +1,3 @@
+import type { Writable } from 'node:stream';
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+export declare function runGoalCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, stdout: Writable, signal?: AbortSignal): Promise<number>;

package/dist/application/commands/goal-command-handlers.js

@@ -0,0 +1,7 @@
+import{isFlagEnabled as G,requirePositional as v}from"./cli-args.js";import{ProjectSessionAccess as D}from"../session/project-session-access.js";import{AuthenticationService as L}from"../auth/authentication-service.js";import{loadExecutionConfig as P}from"../config/execution-config.js";import{createLotaGateClient as x}from"../../infrastructure/sdk/lotagate-client-factory.js";import{runHeadlessAgentTurn as F}from"../orchestration/headless-agent-turn.js";import{runGoalLoop as q}from"../orchestration/goal-runner.js";import{CliAgentSessionStore as $}from"../agent/agent-session-store.js";import{formatGoalStatus as k}from"../orchestration/goal-output.js";import{parseGoalInput as B}from"../orchestration/goal-input.js";import{CliError as p}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as g}from"../../domain/errors/error-codes.js";import{MODEL_SELECT_HINT as H,TRUST_GRANT_HINT as J}from"./command-hints.js";import{createTurnId as K,recordTurnCompletion as Q,recordTurnFailure as W,recordTurnStart as z}from"../session/session-turn-lifecycle.js";import{createCommandAbortController as V,throwIfCommandAborted as O}from"./command-cancellation.js";async function fe(r,t,e,u,s,c){const i=r[0]??"status";if(i==="run")return M(r.slice(1).join(" ").trim(),t,e,u,s,void 0,c);O(c);const l=v(r,1,"session id"),d=await e.projectTrust.inspect(u);if(await new D(e.sessionStore).require(l,d.fingerprint),i==="status")return N(s,await e.goalStore.get(l),G(t,"json"));if(i==="set"){const n=v([r.slice(2).join(" ")],0,"goal objective"),w=await e.goalStore.replace(l,U(n,t));return N(s,w,G(t,"json"))}if(i==="pause"){const n=await e.goalStore.pause(l);return N(s,n,G(t,"json"))}if(i==="resume"){const n=await e.goalStore.get(l);if(n===void 0)throw new p(g.GOAL_NOT_FOUND,"Goal not found.",{category:"goal",userMessage:"Goal was not found."});return M(n.objective,t,e,u,s,l,c)}if(i==="clear")return await e.goalStore.clear(l),s.write(`Goal cleared.
+`),0;throw new Error(`Unsupported goal action: ${i}`)}async function M(r,t,e,u,s,c,i){if(O(i),r.length===0)throw new p(g.MISSING_ARGUMENT,"Missing goal objective.",{category:"arguments",userMessage:"A goal objective is required."});const l=U(r,t),d=await e.projectTrust.inspect(u);if(!await e.projectTrust.isTrusted(d))throw new p(g.PROJECT_TRUST_REQUIRED,"Project trust is required for goals.",{category:"project",userMessage:"Project is not trusted.",hint:J});const n=await P(e,u);if(n.config.model===null)throw new p(g.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:H});const w=n.config.model,T=n.config.profile??L.defaultProfileName(),y=await e.auth.requireCredential(T),a=c===void 0?await e.sessionStore.create({projectFingerprint:d.fingerprint,cwd:d.canonicalPath,model:n.config.model,profile:T,status:"active"}):await e.sessionStore.get(c);if(a===void 0)throw new p(g.SESSION_NOT_FOUND,"Goal session not found.",{category:"session",userMessage:"Goal session was not found."});c===void 0?await e.goalStore.create(a.id,l):await e.goalStore.resume(a.id);const I=x(y.profile,y.apiKey),R=new $,h=V(i),E=h.controller,j=()=>E.abort(new Error("Goal interrupted by user."));process.once("SIGINT",j);try{const f=await q({runtime:e,sessionId:a.id,objective:r,model:w,client:I,signal:E.signal,runTurn:async(C,m,A)=>{const S=K();await z(e.sessionStore,a.id,S,C);try{const o=await e.goalStore.get(a.id),_=await F({runtime:e,cwd:u,model:w,profileName:T,client:I,prompt:C,output:s,sessionId:a.id,agentSessionStore:R,signal:A,turnId:S,...o===void 0?{}:{goal:{objective:o.objective,status:o.status,turns:o.turns,evaluatorRuns:o.evaluatorRuns,tokensUsed:o.usage.totalTokens,...o.tokenBudget===void 0?{}:{tokenBudget:o.tokenBudget},...o.maxTurns===void 0?{}:{maxTurns:o.maxTurns},...o.maxDurationMs===void 0?{}:{maxDurationMs:o.maxDurationMs},...o.lastError===void 0?{}:{lastError:o.lastError},...o.lastEvaluation===void 0?{}:{lastEvaluation:o.lastEvaluation.reason}}},onUsage:m.onUsage,onSubagentUsage:m.onUsage,onSnapshot:m.onSnapshot});return s.write(`
+`),await Q(e.sessionStore,a.id,S,_),_}catch(o){throw m.onError(o),await W(e.sessionStore,a.id,S,o,E.signal.aborted),o}}});await e.sessionStore.updateStatus(a.id,f?.status==="completed"?"completed":f?.status==="paused"?"active":"failed"),s.write(`Goal session: ${a.id}
+`);const b=f?.status==="paused"&&f.lastError?.startsWith("Goal paused by safety limit:")===!0;return f?.status==="completed"||b?0:1}finally{process.off("SIGINT",j),h.dispose()}}function U(r,t){return B(r,t)}function N(r,t,e){return e?(r.write(`${JSON.stringify(t??null)}
+`),t===void 0?1:0):t===void 0?(r.write(`No active goal.
+`),1):(r.write(`${k(t)}
+`),0)}export{fe as runGoalCommand};

package/dist/application/commands/media-command-handlers.d.ts

@@ -0,0 +1,9 @@
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+import type { CommandInvocation } from './command-contract.js';
+import type { CommandOutput } from './command-output.js';
+export interface CommandActivityObserver {
+    start(key: string, label: string): {
+        complete(isError: boolean): void;
+    };
+}
+export declare function runMediaCommand(invocation: CommandInvocation, runtime: CliRuntime, cwd: string, output: CommandOutput, activity?: CommandActivityObserver, suppliedSignal?: AbortSignal): Promise<number>;

package/dist/application/commands/media-command-handlers.js

@@ -0,0 +1,9 @@
+import{AuthenticationService as P}from"../auth/authentication-service.js";import{loadExecutionConfig as R}from"../config/execution-config.js";import{waitForVideoOperation as U}from"../media/video-operation-poller.js";import{loadModelCatalog as J}from"../model/model-catalog-service.js";import{CliError as $}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as F}from"../../domain/errors/error-codes.js";import{SDK_BINARY_MEDIA_RESPONSE_BYTES as v,validateMediaCommandOptions as K}from"../../domain/media/gateway-media-contract.js";import{resolveMediaExecutionPolicy as Y}from"../../domain/media/media-execution-policy.js";import{readGatewayAudioInput as H,readGatewayImageEditInput as W}from"../../infrastructure/filesystem/gateway-media-input-reader.js";import{WorkspaceMediaArtifactStore as Z}from"../../infrastructure/filesystem/workspace-media-artifact-store.js";import{normalizeImage as k}from"../../infrastructure/clipboard/image-normalizer.js";import{downloadPublicMedia as Q}from"../../infrastructure/network/safe-media-downloader.js";import{createLotaGateClient as X}from"../../infrastructure/sdk/lotagate-client-factory.js";import{SdkMediaGatewayClient as ee}from"../../infrastructure/sdk/sdk-media-gateway-client.js";import{MODEL_SELECT_HINT as _}from"./command-hints.js";import{writeMediaCommandResult as E}from"./media-command-output.js";import{writeStreamChunk as te}from"./stream-output.js";import{getStringFlag as s,isFlagEnabled as D,requirePositional as G,requireStringFlag as O}from"./cli-args.js";async function De(e,t,o,r,i,a){K(e.action.id,e.positionals,e.options);const n=a===void 0?new AbortController:void 0,p=a??n.signal,u=()=>n?.abort(new Error("Media command interrupted."));n!==void 0&&process.once("SIGINT",u);try{t.logger.info("Media command started.",{action:e.action.id});const d=await oe(e,t,o,r,i,p);return t.logger.info("Media command completed.",{action:e.action.id,exitCode:d}),d}catch(d){const m=d instanceof $?{code:d.code,category:d.category,correlationId:d.correlationId}:{};throw t.logger.error("Media command failed.",{action:e.action.id,...m}),d}finally{n!==void 0&&process.off("SIGINT",u)}}async function oe(e,t,o,r,i,a){const n=e.action.id;n!=="video.status"&&await t.projectTrust.requireTrusted(await t.projectTrust.inspect(o));const p=await R(t,o),u=p.config.profile??P.defaultProfileName(),d=await t.auth.requireCredential(u),m=new ee(X(d.profile,d.apiKey)),f=new Z(o,t.logger),c=Y();if(n==="video.status")return ue(G(e.positionals,0,"operation id"),m,t.logger,r,i,a);if(n==="video.download")return me(G(e.positionals,0,"operation id"),e.options,m,f,t.logger,r,i,a);const w=await ne(e.options,p.config.model,t,o);if(n==="image.generate")return re(e.positionals,e.options,w,m,f,c.downloadTimeoutMs,r,i,a);if(n==="image.edit")return ie(e.positionals,e.options,w,m,f,o,c.downloadTimeoutMs,r,i,a);if(n==="audio.speech")return ae(e.positionals,e.options,w,m,f,r,i,a);if(n==="audio.transcribe"||n==="audio.translate")return de(n,e.options,w,m,f,o,r,i,a);if(n==="video.generate")return se(e.positionals,e.options,w,m,f,c,t,r,i,a);throw new Error(`Unsupported media command: ${n}`)}async function ne(e,t,o,r){const i=s(e,"model")??t;if(i==null)throw new $(F.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:_});if(!(await J(o,r)).data.some(n=>n.id===i))throw new $(F.MODEL_NOT_FOUND,`Model is not available: ${i}`,{category:"model",userMessage:`Model is not available: ${i}.`,hint:_});return i}async function re(e,t,o,r,i,a,n,p,u){const d=N(e,"image"),m=await l(p,"image.generate","image generation",()=>r.generateImage({model:o,prompt:d,...j(t)},{signal:u})),c=(await l(p,"image.store","image download and save",()=>q(m,M("image",d,B(t),t),i,a,u))).map(w=>w.path);return E(n,{kind:"media",mediaType:"image",artifacts:c.map(w=>({path:w}))},I("Generated image",c)),0}async function ie(e,t,o,r,i,a,n,p,u,d){const m=N(e,"image edit"),f=await W(O(t,"image"),s(t,"mask"),a),c=await l(u,"image.edit","image edit",()=>r.editImage({model:o,prompt:m,images:[...f.images],...f.mask===void 0?{}:{mask:f.mask},...j(t),...s(t,"input-fidelity")===void 0?{}:{inputFidelity:s(t,"input-fidelity")}},{signal:d})),y=(await l(u,"image.store","image download and save",()=>q(c,M("image",m,B(t),t),i,n,d))).map(g=>g.path);return E(p,{kind:"media",mediaType:"image",artifacts:y.map(g=>({path:g}))},I("Generated image",y)),0}async function ae(e,t,o,r,i,a,n,p){const u=N(e,"speech"),d=s(t,"response-format"),m=s(t,"stream-format"),f={model:o,input:u,voice:O(t,"voice"),...s(t,"instructions")===void 0?{}:{instructions:s(t,"instructions")},...d===void 0?{}:{responseFormat:d},...S(t,"speed")===void 0?{}:{speed:S(t,"speed")},...m===void 0?{}:{streamFormat:m}};if(m==="sse")return await l(n,"audio.speech","speech streaming",async()=>{for await(const h of r.createSpeechStream({...f,streamFormat:"sse"},{signal:p}))await te(a,`${JSON.stringify(h)}
+`)}),0;const c=await l(n,"audio.speech","speech generation",()=>r.createSpeech({...f,streamFormat:"audio"},{signal:p}));C(c.bytes);const w=d??A(c.contentType,"mp3"),g=(await l(n,"audio.store","speech save",()=>i.writeMany(M("speech",u,w,t),[c.bytes]))).map(h=>h.path);return E(a,{kind:"media",mediaType:"audio",artifacts:g.map(h=>({path:h}))},I("Generated speech",g)),0}async function de(e,t,o,r,i,a,n,p,u){const d=await H(O(t,"file"),a),m=s(t,"response-format")??"json",f={model:o,file:d.bytes,filename:d.filename,responseFormat:m,...s(t,"prompt")===void 0?{}:{prompt:s(t,"prompt")},...S(t,"temperature")===void 0?{}:{temperature:S(t,"temperature")},...e==="audio.transcribe"&&s(t,"language")!==void 0?{language:s(t,"language")}:{},...e==="audio.transcribe"?L(t,"timestamp-granularities",["word","segment"]):{},...e==="audio.transcribe"?L(t,"include"):{}},c=await l(p,e,e==="audio.transcribe"?"audio transcription":"audio translation",()=>e==="audio.transcribe"?r.transcribe(f,{signal:u}):r.translate(f,{signal:u})),w=e==="audio.transcribe"?"transcription":"translation",y=await l(p,`${e}.store`,`${w} save`,()=>i.writeMany(M(w,d.sourceName,le(m),t),[Buffer.from(c,"utf8")]));return ge(m)?n.write(`${c}
+Saved ${w}: ${y[0].path}
+`):n.write(I(`${ye(w)} result`,y.map(g=>g.path))),0}async function se(e,t,o,r,i,a,n,p,u,d){const m=N(e,"video"),f=fe(s(t,"parameters")),c=await l(u,"video.create","video generation request",()=>r.createVideo({model:o,prompt:m,...f===void 0?{}:{parameters:f}},{signal:d}));if(c.errorMessage!==void 0)throw V(c);if(n.logger.info("Video generation accepted.",{operationId:c.id,model:o}),p.write(`Video operation: ${c.id}
+`),D(t,"no-wait"))return 0;const w=c.done?c:await l(u,`video.wait:${c.id}`,"video generation",()=>U(r,c.id,a,d));if(w.errorMessage!==void 0)throw V(w);const y=await l(u,`video.download:${c.id}`,"video download",()=>r.downloadVideo(c.id,{signal:d}));C(y.bytes);const g=await l(u,`video.store:${c.id}`,"video save",()=>i.writeMany(M("video",m,A(y.contentType,"mp4"),t),[y.bytes]));n.logger.info("Video artifact stored.",{operationId:c.id,artifactCount:g.length,artifactBytes:z(g)});const h=g.map(x=>x.path);return E(p,{kind:"media",mediaType:"video",artifacts:h.map(x=>({path:x}))},I("Generated video",h)),0}async function ue(e,t,o,r,i,a){const n=await l(i,`video.status:${e}`,"video status",()=>t.getVideoOperation(e,{signal:a}),p=>p.errorMessage!==void 0);if(o.info("Video status retrieved.",{operationId:n.id,status:n.errorMessage===void 0?n.done?"completed":"pending":"failed"}),n.errorMessage!==void 0)throw V(n);return r.write(`Video operation ${n.id}: ${n.done?"COMPLETED":"PENDING"}
+`),0}async function me(e,t,o,r,i,a,n,p){const u=await l(n,`video.download:${e}`,"video download",()=>o.downloadVideo(e,{signal:p}));C(u.bytes);const d=await l(n,`video.store:${e}`,"video save",()=>r.writeMany(M("video",e,A(u.contentType,"mp4"),t),[u.bytes]));i.info("Video artifact downloaded.",{operationId:e,artifactCount:d.length,artifactBytes:z(d)});const m=d.map(f=>f.path);return E(a,{kind:"media",mediaType:"video",artifacts:m.map(f=>({path:f}))},I("Downloaded video",m)),0}function j(e){const t=s(e,"quality"),o=s(e,"background"),r=s(e,"output-format");return{...T(e,"n")===void 0?{}:{n:T(e,"n")},...s(e,"size")===void 0?{}:{size:s(e,"size")},...t===void 0?{}:{quality:t},...o===void 0?{}:{background:o},...r===void 0?{}:{outputFormat:r},...T(e,"output-compression")===void 0?{}:{outputCompression:T(e,"output-compression")},...s(e,"moderation")===void 0?{}:{moderation:s(e,"moderation")},...s(e,"user")===void 0?{}:{user:s(e,"user")}}}function M(e,t,o,r){const i=s(r,"out"),a=s(r,"out-dir");return{kind:e,source:t,extension:o,...i===void 0?{}:{out:i},...a===void 0?{}:{outDir:a},force:D(r,"force")}}async function q(e,t,o,r,i){const a=[];let n=t.extension;for(const p of e){const u=p.base64===void 0?await pe(p.url,r,i):ce(p.base64);a.push(u.bytes),n=we(u.mimeType,n)}return o.writeMany({...t,extension:n},a)}function ce(e){if(!/^[A-Za-z0-9+/]*={0,2}$/u.test(e)||e.length%4!==0)throw b("The provider returned invalid Base64 image data.");const t=Buffer.from(e,"base64");return C(t),k(t,void 0,v)}async function pe(e,t,o){const r=await Q(e,{maxBytes:v,timeoutMs:t,signal:o}),i=k(r.bytes,r.contentType,v);if(!["image/png","image/jpeg","image/webp"].includes(i.mimeType))throw b(`Unsupported generated image format: ${i.mimeType}.`);return i}function N(e,t){const o=e.join(" ").trim();if(o.length===0)throw b(`A prompt is required for ${t}.`);return o}function T(e,t){const o=s(e,t);if(o!==void 0){if(!/^\d+$/u.test(o)||!Number.isSafeInteger(Number(o)))throw b(`--${t} must be an integer.`);return Number(o)}}function S(e,t){const o=s(e,t);if(o===void 0)return;const r=Number(o);if(!Number.isFinite(r))throw b(`--${t} must be a finite number.`);return r}function L(e,t,o){const r=s(e,t);if(r===void 0)return{};const i=r.split(",").map(a=>a.trim()).filter(Boolean);if(i.length===0||o!==void 0&&i.some(a=>!o.includes(a)))throw b(`--${t} contains an unsupported value.`);return t==="timestamp-granularities"?{timestampGranularities:i}:{include:i}}function fe(e){if(e!==void 0)try{const t=JSON.parse(e);if(typeof t!="object"||t===null||Array.isArray(t))throw new Error;return t}catch{throw b("--parameters must be a JSON object.")}}function B(e){return s(e,"output-format")??"png"}function we(e,t){return e==="image/jpeg"?"jpeg":e==="image/webp"?"webp":e==="image/png"?"png":t}function A(e,t){const o=e?.toLowerCase();return o==="audio/mpeg"?"mp3":o==="audio/ogg"?"opus":o==="audio/aac"?"aac":o==="audio/flac"?"flac":o==="audio/wav"||o==="audio/x-wav"?"wav":o==="video/webm"?"webm":o==="video/quicktime"?"mov":o==="video/mp4"?"mp4":t}function le(e){return e==="text"?"txt":e==="verbose_json"||e==="diarized_json"?"json":e}function ge(e){return e==="text"||e==="srt"||e==="vtt"}function C(e){if(e.byteLength===0||e.byteLength>v)throw b("Generated media exceeds the supported binary output limit.")}function I(e,t){return`${e}${t.length===1?"":"s"} saved:
+${t.map(o=>`  ${o}`).join(`
+`)}
+`}function ye(e){return`${e[0]?.toUpperCase()??""}${e.slice(1)}`}function z(e){return e.reduce((t,o)=>t+o.bytes,0)}function b(e){return new $(F.INVALID_ARGUMENT,e,{category:"media",userMessage:e})}function V(e){return new $("MEDIA_VIDEO_FAILED",`Video operation failed: ${e.id}`,{category:"media",userMessage:e.errorMessage??`Video operation failed: ${e.id}`})}async function l(e,t,o,r,i=()=>!1){const a=e?.start(t,o);try{const n=await r();return a?.complete(i(n)),n}catch(n){throw a?.complete(!0),n}}export{De as runMediaCommand};

package/dist/application/commands/media-command-output.d.ts

@@ -0,0 +1,11 @@
+import type { CommandOutput } from './command-output.js';
+export type MediaArtifactType = 'image' | 'audio' | 'video';
+export interface MediaCommandResult {
+    readonly kind: 'media';
+    readonly mediaType: MediaArtifactType;
+    readonly artifacts: readonly {
+        readonly path: string;
+    }[];
+}
+/** Keeps normal CLI output text while exposing media metadata to Desktop protocol callers. */
+export declare function writeMediaCommandResult(output: CommandOutput, result: MediaCommandResult, fallbackText: string): void;

package/dist/application/commands/media-command-output.js

@@ -0,0 +1 @@
+function t(e,i,r){if(e.writeStructured===void 0){e.write(r);return}e.writeStructured(i,r)}export{t as writeMediaCommandResult};

package/dist/application/commands/memory-command-handler.d.ts

@@ -0,0 +1,29 @@
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+import type { MemoryBundle, MemoryRecord } from '../../domain/memory/memory.js';
+import type { CommandOutput } from './command-output.js';
+export type MemoryCommandPayload = {
+    readonly kind: 'memory.list';
+    readonly items: readonly MemoryRecord[];
+} | {
+    readonly kind: 'memory.show';
+    readonly item: MemoryRecord;
+} | {
+    readonly kind: 'memory.forget';
+    readonly id: string;
+    readonly forgotten: boolean;
+} | {
+    readonly kind: 'memory.clear';
+    readonly cleared: number;
+} | {
+    readonly kind: 'memory.export';
+    readonly bundle: MemoryBundle;
+    readonly outputPath?: string;
+} | {
+    readonly kind: 'memory.import.preview';
+    readonly records: number;
+} | {
+    readonly kind: 'memory.import';
+    readonly imported: number;
+    readonly skipped: number;
+};
+export declare function runMemoryCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, output: CommandOutput): Promise<number>;

package/dist/application/commands/memory-command-handler.js

@@ -0,0 +1,12 @@
+import{isMemoryState as l}from"../../domain/memory/memory.js";import{isMemoryKind as p,MEMORY_KINDS as f}from"../../domain/memory/memory-kinds.js";import{CliError as s}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../../domain/errors/error-codes.js";import{assertExternalWriteTarget as $,resolveExternalOutputPath as w,resolveExternalPath as M}from"../../infrastructure/filesystem/path-resolver.js";import{atomicWriteFile as h}from"../../infrastructure/filesystem/atomic-file-store.js";import{readJsonFileBounded as g}from"../../infrastructure/filesystem/bounded-json-reader.js";import{RESOURCE_LIMITS as k}from"../../domain/runtime/resource-limits.js";import{formatCompactTable as v}from"../formatting/compact-table.js";import{getStringFlag as u,isFlagEnabled as R,requirePositional as c,requireStringFlag as E}from"./cli-args.js";async function V(e,r,t,n,a){const i=e[0]??"list";if(i==="list")return I(await t.memory.list(n,T(r)),a);if(i==="forget"){const o=c(e,1,"memory id"),y=await t.memory.forget(n,o);return m(a,{kind:"memory.forget",id:o,forgotten:y},y?`Forgot memory: ${o}
+`:`Memory not found: ${o}
+`)}if(i==="show")return N(await O(t,n,c(e,1,"memory id")),a);if(i==="clear"){const o=await t.memory.clear(n);return m(a,{kind:"memory.clear",cleared:o},`Cleared ${o} memor${o===1?"y":"ies"}.
+`)}if(i==="export")return S(t,n,r,a);if(i==="import")return x(t,n,r,a);throw new s(d.INVALID_ARGUMENT,`Unsupported memory action: ${i}`,{category:"memory",userMessage:`Unsupported memory action: ${i}`})}async function S(e,r,t,n){const a=await e.memory.export(r),i=u(t,"out");if(i===void 0)return m(n,{kind:"memory.export",bundle:a},`${JSON.stringify(a,null,2)}
+`);const o=await w(i,{cwd:r});return await $(o),await h(o,`${JSON.stringify(a,null,2)}
+`),m(n,{kind:"memory.export",bundle:a,outputPath:o},`Exported ${a.records.length} memories: ${o}
+`)}async function x(e,r,t,n){const a=await M(E(t,"file"),{cwd:r}),i=await e.memory.previewImport(await g(a,k.memoryBundleBytes));if(!R(t,"apply"))return m(n,{kind:"memory.import.preview",records:i.records.length},`Validated ${i.records.length} memories. Re-run with --apply to import.
+`);const o=await e.memory.import(r,i);return m(n,{kind:"memory.import",...o},`Imported ${o.imported} memories; skipped ${o.skipped}.
+`)}function I(e,r){const t=`${v(e.map(n=>({name:n.statement,status:n.kind.toUpperCase(),detail:`${n.id} \xB7 ${n.state} \xB7 ${n.lastRetrievedAt??"never retrieved"}`})),{columns:[{key:"name",header:"Memory",minWidth:4,maxWidth:28},{key:"status",header:"Type",minWidth:4,maxWidth:16},{key:"detail",header:"Details",minWidth:12}],empty:"No memories found."})}
+`;return m(r,{kind:"memory.list",items:e},t)}function N(e,r){const t=[`Memory ${e.id}`,`Type: ${e.kind}`,`Statement: ${e.statement}`,`State: ${e.state}`,`Source: ${e.source}`,`Topics: ${e.topics.length===0?"none":e.topics.join(", ")}`,...e.rationale===void 0?[]:[`Rationale: ${e.rationale}`],`Evidence: ${e.evidenceRefs.length===0?"none":e.evidenceRefs.join(", ")}`,`Retrievals: ${e.retrievalCount}${e.lastRetrievedAt===void 0?"":` \xB7 last retrieved ${e.lastRetrievedAt}`}`].join(`
+`).concat(`
+`);return m(r,{kind:"memory.show",item:e},t)}function m(e,r,t){return e.writeStructured!==void 0?e.writeStructured(r,t):e.write(t),0}async function O(e,r,t){const n=await e.memory.get(r,t);if(n!==void 0)return n;throw new s(d.MEMORY_NOT_FOUND,`Memory not found: ${t}`,{category:"memory",userMessage:`Memory not found: ${t}`})}function T(e){const r=A(e),t=C(e);return{...r===void 0?{}:{kind:r},...t===void 0?{}:{state:t}}}function A(e){const r=u(e,"kind");if(r!==void 0){if(p(r))return r;throw new s(d.INVALID_ARGUMENT,`Memory kind must be one of: ${f.join(", ")}.`,{category:"memory",userMessage:`Memory kind must be one of: ${f.join(", ")}.`})}}function C(e){const r=u(e,"state");if(r!==void 0){if(l(r))return r;throw new s(d.INVALID_ARGUMENT,"Invalid memory state.",{category:"memory",userMessage:"Memory state must be active, superseded, or expired."})}}export{V as runMemoryCommand};

package/dist/application/commands/runtime-command-handlers.d.ts

@@ -0,0 +1,7 @@
+import type { CommandOutput } from './command-output.js';
+import type { createCompositionRoot } from '../../bootstrap/composition-root.js';
+type CliRuntime = ReturnType<typeof createCompositionRoot>;
+export declare function runSessionCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, stdout: CommandOutput, resumeInteractive?: (sessionId: string) => Promise<number>, signal?: AbortSignal): Promise<number>;
+export declare function runChatCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, stdout: CommandOutput, parentSignal?: AbortSignal): Promise<number>;
+export declare function runExecCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, stdout: CommandOutput, parentSignal?: AbortSignal): Promise<number>;
+export {};

package/dist/application/commands/runtime-command-handlers.js

@@ -0,0 +1,14 @@
+import{Writable as k}from"node:stream";import{AuthenticationService as M}from"../auth/authentication-service.js";import{ChatService as G}from"../chat/chat-service.js";import{createLotaGateClient as _}from"../../infrastructure/sdk/lotagate-client-factory.js";import{SdkChatCompletionAdapter as F}from"../../infrastructure/sdk/chat-completion-adapter.js";import{CliError as u}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as w}from"../../domain/errors/error-codes.js";import{MODEL_SELECT_HINT as $}from"./command-hints.js";import{createImageAttachment as P,DEFAULT_MAX_IMAGE_BYTES as D,normalizeImage as q}from"../../infrastructure/clipboard/image-normalizer.js";import{readJsonFileBounded as B}from"../../infrastructure/filesystem/bounded-json-reader.js";import{readFileBounded as J}from"../../infrastructure/filesystem/bounded-file-reader.js";import{RESOURCE_LIMITS as T}from"../../domain/runtime/resource-limits.js";import{ProjectSessionAccess as U}from"../session/project-session-access.js";import{compactStoredSession as j}from"../session/session-compaction-service.js";import{requirePositional as z,getFlag as v,isFlagEnabled as N,requireStringFlag as H}from"./cli-args.js";import{resolveExternalPath as W,resolveWorkspacePath as x}from"../../infrastructure/filesystem/path-resolver.js";import{atomicWriteFile as K}from"../../infrastructure/filesystem/atomic-file-store.js";import{loadExecutionConfig as R}from"../config/execution-config.js";import{runHeadlessAgentTurn as V}from"../orchestration/headless-agent-turn.js";import{writeStreamChunk as E}from"./stream-output.js";import{formatCompactTable as X}from"../formatting/compact-table.js";import{createCommandAbortController as L,throwIfCommandAborted as C}from"./command-cancellation.js";async function Se(g,s,o,a,r,d,m){C(m);const i=g[0]??"list",l=await o.projectTrust.inspect(a);if(i==="list"){const t=await o.sessionStore.list(l.fingerprint);return r.write(`${X(t.map(n=>({name:n.name??n.id,status:n.status.toUpperCase(),detail:`${n.id} \xB7 ${n.model??"no model"} \xB7 ${n.updatedAt}`})),{empty:"No sessions found."})}
+`),0}if(i==="import"){const t=H(s,"file"),n=await x(t,{cwd:a,workspaceRoot:a}),f=await B(n,T.sessionBundleBytes),c=await o.sessionStore.import(f,l.fingerprint,a);return r.write(`${JSON.stringify(c,null,2)}
+`),0}const e=z(g,1,"session id"),p=await new U(o.sessionStore).require(e,l.fingerprint);if(i==="show")return r.write(`${JSON.stringify({metadata:p,transcript:await o.sessionStore.readTranscript(e)},null,2)}
+`),0;if(i==="resume"){if(N(s,"interactive")){if(!(r instanceof k))throw new Error("Interactive session resume requires a terminal output stream.");if(d===void 0)throw new Error("Interactive session resume is unavailable in this command host.");return d(e)}return r.write(`${JSON.stringify({metadata:p,transcript:await o.sessionStore.readTranscript(e),resumable:p.status!=="active"},null,2)}
+`),0}if(i==="fork"){const t=await o.sessionStore.fork(e);return r.write(`${JSON.stringify(t,null,2)}
+`),0}if(i==="compact"){if(g.length>2)throw new u(w.INVALID_ARGUMENT,"Compaction does not accept a summary.",{category:"session",userMessage:"The compact command does not accept a summary. It summarizes the session automatically."});const t=await j(o,a,e);return r.write(`${t.compacted?`Compacted session: ${e}`:`No conversation to compact: ${e}`}
+`),0}if(i==="export"){const t=await o.sessionStore.export(e),n=v(s,"out"),f=`${JSON.stringify(t,null,2)}
+`;if(typeof n=="string"&&n.trim().length>0){const c=await x(n,{cwd:a,workspaceRoot:a},!0);await K(c,f),r.write(`Exported session: ${c}
+`)}else r.write(f);return 0}if(i==="recover")return r.write(`${JSON.stringify({sessionId:e,recovered:await o.sessionStore.recoverStaleLock(e)})}
+`),0;if(i==="repair")return r.write(`${JSON.stringify(await o.sessionStore.repair(e))}
+`),0;if(i==="delete"){await o.executionWorkspaces?.remove(e);const t=await o.sessionStore.delete(e);return r.write(`${t?`Deleted session: ${e}`:`Session not found: ${e}`}
+`),t?0:1}throw new Error(`Unsupported session action: ${i}`)}async function Te(g,s,o,a,r){C(r);const d=g.join(" ").trim();if(d.length===0)return a.write('Interactive prompt editor requires a terminal. Run `lotagate` in a terminal or use `lotagate chat "prompt"` for streaming.\n'),0;const m=await R(s,o);if(m.config.model===null)throw new u(w.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:$});const i=m.config.profile??M.defaultProfileName(),l=await s.auth.requireCredential(i),e=_(l.profile,l.apiKey),p=L(r),t=p.controller,n=()=>t.abort();process.once("SIGINT",n);try{const f=new G(new F(e));for await(const c of f.stream(m.config.model,d,{reasoningEffort:m.config.effort,signal:t.signal}))c.type==="delta"&&await E(a,c.content);return await E(a,`
+`),0}finally{process.off("SIGINT",n),p.dispose()}}async function Ne(g,s,o,a,r,d){C(d);const m=g.join(" ").trim();if(m.length===0)throw new u(w.MISSING_ARGUMENT,"Missing prompt.",{category:"arguments",userMessage:"A prompt is required for exec."});const i=await R(o,a);if(i.config.model===null)throw new u(w.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:$});const l=i.config.profile??M.defaultProfileName(),e=await o.auth.requireCredential(l),p=v(s,"image"),t=[];let n=0;if(typeof p=="string")for(const[h,O]of p.split(",").map(y=>y.trim()).filter(Boolean).entries()){if(t.length>=T.pendingAttachments)throw new u(w.ATTACHMENT_TOO_LARGE,"Too many images were supplied.",{category:"attachment",userMessage:"Too many images were supplied. Reduce the image list and retry."});const y=await W(O,{cwd:a}),b=await J(y,D);if(b.truncated)throw new u(w.ATTACHMENT_TOO_LARGE,"Image exceeds the supported size.",{category:"attachment",userMessage:"An image exceeds the supported size limit."});const S=q(b.bytes);if(n+=S.bytes.byteLength,n>T.pendingAttachmentTotalBytes)throw new u(w.ATTACHMENT_TOO_LARGE,"Image attachment total exceeds the supported limit.",{category:"attachment",userMessage:"The combined image size is too large. Reduce the image list and retry."});t.push({attachment:P(S,"file",`image-${h+1}`,O),bytes:S.bytes})}const f=N(s,"json")||N(s,"jsonl"),c=L(d),I=c.controller,A=()=>I.abort();process.once("SIGINT",A);try{const h=_(e.profile,e.apiKey);return await V({runtime:o,cwd:a,model:i.config.model,profileName:l,reasoningEffort:i.config.effort,client:h,prompt:m,...t.length===0?{}:{attachments:t},output:r,json:f,signal:I.signal}),f||await E(r,`
+`),0}finally{process.off("SIGINT",A),c.dispose()}}export{Te as runChatCommand,Ne as runExecCommand,Se as runSessionCommand};

package/dist/application/commands/stream-output.d.ts

@@ -0,0 +1,4 @@
+/** Writes streamed CLI output without allowing a slow pipe to grow memory unboundedly. */
+export declare function writeStreamChunk(output: {
+    write(value: string): unknown;
+}, value: string): Promise<void>;

package/dist/application/commands/stream-output.js

@@ -0,0 +1 @@
+import{once as e}from"node:events";async function a(n,r){n.write(r)!==!1||!i(n)||await e(n,"drain")}function i(n){return typeof n.once=="function"}export{a as writeStreamChunk};

package/dist/application/commands/utility-commands.d.ts

@@ -0,0 +1,6 @@
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+import type { CommandOutput } from './command-output.js';
+export declare function runDoctorCommand(runtime: CliRuntime, cwd: string, stdout: CommandOutput): Promise<number>;
+export declare function runInspectCommand(runtime: CliRuntime, cwd: string, stdout: CommandOutput): Promise<number>;
+export declare function runCompletionsCommand(positionals: readonly string[], stdout: CommandOutput): Promise<number>;
+export declare function runUpdateCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, stdout: CommandOutput): Promise<number>;

package/dist/application/commands/utility-commands.js

@@ -0,0 +1,10 @@
+import{CLI_ERROR_CODES as m}from"../../domain/errors/error-codes.js";import{CliError as u}from"../../domain/errors/cli-error.js";import{CLI_VERSION as p}from"../../version.js";import f from"node:path";import{AuthenticationService as g}from"../auth/authentication-service.js";import{loadExecutionConfig as d}from"../config/execution-config.js";import{formatCompactTable as h}from"../formatting/compact-table.js";import{COMMAND_REGISTRY as w}from"./command-runtime.js";async function E(t,o,n){const r=await d(t,o),a=await t.projectTrust.inspect(o),e=r.config.profile??g.defaultProfileName(),c=await t.credentialStore.get(e),l=[{name:"node",ok:Number(process.versions.node.split(".")[0])>=22,detail:process.version},{name:"cwd",ok:f.isAbsolute(o),detail:o},{name:"config",ok:!0,detail:`${r.sources.length} file(s) loaded`},{name:"auth",ok:c!==void 0,detail:c===void 0?`profile ${e} is not configured`:`profile ${e} configured`},{name:"project-trust",ok:await t.projectTrust.isTrusted(a),detail:a.canonicalPath}],s=l.every(i=>i.ok);return n.write(`Doctor \xB7 ${s?"OK":"FAIL"}
+${h(l.map(i=>({name:i.name,status:i.ok?"OK":"FAIL",detail:i.detail})))}
+`),s?0:1}async function b(t,o,n){return n.write(`${JSON.stringify(await t.projectTrust.inspect(o),null,2)}
+`),0}async function v(t,o){const n=t[0]??"powershell",r=C(),a=r.join(" "),e=r.map(s=>`"${s}"`).join(","),l={bash:`_lotagate_complete() { COMPREPLY=( $(compgen -W "${a}" -- "\${COMP_WORDS[COMP_CWORD]}") ); }; complete -F _lotagate_complete lotagate
+`,zsh:`#compdef lotagate
+_arguments "1:command:(${a})"
+`,powershell:`Register-ArgumentCompleter -CommandName lotagate -ScriptBlock { param($wordToComplete) ${e} | Where-Object { $_ -like "$wordToComplete*" } }
+`}[n];if(l===void 0)throw new u(m.INVALID_ARGUMENT,`Unsupported shell: ${n}`,{category:"arguments",userMessage:"Unsupported shell. Choose bash, zsh, or powershell."});return o.write(l),0}function C(){return[...new Set(w.list("direct").map(t=>t.path[0]))]}async function I(t,o,n,r){if((t[0]??"check")!=="check")throw new u(m.INVALID_ARGUMENT,"Unsupported update action.",{category:"update",userMessage:"Only `lotagate update check` is supported."});const a=await d(o,n),e=process.env.LOTAGATE_NPM_REGISTRY?.trim()||"https://registry.npmjs.org",c=new AbortController,l=setTimeout(()=>c.abort(),3e3);try{const s=await fetch(`${e.replace(/\/$/u,"")}/@lotagate%2fcli/latest`,{signal:c.signal,headers:{accept:"application/json"}});if(!s.ok)throw new Error(`Registry returned HTTP ${s.status}.`);const i=await s.json();if(typeof i.version!="string"||!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/u.test(i.version))throw new Error("Registry response did not contain a valid version.");r.write(`${JSON.stringify({currentVersion:p,latestVersion:i.version,channel:a.config.updateChannel,updateAvailable:y(i.version,p)>0,installation:"manual"},null,2)}
+`)}catch(s){r.write(`${JSON.stringify({currentVersion:p,channel:a.config.updateChannel,checked:!1,reason:s instanceof Error?s.message:"Unable to query the registry.",installation:"manual"},null,2)}
+`)}finally{clearTimeout(l)}return 0}function y(t,o){const n=e=>(e.split("-")[0]??"").split(".").map(c=>Number(c)),r=n(t),a=n(o);for(let e=0;e<3;e+=1)if((r[e]??0)!==(a[e]??0))return(r[e]??0)-(a[e]??0);return 0}export{v as runCompletionsCommand,E as runDoctorCommand,b as runInspectCommand,I as runUpdateCommand};

package/dist/application/config/execution-config.d.ts

@@ -0,0 +1,4 @@
+import type { createCompositionRoot } from '../../bootstrap/composition-root.js';
+import type { ConfigLoadResult } from '../../infrastructure/config/config-loader.js';
+/** Loads project configuration only after the project trust boundary is known. */
+export declare function loadExecutionConfig(runtime: ReturnType<typeof createCompositionRoot>, cwd: string): Promise<ConfigLoadResult>;

package/dist/application/config/execution-config.js

@@ -0,0 +1 @@
+async function n(t,o){const c=await t.projectTrust.inspect(o),e=await t.projectTrust.isTrusted(c);return t.configLoader.load(o,{includeProject:e})}export{n as loadExecutionConfig};

package/dist/application/extensions/extension-list-contract.d.ts

@@ -0,0 +1,18 @@
+import type { ExtensionScope } from '../../domain/extensions/extension-scope.js';
+export type ExtensionListKind = 'hook' | 'skill' | 'plugin' | 'mcp';
+export type ExtensionListScope = ExtensionScope | 'plugin' | 'builtin';
+export interface ExtensionListItem {
+    readonly name: string;
+    readonly displayName?: string;
+    readonly status: string;
+    readonly detail: string;
+    readonly description?: string;
+    readonly version?: string;
+    readonly scope?: ExtensionListScope;
+    readonly pluginName?: string;
+    readonly sourceName?: string;
+}
+export interface ExtensionListResult {
+    readonly kind: ExtensionListKind;
+    readonly items: readonly ExtensionListItem[];
+}

package/dist/application/extensions/extension-list-formatters.d.ts

@@ -0,0 +1,38 @@
+import type { HookDefinition } from '../../domain/extensions/hook-manifest.js';
+import type { CliMcpConfig, CliMcpServerConfig } from '../../domain/extensions/mcp-config.js';
+import type { InstalledPlugin } from '../../infrastructure/extensions/plugin-manager.js';
+import type { ScopedSkill } from '../../infrastructure/extensions/skill-manager.js';
+import type { ExtensionScope } from '../../domain/extensions/extension-scope.js';
+import type { ExtensionListScope } from './extension-list-contract.js';
+import type { ExtensionListResult } from './extension-list-contract.js';
+export declare function formatMcpList(entries: readonly {
+    scope: ExtensionListScope;
+    config: CliMcpConfig;
+    pluginName?: string;
+    sourceNames?: Readonly<Record<string, string>>;
+    pluginNames?: Readonly<Record<string, string>>;
+}[]): string;
+export declare function createMcpListResult(entries: readonly {
+    scope: ExtensionListScope;
+    config: CliMcpConfig;
+    pluginName?: string;
+    sourceNames?: Readonly<Record<string, string>>;
+    pluginNames?: Readonly<Record<string, string>>;
+}[]): ExtensionListResult;
+export declare function formatExtensionList(result: ExtensionListResult): string;
+export declare function formatMcpDetails(name: string, scope: ExtensionScope, entry: {
+    enabled: boolean;
+    config: CliMcpServerConfig;
+} | undefined): string;
+export declare function formatPluginList(entries: readonly {
+    scope: ExtensionScope;
+    plugins: readonly InstalledPlugin[];
+}[]): string;
+export declare function createPluginListResult(entries: readonly {
+    scope: ExtensionScope;
+    plugins: readonly InstalledPlugin[];
+}[]): ExtensionListResult;
+export declare function formatSkillList(skills: readonly ScopedSkill[]): string;
+export declare function createSkillListResult(skills: readonly ScopedSkill[]): ExtensionListResult;
+export declare function formatHookList(hooks: readonly HookDefinition[]): string;
+export declare function createHookListResult(hooks: readonly HookDefinition[]): ExtensionListResult;

package/dist/application/extensions/extension-list-formatters.js

@@ -0,0 +1 @@
+import{formatCompactTable as m}from"../formatting/compact-table.js";const E=240,N=280;function S(e){return u(D(e))}function D(e){return{kind:"mcp",items:e.flatMap(({scope:n,config:a,pluginName:i,sourceNames:o,pluginNames:c})=>Object.entries(a).map(([d,L])=>({name:d,scope:n,entry:L,pluginName:c?.[d]??i,sourceName:o?.[d]}))).sort((n,a)=>n.name.localeCompare(a.name)||n.scope.localeCompare(a.scope)).map(({name:n,scope:a,entry:i,pluginName:o,sourceName:c})=>({name:n,status:i.enabled?"ENABLED":"DISABLED",detail:`${a} \xB7 ${A(i.config)}`,scope:a,...o===void 0?{}:{pluginName:o},...c===void 0?{}:{sourceName:c}}))}}function u(e){return e.kind==="mcp"?m(e.items,{empty:"No MCP servers configured."}):e.kind==="plugin"?m(e.items,{empty:"No plugins installed."}):e.kind==="skill"?m(e.items,{empty:"No skills available.",maxWidth:N}):m(e.items,{empty:"No hooks are loaded. Hooks require a trusted project."})}function T(e,t,n){if(n===void 0)return`MCP server not found: ${e}.`;const a=n.config.type==="stdio"?{type:p(n.config),command:r(n.config.command),args:n.config.args?.map(r)??[],credentials:f(n.config)}:{type:p(n.config),url:l(n.config.url),credentials:f(n.config)};return JSON.stringify({name:e,scope:t,enabled:n.enabled,...a})}function $(e){return u(g(e))}function g(e){return{kind:"plugin",items:e.flatMap(({scope:n,plugins:a})=>a.map(i=>({scope:n,plugin:i}))).sort((n,a)=>n.plugin.manifest.name.localeCompare(a.plugin.manifest.name)||n.scope.localeCompare(a.scope)).map(({scope:n,plugin:a})=>({name:a.manifest.name,...a.manifest.displayName===void 0?{}:{displayName:a.manifest.displayName},status:a.enabled?"ENABLED":"DISABLED",detail:`${n} \xB7 v${a.manifest.version}`,version:a.manifest.version,...a.manifest.description===void 0?{}:{description:a.manifest.description},scope:n}))}}function R(e){return u(y(e))}function y(e){return{kind:"skill",items:[...e].sort((t,n)=>t.skillKey.localeCompare(n.skillKey)).map(t=>({name:t.skillKey,status:t.enabled?"ENABLED":"DISABLED",detail:`${t.scope} \xB7 ${s(r(t.description),E)}`,scope:t.scope,...t.pluginName===void 0?{}:{pluginName:t.pluginName,sourceName:t.name}}))}}function x(e){return u(C(e))}function C(e){return{kind:"hook",items:[...e].sort((t,n)=>t.id.localeCompare(n.id)).map(t=>({name:t.id,status:t.event,detail:`${s(r([t.command,...t.args].join(" ")),160)} \xB7 ${t.timeoutMs}ms`,...t.scope===void 0?{}:{scope:t.scope},...t.pluginName===void 0?{}:{pluginName:t.pluginName,sourceName:t.sourceName}}))}}function A(e){return e.type==="stdio"?s(r([e.command,...e.args??[]].join(" ")),160):`${e.type} \xB7 ${l(e.url)}`}function p(e){return e.type}function f(e){return e.type==="stdio"?e.env!==void 0&&Object.keys(e.env).length>0:e.auth!==void 0||e.headers!==void 0&&Object.keys(e.headers).length>0||/(?:key|token|secret|password|auth)=/iu.test(e.url)}function l(e){try{const t=new URL(e);for(const n of t.searchParams.keys())/(key|token|secret|password|auth)/iu.test(n)&&t.searchParams.set(n,"[REDACTED]");return s(t.toString(),180)}catch{return s(r(e),180)}}function r(e){return e.replace(/Bearer\s+[^\s]+/giu,"Bearer [REDACTED]").replace(/sk-[A-Za-z0-9_-]{8,}/gu,"[REDACTED]").replace(/(api[_-]?key|password|secret|token)\s*[:=]\s*[^\s,]+/giu,"$1=[REDACTED]")}function s(e,t){return e.length<=t?e:`${e.slice(0,t-3)}...`}export{C as createHookListResult,D as createMcpListResult,g as createPluginListResult,y as createSkillListResult,u as formatExtensionList,x as formatHookList,T as formatMcpDetails,S as formatMcpList,$ as formatPluginList,R as formatSkillList};

package/dist/application/extensions/extension-list-output.d.ts

@@ -0,0 +1,3 @@
+import type { CommandOutput } from '../commands/command-output.js';
+import type { ExtensionListResult } from './extension-list-contract.js';
+export declare function writeExtensionListResult(output: CommandOutput, result: ExtensionListResult, fallbackText: string): void;

package/dist/application/extensions/extension-list-output.js

@@ -0,0 +1,3 @@
+function n(e,i,r){if(e.writeStructured===void 0){e.write(`${r}
+`);return}e.writeStructured(i,`${r}
+`)}export{n as writeExtensionListResult};

package/dist/application/extensions/plugin-contribution-registry.d.ts

@@ -0,0 +1,31 @@
+import { type CliMcpConfig } from '../../domain/extensions/mcp-config.js';
+import { type PluginManifest } from '../../domain/extensions/plugin-manifest.js';
+import type { PluginSkillRoot } from '../../infrastructure/extensions/skill-roots.js';
+import type { PluginAgentDefinition } from '../../domain/extensions/plugin-agent-manifest.js';
+export interface PluginContributions {
+    plugins: readonly PluginManifest[];
+    skillRoots: readonly PluginSkillRoot[];
+    mcpConfig: CliMcpConfig;
+    mcpContributions: readonly PluginMcpContribution[];
+    agents: readonly PluginAgentContribution[];
+}
+export interface PluginAgentContribution {
+    readonly pluginName: string;
+    readonly definition: PluginAgentDefinition;
+}
+export interface PluginMcpContribution {
+    readonly pluginName: string;
+    readonly sourceName: string;
+    readonly qualifiedName: string;
+}
+/** Resolves only enabled, trusted declarative plugin contributions. */
+export declare class PluginContributionRegistry {
+    private readonly globalConfigDirectory;
+    constructor(globalConfigDirectory: string);
+    resolve(cwd: string, trustedProject: boolean): Promise<PluginContributions>;
+}
+export declare function loadPluginMcpConfig(plugins: readonly PluginManifest[]): Promise<{
+    config: CliMcpConfig;
+    contributions: readonly PluginMcpContribution[];
+}>;
+export declare function mergeMcpConfigContributions(...configs: readonly CliMcpConfig[]): CliMcpConfig;

package/dist/application/extensions/plugin-contribution-registry.js

@@ -0,0 +1 @@
+import a from"node:path";import h from"node:fs/promises";import{createHash as y}from"node:crypto";import{mergeMcpConfigs as w,validateMcpConfig as M}from"../../domain/extensions/mcp-config.js";import{CliError as p}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../../domain/errors/error-codes.js";import{PLUGIN_LAYOUT as m}from"../../domain/extensions/plugin-manifest.js";import{PluginManager as C}from"../../infrastructure/extensions/plugin-manager.js";import{readJsonFileBounded as P}from"../../infrastructure/filesystem/bounded-json-reader.js";import{RESOURCE_LIMITS as b}from"../../domain/runtime/resource-limits.js";import{isFileNotFound as _}from"../../infrastructure/filesystem/fs-errors.js";import{PluginAgentDiscovery as $}from"../../infrastructure/extensions/plugin-agent-discovery.js";class G{globalConfigDirectory;constructor(e){this.globalConfigDirectory=e}async resolve(e,i){if(!i)return{plugins:[],skillRoots:[],mcpConfig:{},mcpContributions:[],agents:[]};const s=a.join(this.globalConfigDirectory,"plugins"),f=a.join(e,".lotagate","plugins"),n=I([...await new C(f).list(),...await new C(s).list()]).filter(t=>t.enabled).map(t=>t.manifest),r=await j(n),g=(await Promise.all(n.map(async t=>(await new $().discover(a.join(t.directory,m.agentsDirectory))).map(l=>({pluginName:t.name,definition:l}))))).flat();return{plugins:n,skillRoots:n.map(t=>({root:a.join(t.directory,m.skillsDirectory),pluginName:t.name})),mcpConfig:r.config,mcpContributions:r.contributions,agents:g}}}function I(o){const e=new Set;return o.filter(i=>e.has(i.manifest.name)?!1:(e.add(i.manifest.name),!0))}async function j(o){const e={},i=[];for(const s of o){const f=a.join(s.directory,m.mcpDirectory);let c;try{c=(await h.readdir(f,{withFileTypes:!0})).filter(n=>n.isFile()&&n.name.endsWith(".json")).map(n=>a.join(f,n.name)).sort()}catch(n){if(_(n))continue;throw n}for(const n of c){const r=a.basename(n,".json");if(!/^[a-z0-9][a-z0-9-]{0,63}$/u.test(r))throw u(r);const t=M({[r]:await P(n,b.mcpConfigBytes)})[r];if(t===void 0)throw u(r);const l=v(s.name,r);if(e[l]!==void 0)throw u(l);e[l]=t,i.push({pluginName:s.name,sourceName:r,qualifiedName:l})}}return{config:e,contributions:i}}function v(o,e){const i=o.replace(/^@/u,"").replace("/","_"),s=`plugin_${i}_${e}`;if(s.length<=64)return s;const c=`_${y("sha256").update(`${o}\0${e}`).digest("hex").slice(0,12)}_${e.slice(0,8)}`,n=Math.max(1,57-c.length);return`plugin_${i.slice(0,n)}${c}`}function U(...o){try{return w(...o)}catch(e){if(e instanceof p&&e.code===d.MCP_CONFIG_INVALID){const i=e.message.replace(/^Invalid MCP configuration: /u,"");throw u(i.replace(/\.$/u,"").replace(/^MCP server is defined more than once: /u,""))}throw e}}function u(o){return new p(d.MCP_CONFIG_INVALID,`Multiple MCP contributions define server: ${o}`,{category:"extension",userMessage:`MCP server \`${o}\` is defined more than once. Rename or remove one contribution.`})}export{G as PluginContributionRegistry,j as loadPluginMcpConfig,U as mergeMcpConfigContributions};