@zhivex-ai/core 0.7.0 → 0.8.0

package/README.md

@@ -12,6 +12,11 @@ bun add @zhivex-ai/core
 
 Use `@zhivex-ai/core` when you are building custom adapters or need the lower-level shared contract directly.
 
+Most applications should install `@zhivex-ai/sdk` and follow the main adoption guides:
+
+- Quickstart: <https://github.com/Zhivex/zhivex-ai-sdk/blob/main/docs/QUICKSTART.md>
+- Production guide: <https://github.com/Zhivex/zhivex-ai-sdk/blob/main/docs/PRODUCTION.md>
+
 Repository and full documentation:
 
 - <https://github.com/Zhivex/zhivex-ai-sdk>

package/dist/advanced-tool-registry.d.ts

@@ -0,0 +1,112 @@
+import { z } from "zod";
+import type { AnyToolDefinition, JsonValue, ToolCollection, ToolDefinition, ToolRegistryLike, ToolSet } from "./types.js";
+export type AdvancedToolSource = "local" | "mcp" | "hosted" | "http" | "custom";
+export type ToolPermission = "read" | "write" | "network" | "filesystem" | "code-execution" | "shell" | "external-side-effect";
+export interface ToolAuditMetadata {
+    displayName?: string;
+    riskLevel?: "low" | "medium" | "high" | "critical";
+    owner?: string;
+    labels?: string[];
+    description?: string;
+}
+export interface AdvancedToolRegistryEntry<TTool extends AnyToolDefinition = AnyToolDefinition> {
+    tool: TTool;
+    source?: AdvancedToolSource;
+    permissions?: ToolPermission[];
+    audit?: ToolAuditMetadata;
+    metadata?: Record<string, JsonValue>;
+}
+export interface HttpToolOptions<TSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+    name: string;
+    description?: string;
+    schema: TSchema;
+    url: string | URL;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    mapResponse?: (response: Response, input: z.infer<TSchema>) => Promise<JsonValue> | JsonValue;
+    metadata?: Record<string, JsonValue>;
+}
+export interface ToolTestResult {
+    ok: boolean;
+    toolName: string;
+    output?: JsonValue;
+    error?: {
+        message: string;
+    };
+}
+export interface ToolRegistryTestCase {
+    toolName: string;
+    input: unknown;
+}
+export type ToolPermissionPreset = "read-only" | "network-read" | "filesystem-write" | "code-execution" | "external-side-effect" | "admin";
+export interface ToolFixtureCase {
+    name?: string;
+    toolName: string;
+    input: JsonValue;
+    expectedOutput?: JsonValue;
+    expectedErrorContains?: string;
+    metadata?: Record<string, JsonValue>;
+}
+export interface ToolTestFixture {
+    name?: string;
+    cases: ToolFixtureCase[];
+    metadata?: Record<string, JsonValue>;
+    createdAt?: number;
+}
+export interface ToolFixtureCaseResult extends ToolTestResult {
+    name?: string;
+    input: JsonValue;
+    expectedOutput?: JsonValue;
+    expectedErrorContains?: string;
+    failures: string[];
+    metadata?: Record<string, JsonValue>;
+}
+export interface ToolFixtureResult {
+    ok: boolean;
+    cases: ToolFixtureCaseResult[];
+}
+export interface ToolRegistryInspectionTool {
+    name: string;
+    kind: "callable" | "hosted";
+    source: AdvancedToolSource;
+    permissions: ToolPermission[];
+    audit?: ToolAuditMetadata;
+    requiresApproval: boolean;
+    metadata?: Record<string, JsonValue>;
+}
+export interface ToolRegistryInspection {
+    tools: ToolRegistryInspectionTool[];
+}
+export declare class AdvancedToolRegistry implements ToolRegistryLike {
+    private readonly entriesByName;
+    constructor(initial?: ToolCollection | Iterable<AnyToolDefinition | AdvancedToolRegistryEntry>);
+    register<TTool extends AnyToolDefinition>(value: TTool | AdvancedToolRegistryEntry<TTool>, defaults?: Omit<AdvancedToolRegistryEntry<TTool>, "tool">): AdvancedToolRegistryEntry<TTool>;
+    registerMany(input: ToolCollection | undefined, defaults?: Omit<AdvancedToolRegistryEntry, "tool">): this;
+    merge(...inputs: Array<ToolCollection | AdvancedToolRegistry | undefined>): AdvancedToolRegistry;
+    get(name: string): AnyToolDefinition | undefined;
+    getEntry(name: string): AdvancedToolRegistryEntry | undefined;
+    has(name: string): boolean;
+    entries(): Iterable<[string, AnyToolDefinition]>;
+    advancedEntries(): Iterable<AdvancedToolRegistryEntry>;
+    toToolSet(): ToolSet;
+}
+export declare const createAdvancedToolRegistry: (initial?: ToolCollection | Iterable<AnyToolDefinition | AdvancedToolRegistryEntry>) => AdvancedToolRegistry;
+export declare const createHttpTool: <TSchema extends z.ZodTypeAny>(options: HttpToolOptions<TSchema>) => AdvancedToolRegistryEntry<ToolDefinition<TSchema, JsonValue>>;
+export declare const testToolDefinition: (definition: AnyToolDefinition, input: unknown) => Promise<ToolTestResult>;
+export declare const testToolRegistry: (registry: ToolCollection, cases: ToolRegistryTestCase[]) => Promise<ToolTestResult[]>;
+export declare const createToolPermissionPreset: (preset: ToolPermissionPreset) => Omit<AdvancedToolRegistryEntry, "tool">;
+export declare const createToolTestFixture: (options: {
+    name?: string;
+    cases: ToolFixtureCase[];
+    metadata?: Record<string, JsonValue>;
+    createdAt?: number;
+}) => ToolTestFixture;
+export declare const recordToolTestFixture: (registry: ToolCollection, cases: Array<ToolRegistryTestCase | ToolFixtureCase>, options?: {
+    name?: string;
+    metadata?: Record<string, JsonValue>;
+    createdAt?: number;
+}) => Promise<ToolTestFixture>;
+export declare const runToolTestFixture: (registry: ToolCollection, fixture: ToolTestFixture) => Promise<ToolFixtureResult>;
+export declare const inspectToolRegistry: (registry: ToolCollection) => ToolRegistryInspection;
+//# sourceMappingURL=advanced-tool-registry.d.ts.map

package/dist/advanced-tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced-tool-registry.d.ts","sourceRoot":"","sources":["../src/advanced-tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1H,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEhF,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,OAAO,GACP,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,OAAO,GACP,sBAAsB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB,CAAC,KAAK,SAAS,iBAAiB,GAAG,iBAAiB;IAC5F,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,sBAAsB,GACtB,OAAO,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,qBAAqB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,0BAA0B,EAAE,CAAC;CACrC;AAiGD,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;gBAElE,OAAO,CAAC,EAAE,cAAc,GAAG,QAAQ,CAAC,iBAAiB,GAAG,yBAAyB,CAAC;IAoB9F,QAAQ,CAAC,KAAK,SAAS,iBAAiB,EACtC,KAAK,EAAE,KAAK,GAAG,yBAAyB,CAAC,KAAK,CAAC,EAC/C,QAAQ,CAAC,EAAE,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,GACxD,yBAAyB,CAAC,KAAK,CAAC;IAWnC,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,GAAG,IAAI;IAazG,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,CAAC,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAAC,GAAG,oBAAoB;IAiBhG,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAKhD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS;IAI7D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,OAAO,IAAI,QAAQ,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAIhD,eAAe,IAAI,QAAQ,CAAC,yBAAyB,CAAC;IAItD,SAAS,IAAI,OAAO;CAKrB;AAED,eAAO,MAAM,0BAA0B,GACrC,UAAU,cAAc,GAAG,QAAQ,CAAC,iBAAiB,GAAG,yBAAyB,CAAC,KACjF,oBAAyD,CAAC;AAE7D,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,CAAC,CAAC,UAAU,EACzD,SAAS,eAAe,CAAC,OAAO,CAAC,KAChC,yBAAyB,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CA4D9D,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,YAAY,iBAAiB,EAC7B,OAAO,OAAO,KACb,OAAO,CAAC,cAAc,CAqCxB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,UAAU,cAAc,EACxB,OAAO,oBAAoB,EAAE,KAC5B,OAAO,CAAC,cAAc,EAAE,CAqB1B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,oBAAoB,KAC3B,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAiCxC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,SAAS;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,eASF,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAChC,UAAU,cAAc,EACxB,OAAO,KAAK,CAAC,oBAAoB,GAAG,eAAe,CAAC,EACpD,UAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,KACxF,OAAO,CAAC,eAAe,CAkBzB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,cAAc,EACxB,SAAS,eAAe,KACvB,OAAO,CAAC,iBAAiB,CAwC3B,CAAC;AAyCF,eAAO,MAAM,mBAAmB,GAAI,UAAU,cAAc,KAAG,sBAW9D,CAAC"}

