@modularizer/plat-client 0.4.0

package/dist/server/routing.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Routing Utilities for plat
+ *
+ * Provides functions to generate route variants:
+ * - Case variants: camelCase -> snake_case, kebab-case
+ * - HTTP method flexibility: GET ↔ POST
+ */
+/**
+ * Convert camelCase to snake_case
+ * e.g., getOrder -> get_order
+ */
+export declare function toSnakeCase(str: string): string;
+/**
+ * Convert camelCase to kebab-case
+ * e.g., getOrder -> get-order
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Generate all case variants of a method name
+ * e.g., getOrder -> [getOrder, get_order, get-order]
+ */
+export declare function getCaseVariants(methodName: string): string[];
+/**
+ * Get the flexible HTTP methods for a route
+ * GET can also accept POST, POST can also accept GET
+ * This allows more resilient APIs
+ */
+export declare function getFlexibleMethods(httpMethod: string): string[];
+/**
+ * Create route registration entries for all variants
+ * Takes a method and generates:
+ * - All case variants (camelCase, snake_case, kebab-case)
+ * - All flexible HTTP methods
+ */
+export declare function generateRouteVariants(methodName: string, httpMethod: string): Array<{
+    path: string;
+    method: string;
+}>;
+//# sourceMappingURL=routing.d.ts.map

package/dist/server/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../typescript/src/server/routing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAe/D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAezC"}

package/dist/server/routing.js

@@ -0,0 +1,70 @@
+/**
+ * Routing Utilities for plat
+ *
+ * Provides functions to generate route variants:
+ * - Case variants: camelCase -> snake_case, kebab-case
+ * - HTTP method flexibility: GET ↔ POST
+ */
+/**
+ * Convert camelCase to snake_case
+ * e.g., getOrder -> get_order
+ */
+export function toSnakeCase(str) {
+    return str.replace(/([A-Z])/g, '_$1').toLowerCase();
+}
+/**
+ * Convert camelCase to kebab-case
+ * e.g., getOrder -> get-order
+ */
+export function toKebabCase(str) {
+    return str.replace(/([A-Z])/g, '-$1').toLowerCase();
+}
+/**
+ * Generate all case variants of a method name
+ * e.g., getOrder -> [getOrder, get_order, get-order]
+ */
+export function getCaseVariants(methodName) {
+    return [methodName, toSnakeCase(methodName), toKebabCase(methodName)];
+}
+/**
+ * Get the flexible HTTP methods for a route
+ * GET can also accept POST, POST can also accept GET
+ * This allows more resilient APIs
+ */
+export function getFlexibleMethods(httpMethod) {
+    const method = httpMethod.toUpperCase();
+    if (method === 'GET') {
+        return ['GET', 'POST'];
+    }
+    if (method === 'POST') {
+        return ['POST', 'GET'];
+    }
+    if (method === 'PUT') {
+        return ['PUT', 'PATCH', 'POST'];
+    }
+    if (method === 'DELETE') {
+        return ['DELETE', 'POST'];
+    }
+    return [method];
+}
+/**
+ * Create route registration entries for all variants
+ * Takes a method and generates:
+ * - All case variants (camelCase, snake_case, kebab-case)
+ * - All flexible HTTP methods
+ */
+export function generateRouteVariants(methodName, httpMethod) {
+    const routes = [];
+    const caseVariants = getCaseVariants(methodName);
+    const methodVariants = getFlexibleMethods(httpMethod);
+    for (const caseVariant of caseVariants) {
+        for (const method of methodVariants) {
+            routes.push({
+                path: '/' + caseVariant,
+                method: method,
+            });
+        }
+    }
+    return routes;
+}
+//# sourceMappingURL=routing.js.map

package/dist/server/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../typescript/src/server/routing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;IACvC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACxB,CAAC;IACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACxB,CAAC;IACD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;IACjC,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,UAAkB;IAElB,MAAM,MAAM,GAA4C,EAAE,CAAA;IAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC,CAAA;IAChD,MAAM,cAAc,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAA;IAErD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,KAAK,MAAM,MAAM,IAAI,cAAc,EAAE,CAAC;YACpC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,GAAG,GAAG,WAAW;gBACvB,MAAM,EAAE,MAAM;aACf,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/server/token-limit/index.d.ts

