@vurb/core 3.2.0

package/dist/introspection/GovernanceObserver.js

@@ -0,0 +1,136 @@
+import { SpanStatusCode } from '../observability/Tracing.js';
+/**
+ * Create a governance observer that emits debug events and/or tracing
+ * spans for governance operations.
+ *
+ * @param config - Observer configuration (debug handler and/or tracer)
+ * @returns A `GovernanceObserver` instance
+ *
+ * @example
+ * ```typescript
+ * import { createGovernanceObserver } from 'vurb/introspection';
+ * import { createDebugObserver } from 'vurb';
+ *
+ * const observer = createGovernanceObserver({
+ *     debug: createDebugObserver(),
+ * });
+ *
+ * const contracts = observer.observe(
+ *     'contract.compile',
+ *     'Compiling 5 tool contracts',
+ *     () => compileContracts(builders),
+ * );
+ * ```
+ */
+export function createGovernanceObserver(config) {
+    const { debug, tracer } = config;
+    function observe(operation, label, fn) {
+        const start = Date.now();
+        const span = tracer?.startSpan(`mcp.governance.${operation}`, {
+            attributes: {
+                'mcp.governance.operation': operation,
+                'mcp.governance.label': label,
+            },
+        });
+        try {
+            const result = fn();
+            // Bug #50: Runtime guard — reject async callbacks passed to sync observe()
+            if (result != null && typeof result['then'] === 'function') {
+                throw new Error('[Vurb] observe() received an async callback. Use observeAsync() for async operations.');
+            }
+            const durationMs = Date.now() - start;
+            span?.setAttribute('mcp.governance.outcome', 'success');
+            span?.setAttribute('mcp.durationMs', durationMs);
+            span?.setStatus({ code: SpanStatusCode.OK });
+            debug?.({
+                type: 'governance',
+                operation,
+                label,
+                outcome: 'success',
+                durationMs,
+                timestamp: Date.now(),
+            });
+            return result;
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const message = err instanceof Error ? err.message : String(err);
+            span?.setAttribute('mcp.governance.outcome', 'failure');
+            span?.setAttribute('mcp.durationMs', durationMs);
+            span?.setStatus({ code: SpanStatusCode.ERROR, message });
+            span?.recordException(err instanceof Error ? err : new Error(message));
+            debug?.({
+                type: 'governance',
+                operation,
+                label,
+                outcome: 'failure',
+                detail: message,
+                durationMs,
+                timestamp: Date.now(),
+            });
+            throw err;
+        }
+        finally {
+            span?.end();
+        }
+    }
+    async function observeAsync(operation, label, fn) {
+        const start = Date.now();
+        const span = tracer?.startSpan(`mcp.governance.${operation}`, {
+            attributes: {
+                'mcp.governance.operation': operation,
+                'mcp.governance.label': label,
+            },
+        });
+        try {
+            const result = await fn();
+            const durationMs = Date.now() - start;
+            span?.setAttribute('mcp.governance.outcome', 'success');
+            span?.setAttribute('mcp.durationMs', durationMs);
+            span?.setStatus({ code: SpanStatusCode.OK });
+            debug?.({
+                type: 'governance',
+                operation,
+                label,
+                outcome: 'success',
+                durationMs,
+                timestamp: Date.now(),
+            });
+            return result;
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const message = err instanceof Error ? err.message : String(err);
+            span?.setAttribute('mcp.governance.outcome', 'failure');
+            span?.setAttribute('mcp.durationMs', durationMs);
+            span?.setStatus({ code: SpanStatusCode.ERROR, message });
+            span?.recordException(err instanceof Error ? err : new Error(message));
+            debug?.({
+                type: 'governance',
+                operation,
+                label,
+                outcome: 'failure',
+                detail: message,
+                durationMs,
+                timestamp: Date.now(),
+            });
+            throw err;
+        }
+        finally {
+            span?.end();
+        }
+    }
+    return { observe, observeAsync };
+}
+/**
+ * Create a no-op governance observer.
+ *
+ * Used when observability is not configured. Zero overhead.
+ */
+export function createNoopObserver() {
+    return {
+        observe: (_op, _label, fn) => fn(),
+        observeAsync: (_op, _label, fn) => fn(),
+    };
+}
+//# sourceMappingURL=GovernanceObserver.js.map

