alchemy 0.62.2 → 0.63.0

package/src/ai/vue-file.ts

@@ -1,242 +0,0 @@
-import { generateText } from "ai";
-import type { Context } from "../context.ts";
-import { StaticVueFile } from "../fs/static-vue-file.ts";
-import { Resource } from "../resource.ts";
-import type { Secret } from "../secret.ts";
-import { type ModelConfig, createModel } from "./client.ts";
-
-/**
- * Properties for creating or updating a VueFile
- */
-export interface VueFileProps {
-  /**
-   * Path to the Vue file
-   */
-  path: string;
-
-  /**
-   * Base URL for the OpenAI API
-   * @default 'https://api.openai.com/v1'
-   */
-  baseURL?: string;
-
-  /**
-   * Prompt for generating content
-   * Use alchemy template literals to include file context:
-   * @example
-   * prompt: await alchemy`
-   *   Generate a Vue component using:
-   *   ${alchemy.file("src/api.ts")}
-   * `
-   */
-  prompt: string;
-
-  /**
-   * System prompt for the model
-   * This is used to provide instructions to the model about how to format the response
-   * The default system prompt instructs the model to return a single Vue component inside ```vue fences
-   * @default "You are a Vue component generator. Create a single Vue component based on the user's requirements. Your response MUST include only a single Vue component inside ```vue fences. Do not include any other text, explanations, or multiple code blocks."
-   */
-  system?: string;
-
-  /**
-   * OpenAI API key to use for generating content
-   * If not provided, will use OPENAI_API_KEY environment variable
-   */
-  apiKey?: Secret;
-
-  /**
-   * Model configuration
-   */
-  model?: ModelConfig;
-
-  /**
-   * Temperature for controlling randomness in generation.
-   * Higher values (e.g., 0.8) make output more random,
-   * lower values (e.g., 0.2) make it more deterministic.
-   * @default 0.7
-   */
-  temperature?: number;
-}
-
-/**
- * A Vue file that can be created, updated, and deleted
- */
-export interface VueFile extends VueFileProps, Resource<"ai::VueFile"> {
-  /**
-   * Content of the Vue file
-   */
-  content: string;
-
-  /**
-   * Time at which the file was created
-   */
-  createdAt: number;
-
-  /**
-   * Time at which the file was last updated
-   */
-  updatedAt: number;
-}
-
-/**
- * Default system prompt for Vue file generation
- */
-const DEFAULT_VUE_SYSTEM_PROMPT =
-  "You are a Vue component generator. Create a single Vue component based on the user's requirements. Your response MUST include only a single Vue component inside ```vue fences. Do not include any other text, explanations, or multiple code blocks.";
-
-/**
- * Resource for generating Vue files using AI models.
- * Extracts Vue code from between ```vue fences and validates the response.
- *
- * @example
- * // Create a simple Vue component
- * const button = await VueFile("button-component", {
- *   path: "./src/components/Button.vue",
- *   prompt: await alchemy`
- *     Generate a customizable button Vue component with:
- *     - Primary, secondary, and outline variants
- *     - Small, medium, and large sizes
- *     - Loading state with spinner
- *     - Disabled state
- *   `,
- *   model: {
- *     id: "gpt-4o",
- *     provider: "openai"
- *   }
- * });
- *
- * @example
- * // Generate a Vue component using existing files as reference
- * const userCard = await VueFile("user-card", {
- *   path: "./src/components/UserCard.vue",
- *   prompt: await alchemy`
- *     Create a UserCard Vue component that displays user information.
- *     Follow the styling patterns from:
- *     ${alchemy.file("src/components/Card.vue")}
- *
- *     Use the user type from:
- *     ${alchemy.file("src/types/User.ts")}
- *   `,
- *   temperature: 0.2
- * });
- *
- * @example
- * // Generate a complex form component with validation and custom system prompt
- * const form = await VueFile("registration-form", {
- *   path: "./src/components/RegistrationForm.vue",
- *   prompt: await alchemy`
- *     Generate a registration form Vue component with:
- *     - Email, password, and confirm password fields
- *     - Form validation using Vuelidate or similar
- *     - Error messages for each field
- *     - Submit handler that emits form data
- *
- *     Follow these style guidelines:
- *     ${alchemy.file("src/styles/guidelines.md")}
- *   `,
- *   system: "You are an expert Vue component creator specializing in form components with validation. Create a single Vue component inside ```vue fences with no additional text.",
- *   model: {
- *     id: "claude-3-opus-20240229",
- *     provider: "anthropic"
- *   }
- * });
- */
-export const VueFile = Resource(
-  "ai::VueFile",
-  async function (
-    this: Context<VueFile>,
-    _id: string,
-    props: VueFileProps,
-  ): Promise<VueFile> {
-    // Handle deletion phase
-    if (this.phase === "delete") {
-      return this.destroy();
-    }
-
-    // Use provided system prompt or default
-    const system = props.system || DEFAULT_VUE_SYSTEM_PROMPT;
-
-    // Generate initial content
-    const { text } = await generateText({
-      model: createModel(props),
-      prompt: props.prompt,
-      system,
-      providerOptions: props.model?.options,
-      ...(props.temperature === undefined
-        ? {}
-        : { temperature: props.temperature }),
-    });
-
-    // Extract and validate Vue code
-    let { code, error } = await extractVueCode(text);
-
-    // Re-prompt if there are validation errors
-    if (error) {
-      const errorSystem = `${system}\n\nERROR: ${error}\n\nPlease try again and ensure your response contains exactly one Vue component inside \`\`\`vue fences.`;
-
-      const { text: retryText } = await generateText({
-        model: createModel(props),
-        prompt: props.prompt,
-        system: errorSystem,
-        providerOptions: props.model?.options,
-        ...(props.temperature === undefined
-          ? {}
-          : { temperature: props.temperature }),
-      });
-
-      const retryResult = await extractVueCode(retryText);
-
-      if (retryResult.error) {
-        throw new Error(
-          `Failed to generate valid Vue code: ${retryResult.error}`,
-        );
-      }
-
-      code = retryResult.code;
-    }
-
-    // Use StaticVueFile to create/update the file
-    const file = await StaticVueFile("file", props.path, code);
-
-    // Return the resource
-    return this({
-      ...props,
-      content: file.content,
-      createdAt: Date.now(),
-      updatedAt: Date.now(),
-    });
-  },
-);
-
-/**
- * Extracts Vue code from between ```vue fences
- * Validates that exactly one Vue code block exists
- *
- * @param text The text to extract Vue code from
- * @returns The extracted Vue code or error message
- */
-async function extractVueCode(
-  text: string,
-): Promise<{ code: string; error?: string }> {
-  const vueCodeRegex = /```vue\s*([\s\S]*?)```/g;
-  const matches = Array.from(text.matchAll(vueCodeRegex));
-
-  if (matches.length === 0) {
-    return {
-      code: "",
-      error:
-        "No Vue code block found in the response. Please include your code within ```vue fences.",
-    };
-  }
-
-  if (matches.length > 1) {
-    return {
-      code: "",
-      error:
-        "Multiple Vue code blocks found in the response. Please provide exactly one code block within ```vue fences.",
-    };
-  }
-
-  return { code: matches[0][1].trim() };
-}

