@lotagate/cli 0.1.23 → 0.1.25

package/dist/application/agent/tool-catalog.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from '@lotagate/sdk';
+import type { ToolExecutor } from '@lotagate/agent-sdk';
+export interface CliToolCatalog {
+    readonly definitions: readonly ToolDefinition[];
+    readonly names: readonly string[];
+    readonly details: readonly {
+        name: string;
+        description: string;
+    }[];
+}
+/** Builds one authoritative capability view from the executors registered by CLI. */
+export declare function buildToolCatalog(executors: readonly ToolExecutor[]): CliToolCatalog;
+/** Creates a stable capability catalog from CLI-owned tool definitions. */
+export declare function buildToolCatalogFromDefinitions(definitions: readonly ToolDefinition[]): CliToolCatalog;

package/dist/application/agent/tool-catalog.js

@@ -0,0 +1 @@
+function c(n){return a(n.flatMap(e=>[...e.listTools()]))}function a(n){const e=new Map;for(const t of n){const o=s(t);o===void 0||e.has(o)||e.set(o,{name:o,description:u(t)})}const r=[...e.values()].sort((t,o)=>t.name.localeCompare(o.name));return{definitions:n,names:r.map(t=>t.name),details:r}}function s(n){if("function"in n&&typeof n.function.name=="string")return n.function.name;if("name"in n&&typeof n.name=="string")return n.name}function u(n){return"function"in n&&typeof n.function.description=="string"?n.function.description:"description"in n&&typeof n.description=="string"?n.description:"Host-provided tool."}export{c as buildToolCatalog,a as buildToolCatalogFromDefinitions};

package/dist/application/agent/tool-display.d.ts

@@ -0,0 +1,7 @@
+/** Converts internal tool identifiers into safe, human-readable activity text. */
+export declare function formatToolActivityName(toolName: string): string;
+/** Returns the MCP category plus the human-readable final tool name. */
+export declare function formatMcpActivityName(toolName: string): string;
+/** Formats the effective command while hiding a platform shell wrapper. */
+export declare function formatShellCommandForDisplay(command: string, args: readonly string[], maximum?: number): string;
+export declare function formatFilesystemActivityName(toolName: string, path: unknown, maximum?: number): string;

package/dist/application/agent/tool-display.js

@@ -0,0 +1 @@
+function l(t){if(!t.startsWith("mcp__"))return t;const e=t.lastIndexOf("__");return e<5||e===t.length-2?t:o(t.slice(e+2))}function a(t){return`MCP ${l(t)}`}function d(t,e,s=180){const i=f(t,e),n=p(t)&&i.length===1?h(i[0]??""):h(i.map(r=>/\s/u.test(r)?JSON.stringify(r):r).join(" "));return n.length<=s?n:`${n.slice(0,Math.max(0,s-3))}...`}function w(t,e,s=180){const i=typeof e=="string"&&e.trim().length>0?e.trim():".",n=i==="."?"workspace":i,r=t==="filesystem.read"?"Read file":t==="filesystem.write"?"Write file":t==="filesystem.list"?"List":t==="filesystem.exists"?"Check file":l(t);if(t!=="filesystem.read"&&t!=="filesystem.write")return`${r} ${n}${t==="filesystem.list"&&n!=="workspace"&&!n.endsWith("/")?"/":""}`;const c=`${r} ${n}`;return c.length<=s?c:`${c.slice(0,Math.max(0,s-3))}...`}function f(t,e){const s=t.replace(/^.*[\\/]/u,"").toLowerCase();if(s==="cmd"||s==="cmd.exe"){const i=e.findIndex(r=>/^\/(?:c|k)$/iu.test(r)),n=i<0?e:e.slice(i+1);if(n.length>0)return u(n)}if(s==="powershell"||s==="powershell.exe"||s==="pwsh"||s==="pwsh.exe"||s==="sh"||s==="bash"||s==="zsh"){const i=e.findIndex(r=>/^(?:-c|--command)$/iu.test(r)),n=i<0?e:e.slice(i+1);if(n.length>0)return u(n)}return[t,...e]}function p(t){const e=t.replace(/^.*[\\/]/u,"").toLowerCase();return e==="cmd"||e==="cmd.exe"||e==="powershell"||e==="powershell.exe"||e==="pwsh"||e==="pwsh.exe"||e==="sh"||e==="bash"||e==="zsh"}function u(t){if(t.length!==1)return t;const e=t[0]??"";return e.length>=2&&(e.startsWith('"')&&e.endsWith('"')||e.startsWith("'")&&e.endsWith("'"))?[e.slice(1,-1)]:t}function h(t){return t.replace(/Bearer\s+[^\s]+/giu,"Bearer [REDACTED]").replace(/sk-[A-Za-z0-9_-]{8,}/gu,"[REDACTED]")}function o(t){return t.split(/[_-]+/u).filter(Boolean).map(e=>`${e.slice(0,1).toUpperCase()}${e.slice(1)}`).join(" ")}export{w as formatFilesystemActivityName,a as formatMcpActivityName,d as formatShellCommandForDisplay,l as formatToolActivityName};

package/dist/application/agent/tool-hook-lifecycle.d.ts

@@ -0,0 +1,19 @@
+import type { AgentEvent, ToolExecutionContext } from '@lotagate/agent-sdk';
+import type { HookDefinition } from '../../domain/extensions/hook-manifest.js';
+export interface ToolHookRunner {
+    runEvent(hooks: readonly HookDefinition[], event: 'tool.before' | 'tool.after', context: ToolExecutionContext): Promise<number>;
+}
+export interface ToolHookLifecycleOptions {
+    runner: ToolHookRunner;
+    hooks: readonly HookDefinition[];
+    cwd: string;
+    workspaceRoot: string;
+    sessionId?: string;
+    signal?: AbortSignal;
+    maxResultBytes: number;
+}
+/**
+ * Applies CLI-owned tool lifecycle hooks at the Agent SDK event boundary.
+ * Keeping this adapter outside the SDK also covers both local and MCP tools.
+ */
+export declare function runWithToolHooks(events: AsyncIterable<AgentEvent>, options: ToolHookLifecycleOptions): AsyncIterable<AgentEvent>;

package/dist/application/agent/tool-hook-lifecycle.js

