@namzu/cli 35.0.0 → 36.1.0

package/dist/commands/acp.d.ts

@@ -1,8 +1,16 @@
 import { type AcpAgentGateway, type ExternalRefTarget, type Origin, type SessionId, type ToolPresenter } from '@namzu/sdk';
+import { type TurnUndoStatus, type UndoPreview } from '../checkpoints/store.js';
 import { resolveTrustedProjectContext } from '../config/trusted-project-context.js';
+import { type PluginInventoryView, readPluginInventory } from '../integrations/plugins/inventory.js';
+import { type ComposerModelSettings } from '../integrations/providers/composer-settings.js';
+import { type ProviderConnection } from '../integrations/providers/connections.js';
 import type { DetectedProvider, Preferences } from '../integrations/providers/index.js';
+import { type CliSessionScope, openSessionScope, openSessions } from '../integrations/sessions/store.js';
+import { palConversationBinding } from '../pals/conversations.js';
+import { getCliPalRuntime } from '../pals/environment.js';
 import { decideHeadlessTrust } from '../permissions/headless-trust.js';
-import { type AgentSession, createAgentSession, probeAgentSession } from '../tui/agent.js';
+import { type AgentSession, createAgentSession, describeProviderModels, describeProviderReasoning, probeAgentSession, verifyCredential } from '../tui/agent.js';
+import { type ProviderRetryStatus, readProviderRetryStatus } from './acp-provider-retry.js';
 import type { CommandContext, CommandDef } from './types.js';
 /**
  * `namzu acp` — the agent-client protocol over this process's stdio.
@@ -40,17 +48,130 @@ export type ExternalSessionLookup = (protocol: 'acp', kind: 'session', externalI
  * finds the same session.
  */
 export declare function resolveAcpSession(wireSessionId: string, lookup: ExternalSessionLookup): Promise<AcpSessionTarget>;
