determinate 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cahaseler
+
+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,236 @@
+# determinate
+
+A TypeScript library that treats LLMs as next-action predictors instead of conversational partners.
+
+## The Problem
+
+Current agentic frameworks are built around a conversation metaphor: an append-only chat history, a static list of tools, and a loop that generates the next message given everything that came before. This works well for coding assistants where the environment is deterministic and stable, but falls apart in dynamic environments where:
+
+- **State goes stale.** If you inject environment state each turn across a 50-turn interaction, you have 50 snapshots in context, 49 of which are wrong. The oldest, most incorrect snapshot has the strongest positional signal.
+- **Context fills with noise.** Failed tool calls, redundant observations, and retry loops consume tokens without contributing to decisions. Half the conversation history in a typical agentic run is the agent's own mistakes.
+- **Tools are over-injected.** For a system with 180 possible actions, all 180 schemas are injected every call, even when only 20 are relevant in the current state.
+- **The model does housekeeping instead of reasoning.** The model spends capacity reconciling stale state, filtering irrelevant tools, and formatting output instead of making the actual decision.
+
+For the full argument, see [Beyond the Sacred Conversation](beyond-the-sacred-conversation.md).
+
+## The Approach
+
+The unit of work is not a conversation turn. It is a **state-to-action decision**.
+
+`determinate` is a decision engine, not a framework. It does not own the loop, manage side effects, or implement tool handlers. You provide the situation; it returns an action.
+
+Each call to `nextAction()`:
+
+1. Filters tools to only those valid in the current state
+2. Generates a constrained output schema — the model *cannot* choose an invalid action
+3. Assembles an optimized context with explicit token budgets per section
+4. Makes a single LLM call with structured output (constrained decoding)
+5. Returns the chosen action with validated parameters
+
+No conversation history accumulates inside the library. Context is an intentional budget, not a dumping ground.
+
+## Quick Start
+
+```bash
+bun add determinate
+# zod is a peer dependency
+bun add zod
+```
+
+```typescript
+import { z } from "zod";
+import { createAgent } from "determinate";
+
+const agent = createAgent({
+  provider: {
+    type: "openai",          // or "anthropic", "vllm", "openrouter"
+    model: "gpt-5-nano",
+    apiKey: process.env.OPENAI_API_KEY,
+  },
+  state: z.object({
+    order: z.object({
+      status: z.enum(["pending", "approved", "shipped"]),
+      riskScore: z.number(),
+      items: z.array(z.object({ name: z.string(), qty: z.number() })),
+    }),
+  }),
+  tools: [
+    {
+      name: "approve_order",
+      description: "Approve a pending order",
+      params: z.object({ note: z.string() }),
+      validWhen: (s) => s.order.status === "pending" && s.order.riskScore < 0.7,
+    },
+    {
+      name: "escalate_order",
+      description: "Escalate order for human review",
+      params: z.object({ reason: z.string() }),
+      validWhen: (s) => s.order.status === "pending" && s.order.riskScore >= 0.7,
+    },
+    {
+      name: "ship_order",
+      description: "Ship an approved order",
+      params: z.object({ carrier: z.enum(["fedex", "ups", "usps"]) }),
+      validWhen: (s) => s.order.status === "approved",
+    },
+  ],
+  instructions: (s) =>
+    `You are an order processing agent. Evaluate order risk and take appropriate action.
+     Current risk score: ${s.order.riskScore}`,
+  context: {
+    budgets: { instructions: 5000, state: 5000, history: 10000, tools: 3000 },
+  },
+});
+
+// Your loop — you own it
+agent.setState({
+  order: { status: "pending", riskScore: 0.3, items: [{ name: "Widget", qty: 2 }] },
+});
+
+const result = await agent.nextAction();
+// { action: { tool: "approve_order", params: { note: "Low risk, standard order" } },
+//   meta: { tokensUsed: { input: 180, output: 30 }, model: "gpt-5-nano", latency: 892 } }
+
+// You execute the action, update state, call nextAction() again
+```
+
+## Core Concepts
+
+### State
+
+Define your environment state as a Zod schema. The library validates it, serializes it for the model, and passes it to your tool predicates and instruction function. You replace it entirely each turn via `setState()` — no stale snapshots accumulating.
+
+### Tools with Conditional Validity
+
+Each tool has a `validWhen` predicate evaluated against current state. Only valid tools are presented to the model, and the constrained output schema makes it physically impossible for the model to choose an invalid tool. This is least-privilege enforced structurally, not by hoping the model follows instructions.
+
+### Token Budgets
+
+You set explicit token budgets per section (instructions, state, history, tools). If any section exceeds its budget, the call is rejected with a `BudgetExceededError` — no silent truncation. This makes context overflow a build-time problem you fix once, not a runtime surprise.
+
+### History
+
+You manage history. The library defines the format, validates it, and translates it into provider-native tool-calling messages (exploiting model training on tool-calling patterns). You control what history to include, how to compress it, and when to drop entries.
+
+```typescript
+agent.setHistory([
+  {
+    tool: "request_info",
+    params: { field: "shipping_address" },
+    result: "Customer provided: 123 Main St",
+    success: true,
+  },
+]);
+```
+
+### Instructions
+
+A function from state to string. Called each turn, so you can provide different instructions for different situations without any framework machinery.
+
+```typescript
+instructions: (s) => {
+  if (s.order.riskScore > 0.9) return "This is an extremely high-risk order. Escalate immediately.";
+  if (s.order.status === "approved") return "Select carrier based on package weight and destination.";
+  return "Evaluate the order against standard fulfillment policy.";
+},
+```
+
+## Providers
+
+| Provider | How | Structured Output |
+|----------|-----|-------------------|
+| OpenAI | OpenAI SDK | `response_format: json_schema` |
+| Anthropic | Raw fetch adapter | `output_config.format: json_schema` |
+| vLLM | OpenAI SDK + custom base URL | Constrained decoding (xgrammar/outlines) |
+| OpenRouter | OpenAI SDK + custom base URL | Depends on upstream model |
+
+```typescript
+// Local vLLM
+provider: { type: "vllm", model: "Qwen/Qwen3.5-4B", apiKey: "not-needed", baseUrl: "http://localhost:8000/v1" }
+
+// Anthropic
+provider: { type: "anthropic", model: "claude-haiku-4-5-20251001", apiKey: process.env.ANTHROPIC_API_KEY }
+
+// OpenRouter
+provider: { type: "openrouter", model: "anthropic/claude-sonnet-4-5", apiKey: process.env.OPENROUTER_API_KEY }
+```
+
+## Cost Tracking
+
+The library returns token counts in `meta.tokensUsed` (may be `{ input: 0, output: 0 }` if the provider doesn't report usage). For cost estimation, pass your own pricing:
+
+```typescript
+const agent = createAgent({
+  // ...
+  pricing: { input: 0.05, output: 0.4 },  // per 1M tokens
+});
+
+const result = await agent.nextAction();
+result.meta.cost;  // number | undefined
+```
+
+## Timeouts and Cancellation
+
+```typescript
+// Per-call timeout
+const result = await agent.nextAction({ timeout: 10000 });
+
+// AbortSignal
+const controller = new AbortController();
+const result = await agent.nextAction({ signal: controller.signal });
+```
+
+## Verbose Mode
+
+For debugging, get the full assembled context:
+
+```typescript
+const result = await agent.nextAction({ verbose: true });
+// result.context.messages — what was sent to the LLM
+// result.context.outputSchema — the JSON schema constraining the output
+// result.context.validTools — which tools were available
+```
+
+## Errors
+
+All errors are typed and actionable:
+
+| Error | When |
+|-------|------|
+| `ValidationError` | State doesn't match schema, history format invalid |
+| `BudgetExceededError` | A section exceeds its token budget |
+| `NoValidToolsError` | No tool's `validWhen` returned true |
+| `ProviderError` | Auth failure, rate limit, network error |
+| `OutputError` | Model returned invalid action (shouldn't happen with constrained output) |
+| `AbortError` | Call cancelled or timed out |
+
+## OAuth
+
+Built-in device code flows for subscription-based access (ChatGPT Plus, Claude Pro):
+
+```typescript
+import { getOAuthProvider, getOAuthApiKey } from "determinate";
+
+// Trigger login flow
+const provider = getOAuthProvider("openai"); // returns undefined if not registered
+await provider?.login(callbacks);
+
+// Later, credentials are used automatically
+const agent = createAgent({
+  provider: { type: "openai", model: "gpt-5-nano", oauth: true },
+  // no apiKey needed — uses stored credentials
+  // ...
+});
+```
+
+## Requirements
+
+- **Runtime:** Bun (or Node.js with compatible APIs)
+- **TypeScript:** 5.x
+- **Zod:** >= 4.0.0 (peer dependency)
+
+## Philosophy
+
+This library exists because we believe the conversation metaphor is the wrong abstraction for most agentic systems. An LLM making decisions in a dynamic environment is solving a classification problem with context, not having a conversation. The architecture should reflect that.
+
+For the full argument: [Beyond the Sacred Conversation](beyond-the-sacred-conversation.md).

package/dist/agent.d.ts

@@ -0,0 +1,17 @@
+import { type ValidatedHistoryEntry } from "./schema/history-schema";
+import type { ActionResult, AgentConfig, HistoryEntry, NextActionOptions, VerboseActionResult } from "./types";
+export declare class Agent<TState> {
+    private config;
+    private state;
+    private history;
+    private provider;
+    private tokenizer;
+    constructor(config: AgentConfig<TState>);
+    private resolveProvider;
+    setState(state: TState): void;
+    getState(): TState;
+    setHistory(history: HistoryEntry[]): void;
+    getHistory(): ValidatedHistoryEntry[];
+    nextAction(options?: NextActionOptions): Promise<ActionResult | VerboseActionResult>;
+}
+//# 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":"AAMA,OAAO,EAAE,KAAK,qBAAqB,EAAmB,MAAM,yBAAyB,CAAC;AACtF,OAAO,KAAK,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,MAAM,SAAS,CAAC;AAEjB,qBAAa,KAAK,CAAC,MAAM;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,SAAS,CAAY;gBAEjB,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;YAUzB,eAAe;IAsB7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7B,QAAQ,IAAI,MAAM;IAOlB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAIzC,UAAU,IAAI,qBAAqB,EAAE;IAI/B,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,mBAAmB,CAAC;CA4F1F"}

package/dist/agent.js

@@ -0,0 +1,131 @@
+import { assembleContext } from "./context/assembler";
+import { createTokenizer } from "./context/tokenizer";
+import { AbortError, OutputError, ProviderError, ValidationError } from "./errors";
+import { getOAuthApiKey } from "./oauth/index";
+import { createProvider } from "./providers/factory";
+import { validateHistory } from "./schema/history-schema";
+export class Agent {
+    config;
+    state;
+    history = [];
+    provider;
+    tokenizer;
+    constructor(config) {
+        this.config = config;
+        this.tokenizer = createTokenizer(config.provider.type, config.provider.model);
+        // Create provider immediately if we have an apiKey or OAuth isn't requested
+        if (config.provider.apiKey || !config.provider.oauth) {
+            this.provider = createProvider(config.provider);
+        }
+    }
+    async resolveProvider() {
+        if (this.provider)
+            return this.provider;
+        // OAuth is requested but no apiKey — try stored credentials
+        const oauthProviderId = this.config.provider.type === "openai" ? "openai" : "anthropic";
+        const result = await getOAuthApiKey(oauthProviderId);
+        if (!result) {
+            throw new ProviderError(this.config.provider.type, `No stored OAuth credentials for ${oauthProviderId}. Run the login flow first using the exported OAuth providers.`);
+        }
+        this.provider = createProvider({
+            ...this.config.provider,
+            apiKey: result.apiKey,
+        });
+        return this.provider;
+    }
+    setState(state) {
+        const result = this.config.state.safeParse(state);
+        if (!result.success) {
+            throw new ValidationError(`Invalid state: ${result.error.issues.map((i) => i.message).join(", ")}`);
+        }
+        this.state = result.data;
+    }
+    getState() {
+        if (this.state === undefined) {
+            throw new ValidationError("State has not been set");
+        }
+        return this.state;
+    }
+    setHistory(history) {
+        this.history = validateHistory(history);
+    }
+    getHistory() {
+        return this.history;
+    }
+    async nextAction(options) {
+        const state = this.getState();
+        let signal = options?.signal;
+        if (options?.timeout) {
+            const timeoutSignal = AbortSignal.timeout(options.timeout);
+            signal = signal ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal;
+        }
+        try {
+            const assembled = assembleContext({
+                state,
+                tools: this.config.tools,
+                history: this.history,
+                instructions: this.config.instructions,
+                budgets: this.config.context.budgets,
+                tokenizer: this.tokenizer,
+                providerType: this.config.provider.type,
+            });
+            const provider = await this.resolveProvider();
+            const start = performance.now();
+            const response = await provider.sendRequest({
+                messages: assembled.messages,
+                outputSchema: assembled.outputSchema,
+                model: this.config.provider.model,
+                options: this.config.provider.options,
+                signal,
+            });
+            const latency = performance.now() - start;
+            if (!assembled.validTools.includes(response.action.tool)) {
+                throw new OutputError(`Model returned tool "${response.action.tool}" which is not in the valid set: [${assembled.validTools.join(", ")}]`, JSON.stringify(response.action));
+            }
+            const toolDef = this.config.tools.find((t) => t.name === response.action.tool);
+            if (toolDef) {
+                // Strip the tool_name discriminant injected by the output schema
+                const { tool_name: _, ...cleanParams } = response.action.params;
+                const paramsResult = toolDef.params.safeParse(cleanParams);
+                if (!paramsResult.success) {
+                    throw new OutputError(`Params for tool "${response.action.tool}" failed validation: ${paramsResult.error.issues.map((i) => i.message).join(", ")}`, JSON.stringify(response.action));
+                }
+                response.action.params = paramsResult.data;
+            }
+            let cost;
+            if (this.config.pricing) {
+                const { input, output } = response.meta.tokensUsed;
+                cost =
+                    (input / 1_000_000) * this.config.pricing.input +
+                        (output / 1_000_000) * this.config.pricing.output;
+            }
+            const result = {
+                action: response.action,
+                meta: {
+                    tokensUsed: response.meta.tokensUsed,
+                    cost,
+                    model: response.meta.model,
+                    latency,
+                },
+            };
+            if (options?.verbose) {
+                return {
+                    ...result,
+                    context: {
+                        messages: assembled.messages,
+                        outputSchema: assembled.outputSchema,
+                        validTools: assembled.validTools,
+                    },
+                };
+            }
+            return result;
+        }
+        catch (err) {
+            if (signal?.aborted) {
+                throw new AbortError(options?.timeout ? `Timeout after ${options.timeout}ms` : "Operation was aborted");
+            }
+            throw err;
+        }
+    }
+}
+//# 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/assembler.d.ts

@@ -0,0 +1,19 @@
+import type { HistoryEntry, ProviderConfig, TokenBudgets, ToolDefinition } from "../types";
+import type { Tokenizer } from "./tokenizer";
+interface AssembleInput<TState> {
+    state: TState;
+    tools: ToolDefinition<TState>[];
+    history: HistoryEntry[];
+    instructions: (state: TState) => string;
+    budgets: TokenBudgets;
+    tokenizer: Tokenizer;
+    providerType: ProviderConfig["type"];
+}
+interface AssembledPayload {
+    messages: unknown[];
+    outputSchema: Record<string, unknown>;
+    validTools: string[];
+}
+export declare function assembleContext<TState>(input: AssembleInput<TState>): AssembledPayload;
+export {};
+//# sourceMappingURL=assembler.d.ts.map

package/dist/context/assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assembler.d.ts","sourceRoot":"","sources":["../../src/context/assembler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,UAAU,aAAa,CAAC,MAAM;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;IAChC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,UAAU,gBAAgB;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,gBAAgB,CA8FtF"}

package/dist/context/assembler.js

@@ -0,0 +1,87 @@
+import { randomUUID } from "node:crypto";
+import { NoValidToolsError } from "../errors";
+import { generateActionSchema } from "../schema/action-schema";
+import { enforceBudgets } from "./budget";
+export function assembleContext(input) {
+    const { state, tools, history, instructions, budgets, tokenizer, providerType } = input;
+    // 1. Filter tools by validWhen
+    const validTools = tools.filter((t) => t.validWhen(state));
+    if (validTools.length === 0) {
+        throw new NoValidToolsError();
+    }
+    // 2. Generate output schema
+    const outputSchema = generateActionSchema(validTools);
+    // 3. Build instructions text
+    const instructionsText = instructions(state);
+    const toolInstructions = validTools
+        .filter((t) => t.instructions)
+        .map((t) => `[${t.name}]: ${t.instructions}`)
+        .join("\n");
+    const fullInstructions = toolInstructions
+        ? `${instructionsText}\n\nTool-specific instructions:\n${toolInstructions}`
+        : instructionsText;
+    // 4. Build tool descriptions
+    const toolDescriptions = validTools.map((t) => `- ${t.name}: ${t.description}`).join("\n");
+    // 5. Serialize state
+    const stateText = JSON.stringify(state, null, 2);
+    // 6. Build history messages (needed for accurate budget counting)
+    const historyMessages = [];
+    for (const entry of history) {
+        const callId = randomUUID();
+        if (providerType === "anthropic") {
+            historyMessages.push({
+                role: "assistant",
+                content: [{ type: "tool_use", id: callId, name: entry.tool, input: entry.params }],
+            });
+            historyMessages.push({
+                role: "user",
+                content: [
+                    {
+                        type: "tool_result",
+                        tool_use_id: callId,
+                        content: entry.result,
+                        is_error: entry.success === false,
+                    },
+                ],
+            });
+        }
+        else {
+            historyMessages.push({
+                role: "assistant",
+                tool_calls: [
+                    {
+                        id: callId,
+                        type: "function",
+                        function: { name: entry.tool, arguments: JSON.stringify(entry.params) },
+                    },
+                ],
+            });
+            historyMessages.push({
+                role: "tool",
+                tool_call_id: callId,
+                content: entry.result,
+            });
+        }
+    }
+    // 7. Enforce budgets
+    const historyText = historyMessages.length > 0 ? JSON.stringify(historyMessages) : "";
+    enforceBudgets({
+        instructions: fullInstructions,
+        state: stateText,
+        history: historyText,
+        tools: toolDescriptions,
+    }, budgets, tokenizer);
+    // 8. Build final messages
+    const messages = [];
+    messages.push({
+        role: "system",
+        content: `${fullInstructions}\n\nAvailable actions:\n${toolDescriptions}\n\nRespond with a JSON object choosing one action and its parameters.`,
+    });
+    messages.push(...historyMessages);
+    messages.push({
+        role: "user",
+        content: `Current state:\n${stateText}\n\nChoose the next action.`,
+    });
+    return { messages, outputSchema, validTools: validTools.map((t) => t.name) };
+}
+//# sourceMappingURL=assembler.js.map

package/dist/context/assembler.js.map

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

package/dist/context/budget.d.ts

@@ -0,0 +1,10 @@
+import type { TokenBudgets } from "../types";
+import type { Tokenizer } from "./tokenizer";
+export interface SectionContents {
+    instructions: string;
+    state: string;
+    history: string;
+    tools: string;
+}
+export declare function enforceBudgets(sections: SectionContents, budgets: TokenBudgets, tokenizer: Tokenizer): Record<keyof TokenBudgets, number>;
+//# sourceMappingURL=budget.d.ts.map

package/dist/context/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/context/budget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAC7B,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,SAAS,GAClB,MAAM,CAAC,MAAM,YAAY,EAAE,MAAM,CAAC,CAYpC"}

package/dist/context/budget.js

@@ -0,0 +1,13 @@
+import { BudgetExceededError } from "../errors";
+export function enforceBudgets(sections, budgets, tokenizer) {
+    const counts = {};
+    for (const key of ["instructions", "state", "history", "tools"]) {
+        const count = tokenizer.count(sections[key]);
+        counts[key] = count;
+        if (count > budgets[key]) {
+            throw new BudgetExceededError(key, count, budgets[key]);
+        }
+    }
+    return counts;
+}
+//# sourceMappingURL=budget.js.map

package/dist/context/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/context/budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAWhD,MAAM,UAAU,cAAc,CAC7B,QAAyB,EACzB,OAAqB,EACrB,SAAoB;IAEpB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAU,EAAE,CAAC;QAC1E,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACpB,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QACzD,CAAC;IACF,CAAC;IAED,OAAO,MAA4C,CAAC;AACrD,CAAC"}

package/dist/context/tokenizer.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderConfig } from "../types";
+export interface Tokenizer {
+    count(input: string | Record<string, unknown>): number;
+}
+export declare function createTokenizer(providerType: ProviderConfig["type"], model: string): Tokenizer;
+//# sourceMappingURL=tokenizer.d.ts.map

package/dist/context/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/context/tokenizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,SAAS;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CACvD;AA+BD,wBAAgB,eAAe,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAM9F"}

package/dist/context/tokenizer.js

@@ -0,0 +1,34 @@
+import { encoding_for_model, get_encoding } from "tiktoken";
+function serialize(input) {
+    if (typeof input === "string")
+        return input;
+    return JSON.stringify(input);
+}
+class TiktokenTokenizer {
+    encoder;
+    constructor(model) {
+        try {
+            this.encoder = encoding_for_model(model);
+        }
+        catch {
+            this.encoder = get_encoding("cl100k_base");
+        }
+    }
+    count(input) {
+        return this.encoder.encode(serialize(input)).length;
+    }
+}
+class CharApproximationTokenizer {
+    charsPerToken = 3;
+    count(input) {
+        return Math.ceil(serialize(input).length / this.charsPerToken);
+    }
+}
+export function createTokenizer(providerType, model) {
+    if (providerType === "openai" || providerType === "openrouter" || providerType === "vllm") {
+        return new TiktokenTokenizer(model);
+    }
+    // Anthropic doesn't use tiktoken — approximate by character count
+    return new CharApproximationTokenizer();
+}
+//# sourceMappingURL=tokenizer.js.map

package/dist/context/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../src/context/tokenizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAsB,MAAM,UAAU,CAAC;AAOhF,SAAS,SAAS,CAAC,KAAuC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,iBAAiB;IACd,OAAO,CAAC;IAEhB,YAAY,KAAa;QACxB,IAAI,CAAC;YACJ,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,KAAsB,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAuC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACrD,CAAC;CACD;AAED,MAAM,0BAA0B;IACd,aAAa,GAAG,CAAC,CAAC;IAEnC,KAAK,CAAC,KAAuC;QAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC;CACD;AAED,MAAM,UAAU,eAAe,CAAC,YAAoC,EAAE,KAAa;IAClF,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,YAAY,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC3F,OAAO,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,kEAAkE;IAClE,OAAO,IAAI,0BAA0B,EAAE,CAAC;AACzC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,29 @@
+export declare class ValidationError extends Error {
+    name: "ValidationError";
+}
+export declare class BudgetExceededError extends Error {
+    readonly section: string;
+    readonly actual: number;
+    readonly budget: number;
+    name: "BudgetExceededError";
+    constructor(section: string, actual: number, budget: number);
+}
+export declare class NoValidToolsError extends Error {
+    name: "NoValidToolsError";
+    constructor();
+}
+export declare class ProviderError extends Error {
+    readonly provider: string;
+    name: "ProviderError";
+    constructor(provider: string, message: string);
+}
+export declare class OutputError extends Error {
+    readonly rawOutput: string;
+    name: "OutputError";
+    constructor(message: string, rawOutput: string);
+}
+export declare class AbortError extends Error {
+    name: "AbortError";
+    constructor(message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IAChC,IAAI,EAAG,iBAAiB,CAAU;CAC3C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;aAG5B,OAAO,EAAE,MAAM;aACf,MAAM,EAAE,MAAM;aACd,MAAM,EAAE,MAAM;IAJtB,IAAI,EAAG,qBAAqB,CAAU;gBAE9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;CAI/B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAClC,IAAI,EAAG,mBAAmB,CAAU;;CAI7C;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGtB,QAAQ,EAAE,MAAM;IAFxB,IAAI,EAAG,eAAe,CAAU;gBAExB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAIhB;AAED,qBAAa,WAAY,SAAQ,KAAK;aAIpB,SAAS,EAAE,MAAM;IAHzB,IAAI,EAAG,aAAa,CAAU;gBAEtC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM;CAIlC;AAED,qBAAa,UAAW,SAAQ,KAAK;IAC3B,IAAI,EAAG,YAAY,CAAU;gBAC1B,OAAO,GAAE,MAAgC;CAGrD"}