@@ -0,0 +1,2 @@
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/token-limit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../typescript/src/server/token-limit/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/dist/server/token-limit/index.js

@@ -0,0 +1,2 @@
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/server/token-limit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../typescript/src/server/token-limit/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/dist/server/token-limit/utils.d.ts

@@ -0,0 +1,44 @@
+import { TokenLimitController, TokenLimitEntry, TokenLimitMeta, TokenLimitTiming, TokenLimitConfigs, ResolvedTokenLimitEntry } from '../../types/plugins';
+/**
+ * Resolve token limit key with substitutions:
+ * - :route → methodName
+ * - :parent → basePath
+ * - :user:{field} → user[field] from auth context (e.g., :user:plan, :user:id)
+ */
+export declare function resolveTokenLimitKey(raw: string, methodName: string, basePath: string, user?: any): string;
+/**
+ * Resolve call cost to numeric value
+ */
+export declare function resolveCallCost(spec: TokenLimitEntry['callCost'], params: any, ctx: any): Promise<number>;
+/**
+ * Resolve response cost to numeric value
+ */
+export declare function resolveResponseCost(spec: TokenLimitEntry['responseCost'], result: any, timing: TokenLimitTiming, params: any): Promise<number>;
+/**
+ * Resolve failure cost to numeric value
+ */
+export declare function resolveFailureCost(spec: TokenLimitEntry['failureCost'], error: Error, timing: TokenLimitTiming, params: any): Promise<number>;
+/**
+ * Create an in-memory token limit controller with token-bucket algorithm
+ * Lazy fills bucket on each access
+ */
+export declare function createInMemoryTokenLimit(): TokenLimitController;
+/**
+ * Pre-handler: resolve callCost → controller.deduct() → return ResolvedTokenLimitEntry[] + remainingBalances
+ */
+export declare function applyTokenLimitCheck(meta: TokenLimitMeta | undefined, controller: TokenLimitController, configs: TokenLimitConfigs, methodName: string, basePath: string, params: any, ctx: any, user?: any): Promise<{
+    entries: ResolvedTokenLimitEntry[];
+    remainingBalances: number[];
+}>;
+/**
+ * Post-handler (success): resolve responseCost → deduct;
+ * if refundedStatusCode → refund callCost instead
+ * Returns responseCosts[]
+ */
+export declare function applyTokenLimitResponse(entries: ResolvedTokenLimitEntry[], controller: TokenLimitController, result: any, timing: TokenLimitTiming, params: any, statusCode: number): Promise<number[]>;
+/**
+ * Catch block (error path): resolve failureCost → deduct (or negative → refund)
+ * If failureCost is 0 and statusCode in refundedStatusCodes → refund callCost
+ */
+export declare function applyTokenLimitFailure(entries: ResolvedTokenLimitEntry[], controller: TokenLimitController, error: Error, timing: TokenLimitTiming, params: any, statusCode: number): Promise<number[]>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/token-limit/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../typescript/src/server/token-limit/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAEhB,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,qBAAqB,CAAA;AAM5B;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,GAAG,GACT,MAAM,CAoBR;AAMD;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,eAAe,CAAC,UAAU,CAAC,EACjC,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,GAAG,GACP,OAAO,CAAC,MAAM,CAAC,CAsBjB;AA4BD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,eAAe,CAAC,cAAc,CAAC,EACrC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,CAAC,aAAa,CAAC,EACpC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,GAAG,GACV,OAAO,CAAC,MAAM,CAAC,CAcjB;AAWD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,oBAAoB,CAoE/D;AAMD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,GAAG,EACR,IAAI,CAAC,EAAE,GAAG,GACT,OAAO,CAAC;IAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmC9E;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,EAAE,EAClC,UAAU,EAAE,oBAAoB,EAChC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,uBAAuB,EAAE,EAClC,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCnB"}

package/dist/server/token-limit/utils.js

