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

package/dist/agents/execution-bindings.d.ts

@@ -0,0 +1,73 @@
+import * as z from 'zod/v4';
+import type { ToolCallContext } from '@vibesdotdev/kernel/schemas/tool-call';
+/** Server-persisted selectors; never accepted from model-authored tool input. */
+export declare const executionHostTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"cloud">;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"host">;
+    hostId: z.ZodString;
+}, z.core.$strip>], "kind">;
+export declare const executionBindingFields: {
+    /** Undefined preserves the agent policy; an empty list permits no tool calls. */
+    allowedToolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+    browserSessionId: z.ZodOptional<z.ZodString>;
+    desktopSessionId: z.ZodOptional<z.ZodString>;
+    apiSessionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    pullRequest: z.ZodOptional<z.ZodObject<{
+        repositoryId: z.ZodString;
+        pullRequestNumber: z.ZodNumber;
+        expectedHeadSha: z.ZodString;
+        sourceRef: z.ZodString;
+        allowedActions: z.ZodArray<z.ZodEnum<{
+            merge: "merge";
+            review: "review";
+            fix: "fix";
+        }>>;
+        allowEnvironmentExecution: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+};
+export declare function validateExecutionBindings(execution: {
+    browserSessionId?: string;
+    desktopSessionId?: string;
+    hostTarget?: z.infer<typeof executionHostTargetSchema>;
+}, ctx: z.RefinementCtx): void;
+export declare const executionBindingsSchema: z.ZodObject<{
+    allowedToolIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hostTarget: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"cloud">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"host">;
+        hostId: z.ZodString;
+    }, z.core.$strip>], "kind">>;
+    browserSessionId: z.ZodOptional<z.ZodString>;
+    desktopSessionId: z.ZodOptional<z.ZodString>;
+    apiSessionIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    pullRequest: z.ZodOptional<z.ZodObject<{
+        repositoryId: z.ZodString;
+        pullRequestNumber: z.ZodNumber;
+        expectedHeadSha: z.ZodString;
+        sourceRef: z.ZodString;
+        allowedActions: z.ZodArray<z.ZodEnum<{
+            merge: "merge";
+            review: "review";
+            fix: "fix";
+        }>>;
+        allowEnvironmentExecution: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExecutionBindings = z.infer<typeof executionBindingsSchema>;
+/** Malformed trusted bindings fail closed instead of silently becoming an unbound run. */
+export declare function readExecutionBindings(ctx: Pick<ToolCallContext, 'metadata'>): ExecutionBindings | undefined;
+/** Covers runtime tools and custom providers using the same immutable run grant. */
+export declare function assertToolAllowedByExecutionBindings(ctx: Pick<ToolCallContext, 'metadata'>, toolId: string): void;
+/** A tool-input session selector: absent, or the id the model named. */
+export type SessionSelector = string | undefined;
+/** A model-named session must be the server-bound one; absence keeps the bound session. */
+export declare function assertBoundSessionSelector(boundId: string, selected: SessionSelector): void;
+//# sourceMappingURL=execution-bindings.d.ts.map

package/dist/agents/execution-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-bindings.d.ts","sourceRoot":"","sources":["../../src/agents/execution-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E,iFAAiF;AACjF,eAAO,MAAM,yBAAyB;;;;;2BAGpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;IAClC,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;CAejF,CAAC;AAEF,wBAAgB,yBAAyB,CACxC,SAAS,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;CAAE,EAC3H,GAAG,EAAE,CAAC,CAAC,aAAa,GAClB,IAAI,CAIN;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;iBAA0E,CAAC;AAC/G,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAG3G;AAED,oFAAoF;AACpF,wBAAgB,oCAAoC,CACnD,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EACtC,MAAM,EAAE,MAAM,GACZ,IAAI,CASN;AAED,wEAAwE;AACxE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD,2FAA2F;AAC3F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI,CAO3F"}

package/dist/agents/execution-bindings.js

@@ -0,0 +1,56 @@
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+/** Server-persisted selectors; never accepted from model-authored tool input. */
+export const executionHostTargetSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('cloud') }),
+    z.object({ kind: z.literal('host'), hostId: z.string().trim().min(1) })
+]);
+export const executionBindingFields = {
+    /** Undefined preserves the agent policy; an empty list permits no tool calls. */
+    allowedToolIds: z.array(z.string().min(1)).optional(),
+    hostTarget: executionHostTargetSchema.optional(),
+    browserSessionId: z.string().trim().min(1).optional(),
+    desktopSessionId: z.string().trim().min(1).optional(),
+    apiSessionIds: z.array(z.string().trim().min(1)).default([]),
+    pullRequest: z.object({
+        repositoryId: z.string().min(1),
+        pullRequestNumber: z.number().int().positive(),
+        expectedHeadSha: z.string().regex(/^[a-f0-9]{40}$/i),
+        sourceRef: z.string().min(1),
+        allowedActions: z.array(z.enum(['review', 'fix', 'merge'])).min(1),
+        /** Separate consent: commands can use the environment's credentials beyond PR controls. */
+        allowEnvironmentExecution: z.boolean().default(false)
+    }).optional()
+};
+export function validateExecutionBindings(execution, ctx) {
+    if ((execution.browserSessionId || execution.desktopSessionId) && execution.hostTarget?.kind !== 'host') {
+        ctx.addIssue({ code: 'custom', path: ['hostTarget'], message: 'A persisted browser or desktop session requires its configured host' });
+    }
+}
+export const executionBindingsSchema = z.object(executionBindingFields).superRefine(validateExecutionBindings);
+/** Malformed trusted bindings fail closed instead of silently becoming an unbound run. */
+export function readExecutionBindings(ctx) {
+    const value = ctx.metadata?.executionBindings;
+    return value === undefined ? undefined : executionBindingsSchema.parse(value);
+}
+/** Covers runtime tools and custom providers using the same immutable run grant. */
+export function assertToolAllowedByExecutionBindings(ctx, toolId) {
+    const allowed = readExecutionBindings(ctx)?.allowedToolIds;
+    if (allowed && !allowed.includes(toolId)) {
+        throw new CapabilityError(`Tool '${toolId}' is not allowed by this session's execution configuration`, 'PERMISSION_DENIED', {
+            reason: 'tool-not-allowed',
+            retryable: false,
+            details: { toolId }
+        });
+    }
+}
+/** A model-named session must be the server-bound one; absence keeps the bound session. */
+export function assertBoundSessionSelector(boundId, selected) {
+    if (selected !== undefined && selected !== boundId) {
+        throw new CapabilityError('Tool session selection conflicts with the server-bound execution session', 'PERMISSION_DENIED', {
+            reason: 'session-conflict',
+            retryable: false
+        });
+    }
+}
+//# sourceMappingURL=execution-bindings.js.map

