@goharvest/simforge 0.1.0 → 0.2.0

package/README.md

@@ -2,6 +2,84 @@
 
 Simforge client for provider-based API calls.
 
+## Monorepo Setup
+
+This package is part of a **pnpm workspace** monorepo. The workspace structure separates concerns:
+
+- **Root `package.json`**: Contains only shared dev dependencies (Biome, TypeScript, Vitest, Knip, Madge)
+- **Package `package.json`**: Contains runtime dependencies specific to this package
+- You can run tests and validation from the root directory: `pnpm test` or `pnpm validate`
+- No need to manually update shared dev tooling versions across packages
+
+### Installing Dependencies
+
+Always install dependencies from the **root directory**:
+
+```bash
+# From the root directory
+pnpm install
+```
+
+### Updating pnpm
+
+To update pnpm across the monorepo:
+
+```bash
+# From the root directory
+pnpm pnpm:update
+```
+
+This automatically updates pnpm and syncs the version in `package.json` and CI/CD workflows.
+
+### Running Commands
+
+You can run commands from this directory or from the root:
+
+```bash
+# From this directory
+pnpm test
+pnpm build
+pnpm validate
+
+# From the root directory (runs across all packages)
+pnpm test          # Run all tests
+pnpm validate      # Run lint + tsc + test
+```
+
+### Available Development Tools
+
+This package includes the following shared development tools:
+
+| Tool | Purpose | Command |
+|------|---------|---------|
+| **Vitest** | Unit testing with coverage | `pnpm test` |
+| **Biome** | Fast linting & formatting | `pnpm lint` |
+| **TypeScript** | Type checking | `pnpm tsc` |
+| **Knip** | Find unused dependencies/exports | `pnpm knip` |
+| **Madge** | Detect circular dependencies | `pnpm madge` |
+
+**Run individual tools:**
+
+```bash
+# Run tests with coverage
+pnpm test
+
+# Lint and format code
+pnpm lint
+
+# Type check without building
+pnpm tsc
+
+# Find unused dependencies
+pnpm knip
+
+# Check for circular dependencies
+pnpm madge
+
+# Run all validation checks
+pnpm validate
+```
+
 ## Installation
 
 ```bash
@@ -16,7 +94,6 @@ yarn add @goharvest/simforge
 
 ```bash
 cd simforge-typescript-sdk