@@ -0,0 +1 @@
+async function*l(e,r){if(r.hooks.length===0){yield*e;return}let o=r.sessionId;const n=new Map;for await(const t of e){if(t.type==="session.started"){o=t.sessionId,yield t;continue}if(t.type==="tool.called"){const d=a(t,r,o),u=s(t.runId,t.toolName);n.set(u,[...n.get(u)??[],d]),await r.runner.runEvent(r.hooks,"tool.before",d),yield t;continue}if(t.type==="tool.completed"){const d=s(t.runId,t.toolName),u=i(n,d)??c(t,r,o);await r.runner.runEvent(r.hooks,"tool.after",u),yield t;continue}yield t}}function a(e,r,o){return{sessionId:o??e.runId,runId:e.runId,iteration:e.iteration,...r.signal===void 0?{}:{signal:r.signal},cwd:r.cwd,workspaceRoot:r.workspaceRoot,maxResultBytes:r.maxResultBytes,metadata:{toolName:e.toolName,parentRunId:e.runId,...e.source===void 0?{}:{source:e.source},...e.executorId===void 0?{}:{executorId:e.executorId},...e.serverId===void 0?{}:{serverId:e.serverId}}}}function c(e,r,o){return{sessionId:o??e.runId,runId:e.runId,iteration:0,...r.signal===void 0?{}:{signal:r.signal},cwd:r.cwd,workspaceRoot:r.workspaceRoot,maxResultBytes:r.maxResultBytes,metadata:{toolName:e.toolName,parentRunId:e.runId,...e.source===void 0?{}:{source:e.source},...e.executorId===void 0?{}:{executorId:e.executorId},...e.serverId===void 0?{}:{serverId:e.serverId},isError:e.isError}}}function i(e,r){const o=e.get(r);if(o===void 0||o.length===0)return;const[n,...t]=o;return t.length===0?e.delete(r):e.set(r,t),n}function s(e,r){return`${e}:${r}`}export{l as runWithToolHooks};

package/dist/application/auth/authentication-service.d.ts

@@ -0,0 +1,20 @@
+import { type AuthProfile } from '../../domain/auth/auth-profile.js';
+import type { CredentialStore } from '../../ports/credential-store.js';
+export interface LoginInput {
+    profileName: string;
+    baseUrl: string;
+    apiKey: string;
+}
+export declare class AuthenticationService {
+    private readonly store;
+    constructor(store: CredentialStore);
+    login(input: LoginInput): Promise<AuthProfile>;
+    requireCredential(profileName: string): Promise<{
+        profile: AuthProfile;
+        apiKey: string;
+    }>;
+    logout(profileName: string): Promise<boolean>;
+    list(): Promise<readonly AuthProfile[]>;
+    status(profileName: string): Promise<AuthProfile | undefined>;
+    static defaultProfileName(): string;
+}

package/dist/application/auth/authentication-service.js

@@ -0,0 +1 @@
+import{validateApiKey as i,validateBaseUrl as s,validateProfileName as r}from"../../domain/auth/auth-profile.js";import{CliError as n}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as l}from"../../domain/errors/error-codes.js";import{AUTH_LOGIN_HINT as c}from"../commands/command-hints.js";class p{store;constructor(t){this.store=t}async login(t){const e=r(t.profileName),o=new Date().toISOString(),a={name:e,baseUrl:s(t.baseUrl),credentialRef:`file:${e}`,createdAt:o,updatedAt:o};return await this.store.set({profile:a,apiKey:i(t.apiKey)}),a}async requireCredential(t){const e=await this.store.get(t);if(e===void 0)throw new n(l.AUTH_PROFILE_NOT_FOUND,`Profile not found: ${t}`,{category:"auth",userMessage:`Auth profile \`${t}\` was not found.`,hint:c});return e}async logout(t){return this.store.delete(r(t))}async list(){return this.store.list()}async status(t){return(await this.store.get(r(t)))?.profile}static defaultProfileName(){return process.env.LOTAGATE_PROFILE?.trim()||"default"}}export{p as AuthenticationService};

package/dist/application/chat/chat-service.d.ts

@@ -0,0 +1,12 @@
+import type { ChatModelEvent, ChatModelPort } from '../../ports/chat-model.js';
+import type { AttachmentPayload } from '../../domain/session/attachment.js';
+export interface ChatStreamOptions {
+    reasoningEffort?: string;
+    signal?: AbortSignal;
+    attachments?: readonly AttachmentPayload[];
+}
+export declare class ChatService {
+    private readonly model;
+    constructor(model: ChatModelPort);
+    stream(modelName: string, prompt: string, options?: ChatStreamOptions): AsyncIterable<ChatModelEvent>;
+}

package/dist/application/chat/chat-service.js

@@ -0,0 +1 @@
+import{AssistantDeltaNormalizer as s}from"../../domain/runtime/assistant-delta-normalizer.js";class c{model;constructor(t){this.model=t}async*stream(t,r,e={}){const i=new s;for await(const n of this.model.stream({model:t,prompt:r,...e.reasoningEffort===void 0?{}:{reasoningEffort:e.reasoningEffort},...e.signal===void 0?{}:{signal:e.signal},...e.attachments===void 0?{}:{attachments:e.attachments}})){if(n.type!=="delta"){yield n;continue}const a=i.normalize(n.content);a.length>0&&(yield{type:"delta",content:a})}}}export{c as ChatService};

package/dist/application/chat/pending-attachment-store.d.ts

@@ -0,0 +1,12 @@
+import type { AttachmentPayload } from '../../domain/session/attachment.js';
+export declare class PendingAttachmentStore {
+    private readonly items;
+    private sequence;
+    list(): readonly AttachmentPayload[];
+    get size(): number;
+    nextId(prefix?: string): string;
+    assertCanAdd(byteLength: number): void;
+    add(payload: AttachmentPayload): void;
+    remove(id: string): boolean;
+    clear(): void;
+}

package/dist/application/chat/pending-attachment-store.js

@@ -0,0 +1 @@
+import{CliError as r}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as m}from"../../domain/errors/error-codes.js";import{RESOURCE_LIMITS as i}from"../../domain/runtime/resource-limits.js";class d{items=[];sequence=0;list(){return this.items}get size(){return this.items.length}nextId(e="image"){return this.sequence+=1,`${e}-${this.sequence}`}assertCanAdd(e){const t=this.items.reduce((s,n)=>s+n.bytes.byteLength,0);if(this.items.length>=i.pendingAttachments||t+e>i.pendingAttachmentTotalBytes)throw new r(m.ATTACHMENT_TOO_LARGE,"Pending attachment limits exceeded.",{category:"attachment",userMessage:"Too many or too-large attachments are pending. Remove an attachment and retry."})}add(e){this.assertCanAdd(e.bytes.byteLength),this.items.push(e)}remove(e){const t=this.items.findIndex(({attachment:s})=>s.id===e);return t<0?!1:(this.items.splice(t,1),!0)}clear(){this.items.splice(0,this.items.length)}}export{d as PendingAttachmentStore};

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

@@ -0,0 +1,23 @@
+import type { Readable, Writable } from 'node:stream';
+import type { CliRuntime } from '../../bootstrap/runtime-factory.js';
+import type { CommandInvocation } from './command-contract.js';
+import type { CommandOutput } from './command-output.js';
+import { type CommandActivityObserver } from './media-command-handlers.js';
+import type { ExtensionScope } from '../../domain/extensions/extension-scope.js';
+export interface ApplicationCommandHost {
+    readonly runtime: CliRuntime;
+    readonly cwd: string;
+    readonly output: CommandOutput;
+    readonly secrets?: Readonly<{
+        apiKey?: string;
+    }>;
+    readonly stdin?: Readable;
+    readonly writableOutput?: Writable;
+    readonly selectScope?: (title: string) => Promise<ExtensionScope | undefined>;
+    readonly resumeInteractive?: (sessionId: string) => Promise<number>;
+    readonly activity?: CommandActivityObserver;
+    readonly signal?: AbortSignal;
+}
+export declare function executeApplicationCommand(invocation: CommandInvocation, host: ApplicationCommandHost): Promise<number>;
+/** Runs commands that do not require a runtime or any persistent CLI state. */
+export declare function executeInformationalCommand(invocation: CommandInvocation, output: CommandOutput): number | undefined;

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