package/dist/agents/execution-bindings.js.map

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

package/dist/agents/execution-host.d.ts

@@ -0,0 +1,10 @@
+import type { VibesRuntime, ToolCallContext } from '@vibesdotdev/kernel';
+import type { ToolExecutionResult } from '../kinds/schemas/tool.ts';
+/** Selected-host execution is routed by Fleet; a missing host never means this machine. */
+export declare function dispatchBoundHostTool<Input>(runtime: VibesRuntime, ctx: ToolCallContext, toolId: 'browser' | 'desktop', input: Input): Promise<{
+    dispatched: false;
+} | {
+    dispatched: true;
+    result: ToolExecutionResult;
+}>;
+//# sourceMappingURL=execution-host.d.ts.map

package/dist/agents/execution-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.d.ts","sourceRoot":"","sources":["../../src/agents/execution-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAapE,2FAA2F;AAC3F,wBAAsB,qBAAqB,CAAC,KAAK,EAChD,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,eAAe,EACpB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,KAAK,EAAE,KAAK,GACV,OAAO,CAAC;IAAE,UAAU,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAcpF"}

package/dist/agents/execution-host.js

@@ -0,0 +1,20 @@
+import { readExecutionBindings } from "./execution-bindings.js";
+/** Selected-host execution is routed by Fleet; a missing host never means this machine. */
+export async function dispatchBoundHostTool(runtime, ctx, toolId, input) {
+    const execution = readExecutionBindings(ctx);
+    const selected = execution?.hostTarget;
+    if (!execution || selected?.kind !== 'host')
+        return { dispatched: false };
+    // Fleet stamps this only after authenticating and selecting the exact host.
+    if (ctx.metadata?.executionHostId === selected.hostId)
+        return { dispatched: false };
+    const fleet = await runtime
+        .query('runtime/client')
+        .withId('fleet')
+        .resolve();
+    return {
+        dispatched: true,
+        result: await fleet.invokeBoundTool(selected.hostId, toolId, input, ctx)
+    };
+}
+//# sourceMappingURL=execution-host.js.map