package/dist/introspection/GovernanceObserver.js.map

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

package/dist/introspection/IntrospectionResource.d.ts

@@ -0,0 +1,20 @@
+import { type ToolBuilder } from '../core/types.js';
+import { type IntrospectionConfig } from './types.js';
+/** Delegate interface for accessing registered builders (subset of ToolRegistry) */
+export interface IntrospectionRegistryDelegate<TContext> {
+    /** Iterate over all registered builders */
+    values(): Iterable<ToolBuilder<TContext>>;
+}
+/**
+ * Register MCP Resource handlers for introspection on the low-level Server.
+ *
+ * Called by `attachToServer()` when `options.introspection.enabled` is `true`.
+ *
+ * @param server - The resolved low-level MCP Server instance
+ * @param config - Introspection configuration (from AttachOptions)
+ * @param serverName - Server name for the manifest payload
+ * @param builders - Registry delegate providing builder iteration
+ * @param contextFactory - Factory to create per-request context (from AttachOptions)
+ */
+export declare function registerIntrospectionResource<TContext>(server: unknown, config: IntrospectionConfig<TContext>, serverName: string, builders: IntrospectionRegistryDelegate<TContext>, contextFactory?: (extra: unknown) => TContext | Promise<TContext>): void;
+//# sourceMappingURL=IntrospectionResource.d.ts.map

package/dist/introspection/IntrospectionResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntrospectionResource.d.ts","sourceRoot":"","sources":["../../src/introspection/IntrospectionResource.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,mBAAmB,EAAwB,MAAM,YAAY,CAAC;AA4B5E,oFAAoF;AACpF,MAAM,WAAW,6BAA6B,CAAC,QAAQ;IACnD,2CAA2C;IAC3C,MAAM,IAAI,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7C;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAClD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,6BAA6B,CAAC,QAAQ,CAAC,EACjD,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAClE,IAAI,CA+DN"}

package/dist/introspection/IntrospectionResource.js

