@runtypelabs/sdk 0.1.1

package/dist/runtype.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts
+ *
+ * Provides a fluent API with static namespaces for all product areas.
+ *
+ * @example
+ * ```typescript
+ * import { Runtype } from '@runtypelabs/sdk'
+ *
+ * // Global configuration (once per app)
+ * Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
+ *
+ * // Build and stream a flow
+ * const stream = await Runtype.flows.upsert({ name: 'My Flow' })
+ *   .withRecord({ name: 'Test', metadata: {} })
+ *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
+ *   .stream()
+ *
+ * // Get complete result
+ * const result = await Runtype.flows.use('flow_123')
+ *   .withRecord({ name: 'Test' })
+ *   .result()
+ *
+ * // Schedule a batch
+ * const batch = await Runtype.batches.schedule({
+ *   flowId: 'flow_123',
+ *   recordType: 'customers',
+ * })
+ *
+ * // Run an eval with streaming
+ * const evalStream = await Runtype.evals.run({
+ *   flowId: 'flow_123',
+ *   recordType: 'test_data',
+ *   models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
+ * }).stream()
+ *
+ * // Execute a prompt
+ * const promptResult = await Runtype.prompts.run('prompt_123', {
+ *   recordId: 'rec_456'
+ * }).result()
+ * ```
+ */
+import { FlowsNamespace } from './flows-namespace';
+import { BatchesNamespace } from './batches-namespace';
+import { EvalsNamespace } from './evals-namespace';
+import { PromptsNamespace } from './prompts-namespace';
+export interface RuntypeConfig {
+    /** API key for authentication */
+    apiKey?: string;
+    /** Base URL for the API (defaults to https://api.runtype.com) */
+    baseUrl?: string;
+    /** API version (defaults to 'v1') */
+    apiVersion?: string;
+    /** Request timeout in milliseconds (defaults to 30000) */
+    timeout?: number;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+}
+/**
+ * Internal client implementation that handles HTTP requests
+ */
+export declare class RuntypeClient {
+    private baseUrl;
+    private apiVersion;
+    private timeout;
+    private headers;
+    constructor(config?: RuntypeConfig);
+    /**
+     * Set the API key for authentication
+     */
+    setApiKey(apiKey: string): void;
+    /**
+     * Generic GET request
+     */
+    get<T>(path: string, params?: Record<string, any>): Promise<T>;
+    /**
+     * Generic POST request
+     */
+    post<T>(path: string, data?: any): Promise<T>;
+    /**
+     * Generic request that returns raw Response for streaming
+     */
+    requestStream(path: string, options?: RequestInit): Promise<Response>;
+    /**
+     * Dispatch flow execution (streaming)
+     */
+    dispatch(config: any): Promise<Response>;
+    /**
+     * Build full URL with query parameters
+     */
+    private buildUrl;
+    /**
+     * Make HTTP request with timeout and error handling
+     */
+    private makeRequest;
+    /**
+     * Make HTTP request that returns raw Response (for streaming)
+     */
+    private makeRawRequest;
+    /**
+     * Transform response (placeholder for snake_case to camelCase)
+     */
+    private transformResponse;
+}
+/**
+ * Runtype - Main entry point for the SDK
+ *
+ * Use static methods and namespaces to interact with the API.
+ */
+export declare class Runtype {
+    /**
+     * Configure the global Runtype client
+     *
+     * Call this once at app startup to set the API key and other options.
+     * All subsequent calls to Runtype.flows, Runtype.batches, etc. will use this config.
+     *
+     * @example
+     * ```typescript
+     * Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
+     * ```
+     */
+    static configure(config: RuntypeConfig): void;
+    /**
+     * Get the global client instance, creating one if needed
+     */
+    static getClient(): RuntypeClient;
+    /**
+     * Create a new client instance with custom configuration
+     *
+     * Use this when you need a client with different settings than the global one.
+     *
+     * @example
+     * ```typescript
+     * const client = Runtype.createClient({ apiKey: 'different_key' })
+     * ```
+     */
+    static createClient(config?: RuntypeConfig): RuntypeClient;
+    /**
+     * Flows namespace - Build and execute flows
+     *
+     * @example
+     * ```typescript
+     * // Upsert a flow (create or update)
+     * const result = await Runtype.flows.upsert({ name: 'My Flow' })
+     *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
+     *   .stream()
+     *
+     * // Use an existing flow
+     * const result = await Runtype.flows.use('flow_123')
+     *   .withRecord({ name: 'Test' })
+     *   .result()
+     *
+     * // Virtual flow (one-off, not saved)
+     * const result = await Runtype.flows.virtual({ name: 'Temp Flow' })
+     *   .prompt({ ... })
+     *   .stream()
+     * ```
+     */
+    static get flows(): FlowsNamespace;
+    /**
+     * Batches namespace - Schedule and manage batch operations
+     *
+     * @example
+     * ```typescript
+     * // Schedule a batch
+     * const batch = await Runtype.batches.schedule({
+     *   flowId: 'flow_123',
+     *   recordType: 'customers',
+     * })
+     *
+     * // Get batch status
+     * const status = await Runtype.batches.get('batch_456')
+     *
+     * // Cancel a batch
+     * await Runtype.batches.cancel('batch_456')
+     *
+     * // List batches
+     * const batches = await Runtype.batches.list({ status: 'running' })
+     * ```
+     */
+    static get batches(): BatchesNamespace;
+    /**
+     * Evals namespace - Run evaluations and compare models
+     *
+     * @example
+     * ```typescript
+     * // Run an eval with streaming
+     * const stream = await Runtype.evals.run({
+     *   flowId: 'flow_123',
+     *   recordType: 'test_data',
+     *   models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
+     * }).stream()
+     *
+     * // Submit eval as batch job
+     * const eval = await Runtype.evals.run({
+     *   flowId: 'flow_123',
+     *   recordType: 'test_data',
+     *   models: [
+     *     [{ stepName: 'Analyze', model: 'gpt-4o' }],
+     *     [{ stepName: 'Analyze', model: 'claude-3-opus' }],
+     *   ]
+     * }).submit()
+     * ```
+     */
+    static get evals(): EvalsNamespace;
+    /**
+     * Prompts namespace - Manage and execute prompts
+     *
+     * @example
+     * ```typescript
+     * // Execute a prompt with streaming
+     * const stream = await Runtype.prompts.run('prompt_123', {
+     *   recordId: 'rec_456'
+     * }).stream()
+     *
+     * // Get complete result
+     * const result = await Runtype.prompts.run('prompt_123', {
+     *   recordId: 'rec_456'
+     * }).result()
+     *
+     * // CRUD operations
+     * const prompts = await Runtype.prompts.list()
+     * const prompt = await Runtype.prompts.get('prompt_123')
+     * const newPrompt = await Runtype.prompts.create({ ... })
+     * await Runtype.prompts.update('prompt_123', { ... })
+     * await Runtype.prompts.delete('prompt_123')
+     * ```
+     */
+    static get prompts(): PromptsNamespace;
+}
+export default Runtype;
+//# sourceMappingURL=runtype.d.ts.map