@@ -0,0 +1,260 @@
+import { HttpError } from "../../types/index.js";
+// ============================================================================
+// KEY SUBSTITUTION
+// ============================================================================
+/**
+ * Resolve token limit key with substitutions:
+ * - :route → methodName
+ * - :parent → basePath
+ * - :user:{field} → user[field] from auth context (e.g., :user:plan, :user:id)
+ */
+export function resolveTokenLimitKey(raw, methodName, basePath, user) {
+    let key = raw
+        .replace(':route', methodName)
+        .replace(':parent', basePath);
+    // Replace :user:{field} with user property
+    if (user) {
+        const userMatches = key.match(/:user:(\w+)/g);
+        if (userMatches) {
+            for (const match of userMatches) {
+                const field = match.slice(6); // Remove ':user:'
+                const value = user[field];
+                if (value !== undefined) {
+                    key = key.replace(match, String(value));
+                }
+            }
+        }
+    }
+    return key;
+}
+// ============================================================================
+// COST RESOLVERS
+// ============================================================================
+/**
+ * Resolve call cost to numeric value
+ */
+export async function resolveCallCost(spec, params, ctx) {
+    if (typeof spec === 'number') {
+        return spec;
+    }
+    if (typeof spec === 'function') {
+        return await spec(params, ctx);
+    }
+    if (typeof spec === 'object') {
+        const formula = spec;
+        const initial = formula.initial ?? 0;
+        const perLimit = formula.perLimit ?? 0;
+        const perChar = formula.perChar ?? 0;
+        const limit = params.limit ?? 0;
+        const paramChars = JSON.stringify(params).length;
+        return initial + perLimit * limit + perChar * paramChars;
+    }
+    return 1; // default
+}
+/**
+ * Count items in result (for response cost formula)
+ */
+function countItems(value) {
+    if (Array.isArray(value))
+        return value.length;
+    if (typeof value === 'object' && value !== null)
+        return 1;
+    return 0;
+}
+/**
+ * Count total characters in result (for response cost formula)
+ */
+function countChars(value) {
+    return JSON.stringify(value).length;
+}
+/**
+ * Count keys in result object (for response cost formula)
+ */
+function countKeys(value) {
+    if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+        return Object.keys(value).length;
+    }
+    return 0;
+}
+/**
+ * Resolve response cost to numeric value
+ */
+export async function resolveResponseCost(spec, result, timing, params) {
+    if (spec === undefined || spec === 0) {
+        return 0;
+    }
+    if (typeof spec === 'number') {
+        return spec;
+    }
+    if (typeof spec === 'function') {
+        return await spec(result, timing, params);
+    }
+    if (typeof spec === 'object') {
+        const formula = spec;
+        const perMs = formula.perMs ?? 0;
+        const perItem = formula.perItem ?? 0;
+        const perChar = formula.perChar ?? 0;
+        const perKey = formula.perKey ?? 0;
+        const items = countItems(result);
+        const chars = countChars(result);
+        const keys = countKeys(result);
+        return perMs * timing.durationMs + perItem * items + perChar * chars + perKey * keys;
+    }
+    return 0;
+}
+/**
+ * Resolve failure cost to numeric value
+ */
+export async function resolveFailureCost(spec, error, timing, params) {
+    if (spec === undefined || spec === 0) {
+        return 0;
+    }
+    if (typeof spec === 'number') {
+        return spec;
+    }
+    if (typeof spec === 'function') {
+        return await spec(error, timing, params);
+    }
+    return 0;
+}
+/**
+ * Create an in-memory token limit controller with token-bucket algorithm
+ * Lazy fills bucket on each access
+ */
+export function createInMemoryTokenLimit() {
+    const buckets = new Map();
+    function refillBucket(key, config) {
+        const now = Date.now();
+        let bucket = buckets.get(key);
+        if (!bucket) {
+            bucket = { balance: config.maxBalance, lastRefillMs: now };
+            buckets.set(key, bucket);
+            return bucket.balance;
+        }
+        const elapsedMs = now - bucket.lastRefillMs;
+        const intervalsElapsed = Math.floor(elapsedMs / config.fillInterval);
+        if (intervalsElapsed > 0) {
+            const tokensGenerated = intervalsElapsed * config.fillAmount;
+            bucket.balance = Math.min(config.maxBalance, bucket.balance + tokensGenerated);
+            bucket.lastRefillMs = now - (elapsedMs % config.fillInterval);
+        }
+        return bucket.balance;
+    }
+    return {
+        check(key, config) {
+            const balance = refillBucket(key, config);
+            return balance;
+        },
+        deduct(key, cost, config) {
+            const balance = refillBucket(key, config);
+            const minBalance = config.minBalance ?? 0;
+            const newBalance = balance - cost;
+            if (newBalance < minBalance) {
+                const deficit = minBalance - newBalance;
+                const intervalsNeeded = Math.ceil(deficit / config.fillAmount);
+                const retryAfterMs = intervalsNeeded * config.fillInterval;
+                throw new HttpError(429, 'Token limit exceeded', { retryAfterMs });
+            }
+            const bucket = buckets.get(key);
+            bucket.balance = newBalance;
+            return newBalance;
+        },
+        refund(key, cost, config) {
+            let bucket = buckets.get(key);
+            if (!bucket) {
+                bucket = { balance: Math.min(config.maxBalance, cost), lastRefillMs: Date.now() };
+                buckets.set(key, bucket);
+            }
+            else {
+                bucket.balance = Math.min(config.maxBalance, bucket.balance + cost);
+            }
+        },
+    };
+}
+// ============================================================================
+// PIPELINE HELPERS
+// ============================================================================
+/**
+ * Pre-handler: resolve callCost → controller.deduct() → return ResolvedTokenLimitEntry[] + remainingBalances
+ */
+export async function applyTokenLimitCheck(meta, controller, configs, methodName, basePath, params, ctx, user) {
+    if (!meta) {
+        return { entries: [], remainingBalances: [] };
+    }
+    const entries = Array.isArray(meta) ? meta : [meta];
+    const resolved = [];
+    const remainingBalances = [];
+    for (const entry of entries) {
+        const rawKey = entry.key ?? ':route';
+        const key = resolveTokenLimitKey(rawKey, methodName, basePath, user);
+        const callCost = await resolveCallCost(entry.callCost ?? 1, params, ctx);
+        const config = entry.config ?? configs[key];
+        if (!config) {
+            throw new Error(`Token limit config not found for key "${key}". ` +
+                `Define it in server.tokenLimit.configs or inline in route metadata.`);
+        }
+        const remaining = await controller.deduct(key, callCost, config);
+        resolved.push({
+            key,
+            callCost,
+            responseCostSpec: entry.responseCost,
+            failureCostSpec: entry.failureCost,
+            config,
+        });
+        remainingBalances.push(remaining);
+    }
+    return { entries: resolved, remainingBalances };
+}
+/**
+ * Post-handler (success): resolve responseCost → deduct;
+ * if refundedStatusCode → refund callCost instead
+ * Returns responseCosts[]
+ */
+export async function applyTokenLimitResponse(entries, controller, result, timing, params, statusCode) {
+    const responseCosts = [];
+    for (const entry of entries) {
+        const shouldRefundCall = (entry.config.refundedStatusCodes?.includes(statusCode)) ||
+            (entry.config.refundSuccessful && statusCode >= 200 && statusCode < 300);
+        if (shouldRefundCall) {
+            await controller.refund(entry.key, entry.callCost, entry.config);
+        }
+        else {
+            // Deduct response cost
+            const responseCost = await resolveResponseCost(entry.responseCostSpec, result, timing, params);
+            if (responseCost > 0) {
+                await controller.deduct(entry.key, responseCost, entry.config);
+            }
+            responseCosts.push(responseCost);
+        }
+    }
+    return responseCosts;
+}
+/**
+ * Catch block (error path): resolve failureCost → deduct (or negative → refund)
+ * If failureCost is 0 and statusCode in refundedStatusCodes → refund callCost
+ */
+export async function applyTokenLimitFailure(entries, controller, error, timing, params, statusCode) {
+    const failureCosts = [];
+    for (const entry of entries) {
+        const failureCost = await resolveFailureCost(entry.failureCostSpec, error, timing, params);
+        if (failureCost > 0) {
+            // Deduct additional failure cost
+            await controller.deduct(entry.key, failureCost, entry.config);
+        }
+        else if (failureCost < 0) {
+            // Negative failure cost = partial refund
+            await controller.refund(entry.key, -failureCost, entry.config);
+        }
+        else if (failureCost === 0) {
+            // Check for refunded status codes even on 0 failure cost
+            const shouldRefundCall = (entry.config.refundedStatusCodes?.includes(statusCode)) ||
+                (entry.config.refundSuccessful && statusCode >= 200 && statusCode < 300);
+            if (shouldRefundCall) {
+                await controller.refund(entry.key, entry.callCost, entry.config);
+            }
+        }
+        failureCosts.push(failureCost);
+    }
+    return failureCosts;
+}
+//# sourceMappingURL=utils.js.map