@@ -0,0 +1,112 @@
+/**
+ * IntrospectionResource — MCP Resource Registration for Dynamic Manifest
+ *
+ * When introspection is enabled, this module silently registers two
+ * MCP request handlers on the low-level Server:
+ *
+ *   1. `resources/list` — Advertises the manifest resource
+ *   2. `resources/read` — Returns the RBAC-filtered manifest JSON
+ *
+ * Uses the native MCP Resource protocol — no custom HTTP endpoints.
+ * Zero overhead when introspection is disabled (this module is never imported).
+ *
+ * @module
+ */
+import { ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import {} from '../core/types.js';
+import {} from './types.js';
+import { compileManifest, cloneManifest } from './ManifestCompiler.js';
+// ── Types ────────────────────────────────────────────────
+/** Default URI for the introspection resource */
+const DEFAULT_URI = 'vurb://manifest.json';
+/** Default resource name */
+const RESOURCE_NAME = 'Vurb Manifest';
+/** Default resource description */
+const RESOURCE_DESCRIPTION = 'Dynamic introspection manifest exposing all registered tools, actions, ' +
+    'and presenters. RBAC-filtered per session context.';
+/** Default MIME type for the manifest resource */
+const RESOURCE_MIME_TYPE = 'application/json';
+// ── Public API ───────────────────────────────────────────
+/**
+ * Register MCP Resource handlers for introspection on the low-level Server.
+ *
+ * Called by `attachToServer()` when `options.introspection.enabled` is `true`.
+ *
+ * @param server - The resolved low-level MCP Server instance
+ * @param config - Introspection configuration (from AttachOptions)
+ * @param serverName - Server name for the manifest payload
+ * @param builders - Registry delegate providing builder iteration
+ * @param contextFactory - Factory to create per-request context (from AttachOptions)
+ */
+export function registerIntrospectionResource(server, config, serverName, builders, contextFactory) {
+    const resolved = server;
+    const uri = config.uri ?? DEFAULT_URI;
+    // ── resources/list handler ────────────────────────────
+    // Advertises the manifest resource to clients/orchestrators
+    const existingListHandler = safeGetExistingListHandler(resolved);
+    resolved.setRequestHandler(ListResourcesRequestSchema, (() => {
+        // Merge with any previously registered resources
+        const existingResources = existingListHandler ? existingListHandler() : [];
+        return {
+            resources: [
+                ...existingResources,
+                {
+                    uri,
+                    name: RESOURCE_NAME,
+                    description: RESOURCE_DESCRIPTION,
+                    mimeType: RESOURCE_MIME_TYPE,
+                },
+            ],
+        };
+    }));
+    // ── resources/read handler ───────────────────────────
+    // Returns the RBAC-filtered manifest when requested
+    resolved.setRequestHandler(ReadResourceRequestSchema, (async (request, extra) => {
+        const requestedUri = request.params.uri;
+        // Only handle our manifest URI
+        if (requestedUri !== uri) {
+            return {
+                contents: [],
+            };
+        }
+        // Compile the full manifest from current registry state
+        const fullManifest = compileManifest(serverName, builders.values());
+        // Apply RBAC filter if configured
+        let manifest;
+        if (config.filter && contextFactory) {
+            const ctx = await contextFactory(extra);
+            // Clone before mutation to protect the compiled tree
+            manifest = config.filter(cloneManifest(fullManifest), ctx);
+        }
+        else {
+            manifest = fullManifest;
+        }
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: RESOURCE_MIME_TYPE,
+                    text: JSON.stringify(manifest, null, 2),
+                },
+            ],
+        };
+    }));
+}
+// ── Private Helpers ──────────────────────────────────────
+/**
+ * Attempt to preserve an existing resources/list handler.
+ *
+ * Since the low-level Server replaces handlers (not appends), we
+ * capture any existing handler before overwriting it. This allows
+ * introspection to coexist with user-registered resources.
+ *
+ * @returns A function returning existing resources, or undefined
+ */
+function safeGetExistingListHandler(_server) {
+    // The low-level MCP SDK doesn't expose a getter for existing handlers.
+    // For now, introspection assumes it's the first to register resources/list.
+    // If the user also registers resources, they should do so AFTER
+    // attachToServer() or use the high-level McpServer.resource() API.
+    return undefined;
+}
+//# sourceMappingURL=IntrospectionResource.js.map

