agentic-kit 1.3.1 → 1.4.0

package/LICENSE

@@ -1,7 +1,8 @@
-MIT License
+The MIT License (MIT)
 
 Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
 Copyright (c) 2025 Constructive <developers@constructive.io>
+Copyright (c) 2020-present, Interweb, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -19,4 +20,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -121,11 +121,30 @@ Use `createOpenAIKit`, `createAnthropicKit`, `createOllamaKit`, or
 
 ---
 
-## Related Constructive Tooling
+## Education and Tutorials
+
+ 1. 🚀 [Quickstart: Getting Up and Running](https://constructive.io/learn/quickstart)
+Get started with modular databases in minutes. Install prerequisites and deploy your first module.
+
+ 2. 📦 [Modular PostgreSQL Development with Database Packages](https://constructive.io/learn/modular-postgres)
+Learn to organize PostgreSQL projects with pgpm workspaces and reusable database modules.
+
+ 3. ✏️ [Authoring Database Changes](https://constructive.io/learn/authoring-database-changes)
+Master the workflow for adding, organizing, and managing database changes with pgpm.
 
-### 🤖 AI & Agent Development
+ 4. 🧪 [End-to-End PostgreSQL Testing with TypeScript](https://constructive.io/learn/e2e-postgres-testing)
+Master end-to-end PostgreSQL testing with ephemeral databases, RLS testing, and CI/CD automation.
 
-* [agentic-kit](https://github.com/constructive-io/agentic-kit): **🧰 Provider-agnostic LLM adapter** with streaming and multi-turn support. Swap between Anthropic, OpenAI, Ollama, and any OpenAI-compatible endpoint.
+ 5. ⚡ [Supabase Testing](https://constructive.io/learn/supabase)
+Use TypeScript-first tools to test Supabase projects with realistic RLS, policies, and auth contexts.
+
+ 6. 💧 [Drizzle ORM Testing](https://constructive.io/learn/drizzle-testing)
+Run full-stack tests with Drizzle ORM, including database setup, teardown, and RLS enforcement.
+
+ 7. 🔧 [Troubleshooting](https://constructive.io/learn/troubleshooting)
+Common issues and solutions for pgpm, PostgreSQL, and testing.
+
+## Related Constructive Tooling
 
 ### 📦 Package Management
 
@@ -136,14 +155,33 @@ Use `createOpenAIKit`, `createAnthropicKit`, `createOllamaKit`, or
 * [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
 * [pgsql-seed](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-seed): **🌱 PostgreSQL seeding utilities** for CSV, JSON, SQL data loading, and pgpm deployment.
 * [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
+* [graphile-test](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
+* [pg-query-context](https://github.com/constructive-io/constructive/tree/main/postgres/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
 
 ### 🧠 Parsing & AST
 
 * [pgsql-parser](https://www.npmjs.com/package/pgsql-parser): **🔄 SQL conversion engine** that interprets and converts PostgreSQL syntax.
 * [libpg-query-node](https://www.npmjs.com/package/libpg-query): **🌉 Node.js bindings** for `libpg_query`, converting SQL into parse trees.
+* [pg-proto-parser](https://www.npmjs.com/package/pg-proto-parser): **📦 Protobuf parser** for parsing PostgreSQL Protocol Buffers definitions to generate TypeScript interfaces, utility functions, and JSON mappings for enums.
+* [@pgsql/enums](https://www.npmjs.com/package/@pgsql/enums): **🏷️ TypeScript enums** for PostgreSQL AST for safe and ergonomic parsing logic.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
+### 📚 Documentation & Skills
+
+* [constructive-skills](https://github.com/constructive-io/constructive-skills): **📖 Platform documentation and AI agent skills** — feature catalog, blueprint reference, SDK guides (i18n, billing, limits, events, uploads, security, entities, search, AI), and deployment guides.
+
+Install skills for AI coding agents:
+
+```bash
+# All platform skills (security, blueprints, codegen, billing, etc.)
+npx skills add constructive-io/constructive-skills
+
+# Individual repo skills (pgpm, testing, CLI, search, etc.)
+npx skills add https://github.com/constructive-io/constructive --skill pgpm
+npx skills add https://github.com/constructive-io/constructive --skill constructive-testing
+```
+
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/esm/index.js

@@ -1,15 +1,12 @@
 import { ANTHROPIC_MODELS, AnthropicAdapter } from '@agentic-kit/anthropic';
 import { OLLAMA_MODELS, OllamaAdapter, OllamaClient } from '@agentic-kit/ollama';
 import { OPENAI_COMPATIBLE_MODELS, OpenAIAdapter, } from '@agentic-kit/openai';
-import { createAssistantMessageEventStream, EventStream } from './event-stream.js';
-import { createEmptyUsage, getMessageText, normalizeContext } from './messages.js';
+import { createAssistantMessageEventStream, createEmptyUsage, EventStream, getMessageText, normalizeContext, } from '@agentic-kit/protocol';
 import { clearModels, getModel, getModels, getProviders as getModelProviders, registerModel, registerModels, } from './model-registry.js';
 import { clearProviders, getProvider as getRegisteredProvider, getProviders as getRegisteredProviders, registerProvider, unregisterProviders, } from './provider-registry.js';
 import { transformMessages } from './transform-messages.js';
-export * from './event-stream.js';
-export * from './messages.js';
 export * from './transform-messages.js';
-export * from './types.js';
+export * from '@agentic-kit/protocol';
 export { createAssistantMessageEventStream, EventStream, OllamaClient };
 export { AnthropicAdapter, OllamaAdapter, OpenAIAdapter };
 registerModels([...OPENAI_COMPATIBLE_MODELS, ...ANTHROPIC_MODELS, ...OLLAMA_MODELS]);

package/index.d.ts

@@ -1,14 +1,11 @@
 import { AnthropicAdapter, type AnthropicOptions } from '@agentic-kit/anthropic';
 import { OllamaAdapter, OllamaClient } from '@agentic-kit/ollama';
 import { OpenAIAdapter, type OpenAIOptions } from '@agentic-kit/openai';
-import { createAssistantMessageEventStream, EventStream } from './event-stream.js';
+import { type AssistantMessage, type AssistantMessageEventStream, type Context, createAssistantMessageEventStream, EventStream, type LegacyChatMessage, type LegacyGenerateInput, type LegacyStreamingOptions, type ModelDescriptor, type ProviderAdapter, type StreamOptions } from '@agentic-kit/protocol';
 import { clearModels, getModel, getModels, getProviders as getModelProviders, registerModel, registerModels } from './model-registry.js';
 import { clearProviders, getProvider as getRegisteredProvider, getProviders as getRegisteredProviders, registerProvider, unregisterProviders } from './provider-registry.js';
-import type { AssistantMessage, AssistantMessageEventStream, Context, LegacyChatMessage, LegacyGenerateInput, LegacyStreamingOptions, ModelDescriptor, ProviderAdapter, StreamOptions } from './types.js';
-export * from './event-stream.js';
-export * from './messages.js';
 export * from './transform-messages.js';
-export * from './types.js';
+export * from '@agentic-kit/protocol';
 export { createAssistantMessageEventStream, EventStream, OllamaClient };
 export { AnthropicAdapter, OllamaAdapter, OpenAIAdapter };
 export type { AnthropicOptions, OpenAIOptions };

package/index.js

@@ -29,10 +29,9 @@ Object.defineProperty(exports, "OllamaAdapter", { enumerable: true, get: functio
 Object.defineProperty(exports, "OllamaClient", { enumerable: true, get: function () { return ollama_1.OllamaClient; } });
 const openai_1 = require("@agentic-kit/openai");
 Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return openai_1.OpenAIAdapter; } });
-const event_stream_js_1 = require("./event-stream.js");
-Object.defineProperty(exports, "createAssistantMessageEventStream", { enumerable: true, get: function () { return event_stream_js_1.createAssistantMessageEventStream; } });
-Object.defineProperty(exports, "EventStream", { enumerable: true, get: function () { return event_stream_js_1.EventStream; } });
-const messages_js_1 = require("./messages.js");
+const protocol_1 = require("@agentic-kit/protocol");
+Object.defineProperty(exports, "createAssistantMessageEventStream", { enumerable: true, get: function () { return protocol_1.createAssistantMessageEventStream; } });
+Object.defineProperty(exports, "EventStream", { enumerable: true, get: function () { return protocol_1.EventStream; } });
 const model_registry_js_1 = require("./model-registry.js");
 Object.defineProperty(exports, "clearModels", { enumerable: true, get: function () { return model_registry_js_1.clearModels; } });
 Object.defineProperty(exports, "getModel", { enumerable: true, get: function () { return model_registry_js_1.getModel; } });
@@ -47,10 +46,8 @@ Object.defineProperty(exports, "getRegisteredProviders", { enumerable: true, get
 Object.defineProperty(exports, "registerProvider", { enumerable: true, get: function () { return provider_registry_js_1.registerProvider; } });
 Object.defineProperty(exports, "unregisterProviders", { enumerable: true, get: function () { return provider_registry_js_1.unregisterProviders; } });
 const transform_messages_js_1 = require("./transform-messages.js");
-__exportStar(require("./event-stream.js"), exports);
-__exportStar(require("./messages.js"), exports);
 __exportStar(require("./transform-messages.js"), exports);
-__exportStar(require("./types.js"), exports);
+__exportStar(require("@agentic-kit/protocol"), exports);
 (0, model_registry_js_1.registerModels)([...openai_1.OPENAI_COMPATIBLE_MODELS, ...anthropic_1.ANTHROPIC_MODELS, ...ollama_1.OLLAMA_MODELS]);
 (0, provider_registry_js_1.registerProvider)(new openai_1.OpenAIAdapter());
 (0, provider_registry_js_1.registerProvider)(new anthropic_1.AnthropicAdapter({ apiKey: '' }));
@@ -68,7 +65,7 @@ async function complete(model, context, options) {
 }
 async function completeText(model, context, options) {
     const message = await complete(model, context, options);
-    return (0, messages_js_1.getMessageText)(message);
+    return (0, protocol_1.getMessageText)(message);
 }
 class AgentKit {
     providers = new Map();
@@ -126,7 +123,7 @@ class AgentKit {
         try {
             const message = assertLegacyGenerateSucceeded(await completeWithProvider(provider, model, context, streamOptions));
             options?.onStateChange?.('complete');
-            const text = (0, messages_js_1.getMessageText)(message);
+            const text = (0, protocol_1.getMessageText)(message);
             options?.onComplete?.();
             return text;
         }
@@ -167,7 +164,7 @@ function legacyInputToContext(input) {
                 provider: 'legacy',
                 model: input.model,
                 content: [{ type: 'text', text: message.content }],
-                usage: (0, messages_js_1.createEmptyUsage)(),
+                usage: (0, protocol_1.createEmptyUsage)(),
                 stopReason: 'stop',
                 timestamp: Date.now(),
             }
@@ -202,7 +199,7 @@ function createLegacyModel(provider, modelId, maxTokens) {
     };
 }
 function streamWithProvider(provider, model, context, options) {
-    const normalized = (0, messages_js_1.normalizeContext)(context);
+    const normalized = (0, protocol_1.normalizeContext)(context);
     const transformedContext = {
         ...normalized,
         messages: (0, transform_messages_js_1.transformMessages)(normalized.messages, model),

package/model-registry.d.ts

@@ -1,4 +1,4 @@
-import type { ModelDescriptor } from './types.js';
+import type { ModelDescriptor } from '@agentic-kit/protocol';
 export declare function registerModel(model: ModelDescriptor): void;
 export declare function registerModels(models: ModelDescriptor[]): void;
 export declare function getModel(provider: string, modelId: string): ModelDescriptor | undefined;

package/package.json

@@ -1,19 +1,12 @@
 {
   "name": "agentic-kit",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "Provider-agnostic LLM adapter with streaming and multi-turn support",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "import": "./esm/index.js",
-      "require": "./index.js"
-    }
-  },
-  "homepage": "https://github.com/constructive-io/agentic-kit",
+  "homepage": "https://github.com/constructive-io/constructive",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {
     "access": "public",
@@ -21,26 +14,26 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/constructive-io/agentic-kit"
+    "url": "https://github.com/constructive-io/constructive"
   },
   "bugs": {
-    "url": "https://github.com/constructive-io/agentic-kit/issues"
+    "url": "https://github.com/constructive-io/constructive/issues"
   },
   "scripts": {
     "clean": "makage clean",
     "prepack": "npm run build",
     "build": "makage build",
-    "postbuild": "node ../../scripts/write-esm-package-json.js",
     "build:dev": "makage build --dev",
     "lint": "eslint . --fix",
     "test": "jest",
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "@agentic-kit/anthropic": "1.2.1",
-    "@agentic-kit/ollama": "2.0.0",
-    "@agentic-kit/openai": "1.2.1"
+    "@agentic-kit/anthropic": "1.3.0",
+    "@agentic-kit/ollama": "2.1.0",
+    "@agentic-kit/openai": "1.3.0",
+    "@agentic-kit/protocol": "1.2.0"
   },
   "keywords": [],
-  "gitHead": "c2b13e65b26f14c9983e9b7cc4eafbe4919b13d4"
+  "gitHead": "fc6f9780ea1cab2c9344c2e392649ae644e84849"
 }

package/provider-registry.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderAdapter } from './types.js';
+import type { ProviderAdapter } from '@agentic-kit/protocol';
 export declare function registerProvider(adapter: ProviderAdapter, sourceId?: string): void;
 export declare function getProvider(api: string): ProviderAdapter | undefined;
 export declare function getProviders(): ProviderAdapter[];

package/transform-messages.d.ts

@@ -1,2 +1,2 @@
-import type { Message, ModelDescriptor } from './types.js';
+import type { Message, ModelDescriptor } from '@agentic-kit/protocol';
 export declare function transformMessages(messages: Message[], model: ModelDescriptor): Message[];

package/esm/event-stream.js

@@ -1,77 +0,0 @@
-export class EventStream {
-    isTerminal;
-    extractResult;
-    queue = [];
-    waiting = [];
-    done = false;
-    finalResultPromise;
-    resolveFinalResult;
-    constructor(isTerminal, extractResult) {
-        this.isTerminal = isTerminal;
-        this.extractResult = extractResult;
-        this.finalResultPromise = new Promise((resolve) => {
-            this.resolveFinalResult = resolve;
-        });
-    }
-    push(event) {
-        if (this.done) {
-            return;
-        }
-        if (this.isTerminal(event)) {
-            this.done = true;
-            this.resolveFinalResult(this.extractResult(event));
-        }
-        const waiter = this.waiting.shift();
-        if (waiter) {
-            waiter({ value: event, done: false });
-            return;
-        }
-        this.queue.push(event);
-    }
-    end(result) {
-        this.done = true;
-        if (result !== undefined) {
-            this.resolveFinalResult(result);
-        }
-        while (this.waiting.length > 0) {
-            this.waiting.shift()({ value: undefined, done: true });
-        }
-    }
-    async *[Symbol.asyncIterator]() {
-        while (true) {
-            if (this.queue.length > 0) {
-                yield this.queue.shift();
-                continue;
-            }
-            if (this.done) {
-                return;
-            }
-            const next = await new Promise((resolve) => {
-                this.waiting.push(resolve);
-            });
-            if (next.done) {
-                return;
-            }
-            yield next.value;
-        }
-    }
-    result() {
-        return this.finalResultPromise;
-    }
-}
-export class DefaultAssistantMessageEventStream extends EventStream {
-    constructor() {
-        super((event) => event.type === 'done' || event.type === 'error', (event) => {
-            if (event.type === 'done') {
-                return event.message;
-            }
-            if (event.type === 'error') {
-                return event.error;
-            }
-            throw new Error('Unexpected terminal event');
-        });
-    }
-}
-export function createAssistantMessageEventStream() {
-    return new DefaultAssistantMessageEventStream();
-}

package/esm/messages.js

@@ -1,147 +0,0 @@
-export function createEmptyUsage() {
-    return {
-        input: 0,
-        output: 0,
-        reasoning: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-        totalTokens: 0,
-        cost: {
-            input: 0,
-            output: 0,
-            cacheRead: 0,
-            cacheWrite: 0,
-            total: 0,
-        },
-    };
-}
-export function calculateUsageCost(model, usage) {
-    const schedule = model.cost;
-    usage.cost.input = ((schedule?.input ?? 0) / 1_000_000) * usage.input;
-    usage.cost.output = ((schedule?.output ?? 0) / 1_000_000) * usage.output;
-    usage.cost.cacheRead = ((schedule?.cacheRead ?? 0) / 1_000_000) * usage.cacheRead;
-    usage.cost.cacheWrite = ((schedule?.cacheWrite ?? 0) / 1_000_000) * usage.cacheWrite;
-    usage.cost.total =
-        usage.cost.input + usage.cost.output + usage.cost.cacheRead + usage.cost.cacheWrite;
-}
-export function snapshotUsage(usage) {
-    return { ...usage, cost: { ...usage.cost } };
-}
-export function addUsage(target, delta) {
-    target.input += delta.input;
-    target.output += delta.output;
-    target.reasoning += delta.reasoning;
-    target.cacheRead += delta.cacheRead;
-    target.cacheWrite += delta.cacheWrite;
-    target.totalTokens += delta.totalTokens;
-    target.cost.input += delta.cost.input;
-    target.cost.output += delta.cost.output;
-    target.cost.cacheRead += delta.cost.cacheRead;
-    target.cost.cacheWrite += delta.cost.cacheWrite;
-    target.cost.total += delta.cost.total;
-    return target;
-}
-export function createAssistantMessage(model) {
-    return {
-        role: 'assistant',
-        api: model.api,
-        provider: model.provider,
-        model: model.id,
-        content: [],
-        usage: createEmptyUsage(),
-        stopReason: 'stop',
-        timestamp: Date.now(),
-    };
-}
-export function createTextContent(text = '') {
-    return { type: 'text', text };
-}
-export function createImageContent(data, mimeType) {
-    return { type: 'image', data, mimeType };
-}
-export function createToolCall(id, name) {
-    return { type: 'toolCall', id, name, arguments: {}, rawArguments: '' };
-}
-export function createUserMessage(content) {
-    return {
-        role: 'user',
-        content,
-        timestamp: Date.now(),
-    };
-}
-export function createToolResultMessage(toolCallId, toolName, content, isError = false) {
-    return {
-        role: 'toolResult',
-        toolCallId,
-        toolName,
-        content,
-        isError,
-        timestamp: Date.now(),
-    };
-}
-export function getMessageText(message) {
-    return message.content
-        .filter((block) => block.type === 'text')
-        .map((block) => block.text)
-        .join('');
-}
-const DEFAULT_DEFERRAL_TEXT = 'User did not respond. Continue.';
-/**
- * Synthesize toolResult messages for every toolCall that lacks both a decision
- * and a paired toolResult. Returns input unchanged (referentially equal) when
- * nothing needs synthesizing.
- *
- * Use case: user types a message instead of clicking approve/deny on a paused
- * tool. The agent can't resume on text alone — every dangling toolCall needs
- * a result before the next request. Compose with sendMessages to forward the
- * conversation cleanly:
- *
- *   await sendMessages([...injectDeferralResults(messages), createUserMessage(text)]);
- */
-export function injectDeferralResults(messages, optionsOrText = {}) {
-    const opts = typeof optionsOrText === 'string' ? { deferralText: optionsOrText } : optionsOrText;
-    const deferralText = opts.deferralText ?? DEFAULT_DEFERRAL_TEXT;
-    const completed = new Set();
-    for (const m of messages) {
-        if (m.role === 'toolResult')
-            completed.add(m.toolCallId);
-    }
-    const synthetic = [];
-    for (const m of messages) {
-        if (m.role !== 'assistant')
-            continue;
-        for (const block of m.content) {
-            if (block.type !== 'toolCall')
-                continue;
-            if (completed.has(block.id))
-                continue;
-            if ('decision' in block && block.decision !== undefined)
-                continue;
-            const result = createToolResultMessage(block.id, block.name, [
-                { type: 'text', text: deferralText },
-            ]);
-            if (opts.details !== undefined)
-                result.details = opts.details;
-            synthetic.push(result);
-        }
-    }
-    if (synthetic.length === 0)
-        return messages;
-    return [...messages, ...synthetic];
-}
-export function cloneMessage(message) {
-    return JSON.parse(JSON.stringify(message));
-}
-export function normalizeContext(context) {
-    return {
-        systemPrompt: context.systemPrompt,
-        tools: context.tools ?? [],
-        messages: context.messages.map((message) => ensureTimestamp(cloneMessage(message))),
-    };
-}
-function ensureTimestamp(message) {
-    if (typeof message.timestamp !== 'number') {
-        message.timestamp = Date.now();
-    }
-    return message;
-}

package/esm/package.json

@@ -1 +0,0 @@
-{"type":"module"}

package/esm/types.js

@@ -1 +0,0 @@
-export {};

package/event-stream.d.ts

@@ -1,19 +0,0 @@
-import type { AssistantMessage, AssistantMessageEvent, AssistantMessageEventStream } from './types.js';
-export declare class EventStream<TEvent, TResult = TEvent> implements AsyncIterable<TEvent> {
-    private readonly isTerminal;
-    private readonly extractResult;
-    private readonly queue;
-    private readonly waiting;
-    private done;
-    private readonly finalResultPromise;
-    private resolveFinalResult;
-    constructor(isTerminal: (event: TEvent) => boolean, extractResult: (event: TEvent) => TResult);
-    push(event: TEvent): void;
-    end(result?: TResult): void;
-    [Symbol.asyncIterator](): AsyncIterator<TEvent>;
-    result(): Promise<TResult>;
-}
-export declare class DefaultAssistantMessageEventStream extends EventStream<AssistantMessageEvent, AssistantMessage> implements AssistantMessageEventStream {
-    constructor();
-}
-export declare function createAssistantMessageEventStream(): DefaultAssistantMessageEventStream;

package/event-stream.js

@@ -1,83 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultAssistantMessageEventStream = exports.EventStream = void 0;
-exports.createAssistantMessageEventStream = createAssistantMessageEventStream;
-class EventStream {
-    isTerminal;
-    extractResult;
-    queue = [];
-    waiting = [];
-    done = false;
-    finalResultPromise;
-    resolveFinalResult;
-    constructor(isTerminal, extractResult) {
-        this.isTerminal = isTerminal;
-        this.extractResult = extractResult;
-        this.finalResultPromise = new Promise((resolve) => {
-            this.resolveFinalResult = resolve;
-        });
-    }
-    push(event) {
-        if (this.done) {
-            return;
-        }
-        if (this.isTerminal(event)) {
-            this.done = true;
-            this.resolveFinalResult(this.extractResult(event));
-        }
-        const waiter = this.waiting.shift();
-        if (waiter) {
-            waiter({ value: event, done: false });
-            return;
-        }
-        this.queue.push(event);
-    }
-    end(result) {
-        this.done = true;
-        if (result !== undefined) {
-            this.resolveFinalResult(result);
-        }
-        while (this.waiting.length > 0) {
-            this.waiting.shift()({ value: undefined, done: true });
-        }
-    }
-    async *[Symbol.asyncIterator]() {
-        while (true) {
-            if (this.queue.length > 0) {
-                yield this.queue.shift();
-                continue;
-            }
-            if (this.done) {
-                return;
-            }
-            const next = await new Promise((resolve) => {
-                this.waiting.push(resolve);
-            });
-            if (next.done) {
-                return;
-            }
-            yield next.value;
-        }
-    }
-    result() {
-        return this.finalResultPromise;
-    }
-}
-exports.EventStream = EventStream;
-class DefaultAssistantMessageEventStream extends EventStream {
-    constructor() {
-        super((event) => event.type === 'done' || event.type === 'error', (event) => {
-            if (event.type === 'done') {
-                return event.message;
-            }
-            if (event.type === 'error') {
-                return event.error;
-            }
-            throw new Error('Unexpected terminal event');
-        });
-    }
-}
-exports.DefaultAssistantMessageEventStream = DefaultAssistantMessageEventStream;
-function createAssistantMessageEventStream() {
-    return new DefaultAssistantMessageEventStream();
-}

package/messages.d.ts

@@ -1,33 +0,0 @@
-import type { AssistantMessage, Context, ImageContent, Message, ModelDescriptor, TextContent, ToolCallContent, ToolResultMessage, Usage, UserMessage } from './types.js';
-export declare function createEmptyUsage(): Usage;
-export declare function calculateUsageCost(model: ModelDescriptor, usage: Usage): void;
-export declare function snapshotUsage(usage: Usage): Usage;
-export declare function addUsage(target: Usage, delta: Usage): Usage;
-export declare function createAssistantMessage(model: ModelDescriptor): AssistantMessage;
-export declare function createTextContent(text?: string): TextContent;
-export declare function createImageContent(data: string, mimeType: string): ImageContent;
-export declare function createToolCall(id: string, name: string): ToolCallContent;
-export declare function createUserMessage(content: UserMessage['content']): UserMessage;
-export declare function createToolResultMessage(toolCallId: string, toolName: string, content: ToolResultMessage['content'], isError?: boolean): ToolResultMessage;
-export declare function getMessageText(message: AssistantMessage): string;
-export interface InjectDeferralResultsOptions {
-    /** Text body for synthesized results. Defaults to a generic continue prompt. */
-    deferralText?: string;
-    /** Stamped onto each synthesized result's `details` field — typically `{ deferred: true }` so renderers can hide a "Done" badge. */
-    details?: unknown;
-}
-/**
- * Synthesize toolResult messages for every toolCall that lacks both a decision
- * and a paired toolResult. Returns input unchanged (referentially equal) when
- * nothing needs synthesizing.
- *
- * Use case: user types a message instead of clicking approve/deny on a paused
- * tool. The agent can't resume on text alone — every dangling toolCall needs
- * a result before the next request. Compose with sendMessages to forward the
- * conversation cleanly:
- *
- *   await sendMessages([...injectDeferralResults(messages), createUserMessage(text)]);
- */
-export declare function injectDeferralResults(messages: Message[], optionsOrText?: InjectDeferralResultsOptions | string): Message[];
-export declare function cloneMessage<TMessage extends Message>(message: TMessage): TMessage;
-export declare function normalizeContext(context: Context): Context;

package/messages.js

@@ -1,163 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEmptyUsage = createEmptyUsage;
-exports.calculateUsageCost = calculateUsageCost;
-exports.snapshotUsage = snapshotUsage;
-exports.addUsage = addUsage;
-exports.createAssistantMessage = createAssistantMessage;
-exports.createTextContent = createTextContent;
-exports.createImageContent = createImageContent;
-exports.createToolCall = createToolCall;
-exports.createUserMessage = createUserMessage;
-exports.createToolResultMessage = createToolResultMessage;
-exports.getMessageText = getMessageText;
-exports.injectDeferralResults = injectDeferralResults;
-exports.cloneMessage = cloneMessage;
-exports.normalizeContext = normalizeContext;
-function createEmptyUsage() {
-    return {
-        input: 0,
-        output: 0,
-        reasoning: 0,
-        cacheRead: 0,
-        cacheWrite: 0,
-        totalTokens: 0,
-        cost: {
-            input: 0,
-            output: 0,
-            cacheRead: 0,
-            cacheWrite: 0,
-            total: 0,
-        },
-    };
-}
-function calculateUsageCost(model, usage) {
-    const schedule = model.cost;
-    usage.cost.input = ((schedule?.input ?? 0) / 1_000_000) * usage.input;
-    usage.cost.output = ((schedule?.output ?? 0) / 1_000_000) * usage.output;
-    usage.cost.cacheRead = ((schedule?.cacheRead ?? 0) / 1_000_000) * usage.cacheRead;
-    usage.cost.cacheWrite = ((schedule?.cacheWrite ?? 0) / 1_000_000) * usage.cacheWrite;
-    usage.cost.total =
-        usage.cost.input + usage.cost.output + usage.cost.cacheRead + usage.cost.cacheWrite;
-}
-function snapshotUsage(usage) {
-    return { ...usage, cost: { ...usage.cost } };
-}
-function addUsage(target, delta) {
-    target.input += delta.input;
-    target.output += delta.output;
-    target.reasoning += delta.reasoning;
-    target.cacheRead += delta.cacheRead;
-    target.cacheWrite += delta.cacheWrite;
-    target.totalTokens += delta.totalTokens;
-    target.cost.input += delta.cost.input;
-    target.cost.output += delta.cost.output;
-    target.cost.cacheRead += delta.cost.cacheRead;
-    target.cost.cacheWrite += delta.cost.cacheWrite;
-    target.cost.total += delta.cost.total;
-    return target;
-}
-function createAssistantMessage(model) {
-    return {
-        role: 'assistant',
-        api: model.api,
-        provider: model.provider,
-        model: model.id,
-        content: [],
-        usage: createEmptyUsage(),
-        stopReason: 'stop',
-        timestamp: Date.now(),
-    };
-}
-function createTextContent(text = '') {
-    return { type: 'text', text };
-}
-function createImageContent(data, mimeType) {
-    return { type: 'image', data, mimeType };
-}
-function createToolCall(id, name) {
-    return { type: 'toolCall', id, name, arguments: {}, rawArguments: '' };
-}
-function createUserMessage(content) {
-    return {
-        role: 'user',
-        content,
-        timestamp: Date.now(),
-    };
-}
-function createToolResultMessage(toolCallId, toolName, content, isError = false) {
-    return {
-        role: 'toolResult',
-        toolCallId,
-        toolName,
-        content,
-        isError,
-        timestamp: Date.now(),
-    };
-}
-function getMessageText(message) {
-    return message.content
-        .filter((block) => block.type === 'text')
-        .map((block) => block.text)
-        .join('');
-}
-const DEFAULT_DEFERRAL_TEXT = 'User did not respond. Continue.';
-/**
- * Synthesize toolResult messages for every toolCall that lacks both a decision
- * and a paired toolResult. Returns input unchanged (referentially equal) when
- * nothing needs synthesizing.
- *
- * Use case: user types a message instead of clicking approve/deny on a paused
- * tool. The agent can't resume on text alone — every dangling toolCall needs
- * a result before the next request. Compose with sendMessages to forward the
- * conversation cleanly:
- *
- *   await sendMessages([...injectDeferralResults(messages), createUserMessage(text)]);
- */
-function injectDeferralResults(messages, optionsOrText = {}) {
-    const opts = typeof optionsOrText === 'string' ? { deferralText: optionsOrText } : optionsOrText;
-    const deferralText = opts.deferralText ?? DEFAULT_DEFERRAL_TEXT;
-    const completed = new Set();
-    for (const m of messages) {
-        if (m.role === 'toolResult')
-            completed.add(m.toolCallId);
-    }
-    const synthetic = [];
-    for (const m of messages) {
-        if (m.role !== 'assistant')
-            continue;
-        for (const block of m.content) {
-            if (block.type !== 'toolCall')
-                continue;
-            if (completed.has(block.id))
-                continue;
-            if ('decision' in block && block.decision !== undefined)
-                continue;
-            const result = createToolResultMessage(block.id, block.name, [
-                { type: 'text', text: deferralText },
-            ]);
-            if (opts.details !== undefined)
-                result.details = opts.details;
-            synthetic.push(result);
-        }
-    }
-    if (synthetic.length === 0)
-        return messages;
-    return [...messages, ...synthetic];
-}
-function cloneMessage(message) {
-    return JSON.parse(JSON.stringify(message));
-}
-function normalizeContext(context) {
-    return {
-        systemPrompt: context.systemPrompt,
-        tools: context.tools ?? [],
-        messages: context.messages.map((message) => ensureTimestamp(cloneMessage(message))),
-    };
-}
-function ensureTimestamp(message) {
-    if (typeof message.timestamp !== 'number') {
-        message.timestamp = Date.now();
-    }
-    return message;
-}

package/types.d.ts

@@ -1,232 +0,0 @@
-export type JsonPrimitive = string | number | boolean | null;
-export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-export interface JsonObject {
-    [key: string]: JsonValue | undefined;
-}
-export interface JsonSchema {
-    $id?: string;
-    $ref?: string;
-    additionalProperties?: boolean | JsonSchema;
-    allOf?: JsonSchema[];
-    anyOf?: JsonSchema[];
-    const?: JsonValue;
-    default?: JsonValue;
-    description?: string;
-    enum?: JsonValue[];
-    format?: string;
-    items?: JsonSchema | JsonSchema[];
-    maxItems?: number;
-    maxLength?: number;
-    maximum?: number;
-    minItems?: number;
-    minLength?: number;
-    minimum?: number;
-    oneOf?: JsonSchema[];
-    pattern?: string;
-    properties?: Record<string, JsonSchema>;
-    required?: string[];
-    title?: string;
-    type?: string | string[];
-}
-export type InputCapability = 'text' | 'image';
-export interface CostSchedule {
-    input?: number;
-    output?: number;
-    cacheRead?: number;
-    cacheWrite?: number;
-}
-export interface OpenAICompatibleCompat {
-    maxTokensField?: 'max_completion_tokens' | 'max_tokens';
-    reasoningFormat?: 'none' | 'openai';
-    supportsReasoningEffort?: boolean;
-    supportsStrictToolSchema?: boolean;
-    supportsUsageInStreaming?: boolean;
-    toolCallIdFormat?: 'passthrough' | 'safe64' | 'mistral9';
-    requiresToolResultName?: boolean;
-}
-export interface ModelDescriptor {
-    id: string;
-    name: string;
-    api: string;
-    provider: string;
-    baseUrl: string;
-    input: InputCapability[];
-    reasoning: boolean;
-    tools?: boolean;
-    contextWindow?: number;
-    maxOutputTokens?: number;
-    cost?: CostSchedule;
-    headers?: Record<string, string>;
-    compat?: OpenAICompatibleCompat;
-}
-export interface TextContent {
-    type: 'text';
-    text: string;
-}
-export interface ImageContent {
-    type: 'image';
-    data: string;
-    mimeType: string;
-}
-export interface ThinkingContent {
-    type: 'thinking';
-    thinking: string;
-    signature?: string;
-}
-export interface ToolCallContent {
-    type: 'toolCall';
-    id: string;
-    name: string;
-    arguments: Record<string, JsonValue | undefined>;
-    rawArguments?: string;
-    decision?: unknown;
-}
-export interface Usage {
-    input: number;
-    output: number;
-    reasoning: number;
-    cacheRead: number;
-    cacheWrite: number;
-    totalTokens: number;
-    cost: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-        total: number;
-    };
-}
-export type StopReason = 'stop' | 'length' | 'toolUse' | 'error' | 'aborted';
-export interface UserMessage {
-    role: 'user';
-    content: string | Array<TextContent | ImageContent>;
-    timestamp: number;
-}
-export interface AssistantMessage {
-    role: 'assistant';
-    content: Array<TextContent | ThinkingContent | ToolCallContent>;
-    api: string;
-    provider: string;
-    model: string;
-    usage: Usage;
-    stopReason: StopReason;
-    errorMessage?: string;
-    timestamp: number;
-}
-export interface ToolResultMessage<TDetails = unknown> {
-    role: 'toolResult';
-    toolCallId: string;
-    toolName: string;
-    content: Array<TextContent | ImageContent>;
-    isError: boolean;
-    details?: TDetails;
-    timestamp: number;
-}
-export type Message = UserMessage | AssistantMessage | ToolResultMessage;
-export interface ToolDefinition<TSchema extends JsonSchema = JsonSchema> {
-    name: string;
-    description: string;
-    parameters: TSchema;
-}
-export interface Context {
-    systemPrompt?: string;
-    messages: Message[];
-    tools?: ToolDefinition[];
-}
-export type CacheRetention = 'none' | 'short' | 'long';
-export interface StreamOptions {
-    apiKey?: string;
-    cacheRetention?: CacheRetention;
-    headers?: Record<string, string>;
-    maxRetryDelayMs?: number;
-    maxTokens?: number;
-    metadata?: Record<string, JsonValue | undefined>;
-    onPayload?: (payload: unknown) => void;
-    reasoning?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    sessionId?: string;
-    signal?: AbortSignal;
-    temperature?: number;
-}
-export type AssistantMessageEvent = {
-    type: 'start';
-    partial: AssistantMessage;
-} | {
-    type: 'text_start';
-    contentIndex: number;
-    partial: AssistantMessage;
-} | {
-    type: 'text_delta';
-    contentIndex: number;
-    delta: string;
-    partial: AssistantMessage;
-} | {
-    type: 'text_end';
-    contentIndex: number;
-    content: string;
-    partial: AssistantMessage;
-} | {
-    type: 'thinking_start';
-    contentIndex: number;
-    partial: AssistantMessage;
-} | {
-    type: 'thinking_delta';
-    contentIndex: number;
-    delta: string;
-    partial: AssistantMessage;
-} | {
-    type: 'thinking_end';
-    contentIndex: number;
-    content: string;
-    partial: AssistantMessage;
-} | {
-    type: 'toolcall_start';
-    contentIndex: number;
-    partial: AssistantMessage;
-} | {
-    type: 'toolcall_delta';
-    contentIndex: number;
-    delta: string;
-    partial: AssistantMessage;
-} | {
-    type: 'toolcall_end';
-    contentIndex: number;
-    toolCall: ToolCallContent;
-    partial: AssistantMessage;
-} | {
-    type: 'done';
-    reason: Extract<StopReason, 'stop' | 'length' | 'toolUse'>;
-    message: AssistantMessage;
-} | {
-    type: 'error';
-    reason: Extract<StopReason, 'error' | 'aborted'>;
-    error: AssistantMessage;
-};
-export interface ProviderAdapter<TOptions extends StreamOptions = StreamOptions> {
-    api: string;
-    provider: string;
-    createModel?: (modelId: string, overrides?: Partial<ModelDescriptor>) => ModelDescriptor;
-    listModels?: (options?: Pick<StreamOptions, 'apiKey' | 'headers'>) => Promise<Array<ModelDescriptor | string>>;
-    stream: (model: ModelDescriptor, context: Context, options?: TOptions) => AssistantMessageEventStream;
-}
-export interface LegacyChatMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}
-export interface LegacyGenerateInput {
-    model: string;
-    prompt?: string;
-    messages?: LegacyChatMessage[];
-    system?: string;
-    stream?: boolean;
-    temperature?: number;
-    maxTokens?: number;
-}
-export interface LegacyStreamingOptions {
-    onChunk?: (chunk: string) => void;
-    onComplete?: () => void;
-    onError?: (error: Error) => void;
-    onStateChange?: (state: string) => void;
-}
-export interface AssistantMessageEventStream extends AsyncIterable<AssistantMessageEvent> {
-    result(): Promise<AssistantMessage>;
-}

package/types.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });