@lotagate/cli 0.1.24 → 0.1.26

package/dist/bootstrap/runtime-factory.d.ts

@@ -0,0 +1,46 @@
+import type { Writable } from 'node:stream';
+import { ConfigLoader } from '../infrastructure/config/config-loader.js';
+import { type PlatformPaths } from '../infrastructure/platform/platform-paths.js';
+import type { Logger } from '../ports/logger.js';
+import type { CredentialStore } from '../ports/credential-store.js';
+import { AuthenticationService } from '../application/auth/authentication-service.js';
+import { ProjectTrustService } from '../application/project/project-trust-service.js';
+import type { ProjectTrustStore } from '../ports/project-trust-store.js';
+import { type ShutdownManager } from './shutdown-manager.js';
+import type { SessionStore } from '../ports/session-store.js';
+import { WorkspaceSettingsStore } from '../infrastructure/workspace/workspace-settings-store.js';
+import type { CacheStore } from '../ports/cache-store.js';
+import { type CachePolicy } from '../infrastructure/cache/cache-policy.js';
+import type { GoalStore } from '../ports/goal-store.js';
+import { type HostPlatformContext } from '../infrastructure/platform/host-platform.js';
+import { McpRuntime } from '../infrastructure/extensions/mcp-runtime.js';
+import { MemoryService } from '../application/memory/memory-service.js';
+import { SessionExecutionWorkspaceService } from '../application/workspace/session-execution-workspace.js';
+import { ModelCatalogInFlightRegistry } from '../application/model/cached-model-catalog.js';
+import { CliAgentPreparationCache } from '../application/agent/cli-agent-preparation-cache.js';
+export interface CliRuntime {
+    readonly platform: HostPlatformContext;
+    readonly paths: PlatformPaths;
+    readonly logger: Logger;
+    readonly configLoader: ConfigLoader;
+    readonly credentialStore: CredentialStore;
+    readonly auth: AuthenticationService;
+    readonly projectTrustStore: ProjectTrustStore;
+    readonly projectTrust: ProjectTrustService;
+    readonly sessionStore: SessionStore;
+    readonly goalStore: GoalStore;
+    readonly workspaceSettings: WorkspaceSettingsStore;
+    readonly cache: CacheStore;
+    readonly cachePolicy: CachePolicy;
+    readonly mcpRuntime: McpRuntime;
+    readonly memory: MemoryService;
+    readonly executionWorkspaces: SessionExecutionWorkspaceService;
+    readonly modelCatalogInFlight: ModelCatalogInFlightRegistry;
+    readonly agentPreparation?: CliAgentPreparationCache;
+    readonly shutdown: ShutdownManager;
+}
+export interface RuntimeFactoryOptions {
+    stderr?: Writable;
+    interactive?: boolean;
+}
+export declare function createCliRuntime(options?: RuntimeFactoryOptions): CliRuntime;

package/dist/bootstrap/runtime-factory.js

@@ -0,0 +1 @@
+import{ConfigLoader as M}from"../infrastructure/config/config-loader.js";import{StructuredLogger as R}from"../infrastructure/logging/structured-logger.js";import{resolvePlatformPaths as D}from"../infrastructure/platform/platform-paths.js";import{AuthenticationService as L}from"../application/auth/authentication-service.js";import{CompositeCredentialStore as j}from"../infrastructure/credentials/composite-credential-store.js";import{EncryptedFileCredentialStore as k}from"../infrastructure/credentials/encrypted-file-credential-store.js";import{EnvironmentCredentialStore as T}from"../infrastructure/credentials/environment-credential-store.js";import{FileProjectTrustStore as W}from"../infrastructure/project/file-project-trust-store.js";import{ProjectTrustService as x}from"../application/project/project-trust-service.js";import{DefaultShutdownManager as E}from"./shutdown-manager.js";import{FileSessionStore as A}from"../infrastructure/sessions/file-session-store.js";import{WorkspaceSettingsStore as I}from"../infrastructure/workspace/workspace-settings-store.js";import{FileCacheStore as b}from"../infrastructure/cache/file-cache-store.js";import{resolveCachePolicy as G}from"../infrastructure/cache/cache-policy.js";import{DailyRotatingFileWriter as H}from"../infrastructure/logging/daily-rotating-file-writer.js";import{resolveLoggingPolicy as q}from"../infrastructure/logging/logging-policy.js";import{FileGoalStore as z}from"../infrastructure/sessions/file-goal-store.js";import{detectHostPlatform as B}from"../infrastructure/platform/host-platform.js";import{McpRuntime as J,resolveMcpRuntimePolicy as K}from"../infrastructure/extensions/mcp-runtime.js";import{FileMemoryStore as N}from"../infrastructure/memory/file-memory-store.js";import{MemoryService as O}from"../application/memory/memory-service.js";import{SessionExecutionWorkspaceService as Q}from"../application/workspace/session-execution-workspace.js";import{ModelCatalogInFlightRegistry as U}from"../application/model/cached-model-catalog.js";import{CliAgentPreparationCache as V}from"../application/agent/cli-agent-preparation-cache.js";function ve(i={}){const t=B(),e=D(process.env,t),n=new E,c=G(),g=new b(e.cacheDir,c),m=q();let o;try{o=new H(e.logsDir,m)}catch{}const d=i.interactive?o===void 0?"warn":"none":"warn",r=new R({output:i.stderr??process.stderr,level:m.level,consoleLevel:d,...o===void 0?{}:{file:o}}),s=new J(void 0,K(),r);o!==void 0&&n.register(()=>o?.close()),n.register(()=>s.close());const u=new M(r,e),l=new k(e),a=new j([new T,l],l),w=new L(a),p=new W(e),S=new x(p),f=new A(e),h=new z(f),v=new I,C=new O(new N(e,r),void 0,r),y=new Q(e.globalConfigDir,t),P=new U,F=new V;return{platform:t,paths:e,logger:r,configLoader:u,credentialStore:a,auth:w,projectTrustStore:p,projectTrust:S,sessionStore:f,goalStore:h,workspaceSettings:v,cache:g,cachePolicy:c,mcpRuntime:s,memory:C,executionWorkspaces:y,modelCatalogInFlight:P,agentPreparation:F,shutdown:n}}export{ve as createCliRuntime};

package/dist/bootstrap/shutdown-manager.d.ts

@@ -0,0 +1,11 @@
+export interface ShutdownManager {
+    register(handler: () => void | Promise<void>): void;
+    shutdown(): Promise<void>;
+}
+export declare class DefaultShutdownManager implements ShutdownManager {
+    private readonly handlers;
+    private shutdownPromise;
+    register(handler: () => void | Promise<void>): void;
+    shutdown(): Promise<void>;
+    private runShutdown;
+}

package/dist/bootstrap/shutdown-manager.js

@@ -0,0 +1 @@
+class n{handlers=[];shutdownPromise;register(r){this.handlers.push(r)}async shutdown(){return this.shutdownPromise!==void 0?this.shutdownPromise:(this.shutdownPromise=this.runShutdown(),this.shutdownPromise)}async runShutdown(){const r=[];for(const s of[...this.handlers].reverse())try{await s()}catch(e){r.push(e)}if(r.length>0)throw new AggregateError(r,"One or more shutdown handlers failed.")}}export{n as DefaultShutdownManager};

package/dist/bootstrap/startup-sequence.d.ts

@@ -0,0 +1,5 @@
+export interface StartupContext {
+    cwd: string;
+    isInteractive: boolean;
+}
+export declare function resolveStartupContext(argv: readonly string[], processCwd?: string): StartupContext;

package/dist/bootstrap/startup-sequence.js

@@ -0,0 +1 @@
+import r from"node:path";import{parseGlobalCliOptions as e}from"./global-cli-options.js";function n(t,o=process.cwd()){const s=e(t);return{cwd:r.resolve(s.cwd??o),isInteractive:process.stdin.isTTY===!0&&process.stdout.isTTY===!0}}export{n as resolveStartupContext};

package/dist/domain/auth/auth-profile.d.ts