package/src/ai/yaml-file.ts

@@ -1,328 +0,0 @@
-import { generateObject, generateText } from "ai";
-import type { JsonSchema, Type, type } from "arktype";
-import type { Context } from "../context.ts";
-import { StaticYamlFile } from "../fs/static-yaml-file.ts";
-import { Resource } from "../resource.ts";
-import type { Secret } from "../secret.ts";
-import { ark } from "./ark.ts";
-import { type ModelConfig, createModel } from "./client.ts";
-
-/**
- * Properties for creating or updating a YAMLFile
- */
-export interface YAMLFileProps<
-  T extends Type<any, any> | undefined = undefined,
-> {
-  /**
-   * Path to the YAML file
-   */
-  path: string;
-
-  /**
-   * Optional ArkType schema to validate and structure the generated YAML
-   * When provided, the resource will use generateObject with schema validation
-   * When not provided, it will extract YAML from between ```yaml fences
-   */
-  schema?: T;
-
-  /**
-   * Base URL for the OpenAI API
-   * @default 'https://api.openai.com/v1'
-   */
-  baseURL?: string;
-
-  /**
-   * Prompt for generating content
-   * Use alchemy template literals to include file context:
-   * @example
-   * prompt: await alchemy`
-   *   Generate a YAML configuration for:
-   *   ${alchemy.file("src/serverless.js")}
-   * `
-   */
-  prompt: string;
-
-  /**
-   * System prompt for the model
-   * This is used to provide instructions to the model about how to format the response
-   * @default Depends on whether schema is provided
-   */
-  system?: string;
-
-  /**
-   * OpenAI API key to use for generating content
-   * If not provided, will use OPENAI_API_KEY environment variable
-   */
-  apiKey?: Secret;
-
-  /**
-   * Model configuration
-   */
-  model?: ModelConfig;
-
-  /**
-   * Temperature for controlling randomness in generation.
-   * Higher values (e.g., 0.8) make output more random,
-   * lower values (e.g., 0.2) make it more deterministic.
-   * @default 0.7
-   */
-  temperature?: number;
-}
-
-/**
- * A YAML file that can be created, updated, and deleted
- */
-export interface YAMLFile<T = any>
-  extends Omit<YAMLFileProps, "schema">,
-    Resource<"ai::YAMLFile"> {
-  /**
-   * Content of the YAML file as a string
-   */
-  content: string;
-
-  /**
-   * Parsed YAML object
-   */
-  yaml: T;
-
-  /**
-   * Schema used to validate the YAML (if provided)
-   */
-  schema?: JsonSchema;
-
-  /**
-   * Time at which the file was created
-   */
-  createdAt: number;
-
-  /**
-   * Time at which the file was last updated
-   */
-  updatedAt: number;
-}
-
-/**
- * Default system prompt for YAML file generation without schema
- */
-const DEFAULT_YAML_SYSTEM_PROMPT =
-  "You are a YAML generator. Create valid YAML based on the user's requirements. Your response MUST include only YAML inside ```yaml fences. Do not include any other text, explanations, or multiple code blocks. Use standard YAML syntax with proper indentation. Use quotes around strings that contain special characters when necessary.";
-
-/**
- * Resource for generating YAML files using AI models.
- * Can operate in two modes:
- * 1. With schema: Uses generateObject with type validation, then converts to YAML
- * 2. Without schema: Extracts YAML from between ```yaml fences
- *
- * @example
- * // Generate a serverless configuration file
- * const serverlessConfig = await YAMLFile("serverless-config", {
- *   path: "./serverless.yml",
- *   prompt: await alchemy`
- *     Generate a serverless.yml configuration for an AWS Lambda API with:
- *     - A service name "user-api"
- *     - Node.js 16.x runtime
- *     - Three functions: createUser, getUser, and listUsers
- *     - API Gateway endpoints for each function
- *     - DynamoDB table for users
- *     - IAM permissions for DynamoDB access
- *   `,
- *   model: {
- *     id: "gpt-4o",
- *     provider: "openai"
- *   }
- * });
- *
- * @example
- * // Generate YAML with schema validation
- * import { type } from "arktype";
- *
- * const k8sConfigSchema = type({
- *   apiVersion: "string",
- *   kind: "string",
- *   metadata: {
- *     name: "string",
- *     namespace: "string?",
- *     labels: "Record<string, string>?"
- *   },
- *   spec: {
- *     replicas: "number",
- *     selector: {
- *       matchLabels: "Record<string, string>"
- *     },
- *     template: {
- *       metadata: {
- *         labels: "Record<string, string>"
- *       },
- *       spec: {
- *         containers: [{
- *           name: "string",
- *           image: "string",
- *           ports: [{
- *             containerPort: "number"
- *           }]
- *         }]
- *       }
- *     }
- *   }
- * });
- *
- * const deployment = await YAMLFile("k8s-deployment", {
- *   path: "./kubernetes/deployment.yaml",
- *   schema: k8sConfigSchema,
- *   prompt: "Generate a Kubernetes deployment for a web application named 'frontend' with 3 replicas using the nginx:latest image and exposing port 80",
- *   temperature: 0.2
- * });
- *
- * @example
- * // Generate GitHub Actions workflow with custom system prompt
- * const workflow = await YAMLFile("github-workflow", {
- *   path: "./.github/workflows/ci.yml",
- *   prompt: await alchemy`
- *     Create a GitHub Actions workflow for a Node.js project that:
- *     - Runs on push to main and pull requests
- *     - Sets up Node.js 18
- *     - Installs dependencies with npm
- *     - Runs linting and tests
- *     - Builds the project
- *     - Deploys to GitHub Pages on success (main branch only)
- *   `,
- *   system: "You are a DevOps expert specializing in GitHub Actions workflows. Create a single YAML file inside ```yaml fences with no additional text. Follow GitHub Actions best practices and use proper YAML syntax.",
- *   model: {
- *     id: "claude-3-opus-20240229",
- *     provider: "anthropic"
- *   }
- * });
- */
-export const YAMLFile = Resource("ai::YAMLFile", async function <
-  const T extends Type<any, any> | undefined = undefined,
->(this: Context<YAMLFile<T extends Type<any, any> ? type.infer<T> : any>>, _id: string, props: YAMLFileProps<T>): Promise<
-  YAMLFile<T extends Type<any, any> ? type.infer<T> : any>
-> {
-  // Handle deletion phase
-  if (this.phase === "delete") {
-    return this.destroy();
-  }
-
-  let yamlContent: string;
-  let yamlObject: any;
-
-  // Check if schema is provided
-  if (props.schema) {
-    // Use schema-based generation
-    const { object } = await generateObject({
-      model: createModel(props),
-      schema: ark.schema<type.infer<typeof props.schema>>(props.schema),
-      providerOptions: props.model?.options,
-      system:
-        props.system ||
-        "Generate a valid object based on the provided requirements.",
-      prompt: props.prompt,
-      ...(props.temperature === undefined
-        ? {}
-        : { temperature: props.temperature }),
-    });
-
-    yamlObject = object;
-
-    // Let StaticYamlFile handle the YAML conversion
-    const file = await StaticYamlFile("file", props.path, yamlObject);
-    yamlContent = file.content;
-  } else {
-    // Use fence-based extraction
-    // Use provided system prompt or default
-    const system = props.system || DEFAULT_YAML_SYSTEM_PROMPT;
-
-    // Generate initial content
-    const { text } = await generateText({
-      model: createModel(props),
-      prompt: props.prompt,
-      system,
-      providerOptions: props.model?.options,
-      ...(props.temperature === undefined
-        ? {}
-        : { temperature: props.temperature }),
-    });
-
-    // Extract and validate YAML content
-    let { content, error } = await extractYAMLContent(text);
-
-    // Re-prompt if there are validation errors
-    if (error) {
-      const errorSystem = `${system}\n\nERROR: ${error}\n\nPlease try again and ensure your response contains exactly one YAML block inside \`\`\`yaml fences.`;
-
-      const { text: retryText } = await generateText({
-        model: createModel(props),
-        prompt: props.prompt,
-        system: errorSystem,
-        providerOptions: props.model?.options,
-        ...(props.temperature === undefined
-          ? {}
-          : { temperature: props.temperature }),
-      });
-
-      const retryResult = await extractYAMLContent(retryText);
-
-      if (retryResult.error) {
-        throw new Error(`Failed to generate valid YAML: ${retryResult.error}`);
-      }
-
-      content = retryResult.content;
-    }
-
-    yamlContent = content;
-
-    // Create the file with the string content
-    const _file = await StaticYamlFile("file", props.path, yamlContent);
-
-    // We need to parse the YAML to get the object representation
-    const yaml = await import("yaml");
-    yamlObject = yaml.parse(yamlContent);
-  }
-
-  // Return the resource
-  return this({
-    ...props,
-    schema: props.schema,
-    content: yamlContent,
-    yaml: yamlObject,
-    createdAt: Date.now(),
-    updatedAt: Date.now(),
-  });
-});
-
-/**
- * Extracts YAML content from between ```yaml fences
- * Validates that exactly one YAML code block exists
- *
- * @param text The text to extract YAML from
- * @returns The extracted YAML or error message
- */
-async function extractYAMLContent(
-  text: string,
-): Promise<{ content: string; error?: string }> {
-  // Check for yaml or yml fence blocks
-  const yamlCodeRegex = /```(yaml|yml)\s*([\s\S]*?)```/g;
-  const matches = Array.from(text.matchAll(yamlCodeRegex));
-
-  if (matches.length === 0) {
-    return {
-      content: "",
-      error:
-        "No YAML code block found in the response. Please include your YAML within ```yaml fences.",
-    };
-  }
-
-  if (matches.length > 1) {
-    return {
-      content: "",
-      error:
-        "Multiple YAML code blocks found in the response. Please provide exactly one YAML block within ```yaml fences.",
-    };
-  }
-
-  const content = matches[0][2].trim();
-
-  // We don't validate YAML parsing here because js-yaml might not be available
-  // Validation will happen at usage time if needed
-  return { content };
-}