package/dist/agents/execution-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-host.js","sourceRoot":"","sources":["../../src/agents/execution-host.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAYhE,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,OAAqB,EACrB,GAAoB,EACpB,MAA6B,EAC7B,KAAY;IAEZ,MAAM,SAAS,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,SAAS,EAAE,UAAU,CAAC;IACvC,IAAI,CAAC,SAAS,IAAI,QAAQ,EAAE,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC1E,4EAA4E;IAC5E,IAAI,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,QAAQ,CAAC,MAAM;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,MAAM,OAAO;SACzB,KAAK,CAAyB,gBAAgB,CAAC;SAC/C,MAAM,CAAC,OAAO,CAAC;SACf,OAAO,EAAE,CAAC;IACZ,OAAO;QACN,UAAU,EAAE,IAAI;QAChB,MAAM,EAAE,MAAM,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC;KACxE,CAAC;AACH,CAAC"}

package/dist/agents/interfaces/agent.d.ts

@@ -0,0 +1,7 @@
+/**
+ * AI Agent Interface
+ *
+ * Re-export of agent interface definitions.
+ */
+export type { AIAgentContext, AIAgentInterface, AIAgentConstructor } from './schemas/index.ts';
+//# sourceMappingURL=agent.d.ts.map

package/dist/agents/interfaces/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/agents/interfaces/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,MAAM,oBAAoB,CAAC"}

package/dist/agents/interfaces/agent.js

@@ -0,0 +1,7 @@
+/**
+ * AI Agent Interface
+ *
+ * Re-export of agent interface definitions.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/agents/interfaces/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/agents/interfaces/agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agents/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Agent Interfaces
+ *
+ * Exports agent interface definitions.
+ */
+export type { AIAgentContext, AIAgentInterface, AIAgentConstructor } from './agent.ts';
+export type { AIAgentLoopContext, AIAgentLoopInterface, AIAgentLoopConstructor } from './loop.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvF,YAAY,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC"}

package/dist/agents/interfaces/index.js

