@zenalexa/unicli 0.210.0 → 0.212.1

package/dist/mcp/schema.js

@@ -0,0 +1,136 @@
+/**
+ * Shared JSON Schema builders for MCP tools and CLI schema command.
+ *
+ * Single source of truth for:
+ *   - Adapter arg → JSON Schema type mapping
+ *   - Input/output schema generation from AdapterCommand metadata
+ *   - Tool name normalization (site + command → MCP tool name)
+ *   - Description truncation within token budgets
+ */
+// ── Type Mapping ────────────────────────────────────────────────────────────
+/**
+ * Map adapter `arg.type` to JSON Schema primitive.
+ * Defaults to "string" for unknown/missing — safer than failing the build.
+ */
+export function jsonTypeFor(t) {
+    switch (t) {
+        case "int":
+            return "integer";
+        case "float":
+            return "number";
+        case "bool":
+            return "boolean";
+        case "str":
+        default:
+            return "string";
+    }
+}
+// ── Schema Builders ─────────────────────────────────────────────────────────
+/**
+ * Build JSON Schema for a command's input from its `args` definition.
+ * Always includes a `limit` parameter (default 20) for result capping.
+ */
+export function buildInputSchema(cmd) {
+    const props = {
+        limit: {
+            type: "integer",
+            description: "Cap result count (default 20)",
+            default: 20,
+        },
+    };
+    const required = [];
+    for (const a of cmd.adapterArgs ?? []) {
+        if (a.name === "limit")
+            continue;
+        const prop = {
+            type: jsonTypeFor(a.type),
+            description: a.description,
+        };
+        if (a.default !== undefined)
+            prop.default = a.default;
+        if (a.choices)
+            prop.enum = a.choices;
+        props[a.name] = prop;
+        if (a.required)
+            required.push(a.name);
+    }
+    const schema = {
+        type: "object",
+        properties: props,
+        additionalProperties: false,
+    };
+    if (required.length > 0)
+        schema.required = required;
+    return schema;
+}
+/**
+ * Build JSON Schema for a command's output.
+ *
+ * Two formats:
+ *   - `wrapped` (MCP): `{count: int, results: [{...columns}]}`
+ *   - `flat` (CLI schema): `[{...columns}]`
+ *
+ * MCP clients expect the wrapped format; the CLI `unicli schema` command
+ * exposes the flat array format for simpler consumption.
+ */
+export function buildOutputSchema(cmd, format = "wrapped") {
+    const itemProps = {};
+    for (const col of cmd.columns ?? []) {
+        itemProps[col] = { type: "string", description: `Column: ${col}` };
+    }
+    const itemSchema = {
+        type: "object",
+        ...(Object.keys(itemProps).length > 0 ? { properties: itemProps } : {}),
+    };
+    if (format === "flat") {
+        return { type: "array", items: itemSchema };
+    }
+    return {
+        type: "object",
+        properties: {
+            count: { type: "integer", description: "Number of results returned" },
+            results: {
+                type: "array",
+                description: "Result rows",
+                items: itemSchema,
+            },
+        },
+    };
+}
+// ── Tool Name ───────────────────────────────────────────────────────────────
+/**
+ * Build normalized MCP tool name: `unicli_<site>_<command>`.
+ *
+ * Non-alphanumeric chars collapse to `_`. This normalization is NOT
+ * reversible — callers must use a lookup table for reverse mapping.
+ */
+export function buildToolName(site, command) {
+    return `unicli_${site}_${command}`.replace(/[^a-zA-Z0-9_]/g, "_");
+}
+// ── Description Truncation ──────────────────────────────────────────────────
+/**
+ * Approximate token count. Uses `words × 1.3` — closely tracks
+ * tiktoken cl100k for English + mixed-case identifiers.
+ */
+export function approxTokens(text) {
+    const words = text.split(/\s+/).filter(Boolean).length;
+    return Math.ceil(words * 1.3);
+}
+/**
+ * Truncate description to fit within a token budget.
+ * Cuts at word boundary, appends "…" when truncated.
+ */
+export function truncateDescription(desc, maxTokens = 68) {
+    if (approxTokens(desc) <= maxTokens)
+        return desc;
+    const words = desc.split(/\s+/).filter(Boolean);
+    let result = "";
+    for (const word of words) {
+        const candidate = result ? `${result} ${word}` : word;
+        if (approxTokens(candidate + " …") > maxTokens)
+            break;
+        result = candidate;
+    }
+    return result ? `${result} …` : words[0] + " …";
+}
+//# sourceMappingURL=schema.js.map

package/dist/mcp/schema.js.map

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

package/dist/mcp/server.d.ts

@@ -3,24 +3,42 @@
  * MCP (Model Context Protocol) server for Uni-CLI.
  *
  * Two registration modes:
- *   1. **Expanded (default)** — one tool per adapter command
+ *   1. **Smart default** — 3 tools: `unicli_run`, `unicli_list`,
+ *      `unicli_discover`. Keeps the MCP handshake under 200 tokens.
+ *   2. **Expanded (`--expanded`)** — one tool per adapter command
  *      (`unicli_<site>_<command>`) with JSON Schema derived from `args` +
- *      `columns`. This is the production mode the v0.208 plan calls out:
- *      MCP clients see the full Uni-CLI surface area without an extra
- *      list_adapters → run_command roundtrip.
- *   2. **Lazy (`--lazy`)** — only `list_adapters` + `run_command` are
- *      registered. Useful when an MCP client has a hard tool-count limit
- *      or wants the smallest possible handshake.
+ *      `columns`. MCP clients see the full Uni-CLI surface area.
  *
- * Two transports:
+ * Three transports:
  *   - **stdio (default)** — newline-delimited JSON over stdin/stdout
  *   - **http (`--transport http [--port 19826]`)** — POST /mcp accepts a
- *     single JSON-RPC envelope and returns a single JSON response. No
- *     SSE streaming yet — additive in a future release.
+ *     single JSON-RPC envelope and returns a single JSON response.
+ *   - **sse (`--transport sse [--port 19826]`)** — Streamable HTTP with
+ *     Server-Sent Events. GET /mcp/sse opens the event stream, POST
+ *     /mcp/message?sessionId=xxx delivers JSON-RPC requests.
  *
  * Auth pass-through is automatic: every adapter the CLI loads (including
  * cookie-based ones) is exposed by name; the runtime resolves cookies on
  * each call via the same code path as the CLI.
  */
+interface McpStructuredContent {
+    type: "json";
+    data: unknown;
+}
+interface McpToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent?: McpStructuredContent;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+/**
+ * Annotate a tool result with `_meta.anthropic/maxResultSizeChars` when the
+ * serialized payload exceeds MAX_RESULT_SIZE_CHARS (10 KB). This tells
+ * Claude Code to accept large payloads without truncation.
+ */
+export declare function annotateIfLarge(result: McpToolResult): McpToolResult;
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AA4DH,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;CACf;AAED,UAAU,aAAa;IACrB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAgXD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CASpE"}