-pnpm install
 pnpm build
 ```
 
@@ -39,12 +116,36 @@ pnpm add @harvest/simforge
 
 ## Usage
 
+### Basic Usage (Local Execution)
+
+By default, the SDK executes BAML functions **locally on the client** by fetching the BAML prompt from the server and running it with your own API keys:
+
 ```typescript
 import { Simforge } from "@goharvest/simforge";
 
 const client = new Simforge({
   apiKey: "sf_your_api_key_here", // Required: Your Simforge API key
-  serviceUrl: "https://your-simforge-instance.com", // Optional, can use SIMFORGE_URL env var
+  serviceUrl: "https://simforge.goharvest.ai", // Optional
+  envVars: {
+    OPENAI_API_KEY: process.env.OPENAI_API_KEY, // Your LLM provider API keys
+  },
+  executeLocally: true, // Default: true
+});
+
+const result = await client.call("method_name", {
+  arg1: "value1",
+  arg2: "value2",
+});
+```
+
+### Server-Side Execution
+
+If you prefer to execute BAML on the server (using the server's API keys), set `executeLocally: false`:
+
+```typescript
+const client = new Simforge({
+  apiKey: "sf_your_api_key_here",
+  executeLocally: false, // Execute on server instead of locally
 });
 
 const result = await client.call("method_name", {
@@ -94,15 +195,80 @@ try {
 
 ## Configuration
 
-| Option       | Required | Description                                                                                     |
-| ------------ | -------- | ----------------------------------------------------------------------------------------------- |
-| `apiKey`     | Yes      | Your Simforge API key (generate from your Simforge dashboard)                                   |
-| `serviceUrl` | No       | The base URL for the Simforge API. Can also be set via the `SIMFORGE_URL` environment variable. |
-| `timeout`    | No       | Request timeout in milliseconds (default: 120000)                                               |
+| Option           | Required | Description                                                                                                                      |
+| ---------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| `apiKey`         | Yes      | Your Simforge API key (generate from your Simforge dashboard)                                                                    |
+| `serviceUrl`     | No       | The base URL for the Simforge API (default: https://simforge.goharvest.ai)                                                      |
+| `timeout`        | No       | Request timeout in milliseconds (default: 120000)                                                                                |
+| `envVars`        | No       | Environment variables for LLM provider API keys (e.g., `{ OPENAI_API_KEY: "..." }`). Required for local execution.              |
+| `executeLocally` | No       | Whether to execute BAML locally on the client (default: true). Set to false to execute on the server with the server's API keys. |
+
+## Execution Modes
+
+### Local Execution (Default)
+
+When `executeLocally: true` (default), the SDK:
+
+1. Fetches the BAML function definition from the Simforge server
+2. Executes the BAML locally using the `@boundaryml/baml` runtime
+3. Uses your own LLM provider API keys (passed via `envVars`)
+4. Returns the result directly to you
+
+**Benefits:**
+
+- Full control over API keys and costs
+- Lower latency (no server round-trip for execution)
+- Privacy: Your data doesn't go through the Simforge server
+
+**Requirements:**
+
+- You must provide LLM provider API keys via `envVars`
+- The BAML runtime runs in your environment (Node.js, browser with polyfills, etc.)
+
+### Server-Side Execution
+
+When `executeLocally: false`, the SDK:
+
+1. Sends the function name and inputs to the Simforge server
+2. The server executes the BAML using its own API keys
+3. Returns the result to you
+
+**Benefits:**
+
+- No need to manage LLM provider API keys
+- Simpler setup
+- Works in any environment
+
+**Requirements:**
+
+- The Simforge server must have the necessary API keys configured
 
 ## Environment Variables
 
 - `SIMFORGE_URL`: The base URL for the Simforge API (used if `serviceUrl` is not provided)
+- `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, etc.: LLM provider API keys (required for local execution)
+
+## Testing
+
+A test script is provided to verify both local and server-side execution:
+
+```bash
+# Set up environment variables
+export SIMFORGE_API_KEY="sf_your_api_key"
+export OPENAI_API_KEY="your_openai_key"
+
+# Run the test script
+pnpm tsx test-local-execution.ts [function-name] [query]
+
+# Example
+pnpm tsx test-local-execution.ts extract-entities "What is the capital of France?"
+```
+
+The test script will:
+
+1. Test local execution with your API keys
+2. Test server-side execution
+3. Compare results and performance
 
 ## Publishing
 

package/dist/baml.d.ts

@@ -0,0 +1,87 @@
+/**
+ * BAML execution utilities for the Simforge TypeScript SDK.
+ * This module provides functions to execute BAML prompts dynamically on the client side.
+ */
+/**
+ * Provider definition from the server.
+ */
+export interface ProviderDefinition {
+    provider: string;
+    apiKeyEnv: string;
+    models: Array<{
+        model: string;
+        description: string;
+    }>;
+}
+/**
+ * Model parameters extracted from the LLM request.
+ */
+export interface ModelParameters {
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    [key: string]: unknown;
+}
+/**
+ * Metadata extracted from BAML execution.
+ */
+export interface BamlExecutionMetadata {
+    /** The actual model/client used (e.g., "OpenAI_GPT4_1_mini") */
+    clientName: string | null;
+    /** The provider (e.g., "openai", "anthropic") */
+    provider: string | null;
+    /** The actual model name from the API request (e.g., "gpt-4o") */
+    model: string | null;
+    /** Model parameters (temperature, max_tokens, etc.) */
+    modelParameters: ModelParameters | null;
+    /** Input tokens used */
+    inputTokens: number | null;
+    /** Output tokens used */
+    outputTokens: number | null;
+    /** Cached input tokens (if any) */
+    cachedInputTokens: number | null;
+    /** Execution duration in milliseconds */
+    durationMs: number | null;
+    /** Raw LLM response before parsing */
+    rawLlmResponse: string | null;
+    /** The actual rendered messages sent to the LLM (with ctx.output_format filled in) */
+    renderedMessages: Array<{
+        role: string;
+        content: string;
+    }> | null;
+}
+/**
+ * Result of a BAML function execution with metadata.
+ */
+export interface BamlExecutionResult {
+    /** The parsed result of the function */
+    result: unknown;
+    /** Metadata about the execution (tokens, timing, model, etc.) */
+    metadata: BamlExecutionMetadata;
+}
+/**
+ * Generate the BAML client name from provider and model.
+ * e.g., "openai" + "gpt-4.1-mini" -> "OpenAI_GPT4_1_mini"
+ */
+export declare function getClientName(provider: string, model: string): string;
+/**
+ * Type for allowed environment variables.
+ * Only OPENAI_API_KEY is currently supported.
+ */
+export type AllowedEnvVars = {
+    OPENAI_API_KEY?: string;
+};
+/**
+ * Runs the BAML function with the given inputs using the BAML runtime directly.
+ * No file generation or subprocess spawning needed.
+ *
+ * @param bamlSource - The BAML source code containing the function
+ * @param inputs - Named arguments to pass to the function
+ * @param providers - Available provider definitions
+ * @param envVars - Environment variables for API keys (only OPENAI_API_KEY is allowed)
+ * @returns The result and execution metadata of the BAML function call
+ */
+export declare function runFunctionWithBaml(bamlSource: string, inputs: Record<string, unknown>, providers: ProviderDefinition[], envVars: AllowedEnvVars): Promise<BamlExecutionResult>;
+//# sourceMappingURL=baml.d.ts.map

package/dist/baml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baml.d.ts","sourceRoot":"","sources":["../src/baml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,KAAK,CAAC;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;KACpB,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kEAAkE;IAClE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,uDAAuD;IACvD,eAAe,EAAE,eAAe,GAAG,IAAI,CAAA;IACvC,wBAAwB;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,yBAAyB;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,yCAAyC;IACzC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,sCAAsC;IACtC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,sFAAsF;IACtF,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAA;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAA;IACf,iEAAiE;IACjE,QAAQ,EAAE,qBAAqB,CAAA;CAChC;AAiCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AA2MD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAiBD;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,kBAAkB,EAAE,EAC/B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAoD9B"}

package/dist/baml.js

@@ -0,0 +1,247 @@
+/**
+ * BAML execution utilities for the Simforge TypeScript SDK.
+ * This module provides functions to execute BAML prompts dynamically on the client side.
+ */
+import { BamlRuntime, Collector } from "@boundaryml/baml";
+/**
+ * Capitalize first letter of a string.
+ */
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+/**
+ * Convert provider name to PascalCase.
+ * e.g., "openai" -> "OpenAI", "anthropic" -> "Anthropic"
+ */
+function formatProvider(provider) {
+    const providerMap = {
+        openai: "OpenAI",
+        anthropic: "Anthropic",
+        google: "Google",
+    };
+    return providerMap[provider] ?? capitalize(provider);
+}
+/**
+ * Convert a model name to a valid BAML identifier part.
+ * e.g., "gpt-5-mini" -> "GPT5_mini", "gpt-4.1" -> "GPT4_1"
+ */
+function formatModel(model) {
+    return model
+        .replace(/^gpt-/, "GPT") // gpt- prefix -> GPT
+        .replace(/\./g, "_") // dots -> underscore
+        .replace(/-/g, "_"); // hyphens -> underscore
+}
+/**
+ * Generate the BAML client name from provider and model.
+ * e.g., "openai" + "gpt-4.1-mini" -> "OpenAI_GPT4_1_mini"
+ */
+export function getClientName(provider, model) {
+    return `${formatProvider(provider)}_${formatModel(model)}`;
+}
+/**
+ * Generates BAML client definition strings.
+ * BamlRuntime.fromFiles requires clients to be defined in source for parsing.
+ */
+function generateClientDefinitions(providers) {
+    const definitions = [];
+    for (const providerDef of providers) {
+        for (const model of providerDef.models) {
+            const clientName = getClientName(providerDef.provider, model.model);
+            definitions.push(`client<llm> ${clientName} {
+  provider ${providerDef.provider}
+  options {
+    model "${model.model}"
+    api_key env.${providerDef.apiKeyEnv}
+  }
+}`);
+        }
+    }
+    return definitions.join("\n\n");
+}
+/**
+ * Prepends the default client definitions to a BAML source if it doesn't already define them.
+ */
+function withDefaultClients(bamlSource, providers) {
+    const hasDefaultClient = bamlSource.includes("client<llm> OpenAI_");
+    if (hasDefaultClient) {
+        return bamlSource;
+    }
+    const defaultClients = generateClientDefinitions(providers);
+    return `${defaultClients}\n\n${bamlSource}`;
+}
+/**
+ * Extracts the first function name from BAML source code.
+ */
+function extractFunctionName(bamlSource) {
+    const match = bamlSource.match(/function\s+(\w+)\s*\(/);
+    return match?.[1] ?? null;
+}
+/**
+ * Coerces input values from strings to their appropriate types.
+ * Web UI inputs are always strings, but BAML expects typed values.
+ */
+function coerceInputs(inputs) {
+    const coerced = {};
+    for (const [key, value] of Object.entries(inputs)) {
+        if (typeof value === "string") {
+            // Try to parse as JSON (handles numbers, booleans, arrays, objects)
+            try {
+                coerced[key] = JSON.parse(value);
+            }
+            catch {
+                // Keep as string if not valid JSON
+                coerced[key] = value;
+            }
+        }
+        else {
+            coerced[key] = value;
+        }
+    }
+    return coerced;
+}
+/**
+ * Extract data from the LLM HTTP request body.
+ * This contains the actual prompt, model, and parameters sent to the LLM.
+ */
+function extractFromRequestBody(selectedCall) {
+    try {
+        const requestBody = selectedCall?.httpRequest?.body?.json();
+        if (!requestBody || typeof requestBody !== "object") {
+            return { model: null, modelParameters: null, renderedMessages: null };
+        }
+        // Extract the actual model name
+        const model = typeof requestBody.model === "string" ? requestBody.model : null;
+        // Extract model parameters
+        const modelParameters = {};
+        if (typeof requestBody.temperature === "number") {
+            modelParameters.temperature = requestBody.temperature;
+        }
+        if (requestBody.max_tokens !== undefined) {
+            modelParameters.max_tokens = requestBody.max_tokens;
+        }
+        if (typeof requestBody.top_p === "number") {
+            modelParameters.top_p = requestBody.top_p;
+        }
+        if (typeof requestBody.frequency_penalty === "number") {
+            modelParameters.frequency_penalty = requestBody.frequency_penalty;
+        }
+        if (typeof requestBody.presence_penalty === "number") {
+            modelParameters.presence_penalty = requestBody.presence_penalty;
+        }
+        // Include response_format if present (for JSON mode)
+        if (requestBody.response_format) {
+            modelParameters.response_format = requestBody.response_format;
+        }
+        // Extract rendered messages
+        let renderedMessages = null;
+        if (Array.isArray(requestBody.messages)) {
+            renderedMessages = requestBody.messages
+                .filter((msg) => typeof msg === "object" &&
+                msg !== null &&
+                "role" in msg &&
+                typeof msg.role === "string")
+                .map((msg) => ({
+                role: msg.role,
+                content: typeof msg.content === "string"
+                    ? msg.content
+                    : JSON.stringify(msg.content),
+            }));
+        }
+        return {
+            model,
+            modelParameters: Object.keys(modelParameters).length > 0 ? modelParameters : null,
+            renderedMessages,
+        };
+    }
+    catch {
+        return { model: null, modelParameters: null, renderedMessages: null };
+    }
+}
+/**
+ * Extract execution metadata from a BAML collector.
+ */
+function extractMetadataFromCollector(collector) {
+    const lastLog = collector.last;
+    const usage = collector.usage;
+    // Get the selected LLM call from the last function log
+    const calls = lastLog?.calls ?? [];
+    const selectedCall = calls.find((call) => call.selected) ?? calls[0];
+    // Extract the model, parameters, and rendered messages from the HTTP request
+    const { model, modelParameters, renderedMessages } = extractFromRequestBody(selectedCall);
+    return {
+        clientName: selectedCall?.clientName ?? null,
+        provider: selectedCall?.provider ?? null,
+        model,
+        modelParameters,
+        inputTokens: usage?.inputTokens ?? selectedCall?.usage?.inputTokens ?? null,
+        outputTokens: usage?.outputTokens ?? selectedCall?.usage?.outputTokens ?? null,
+        cachedInputTokens: usage?.cachedInputTokens ?? null,
+        durationMs: lastLog?.timing?.durationMs ?? null,
+        rawLlmResponse: lastLog?.rawLlmResponse ?? null,
+        renderedMessages,
+    };
+}
+/**
+ * Allowed environment variable keys for LLM providers.
+ * Only these keys will be passed to the BAML runtime.
+ */
+const ALLOWED_ENV_KEYS = ["OPENAI_API_KEY"];
+/**
+ * Filters environment variables to only include allowed keys.
+ * This prevents accidentally passing sensitive environment variables to the BAML runtime.
+ */
+function filterEnvVars(envVars) {
+    const filtered = {};
+    for (const key of ALLOWED_ENV_KEYS) {
+        const value = envVars[key];
+        if (value) {
+            filtered[key] = value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Runs the BAML function with the given inputs using the BAML runtime directly.
+ * No file generation or subprocess spawning needed.
+ *
+ * @param bamlSource - The BAML source code containing the function
+ * @param inputs - Named arguments to pass to the function
+ * @param providers - Available provider definitions
+ * @param envVars - Environment variables for API keys (only OPENAI_API_KEY is allowed)
+ * @returns The result and execution metadata of the BAML function call
+ */
+export async function runFunctionWithBaml(bamlSource, inputs, providers, envVars) {
+    // Extract function name from the BAML source
+    const functionName = extractFunctionName(bamlSource);
+    if (!functionName) {
+        throw new Error("No function found in BAML source");
+    }
+    // Add default client definitions (runtime needs them for parsing)
+    const fullSource = withDefaultClients(bamlSource, providers);
+    // Filter env vars to only allowed keys
+    const filteredEnvVars = filterEnvVars(envVars);
+    // Create runtime from source with env vars
+    const runtime = BamlRuntime.fromFiles("/tmp/baml_runtime", { "source.baml": fullSource }, filteredEnvVars);
+    // Create context manager
+    const ctx = runtime.createContextManager();
+    // Create collector to capture execution metadata
+    const collector = new Collector("simforge-collector");
+    // Coerce inputs from strings to proper types
+    const args = coerceInputs(inputs);
+    // Call the function with collector
+    const functionResult = await runtime.callFunction(functionName, args, ctx, null, // TypeBuilder
+    null, // ClientRegistry
+    [collector], // Collectors - capture execution data
+    {}, // Tags
+    filteredEnvVars);
+    if (!functionResult.isOk()) {
+        throw new Error("BAML function execution failed");
+    }
+    // Extract metadata from collector
+    const metadata = extractMetadataFromCollector(collector);
+    return {
+        result: functionResult.parsed(false),
+        metadata,
+    };
+}
+//# sourceMappingURL=baml.js.map

package/dist/baml.js.map

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

package/dist/client.d.ts

@@ -1,6 +1,7 @@
 /**
  * Simforge client for provider-based API calls.
  */
+import { type AllowedEnvVars } from "./baml.js";
 export interface SimforgeConfig {
     /** The API key for Simforge API authentication */
     apiKey: string;
@@ -8,6 +9,10 @@ export interface SimforgeConfig {
     serviceUrl?: string;
     /** Request timeout in milliseconds (default: 120000) */
     timeout?: number;
+    /** Environment variables for LLM provider API keys (only OPENAI_API_KEY is supported) */
+    envVars?: AllowedEnvVars;
+    /** Whether to execute BAML locally on the client (default: true) */
+    executeLocally?: boolean;
 }
 export interface CallResponse<T = unknown> {
     result?: T;
@@ -26,12 +31,22 @@ export declare class Simforge {
     private readonly apiKey;
     private readonly serviceUrl;
     private readonly timeout;
+    private readonly envVars;
+    private readonly executeLocally;
     /**
      * Initialize the Simforge client.
      *
      * @param config - Configuration options for the client
      */
     constructor(config: SimforgeConfig);
+    /**
+     * Fetch the function with its current version and BAML prompt from the server.
+     *
+     * @param methodName - The name of the method to fetch
+     * @returns The function with current version, BAML prompt, and provider definitions
+     * @throws {SimforgeError} If the function is not found or an error occurs
+     */
+    private fetchFunctionVersion;
     /**
      * Call a method with the given named arguments via BAML execution.
      *
@@ -42,3 +57,4 @@ export declare class Simforge {
      */
     call<T = unknown>(methodName: string, inputs?: Record<string, unknown>): Promise<T>;
 }
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,WAAW,CAAA;AAIlB,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;IACd,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,MAAM,CAAC,EAAE,CAAC,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAWD,qBAAa,aAAc,SAAQ,KAAK;aAGpB,GAAG,CAAC,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,GAAG,CAAC,EAAE,MAAM,YAAA;CAK/B;AAED;;GAEG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;OAIG;gBACS,MAAM,EAAE,cAAc;IAQlC;;;;;;OAMG;YACW,oBAAoB;IAyElC;;;;;;;OAOG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,OAAO,CAAC,CAAC,CAAC;CAgFd"}

package/dist/client.js

@@ -1,6 +1,7 @@
 /**
  * Simforge client for provider-based API calls.
  */
+import { runFunctionWithBaml, } from "./baml.js";
 const DEFAULT_SERVICE_URL = "https://simforge.goharvest.ai";
 export class SimforgeError extends Error {
     constructor(message, url) {
@@ -22,6 +23,68 @@ export class Simforge {
         this.apiKey = config.apiKey;
         this.serviceUrl = config.serviceUrl ?? DEFAULT_SERVICE_URL;
         this.timeout = config.timeout ?? 120000;
+        this.envVars = config.envVars ?? {};
+        this.executeLocally = config.executeLocally ?? true;
+    }
+    /**
+     * Fetch the function with its current version and BAML prompt from the server.
+     *
+     * @param methodName - The name of the method to fetch
+     * @returns The function with current version, BAML prompt, and provider definitions
+     * @throws {SimforgeError} If the function is not found or an error occurs
+     */
+    async fetchFunctionVersion(methodName) {
+        const url = `${this.serviceUrl}/api/sdk/functions/lookup`;
+        const payload = { name: methodName };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(payload),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new SimforgeError(`HTTP ${response.status}: ${errorText.slice(0, 500)}`);
+            }
+            const result = await response.json();
+            // Check if function was not found
+            if (result.id === null) {
+                throw new SimforgeError(`Function "${methodName}" not found. Create it at: ${this.serviceUrl}/functions`, "/functions");
+            }
+            // Check if function has no prompt
+            if (!result.prompt) {
+                throw new SimforgeError(`Function "${methodName}" has no prompt configured. Add one at: ${this.serviceUrl}/functions/${result.id}`, `/functions/${result.id}`);
+            }
+            // Check for errors in the response
+            if (result.error) {
+                if (result.url) {
+                    throw new SimforgeError(`${result.error} Configure it at: ${this.serviceUrl}${result.url}`, result.url);
+                }
+                throw new SimforgeError(result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof SimforgeError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new SimforgeError(`Request timed out after ${this.timeout}ms`);
+                }
+                throw new SimforgeError(error.message);
+            }
+            throw new SimforgeError("Unknown error occurred");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
     }
     /**
      * Call a method with the given named arguments via BAML execution.
@@ -32,6 +95,24 @@ export class Simforge {
      * @throws {SimforgeError} If service_url is not set, or if an error occurs
      */
     async call(methodName, inputs = {}) {
+        // If executeLocally is true, fetch the BAML and execute it locally
+        if (this.executeLocally) {
+            try {
+                const functionVersion = await this.fetchFunctionVersion(methodName);
+                const result = await runFunctionWithBaml(functionVersion.prompt, inputs, functionVersion.providers, this.envVars);
+                return result.result;
+            }
+            catch (error) {
+                if (error instanceof SimforgeError) {
+                    throw error;
+                }
+                if (error instanceof Error) {
+                    throw new SimforgeError(error.message);
+                }
+                throw new SimforgeError("Unknown error occurred during local execution");
+            }
+        }
+        // Otherwise, fall back to server-side execution
         const url = `${this.serviceUrl}/api/sdk/call`;
         const payload = {
             name: methodName,
@@ -80,3 +161,4 @@ export class Simforge {
         }
     }
 }
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../src/client.test.ts"],"names":[],"mappings":""}

package/dist/client.test.js

@@ -0,0 +1,357 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import * as baml from "./baml.js";
+import { Simforge, SimforgeError } from "./client";
+// Mock fetch globally
+globalThis.fetch = vi.fn();
+// Mock BAML execution
+vi.mock("./baml.js", () => ({
+    runFunctionWithBaml: vi.fn(),
+}));
+describe("Simforge Client", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe("constructor", () => {
+        it("should create a client with default values", () => {
+            const client = new Simforge({ apiKey: "test-key" });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        it("should create client even with empty apiKey (validation happens at call time)", () => {
+            const client = new Simforge({ apiKey: "" });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        it("should use custom serviceUrl", () => {
+            const client = new Simforge({
+                apiKey: "test-key",
+                serviceUrl: "https://custom.example.com",
+            });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        it("should use custom timeout", () => {
+            const client = new Simforge({
+                apiKey: "test-key",
+                timeout: 5000,
+            });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        it("should accept envVars", () => {
+            const client = new Simforge({
+                apiKey: "test-key",
+                envVars: { OPENAI_API_KEY: "test-openai-key" },
+            });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        it("should accept executeLocally flag", () => {
+            const client = new Simforge({
+                apiKey: "test-key",
+                executeLocally: false,
+            });
+            expect(client).toBeInstanceOf(Simforge);
+        });
+        describe("call method - local execution", () => {
+            beforeEach(() => {
+                // Reset BAML mock
+                vi.mocked(baml.runFunctionWithBaml).mockReset();
+            });
+            it("should execute BAML locally with correct types", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractName",
+                    hasPrompt: true,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: `
+class Name {
+  first_name string
+  middle_name string?
+  last_name string
+}
+
+function ExtractName(text: string) -> Name {
+  client GPT4
+  prompt #"Extract name from: {{ text }}"#
+}
+        `,
+                    providers: [
+                        {
+                            provider: "openai",
+                            apiKeyEnv: "OPENAI_API_KEY",
+                            models: [{ model: "gpt-4", description: "GPT-4" }],
+                        },
+                    ],
+                };
+                const mockBamlResult = {
+                    result: {
+                        first_name: "John",
+                        middle_name: "Michael",
+                        last_name: "Doe",
+                    },
+                    metadata: {
+                        clientName: "GPT4",
+                        provider: "openai",
+                        model: "gpt-4",
+                        modelParameters: { temperature: 0.7 },
+                        inputTokens: 10,
+                        outputTokens: 20,
+                        cachedInputTokens: 0,
+                        durationMs: 100,
+                        rawLlmResponse: '{"first_name":"John","middle_name":"Michael","last_name":"Doe"}',
+                        renderedMessages: [
+                            {
+                                role: "system",
+                                content: "Extract name from: John Michael Doe",
+                            },
+                        ],
+                    },
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                // Mock BAML execution
+                vi.mocked(baml.runFunctionWithBaml).mockResolvedValueOnce(mockBamlResult);
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                    envVars: { OPENAI_API_KEY: "test-openai-key" },
+                });
+                const result = await client.call("ExtractName", {
+                    text: "John Michael Doe",
+                });
+                // Verify result structure
+                expect(result).toEqual({
+                    first_name: "John",
+                    middle_name: "Michael",
+                    last_name: "Doe",
+                });
+                // Verify BAML was called with correct parameters
+                expect(baml.runFunctionWithBaml).toHaveBeenCalledWith(mockFunctionData.prompt, { text: "John Michael Doe" }, mockFunctionData.providers, { OPENAI_API_KEY: "test-openai-key" });
+            });
+            it("should handle wrong input types in local execution", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractName",
+                    hasPrompt: true,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: "function ExtractName(text: string) -> Name {}",
+                    providers: [],
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                // Mock BAML to throw type error
+                vi.mocked(baml.runFunctionWithBaml).mockRejectedValueOnce(new Error("Invalid argument: Expected type String, got Number(12345)"));
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                });
+                await expect(
+                // biome-ignore lint/suspicious/noExplicitAny: Testing wrong type handling
+                client.call("ExtractName", { text: 12345 })).rejects.toThrow("Invalid argument");
+            });
+            it("should handle missing required inputs in local execution", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractName",
+                    hasPrompt: true,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: "function ExtractName(text: string) -> Name {}",
+                    providers: [],
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                // Mock BAML to throw missing parameter error
+                vi.mocked(baml.runFunctionWithBaml).mockRejectedValueOnce(new Error("Missing required parameter: text"));
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                });
+                await expect(client.call("ExtractName", {})).rejects.toThrow("Missing required parameter");
+            });
+            it("should return typed Pydantic-like object for complex types", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractPerson",
+                    hasPrompt: true,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: `
+class Address {
+  street string
+  city string
+  zip string?
+}
+
+class Person {
+  name string
+  age int
+  email string?
+  address Address
+}
+
+function ExtractPerson(text: string) -> Person {}
+        `,
+                    providers: [],
+                };
+                const mockBamlResult = {
+                    result: {
+                        name: "John Doe",
+                        age: 30,
+                        email: "john@example.com",
+                        address: {
+                            street: "123 Main St",
+                            city: "New York",
+                            zip: "10001",
+                        },
+                    },
+                    metadata: {
+                        clientName: "GPT4",
+                        provider: "openai",
+                        model: "gpt-4",
+                        modelParameters: {},
+                        inputTokens: 0,
+                        outputTokens: 0,
+                        cachedInputTokens: 0,
+                        durationMs: 0,
+                        rawLlmResponse: null,
+                        renderedMessages: [],
+                    },
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                vi.mocked(baml.runFunctionWithBaml).mockResolvedValueOnce(mockBamlResult);
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                });
+                const result = (await client.call("ExtractPerson", {
+                    text: "John Doe, 30, john@example.com, 123 Main St, New York, 10001",
+                }));
+                // Verify nested structure
+                expect(result).toHaveProperty("name", "John Doe");
+                expect(result).toHaveProperty("age", 30);
+                expect(result).toHaveProperty("email", "john@example.com");
+                expect(result).toHaveProperty("address");
+                expect(result.address).toHaveProperty("street", "123 Main St");
+                expect(result.address).toHaveProperty("city", "New York");
+                expect(result.address).toHaveProperty("zip", "10001");
+            });
+            it("should throw error if function has no prompt configured", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractName",
+                    hasPrompt: false,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: null,
+                    providers: [],
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                });
+                await expect(client.call("ExtractName", { text: "test" })).rejects.toThrow("has no prompt");
+            });
+            it("should pass only allowed env vars to BAML", async () => {
+                const mockFunctionData = {
+                    id: "func-123",
+                    name: "ExtractName",
+                    hasPrompt: true,
+                    versionId: "v1",
+                    versionNumber: 1,
+                    prompt: "function ExtractName(text: string) -> Name {}",
+                    providers: [],
+                };
+                const mockBamlResult = {
+                    result: { first_name: "John", last_name: "Doe" },
+                    metadata: {
+                        clientName: "GPT4",
+                        provider: "openai",
+                        model: "gpt-4",
+                        modelParameters: {},
+                        inputTokens: 0,
+                        outputTokens: 0,
+                        cachedInputTokens: 0,
+                        durationMs: 0,
+                        rawLlmResponse: null,
+                        renderedMessages: [],
+                    },
+                };
+                globalThis.fetch.mockResolvedValueOnce({
+                    ok: true,
+                    json: async () => mockFunctionData,
+                });
+                vi.mocked(baml.runFunctionWithBaml).mockResolvedValueOnce(mockBamlResult);
+                const client = new Simforge({
+                    apiKey: "test-key",
+                    executeLocally: true,
+                    envVars: {
+                        OPENAI_API_KEY: "test-key",
+                    },
+                });
+                await client.call("ExtractName", { text: "John Doe" });
+                // Verify OPENAI_API_KEY was passed
+                const callArgs = vi.mocked(baml.runFunctionWithBaml).mock.calls[0];
+                expect(callArgs[3]).toEqual({ OPENAI_API_KEY: "test-key" });
+                // Verify no other keys are present
+                expect(Object.keys(callArgs[3])).toHaveLength(1);
+            });
+        });
+    });
+    describe("call method - server-side execution", () => {
+        it("should make successful API call", async () => {
+            const mockResponse = "success";
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: true,
+                json: async () => ({ result: mockResponse }),
+            });
+            const client = new Simforge({
+                apiKey: "test-key",
+                executeLocally: false,
+            });
+            const result = await client.call("testMethod", { input: "test" });
+            expect(result).toEqual(mockResponse);
+            expect(globalThis.fetch).toHaveBeenCalledWith(expect.stringContaining("/api/sdk/call"), expect.objectContaining({
+                method: "POST",
+                headers: expect.objectContaining({
+                    Authorization: "Bearer test-key",
+                    "Content-Type": "application/json",
+                }),
+            }));
+        });
+        it("should handle API errors", async () => {
+            ;
+            globalThis.fetch.mockResolvedValueOnce({
+                ok: false,
+                status: 400,
+                json: async () => ({ error: "Bad request" }),
+            });
+            const client = new Simforge({
+                apiKey: "test-key",
+                executeLocally: false,
+            });
+            await expect(client.call("testMethod", {})).rejects.toThrow(SimforgeError);
+        });
+        it("should handle network errors", async () => {
+            ;
+            globalThis.fetch.mockRejectedValueOnce(new Error("Network error"));
+            const client = new Simforge({
+                apiKey: "test-key",
+                executeLocally: false,
+            });
+            await expect(client.call("testMethod", {})).rejects.toThrow(SimforgeError);
+        });
+    });
+});
+//# sourceMappingURL=client.test.js.map

package/dist/client.test.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 /**
  * Simforge client for provider-based API calls.
  */
-export { Simforge, SimforgeError } from "./client";
-export type { SimforgeConfig, CallResponse } from "./client";
+export type { AllowedEnvVars, BamlExecutionMetadata, BamlExecutionResult, ModelParameters, ProviderDefinition, } from "./baml.js";
+export type { CallResponse, SimforgeConfig } from "./client.js";
+export { Simforge, SimforgeError } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,4 +1,5 @@
 /**
  * Simforge client for provider-based API calls.
  */
-export { Simforge, SimforgeError } from "./client";
+export { Simforge, SimforgeError } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goharvest/simforge",
-  "version": "0.1.0",
-  "description": "Simforge client for provider-based API calls",
+  "version": "0.2.0",
+  "description": "Simforge client for provider-based API calls with local BAML execution",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,7 +16,16 @@
   ],
   "scripts": {
     "build": "tsc",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "format": "biome format --write src",
+    "tsc": "tsc --noEmit",
+    "knip": "knip",
+    "madge": "madge --warning --ts-config ./tsconfig.json --extensions ts --circular ./src",
+    "validate": "pnpm lint && pnpm tsc && pnpm knip && pnpm madge",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "keywords": [
     "simforge",
@@ -35,8 +44,9 @@
   "bugs": {
     "url": "https://github.com/anthropic-harvest/simforge-typescript-sdk/issues"
   },
+  "dependencies": {
+    "@boundaryml/baml": "^0.214.0"
+  },
   "devDependencies": {
-    "@types/node": "^22.15.21",
-    "typescript": "^5.7.2"
   }
 }