@pentoshi/clai 4.8.3 → 4.9.0

package/dist/mcp/names.js

@@ -0,0 +1,59 @@
+import { createHash } from "node:crypto";
+export const MCP_CANONICAL_PREFIX = "mcp.";
+export const MCP_WIRE_PREFIX = "mcp_";
+export const MCP_WIRE_MAX_LENGTH = 64;
+const MIN_HASH_LENGTH = 8;
+const NON_WIRE_CHAR = /[^A-Za-z0-9]+/g;
+const IDENTITY_SEPARATOR = "\u0000";
+export function canonicalToolName(serverName, toolName) {
+    return `${MCP_CANONICAL_PREFIX}${serverName}.${toolName}`;
+}
+export function isCanonicalToolName(value) {
+    return value.startsWith(MCP_CANONICAL_PREFIX) && value.length > MCP_CANONICAL_PREFIX.length;
+}
+export function toolIdentity(serverName, toolName) {
+    return `${serverName}${IDENTITY_SEPARATOR}${toolName}`;
+}
+function sanitizeSegment(raw) {
+    const replaced = raw.replace(NON_WIRE_CHAR, "_").replace(/^_+|_+$/g, "");
+    const value = replaced.length > 0 ? replaced : "x";
+    return { value, normalized: value !== raw };
+}
+function hashFor(identity, length) {
+    return createHash("sha256").update(identity).digest("hex").slice(0, length);
+}
+function withHash(base, identity, length) {
+    const suffix = `_${hashFor(identity, length)}`;
+    const room = Math.max(MCP_WIRE_PREFIX.length, MCP_WIRE_MAX_LENGTH - suffix.length);
+    const head = base.length > room ? base.slice(0, room) : base;
+    return `${head}${suffix}`;
+}
+export class WireNameAllocator {
+    used = new Map();
+    assign(input) {
+        const identity = toolIdentity(input.serverName, input.toolName);
+        const server = sanitizeSegment(input.serverName);
+        const tool = sanitizeSegment(input.toolName);
+        const base = `${MCP_WIRE_PREFIX}${server.value}_${tool.value}`;
+        const collides = this.used.has(base) && this.used.get(base) !== identity;
+        const mustHash = server.normalized || tool.normalized || base.length > MCP_WIRE_MAX_LENGTH || collides;
+        let hashLength = MIN_HASH_LENGTH;
+        let candidate = mustHash ? withHash(base, identity, hashLength) : base;
+        while (this.used.has(candidate) && this.used.get(candidate) !== identity) {
+            hashLength += 4;
+            candidate = withHash(base, identity, hashLength);
+        }
+        this.used.set(candidate, identity);
+        return candidate;
+    }
+}
+export function allocateWireNames(inputs) {
+    const sorted = [...inputs].sort((a, b) => toolIdentity(a.serverName, a.toolName).localeCompare(toolIdentity(b.serverName, b.toolName)));
+    const allocator = new WireNameAllocator();
+    const byIdentity = new Map();
+    for (const input of sorted) {
+        byIdentity.set(toolIdentity(input.serverName, input.toolName), allocator.assign(input));
+    }
+    return byIdentity;
+}
+//# sourceMappingURL=names.js.map

package/dist/mcp/names.js.map

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

package/dist/mcp/results.d.ts

@@ -0,0 +1,6 @@
+import type { RiskLevel } from "../types.js";
+import type { McpNormalizedResult, McpToolAnnotations, McpToolDescriptor, McpToolMetadata } from "./types.js";
+export declare function deriveRisk(annotations: McpToolAnnotations): RiskLevel;
+export declare function parseToolDescriptor(value: unknown): McpToolDescriptor | undefined;
+export declare function toToolMetadata(serverName: string, descriptor: McpToolDescriptor, wireName: string): McpToolMetadata;
+export declare function normalizeToolResult(raw: unknown): McpNormalizedResult;

package/dist/mcp/results.js

