@chances-ai/client 24.0.0

package/dist/client-core/client.d.ts

@@ -0,0 +1,145 @@
+/**
+ * (v17 M1 / v19 M2 / v20 M3) `RpcClient` — the pure-TS ACP client state machine.
+ * It owns the transport, a browser-safe `LocalEventBus`, the reused
+ * `ChatViewModel` (transcript), and a vanilla-zustand control store. Inbound ACP
+ * `session/update` notifications are reverse-mapped to `AppEvent`s on the bus
+ * that drives the ChatViewModel; the `session/prompt` response, the
+ * `session/request_permission` request, and the chances extension event/responses
+ * drive the control store. Outbound commands are ACP JSON-RPC. No DOM/React/Ink
+ * here — that is web-ui's job.
+ *
+ * **Self-rolled ACP, not the SDK runtime (docs/6.4a §3).** The relay fans one
+ * session out to many sockets, so the SDK's point-to-point `ClientSideConnection`
+ * (which owns JSON-RPC id correlation for one socket) doesn't fit. We frame ACP
+ * ourselves on the same transport seam, keeping the M2 reconnect machinery: ids
+ * are prefixed per client so a fan-out response can't cross-talk between tabs
+ * (`ownsId`); a re-received `session/request_permission` for an already-pending
+ * id is idempotent; permission answers are ACP responses to the agent's request.
+ *
+ * Handshake: on the first (or a cold-reloaded) `relay_welcome`, the client sends
+ * ACP `initialize` then `session/new` to learn its capabilities/models +
+ * sessionId; a RESUMING reconnect skips the handshake (it already has them) and
+ * just replays the gap. The wire is real ACP — a plain ACP client/Zed speaks the
+ * same `initialize`/`session/*` it does (proven by the c6 SDK-interop test).
+ */
+import { ChatViewModel, type ChatViewModelOptions } from "@chances-ai/ui-core";
+import type { ApprovalMode } from "@chances-ai/runtime";
+import { type ClientStore, type GitDiffResult, type GitStatusResult, type ListFilesResult, type QuestionAnswer, type ReadFileResult } from "./store.js";
+import type { TransportFactory } from "./transport.js";
+/** Schedule `run` after `delayMs`; returns a cancel fn. Injected so reconnect
+ *  timing is deterministic in tests (no real timers). */
+export type ReconnectScheduler = (delayMs: number, run: () => void) => () => void;
+export interface ReconnectOptions {
+    schedule?: ReconnectScheduler;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    staleAfterMs?: number;
+}
+export interface RpcClientOptions {
+    scheduler?: ChatViewModelOptions["scheduler"];
+    home?: string;
+    reconnect?: ReconnectOptions;
+    /** Per-client id prefix so two tabs' command ids never collide on the fan-out
+     *  response stream. Defaults to a short random token. */
+    clientId?: string;
+}
+export declare class RpcClient {
+    readonly view: ChatViewModel;
+    readonly store: ClientStore;
+    private readonly bus;
+    private readonly factory;
+    private readonly handlers;
+    private transport;
+    private seq;
+    private readonly clientId;
+    /** In-flight request/response waiters (initialize/session.new/ping/set_model). */
+    private readonly waiters;
+    private userClosed;
+    private transportDown;
+    private reconnectAttempt;
+    private reconnectBudgetMs;
+    private cancelReconnect;
+    private readonly schedule;
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly staleAfterMs;
+    constructor(factory: TransportFactory, opts?: RpcClientOptions);
+    private connect;
+    /** Submit a prompt (ACP `session/prompt`). Echoes a user line + optimistically
+     *  marks busy; a rejected response (AGENT_BUSY) clears it. */
+    prompt(text: string): void;
+    /** Cancel the running turn (ACP `session/cancel` notification). */
+    abort(): void;
+    /** Claim the controller lease — a handoff (no effect when the lease is disabled,
+     *  since everyone already drives). The relay broadcasts the new holder/epoch as
+     *  a `_chances/unstable/control` notification that recomputes `isController`. */
+    takeControl(): void;
+    /** Switch model (chances extension). Resolves with the ack result. */
+    setModel(selection: {
+        provider?: string;
+        model?: string;
+    }): Promise<unknown>;
+    /** (v22) Set the session approval mode (chances extension `set_approval`), the
+     *  GUI twin of the TUI Shift+Tab. Allowed mid-turn (applies to the next
+     *  permission check). Optimistically updates the store, then reconciles with
+     *  the ack (the engine echoes the mode it actually applied). */
+    setApprovalMode(mode: ApprovalMode): Promise<unknown>;
+    /** (v22) Advance the approval mode one step in the Shift+Tab cycle. */
+    cycleApprovalMode(): Promise<unknown>;
+    /** Answer the open permission ask — an ACP RESPONSE to the agent's
+     *  `session/request_permission` request (id = the ask id). No-op when none. */
+    answerPermission(allow: boolean, remember?: boolean): void;
+    /** (v22) Answer the open `ask_user_question` — an ACP RESPONSE to the agent's
+     *  `_chances/unstable/request_question` request (id = the ask id). `declined`
+     *  cancels. No-op when none pending. */
+    answerQuestion(answer: QuestionAnswer): void;
+    /** Liveness probe (chances extension `_chances/unstable/ping`). */
+    ping(): Promise<unknown>;
+    /** List the immediate children of `dir` (one level, lazy). The file tree calls
+     *  this per-expand; results stay component-local (not in the store). */
+    listFiles(dir: string): Promise<ListFilesResult>;
+    /** Read a workspace file (capped + binary-guarded) and set it as the open file
+     *  in the store so the code viewer renders it. */
+    openFileInViewer(path: string): Promise<ReadFileResult>;
+    /** Refresh `git_status` into the store (shared by the environment panel + the
+     *  file tree change badges). */
+    refreshGitStatus(): Promise<GitStatusResult>;
+    /** `git diff [path]` — the code viewer fetches this on demand (component-local). */
+    gitDiff(path?: string): Promise<GitDiffResult>;
+    /** Shared request/response helper for the read-only queries. */
+    private query;
+    /** Close the transport for good — a USER close, so NO reconnect follows. */
+    close(): void;
+    private handleMessage;
+    /** A `relay_welcome`: adopt the snapshot, clear backoff, cold-reload if stale,
+     *  and (re)handshake if this is a fresh/cold session. */
+    private onWelcome;
+    private doHandshake;
+    private coldReload;
+    private onSessionUpdate;
+    private onPermissionRequest;
+    /** (v22) An incoming `_chances/unstable/request_question` — park it for the UI.
+     *  Idempotent on re-send (M2), mirroring the permission ask. */
+    private onQuestionRequest;
+    private onExtEvent;
+    /** A `_chances/unstable/control` notification (a lease handoff / state change):
+     *  recompute whether THIS client may drive. */
+    private onControlState;
+    /** Derive lease UI state: this client may drive when the lease is OFF (everyone
+     *  drives) OR it holds the lease (`holder === clientId`). */
+    private leaseStateFrom;
+    private onResponse;
+    /** The `session/prompt` response folds the turn end (chances `result` frame):
+     *  clear busy + any pending permission, record stopReason/usage, commit the VM. */
+    private onTurnEnd;
+    private onTransportDown;
+    private scheduleReconnect;
+    private toTerminal;
+    private rejectWaiters;
+    private sessionId;
+    private nextId;
+    private ownsId;
+    private sendRaw;
+    private expectResponse;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client-core/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client-core/client.ts"],"names":[],"mappings":"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"}