@@ -0,0 +1,14 @@
+export interface AuthProfile {
+    name: string;
+    baseUrl: string;
+    credentialRef: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface StoredCredential {
+    profile: AuthProfile;
+    apiKey: string;
+}
+export declare function validateProfileName(name: string): string;
+export declare function validateBaseUrl(value: string): string;
+export declare function validateApiKey(apiKey: string): string;

package/dist/domain/auth/auth-profile.js

@@ -0,0 +1 @@
+import{CliError as t}from"../errors/cli-error.js";import{CLI_ERROR_CODES as a}from"../errors/error-codes.js";const s=/^[a-z][a-z0-9_-]{0,31}$/;function l(r){const e=r.trim().toLowerCase();if(!s.test(e))throw new t(a.AUTH_PROFILE_NOT_FOUND,`Invalid profile name: ${r}`,{category:"auth",userMessage:"Profile names may contain lowercase letters, digits, hyphens, or underscores; maximum 32 characters."});return e}function c(r){let e;try{e=new URL(r)}catch(o){throw new t(a.AUTH_BASE_URL_INVALID,"Base URL is invalid.",{category:"auth",userMessage:"Invalid base URL.",cause:o})}if(e.protocol!=="http:"&&e.protocol!=="https:")throw new t(a.AUTH_BASE_URL_INVALID,"Base URL must use HTTP or HTTPS.",{category:"auth",userMessage:"Base URL must use HTTP or HTTPS."});return r.replace(/\/+$/,"")}function u(r){const e=r.trim();if(e.length<8||e.length>4096||/[\r\n]/.test(e))throw new t(a.AUTH_API_KEY_INVALID,"API key has an invalid shape.",{category:"auth",userMessage:"API key is invalid or contains a newline."});return e}export{u as validateApiKey,c as validateBaseUrl,l as validateProfileName};

package/dist/domain/config/config-schema.d.ts

@@ -0,0 +1,24 @@
+export declare const REASONING_EFFORTS: readonly ["low", "medium", "high"];
+export type ReasoningEffort = typeof REASONING_EFFORTS[number];
+export declare const DEFAULT_REASONING_EFFORT: ReasoningEffort;
+export declare const CONFIG_SCHEMA_VERSION = 1;
+export interface CliConfig {
+    schemaVersion: 1;
+    baseUrl: string;
+    model: string | null;
+    effort: ReasoningEffort;
+    profile: string | null;
+    theme: 'dark' | 'light' | 'auto';
+    approvalMode: 'ask' | 'auto' | 'deny';
+    sandboxMode: 'workspace' | 'disabled';
+    telemetry: 'off' | 'opt-in';
+    updateChannel: 'stable' | 'preview';
+    memoryContext: 'enabled' | 'disabled';
+    memorySemanticSearch: 'enabled' | 'disabled';
+    memoryEmbeddingModel: string | null;
+}
+export type ConfigurableKey = Exclude<keyof CliConfig, 'schemaVersion'>;
+export declare const CONFIGURABLE_KEYS: readonly ConfigurableKey[];
+export declare const DEFAULT_CONFIG: CliConfig;
+export declare function validateConfig(value: unknown): Partial<CliConfig>;
+export declare function mergeConfig(...layers: readonly Partial<CliConfig>[]): CliConfig;

package/dist/domain/config/config-schema.js

@@ -0,0 +1 @@
+import{CliError as d}from"../errors/cli-error.js";import{CLI_ERROR_CODES as i}from"../errors/error-codes.js";import{findUnexpectedRecordKey as M,isRecord as S}from"../validation/record-schema.js";const E=["low","medium","high"],N="medium",a=1,_=["baseUrl","model","effort","profile","theme","approvalMode","sandboxMode","telemetry","updateChannel","memoryContext","memorySemanticSearch","memoryEmbeddingModel"],x=["schemaVersion",..._],O={schemaVersion:a,baseUrl:"https://api.lotagate.com",model:null,effort:N,profile:null,theme:"dark",approvalMode:"ask",sandboxMode:"workspace",telemetry:"off",updateChannel:"stable",memoryContext:"enabled",memorySemanticSearch:"disabled",memoryEmbeddingModel:null};function f(e,n){if(typeof e!="string"||e.trim().length===0)throw new d(i.CONFIG_SCHEMA_INVALID,`Invalid config field: ${n}`,{category:"config",userMessage:`Invalid configuration: field \`${n}\` must be a non-empty string.`})}function w(e){if(!S(e))throw new d(i.CONFIG_SCHEMA_INVALID,"Config must be a JSON object.",{category:"config",userMessage:"Configuration file must contain a JSON object."});const n=M(e,x);if(n!==void 0)throw b(`Unsupported configuration field: \`${n}\`.`);if(e.schemaVersion!==void 0&&e.schemaVersion!==a)throw new d(i.CONFIG_SCHEMA_INVALID,"Unsupported config schema version.",{category:"config",userMessage:`Unsupported configuration schema version: ${String(e.schemaVersion)}.`});const o=e.baseUrl;if(o!==void 0){f(o,"baseUrl");try{new URL(o)}catch(I){throw new d(i.CONFIG_SCHEMA_INVALID,"baseUrl must be a valid URL.",{category:"config",userMessage:"baseUrl must be a valid URL.",cause:I})}}const t=e.model,c=r(e.effort,"effort",E),s=e.profile;if(t!=null&&f(t,"model"),s!=null&&f(s,"profile"),typeof t=="string"&&t.length>256)throw new d(i.CONFIG_SCHEMA_INVALID,"Model id is too long.",{category:"config",userMessage:"Model id must not exceed 256 characters."});const l=r(e.theme,"theme",["dark","light","auto"]),u=r(e.approvalMode,"approvalMode",["ask","auto","deny"]),p=r(e.sandboxMode,"sandboxMode",["workspace","disabled"]),g=r(e.telemetry,"telemetry",["off","opt-in"]),h=r(e.updateChannel,"updateChannel",["stable","preview"]),y=r(e.memoryContext,"memoryContext",["enabled","disabled"]),C=r(e.memorySemanticSearch,"memorySemanticSearch",["enabled","disabled"]),m=e.memoryEmbeddingModel;return m!=null&&f(m,"memoryEmbeddingModel"),{...e.schemaVersion===void 0?{}:{schemaVersion:a},...o===void 0?{}:{baseUrl:o},...t===void 0?{}:{model:t},...c===void 0?{}:{effort:c},...s===void 0?{}:{profile:s},...l===void 0?{}:{theme:l},...u===void 0?{}:{approvalMode:u},...p===void 0?{}:{sandboxMode:p},...g===void 0?{}:{telemetry:g},...h===void 0?{}:{updateChannel:h},...y===void 0?{}:{memoryContext:y},...C===void 0?{}:{memorySemanticSearch:C},...m===void 0?{}:{memoryEmbeddingModel:m}}}function F(...e){const n=e.reduce((o,t)=>({...o,...t}),{});return{...O,...w(n),schemaVersion:a}}function r(e,n,o){if(e!==void 0){if(typeof e!="string"||!o.includes(e))throw b(`Invalid configuration: value for \`${n}\` is not supported.`);return e}}function b(e){return new d(i.CONFIG_SCHEMA_INVALID,e,{category:"config",userMessage:e})}export{_ as CONFIGURABLE_KEYS,a as CONFIG_SCHEMA_VERSION,O as DEFAULT_CONFIG,N as DEFAULT_REASONING_EFFORT,E as REASONING_EFFORTS,F as mergeConfig,w as validateConfig};

package/dist/domain/errors/cli-command-hint.d.ts

@@ -0,0 +1,5 @@
+export interface CliCommandHint {
+    /** Runtime command action identifiers, resolved by the shared command catalog. */
+    readonly actionId: string;
+    readonly tuiActionId?: string;
+}

package/dist/domain/errors/cli-error.d.ts

@@ -0,0 +1,35 @@
+import type { CliErrorCode } from './error-codes.js';
+import type { CliCommandHint } from './cli-command-hint.js';
+export interface CliErrorOptions {
+    category: string;
+    userMessage?: string;
+    retryable?: boolean;
+    exitCode?: number;
+    correlationId?: string;
+    details?: Record<string, unknown>;
+    hint?: CliCommandHint;
+    cause?: unknown;
+}
+export interface CliErrorShape {
+    code: CliErrorCode | string;
+    category: string;
+    message: string;
+    userMessage: string;
+    retryable: boolean;
+    exitCode: number;
+    correlationId?: string;
+    details?: Record<string, unknown>;
+}
+export declare class CliError extends Error {
+    readonly code: CliErrorCode | string;
+    readonly category: string;
+    readonly userMessage: string;
+    readonly retryable: boolean;
+    readonly exitCode: number;
+    readonly correlationId: string | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    readonly hint: CliCommandHint | undefined;
+    constructor(code: CliErrorCode | string, message: string, options: CliErrorOptions);
+    toJSON(): CliErrorShape;
+}
+export declare function asCliError(error: unknown): CliError;

package/dist/domain/errors/cli-error.js

@@ -0,0 +1 @@
+import{CLI_ERROR_CODES as r}from"./error-codes.js";class i extends Error{code;category;userMessage;retryable;exitCode;correlationId;details;hint;constructor(t,a,s){super(a,{cause:s.cause}),this.name="CliError",this.code=t,this.category=s.category,this.userMessage=s.userMessage??a,this.retryable=s.retryable??!1,this.exitCode=s.exitCode??1,this.correlationId=s.correlationId,this.details=s.details,this.hint=s.hint}toJSON(){return{code:this.code,category:this.category,message:this.message,userMessage:this.userMessage,retryable:this.retryable,exitCode:this.exitCode,...this.correlationId!==void 0?{correlationId:this.correlationId}:{},...this.details!==void 0?{details:this.details}:{}}}}function h(e){if(e instanceof i)return e;const t=c(e),a=u(e);if(t==="REQUEST_ABORTED"||d(e))return new i(r.INTERRUPTED,n(e),{category:"agent",userMessage:"The request was interrupted.",retryable:!0,...a,cause:e});if(t==="REQUEST_TIMEOUT"||t==="NETWORK_ERROR")return new i(r.MEDIA_REQUEST_FAILED,n(e),{category:"media",userMessage:"The media request could not be completed. Retry the request; if it persists, check the selected model, credentials, and network connection.",retryable:!0,...a,cause:e});if(t==="REQUEST_PAYLOAD_TOO_LARGE"){const s=a.details?.kind==="json-body",o=E(a.details?.maxBytes);return new i(r.INVALID_ARGUMENT,n(e),{category:"media",userMessage:s?`The serialized Gateway request exceeds ${o}. Remove some attachments or reduce the prompt/context.`:"The media request exceeds a Gateway file or aggregate size limit. Review the command options and input file size.",...a,cause:e})}return t==="REQUEST_VALIDATION_ERROR"?new i(r.INVALID_ARGUMENT,n(e),{category:"media",userMessage:"The media request does not satisfy a gateway validation limit. Review the command options and input file size.",...a,cause:e}):t==="RESPONSE_TOO_LARGE"?new i(r.MEDIA_RESPONSE_TOO_LARGE,n(e),{category:"media",userMessage:"The generated media exceeds the supported download size.",retryable:!1,...a,cause:e}):t==="TOOL_ARGUMENTS_INVALID"?new i(r.TOOL_ARGUMENT_INVALID,n(e),{category:"tool",userMessage:"The selected model returned malformed tool arguments. Retry the request or choose a model with reliable tool-calling support.",retryable:!0,cause:e}):t==="TOOL_DENIED"||t==="TOOL_APPROVAL_REQUIRED"?new i(r.TOOL_DENIED,n(e),{category:"tool",userMessage:"The tool action was denied by the active workspace policy. Use interactive approval or configure an explicit workspace permission.",retryable:!1,...a,cause:e}):t==="TOOL_EXECUTION_FAILED"||t==="MCP_OPERATION_FAILED"||t==="MCP_DISCONNECTED"?new i(r.TOOL_EXECUTION_FAILED,n(e),{category:"tool",userMessage:"The selected tool could not complete. Retry the request; if it persists, check the tool or MCP server connection.",retryable:!0,...a,cause:e}):t==="TOOL_NOT_FOUND"?new i(r.MODEL_STREAM_FAILED,n(e),{category:"model",userMessage:"The selected model requested a tool that is unavailable in this CLI session. Retry the request or choose another model.",retryable:!0,cause:e}):t==="AGENT_LIMIT_EXCEEDED"?new i(r.AGENT_STUCK,n(e),{category:"agent",userMessage:"The agent reached a safety limit before completing. Narrow the task and try again.",retryable:!0,cause:e}):t==="MODEL_RESPONSE_INVALID"||t==="RESPONSE_PARSE_ERROR"||f(e)?new i(r.MODEL_STREAM_FAILED,n(e),{category:"model",userMessage:"The model provider could not complete the request. Retry; if it persists, check the selected model, credentials, and base URL.",retryable:!0,cause:e}):new i(r.INTERNAL_ERROR,e instanceof Error?e.message:String(e),{category:"general",userMessage:"An internal error occurred.",hint:{actionId:"doctor"},cause:e})}function c(e){if(typeof e!="object"||e===null)return;const t=e;return typeof t.code=="string"?t.code:typeof t.errorCode=="string"?t.errorCode:void 0}function d(e){let t=e;for(let a=0;a<5&&t!==void 0&&t!==null;a+=1){if(typeof t!="object")return!1;const s=t;if(s.name==="AbortError"||s.code==="ABORT_ERR"||typeof s.message=="string"&&/\b(aborted|cancelled|canceled)\b/iu.test(s.message))return!0;t=s.cause}return!1}function u(e){if(typeof e!="object"||e===null)return{};const t=e;return{...typeof t.correlationId=="string"?{correlationId:t.correlationId}:{},...l(t.details)?{details:t.details}:{}}}function l(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function E(e){if(typeof e!="number"||!Number.isFinite(e)||e<=0)return"the configured size limit";const t=e/1e6;return Number.isInteger(t)?`${t} MB`:`${e} bytes`}function f(e){return n(e)==="Upstream AI provider request failed."}function n(e){return e instanceof Error?e.message:String(e)}export{i as CliError,h as asCliError};

package/dist/domain/errors/error-codes.d.ts

@@ -0,0 +1,51 @@
+export declare const CLI_ERROR_CODES: {
+    readonly INVALID_ARGUMENT: "CLI_INVALID_ARGUMENT";
+    readonly MISSING_ARGUMENT: "CLI_MISSING_ARGUMENT";
+    readonly INTERRUPTED: "CLI_INTERRUPTED";
+    readonly INTERNAL_ERROR: "CLI_INTERNAL_ERROR";
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_INVALID_JSON: "CONFIG_INVALID_JSON";
+    readonly CONFIG_SCHEMA_INVALID: "CONFIG_SCHEMA_INVALID";
+    readonly CONFIG_LOCKED: "CONFIG_LOCKED";
+    readonly PROJECT_PATH_INVALID: "PROJECT_PATH_INVALID";
+    readonly AUTH_API_KEY_INVALID: "AUTH_API_KEY_INVALID";
+    readonly AUTH_PROFILE_NOT_FOUND: "AUTH_PROFILE_NOT_FOUND";
+    readonly AUTH_CREDENTIAL_STORE_UNAVAILABLE: "AUTH_CREDENTIAL_STORE_UNAVAILABLE";
+    readonly AUTH_BASE_URL_INVALID: "AUTH_BASE_URL_INVALID";
+    readonly PROJECT_TRUST_REQUIRED: "PROJECT_TRUST_REQUIRED";
+    readonly MODEL_NOT_FOUND: "MODEL_NOT_FOUND";
+    readonly MODEL_STREAM_FAILED: "MODEL_STREAM_FAILED";
+    readonly MODEL_EMPTY_RESPONSE: "MODEL_EMPTY_RESPONSE";
+    readonly MODEL_PROTOCOL_EMPTY_RESPONSE: "MODEL_PROTOCOL_EMPTY_RESPONSE";
+    readonly MEDIA_REQUEST_FAILED: "MEDIA_REQUEST_FAILED";
+    readonly MEDIA_RESPONSE_TOO_LARGE: "MEDIA_RESPONSE_TOO_LARGE";
+    readonly MODEL_EMPTY_FINAL: "MODEL_EMPTY_FINAL";
+    readonly AGENT_STUCK: "AGENT_STUCK";
+    readonly ATTACHMENT_CLIPBOARD_UNAVAILABLE: "ATTACHMENT_CLIPBOARD_UNAVAILABLE";
+    readonly ATTACHMENT_FORMAT_UNSUPPORTED: "ATTACHMENT_FORMAT_UNSUPPORTED";
+    readonly ATTACHMENT_TOO_LARGE: "ATTACHMENT_TOO_LARGE";
+    readonly ATTACHMENT_INVALID_IMAGE: "ATTACHMENT_INVALID_IMAGE";
+    readonly TOOL_ARGUMENT_INVALID: "TOOL_ARGUMENT_INVALID";
+    readonly TOOL_DENIED: "CLI_TOOL_DENIED";
+    readonly TOOL_EXECUTION_FAILED: "CLI_TOOL_EXECUTION_FAILED";
+    readonly PROJECT_SYMLINK_ESCAPE: "PROJECT_SYMLINK_ESCAPE";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly SESSION_LOCKED: "SESSION_LOCKED";
+    readonly SESSION_CORRUPTED: "SESSION_CORRUPTED";
+    readonly TASK_DEPENDENCY_CYCLE: "TASK_DEPENDENCY_CYCLE";
+    readonly TASK_SCHEDULER_OVERLOADED: "TASK_SCHEDULER_OVERLOADED";
+    readonly TASK_PLAN_APPROVAL_REQUIRED: "TASK_PLAN_APPROVAL_REQUIRED";
+    readonly PLUGIN_MANIFEST_INVALID: "PLUGIN_MANIFEST_INVALID";
+    readonly PLUGIN_NOT_FOUND: "PLUGIN_NOT_FOUND";
+    readonly SKILL_FRONTMATTER_INVALID: "SKILL_FRONTMATTER_INVALID";
+    readonly SKILL_NOT_FOUND: "SKILL_NOT_FOUND";
+    readonly MCP_CONFIG_INVALID: "MCP_CONFIG_INVALID";
+    readonly MCP_SERVER_NOT_FOUND: "MCP_SERVER_NOT_FOUND";
+    readonly GOAL_NOT_FOUND: "GOAL_NOT_FOUND";
+    readonly GOAL_INVALID_STATE: "GOAL_INVALID_STATE";
+    readonly GOAL_LIMIT_REACHED: "GOAL_LIMIT_REACHED";
+    readonly MEMORY_NOT_FOUND: "MEMORY_NOT_FOUND";
+    readonly MEMORY_INVALID: "MEMORY_INVALID";
+    readonly MEMORY_LIMIT_REACHED: "MEMORY_LIMIT_REACHED";
+};
+export type CliErrorCode = (typeof CLI_ERROR_CODES)[keyof typeof CLI_ERROR_CODES];

package/dist/domain/errors/error-codes.js

@@ -0,0 +1 @@
+const _={INVALID_ARGUMENT:"CLI_INVALID_ARGUMENT",MISSING_ARGUMENT:"CLI_MISSING_ARGUMENT",INTERRUPTED:"CLI_INTERRUPTED",INTERNAL_ERROR:"CLI_INTERNAL_ERROR",CONFIG_NOT_FOUND:"CONFIG_NOT_FOUND",CONFIG_INVALID_JSON:"CONFIG_INVALID_JSON",CONFIG_SCHEMA_INVALID:"CONFIG_SCHEMA_INVALID",CONFIG_LOCKED:"CONFIG_LOCKED",PROJECT_PATH_INVALID:"PROJECT_PATH_INVALID",AUTH_API_KEY_INVALID:"AUTH_API_KEY_INVALID",AUTH_PROFILE_NOT_FOUND:"AUTH_PROFILE_NOT_FOUND",AUTH_CREDENTIAL_STORE_UNAVAILABLE:"AUTH_CREDENTIAL_STORE_UNAVAILABLE",AUTH_BASE_URL_INVALID:"AUTH_BASE_URL_INVALID",PROJECT_TRUST_REQUIRED:"PROJECT_TRUST_REQUIRED",MODEL_NOT_FOUND:"MODEL_NOT_FOUND",MODEL_STREAM_FAILED:"MODEL_STREAM_FAILED",MODEL_EMPTY_RESPONSE:"MODEL_EMPTY_RESPONSE",MODEL_PROTOCOL_EMPTY_RESPONSE:"MODEL_PROTOCOL_EMPTY_RESPONSE",MEDIA_REQUEST_FAILED:"MEDIA_REQUEST_FAILED",MEDIA_RESPONSE_TOO_LARGE:"MEDIA_RESPONSE_TOO_LARGE",MODEL_EMPTY_FINAL:"MODEL_EMPTY_FINAL",AGENT_STUCK:"AGENT_STUCK",ATTACHMENT_CLIPBOARD_UNAVAILABLE:"ATTACHMENT_CLIPBOARD_UNAVAILABLE",ATTACHMENT_FORMAT_UNSUPPORTED:"ATTACHMENT_FORMAT_UNSUPPORTED",ATTACHMENT_TOO_LARGE:"ATTACHMENT_TOO_LARGE",ATTACHMENT_INVALID_IMAGE:"ATTACHMENT_INVALID_IMAGE",TOOL_ARGUMENT_INVALID:"TOOL_ARGUMENT_INVALID",TOOL_DENIED:"CLI_TOOL_DENIED",TOOL_EXECUTION_FAILED:"CLI_TOOL_EXECUTION_FAILED",PROJECT_SYMLINK_ESCAPE:"PROJECT_SYMLINK_ESCAPE",SESSION_NOT_FOUND:"SESSION_NOT_FOUND",SESSION_LOCKED:"SESSION_LOCKED",SESSION_CORRUPTED:"SESSION_CORRUPTED",TASK_DEPENDENCY_CYCLE:"TASK_DEPENDENCY_CYCLE",TASK_SCHEDULER_OVERLOADED:"TASK_SCHEDULER_OVERLOADED",TASK_PLAN_APPROVAL_REQUIRED:"TASK_PLAN_APPROVAL_REQUIRED",PLUGIN_MANIFEST_INVALID:"PLUGIN_MANIFEST_INVALID",PLUGIN_NOT_FOUND:"PLUGIN_NOT_FOUND",SKILL_FRONTMATTER_INVALID:"SKILL_FRONTMATTER_INVALID",SKILL_NOT_FOUND:"SKILL_NOT_FOUND",MCP_CONFIG_INVALID:"MCP_CONFIG_INVALID",MCP_SERVER_NOT_FOUND:"MCP_SERVER_NOT_FOUND",GOAL_NOT_FOUND:"GOAL_NOT_FOUND",GOAL_INVALID_STATE:"GOAL_INVALID_STATE",GOAL_LIMIT_REACHED:"GOAL_LIMIT_REACHED",MEMORY_NOT_FOUND:"MEMORY_NOT_FOUND",MEMORY_INVALID:"MEMORY_INVALID",MEMORY_LIMIT_REACHED:"MEMORY_LIMIT_REACHED"};export{_ as CLI_ERROR_CODES};

package/dist/domain/extensions/extension-constants.d.ts

@@ -0,0 +1 @@
+export declare const MAX_PLUGIN_DISPLAY_NAME_LENGTH = 128;

package/dist/domain/extensions/extension-constants.js

@@ -0,0 +1 @@
+const _=128;export{_ as MAX_PLUGIN_DISPLAY_NAME_LENGTH};

package/dist/domain/extensions/extension-scope.d.ts

@@ -0,0 +1,3 @@
+export type ExtensionScope = 'user' | 'project';
+export declare function parseExtensionScope(value: string | boolean | undefined): ExtensionScope | undefined;
+export declare function requireExtensionScope(value: string | boolean | undefined): ExtensionScope;

package/dist/domain/extensions/extension-scope.js

@@ -0,0 +1 @@
+import{CliError as o}from"../errors/cli-error.js";import{CLI_ERROR_CODES as s}from"../errors/error-codes.js";function n(e){if(e!==void 0){if(typeof e!="string"||e!=="user"&&e!=="project")throw new o(s.INVALID_ARGUMENT,"Extension scope must be user or project.",{category:"arguments",userMessage:"Invalid scope. Use --scope user or --scope project."});return e}}function c(e){const r=n(e);if(r===void 0)throw new o(s.MISSING_ARGUMENT,"Extension scope is required for non-interactive commands.",{category:"arguments",userMessage:"Choose a scope interactively or pass --scope user|project."});return r}export{n as parseExtensionScope,c as requireExtensionScope};

package/dist/domain/extensions/extension-state.d.ts

@@ -0,0 +1,5 @@
+export interface ExtensionStateEntry {
+    enabled: boolean;
+}
+export type ExtensionState = Record<string, ExtensionStateEntry>;
+export declare function parseExtensionState(value: unknown): ExtensionState;

package/dist/domain/extensions/extension-state.js

@@ -0,0 +1 @@
+function o(t){if(typeof t!="object"||t===null||Array.isArray(t))throw new Error("Extension state must be an object.");const n={};for(const[r,e]of Object.entries(t)){if(typeof e!="object"||e===null||Array.isArray(e)||typeof e.enabled!="boolean")throw new Error(`Invalid extension state entry: ${r}.`);n[r]={enabled:e.enabled}}return n}export{o as parseExtensionState};

package/dist/domain/extensions/hook-manifest.d.ts

@@ -0,0 +1,13 @@
+export type HookEvent = 'session.start' | 'prompt.before' | 'tool.before' | 'tool.after' | 'response.after' | 'session.end';
+export interface HookDefinition {
+    id: string;
+    event: HookEvent;
+    command: string;
+    args: readonly string[];
+    timeoutMs: number;
+    directory: string;
+    scope?: 'project' | 'plugin';
+    pluginName?: string;
+    sourceName?: string;
+}
+export declare function parseHookDefinition(value: unknown, directory: string, id: string): HookDefinition;

package/dist/domain/extensions/hook-manifest.js

@@ -0,0 +1 @@
+import{CliError as a}from"../errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../errors/error-codes.js";function k(o,f,u){if(typeof o!="object"||o===null)throw e("Hook must be a JSON object.");const n=o,i=n.event,r=n.command,s=n.args,m=n.timeoutMs;if(!p(i))throw e("Hook event is not supported.");if(typeof r!="string"||r.trim().length===0||/[\r\n]/u.test(r))throw e("Hook command is invalid.");if(s!==void 0&&(!Array.isArray(s)||s.some(c=>typeof c!="string")))throw e("Hook args must be strings.");const t=m===void 0?1e4:m;if(typeof t!="number"||!Number.isInteger(t)||t<100||t>12e4)throw e("Hook timeout must be between 100 and 120000 milliseconds.");return{id:u,event:i,command:r,args:s??[],timeoutMs:t,directory:f}}function p(o){return typeof o=="string"&&["session.start","prompt.before","tool.before","tool.after","response.after","session.end"].includes(o)}function e(o){return new a(d.PLUGIN_MANIFEST_INVALID,o,{category:"extension",userMessage:`Invalid hook: ${o}`})}export{k as parseHookDefinition};

package/dist/domain/extensions/host-tool-plugin-ids.d.ts

@@ -0,0 +1,5 @@
+/** Public plugin identities that own optional native Desktop host capabilities. */
+export declare const HOST_TOOL_PLUGIN_IDS: {
+    readonly browser: "browser-use";
+    readonly computer: "computer-use";
+};

package/dist/domain/extensions/host-tool-plugin-ids.js

@@ -0,0 +1 @@
+const e={browser:"browser-use",computer:"computer-use"};export{e as HOST_TOOL_PLUGIN_IDS};

package/dist/domain/extensions/mcp-config.d.ts

@@ -0,0 +1,35 @@
+import type { McpServerConfig } from '@lotagate/agent-sdk';
+/** Persistable subset of the public Agent SDK MCP contract. */
+export interface McpSecretReference {
+    type: 'env';
+    name: string;
+}
+export type CliSecretValue = string | McpSecretReference;
+export type CliMcpServerConfig = (Omit<Extract<McpServerConfig, {
+    type: 'stdio';
+}>, 'env'> & {
+    env?: Readonly<Record<string, CliSecretValue>>;
+}) | (Omit<Extract<McpServerConfig, {
+    type: 'http' | 'sse';
+}>, 'headers' | 'auth'> & {
+    headers?: Readonly<Record<string, CliSecretValue>>;
+    auth?: {
+        type: 'bearer';
+        token: McpSecretReference;
+    };
+});
+export interface CliMcpServerEntry {
+    enabled: boolean;
+    config: CliMcpServerConfig;
+}
+export type CliMcpConfig = Record<string, CliMcpServerEntry>;
+export declare function mergeMcpConfigs(...configs: readonly CliMcpConfig[]): CliMcpConfig;
+/**
+ * Combines ordered configuration layers where a later, more specific layer
+ * overrides an earlier one. Runtime callers pass user scope before project
+ * scope so a trusted project can intentionally override a global server with
+ * the same name.
+ */
+export declare function mergeMcpConfigsWithOverride(...configs: readonly CliMcpConfig[]): CliMcpConfig;
+export declare function validateMcpName(name: string): string;
+export declare function validateMcpConfig(value: unknown): CliMcpConfig;

package/dist/domain/extensions/mcp-config.js

@@ -0,0 +1 @@
+import{CliError as d}from"../errors/cli-error.js";import{CLI_ERROR_CODES as m}from"../errors/error-codes.js";function C(...t){const e={};for(const o of t)for(const[r,i]of Object.entries(o)){if(e[r]!==void 0)throw n(`MCP server is defined more than once: ${r}.`);e[r]=i}return e}function M(...t){const e={};for(const o of t)Object.assign(e,o);return e}function g(t){const e=t.trim().toLowerCase();if(!/^[a-z][a-z0-9_-]{0,63}$/.test(e))throw n("MCP server name must be lowercase and <= 64 characters.");return e}function A(t){if(typeof t!="object"||t===null||Array.isArray(t))throw n("MCP config must be an object.");const e={};for(const[o,r]of Object.entries(t)){const i=g(o);if(typeof r!="object"||r===null||Array.isArray(r))throw n(`Invalid MCP entry: ${i}.`);const s=r;if(typeof s.enabled!="boolean"||typeof s.config!="object"||s.config===null)throw n(`Invalid MCP entry: ${i}.`);e[i]={enabled:s.enabled,config:h(s.config)}}return e}function h(t){const e=t,o=e.type;if(o==="stdio"){if(typeof e.command!="string"||e.command.trim().length===0||/[\r\n]/.test(e.command))throw n("stdio MCP command is invalid.");if(e.args!==void 0&&(!Array.isArray(e.args)||e.args.some(r=>typeof r!="string")))throw n("stdio MCP args must be strings.");return{type:o,command:e.command,...e.args===void 0?{}:{args:e.args},...e.env===void 0?{}:{env:a(e.env,"stdio env")},...e.cwd===void 0?{}:{cwd:y(e.cwd,"stdio cwd")},...e.maxBufferSize===void 0?{}:{maxBufferSize:p(e.maxBufferSize,"stdio maxBufferSize")}}}if(o==="http"||o==="sse"){if(typeof e.url!="string")throw n("HTTP MCP URL is required.");try{const r=new URL(e.url);if(!["http:","https:"].includes(r.protocol)||r.username.length>0||r.password.length>0||[...r.searchParams.keys()].some(u))throw new Error("credentials")}catch(r){throw n("HTTP MCP URL must use HTTP or HTTPS and must not contain credentials.",r)}return{type:o,url:e.url,...e.headers===void 0?{}:{headers:a(e.headers,"HTTP headers")},...e.auth===void 0?{}:{auth:b(e.auth)}}}throw n("MCP type must be stdio, http or sse.")}function y(t,e){if(typeof t!="string"||t.length===0)throw n(`${e} must be a non-empty string.`);return t}function p(t,e){if(typeof t!="number"||!Number.isSafeInteger(t)||t<=0)throw n(`${e} must be a positive integer.`);return t}function b(t){if(typeof t!="object"||t===null||Array.isArray(t))throw n("HTTP auth must be a bearer token configuration.");const e=t;if(e.type!=="bearer")throw n("HTTP auth must be a bearer token configuration.");return{type:"bearer",token:f(e.token,"HTTP bearer token")}}function a(t,e){if(typeof t!="object"||t===null||Array.isArray(t))throw n(`${e} must be an object of string values or environment references.`);const o={};for(const[r,i]of Object.entries(t)){if(r.length===0||/[\r\n]/u.test(r))throw n(`${e} must contain valid string key/value pairs.`);o[r]=c(i)?f(i,`${e} secret reference`):u(r)?(()=>{throw n(`${e} value for ${r} must use an environment reference.`)})():w(i,`${e} value`)}return o}function f(t,e){if(!c(t)||!/^[A-Za-z_][A-Za-z0-9_]{0,127}$/u.test(t.name))throw n(`${e} must reference an environment variable name.`);return{type:"env",name:t.name}}function w(t,e){if(typeof t!="string"||/[\r\n]/u.test(t))throw n(`${e} must be a string without line breaks.`);return t}function c(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)&&t.type==="env"&&typeof t.name=="string"}function u(t){return/(?:api[-_]?key|authorization|auth[-_]?token|cookie|credential|key|password|secret|token)/iu.test(t)}function n(t,e){return new d(m.MCP_CONFIG_INVALID,t,{category:"mcp",userMessage:`Invalid MCP configuration: ${t}`,cause:e})}export{C as mergeMcpConfigs,M as mergeMcpConfigsWithOverride,A as validateMcpConfig,g as validateMcpName};

package/dist/domain/extensions/plugin-agent-manifest.d.ts

@@ -0,0 +1,8 @@
+export interface PluginAgentDefinition {
+    name: string;
+    description: string;
+    instructions: string;
+    allowedTools: readonly string[];
+    directory: string;
+}
+export declare function parsePluginAgentDocument(raw: string, directory: string): PluginAgentDefinition;

package/dist/domain/extensions/plugin-agent-manifest.js

@@ -0,0 +1 @@
+import{CliError as c}from"../errors/cli-error.js";import{CLI_ERROR_CODES as p}from"../errors/error-codes.js";import{findUnexpectedRecordKey as l}from"../validation/record-schema.js";import{parseYamlList as u,parseYamlMapping as d}from"./yaml-subset.js";function A(n,a){const e=d(n,t),s=l(e,["name","description","instructions","allowed-tools"]);if(s!==void 0)throw t(`Unsupported agent field: \`${s}\`.`);const o=e.name,i=e.description,r=e.instructions;if(typeof o!="string"||!/^[a-z0-9][a-z0-9-]{0,63}$/u.test(o))throw t("Agent name must use lowercase kebab-case.");if(typeof i!="string"||i.trim().length===0)throw t("Agent requires a description.");if(typeof r!="string"||r.trim().length===0)throw t("Agent requires instructions.");return{name:o,description:i,instructions:r,allowedTools:u(e["allowed-tools"]),directory:a}}function t(n){return new c(p.PLUGIN_MANIFEST_INVALID,n,{category:"extension",userMessage:`Invalid plugin agent: ${n}`})}export{A as parsePluginAgentDocument};

package/dist/domain/extensions/plugin-manifest.d.ts

@@ -0,0 +1,23 @@
+export interface PluginManifest {
+    name: string;
+    displayName?: string;
+    version: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    homepage?: string;
+    repository?: string;
+    keywords?: readonly string[];
+    directory: string;
+}
+export declare const PLUGIN_LAYOUT: {
+    readonly markerDirectory: ".lotagate-plugin";
+    readonly manifestFile: "plugin.json";
+    readonly skillsDirectory: "skills";
+    readonly agentsDirectory: "agents";
+    readonly hooksDirectory: "hooks";
+    readonly mcpDirectory: "mcp";
+    readonly readmeFile: "README.md";
+    readonly licenseFile: "LICENSE";
+};
+export declare function parsePluginManifest(value: unknown, directory: string): PluginManifest;

package/dist/domain/extensions/plugin-manifest.js

@@ -0,0 +1 @@
+import{CliError as g}from"../errors/cli-error.js";import{CLI_ERROR_CODES as h}from"../errors/error-codes.js";import{findUnexpectedRecordKey as N,isRecord as w}from"../validation/record-schema.js";import{MAX_PLUGIN_DISPLAY_NAME_LENGTH as y}from"./extension-constants.js";const v={markerDirectory:".lotagate-plugin",manifestFile:"plugin.json",skillsDirectory:"skills",agentsDirectory:"agents",hooksDirectory:"hooks",mcpDirectory:"mcp",readmeFile:"README.md",licenseFile:"LICENSE"};function L(n,t){if(!w(n))throw i("Manifest must be a JSON object.");const e=n,r=N(e,["name","displayName","version","description","author","license","homepage","repository","keywords"]);if(r!==void 0)throw i(`Unsupported manifest field: \`${r}\`.`);const s=e.name,d=A(e),a=e.version,f=o(e,"description"),u=o(e,"author"),c=o(e,"license"),m=o(e,"homepage"),l=o(e,"repository"),p=k(e,"keywords");if(typeof s!="string"||!/^[a-z0-9][a-z0-9-]{0,63}$/.test(s))throw i("Plugin name must use lowercase kebab-case.");if(typeof a!="string"||!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(a))throw i("Plugin version must be semver-like.");return{name:s,...d===void 0?{}:{displayName:d},version:a,...f===void 0?{}:{description:f},...u===void 0?{}:{author:u},...c===void 0?{}:{license:c},...m===void 0?{}:{homepage:m},...l===void 0?{}:{repository:l},...p===void 0?{}:{keywords:p},directory:t}}function A(n){const t=n.displayName;if(t===void 0)return;if(typeof t!="string")throw i("Manifest field `displayName` must be a string.");const e=t.trim();if(e.length===0||e.length>y||M(e))throw i(`Manifest field \`displayName\` must be a non-empty string of at most ${y} characters.`);return e}function M(n){return[...n].some(t=>{const e=t.codePointAt(0)??0;return e<32||e===127})}function o(n,t){const e=n[t];if(e!==void 0){if(typeof e!="string")throw i(`Manifest field \`${t}\` must be a string.`);return e}}function k(n,t){const e=n[t];if(e!==void 0){if(!Array.isArray(e)||e.some(r=>typeof r!="string"||r.trim().length===0))throw i(`Manifest field \`${t}\` must be an array of non-empty strings.`);return e.map(r=>r.trim())}}function i(n){return new g(h.PLUGIN_MANIFEST_INVALID,n,{category:"extension",userMessage:`Invalid plugin: ${n}`})}export{v as PLUGIN_LAYOUT,L as parsePluginManifest};

package/dist/domain/extensions/skill-manifest.d.ts

@@ -0,0 +1,10 @@
+export interface SkillManifest {
+    name: string;
+    description: string;
+    userInvocable: boolean;
+    modelInvocable: boolean;
+    allowedTools: readonly string[];
+    directory: string;
+    body: string;
+}
+export declare function parseSkillDocument(raw: string, directory: string): SkillManifest;

package/dist/domain/extensions/skill-manifest.js

@@ -0,0 +1,3 @@
+import{CliError as f}from"../errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../errors/error-codes.js";import{parseYamlList as p,parseYamlMapping as u}from"./yaml-subset.js";function b(t,m){const n=t.replace(/^\uFEFF/,"");if(!n.startsWith(`---
+`)&&!n.startsWith(`---\r
+`))throw e("Skill must start with YAML frontmatter.");const r=n.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);if(r===null)throw e("Skill frontmatter is not closed.");const l=r[1],a=r[2];if(l===void 0||a===void 0)throw e("Skill document is incomplete.");const o=u(l,e),i=o.name,s=o.description;if(typeof i!="string"||typeof s!="string"||s.trim().length===0)throw e("Skill requires name and description.");if(!/^[a-z0-9][a-z0-9-]{0,63}$/.test(i))throw e("Skill name must be lowercase kebab-case.");return{name:i,description:s,userInvocable:!c(o["user-invocable"]),modelInvocable:!c(o["model-invocable"]),allowedTools:p(o["allowed-tools"]),directory:m,body:a.trim()}}function c(t){return typeof t=="string"&&t.toLowerCase()==="false"}function e(t){return new f(d.SKILL_FRONTMATTER_INVALID,t,{category:"extension",userMessage:`Invalid skill: ${t}`})}export{b as parseSkillDocument};

