@darkiceinteractive/mcp-conductor 1.1.0 → 3.0.0-beta.1

package/dist/runtime/helpers/compact.js

@@ -0,0 +1,93 @@
+/**
+ * mcp.compact — Field selection and data trimming helper
+ *
+ * Zero-roundtrip sandbox helper. Reduces large data objects to only the
+ * fields the caller cares about, truncates arrays, clips strings, and
+ * limits nesting depth. All operations are synchronous and in-process.
+ *
+ * @module runtime/helpers/compact
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Internal helpers
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Parse a dot-path like "labels.name" into a nested selector tree.
+ * { labels: { name: true }, id: true }
+ */
+function buildSelectorTree(fields) {
+    const tree = {};
+    for (const field of fields) {
+        const parts = field.split('.');
+        let node = tree;
+        for (let i = 0; i < parts.length; i++) {
+            const part = parts[i] ?? '';
+            if (i === parts.length - 1) {
+                node[part] = true;
+            }
+            else {
+                if (typeof node[part] !== 'object' || node[part] === null) {
+                    node[part] = {};
+                }
+                node = node[part];
+            }
+        }
+    }
+    return tree;
+}
+function trimValue(value, selector, opts, depth) {
+    const maxDepth = opts.maxDepth ?? Infinity;
+    if (depth > maxDepth) {
+        return typeof value === 'object' && value !== null ? '[truncated]' : value;
+    }
+    if (typeof value === 'string') {
+        const max = opts.maxStringLength;
+        if (max !== undefined && value.length > max) {
+            return value.slice(0, max) + '…';
+        }
+        return value;
+    }
+    if (Array.isArray(value)) {
+        const maxItems = opts.maxItems;
+        const arr = maxItems !== undefined ? value.slice(0, maxItems) : value;
+        return arr.map((item) => trimValue(item, selector, opts, depth + 1));
+    }
+    if (typeof value === 'object' && value !== null) {
+        const obj = value;
+        const result = {};
+        if (selector && Object.keys(selector).length > 0) {
+            // Only keep selected keys
+            for (const key of Object.keys(selector)) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    const childSelector = selector[key];
+                    const nextSelector = childSelector === true ? null : childSelector;
+                    result[key] = trimValue(obj[key], nextSelector, opts, depth + 1);
+                }
+            }
+        }
+        else {
+            // No field filter — apply structural limits only
+            for (const key of Object.keys(obj)) {
+                result[key] = trimValue(obj[key], null, opts, depth + 1);
+            }
+        }
+        return result;
+    }
+    return value;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Compact a data value by selecting fields, truncating arrays, clipping
+ * strings, and limiting nesting depth.
+ *
+ * @example
+ * const lean = compact(issues, { fields: ['id', 'title', 'labels.name'], maxItems: 20 });
+ */
+export function compact(data, options = {}) {
+    const selector = options.fields && options.fields.length > 0
+        ? buildSelectorTree(options.fields)
+        : null;
+    return trimValue(data, selector, options, 0);
+}
+//# sourceMappingURL=compact.js.map

package/dist/runtime/helpers/compact.js.map

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

package/dist/runtime/helpers/delta.d.ts

@@ -0,0 +1,45 @@
+/**
+ * mcp.delta — Cross-call diff wrapper
+ *
+ * Wraps cache.delta from Phase 2 (when available) to return only the
+ * changed portions of a tool result relative to the previous call.
+ * This file designs the API surface so it works once Phase 2 cache
+ * lands; for now it performs a structural diff in-process.
+ *
+ * @module runtime/helpers/delta
+ */
+export interface DeltaResult<T> {
+    /** Whether data changed relative to the previous snapshot */
+    changed: boolean;
+    /** The delta payload (full object if no previous snapshot) */
+    delta: Partial<T> | T;
+    /** Keys that changed (for objects) or null for primitives/arrays */
+    changedKeys?: string[];
+    /** Number of items added (arrays only) */
+    added?: number;
+    /** Number of items removed (arrays only) */
+    removed?: number;
+}
+export interface CacheDeltaBridge {
+    delta<T>(server: string, tool: string, args: unknown, current: T): Promise<DeltaResult<T>>;
+}
+/**
+ * Register the Phase 2 cache bridge. Called during system initialisation
+ * once the cache layer is available.
+ */
+export declare function registerCacheBridge(bridge: CacheDeltaBridge): void;
+/**
+ * Compute the delta for a tool result relative to the previous call.
+ * Delegates to Phase 2 cache.delta when registered; falls back to
+ * in-process structural differ.
+ *
+ * @example
+ * const d = await delta('github', 'list_issues', { repo: 'foo' }, issues);
+ * if (d.changed) console.log('Changed keys:', d.changedKeys);
+ */
+export declare function delta<T>(server: string, tool: string, args: unknown, current: T): Promise<DeltaResult<T>>;
+/**
+ * Clear all in-process snapshots (useful in tests).
+ */
+export declare function clearSnapshots(): void;
+//# sourceMappingURL=delta.d.ts.map

