@atoms-agent/core 0.3.0

package/dist/structured-output.js

@@ -0,0 +1,170 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+import { Ajv } from "ajv";
+const ajv = new Ajv({ allErrors: true, strict: true, addUsedSchema: false });
+const CONFIG_KEYS = new Set(["name", "description", "schema"]);
+export function assertStructuredOutputConfig(value, path = "Structured Output") {
+    const config = requirePlainObject(value, path);
+    assertOnlyKeys(config, CONFIG_KEYS, path);
+    if (Object.hasOwn(config, "name")) {
+        if (typeof config.name !== "string" || !/^[A-Za-z0-9_-]{1,64}$/.test(config.name)) {
+            configError(`${path}.name must match [A-Za-z0-9_-]{1,64}.`);
+        }
+    }
+    if (Object.hasOwn(config, "description")) {
+        if (typeof config.description !== "string" || config.description.trim().length === 0) {
+            configError(`${path}.description must be a non-empty string.`);
+        }
+    }
+    const schema = requirePlainObject(config.schema, `${path}.schema`);
+    assertJsonSafe(schema, `${path}.schema`, new WeakSet());
+}
+export function createStructuredOutputRuntime(config) {
+    assertStructuredOutputConfig(config);
+    const request = {
+        name: config.name ?? "agent_output",
+        ...(config.description === undefined ? {} : { description: config.description }),
+        schema: structuredClone(config.schema),
+    };
+    let validator;
+    try {
+        validator = ajv.compile(request.schema);
+    }
+    catch (cause) {
+        throw new AtomsAgentError("CONFIG_ERROR", "Structured Output schema is invalid.", { cause });
+    }
+    return {
+        request,
+        promptInstruction: buildPromptInstruction(request),
+        validate(text, repairAttempted) {
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                return createStructuredOutputFailure([diagnostic("parse", "The final response is not valid JSON.")], repairAttempted);
+            }
+            if (!isJsonValue(parsed)) {
+                return createStructuredOutputFailure([diagnostic("json_safe", "The parsed response is not a JSON-safe value.")], repairAttempted);
+            }
+            if (!validator(parsed)) {
+                return createStructuredOutputFailure((validator.errors ?? []).map(toDiagnostic), repairAttempted);
+            }
+            return {
+                valid: true,
+                value: structuredClone(parsed),
+                diagnostics: [],
+                repairAttempted,
+            };
+        },
+        repairPrompt(diagnostics) {
+            const details = diagnostics
+                .map((item) => `- ${item.instancePath.length === 0 ? "/" : item.instancePath}: ${item.message} (${item.keyword})`)
+                .join("\n");
+            return [
+                "Your previous final response did not satisfy the required JSON Schema.",
+                "Correct it now. Return only the corrected JSON value, with no Markdown or explanation.",
+                "Validation diagnostics:",
+                details,
+            ].join("\n");
+        },
+    };
+}
+export function createStructuredOutputFailure(diagnostics, repairAttempted) {
+    return {
+        valid: false,
+        diagnostics: structuredClone([...diagnostics]),
+        repairAttempted,
+    };
+}
+export class StructuredOutputValidationError extends AtomsAgentError {
+    result;
+    constructor(result) {
+        super("OUTPUT_VALIDATION_ERROR", "Structured Output remained invalid after one repair attempt.");
+        this.name = "StructuredOutputValidationError";
+        this.result = structuredClone(result);
+    }
+}
+function buildPromptInstruction(request) {
+    return [
+        "Structured Output requirement:",
+        "You may call available tools before answering. When producing the final answer, return only one JSON value that matches the schema below.",
+        "Do not wrap the JSON in Markdown and do not add explanatory text.",
+        ...(request.description === undefined ? [] : [`Purpose: ${request.description}`]),
+        `Schema name: ${request.name}`,
+        JSON.stringify(request.schema),
+    ].join("\n");
+}
+function toDiagnostic(error) {
+    return {
+        instancePath: error.instancePath,
+        schemaPath: error.schemaPath,
+        keyword: error.keyword,
+        message: error.message ?? "JSON Schema validation failed.",
+    };
+}
+function diagnostic(keyword, message) {
+    return { instancePath: "", schemaPath: "", keyword, message };
+}
+function isJsonValue(value) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean" ||
+        (typeof value === "number" && Number.isFinite(value))) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.every(isJsonValue);
+    }
+    if (typeof value !== "object") {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return ((prototype === Object.prototype || prototype === null) &&
+        Object.values(value).every(isJsonValue));
+}
+function assertJsonSafe(value, path, seen) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "boolean" ||
+        (typeof value === "number" && Number.isFinite(value))) {
+        return;
+    }
+    if (typeof value !== "object") {
+        configError(`${path} must contain only JSON-safe values.`);
+    }
+    if (seen.has(value)) {
+        configError(`${path} must not contain circular references.`);
+    }
+    seen.add(value);
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => assertJsonSafe(item, `${path}[${index}]`, seen));
+    }
+    else {
+        const object = requirePlainObject(value, path);
+        for (const [key, item] of Object.entries(object)) {
+            assertJsonSafe(item, `${path}.${key}`, seen);
+        }
+    }
+    seen.delete(value);
+}
+function requirePlainObject(value, path) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        configError(`${path} must be a plain object.`);
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        configError(`${path} must be a plain object.`);
+    }
+    return value;
+}
+function assertOnlyKeys(value, allowed, path) {
+    for (const key of Reflect.ownKeys(value)) {
+        if (typeof key !== "string" || !allowed.has(key)) {
+            configError(`${path} contains unsupported field ${String(key)}.`);
+        }
+    }
+}
+function configError(message) {
+    throw new AtomsAgentError("CONFIG_ERROR", message);
+}
+//# sourceMappingURL=structured-output.js.map

