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

package/dist/api/tools/wrapper.js

@@ -0,0 +1,248 @@
+/**
+ * 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 { generateManifestFromAPI } from "./generator.js";
+/**
+ * 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 class APIToolBuilder {
+    config = {
+        environments: {
+            server: true,
+            cli: false,
+            worker: false,
+            browser: false
+        }
+    };
+    /**
+     * Set tool ID
+     */
+    id(id) {
+        this.config.id = id;
+        return this;
+    }
+    /**
+     * Set tool description
+     */
+    description(description) {
+        this.config.description = description;
+        return this;
+    }
+    /**
+     * Set HTTP GET method
+     */
+    get(path) {
+        this.config.method = 'GET';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Set HTTP POST method
+     */
+    post(path) {
+        this.config.method = 'POST';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Set HTTP PUT method
+     */
+    put(path) {
+        this.config.method = 'PUT';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Set HTTP PATCH method
+     */
+    patch(path) {
+        this.config.method = 'PATCH';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Set HTTP DELETE method
+     */
+    delete(path) {
+        this.config.method = 'DELETE';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Set request body schema
+     */
+    body(schema) {
+        this.config.bodySchema = schema;
+        return this;
+    }
+    /**
+     * Set query parameters schema
+     */
+    query(schema) {
+        this.config.querySchema = schema;
+        return this;
+    }
+    /**
+     * Set response schema
+     */
+    response(schema) {
+        this.config.responseSchema = schema;
+        return this;
+    }
+    /**
+     * Mark as requiring authentication
+     */
+    requiresAuth(required = true) {
+        this.config.requiresAuth = required;
+        return this;
+    }
+    /**
+     * Set base URL for API calls
+     */
+    baseUrl(url) {
+        this.config.baseUrl = url;
+        return this;
+    }
+    /**
+     * Add custom headers
+     */
+    headers(headers) {
+        this.config.headers = { ...this.config.headers, ...headers };
+        return this;
+    }
+    /**
+     * Add a single header
+     */
+    header(key, value) {
+        if (!this.config.headers) {
+            this.config.headers = {};
+        }
+        this.config.headers[key] = value;
+        return this;
+    }
+    /**
+     * Set tool environments
+     */
+    environments(envs) {
+        this.config.environments = { ...this.config.environments, ...envs };
+        return this;
+    }
+    /**
+     * Enable for CLI environment
+     */
+    cli() {
+        if (this.config.environments) {
+            this.config.environments.cli = true;
+        }
+        return this;
+    }
+    /**
+     * Enable for browser environment
+     */
+    browser() {
+        if (this.config.environments) {
+            this.config.environments.browser = true;
+        }
+        return this;
+    }
+    /**
+     * Enable for worker environment
+     */
+    worker() {
+        if (this.config.environments) {
+            this.config.environments.worker = true;
+        }
+        return this;
+    }
+    /**
+     * Build the tool manifest; its calls go through the handed runtime's `api/client`.
+     */
+    build(runtime) {
+        // Validate required fields
+        const { method, path } = this.config;
+        if (!method) {
+            throw new Error('HTTP method is required. Use get(), post(), put(), patch(), or delete()');
+        }
+        if (!path) {
+            throw new Error('API path is required');
+        }
+        const config = { ...this.config, method, path };
+        return generateManifestFromAPI(runtime, config);
+    }
+}
+/**
+ * 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 function apiTool() {
+    return new APIToolBuilder();
+}
+/**
+ * Quick helper to wrap a GET endpoint
+ */
+export function wrapGET(runtime, id, path, options) {
+    const builder = apiTool().id(id).get(path);
+    if (options?.description)
+        builder.description(options.description);
+    if (options?.query)
+        builder.query(options.query);
+    if (options?.response)
+        builder.response(options.response);
+    if (options?.requiresAuth)
+        builder.requiresAuth();
+    return builder.build(runtime);
+}
+/**
+ * Quick helper to wrap a POST endpoint
+ */
+export function wrapPOST(runtime, id, path, options) {
+    const builder = apiTool().id(id).post(path);
+    if (options?.description)
+        builder.description(options.description);
+    if (options?.body)
+        builder.body(options.body);
+    if (options?.response)
+        builder.response(options.response);
+    if (options?.requiresAuth)
+        builder.requiresAuth();
+    return builder.build(runtime);
+}
+//# sourceMappingURL=wrapper.js.map

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

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

package/dist/app/dashboard.d.ts

@@ -0,0 +1,28 @@
+export declare function createBuilderCards(input: {
+    systemTools: number;
+    customTools: number;
+    agents: number;
+    prompts: number;
+    components: number;
+    benchmarks: number;
+}): {
+    title: string;
+    description: string;
+    href: string;
+    cta: string;
+    stat: string;
+    secondary: string;
+}[];
+export declare function createIntegrationPoints(input: {
+    enabledRuntimeTools: number;
+    adapters: number;
+    providers: number;
+    components: number;
+    remoteRegistries: number;
+}): {
+    name: string;
+    href: string;
+    detail: string;
+    status: string;
+}[];
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/app/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../src/app/dashboard.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB;;;;;;;IA2CA;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC9C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CACzB;;;;;IAgDA"}

package/dist/app/dashboard.js

@@ -0,0 +1,93 @@
+export function createBuilderCards(input) {
+    return [
+        {
+            title: 'Custom Tools',
+            description: 'Author runtime-callable tools with TypeScript, JSON schemas, and test flows.',
+            href: '/tools/create',
+            cta: 'Create Tool',
+            stat: `${input.customTools} custom`,
+            secondary: `${input.systemTools} runtime tools available`
+        },
+        {
+            title: 'Custom Agents',
+            description: 'Compose prompts, tool bindings, and loop strategy into reusable agents.',
+            href: '/agents/create',
+            cta: 'Create Agent',
+            stat: `${input.agents} authored`,
+            secondary: 'Runs now resolve through the tools-owned runtime path'
+        },
+        {
+            title: 'Prompt Library',
+            description: 'Iterate on prompt assets, compare versions, and test them against models.',
+            href: '/prompts/create',
+            cta: 'Create Prompt',
+            stat: `${input.prompts} prompts`,
+            secondary: 'Testing, compare, analytics, and export are live'
+        },
+        {
+            title: 'Custom Components',
+            description: 'Author Svelte components, publish them to platform, and reuse them across apps.',
+            href: '/components',
+            cta: 'Open Components',
+            stat: `${input.components} components`,
+            secondary: 'Backed by platform component publishing and runtime widget artifacts'
+        },
+        {
+            title: 'Benchmarks',
+            description: 'Define datasets and scenarios, then evaluate agents and tools over time.',
+            href: '/benchmarks',
+            cta: 'Open Benchmarks',
+            stat: `${input.benchmarks} benchmarks`,
+            secondary: 'Schedules, streaming progress, and webhook hooks are live'
+        }
+    ];
+}
+export function createIntegrationPoints(input) {
+    return [
+        {
+            name: 'Runtime Registry',
+            href: '/registry',
+            detail: `${input.enabledRuntimeTools} enabled runtime tools across the platform`,
+            status: 'Live'
+        },
+        {
+            name: 'MCP Surface',
+            href: '/mcp',
+            detail: 'Expose tool-aware runtime assets to external MCP clients and presets',
+            status: 'Live'
+        },
+        {
+            name: 'Custom Components',
+            href: '/components',
+            detail: `${input.components} platform-backed components available for runtime widgets and shared UI`,
+            status: 'Live'
+        },
+        {
+            name: 'HTTP APIs',
+            href: '/tools',
+            detail: 'CRUD and execution endpoints for tools, agents, prompts, benchmarks, and code execution',
+            status: 'Live'
+        },
+        {
+            name: 'Adapters + Providers',
+            href: '/registry',
+            detail: `${input.adapters} adapters and ${input.providers} providers are currently registered`,
+            status: 'Live'
+        },
+        {
+            name: 'Remote Registries',
+            href: '/registry',
+            detail: input.remoteRegistries > 0
+                ? `${input.remoteRegistries} remote registry source${input.remoteRegistries === 1 ? '' : 's'} configured for package or hosted tool discovery`
+                : 'Remote registry ingestion is available for package-published or hosted tool catalogs',
+            status: input.remoteRegistries > 0 ? 'Configured' : 'Available'
+        },
+        {
+            name: 'Benchmark Webhooks',
+            href: '/benchmarks/schedules',
+            detail: 'Schedules can fan out via webhook-aware benchmark automation',
+            status: 'Live'
+        }
+    ];
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/app/dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/app/dashboard.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,KAOlC;IACA,OAAO;QACN;YACC,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,8EAA8E;YAC3F,IAAI,EAAE,eAAe;YACrB,GAAG,EAAE,aAAa;YAClB,IAAI,EAAE,GAAG,KAAK,CAAC,WAAW,SAAS;YACnC,SAAS,EAAE,GAAG,KAAK,CAAC,WAAW,0BAA0B;SACzD;QACD;YACC,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,yEAAyE;YACtF,IAAI,EAAE,gBAAgB;YACtB,GAAG,EAAE,cAAc;YACnB,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,WAAW;YAChC,SAAS,EAAE,uDAAuD;SAClE;QACD;YACC,KAAK,EAAE,gBAAgB;YACvB,WAAW,EAAE,2EAA2E;YACxF,IAAI,EAAE,iBAAiB;YACvB,GAAG,EAAE,eAAe;YACpB,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,UAAU;YAChC,SAAS,EAAE,kDAAkD;SAC7D;QACD;YACC,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,iFAAiF;YAC9F,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,iBAAiB;YACtB,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,aAAa;YACtC,SAAS,EAAE,sEAAsE;SACjF;QACD;YACC,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,0EAA0E;YACvF,IAAI,EAAE,aAAa;YACnB,GAAG,EAAE,iBAAiB;YACtB,IAAI,EAAE,GAAG,KAAK,CAAC,UAAU,aAAa;YACtC,SAAS,EAAE,2DAA2D;SACtE;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAMvC;IACA,OAAO;QACN;YACC,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,GAAG,KAAK,CAAC,mBAAmB,4CAA4C;YAChF,MAAM,EAAE,MAAM;SACd;QACD;YACC,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,sEAAsE;YAC9E,MAAM,EAAE,MAAM;SACd;QACD;YACC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,aAAa;YACnB,MAAM,EAAE,GAAG,KAAK,CAAC,UAAU,yEAAyE;YACpG,MAAM,EAAE,MAAM;SACd;QACD;YACC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,yFAAyF;YACjG,MAAM,EAAE,MAAM;SACd;QACD;YACC,IAAI,EAAE,sBAAsB;YAC5B,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,GAAG,KAAK,CAAC,QAAQ,iBAAiB,KAAK,CAAC,SAAS,qCAAqC;YAC9F,MAAM,EAAE,MAAM;SACd;QACD;YACC,IAAI,EAAE,mBAAmB;YACzB,IAAI,EAAE,WAAW;YACjB,MAAM,EACL,KAAK,CAAC,gBAAgB,GAAG,CAAC;gBACzB,CAAC,CAAC,GAAG,KAAK,CAAC,gBAAgB,0BAA0B,KAAK,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kDAAkD;gBAC9I,CAAC,CAAC,sFAAsF;YAC1F,MAAM,EAAE,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW;SAC/D;QACD;YACC,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,8DAA8D;YACtE,MAAM,EAAE,MAAM;SACd;KACD,CAAC;AACH,CAAC"}

package/dist/audit-ledger/parser.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Audit Ledger Parser
+ *
+ * Parses the claims-table format used by `docs/audits/** /LEDGER.md` files —
+ * see `docs/audits/tui-agentic/LEDGER.md` for the canonical example and
+ * `docs/proposals/tui-followon-program/README.md` for the status vocabulary
+ * (`UNVERIFIED` / `PARTIAL` / `CONFIRMED` / `REFUTED→FIXED(<commit>)`).
+ *
+ * Pure, no I/O — callers read the file and pass `path` + `content`. A ledger
+ * can hold several claims tables (P0/P1/P2 sections); every table whose
+ * header declares both a `Claim` and a `Status` column is parsed, in file
+ * order. Tables that don't declare those columns (e.g. a "Pass log" or a
+ * `PROGRAM.md`-style contract table) are left alone.
+ *
+ * Deliberately strict: a claims-table header without a valid separator row,
+ * a data row whose column count doesn't match the header, or a data row with
+ * an empty Claim/Status cell all refuse `INVALID_INPUT` `ledger-parse-invalid` rather than being
+ * silently skipped — a checker that can't trust its own parse must not
+ * report a false "fully confirmed".
+ *
+ * Also deliberately strict about *qualified* confirmations: a cell that starts
+ * "CONFIRMED"/"REFUTED→FIXED" but smuggles in a disqualifying caveat — outside OR
+ * inside its parenthetical evidence, e.g. "CONFIRMED (all layers) except the live
+ * smoke (blocked by local AI gate)" — is downgraded to `QUALIFIED`/`passes:false`
+ * rather than counted as done. See `QUALIFIER_WORDS` for the exact vocabulary and
+ * the hyphen-compound carve-out that keeps plain prose like "server-blocked upstream"
+ * passing.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+export type LedgerClaimStatus = 'CONFIRMED' | 'REFUTED_FIXED' | 'REFUTED' | 'PARTIAL' | 'UNVERIFIED' | 'QUALIFIED' | 'UNKNOWN';
+export interface LedgerClaim {
+    /** Table row id, taken verbatim from the `#` column (falls back to a 1-based index). */
+    id: string;
+    claim: string;
+    statusRaw: string;
+    status: LedgerClaimStatus;
+    /** Commit refs captured out of every `FIXED(<commit>[, <commit>...])` segment in the status cell. */
+    fixCommits: string[];
+    /** True when the claim satisfies the ledger's done condition (CONFIRMED, or REFUTED→FIXED). */
+    passes: boolean;
+    /**
+     * Disqualifying qualifier words (lower-cased, deduped) found anywhere in the status
+     * cell — parenthetical evidence included — that downgraded an otherwise-terminal
+     * CONFIRMED/REFUTED→FIXED status to `QUALIFIED`/`passes:false`. Empty/undefined when
+     * no qualifier applied. See `QUALIFIER_WORDS`.
+     */
+    qualifiers?: string[];
+    evidence?: string;
+    /** 1-based line number of the row in the source file, for diagnostics. */
+    line: number;
+    /** Nearest preceding markdown heading, if any (e.g. "P0 — the agentic core ..."). */
+    section?: string;
+}
+export interface LedgerParseResult {
+    path: string;
+    claims: LedgerClaim[];
+    /** Number of recognized claims tables (Claim + Status columns) found in the file. */
+    tableCount: number;
+}
+/** The refusal for a ledger the parser cannot trust: names the file and, when known, the line. */
+export declare function ledgerParseFailure(message: string, path: string, line?: number): CapabilityError;
+export declare function parseLedgerMarkdown(path: string, content: string): LedgerParseResult;
+//# sourceMappingURL=parser.d.ts.map

package/dist/audit-ledger/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/audit-ledger/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,MAAM,iBAAiB,GAC1B,WAAW,GACX,eAAe,GACf,SAAS,GACT,SAAS,GACT,YAAY,GACZ,WAAW,GACX,SAAS,CAAC;AAEb,MAAM,WAAW,WAAW;IAC3B,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,qGAAqG;IACrG,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+FAA+F;IAC/F,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,CAMhG;AAwJD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAsGpF"}