@ank1015/agents-runtime 0.1.11

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+All notable changes to `@ank1015/agents-runtime` will be documented in this file.
+
+## 0.1.11
+
+- First public npm release of the generic agent loop runtime.
+- Depends on `@ank1015/agents-contracts@^0.1.11`.
+
+## 0.1.1
+
+- Internal workspace package version prior to first public publish.
+
+## 0.1.0 - Initial Release
+
+- Added the `Agent` container with transport, tool registry, plugin interceptors, and config.
+- Added per-run `AgentRun` handles with event streaming, `abort()`, and `send()` steering.
+- Added `defineTool`, tool registry, and argument validation helpers.
+- Added interceptor-based plugin installation across loop stages.
+- Added utility helpers for ids, time, content, usage, errors, and abort.
+- Added grouped package exports for `tools` and `utils`.

package/README.md

@@ -0,0 +1,92 @@
+# @ank1015/agents-runtime
+
+Generic agent loop runtime for the `@ank1015/agents` packages.
+
+This package turns an injected `LLMTransport` into a multi-turn, tool-using agent. Extensibility is a single interceptor primitive that can observe, transform, wrap, replace, or re-run any stage of the loop.
+
+It depends only on `@ank1015/agents-contracts` (and `zod`). Hand it any transport — `createAdapterTransport`, `GatewayTransport`, or your own.
+
+## Install
+
+```sh
+pnpm add @ank1015/agents-runtime
+```
+
+## What This Package Provides
+
+- `Agent` — durable container for transport, tools, plugins, and config
+- `AgentRun` — per-run event stream with `abort()` and `send()` steering
+- `defineTool` / tool registry helpers
+- Utility helpers for ids, time, content, usage, errors, and abort
+
+## Import Paths
+
+```ts
+import { Agent, defineTool, createEventStream } from '@ank1015/agents-runtime';
+import { defineTool as defineToolFromTools } from '@ank1015/agents-runtime/tools';
+import { createId, now } from '@ank1015/agents-runtime/utils';
+```
+
+## Quick Start
+
+```ts
+import { Agent, defineTool } from '@ank1015/agents-runtime';
+import { createAdapterTransport } from '@ank1015/agents-core/transport';
+import { createAnthropicProviderAdapter } from '@ank1015/agents-provider-anthropic';
+import { z } from 'zod';
+
+const transport = createAdapterTransport([
+  createAnthropicProviderAdapter({
+    provider: 'anthropic',
+    apiKey: { type: 'env', name: 'ANTHROPIC_API_KEY' },
+  }),
+]);
+
+const agent = new Agent({
+  transport,
+  config: {
+    provider: 'anthropic',
+    modelId: 'claude-sonnet-4-6',
+    instructions: 'You are a helpful coding assistant.',
+  },
+  tools: [
+    defineTool({
+      name: 'echo',
+      description: 'Echo a string back',
+      parameters: z.object({ text: z.string() }),
+      execute: async ({ args }) => ({
+        content: [{ type: 'text', text: args.text }],
+      }),
+    }),
+  ],
+});
+
+const run = agent.run({
+  messages: [{ role: 'user', content: [{ type: 'text', text: 'Say hello via echo.' }] }],
+});
+
+for await (const event of run) {
+  console.log(event.type);
+}
+
+const result = await run.result();
+```
+
+## Plugins
+
+Plugins install interceptors on loop stages (`input`, `request`, `model`, `response`, `tool`, `result`, `finish`). Add them at construction or with `agent.use(plugin)` before the first run.
+
+```ts
+agent.use({
+  name: 'log-requests',
+  setup(api) {
+    api.before('request', (ctx) => {
+      console.log('request', ctx.request.modelId);
+    });
+  },
+});
+```
+
+## Versioning
+
+This package is currently `0.1.11`. Until `1.0.0`, public runtime APIs may still evolve as the agent contract and plugin surface settle.

package/dist/agent.d.ts

@@ -0,0 +1,42 @@
+import type { AgentConfig, AgentEventStream, AgentInput, AgentPlugin, ExecutableTool, LLMTransport, Message, Provider, ToolRegistry } from '@ank1015/agents-contracts';
+export interface AgentOptions<P extends Provider = Provider> {
+    transport: LLMTransport;
+    config: AgentConfig<P>;
+    tools?: readonly ExecutableTool[];
+    plugins?: readonly AgentPlugin[];
+    deps?: {
+        createId?: (prefix?: string) => string;
+        now?: () => number;
+    };
+}
+/**
+ * A run handle: the loop's event stream (`for await` / `result()` / `drain()`)
+ * plus out-of-band control — `abort()` cancels the run, `send()` injects a
+ * message that the loop drains at the top of the next turn (steering /
+ * side-agents).
+ */
+export interface AgentRun<P extends Provider = Provider> extends AgentEventStream<P> {
+    abort(): void;
+    send(message: Message): void;
+}
+/**
+ * The durable, reusable container. Owns the transport, tool registry, plugin
+ * interceptors, and resolved config. `run()` starts an isolated run (fresh
+ * state per call) and returns an {@link AgentRun}.
+ */
+export declare class Agent<P extends Provider = Provider> {
+    #private;
+    constructor(options: AgentOptions<P>);
+    /** The tool registry, so callers can register tools after construction. */
+    get tools(): ToolRegistry;
+    use(plugin: AgentPlugin): this;
+    tool(tool: ExecutableTool): this;
+    /**
+     * Starts an isolated run. With no `input.model`, the run uses the agent's
+     * default config and is typed `AgentRun<P>`. With `input.model`, the whole run
+     * uses that {@link ModelSelection} — possibly a different provider — and the
+     * run is typed to that provider (`Q`). Plugins still adjust the model per turn.
+     */
+    run<Q extends Provider = P>(input: AgentInput<Q>): AgentRun<Q>;
+}
+//# 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,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAEhB,UAAU,EACV,WAAW,EAEX,cAAc,EACd,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,YAAY,EACb,MAAM,2BAA2B,CAAC;AAQnC,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACzD,SAAS,EAAE,YAAY,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;QACvC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;IAClF,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,KAAK,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;;gBAWlC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;IAWpC,2EAA2E;IAC3E,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAQ9B,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKhC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,QAAQ,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;CA+B/D"}