@@ -0,0 +1,3 @@
+import{runAgentCommand as a}from"../protocol/jsonl-agent-command.js";import{runAuthCommand as t,runConfigCommand as o,runEffortCommand as m,runHookCommand as d,runMcpCommand as c,runModelCommand as l,runPluginCommand as p,runSkillCommand as s,runTrustCommand as f}from"./cli-command-services.js";import{formatCommandHelp as w}from"./command-presentation.js";import{COMMAND_REGISTRY as C}from"./command-runtime.js";import{runGoalCommand as y}from"./goal-command-handlers.js";import{runChatCommand as P,runExecCommand as g,runSessionCommand as x}from"./runtime-command-handlers.js";import{runMediaCommand as E}from"./media-command-handlers.js";import{runCompletionsCommand as S,runDoctorCommand as I,runInspectCommand as O,runUpdateCommand as b}from"./utility-commands.js";import{runMemoryCommand as M}from"./memory-command-handler.js";import{CLI_VERSION as $}from"../../version.js";const k={help:async(r,n)=>i(r,n.output),version:async(r,n)=>i(r,n.output),config:async(r,n)=>o(r.handlerPositionals,n.runtime.configLoader,n.cwd,n.output),auth:async(r,n)=>t(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,n.secrets?.apiKey),trust:async(r,n)=>f(r.handlerPositionals,n.runtime,n.cwd,n.output),inspect:async(r,n)=>O(n.runtime,n.cwd,n.output),hook:async(r,n)=>d(r.handlerPositionals,n.runtime,n.cwd,n.output),model:async(r,n)=>l(r.handlerPositionals,n.runtime,n.cwd,n.output),effort:async(r,n)=>m(r.handlerPositionals,n.runtime,n.cwd,n.output),mcp:async(r,n)=>c(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,u(n),n.signal),plugin:async(r,n)=>p(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,u(n),n.signal),skill:async(r,n)=>s(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,u(n),n.signal),session:async(r,n)=>x(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,n.resumeInteractive,n.signal),goal:async(r,n)=>{if(n.writableOutput===void 0)throw new Error("Goal commands require a writable terminal output.");return y(r.handlerPositionals,r.options,n.runtime,n.cwd,n.writableOutput,n.signal)},memory:async(r,n)=>M(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output),doctor:async(r,n)=>I(n.runtime,n.cwd,n.output),chat:async(r,n)=>P(r.handlerPositionals,n.runtime,n.cwd,n.output,n.signal),exec:async(r,n)=>g(r.handlerPositionals,r.options,n.runtime,n.cwd,n.output,n.signal),media:async(r,n)=>E(r,n.runtime,n.cwd,n.output,n.activity,n.signal),agent:async(r,n)=>{if(n.stdin===void 0||n.writableOutput===void 0)throw new Error("The JSONL agent protocol requires stdin and a writable terminal output.");return a(r.handlerPositionals,n.runtime,n.cwd,n.stdin,n.writableOutput)},completions:async(r,n)=>S(r.handlerPositionals,n.output),update:async(r,n)=>b(r.handlerPositionals,n.runtime,n.cwd,n.output)};async function J(r,n){const e=k[r.action.executor];if(e===void 0)throw new Error(`Command ${r.action.id} requires a ${r.surface}-specific executor.`);return e(r,n)}function q(r,n){if(r.action.executor==="help")return n.write(`${w(C,r.surface)}
+`),0;if(r.action.executor==="version")return n.write(`${$}
+`),0}function i(r,n){const e=q(r,n);if(e===void 0)throw new Error(`Command ${r.action.id} is not informational.`);return e}function u(r){return r.selectScope===void 0?{}:{selectScope:r.selectScope}}export{J as executeApplicationCommand,q as executeInformationalCommand};

package/dist/application/commands/cli-args.d.ts

@@ -0,0 +1,6 @@
+export declare function getFlag(flags: ReadonlyMap<string, string | boolean>, name: string): string | boolean | undefined;
+export declare function isFlagEnabled(flags: ReadonlyMap<string, string | boolean>, name: string): boolean;
+export declare function getStringFlag(flags: ReadonlyMap<string, string | boolean>, name: string): string | undefined;
+export declare function requireStringFlag(flags: ReadonlyMap<string, string | boolean>, name: string): string;
+export declare function getPositiveIntegerFlag(flags: ReadonlyMap<string, string | boolean>, name: string, maximum: number): number | undefined;
+export declare function requirePositional(positionals: readonly string[], index: number, label: string): string;

package/dist/application/commands/cli-args.js

@@ -0,0 +1 @@
+import{CliError as u}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as o}from"../../domain/errors/error-codes.js";function s(r,e){return r.get(e)}function d(r,e){const t=r.get(e);return t===!0||t==="true"}function g(r,e){const t=s(r,e);return typeof t=="string"&&t.trim().length>0?t.trim():void 0}function c(r,e){const t=g(r,e);if(t===void 0)throw new u(o.MISSING_ARGUMENT,`Missing --${e}.`,{category:"arguments",userMessage:`Missing required option --${e}.`});return t}function l(r,e,t){const n=s(r,e);if(n===void 0)return;const i=typeof n=="string"&&/^\d+$/u.test(n)?Number(n):Number.NaN;if(!Number.isSafeInteger(i)||i<=0||i>t)throw new u(o.INVALID_ARGUMENT,`Invalid --${e}.`,{category:"arguments",userMessage:`--${e} must be a positive integer no greater than ${t}.`});return i}function p(r,e,t){const n=r[e];if(n===void 0||n.trim().length===0)throw new u(o.MISSING_ARGUMENT,`Missing ${t}.`,{category:"arguments",userMessage:`Missing required argument: ${t}.`});return n}export{s as getFlag,l as getPositiveIntegerFlag,g as getStringFlag,d as isFlagEnabled,p as requirePositional,c as requireStringFlag};

package/dist/application/commands/cli-command-services.d.ts