package/dist/runtime/helpers/delta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delta.d.ts","sourceRoot":"","sources":["../../../src/runtime/helpers/delta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,CAAC,EACL,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5B;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAElE;AAsDD;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAkDzB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/runtime/helpers/delta.js

@@ -0,0 +1,116 @@
+/**
+ * mcp.delta — Cross-call diff wrapper
+ *
+ * Wraps cache.delta from Phase 2 (when available) to return only the
+ * changed portions of a tool result relative to the previous call.
+ * This file designs the API surface so it works once Phase 2 cache
+ * lands; for now it performs a structural diff in-process.
+ *
+ * @module runtime/helpers/delta
+ */
+let _cacheBridge = null;
+/**
+ * Register the Phase 2 cache bridge. Called during system initialisation
+ * once the cache layer is available.
+ */
+export function registerCacheBridge(bridge) {
+    _cacheBridge = bridge;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// In-process structural differ (fallback when Phase 2 is not present)
+// ─────────────────────────────────────────────────────────────────────────────
+// In-memory snapshot store keyed by "server::tool::argsHash"
+const _snapshots = new Map();
+function hashArgs(args) {
+    try {
+        return JSON.stringify(args) ?? 'null';
+    }
+    catch {
+        return String(args);
+    }
+}
+function snapshotKey(server, tool, args) {
+    return `${server}::${tool}::${hashArgs(args)}`;
+}
+function diffObjects(prev, curr) {
+    const delta = {};
+    const changedKeys = [];
+    const allKeys = new Set([...Object.keys(prev), ...Object.keys(curr)]);
+    for (const key of allKeys) {
+        const prevVal = JSON.stringify(prev[key]);
+        const currVal = JSON.stringify(curr[key]);
+        if (prevVal !== currVal) {
+            delta[key] = curr[key];
+            changedKeys.push(key);
+        }
+    }
+    return { delta, changedKeys };
+}
+function diffArrays(prev, curr) {
+    const prevLen = prev.length;
+    const currLen = curr.length;
+    const added = Math.max(0, currLen - prevLen);
+    const removed = Math.max(0, prevLen - currLen);
+    const changed = JSON.stringify(prev) !== JSON.stringify(curr);
+    return { changed, added, removed };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Compute the delta for a tool result relative to the previous call.
+ * Delegates to Phase 2 cache.delta when registered; falls back to
+ * in-process structural differ.
+ *
+ * @example
+ * const d = await delta('github', 'list_issues', { repo: 'foo' }, issues);
+ * if (d.changed) console.log('Changed keys:', d.changedKeys);
+ */
+export async function delta(server, tool, args, current) {
+    // Prefer Phase 2 cache bridge if available
+    if (_cacheBridge) {
+        return _cacheBridge.delta(server, tool, args, current);
+    }
+    // Fallback: in-process structural differ
+    const key = snapshotKey(server, tool, args);
+    const previous = _snapshots.get(key);
+    _snapshots.set(key, current);
+    if (previous === undefined) {
+        // No previous snapshot — return full result
+        return { changed: true, delta: current };
+    }
+    // Array diff
+    if (Array.isArray(current) && Array.isArray(previous)) {
+        const { changed, added, removed } = diffArrays(previous, current);
+        return {
+            changed,
+            delta: changed ? current : [],
+            added,
+            removed,
+        };
+    }
+    // Object diff
+    if (typeof current === 'object' &&
+        current !== null &&
+        typeof previous === 'object' &&
+        previous !== null &&
+        !Array.isArray(current)) {
+        const { delta: objectDelta, changedKeys } = diffObjects(previous, current);
+        const changed = changedKeys.length > 0;
+        return {
+            changed,
+            delta: changed ? objectDelta : {},
+            changedKeys,
+        };
+    }
+    // Primitive diff
+    const changed = JSON.stringify(previous) !== JSON.stringify(current);
+    return { changed, delta: changed ? current : undefined };
+}
+/**
+ * Clear all in-process snapshots (useful in tests).
+ */
+export function clearSnapshots() {
+    _snapshots.clear();
+}
+//# sourceMappingURL=delta.js.map

package/dist/runtime/helpers/delta.js.map

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

package/dist/runtime/helpers/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sandbox helper exports
+ *
+ * These are the zero-roundtrip helpers injected into the execute_code sandbox
+ * via the mcp global. All functions run in-process with no external calls.
+ *
+ * @module runtime/helpers
+ */
+export { compact } from './compact.js';
+export type { CompactOptions } from './compact.js';
+export { summarize } from './summarize.js';
+export type { SummarizeOptions, SummarizeStyle } from './summarize.js';
+export { delta, clearSnapshots, registerCacheBridge } from './delta.js';
+export type { DeltaResult, CacheDeltaBridge } from './delta.js';
+export { budget, BudgetExceededError, estimateTokens } from './budget.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/helpers/index.js

@@ -0,0 +1,13 @@
+/**
+ * Sandbox helper exports
+ *
+ * These are the zero-roundtrip helpers injected into the execute_code sandbox
+ * via the mcp global. All functions run in-process with no external calls.
+ *
+ * @module runtime/helpers
+ */
+export { compact } from './compact.js';
+export { summarize } from './summarize.js';
+export { delta, clearSnapshots, registerCacheBridge } from './delta.js';
+export { budget, BudgetExceededError, estimateTokens } from './budget.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/helpers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGxE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/runtime/helpers/summarize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * mcp.summarize — Heuristic summarization helper
+ *
+ * Converts arbitrary data into a compact string representation that fits
+ * within a token budget. Uses a simple heuristic: 1 token ≈ 4 characters.
+ * No LLM calls — fully in-process and zero-roundtrip.
+ *
+ * @module runtime/helpers/summarize
+ */
+export type SummarizeStyle = 'list' | 'paragraph' | 'json';
+export interface SummarizeOptions {
+    /** Target token budget. Output will not exceed this. */
+    maxTokens: number;
+    /** Output format. Defaults to 'list'. */
+    style?: SummarizeStyle;
+}
+/**
+ * Summarize arbitrary data into a string that fits within `maxTokens`.
+ *
+ * @example
+ * const summary = summarize(issues, { maxTokens: 200, style: 'list' });
+ */
+export declare function summarize(data: unknown, options: SummarizeOptions): string;
+//# sourceMappingURL=summarize.d.ts.map

package/dist/runtime/helpers/summarize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../src/runtime/helpers/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAwGD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAa1E"}

package/dist/runtime/helpers/summarize.js

@@ -0,0 +1,124 @@
+/**
+ * mcp.summarize — Heuristic summarization helper
+ *
+ * Converts arbitrary data into a compact string representation that fits
+ * within a token budget. Uses a simple heuristic: 1 token ≈ 4 characters.
+ * No LLM calls — fully in-process and zero-roundtrip.
+ *
+ * @module runtime/helpers/summarize
+ */
+// Characters per token (conservative heuristic)
+const CHARS_PER_TOKEN = 4;
+function tokenBudgetToChars(maxTokens) {
+    return maxTokens * CHARS_PER_TOKEN;
+}
+function clip(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return text.slice(0, Math.max(0, maxChars - 1)) + '…';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Style renderers
+// ─────────────────────────────────────────────────────────────────────────────
+function renderJson(data, maxChars) {
+    try {
+        const full = JSON.stringify(data, null, 2);
+        return clip(full, maxChars);
+    }
+    catch {
+        return clip(String(data), maxChars);
+    }
+}
+function renderList(data, maxChars) {
+    const lines = [];
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            if (typeof item === 'object' && item !== null) {
+                const pairs = Object.entries(item)
+                    .slice(0, 4)
+                    .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+                    .join(', ');
+                lines.push(`• ${pairs}`);
+            }
+            else {
+                lines.push(`• ${String(item)}`);
+            }
+        }
+    }
+    else if (typeof data === 'object' && data !== null) {
+        for (const [key, value] of Object.entries(data)) {
+            lines.push(`${key}: ${typeof value === 'object' ? JSON.stringify(value) : String(value)}`);
+        }
+    }
+    else {
+        lines.push(String(data));
+    }
+    // Build output within budget, line by line
+    const budget = maxChars;
+    let result = '';
+    for (const line of lines) {
+        const candidate = result ? result + '\n' + line : line;
+        if (candidate.length > budget) {
+            // Try to fit partial line
+            const remaining = budget - result.length - 1; // 1 for newline
+            if (remaining > 4) {
+                result += (result ? '\n' : '') + clip(line, remaining);
+            }
+            break;
+        }
+        result = candidate;
+    }
+    return result || clip(String(data), budget);
+}
+function renderParagraph(data, maxChars) {
+    let text;
+    if (typeof data === 'string') {
+        text = data;
+    }
+    else if (Array.isArray(data)) {
+        // Summarise array as "N items: first, second, ..."
+        const count = data.length;
+        const previews = data
+            .slice(0, 3)
+            .map((x) => typeof x === 'object' && x !== null
+            ? JSON.stringify(x).slice(0, 60)
+            : String(x).slice(0, 60))
+            .join(', ');
+        text = `${count} item${count !== 1 ? 's' : ''}: ${previews}${count > 3 ? '...' : ''}`;
+    }
+    else if (typeof data === 'object' && data !== null) {
+        const keys = Object.keys(data);
+        const previews = keys
+            .slice(0, 5)
+            .map((k) => `${k}: ${JSON.stringify(data[k]).slice(0, 30)}`)
+            .join('; ');
+        text = `Object with ${keys.length} field${keys.length !== 1 ? 's' : ''}: ${previews}`;
+    }
+    else {
+        text = String(data);
+    }
+    return clip(text, maxChars);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Summarize arbitrary data into a string that fits within `maxTokens`.
+ *
+ * @example
+ * const summary = summarize(issues, { maxTokens: 200, style: 'list' });
+ */
+export function summarize(data, options) {
+    const maxChars = tokenBudgetToChars(options.maxTokens);
+    const style = options.style ?? 'list';
+    switch (style) {
+        case 'json':
+            return renderJson(data, maxChars);
+        case 'paragraph':
+            return renderParagraph(data, maxChars);
+        case 'list':
+        default:
+            return renderList(data, maxChars);
+    }
+}
+//# sourceMappingURL=summarize.js.map

package/dist/runtime/helpers/summarize.js.map

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

package/dist/runtime/helpers/worker-preload.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Worker preload — inline sandbox helper source
+ *
+ * Generates the JavaScript source string that is written to a temp file
+ * and passed via WorkerOptions.preloadHelpers[] so the Deno worker evaluates
+ * it before any user code runs.  Injects compact/summarize/delta/budget/findTool
+ * onto the mcp global.
+ *
+ * @module runtime/helpers/worker-preload
+ */
+export interface PreloadOptions {
+    /** Registry tools to seed findTool (server/tool/description triples) */
+    tools?: Array<{
+        server: string;
+        tool: string;
+        description: string;
+    }>;
+}
+/**
+ * Build a self-contained JS source string for the Deno worker preload.
+ * The string is plain JavaScript — no TypeScript-only syntax — because
+ * it runs inside the Deno subprocess at runtime.
+ */
+export declare function buildHelperPreloadSource(options?: PreloadOptions): string;
+//# sourceMappingURL=worker-preload.d.ts.map

package/dist/runtime/helpers/worker-preload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-preload.d.ts","sourceRoot":"","sources":["../../../src/runtime/helpers/worker-preload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,CAqN7E"}