@vibesdotdev/tools 0.0.0-stage → 1.0.0-rc.3

package/dist/errors/domain.js

@@ -0,0 +1,58 @@
+import { ToolErrorCode } from "./codes.js";
+import { ToolError } from "./tool-error.js";
+export class ToolDependencyError extends ToolError {
+    missingDependencies;
+    constructor(message, missingDependencies, metadata, recoveryHint) {
+        super(message, ToolErrorCode.DEPENDENCY_MISSING, metadata, recoveryHint || `Missing required dependencies: ${missingDependencies.join(', ')}`);
+        this.missingDependencies = missingDependencies;
+        this.name = 'ToolDependencyError';
+    }
+    toJSON() {
+        return { ...super.toJSON(), missingDependencies: this.missingDependencies };
+    }
+}
+export class ToolPermissionError extends ToolError {
+    requiredPermissions;
+    constructor(message, requiredPermissions, metadata, recoveryHint) {
+        super(message, ToolErrorCode.PERMISSION_DENIED, metadata, recoveryHint || 'You do not have permission to perform this operation.');
+        this.requiredPermissions = requiredPermissions;
+        this.name = 'ToolPermissionError';
+    }
+    toJSON() {
+        return { ...super.toJSON(), requiredPermissions: this.requiredPermissions };
+    }
+}
+export class ToolTimeoutError extends ToolError {
+    timeoutMs;
+    constructor(message, timeoutMs, metadata, recoveryHint) {
+        super(message, ToolErrorCode.TIMEOUT, metadata, recoveryHint || `Operation timed out after ${timeoutMs}ms. Try again or use a simpler input.`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'ToolTimeoutError';
+    }
+    toJSON() {
+        return { ...super.toJSON(), timeoutMs: this.timeoutMs };
+    }
+}
+export class ToolNotFoundError extends ToolError {
+    toolId;
+    constructor(message, toolId, metadata, recoveryHint) {
+        super(message, ToolErrorCode.NOT_FOUND, metadata, recoveryHint || `Tool "${toolId}" was not found in the registry.`);
+        this.toolId = toolId;
+        this.name = 'ToolNotFoundError';
+    }
+    toJSON() {
+        return { ...super.toJSON(), toolId: this.toolId };
+    }
+}
+export class ToolContextError extends ToolError {
+    missingFields;
+    constructor(message, missingFields, metadata, recoveryHint) {
+        super(message, ToolErrorCode.CONTEXT_INVALID, metadata, recoveryHint || 'Tool execution context is invalid or incomplete.');
+        this.missingFields = missingFields;
+        this.name = 'ToolContextError';
+    }
+    toJSON() {
+        return { ...super.toJSON(), missingFields: this.missingFields };
+    }
+}
+//# sourceMappingURL=domain.js.map

package/dist/errors/domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/errors/domain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAGhC;IAFjB,YACC,OAAe,EACC,mBAA6B,EAC7C,QAA2B,EAC3B,YAAqB;QAErB,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,kBAAkB,EAChC,QAAQ,EACR,YAAY,IAAI,kCAAkC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;QATc,wBAAmB,GAAnB,mBAAmB,CAAU;QAU7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7E,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IAGhC;IAFjB,YACC,OAAe,EACC,mBAA8B,EAC9C,QAA2B,EAC3B,YAAqB;QAErB,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,iBAAiB,EAC/B,QAAQ,EACR,YAAY,IAAI,uDAAuD,CACvE,CAAC;QATc,wBAAmB,GAAnB,mBAAmB,CAAW;QAU9C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7E,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAG7B;IAFjB,YACC,OAAe,EACC,SAAiB,EACjC,QAA2B,EAC3B,YAAqB;QAErB,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,OAAO,EACrB,QAAQ,EACR,YAAY,IAAI,6BAA6B,SAAS,uCAAuC,CAC7F,CAAC;QATc,cAAS,GAAT,SAAS,CAAQ;QAUjC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACzD,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAG9B;IAFjB,YACC,OAAe,EACC,MAAc,EAC9B,QAA2B,EAC3B,YAAqB;QAErB,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,SAAS,EACvB,QAAQ,EACR,YAAY,IAAI,SAAS,MAAM,kCAAkC,CACjE,CAAC;QATc,WAAM,GAAN,MAAM,CAAQ;QAU9B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IACnD,CAAC;CACD;AAED,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAG7B;IAFjB,YACC,OAAe,EACC,aAAwB,EACxC,QAA2B,EAC3B,YAAqB;QAErB,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,eAAe,EAC7B,QAAQ,EACR,YAAY,IAAI,kDAAkD,CAClE,CAAC;QATc,kBAAa,GAAb,aAAa,CAAW;QAUxC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAChC,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;IACjE,CAAC;CACD"}

package/dist/errors/execution.d.ts

@@ -0,0 +1,36 @@
+import { ToolErrorCode } from './codes.ts';
+import { ToolError } from './tool-error.ts';
+import type { ToolErrorContext } from './types.ts';
+export declare class ToolExecutionError extends ToolError {
+    readonly cause?: Error;
+    constructor(message: string, options?: {
+        cause?: Error;
+        metadata?: ToolErrorContext;
+        recoveryHint?: string;
+        alternatives?: string[];
+    });
+    toJSON(): {
+        cause: {
+            name: string;
+            message: string;
+        } | undefined;
+        name: string;
+        code: import("@vibesdotdev/kernel").CapabilityErrorCode;
+        toolCode: ToolErrorCode;
+        reason: string;
+        message: string;
+        metadata: {
+            [x: string]: import("@vibesdotdev/kernel/bootstrap").JsonValue | undefined;
+            toolId?: string | undefined;
+            operation?: string | undefined;
+            timestamp?: string | undefined;
+            requestId?: string | undefined;
+            userId?: string | undefined;
+        } | undefined;
+        recoveryHint: string | undefined;
+        alternatives: string[] | undefined;
+        timestamp: string;
+        stack: string | undefined;
+    };
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/errors/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../src/errors/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,kBAAmB,SAAQ,SAAS;IAChD,SAAyB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGtC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,QAAQ,CAAC,EAAE,gBAAgB,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB;IAaF,MAAM;;;;;;;;;;;;;;;;;;;;;;;CASN"}

package/dist/errors/execution.js

@@ -0,0 +1,19 @@
+import { ToolErrorCode } from "./codes.js";
+import { ToolError } from "./tool-error.js";
+export class ToolExecutionError extends ToolError {
+    cause;
+    constructor(message, options) {
+        super(message, ToolErrorCode.EXECUTION_FAILED, options?.metadata, options?.recoveryHint || 'The tool encountered an error during execution.', options?.alternatives);
+        this.name = 'ToolExecutionError';
+        this.cause = options?.cause;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            cause: this.cause instanceof Error
+                ? { name: this.cause.name, message: this.cause.message }
+                : undefined
+        };
+    }
+}
+//# sourceMappingURL=execution.js.map

package/dist/errors/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../src/errors/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IACvB,KAAK,CAAS;IAEvC,YACC,OAAe,EACf,OAKC;QAED,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,gBAAgB,EAC9B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,YAAY,IAAI,iDAAiD,EAC1E,OAAO,EAAE,YAAY,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;IAC7B,CAAC;IAED,MAAM;QACL,OAAO;YACN,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,KAAK,EACJ,IAAI,CAAC,KAAK,YAAY,KAAK;gBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;gBACxD,CAAC,CAAC,SAAS;SACb,CAAC;IACH,CAAC;CACD"}

package/dist/errors/index.d.ts

@@ -0,0 +1,8 @@
+export { ToolError, ToolErrorCode } from './tool-error.ts';
+export type { ToolErrorContext } from './tool-error.ts';
+export { ToolErrorContextSchema } from './types.ts';
+export { ToolExecutionError } from './execution.ts';
+export { ToolContextError, ToolDependencyError, ToolNotFoundError, ToolPermissionError, ToolTimeoutError } from './domain.ts';
+export { ToolValidationError } from './validation.ts';
+export { isToolError, wrapAsToolError } from './util.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,7 @@
+export { ToolError, ToolErrorCode } from "./tool-error.js";
+export { ToolErrorContextSchema } from "./types.js";
+export { ToolExecutionError } from "./execution.js";
+export { ToolContextError, ToolDependencyError, ToolNotFoundError, ToolPermissionError, ToolTimeoutError } from "./domain.js";
+export { ToolValidationError } from "./validation.js";
+export { isToolError, wrapAsToolError } from "./util.js";
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/errors/tool-error.d.ts

@@ -0,0 +1,47 @@
+import { ToolErrorCode } from './codes.ts';
+import type { ToolErrorContext } from './types.ts';
+import { CapabilityError, type CapabilityErrorCode, type RuntimeRef } from '@vibesdotdev/kernel';
+export interface KnowledgeSearchItem {
+    contentText: string;
+    title?: string;
+}
+export interface KnowledgeSearchResponse {
+    items?: KnowledgeSearchItem[];
+}
+export declare class ToolError extends CapabilityError {
+    readonly metadata?: ToolErrorContext | undefined;
+    readonly alternatives?: string[] | undefined;
+    readonly timestamp: Date;
+    readonly toolCode: ToolErrorCode;
+    constructor(message: string, code: ToolErrorCode, metadata?: ToolErrorContext | undefined, recoveryHint?: string, alternatives?: string[] | undefined);
+    toJSON(): {
+        name: string;
+        code: CapabilityErrorCode;
+        toolCode: ToolErrorCode;
+        reason: string;
+        message: string;
+        metadata: {
+            [x: string]: import("@vibesdotdev/kernel/bootstrap").JsonValue | undefined;
+            toolId?: string | undefined;
+            operation?: string | undefined;
+            timestamp?: string | undefined;
+            requestId?: string | undefined;
+            userId?: string | undefined;
+        } | undefined;
+        recoveryHint: string | undefined;
+        alternatives: string[] | undefined;
+        timestamp: string;
+        stack: string | undefined;
+    };
+    getUserMessage(): string;
+    /** The recovery hint, enriched from the knowledge base; an enrichment failure is logged on `runtime`. */
+    getKnowledgeAwareHint(runtime: RuntimeRef, apiClient?: {
+        request: (path: string, init: {
+            method: string;
+            query?: Record<string, string | number | boolean | string[] | undefined>;
+        }) => Promise<KnowledgeSearchResponse | undefined>;
+    }): Promise<string>;
+}
+export { ToolErrorCode } from './codes.ts';
+export type { ToolErrorContext } from './types.ts';
+//# sourceMappingURL=tool-error.d.ts.map

package/dist/errors/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../../src/errors/tool-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAuB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAiBtH,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACvC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,qBAAa,SAAU,SAAQ,eAAe;aAO5B,QAAQ,CAAC,EAAE,gBAAgB;aAE3B,YAAY,CAAC,EAAE,MAAM,EAAE;IARxC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAChC,SAAgB,QAAQ,EAAE,aAAa,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,EACH,QAAQ,CAAC,EAAE,gBAAgB,YAAA,EAC3C,YAAY,CAAC,EAAE,MAAM,EACL,YAAY,CAAC,EAAE,MAAM,EAAE,YAAA;IAaxC,MAAM;;;;;;;;;;;;;;;;;;;IAeN,cAAc,IAAI,MAAM;IAIxB,yGAAyG;IACnG,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAC5D,OAAO,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;YACL,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;SACzE,KACG,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,CAAC;CA8CnB;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/errors/tool-error.js

@@ -0,0 +1,98 @@
+import { ToolErrorCode } from "./codes.js";
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError, CaughtFailureSchema } from '@vibesdotdev/kernel';
+const TOOL_CODE_TO_CAPABILITY = {
+    [ToolErrorCode.VALIDATION_FAILED]: 'INVALID_INPUT',
+    [ToolErrorCode.EXECUTION_FAILED]: 'INTERNAL',
+    [ToolErrorCode.CONTEXT_INVALID]: 'INVALID_INPUT',
+    [ToolErrorCode.DEPENDENCY_MISSING]: 'UNAVAILABLE',
+    [ToolErrorCode.PERMISSION_DENIED]: 'PERMISSION_DENIED',
+    [ToolErrorCode.CAPABILITY_CEILING_DENIED]: 'PERMISSION_DENIED',
+    [ToolErrorCode.EGRESS_NOT_ALLOWED]: 'PERMISSION_DENIED',
+    [ToolErrorCode.TIMEOUT]: 'TIMEOUT',
+    [ToolErrorCode.NOT_FOUND]: 'NOT_FOUND',
+    [ToolErrorCode.RATE_LIMITED]: 'RATE_LIMITED',
+    [ToolErrorCode.CANCELLED]: 'CANCELLED',
+    [ToolErrorCode.INTERNAL]: 'INTERNAL'
+};
+export class ToolError extends CapabilityError {
+    metadata;
+    alternatives;
+    timestamp;
+    toolCode;
+    constructor(message, code, metadata, recoveryHint, alternatives) {
+        const capCode = TOOL_CODE_TO_CAPABILITY[code] ?? 'INTERNAL';
+        super(message, capCode, {
+            recoveryHint,
+            reason: code.toLowerCase().replaceAll('_', '-'),
+            details: metadata ? { toolId: metadata.toolId, operation: metadata.operation } : undefined
+        });
+        this.metadata = metadata;
+        this.alternatives = alternatives;
+        this.name = 'ToolError';
+        this.toolCode = code;
+        this.timestamp = new Date();
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            toolCode: this.toolCode,
+            reason: this.reason,
+            message: this.message,
+            metadata: this.metadata,
+            recoveryHint: this.recoveryHint,
+            alternatives: this.alternatives,
+            timestamp: this.timestamp.toISOString(),
+            stack: this.stack
+        };
+    }
+    getUserMessage() {
+        return this.recoveryHint || this.message;
+    }
+    /** The recovery hint, enriched from the knowledge base; an enrichment failure is logged on `runtime`. */
+    async getKnowledgeAwareHint(runtime, apiClient) {
+        const baseHint = this.recoveryHint || this.message;
+        if (!apiClient)
+            return baseHint;
+        try {
+            const searchTerms = [
+                this.code,
+                this.message.slice(0, 100),
+                this.metadata?.toolId,
+                this.metadata?.operation
+            ]
+                .filter(Boolean)
+                .join(' ');
+            const response = await apiClient.request('/api/knowledge/search', {
+                method: 'GET',
+                query: { query: searchTerms, contentType: 'instruction', limit: 3 }
+            });
+            if (response?.items && response.items.length > 0) {
+                const solutions = response.items
+                    .map((item, i) => {
+                    const title = item.title ? `${item.title}: ` : '';
+                    const text = item.contentText.length > 150
+                        ? `${item.contentText.slice(0, 147)}...`
+                        : item.contentText;
+                    return `${i + 1}. ${title}${text}`;
+                })
+                    .join('\n');
+                return `${baseHint}\n\n**Related solutions from knowledge base:**\n${solutions}`;
+            }
+        }
+        catch (error) {
+            const failure = CaughtFailureSchema.parse(error);
+            if (CapabilityError.isAbsenceOf(failure, 'knowledge', 'search') || (failure instanceof Error && failure.name === 'AbortError')) {
+                return baseHint;
+            }
+            getLogger('tools:tool-error', runtime).debug('Recovery hint enrichment failed; using the base hint', {
+                error: failure instanceof Error ? failure.message : failure.description
+            });
+            throw failure;
+        }
+        return baseHint;
+    }
+}
+export { ToolErrorCode } from "./codes.js";
+//# sourceMappingURL=tool-error.js.map