package/dist/runtype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtype.d.ts","sourceRoot":"","sources":["../src/runtype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAOtD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAaD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,GAAE,aAAkB;IAetC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IASpE;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAUnD;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa/E;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAO9C;;OAEG;IACH,OAAO,CAAC,QAAQ;IAgBhB;;OAEG;YACW,WAAW;IAsCzB;;OAEG;YACW,cAAc;IA6B5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAI1B;AAMD;;;;GAIG;AACH,qBAAa,OAAO;IAKlB;;;;;;;;;;OAUG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK7C;;OAEG;IACH,MAAM,CAAC,SAAS,IAAI,aAAa;IAOjC;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,aAAa;IAQ1D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,KAAK,KAAK,IAAI,cAAc,CAEjC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,KAAK,OAAO,IAAI,gBAAgB,CAErC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,KAAK,KAAK,IAAI,cAAc,CAEjC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,KAAK,OAAO,IAAI,gBAAgB,CAErC;CACF;AAED,eAAe,OAAO,CAAA"}

package/dist/runtype.js

@@ -0,0 +1,367 @@
+"use strict";
+/**
+ * Runtype - The unified SDK client for building and executing flows, batches, evals, and prompts
+ *
+ * Provides a fluent API with static namespaces for all product areas.
+ *
+ * @example
+ * ```typescript
+ * import { Runtype } from '@runtypelabs/sdk'
+ *
+ * // Global configuration (once per app)
+ * Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
+ *
+ * // Build and stream a flow
+ * const stream = await Runtype.flows.upsert({ name: 'My Flow' })
+ *   .withRecord({ name: 'Test', metadata: {} })
+ *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
+ *   .stream()
+ *
+ * // Get complete result
+ * const result = await Runtype.flows.use('flow_123')
+ *   .withRecord({ name: 'Test' })
+ *   .result()
+ *
+ * // Schedule a batch
+ * const batch = await Runtype.batches.schedule({
+ *   flowId: 'flow_123',
+ *   recordType: 'customers',
+ * })
+ *
+ * // Run an eval with streaming
+ * const evalStream = await Runtype.evals.run({
+ *   flowId: 'flow_123',
+ *   recordType: 'test_data',
+ *   models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
+ * }).stream()
+ *
+ * // Execute a prompt
+ * const promptResult = await Runtype.prompts.run('prompt_123', {
+ *   recordId: 'rec_456'
+ * }).result()
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Runtype = exports.RuntypeClient = void 0;
+const flows_namespace_1 = require("./flows-namespace");
+const batches_namespace_1 = require("./batches-namespace");
+const evals_namespace_1 = require("./evals-namespace");
+const prompts_namespace_1 = require("./prompts-namespace");
+const transform_1 = require("./transform");
+// ============================================================================
+// Global State
+// ============================================================================
+let globalConfig = {};
+let globalClient = null;
+// ============================================================================
+// RuntypeClient Class (internal implementation)
+// ============================================================================
+/**
+ * Internal client implementation that handles HTTP requests
+ */
+class RuntypeClient {
+    constructor(config = {}) {
+        const baseUrl = config.baseUrl || 'https://api.runtype.com';
+        this.apiVersion = config.apiVersion || 'v1';
+        this.baseUrl = this.apiVersion ? `${baseUrl}/${this.apiVersion}` : baseUrl;
+        this.timeout = config.timeout || 30000;
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...(config.headers || {})
+        };
+        if (config.apiKey) {
+            this.headers.Authorization = `Bearer ${config.apiKey}`;
+        }
+    }
+    /**
+     * Set the API key for authentication
+     */
+    setApiKey(apiKey) {
+        this.headers.Authorization = `Bearer ${apiKey}`;
+    }
+    /**
+     * Generic GET request
+     */
+    async get(path, params) {
+        const url = this.buildUrl(path, params);
+        const response = await this.makeRequest(url, {
+            method: 'GET',
+            headers: this.headers
+        });
+        return this.transformResponse(response);
+    }
+    /**
+     * Generic POST request
+     */
+    async post(path, data) {
+        const url = this.buildUrl(path);
+        const response = await this.makeRequest(url, {
+            method: 'POST',
+            headers: this.headers,
+            body: data ? JSON.stringify(data) : undefined
+        });
+        return this.transformResponse(response);
+    }
+    /**
+     * Generic request that returns raw Response for streaming
+     */
+    async requestStream(path, options = {}) {
+        const url = this.buildUrl(path);
+        const headers = {
+            ...this.headers,
+            ...options.headers
+        };
+        return this.makeRawRequest(url, {
+            ...options,
+            headers,
+        });
+    }
+    /**
+     * Dispatch flow execution (streaming)
+     */
+    async dispatch(config) {
+        return this.requestStream('/dispatch', {
+            method: 'POST',
+            body: JSON.stringify((0, transform_1.transformRequest)(config))
+        });
+    }
+    /**
+     * Build full URL with query parameters
+     */
+    buildUrl(path, params) {
+        const base = this.baseUrl.endsWith('/') ? this.baseUrl : `${this.baseUrl}/`;
+        const relPath = path.startsWith('/') ? path.slice(1) : path;
+        const url = new URL(relPath, base);
+        if (params) {
+            Object.entries(params).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            });
+        }
+        return url.toString();
+    }
+    /**
+     * Make HTTP request with timeout and error handling
+     */
+    async makeRequest(url, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            if (response.status === 204) {
+                return null;
+            }
+            const contentType = response.headers.get('content-type');
+            if (contentType?.includes('application/json')) {
+                return response.json();
+            }
+            return response.text();
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Make HTTP request that returns raw Response (for streaming)
+     */
+    async makeRawRequest(url, options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`API request failed: ${response.status} ${response.statusText} - ${errorText}`);
+            }
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${this.timeout}ms`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Transform response (placeholder for snake_case to camelCase)
+     */
+    transformResponse(response) {
+        // For now, return as-is. Can add transformation later if needed.
+        return response;
+    }
+}
+exports.RuntypeClient = RuntypeClient;
+// ============================================================================
+// Runtype Static Class
+// ============================================================================
+/**
+ * Runtype - Main entry point for the SDK
+ *
+ * Use static methods and namespaces to interact with the API.
+ */
+class Runtype {
+    // ============================================================================
+    // Global Configuration
+    // ============================================================================
+    /**
+     * Configure the global Runtype client
+     *
+     * Call this once at app startup to set the API key and other options.
+     * All subsequent calls to Runtype.flows, Runtype.batches, etc. will use this config.
+     *
+     * @example
+     * ```typescript
+     * Runtype.configure({ apiKey: process.env.RUNTYPE_API_KEY })
+     * ```
+     */
+    static configure(config) {
+        globalConfig = { ...globalConfig, ...config };
+        globalClient = new RuntypeClient(globalConfig);
+    }
+    /**
+     * Get the global client instance, creating one if needed
+     */
+    static getClient() {
+        if (!globalClient) {
+            globalClient = new RuntypeClient(globalConfig);
+        }
+        return globalClient;
+    }
+    /**
+     * Create a new client instance with custom configuration
+     *
+     * Use this when you need a client with different settings than the global one.
+     *
+     * @example
+     * ```typescript
+     * const client = Runtype.createClient({ apiKey: 'different_key' })
+     * ```
+     */
+    static createClient(config) {
+        return new RuntypeClient({ ...globalConfig, ...config });
+    }
+    // ============================================================================
+    // Static Namespaces
+    // ============================================================================
+    /**
+     * Flows namespace - Build and execute flows
+     *
+     * @example
+     * ```typescript
+     * // Upsert a flow (create or update)
+     * const result = await Runtype.flows.upsert({ name: 'My Flow' })
+     *   .prompt({ name: 'Analyze', model: 'gpt-4o', userPrompt: '...' })
+     *   .stream()
+     *
+     * // Use an existing flow
+     * const result = await Runtype.flows.use('flow_123')
+     *   .withRecord({ name: 'Test' })
+     *   .result()
+     *
+     * // Virtual flow (one-off, not saved)
+     * const result = await Runtype.flows.virtual({ name: 'Temp Flow' })
+     *   .prompt({ ... })
+     *   .stream()
+     * ```
+     */
+    static get flows() {
+        return new flows_namespace_1.FlowsNamespace(() => this.getClient());
+    }
+    /**
+     * Batches namespace - Schedule and manage batch operations
+     *
+     * @example
+     * ```typescript
+     * // Schedule a batch
+     * const batch = await Runtype.batches.schedule({
+     *   flowId: 'flow_123',
+     *   recordType: 'customers',
+     * })
+     *
+     * // Get batch status
+     * const status = await Runtype.batches.get('batch_456')
+     *
+     * // Cancel a batch
+     * await Runtype.batches.cancel('batch_456')
+     *
+     * // List batches
+     * const batches = await Runtype.batches.list({ status: 'running' })
+     * ```
+     */
+    static get batches() {
+        return new batches_namespace_1.BatchesNamespace(() => this.getClient());
+    }
+    /**
+     * Evals namespace - Run evaluations and compare models
+     *
+     * @example
+     * ```typescript
+     * // Run an eval with streaming
+     * const stream = await Runtype.evals.run({
+     *   flowId: 'flow_123',
+     *   recordType: 'test_data',
+     *   models: [{ stepName: 'Analyze', model: 'gpt-4o' }]
+     * }).stream()
+     *
+     * // Submit eval as batch job
+     * const eval = await Runtype.evals.run({
+     *   flowId: 'flow_123',
+     *   recordType: 'test_data',
+     *   models: [
+     *     [{ stepName: 'Analyze', model: 'gpt-4o' }],
+     *     [{ stepName: 'Analyze', model: 'claude-3-opus' }],
+     *   ]
+     * }).submit()
+     * ```
+     */
+    static get evals() {
+        return new evals_namespace_1.EvalsNamespace(() => this.getClient());
+    }
+    /**
+     * Prompts namespace - Manage and execute prompts
+     *
+     * @example
+     * ```typescript
+     * // Execute a prompt with streaming
+     * const stream = await Runtype.prompts.run('prompt_123', {
+     *   recordId: 'rec_456'
+     * }).stream()
+     *
+     * // Get complete result
+     * const result = await Runtype.prompts.run('prompt_123', {
+     *   recordId: 'rec_456'
+     * }).result()
+     *
+     * // CRUD operations
+     * const prompts = await Runtype.prompts.list()
+     * const prompt = await Runtype.prompts.get('prompt_123')
+     * const newPrompt = await Runtype.prompts.create({ ... })
+     * await Runtype.prompts.update('prompt_123', { ... })
+     * await Runtype.prompts.delete('prompt_123')
+     * ```
+     */
+    static get prompts() {
+        return new prompts_namespace_1.PromptsNamespace(() => this.getClient());
+    }
+}
+exports.Runtype = Runtype;
+exports.default = Runtype;
+//# sourceMappingURL=runtype.js.map

package/dist/runtype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtype.js","sourceRoot":"","sources":["../src/runtype.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;;;AAGH,uDAAkD;AAClD,2DAAsD;AACtD,uDAAkD;AAClD,2DAAsD;AACtD,2CAA8C;AAmB9C,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,IAAI,YAAY,GAAkB,EAAE,CAAA;AACpC,IAAI,YAAY,GAAyB,IAAI,CAAA;AAE7C,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAE/E;;GAEG;AACH,MAAa,aAAa;IAMxB,YAAY,SAAwB,EAAE;QACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,yBAAyB,CAAA;QAC3D,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAA;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1E,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,KAAK,CAAA;QACtC,IAAI,CAAC,OAAO,GAAG;YACb,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SAC1B,CAAA;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,CAAA;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAA;IACjD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAI,IAAY,EAAE,MAA4B;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YAC3C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,iBAAiB,CAAI,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAU;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YAC3C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAA;QACF,OAAO,IAAI,CAAC,iBAAiB,CAAI,QAAQ,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,UAAuB,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC/B,MAAM,OAAO,GAAG;YACd,GAAG,IAAI,CAAC,OAAO;YACf,GAAI,OAAO,CAAC,OAAkC;SAC/C,CAAA;QAED,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE;YAC9B,GAAG,OAAO;YACV,OAAO;SACR,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAW;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE;YACrC,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAA,4BAAgB,EAAC,MAAM,CAAC,CAAC;SAC/C,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,IAAY,EAAE,MAA4B;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAA;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAC3D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAElC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;gBAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBAC1C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC1C,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CAAC,GAAW,EAAE,OAAoB;QACzD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAEpE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,GAAG,OAAO;gBACV,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAA;YAEF,YAAY,CAAC,SAAS,CAAC,CAAA;YAEvB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;gBACvC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAAC,CAAA;YACjG,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAA;YACb,CAAC;YAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;YACxD,IAAI,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;gBAC9C,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;YACxB,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAA;YAEvB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YAC5D,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,OAAoB;QAC5D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QAEpE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,GAAG,OAAO;gBACV,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAA;YAEF,YAAY,CAAC,SAAS,CAAC,CAAA;YAEvB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;gBACvC,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE,CAAC,CAAA;YACjG,CAAC;YAED,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAA;YAEvB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAC1D,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YAC5D,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAI,QAAa;QACxC,iEAAiE;QACjE,OAAO,QAAa,CAAA;IACtB,CAAC;CACF;AAlLD,sCAkLC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAa,OAAO;IAClB,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E;;;;;;;;;;OAUG;IACH,MAAM,CAAC,SAAS,CAAC,MAAqB;QACpC,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAA;QAC7C,YAAY,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;IAChD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS;QACd,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,YAAY,CAAA;IACrB,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,YAAY,CAAC,MAAsB;QACxC,OAAO,IAAI,aAAa,CAAC,EAAE,GAAG,YAAY,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,+EAA+E;IAC/E,oBAAoB;IACpB,+EAA+E;IAE/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,KAAK,KAAK;QACd,OAAO,IAAI,gCAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,KAAK,OAAO;QAChB,OAAO,IAAI,oCAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACrD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,KAAK,KAAK;QACd,OAAO,IAAI,gCAAc,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACnD,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,KAAK,OAAO;QAChB,OAAO,IAAI,oCAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IACrD,CAAC;CACF;AAxJD,0BAwJC;AAED,kBAAe,OAAO,CAAA"}

package/dist/stream-utils.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SSE Stream Utilities for FlowBuilder
+ *
+ * Provides utilities for parsing Server-Sent Events (SSE) streams
+ * from the Runtype API dispatch endpoint.
+ */
+import type { StreamCallbacks, StreamEvent, FlowSummary } from './flow-builder';
+/**
+ * Parse SSE stream chunks into individual events
+ *
+ * @param chunk - New chunk from the stream
+ * @param buffer - Previous incomplete buffer
+ * @returns Parsed events and remaining buffer
+ */
+export declare function parseSSEChunk(chunk: string, buffer: string): {
+    events: string[];
+    remainingBuffer: string;
+};
+/**
+ * Parse final buffer if it contains a complete event
+ *
+ * @param buffer - Remaining buffer after stream ends
+ * @returns Parsed event JSON string or null
+ */
+export declare function parseFinalBuffer(buffer: string): string | null;
+/**
+ * Process a streaming response with callbacks
+ *
+ * @param response - Fetch Response object with streaming body
+ * @param callbacks - Callbacks for different event types
+ * @returns Promise resolving to FlowSummary when complete
+ *
+ * @example
+ * ```typescript
+ * const response = await client.dispatch(config)
+ * const summary = await processStream(response, {
+ *   onStepChunk: (chunk) => process.stdout.write(chunk),
+ *   onFlowComplete: (event) => console.log('Done!'),
+ * })
+ * ```
+ */
+export declare function processStream(response: Response, callbacks?: StreamCallbacks): Promise<FlowSummary>;
+/**
+ * Create an async iterator over SSE events
+ *
+ * @param response - Fetch Response object with streaming body
+ * @yields Parsed SSE events
+ *
+ * @example
+ * ```typescript
+ * const response = await client.dispatch(config)
+ * for await (const event of streamEvents(response)) {
+ *   console.log(event.type, event)
+ * }
+ * ```
+ */
+export declare function streamEvents(response: Response): AsyncGenerator<StreamEvent>;
+//# sourceMappingURL=stream-utils.d.ts.map

package/dist/stream-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-utils.d.ts","sourceRoot":"","sources":["../src/stream-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EASX,WAAW,EACZ,MAAM,gBAAgB,CAAA;AAMvB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAgB/C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ9D;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,eAAoB,GAC9B,OAAO,CAAC,WAAW,CAAC,CA8ItB;AAgED;;;;;;;;;;;;;GAaG;AACH,wBAAuB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAyEnF"}