package/dist/introspection/IntrospectionResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntrospectionResource.js","sourceRoot":"","sources":["../../src/introspection/IntrospectionResource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACH,0BAA0B,EAC1B,yBAAyB,GAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAoB,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAkD,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEvE,4DAA4D;AAE5D,iDAAiD;AACjD,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAE3C,4BAA4B;AAC5B,MAAM,aAAa,GAAG,eAAe,CAAC;AAEtC,mCAAmC;AACnC,MAAM,oBAAoB,GACtB,yEAAyE;IACzE,oDAAoD,CAAC;AAEzD,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAiB9C,4DAA4D;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CACzC,MAAe,EACf,MAAqC,EACrC,UAAkB,EAClB,QAAiD,EACjD,cAAiE;IAEjE,MAAM,QAAQ,GAAG,MAAgC,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;IAEtC,yDAAyD;IACzD,4DAA4D;IAC5D,MAAM,mBAAmB,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAEjE,QAAQ,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,CAAC,GAAG,EAAE;QACzD,iDAAiD;QACjD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3E,OAAO;YACH,SAAS,EAAE;gBACP,GAAG,iBAAiB;gBACpB;oBACI,GAAG;oBACH,IAAI,EAAE,aAAa;oBACnB,WAAW,EAAE,oBAAoB;oBACjC,QAAQ,EAAE,kBAAkB;iBAC/B;aACJ;SACJ,CAAC;IACN,CAAC,CAAkC,CAAC,CAAC;IAErC,wDAAwD;IACxD,oDAAoD;IACpD,QAAQ,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,CAAC,KAAK,EACxD,OAAoC,EACpC,KAAc,EAChB,EAAE;QACA,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;QAExC,+BAA+B;QAC/B,IAAI,YAAY,KAAK,GAAG,EAAE,CAAC;YACvB,OAAO;gBACH,QAAQ,EAAE,EAAE;aACf,CAAC;QACN,CAAC;QAED,wDAAwD;QACxD,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpE,kCAAkC;QAClC,IAAI,QAAyB,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;YACxC,qDAAqD;YACrD,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACJ,QAAQ,GAAG,YAAY,CAAC;QAC5B,CAAC;QAED,OAAO;YACH,QAAQ,EAAE;gBACN;oBACI,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBAC1C;aACJ;SACJ,CAAC;IACN,CAAC,CAAkC,CAAC,CAAC;AACzC,CAAC;AAED,4DAA4D;AAE5D;;;;;;;;GAQG;AACH,SAAS,0BAA0B,CAC/B,OAA+B;IAE/B,uEAAuE;IACvE,4EAA4E;IAC5E,gEAAgE;IAChE,mEAAmE;IACnE,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/introspection/ManifestCompiler.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ManifestCompiler — Compiles the Dynamic Introspection Manifest
+ *
+ * Given a registry of tool builders, extracts all metadata (names,
+ * descriptions, action metadata, Zod→JSON Schema, presenter info)
+ * and compiles a structured {@link ManifestPayload}.
+ *
+ * The compiler operates on the **public** {@link ToolBuilder} interface,
+ * never accessing internals. This guarantees compatibility with custom
+ * builder implementations.
+ *
+ * Pure-function module: no state, no side effects.
+ *
+ * @module
+ */
+import { type ToolBuilder } from '../core/types.js';
+import { type ManifestPayload } from './types.js';
+/**
+ * Compile a full manifest payload from a set of tool builders.
+ *
+ * @param serverName - The server name (from config or fallback)
+ * @param builders - Iterable of all registered tool builders
+ * @returns A deep-cloneable manifest payload
+ */
+export declare function compileManifest<TContext>(serverName: string, builders: Iterable<ToolBuilder<TContext>>): ManifestPayload;
+/**
+ * Deep-clone a manifest payload for safe mutation by the RBAC filter.
+ *
+ * Uses structured clone semantics via JSON round-trip (the manifest
+ * is a pure JSON-serializable object — no functions, no circular refs).
+ */
+export declare function cloneManifest(manifest: ManifestPayload): ManifestPayload;
+//# sourceMappingURL=ManifestCompiler.d.ts.map

package/dist/introspection/ManifestCompiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestCompiler.d.ts","sourceRoot":"","sources":["../../src/introspection/ManifestCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACH,KAAK,eAAe,EAKvB,MAAM,YAAY,CAAC;AAYpB;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,GAC1C,eAAe,CASjB;AAkDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAExE"}

package/dist/introspection/ManifestCompiler.js

