@lotagate/cli 0.1.24 → 0.1.25

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 i}from"./error-codes.js";class r 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 f(e){if(e instanceof r)return e;const t=o(e),a=l(e);return t==="REQUEST_ABORTED"||c(e)?new r(i.INTERRUPTED,n(e),{category:"agent",userMessage:"The request was interrupted.",retryable:!0,...a,cause:e}):t==="REQUEST_TIMEOUT"||t==="NETWORK_ERROR"?new r(i.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}):t==="REQUEST_VALIDATION_ERROR"||t==="REQUEST_PAYLOAD_TOO_LARGE"?new r(i.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 r(i.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 r(i.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 r(i.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 r(i.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 r(i.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 r(i.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"||d(e)?new r(i.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 r(i.INTERNAL_ERROR,e instanceof Error?e.message:String(e),{category:"general",userMessage:"An internal error occurred.",hint:{actionId:"doctor"},cause:e})}function o(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 c(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 l(e){if(typeof e!="object"||e===null)return{};const t=e;return{...typeof t.correlationId=="string"?{correlationId:t.correlationId}:{},...u(t.details)?{details:t.details}:{}}}function u(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function d(e){return n(e)==="Upstream AI provider request failed."}function n(e){return e instanceof Error?e.message:String(e)}export{r as CliError,f 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-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,9 @@
+/** 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";
+    readonly pdf: "pdf";
+    readonly pptx: "pptx";
+    readonly excel: "excel";
+    readonly docs: "docs";
+};

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

@@ -0,0 +1 @@
+const e={browser:"browser-use",computer:"computer-use",pdf:"pdf",pptx:"pptx",excel:"excel",docs:"docs"};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";const y=128,b={markerDirectory:".lotagate-plugin",manifestFile:"plugin.json",skillsDirectory:"skills",agentsDirectory:"agents",hooksDirectory:"hooks",mcpDirectory:"mcp",readmeFile:"README.md",licenseFile:"LICENSE"};function v(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"),c=o(e,"author"),u=o(e,"license"),l=o(e,"homepage"),m=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},...c===void 0?{}:{author:c},...u===void 0?{}:{license:u},...l===void 0?{}:{homepage:l},...m===void 0?{}:{repository:m},...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{b as PLUGIN_LAYOUT,v 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,41 @@
+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'>[];
+}
+/**
+ * Applies a deterministic safety correction to the model-assisted intent
+ * classification. Direct information questions are answer work, even when
+ * the model describes them with a research-like objective such as "find".
+ * Explicit work requests remain unchanged and continue through host evidence
+ * and verification gates.
+ */
+export declare function stabilizeIntentCompilation(prompt: string, input: IntentCompilationInput): IntentCompilationInput;
+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 h from"node:crypto";import{CliError as u}from"../errors/cli-error.js";import{CLI_ERROR_CODES as d}from"../errors/error-codes.js";import{findUnexpectedRecordKey as c,isRecord as s}from"../validation/record-schema.js";const f=["answer","research","change","automation"];function j(t,e){return e.kind==="answer"||!b(t)?e:{...e,kind:"answer",steps:e.steps.map(i=>({...i,requiresVerification:!1}))}}function p(t){return t==="change"||t==="automation"}function m(t,e=new Date().toISOString()){const i=l(t),n=p(i.kind);return{id:h.randomUUID(),kind:i.kind,objective:i.objective,steps:i.steps.map((o,a)=>({...o,requiresVerification:n||o.requiresVerification,id:`step-${a+1}`})),createdAt:e}}function l(t){if(!s(t))throw r("Intent compilation must be an object.");const e=c(t,["kind","objective","steps"]);if(e!==void 0)throw r(`Unsupported intent field: ${e}.`);const i=t.kind,n=t.objective,o=t.steps;if(!w(i))throw r("Intent kind is invalid.");if(typeof n!="string"||n.trim().length===0||n.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:i,objective:n.trim(),steps:o.map(y)}}function V(t){const e=t.trim();if(e.length===0)throw r("Intent objective is required.");const i=I(e);return m({kind:i,objective:e,steps:[{title:g(i),acceptanceCriteria:[e],requiresVerification:i==="change"||i==="automation"}]})}function g(t){return t==="change"?"Implement and verify the requested change":"Address the requested outcome"}function w(t){return typeof t=="string"&&f.includes(t)}function y(t){if(!s(t))throw r("Intent step is invalid.");const e=c(t,["title","acceptanceCriteria","requiresVerification"]);if(e!==void 0)throw r(`Unsupported intent step field: ${e}.`);const i=t.title,n=t.acceptanceCriteria,o=t.requiresVerification;if(typeof i!="string"||i.trim().length===0||i.length>2048)throw r("Intent step title is invalid.");if(!Array.isArray(n)||n.length===0||n.length>16||n.some(a=>typeof a!="string"||a.trim().length===0||a.length>2048))throw r("Intent acceptance criteria are invalid.");if(typeof o!="boolean")throw r("Intent verification requirement is invalid.");return{title:i.trim(),acceptanceCriteria:n.map(a=>String(a).trim()),requiresVerification:o}}function I(t){const e=t.toLocaleLowerCase();return/(fix|implement|change|refactor|add|remove|sửa|triển khai|thêm|xóa)/u.test(e)?"change":/(research|investigate|audit|analy[sz]e|nghiên cứu|kiểm tra|đánh giá)/u.test(e)?"research":/(run|execute|deploy|monitor|automation|chạy|triển khai|theo dõi)/u.test(e)?"automation":"answer"}function b(t){const e=t.trim().toLocaleLowerCase();return e.length===0||k(e)?!1:/[?؟]/u.test(e)||/(?:^|\s)(?:what|who|where|when|why|how|which|is|are|can|do|does|là gì|ai|ở đâu|khi nào|tại sao|thế nào|như nào|nào|có phải|có .* không|cho biết|nói cho tôi biết)\b/iu.test(e)||/(?:memory|context|ghi nhớ|đã lưu|remembered|what do you know)/iu.test(e)}function k(t){return/(?:implement|fix|change|edit|write|create|remove|delete|build|run|test|audit|research|investigate|analy[sz]e|check|inspect|review|verify|validate|trace|deploy|monitor|sửa|thay đổi|viết|tạo|xóa|chạy|xem|kiểm tra|rà soát|nghiên cứu|triển khai|theo dõi)\b/iu.test(t)}function r(t){return new u(d.INVALID_ARGUMENT,t,{category:"intent",userMessage:t})}export{f as INTENT_KINDS,m as createIntentContract,V as fallbackIntent,w as isIntentKind,l as normalizeIntentCompilation,p as requiresHostVerification,j as stabilizeIntentCompilation};

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 c=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,i,t){v(t),(e==="image.generate"||e==="image.edit")&&C(i,t),e==="image.edit"&&E(t),e==="audio.speech"&&_(i,t),e==="audio.transcribe"&&h(t,!0),e==="audio.translate"&&h(t,!1),e==="video.generate"&&$(t)}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,i,t){if(!(e>0&&e<=i))throw n(`${t} must be between 1 byte and ${f(i)}.`)}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>=c?`${e/c} KB`:`${e} bytes`}function v(e){const i=r(e,"out");if(p(e,"force")&&i===void 0)throw n("`--force` is only valid with `--out`.")}function C(e,i){d(g(e,"image"),u.imagePromptCharacters,"Image prompt");const t=w(i,"n");if(t!==void 0&&(t<1||t>u.imageCount))throw n(`--n must be an integer between 1 and ${u.imageCount}.`);if(t!==void 0&&t>1&&r(i,"out")!==void 0)throw n("--out can only be used when exactly one image artifact is requested. Use --out-dir instead.");const o=r(i,"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(i,"output-format"),m=w(i,"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(i,"moderation"),64,"Moderation value"),d(r(i,"user"),255,"User value")}function E(e){if(r(e,"image")===void 0)throw n("Missing required option --image.")}function _(e,i){d(g(e,"speech"),u.speechInputCharacters,"Speech input"),d(x(i,"voice"),u.speechVoiceCharacters,"Voice"),d(r(i,"instructions"),u.speechInstructionsCharacters,"Speech instructions");const t=b(i,"speed");if(t!==void 0&&(t<.25||t>4))throw n("--speed must be between 0.25 and 4.")}function h(e,i){d(r(e,"prompt"),u.audioPromptCharacters,"Audio prompt");const t=b(e,"temperature");if(t!==void 0&&(t<0||t>1))throw n("--temperature must be between 0 and 1.");if(i&&(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(p(e,"no-wait")&&(r(e,"out")!==void 0||r(e,"out-dir")!==void 0||p(e,"force")))throw n("--no-wait cannot be combined with output options. Use video download after the operation completes.")}function S(e){const[i,t]=e.split("x"),o=Number(i),a=Number(t);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 g(e,i){const t=e.join(" ").trim();if(t.length===0)throw n(`A prompt is required for ${i}.`);return t}function x(e,i){const t=r(e,i);if(t===void 0)throw n(`Missing required option --${i}.`);return t}function d(e,i,t){if(e!==void 0&&e.length>i)throw n(`${t} must not exceed ${i} characters.`)}function w(e,i){const t=r(e,i);if(t!==void 0){if(!/^\d+$/u.test(t)||!Number.isSafeInteger(Number(t)))throw n(`--${i} must be an integer.`);return Number(t)}}function b(e,i){const t=r(e,i);if(t===void 0)return;const o=Number(t);if(!Number.isFinite(o))throw n(`--${i} must be a finite number.`);return o}function r(e,i){const t=e.get(i);return typeof t=="string"&&t.trim().length>0?t.trim():void 0}function p(e,i){return e.get(i)===!0||e.get(i)==="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-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 {};

package/dist/domain/media/media-execution-policy.js

@@ -0,0 +1 @@
+import{CliError as E}from"../errors/cli-error.js";import{CLI_ERROR_CODES as I}from"../errors/error-codes.js";const O=5e3,n=1200*1e3,A=6e4;function M(t=process.env){const _=T(t,"LOTAGATE_VIDEO_POLL_INTERVAL_MS",O),o=T(t,"LOTAGATE_VIDEO_WAIT_TIMEOUT_MS",n);if(o<_)throw r("LOTAGATE_VIDEO_WAIT_TIMEOUT_MS must not be smaller than LOTAGATE_VIDEO_POLL_INTERVAL_MS.");return{videoPollIntervalMs:_,videoWaitTimeoutMs:o,downloadTimeoutMs:T(t,"LOTAGATE_MEDIA_DOWNLOAD_TIMEOUT_MS",A)}}function T(t,_,o){const e=t[_];if(e===void 0||e.trim().length===0)return o;if(!/^\d+$/u.test(e))throw r(`${_} must be a positive integer.`);const i=Number(e);if(!Number.isSafeInteger(i)||i<=0)throw r(`${_} must be a positive integer.`);return i}function r(t){return new E(I.CONFIG_SCHEMA_INVALID,t,{category:"config",userMessage:t})}export{M as resolveMediaExecutionPolicy};

package/dist/domain/memory/memory-kinds.d.ts

@@ -0,0 +1,15 @@
+import type { IntentKind } from '../intent/intent-contract.js';
+export declare const MEMORY_KINDS: readonly ["fact", "preference", "decision", "constraint", "goal", "procedure", "episodic", "lesson"];
+export type MemoryKind = typeof MEMORY_KINDS[number];
+export interface MemoryKindDefinition {
+    readonly id: MemoryKind;
+    readonly description: string;
+    readonly captureSignals: readonly string[];
+    readonly intentKinds: readonly IntentKind[];
+    readonly retrievalRole: 'grounding' | 'behavior' | 'control' | 'planning' | 'workflow' | 'experience';
+    readonly freshness: 'stable' | 'latest' | 'expiring' | 'decaying';
+    readonly consolidationPolicy: 'merge' | 'supersede' | 'retain' | 'retain-on-conflict';
+}
+export declare const MEMORY_KIND_DEFINITIONS: readonly MemoryKindDefinition[];
+export declare function isMemoryKind(value: unknown): value is MemoryKind;
+export declare function memoryKindDefinition(kind: MemoryKind): MemoryKindDefinition;

package/dist/domain/memory/memory-kinds.js

@@ -0,0 +1 @@
+const o=["fact","preference","decision","constraint","goal","procedure","episodic","lesson"],i=[{id:"fact",description:"A stable declarative fact about the user, project, or environment.",captureSignals:["is","uses","has","located"],intentKinds:["answer","research","change","automation"],retrievalRole:"grounding",freshness:"stable",consolidationPolicy:"retain-on-conflict"},{id:"preference",description:"A user preference about how the agent should behave or communicate.",captureSignals:["prefer","always","do not","style"],intentKinds:["answer","research"],retrievalRole:"behavior",freshness:"latest",consolidationPolicy:"supersede"},{id:"decision",description:"An accepted choice and its rationale that can be superseded later.",captureSignals:["decided","choose","approved","will use"],intentKinds:["answer","research","change","automation"],retrievalRole:"control",freshness:"latest",consolidationPolicy:"supersede"},{id:"constraint",description:"An active rule describing what the agent must or must not do.",captureSignals:["must","must not","required","never"],intentKinds:["change","automation"],retrievalRole:"control",freshness:"stable",consolidationPolicy:"retain-on-conflict"},{id:"goal",description:"A durable future objective that is distinct from one running session goal.",captureSignals:["want to","goal","plan to","target"],intentKinds:["change","automation"],retrievalRole:"planning",freshness:"expiring",consolidationPolicy:"supersede"},{id:"procedure",description:"A reusable workflow or method for accomplishing an operation.",captureSignals:["step","workflow","run","process"],intentKinds:["change","automation"],retrievalRole:"workflow",freshness:"latest",consolidationPolicy:"supersede"},{id:"episodic",description:"A bounded past event, outcome, or failure with temporal context.",captureSignals:["completed","failed","happened","outcome"],intentKinds:["research","change","automation"],retrievalRole:"experience",freshness:"decaying",consolidationPolicy:"retain"},{id:"lesson",description:"A generalizable lesson distilled from one or more past experiences.",captureSignals:["learned","lesson","avoid","because"],intentKinds:["research","change","automation"],retrievalRole:"experience",freshness:"decaying",consolidationPolicy:"merge"}];function t(e){return typeof e=="string"&&o.includes(e)}function r(e){return i.find(n=>n.id===e)}export{o as MEMORY_KINDS,i as MEMORY_KIND_DEFINITIONS,t as isMemoryKind,r as memoryKindDefinition};

package/dist/domain/memory/memory-retrieval-policy.d.ts

@@ -0,0 +1,3 @@
+import type { IntentKind } from '../intent/intent-contract.js';
+import { type MemoryKind } from './memory-kinds.js';
+export declare function preferredMemoryKinds(intentKind: IntentKind | undefined): readonly MemoryKind[] | undefined;

package/dist/domain/memory/memory-retrieval-policy.js

@@ -0,0 +1 @@
+import{MEMORY_KIND_DEFINITIONS as n}from"./memory-kinds.js";function i(r){return r===void 0?void 0:n.filter(e=>e.intentKinds.includes(r)).map(e=>e.id)}export{i as preferredMemoryKinds};

package/dist/domain/memory/memory-search.d.ts

@@ -0,0 +1,33 @@
+import type { MemoryKind } from './memory-kinds.js';
+import type { MemoryRecord } from './memory.js';
+export interface MemorySearchQuery {
+    readonly text: string;
+    readonly maximum: number;
+    readonly preferredKinds?: readonly MemoryKind[];
+}
+export interface MemorySearchHit {
+    readonly record: MemoryRecord;
+    readonly lexicalScore: number;
+    readonly rank: number;
+}
+export interface MemorySemanticHit {
+    readonly record: MemoryRecord;
+    readonly similarity: number;
+    readonly rank: number;
+}
+export interface MemorySearchDocument {
+    readonly id: string;
+    readonly termFrequency: Readonly<Record<string, number>>;
+    readonly length: number;
+}
+export interface MemorySearchIndex {
+    readonly documents: Readonly<Record<string, MemorySearchDocument>>;
+    readonly postings: Readonly<Record<string, readonly string[]>>;
+    readonly documentFrequency: Readonly<Record<string, number>>;
+    readonly averageDocumentLength: number;
+}
+export declare function buildMemorySearchIndex(records: readonly MemoryRecord[]): MemorySearchIndex;
+export declare function searchMemoryIndex(recordsById: Readonly<Record<string, MemoryRecord>>, index: MemorySearchIndex, query: MemorySearchQuery): readonly MemorySearchHit[];
+export declare function normalizeSearchText(value: string): string;
+export declare function uniqueTokens(value: string): readonly string[];
+export declare function isMemoryRetrievable(record: MemoryRecord, now?: number): boolean;