package/dist/server/token-limit/utils.js.map

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

package/dist/server/tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Definition Generation for AI Integrations (Claude, OpenAI, etc)
+ *
+ * Generates standardized tool definitions from controller metadata
+ * Supports multiple formats: Anthropic (Claude), OpenAI, generic JSON Schema
+ */
+import { ZodSchema } from 'zod';
+import type { ToolDefinition, ToolFormat, AnthropicTool, OpenAITool } from '../types/tools';
+import { buildInputSchemaFromOpenAPIOperation, buildResponseSchemaFromOpenAPIOperation, emptyInputSchema, normalizeInputSchema, toolDefinitionFromOpenAPIOperation, type ToolDefinitionInit } from '../shared/tools';
+/**
+ * Convert a Zod schema to JSON Schema
+ */
+export declare function zodToJsonSchema(schema: ZodSchema): any;
+export { buildInputSchemaFromOpenAPIOperation, buildResponseSchemaFromOpenAPIOperation, emptyInputSchema, normalizeInputSchema, toolDefinitionFromOpenAPIOperation, };
+export declare function createToolDefinition(init: ToolDefinitionInit): ToolDefinition;
+export declare function createToolDefinition(methodName: string, httpMethod: string, path: string, description: string, inputSchema?: ZodSchema | Record<string, any>, responseSchema?: ZodSchema | Record<string, any>, controller?: string): ToolDefinition;
+/**
+ * Convert tool definition to Claude/Anthropic format
+ */
+export declare function toAnthropicFormat(tool: ToolDefinition): AnthropicTool;
+/**
+ * Convert tool definition to OpenAI format
+ */
+export declare function toOpenAIFormat(tool: ToolDefinition): OpenAITool;
+/**
+ * Convert tool definition to generic format (with metadata)
+ */
+export declare function toSchemaFormat(tool: ToolDefinition): ToolDefinition;
+/**
+ * Convert tool definition to requested format
+ */
+export declare function formatTool(tool: ToolDefinition, format: ToolFormat): any;
+//# sourceMappingURL=tools.d.ts.map

