alchemy 0.62.2 → 0.63.0

package/src/ai/css-file.ts

@@ -1,247 +0,0 @@
-import { generateText } from "ai";
-import type { Context } from "../context.ts";
-import { StaticCSSFile } from "../fs/static-css-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 CSSFile
- */
-export interface CSSFileProps {
-  /**
-   * Path to the CSS 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 CSS styles for:
-   *   ${alchemy.file("src/components/Button.jsx")}
-   * `
-   */
-  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 CSS code inside ```css fences
-   * @default "You are a CSS code generator. Create CSS code based on the user's requirements. Your response MUST include only CSS code inside ```css 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 CSS file that can be created, updated, and deleted
- */
-export interface CSSFile extends CSSFileProps, Resource<"ai::CSSFile"> {
-  /**
-   * Content of the CSS 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 CSS file generation
- */
-const DEFAULT_CSS_SYSTEM_PROMPT =
-  "You are a CSS code generator. Create CSS code based on the user's requirements. Your response MUST include only CSS code inside ```css fences. Do not include any other text, explanations, or multiple code blocks.";
-
-/**
- * Resource for generating CSS files using AI models.
- * Extracts CSS code from between ```css fences and validates the response.
- *
- * @example
- * // Create styles for a website
- * const mainStyles = await CSSFile("main-styles", {
- *   path: "./public/css/main.css",
- *   prompt: await alchemy`
- *     Generate modern CSS styles for a company website with:
- *     - Clean, minimalist design
- *     - Primary color: #0062ff
- *     - Secondary color: #6c757d
- *     - Light gray background
- *     - Responsive layout for mobile, tablet, and desktop
- *     - Custom styles for buttons, cards, and navigation
- *   `,
- *   model: {
- *     id: "gpt-4o",
- *     provider: "openai"
- *   }
- * });
- *
- * @example
- * // Generate CSS based on existing HTML
- * const componentStyles = await CSSFile("component-styles", {
- *   path: "./src/styles/component.css",
- *   prompt: await alchemy`
- *     Create CSS styles for this HTML component:
- *     ${alchemy.file("src/components/Card.html")}
- *
- *     The styles should be:
- *     - Modern and clean
- *     - Include hover effects and transitions
- *     - Support both light and dark themes
- *     - Use CSS variables for colors and spacing
- *   `,
- *   temperature: 0.2
- * });
- *
- * @example
- * // Generate CSS animation with custom system prompt
- * const animationStyles = await CSSFile("animations", {
- *   path: "./src/styles/animations.css",
- *   prompt: await alchemy`
- *     Create CSS animations for:
- *     - Fade in/out
- *     - Slide in from different directions
- *     - Pulse effect
- *     - Bounce effect
- *     - Scale in/out
- *     - Rotate
- *
- *     Each animation should be reusable via class names.
- *   `,
- *   system: "You are an expert CSS animator. Create a single CSS file inside ```css fences with no additional text. Use modern CSS animation techniques and include vendor prefixes where needed for browser compatibility.",
- *   model: {
- *     id: "claude-3-opus-20240229",
- *     provider: "anthropic"
- *   }
- * });
- */
-export const CSSFile = Resource(
-  "ai::CSSFile",
-  async function (
-    this: Context<CSSFile>,
-    _id: string,
-    props: CSSFileProps,
-  ): Promise<CSSFile> {
-    // Handle deletion phase
-    if (this.phase === "delete") {
-      return this.destroy();
-    }
-
-    // Use provided system prompt or default
-    const system = props.system || DEFAULT_CSS_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 CSS code
-    let { code, error } = await extractCSSCode(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 CSS code block inside \`\`\`css 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 extractCSSCode(retryText);
-
-      if (retryResult.error) {
-        throw new Error(
-          `Failed to generate valid CSS code: ${retryResult.error}\n${retryText}`,
-        );
-      }
-
-      code = retryResult.code;
-    }
-
-    // Use StaticCSSFile to create/update the file
-    const file = await StaticCSSFile("file", props.path, code);
-
-    // Return the resource
-    return this({
-      ...props,
-      content: file.content,
-      createdAt: Date.now(),
-      updatedAt: Date.now(),
-    });
-  },
-);
-
-/**
- * Extracts CSS code from between ```css fences
- * Validates that exactly one CSS code block exists
- *
- * @param text The text to extract CSS code from
- * @returns The extracted CSS code or error message
- */
-async function extractCSSCode(
-  text: string,
-): Promise<{ code: string; error?: string }> {
-  const cssCodeRegex = /```css\s*([\s\S]*?)```/g;
-  const matches = Array.from(text.matchAll(cssCodeRegex));
-
-  if (matches.length === 0) {
-    return {
-      code: "",
-      error:
-        "No CSS code block found in the response. Please include your code within ```css fences.",
-    };
-  }
-
-  if (matches.length > 1) {
-    return {
-      code: "",
-      error:
-        "Multiple CSS code blocks found in the response. Please provide exactly one code block within ```css fences.",
-    };
-  }
-
-  return { code: matches[0][1].trim() };
-}

package/src/ai/data.ts

@@ -1,221 +0,0 @@
-import { generateObject, type CoreMessage } from "ai";
-import type { JsonSchema, Type, type } from "arktype";
-import type { Context } from "../context.ts";
-import { Resource } from "../resource.ts";
-import type { Secret } from "../secret.ts";
-import { ark } from "./ark.ts";
-import { createModel, type ModelConfig } from "./client.ts";
-
-/**
- * Properties for creating or updating an AI Object
- */
-export interface DataProps<T extends Type<any, any>> {
-  /**
-   * The ArkType schema to validate and structure the generated content
-   */
-  schema: T | JsonSchema;
-
-  /**
-   * Prompt for generating the content
-   * Use alchemy template literals to include file context:
-   * @example
-   * prompt: await alchemy`
-   *   Generate a description for:
-   *   ${alchemy.file("src/data.ts")}
-   * `
-   */
-  prompt?: string;
-
-  /**
-   * Message history for the conversation
-   * If provided, this will be used instead of the prompt
-   */
-  messages?: CoreMessage[];
-
-  /**
-   * System prompt to guide the AI's behavior
-   * @example
-   * system: "You are a technical writer tasked with describing code"
-   */
-  system?: string;
-
-  /**
-   * 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;
-
-  /**
-   * Base URL for the OpenAI API
-   * @default 'https://api.openai.com/v1'
-   */
-  baseURL?: 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;
-
-  /**
-   * Whether to freeze the generated object
-   * @default false
-   */
-  freeze?: boolean;
-}
-
-/**
- * A resource that uses AI to generate structured content based on a schema
- */
-export interface Data<T> extends Resource<"ai::Object"> {
-  type: JsonSchema;
-
-  /**
-   * The generated content, typed according to the provided schema
-   */
-  object: T;
-
-  /**
-   * Updated message history with the AI's response appended
-   */
-  messages: CoreMessage[];
-
-  /**
-   * Time at which the content was generated
-   */
-  createdAt: number;
-}
-
-/**
- * Resource for generating structured content using the Vercel AI SDK.
- * Supports powerful context handling through the alchemy template literal tag.
- *
- * @example
- * // Generate a product description with specific fields
- * const productSchema = type({
- *   name: "string",
- *   description: "string",
- *   features: "string[]",
- *   price: "number"
- * });
- *
- * const product = await Data("new-product", {
- *   schema: productSchema,
- *   prompt: "Generate a product description for a new smartphone",
- *   system: "You are a product copywriter specializing in tech products",
- *   model: {
- *     id: "gpt-4o",
- *     provider: "openai",
- *     options: {
- *       temperature: 0.7
- *     }
- *   }
- * });
- *
- * console.log(product.object); // Typed as per schema
- *
- * @example
- * // Generate code documentation with context
- * const docSchema = type({
- *   summary: "string",
- *   parameters: {
- *     name: "string",
- *     type: "string",
- *     description: "string"
- *   }[],
- *   returns: "string"
- * });
- *
- * const docs = await Data("function-docs", {
- *   schema: docSchema,
- *   prompt: await alchemy`
- *     Generate documentation for this function:
- *     ${alchemy.file("src/utils/format.ts")}
- *   `,
- *   system: "You are a technical documentation writer",
- *   temperature: 0.2
- * });
- *
- * @example
- * // Using message history for iterative generation
- * const feedbackSchema = type({
- *   rating: "number",
- *   positives: "string[]",
- *   improvements: "string[]",
- *   summary: "string"
- * });
- *
- * const feedback = await Data("product-feedback", {
- *   schema: feedbackSchema,
- *   messages: [
- *     { role: "user", content: "I'd like feedback on my product design" },
- *     { role: "assistant", content: "I'd be happy to provide feedback. What's your product?" },
- *     { role: "user", content: "It's a new smart home device that..." }
- *   ],
- *   system: "You are a product design expert providing structured feedback",
- *   temperature: 0.3
- * });
- */
-export const Data = Resource("ai::Object", async function <
-  const T extends Type<any, any>,
->(this: Context<Data<any>>, _id: string, props: DataProps<T>): Promise<
-  Data<type.infer<T>>
-> {
-  if (this.phase === "delete") {
-    return this.destroy();
-  }
-
-  // Validate that either prompt or messages is provided
-  if (!props.prompt && !props.messages) {
-    throw new Error("Either prompt or messages must be provided");
-  }
-
-  if (this.phase === "update" && props.freeze) {
-    return this(this.output);
-  }
-
-  // Create messages array if only prompt is provided
-  const messages = props.messages || [{ role: "user", content: props.prompt! }];
-
-  // Generate structured output using generateObject
-  const { object } = await generateObject({
-    model: createModel(props),
-    // Convert ArkType schema to Zod schema for generateObject
-    // This is needed because generateObject expects a Zod schema
-    schema: ark.schema<type.infer<T>>(props.schema),
-    providerOptions: props.model?.options,
-    system:
-      props.system ||
-      "You are an AI assistant tasked with generating structured content.",
-    messages,
-    ...(props.temperature === undefined
-      ? {}
-      : // some models error if you provide it (rather than ignoring it)
-        { temperature: props.temperature }),
-  });
-
-  // Create updated message history with the structured response
-  const responseText = JSON.stringify(object);
-  const updatedMessages = [
-    ...messages,
-    {
-      role: "assistant" as const,
-      content: responseText,
-    },
-  ];
-
-  // Return the resource with typed content and updated messages
-  return this({
-    type: props.schema,
-    object: object,
-    messages: updatedMessages,
-    createdAt: Date.now(),
-  });
-});