@rubrion/mastra-cloudflare 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,104 @@
-# Temporary Holding Version
+# @rubrion/mastra-cloudflare
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Mastra](https://mastra.ai) agents on Cloudflare Workers, without the boilerplate:
+
+- **`createAgentServer`**: an OpenAI-compatible server (`/v1/models`, `/v1/chat/completions` with real SSE streaming) for your agents, as a Worker `fetch` handler, with no HTTP framework and a small startup cost. `model: "auto"` routes each message to the right agent, or splits it across up to three.
+- **`defineAgents`**: agents as plain config, built lazily once per isolate (bindings and secrets are only readable inside a request).
+- **`d1Memory`**: Mastra Memory on D1, no vector store to pay for.
+- **`workersAI`**, **`openAICompatible`**, **`providerModel`**: models from Workers AI, any OpenAI-compatible endpoint, or the provider each request carries.
+- Re-exports `Agent`, `createTool`, `z` and `RequestContext`, so a project needs only this package.
+
+The [rubry template](https://github.com/rubrion/rubry) puts it to work: agents plus a middleware with API keys and a settings page.
+
+## Install
+
+```bash
+npm install @rubrion/mastra-cloudflare
+```
+
+`wrangler.jsonc` needs `"compatibility_flags": ["nodejs_compat"]`.
+
+## A Worker in 20 lines
+
+```ts
+import { env } from 'cloudflare:workers';
+import { createAgentServer, createTool, d1Memory, defineAgents, z } from '@rubrion/mastra-cloudflare';
+
+const time = createTool({
+	id: 'current_time',
+	description: 'The current date and time.',
+	inputSchema: z.object({}),
+	execute: async () => ({ now: new Date().toISOString() }),
+});
+
+const agents = defineAgents(
+	[
+		{ id: 'writer', name: 'Writer', description: 'Writes and edits text.', instructions: 'Write what is asked, briefly.' },
+		{ id: 'helper', name: 'Helper', description: 'General questions; knows the time.', instructions: 'Be useful.', tools: { current_time: time } },
+	],
+	{ memory: d1Memory(() => env.MEMORY) },
+);
+
+export default createAgentServer({
+	agents,
+	apiKey: (e: Env) => e.API_KEY,
+	provider: (e: Env) => ({ baseURL: 'https://api.openai.com/v1', apiKey: e.OPENAI_API_KEY, model: 'gpt-5-mini' }),
+});
+```
+
+```bash
+curl -N http://localhost:8787/v1/chat/completions -H "Authorization: Bearer $API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{"model":"auto","stream":true,"messages":[{"role":"user","content":"What time is it?"}]}'
+```
+
+## Server
+
+`createAgentServer({ agents, name?, apiKey?, provider?, planner?, maxSteps?, maxAgents? })` returns `{ fetch(request, env) }`. `maxSteps` (tool rounds per reply, default 5) and `maxAgents` (how many agents `auto` may split a request across, default 3) take a number or `(env) => number`.
+
+Replies carry OpenAI's `usage` (prompt, completion and total tokens over the planner, every agent and every tool round): in the JSON body, or on the final chunk when streaming.
+
+| Route | |
+|---|---|
+| `GET /` | health: name and agent ids |
+| `GET /v1/models` | `auto` (when it can route) and each agent, with its description |
+| `POST /v1/chat/completions` | `model`: agent id or `auto`; `stream: true` for SSE; text and `image_url` content |
+
+Per-request headers, for a middleware in front (see `HEADERS`):
+
+| Header | |
+|---|---|
+| `X-Provider-Base-URL` / `X-Provider-Key` / `X-Provider-Model` | the model for this request (else `provider(env)`) |
+| `X-Agents: a,b` | only these agents are on |
+| `X-Session-Id` | memory per (session, agent): send only the new message. Needs `memory` on `defineAgents` |
+
+## Agents
+
+```ts
+interface AgentSpec {
+	id: string;
+	name: string;
+	description: string; // the router picks agents by it
+	instructions: string | ((args: { requestContext }) => string);
+	model?: (requestContext) => Model; // default: providerModel (the request's provider)
+	tools?: Record<string, Tool>;
+	maxOutputTokens?: number;
+	enabled?: () => boolean; // off when its configuration is missing
+}
+```
+
+`defineAgents(specs, { memory })` returns `{ list(), find(id), get(id) → { agent, spec }, mastra() }`. Specs can carry extra fields of your own (`defineAgents<MySpec>(…)`). `buildAgent(spec)` builds one uncached Agent, e.g. per request.
+
+## Models
+
+```ts
+openAICompatible({ baseURL, apiKey, model }); // OpenAI, OpenRouter, LiteLLM, vLLM, Ollama, another agent server…
+workersAI(env.AI, '@cf/google/gemma-4-26b-a4b-it', { thinking: true }); // with providerOptions: workersAIOptions(true)
+providerModel(requestContext, fallback?); // the provider the request carries
+```
+
+`workersAI` with `thinking` drops `reasoning_effort` from the binding call: Mastra sends the AI SDK's unified `reasoning` option, and reasoning models such as Gemma 4 stop thinking whenever it is present.
+
+## License
+
+GPL-3.0-only

package/dist/agents.d.ts

@@ -0,0 +1,47 @@
+import { Agent } from '@mastra/core/agent';
+import { Mastra } from '@mastra/core/mastra';
+import type { MastraMemory } from '@mastra/core/memory';
+import type { RequestContext } from '@mastra/core/request-context';
+import { type Model } from './models.js';
+export interface AgentSpec {
+    id: string;
+    name: string;
+    /** What the agent is for, in one or two sentences. The router picks agents by it. */
+    description: string;
+    instructions: string | ((args: {
+        requestContext: RequestContext;
+    }) => string);
+    /** Its model; by default the request's provider (`providerModel`). */
+    model?: (requestContext: RequestContext) => Model;
+    tools?: Record<string, unknown>;
+    /** Cap on each reply, in tokens. */
+    maxOutputTokens?: number;
+    /** Off when its configuration is missing (e.g. a key that isn't set). */
+    enabled?: () => boolean;
+}
+export interface AgentsOptions {
+    /** Memory every agent shares (see `d1Memory`); without it agents are stateless. */
+    memory?: () => MastraMemory;
+}
+/** A Mastra Agent from a spec, not cached: for agents made per request. */
+export declare function buildAgent(spec: AgentSpec, { memory }?: AgentsOptions): Agent<string, never, undefined, any, import("@mastra/core/agent").AgentEditorConfig | undefined>;
+/**
+ * The registry of a Worker's agents. `T` can carry app-specific fields
+ * (a tagline, a price) next to the spec's own.
+ */
+export declare function defineAgents<T extends AgentSpec>(specs: T[], options?: AgentsOptions): {
+    specs: T[];
+    memory: (() => MastraMemory) | undefined;
+    /** The agents that are on. */
+    list: () => T[];
+    find: (id: string) => T | undefined;
+    /** An agent and its spec, or undefined when unknown or off. */
+    get(id: string): {
+        agent: Agent<string, import("@mastra/core/agent").ToolsInput, undefined, any, import("@mastra/core/agent").AgentEditorConfig | undefined>;
+        spec: T;
+    } | undefined;
+    /** A Mastra instance with every enabled agent registered (logger, storage wiring). */
+    mastra(): Mastra<Record<string, Agent<any, import("@mastra/core/agent").ToolsInput, undefined, any, import("@mastra/core/agent").AgentEditorConfig | undefined>>, Record<string, import("@mastra/core/workflows").AnyWorkflow>, Record<string, import("@mastra/core/vector").MastraVector<any>>, Record<string, import("@mastra/core/tts").MastraTTS>, import("@mastra/core/logger").IMastraLogger, Record<string, import("@mastra/core/mcp").MCPServerBase<any>>, Record<string, import("@mastra/core/evals").MastraScorer<any, any, any, any>>, Record<string, import("@mastra/core/tools").ToolAction<any, any, any, any, any, any, unknown>>, Record<string, import("@mastra/core/processors").Processor<any, unknown>>, Record<string, MastraMemory>, Record<string, import("@mastra/core/channels").ChannelProvider>, Record<string, import("@mastra/core/classifier").Classifier<any>>, Record<string, import("@mastra/core/knowledge").Knowledge>>;
+};
+export type AgentRegistry<T extends AgentSpec = AgentSpec> = ReturnType<typeof defineAgents<T>>;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,KAAK,MAAM,CAAC,CAAC;IAC9E,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,KAAK,CAAC;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC7B,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,YAAY,CAAC;CAC5B;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,GAAE,aAAkB,oGAUzE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,GAAE,aAAkB;;mBApBzE,YAAY;IAoC1B,8BAA8B;;eAZb,MAAM;IAevB,+DAA+D;YACvD,MAAM;;;;IAId,sFAAsF;;EAMvF;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,IAAI,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/agents.js

@@ -0,0 +1,53 @@
+// Agents as configuration: a list of specs becomes Mastra Agents, built once
+// per isolate on first use (bindings and secrets are only readable then).
+import { Agent } from '@mastra/core/agent';
+import { Mastra } from '@mastra/core/mastra';
+import { providerModel } from './models.js';
+/** A Mastra Agent from a spec, not cached: for agents made per request. */
+export function buildAgent(spec, { memory } = {}) {
+    return new Agent({
+        id: spec.id,
+        name: spec.name,
+        description: spec.description,
+        instructions: ({ requestContext }) => (typeof spec.instructions === 'function' ? spec.instructions({ requestContext }) : spec.instructions),
+        model: ({ requestContext }) => (spec.model ?? providerModel)(requestContext),
+        tools: (spec.tools ?? {}),
+        ...(memory ? { memory: () => memory() } : {}),
+    });
+}
+/**
+ * The registry of a Worker's agents. `T` can carry app-specific fields
+ * (a tagline, a price) next to the spec's own.
+ */
+export function defineAgents(specs, options = {}) {
+    const built = new Map();
+    let mastra;
+    const list = () => specs.filter((s) => s.enabled?.() ?? true);
+    const find = (id) => list().find((s) => s.id === id);
+    const agentOf = (spec) => {
+        let agent = built.get(spec.id);
+        if (!agent) {
+            agent = buildAgent(spec, options);
+            built.set(spec.id, agent);
+        }
+        return agent;
+    };
+    return {
+        specs,
+        memory: options.memory,
+        /** The agents that are on. */
+        list,
+        find,
+        /** An agent and its spec, or undefined when unknown or off. */
+        get(id) {
+            const spec = find(id);
+            return spec ? { agent: agentOf(spec), spec } : undefined;
+        },
+        /** A Mastra instance with every enabled agent registered (logger, storage wiring). */
+        mastra() {
+            mastra ??= new Mastra({ agents: Object.fromEntries(list().map((s) => [s.id, agentOf(s)])) });
+            return mastra;
+        },
+    };
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { d1Memory, type D1MemoryOptions } from './memory.js';
+export { openAICompatible, providerModel, workersAI, workersAIOptions, PROVIDER, DEFAULT_MODEL, type AiBinding, type Model, type ProviderConfig } from './models.js';
+export { buildAgent, defineAgents, type AgentRegistry, type AgentSpec, type AgentsOptions } from './agents.js';
+export { createAgentServer, HEADERS, type AgentServerOptions } from './server.js';
+export { plannerAgent, RoutingPlanSchema, type RoutingPlan } from './routing.js';
+export { Agent } from '@mastra/core/agent';
+export { Mastra } from '@mastra/core/mastra';
+export { RequestContext } from '@mastra/core/request-context';
+export { createTool } from '@mastra/core/tools';
+export { z } from 'zod';
+//# 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":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACrK,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGjF,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// @rubrion/mastra-cloudflare: Mastra agents on Cloudflare Workers.
+export { d1Memory } from './memory.js';
+export { openAICompatible, providerModel, workersAI, workersAIOptions, PROVIDER, DEFAULT_MODEL } from './models.js';
+export { buildAgent, defineAgents } from './agents.js';
+export { createAgentServer, HEADERS } from './server.js';
+export { plannerAgent, RoutingPlanSchema } from './routing.js';
+// So a project needs only this package to define agents and tools.
+export { Agent } from '@mastra/core/agent';
+export { Mastra } from '@mastra/core/mastra';
+export { RequestContext } from '@mastra/core/request-context';
+export { createTool } from '@mastra/core/tools';
+export { z } from 'zod';
+//# 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,mEAAmE;AACnE,OAAO,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAmD,MAAM,aAAa,CAAC;AACrK,OAAO,EAAE,UAAU,EAAE,YAAY,EAA0D,MAAM,aAAa,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAA2B,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AAEjF,mEAAmE;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,15 @@
+import { Memory } from '@mastra/memory';
+export interface D1MemoryOptions {
+    /** Messages recalled into each prompt; the one memory setting charged per turn. */
+    lastMessages?: number;
+    /** Store id, for Mastra's logs. */
+    id?: string;
+}
+/**
+ * A getter for a D1-backed Memory, with no vector store or embedder to pay
+ * for. Pass the getter as an agent's `memory`.
+ *
+ *     const memory = d1Memory(() => env.MEMORY, { lastMessages: 8 });
+ */
+export declare function d1Memory(binding: () => D1Database, { lastMessages, id }?: D1MemoryOptions): () => Memory;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,WAAW,eAAe;IAC/B,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,UAAU,EAAE,EAAE,YAAiB,EAAE,EAAoB,EAAE,GAAE,eAAoB,gBAQpH"}

package/dist/memory.js

@@ -0,0 +1,19 @@
+// Mastra Memory on D1. Built lazily: D1 table setup is I/O, which Workers only
+// allow inside a request, never at module load. Tables are created on first use.
+import { D1Store } from '@mastra/cloudflare-d1';
+import { Memory } from '@mastra/memory';
+/**
+ * A getter for a D1-backed Memory, with no vector store or embedder to pay
+ * for. Pass the getter as an agent's `memory`.
+ *
+ *     const memory = d1Memory(() => env.MEMORY, { lastMessages: 8 });
+ */
+export function d1Memory(binding, { lastMessages = 10, id = 'mastra-memory' } = {}) {
+    let memory;
+    return () => (memory ??= new Memory({
+        storage: new D1Store({ id, binding: binding() }),
+        vector: false,
+        options: { lastMessages, semanticRecall: false, generateTitle: false },
+    }));
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AASxC;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAyB,EAAE,EAAE,YAAY,GAAG,EAAE,EAAE,EAAE,GAAG,eAAe,KAAsB,EAAE;IACpH,IAAI,MAA0B,CAAC;IAC/B,OAAO,GAAG,EAAE,CACX,CAAC,MAAM,KAAK,IAAI,MAAM,CAAC;QACtB,OAAO,EAAE,IAAI,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QAChD,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE;KACtE,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,47 @@
+import type { LanguageModelV4 } from '@ai-sdk/provider';
+import type { RequestContext } from '@mastra/core/request-context';
+/** An OpenAI-compatible provider: OpenAI, OpenRouter, a LiteLLM/vLLM/Ollama proxy, another agent server. */
+export interface ProviderConfig {
+    baseURL: string;
+    apiKey: string;
+    model: string;
+    /** Shown in Mastra's logs; defaults to "provider". */
+    name?: string;
+}
+/** The request-context key the server stores the request's provider under. */
+export declare const PROVIDER = "provider";
+/** The request-context key for the model used when a request carries no provider (see `defaultModel`). */
+export declare const DEFAULT_MODEL = "default-model";
+/** What every factory here returns: an AI SDK language model, as Mastra agents take. */
+export type Model = LanguageModelV4;
+export declare const openAICompatible: (config: ProviderConfig) => Model;
+/**
+ * The model of the request's provider (see `PROVIDER`), else `fallback`, else
+ * the server's `defaultModel`. The default of every agent that doesn't name
+ * its own model.
+ */
+export declare function providerModel(requestContext?: RequestContext, fallback?: ProviderConfig): Model;
+/** The slice of the `AI` binding the Workers AI provider calls. */
+export interface AiBinding {
+    run(model: string, inputs: Record<string, unknown>, options?: unknown): Promise<unknown>;
+}
+/**
+ * A Workers AI model. `thinking` (for reasoning models such as Gemma 4 or
+ * Qwen 3) turns their thinking on or off through the chat template; leave it
+ * undefined for other models. With thinking on, the binding also drops
+ * `reasoning_effort`: Mastra sends the AI SDK's unified `reasoning` option,
+ * which the provider turns into `reasoning_effort`, and these models stop
+ * thinking whenever it is present at all.
+ */
+export declare function workersAI(binding: AiBinding, model: string, { thinking }?: {
+    thinking?: boolean;
+}): Model;
+/** Provider options that switch a Workers AI reasoning model's thinking on or off. */
+export declare const workersAIOptions: (thinking: boolean) => {
+    'workers-ai': {
+        chat_template_kwargs: {
+            enable_thinking: boolean;
+        };
+    };
+};
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,4GAA4G;AAC5G,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,8EAA8E;AAC9E,eAAO,MAAM,QAAQ,aAAa,CAAC;AACnC,0GAA0G;AAC1G,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,wFAAwF;AACxF,MAAM,MAAM,KAAK,GAAG,eAAe,CAAC;AAEpC,eAAO,MAAM,gBAAgB,GAAI,QAAQ,cAAc,KAAG,KAC8F,CAAC;AAEzJ;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,KAAK,CAM/F;AAED,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACzB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,KAAK,CAU7G;AAED,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,GAAI,UAAU,OAAO;;;;;;CAAgF,CAAC"}

package/dist/models.js

@@ -0,0 +1,46 @@
+// Model factories for Workers: any OpenAI-compatible endpoint, Workers AI,
+// and the provider a request carries (set by a middleware, see server.ts).
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { createWorkersAI } from 'workers-ai-provider';
+/** The request-context key the server stores the request's provider under. */
+export const PROVIDER = 'provider';
+/** The request-context key for the model used when a request carries no provider (see `defaultModel`). */
+export const DEFAULT_MODEL = 'default-model';
+export const openAICompatible = (config) => createOpenAICompatible({ name: config.name ?? 'provider', baseURL: config.baseURL.replace(/\/+$/, ''), apiKey: config.apiKey }).chatModel(config.model);
+/**
+ * The model of the request's provider (see `PROVIDER`), else `fallback`, else
+ * the server's `defaultModel`. The default of every agent that doesn't name
+ * its own model.
+ */
+export function providerModel(requestContext, fallback) {
+    const config = requestContext?.get(PROVIDER) ?? fallback;
+    if (config?.baseURL && config.model)
+        return openAICompatible(config);
+    const model = requestContext?.get(DEFAULT_MODEL);
+    if (model)
+        return model;
+    throw new Error('No model provider configured for this request');
+}
+/**
+ * A Workers AI model. `thinking` (for reasoning models such as Gemma 4 or
+ * Qwen 3) turns their thinking on or off through the chat template; leave it
+ * undefined for other models. With thinking on, the binding also drops
+ * `reasoning_effort`: Mastra sends the AI SDK's unified `reasoning` option,
+ * which the provider turns into `reasoning_effort`, and these models stop
+ * thinking whenever it is present at all.
+ */
+export function workersAI(binding, model, { thinking } = {}) {
+    const ai = {
+        run: (m, inputs, options) => {
+            if (thinking === undefined)
+                return binding.run(m, inputs, options);
+            const { reasoning_effort: _ignored, ...rest } = inputs;
+            const kwargs = { ...inputs.chat_template_kwargs, enable_thinking: thinking };
+            return binding.run(m, { ...(thinking ? rest : inputs), chat_template_kwargs: kwargs }, options);
+        },
+    };
+    return createWorkersAI({ binding: ai })(model);
+}
+/** Provider options that switch a Workers AI reasoning model's thinking on or off. */
+export const workersAIOptions = (thinking) => ({ 'workers-ai': { chat_template_kwargs: { enable_thinking: thinking } } });
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAWtD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC;AACnC,0GAA0G;AAC1G,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAK7C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAsB,EAAS,EAAE,CACjE,sBAAsB,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAEzJ;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,cAA+B,EAAE,QAAyB;IACvF,MAAM,MAAM,GAAI,cAAc,EAAE,GAAG,CAAC,QAAQ,CAAgC,IAAI,QAAQ,CAAC;IACzF,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK;QAAE,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,cAAc,EAAE,GAAG,CAAC,aAAa,CAAsB,CAAC;IACtE,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;AAClE,CAAC;AAOD;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAkB,EAAE,KAAa,EAAE,EAAE,QAAQ,KAA6B,EAAE;IACrG,MAAM,EAAE,GAAG;QACV,GAAG,EAAE,CAAC,CAAS,EAAE,MAA+B,EAAE,OAAiB,EAAE,EAAE;YACtE,IAAI,QAAQ,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACnE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;YACvD,MAAM,MAAM,GAAG,EAAE,GAAI,MAAM,CAAC,oBAA2C,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC;YACrG,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjG,CAAC;KACD,CAAC;IACF,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,EAAmB,EAAE,CAAC,CAAC,KAA0D,CAAqB,CAAC;AAC1I,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAiB,EAAE,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,oBAAoB,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/dist/routing.d.ts

@@ -0,0 +1,32 @@
+import { Agent } from '@mastra/core/agent';
+import type { RequestContext } from '@mastra/core/request-context';
+import { z } from 'zod';
+import type { AgentSpec } from './agents.js';
+import { type Model } from './models.js';
+export declare const RoutingPlanSchema: z.ZodObject<{
+    slices: z.ZodArray<z.ZodObject<{
+        agent: z.ZodString;
+        instructions: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type RoutingPlan = z.infer<typeof RoutingPlanSchema>;
+export interface ChatMessage {
+    role: string;
+    content: unknown;
+}
+/** The planner agent; `candidates` is set per request in its request context. */
+export declare function plannerAgent(model?: (requestContext: RequestContext) => Model, rules?: string): Agent<"planner", import("@mastra/core/agent").ToolsInput, undefined, any, import("@mastra/core/agent").AgentEditorConfig | undefined>;
+export declare const candidatesJson: (specs: AgentSpec[]) => string;
+/** Keep a model-made plan to known agents; null when nothing usable is left. */
+export declare function sanitizePlan(plan: RoutingPlan | null | undefined, ids: Set<string>, max?: number): RoutingPlan | null;
+export declare const fallbackPlan: (id: string, instructions: string) => RoutingPlan;
+/** The last `n` user turns, each with the replies that followed it. */
+export declare function recentTurns(messages: ChatMessage[], n?: number): ChatMessage[];
+export declare function textOf(content: unknown): string;
+export declare function lastUserText(messages: ChatMessage[]): string;
+/** One reply from several agents: their outputs under their names. */
+export declare const mergeReplies: (parts: {
+    name: string;
+    text: string;
+}[]) => string;
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;iBAW5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAWD,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,KAAK,EAAE,KAAK,SAAQ,yIAQ5F;AAED,eAAO,MAAM,cAAc,GAAI,OAAO,SAAS,EAAE,WAA+F,CAAC;AAEjJ,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,SAAI,GAAG,WAAW,GAAG,IAAI,CAGhH;AAED,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,cAAc,MAAM,KAAG,WAA0D,CAAC;AAE3H,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,CAAC,SAAI,GAAG,WAAW,EAAE,CAGzE;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI/C;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAG5D;AAED,sEAAsE;AACtE,eAAO,MAAM,YAAY,GAAI,OAAO;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,WAC2C,CAAC"}

package/dist/routing.js

@@ -0,0 +1,62 @@
+// Multi-agent routing: a planner agent reads the agents' descriptions and the
+// last few turns, and assigns the request to one or more of them (at most 3),
+// each with its own slice of the work. Falls back to the first agent.
+import { Agent } from '@mastra/core/agent';
+import { z } from 'zod';
+import { providerModel } from './models.js';
+export const RoutingPlanSchema = z.object({
+    slices: z
+        .array(z.object({
+        agent: z.string(),
+        /** What this agent delivers, and only that. */
+        instructions: z.string(),
+    }))
+        .min(1)
+        .max(3),
+});
+const RULES = `You are the routing planner of a multi-agent system.
+Pick which agent(s) handle the user's LAST message, using the earlier turns as context.
+Rules:
+- Only use agents from the list below.
+- Prefer one agent. Use several only for clearly distinct deliverables, at most 3.
+- Each slice owns exactly one deliverable; its instructions name only that deliverable, never the whole request.
+- Repeat shared constraints (dates, names, audience) in every slice that needs them.
+Reply with JSON only: {"slices":[{"agent":"<agent id>","instructions":"<what this agent delivers>"}]}`;
+/** The planner agent; `candidates` is set per request in its request context. */
+export function plannerAgent(model, rules = RULES) {
+    return new Agent({
+        id: 'planner',
+        name: 'Routing planner',
+        description: 'Assigns a request to the agents that should handle it.',
+        instructions: ({ requestContext }) => `${rules}\n\nAgents (JSON):\n${requestContext.get('candidates') ?? '[]'}`,
+        model: ({ requestContext }) => (model ?? providerModel)(requestContext),
+    });
+}
+export const candidatesJson = (specs) => JSON.stringify(specs.map((s) => ({ id: s.id, name: s.name, description: s.description })));
+/** Keep a model-made plan to known agents; null when nothing usable is left. */
+export function sanitizePlan(plan, ids, max = 3) {
+    const slices = (plan?.slices ?? []).filter((s) => s && ids.has(s.agent)).slice(0, Math.max(1, Math.min(max, 3)));
+    return slices.length ? { slices } : null;
+}
+export const fallbackPlan = (id, instructions) => ({ slices: [{ agent: id, instructions }] });
+/** The last `n` user turns, each with the replies that followed it. */
+export function recentTurns(messages, n = 3) {
+    const users = messages.flatMap((m, i) => (m.role === 'user' ? [i] : []));
+    return users.length <= n ? messages : messages.slice(users[users.length - n]);
+}
+export function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content))
+        return content.map((p) => (p && typeof p === 'object' && 'text' in p ? String(p.text) : '')).join('\n');
+    return '';
+}
+export function lastUserText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--)
+        if (messages[i].role === 'user')
+            return textOf(messages[i].content);
+    return '';
+}
+/** One reply from several agents: their outputs under their names. */
+export const mergeReplies = (parts) => parts.length === 1 ? parts[0].text.trim() : parts.map((p) => `**${p.name}**\n\n${p.text.trim()}`).join('\n\n');
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAc,MAAM,aAAa,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC;SACP,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;QACR,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,+CAA+C;QAC/C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;KACxB,CAAC,CACF;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;CACR,CAAC,CAAC;AAQH,MAAM,KAAK,GAAG;;;;;;;sGAOwF,CAAC;AAEvG,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,KAAiD,EAAE,KAAK,GAAG,KAAK;IAC5F,OAAO,IAAI,KAAK,CAAC;QAChB,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,wDAAwD;QACrE,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,GAAG,KAAK,uBAAuB,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE;QAC/G,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC,cAAc,CAAU;KAChF,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;AAEjJ,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,IAAoC,EAAE,GAAgB,EAAE,GAAG,GAAG,CAAC;IAC3F,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,YAAoB,EAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;AAE3H,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,QAAuB,EAAE,CAAC,GAAG,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAgB;IACtC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpI,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAuB;IACnD,KAAK,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnH,OAAO,EAAE,CAAC;AACX,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAuC,EAAE,EAAE,CACvE,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,34 @@
+import { RequestContext } from '@mastra/core/request-context';
+import type { AgentRegistry, AgentSpec } from './agents.js';
+import { type Model, type ProviderConfig } from './models.js';
+export declare const HEADERS: {
+    readonly baseURL: "x-provider-base-url";
+    readonly key: "x-provider-key";
+    readonly model: "x-provider-model";
+    readonly agents: "x-agents";
+    readonly session: "x-session-id";
+};
+export interface AgentServerOptions<T extends AgentSpec, E> {
+    agents: AgentRegistry<T>;
+    /** Shown as `owned_by` in /v1/models and in the health check. */
+    name?: string;
+    /** The bearer key callers must send; none (or empty) leaves the server open. */
+    apiKey?: (env: E) => string | undefined;
+    /** The provider when the request doesn't carry one (e.g. from env vars). */
+    provider?: (env: E) => ProviderConfig | undefined;
+    /** The model when there's no provider at all, e.g. `workersAI(env.AI, …)`: works with no keys. */
+    defaultModel?: (env: E) => Model;
+    /** "auto" routing; false turns it off. The planner uses the request's provider unless given a model. */
+    planner?: false | {
+        model?: (requestContext: RequestContext) => Model;
+        rules?: string;
+    };
+    /** Tool-call rounds per reply (default 5); a function to set it per environment. */
+    maxSteps?: number | ((env: E) => number);
+    /** Most agents "auto" may split a request across (default 3; 1 to never split). */
+    maxAgents?: number | ((env: E) => number);
+}
+export declare function createAgentServer<T extends AgentSpec, E = unknown>(options: AgentServerOptions<T, E>): {
+    fetch(request: Request, env: E): Promise<Response>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAA2B,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGvF,eAAO,MAAM,OAAO;;;;;;CAMV,CAAC;AAEX,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC;IACzD,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,cAAc,GAAG,SAAS,CAAC;IAClD,kGAAkG;IAClG,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC;IACjC,wGAAwG;IACxG,OAAO,CAAC,EAAE,KAAK,GAAG;QAAE,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,KAAK,KAAK,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;IACzC,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC;CAC1C;AAwBD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;mBAO9E,OAAO,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;EAqMzD"}