package/dist/structured-output.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,75 @@
+import type { AgentErrorCode, JsonSchema, JsonValue, ToolCallBlock } from "@atoms-agent/llm";
+/**
+ * Tool 副作用声明。影响并发与（未来的）恢复语义：
+ * v0.1 中 Tool 一律串行执行，该字段主要供 authorize 策略使用。
+ */
+export type ToolSideEffect = "none" | "idempotent" | "non_idempotent";
+/** 传给 Tool Execute 的运行时上下文。 */
+export type ToolContext = {
+    toolCallId: string;
+    /** Run 级取消/超时信号，Tool 实现必须响应（AGENTS.md §12）。 */
+    signal: AbortSignal;
+    /** AgentSpec Tool Binding 的 JSON-safe 配置。 */
+    config?: JsonValue;
+};
+export type ToolDefinition<TInput extends JsonValue = JsonValue> = {
+    name: string;
+    description: string;
+    /** 可选；未指定时 Runtime 视为 "0.0.0"（AGENTS.md §9）。 */
+    version?: string;
+    inputSchema: JsonSchema;
+    sideEffect: ToolSideEffect;
+    /**
+     * 只在输入通过 JSON Schema 校验、且 authorize() 返回 allow 后被调用。
+     * 返回值会被字符串化并经过大小治理后写入 Tool Result。
+     * 失败应抛出异常，由 Runtime 转为分类 Tool Error，不要返回伪成功文本。
+     */
+    execute(input: TInput, context: ToolContext): Promise<JsonValue>;
+};
+export declare function defineTool<TInput extends JsonValue = JsonValue>(definition: ToolDefinition<TInput>): ToolDefinition<TInput>;
+/** 一次待授权的 Tool 调用。input 已通过 schema 校验。 */
+export type ToolCallRequest = {
+    toolCallId: string;
+    tool: Pick<ToolDefinition, "name" | "description" | "version" | "sideEffect">;
+    input: JsonValue;
+    config?: JsonValue;
+    signal: AbortSignal;
+};
+export type AuthorizeDecision = "allow" | "deny";
+/**
+ * 统一权限回调（PRD TOOL-003）。deny 时 Tool 不执行，
+ * Runtime 生成带 AUTHORIZATION_ERROR 的 Tool Error Result 回填模型。
+ * 未提供 authorize 时的默认策略：仅 sideEffect === "none" 允许执行。
+ */
+export type AuthorizeFn = (request: ToolCallRequest) => AuthorizeDecision | Promise<AuthorizeDecision>;
+export type ToolOutputLimits = {
+    maxCharacters?: number;
+    maxBytes?: number;
+    maxEstimatedTokens?: number;
+};
+export declare const DEFAULT_TOOL_OUTPUT_LIMITS: Required<ToolOutputLimits>;
+export type GovernedToolOutput = {
+    content: string;
+    truncated: boolean;
+};
+export type ToolResultErrorCode = Extract<AgentErrorCode, "TOOL_VALIDATION_ERROR" | "TOOL_EXECUTION_ERROR" | "AUTHORIZATION_ERROR">;
+export type ToolRuntimeResult = {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    isError: boolean;
+    truncated: boolean;
+    errorCode?: ToolResultErrorCode;
+};
+export type ExecuteToolCallOptions = {
+    signal: AbortSignal;
+    authorize?: AuthorizeFn;
+    config?: JsonValue;
+    outputLimits?: ToolOutputLimits;
+};
+/** 默认权限：无副作用 Tool 自动允许，其余拒绝。 */
+export declare const defaultAuthorize: AuthorizeFn;
+/** C102 Tool Runtime；Loop 只调用该入口，保证执行顺序与错误配对一致。 */
+export declare function executeToolCall<TInput extends JsonValue>(tool: ToolDefinition<TInput>, call: ToolCallBlock, options: ExecuteToolCallOptions): Promise<ToolRuntimeResult>;
+export declare function truncateToolOutput(content: string, configuredLimits?: ToolOutputLimits): GovernedToolOutput;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

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