@@ -0,0 +1,88 @@
+/**
+ * ManifestCompiler — Compiles the Dynamic Introspection Manifest
+ *
+ * Given a registry of tool builders, extracts all metadata (names,
+ * descriptions, action metadata, Zod→JSON Schema, presenter info)
+ * and compiles a structured {@link ManifestPayload}.
+ *
+ * The compiler operates on the **public** {@link ToolBuilder} interface,
+ * never accessing internals. This guarantees compatibility with custom
+ * builder implementations.
+ *
+ * Pure-function module: no state, no side effects.
+ *
+ * @module
+ */
+import {} from '../core/types.js';
+import {} from './types.js';
+// ── Package Version ──────────────────────────────────────
+/**
+ * Framework version injected into every manifest.
+ * Imported at build time — zero runtime FS overhead.
+ */
+const VURB_VERSION = '1.1.0';
+// ── Public API ───────────────────────────────────────────
+/**
+ * Compile a full manifest payload from a set of tool builders.
+ *
+ * @param serverName - The server name (from config or fallback)
+ * @param builders - Iterable of all registered tool builders
+ * @returns A deep-cloneable manifest payload
+ */
+export function compileManifest(serverName, builders) {
+    const capabilities = compileCapabilities(builders);
+    return {
+        server: serverName,
+        vurb_version: VURB_VERSION,
+        architecture: 'MVA (Model-View-Agent)',
+        capabilities,
+    };
+}
+// ── Internal Steps ───────────────────────────────────────
+/** Compile tools and collect unique presenters across all builders. */
+function compileCapabilities(builders) {
+    const tools = {};
+    const presenters = {};
+    for (const builder of builders) {
+        const toolDef = builder.buildToolDefinition();
+        const metadata = builder.getActionMetadata();
+        // Compile actions
+        const actions = {};
+        for (const action of metadata) {
+            const presenterName = action.presenterName;
+            actions[action.key] = {
+                description: action.description,
+                destructive: action.destructive,
+                idempotent: action.idempotent,
+                readOnly: action.readOnly,
+                required_fields: action.requiredFields,
+                returns_presenter: presenterName,
+            };
+            // Collect presenter stub (if not already registered)
+            if (presenterName && !presenters[presenterName]) {
+                presenters[presenterName] = {
+                    schema_keys: action.presenterSchemaKeys ?? [],
+                    ui_blocks_supported: action.presenterUiBlockTypes ?? [],
+                    has_contextual_rules: action.presenterHasContextualRules ?? false,
+                };
+            }
+        }
+        tools[builder.getName()] = {
+            description: toolDef.description,
+            tags: builder.getTags(),
+            actions,
+            input_schema: toolDef.inputSchema,
+        };
+    }
+    return { tools, presenters };
+}
+/**
+ * Deep-clone a manifest payload for safe mutation by the RBAC filter.
+ *
+ * Uses structured clone semantics via JSON round-trip (the manifest
+ * is a pure JSON-serializable object — no functions, no circular refs).
+ */
+export function cloneManifest(manifest) {
+    return JSON.parse(JSON.stringify(manifest));
+}
+//# sourceMappingURL=ManifestCompiler.js.map

package/dist/introspection/ManifestCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManifestCompiler.js","sourceRoot":"","sources":["../../src/introspection/ManifestCompiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAoB,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAMN,MAAM,YAAY,CAAC;AAEpB,4DAA4D;AAE5D;;;GAGG;AACH,MAAM,YAAY,GAAG,OAAO,CAAC;AAE7B,4DAA4D;AAE5D;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC3B,UAAkB,EAClB,QAAyC;IAEzC,MAAM,YAAY,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAEnD,OAAO;QACH,MAAM,EAAE,UAAU;QAClB,YAAY,EAAE,YAAY;QAC1B,YAAY,EAAE,wBAAwB;QACtC,YAAY;KACf,CAAC;AACN,CAAC;AAED,4DAA4D;AAE5D,uEAAuE;AACvE,SAAS,mBAAmB,CACxB,QAAyC;IAEzC,MAAM,KAAK,GAAiC,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAsC,EAAE,CAAC;IAEzD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAE7C,kBAAkB;QAClB,MAAM,OAAO,GAAmC,EAAE,CAAC;QACnD,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,CAAC;YAE3C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;gBAClB,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,eAAe,EAAE,MAAM,CAAC,cAAc;gBACtC,iBAAiB,EAAE,aAAa;aACnC,CAAC;YAEF,qDAAqD;YACrD,IAAI,aAAa,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC9C,UAAU,CAAC,aAAa,CAAC,GAAG;oBACxB,WAAW,EAAE,MAAM,CAAC,mBAAmB,IAAI,EAAE;oBAC7C,mBAAmB,EAAE,MAAM,CAAC,qBAAqB,IAAI,EAAE;oBACvD,oBAAoB,EAAE,MAAM,CAAC,2BAA2B,IAAI,KAAK;iBACpE,CAAC;YACN,CAAC;QACL,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG;YACvB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;YACvB,OAAO;YACP,YAAY,EAAE,OAAO,CAAC,WAAW;SACpC,CAAC;IACN,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAyB;IACnD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAoB,CAAC;AACnE,CAAC"}

package/dist/introspection/SemanticProbe.d.ts

