@loopingai/core 0.5.0 → 0.6.0

package/README.md

@@ -188,8 +188,8 @@ probed for), and hand-rolling it is how two agents in one repo drift apart.
 
 ### 4. Delegate, if your agent delegates
 
-`@loopingai/core/round` adds the other half: a durable Subtask DAG, wave
-scheduling, isolated subagent execution, and the round loop over them.
+`@loopingai/core/round` adds the other half: durable Subtasks, concurrent
+execution, isolated subagents, and the round loop over them.
 
 ```ts
 import { RoundAgentBase, type RoundPolicy } from "@loopingai/core/round";
@@ -225,10 +225,11 @@ not drag in the A2A adapter, and the test harness cannot reach a production bund
 | `@loopingai/core`              | `createAgentRuntime`, the plugin contract, config shapes, platform facts    |
 | `@loopingai/core/a2a`          | card signing, JWKS, gateway-JWT verify, push notify, task store, executor   |
 | `@loopingai/core/worker`       | `createA2AWorker()` — the whole zero-trust edge                             |
-| `@loopingai/core/agent`        | session, history, model runtime, inference, budget, control tools           |
+| `@loopingai/core/agent`        | session, history, models + Workers AI, inference, budget, control tools     |
 | `@loopingai/core/host`         | `LoopingAgent` — the Durable Object body — and `PluginHost`                 |
 | `@loopingai/core/round`        | the delegating round loop: `RoundAgentBase`, `runHandleTask`, `runTurn`     |
-| `@loopingai/core/subtasks`     | delegation types, decomposition, the `delegate` tool, wave scheduler        |
+| `@loopingai/core/anthropic`    | Claude as a second provider — _optional peer on `@anthropic-ai/sdk`_        |
+| `@loopingai/core/subtasks`     | delegation types, decomposition, the `delegate` tool                        |
 | `@loopingai/core/subagent`     | `RecipeSubagentBase`, resumable runs, fingerprinting, workspace             |
 | `@loopingai/core/db`           | `AgentDB`, `notify_tasks` + `subtasks` schema, migrations, `PluginStore`    |
 | `@loopingai/core/testing`      | VCR, `FakeSession`, `mockModel`, DO helpers, JWK fixtures — _workerd realm_ |
@@ -465,6 +466,7 @@ await withDb("accepts a turn once", async (db) => {
 - **Bindings:** `AI`, one Durable Object, one Workflow
 - **Secrets:** `A2A_SIGNING_KEY`, `GATEWAY_ORIGINS`
 - **Peers, never bundled:** `agents`, `ai`, `workers-ai-provider`
+- **Optional peer:** `@anthropic-ai/sdk`, needed only by `@loopingai/core/anthropic`
 
 That last point is not stylistic: two copies of `agents` in one Worker breaks the
 `Session` / `SessionMessage` types and every `instanceof`. For local development

package/dist/a2a/agent-stub.d.ts

@@ -58,4 +58,3 @@ export interface TaskListPage {
  * what makes a task unreachable from any other caller by construction.
  */
 export type AgentResolver = (identity: GatewayIdentity) => TaskAgent;
-//# sourceMappingURL=agent-stub.d.ts.map

package/dist/a2a/agent-stub.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=agent-stub.js.map

package/dist/a2a/caller.d.ts

@@ -21,4 +21,3 @@ import type { GatewayIdentity } from "./verify.js";
  * wants to name it.
  */
 export declare function callerContext(identity: GatewayIdentity): string;
-//# sourceMappingURL=caller.d.ts.map

package/dist/a2a/caller.js

@@ -31,4 +31,3 @@ export function callerContext(identity) {
     }
     return lines.join("\n");
 }
-//# sourceMappingURL=caller.js.map

package/dist/a2a/card.d.ts

@@ -156,4 +156,3 @@ export declare function publicCardJwks(privateJwk: JWK & {
 }): {
     keys: JWK[];
 };
-//# sourceMappingURL=card.d.ts.map

package/dist/a2a/card.js

@@ -159,4 +159,3 @@ export function publicCardJwks(privateJwk) {
     void _d;
     return { keys: [{ ...pub, use: "sig", alg: A2A_JWS_ALG }] };
 }
-//# sourceMappingURL=card.js.map

package/dist/a2a/context.d.ts

@@ -17,4 +17,3 @@ import type { GatewayIdentity } from "./verify.js";
 export declare function buildCallContext(request: Request, identity: GatewayIdentity, tenant: string): ServerCallContext;
 /** Echo back the extensions the handler actually activated (spec §14.2.2). */
 export declare function extensionHeaders(context: ServerCallContext): HeadersInit;
-//# sourceMappingURL=context.d.ts.map

package/dist/a2a/context.js

@@ -59,4 +59,3 @@ export function extensionHeaders(context) {
         return {};
     return { [HTTP_EXTENSION_HEADER]: Extensions.toServiceParameter(activated) };
 }
-//# sourceMappingURL=context.js.map

package/dist/a2a/executor.d.ts

@@ -82,4 +82,3 @@ export declare class A2AExecutor implements AgentExecutor {
      */
     cancelTask: (taskId: string, eventBus: ExecutionEventBus) => Promise<void>;
 }
-//# sourceMappingURL=executor.d.ts.map

package/dist/a2a/executor.js

@@ -104,4 +104,3 @@ export class A2AExecutor {
         eventBus.finished();
     };
 }
-//# sourceMappingURL=executor.js.map

package/dist/a2a/index.d.ts

@@ -30,4 +30,3 @@ export { buildCallContext, extensionHeaders } from "./context.js";
 export { DurableTaskStore } from "./task-store.js";
 export { A2AExecutor, workflowIdForMessage, ignoreAlreadyExists, type AcceptedTurn, type ExecutorConfig, type TurnStarter } from "./executor.js";
 export type { AgentResolver, TaskAgent, TaskListPage, TaskListQuery } from "./agent-stub.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/a2a/index.js

@@ -29,4 +29,3 @@ export { textPart, partsText, textOf, agentTextMessage, inboundText, InboundPart
 export { buildCallContext, extensionHeaders } from "./context.js";
 export { DurableTaskStore } from "./task-store.js";
 export { A2AExecutor, workflowIdForMessage, ignoreAlreadyExists } from "./executor.js";
-//# sourceMappingURL=index.js.map

package/dist/a2a/notify.d.ts

@@ -37,9 +37,10 @@ export { NOTIFICATION_TOKEN_HEADER } from "@loopingai/a2a-protocol";
  */
 export declare function buildSubmittedTask(taskId: string, contextId: string): PlainTask;
 /**
- * The terminal `completed` Task for a turn the agent deliberately did not answer
- * (it called the `no_reply` tool — see the agent loop). Same
- * shape as {@link buildSubmittedTask}: **no `status.message` at all**.
+ * The terminal `completed` Task for a turn the agent deliberately did not
+ * answer — a turn an `AgentPlugin.shouldHandleTurn` gate declined, or whatever
+ * else a host treats as "nothing to say". Same shape as
+ * {@link buildSubmittedTask}: **no `status.message` at all**.
  *
  * The callback is still POSTed. The gateway's pending row has to resolve — we
  * simply hand it nothing to post to Slack. There is no `messageId` because there
@@ -103,4 +104,3 @@ export declare function signCallbackJwt(privateJwk: JWK & {
  * workflow's `notify` step) can decide whether a non-2xx warrants a retry.
  */
 export declare function postNotification(url: string, token: string, jwt: string, task: Task): Promise<Response>;
-//# sourceMappingURL=notify.d.ts.map

package/dist/a2a/notify.js

@@ -69,9 +69,10 @@ export function buildSubmittedTask(taskId, contextId) {
     return buildBareTask(taskId, contextId, TaskState.TASK_STATE_SUBMITTED);
 }
 /**
- * The terminal `completed` Task for a turn the agent deliberately did not answer
- * (it called the `no_reply` tool — see the agent loop). Same
- * shape as {@link buildSubmittedTask}: **no `status.message` at all**.
+ * The terminal `completed` Task for a turn the agent deliberately did not
+ * answer — a turn an `AgentPlugin.shouldHandleTurn` gate declined, or whatever
+ * else a host treats as "nothing to say". Same shape as
+ * {@link buildSubmittedTask}: **no `status.message` at all**.
  *
  * The callback is still POSTed. The gateway's pending row has to resolve — we
  * simply hand it nothing to post to Slack. There is no `messageId` because there
@@ -177,4 +178,3 @@ export async function postNotification(url, token, jwt, task) {
         body
     });
 }
-//# sourceMappingURL=notify.js.map

package/dist/a2a/parts.d.ts

@@ -43,4 +43,3 @@ export declare function agentTextMessage(input: {
     contextId: string;
     taskId: string;
 }): PlainMessage;
-//# sourceMappingURL=parts.d.ts.map

package/dist/a2a/parts.js

@@ -92,4 +92,3 @@ export function agentTextMessage(input) {
         referenceTaskIds: []
     };
 }
-//# sourceMappingURL=parts.js.map

package/dist/a2a/push.d.ts

@@ -68,4 +68,3 @@ export interface PushChannel {
  * one card and the gateway pins one key for every agent on it.
  */
 export declare function createPushChannel(signingKey: string, push: TurnPushContext): PushChannel;
-//# sourceMappingURL=push.d.ts.map

package/dist/a2a/push.js

@@ -51,4 +51,3 @@ export function createPushChannel(signingKey, push) {
         }
     };
 }
-//# sourceMappingURL=push.js.map

package/dist/a2a/task-store.d.ts

@@ -42,4 +42,3 @@ export declare class DurableTaskStore implements TaskStore {
      */
     list(params: ListTasksRequest): Promise<ListTasksResponse>;
 }
-//# sourceMappingURL=task-store.d.ts.map

package/dist/a2a/task-store.js

@@ -97,4 +97,3 @@ function parseTimestamp(iso) {
     const ms = Date.parse(iso);
     return Number.isNaN(ms) ? undefined : ms;
 }
-//# sourceMappingURL=task-store.js.map

package/dist/a2a/task.d.ts

@@ -83,4 +83,3 @@ export interface PlainTask {
  */
 export declare function taskStateLabel(state: TaskState): string;
 export {};
-//# sourceMappingURL=task.d.ts.map

package/dist/a2a/task.js

@@ -13,4 +13,3 @@ export function taskStateLabel(state) {
         .toLowerCase()
         .replace(/_/g, "-");
 }
-//# sourceMappingURL=task.js.map

package/dist/a2a/verify.d.ts

@@ -74,4 +74,3 @@ export declare function verifyGatewayToken(token: string, opts: VerifyOptions):
     identity: GatewayIdentity;
     tenant: string;
 }>;
-//# sourceMappingURL=verify.d.ts.map

package/dist/a2a/verify.js

@@ -137,4 +137,3 @@ export async function verifyGatewayToken(token, opts) {
         throw new GatewayAuthError(err.message);
     }
 }
-//# sourceMappingURL=verify.js.map

package/dist/agent/anthropic/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@loopingai/core/anthropic` — Claude as a second model provider.
+ *
+ * Its own subpath, and an **optional** peer dependency on `@anthropic-ai/sdk`,
+ * for the same reason `/round` is not re-exported from the root barrel: an agent
+ * that runs on Workers AI should not pay — in install size, in bundle bytes, or
+ * in a dependency it must keep current — for a provider it never calls.
+ *
+ * What lives here is a provider, not a capability. It ships no tools, no prompt
+ * copy and no policy; it satisfies {@link ModelRuntime} and stops.
+ */
+export { CredentialRejectedError, type CredentialRejectedBy } from "../errors.js";
+export { createAnthropicLanguageModel, type AnthropicModelDeps } from "./language-model.js";
+export { createAnthropicModelRuntime, type AnthropicRuntimeDeps } from "./runtime.js";
+export { ANTHROPIC_PROVIDER, type CacheTtl } from "./prompt.js";

