npm - @zenalexa/unicli - Versions diffs - 0.210.0 → 0.211.2 - Mend

@zenalexa/unicli 0.210.0 → 0.211.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (81) hide show

package/AGENTS.md +21 -7
package/README.md +680 -83
package/dist/cli.d.ts.map +1 -1
package/dist/cli.js +5 -0
package/dist/cli.js.map +1 -1
package/dist/commands/agents.d.ts +14 -3
package/dist/commands/agents.d.ts.map +1 -1
package/dist/commands/agents.js +369 -140
package/dist/commands/agents.js.map +1 -1
package/dist/commands/mcp.d.ts +3 -4
package/dist/commands/mcp.d.ts.map +1 -1
package/dist/commands/mcp.js +47 -62
package/dist/commands/mcp.js.map +1 -1
package/dist/commands/schema.d.ts +12 -0
package/dist/commands/schema.d.ts.map +1 -0
package/dist/commands/schema.js +72 -0
package/dist/commands/schema.js.map +1 -0
package/dist/commands/search.d.ts +12 -0
package/dist/commands/search.d.ts.map +1 -0
package/dist/commands/search.js +47 -0
package/dist/commands/search.js.map +1 -0
package/dist/discovery/aliases.d.ts +31 -0
package/dist/discovery/aliases.d.ts.map +1 -0
package/dist/discovery/aliases.js +477 -0
package/dist/discovery/aliases.js.map +1 -0
package/dist/discovery/loader.d.ts.map +1 -1
package/dist/discovery/loader.js +25 -0
package/dist/discovery/loader.js.map +1 -1
package/dist/discovery/search.d.ts +73 -0
package/dist/discovery/search.d.ts.map +1 -0
package/dist/discovery/search.js +355 -0
package/dist/discovery/search.js.map +1 -0
package/dist/manifest-compact.txt +15 -0
package/dist/manifest-search.json +1 -0
package/dist/manifest.json +433 -244
package/dist/mcp/oauth.d.ts +33 -0
package/dist/mcp/oauth.d.ts.map +1 -0
package/dist/mcp/oauth.js +220 -0
package/dist/mcp/oauth.js.map +1 -0
package/dist/mcp/schema.d.ts +65 -0
package/dist/mcp/schema.d.ts.map +1 -0
package/dist/mcp/schema.js +136 -0
package/dist/mcp/schema.js.map +1 -0
package/dist/mcp/server.d.ts +23 -10
package/dist/mcp/server.d.ts.map +1 -1
package/dist/mcp/server.js +350 -182
package/dist/mcp/server.js.map +1 -1
package/dist/mcp/sse-transport.d.ts +34 -0
package/dist/mcp/sse-transport.d.ts.map +1 -0
package/dist/mcp/sse-transport.js +182 -0
package/dist/mcp/sse-transport.js.map +1 -0
package/dist/mcp/streamable-http.d.ts +64 -0
package/dist/mcp/streamable-http.d.ts.map +1 -0
package/dist/mcp/streamable-http.js +312 -0
package/dist/mcp/streamable-http.js.map +1 -0
package/dist/permissions/sensitive-paths.js +2 -2
package/dist/permissions/sensitive-paths.js.map +1 -1
package/package.json +7 -7
package/src/adapters/1688/_site.json +9 -0
package/src/adapters/barchart/_site.json +10 -0
package/src/adapters/jd/_site.json +9 -0
package/src/adapters/linkedin/_site.json +10 -0
package/src/adapters/macos/finder-copy.yaml +40 -0
package/src/adapters/macos/finder-move.yaml +40 -0
package/src/adapters/macos/finder-new-folder.yaml +36 -0
package/src/adapters/macos/safari-history.yaml +23 -0
package/src/adapters/macos/safari-url.yaml +22 -0
package/src/adapters/macos/screen-recording.yaml +32 -0
package/src/adapters/macos/wallpaper.yaml +33 -0
package/src/adapters/reuters/_site.json +9 -0
package/src/adapters/sinablog/_site.json +9 -0
package/src/adapters/smzdm/_site.json +9 -0
package/src/adapters/weixin/_site.json +9 -0
package/src/adapters/1688/manifest.yaml +0 -7
package/src/adapters/barchart/manifest.yaml +0 -8
package/src/adapters/jd/manifest.yaml +0 -7
package/src/adapters/linkedin/manifest.yaml +0 -8
package/src/adapters/reuters/manifest.yaml +0 -7
package/src/adapters/sinablog/manifest.yaml +0 -7
package/src/adapters/smzdm/manifest.yaml +0 -7
package/src/adapters/weixin/manifest.yaml +0 -7

