@prestyj/cli 5.10.0 → 5.12.0

package/dist/modes/acp-mode.d.ts

@@ -0,0 +1,122 @@
+import type { Message, Provider, ThinkingLevel } from "@prestyj/ai";
+import type { EventBus } from "../core/event-bus.js";
+/** The ACP major version this mode implements. Bumped only for breaking changes. */
+export declare const ACP_PROTOCOL_VERSION = 1;
+/**
+ * The slice of {@link AgentSession} this mode uses.
+ *
+ * Narrowed to an interface so a test can drive the whole protocol without a
+ * provider, credentials or a network — the transport is what is under test,
+ * and a real model would make the frames non-deterministic.
+ */
+export interface AcpAgentSession {
+    readonly eventBus: Pick<EventBus, "on">;
+    initialize(): Promise<void>;
+    prompt(content: string): Promise<void>;
+    getState(): {
+        sessionId: string;
+        provider: Provider;
+        model: string;
+    };
+    /**
+     * Context accounting for the ACP `usage_update` notification. Optional so a
+     * test double or an alternative session implementation need not carry token
+     * accounting — a session without it simply reports no usage.
+     */
+    getContextUsage?(): {
+        used: number;
+        size: number;
+        costUsd?: number;
+    };
+    dispose(): Promise<void>;
+    /** Replace the turn-cancellation signal so the session remains reusable. */
+    setSignal(signal: AbortSignal): void;
+    /** Replay a session file from disk into this session. */
+    loadSession(sessionPath: string): Promise<void>;
+    /** The conversation as restored, used to replay history to the client. */
+    getMessages(): Message[];
+    switchModel(provider: string, model: string): Promise<void>;
+    getThinkingLevel(): ThinkingLevel | undefined;
+    setThinkingLevel(level: ThinkingLevel | undefined): void;
+    /** Plan mode is GG's session mode: read-only research until exit_plan. */
+    getPlanMode(): boolean;
+    setPlanMode(active: boolean): Promise<void>;
+    /** Bake an approved plan into the prompt so [DONE:n] progress markers work. */
+    setApprovedPlan(planPath: string | undefined): Promise<void>;
+    /**
+     * Registry commands (/model, /compact, …), including any an extension
+     * registered during `initialize`. Optional so a test double need not carry a
+     * registry — a session without one simply advertises no registry commands.
+     */
+    readonly slashCommands?: {
+        getAll(): {
+            name: string;
+            aliases: string[];
+            description: string;
+            usage: string;
+        }[];
+    };
+}
+/**
+ * The plan-mode callbacks the agent loop calls when the model uses the
+ * `enter_plan` / `exit_plan` tools.
+ *
+ * Handed to the session factory rather than built inside it so a test double
+ * can drive plan mode without a model: approving a plan is what turns it into
+ * the client's to-do list, and that path is otherwise unreachable.
+ */
+export interface AcpPlanHooks {
+    onEnterPlan: () => Promise<void>;
+    /** Returns the instruction handed back to the model after approval. */
+    onExitPlan: (planPath: string) => Promise<string>;
+}
+export interface AcpModeOptions {
+    provider: Provider;
+    model: string;
+    cwd: string;
+    version: string;
+    baseUrl?: string;
+    systemPrompt?: string;
+    thinkingLevel?: ThinkingLevel;
+    /** Defaults to `process.stdin` / `process.stdout`. */
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    /**
+     * Builds the session for `session/new`. Overridden by tests; production
+     * always gets a real {@link AgentSession}.
+     */
+    createSession?: (signal: AbortSignal, hooks: AcpPlanHooks) => AcpAgentSession;
+}
+/** The selectors this agent exposes. Ids are part of the wire contract. */
+export declare const MODEL_CONFIG_ID = "model";
+export declare const THINKING_CONFIG_ID = "thinking";
+export declare const MODE_CONFIG_ID = "mode";
+/**
+ * Turn a restored conversation into the `session/update` stream a client needs
+ * to draw it.
+ *
+ * ACP has no "here is the transcript" response: a loaded session is replayed as
+ * the same notifications a live turn produces, so the client needs no second
+ * rendering path. Thinking is deliberately NOT replayed — it is transient by
+ * design, and a wall of stale reasoning above a resumed conversation buries the
+ * thing the user came back for.
+ *
+ * Each replayed chunk carries a `messageId` so a client can group chunks into
+ * the messages they came from; ids are per-replay and positional, which is all
+ * the protocol needs of them.
+ */
+export declare function historyUpdates(messages: readonly Message[]): Record<string, unknown>[];
+/**
+ * Serve ACP on stdio until the input stream ends.
+ *
+ * Resolves when the client disconnects; the caller owns process exit.
+ */
+export declare function runAcpMode(options: AcpModeOptions): Promise<void>;
+/**
+ * CLI entry point: serve ACP on the real stdio, then exit.
+ *
+ * Split from {@link runAcpMode} so the protocol can be tested without the
+ * process-level side effects (signal handlers, logger teardown, exit codes).
+ */
+export declare function runAcpModeCli(options: AcpModeOptions): Promise<void>;
+//# sourceMappingURL=acp-mode.d.ts.map

package/dist/modes/acp-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-mode.d.ts","sourceRoot":"","sources":["../../src/modes/acp-mode.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AA0BrD,oFAAoF;AACpF,eAAO,MAAM,oBAAoB,IAAI,CAAC;AA8BtC;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE;;;;OAIG;IACH,eAAe,CAAC,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,4EAA4E;IAC5E,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,yDAAyD;IACzD,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,0EAA0E;IAC1E,WAAW,IAAI,OAAO,EAAE,CAAC;IACzB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAAC;IAC9C,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,IAAI,CAAC;IACzD,0EAA0E;IAC1E,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,+EAA+E;IAC/E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,MAAM,IAAI;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KACrF,CAAC;CACH;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,uEAAuE;IACvE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,eAAe,CAAC;CAC/E;AA+LD,2EAA2E;AAC3E,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAC7C,eAAO,MAAM,cAAc,SAAS,CAAC;AA6MrC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAoEtF;AAID;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAs4BvE;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1E"}