@@ -0,0 +1,182 @@
+import { canonicalToolName } from "./names.js";
+function coerceSchema(schema) {
+    if (typeof schema === "object" &&
+        schema !== null &&
+        schema.type === "object") {
+        const record = schema;
+        const properties = typeof record.properties === "object" && record.properties !== null
+            ? record.properties
+            : {};
+        const required = Array.isArray(record.required)
+            ? record.required.filter((entry) => typeof entry === "string")
+            : undefined;
+        const additionalProperties = typeof record.additionalProperties === "boolean"
+            ? record.additionalProperties
+            : undefined;
+        return {
+            type: "object",
+            properties,
+            ...(required !== undefined ? { required } : {}),
+            ...(additionalProperties !== undefined ? { additionalProperties } : {}),
+        };
+    }
+    return { type: "object", properties: {} };
+}
+function readAnnotations(value) {
+    if (typeof value !== "object" || value === null)
+        return {};
+    const record = value;
+    const result = {};
+    if (typeof record.title === "string")
+        result.title = record.title;
+    if (typeof record.readOnlyHint === "boolean")
+        result.readOnlyHint = record.readOnlyHint;
+    if (typeof record.destructiveHint === "boolean")
+        result.destructiveHint = record.destructiveHint;
+    if (typeof record.idempotentHint === "boolean")
+        result.idempotentHint = record.idempotentHint;
+    if (typeof record.openWorldHint === "boolean")
+        result.openWorldHint = record.openWorldHint;
+    return result;
+}
+export function deriveRisk(annotations) {
+    if (annotations.readOnlyHint === true)
+        return "safe";
+    return "confirm";
+}
+export function parseToolDescriptor(value) {
+    if (typeof value !== "object" || value === null)
+        return undefined;
+    const record = value;
+    if (typeof record.name !== "string" || record.name.length === 0)
+        return undefined;
+    const descriptor = { name: record.name };
+    if (typeof record.title === "string")
+        descriptor.title = record.title;
+    if (typeof record.description === "string")
+        descriptor.description = record.description;
+    if (typeof record.inputSchema === "object" && record.inputSchema !== null) {
+        descriptor.inputSchema = record.inputSchema;
+    }
+    if ("annotations" in record)
+        descriptor.annotations = readAnnotations(record.annotations);
+    return descriptor;
+}
+export function toToolMetadata(serverName, descriptor, wireName) {
+    const annotations = descriptor.annotations ?? {};
+    const readOnly = annotations.readOnlyHint === true;
+    const destructive = readOnly ? false : annotations.destructiveHint ?? true;
+    const idempotent = annotations.idempotentHint ?? false;
+    const openWorld = annotations.openWorldHint ?? false;
+    const title = descriptor.title ?? annotations.title;
+    const base = {
+        canonicalName: canonicalToolName(serverName, descriptor.name),
+        wireName,
+        serverName,
+        toolName: descriptor.name,
+        description: descriptor.description ?? "",
+        inputSchema: coerceSchema(descriptor.inputSchema),
+        risk: deriveRisk(annotations),
+        readOnly,
+        destructive,
+        idempotent,
+        openWorld,
+        annotations,
+    };
+    return title !== undefined ? { ...base, title } : base;
+}
+function readContentImages(content) {
+    const images = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type !== "image")
+            continue;
+        const data = record.data;
+        const mimeType = record.mimeType;
+        if (typeof data === "string" && typeof mimeType === "string") {
+            images.push({ mediaType: mimeType, dataBase64: data });
+        }
+    }
+    return images;
+}
+function readContentResources(content) {
+    const resources = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type !== "resource")
+            continue;
+        const resource = record.resource;
+        if (typeof resource !== "object" || resource === null)
+            continue;
+        const res = resource;
+        const uri = typeof res.uri === "string" ? res.uri : "";
+        const normalized = { uri };
+        if (typeof res.mimeType === "string")
+            normalized.mimeType = res.mimeType;
+        if (typeof res.text === "string")
+            normalized.text = res.text;
+        if (typeof res.blob === "string")
+            normalized.blobBase64 = res.blob;
+        resources.push(normalized);
+    }
+    return resources;
+}
+function readContentText(content) {
+    const parts = [];
+    for (const entry of content) {
+        if (typeof entry !== "object" || entry === null)
+            continue;
+        const record = entry;
+        if (record.type === "text" && typeof record.text === "string") {
+            parts.push(record.text);
+        }
+        else if (record.type === "resource") {
+            const resource = record.resource;
+            if (resource && typeof resource.text === "string") {
+                const uri = typeof resource.uri === "string" ? resource.uri : "resource";
+                parts.push(`[${uri}]\n${resource.text}`);
+            }
+            else if (resource && typeof resource.uri === "string") {
+                parts.push(`[resource ${resource.uri}]`);
+            }
+        }
+        else if (record.type === "image") {
+            const mime = typeof record.mimeType === "string" ? record.mimeType : "image";
+            parts.push(`[image ${mime}]`);
+        }
+        else if (record.type === "audio") {
+            const mime = typeof record.mimeType === "string" ? record.mimeType : "audio";
+            parts.push(`[audio ${mime}]`);
+        }
+    }
+    return parts.join("\n");
+}
+export function normalizeToolResult(raw) {
+    const record = typeof raw === "object" && raw !== null ? raw : {};
+    const isError = record.isError === true;
+    const content = Array.isArray(record.content) ? record.content : [];
+    const images = readContentImages(content);
+    const resources = readContentResources(content);
+    const chatImages = images.map((image) => ({
+        mediaType: image.mediaType,
+        dataBase64: image.dataBase64,
+    }));
+    let text = readContentText(content);
+    if (text.length === 0 && typeof record.structuredContent === "object" && record.structuredContent !== null) {
+        text = JSON.stringify(record.structuredContent);
+    }
+    return {
+        ok: !isError,
+        isError,
+        text,
+        images,
+        resources,
+        chatImages,
+        raw,
+    };
+}
+//# sourceMappingURL=results.js.map

