@vurb/core 3.2.0

package/dist/cli/vurb.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+/**
+ * Vurb CLI
+ *
+ * Slim entry point: parses args, dispatches to command modules.
+ * All logic lives in focused modules under `./commands/`.
+ *
+ * @module
+ */
+import { parseArgs } from './args.js';
+import { HELP } from './constants.js';
+import { commandLock } from './commands/lock.js';
+import { commandDev } from './commands/dev.js';
+import { commandCreate } from './commands/create.js';
+import { commandRemote } from './commands/remote.js';
+import { commandDeploy } from './commands/deploy.js';
+// ─── Re-exports (backward compat — tests import from vurb.js) ──
+export { parseArgs } from './args.js';
+export { VURB_VERSION, HELP, ansi } from './constants.js';
+export { ProgressTracker, createDefaultReporter } from './progress.js';
+export { resolveRegistry } from './registry.js';
+export { collectConfig } from './commands/create.js';
+export { commandLock, commandDev, commandCreate };
+export { ask } from './utils.js';
+// ─── Main ────────────────────────────────────────────────────────
+async function main() {
+    const args = parseArgs(process.argv);
+    if (args.help || !args.command) {
+        console.log(HELP);
+        process.exit(args.help ? 0 : 1);
+    }
+    switch (args.command) {
+        case 'create':
+            await commandCreate(args);
+            break;
+        case 'dev':
+            await commandDev(args);
+            break;
+        case 'lock':
+            await commandLock(args);
+            process.exit(0);
+            break;
+        case 'deploy':
+            await commandDeploy(args);
+            process.exit(0);
+            break;
+        case 'remote':
+            await commandRemote(args);
+            break;
+        case 'inspect':
+        case 'insp':
+        case 'debug':
+        case 'dbg': {
+            const inspectArgv = process.argv.slice(3);
+            try {
+                const { runInspector } = await import('@vurb/inspector');
+                await runInspector(inspectArgv);
+            }
+            catch (importErr) {
+                console.error(`\x1b[31m\u2717\x1b[0m The inspector TUI requires the optional package:\n\n` +
+                    `  npm install @vurb/inspector\n`);
+                process.exit(1);
+            }
+            break;
+        }
+        default:
+            console.error(`Unknown command: "${args.command}"\n`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+/* c8 ignore next 9 — CLI entry-point guard */
+function detectCLI() {
+    if (typeof process === 'undefined' || !process.argv[1])
+        return false;
+    const base = process.argv[1].replace(/\\/g, '/').split('/').pop() ?? '';
+    // Strip extension (.js, .cjs, .mjs, .cmd, .ps1, .exe, etc.)
+    const name = base.replace(/\.[a-z0-9]+$/i, '');
+    return name === 'vurb';
+}
+if (detectCLI()) {
+    main().catch((err) => {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=vurb.js.map

package/dist/cli/vurb.js.map

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

package/dist/client/InferRouter.d.ts

@@ -0,0 +1,92 @@
+/**
+ * InferRouter — Compile-Time Router Type Extraction
+ *
+ * Extracts a fully typed `RouterMap` from a `TypedToolRegistry` or
+ * an array of `GroupedToolBuilder` instances. This is the key piece
+ * that makes the VurbClient tRPC-style experience real.
+ *
+ * **Zero runtime cost** — this module contains only type declarations.
+ *
+ * @example
+ * ```typescript
+ * // ── SERVER SIDE ──
+ * const registry = createTypedRegistry<AppContext>()(
+ *     projectsTool,  // GroupedToolBuilder<AppContext, ..., 'projects', { 'projects.list': ..., ... }>
+ *     billingTool,
+ * );
+ * export type AppRouter = InferRouter<typeof registry>;
+ *
+ * // ── CLIENT SIDE ──
+ * import type { AppRouter } from './server';
+ * const client = createVurbClient<AppRouter>(transport);
+ * await client.execute('projects.list', { workspace_id: 'ws_1' });
+ * //                    ^^^^^^^^^^^^^^    ^^^^^^^^^^^^^^^^^^^^^
+ * //                    autocomplete!     typed args!
+ * ```
+ *
+ * @module
+ */
+import { type GroupedToolBuilder } from '../core/builder/GroupedToolBuilder.js';
+import { type ToolRegistry } from '../core/registry/ToolRegistry.js';
+/**
+ * A typed wrapper around `ToolRegistry` that preserves builder types
+ * for compile-time router inference.
+ *
+ * Created by {@link createTypedRegistry}. The registry itself stores
+ * builders at runtime via a standard `ToolRegistry`, but the `_builders`
+ * tuple type is preserved for `InferRouter` extraction.
+ *
+ * @typeParam TContext - Application context type
+ * @typeParam TBuilders - Tuple of registered builder types
+ */
+export interface TypedToolRegistry<TContext, TBuilders extends readonly unknown[]> {
+    /** The underlying ToolRegistry instance (for runtime use) */
+    readonly registry: ToolRegistry<TContext>;
+    /** Branded field for type inference — never accessed at runtime */
+    readonly _builders: TBuilders;
+    /** Branded phantom type for context inference */
+    readonly _context: TContext;
+}
+/**
+ * Infer a `RouterMap` from a `TypedToolRegistry`.
+ *
+ * Extracts the accumulated `TRouterMap` from each builder registered
+ * in the typed registry, producing a flat intersection of all
+ * `{ 'toolName.actionName': ArgsType }` entries.
+ *
+ * @typeParam T - A `TypedToolRegistry` instance type
+ *
+ * @example
+ * ```typescript
+ * const projects = createTool<Ctx>('projects')
+ *     .action({ name: 'list', schema: z.object({ status: z.string() }), handler: ... })
+ *     .action({ name: 'create', schema: z.object({ name: z.string() }), handler: ... });
+ *
+ * const registry = createTypedRegistry<Ctx>()(projects);
+ * type AppRouter = InferRouter<typeof registry>;
+ * // Result: {
+ * //   'projects.list': { status: string };
+ * //   'projects.create': { name: string };
+ * // }
+ * ```
+ */
+export type InferRouter<T> = T extends TypedToolRegistry<infer _TCtx, infer TBuilders> ? InferRouterFromBuilders<TBuilders> : T extends readonly unknown[] ? InferRouterFromBuilders<T> : Record<string, Record<string, unknown>>;
+/**
+ * Infer router entries from a tuple of builders.
+ *
+ * Recursively intersects the `TRouterMap` from each builder in the tuple.
+ *
+ * @internal
+ */
+type InferRouterFromBuilders<T> = T extends readonly [infer First, ...infer Rest] ? ExtractRouterMap<First> & InferRouterFromBuilders<Rest> : T extends readonly [] ? {} : Record<string, Record<string, unknown>>;
+/**
+ * Extract the accumulated `TRouterMap` from a single `GroupedToolBuilder`.
+ *
+ * The 4th generic parameter of `GroupedToolBuilder<TCtx, TCommon, TName, TRouterMap>`
+ * carries the compile-time action map. This type extracts it.
+ *
+ * @internal
+ */
+type ExtractRouterMap<T> = T extends GroupedToolBuilder<infer _TCtx, infer _TCommon, infer _TName, infer TRouterMap> ? TRouterMap : Record<string, Record<string, unknown>>;
+export {};
+//# sourceMappingURL=InferRouter.d.ts.map

package/dist/client/InferRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferRouter.d.ts","sourceRoot":"","sources":["../../src/client/InferRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAMrE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,iBAAiB,CAAC,QAAQ,EAAE,SAAS,SAAS,SAAS,OAAO,EAAE;IAC7E,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC/B;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB,CAAC,SAAS,iBAAiB,CAAC,MAAM,KAAK,EAAE,MAAM,SAAS,CAAC,GACnD,uBAAuB,CAAC,SAAS,CAAC,GAClC,CAAC,SAAS,SAAS,OAAO,EAAE,GACxB,uBAAuB,CAAC,CAAC,CAAC,GAC1B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtD;;;;;;GAMG;AACH,KAAK,uBAAuB,CAAC,CAAC,IAC1B,CAAC,SAAS,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,GACzC,gBAAgB,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,GACvD,CAAC,SAAS,SAAS,EAAE,GAEjB,EAAE,GACF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,KAAK,gBAAgB,CAAC,CAAC,IACnB,CAAC,SAAS,kBAAkB,CAAC,MAAM,KAAK,EAAE,MAAM,QAAQ,EAAE,MAAM,MAAM,EAAE,MAAM,UAAU,CAAC,GACnF,UAAU,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/client/InferRouter.js

@@ -0,0 +1,31 @@
+/**
+ * InferRouter — Compile-Time Router Type Extraction
+ *
+ * Extracts a fully typed `RouterMap` from a `TypedToolRegistry` or
+ * an array of `GroupedToolBuilder` instances. This is the key piece
+ * that makes the VurbClient tRPC-style experience real.
+ *
+ * **Zero runtime cost** — this module contains only type declarations.
+ *
+ * @example
+ * ```typescript
+ * // ── SERVER SIDE ──
+ * const registry = createTypedRegistry<AppContext>()(
+ *     projectsTool,  // GroupedToolBuilder<AppContext, ..., 'projects', { 'projects.list': ..., ... }>
+ *     billingTool,
+ * );
+ * export type AppRouter = InferRouter<typeof registry>;
+ *
+ * // ── CLIENT SIDE ──
+ * import type { AppRouter } from './server';
+ * const client = createVurbClient<AppRouter>(transport);
+ * await client.execute('projects.list', { workspace_id: 'ws_1' });
+ * //                    ^^^^^^^^^^^^^^    ^^^^^^^^^^^^^^^^^^^^^
+ * //                    autocomplete!     typed args!
+ * ```
+ *
+ * @module
+ */
+import {} from '../core/builder/GroupedToolBuilder.js';
+import {} from '../core/registry/ToolRegistry.js';
+//# sourceMappingURL=InferRouter.js.map

package/dist/client/InferRouter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InferRouter.js","sourceRoot":"","sources":["../../src/client/InferRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EAA2B,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAqB,MAAM,kCAAkC,CAAC"}

package/dist/client/VurbClient.d.ts

@@ -0,0 +1,282 @@
+/**
+ * VurbClient — Type-Safe MCP Client (tRPC-style)
+ *
+ * Provides end-to-end type safety from server to client.
+ * The server exports its router type, and the client consumes it
+ * with full autocomplete and compile-time validation.
+ *
+ * @example
+ * ```typescript
+ * // ── SERVER (mcp-server.ts) ──
+ * export const registry = new ToolRegistry<AppContext>();
+ * registry.register(projects);
+ * registry.register(billing);
+ * export type AppRouter = InferRouter<typeof registry>;
+ *
+ * // ── CLIENT (agent.ts) ──
+ * import { createVurbClient } from 'vurb/client';
+ * import type { AppRouter } from './mcp-server';
+ *
+ * const client = createVurbClient<AppRouter>(transport);
+ * const result = await client.execute('projects.create', { name: 'Vinkius V2' });
+ * //                                   ^^^^^^^^^^^^^^^^    ^^^^^^^^^^^^^^^^^
+ * //                                   autocomplete!       typed args!
+ * ```
+ *
+ * @module
+ */
+import { type ToolResponse } from '../core/response.js';
+/**
+ * Transport interface for the Vurb client.
+ * This abstracts the MCP transport layer (stdio, HTTP, WebSocket, etc.)
+ */
+export interface VurbTransport {
+    /** Call a tool by name with arguments */
+    callTool(name: string, args: Record<string, unknown>): Promise<ToolResponse>;
+}
+/**
+ * Router type inferred from a ToolRegistry.
+ *
+ * Maps tool names to their action names and argument shapes.
+ * This type is used at compile-time only — zero runtime cost.
+ *
+ * @example
+ * ```typescript
+ * type MyRouter = {
+ *     'projects.list': { workspace_id: string; status?: string };
+ *     'projects.create': { workspace_id: string; name: string };
+ *     'billing.refund': { invoice_id: string; amount: number };
+ * };
+ * ```
+ */
+export type RouterMap = Record<string, Record<string, unknown>>;
+/**
+ * Client-side middleware for request/response interception.
+ *
+ * Follows the same onion model as server-side middleware:
+ * each middleware wraps the next, forming a pipeline.
+ *
+ * Use cases: authentication injection, request logging,
+ * retry logic, timeout enforcement, response transformation.
+ *
+ * @example
+ * ```typescript
+ * const authMiddleware: ClientMiddleware = async (action, args, next) => {
+ *     const enrichedArgs = { ...args, _token: getToken() };
+ *     return next(action, enrichedArgs);
+ * };
+ *
+ * const retryMiddleware: ClientMiddleware = async (action, args, next) => {
+ *     for (let i = 0; i < 3; i++) {
+ *         const result = await next(action, args);
+ *         if (!result.isError) return result;
+ *     }
+ *     return next(action, args);
+ * };
+ * ```
+ */
+export type ClientMiddleware = (action: string, args: Record<string, unknown>, next: (action: string, args: Record<string, unknown>) => Promise<ToolResponse>) => Promise<ToolResponse>;
+/**
+ * Structured error parsed from a `<tool_error>` XML envelope.
+ *
+ * Provides typed access to self-healing fields so client code
+ * can programmatically react to server errors without regex parsing.
+ */
+export declare class VurbClientError extends Error {
+    /** Error code from the `code` attribute (e.g. `'NOT_FOUND'`). */
+    readonly code: string;
+    /** Recovery suggestion from `<recovery>` element. */
+    readonly recovery?: string | undefined;
+    /** Available actions from `<available_actions>` children. */
+    readonly availableActions: readonly string[];
+    /** Error severity from the `severity` attribute. */
+    readonly severity: string;
+    /** Raw ToolResponse that caused the error. */
+    readonly raw: ToolResponse;
+    constructor(message: string, code: string, raw: ToolResponse, options?: {
+        recovery?: string | undefined;
+        availableActions?: string[] | undefined;
+        severity?: string | undefined;
+    });
+}
+/**
+ * Options for creating a VurbClient.
+ */
+export interface VurbClientOptions {
+    /**
+     * Client-side middleware pipeline.
+     *
+     * Middleware execute in registration order (first = outermost).
+     * Each middleware can modify the request, response, or both.
+     *
+     * @example
+     * ```typescript
+     * const client = createVurbClient<AppRouter>(transport, {
+     *     middleware: [authMiddleware, loggingMiddleware],
+     * });
+     * ```
+     */
+    middleware?: ClientMiddleware[];
+    /**
+     * When `true`, `execute()` throws a {@link VurbClientError}
+     * for responses with `isError: true`.
+     *
+     * When `false` (default), error responses are returned normally
+     * and the caller must check `result.isError`.
+     *
+     * @default false
+     */
+    throwOnError?: boolean;
+    /**
+     * Key used as the discriminator when calling grouped tools.
+     *
+     * Must match the discriminator key configured on the server
+     * (e.g. `group.discriminator('command')`).
+     *
+     * @default 'action'
+     */
+    discriminatorKey?: string;
+}
+/**
+ * Type-safe client that provides autocomplete and compile-time
+ * validation for MCP tool calls.
+ *
+ * @typeParam TRouter - The router map inferred from the server's registry
+ */
+export interface VurbClient<TRouter extends RouterMap> {
+    /**
+     * Execute a tool action with full type safety.
+     *
+     * @param action - Full action path (e.g. 'projects.create')
+     * @param args - Typed arguments matching the action's schema
+     * @returns The tool response
+     */
+    execute<TAction extends keyof TRouter & string>(action: TAction, args: TRouter[TAction]): Promise<ToolResponse>;
+    /**
+     * Execute multiple tool actions concurrently.
+     *
+     * All calls run in parallel via `Promise.all`.
+     * Use `{ sequential: true }` for ordered execution.
+     *
+     * @param calls - Array of `{ action, args }` objects
+     * @param options - Optional execution mode
+     * @returns Array of tool responses, one per call
+     *
+     * @example
+     * ```typescript
+     * const results = await client.executeBatch([
+     *     { action: 'projects.list', args: { workspace_id: 'ws_1' } },
+     *     { action: 'billing.balance', args: { account_id: 'acc_1' } },
+     * ]);
+     * ```
+     */
+    executeBatch<TActions extends ReadonlyArray<keyof TRouter & string>>(calls: {
+        [K in keyof TActions]: {
+            action: TActions[K];
+            args: TRouter[TActions[K] & keyof TRouter];
+        };
+    }, options?: {
+        sequential?: boolean | undefined;
+    } | undefined): Promise<ToolResponse[]>;
+    /**
+     * Fluent proxy for calling tools with dot-navigation.
+     *
+     * Builds the action path from chained property accesses,
+     * then executes when invoked as a function.
+     *
+     * @example
+     * ```typescript
+     * // Equivalent to: client.execute('projects.create', { name: 'V2' })
+     * await client.proxy.projects.create({ name: 'V2' });
+     *
+     * // Also works for deeper paths:
+     * await client.proxy.platform.users.list({ limit: 10 });
+     * ```
+     */
+    readonly proxy: FluentProxy<TRouter>;
+}
+/**
+ * Splits a dotted key `'a.b.c'` into head `'a'` and tail `'b.c'`.
+ * @internal
+ */
+type SplitKey<K extends string> = K extends `${infer Head}.${infer Tail}` ? [Head, Tail] : [K, never];
+/**
+ * Collects all first segments from the router keys.
+ * @internal
+ */
+type FirstSegments<TRouter extends RouterMap> = {
+    [K in keyof TRouter & string]: SplitKey<K>[0];
+}[keyof TRouter & string];
+/**
+ * Given a segment prefix, collects remaining tails and their arg types.
+ * @internal
+ */
+type SubRouter<TRouter extends RouterMap, Prefix extends string> = {
+    [K in keyof TRouter & string as K extends `${Prefix}.${infer Rest}` ? Rest : never]: TRouter[K];
+};
+/**
+ * Recursive proxy node type.
+ *
+ * - If the key resolves to a leaf action, it becomes callable.
+ * - If it has further segments, it exposes another level of navigation.
+ * @internal
+ */
+type ProxyNode<TRouter extends RouterMap> = {
+    [Seg in FirstSegments<TRouter>]: (Seg extends keyof TRouter ? ((args: TRouter[Seg]) => Promise<ToolResponse>) : unknown) & (string extends FirstSegments<SubRouter<TRouter, Seg>> ? unknown : FluentProxy<SubRouter<TRouter, Seg>>);
+};
+/**
+ * Top-level fluent proxy type.
+ *
+ * Provides dot-navigation for calling tools:
+ * ```typescript
+ * await client.proxy.projects.create({ name: 'V2' });
+ * ```
+ */
+export type FluentProxy<TRouter extends RouterMap> = ProxyNode<TRouter>;
+/**
+ * Create a type-safe MCP client.
+ *
+ * The client provides full autocomplete for action names and
+ * compile-time validation for arguments based on the server's
+ * router type.
+ *
+ * @typeParam TRouter - The router map (use `InferRouter<typeof registry>`)
+ * @param transport - The MCP transport layer
+ * @param options - Client options (middleware, error handling)
+ * @returns A typed {@link VurbClient}
+ *
+ * @example
+ * ```typescript
+ * import type { AppRouter } from './mcp-server';
+ *
+ * const client = createVurbClient<AppRouter>(transport);
+ *
+ * // Full autocomplete + type validation:
+ * await client.execute('projects.create', { name: 'Vinkius V2' });
+ *
+ * // TS error: 'projects.nonexistent' is not a valid action
+ * await client.execute('projects.nonexistent', {});
+ *
+ * // TS error: missing required arg 'name'
+ * await client.execute('projects.create', {});
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With client middleware and throwOnError
+ * const client = createVurbClient<AppRouter>(transport, {
+ *     throwOnError: true,
+ *     middleware: [
+ *         async (action, args, next) => {
+ *             console.log(`[Client] calling ${action}`);
+ *             const result = await next(action, args);
+ *             console.log(`[Client] ${action} done`);
+ *             return result;
+ *         },
+ *     ],
+ * });
+ * ```
+ */
+export declare function createVurbClient<TRouter extends RouterMap>(transport: VurbTransport, options?: VurbClientOptions): VurbClient<TRouter>;
+export {};
+//# sourceMappingURL=VurbClient.d.ts.map

package/dist/client/VurbClient.d.ts.map

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