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

package/dist/api/schemas/validation.js.map

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

package/dist/api/tools/examples.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Example API Tools
+ *
+ * Demonstrates how to create tools from API endpoints using the wrapper.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolManifest } from '@vibesdotdev/tools/manifest/types';
+/**
+ * Example 1: Weather API tool using fluent builder
+ */
+export declare const exampleWeatherTool: (runtime: VibesRuntime) => ToolManifest;
+/**
+ * Example 2: GitHub API tool using quick wrapper
+ */
+export declare const exampleGithubRepoTool: (runtime: VibesRuntime) => ToolManifest;
+/**
+ * Example 3: JSON placeholder API (working example for testing)
+ */
+export declare const exampleCreatePostTool: (runtime: VibesRuntime) => ToolManifest;
+/**
+ * Example 4: Internal Vibes API tool
+ * (This would work once the app is running)
+ */
+export declare const exampleVibesKnowledgeSearchTool: (runtime: VibesRuntime) => ToolManifest;
+//# sourceMappingURL=examples.d.ts.map

package/dist/api/tools/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../src/api/tools/examples.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,YAAY,KAAG,YA4B3C,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,YAAY,KAAG,YAiB7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,SAAS,YAAY,KAAG,YAkB7D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAAI,SAAS,YAAY,KAAG,YAuBxD,CAAC"}

package/dist/api/tools/examples.js

@@ -0,0 +1,91 @@
+/**
+ * Example API Tools
+ *
+ * Demonstrates how to create tools from API endpoints using the wrapper.
+ */
+import * as z from 'zod/v4';
+import { apiTool, wrapGET, wrapPOST } from "./wrapper.js";
+/**
+ * Example 1: Weather API tool using fluent builder
+ */
+export const exampleWeatherTool = (runtime) => apiTool()
+    .id('example_weather')
+    .description('Get current weather (example/mock)')
+    .get('https://api.weatherapi.com/v1/current.json')
+    .query(z.object({
+    q: z.string().describe('Location (city name, lat/lon, IP, etc)'),
+    key: z.string().describe('API key')
+}))
+    .response(z.object({
+    location: z.object({
+        name: z.string(),
+        region: z.string(),
+        country: z.string()
+    }),
+    current: z.object({
+        temp_c: z.number(),
+        temp_f: z.number(),
+        condition: z.object({
+            text: z.string()
+        }),
+        humidity: z.number()
+    })
+}))
+    .environments({ server: true, cli: true, worker: true, browser: false })
+    .build(runtime);
+/**
+ * Example 2: GitHub API tool using quick wrapper
+ */
+export const exampleGithubRepoTool = (runtime) => wrapGET(runtime, 'example_github_repo', 'https://api.github.com/repos/{owner}/{repo}', {
+    description: 'Get GitHub repository information (example)',
+    response: z.object({
+        id: z.number(),
+        name: z.string(),
+        full_name: z.string(),
+        description: z.string().nullable(),
+        stargazers_count: z.number(),
+        forks_count: z.number(),
+        language: z.string().nullable(),
+        html_url: z.string()
+    })
+});
+/**
+ * Example 3: JSON placeholder API (working example for testing)
+ */
+export const exampleCreatePostTool = (runtime) => wrapPOST(runtime, 'example_create_post', 'https://jsonplaceholder.typicode.com/posts', {
+    description: 'Create a post (JSONPlaceholder API - working example)',
+    body: z.object({
+        title: z.string(),
+        body: z.string(),
+        userId: z.number().default(1)
+    }),
+    response: z.object({
+        id: z.number(),
+        title: z.string(),
+        body: z.string(),
+        userId: z.number()
+    })
+});
+/**
+ * Example 4: Internal Vibes API tool
+ * (This would work once the app is running)
+ */
+export const exampleVibesKnowledgeSearchTool = (runtime) => apiTool()
+    .id('example_vibes_knowledge_search')
+    .description('Search Vibes knowledge base (example - requires running server)')
+    .post('/api/knowledge/documents/search')
+    .body(z.object({
+    query: z.string(),
+    limit: z.number().default(10)
+}))
+    .response(z.object({
+    results: z.array(z.object({
+        id: z.string(),
+        title: z.string(),
+        content: z.string(),
+        score: z.number()
+    }))
+}))
+    .requiresAuth()
+    .build(runtime);
+//# sourceMappingURL=examples.js.map