package/dist/domain/extensions/yaml-subset.d.ts

@@ -0,0 +1,9 @@
+import { CliError } from '../errors/cli-error.js';
+export type YamlValue = string | readonly string[];
+/**
+ * Parses the deliberately small YAML mapping subset used by extension metadata.
+ * It supports scalars, folded/literal blocks and string lists without executing
+ * YAML tags or constructing arbitrary objects.
+ */
+export declare function parseYamlMapping(raw: string, invalid?: (message: string) => CliError): Record<string, YamlValue>;
+export declare function parseYamlList(value: YamlValue | undefined): readonly string[];

package/dist/domain/extensions/yaml-subset.js

@@ -0,0 +1,2 @@
+import{CliError as f}from"../errors/cli-error.js";import{CLI_ERROR_CODES as p}from"../errors/error-codes.js";function w(t,i=g){const n=t.split(/\r?\n/),o={};for(let e=0;e<n.length;e+=1){const l=n[e]??"";if(l.trim().length===0||l.trimStart().startsWith("#"))continue;const u=l.match(/^([A-Za-z][A-Za-z0-9_-]*):(?:[ \t]*(.*))?$/u);if(u===null)throw i(`Invalid YAML metadata line: ${l}`);const a=u[1]?.toLowerCase(),s=u[2]??"";if(a===void 0)throw i("YAML metadata key is invalid.");if(s===">"||s==="|"){const r=[];for(;e+1<n.length&&h(n[e+1]??"");)r.push(d(n[++e]??""));o[a]=s===">"?r.join(" ").replace(/\s+/gu," ").trim():r.join(`
+`).trimEnd();continue}if(s.trim().length===0&&e+1<n.length&&m(n[e+1]??"")){const r=[];for(;e+1<n.length&&m(n[e+1]??"");)r.push(c(n[++e].trim().slice(2).trim()));o[a]=r;continue}o[a]=c(s.trim())}return o}function A(t){if(t===void 0)return[];if(typeof t!="string")return t;const i=t.trim().replace(/^\[|\]$/g,"").trim();return i.length===0?[]:(i.includes(",")?i.split(","):i.split(/\s+/u)).map(c).map(n=>n.trim()).filter(Boolean)}function h(t){return/^\s+/.test(t)||t.trim().length===0}function m(t){return/^\s+-\s+/.test(t)}function d(t){return t.trim().length===0?"":t.replace(/^\s{2}/u,"")}function c(t){return t.replace(/^(['"])([\s\S]*)\1$/u,"$2")}function g(t){return new f(p.SKILL_FRONTMATTER_INVALID,t,{category:"extension",userMessage:`Invalid extension metadata: ${t}`})}export{A as parseYamlList,w as parseYamlMapping};

package/dist/domain/filesystem/file-change-diff.d.ts

@@ -0,0 +1,21 @@
+export type FileDiffLineKind = 'context' | 'addition' | 'deletion';
+export interface FileDiffLine {
+    readonly kind: FileDiffLineKind;
+    readonly text: string;
+    readonly oldLine?: number;
+    readonly newLine?: number;
+}
+export interface FileChangeDiff {
+    readonly path: string;
+    readonly lines: readonly FileDiffLine[];
+    readonly additions: number;
+    readonly deletions: number;
+    readonly truncated: boolean;
+}
+export interface FileDiffOptions {
+    maxLines?: number;
+    maxInputLines?: number;
+    truncated?: boolean;
+}
+/** Creates a bounded, deterministic line diff suitable for terminal rendering. */
+export declare function createFileChangeDiff(path: string, before: string, after: string, options?: FileDiffOptions): FileChangeDiff;

package/dist/domain/filesystem/file-change-diff.js

@@ -0,0 +1,3 @@
+function w(i,o,s,n={}){const e=n.maxInputLines??400,x=n.maxLines??240,f=L(o),m=L(s),I=f.length>e||m.length>e,d=f.slice(0,e),r=m.slice(0,e),p=b(d,r),c=[];let h=1,u=1,t=0,l=0;for(;t<d.length||l<r.length;)t<d.length&&l<r.length&&d[t]===r[l]?(c.push({kind:"context",text:d[t]??"",oldLine:h,newLine:u}),t+=1,l+=1,h+=1,u+=1):l<r.length&&(t===d.length||(p[t+1]?.[l]??0)<(p[t]?.[l+1]??0))?(c.push({kind:"addition",text:r[l]??"",newLine:u}),l+=1,u+=1):(c.push({kind:"deletion",text:d[t]??"",oldLine:h}),t+=1,h+=1);const k=n.truncated===!0||I||c.length>x,a=c.slice(0,x);return{path:i,lines:a,additions:a.filter(g=>g.kind==="addition").length,deletions:a.filter(g=>g.kind==="deletion").length,truncated:k}}function L(i){return i.length===0?[]:i.replace(/\r\n/gu,`
+`).split(`
+`)}function b(i,o){const s=Array.from({length:i.length+1},()=>Array(o.length+1).fill(0));for(let n=i.length-1;n>=0;n-=1)for(let e=o.length-1;e>=0;e-=1)s[n][e]=i[n]===o[e]?(s[n+1]?.[e+1]??0)+1:Math.max(s[n+1]?.[e]??0,s[n]?.[e+1]??0);return s}export{w as createFileChangeDiff};

package/dist/domain/intent/intent-contract.d.ts

@@ -0,0 +1,33 @@
+export declare const INTENT_KINDS: readonly ["answer", "research", "change", "automation"];
+export type IntentKind = typeof INTENT_KINDS[number];
+export interface IntentStep {
+    readonly id: string;
+    readonly title: string;
+    readonly acceptanceCriteria: readonly string[];
+    readonly requiresVerification: boolean;
+}
+export interface IntentContract {
+    readonly id: string;
+    readonly kind: IntentKind;
+    readonly objective: string;
+    readonly steps: readonly IntentStep[];
+    readonly createdAt: string;
+}
+export interface IntentCompilationInput {
+    readonly kind: IntentKind;
+    readonly objective: string;
+    readonly steps: readonly Omit<IntentStep, 'id'>[];
+}
+export interface CompletionAssessment {
+    readonly decision: 'complete' | 'continue';
+    readonly missing: readonly string[];
+}
+/**
+ * The host, not the model, owns the minimum verification policy for work
+ * that can change state or execute an operational workflow.
+ */
+export declare function requiresHostVerification(kind: IntentKind): boolean;
+export declare function createIntentContract(input: IntentCompilationInput, timestamp?: string): IntentContract;
+export declare function normalizeIntentCompilation(value: unknown): IntentCompilationInput;
+export declare function fallbackIntent(prompt: string): IntentContract;
+export declare function isIntentKind(value: unknown): value is IntentKind;

package/dist/domain/intent/intent-contract.js

@@ -0,0 +1 @@
+import p from"node:crypto";import{CliError as f}from"../errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../errors/error-codes.js";import{findUnexpectedRecordKey as s,isRecord as a}from"../validation/record-schema.js";const u=["answer","research","change","automation"];function l(t){return t==="change"||t==="automation"}function h(t,n=new Date().toISOString()){const e=m(t),i=l(e.kind);return{id:p.randomUUID(),kind:e.kind,objective:e.objective,steps:e.steps.map((o,c)=>({...o,requiresVerification:i||o.requiresVerification,id:`step-${c+1}`})),createdAt:n}}function m(t){if(!a(t))throw r("Intent compilation must be an object.");const n=s(t,["kind","objective","steps"]);if(n!==void 0)throw r(`Unsupported intent field: ${n}.`);const e=t.kind,i=t.objective,o=t.steps;if(!g(e))throw r("Intent kind is invalid.");if(typeof i!="string"||i.trim().length===0||i.length>16384)throw r("Intent objective is invalid.");if(!Array.isArray(o)||o.length===0||o.length>10)throw r("Intent requires between one and ten steps.");return{kind:e,objective:i.trim(),steps:o.map(I)}}function j(t){const n=t.trim();if(n.length===0)throw r("Intent objective is required.");return h({kind:"change",objective:n,steps:[{title:"Handle and verify the requested outcome",acceptanceCriteria:[n],requiresVerification:!0}]})}function g(t){return typeof t=="string"&&u.includes(t)}function I(t){if(!a(t))throw r("Intent step is invalid.");const n=s(t,["title","acceptanceCriteria","requiresVerification"]);if(n!==void 0)throw r(`Unsupported intent step field: ${n}.`);const e=t.title,i=t.acceptanceCriteria,o=t.requiresVerification;if(typeof e!="string"||e.trim().length===0||e.length>2048)throw r("Intent step title is invalid.");if(!Array.isArray(i)||i.length===0||i.length>16||i.some(c=>typeof c!="string"||c.trim().length===0||c.length>2048))throw r("Intent acceptance criteria are invalid.");if(typeof o!="boolean")throw r("Intent verification requirement is invalid.");return{title:e.trim(),acceptanceCriteria:i.map(c=>String(c).trim()),requiresVerification:o}}function r(t){return new f(d.INVALID_ARGUMENT,t,{category:"intent",userMessage:t})}export{u as INTENT_KINDS,h as createIntentContract,j as fallbackIntent,g as isIntentKind,m as normalizeIntentCompilation,l as requiresHostVerification};

package/dist/domain/media/gateway-media-contract.d.ts

@@ -0,0 +1,23 @@
+/** Mirrors the gateway's public media validation contract. The gateway remains authoritative. */
+export declare const GATEWAY_MEDIA_LIMITS: {
+    readonly imagePromptCharacters: 32000;
+    readonly imageCount: 16;
+    readonly imageEditFileBytes: number;
+    readonly imageEditMaskBytes: number;
+    readonly imageEditTotalBytes: number;
+    readonly audioUploadBytes: number;
+    readonly speechInputCharacters: 4096;
+    readonly speechInstructionsCharacters: 4096;
+    readonly speechVoiceCharacters: 64;
+    readonly audioPromptCharacters: 4096;
+    readonly transcriptionLanguageCharacters: 10;
+};
+/** The installed SDK buffers binary media responses to this exact upper bound. */
+export declare const SDK_BINARY_MEDIA_RESPONSE_BYTES: number;
+type Flags = ReadonlyMap<string, string | boolean>;
+export declare function validateMediaCommandOptions(action: string, positionals: readonly string[], flags: Flags): void;
+export declare function validateImageEditInputCount(paths: readonly string[]): void;
+export declare function validateUploadSize(bytes: number, maximum: number, label: string): void;
+export declare function validateImageEditTotalSize(bytes: number): void;
+export declare function formatByteLimit(bytes: number): string;
+export {};

package/dist/domain/media/gateway-media-contract.js

@@ -0,0 +1 @@
+import{CliError as I}from"../errors/cli-error.js";import{CLI_ERROR_CODES as l}from"../errors/error-codes.js";const p=1e3,s=1e6,u={imagePromptCharacters:32e3,imageCount:16,imageEditFileBytes:47*s,imageEditMaskBytes:4*s,imageEditTotalBytes:128*s,audioUploadBytes:50*s,speechInputCharacters:4096,speechInstructionsCharacters:4096,speechVoiceCharacters:64,audioPromptCharacters:4096,transcriptionLanguageCharacters:10},M=50*1024*1024;function O(e,t,i){v(i),(e==="image.generate"||e==="image.edit")&&C(t,i),e==="image.edit"&&E(i),e==="audio.speech"&&_(t,i),e==="audio.transcribe"&&h(i,!0),e==="audio.translate"&&h(i,!1),e==="video.generate"&&$(i)}function T(e){if(e.length===0)throw n("`--image` requires at least one workspace image path.");if(e.length>u.imageCount)throw n(`Image edits support at most ${u.imageCount} input images.`)}function A(e,t,i){if(!(e>0&&e<=t))throw n(`${i} must be between 1 byte and ${f(t)}.`)}function q(e){if(!(e<=u.imageEditTotalBytes))throw n(`Image edit uploads must not exceed ${f(u.imageEditTotalBytes)} in total.`)}function f(e){return e>=s?`${e/s} MB`:e>=p?`${e/p} KB`:`${e} bytes`}function v(e){const t=r(e,"out");if(c(e,"force")&&t===void 0)throw n("`--force` is only valid with `--out`.")}function C(e,t){d(w(e,"image"),u.imagePromptCharacters,"Image prompt");const i=g(t,"n");if(i!==void 0&&(i<1||i>u.imageCount))throw n(`--n must be an integer between 1 and ${u.imageCount}.`);if(i!==void 0&&i>1&&r(t,"out")!==void 0)throw n("--out can only be used when exactly one image artifact is requested. Use --out-dir instead.");const o=r(t,"size");if(o!==void 0&&o!=="auto"&&!/^\d{2,4}x\d{2,4}$/u.test(o))throw n("--size must be `auto` or WIDTHxHEIGHT.");o!==void 0&&o!=="auto"&&S(o);const a=r(t,"output-format"),m=g(t,"output-compression");if(m!==void 0&&(m<0||m>100))throw n("--output-compression must be an integer between 0 and 100.");if(m!==void 0&&a!=="jpeg"&&a!=="webp")throw n("--output-compression requires --output-format jpeg or webp.");d(r(t,"moderation"),64,"Moderation value"),d(r(t,"user"),255,"User value")}function E(e){if(r(e,"image")===void 0)throw n("Missing required option --image.")}function _(e,t){d(w(e,"speech"),u.speechInputCharacters,"Speech input"),d(x(t,"voice"),u.speechVoiceCharacters,"Voice"),d(r(t,"instructions"),u.speechInstructionsCharacters,"Speech instructions");const i=r(t,"stream-format");if(i!==void 0&&i!=="audio"&&i!=="sse")throw n("--stream-format must be either `audio` or `sse`.");if(i==="sse"&&(r(t,"out")!==void 0||r(t,"out-dir")!==void 0||c(t,"force")))throw n("--stream-format sse cannot be combined with output file options.");const o=b(t,"speed");if(o!==void 0&&(o<.25||o>4))throw n("--speed must be between 0.25 and 4.")}function h(e,t){d(r(e,"prompt"),u.audioPromptCharacters,"Audio prompt");const i=b(e,"temperature");if(i!==void 0&&(i<0||i>1))throw n("--temperature must be between 0 and 1.");if(t&&(d(r(e,"language"),u.transcriptionLanguageCharacters,"Language code"),r(e,"timestamp-granularities")!==void 0&&r(e,"response-format")!=="verbose_json"))throw n("--timestamp-granularities requires --response-format verbose_json.")}function $(e){if(c(e,"no-wait")&&(r(e,"out")!==void 0||r(e,"out-dir")!==void 0||c(e,"force")))throw n("--no-wait cannot be combined with output options. Use video download after the operation completes.")}function S(e){const[t,i]=e.split("x"),o=Number(t),a=Number(i);if(!Number.isSafeInteger(o)||!Number.isSafeInteger(a)||o<1||a<1||o>4096||a>4096||Math.max(o,a)/Math.min(o,a)>3||o%16!==0||a%16!==0)throw n("--size must use positive dimensions up to 4096px, a maximum 3:1 aspect ratio, and multiples of 16.")}function w(e,t){const i=e.join(" ").trim();if(i.length===0)throw n(`A prompt is required for ${t}.`);return i}function x(e,t){const i=r(e,t);if(i===void 0)throw n(`Missing required option --${t}.`);return i}function d(e,t,i){if(e!==void 0&&e.length>t)throw n(`${i} must not exceed ${t} characters.`)}function g(e,t){const i=r(e,t);if(i!==void 0){if(!/^\d+$/u.test(i)||!Number.isSafeInteger(Number(i)))throw n(`--${t} must be an integer.`);return Number(i)}}function b(e,t){const i=r(e,t);if(i===void 0)return;const o=Number(i);if(!Number.isFinite(o))throw n(`--${t} must be a finite number.`);return o}function r(e,t){const i=e.get(t);return typeof i=="string"&&i.trim().length>0?i.trim():void 0}function c(e,t){return e.get(t)===!0||e.get(t)==="true"}function n(e){return new I(l.INVALID_ARGUMENT,e,{category:"media",userMessage:e})}export{u as GATEWAY_MEDIA_LIMITS,M as SDK_BINARY_MEDIA_RESPONSE_BYTES,f as formatByteLimit,T as validateImageEditInputCount,q as validateImageEditTotalSize,O as validateMediaCommandOptions,A as validateUploadSize};

package/dist/domain/media/media-constants.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_VIDEO_POLL_INTERVAL_MS = 5000;
+export declare const DEFAULT_VIDEO_WAIT_TIMEOUT_MS: number;
+export declare const DEFAULT_MEDIA_DOWNLOAD_TIMEOUT_MS = 60000;

package/dist/domain/media/media-constants.js

@@ -0,0 +1 @@
+const _=5e3,E=12e5,T=6e4;export{T as DEFAULT_MEDIA_DOWNLOAD_TIMEOUT_MS,_ as DEFAULT_VIDEO_POLL_INTERVAL_MS,E as DEFAULT_VIDEO_WAIT_TIMEOUT_MS};

package/dist/domain/media/media-contract.d.ts

@@ -0,0 +1,28 @@
+export type MediaArtifactKind = 'image' | 'speech' | 'transcription' | 'translation' | 'video';
+export interface MediaBinary {
+    readonly bytes: Uint8Array;
+    readonly contentType?: string;
+}
+export interface GeneratedImage {
+    readonly base64?: string;
+    readonly url?: string;
+    readonly revisedPrompt?: string;
+}
+export interface VideoOperation {
+    readonly id: string;
+    readonly done: boolean;
+    readonly errorMessage?: string;
+}
+export interface MediaArtifactRequest {
+    readonly kind: MediaArtifactKind;
+    readonly source: string;
+    readonly extension: string;
+    /** Filename stem without extension; the artifact store appends extension. */
+    readonly out?: string;
+    readonly outDir?: string;
+    readonly force: boolean;
+}
+export interface StoredMediaArtifact {
+    readonly path: string;
+    readonly bytes: number;
+}

package/dist/domain/media/media-execution-policy.d.ts

@@ -0,0 +1,9 @@
+export interface MediaExecutionPolicy {
+    readonly videoPollIntervalMs: number;
+    readonly videoWaitTimeoutMs: number;
+    readonly downloadTimeoutMs: number;
+}
+type Environment = Readonly<Record<string, string | undefined>>;
+/** CLI-owned local resource policy. It does not alter gateway or SDK contracts. */
+export declare function resolveMediaExecutionPolicy(environment?: Environment): MediaExecutionPolicy;
+export {};