@zenalexa/unicli 0.211.2 → 0.212.1

package/dist/protocol/acp.d.ts

@@ -0,0 +1,126 @@
+/**
+ * ACP (Agent Client Protocol) server — JSON-RPC 2.0 over stdio.
+ *
+ * ACP is the protocol adopted by the Zed editor and Gemini CLI for agent ↔
+ * editor integration. The canonical spec lives at
+ * https://github.com/zed-industries/agent-client-protocol. Uni-CLI implements
+ * a minimal ACP server so avante.nvim (and other ACP clients) can drive
+ * `unicli` commands directly — the prompt is parsed for `unicli <site>
+ * <cmd>` invocations and executed via the shared pipeline runner.
+ *
+ * Why a separate module from MCP:
+ *   - ACP is editor-oriented (prompt/submit with streaming chunks, session
+ *     lifecycle), MCP is tool-oriented (tools/list, tools/call).
+ *   - ACP responses are natural-language chunks + final result; MCP is
+ *     structured JSON only.
+ *   - Keeping them orthogonal lets each evolve independently.
+ *
+ * Design assumptions (documented because the ACP schema is still evolving):
+ *   - JSON-RPC 2.0 framing: newline-delimited frames on stdio. This matches
+ *     `@agentclientprotocol/schema` convention and what Gemini CLI emits.
+ *   - `initialize` returns `{capabilities, serverInfo, protocolVersion}` —
+ *     mirrors MCP's shape for familiarity.
+ *   - `prompt/submit` streams `content/updated` notifications for progress
+ *     and returns a final `{content, sessionId, ok}` result.
+ *   - `session/*` methods maintain an in-memory map keyed by client-chosen
+ *     id. Sessions hold the last prompt + response for the client to resume
+ *     or cancel. Persistence is out of scope for this shim.
+ *
+ * All non-protocol output (errors, logs) MUST go to stderr — stdout is
+ * reserved for JSON-RPC frames only.
+ */
+import type { AdapterManifest, AdapterCommand } from "../types.js";
+export interface AcpRpcRequest {
+    jsonrpc: "2.0";
+    id?: number | string | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface AcpRpcResponse {
+    jsonrpc: "2.0";
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface AcpRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface AcpSession {
+    id: string;
+    createdAt: number;
+    lastPrompt?: string;
+    lastResult?: unknown;
+    cancelled?: boolean;
+}
+export interface AcpServerOptions {
+    /** Logger for stderr output. Defaults to process.stderr.write. */
+    log?: (message: string) => void;
+    /** Emit a JSON-RPC response or notification frame. Defaults to stdout. */
+    emit?: (frame: AcpRpcResponse | AcpRpcNotification) => void;
+    /** Enable verbose debug logging to stderr. */
+    debug?: boolean;
+}
+export declare class AcpServer {
+    private sessions;
+    private log;
+    private emit;
+    private debug;
+    private initialized;
+    constructor(opts?: AcpServerOptions);
+    /**
+     * Handle a single JSON-RPC frame. Returns the response to emit, or
+     * `undefined` for notifications (no id → no reply).
+     *
+     * Public so the stdio loop and tests can drive the dispatch directly.
+     */
+    handle(req: AcpRpcRequest): Promise<AcpRpcResponse | undefined>;
+    private handleInitialize;
+    private handleAuthenticate;
+    private handleSessionCreate;
+    private handleSessionCancel;
+    private handleSessionList;
+    private handlePromptSubmit;
+    private ensureSession;
+    /** Primarily for tests — surface the in-memory sessions. */
+    getSessions(): AcpSession[];
+    isInitialized(): boolean;
+    /**
+     * Start reading JSON-RPC frames from stdin until EOF. Resolves when
+     * stdin closes. Errors in individual frames are reported as JSON-RPC
+     * error envelopes; fatal I/O errors reject the returned promise.
+     */
+    startStdio(input?: NodeJS.ReadableStream): Promise<void>;
+}
+export interface ParsedInvocation {
+    site: string;
+    command: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Parse a natural-language prompt for a `unicli <site> <command> [args]`
+ * invocation. Matches the literal `unicli` token followed by two identifiers,
+ * then consumes remaining key=value or --flag value tokens plus a single
+ * trailing positional.
+ *
+ * Returns `undefined` when no invocation is detected — caller prints
+ * suggestions.
+ */
+export declare function parseUnicliInvocation(prompt: string): ParsedInvocation | undefined;
+/**
+ * Execute a resolved adapter command with its merged args and return the
+ * raw result array. Shared between ACP and MCP dispatchers.
+ */
+export declare function runCommand(adapter: AdapterManifest, cmd: AdapterCommand, args: Record<string, unknown>): Promise<unknown[]>;
+/**
+ * Suggest at most five candidate commands based on a prompt. Lightweight
+ * substring match over the adapter catalog — good enough for "did you
+ * mean?" hints without pulling in the full BM25 search machinery.
+ */
+export declare function suggestCommands(prompt: string): string;
+//# sourceMappingURL=acp.d.ts.map

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

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