package/dist/agent.js

@@ -0,0 +1,102 @@
+import { createEventStream } from '@ank1015/agents-contracts';
+import { AgentLoop } from './kernel/driver.js';
+import { createInterceptorStore, installPlugins, makePluginApi } from './plugins/registry.js';
+import { createToolRegistry } from './tools/registry.js';
+import { createId as defaultCreateId, now as defaultNow } from './utils/index.js';
+/**
+ * The durable, reusable container. Owns the transport, tool registry, plugin
+ * interceptors, and resolved config. `run()` starts an isolated run (fresh
+ * state per call) and returns an {@link AgentRun}.
+ */
+export class Agent {
+    #transport;
+    #config;
+    #tools;
+    #interceptors;
+    #plugins;
+    #api;
+    #createId;
+    #now;
+    #ready;
+    constructor(options) {
+        this.#transport = options.transport;
+        this.#config = options.config;
+        this.#tools = createToolRegistry(options.tools ?? []);
+        this.#interceptors = createInterceptorStore();
+        this.#api = makePluginApi(this.#interceptors, this.#tools);
+        this.#plugins = [...(options.plugins ?? [])];
+        this.#createId = options.deps?.createId ?? defaultCreateId;
+        this.#now = options.deps?.now ?? defaultNow;
+    }
+    /** The tool registry, so callers can register tools after construction. */
+    get tools() {
+        return this.#tools;
+    }
+    use(plugin) {
+        if (this.#ready !== undefined) {
+            throw new Error('Cannot add plugins after the first run has started.');
+        }
+        this.#plugins.push(plugin);
+        return this;
+    }
+    tool(tool) {
+        this.#tools.register(tool);
+        return this;
+    }
+    /**
+     * Starts an isolated run. With no `input.model`, the run uses the agent's
+     * default config and is typed `AgentRun<P>`. With `input.model`, the whole run
+     * uses that {@link ModelSelection} — possibly a different provider — and the
+     * run is typed to that provider (`Q`). Plugins still adjust the model per turn.
+     */
+    run(input) {
+        this.#ready ??= installPlugins(this.#plugins, this.#api);
+        // Resolve the run's config: a per-run override replaces the model selection
+        // (provider/modelId/providerOptions) entirely while keeping the agent's
+        // instructions. The transport routes by provider at runtime, which the static
+        // generic can't track — hence the cast on the no-override branch, where `Q`
+        // resolves to `P` at the call site.
+        let config;
+        if (input.model) {
+            config = { ...input.model };
+            if (this.#config.instructions !== undefined) {
+                config.instructions = this.#config.instructions;
+            }
+        }
+        else {
+            config = this.#config;
+        }
+        const source = createEventStream();
+        const loop = new AgentLoop({
+            transport: this.#transport,
+            tools: this.#tools,
+            interceptors: this.#interceptors,
+            config,
+            ready: this.#ready,
+            createId: this.#createId,
+            now: this.#now,
+        });
+        void loop.drive(input, source);
+        return makeAgentRun(source, loop);
+    }
+}
+function makeAgentRun(source, loop) {
+    return {
+        [Symbol.asyncIterator]() {
+            return source[Symbol.asyncIterator]();
+        },
+        result() {
+            return source.result();
+        },
+        drain() {
+            return source.drain();
+        },
+        abort() {
+            loop.abort();
+        },
+        send(message) {
+            loop.send(message);
+        },
+    };
+}
+//# 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/index.d.ts

@@ -0,0 +1,5 @@
+export * from './agent.js';
+export * from './tools/index.js';
+export * from './utils/index.js';
+export { createEventStream } from '@ank1015/agents-contracts';
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './agent.js';
+export * from './tools/index.js';
+export * from './utils/index.js';
+export { createEventStream } from '@ank1015/agents-contracts';
+//# 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,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/kernel/context.d.ts