package/dist/tool.js

@@ -0,0 +1,206 @@
+import { AtomsAgentError } from "@atoms-agent/llm";
+import { Ajv } from "ajv";
+import { awaitWithAbort } from "./internal/abort.js";
+/**
+ * 定义一个 Tool（任务 C102 接入校验与执行管线）。
+ *
+ * defineTool 本身只做定义收敛与冻结，不做 IO。
+ */
+const ajv = new Ajv({ allErrors: true, strict: true, addUsedSchema: false });
+const validators = new WeakMap();
+export function defineTool(definition) {
+    if (definition.name.trim().length === 0) {
+        throw new AtomsAgentError("CONFIG_ERROR", "Tool name must not be empty.");
+    }
+    if (definition.description.trim().length === 0) {
+        throw new AtomsAgentError("CONFIG_ERROR", `Tool ${definition.name} requires a description.`);
+    }
+    const normalized = {
+        ...definition,
+        inputSchema: deepFreezeJson(structuredClone(definition.inputSchema)),
+    };
+    const tool = Object.freeze(normalized);
+    validatorFor(tool);
+    return tool;
+}
+export const DEFAULT_TOOL_OUTPUT_LIMITS = Object.freeze({
+    maxCharacters: 16_000,
+    maxBytes: 64_000,
+    maxEstimatedTokens: 4_000,
+});
+/** 默认权限：无副作用 Tool 自动允许，其余拒绝。 */
+export const defaultAuthorize = ({ tool }) => tool.sideEffect === "none" ? "allow" : "deny";
+/** C102 Tool Runtime；Loop 只调用该入口，保证执行顺序与错误配对一致。 */
+export async function executeToolCall(tool, call, options) {
+    throwIfAborted(options.signal);
+    const limits = normalizeOutputLimits(options.outputLimits);
+    const validate = validatorFor(tool);
+    if (!validate(call.input)) {
+        return errorResult(tool, call, "TOOL_VALIDATION_ERROR", `Tool input is invalid: ${formatValidationErrors(validate.errors)}`, limits);
+    }
+    throwIfAborted(options.signal);
+    let decision;
+    try {
+        decision = await awaitWithAbort(() => (options.authorize ?? defaultAuthorize)({
+            toolCallId: call.toolCallId,
+            tool: {
+                name: tool.name,
+                description: tool.description,
+                version: tool.version ?? "0.0.0",
+                sideEffect: tool.sideEffect,
+            },
+            input: structuredClone(call.input),
+            ...(options.config === undefined ? {} : { config: structuredClone(options.config) }),
+            signal: options.signal,
+        }), options.signal, "Tool authorization was cancelled.");
+    }
+    catch (cause) {
+        throwIfAborted(options.signal);
+        return errorResult(tool, call, "AUTHORIZATION_ERROR", "Tool authorization failed.", limits, cause);
+    }
+    throwIfAborted(options.signal);
+    if (decision === "deny") {
+        return errorResult(tool, call, "AUTHORIZATION_ERROR", "Tool execution was denied.", limits);
+    }
+    if (decision !== "allow") {
+        return errorResult(tool, call, "AUTHORIZATION_ERROR", "Tool authorization returned an invalid decision.", limits);
+    }
+    throwIfAborted(options.signal);
+    try {
+        const output = await tool.execute(call.input, {
+            toolCallId: call.toolCallId,
+            signal: options.signal,
+            ...(options.config === undefined ? {} : { config: structuredClone(options.config) }),
+        });
+        throwIfAborted(options.signal);
+        const governed = truncateToolOutput(serializeToolOutput(output), limits);
+        return {
+            toolCallId: call.toolCallId,
+            toolName: tool.name,
+            content: governed.content,
+            isError: false,
+            truncated: governed.truncated,
+        };
+    }
+    catch (cause) {
+        throwIfAborted(options.signal);
+        return errorResult(tool, call, "TOOL_EXECUTION_ERROR", "Tool execution failed.", limits, cause);
+    }
+}
+const TRUNCATION_NOTICE = "\n...[tool output truncated]";
+const textEncoder = new TextEncoder();
+export function truncateToolOutput(content, configuredLimits) {
+    const limits = normalizeOutputLimits(configuredLimits);
+    if (fitsOutputLimits(content, limits)) {
+        return { content, truncated: false };
+    }
+    const characters = Array.from(content);
+    let low = 0;
+    let high = characters.length;
+    while (low < high) {
+        const middle = Math.ceil((low + high) / 2);
+        if (fitsOutputLimits(characters.slice(0, middle).join("") + TRUNCATION_NOTICE, limits)) {
+            low = middle;
+        }
+        else {
+            high = middle - 1;
+        }
+    }
+    const candidate = characters.slice(0, low).join("") + TRUNCATION_NOTICE;
+    if (fitsOutputLimits(candidate, limits)) {
+        return { content: candidate, truncated: true };
+    }
+    const noticeCharacters = Array.from(TRUNCATION_NOTICE);
+    while (noticeCharacters.length > 0) {
+        const notice = noticeCharacters.join("");
+        if (fitsOutputLimits(notice, limits)) {
+            return { content: notice, truncated: true };
+        }
+        noticeCharacters.pop();
+    }
+    return { content: "", truncated: true };
+}
+function validatorFor(tool) {
+    const existing = validators.get(tool);
+    if (existing !== undefined) {
+        return existing;
+    }
+    try {
+        const validator = ajv.compile(tool.inputSchema);
+        validators.set(tool, validator);
+        return validator;
+    }
+    catch (cause) {
+        throw new AtomsAgentError("CONFIG_ERROR", `Tool ${tool.name} has an invalid input schema.`, {
+            cause,
+        });
+    }
+}
+function errorResult(tool, call, errorCode, message, limits, cause) {
+    const error = new AtomsAgentError(errorCode, message, { cause });
+    const governed = truncateToolOutput(`[${error.code}] ${error.message}`, limits);
+    return {
+        toolCallId: call.toolCallId,
+        toolName: tool.name,
+        content: governed.content,
+        isError: true,
+        truncated: governed.truncated,
+        errorCode,
+    };
+}
+function normalizeOutputLimits(configuredLimits) {
+    const limits = {
+        ...DEFAULT_TOOL_OUTPUT_LIMITS,
+        ...configuredLimits,
+    };
+    for (const [name, value] of Object.entries(limits)) {
+        if (!Number.isInteger(value) || value <= 0) {
+            throw new AtomsAgentError("CONFIG_ERROR", `${name} must be a positive integer.`);
+        }
+    }
+    return limits;
+}
+function fitsOutputLimits(content, limits) {
+    const characters = Array.from(content).length;
+    const bytes = textEncoder.encode(content).byteLength;
+    const estimatedTokens = Math.ceil(bytes / 4);
+    return (characters <= limits.maxCharacters &&
+        bytes <= limits.maxBytes &&
+        estimatedTokens <= limits.maxEstimatedTokens);
+}
+function serializeToolOutput(output) {
+    if (typeof output === "string") {
+        return output;
+    }
+    const serialized = JSON.stringify(output);
+    if (serialized === undefined) {
+        throw new TypeError("Tool output is not JSON serializable.");
+    }
+    return serialized;
+}
+function formatValidationErrors(errors) {
+    if (errors === null || errors === undefined || errors.length === 0) {
+        return "schema validation failed";
+    }
+    return errors
+        .map((error) => `${error.instancePath || "/"} ${error.message ?? error.keyword}`)
+        .join("; ");
+}
+function throwIfAborted(signal) {
+    if (signal.aborted) {
+        throw new AtomsAgentError("CANCELLED", "Tool execution was cancelled.", {
+            cause: signal.reason,
+        });
+    }
+}
+function deepFreezeJson(value) {
+    if (value !== null && typeof value === "object") {
+        const children = Array.isArray(value) ? value : Object.values(value);
+        for (const child of children) {
+            deepFreezeJson(child);
+        }
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@atoms-agent/core",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "Agent loop, tool runtime, event stream, context strategy, limits and cancellation",
+  "license": "MIT",
+  "author": "atoms_agent contributors",
+  "homepage": "https://github.com/Fufu-0101/atoms_agent#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fufu-0101/atoms_agent.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Fufu-0101/atoms_agent/issues"
+  },
+  "keywords": [
+    "agent",
+    "agent-loop",
+    "tools",
+    "llm",
+    "typescript",
+    "sdk"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.13"
+  },
+  "dependencies": {
+    "@atoms-agent/llm": "0.3.0",
+    "ajv": "^8.17.1"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsc -b"
+  }
+}