@@ -0,0 +1,17 @@
+import { type ExtensionScope } from '../../domain/extensions/extension-scope.js';
+import type { ConfigLoader } from '../../infrastructure/config/config-loader.js';
+import type { createCompositionRoot } from '../../bootstrap/composition-root.js';
+import type { CommandOutput } from './command-output.js';
+export type CliRuntime = ReturnType<typeof createCompositionRoot>;
+export interface CommandInteraction {
+    selectScope?: (title: string) => Promise<ExtensionScope | undefined>;
+}
+export declare function runConfigCommand(positionals: readonly string[], loader: ConfigLoader, cwd: string, output: CommandOutput): Promise<number>;
+export declare function runAuthCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, output: CommandOutput, desktopApiKey?: string): Promise<number>;
+export declare function runTrustCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, output: CommandOutput): Promise<number>;
+export declare function runModelCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, output: CommandOutput): Promise<number>;
+export declare function runEffortCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, output: CommandOutput): Promise<number>;
+export declare function runMcpCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, output: CommandOutput, interaction?: CommandInteraction, signal?: AbortSignal): Promise<number>;
+export declare function runPluginCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, output: CommandOutput, interaction?: CommandInteraction, signal?: AbortSignal): Promise<number>;
+export declare function runSkillCommand(positionals: readonly string[], flags: ReadonlyMap<string, string | boolean>, runtime: CliRuntime, cwd: string, output: CommandOutput, interaction?: CommandInteraction, signal?: AbortSignal): Promise<number>;
+export declare function runHookCommand(positionals: readonly string[], runtime: CliRuntime, cwd: string, output: CommandOutput): Promise<number>;

package/dist/application/commands/cli-command-services.js