package/dist/mcp/results.js.map

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

package/dist/mcp/runtime.d.ts

@@ -0,0 +1,107 @@
+import type { RiskDecision } from "../safety/classifier.js";
+import type { ToolDefinition, ToolResult } from "../types.js";
+import { McpManager, type McpManagerOptions } from "./manager.js";
+import type { McpSnapshot, McpToolMetadata } from "./types.js";
+export type McpRuntimeSelection = {
+    readonly mode: "all";
+} | {
+    readonly mode: "off";
+} | {
+    readonly mode: "servers";
+    readonly serverNames: readonly string[];
+};
+export type McpBaseSelection = {
+    readonly mode: "all";
+} | {
+    readonly mode: "off";
+};
+export interface McpRuntimeState {
+    readonly snapshot: McpSnapshot;
+    readonly selection: McpRuntimeSelection;
+    readonly refreshing: boolean;
+    readonly activeToolCount: number;
+    readonly catalogSignature: string;
+    readonly error?: string | undefined;
+}
+export interface McpRuntimeOptions {
+    readonly manager?: McpManager | undefined;
+    readonly managerOptions?: McpManagerOptions | undefined;
+}
+export declare function mcpSelectionLabel(selection: McpRuntimeSelection): string;
+/**
+ * A turn's pinned view of the catalog. Tool schemas are advertised once per
+ * turn, so dispatch, classification and prompt context must keep resolving
+ * against that same catalog even if a refresh, reconnect or selection edit
+ * lands mid-turn — otherwise an advertised tool becomes "unknown" halfway
+ * through and the model is told its tools disappeared.
+ */
+export interface McpTurnLease {
+    release(): void;
+}
+export declare class McpRuntime {
+    private readonly manager;
+    private readonly listeners;
+    private refreshPromise;
+    private started;
+    private closed;
+    private state;
+    private base;
+    private readonly leases;
+    private readonly unregisterDispatcher;
+    constructor(options?: McpRuntimeOptions);
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getState: () => McpRuntimeState;
+    private emit;
+    private publish;
+    private registerSnapshotTools;
+    start(): Promise<McpRuntimeState>;
+    ensureReady(): Promise<McpRuntimeState>;
+    refresh(options?: {
+        force?: boolean;
+    }): Promise<McpRuntimeState>;
+    reconnect(serverName: string): Promise<McpRuntimeState>;
+    selectAll(): McpRuntimeState;
+    selectOff(): McpRuntimeState;
+    serverNames(): ReadonlySet<string>;
+    selectServers(serverNames: readonly string[]): McpRuntimeState;
+    selectServer(serverName: string): McpRuntimeState;
+    applyMentionSelection(text: string): McpRuntimeState;
+    beginTurn(): McpTurnLease;
+    private liveView;
+    /** Newest pinned turn view, or the live one when no turn is in flight. */
+    private view;
+    private views;
+    toolDefinitions(options?: {
+        askMode?: boolean;
+    }): ToolDefinition[];
+    toolNames(options?: {
+        askMode?: boolean;
+    }): string[];
+    /**
+     * Tolerant lookup: exact canonical / wire hit first, then a punctuation- and
+     * case-insensitive match, then an unambiguous suffix match. Models routinely
+     * rewrite `mcp.docs.resolve-library-id` as `mcp_docs_resolve_library_id` or
+     * drop the server segment; a live tool must not be reported missing for a
+     * cosmetic difference.
+     */
+    private resolveMetadata;
+    getTool(name: string, options?: {
+        includeUnselected?: boolean;
+    }): McpToolMetadata | undefined;
+    unavailableToolMessage(name: string): string;
+    canonicalizeToolName(name: string): string;
+    classify(name: string): RiskDecision | undefined;
+    isParallelSafe(name: string): boolean;
+    private secretsFor;
+    private normalizeResult;
+    callTool(name: string, args: Record<string, unknown>, options?: {
+        signal?: AbortSignal | undefined;
+        timeoutMs?: number | undefined;
+    }): Promise<ToolResult>;
+    promptContext(options: {
+        nativeTools: boolean;
+        askMode?: boolean;
+    }): string | undefined;
+    statusLabel(): string | undefined;
+    closeAll(): Promise<void>;
+}