@@ -0,0 +1,207 @@
+/**
+ * SemanticProbe — LLM-as-a-Judge for Opaque Behavior Detection
+ *
+ * **Evolution 2: Semantic Probing**
+ *
+ * Provides a framework for using an LLM to evaluate whether
+ * a tool handler's actual runtime behavior matches its declared
+ * behavioral contract. This detects "semantic drift" — situations
+ * where the handler's output changes meaning even when the
+ * egress schema and system rules remain structurally identical.
+ *
+ * **Architecture**: This module defines the probe protocol,
+ * types, and evaluation pipeline. The actual LLM invocation
+ * is delegated to user-provided adapters — the module never
+ * makes LLM calls directly, maintaining the "no hidden
+ * network dependencies" principle.
+ *
+ * **Testing integration**: Designed to be integrated with
+ * `VurbTester.callAction()` for automated regression
+ * testing: "given these inputs, does the output semantically
+ * match the previous known-good output?"
+ *
+ * Pure-function module for probe construction and evaluation;
+ * LLM interaction is async via pluggable adapters.
+ *
+ * @module
+ */
+/**
+ * Configuration for semantic probing.
+ */
+export interface SemanticProbeConfig {
+    /** The LLM adapter to use for evaluation */
+    readonly adapter: SemanticProbeAdapter;
+    /** Risk thresholds for classification */
+    readonly thresholds?: Partial<SemanticThresholds>;
+    /** Maximum number of probes to run in parallel */
+    readonly concurrency?: number;
+    /** Whether to include raw LLM responses in results */
+    readonly includeRawResponses?: boolean;
+}
+/**
+ * Pluggable LLM adapter for semantic evaluation.
+ *
+ * Implementations should call an LLM with the provided prompt
+ * and return the structured evaluation result.
+ */
+export interface SemanticProbeAdapter {
+    /** Human-readable name (e.g., 'claude-3.5', 'gpt-4o') */
+    readonly name: string;
+    /**
+     * Send a semantic evaluation prompt to the LLM.
+     *
+     * @param prompt - Complete evaluation prompt
+     * @returns Raw LLM response text
+     */
+    evaluate(prompt: string): Promise<string>;
+}
+/**
+ * Thresholds for semantic drift classification.
+ */
+export interface SemanticThresholds {
+    /** Score below which drift is considered 'high' (default: 0.5) */
+    readonly highDriftThreshold: number;
+    /** Score below which drift is considered 'medium' (default: 0.75) */
+    readonly mediumDriftThreshold: number;
+}
+/**
+ * A semantic probe definition — a structured test case
+ * for LLM-based behavioral evaluation.
+ */
+export interface SemanticProbe {
+    /** Unique identifier for this probe */
+    readonly id: string;
+    /** Tool name being probed */
+    readonly toolName: string;
+    /** Action key being probed */
+    readonly actionKey: string;
+    /** Description of what this probe tests */
+    readonly description: string;
+    /** Input arguments to the tool */
+    readonly input: Record<string, unknown>;
+    /** Expected output (known-good baseline) */
+    readonly expectedOutput: unknown;
+    /** Actual output from the current handler */
+    readonly actualOutput: unknown;
+    /** Behavioral contract context for the judge */
+    readonly contractContext: ProbeContractContext;
+}
+/**
+ * Contract context injected into the LLM judge prompt.
+ *
+ * Provides the judge with enough information to evaluate
+ * whether the behavioral contract was violated.
+ */
+export interface ProbeContractContext {
+    /** Tool description */
+    readonly description: string | undefined;
+    /** Whether the action is declared readOnly */
+    readonly readOnly: boolean;
+    /** Whether the action is declared destructive */
+    readonly destructive: boolean;
+    /** System rules that should be respected */
+    readonly systemRules: readonly string[];
+    /** Schema field names (expected output shape) */
+    readonly schemaKeys: readonly string[];
+}
+/**
+ * Result of a single semantic probe evaluation.
+ */
+export interface SemanticProbeResult {
+    /** The probe that was evaluated */
+    readonly probe: SemanticProbe;
+    /** Semantic similarity score (0.0 = completely different, 1.0 = identical) */
+    readonly similarityScore: number;
+    /** Drift classification */
+    readonly driftLevel: DriftLevel;
+    /** Whether the behavioral contract was violated */
+    readonly contractViolated: boolean;
+    /** Specific violations detected by the judge */
+    readonly violations: readonly string[];
+    /** LLM judge's reasoning */
+    readonly reasoning: string;
+    /** Raw LLM response (if configured) */
+    readonly rawResponse: string | null;
+    /** ISO-8601 timestamp of evaluation */
+    readonly evaluatedAt: string;
+}
+/** Drift level classification */
+export type DriftLevel = 'none' | 'low' | 'medium' | 'high';
+/**
+ * Aggregated result of multiple semantic probes.
+ */
+export interface SemanticProbeReport {
+    /** Tool name */
+    readonly toolName: string;
+    /** All individual probe results */
+    readonly results: readonly SemanticProbeResult[];
+    /** Overall drift assessment */
+    readonly overallDrift: DriftLevel;
+    /** Number of contract violations */
+    readonly violationCount: number;
+    /** Whether the tool is considered semantically stable */
+    readonly stable: boolean;
+    /** Human-readable summary */
+    readonly summary: string;
+    /** ISO-8601 timestamp */
+    readonly completedAt: string;
+}
+/**
+ * Create a semantic probe from input/output pairs.
+ *
+ * @param toolName - Tool name
+ * @param actionKey - Action key
+ * @param input - Input arguments
+ * @param expectedOutput - Known-good baseline output
+ * @param actualOutput - Current handler output
+ * @param contractContext - Behavioral contract context
+ * @returns A structured semantic probe
+ */
+export declare function createProbe(toolName: string, actionKey: string, input: Record<string, unknown>, expectedOutput: unknown, actualOutput: unknown, contractContext: ProbeContractContext): SemanticProbe;
+/**
+ * Build the evaluation prompt for the LLM judge.
+ *
+ * The prompt is structured to elicit a JSON-formatted response
+ * with specific fields for programmatic parsing.
+ *
+ * @param probe - The semantic probe to evaluate
+ * @returns Complete evaluation prompt
+ */
+export declare function buildJudgePrompt(probe: SemanticProbe): string;
+/**
+ * Parse the LLM judge's response into a structured result.
+ *
+ * Handles malformed responses gracefully by falling back
+ * to conservative defaults.
+ *
+ * @param probe - The probe that was evaluated
+ * @param rawResponse - Raw LLM response text
+ * @param config - Probe configuration
+ * @returns Structured probe result
+ */
+export declare function parseJudgeResponse(probe: SemanticProbe, rawResponse: string, config: SemanticProbeConfig): SemanticProbeResult;
+/**
+ * Run a complete semantic probe evaluation.
+ *
+ * @param probe - The probe to evaluate
+ * @param config - Probe configuration (includes LLM adapter)
+ * @returns Evaluation result
+ */
+export declare function evaluateProbe(probe: SemanticProbe, config: SemanticProbeConfig): Promise<SemanticProbeResult>;
+/**
+ * Run multiple probes and aggregate results.
+ *
+ * @param probes - Array of probes to evaluate
+ * @param config - Probe configuration
+ * @returns Aggregated report
+ */
+export declare function evaluateProbes(probes: readonly SemanticProbe[], config: SemanticProbeConfig): Promise<SemanticProbeReport>;
+/**
+ * Aggregate individual probe results into a report.
+ *
+ * @param toolName - Tool name
+ * @param results - Individual probe results
+ * @returns Aggregated report
+ */
+export declare function aggregateResults(toolName: string, results: readonly SemanticProbeResult[]): SemanticProbeReport;
+//# sourceMappingURL=SemanticProbe.d.ts.map

package/dist/introspection/SemanticProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemanticProbe.d.ts","sourceRoot":"","sources":["../../src/introspection/SemanticProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAClD,kDAAkD;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,4CAA4C;IAC5C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAC;CAClD;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uCAAuC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAED,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,+BAA+B;IAC/B,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAClC,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAChC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,cAAc,EAAE,OAAO,EACvB,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,oBAAoB,GACtC,aAAa,CAaf;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAqD7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,aAAa,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,GAC5B,mBAAmB,CAoCrB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAC/B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,mBAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAI9B;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAChC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,MAAM,EAAE,mBAAmB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAgC9B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,SAAS,mBAAmB,EAAE,GACxC,mBAAmB,CA8BrB"}