package/dist/server/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../typescript/src/server/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3F,OAAO,EACH,oCAAoC,EACpC,uCAAuC,EAEvC,gBAAgB,EAChB,oBAAoB,EACpB,kCAAkC,EAClC,KAAK,kBAAkB,EAC1B,MAAM,iBAAiB,CAAA;AAGxB;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,GAAG,CAoCtD;AAuCD,OAAO,EACH,oCAAoC,EACpC,uCAAuC,EACvC,gBAAgB,EAChB,oBAAoB,EACpB,kCAAkC,GACrC,CAAA;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAAA;AAC9E,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7C,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,UAAU,CAAC,EAAE,MAAM,GACpB,cAAc,CAAA;AAuDjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAMrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,CAa/D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAEnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,GAAG,GAAG,CAUxE"}

package/dist/server/tools.js

@@ -0,0 +1,160 @@
+/**
+ * Tool Definition Generation for AI Integrations (Claude, OpenAI, etc)
+ *
+ * Generates standardized tool definitions from controller metadata
+ * Supports multiple formats: Anthropic (Claude), OpenAI, generic JSON Schema
+ */
+import { buildInputSchemaFromOpenAPIOperation, buildResponseSchemaFromOpenAPIOperation, createToolDefinition as createSharedToolDefinition, emptyInputSchema, normalizeInputSchema, toolDefinitionFromOpenAPIOperation, } from '../shared/tools.js';
+/**
+ * Convert a Zod schema to JSON Schema
+ */
+export function zodToJsonSchema(schema) {
+    if (!schema) {
+        return { type: 'object', properties: {} };
+    }
+    // Handle different Zod types
+    const schemaAny = schema;
+    // For object schemas
+    if (schemaAny._def?.shape) {
+        const shape = schemaAny._def.shape;
+        const properties = {};
+        const required = [];
+        for (const [key, field] of Object.entries(shape)) {
+            const fieldSchema = field;
+            const fieldAny = fieldSchema;
+            // Check if required
+            if (fieldAny._def?.innerType === undefined && fieldAny._def?.t !== 'ZodOptional') {
+                required.push(key);
+            }
+            // Get the type
+            properties[key] = zodTypeToJsonType(fieldSchema);
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+        };
+    }
+    // Fallback
+    return { type: 'object', properties: {} };
+}
+/**
+ * Convert a single Zod type to JSON Schema type
+ */
+function zodTypeToJsonType(schema) {
+    const schemaAny = schema;
+    const typeName = schemaAny._def?.t;
+    switch (typeName) {
+        case 'ZodString':
+            return { type: 'string' };
+        case 'ZodNumber':
+            return { type: 'number' };
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray': {
+            const elementSchema = schemaAny._def?.type;
+            return {
+                type: 'array',
+                items: elementSchema ? zodTypeToJsonType(elementSchema) : { type: 'object' },
+            };
+        }
+        case 'ZodObject':
+            return zodToJsonSchema(schema);
+        case 'ZodOptional':
+            return zodTypeToJsonType(schemaAny._def?.innerType);
+        case 'ZodEnum':
+            return {
+                type: 'string',
+                enum: schemaAny._def?.values || [],
+            };
+        case 'ZodUnion':
+            return { type: 'string' }; // Simplified
+        default:
+            return { type: 'string' };
+    }
+}
+export { buildInputSchemaFromOpenAPIOperation, buildResponseSchemaFromOpenAPIOperation, emptyInputSchema, normalizeInputSchema, toolDefinitionFromOpenAPIOperation, };
+/**
+ * Create a tool definition from controller method metadata
+ */
+export function createToolDefinition(initOrMethodName, httpMethod, path, description, inputSchema, responseSchema, controller) {
+    if (typeof initOrMethodName === 'object') {
+        return createSharedToolDefinition(initOrMethodName);
+    }
+    const methodName = initOrMethodName;
+    const normalizedMethod = (httpMethod || 'GET').toUpperCase();
+    const normalizedPath = path || `/${methodName}`;
+    const jsonInputSchema = inputSchema ? schemaToJsonSchema(inputSchema) : emptyInputSchema();
+    return {
+        name: methodName,
+        description: description || `${normalizedMethod} ${normalizedPath}`,
+        method: normalizedMethod,
+        path: normalizedPath,
+        controller,
+        input_schema: normalizeInputSchema(jsonInputSchema),
+        response_schema: responseSchema ? schemaToJsonSchema(responseSchema) : undefined,
+    };
+}
+function schemaToJsonSchema(schema) {
+    if (isJsonSchemaObject(schema)) {
+        return schema;
+    }
+    return zodToJsonSchema(schema);
+}
+function isJsonSchemaObject(schema) {
+    return Boolean(schema
+        && typeof schema === 'object'
+        && !('_def' in schema)
+        && ('type' in schema
+            || 'properties' in schema
+            || 'oneOf' in schema
+            || 'enum' in schema));
+}
+/**
+ * Convert tool definition to Claude/Anthropic format
+ */
+export function toAnthropicFormat(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.input_schema,
+    };
+}
+/**
+ * Convert tool definition to OpenAI format
+ */
+export function toOpenAIFormat(tool) {
+    return {
+        type: 'function',
+        function: {
+            name: tool.name,
+            description: tool.description,
+            parameters: {
+                type: 'object',
+                properties: tool.input_schema.properties,
+                required: tool.input_schema.required,
+            },
+        },
+    };
+}
+/**
+ * Convert tool definition to generic format (with metadata)
+ */
+export function toSchemaFormat(tool) {
+    return tool;
+}
+/**
+ * Convert tool definition to requested format
+ */
+export function formatTool(tool, format) {
+    switch (format) {
+        case 'claude':
+            return toAnthropicFormat(tool);
+        case 'openai':
+            return toOpenAIFormat(tool);
+        case 'schema':
+        default:
+            return toSchemaFormat(tool);
+    }
+}
+//# sourceMappingURL=tools.js.map