package/dist/api/tools/examples.js.map

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

package/dist/api/tools/generator.d.ts

@@ -0,0 +1,34 @@
+/**
+ * API Tools Generator
+ *
+ * Automatically generates tool manifests from OpenAPI registry entries.
+ * Supports both automatic generation from registry and manual wrapping of APIs.
+ *
+ * A generated tool calls its endpoint through the handed runtime's `api/client`,
+ * so the runtime is bound when the manifest is built: the manifest handler
+ * receives only the call's metadata and input.
+ */
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolManifest } from '@vibesdotdev/tools/manifest/types';
+import type { APIToolConfig, RouteConfig } from './schemas/generator.ts';
+export type { APIToolConfig, GeneratorOptions } from './schemas/generator.ts';
+/** An OpenAPI document's paths; each path item is read one operation at a time. */
+declare const OpenApiDocumentSchema: z.ZodObject<{
+    paths: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{}, z.core.$loose>>>;
+}, z.core.$strip>;
+interface OpenAPIRegistryReader {
+    getRegisteredRoutes(): Array<{
+        method: string;
+        path: string;
+    }>;
+    generateSpec(): z.input<typeof OpenApiDocumentSchema>;
+}
+export declare function generateManifestFromAPI(runtime: VibesRuntime, config: APIToolConfig): ToolManifest;
+export declare function generateManifestFromRouteConfig(runtime: VibesRuntime, method: string, path: string, config: RouteConfig): ToolManifest;
+export declare function generateManifestsFromRegistry(runtime: VibesRuntime, registry: OpenAPIRegistryReader, options: {
+    tags?: string[];
+    pathPattern?: RegExp;
+    includeAuth?: boolean;
+}): Promise<ToolManifest[]>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/api/tools/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../src/api/tools/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAOtE,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA+B9E,mFAAmF;AACnF,QAAA,MAAM,qBAAqB;;iBAEzB,CAAC;AAEH,UAAU,qBAAqB;IAC9B,mBAAmB,IAAI,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,YAAY,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;CACtD;AAkDD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,GAAG,YAAY,CAsBlG;AAED,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GACjB,YAAY,CAWd;AAED,wBAAsB,6BAA6B,CAClD,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,GACC,OAAO,CAAC,YAAY,EAAE,CAAC,CAiDzB"}

package/dist/api/tools/generator.js

