@zenalexa/unicli 0.211.2 → 0.213.0-beta.2

package/dist/output/md.js

@@ -0,0 +1,300 @@
+/**
+ * Agent-Native Markdown renderer — turns an AgentEnvelope into a
+ * frontmatter + sectioned markdown document for LLM consumption.
+ *
+ * Output contract:
+ *  - YAML frontmatter block (always)
+ *  - ## Data (success only)
+ *  - ## Context (success, conditional)
+ *  - ## Next Actions (success, pagination-conditional)
+ *  - ## Error / ## Suggestion / ## Alternatives (error only)
+ *  - Trailing newline
+ */
+const MAX_STRING_LEN = 500;
+const MAX_INLINE_JSON = 200;
+/**
+ * Sanitize for multi-line block contexts (e.g. Suggestion paragraph).
+ * Preserves newlines; only escapes line-start `---` to prevent frontmatter injection.
+ */
+function sanitizeBlock(s) {
+    return s.replace(/^---/gm, "\\---");
+}
+/**
+ * Sanitize for single-line inline contexts (frontmatter values, bullet
+ * keys/values, titles).  Collapses embedded newlines to a space and escapes
+ * a leading `---` so the value cannot break YAML frontmatter.
+ */
+function sanitizeInline(s) {
+    return s
+        .replace(/[\r\n]+/g, " ")
+        .replace(/^---/, "\\---")
+        .trim();
+}
+/** Format a leaf value for a bullet list item. */
+function formatValue(v) {
+    if (v === null)
+        return "(null)";
+    if (v === undefined)
+        return "(undefined)";
+    if (typeof v === "function")
+        return "[Function]";
+    if (Buffer.isBuffer(v))
+        return `[Buffer ${v.byteLength} bytes]`;
+    if (v instanceof Date)
+        return v.toISOString();
+    if (Array.isArray(v))
+        return `[${v.length} items]`;
+    // FIX B3: BigInt explicit early-return — JSON.stringify always throws on BigInt.
+    if (typeof v === "bigint")
+        return `${v.toString()}n`;
+    if (typeof v === "object" && v !== null) {
+        // Fast path: no cycles — JSON.stringify handles DAGs (shared refs) naturally.
+        // Slow path: cycle detected — redo with a replacer that tracks the current
+        // serialization ancestry via the holder object (`this` in the replacer).
+        // FIX B1: outer catch handles objects whose toJSON() throws (unconditional).
+        let json;
+        try {
+            json = JSON.stringify(v);
+        }
+        catch {
+            // Either a circular structure or a throwing toJSON. Try ancestry-tracking
+            // replacer. `this` in the replacer is the holder object; we maintain a path
+            // map from holder → key so we can reconstruct the ancestry Set on each call.
+            try {
+                const ancestors = [];
+                json =
+                    JSON.stringify(v, function (_key, val) {
+                        if (typeof val === "object" && val !== null) {
+                            // Remove any ancestors that are no longer in this holder's chain.
+                            const holderIdx = ancestors.indexOf(this);
+                            if (holderIdx !== -1) {
+                                ancestors.splice(holderIdx + 1);
+                            }
+                            else {
+                                ancestors.length = 0;
+                            }
+                            if (ancestors.includes(val))
+                                return "[Circular]";
+                            ancestors.push(val);
+                        }
+                        return val;
+                    }) ?? "[unserializable]";
+            }
+            catch {
+                // toJSON throws even inside replacer — give up gracefully.
+                return "[unserializable]";
+            }
+        }
+        if (typeof json !== "string")
+            return "[unserializable]";
+        if (json.length > MAX_INLINE_JSON) {
+            return json.slice(0, MAX_INLINE_JSON) + "… (truncated)";
+        }
+        return json;
+    }
+    if (typeof v === "string") {
+        const truncated = v.length > MAX_STRING_LEN
+            ? v.slice(0, MAX_STRING_LEN) + `… (truncated, ${v.length} chars total)`
+            : v;
+        // FIX B2: collapse newlines so multiline strings don't break bullet structure.
+        return truncated.replace(/[\r\n]+/g, " ");
+    }
+    return String(v);
+}
+/** Render YAML frontmatter block. */
+function renderFrontmatter(env) {
+    const lines = ["---"];
+    lines.push(`ok: ${env.ok}`);
+    lines.push(`schema_version: "${env.schema_version}"`);
+    // FIX B2: command value is inline — sanitizeInline.
+    lines.push(`command: ${sanitizeInline(env.command)}`);
+    lines.push(`duration_ms: ${env.meta.duration_ms}`);
+    if (env.ok) {
+        const meta = env.meta;
+        if (meta.count !== undefined)
+            lines.push(`count: ${meta.count}`);
+        if (meta.surface !== undefined)
+            lines.push(`surface: ${sanitizeInline(meta.surface)}`);
+        if (meta.adapter_version !== undefined)
+            // FIX B2: adapter_version with embedded newline must not break YAML block.
+            lines.push(`adapter_version: ${sanitizeInline(meta.adapter_version)}`);
+        if (meta.operator !== undefined)
+            lines.push(`operator: ${sanitizeInline(meta.operator)}`);
+        if (meta.pagination?.next_cursor !== undefined)
+            // FIX B2: cursor value is inline.
+            lines.push(`next_cursor: ${sanitizeInline(String(meta.pagination.next_cursor))}`);
+        if (meta.pagination?.has_more !== undefined)
+            lines.push(`has_more: ${meta.pagination.has_more}`);
+    }
+    else {
+        // error envelope: include surface if present, but NOT error fields
+        const meta = env.meta;
+        if (meta.surface !== undefined)
+            lines.push(`surface: ${sanitizeInline(meta.surface)}`);
+        if (meta.adapter_version !== undefined)
+            lines.push(`adapter_version: ${sanitizeInline(meta.adapter_version)}`);
+        if (meta.operator !== undefined)
+            lines.push(`operator: ${sanitizeInline(meta.operator)}`);
+    }
+    lines.push("---");
+    return lines.join("\n");
+}
+/** Pick a display title from an item object. */
+function pickTitle(item) {
+    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
+        const obj = item;
+        for (const key of ["title", "name", "id"]) {
+            if (obj[key] !== undefined && obj[key] !== null) {
+                // FIX B2: title is placed in a ### header line — must be single-line.
+                return sanitizeInline(String(obj[key]));
+            }
+        }
+    }
+    return "Item";
+}
+/** Render a single array item as ### N · title + bullet list. */
+function renderItem(item, index) {
+    const title = pickTitle(item);
+    const lines = [`### ${index} · ${title}`, ""];
+    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
+        const obj = item;
+        for (const key of Object.keys(obj)) {
+            // FIX B2: key appears inline in a bullet — sanitizeInline.
+            lines.push(`- **${sanitizeInline(key)}**: ${formatValue(obj[key])}`);
+        }
+    }
+    else {
+        lines.push(`- **value**: ${formatValue(item)}`);
+    }
+    return lines.join("\n");
+}
+/** Render the ## Data section for a success envelope. */
+function renderDataSection(data) {
+    const lines = ["## Data", ""];
+    if (Array.isArray(data)) {
+        if (data.length === 0) {
+            lines.push("_(no data)_");
+        }
+        else {
+            for (let i = 0; i < data.length; i++) {
+                lines.push(renderItem(data[i], i + 1));
+                if (i < data.length - 1)
+                    lines.push("");
+            }
+        }
+    }
+    else {
+        const keys = Object.keys(data);
+        if (keys.length === 0) {
+            lines.push("_(no data)_");
+        }
+        else {
+            for (const key of keys) {
+                lines.push(`- **${key}**: ${formatValue(data[key])}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+/** Render the ## Context section (omitted if no bullets). */
+function renderContextSection(meta) {
+    const bullets = [];
+    if (meta.adapter_version !== undefined)
+        // FIX B2: context bullet values are inline.
+        bullets.push(`- **adapter_version**: ${sanitizeInline(meta.adapter_version)}`);
+    if (meta.surface !== undefined)
+        bullets.push(`- **surface**: ${sanitizeInline(meta.surface)}`);
+    if (meta.operator !== undefined)
+        bullets.push(`- **operator**: ${sanitizeInline(meta.operator)}`);
+    if (meta.pagination?.next_cursor !== undefined)
+        bullets.push(`- **next_cursor**: ${sanitizeInline(String(meta.pagination.next_cursor))}`);
+    if (meta.pagination?.has_more !== undefined)
+        bullets.push(`- **has_more**: ${meta.pagination.has_more}`);
+    if (bullets.length === 0)
+        return "";
+    return ["## Context", "", ...bullets].join("\n");
+}
+/** Render ## Next Actions (only when pagination.has_more === true). */
+function renderNextActionsSection(meta) {
+    if (meta.pagination?.has_more !== true)
+        return "";
+    const cursor = meta.pagination?.next_cursor;
+    // FIX B2: cursor in inline code span — sanitizeInline.
+    const cursorStr = cursor !== undefined
+        ? `\`${sanitizeInline(String(cursor))}\``
+        : "(no cursor)";
+    return [
+        "## Next Actions",
+        "",
+        `- Fetch next page with cursor: ${cursorStr}`,
+    ].join("\n");
+}
+/** Render ## Error section for error envelopes. */
+function renderErrorSection(err) {
+    const lines = ["## Error", ""];
+    // FIX B2: error fields are inline bullet values — sanitizeInline.
+    lines.push(`- **code**: ${sanitizeInline(err.code)}`);
+    lines.push(`- **message**: ${formatValue(err.message)}`);
+    if (err.adapter_path !== undefined)
+        lines.push(`- **adapter_path**: ${sanitizeInline(err.adapter_path)}`);
+    if (err.step !== undefined)
+        lines.push(`- **step**: ${err.step}`);
+    if (err.retryable !== undefined)
+        lines.push(`- **retryable**: ${err.retryable}`);
+    return lines.join("\n");
+}
+/** Render ## Suggestion (paragraph, no bullet). */
+function renderSuggestionSection(err) {
+    if (!err.suggestion)
+        return "";
+    // FIX B2: Suggestion is a multi-line paragraph — sanitizeBlock preserves newlines.
+    return ["## Suggestion", "", sanitizeBlock(err.suggestion)].join("\n");
+}
+/** Render ## Alternatives (inline-code bullets). */
+function renderAlternativesSection(err) {
+    if (!err.alternatives || err.alternatives.length === 0)
+        return "";
+    // FIX B2: alternative values appear inside inline code — sanitizeInline.
+    const bullets = err.alternatives.map((a) => `- \`${sanitizeInline(a)}\``);
+    return ["## Alternatives", "", ...bullets].join("\n");
+}
+/** Assemble the success envelope body. */
+function renderSuccess(env) {
+    const parts = [];
+    parts.push(renderFrontmatter(env));
+    parts.push(renderDataSection(env.data));
+    const context = renderContextSection(env.meta);
+    if (context)
+        parts.push(context);
+    const nextActions = renderNextActionsSection(env.meta);
+    if (nextActions)
+        parts.push(nextActions);
+    return parts.join("\n\n") + "\n";
+}
+/** Assemble the error envelope body. */
+function renderError(env) {
+    const parts = [];
+    parts.push(renderFrontmatter(env));
+    parts.push(renderErrorSection(env.error));
+    const suggestion = renderSuggestionSection(env.error);
+    if (suggestion)
+        parts.push(suggestion);
+    const alternatives = renderAlternativesSection(env.error);
+    if (alternatives)
+        parts.push(alternatives);
+    return parts.join("\n\n") + "\n";
+}
+/**
+ * Render an AgentEnvelope as agent-native markdown.
+ *
+ * Pure function — no side effects. Output always ends with a single `\n`.
+ */
+export function renderMd(envelope) {
+    if (envelope.ok) {
+        return renderSuccess(envelope);
+    }
+    else {
+        return renderError(envelope);
+    }
+}
+//# sourceMappingURL=md.js.map

package/dist/output/md.js.map

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

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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"}