@@ -0,0 +1,7 @@
+/**
+ * AI Agent Interfaces
+ *
+ * Exports agent interface definitions.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/agents/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agents/interfaces/loop.d.ts

@@ -0,0 +1,2 @@
+export type { AIAgentLoopConstructor, AIAgentLoopContext, AIAgentLoopInterface } from '../schemas/loop-runtime.ts';
+//# sourceMappingURL=loop.d.ts.map

package/dist/agents/interfaces/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/agents/interfaces/loop.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,4BAA4B,CAAC"}

package/dist/agents/interfaces/loop.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=loop.js.map

package/dist/agents/interfaces/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../../src/agents/interfaces/loop.ts"],"names":[],"mappings":""}

package/dist/agents/interfaces/schemas/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Agent Interface Schemas
+ *
+ * Core type definitions for agent interfaces.
+ */
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolProvider } from '../../contracts/tool-provider.ts';
+import type { ToolApprovalRuntime } from '../../contracts/approval-types.ts';
+import type { GenerationRequest, GenerationResponse, StreamEvent, GenerationExecutionOptions, ToolConfiguration } from '@vibesdotdev/ai-schemas/generation/contracts';
+import type { AIAgentInstanceDescriptor, AIAgentLoopDescriptor } from '../../schemas/index.ts';
+/**
+ * Context provided to agent implementations
+ */
+export interface AIAgentContext extends KindContext {
+    /** Workspace path for tool execution */
+    workspacePath?: string;
+    /** Tool provider for tool resolution and execution */
+    toolProvider?: ToolProvider;
+    /** Tool approval runtime for interactive approval flows */
+    approvalRuntime?: ToolApprovalRuntime;
+    /** Per-tool configuration overrides (from UI) */
+    toolConfigurations?: ToolConfiguration[];
+}
+/**
+ * AI Agent Interface
+ *
+ * Agents are instantiated with a descriptor and context.
+ */
+export interface AIAgentInterface {
+    /** The agent descriptor */
+    readonly descriptor: AIAgentInstanceDescriptor;
+    /**
+     * Execute generation with agent loop (non-streaming)
+     */
+    execute(request: GenerationRequest, options?: GenerationExecutionOptions): Promise<GenerationResponse>;
+    /**
+     * Execute generation with agent loop (streaming)
+     */
+    stream(request: GenerationRequest, options?: GenerationExecutionOptions): AsyncGenerator<StreamEvent, GenerationResponse>;
+    /**
+     * Check if this agent can handle the request
+     */
+    canHandle(request: GenerationRequest): boolean;
+    /**
+     * Cleanup resources
+     */
+    dispose?(): Promise<void>;
+}
+/**
+ * Agent constructor type for runtime instantiation
+ */
+export type AIAgentConstructor = new (descriptor: AIAgentInstanceDescriptor, context: AIAgentContext) => AIAgentInterface;
+export interface AIAgentLoopContext extends AIAgentContext {
+    readonly runtime: VibesRuntime;
+}
+export interface AIAgentLoopInterface {
+    readonly descriptor: AIAgentLoopDescriptor;
+    canHandle(instance: AIAgentInstanceDescriptor): boolean;
+    execute(instance: AIAgentInstanceDescriptor, request: GenerationRequest, options?: GenerationExecutionOptions, callContext?: Partial<AIAgentLoopContext>): Promise<GenerationResponse>;
+    stream(instance: AIAgentInstanceDescriptor, request: GenerationRequest, options?: GenerationExecutionOptions, callContext?: Partial<AIAgentLoopContext>): AsyncGenerator<StreamEvent, GenerationResponse>;
+    dispose?(): Promise<void>;
+}
+export type AIAgentLoopConstructor = new (descriptor: AIAgentInstanceDescriptor, context: AIAgentLoopContext) => AIAgentLoopInterface;
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/interfaces/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/interfaces/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,KAAK,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,0BAA0B,EAC1B,iBAAiB,EACjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EACX,yBAAyB,EACzB,qBAAqB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAE/C;;OAEG;IACH,OAAO,CACN,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,0BAA0B,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;OAEG;IACH,MAAM,CACL,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,0BAA0B,GAClC,cAAc,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IAEnD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAE/C;;OAEG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAChC,UAAU,EAAE,yBAAyB,EACrC,OAAO,EAAE,cAAc,KACnB,gBAAgB,CAAC;AAEtB,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACzD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACxD,OAAO,CACN,QAAQ,EAAE,yBAAyB,EACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,0BAA0B,EACpC,WAAW,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACvC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/B,MAAM,CACL,QAAQ,EAAE,yBAAyB,EACnC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE,0BAA0B,EACpC,WAAW,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACvC,cAAc,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,MAAM,sBAAsB,GAAG,KACpC,UAAU,EAAE,yBAAyB,EACrC,OAAO,EAAE,kBAAkB,KACvB,oBAAoB,CAAC"}

package/dist/agents/interfaces/schemas/index.js

@@ -0,0 +1,7 @@
+/**
+ * Agent Interface Schemas
+ *
+ * Core type definitions for agent interfaces.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/agents/interfaces/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/interfaces/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agents/interfaces.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AI Agent Interfaces
+ *
+ * Re-export of core contracts from schemas.
+ */
+export type { AIAgentLoopContext, AIAgentLoopInterface, AIAgentLoopConstructor } from './interfaces/schemas/index.ts';
+export type { AIAgentInterface } from './interfaces/agent.ts';
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/agents/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/agents/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACX,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agents/interfaces.js

@@ -0,0 +1,7 @@
+/**
+ * AI Agent Interfaces
+ *
+ * Re-export of core contracts from schemas.
+ */
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/agents/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/agents/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/agents/native-tool-definitions.d.ts

@@ -0,0 +1,67 @@
+import { type ValueFreeFailure, type VibesRuntime } from '@vibesdotdev/kernel';
+import { type JsonObject } from '@vibesdotdev/kernel/schemas/json';
+import type { GenerationExecutionOptions, GenerationRequest } from '@vibesdotdev/ai-schemas/generation/contracts';
+import type { ToolDefinition } from '@vibesdotdev/ai-schemas/generation/references';
+import type { ToolAssetDescriptor } from '../schemas/runtime/descriptors.ts';
+/** A provider-native tool definition: the vendor-neutral `ToolDefinition` of `@vibesdotdev/ai-schemas`. */
+export type NativeToolDefinition = ToolDefinition;
+/**
+ * Result of resolving `toolIds` against the live `tools/tool` registry.
+ *
+ * `missingToolIds` is a constitution-rule-13 contract: declared tools that fail
+ * to resolve must not vanish silently. Callers must make a non-empty list
+ * impossible for the agent/developer to miss.
+ */
+export type NativeToolHydrationResult = {
+    tools: NativeToolDefinition[];
+    resolvedToolIds: string[];
+    missingToolIds: string[];
+    /** True when the tools/tool kind query itself failed (registry injury). */
+    registryUnavailable: boolean;
+    /** Why the registry query failed, as value-free facts, when it did. */
+    registryFailure?: ValueFreeFailure;
+};
+/** Marker on a Zod field the host binds. Agent-facing JSON Schema must omit it. */
+export declare const CONTEXT_BOUND_INPUT_DESCRIPTION = "Bound by the execution context. Omit this; the host supplies it.";
+/**
+ * Drop context-bound fields (and their required entries) from a projected JSON
+ * Schema. A document that is not JSON is returned as an open object schema.
+ */
+export declare function omitContextBoundInputs<Schema extends object>(schema: Schema): JsonObject;
+/**
+ * The agent-facing JSON Schema of a tool's input: context-bound fields dropped,
+ * and an object schema whatever the source shape (a union of object variants is
+ * merged into one object). Null when the document is not an object schema.
+ */
+export declare function normalizeNativeToolInputSchema<Schema extends object>(schema: Schema): JsonObject | null;
+export declare function toolDescriptorToDefinition(descriptor: ToolAssetDescriptor): NativeToolDefinition;
+/**
+ * Degraded-surface notice (constitution rule 13) for generation hydration.
+ * Mirrors the agent-loop notice so models report missing limbs instead of
+ * inventing workarounds.
+ */
+export declare function degradedToolHydrationNotice(missingToolIds: string[]): string;
+/**
+ * Resolve `toolIds` against the live `tools/tool` registry into provider-native
+ * tool definitions. Always reports `missingToolIds` (never silent partials).
+ */
+export declare function resolveNativeToolDefinitions(runtime: VibesRuntime, toolIds: readonly string[]): NativeToolHydrationResult;
+export declare function readToolHydrationMeta(request: GenerationRequest): NativeToolHydrationResult | undefined;
+/**
+ * Merge hydration result into generation options metadata. Keys match what
+ * `text-generation.job.impl` already reads for progress telemetry.
+ */
+export declare function withToolHydrationMetadata(options: Pick<GenerationExecutionOptions, 'metadata'> | undefined, hydration: NativeToolHydrationResult | undefined): Pick<GenerationExecutionOptions, 'metadata'> | undefined;
+/**
+ * Hydrate a generation request's `toolIds` into provider-native `tools[]`.
+ *
+ * Constitution rule 13: when any declared tool fails to resolve, log a warn
+ * and inject a degraded-toolset notice into the request messages so the model
+ * cannot miss the breakage. Partial resolution still ships the tools that
+ * resolved — the missing set is never silent.
+ *
+ * Callers should also merge `readToolHydrationMeta(request)` into execution
+ * options via `withToolHydrationMetadata` so job telemetry sees missing tools.
+ */
+export declare function hydrateGenerationRequestTools(runtime: VibesRuntime, request: GenerationRequest): GenerationRequest;
+//# sourceMappingURL=native-tool-definitions.d.ts.map

package/dist/agents/native-tool-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-tool-definitions.d.ts","sourceRoot":"","sources":["../../src/agents/native-tool-definitions.ts"],"names":[],"mappings":"AACA,OAAO,EAAyC,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtH,OAAO,EAAkC,KAAK,UAAU,EAAkB,MAAM,kCAAkC,CAAC;AAOnH,OAAO,KAAK,EAEX,0BAA0B,EAC1B,iBAAiB,EAEjB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,2GAA2G;AAC3G,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACvC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2EAA2E;IAC3E,mBAAmB,EAAE,OAAO,CAAC;IAC7B,uEAAuE;IACvE,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC,CAAC;AAKF,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,qEACuB,CAAC;AAsBpE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAGxF;AAqFD;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAWvG;AA0HD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,GAAG,oBAAoB,CAEhG;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ5E;AAiCD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,SAAS,MAAM,EAAE,GACxB,yBAAyB,CAwC3B;AAUD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,yBAAyB,GAAG,SAAS,CAEvG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,SAAS,EACjE,SAAS,EAAE,yBAAyB,GAAG,SAAS,GAC9C,IAAI,CAAC,0BAA0B,EAAE,UAAU,CAAC,GAAG,SAAS,CAe1D;AAOD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CA2BlH"}