@@ -0,0 +1,33 @@
+import j from"node:path";import{AuthenticationService as D}from"../auth/authentication-service.js";import{CONFIGURABLE_KEYS as V,DEFAULT_CONFIG as B,REASONING_EFFORTS as H}from"../../domain/config/config-schema.js";import{requirePositional as S,getFlag as $,requireStringFlag as _}from"./cli-args.js";import{readSecret as Y}from"../../infrastructure/credentials/secret-input.js";import{getModelContextWindow as z}from"../../infrastructure/sdk/model-catalog-adapter.js";import{FileMcpConfigStore as F}from"../../infrastructure/extensions/file-mcp-config-store.js";import{McpRuntime as Q}from"../../infrastructure/extensions/mcp-runtime.js";import{PluginManager as G}from"../../infrastructure/extensions/plugin-manager.js";import{SkillManager as X}from"../../infrastructure/extensions/skill-manager.js";import{SkillInstaller as Z}from"../../infrastructure/extensions/skill-installer.js";import{resolveExtensionSource as ee}from"../../infrastructure/extensions/extension-source-resolver.js";import{resolveSkillRootScopes as te}from"../../infrastructure/extensions/skill-roots.js";import{CompositeMcpConfigStore as oe}from"../../infrastructure/extensions/composite-mcp-config-store.js";import{PluginContributionRegistry as x}from"../extensions/plugin-contribution-registry.js";import{parseExtensionScope as ne,requireExtensionScope as re}from"../../domain/extensions/extension-scope.js";import{CliError as P}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as C}from"../../domain/errors/error-codes.js";import{createHookListResult as J,createMcpListResult as ie,createPluginListResult as ae,createSkillListResult as se,formatExtensionList as v}from"../extensions/extension-list-formatters.js";import{writeExtensionListResult as E}from"../extensions/extension-list-output.js";import{HookRuntime as le}from"../../infrastructure/extensions/hook-runtime.js";import{ShellToolExecutor as ce}from"../../infrastructure/shell/shell-tool-executor.js";import{ToolPolicy as fe}from"@lotagate/agent-sdk";import{formatMcpDetails as de}from"../extensions/extension-list-formatters.js";import{loadExecutionConfig as W}from"../config/execution-config.js";import{redactLogText as K}from"../../infrastructure/logging/log-redactor.js";import{formatCompactTable as R}from"../formatting/compact-table.js";import{formatCompactNumber as pe}from"../formatting/compact-number.js";import{loadModelCatalog as ue}from"../model/model-catalog-service.js";import{describeInstalledPlugin as ge}from"../extensions/plugin-detail-service.js";import{throwIfCommandAborted as w}from"./command-cancellation.js";const we={empty:"No models are available.",maxWidth:160,columns:[{key:"name",header:"Name",width:52,minWidth:16},{key:"category",header:"Model category",width:16,minWidth:8},{key:"contextWindow",header:"Context window",width:14,minWidth:8},{key:"status",header:"Status",width:12,minWidth:6},{key:"detail",header:"Detail",minWidth:6}]};async function ze(s,r,e,o){const t=s[0]??"get";if(t==="path")return o.write(`${JSON.stringify({global:r.platformPaths.globalConfigFile,project:j.join(e,".lotagate")},null,2)}
+`),0;if(t==="get"){const l=await r.load(e),n=s[1];return o.write(`${JSON.stringify(n===void 0?l.config:l.config[n]??null,null,2)}
+`),0}if(t==="set"){const l=S(s,1,"config key");if(!V.includes(l))throw new P(C.INVALID_ARGUMENT,`Unsupported config key: ${l}`,{category:"arguments",userMessage:`Unsupported configuration key: ${l}.`});return await r.setGlobal(l,ye(S(s,2,"config value"))),0}throw new Error(`Unsupported config action: ${t}`)}async function Qe(s,r,e,o,t,l){const n=s[0]??"status",p=await e.configLoader.load(o,{includeProject:!1}),g=p.config.profile??D.defaultProfileName();if(n==="login"){const i=String($(r,"profile")??g),a=String($(r,"base-url")??p.config.baseUrl??B.baseUrl),d=await e.auth.login({profileName:i,baseUrl:a,apiKey:l??await Y("LotaGate API key: ")});return await e.configLoader.setGlobal("profile",d.name),t.write(`Logged in profile: ${d.name}
+`),0}if(n==="list"){const i=await e.auth.list();return t.write(`${R(i.map(a=>({name:a.name,status:a.name===g?"ACTIVE":"READY",detail:K(a.baseUrl)})),{empty:"No authentication profiles."})}
+`),0}if(n==="status"){const i=await e.credentialStore.get(g);return t.write(`${JSON.stringify(i===void 0?{authenticated:!1,profile:g}:{authenticated:!0,profile:i.profile.name,baseUrl:i.profile.baseUrl,credentialRef:i.profile.credentialRef},null,2)}
+`),0}if(n==="logout"){const i=s[1]??g,a=await e.auth.logout(i);return t.write(`${a?`Logged out profile: ${i}`:`Profile not found: ${i}`}
+`),a?0:1}if(n==="use"){const i=S(s,1,"profile name");return await e.auth.requireCredential(i),await e.configLoader.setGlobal("profile",i),t.write(`Active profile: ${i}
+`),0}throw new Error(`Unsupported auth action: ${n}`)}async function Xe(s,r,e,o){const t=s[0]??"status";if(t==="list")return o.write(`${R((await r.projectTrust.list()).map(n=>({name:n.canonicalPath,status:"TRUSTED",detail:n.fingerprint})),{empty:"No trusted projects."})}
+`),0;const l=await r.projectTrust.inspect(e);if(t==="status")return o.write(`${JSON.stringify({...l,trusted:await r.projectTrust.isTrusted(l)},null,2)}
+`),0;if(t==="grant")return await r.projectTrust.grant(l),await r.workspaceSettings.ensureInitialized(l.canonicalPath),o.write(`Trusted project: ${l.canonicalPath}
+`),0;if(t==="revoke"){const n=await r.projectTrust.revoke(l);return o.write(`${n?`Revoked project: ${l.canonicalPath}`:"Project was not trusted."}
+`),n?0:1}throw new Error(`Unsupported trust action: ${t}`)}async function Ze(s,r,e,o){const t=s[0]??"current",l=await W(r,e);if(t==="current")return o.write(`${JSON.stringify({model:l.config.model,profile:l.config.profile},null,2)}
+`),0;if(t==="use"){const n=S(s,1,"model id");return await r.configLoader.setGlobal("model",n),o.write(`Active model: ${n}
+`),0}if(t==="list"||t==="refresh"){const n=await ue(r,e,t==="refresh");return o.write(`${R(n.data.map(p=>({name:typeof p.display_name=="string"?p.display_name:p.id,status:p.id===l.config.model?"ACTIVE":"AVAILABLE",...typeof p.owned_by=="string"?{detail:p.owned_by}:{},values:{category:typeof p.model_category=="string"?p.model_category:"-",contextWindow:me(p)}})),we)}
+`),0}if(t==="doctor"){const n=l.config.profile??D.defaultProfileName(),p=await r.auth.status(n);return o.write(`${JSON.stringify({profile:n,authenticated:p!==void 0,model:l.config.model,baseUrl:p?.baseUrl??l.config.baseUrl},null,2)}
+`),0}throw new Error(`Unsupported model action: ${t}`)}async function et(s,r,e,o){const t=s[0]??"current",l=await W(r,e);if(t==="current")return o.write(`${JSON.stringify({effort:l.config.effort},null,2)}
+`),0;if(t==="use"){const n=S(s,1,"effort");if(!H.includes(n))throw new Error(`Unsupported reasoning effort: ${n}`);return await r.configLoader.setGlobal("effort",n),o.write(`Active effort: ${n}
+`),0}throw new Error(`Unsupported effort action: ${t}`)}function me(s){const r=z(s);return r===void 0?"-":pe(r)}async function tt(s,r,e,o,t,l={},n){w(n);const p=F.forScope(o,e.paths.globalConfigDir,"project"),g=F.forScope(o,e.paths.globalConfigDir,"user"),i=s[0]??"list";if(i==="list"){const c=await e.projectTrust.inspect(o),h=await e.projectTrust.isTrusted(c),f=await new x(e.paths.globalConfigDir).resolve(o,h),m=ie([{scope:"user",config:await g.list()},{scope:"project",config:await p.list()},...h&&Object.keys(f.mcpConfig).length>0?[{scope:"plugin",config:f.mcpConfig,sourceNames:Object.fromEntries(f.mcpContributions.map(b=>[b.qualifiedName,b.sourceName])),pluginNames:Object.fromEntries(f.mcpContributions.map(b=>[b.qualifiedName,b.pluginName]))}]:[]]);return E(t,m,v(m)),0}if(i==="reload"||i==="doctor"){w(n),i==="reload"&&await e.mcpRuntime.invalidate(o);const c=new Q(()=>new oe([g,p]));try{const h=await e.projectTrust.inspect(o),f=await c.connectConfigured(o,await e.projectTrust.isTrusted(h));return w(n),t.write(`${R(f.map(({serverId:m,status:b,protocolEra:T,protocolVersion:N,error:M})=>({name:m,status:b==="connected"?"OK":b.toUpperCase(),detail:M===void 0?[T,N].filter(Boolean).join(" \xB7 "):K(M.message)})),{empty:"No MCP servers configured."})}
+`),f.some(m=>m.status==="failed")?1:0}finally{await c.close()}}const a=S(s,1,"MCP server name"),d=await U(r,l,"MCP server scope",!0);if(d===void 0)throw new Error("MCP server scope was not selected.");const u={store:d==="project"?p:g,scope:d},y=u.store;if(i==="get"){const c=await y.get(a);return t.write(`${de(a,u.scope,c)}
+`),0}if(i==="remove"){w(n),await k(e,o,u.scope);const c=await y.remove(a);return c&&await e.mcpRuntime.invalidate(o),e.logger.info("MCP server removal completed.",{name:a,scope:u.scope,removed:c}),t.write(`${c?`Removed MCP server: ${a}`:`MCP server not found: ${a}`}
+`),c?0:1}if(i==="enable"||i==="disable")return w(n),await k(e,o,u.scope),await y.setEnabled(a,i==="enable"),await e.mcpRuntime.invalidate(o),e.logger.info("MCP server state changed.",{name:a,scope:u.scope,enabled:i==="enable"}),t.write(`${i==="enable"?"Enabled":"Disabled"} MCP server: ${a}
+`),0;if(i==="add"){w(n),await k(e,o,d??"project");const c=String($(r,"type")??"stdio");if(c==="stdio"){const h=_(r,"command"),f=$(r,"args");await y.add(a,{type:"stdio",command:h,...typeof f=="string"?{args:f.split(",").map(m=>m.trim()).filter(Boolean)}:{}})}else if(c==="http"||c==="sse")await y.add(a,{type:c,url:_(r,"url")});else throw new P(C.INVALID_ARGUMENT,`Unsupported MCP type: ${c}`,{category:"arguments",userMessage:"MCP type must be stdio, http, or sse."});return w(n),await e.mcpRuntime.invalidate(o),e.logger.info("MCP server added.",{name:a,scope:d??"project",type:c}),t.write(`Added MCP server successfully: ${a}
+`),0}throw new Error(`Unsupported MCP action: ${i}`)}async function ot(s,r,e,o,t,l={},n){w(n);const p=new G(e.paths.pluginsDir),g=new G(j.join(j.resolve(o),".lotagate","plugins")),i=s[0]??"list";if(i==="list"){const f=ae([{scope:"user",plugins:await p.list(void 0,{verifyIntegrity:!1})},{scope:"project",plugins:await g.list(void 0,{verifyIntegrity:!1})}]);return E(t,f,v(f)),0}if(i==="install"){const f=S(s,1,"plugin or skill source"),m=await U(r,l,"Plugin installation scope",!0);if(m===void 0)throw new Error("Plugin installation scope was not selected.");await k(e,o,m);const b=$(r,"sha256"),T=$(r,"signature"),N=$(r,"public-key"),M=m==="project"?g:p,q=m==="project"?j.join(j.resolve(o),".lotagate","skills"):e.paths.skillsDir,O=await ee(f,e.platform,n);try{w(n);const A={...typeof b=="string"?{sha256:b}:{},...typeof T=="string"?{signature:T}:{},...typeof N=="string"?{publicKeyPem:N}:{}},L=await new Z().install(O.directory,q,A);if(L!==void 0)return w(n),e.logger.info("Skill installed.",{name:L.manifest.name,scope:m}),t.write(`Added skill successfully: ${L.manifest.name}
+`),0;const I=await M.install(O.directory,A);return w(n),e.logger.info("Plugin installed.",{name:I.manifest.name,scope:m}),t.write(`Added plugin successfully: ${I.manifest.name}
+`),0}finally{await O.cleanup()}}const a=S(s,1,"plugin name"),d=await U(r,l,"Plugin scope",!0);if(d===void 0)throw new Error("Plugin scope was not selected.");const u={manager:d==="project"?g:p,scope:d},y=u.manager,h=(await y.list(void 0,{verifyIntegrity:!1})).find(f=>f.manifest.name===a);if(h===void 0)throw new P(C.PLUGIN_NOT_FOUND,`Plugin not found: ${a}`,{category:"extension",userMessage:`Plugin not found: ${a}.`});if(i==="info"){const f=await ge(h,d);return t.writeStructured===void 0?t.write(`${JSON.stringify(f,null,2)}
+`):t.writeStructured(f,`${JSON.stringify(f,null,2)}
+`),0}if(i==="enable"||i==="disable")return w(n),await k(e,o,u.scope),await y.setEnabled(a,i==="enable"),e.logger.info("Plugin state changed.",{name:a,scope:u.scope,enabled:i==="enable"}),t.write(`${i==="enable"?"Enabled":"Disabled"} plugin: ${a}
+`),0;if(i==="uninstall"){w(n),await k(e,o,u.scope);const f=await y.uninstall(a);return e.logger.info("Plugin uninstallation completed.",{name:a,scope:u.scope,removed:f}),t.write(`${f?`Uninstalled plugin: ${a}`:`Plugin not found: ${a}`}
+`),f?0:1}throw new Error(`Unsupported plugin action: ${i}`)}async function U(s,r,e,o){const t=ne($(s,"scope"));if(t!==void 0)return t;const l=r.selectScope===void 0?void 0:await r.selectScope(e);return l!==void 0?l:o?re(void 0):void 0}async function k(s,r,e){if(e!=="project")return;const o=await s.projectTrust.inspect(r);if(!await s.projectTrust.isTrusted(o))throw new P(C.PROJECT_TRUST_REQUIRED,"Project scope requires trust.",{category:"project",userMessage:"Trust the project before writing project-scoped extensions."})}async function nt(s,r,e,o,t,l={},n){w(n);const p=await e.projectTrust.inspect(o),g=await new x(e.paths.globalConfigDir).resolve(o,await e.projectTrust.isTrusted(p)),i=te(o,e.paths.globalConfigDir,g.skillRoots),a=new X(j.join(e.paths.globalConfigDir,"skills-state.json")),d=s[0]??"list";if(d==="list"){const f=se(await a.listScoped(i,{includeShadowed:!0}));return E(t,f,v(f)),0}const u=S(s,1,"skill name"),y=await U(r,l,"Skill scope",!0);if(y===void 0)throw new Error("Skill scope was not selected.");const c=(await a.listScoped(i,{includeShadowed:!0})).find(f=>f.skillKey===u&&f.scope===y);if(c===void 0)throw new P(C.SKILL_NOT_FOUND,`Skill not found: ${u}`,{category:"extension",userMessage:`Skill not found: ${u}.`});if(d==="remove"&&c.scope!=="user"&&c.scope!=="project")throw new P(C.INVALID_ARGUMENT,`Skill cannot be removed from the ${c.scope} scope: ${u}`,{category:"arguments",userMessage:"Only user- and project-scoped skills can be removed."});const h=c.scope==="project";if((d==="remove"||d==="enable"||d==="disable")&&await k(e,o,h?"project":"user"),d==="info")return t.write(`${JSON.stringify(he(c),null,2)}
+`),0;if(d==="enable"||d==="disable")return w(n),await a.setEnabled(c.skillKey,d==="enable",c.statePath),e.logger.info("Skill state changed.",{name:u,scope:c.scope,enabled:d==="enable"}),t.write(`${d==="enable"?"Enabled":"Disabled"} skill: ${u}
+`),0;if(d==="remove"){w(n);const f=await a.remove(c.skillKey,c.root,c.statePath);return e.logger.info("Skill removal completed.",{name:u,scope:c.scope,removed:f}),t.write(`${f?`Removed skill: ${u}`:`Skill not found: ${u}`}
+`),f?0:1}if(d==="run"){if(!c.enabled)throw new P(C.SKILL_NOT_FOUND,`Skill is disabled: ${u}`,{category:"extension",userMessage:`Skill is disabled: ${u}.`});return t.write(`${c.body}
+`),0}throw new Error(`Unsupported skill action: ${d}`)}async function rt(s,r,e,o){const t=s[0]??"list";if(t!=="list")throw new Error(`Unsupported hook action: ${t}`);const l=await r.projectTrust.inspect(e);if(!await r.projectTrust.isTrusted(l)){const a=J([]);return E(o,a,v(a)),0}const n=new le(new ce({platform:r.platform}),{trustedProject:!0,enabled:!0,toolPolicy:new fe}),p=await new x(r.paths.globalConfigDir).resolve(e,!0),g=[...await n.loadProject(l.canonicalPath)];for(const a of p.plugins)g.push(...await n.load(a));const i=J(g);return E(o,i,v(i)),0}function ye(s){return s==="true"?!0:s==="false"?!1:s==="null"?null:s}function he(s){const{root:r,statePath:e,...o}=s;return o}export{Qe as runAuthCommand,ze as runConfigCommand,et as runEffortCommand,rt as runHookCommand,tt as runMcpCommand,Ze as runModelCommand,ot as runPluginCommand,nt as runSkillCommand,Xe as runTrustCommand};

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