@@ -0,0 +1,163 @@
+/**
+ * API Tools Generator
+ *
+ * Automatically generates tool manifests from OpenAPI registry entries.
+ * Supports both automatic generation from registry and manual wrapping of APIs.
+ *
+ * A generated tool calls its endpoint through the handed runtime's `api/client`,
+ * so the runtime is bound when the manifest is built: the manifest handler
+ * receives only the call's metadata and input.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import { createToolManifest } from '@vibesdotdev/tools/manifest/factory';
+import { ToolJsonValueSchema } from "../../kinds/schemas/tool.js";
+const ApiToolMethodSchema = z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE']);
+/** Methods whose request carries the tool input's body. */
+const BODY_METHODS = new Set(['POST', 'PUT', 'PATCH']);
+/** The query values the `api/client` transport accepts. */
+const ApiQueryValueSchema = z.union([z.string(), z.number(), z.boolean(), z.array(z.string())]);
+/** The part of a generated tool's input the request reads; absent input calls with no body or query. */
+const ApiToolInputSchema = z
+    .object({
+    body: JsonValueSchema.optional(),
+    query: z.record(z.string(), ApiQueryValueSchema).optional()
+})
+    .optional();
+/** The OpenAPI operation fields the generator reads. */
+const OpenApiOperationSchema = z.object({
+    tags: z.array(z.string()).optional(),
+    summary: z.string().optional(),
+    description: z.string().optional(),
+    operationId: z.string().optional(),
+    security: z.array(z.record(z.string(), z.array(z.string()))).optional()
+});
+/** An OpenAPI document's paths; each path item is read one operation at a time. */
+const OpenApiDocumentSchema = z.object({
+    paths: z.record(z.string(), z.looseObject({})).optional()
+});
+function toMethod(method) {
+    const parsed = ApiToolMethodSchema.safeParse(method.toUpperCase());
+    if (!parsed.success) {
+        throw new CapabilityError(`Unsupported HTTP method: ${method}`, 'INVALID_INPUT', {
+            reason: 'api-tool-method-unsupported',
+            retryable: false,
+            details: { method }
+        });
+    }
+    return parsed.data;
+}
+function generateToolId(method, path) {
+    const cleanPath = path.replace(/^\/api\//, '').replace(/\//g, '_');
+    return `api_${method.toLowerCase()}_${cleanPath}`;
+}
+/** The tool's declared input: the body and query the endpoint takes, or open params when it declares neither. */
+function apiToolInputSchema(config) {
+    if (!config.bodySchema && !config.querySchema)
+        return z.object({ params: JsonValueSchema.optional() });
+    let schema = z.object({});
+    if (config.bodySchema)
+        schema = schema.extend({ body: config.bodySchema.optional() });
+    if (config.querySchema)
+        schema = schema.extend({ query: config.querySchema.optional() });
+    return schema;
+}
+function createAPIHandler(runtime, config) {
+    return async (_context, rawInput) => {
+        const parsed = ApiToolInputSchema.safeParse(rawInput);
+        if (!parsed.success) {
+            throw new CapabilityError(`Tool input for ${config.method} ${config.path} is not a request body and query.`, 'INVALID_INPUT', {
+                reason: 'api-tool-input-invalid',
+                retryable: false,
+                details: { method: config.method, path: config.path }
+            });
+        }
+        const input = parsed.data ?? {};
+        const apiClient = await runtime.query('api/client').resolve();
+        const request = { method: config.method };
+        if (input.query)
+            request.query = input.query;
+        if (BODY_METHODS.has(config.method) && input.body !== undefined)
+            request.body = input.body;
+        if (config.headers)
+            request.headers = config.headers;
+        return ToolJsonValueSchema.optional().parse(await apiClient.request(config.path, request));
+    };
+}
+export function generateManifestFromAPI(runtime, config) {
+    const toolId = config.id || generateToolId(config.method, config.path);
+    return createToolManifest({
+        id: toolId,
+        name: toolId,
+        description: config.description || `Call ${config.method} ${config.path}`,
+        category: 'api',
+        subcategory: 'generated',
+        hardware: ['consumer', 'cloud'],
+        purpose: ['direct', 'worker', 'mcp', 'agent'],
+        requiresApproval: config.requiresAuth ?? false,
+        tags: ['api', 'generated', config.method.toLowerCase()],
+        safety: config.method === 'GET' ? 'read' : 'write',
+        schemas: {
+            input: apiToolInputSchema(config),
+            output: config.responseSchema ?? JsonValueSchema
+        }
+    }, () => Promise.resolve(createAPIHandler(runtime, config)));
+}
+export function generateManifestFromRouteConfig(runtime, method, path, config) {
+    return generateManifestFromAPI(runtime, {
+        id: config.metadata?.operationId,
+        method: toMethod(method),
+        path,
+        description: config.metadata?.description || config.metadata?.summary,
+        bodySchema: config.validation?.body,
+        querySchema: config.validation?.query,
+        responseSchema: config.responses?.['200']?.schema,
+        requiresAuth: config.auth?.required !== false
+    });
+}
+export async function generateManifestsFromRegistry(runtime, registry, options) {
+    const manifests = [];
+    const routes = registry.getRegisteredRoutes();
+    const spec = OpenApiDocumentSchema.parse(registry.generateSpec());
+    const requiredTags = options.tags;
+    for (const route of routes) {
+        if (options.pathPattern && !options.pathPattern.test(route.path)) {
+            continue;
+        }
+        const pathItem = spec.paths?.[route.path];
+        if (!pathItem)
+            continue;
+        const rawOperation = pathItem[route.method.toLowerCase()];
+        if (rawOperation === undefined)
+            continue;
+        const parsedOperation = OpenApiOperationSchema.safeParse(rawOperation);
+        if (!parsedOperation.success) {
+            throw new CapabilityError(`The OpenAPI operation ${route.method} ${route.path} is malformed.`, 'INVALID_INPUT', {
+                reason: 'openapi-operation-invalid',
+                retryable: false,
+                details: { method: route.method, path: route.path }
+            });
+        }
+        const operation = parsedOperation.data;
+        if (requiredTags && !operation.tags?.some((tag) => requiredTags.includes(tag))) {
+            continue;
+        }
+        if (!options.includeAuth && operation.security && operation.security.length > 0) {
+            continue;
+        }
+        const routeConfig = {
+            metadata: {
+                summary: operation.summary,
+                description: operation.description,
+                tags: operation.tags,
+                operationId: operation.operationId
+            },
+            // An operation without its own `security` inherits the document's, so it stays auth-required.
+            auth: { required: operation.security === undefined ? undefined : operation.security.length > 0 }
+        };
+        manifests.push(generateManifestFromRouteConfig(runtime, route.method, route.path, routeConfig));
+    }
+    return manifests;
+}
+//# sourceMappingURL=generator.js.map

package/dist/api/tools/generator.js.map

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

package/dist/api/tools/schemas/generator.d.ts

@@ -0,0 +1,48 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type z from 'zod/v4';
+export interface APIToolConfig {
+    id?: string;
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    path: string;
+    description?: string;
+    requestSchema?: unknown;
+    bodySchema?: z.ZodType<unknown>;
+    querySchema?: z.ZodType<unknown>;
+    responseSchema?: z.ZodType<unknown>;
+    headers?: Record<string, string>;
+    requiresAuth?: boolean;
+    baseUrl?: string;
+    environments?: {
+        server?: boolean;
+        cli?: boolean;
+        worker?: boolean;
+        browser?: boolean;
+    };
+    tags?: string[];
+}
+/** Local mirror of the kit RouteConfig shape to avoid a kit production dependency */
+export interface RouteConfig {
+    metadata?: {
+        summary?: string;
+        description?: string;
+        tags?: string[];
+        operationId?: string;
+    };
+    validation?: {
+        query?: z.ZodType<unknown>;
+        body?: z.ZodType<unknown>;
+    };
+    responses?: {
+        '200'?: {
+            schema?: z.ZodType<unknown>;
+        };
+    };
+    auth?: {
+        required?: boolean;
+    };
+}
+export interface GeneratorOptions {
+    runtime?: VibesRuntime;
+    routes?: RouteConfig[];
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/api/tools/schemas/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/api/tools/schemas/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,UAAU,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE;QACX,KAAK,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SAC5B,CAAC;KACF,CAAC;IACF,IAAI,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACF;AAED,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACvB"}

package/dist/api/tools/schemas/generator.js

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

package/dist/api/tools/schemas/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/api/tools/schemas/generator.ts"],"names":[],"mappings":""}

package/dist/api/tools/schemas/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * API Tools Generator Schemas
+ */
+export interface ToolGeneratorConfig {
+    outputDir: string;
+    template?: string;
+}
+export interface APIToolConfig {
+    name: string;
+    endpoint: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/api/tools/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/tools/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC1C"}

package/dist/api/tools/schemas/index.js

@@ -0,0 +1,5 @@
+/**
+ * API Tools Generator Schemas
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/api/tools/schemas/index.js.map

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

package/dist/api/tools/wrapper.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Manual API Tool Wrapper
+ *
+ * Provides a fluent interface for manually wrapping APIs as tool manifests.
+ * Useful when you want more control than automatic generation provides.
+ */
+import type * as z from 'zod/v4';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ToolManifest } from '@vibesdotdev/tools/manifest/types';
+/**
+ * Fluent builder for creating API-based tools
+ *
+ * @example
+ * ```typescript
+ * const weatherTool = apiTool()
+ *   .id('get_weather')
+ *   .description('Get current weather for a location')
+ *   .get('/api/weather')
+ *   .query(z.object({
+ *     location: z.string(),
+ *     units: z.enum(['celsius', 'fahrenheit']).default('celsius')
+ *   }))
+ *   .response(z.object({
+ *     temperature: z.number(),
+ *     condition: z.string(),
+ *     humidity: z.number()
+ *   }))
+ *   .build(runtime);
+ * ```
+ */
+export declare class APIToolBuilder {
+    private config;
+    /**
+     * Set tool ID
+     */
+    id(id: string): this;
+    /**
+     * Set tool description
+     */
+    description(description: string): this;
+    /**
+     * Set HTTP GET method
+     */
+    get(path: string): this;
+    /**
+     * Set HTTP POST method
+     */
+    post(path: string): this;
+    /**
+     * Set HTTP PUT method
+     */
+    put(path: string): this;
+    /**
+     * Set HTTP PATCH method
+     */
+    patch(path: string): this;
+    /**
+     * Set HTTP DELETE method
+     */
+    delete(path: string): this;
+    /**
+     * Set request body schema
+     */
+    body(schema: z.ZodType): this;
+    /**
+     * Set query parameters schema
+     */
+    query(schema: z.ZodType): this;
+    /**
+     * Set response schema
+     */
+    response(schema: z.ZodType): this;
+    /**
+     * Mark as requiring authentication
+     */
+    requiresAuth(required?: boolean): this;
+    /**
+     * Set base URL for API calls
+     */
+    baseUrl(url: string): this;
+    /**
+     * Add custom headers
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Add a single header
+     */
+    header(key: string, value: string): this;
+    /**
+     * Set tool environments
+     */
+    environments(envs: {
+        server?: boolean;
+        cli?: boolean;
+        worker?: boolean;
+        browser?: boolean;
+    }): this;
+    /**
+     * Enable for CLI environment
+     */
+    cli(): this;
+    /**
+     * Enable for browser environment
+     */
+    browser(): this;
+    /**
+     * Enable for worker environment
+     */
+    worker(): this;
+    /**
+     * Build the tool manifest; its calls go through the handed runtime's `api/client`.
+     */
+    build(runtime: VibesRuntime): ToolManifest;
+}
+/**
+ * Create a new API tool builder
+ *
+ * @example
+ * ```typescript
+ * const tool = apiTool()
+ *   .id('create_todo')
+ *   .description('Create a new todo item')
+ *   .post('/api/todos')
+ *   .body(z.object({
+ *     title: z.string(),
+ *     completed: z.boolean().default(false)
+ *   }))
+ *   .response(z.object({
+ *     id: z.string(),
+ *     title: z.string(),
+ *     completed: z.boolean()
+ *   }))
+ *   .build(runtime);
+ * ```
+ */
+export declare function apiTool(): APIToolBuilder;
+/**
+ * Quick helper to wrap a GET endpoint
+ */
+export declare function wrapGET(runtime: VibesRuntime, id: string, path: string, options?: {
+    description?: string;
+    query?: z.ZodType;
+    response?: z.ZodType;
+    requiresAuth?: boolean;
+}): ToolManifest;
+/**
+ * Quick helper to wrap a POST endpoint
+ */
+export declare function wrapPOST(runtime: VibesRuntime, id: string, path: string, options?: {
+    description?: string;
+    body?: z.ZodType;
+    response?: z.ZodType;
+    requiresAuth?: boolean;
+}): ToolManifest;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/api/tools/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../../src/api/tools/wrapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IAC1B,OAAO,CAAC,MAAM,CAOZ;IAEF;;OAEG;IACH,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKpB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMxB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMvB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM1B;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI;IAK7B;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI;IAK9B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI;IAKjC;;OAEG;IACH,YAAY,CAAC,QAAQ,UAAO,GAAG,IAAI;IAKnC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE;QAClB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,GAAG,CAAC,EAAE,OAAO,CAAC;QACd,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KAClB,GAAG,IAAI;IAKR;;OAEG;IACH,GAAG,IAAI,IAAI;IAOX;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;IACH,MAAM,IAAI,IAAI;IAOd;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY;CAa1C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,IAAI,cAAc,CAExC;AAED;;GAEG;AACH,wBAAgB,OAAO,CACtB,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,GACC,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACvB,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB,GACC,YAAY,CASd"}