@atoms-agent/core 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 atoms_agent contributors
+
+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,65 @@
+# @atoms-agent/core
+
+Agent loop, tool runtime, event stream, context strategy, limits, and
+cancellation for `atoms_agent`.
+
+This package depends on `@atoms-agent/llm` for model adapters and canonical
+message types. It does not depend on concrete business tools, MCP, coding
+toolkits, or host UI.
+
+## Install
+
+```bash
+npm install @atoms-agent/core @atoms-agent/llm
+```
+
+Local tarball (publish-ready verification):
+
+```bash
+npm install ./atoms-agent-llm-0.3.0.tgz ./atoms-agent-core-0.3.0.tgz
+```
+
+## Usage
+
+```typescript
+import { createAgent, defineTool } from "@atoms-agent/core";
+import { openai } from "@atoms-agent/llm";
+
+const agent = createAgent({
+  model: openai({
+    model: "gpt-5",
+    apiKey: process.env.OPENAI_API_KEY!,
+  }),
+  systemPrompt: "You are a helpful assistant.",
+  tools: [
+    defineTool({
+      name: "ping",
+      description: "Return pong",
+      inputSchema: {
+        type: "object",
+        properties: {},
+        additionalProperties: false,
+      },
+      sideEffect: "none",
+      execute: async () => ({ ok: true }),
+    }),
+  ],
+});
+
+for await (const event of agent.run("hello")) {
+  if (event.type === "message_delta") {
+    process.stdout.write(event.delta);
+  }
+}
+```
+
+Only import from the package root. Subpath / deep imports are not supported.
+
+## Requirements
+
+- Node.js >= 22.13
+- ESM
+
+## License
+
+MIT

package/dist/agent.d.ts

@@ -0,0 +1,58 @@
+import type { ModelAdapter } from "@atoms-agent/llm";
+import { type ContextStrategy } from "./context.js";
+import type { AgentEvent } from "./events.js";
+import type { RunLimits } from "./limits.js";
+import type { RuntimeRegistry } from "./registry.js";
+import { type AgentSpec } from "./spec.js";
+import { type AgentState, type AgentStateSnapshot } from "./state.js";
+import { type StructuredOutputConfig } from "./structured-output.js";
+import { type AuthorizeFn, type ToolDefinition } from "./tool.js";
+/**
+ * 内联形态：直接传入实现，用于快速上手。
+ * 内部会构建匿名 Registry 并归一为 Spec 形态（PRD §9 裁决）。
+ */
+export type InlineAgentOptions = {
+    model: ModelAdapter;
+    systemPrompt: string;
+    tools?: ToolDefinition[];
+    context?: ContextStrategy;
+    limits?: RunLimits;
+    structuredOutput?: StructuredOutputConfig;
+    authorize?: AuthorizeFn;
+};
+/** 配置化形态：可序列化 Spec + 运行时 Registry。 */
+export type SpecAgentOptions = {
+    spec: AgentSpec;
+    registry: RuntimeRegistry;
+    authorize?: AuthorizeFn;
+};
+export type CreateAgentOptions = InlineAgentOptions | SpecAgentOptions;
+export type RunOptions = {
+    /** Host 侧取消信号；与 timeoutMs 组合生效。 */
+    signal?: AbortSignal;
+};
+export interface Agent {
+    /**
+     * 执行一次 Run：输入 -> Loop -> Event Stream。
+     * 迭代结束（agent_end 或 error 后）Run 终止；消息历史保留在 Agent 内。
+     */
+    run(input: string, options?: RunOptions): AsyncIterable<AgentEvent>;
+    /** 当前消息历史的只读快照。 */
+    state(): AgentState;
+    /**
+     * 导出 JSON-safe 状态（CORE-006）。
+     * Run 进行中禁止导出；应用可自行持久化，但不承诺 Crash Consistency、
+     * 并发写或副作用恢复。
+     */
+    exportState(): AgentStateSnapshot;
+    /**
+     * 从 Snapshot 恢复消息历史。
+     * 拒绝非法/不兼容 Snapshot；Run 进行中禁止恢复。
+     */
+    restoreState(snapshot: unknown): void;
+}
+/**
+ * 创建 Agent（任务 C104 实现 Loop；两种形态共用同一个 Loop，禁止两套实现）。
+ */
+export declare function createAgent(options: CreateAgentOptions): Agent;
+//# 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,EAAa,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAiC,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB,CAAC;AAEF,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,WAAW,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG;IACvB,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAEpE,mBAAmB;IACnB,KAAK,IAAI,UAAU,CAAC;IAEpB;;;;OAIG;IACH,WAAW,IAAI,kBAAkB,CAAC;IAElC;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,KAAK,CAkC9D"}

