@elfenlabs/cog 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elfenlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.

package/README.md

@@ -0,0 +1,295 @@
+# 🧠 Cog
+
+A minimal agent SDK for TypeScript. Three primitives, zero opinions on your LLM provider.
+
+```
+npm install @elfenlabs/cog
+```
+
+## Quick Start
+
+```typescript
+import { createContext, createTool, createOpenAIProvider, runAgent } from '@elfenlabs/cog'
+
+// Define a tool
+const getWeather = createTool({
+  id: 'get_weather',
+  description: 'Get the current weather for a city',
+  schema: {
+    city: { type: 'string', description: 'The city name' },
+  },
+  execute: async (args) => {
+    const { city } = args as { city: string }
+    return { city, temp: 22, condition: 'sunny' }
+  },
+})
+
+// Create context and provider
+const ctx = createContext()
+ctx.push("What's the weather in Tokyo?")
+
+const provider = createOpenAIProvider('https://api.openai.com', 'gpt-4o', {
+  apiKey: process.env.OPENAI_API_KEY,
+})
+
+// Run the agent
+const result = await runAgent({
+  ctx,
+  provider,
+  instruction: 'You are a helpful assistant. Use tools when needed.',
+  tools: [getWeather],
+})
+
+console.log(result.response) // "The weather in Tokyo is 22°C and sunny."
+console.log(result.steps)    // 2
+console.log(result.usage)    // { promptTokens, completionTokens, totalTokens }
+```
+
+## Primitives
+
+| Primitive | What it is |
+|---|---|
+| **Context** | Append-only message chain. You push messages in, the agent loop reads them out. |
+| **Tool** | Schema + execute function. The agent calls tools automatically based on model output. |
+| **Agent** | The loop. Calls the provider, executes tool calls, repeats until the model responds with text. |
+
+## Context
+
+An ordered `Message[]` chain. Push strings (become `user` messages) or full `Message` objects.
+
+```typescript
+import { createContext } from '@elfenlabs/cog'
+
+const ctx = createContext()
+
+// Strings become user messages
+ctx.push('What is 2 + 2?')
+
+// Full messages for other roles
+ctx.push({ role: 'system', content: 'You are a math tutor.' })
+
+// Read messages
+ctx.messages // readonly Message[]
+
+// Serialize / restore
+const snapshot = ctx.serialize()
+const restored = createContext({ from: snapshot })
+```
+
+### Message Shape
+
+```typescript
+type Message = {
+  role: 'system' | 'user' | 'assistant' | 'tool'
+  content: string
+  reasoning?: string        // chain-of-thought from reasoning models
+  toolCallId?: string       // links tool results back to the call
+  toolCalls?: ToolCallRequest[]  // tool calls requested by the model
+}
+```
+
+## Tool
+
+A tool is an `id`, a `description`, a `schema`, and an `execute` function.
+
+```typescript
+import { createTool } from '@elfenlabs/cog'
+
+const calculator = createTool({
+  id: 'calculator',
+  description: 'Evaluate a math expression',
+  schema: {
+    expression: { type: 'string', description: 'The expression to evaluate', required: true },
+  },
+  execute: async (args) => {
+    const { expression } = args as { expression: string }
+    return { result: eval(expression) }
+  },
+})
+
+// The .spec property gives you the wire format for provider APIs
+calculator.spec // { name, description, parameters }
+```
+
+### Parameter Types
+
+```typescript
+type ToolParameter = {
+  type: 'string' | 'number' | 'boolean'
+  description: string
+  required?: boolean  // default: true
+}
+```
+
+## Agent Loop
+
+`runAgent` calls the provider in a loop, executing tool calls until the model responds with text only.
+
+```typescript
+import { runAgent } from '@elfenlabs/cog'
+
+const result = await runAgent({
+  ctx,                    // Context — the conversation so far
+  provider,               // Provider — any LLM backend
+  instruction: '...',     // system prompt (prepended to every call)
+  tools: [tool1, tool2],  // available tools
+
+  // Limits
+  maxSteps: 50,           // default: 50
+  signal: abortController.signal,
+
+  // Streaming callbacks
+  onThinkingStart: () => {},
+  onThinking: (chunk) => {},      // reasoning tokens (dim/hidden)
+  onThinkingEnd: () => {},
+  onOutputStart: () => {},
+  onOutput: (chunk) => {},        // content tokens (visible)
+  onOutputEnd: () => {},
+
+  // Tool lifecycle hooks
+  onBeforeToolCall: async (tool, args) => {
+    // return false to block the call
+  },
+  onAfterToolCall: (tool, args, result) => {},
+})
+
+result.response  // final text response
+result.steps     // number of provider calls made
+result.usage     // { promptTokens, completionTokens, totalTokens }
+```
+
+### How the Loop Works
+
+```
+┌─────────────────────────────────────────────┐
+│  system prompt + ctx.messages → provider    │
+│                    ↓                        │
+│  ┌─ tool calls? ──────────────────────────┐ │
+│  │ YES → execute tools → push results     │ │
+│  │       → loop back to provider          │ │
+│  ├─ text content? ────────────────────────┤ │
+│  │ YES → push assistant message → return  │ │
+│  ├─ reasoning only? ─────────────────────┤  │
+│  │ YES → push reasoning → loop           │  │
+│  └────────────────────────────────────────┘ │
+└─────────────────────────────────────────────┘
+```
+
+## Provider
+
+The `Provider` interface is a single method. Implement it for any LLM backend.
+
+```typescript
+interface Provider {
+  generate(params: {
+    messages: Message[]
+    tools?: ToolSpec[]
+    signal?: AbortSignal
+    stream?: StreamCallbacks
+  }): Promise<GenerateResult>
+}
+
+type GenerateResult = {
+  content?: string
+  reasoning?: string
+  toolCalls?: ToolCallRequest[]
+  usage?: Usage
+}
+
+type StreamCallbacks = {
+  onReasoning?: (chunk: string) => void
+  onContent?: (chunk: string) => void
+}
+```
+
+### Built-in: OpenAI-Compatible Provider
+
+Works with OpenAI, vLLM, OpenRouter, Ollama, LiteLLM, and any OpenAI-compatible API. Supports streaming (SSE) with reasoning model support (`reasoning_content`).
+
+```typescript
+import { createOpenAIProvider } from '@elfenlabs/cog'
+
+// OpenAI
+const openai = createOpenAIProvider('https://api.openai.com', 'gpt-4o', {
+  apiKey: process.env.OPENAI_API_KEY,
+})
+
+// Local vLLM
+const vllm = createOpenAIProvider('http://localhost:8000', 'my-model')
+
+// OpenRouter
+const openrouter = createOpenAIProvider('https://openrouter.ai/api', 'anthropic/claude-sonnet-4.5', {
+  apiKey: process.env.OPENROUTER_API_KEY,
+  temperature: 0.2,
+})
+```
+
+## Sub-Agent Composition
+
+Agents are just functions. Wrap `runAgent` inside a tool to create sub-agents with isolated context.
+
+```typescript
+const searchOrders = createTool({
+  id: 'search_orders',
+  description: 'Search through paginated orders to find a match',
+  schema: {
+    query: { type: 'string', description: 'What to search for' },
+  },
+  execute: async (args) => {
+    const { query } = args as { query: string }
+
+    // Sub-agent gets its own isolated context
+    const subCtx = createContext()
+    subCtx.push(`Find: ${query}`)
+
+    const fetchPage = createTool({
+      id: 'fetch_page',
+      description: 'Fetch a page of orders',
+      schema: { page: { type: 'number', description: 'Page number' } },
+      execute: async (a) => api.getOrders((a as { page: number }).page),
+    })
+
+    const result = await runAgent({
+      ctx: subCtx,
+      provider,
+      instruction: 'Search through pages until you find the item or exhaust all pages.',
+      tools: [fetchPage],
+      maxSteps: 20,
+    })
+
+    // Only the final answer bubbles up — no pagination noise in parent context
+    return result.response
+  },
+})
+
+// Parent agent uses the sub-agent as a regular tool
+const result = await runAgent({
+  ctx: createContext(),
+  provider,
+  instruction: 'Use search_orders to look up order information.',
+  tools: [searchOrders],
+})
+```
+
+## Error Handling
+
+```typescript
+import { MaxStepsError, AgentAbortError } from '@elfenlabs/cog'
+
+try {
+  await runAgent({ ctx, provider, instruction: '...', tools, maxSteps: 10 })
+} catch (err) {
+  if (err instanceof MaxStepsError) {
+    // Agent exceeded step limit
+  }
+  if (err instanceof AgentAbortError) {
+    // AbortSignal was triggered
+  }
+}
+```
+
+Unknown tool calls and tool execution errors are automatically caught and fed back to the model as `tool` messages, letting it recover gracefully.
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Cog v2 — Agent Loop
+ *
+ * The heart of the library. Calls the model in a loop,
+ * executing tool calls until the model responds with text only.
+ */
+import type { Context } from './context.js';
+import type { Tool } from './tool.js';
+import type { Provider, Usage } from './types.js';
+export type AgentConfig = {
+    ctx: Context;
+    provider: Provider;
+    instruction: string;
+    tools: Tool<any>[];
+    maxSteps?: number;
+    signal?: AbortSignal;
+    onThinkingStart?: () => void;
+    onThinking?: (chunk: string) => void;
+    onThinkingEnd?: () => void;
+    onOutputStart?: () => void;
+    onOutput?: (chunk: string) => void;
+    onOutputEnd?: () => void;
+    onBeforeToolCall?: (tool: Tool<any>, args: Record<string, unknown>) => Promise<boolean | void> | boolean | void;
+    onAfterToolCall?: (tool: Tool<any>, args: Record<string, unknown>, result: unknown) => void;
+};
+export type AgentResult = {
+    response: string;
+    steps: number;
+    usage: Usage;
+};
+export declare class MaxStepsError extends Error {
+    constructor(maxSteps: number);
+}
+export declare class AgentAbortError extends Error {
+    constructor();
+}
+export declare function runAgent(config: AgentConfig): Promise<AgentResult>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAW,QAAQ,EAAmB,KAAK,EAAE,MAAM,YAAY,CAAA;AAI3E,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,OAAO,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,gBAAgB,CAAC,EAAE,CACjB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,CAAA;IAC7C,eAAe,CAAC,EAAE,CAChB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,KACZ,IAAI,CAAA;CACV,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAA;CACb,CAAA;AAID,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAID,wBAAsB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAwMxE"}