package/dist/mcp/oauth.d.ts ADDED Viewed

@@ -0,0 +1,33 @@
+/**
+ * OAuth 2.1 Authorization Code + PKCE for MCP HTTP transport.
+ *
+ * S256-only, public clients (no client_secret), in-memory storage.
+ * Zero external dependencies — uses Node.js crypto + http built-ins.
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+interface AuthCode {
+    clientId: string;
+    codeChallenge: string;
+    redirectUri: string;
+    expiresAt: number;
+}
+interface Token {
+    clientId: string;
+    expiresAt: number;
+}
+declare function generateHex(bytes: number): string;
+declare function sha256Base64url(input: string): string;
+declare function pruneExpired(): void;
+/** Returns `true` if the request was an OAuth route and has been handled. */
+export declare function handleOAuthRoute(req: IncomingMessage, res: ServerResponse): boolean;
+/** Returns a function that blocks unauthorized requests (returns `true` = blocked). */
+export declare function createOAuthMiddleware(): (req: IncomingMessage, res: ServerResponse) => boolean;
+export declare const _test: {
+    readonly authCodes: Map<string, AuthCode>;
+    readonly tokens: Map<string, Token>;
+    readonly sha256Base64url: typeof sha256Base64url;
+    readonly generateHex: typeof generateHex;
+    readonly pruneExpired: typeof pruneExpired;
+};
+export {};
+//# sourceMappingURL=oauth.d.ts.map

package/dist/mcp/oauth.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/mcp/oauth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,UAAU,QAAQ;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AACD,UAAU,KAAK;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,iBAAS,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AACD,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAiCD,iBAAS,YAAY,IAAI,IAAI,CAI5B;AAwID,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAqBT;AAED,uFAAuF;AACvF,wBAAgB,qBAAqB,IAAI,CACvC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,KAChB,OAAO,CAmBX;AAGD,eAAO,MAAM,KAAK;;;;;;CAMR,CAAC"}

package/dist/mcp/oauth.js ADDED Viewed