@@ -0,0 +1,28 @@
+import type { AgentConfig, AgentEvent, AgentState, AssistantToolCall, LLMRequest, LLMTransport, Message, Provider, Stage, StageContext, ToolRegistry } from '@ank1015/agents-contracts';
+/** Operation-local data the kernel attaches for the node stages. */
+export interface StageExtras<P extends Provider = Provider> {
+    request?: LLMRequest<P>;
+    call?: AssistantToolCall;
+}
+/**
+ * Live wiring the kernel hands to {@link makeStageContext}. The context is a
+ * thin view over these: state/config are the loop's mutable objects, the rest
+ * are bound callbacks, so every interceptor sees the current run.
+ */
+export interface KernelBindings<P extends Provider = Provider> {
+    state: AgentState<P>;
+    getConfig: () => AgentConfig<P>;
+    setConfig: (config: AgentConfig<P>) => void;
+    signal: AbortSignal | undefined;
+    metadata: Record<string, unknown>;
+    transport: LLMTransport;
+    tools: ToolRegistry;
+    emit: (event: AgentEvent<P>) => void;
+    addMessage: (message: Message) => void;
+    updateMessages: (update: (messages: Message[]) => Message[]) => void;
+    requestContinue: () => void;
+    requestStop: (reason?: string) => void;
+}
+/** Builds the {@link StageContext} an interceptor receives for one stage. */
+export declare function makeStageContext<S extends Stage, P extends Provider = Provider>(bindings: KernelBindings<P>, stage: S, extras?: StageExtras<P>): StageContext<S, P>;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/kernel/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,oEAAoE;AACpE,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IACxD,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAC3D,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,MAAM,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,CAAC;IACrE,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,QAAQ,GAAG,QAAQ,EAC7E,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,MAAM,GAAE,WAAW,CAAC,CAAC,CAAM,GAC1B,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAiCpB"}

package/dist/kernel/context.js

@@ -0,0 +1,31 @@
+/** Builds the {@link StageContext} an interceptor receives for one stage. */
+export function makeStageContext(bindings, stage, extras = {}) {
+    const ctx = {
+        stage,
+        state: bindings.state,
+        signal: bindings.signal,
+        metadata: bindings.metadata,
+        get config() {
+            return bindings.getConfig();
+        },
+        set config(value) {
+            bindings.setConfig(value);
+        },
+        transport: bindings.transport,
+        tools: bindings.tools,
+        emit: bindings.emit,
+        addMessage: bindings.addMessage,
+        updateMessages: bindings.updateMessages,
+        continue: bindings.requestContinue,
+        stop: bindings.requestStop,
+    };
+    const node = ctx;
+    if (extras.request !== undefined) {
+        node.request = extras.request;
+    }
+    if (extras.call !== undefined) {
+        node.call = extras.call;
+    }
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/kernel/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/kernel/context.ts"],"names":[],"mappings":"AAyCA,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAC9B,QAA2B,EAC3B,KAAQ,EACR,SAAyB,EAAE;IAE3B,MAAM,GAAG,GAAoB;QAC3B,KAAK;QACL,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,IAAI,MAAM;YACR,OAAO,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,MAAM,CAAC,KAAqB;YAC9B,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,QAAQ,EAAE,QAAQ,CAAC,eAAe;QAClC,IAAI,EAAE,QAAQ,CAAC,WAAW;KAC3B,CAAC;IAEF,MAAM,IAAI,GAAG,GAGZ,CAAC;IACF,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,OAAO,GAAyB,CAAC;AACnC,CAAC"}

package/dist/kernel/driver.d.ts

@@ -0,0 +1,27 @@
+import type { AgentConfig, AgentEventStreamSource, AgentInput, LLMTransport, Message, Provider, ToolRegistry } from '@ank1015/agents-contracts';
+import type { InterceptorStore } from '../plugins/registry.js';
+export interface AgentLoopDeps<P extends Provider = Provider> {
+    transport: LLMTransport;
+    tools: ToolRegistry;
+    interceptors: InterceptorStore;
+    config: AgentConfig<P>;
+    /** Resolves once all plugin `setup` calls have completed. */
+    ready: Promise<void>;
+    createId: (prefix?: string) => string;
+    now: () => number;
+}
+/**
+ * Per-run executor of the 5-edge / 2-node loop. Every stage is dispatched
+ * through {@link runStage}, which composes the stage's interceptors as an onion
+ * around the stage's real work. The loop owns the run invariants (one terminal
+ * event, tool-call/result pairing, abort propagation, continue ownership);
+ * everything else is a plugin's job.
+ */
+export declare class AgentLoop<P extends Provider = Provider> {
+    #private;
+    constructor(deps: AgentLoopDeps<P>);
+    abort(): void;
+    send(message: Message): void;
+    drive(input: AgentInput, source: AgentEventStreamSource<P>): Promise<void>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/kernel/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../src/kernel/driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAGX,sBAAsB,EAEtB,UAAU,EAOV,YAAY,EACZ,OAAO,EACP,QAAQ,EAKR,YAAY,EAGb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAgB/D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAC1D,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,6DAA6D;IAC7D,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;;gBAwBtC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;IAYlC,KAAK,IAAI,IAAI;IAIb,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMtB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAmcjF"}