-type AcpLiveSession = Pick<AgentSession, 'hasProvider' | 'errorHint' | 'mcpFailed' | 'send' | 'close' | 'presenter'>;
+type AcpLiveSession = Pick<AgentSession, 'hasProvider' | 'errorHint' | 'mcpFailed' | 'send' | 'close' | 'presenter' | 'jobs' | 'readJob' | 'stopJob' | 'plugins' | 'reasoningEffortLevels' | 'reasoningEffortDefault' | 'imageAttachmentsSupported' | 'documentAttachmentsSupported' | 'checkpoints' | 'markFilesChanged'> & {
+    readonly resumePaused?: AgentSession['resumePaused'];
+    readonly abandonTurn?: AgentSession['abandonTurn'];
+};
 export interface AcpRuntimeDependencies {
+    readonly palBinding?: typeof palConversationBinding;
+    readonly palRuntime?: typeof getCliPalRuntime;
     readonly probe: typeof probeAgentSession;
+    readonly describeModels?: typeof describeProviderModels;
+    readonly verifyKey?: typeof verifyCredential;
+    readonly describeReasoning?: typeof describeProviderReasoning;
+    readonly readPlugins?: typeof readPluginInventory;
     readonly createSession: (preferences: Preferences, detected: readonly DetectedProvider[], options: Parameters<typeof createAgentSession>[2]) => Promise<AcpLiveSession>;
     readonly decideTrust: typeof decideHeadlessTrust;
     readonly resolveProjectContext: typeof resolveTrustedProjectContext;
     /** Which namzu session a wire session id stands for; see {@link resolveAcpSession}. */
     readonly resolveSession: (wireSessionId: string) => Promise<AcpSessionTarget>;
+    /** Durable CLI catalog owned for the lifetime of one runtime session. */
+    readonly openSessions?: typeof openSessions;
+    /** Direct journal reads; legacy injected openSessions remains the fallback when absent. */
+    readonly openSessionScope?: typeof openSessionScope;
+    readonly readRetryStatus?: typeof readProviderRetryStatus;
+}
+/** What a client sends to apply an undo; already validated for shape. */
+export interface TurnUndoRequest {
+    readonly turnId: string;
+    readonly planToken: string;
+    readonly resolutions?: Readonly<Record<string, 'skip' | 'keep_copy'>>;
+    readonly alsoUndoLater?: boolean;
+}
+export interface TurnUndoResult {
+    readonly turnId: string;
+    /** `plan-changed` means nothing was written: `replan` is what to show instead. */
+    readonly status: 'applied' | 'undone' | 'partially_undone' | 'plan-changed';
+    readonly files: Readonly<Record<string, string>>;
+    /** Later replies undone along with it, by turn id. */
+    readonly later?: Readonly<Record<string, Readonly<Record<string, string>>>>;
+    /** Files the operator had changed, saved before being replaced. */
+    readonly copies?: readonly {
+        path: string;
+        sha256: string;
+    }[];
+    readonly replan?: UndoPreview;
+}
+/**
+ * Undo a reply's file changes. Reads and writes the conversation's
+ * `file-history/` and the disk only: a conversation nobody has opened in this
+ * process is undone without building a model session.
+ */
+export interface CliTurnUndo {
+    status(sessionId: string, cwd: string, scope: CliSessionScope, turnIds?: readonly string[]): Promise<{
+        turns: TurnUndoStatus[];
+    }>;
+    preview(sessionId: string, cwd: string, scope: CliSessionScope, turnId: string, options?: {
+        alsoUndoLater?: boolean;
+    }): Promise<UndoPreview>;
+    undo(sessionId: string, cwd: string, scope: CliSessionScope, request: TurnUndoRequest): Promise<TurnUndoResult>;
 }
 export interface CliAcpRuntime {
     readonly gateway: AcpAgentGateway;
+    /** Per-reply file undo; absent on a runtime that keeps no file history. */
+    readonly turnUndo?: CliTurnUndo;
+    /** Live operator text for this connection's current ordinary Namzu prompt only. */
+    liveInputStatus?(sessionId: string, scopeId?: string, scope?: CliSessionScope): Promise<CliLiveInputStatus>;
+    liveInput?(sessionId: string, input: {
+        scopeId: string;
+        inputId: string;
+        prompt: string;
+    }, scope?: CliSessionScope): Promise<{
+        accepted: true;
+        scopeId: string;
+        inputId: string;
+    }>;
+    providerStatus(sessionId?: string): Promise<unknown>;
+    /** Every provider this build can use, and whether this machine has one connected. */
+    providerConnections(): Promise<{
+        providers: ProviderConnection[];
+    }>;
+    /** Save a pasted key privately and forget the cached provider list. */
+    saveProviderKey(provider: string, apiKey: string): Promise<{
+        saved: true;
+    }>;
+    removeProviderKey(provider: string): Promise<{
+        removed: true;
+    }>;
+    /** A cheap authenticated call; never a model turn. */
+    /** Forget the cached provider list so the next read sees keys saved by another connection. */
+    refreshProviders(): Promise<{
+        refreshed: true;
+    }>;
+    testProvider(provider: string): Promise<{
+        status: 'ok' | 'rejected' | 'unchecked' | 'missing';
+        /** Why an unchecked key learned nothing, when the provider's answer says. */
+        cause?: 'quota' | 'busy' | 'down' | 'no-answer';
+    }>;
+    /** The optional scope is a host-authenticated handoff, never a wire-supplied ownership claim. */
+    providerRetryStatus?(sessionId: string, cwd: string, scope?: CliSessionScope): Promise<ProviderRetryStatus>;
+    /**
+     * Close the conversation's paused provider turn without repeating it (`turn_failed`, code
+     * `abandoned`), so the next message starts a new turn. Whatever the stopped request may have
+     * cost stays recorded as unknown. Refuses a turn that waits for a person's decision. The turn's
+     * messages leave the context the next turn carries (the client puts the person's message back
+     * in its message box), while the log keeps them.
+     */
+    abandonPausedTurn?(sessionId: string, cwd: string, turnId?: string, options?: {
+        readonly withdrawMessages?: boolean;
+    }): Promise<{
+        closed: true;
+    }>;
+    modelSettings(provider: string, model: string, sessionId?: string): Promise<ComposerModelSettings>;
+    plugins(cwd: string, sessionId?: string): Promise<PluginInventoryView>;
+    setPluginEnabled(sessionId: string, name: string, enabled: boolean, cwd?: string): Promise<PluginInventoryView>;
+    models(provider: string, sessionId?: string): Promise<{
+        models: {
+            id: string;
+            label: string;
+            note?: string;
+        }[];
+        notice: string | null;
+    }>;
+    selectProvider(sessionId: string, provider: string, model?: string): Promise<void>;
+    jobs(sessionId: string): readonly import('@namzu/sdk').BackgroundJob[];
+    readJob(sessionId: string, jobId: string): unknown;
+    stopJob(sessionId: string, jobId: string): Promise<unknown>;
     /**
      * Delegates to whichever session's own event is being rendered RIGHT NOW
      * — never "whichever session's `prompt` call is live", which two
@@ -71,6 +192,14 @@ export interface CliAcpRuntime {
     readonly presenter: ToolPresenter;
     close(): Promise<void>;
 }
+export interface CliLiveInputStatus {
+    available: boolean;
+    scopeId?: string;
+    inputs: {
+        id: string;
+        status: 'pending' | 'delivered';
+    }[];
+}
 /**
  * Owns the CLI runtime behind one ACP connection.
  *
@@ -79,7 +208,9 @@ export interface CliAcpRuntime {
  * wire session, never one mutable connection-global slot.
  */
 export declare function createCliAcpRuntime(bootstrapCtx: CommandContext, deps?: AcpRuntimeDependencies): CliAcpRuntime;
-export declare function runAcpCommand(ctx: CommandContext): Promise<number>;
+/** Try both resource owners even if conversation shutdown fails. */
+export declare function closeAcpResources(runtime: Pick<CliAcpRuntime, 'close'>, closePals?: () => Promise<void>): Promise<void>;
+export declare function runAcpCommand(ctx: CommandContext, desktop?: boolean): Promise<number>;
 export declare const acpCommand: CommandDef;
 export {};
 //# sourceMappingURL=acp.d.ts.map

package/dist/commands/acp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../src/commands/acp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAGtB,KAAK,MAAM,EAGX,KAAK,SAAS,EACd,KAAK,aAAa,EAMlB,MAAM,YAAY,CAAA;AAMnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAEtE,OAAO,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAmD5D;;;;;;;;;;;;;;;GAeG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,CACnC,QAAQ,EAAE,KAAK,EACf,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,KACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACtC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAgBD,KAAK,cAAc,GAAG,IAAI,CACzB,YAAY,EACZ,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,WAAW,CAC1E,CAAA;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,CACvB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,mBAAmB,CAAA;IAChD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,4BAA4B,CAAA;IACnE,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAC7E;AAQD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAUD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,cAAc,EAC5B,IAAI,GAAE,sBAA6C,GACjD,aAAa,CAoQf;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCxE;AAED,eAAO,MAAM,UAAU,EAAE,UAIxB,CAAA"}
+{"version":3,"file":"acp.d.ts","sourceRoot":"","sources":["../../src/commands/acp.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,iBAAiB,EAGtB,KAAK,MAAM,EAIX,KAAK,SAAS,EACd,KAAK,aAAa,EAQlB,MAAM,YAAY,CAAA;AAOnB,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACpG,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,KAAK,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAEpG,OAAO,EACN,KAAK,qBAAqB,EAE1B,MAAM,gDAAgD,CAAA;AACvD,OAAO,EACN,KAAK,kBAAkB,EAKvB,MAAM,0CAA0C,CAAA;AAMjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAEvF,OAAO,EACN,KAAK,eAAe,EAIpB,gBAAgB,EAChB,YAAY,EAEZ,MAAM,mCAAmC,CAAA;AAM1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,EAAsB,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAI7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAGtE,OAAO,EACN,KAAK,YAAY,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,KAAK,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAI3F,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAmD5D;;;;;;;;;;;;;;;GAeG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,CACnC,QAAQ,EAAE,KAAK,EACf,IAAI,EAAE,SAAS,EACf,UAAU,EAAE,MAAM,KACd,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAA;AAE3C;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACtC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,qBAAqB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAgBD,KAAK,cAAc,GAAG,IAAI,CACzB,YAAY,EACV,aAAa,GACb,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,GACP,WAAW,GACX,MAAM,GACN,SAAS,GACT,SAAS,GACT,SAAS,GACT,uBAAuB,GACvB,wBAAwB,GACxB,2BAA2B,GAC3B,8BAA8B,GAC9B,aAAa,GACb,kBAAkB,CACpB,GAAG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAA;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;CAClD,CAAA;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,sBAAsB,CAAA;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,gBAAgB,CAAA;IAC7C,QAAQ,CAAC,KAAK,EAAE,OAAO,iBAAiB,CAAA;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,sBAAsB,CAAA;IACvD,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,gBAAgB,CAAA;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAA;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,mBAAmB,CAAA;IACjD,QAAQ,CAAC,aAAa,EAAE,CACvB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,SAAS,gBAAgB,EAAE,EACrC,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAC7C,OAAO,CAAC,cAAc,CAAC,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,mBAAmB,CAAA;IAChD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,4BAA4B,CAAA;IACnE,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC7E,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAA;IAC3C,2FAA2F;IAC3F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,gBAAgB,CAAA;IACnD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,uBAAuB,CAAA;CACzD;AAqDD,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAA;IACrE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,kBAAkB,GAAG,cAAc,CAAA;IAC3E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3E,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,MAAM,CACL,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC;QAAE,KAAK,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC,CAAA;IACvC,OAAO,CACN,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,WAAW,CAAC,CAAA;IACvB,IAAI,CACH,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,eAAe,GACtB,OAAO,CAAC,cAAc,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;IAC/B,mFAAmF;IACnF,eAAe,CAAC,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC9B,SAAS,CAAC,CACT,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC3D,KAAK,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAChE,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpD,qFAAqF;IACrF,mBAAmB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAAE,CAAC,CAAA;IACnE,uEAAuE;IACvE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAC3E,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAC/D,sDAAsD;IACtD,8FAA8F;IAC9F,gBAAgB,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAChD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAA;QACnD,6EAA6E;QAC7E,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAA;KAC/C,CAAC,CAAA;IACF,iGAAiG;IACjG,mBAAmB,CAAC,CACnB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC/B;;;;;;OAMG;IACH,iBAAiB,CAAC,CACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC/C,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IAC5B,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAA;IAClG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACtE,gBAAgB,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,GAAG,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC/B,MAAM,CACL,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QACV,MAAM,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;QACtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KACrB,CAAC,CAAA;IACF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClF,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,OAAO,YAAY,EAAE,aAAa,EAAE,CAAA;IACtE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAClD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,MAAM,WAAW,kBAAkB;IAClC,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;KAAE,EAAE,CAAA;CACzD;AAoHD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,YAAY,EAAE,cAAc,EAC5B,IAAI,GAAE,sBAA6C,GACjD,aAAa,CA4pCf;AAED,oEAAoE;AACpE,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,EACrC,SAAS,GAAE,MAAM,OAAO,CAAC,IAAI,CAAsB,GACjD,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA6EzF;AAED,eAAO,MAAM,UAAU,EAAE,UAUxB,CAAA"}

package/dist/commands/computer.d.ts

@@ -0,0 +1,3 @@
+import type { CommandDef } from './types.js';
+export declare const computerCommand: CommandDef;
+//# sourceMappingURL=computer.d.ts.map

package/dist/commands/computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computer.d.ts","sourceRoot":"","sources":["../../src/commands/computer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,eAAO,MAAM,eAAe,EAAE,UAe7B,CAAA"}

package/dist/commands/desktop-host-changes.d.ts

@@ -0,0 +1,65 @@
+import { type GitRunBytes } from './desktop-host-header.js';
+export type ProjectChangeStatus = 'modified' | 'added' | 'deleted' | 'renamed' | 'untracked' | 'binary';
+export interface ProjectChangeFile {
+    path: string;
+    status: ProjectChangeStatus;
+    added: number;
+    removed: number;
+    oldPath?: string;
+    /** Set on a renamed file whose content is not text, so the rename itself stays visible. */
+    binary?: true;
+}
+export interface ProjectChanges {
+    files: ProjectChangeFile[];
+    truncated: boolean;
+}
+export interface ProjectDiff {
+    before: string | null;
+    after: string | null;
+    binary: boolean;
+    truncated: boolean;
+}
+export declare const CHANGES_MAX_FILES = 2000;
+/** Untracked files whose lines are counted; the rest list as new with no count. */
+export declare const CHANGES_UNTRACKED_COUNTED = 200;
+export declare const CHANGES_TIMEOUT_MS = 10000;
+export declare const CHANGES_OUTPUT_CAP: number;
+export declare const DIFF_TEXT_MAX_BYTES: number;
+/** The segments of a project-relative path, or null when the text itself is unacceptable. */
+export declare function projectPathSegments(path: unknown): string[] | null;
+/** Validates the text of `path`, then resolves symlinks and checks the result stays inside `root`. */
+export declare function confineChangePath(root: string, path: unknown): Promise<{
+    segments: string[];
+    absolute: string | null;
+}>;
+interface NumstatRow {
+    path: string;
+    oldPath?: string;
+    added: number;
+    removed: number;
+    binary: boolean;
+}
+/** `git diff --numstat -z`: `A\tR\tpath\0`, or `A\tR\t\0old\0new\0` for a rename; `-\t-` is binary. */
+export declare function parseNumstat(data: Buffer, truncated?: boolean): NumstatRow[];
+/** `git diff --name-status -z`: `M\0path\0`, `R100\0old\0new\0`. Keyed by the current path. */
+export declare function parseNameStatus(data: Buffer, truncated?: boolean): Map<string, {
+    letter: string;
+    oldPath?: string;
+}>;
+/** Lines a text would add: the count of newlines, plus an unterminated last line. */
+export declare function countLines(text: string): number;
+type Decoded = {
+    text: string;
+} | {
+    binary: true;
+};
+/** Strict UTF-8 without NUL bytes, otherwise the content is binary. */
+export declare function decodeText(bytes: Buffer): Decoded;
+export declare function createProjectChanges(options?: {
+    run?: GitRunBytes;
+}): {
+    changes: (cwd: string) => Promise<ProjectChanges | null>;
+    diff: (cwd: string, path: unknown) => Promise<ProjectDiff>;
+};
+export {};
+//# sourceMappingURL=desktop-host-changes.d.ts.map

package/dist/commands/desktop-host-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-host-changes.d.ts","sourceRoot":"","sources":["../../src/commands/desktop-host-changes.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAe,MAAM,0BAA0B,CAAA;AAExE,MAAM,MAAM,mBAAmB,GAC5B,UAAU,GACV,OAAO,GACP,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,CAAA;AAEX,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,mBAAmB,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,IAAI,CAAA;CACb;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,OAAO,CAAA;CAClB;AAED,eAAO,MAAM,iBAAiB,OAAQ,CAAA;AACtC,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAC5C,eAAO,MAAM,kBAAkB,QAAS,CAAA;AACxC,eAAO,MAAM,kBAAkB,QAAc,CAAA;AAC7C,eAAO,MAAM,mBAAmB,QAAkB,CAAA;AAiBlD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAWlE;AAED,sGAAsG;AACtG,wBAAsB,iBAAiB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACX,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAsB1D;AAED,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;CACf;AAUD,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,UAAU,EAAE,CA2B1E;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,UAAQ,GACf,GAAG,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBnD;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,KAAK,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,CAAA;AAGlD,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOjD;AAiCD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,WAAW,CAAA;CAAO;mBAoE3C,MAAM,KAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;gBAgF1C,MAAM,QAAQ,OAAO,KAAG,OAAO,CAAC,WAAW,CAAC;EA8BrE"}

package/dist/commands/desktop-host-header.d.ts

@@ -0,0 +1,30 @@
+export interface ProjectGitState {
+    readonly branch: string | null;
+    readonly subject: string | null;
+}
+export type GitRun = (args: readonly string[], cwd: string) => Promise<string>;
+/** Raw bytes for binary-safe reads. `truncated` when the output cap cut the stream short. */
+export type GitRunBytes = (args: readonly string[], cwd: string, limits: {
+    maxBytes: number;
+    timeoutMs: number;
+}) => Promise<{
+    data: Buffer;
+    truncated: boolean;
+}>;
+export declare const GIT_TIMEOUT_MS = 3000;
+export declare const GIT_OUTPUT_CAP: number;
+export declare const GIT_CACHE_MS = 15000;
+export declare const MARKDOWN_CAP_BYTES: number;
+export declare const runGit: GitRun;
+export declare const runGitBytes: GitRunBytes;
+/** Branch and last commit subject of the repository at `cwd`; null when there is no usable repository. */
+export declare function createProjectGit(options?: {
+    run?: GitRun;
+    now?: () => number;
+}): (cwd: string) => Promise<ProjectGitState | null>;
+/** Cap Markdown at `max` UTF-8 bytes without splitting a character. */
+export declare function capMarkdown(markdown: string, max?: number): {
+    markdown: string;
+    truncated: boolean;
+};
+//# sourceMappingURL=desktop-host-header.d.ts.map

package/dist/commands/desktop-host-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-host-header.d.ts","sourceRoot":"","sources":["../../src/commands/desktop-host-header.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE9E,6FAA6F;AAC7F,MAAM,MAAM,WAAW,GAAG,CACzB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAC3C,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAA;AAElD,eAAO,MAAM,cAAc,OAAQ,CAAA;AACnC,eAAO,MAAM,cAAc,QAAY,CAAA;AACvC,eAAO,MAAM,YAAY,QAAS,CAAA;AAClC,eAAO,MAAM,kBAAkB,QAAkB,CAAA;AAWjD,eAAO,MAAM,MAAM,EAAE,MAclB,CAAA;AAEH,eAAO,MAAM,WAAW,EAAE,WAqBvB,CAAA;AAEH,0GAA0G;AAC1G,wBAAgB,gBAAgB,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,IAsB1E,KAAK,MAAM,KAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAOrD;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAqB;;;EAOrE"}