@@ -0,0 +1,220 @@
+/**
+ * OAuth 2.1 Authorization Code + PKCE for MCP HTTP transport.
+ *
+ * S256-only, public clients (no client_secret), in-memory storage.
+ * Zero external dependencies — uses Node.js crypto + http built-ins.
+ */
+import { createHash, randomBytes } from "node:crypto";
+const authCodes = new Map();
+const tokens = new Map();
+const AUTH_CODE_TTL_MS = 60_000;
+const TOKEN_TTL_S = 3_600;
+const TOKEN_TTL_MS = TOKEN_TTL_S * 1_000;
+function generateHex(bytes) {
+    return randomBytes(bytes).toString("hex");
+}
+function sha256Base64url(input) {
+    return createHash("sha256").update(input).digest("base64url");
+}
+function parseQuery(url) {
+    const i = url.indexOf("?");
+    return new URLSearchParams(i >= 0 ? url.slice(i + 1) : "");
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on("data", (c) => {
+            size += c.length;
+            if (size > 65_536) {
+                req.destroy();
+                reject(new Error("Body too large"));
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+function json(res, status, body) {
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Cache-Control": "no-store",
+    });
+    res.end(JSON.stringify(body));
+}
+function pruneExpired() {
+    const now = Date.now();
+    for (const [k, v] of authCodes)
+        if (v.expiresAt <= now)
+            authCodes.delete(k);
+    for (const [k, v] of tokens)
+        if (v.expiresAt <= now)
+            tokens.delete(k);
+}
+// ── Authorization Endpoint ─────────────────────────────────────────────────
+const HTML = (cid, ch, ru) => `<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"><title>Uni-CLI MCP Auth</title>` +
+    `<style>body{font-family:system-ui,sans-serif;max-width:420px;margin:80px auto;text-align:center}` +
+    `button{padding:12px 32px;font-size:16px;cursor:pointer;border:none;border-radius:6px;` +
+    `background:#2563eb;color:#fff}code{background:#f1f5f9;padding:2px 6px;border-radius:3px}</style>` +
+    `</head><body><h2>Authorize MCP Client</h2><p>Client <code>${cid}</code> requests access.</p>` +
+    `<form method="POST" action="/oauth/authorize"><input type="hidden" name="client_id" value="${cid}">` +
+    `<input type="hidden" name="code_challenge" value="${ch}"><input type="hidden" name="redirect_uri" ` +
+    `value="${ru}"><button type="submit">Grant Access</button></form></body></html>`;
+function handleAuthorizeGet(req, res) {
+    const p = parseQuery(req.url ?? "");
+    const clientId = p.get("client_id"), challenge = p.get("code_challenge");
+    const method = p.get("code_challenge_method"), redirect = p.get("redirect_uri");
+    if (!clientId || !challenge || !redirect)
+        return json(res, 400, {
+            error: "invalid_request",
+            error_description: "Missing client_id, code_challenge, or redirect_uri",
+        });
+    if (method && method !== "S256")
+        return json(res, 400, {
+            error: "invalid_request",
+            error_description: "Only S256 code_challenge_method is supported",
+        });
+    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+    res.end(HTML(clientId, challenge, redirect));
+}
+async function handleAuthorizePost(req, res) {
+    const p = new URLSearchParams(await readBody(req));
+    const clientId = p.get("client_id"), challenge = p.get("code_challenge"), redirect = p.get("redirect_uri");
+    if (!clientId || !challenge || !redirect)
+        return json(res, 400, {
+            error: "invalid_request",
+            error_description: "Missing required parameters",
+        });
+    pruneExpired();
+    const code = generateHex(32);
+    authCodes.set(code, {
+        clientId,
+        codeChallenge: challenge,
+        redirectUri: redirect,
+        expiresAt: Date.now() + AUTH_CODE_TTL_MS,
+    });
+    res.writeHead(302, {
+        Location: `${redirect}${redirect.includes("?") ? "&" : "?"}code=${code}`,
+    });
+    res.end();
+}
+// ── Token Endpoint ─────────────────────────────────────────────────────────
+async function handleToken(req, res) {
+    const p = new URLSearchParams(await readBody(req));
+    const grant = p.get("grant_type"), code = p.get("code");
+    const verifier = p.get("code_verifier"), clientId = p.get("client_id");
+    if (grant !== "authorization_code")
+        return json(res, 400, {
+            error: "unsupported_grant_type",
+            error_description: "Only authorization_code is supported",
+        });
+    if (!code || !verifier || !clientId)
+        return json(res, 400, {
+            error: "invalid_request",
+            error_description: "Missing code, code_verifier, or client_id",
+        });
+    pruneExpired();
+    const entry = authCodes.get(code);
+    if (!entry)
+        return json(res, 400, {
+            error: "invalid_grant",
+            error_description: "Invalid or expired authorization code",
+        });
+    authCodes.delete(code); // single-use
+    if (entry.expiresAt <= Date.now())
+        return json(res, 400, {
+            error: "invalid_grant",
+            error_description: "Authorization code has expired",
+        });
+    if (entry.clientId !== clientId)
+        return json(res, 400, {
+            error: "invalid_grant",
+            error_description: "Client ID mismatch",
+        });
+    if (sha256Base64url(verifier) !== entry.codeChallenge)
+        return json(res, 400, {
+            error: "invalid_grant",
+            error_description: "PKCE verification failed",
+        });
+    const accessToken = generateHex(32);
+    tokens.set(accessToken, { clientId, expiresAt: Date.now() + TOKEN_TTL_MS });
+    json(res, 200, {
+        access_token: accessToken,
+        token_type: "Bearer",
+        expires_in: TOKEN_TTL_S,
+    });
+}
+// ── Bearer Validation ──────────────────────────────────────────────────────
+function validateBearer(req) {
+    const h = req.headers.authorization;
+    if (!h)
+        return false;
+    const parts = h.split(" ");
+    if (parts.length !== 2 || parts[0] !== "Bearer")
+        return false;
+    const entry = tokens.get(parts[1]);
+    if (!entry)
+        return false;
+    if (entry.expiresAt <= Date.now()) {
+        tokens.delete(parts[1]);
+        return false;
+    }
+    return true;
+}
+// ── Public API ─────────────────────────────────────────────────────────────
+/** Returns `true` if the request was an OAuth route and has been handled. */
+export function handleOAuthRoute(req, res) {
+    const path = (req.url ?? "").split("?")[0];
+    if (path === "/oauth/authorize") {
+        if (req.method === "GET") {
+            handleAuthorizeGet(req, res);
+            return true;
+        }
+        if (req.method === "POST") {
+            handleAuthorizePost(req, res).catch(() => {
+                if (!res.writableEnded)
+                    json(res, 500, { error: "server_error" });
+            });
+            return true;
+        }
+    }
+    if (path === "/oauth/token" && req.method === "POST") {
+        handleToken(req, res).catch(() => {
+            if (!res.writableEnded)
+                json(res, 500, { error: "server_error" });
+        });
+        return true;
+    }
+    return false;
+}
+/** Returns a function that blocks unauthorized requests (returns `true` = blocked). */
+export function createOAuthMiddleware() {
+    return (req, res) => {
+        if (validateBearer(req))
+            return false;
+        res.writeHead(401, {
+            "Content-Type": "application/json",
+            "WWW-Authenticate": 'Bearer realm="unicli-mcp"',
+        });
+        res.end(JSON.stringify({
+            jsonrpc: "2.0",
+            id: null,
+            error: {
+                code: -32600,
+                message: "Unauthorized: valid Bearer token required",
+            },
+        }));
+        return true;
+    };
+}
+// Test helpers — exported for unit tests only
+export const _test = {
+    authCodes,
+    tokens,
+    sha256Base64url,
+    generateHex,
+    pruneExpired,
+};
+//# sourceMappingURL=oauth.js.map

package/dist/mcp/oauth.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/dist/mcp/schema.d.ts ADDED Viewed

@@ -0,0 +1,65 @@
+/**
+ * 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
+ */
+import type { AdapterCommand } from "../types.js";
+export interface JsonSchemaProperty {
+    type: string;
+    description?: string;
+    default?: unknown;
+    enum?: string[];
+    additionalProperties?: boolean;
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+}
+export interface JsonSchemaObject {
+    type: "object" | "array";
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean;
+    items?: JsonSchemaProperty;
+}
+/**
+ * Map adapter `arg.type` to JSON Schema primitive.
+ * Defaults to "string" for unknown/missing — safer than failing the build.
+ */
+export declare function jsonTypeFor(t: string | undefined): string;
+/**
+ * Build JSON Schema for a command's input from its `args` definition.
+ * Always includes a `limit` parameter (default 20) for result capping.
+ */
+export declare function buildInputSchema(cmd: AdapterCommand): JsonSchemaObject;
+/**
+ * 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 declare function buildOutputSchema(cmd: AdapterCommand, format?: "wrapped" | "flat"): JsonSchemaObject;
+/**
+ * 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 declare function buildToolName(site: string, command: string): string;
+/**
+ * Approximate token count. Uses `words × 1.3` — closely tracks
+ * tiktoken cl100k for English + mixed-case identifiers.
+ */
+export declare function approxTokens(text: string): number;
+/**
+ * Truncate description to fit within a token budget.
+ * Cuts at word boundary, appends "…" when truncated.
+ */
+export declare function truncateDescription(desc: string, maxTokens?: number): string;
+//# sourceMappingURL=schema.d.ts.map

package/dist/mcp/schema.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/mcp/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAYzD;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,GAAG,gBAAgB,CA6BtE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,cAAc,EACnB,MAAM,GAAE,SAAS,GAAG,MAAkB,GACrC,gBAAgB,CA0BlB;AAID;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAUxE"}

package/dist/mcp/schema.js ADDED Viewed

@@ -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 ADDED Viewed

@@ -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 CHANGED Viewed

@@ -3,24 +3,37 @@
  * 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 McpToolResult {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    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 CHANGED Viewed

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