package/dist/agent/anthropic/index.js

@@ -0,0 +1,19 @@
+/**
+ * `@loopingai/core/anthropic` — Claude as a second model provider.
+ *
+ * Its own subpath, and an **optional** peer dependency on `@anthropic-ai/sdk`,
+ * for the same reason `/round` is not re-exported from the root barrel: an agent
+ * that runs on Workers AI should not pay — in install size, in bundle bytes, or
+ * in a dependency it must keep current — for a provider it never calls.
+ *
+ * What lives here is a provider, not a capability. It ships no tools, no prompt
+ * copy and no policy; it satisfies {@link ModelRuntime} and stops.
+ */
+// Re-exported, not owned: a rejected credential is a fact about the path to a
+// model, not about Anthropic, so the error lives with the rest of the provider
+// contract in {@link file://../errors.ts}. An agent that only imports this
+// subpath still gets it from one place.
+export { CredentialRejectedError } from "../errors.js";
+export { createAnthropicLanguageModel } from "./language-model.js";
+export { createAnthropicModelRuntime } from "./runtime.js";
+export { ANTHROPIC_PROVIDER } from "./prompt.js";

package/dist/agent/anthropic/language-model.d.ts

@@ -0,0 +1,59 @@
+import type Anthropic from "@anthropic-ai/sdk";
+import type { LanguageModelV4 } from "@ai-sdk/provider";
+import { type CredentialRejectedBy } from "../errors.js";
+import { type CacheTtl } from "./prompt.js";
+/**
+ * A `LanguageModelV4` over `@anthropic-ai/sdk`, so core's loops can call Claude
+ * without knowing they are.
+ *
+ * Every loop in core is written against `generateText` from `ai` and a
+ * `LanguageModel` — {@link file://../../round/turn.ts turn.ts},
+ * {@link file://../../subagent/run.ts run.ts} and
+ * {@link file://../session.ts session.ts}. Satisfying that interface is what
+ * keeps the round loop, the control-tool repair ladder, subtask execution and
+ * the Workflow untouched by a second provider. The alternative — a bespoke
+ * Messages-API loop for one agent — would have given all of that up.
+ *
+ * `ai@7` accepts `LanguageModelV2 | V3 | V4`; this targets **v4**, the newest
+ * the installed `@ai-sdk/provider` defines.
+ */
+/** How the adapter reaches the API. Everything is injected so nothing reads env. */
+export interface AnthropicModelDeps {
+    /**
+     * Constructed lazily by the runtime — see the note in
+     * {@link file://./runtime.ts}. Awaited, because building it has to resolve
+     * `env.AI.gateway(id).getUrl()`, which is async.
+     */
+    client: () => Anthropic | Promise<Anthropic>;
+    /** Anthropic model id, e.g. `claude-opus-5`. */
+    modelId: string;
+    /** `max_tokens` when a caller supplies none. Anthropic requires the field. */
+    defaultMaxTokens: number;
+    /** Prompt-cache TTL, or `false` to place no breakpoints. Defaults to `"5m"`. */
+    cache?: CacheTtl | false;
+    /**
+     * Reasoning effort, when the caller does not set one per-call.
+     *
+     * Maps to `output_config.effort`. Coding and agentic work wants `"xhigh"`;
+     * `"high"` is the API default. Core never picks this — an agent does.
+     */
+    effort?: "low" | "medium" | "high" | "xhigh" | "max";
+    /** Extra headers merged into every request (AI Gateway metadata lives here). */
+    headers?: Record<string, string>;
+    /**
+     * Recognise a deployment-specific authority in a `401`/`403` body.
+     *
+     * Consulted before the built-in shapes; return `undefined` to fall through to
+     * them. It exists because a deployment may put an authenticated intermediary
+     * between the gateway and Anthropic, and only that deployment knows what its
+     * refusal looks like — core recognising one particular proxy's error body
+     * would be exactly the deployment policy this package does not ship.
+     *
+     * The remedy is what makes it worth distinguishing at all: a proxy that mints
+     * its caller credential per request has no secret to rotate, so reporting its
+     * `401` as `credential` sends an operator to replace a working token. See
+     * {@link file://../errors.ts CredentialRejectedBy}.
+     */
+    classifyAuthFailure?: (body: unknown) => CredentialRejectedBy | undefined;
+}
+export declare function createAnthropicLanguageModel(deps: AnthropicModelDeps): LanguageModelV4;