package/dist/agent.js

@@ -0,0 +1,183 @@
+/**
+ * Cog v2 — Agent Loop
+ *
+ * The heart of the library. Calls the model in a loop,
+ * executing tool calls until the model responds with text only.
+ */
+// ── Errors ──────────────────────────────────────────────────────────────────
+export class MaxStepsError extends Error {
+    constructor(maxSteps) {
+        super(`Agent exceeded maximum steps (${maxSteps})`);
+        this.name = 'MaxStepsError';
+    }
+}
+export class AgentAbortError extends Error {
+    constructor() {
+        super('Agent was aborted');
+        this.name = 'AgentAbortError';
+    }
+}
+// ── Agent Loop ──────────────────────────────────────────────────────────────
+export async function runAgent(config) {
+    const { ctx, provider, instruction, tools, maxSteps = 50, signal, onThinkingStart, onThinking, onThinkingEnd, onOutputStart, onOutput, onOutputEnd, onBeforeToolCall, onAfterToolCall, } = config;
+    const toolMap = new Map(tools.map(t => [t.id, t]));
+    const toolSpecs = tools.map(t => t.spec);
+    let steps = 0;
+    let isThinking = false;
+    let isOutputting = false;
+    const totalUsage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    /** End reasoning block if one is active */
+    const endThinking = () => {
+        if (isThinking) {
+            isThinking = false;
+            onThinkingEnd?.();
+        }
+    };
+    /** End output block if one is active */
+    const endOutput = () => {
+        if (isOutputting) {
+            isOutputting = false;
+            onOutputEnd?.();
+        }
+    };
+    while (true) {
+        // Check abort
+        if (signal?.aborted) {
+            throw new AgentAbortError();
+        }
+        // Check step limit
+        if (steps >= maxSteps) {
+            throw new MaxStepsError(maxSteps);
+        }
+        // Build messages: instruction as system prompt + context messages
+        const messages = [
+            { role: 'system', content: instruction },
+            ...ctx.messages,
+        ];
+        // Build stream callbacks for the provider
+        // Wrap onThinking to manage start/end lifecycle
+        const wrappedOnThinking = onThinking
+            ? (chunk) => {
+                if (!isThinking) {
+                    isThinking = true;
+                    onThinkingStart?.();
+                }
+                onThinking(chunk);
+            }
+            : undefined;
+        const wrappedOnOutput = onOutput
+            ? (chunk) => {
+                if (!isOutputting) {
+                    isOutputting = true;
+                    onOutputStart?.();
+                }
+                onOutput(chunk);
+            }
+            : undefined;
+        const stream = wrappedOnThinking || wrappedOnOutput
+            ? {
+                onReasoning: wrappedOnThinking,
+                onContent: wrappedOnOutput,
+            }
+            : undefined;
+        // Call the provider
+        const result = await provider.generate({
+            messages,
+            tools: toolSpecs.length > 0 ? toolSpecs : undefined,
+            signal,
+            stream,
+        });
+        steps++;
+        // Accumulate token usage
+        if (result.usage) {
+            totalUsage.promptTokens += result.usage.promptTokens;
+            totalUsage.completionTokens += result.usage.completionTokens;
+            totalUsage.totalTokens += result.usage.totalTokens;
+        }
+        // Case 1: Model returned tool calls → execute and loop
+        if (result.toolCalls && result.toolCalls.length > 0) {
+            endThinking();
+            // Append the assistant message with tool calls to context
+            ctx.push({
+                role: 'assistant',
+                content: result.content ?? '',
+                reasoning: result.reasoning,
+                toolCalls: result.toolCalls,
+            });
+            for (const call of result.toolCalls) {
+                const tool = toolMap.get(call.name);
+                if (!tool) {
+                    // Unknown tool — append error as tool result so model can recover
+                    ctx.push({
+                        role: 'tool',
+                        content: `Error: unknown tool "${call.name}"`,
+                        toolCallId: call.id,
+                    });
+                    continue;
+                }
+                // Hook: before
+                if (onBeforeToolCall) {
+                    const allowed = await onBeforeToolCall(tool, call.arguments);
+                    if (allowed === false) {
+                        ctx.push({
+                            role: 'tool',
+                            content: 'Error: tool call was blocked',
+                            toolCallId: call.id,
+                        });
+                        continue;
+                    }
+                }
+                // Execute the tool
+                try {
+                    const toolResult = await tool.execute(call.arguments, ctx);
+                    const content = typeof toolResult === 'string'
+                        ? toolResult
+                        : JSON.stringify(toolResult);
+                    ctx.push({
+                        role: 'tool',
+                        content,
+                        toolCallId: call.id,
+                    });
+                    // Hook: after
+                    if (onAfterToolCall) {
+                        onAfterToolCall(tool, call.arguments, toolResult);
+                    }
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    ctx.push({
+                        role: 'tool',
+                        content: `Error: ${message}`,
+                        toolCallId: call.id,
+                    });
+                }
+            }
+            // Continue the loop
+            continue;
+        }
+        // Case 2: Model returned text only → done
+        if (result.content) {
+            endThinking();
+            endOutput();
+            ctx.push({
+                role: 'assistant',
+                content: result.content,
+                reasoning: result.reasoning,
+            });
+            return { response: result.content, steps, usage: totalUsage };
+        }
+        // Case 3: Reasoning only (no content, no tool calls) — continue loop
+        // Reasoning models sometimes produce a think step before acting.
+        if (result.reasoning) {
+            ctx.push({
+                role: 'assistant',
+                content: '',
+                reasoning: result.reasoning,
+            });
+            continue;
+        }
+        // Case 4: Nothing at all — error
+        throw new Error('Provider returned neither content nor tool calls');
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Cog v2 — Context
+ *
+ * Append-only message chain. Push messages in, serialize out.
+ */
+import type { Message } from './types.js';
+export type SerializedContext = {
+    messages: Message[];
+};
+export type ContextOptions = {
+    /** Restore from a serialized snapshot */
+    from?: SerializedContext;
+};
+export declare class Context {
+    private _messages;
+    constructor(opts?: ContextOptions);
+    /** All messages in the chain (readonly copy) */
+    get messages(): readonly Message[];
+    /**
+     * Push a message onto the chain.
+     * - String → user message
+     * - Message object → stored as-is
+     */
+    push(content: string | Message): void;
+    /** Serialize to a JSON-safe snapshot */
+    serialize(): SerializedContext;
+}
+export declare function createContext(opts?: ContextOptions): Context;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIzC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,yCAAyC;IACzC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CACzB,CAAA;AAID,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAW;gBAEhB,IAAI,CAAC,EAAE,cAAc;IAIjC,gDAAgD;IAChD,IAAI,QAAQ,IAAI,SAAS,OAAO,EAAE,CAEjC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQrC,wCAAwC;IACxC,SAAS,IAAI,iBAAiB;CAG/B;AAID,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAE5D"}

package/dist/context.js

@@ -0,0 +1,38 @@
+/**
+ * Cog v2 — Context
+ *
+ * Append-only message chain. Push messages in, serialize out.
+ */
+// ── Context ─────────────────────────────────────────────────────────────────
+export class Context {
+    _messages;
+    constructor(opts) {
+        this._messages = opts?.from ? structuredClone(opts.from.messages) : [];
+    }
+    /** All messages in the chain (readonly copy) */
+    get messages() {
+        return this._messages;
+    }
+    /**
+     * Push a message onto the chain.
+     * - String → user message
+     * - Message object → stored as-is
+     */
+    push(content) {
+        if (typeof content === 'string') {
+            this._messages.push({ role: 'user', content });
+        }
+        else {
+            this._messages.push(content);
+        }
+    }
+    /** Serialize to a JSON-safe snapshot */
+    serialize() {
+        return { messages: structuredClone(this._messages) };
+    }
+}
+// ── Factory ─────────────────────────────────────────────────────────────────
+export function createContext(opts) {
+    return new Context(opts);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,+EAA+E;AAE/E,MAAM,OAAO,OAAO;IACV,SAAS,CAAW;IAE5B,YAAY,IAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAA;IACvB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAyB;QAC5B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,SAAS;QACP,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAA;IACtD,CAAC;CACF;AAED,+EAA+E;AAE/E,MAAM,UAAU,aAAa,CAAC,IAAqB;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cog v2 — A minimal agent SDK for TypeScript
+ *
+ * Three primitives, infinite composition.
+ */
+export { createContext, Context } from './context.js';
+export type { ContextOptions, SerializedContext } from './context.js';
+export { createTool, Tool } from './tool.js';
+export type { ToolConfig } from './tool.js';
+export { runAgent, MaxStepsError, AgentAbortError } from './agent.js';
+export type { AgentConfig, AgentResult } from './agent.js';
+export { createOpenAIProvider } from './providers/openai.js';
+export type { OpenAIProviderOptions } from './providers/openai.js';
+export type { Message, ToolCallRequest, ToolParameter, ToolSpec, GenerateResult, StreamCallbacks, Provider, Usage, } from './types.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;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACrE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,YAAY,EACV,OAAO,EACP,eAAe,EACf,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,QAAQ,EACR,KAAK,GACN,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * Cog v2 — A minimal agent SDK for TypeScript
+ *
+ * Three primitives, infinite composition.
+ */
+export { createContext, Context } from './context.js';
+export { createTool, Tool } from './tool.js';
+export { runAgent, MaxStepsError, AgentAbortError } from './agent.js';
+export { createOpenAIProvider } from './providers/openai.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;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGrD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAG5C,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Cog — OpenAI-compatible Provider
+ *
+ * Works with OpenAI, vLLM, OpenRouter, and any OpenAI-compatible API.
+ * Supports streaming (SSE) with reasoning_content extraction.
+ */
+import type { Provider } from '../types.js';
+export type OpenAIProviderOptions = {
+    /** API key for authentication (sent as Bearer token) */
+    apiKey?: string;
+    /** Temperature for generation (default: 0.7) */
+    temperature?: number;
+};
+/**
+ * Create a provider for any OpenAI-compatible API.
+ *
+ * Works with: OpenAI, vLLM, OpenRouter, Ollama, LiteLLM, etc.
+ *
+ * @example
+ * ```ts
+ * const provider = createOpenAIProvider('https://api.openai.com', 'gpt-4o')
+ * const provider = createOpenAIProvider('http://localhost:8000', 'my-model')
+ * const provider = createOpenAIProvider('https://openrouter.ai/api', 'anthropic/claude-sonnet-4.5', {
+ *   apiKey: 'sk-or-...',
+ *   temperature: 0.2,
+ * })
+ * ```
+ */
+export declare function createOpenAIProvider(baseUrl: string, model: string, opts?: OpenAIProviderOptions): Provider;
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAA8D,MAAM,aAAa,CAAA;AAIvG,MAAM,MAAM,qBAAqB,GAAG;IAClC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAwID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,qBAAqB,GAC3B,QAAQ,CA2DV"}

package/dist/providers/openai.js

@@ -0,0 +1,196 @@
+/**
+ * Cog — OpenAI-compatible Provider
+ *
+ * Works with OpenAI, vLLM, OpenRouter, and any OpenAI-compatible API.
+ * Supports streaming (SSE) with reasoning_content extraction.
+ */
+// ── Message Conversion ──────────────────────────────────────────────────────
+/** Convert internal Cog messages to OpenAI API wire format */
+function toAPIMessages(messages) {
+    return messages.map(m => {
+        const msg = { role: m.role, content: m.content };
+        if (m.toolCallId)
+            msg.tool_call_id = m.toolCallId;
+        if (m.toolCalls) {
+            msg.tool_calls = m.toolCalls.map(tc => ({
+                id: tc.id,
+                type: 'function',
+                function: { name: tc.name, arguments: JSON.stringify(tc.arguments) },
+            }));
+        }
+        return msg;
+    });
+}
+/** Convert internal Cog tool specs to OpenAI function-calling format */
+function toAPITools(tools) {
+    return tools.map(t => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: {
+                type: 'object',
+                properties: Object.fromEntries(Object.entries(t.parameters).map(([k, v]) => [
+                    k,
+                    { type: v.type, description: v.description },
+                ])),
+                required: Object.entries(t.parameters)
+                    .filter(([_, v]) => v.required !== false)
+                    .map(([k]) => k),
+            },
+        },
+    }));
+}
+/** Parse tool calls from a non-streaming response message */
+function parseToolCalls(toolCalls) {
+    if (!toolCalls)
+        return undefined;
+    return toolCalls.map((tc) => ({
+        id: tc.id,
+        name: tc.function.name,
+        arguments: JSON.parse(tc.function.arguments),
+    }));
+}
+// ── SSE Streaming ───────────────────────────────────────────────────────────
+async function readSSEStream(response, stream) {
+    let content = '';
+    let reasoning = '';
+    let usage;
+    const toolCallsMap = new Map();
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop();
+        for (const line of lines) {
+            if (!line.startsWith('data: '))
+                continue;
+            const payload = line.slice(6).trim();
+            if (payload === '[DONE]')
+                continue;
+            const chunk = JSON.parse(payload);
+            // Usage arrives in the final chunk (when stream_options.include_usage is set)
+            if (chunk.usage) {
+                usage = {
+                    promptTokens: chunk.usage.prompt_tokens ?? 0,
+                    completionTokens: chunk.usage.completion_tokens ?? 0,
+                    totalTokens: chunk.usage.total_tokens ?? 0,
+                };
+            }
+            const delta = chunk.choices?.[0]?.delta;
+            if (!delta)
+                continue;
+            if (delta.reasoning_content) {
+                reasoning += delta.reasoning_content;
+                stream?.onReasoning?.(delta.reasoning_content);
+            }
+            if (delta.content) {
+                content += delta.content;
+                stream?.onContent?.(delta.content);
+            }
+            if (delta.tool_calls) {
+                for (const tc of delta.tool_calls) {
+                    const idx = tc.index ?? 0;
+                    if (!toolCallsMap.has(idx)) {
+                        toolCallsMap.set(idx, { id: tc.id ?? '', name: '', args: '' });
+                    }
+                    const entry = toolCallsMap.get(idx);
+                    if (tc.id)
+                        entry.id = tc.id;
+                    if (tc.function?.name)
+                        entry.name += tc.function.name;
+                    if (tc.function?.arguments)
+                        entry.args += tc.function.arguments;
+                }
+            }
+        }
+    }
+    const toolCalls = toolCallsMap.size > 0
+        ? Array.from(toolCallsMap.values()).map(tc => ({
+            id: tc.id,
+            name: tc.name,
+            arguments: JSON.parse(tc.args || '{}'),
+        }))
+        : undefined;
+    return {
+        content: content || undefined,
+        reasoning: reasoning || undefined,
+        toolCalls,
+        usage,
+    };
+}
+// ── Provider Factory ────────────────────────────────────────────────────────
+/**
+ * Create a provider for any OpenAI-compatible API.
+ *
+ * Works with: OpenAI, vLLM, OpenRouter, Ollama, LiteLLM, etc.
+ *
+ * @example
+ * ```ts
+ * const provider = createOpenAIProvider('https://api.openai.com', 'gpt-4o')
+ * const provider = createOpenAIProvider('http://localhost:8000', 'my-model')
+ * const provider = createOpenAIProvider('https://openrouter.ai/api', 'anthropic/claude-sonnet-4.5', {
+ *   apiKey: 'sk-or-...',
+ *   temperature: 0.2,
+ * })
+ * ```
+ */
+export function createOpenAIProvider(baseUrl, model, opts) {
+    const temperature = opts?.temperature ?? 0.7;
+    return {
+        async generate(params) {
+            const shouldStream = !!(params.stream?.onReasoning || params.stream?.onContent);
+            const body = {
+                model,
+                messages: toAPIMessages(params.messages),
+                temperature,
+                stream: shouldStream,
+                ...(shouldStream ? { stream_options: { include_usage: true } } : {}),
+            };
+            const tools = params.tools && params.tools.length > 0 ? toAPITools(params.tools) : undefined;
+            if (tools) {
+                body.tools = tools;
+                body.tool_choice = 'auto';
+            }
+            const headers = { 'Content-Type': 'application/json' };
+            if (opts?.apiKey)
+                headers['Authorization'] = `Bearer ${opts.apiKey}`;
+            const response = await fetch(`${baseUrl}/v1/chat/completions`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+                signal: params.signal,
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`LLM request failed (${response.status}): ${text}`);
+            }
+            // Non-streaming path
+            if (!shouldStream) {
+                const data = (await response.json());
+                const message = data.choices[0].message;
+                const usage = data.usage
+                    ? {
+                        promptTokens: data.usage.prompt_tokens ?? 0,
+                        completionTokens: data.usage.completion_tokens ?? 0,
+                        totalTokens: data.usage.total_tokens ?? 0,
+                    }
+                    : undefined;
+                return {
+                    content: message.content ?? undefined,
+                    reasoning: message.reasoning_content ?? undefined,
+                    toolCalls: parseToolCalls(message.tool_calls),
+                    usage,
+                };
+            }
+            // Streaming path (SSE)
+            return readSSEStream(response, params.stream);
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Cog v2 — Tool
+ *
+ * A tool is a schema + execute function. Everything is a tool.
+ */
+import type { Context } from './context.js';
+import type { ToolParameter, ToolSpec } from './types.js';
+export type ToolConfig<TArgs = Record<string, unknown>> = {
+    id: string;
+    description: string;
+    schema?: Record<string, ToolParameter>;
+    execute: (args: TArgs, ctx: Context) => Promise<unknown>;
+};
+export declare class Tool<TArgs = Record<string, unknown>> {
+    readonly id: string;
+    readonly description: string;
+    readonly schema: Record<string, ToolParameter>;
+    readonly execute: (args: TArgs, ctx: Context) => Promise<unknown>;
+    constructor(config: ToolConfig<TArgs>);
+    /** Tool specification for the provider (OpenAI-compatible format) */
+    get spec(): ToolSpec;
+}
+export declare function createTool<TArgs = Record<string, unknown>>(config: ToolConfig<TArgs>): Tool<TArgs>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAIzD,MAAM,MAAM,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACxD,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACtC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzD,CAAA;AAID,qBAAa,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;gBAErD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC;IAOrC,qEAAqE;IACrE,IAAI,IAAI,IAAI,QAAQ,CAMnB;CACF;AAID,wBAAgB,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxD,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,GACxB,IAAI,CAAC,KAAK,CAAC,CAEb"}

package/dist/tool.js

@@ -0,0 +1,31 @@
+/**
+ * Cog v2 — Tool
+ *
+ * A tool is a schema + execute function. Everything is a tool.
+ */
+// ── Tool ────────────────────────────────────────────────────────────────────
+export class Tool {
+    id;
+    description;
+    schema;
+    execute;
+    constructor(config) {
+        this.id = config.id;
+        this.description = config.description;
+        this.schema = config.schema ?? {};
+        this.execute = config.execute;
+    }
+    /** Tool specification for the provider (OpenAI-compatible format) */
+    get spec() {
+        return {
+            name: this.id,
+            description: this.description,
+            parameters: this.schema,
+        };
+    }
+}
+// ── Factory ─────────────────────────────────────────────────────────────────
+export function createTool(config) {
+    return new Tool(config);
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,+EAA+E;AAE/E,MAAM,OAAO,IAAI;IACN,EAAE,CAAQ;IACV,WAAW,CAAQ;IACnB,MAAM,CAA+B;IACrC,OAAO,CAAiD;IAEjE,YAAY,MAAyB;QACnC,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAA;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAA;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAC/B,CAAC;IAED,qEAAqE;IACrE,IAAI,IAAI;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,EAAE;YACb,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,MAAM;SACxB,CAAA;IACH,CAAC;CACF;AAED,+EAA+E;AAE/E,MAAM,UAAU,UAAU,CACxB,MAAyB;IAEzB,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,CAAA;AACzB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Cog v2 — Core Types
+ */
+/** A tool call request from the model */
+export type ToolCallRequest = {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+};
+/** A message in the context chain */
+export type Message = {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    reasoning?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCallRequest[];
+};
+/** Parameter definition for a tool */
+export type ToolParameter = {
+    type: 'string' | 'number' | 'boolean';
+    description: string;
+    required?: boolean;
+};
+/** Tool specification sent to the provider */
+export type ToolSpec = {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParameter>;
+};
+/** Token usage statistics from a provider call */
+export type Usage = {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+};
+/** Result from a provider generate call */
+export type GenerateResult = {
+    content?: string;
+    reasoning?: string;
+    toolCalls?: ToolCallRequest[];
+    usage?: Usage;
+};
+/** Streaming callbacks passed to the provider */
+export type StreamCallbacks = {
+    onReasoning?: (chunk: string) => void;
+    onContent?: (chunk: string) => void;
+};
+/** LLM provider interface — user-supplied */
+export interface Provider {
+    generate(params: {
+        messages: Message[];
+        tools?: ToolSpec[];
+        signal?: AbortSignal;
+        stream?: StreamCallbacks;
+    }): Promise<GenerateResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAA;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;CAC9B,CAAA;AAID,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC1C,CAAA;AAID,kDAAkD;AAClD,MAAM,MAAM,KAAK,GAAG;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,CAAA;AAED,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,EAAE,OAAO,EAAE,CAAA;QACnB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAA;QAClB,MAAM,CAAC,EAAE,WAAW,CAAA;QACpB,MAAM,CAAC,EAAE,eAAe,CAAA;KACzB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CAC5B"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Cog v2 — Core Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@elfenlabs/cog",
+  "version": "0.1.0",
+  "description": "A minimal agent SDK for TypeScript — three primitives, infinite composition",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc",
+    "test": "bun test"
+  },
+  "keywords": [
+    "agent",
+    "sdk",
+    "llm",
+    "context",
+    "state-machine",
+    "ai",
+    "typescript"
+  ],
+  "author": "Elfenlabs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elfenlabs/cog.git"
+  },
+  "homepage": "https://github.com/elfenlabs/cog#readme",
+  "bugs": {
+    "url": "https://github.com/elfenlabs/cog/issues"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}