package/dist/errors/tool-error.js.map

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

package/dist/errors/types.d.ts

@@ -0,0 +1,10 @@
+import * as z from 'zod/v4';
+export declare const ToolErrorContextSchema: z.ZodObject<{
+    toolId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodType<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue, z.core.$ZodTypeInternals<import("@vibesdotdev/kernel/bootstrap").JsonValue, import("@vibesdotdev/kernel/bootstrap").JsonValue>>>>>;
+export type ToolErrorContext = z.infer<typeof ToolErrorContextSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;;;;;oRAMI,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/errors/types.js

@@ -0,0 +1,10 @@
+import * as z from 'zod/v4';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+export const ToolErrorContextSchema = z.object({
+    toolId: z.string().optional(),
+    operation: z.string().optional(),
+    timestamp: z.string().optional(),
+    requestId: z.string().optional(),
+    userId: z.string().optional()
+}).catchall(JsonValueSchema.optional());
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC"}

package/dist/errors/util.d.ts

@@ -0,0 +1,4 @@
+import { ToolError } from './tool-error.ts';
+export declare function isToolError(error: unknown): error is ToolError;
+export declare function wrapAsToolError(error: Error | string | null | undefined, toolId?: string, operation?: string): ToolError;
+//# sourceMappingURL=util.d.ts.map

package/dist/errors/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/errors/util.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAQxH"}

package/dist/errors/util.js

@@ -0,0 +1,15 @@
+import { ToolExecutionError } from "./execution.js";
+import { ToolError } from "./tool-error.js";
+export function isToolError(error) {
+    return error instanceof ToolError;
+}
+export function wrapAsToolError(error, toolId, operation) {
+    if (isToolError(error))
+        return error;
+    const metadata = { toolId, operation };
+    if (error instanceof Error) {
+        return new ToolExecutionError(error.message, { cause: error, metadata });
+    }
+    return new ToolExecutionError(String(error ?? 'Unknown error'), { metadata });
+}
+//# sourceMappingURL=util.js.map

package/dist/errors/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../src/errors/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,SAAS,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAwC,EAAE,MAAe,EAAE,SAAkB;IAC5G,IAAI,WAAW,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAErC,MAAM,QAAQ,GAAqB,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACzD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/errors/validation.d.ts

@@ -0,0 +1,42 @@
+import { ToolErrorCode } from './codes.ts';
+import { ToolError } from './tool-error.ts';
+import type { ToolErrorContext } from './types.ts';
+export declare class ToolValidationError extends ToolError {
+    readonly validationErrors?: Array<{
+        path: string;
+        message: string;
+    }>;
+    constructor(message: string, options?: {
+        validationErrors?: Array<{
+            path: string;
+            message: string;
+        }>;
+        metadata?: ToolErrorContext;
+        recoveryHint?: string;
+        alternatives?: string[];
+    });
+    toJSON(): {
+        validationErrors: {
+            path: string;
+            message: string;
+        }[] | undefined;
+        name: string;
+        code: import("@vibesdotdev/kernel").CapabilityErrorCode;
+        toolCode: ToolErrorCode;
+        reason: string;
+        message: string;
+        metadata: {
+            [x: string]: import("@vibesdotdev/kernel/bootstrap").JsonValue | undefined;
+            toolId?: string | undefined;
+            operation?: string | undefined;
+            timestamp?: string | undefined;
+            requestId?: string | undefined;
+            userId?: string | undefined;
+        } | undefined;
+        recoveryHint: string | undefined;
+        alternatives: string[] | undefined;
+        timestamp: string;
+        stack: string | undefined;
+    };
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/errors/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/errors/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,SAAgB,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAG3E,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,gBAAgB,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAC5D,QAAQ,CAAC,EAAE,gBAAgB,CAAC;QAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB;IAaF,MAAM;;kBAtB2C,MAAM;qBAAW,MAAM;;;;;;;;;;;;;;;;;;;;CAyBxE"}

package/dist/errors/validation.js

@@ -0,0 +1,14 @@
+import { ToolErrorCode } from "./codes.js";
+import { ToolError } from "./tool-error.js";
+export class ToolValidationError extends ToolError {
+    validationErrors;
+    constructor(message, options) {
+        super(message, ToolErrorCode.VALIDATION_FAILED, options?.metadata, options?.recoveryHint || 'Check the input parameters and try again.', options?.alternatives);
+        this.name = 'ToolValidationError';
+        this.validationErrors = options?.validationErrors;
+    }
+    toJSON() {
+        return { ...super.toJSON(), validationErrors: this.validationErrors };
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/errors/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/errors/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACjC,gBAAgB,CAA4C;IAE5E,YACC,OAAe,EACf,OAKC;QAED,KAAK,CACJ,OAAO,EACP,aAAa,CAAC,iBAAiB,EAC/B,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,YAAY,IAAI,2CAA2C,EACpE,OAAO,EAAE,YAAY,CACrB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;IACnD,CAAC;IAED,MAAM;QACL,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACvE,CAAC;CACD"}

package/dist/execution/approval.d.ts

@@ -0,0 +1,6 @@
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+import type { ToolApprovalChannelDescriptor } from '@vibesdotdev/ai-schemas/agents/approval/channel';
+/** The same configured channel contract used by agent loops, admitted after tool-owner preflight. */
+export declare function authorizeToolCall<Input>(runtime: VibesRuntime, toolId: string, input: Input, ctx: ToolCallContext, requested?: ToolApprovalChannelDescriptor): Promise<'approved' | 'assumed'>;
+//# sourceMappingURL=approval.d.ts.map

package/dist/execution/approval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/execution/approval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,iDAAiD,CAAC;AAOrG,qGAAqG;AACrG,wBAAsB,iBAAiB,CAAC,KAAK,EAC5C,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,eAAe,EACpB,SAAS,CAAC,EAAE,6BAA6B,GACvC,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAoCjC"}

package/dist/execution/approval.js

@@ -0,0 +1,49 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { ToolApprovalDecisionSchema } from '@vibesdotdev/ai-schemas/agents/approval/types';
+import { ToolApprovalRequestSchema } from '@vibesdotdev/ai-schemas/agents/approval/types';
+import { ToolApprovalClient } from "../agents/approval/approval-client.js";
+import { ToolDescriptorSchema } from "../schemas/runtime/descriptors.js";
+import { getVibesConfigClient } from '@vibesdotdev/config/client';
+import { ToolApprovalChannelDescriptorSchema } from '@vibesdotdev/ai-schemas/agents/approval/channel';
+/** The same configured channel contract used by agent loops, admitted after tool-owner preflight. */
+export async function authorizeToolCall(runtime, toolId, input, ctx, requested) {
+    const descriptor = runtime.hasKind('tools/tool') ? runtime.assets('tools/tool').descriptor(toolId) : undefined;
+    const configured = descriptor === undefined ? undefined : ToolDescriptorSchema.pick({ approval: true }).parse(descriptor).approval;
+    const declared = configured && 'config' in configured
+        ? await (await getVibesConfigClient(runtime)).readField(configured.config, ToolApprovalChannelDescriptorSchema.optional())
+        : configured;
+    // A caller can request a gate, but cannot replace a tool owner's configured requirement.
+    const channel = declared ?? requested;
+    if (channel === undefined) {
+        ctx.metadata = { ...ctx.metadata, toolApproval: 'assumed' };
+        return 'assumed';
+    }
+    const approval = new ToolApprovalClient(runtime);
+    try {
+        const gate = await approval.resolveGate(channel, { signal: ctx.signal });
+        if (!gate)
+            throw new CapabilityError('The configured approval channel is unavailable.', 'UNAVAILABLE', { reason: 'tool-approval-unavailable', retryable: true });
+        const decision = ToolApprovalDecisionSchema.parse(await gate.requestApproval(ToolApprovalRequestSchema.parse({
+            requestId: ctx.callId, toolCallId: ctx.callId, toolId, toolName: toolId,
+            args: input
+        })));
+        if (ctx.signal?.aborted || decision.origin === 'cancelled') {
+            throw new CapabilityError('Tool approval was cancelled.', 'CANCELLED', { reason: 'tool-approval-cancelled' });
+        }
+        if (decision.deferred)
+            throw approval.deferred(ctx.callId, ctx.callId);
+        if (!decision.approved) {
+            const human = decision.origin === 'human';
+            throw new CapabilityError(human ? 'The user declined this tool proposal.' : 'The approval channel supplied no confirmed user approval.', human ? 'PERMISSION_DENIED' : 'UNAVAILABLE', {
+                reason: human ? 'tool-approval-declined' : decision.origin === 'timeout' ? 'tool-approval-timeout' : 'tool-approval-unavailable',
+                retryable: !human
+            });
+        }
+        ctx.metadata = { ...ctx.metadata, toolApproval: 'approved' };
+        return 'approved';
+    }
+    finally {
+        approval.dispose();
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/execution/approval.js.map

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

package/dist/execution/caller-invocation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A tool run as a caller: the identity the caller is (explicit options, else
+ * the identity the launching harness declared, else the invocation's actor,
+ * else the session manager's bindings), the workspace bound for its session,
+ * and the invocation inside that caller's overlay. The CLI's `tools run` and
+ * in-process hosts (the Pi extension) run tools through this one path.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolCallContext } from '../kinds/tool.ts';
+import type { CallerIdentityOptions, CallerToolRun } from './schemas/caller-invocation.ts';
+/**
+ * Project the bound CLI session into the per-call identity envelope.  The
+ * workspace-lock tool uses this to keep custody tied to the current body; the
+ * old command path created a bare ToolCallContext and fell back to the literal
+ * workspace session id `cli`.
+ *
+ * Participant mapping wins over global defaults.
+ */
+export declare function callerFromRuntimeScope(runtime: VibesRuntime, options?: CallerIdentityOptions): Promise<ToolCallContext['caller'] | undefined>;
+/** Run `run.toolId` as the caller `run` names, through the runtime it is handed. */
+export declare function invokeToolAsCaller<T = unknown>(runtime: VibesRuntime, run: CallerToolRun): Promise<T>;
+//# sourceMappingURL=caller-invocation.d.ts.map

package/dist/execution/caller-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caller-invocation.d.ts","sourceRoot":"","sources":["../../src/execution/caller-invocation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGzH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,KAAK,EAAuC,qBAAqB,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEhI;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC,CA2FhD;AA8BD,oFAAoF;AACpF,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAiB3G"}