veryfront 0.1.215 → 0.1.217

package/README.md

@@ -24,7 +24,7 @@ Purpose-built for TypeScript and React, Veryfront gives you everything you need
 
 - [**Memory & Streaming**](https://veryfront.com/docs/code/guides/memory-and-streaming) — Give agents conversation history and streaming responses. Built-in chat UI components for React.
 
-- [**MCP Server**](https://veryfront.com/docs/code/guides/mcp-server) — Expose agents, tools, and resources via the Model Context Protocol. Connect your coding agent to live errors, logs, and HMR.
+- [**MCP Server**](https://veryfront.com/docs/code/guides/mcp-server) — Expose tools, prompts, and resources via the Model Context Protocol.
 
 - [**Pages & Routing**](https://veryfront.com/docs/code/guides/pages-and-routing) — File-based routing with React Server Components, layouts, and server-side rendering.
 

package/esm/cli/commands/extension/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const extensionHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/extension/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/extension/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,aAAa,EAAE,WAe3B,CAAC"}

package/esm/cli/commands/extension/command-help.js

@@ -0,0 +1,16 @@
+export const extensionHelp = {
+    name: "extension",
+    category: "development",
+    description: "Scaffold and validate veryfront extensions",
+    usage: "veryfront extension <init|validate> [args]",
+    options: [],
+    examples: [
+        "veryfront extension init my-cache              # Scaffold a new extension",
+        "veryfront extension validate extensions/my-cache   # Validate an extension",
+    ],
+    notes: [
+        "'init <name>' creates extensions/<name>/ with a typed factory and tests",
+        "'validate <path>' loads the extension and reports shape issues",
+        "Names must be lowercase alphanumeric with hyphens (e.g. 'my-cache')",
+    ],
+};

package/esm/cli/commands/extension/handler.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from "../../shared/types.js";
+export declare function handleExtensionCommand(args: ParsedArgs): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/extension/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/extension/handler.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAIxD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B5E"}

package/esm/cli/commands/extension/handler.js

@@ -0,0 +1,36 @@
+/**
+ * Extension command handler — routes to subcommands.
+ *
+ * @module cli/commands/extension/handler
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { runExtensionInit, validateExtensionName } from "./init-command.js";
+import { runExtensionValidate } from "./validate-command.js";
+export async function handleExtensionCommand(args) {
+    const subcommand = args._[1];
+    switch (subcommand) {
+        case "init": {
+            const name = args._[2];
+            if (!name) {
+                console.error("Usage: veryfront extension init <name>");
+                dntShim.Deno.exit(1);
+            }
+            const nameError = validateExtensionName(name);
+            if (nameError) {
+                console.error(`Error: ${nameError}`);
+                dntShim.Deno.exit(1);
+            }
+            await runExtensionInit(name, dntShim.Deno.cwd());
+            console.log(`Extension scaffolded at extensions/${name}/`);
+            break;
+        }
+        case "validate": {
+            const path = args._[2] || ".";
+            await runExtensionValidate(path);
+            break;
+        }
+        default:
+            console.error("Usage: veryfront extension <init|validate> [args]");
+            dntShim.Deno.exit(1);
+    }
+}

package/esm/cli/commands/extension/init-command.d.ts

@@ -0,0 +1,19 @@
+export interface GeneratedFile {
+    path: string;
+    content: string;
+}
+/**
+ * Validate an extension name. Returns an error message if invalid,
+ * or `undefined` if the name is acceptable.
+ */
+export declare function validateExtensionName(name: string): string | undefined;
+/**
+ * Generate the file contents for a new extension scaffold.
+ * Does not write to disk — returns file path/content pairs.
+ */
+export declare function generateExtensionFiles(name: string): GeneratedFile[];
+/**
+ * Execute the extension init command: generate files and write to disk.
+ */
+export declare function runExtensionInit(name: string, baseDir: string): Promise<void>;
+//# sourceMappingURL=init-command.d.ts.map

package/esm/cli/commands/extension/init-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/extension/init-command.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CAmFpE;AASD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF"}

package/esm/cli/commands/extension/init-command.js

@@ -0,0 +1,122 @@
+/**
+ * Extension init command — scaffold a new extension.
+ *
+ * @module cli/commands/extension/init-command
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+const VALID_NAME = /^[a-z0-9][a-z0-9-]*$/;
+/**
+ * Validate an extension name. Returns an error message if invalid,
+ * or `undefined` if the name is acceptable.
+ */
+export function validateExtensionName(name) {
+    if (!name)
+        return "Extension name is required.";
+    if (!VALID_NAME.test(name)) {
+        return "Extension name must be lowercase alphanumeric with hyphens (e.g., 'my-cache').";
+    }
+    if (name.length > 64)
+        return "Extension name must be 64 characters or fewer.";
+    return undefined;
+}
+/**
+ * Generate the file contents for a new extension scaffold.
+ * Does not write to disk — returns file path/content pairs.
+ */
+export function generateExtensionFiles(name) {
+    const base = `extensions/${name}`;
+    const indexTs = `/**
+ * ${name} extension.
+ *
+ * @module extensions/${name}
+ */
+
+import type { ExtensionFactory } from "veryfront/extensions";
+
+const ${camelCase(name)}: ExtensionFactory = () => ({
+  name: "${name}",
+  version: "0.1.0",
+  capabilities: [],
+
+  // Uncomment and modify to provide a contract implementation:
+  // provides: {
+  //   ContractName: { /* implementation */ },
+  // },
+
+  // Uncomment for async setup:
+  // async setup(ctx) {
+  //   // ctx.get<T>("ContractName") — consume another contract
+  //   // ctx.provide("ContractName", impl) — register a contract
+  // },
+
+  // Uncomment for cleanup:
+  // async teardown() {
+  //   // Close connections, flush buffers, etc.
+  // },
+});
+
+export default ${camelCase(name)};
+`;
+    const testTs = `/**
+ * ${name} extension tests.
+ *
+ * @module extensions/${name}/test
+ */
+
+import { assertEquals } from "#veryfront/testing/assert.ts";
+import { describe, it } from "#veryfront/testing/bdd.ts";
+import factory from "./index.ts";
+
+describe("${name} extension", () => {
+  it("should create an extension with correct name", () => {
+    const ext = factory();
+    assertEquals(ext.name, "${name}");
+  });
+
+  it("should have a version", () => {
+    const ext = factory();
+    assertEquals(typeof ext.version, "string");
+    assertEquals(ext.version.length > 0, true);
+  });
+
+  it("should have a capabilities array", () => {
+    const ext = factory();
+    assertEquals(Array.isArray(ext.capabilities), true);
+  });
+});
+`;
+    const denoJson = JSON.stringify({
+        name: name,
+        version: "0.1.0",
+        veryfront: {
+            extension: true,
+            capabilities: [],
+        },
+    }, null, 2);
+    return [
+        { path: `${base}/src/index.ts`, content: indexTs },
+        { path: `${base}/src/index.test.ts`, content: testTs },
+        { path: `${base}/deno.json`, content: denoJson + "\n" },
+    ];
+}
+function camelCase(name) {
+    return name
+        .split(/[-_]/)
+        .map((part, i) => (i === 0 ? part : part.charAt(0).toUpperCase() + part.slice(1)))
+        .join("");
+}
+/**
+ * Execute the extension init command: generate files and write to disk.
+ */
+export async function runExtensionInit(name, baseDir) {
+    const error = validateExtensionName(name);
+    if (error)
+        throw new Error(error);
+    const files = generateExtensionFiles(name);
+    for (const file of files) {
+        const fullPath = `${baseDir}/${file.path}`;
+        const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
+        await dntShim.Deno.mkdir(dir, { recursive: true });
+        await dntShim.Deno.writeTextFile(fullPath, file.content);
+    }
+}

package/esm/cli/commands/extension/validate-command.d.ts

@@ -0,0 +1,13 @@
+export interface ValidationReport {
+    valid: boolean;
+    issues: string[];
+}
+/**
+ * Validate an extension at the given directory path.
+ */
+export declare function validateExtensionAtPath(extensionPath: string): Promise<ValidationReport>;
+/**
+ * CLI entry point for `veryfront extension validate <path>`.
+ */
+export declare function runExtensionValidate(extensionPath: string): Promise<void>;
+//# sourceMappingURL=validate-command.d.ts.map

package/esm/cli/commands/extension/validate-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/extension/validate-command.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAwC3B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/E"}

package/esm/cli/commands/extension/validate-command.js

@@ -0,0 +1,62 @@
+/**
+ * Extension validate command — check an extension for shape and capability issues.
+ *
+ * @module cli/commands/extension/validate-command
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { validateExtension } from "../../../src/extensions/validation.js";
+/**
+ * Validate an extension at the given directory path.
+ */
+export async function validateExtensionAtPath(extensionPath) {
+    const issues = [];
+    const candidates = [
+        `${extensionPath}/src/index.ts`,
+        `${extensionPath}/index.ts`,
+    ];
+    let entryPoint;
+    for (const candidate of candidates) {
+        try {
+            const stat = await dntShim.Deno.stat(candidate);
+            if (stat.isFile) {
+                entryPoint = candidate;
+                break;
+            }
+        }
+        catch { /* next candidate */ }
+    }
+    if (!entryPoint) {
+        issues.push(`No entry point found. Expected src/index.ts or index.ts in ${extensionPath}`);
+        return { valid: false, issues };
+    }
+    try {
+        const mod = await import(`file://${await dntShim.Deno.realPath(entryPoint)}`);
+        const factory = mod.default;
+        if (typeof factory !== "function") {
+            issues.push("Default export must be a function (ExtensionFactory).");
+            return { valid: false, issues };
+        }
+        const ext = factory();
+        issues.push(...validateExtension(ext));
+    }
+    catch (err) {
+        issues.push(`Failed to import extension: ${err.message}`);
+    }
+    return { valid: issues.length === 0, issues };
+}
+/**
+ * CLI entry point for `veryfront extension validate <path>`.
+ */
+export async function runExtensionValidate(extensionPath) {
+    const report = await validateExtensionAtPath(extensionPath);
+    if (report.valid) {
+        console.log("Extension is valid.");
+    }
+    else {
+        console.error("Extension validation failed:");
+        for (const issue of report.issues) {
+            console.error(`  - ${issue}`);
+        }
+        dntShim.Deno.exit(1);
+    }
+}

package/esm/cli/commands/generate/integration-generator-helpers.d.ts

@@ -0,0 +1,35 @@
+export type TokenAuthMethod = "basic" | "body" | "client_secret_basic" | "client_secret_post" | "request_body";
+export interface IntegrationGeneratorOptionsLike {
+    name?: string;
+    displayName?: string;
+    authType?: "oauth2" | "api-key";
+    apiBaseUrl?: string;
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    scopes?: string;
+    tokenAuthMethod?: TokenAuthMethod;
+    additionalAuthParams?: string;
+    usePKCE?: boolean;
+}
+export interface IntegrationConfig {
+    name: string;
+    displayName: string;
+    authType: "oauth2" | "api-key";
+    apiBaseUrl: string;
+    authorizationUrl?: string;
+    tokenUrl?: string;
+    scopes: string[];
+    tokenAuthMethod: TokenAuthMethod;
+    additionalAuthParams: Record<string, string>;
+    usePKCE: boolean;
+    envVarPrefix: string;
+}
+export declare function parseScopes(scopes?: string): string[];
+export declare function parseAdditionalAuthParams(params?: string): Record<string, string>;
+export declare function normalizeTokenAuthMethod(method?: string): TokenAuthMethod;
+export declare function parseBooleanOption(value: string | boolean | undefined, defaultValue?: boolean): boolean;
+export declare function validateIntegrationName(name: string): void;
+export declare function getNonInteractiveConfig(options: IntegrationGeneratorOptionsLike): IntegrationConfig;
+export declare function getToolInputSchema(toolFile: string): string;
+export declare function getToolExecuteBody(toolFile: string): string;
+//# sourceMappingURL=integration-generator-helpers.d.ts.map

package/esm/cli/commands/generate/integration-generator-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-generator-helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/integration-generator-helpers.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,MAAM,GACN,qBAAqB,GACrB,oBAAoB,GACpB,cAAc,CAAC;AAEnB,MAAM,WAAW,+BAA+B;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,eAAe,CAmBzE;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,EACnC,YAAY,UAAQ,GACnB,OAAO,CAkBT;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAI1D;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,+BAA+B,GACvC,iBAAiB,CAwBnB;AAmCD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/esm/cli/commands/generate/integration-generator-helpers.js

@@ -0,0 +1,123 @@
+export function parseScopes(scopes) {
+    return scopes?.split(",").map((scope) => scope.trim()) || [];
+}
+export function parseAdditionalAuthParams(params) {
+    if (!params?.trim())
+        return {};
+    return Object.fromEntries(params.split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .map((entry) => {
+        const separatorIndex = entry.indexOf("=");
+        if (separatorIndex === -1) {
+            throw new Error("Additional auth params must use key=value pairs separated by commas");
+        }
+        const key = entry.slice(0, separatorIndex).trim();
+        const value = entry.slice(separatorIndex + 1).trim();
+        if (!key || !value) {
+            throw new Error("Additional auth params must use non-empty key=value pairs");
+        }
+        return [key, value];
+    }));
+}
+export function normalizeTokenAuthMethod(method) {
+    switch (method?.trim().toLowerCase()) {
+        case "basic":
+            return "basic";
+        case "body":
+            return "body";
+        case "client_secret_basic":
+            return "client_secret_basic";
+        case "client_secret_post":
+            return "client_secret_post";
+        case "request_body":
+        case undefined:
+        case "":
+            return "request_body";
+        default:
+            throw new Error("OAuth token auth method must be one of: request_body, body, basic, client_secret_basic, client_secret_post");
+    }
+}
+export function parseBooleanOption(value, defaultValue = false) {
+    if (typeof value === "boolean")
+        return value;
+    if (!value?.trim())
+        return defaultValue;
+    switch (value.trim().toLowerCase()) {
+        case "y":
+        case "yes":
+        case "true":
+        case "1":
+            return true;
+        case "n":
+        case "no":
+        case "false":
+        case "0":
+            return false;
+        default:
+            throw new Error("Boolean option must be yes/no, true/false, or 1/0");
+    }
+}
+export function validateIntegrationName(name) {
+    if (!name || !/^[a-z][a-z0-9-]*$/.test(name)) {
+        throw new Error("Integration name must be lowercase letters, numbers, and hyphens");
+    }
+}
+export function getNonInteractiveConfig(options) {
+    const { name, displayName, authType } = options;
+    if (!name || !displayName || !authType) {
+        throw new Error("Non-interactive mode requires --name, --display-name, and --auth-type options");
+    }
+    const normalizedName = name.toLowerCase();
+    return {
+        name: normalizedName,
+        displayName,
+        authType,
+        apiBaseUrl: options.apiBaseUrl ?? `https://api.${name}.com`,
+        authorizationUrl: options.authorizationUrl,
+        tokenUrl: options.tokenUrl,
+        scopes: parseScopes(options.scopes),
+        tokenAuthMethod: normalizeTokenAuthMethod(options.tokenAuthMethod),
+        additionalAuthParams: parseAdditionalAuthParams(options.additionalAuthParams),
+        usePKCE: parseBooleanOption(options.usePKCE, false),
+        envVarPrefix: name.toUpperCase().replace(/-/g, "_"),
+    };
+}
+const TOOL_FILE_CONTENTS = {
+    "list-items.ts": {
+        inputSchema: `limit: z.number().optional().describe("Maximum number of items to return"),
+    offset: z.number().optional().describe("Number of items to skip"),`,
+        executeBody: `const items = await listItems({
+        limit: input.limit,
+        offset: input.offset,
+      });
+      return {
+        success: true,
+        items,
+        count: items.length,
+      };`,
+    },
+    "get-item.ts": {
+        inputSchema: `id: z.string().describe("The ID of the item to retrieve"),`,
+        executeBody: `const item = await getItem(input.id);
+      return {
+        success: true,
+        item,
+      };`,
+    },
+    "search.ts": {
+        inputSchema: `query: z.string().describe("Search query"),`,
+        executeBody: `const results = await searchItems(input.query);
+      return {
+        success: true,
+        results,
+        count: results.length,
+      };`,
+    },
+};
+export function getToolInputSchema(toolFile) {
+    return TOOL_FILE_CONTENTS[toolFile]?.inputSchema ?? "";
+}
+export function getToolExecuteBody(toolFile) {
+    return TOOL_FILE_CONTENTS[toolFile]?.executeBody ?? "";
+}

package/esm/cli/commands/generate/integration-generator.d.ts

@@ -4,6 +4,7 @@
  * Generates new service integration scaffolds with interactive prompts.
  * Creates connector.json, API client, OAuth routes, token store, and tool skeletons.
  */
+import { type TokenAuthMethod } from "./integration-generator-helpers.js";
 export interface IntegrationGeneratorOptions {
     /** Integration name (lowercase, e.g., "twilio") */
     name?: string;
@@ -28,7 +29,5 @@ export interface IntegrationGeneratorOptions {
     /** Skip interactive prompts */
     skipPrompts?: boolean;
 }
-type TokenAuthMethod = "basic" | "body" | "client_secret_basic" | "client_secret_post" | "request_body";
 export declare function generateIntegration(projectDir: string, options?: IntegrationGeneratorOptions): Promise<void>;
-export {};
 //# sourceMappingURL=integration-generator.d.ts.map

package/esm/cli/commands/generate/integration-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integration-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/integration-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,KAAK,eAAe,GAChB,OAAO,GACP,MAAM,GACN,qBAAqB,GACrB,oBAAoB,GACpB,cAAc,CAAC;AA2GnB,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,IAAI,CAAC,CAwBf"}
+{"version":3,"file":"integration-generator.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate/integration-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,EASL,KAAK,eAAe,EAErB,MAAM,oCAAoC,CAAC;AAK5C,MAAM,WAAW,2BAA2B;IAC1C,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,mBAAmB;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAaD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,IAAI,CAAC,CAwBf"}

package/esm/cli/commands/generate/integration-generator.js

@@ -11,6 +11,7 @@ import { createFileSystem } from "../../../src/platform/index.js";
 import { ensureDir } from "../../utils/fs.js";
 import { isInteractive as checkIsInteractive, promptSync } from "../../../src/platform/index.js";
 import { isCiEnv, isDenoTestingEnv } from "../../../src/config/index.js";
+import { getNonInteractiveConfig, getToolExecuteBody, getToolInputSchema, normalizeTokenAuthMethod, parseAdditionalAuthParams, parseBooleanOption, parseScopes, validateIntegrationName, } from "./integration-generator-helpers.js";
 import { select } from "../../utils/terminal-select.js";
 let fs;
 function canRunPrompts() {
@@ -22,71 +23,6 @@ function promptText(question, defaultValue) {
     const input = promptSync(fullQuestion);
     return Promise.resolve(input?.trim() || defaultValue || "");
 }
-function parseScopes(scopes) {
-    return scopes?.split(",").map((s) => s.trim()) || [];
-}
-function parseAdditionalAuthParams(params) {
-    if (!params?.trim())
-        return {};
-    return Object.fromEntries(params.split(",")
-        .map((entry) => entry.trim())
-        .filter(Boolean)
-        .map((entry) => {
-        const separatorIndex = entry.indexOf("=");
-        if (separatorIndex === -1) {
-            throw new Error("Additional auth params must use key=value pairs separated by commas");
-        }
-        const key = entry.slice(0, separatorIndex).trim();
-        const value = entry.slice(separatorIndex + 1).trim();
-        if (!key || !value) {
-            throw new Error("Additional auth params must use non-empty key=value pairs");
-        }
-        return [key, value];
-    }));
-}
-function normalizeTokenAuthMethod(method) {
-    switch (method?.trim().toLowerCase()) {
-        case "basic":
-            return "basic";
-        case "body":
-            return "body";
-        case "client_secret_basic":
-            return "client_secret_basic";
-        case "client_secret_post":
-            return "client_secret_post";
-        case "request_body":
-        case undefined:
-        case "":
-            return "request_body";
-        default:
-            throw new Error("OAuth token auth method must be one of: request_body, body, basic, client_secret_basic, client_secret_post");
-    }
-}
-function parseBooleanOption(value, defaultValue = false) {
-    if (typeof value === "boolean")
-        return value;
-    if (!value?.trim())
-        return defaultValue;
-    switch (value.trim().toLowerCase()) {
-        case "y":
-        case "yes":
-        case "true":
-        case "1":
-            return true;
-        case "n":
-        case "no":
-        case "false":
-        case "0":
-            return false;
-        default:
-            throw new Error("Boolean option must be yes/no, true/false, or 1/0");
-    }
-}
-function validateIntegrationName(name) {
-    if (!name || !/^[a-z][a-z0-9-]*$/.test(name)) {
-        throw new Error("Integration name must be lowercase letters, numbers, and hyphens");
-    }
-}
 export async function generateIntegration(projectDir, options = {}) {
     fs = createFileSystem();
     const shouldPrompt = !options.skipPrompts && canRunPrompts();
@@ -109,26 +45,6 @@ export async function generateIntegration(projectDir, options = {}) {
     console.log(`  4. Customize the generated tools in ai/integrations/${config.name}/tools/`);
     console.log("");
 }
-function getNonInteractiveConfig(options) {
-    const { name, displayName, authType } = options;
-    if (!name || !displayName || !authType) {
-        throw new Error("Non-interactive mode requires --name, --display-name, and --auth-type options");
-    }
-    const normalizedName = name.toLowerCase();
-    return {
-        name: normalizedName,
-        displayName,
-        authType,
-        apiBaseUrl: options.apiBaseUrl ?? `https://api.${name}.com`,
-        authorizationUrl: options.authorizationUrl,
-        tokenUrl: options.tokenUrl,
-        scopes: parseScopes(options.scopes),
-        tokenAuthMethod: normalizeTokenAuthMethod(options.tokenAuthMethod),
-        additionalAuthParams: parseAdditionalAuthParams(options.additionalAuthParams),
-        usePKCE: parseBooleanOption(options.usePKCE, false),
-        envVarPrefix: name.toUpperCase().replace(/-/g, "_"),
-    };
-}
 async function getInteractiveConfig(options) {
     console.log("");
     console.log(green("Integration Generator"));
@@ -666,44 +582,6 @@ export async function searchItems(query: string): Promise<unknown[]> {
     await fs.writeTextFile(join(baseDir, "lib", `${config.name}-client.ts`), client);
     cliLogger.debug("Created API client");
 }
-function getToolInputSchema(toolFile) {
-    return TOOL_FILE_CONTENTS[toolFile]?.inputSchema ?? "";
-}
-function getToolExecuteBody(toolFile) {
-    return TOOL_FILE_CONTENTS[toolFile]?.executeBody ?? "";
-}
-const TOOL_FILE_CONTENTS = {
-    "list-items.ts": {
-        inputSchema: `limit: z.number().optional().describe("Maximum number of items to return"),
-    offset: z.number().optional().describe("Number of items to skip"),`,
-        executeBody: `const items = await listItems({
-        limit: input.limit,
-        offset: input.offset,
-      });
-      return {
-        success: true,
-        items,
-        count: items.length,
-      };`,
-    },
-    "get-item.ts": {
-        inputSchema: `id: z.string().describe("The ID of the item to retrieve"),`,
-        executeBody: `const item = await getItem(input.id);
-      return {
-        success: true,
-        item,
-      };`,
-    },
-    "search.ts": {
-        inputSchema: `query: z.string().describe("Search query"),`,
-        executeBody: `const results = await searchItems(input.query);
-      return {
-        success: true,
-        results,
-        count: results.length,
-      };`,
-    },
-};
 async function createToolSkeletons(baseDir, config) {
     const tools = [
         {