package/src/fs/static-astro-file.ts

@@ -1,45 +0,0 @@
-import { File } from "./file.ts";
-
-export type StaticAstroFile = File;
-
-/**
- * Creates a static Astro component file
- *
- * @example
- * // Create an Astro component file with content
- * const header = await StaticAstroFile("Header.astro",
- *   `---
- *   import Logo from '../components/Logo.astro';
- *   const navItems = ['Home', 'About', 'Contact'];
- *   ---
- *
- *   <header class="header">
- *     <Logo />
- *     <nav>
- *       <ul>
- *         {navItems.map(item => (
- *           <li><a href={`/${item.toLowerCase()}`}>{item}</a></li>
- *         ))}
- *       </ul>
- *     </nav>
- *   </header>
- *
- *   <style>
- *     .header {
- *       display: flex;
- *       justify-content: space-between;
- *       padding: 1rem;
- *     }
- *   </style>`
- * );
- */
-export function StaticAstroFile(
-  id: string,
-  ...args: [content: string] | [path: string, content: string]
-): Promise<StaticAstroFile> {
-  const [path, content] = args.length === 1 ? [id, args[0]] : args;
-  return File(id, {
-    path,
-    content,
-  });
-}

package/src/fs/static-css-file.ts

@@ -1,35 +0,0 @@
-import { File } from "./file.ts";
-
-export type StaticCSSFile = File;
-
-/**
- * Creates a static CSS file
- *
- * @example
- * // Create a CSS file with styles
- * const styles = await StaticCSSFile("styles.css",
- *   `.container {
- *     max-width: 1200px;
- *     margin: 0 auto;
- *     padding: 0 1rem;
- *   }
- *
- *   .button {
- *     background-color: #0062ff;
- *     color: white;
- *     border: none;
- *     padding: 0.5rem 1rem;
- *     border-radius: 4px;
- *   }`
- * );
- */
-export function StaticCSSFile(
-  id: string,
-  ...args: [content: string] | [path: string, content: string]
-): Promise<StaticCSSFile> {
-  const [path, content] = args.length === 1 ? [id, args[0]] : args;
-  return File(id, {
-    path,
-    content,
-  });
-}

package/src/fs/static-html-file.ts

@@ -1,42 +0,0 @@
-import { File } from "./file.ts";
-
-export type StaticHTMLFile = File;
-
-/**
- * Creates a static HTML file
- *
- * @example
- * // Create an HTML file with content
- * const page = await StaticHTMLFile("index.html",
- *   `<!DOCTYPE html>
- *   <html lang="en">
- *   <head>
- *     <meta charset="UTF-8">
- *     <meta name="viewport" content="width=device-width, initial-scale=1.0">
- *     <title>My Website</title>
- *     <link rel="stylesheet" href="styles.css">
- *   </head>
- *   <body>
- *     <header>
- *       <h1>Welcome to My Website</h1>
- *     </header>
- *     <main>
- *       <p>This is the main content of the page.</p>
- *     </main>
- *     <footer>
- *       <p>&copy; 2024 My Company</p>
- *     </footer>
- *   </body>
- *   </html>`
- * );
- */
-export function StaticHTMLFile(
-  id: string,
-  ...args: [content: string] | [path: string, content: string]
-): Promise<StaticHTMLFile> {
-  const [path, content] = args.length === 1 ? [id, args[0]] : args;
-  return File(id, {
-    path,
-    content,
-  });
-}