package/dist/agent.js

@@ -0,0 +1,118 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+import { randomUUID } from "node:crypto";
+import { slidingWindow } from "./context.js";
+import { runLoop } from "./internal/loop.js";
+import { DEFAULT_LIMITS } from "./limits.js";
+import { createRegistry } from "./registry.js";
+import { assertAgentSpec } from "./spec.js";
+import { exportState as exportAgentState, restoreState as restoreAgentState, } from "./state.js";
+import { createStructuredOutputRuntime } from "./structured-output.js";
+import { defaultAuthorize } from "./tool.js";
+/**
+ * 创建 Agent（任务 C104 实现 Loop；两种形态共用同一个 Loop，禁止两套实现）。
+ */
+export function createAgent(options) {
+    if ("spec" in options) {
+        return createSpecAgent(options.spec, options.registry, options.authorize);
+    }
+    const registry = createRegistry();
+    const modelRef = "inline.model";
+    const contextRef = "inline.context";
+    registry.model(modelRef, options.model);
+    registry.context(contextRef, options.context ??
+        slidingWindow({ maxTokens: options.model.capabilities.maxContextTokens ?? 32_000 }));
+    const tools = options.tools ?? [];
+    const toolBindings = tools.map((tool, index) => {
+        const ref = `inline.tool.${index + 1}`;
+        registry.tool(ref, tool);
+        return { ref };
+    });
+    const spec = {
+        id: `inline:${options.model.modelId}`,
+        model: { ref: modelRef },
+        systemPrompt: options.systemPrompt,
+        tools: toolBindings,
+        context: { ref: contextRef },
+        ...(options.limits === undefined ? {} : { limits: options.limits }),
+        ...(options.structuredOutput === undefined
+            ? {}
+            : { structuredOutput: options.structuredOutput }),
+    };
+    return createSpecAgent(spec, registry, options.authorize);
+}
+function createSpecAgent(sourceSpec, registry, authorize) {
+    assertAgentSpec(sourceSpec);
+    const spec = structuredClone(sourceSpec);
+    const model = registry.resolveModel(spec.model.ref);
+    const contextBinding = spec.context;
+    const context = contextBinding === undefined
+        ? slidingWindow({ maxTokens: model.capabilities.maxContextTokens ?? 32_000 })
+        : registry.resolveContext(contextBinding.ref);
+    const contextConfig = contextBinding?.config;
+    const tools = new Map();
+    for (const binding of spec.tools) {
+        const tool = registry.resolveTool(binding.ref);
+        if (tools.has(tool.name)) {
+            throw new AtomsAgentError("CONFIG_ERROR", `Agent ${spec.id} resolves multiple Tools named ${tool.name}.`);
+        }
+        tools.set(tool.name, {
+            tool,
+            ...(binding.config === undefined ? {} : { config: structuredClone(binding.config) }),
+        });
+    }
+    const limits = { ...DEFAULT_LIMITS, ...spec.limits };
+    const structuredOutput = spec.structuredOutput === undefined
+        ? undefined
+        : createStructuredOutputRuntime(spec.structuredOutput);
+    const state = { messages: [] };
+    let running = false;
+    return {
+        run(input, runOptions) {
+            const runId = randomUUID();
+            return execute();
+            async function* execute() {
+                if (running) {
+                    throw new AtomsAgentError("CONFIG_ERROR", `Agent ${spec.id} does not support concurrent runs on shared state.`);
+                }
+                running = true;
+                try {
+                    yield* runLoop({
+                        runId,
+                        agentId: spec.id,
+                        model,
+                        systemPrompt: spec.systemPrompt,
+                        tools,
+                        context,
+                        contextConfig,
+                        limits,
+                        structuredOutput,
+                        authorize: authorize ?? defaultAuthorize,
+                        state,
+                        input,
+                        signal: runOptions?.signal,
+                    });
+                }
+                finally {
+                    running = false;
+                }
+            }
+        },
+        state() {
+            return structuredClone(state);
+        },
+        exportState() {
+            if (running) {
+                throw new AtomsAgentError("CONFIG_ERROR", `Agent ${spec.id} cannot export state while a run is in progress.`);
+            }
+            return exportAgentState(state);
+        },
+        restoreState(snapshot) {
+            if (running) {
+                throw new AtomsAgentError("CONFIG_ERROR", `Agent ${spec.id} cannot restore state while a run is in progress.`);
+            }
+            const restored = restoreAgentState(snapshot);
+            state.messages = restored.messages;
+        },
+    };
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,33 @@
+import type { AgentMessage, JsonValue } from "@atoms-agent/llm";
+export type PrepareContextInput = {
+    /** 完整消息历史（只读）。 */
+    history: readonly AgentMessage[];
+    systemPrompt: string;
+    /** AgentSpec Context Binding 的 JSON-safe 配置。 */
+    config?: JsonValue;
+    /** Run 级取消/超时信号。 */
+    signal: AbortSignal;
+};
+export type PreparedContext = {
+    /** 本次 Provider 请求实际使用的消息列表。 */
+    messages: AgentMessage[];
+};
+/**
+ * ContextStrategy —— 从完整历史生成本次模型调用的消息投影（PRD S4 / CFG-003）。
+ *
+ * 约束（AGENTS.md §10）：
+ * - 不修改原始历史（核心不变量 8），只返回新列表。
+ * - 不执行 Tool、不访问 Provider。
+ * - 无法满足最小上下文时抛 CONTEXT_LIMIT_ERROR，而不是静默丢弃关键消息。
+ * - v0.1 不做 LLM Summary Compaction。
+ */
+export interface ContextStrategy {
+    prepare(input: PrepareContextInput): Promise<PreparedContext>;
+}
+export type SlidingWindowOptions = {
+    /** 估算 Token 预算上限；超出时从最旧的非首条 User 消息开始丢弃。 */
+    maxTokens: number;
+};
+/** 默认 Sliding Window / Token Budget 实现（任务 C103）。 */
+export declare function slidingWindow(options: SlidingWindowOptions): ContextStrategy;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGhE,MAAM,MAAM,mBAAmB,GAAG;IAChC,kBAAkB;IAClB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oBAAoB;IACpB,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,+BAA+B;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/D;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,eAAe,CA4B5E"}

package/dist/context.js

@@ -0,0 +1,42 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+/** 默认 Sliding Window / Token Budget 实现（任务 C103）。 */
+export function slidingWindow(options) {
+    if (!Number.isInteger(options.maxTokens) || options.maxTokens <= 0) {
+        throw new AtomsAgentError("CONFIG_ERROR", "Sliding window maxTokens must be positive.");
+    }
+    return {
+        async prepare(input) {
+            const groups = groupMessages(input.history);
+            const selected = [...groups];
+            while (selected.length > 2 &&
+                estimateContextTokens(input.systemPrompt, selected.flat()) > options.maxTokens) {
+                selected.splice(1, 1);
+            }
+            const messages = selected.flat();
+            if (estimateContextTokens(input.systemPrompt, messages) > options.maxTokens) {
+                throw new AtomsAgentError("CONTEXT_LIMIT_ERROR", "The system prompt and minimum conversation context exceed maxTokens.");
+            }
+            return { messages: structuredClone(messages) };
+        },
+    };
+}
+function groupMessages(history) {
+    const groups = [];
+    for (const message of history) {
+        if (groups.length === 0 || message.role === "user") {
+            groups.push([]);
+        }
+        groups.at(-1).push(message);
+    }
+    return groups;
+}
+function estimateContextTokens(systemPrompt, messages) {
+    const encoder = new TextEncoder();
+    const systemTokens = Math.ceil(encoder.encode(systemPrompt).byteLength / 4);
+    const messageTokens = messages.reduce((total, message) => {
+        const bytes = encoder.encode(JSON.stringify(message)).byteLength;
+        return total + Math.ceil(bytes / 4) + 4;
+    }, 0);
+    return systemTokens + messageTokens;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAmCnD,oDAAoD;AACpD,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,eAAe,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAA0B;YACtC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;YAE7B,OACE,QAAQ,CAAC,MAAM,GAAG,CAAC;gBACnB,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,EAC9E,CAAC;gBACD,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,CAAC;YAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC5E,MAAM,IAAI,eAAe,CACvB,qBAAqB,EACrB,sEAAsE,CACvE,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAgC;IACrD,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,YAAoB,EAAE,QAAiC;IACpF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACvD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;QACjE,OAAO,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC,EAAE,CAAC,CAAC,CAAC;IACN,OAAO,YAAY,GAAG,aAAa,CAAC;AACtC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core 与应用层共用 llm 包定义的统一错误模型，此处仅转发，
+ * 保证两个包抛出的错误可以用同一类型捕获与判别。
+ */
+export { AtomsAgentError } from "@atoms-agent/llm";
+export type { AgentErrorCode } from "@atoms-agent/llm";
+//# 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;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,6 @@
+/**
+ * Core 与应用层共用 llm 包定义的统一错误模型，此处仅转发，
+ * 保证两个包抛出的错误可以用同一类型捕获与判别。
+ */
+export { AtomsAgentError } from "@atoms-agent/llm";
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,68 @@
+import type { AgentErrorCode, AssistantMessage, JsonValue, Usage } from "@atoms-agent/llm";
+import type { StructuredOutputResult } from "./structured-output.js";
+/**
+ * Agent Event Stream —— Core 与 Host 之间唯一的运行时通信通道（PRD §8.4）。
+ *
+ * Event 用于流式消费和观察，不是 Durable Event Store。
+ * 顺序不变量（AGENTS.md §11）：
+ * - 一个 Run 恰好一次 `agent_start` 与 `agent_end`。
+ * - `message_delta` 可以任意多条，但 `message_end` 必须包含完整消息。
+ * - Event 顺序可测试。
+ */
+export type AgentEvent = {
+    type: "agent_start";
+    runId: string;
+    agentId: string;
+} | {
+    type: "turn_start";
+    runId: string;
+    turn: number;
+} | {
+    type: "message_start";
+    runId: string;
+    turn: number;
+} | {
+    type: "message_delta";
+    runId: string;
+    turn: number;
+    delta: string;
+} | {
+    type: "message_end";
+    runId: string;
+    turn: number;
+    message: AssistantMessage;
+    usage: Usage;
+} | {
+    type: "tool_start";
+    runId: string;
+    turn: number;
+    toolCallId: string;
+    toolName: string;
+    input: JsonValue;
+} | {
+    type: "tool_end";
+    runId: string;
+    turn: number;
+    toolCallId: string;
+    toolName: string;
+    /** 截断治理后的结果文本；isError=true 时为分类错误说明。 */
+    content: string;
+    isError: boolean;
+} | {
+    type: "turn_end";
+    runId: string;
+    turn: number;
+} | {
+    type: "agent_end";
+    runId: string;
+    /** 正常完成为 "completed"；其余对应终止原因。 */
+    stopReason: "completed" | "cancelled" | "max_turns" | "timeout" | "error";
+    finalText?: string;
+    structuredOutput?: StructuredOutputResult;
+} | {
+    type: "error";
+    runId: string;
+    code: AgentErrorCode;
+    message: string;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE3F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrE;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;CACd,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,GACD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,UAAU,EAAE,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/events.js

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

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { createAgent } from "./agent.js";
+export type { Agent, CreateAgentOptions, InlineAgentOptions, SpecAgentOptions, RunOptions, } from "./agent.js";
+export { defineTool } from "./tool.js";
+export type { ToolDefinition, ToolContext, ToolSideEffect, ToolCallRequest, AuthorizeFn, AuthorizeDecision, } from "./tool.js";
+export type { AgentSpec } from "./spec.js";
+export { createRegistry } from "./registry.js";
+export type { RuntimeRegistry } from "./registry.js";
+export { slidingWindow } from "./context.js";
+export type { ContextStrategy, PrepareContextInput, PreparedContext, SlidingWindowOptions, } from "./context.js";
+export type { AgentEvent } from "./events.js";
+export type { RunLimits } from "./limits.js";
+export { AGENT_STATE_SCHEMA_VERSION, assertAgentStateSnapshot, exportState, restoreState, } from "./state.js";
+export type { AgentState, AgentStateSnapshot } from "./state.js";
+export type { StructuredOutputConfig, StructuredOutputDiagnostic, StructuredOutputResult, } from "./structured-output.js";
+export { AtomsAgentError } from "./errors.js";
+export type { AgentErrorCode } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EACV,KAAK,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,eAAe,EACf,WAAW,EACX,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACV,sBAAsB,EACtB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { createAgent } from "./agent.js";
+export { defineTool } from "./tool.js";
+export { createRegistry } from "./registry.js";
+export { slidingWindow } from "./context.js";
+export { AGENT_STATE_SCHEMA_VERSION, assertAgentStateSnapshot, exportState, restoreState, } from "./state.js";
+export { AtomsAgentError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAUvC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAS7C,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,EACxB,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/internal/abort.d.ts

@@ -0,0 +1,2 @@
+export declare function awaitWithAbort<T>(operation: () => T | PromiseLike<T>, signal: AbortSignal, message: string): Promise<T>;
+//# sourceMappingURL=abort.d.ts.map

package/dist/internal/abort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.d.ts","sourceRoot":"","sources":["../../src/internal/abort.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,CAAC,EAC9B,SAAS,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EACnC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAgCZ"}

package/dist/internal/abort.js

@@ -0,0 +1,34 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+export function awaitWithAbort(operation, signal, message) {
+    if (signal.aborted) {
+        return Promise.reject(cancellationError(message, signal));
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (callback) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            callback();
+        };
+        const onAbort = () => {
+            finish(() => reject(cancellationError(message, signal)));
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        let pending;
+        try {
+            pending = Promise.resolve(operation());
+        }
+        catch (cause) {
+            finish(() => reject(cause));
+            return;
+        }
+        pending.then((value) => finish(() => resolve(value)), (cause) => finish(() => reject(cause)));
+    });
+}
+function cancellationError(message, signal) {
+    return new AtomsAgentError("CANCELLED", message, { cause: signal.reason });
+}
+//# sourceMappingURL=abort.js.map

package/dist/internal/abort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abort.js","sourceRoot":"","sources":["../../src/internal/abort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,cAAc,CAC5B,SAAmC,EACnC,MAAmB,EACnB,OAAe;IAEf,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,QAAoB,EAAQ,EAAE;YAC5C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,IAAI,OAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QACD,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACvC,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAChD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe,EAAE,MAAmB;IAC7D,OAAO,IAAI,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7E,CAAC"}

package/dist/internal/loop.d.ts

@@ -0,0 +1,45 @@
+import type { JsonValue, ModelAdapter } from "@atoms-agent/llm";
+import type { ContextStrategy } from "../context.js";
+import type { AgentEvent } from "../events.js";
+import type { RunLimits } from "../limits.js";
+import { type AgentState } from "../state.js";
+import { type StructuredOutputRuntime } from "../structured-output.js";
+import { type AuthorizeFn, type ToolDefinition } from "../tool.js";
+export type LoopToolBinding = {
+    tool: ToolDefinition;
+    config?: JsonValue;
+};
+/**
+ * Agent Loop 内部入口（不对外导出）。
+ *
+ * 标准流程（PRD §8.3）：
+ *   prepare context -> model stream -> assistant message
+ *     -> tool calls? validate -> authorize -> execute -> truncate -> results -> next turn
+ *     -> final response
+ *
+ * 必须维护的核心不变量（PRD §11 / AGENTS.md §7）：
+ * 1. 每个 Tool Call 在下一次模型调用前恰好一个 Tool Result。
+ * 2. Invalid/Denied Tool 执行次数为 0。
+ * 3. Cancel 后不启动新的模型请求或 Tool。
+ * 4. 不超过 maxTurns / timeoutMs（timeoutMs 为 Run 级 Deadline，经 AbortSignal 取消在途操作）。
+ * 5. Tool Output 进入模型前经过大小治理。
+ * 6. 一个 Run 恰好一次 agent_start / agent_end。
+ */
+export type LoopInput = {
+    runId: string;
+    agentId: string;
+    model: ModelAdapter;
+    systemPrompt: string;
+    tools: Map<string, LoopToolBinding>;
+    context: ContextStrategy;
+    contextConfig: JsonValue | undefined;
+    limits: Required<RunLimits>;
+    structuredOutput: StructuredOutputRuntime | undefined;
+    authorize: AuthorizeFn;
+    state: AgentState;
+    input: string;
+    signal?: AbortSignal;
+};
+/** 任务 C104（Loop/Event）与 C105（取消/Limits/Retry）实现。 */
+export declare function runLoop(input: LoopInput): AsyncIterable<AgentEvent>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/internal/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/internal/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,SAAS,EACT,YAAY,EAKb,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAKL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,aAAa,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5B,gBAAgB,EAAE,uBAAuB,GAAG,SAAS,CAAC;IACtD,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,oDAAoD;AACpD,wBAAuB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAAC,UAAU,CAAC,CAgL1E"}