@@ -0,0 +1,6 @@
+/** Links a command-owned controller to the host lifecycle without leaking listeners. */
+export declare function createCommandAbortController(parent?: AbortSignal): {
+    controller: AbortController;
+    dispose: () => void;
+};
+export declare function throwIfCommandAborted(signal?: AbortSignal): void;

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

@@ -0,0 +1 @@
+function t(o){const e=new AbortController,r=()=>e.abort(o?.reason);return o?.aborted===!0?r():o?.addEventListener("abort",r,{once:!0}),{controller:e,dispose:()=>o?.removeEventListener("abort",r)}}function n(o){if(o?.aborted===!0)throw o.reason??new Error("Command cancelled.")}export{t as createCommandAbortController,n as throwIfCommandAborted};

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

@@ -0,0 +1,6 @@
+import type { CommandActionSpec } from './command-contract.js';
+/**
+ * Executable command contract for every public direct and slash command.
+ * Presentation layers consume this catalog; application handlers remain separate.
+ */
+export declare const COMMAND_ACTIONS: readonly CommandActionSpec[];

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:"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 E,requirePositional as _}from"./cli-args.js";import{ProjectSessionAccess as A}from"../session/project-session-access.js";import{AuthenticationService as D}from"../auth/authentication-service.js";import{loadExecutionConfig as L}from"../config/execution-config.js";import{createLotaGateClient as P}from"../../infrastructure/sdk/lotagate-client-factory.js";import{runHeadlessAgentTurn as x}from"../orchestration/headless-agent-turn.js";import{runGoalLoop as F}from"../orchestration/goal-runner.js";import{CliAgentSessionStore as q}from"../agent/agent-session-store.js";import{formatGoalStatus as $}from"../orchestration/goal-output.js";import{parseGoalInput as k}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 B,TRUST_GRANT_HINT as H}from"./command-hints.js";import{createTurnId as J,recordTurnCompletion as K,recordTurnFailure as Q,recordTurnStart as W}from"../session/session-turn-lifecycle.js";import{createCommandAbortController as z,throwIfCommandAborted as v}from"./command-cancellation.js";async function de(r,t,e,l,s,c){const i=r[0]??"status";if(i==="run")return O(r.slice(1).join(" ").trim(),t,e,l,s,void 0,c);v(c);const n=_(r,1,"session id"),d=await e.projectTrust.inspect(l);if(await new A(e.sessionStore).require(n,d.fingerprint),i==="status")return G(s,await e.goalStore.get(n),E(t,"json"));if(i==="set"){const u=_([r.slice(2).join(" ")],0,"goal objective"),w=await e.goalStore.replace(n,M(u,t));return G(s,w,E(t,"json"))}if(i==="pause"){const u=await e.goalStore.pause(n);return G(s,u,E(t,"json"))}if(i==="resume"){const u=await e.goalStore.get(n);if(u===void 0)throw new p(g.GOAL_NOT_FOUND,"Goal not found.",{category:"goal",userMessage:"Goal was not found."});return O(u.objective,t,e,l,s,n,c)}if(i==="clear")return await e.goalStore.clear(n),s.write(`Goal cleared.
+`),0;throw new Error(`Unsupported goal action: ${i}`)}async function O(r,t,e,l,s,c,i){if(v(i),r.length===0)throw new p(g.MISSING_ARGUMENT,"Missing goal objective.",{category:"arguments",userMessage:"A goal objective is required."});const n=await e.projectTrust.inspect(l);if(!await e.projectTrust.isTrusted(n))throw new p(g.PROJECT_TRUST_REQUIRED,"Project trust is required for goals.",{category:"project",userMessage:"Project is not trusted.",hint:H});const d=await L(e,l);if(d.config.model===null)throw new p(g.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:B});const u=d.config.model,w=d.config.profile??D.defaultProfileName(),y=await e.auth.requireCredential(w),a=c===void 0?await e.sessionStore.create({projectFingerprint:n.fingerprint,cwd:n.canonicalPath,model:d.config.model,profile:w,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,M(r,t)):await e.goalStore.resume(a.id);const N=P(y.profile,y.apiKey),U=new q,h=z(i),T=h.controller,j=()=>T.abort(new Error("Goal interrupted by user."));process.once("SIGINT",j);try{const f=await F({runtime:e,sessionId:a.id,objective:r,model:u,client:N,signal:T.signal,runTurn:async(I,m,b)=>{const S=J();await W(e.sessionStore,a.id,S,I);try{const o=await e.goalStore.get(a.id),C=await x({runtime:e,cwd:l,model:u,client:N,prompt:I,output:s,sessionId:a.id,agentSessionStore:U,signal:b,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 K(e.sessionStore,a.id,S,C),C}catch(o){throw m.onError(o),await Q(e.sessionStore,a.id,S,o,T.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 R=f?.status==="paused"&&f.lastError?.startsWith("Goal paused by safety limit:")===!0;return f?.status==="completed"||R?0:1}finally{process.off("SIGINT",j),h.dispose()}}function M(r,t){return k(r,t)}function G(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(`${$(t)}
+`),0)}export{de 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,8 @@
+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 I}from"../../domain/errors/cli-error.js";import{CLI_ERROR_CODES as S}from"../../domain/errors/error-codes.js";import{SDK_BINARY_MEDIA_RESPONSE_BYTES as E,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 _}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 k}from"./command-hints.js";import{writeMediaCommandResult as $}from"./media-command-output.js";import{getStringFlag as c,isFlagEnabled as D,requirePositional as G,requireStringFlag as O}from"./cli-args.js";async function _e(e,t,o,r,i,a){K(e.action.id,e.positionals,e.options);const n=a===void 0?new AbortController:void 0,m=a??n.signal,s=()=>n?.abort(new Error("Media command interrupted."));n!==void 0&&process.once("SIGINT",s);try{t.logger.info("Media command started.",{action:e.action.id});const d=await te(e,t,o,r,i,m);return t.logger.info("Media command completed.",{action:e.action.id,exitCode:d}),d}catch(d){const u=d instanceof I?{code:d.code,category:d.category,correlationId:d.correlationId}:{};throw t.logger.error("Media command failed.",{action:e.action.id,...u}),d}finally{n!==void 0&&process.off("SIGINT",s)}}async function te(e,t,o,r,i,a){const n=e.action.id;n!=="video.status"&&await t.projectTrust.requireTrusted(await t.projectTrust.inspect(o));const m=await R(t,o),s=m.config.profile??P.defaultProfileName(),d=await t.auth.requireCredential(s),u=new ee(X(d.profile,d.apiKey)),f=new Z(o,t.logger),p=Y();if(n==="video.status")return se(G(e.positionals,0,"operation id"),u,t.logger,r,i,a);if(n==="video.download")return ue(G(e.positionals,0,"operation id"),e.options,u,f,t.logger,r,i,a);const l=await oe(e.options,m.config.model,t,o);if(n==="image.generate")return ne(e.positionals,e.options,l,u,f,p.downloadTimeoutMs,r,i,a);if(n==="image.edit")return re(e.positionals,e.options,l,u,f,o,p.downloadTimeoutMs,r,i,a);if(n==="audio.speech")return ie(e.positionals,e.options,l,u,f,r,i,a);if(n==="audio.transcribe"||n==="audio.translate")return ae(n,e.options,l,u,f,o,r,i,a);if(n==="video.generate")return de(e.positionals,e.options,l,u,f,p,t,r,i,a);throw new Error(`Unsupported media command: ${n}`)}async function oe(e,t,o,r){const i=c(e,"model")??t;if(i==null)throw new I(S.MODEL_NOT_FOUND,"No model is selected.",{category:"model",userMessage:"No model is selected.",hint:k});if(!(await J(o,r)).data.some(n=>n.id===i))throw new I(S.MODEL_NOT_FOUND,`Model is not available: ${i}`,{category:"model",userMessage:`Model is not available: ${i}.`,hint:k});return i}async function ne(e,t,o,r,i,a,n,m,s){const d=v(e,"image"),u=await w(m,"image.generate","image generation",()=>r.generateImage({model:o,prompt:d,...j(t)},{signal:s})),p=(await w(m,"image.store","image download and save",()=>q(u,b("image",d,B(t),t),i,a,s))).map(l=>l.path);return $(n,{kind:"media",mediaType:"image",artifacts:p.map(l=>({path:l}))},M("Generated image",p)),0}async function re(e,t,o,r,i,a,n,m,s,d){const u=v(e,"image edit"),f=await W(O(t,"image"),c(t,"mask"),a),p=await w(s,"image.edit","image edit",()=>r.editImage({model:o,prompt:u,images:[...f.images],...f.mask===void 0?{}:{mask:f.mask},...j(t),...c(t,"input-fidelity")===void 0?{}:{inputFidelity:c(t,"input-fidelity")}},{signal:d})),g=(await w(s,"image.store","image download and save",()=>q(p,b("image",u,B(t),t),i,n,d))).map(y=>y.path);return $(m,{kind:"media",mediaType:"image",artifacts:g.map(y=>({path:y}))},M("Generated image",g)),0}async function ie(e,t,o,r,i,a,n,m){const s=v(e,"speech"),d=c(t,"response-format"),u=await w(n,"audio.speech","speech generation",()=>r.createSpeech({model:o,input:s,voice:O(t,"voice"),...c(t,"instructions")===void 0?{}:{instructions:c(t,"instructions")},...d===void 0?{}:{responseFormat:d},...N(t,"speed")===void 0?{}:{speed:N(t,"speed")}},{signal:m}));C(u.bytes);const f=d??A(u.contentType,"mp3"),l=(await w(n,"audio.store","speech save",()=>i.writeMany(b("speech",s,f,t),[u.bytes]))).map(g=>g.path);return $(a,{kind:"media",mediaType:"audio",artifacts:l.map(g=>({path:g}))},M("Generated speech",l)),0}async function ae(e,t,o,r,i,a,n,m,s){const d=await H(O(t,"file"),a),u=c(t,"response-format")??"json",f={model:o,file:d.bytes,filename:d.filename,responseFormat:u,...c(t,"prompt")===void 0?{}:{prompt:c(t,"prompt")},...N(t,"temperature")===void 0?{}:{temperature:N(t,"temperature")},...e==="audio.transcribe"&&c(t,"language")!==void 0?{language:c(t,"language")}:{},...e==="audio.transcribe"?L(t,"timestamp-granularities",["word","segment"]):{},...e==="audio.transcribe"?L(t,"include"):{}},p=await w(m,e,e==="audio.transcribe"?"audio transcription":"audio translation",()=>e==="audio.transcribe"?r.transcribe(f,{signal:s}):r.translate(f,{signal:s})),l=e==="audio.transcribe"?"transcription":"translation",g=await w(m,`${e}.store`,`${l} save`,()=>i.writeMany(b(l,d.sourceName,le(u),t),[Buffer.from(p,"utf8")]));return we(u)?n.write(`${p}
+Saved ${l}: ${g[0].path}
+`):n.write(M(`${ge(l)} result`,g.map(y=>y.path))),0}async function de(e,t,o,r,i,a,n,m,s,d){const u=v(e,"video"),f=pe(c(t,"parameters")),p=await w(s,"video.create","video generation request",()=>r.createVideo({model:o,prompt:u,...f===void 0?{}:{parameters:f}},{signal:d}));if(p.errorMessage!==void 0)throw V(p);if(n.logger.info("Video generation accepted.",{operationId:p.id,model:o}),m.write(`Video operation: ${p.id}
+`),D(t,"no-wait"))return 0;const l=p.done?p:await w(s,`video.wait:${p.id}`,"video generation",()=>U(r,p.id,a,d));if(l.errorMessage!==void 0)throw V(l);const g=await w(s,`video.download:${p.id}`,"video download",()=>r.downloadVideo(p.id,{signal:d}));C(g.bytes);const y=await w(s,`video.store:${p.id}`,"video save",()=>i.writeMany(b("video",u,A(g.contentType,"mp4"),t),[g.bytes]));n.logger.info("Video artifact stored.",{operationId:p.id,artifactCount:y.length,artifactBytes:z(y)});const F=y.map(x=>x.path);return $(m,{kind:"media",mediaType:"video",artifacts:F.map(x=>({path:x}))},M("Generated video",F)),0}async function se(e,t,o,r,i,a){const n=await w(i,`video.status:${e}`,"video status",()=>t.getVideoOperation(e,{signal:a}),m=>m.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 ue(e,t,o,r,i,a,n,m){const s=await w(n,`video.download:${e}`,"video download",()=>o.downloadVideo(e,{signal:m}));C(s.bytes);const d=await w(n,`video.store:${e}`,"video save",()=>r.writeMany(b("video",e,A(s.contentType,"mp4"),t),[s.bytes]));i.info("Video artifact downloaded.",{operationId:e,artifactCount:d.length,artifactBytes:z(d)});const u=d.map(f=>f.path);return $(a,{kind:"media",mediaType:"video",artifacts:u.map(f=>({path:f}))},M("Downloaded video",u)),0}function j(e){const t=c(e,"quality"),o=c(e,"background"),r=c(e,"output-format");return{...T(e,"n")===void 0?{}:{n:T(e,"n")},...c(e,"size")===void 0?{}:{size:c(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")},...c(e,"moderation")===void 0?{}:{moderation:c(e,"moderation")},...c(e,"user")===void 0?{}:{user:c(e,"user")}}}function b(e,t,o,r){const i=c(r,"out"),a=c(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 m of e){const s=m.base64===void 0?await me(m.url,r,i):ce(m.base64);a.push(s.bytes),n=fe(s.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 h("The provider returned invalid Base64 image data.");const t=Buffer.from(e,"base64");return C(t),_(t,void 0,E)}async function me(e,t,o){const r=await Q(e,{maxBytes:E,timeoutMs:t,signal:o}),i=_(r.bytes,r.contentType,E);if(!["image/png","image/jpeg","image/webp"].includes(i.mimeType))throw h(`Unsupported generated image format: ${i.mimeType}.`);return i}function v(e,t){const o=e.join(" ").trim();if(o.length===0)throw h(`A prompt is required for ${t}.`);return o}function T(e,t){const o=c(e,t);if(o!==void 0){if(!/^\d+$/u.test(o)||!Number.isSafeInteger(Number(o)))throw h(`--${t} must be an integer.`);return Number(o)}}function N(e,t){const o=c(e,t);if(o===void 0)return;const r=Number(o);if(!Number.isFinite(r))throw h(`--${t} must be a finite number.`);return r}function L(e,t,o){const r=c(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 h(`--${t} contains an unsupported value.`);return t==="timestamp-granularities"?{timestampGranularities:i}:{include:i}}function pe(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 h("--parameters must be a JSON object.")}}function B(e){return c(e,"output-format")??"png"}function fe(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 we(e){return e==="text"||e==="srt"||e==="vtt"}function C(e){if(e.byteLength===0||e.byteLength>E)throw h("Generated media exceeds the supported binary output limit.")}function M(e,t){return`${e}${t.length===1?"":"s"} saved:
+${t.map(o=>`  ${o}`).join(`
+`)}
+`}function ge(e){return`${e[0]?.toUpperCase()??""}${e.slice(1)}`}function z(e){return e.reduce((t,o)=>t+o.bytes,0)}function h(e){return new I(S.INVALID_ARGUMENT,e,{category:"media",userMessage:e})}function V(e){return new I("MEDIA_VIDEO_FAILED",`Video operation failed: ${e.id}`,{category:"media",userMessage:e.errorMessage??`Video operation failed: ${e.id}`})}async function w(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{_e as runMediaCommand};