package/dist/advanced-tool-registry.js

@@ -0,0 +1,407 @@
+import { ValidationError } from "./errors.js";
+import { isHostedToolDefinition, serializeJsonValue, tool } from "./messages.js";
+import { isToolRegistry, toToolSet } from "./tool-registry.js";
+const sensitivePermissions = new Set([
+    "write",
+    "filesystem",
+    "code-execution",
+    "shell",
+    "external-side-effect"
+]);
+const riskRequiresApproval = (riskLevel) => riskLevel === "high" || riskLevel === "critical";
+const permissionsRequireApproval = (permissions) => permissions?.some((permission) => sensitivePermissions.has(permission)) ?? false;
+const cloneTool = (definition) => ({
+    ...definition,
+    metadata: definition.metadata ? { ...definition.metadata } : undefined
+});
+const isCallableTool = (definition) => "execute" in definition;
+const jsonEqual = (left, right) => JSON.stringify(serializeJsonValue(left)) === JSON.stringify(serializeJsonValue(right));
+const normalizeEntry = (value, defaults) => "tool" in value
+    ? {
+        ...defaults,
+        ...value,
+        permissions: value.permissions ?? defaults?.permissions,
+        audit: value.audit ?? defaults?.audit,
+        metadata: value.metadata ?? defaults?.metadata
+    }
+    : {
+        ...defaults,
+        tool: value
+    };
+const materializeEntry = (entry) => {
+    const definition = cloneTool(entry.tool);
+    const metadata = serializeJsonValue({
+        ...(definition.metadata ?? {}),
+        ...(entry.metadata ?? {}),
+        advancedRegistry: {
+            source: entry.source ?? "custom",
+            permissions: entry.permissions ?? [],
+            audit: entry.audit ?? null
+        }
+    });
+    return {
+        ...definition,
+        metadata,
+        requiresApproval: definition.requiresApproval ??
+            (permissionsRequireApproval(entry.permissions) || riskRequiresApproval(entry.audit?.riskLevel))
+    };
+};
+const jsonResponse = async (response) => {
+    const contentType = response.headers.get("content-type") ?? "";
+    if (contentType.includes("application/json")) {
+        return serializeJsonValue(await response.json());
+    }
+    return serializeJsonValue(await response.text());
+};
+const appendSearchParams = (url, input) => {
+    if (!input || typeof input !== "object" || Array.isArray(input)) {
+        url.searchParams.set("input", JSON.stringify(input));
+        return;
+    }
+    for (const [key, value] of Object.entries(input)) {
+        url.searchParams.set(key, typeof value === "string" ? value : JSON.stringify(value));
+    }
+};
+const withTimeoutSignal = (timeoutMs) => {
+    if (!timeoutMs) {
+        return undefined;
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    return {
+        signal: controller.signal,
+        clear: () => clearTimeout(timer)
+    };
+};
+export class AdvancedToolRegistry {
+    entriesByName = new Map();
+    constructor(initial) {
+        if (!initial) {
+            return;
+        }
+        if (isToolRegistry(initial)) {
+            this.registerMany(initial.toToolSet());
+            return;
+        }
+        if (Symbol.iterator in Object(initial)) {
+            for (const entry of initial) {
+                this.register(entry);
+            }
+            return;
+        }
+        this.registerMany(initial);
+    }
+    register(value, defaults) {
+        const entry = normalizeEntry(value, defaults);
+        const existing = this.entriesByName.get(entry.tool.name);
+        if (existing && existing.tool !== entry.tool) {
+            throw new ValidationError(`Tool "${entry.tool.name}" is already registered.`);
+        }
+        this.entriesByName.set(entry.tool.name, entry);
+        return entry;
+    }
+    registerMany(input, defaults) {
+        const toolSet = toToolSet(input);
+        if (!toolSet) {
+            return this;
+        }
+        for (const definition of Object.values(toolSet)) {
+            this.register(definition, defaults);
+        }
+        return this;
+    }
+    merge(...inputs) {
+        const merged = new AdvancedToolRegistry(this.advancedEntries());
+        for (const input of inputs) {
+            if (!input) {
+                continue;
+            }
+            if (input instanceof AdvancedToolRegistry) {
+                for (const entry of input.advancedEntries()) {
+                    merged.register(entry);
+                }
+            }
+            else {
+                merged.registerMany(input);
+            }
+        }
+        return merged;
+    }
+    get(name) {
+        const entry = this.entriesByName.get(name);
+        return entry ? materializeEntry(entry) : undefined;
+    }
+    getEntry(name) {
+        return this.entriesByName.get(name);
+    }
+    has(name) {
+        return this.entriesByName.has(name);
+    }
+    entries() {
+        return Object.entries(this.toToolSet());
+    }
+    advancedEntries() {
+        return this.entriesByName.values();
+    }
+    toToolSet() {
+        return Object.fromEntries([...this.entriesByName.entries()].map(([name, entry]) => [name, materializeEntry(entry)]));
+    }
+}
+export const createAdvancedToolRegistry = (initial) => new AdvancedToolRegistry(initial);
+export const createHttpTool = (options) => {
+    const method = options.method ?? "POST";
+    const definition = tool({
+        name: options.name,
+        description: options.description,
+        schema: options.schema,
+        metadata: serializeJsonValue({
+            ...(options.metadata ?? {}),
+            source: "http",
+            url: String(options.url),
+            method
+        }),
+        execute: async (input) => {
+            const serializedInput = serializeJsonValue(input);
+            const url = new URL(String(options.url));
+            const timeout = withTimeoutSignal(options.timeoutMs);
+            const init = {
+                method,
+                headers: {
+                    accept: "application/json, text/plain;q=0.9, */*;q=0.8",
+                    ...options.headers
+                },
+                signal: timeout?.signal
+            };
+            if (method === "GET") {
+                appendSearchParams(url, serializedInput);
+            }
+            else {
+                init.headers = {
+                    "content-type": "application/json",
+                    ...init.headers
+                };
+                init.body = JSON.stringify(serializedInput);
+            }
+            try {
+                const response = await fetch(url, init);
+                if (!response.ok) {
+                    throw new Error(`HTTP tool "${options.name}" failed with status ${response.status}.`);
+                }
+                return serializeJsonValue(options.mapResponse ? await options.mapResponse(response, input) : await jsonResponse(response));
+            }
+            finally {
+                timeout?.clear();
+            }
+        }
+    });
+    return {
+        tool: definition,
+        source: "http",
+        permissions: ["network", "external-side-effect"],
+        audit: {
+            displayName: options.name,
+            riskLevel: "medium",
+            description: options.description
+        }
+    };
+};
+export const testToolDefinition = async (definition, input) => {
+    if (!isCallableTool(definition)) {
+        return {
+            ok: false,
+            toolName: definition.name,
+            error: {
+                message: `Tool "${definition.name}" is hosted and cannot be executed locally.`
+            }
+        };
+    }
+    const parsed = definition.schema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            toolName: definition.name,
+            error: {
+                message: `Invalid input for tool "${definition.name}": ${parsed.error.message}`
+            }
+        };
+    }
+    try {
+        return {
+            ok: true,
+            toolName: definition.name,
+            output: serializeJsonValue(await definition.execute(parsed.data))
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            toolName: definition.name,
+            error: {
+                message: error instanceof Error ? error.message : String(error)
+            }
+        };
+    }
+};
+export const testToolRegistry = async (registry, cases) => {
+    const toolSet = toToolSet(registry) ?? {};
+    const results = [];
+    for (const testCase of cases) {
+        const definition = toolSet[testCase.toolName];
+        if (!definition) {
+            results.push({
+                ok: false,
+                toolName: testCase.toolName,
+                error: {
+                    message: `Tool "${testCase.toolName}" is not registered.`
+                }
+            });
+            continue;
+        }
+        results.push(await testToolDefinition(definition, testCase.input));
+    }
+    return results;
+};
+export const createToolPermissionPreset = (preset) => {
+    switch (preset) {
+        case "read-only":
+            return {
+                permissions: ["read"],
+                audit: { riskLevel: "low", labels: ["read-only"] }
+            };
+        case "network-read":
+            return {
+                permissions: ["read", "network"],
+                audit: { riskLevel: "medium", labels: ["network"] }
+            };
+        case "filesystem-write":
+            return {
+                permissions: ["read", "write", "filesystem"],
+                audit: { riskLevel: "high", labels: ["filesystem"] }
+            };
+        case "code-execution":
+            return {
+                permissions: ["code-execution"],
+                audit: { riskLevel: "critical", labels: ["code-execution"] }
+            };
+        case "external-side-effect":
+            return {
+                permissions: ["network", "external-side-effect"],
+                audit: { riskLevel: "high", labels: ["external-side-effect"] }
+            };
+        case "admin":
+            return {
+                permissions: ["read", "write", "network", "filesystem", "code-execution", "shell", "external-side-effect"],
+                audit: { riskLevel: "critical", labels: ["admin"] }
+            };
+    }
+};
+export const createToolTestFixture = (options) => ({
+    name: options.name,
+    cases: options.cases.map((testCase) => ({
+        ...testCase,
+        input: serializeJsonValue(testCase.input),
+        expectedOutput: testCase.expectedOutput === undefined ? undefined : serializeJsonValue(testCase.expectedOutput)
+    })),
+    metadata: options.metadata,
+    createdAt: options.createdAt ?? Date.now()
+});
+export const recordToolTestFixture = async (registry, cases, options = {}) => {
+    const results = await testToolRegistry(registry, cases);
+    return createToolTestFixture({
+        name: options.name,
+        metadata: options.metadata,
+        createdAt: options.createdAt,
+        cases: cases.map((testCase, index) => {
+            const result = results[index];
+            return {
+                name: "name" in testCase ? testCase.name : undefined,
+                toolName: testCase.toolName,
+                input: serializeJsonValue(testCase.input),
+                expectedOutput: result?.ok ? result.output : undefined,
+                expectedErrorContains: result?.ok ? undefined : result?.error?.message,
+                metadata: "metadata" in testCase ? testCase.metadata : undefined
+            };
+        })
+    });
+};
+export const runToolTestFixture = async (registry, fixture) => {
+    const results = await testToolRegistry(registry, fixture.cases);
+    const cases = fixture.cases.map((testCase, index) => {
+        const result = results[index] ?? {
+            ok: false,
+            toolName: testCase.toolName,
+            error: { message: `Tool "${testCase.toolName}" did not return a result.` }
+        };
+        const failures = [];
+        if (testCase.expectedOutput !== undefined && !jsonEqual(result.output, testCase.expectedOutput)) {
+            failures.push(`Expected output for tool "${testCase.toolName}" did not match fixture.`);
+        }
+        if (testCase.expectedErrorContains !== undefined &&
+            !result.error?.message.includes(testCase.expectedErrorContains)) {
+            failures.push(`Expected error for tool "${testCase.toolName}" to contain "${testCase.expectedErrorContains}".`);
+        }
+        if (testCase.expectedOutput !== undefined && !result.ok) {
+            failures.push(`Expected tool "${testCase.toolName}" to succeed.`);
+        }
+        const expectedFailure = testCase.expectedErrorContains !== undefined;
+        return {
+            ...result,
+            name: testCase.name,
+            input: testCase.input,
+            expectedOutput: testCase.expectedOutput,
+            expectedErrorContains: testCase.expectedErrorContains,
+            failures,
+            ok: failures.length === 0 && (expectedFailure ? !result.ok : result.ok),
+            metadata: testCase.metadata
+        };
+    });
+    return {
+        ok: cases.every((testCase) => testCase.ok),
+        cases
+    };
+};
+const metadataAdvancedRegistry = (definition) => {
+    const metadata = definition.metadata?.advancedRegistry;
+    return metadata && typeof metadata === "object" && !Array.isArray(metadata)
+        ? metadata
+        : undefined;
+};
+const inspectDefinition = (definition, entry) => {
+    const materialized = entry ? materializeEntry(entry) : definition;
+    const advanced = metadataAdvancedRegistry(materialized);
+    const audit = entry?.audit ?? (advanced?.audit && typeof advanced.audit === "object" && !Array.isArray(advanced.audit)
+        ? advanced.audit
+        : undefined);
+    const permissions = entry?.permissions ?? (Array.isArray(advanced?.permissions)
+        ? advanced.permissions.filter((permission) => typeof permission === "string" && [
+            "read",
+            "write",
+            "network",
+            "filesystem",
+            "code-execution",
+            "shell",
+            "external-side-effect"
+        ].includes(permission))
+        : []);
+    return {
+        name: materialized.name,
+        kind: isHostedToolDefinition(materialized) ? "hosted" : "callable",
+        source: entry?.source ?? (typeof advanced?.source === "string" ? advanced.source : "custom"),
+        permissions,
+        audit,
+        requiresApproval: materialized.requiresApproval ?? false,
+        metadata: materialized.metadata
+    };
+};
+export const inspectToolRegistry = (registry) => {
+    if (registry instanceof AdvancedToolRegistry) {
+        return {
+            tools: [...registry.advancedEntries()].map((entry) => inspectDefinition(entry.tool, entry))
+        };
+    }
+    const toolSet = toToolSet(registry) ?? {};
+    return {
+        tools: Object.values(toolSet).map((definition) => inspectDefinition(definition))
+    };
+};
+//# sourceMappingURL=advanced-tool-registry.js.map

package/dist/advanced-tool-registry.js.map

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