@migor/agentia 0.0.1

package/dist/run/run.js

@@ -0,0 +1,98 @@
+import { runAgent } from '../engine/loop.js';
+import { TraceRecorder } from '../engine/tracer.js';
+import { classifyError } from '../engine/errors.js';
+import { RunContext, withRunContext } from './context.js';
+/**
+ * Run —— 一次运行的生命周期容器（spec §2/§6.1）。
+ * runId == recorder.traceId == traceId（1:1）。
+ * recorder 由 engine 的 runAgent 写入（run 根 span 归 engine 开）。
+ */
+export class Run {
+    recorder;
+    runId;
+    idempotencyKey;
+    createdAt = Date.now();
+    _status = 'queued';
+    startedAt;
+    finishedAt;
+    _result;
+    constructor(opts = {}) {
+        this.recorder = new TraceRecorder();
+        this.runId = this.recorder.traceId;
+        this.idempotencyKey = opts.idempotencyKey;
+    }
+    get status() {
+        return this._status;
+    }
+    get result() {
+        return this._result;
+    }
+    /** meta（供运行记录/持久化使用） */
+    toMeta() {
+        return {
+            runId: this.runId,
+            status: this._status,
+            idempotencyKey: this.idempotencyKey,
+            createdAt: this.createdAt,
+            startedAt: this.startedAt,
+            finishedAt: this.finishedAt,
+            error: this._result?.error,
+        };
+    }
+    start() {
+        if (this._status !== 'queued')
+            throw new Error(`cannot start a run in status ${this._status}`);
+        this._status = 'running';
+        this.startedAt = Date.now();
+    }
+    finish(result) {
+        this._result = result;
+        this.finishedAt = Date.now();
+        this._status = result.stopReason === 'end_turn' ? 'succeeded' : 'failed';
+    }
+    fail(error) {
+        this._status = 'failed';
+        this.finishedAt = Date.now();
+        if (!this._result) {
+            // run 根可能尚未开（如 contextInit 抛错）：补一个 error 根再 snapshot，
+            // 避免 snapshot 的 "run root not started" 掩盖原始错误。
+            if (!this.recorder.rootStarted) {
+                const rootId = this.recorder.begin('run', 'agent.run', null);
+                this.recorder.end(rootId, { status: 'error', error: classifyError(error) });
+            }
+            this._result = {
+                trace: this.recorder.snapshot('error'),
+                stopReason: 'error',
+                finalText: '',
+                iterations: 0,
+            };
+        }
+        this._result.error = classifyError(error);
+    }
+}
+/**
+ * 高层入口：建 Run → start → 注入 recorder 跑 engine → finish。
+ * run 层持有 recorder，返回后 run.recorder 里的 trace 即本次完整调用树。
+ * RunContext 在整个执行期间经 AsyncLocalStorage 可被 `RunContext.current()` 读到，
+ * 工具/单元执行体无需把 ctx 作为参数层层下传。
+ */
+export async function executeRun(options) {
+    const run = new Run({ idempotencyKey: options.idempotencyKey });
+    run.start();
+    const ctx = new RunContext(run);
+    return withRunContext(ctx, async () => {
+        try {
+            options.contextInit?.(ctx);
+            const result = await runAgent({ ...options, recorder: run.recorder });
+            run.finish(result);
+            return { run, result };
+        }
+        catch (e) {
+            run.fail(e);
+            if (options.rethrow === false)
+                return { run, result: run.result };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/run/run.js.map

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

package/dist/run/scheduler.d.ts

@@ -0,0 +1,27 @@
+import type { AsyncRunner } from './async.js';
+import type { RunInvocationOptions } from './spec.js';
+export interface ScheduleEveryOptions {
+    /** 任务级调用参数 */
+    options?: RunInvocationOptions;
+    /** 幂等键前缀；周期任务按 interval 窗口分片去重 */
+    idempotencyPrefix?: string;
+    /** 覆盖触发来源标记 */
+    source?: string;
+}
+export interface ScheduleHandle {
+    id: string;
+    cancel(): void;
+}
+export declare class Scheduler {
+    private readonly runner;
+    private readonly jobs;
+    constructor(runner: AsyncRunner);
+    /** 周期触发（毫秒间隔）。首次触发在 intervalMs 之后。 */
+    every(intervalMs: number, input: unknown, opts?: ScheduleEveryOptions): ScheduleHandle;
+    /** 单次触发（指定时刻）。 */
+    at(when: Date, input: unknown, opts?: ScheduleEveryOptions): ScheduleHandle;
+    cancel(id: string): void;
+    stop(): void;
+    get active(): number;
+    private dispatch;
+}

package/dist/run/scheduler.js

@@ -0,0 +1,85 @@
+import { randomUUID } from 'node:crypto';
+export class Scheduler {
+    runner;
+    jobs = new Map();
+    constructor(runner) {
+        this.runner = runner;
+    }
+    /** 周期触发（毫秒间隔）。首次触发在 intervalMs 之后。 */
+    every(intervalMs, input, opts = {}) {
+        const id = randomUUID();
+        const timer = setInterval(() => {
+            const job = this.jobs.get(id);
+            if (job)
+                this.dispatch(job);
+        }, intervalMs);
+        if (typeof timer === 'object' && 'unref' in timer)
+            timer.unref?.();
+        this.jobs.set(id, {
+            id,
+            kind: 'every',
+            timer,
+            intervalMs,
+            input,
+            options: opts.options,
+            source: opts.source,
+            prefix: opts.idempotencyPrefix,
+        });
+        return { id, cancel: () => this.cancel(id) };
+    }
+    /** 单次触发（指定时刻）。 */
+    at(when, input, opts = {}) {
+        const id = randomUUID();
+        const delay = Math.max(0, when.getTime() - Date.now());
+        const timer = setTimeout(() => {
+            const job = this.jobs.get(id);
+            this.jobs.delete(id);
+            if (job)
+                this.dispatch(job);
+        }, delay);
+        this.jobs.set(id, {
+            id,
+            kind: 'at',
+            timer,
+            input,
+            options: opts.options,
+            source: opts.source,
+            prefix: opts.idempotencyPrefix,
+        });
+        return { id, cancel: () => this.cancel(id) };
+    }
+    cancel(id) {
+        const job = this.jobs.get(id);
+        if (!job)
+            return;
+        clearTimeout(job.timer);
+        this.jobs.delete(id);
+    }
+    stop() {
+        for (const id of [...this.jobs.keys()])
+            this.cancel(id);
+    }
+    get active() {
+        return this.jobs.size;
+    }
+    dispatch(job) {
+        // 'at' 单发：有 prefix 则用固定键（同次重复提交去重）；周期任务用窗口键
+        const idempotencyKey = job.prefix
+            ? job.kind === 'every'
+                ? `${job.prefix}:${Math.floor(Date.now() / (job.intervalMs ?? 1))}`
+                : job.prefix
+            : undefined;
+        try {
+            this.runner.submit(job.input, {
+                idempotencyKey,
+                options: job.options,
+                source: job.source ?? `schedule:${job.id.slice(0, 8)}`,
+            });
+        }
+        catch (e) {
+            // 调度触发不应崩掉宿主进程：入参非法等以 console 形式暴露
+            console.error(`[agentia:scheduler] ${job.id} 触发失败`, e?.message ?? e);
+        }
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/run/scheduler.js.map

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

package/dist/run/spec.d.ts

@@ -0,0 +1,40 @@
+import type Anthropic from '@anthropic-ai/sdk';
+import type { AgentTool } from '../core/tool.js';
+import type { ContextPolicy } from '../engine/types.js';
+/**
+ * Agentia —— run 调用契约（spec §6.3 三类触发共用同一份入参形态）。
+ * transport 层（同步 RPC / 异步任务 / 定时）只谈 RunInput / RunSpec，
+ * 与具体 agent 装配解耦 —— 换宿主（HTTP/队列/DB）不换语义（spec §6.6）。
+ */
+/** 单次 run 透传给引擎/应用的可选调用参数（与 toolkit/module 的 RunAppOptions 子集对齐） */
+export interface RunInvocationOptions {
+    model?: string;
+    maxTokens?: number;
+    maxIterations?: number;
+    client?: Anthropic;
+    onText?: (delta: string) => void;
+    /** 预置进本次 RunContext.blackboard */
+    blackboard?: Record<string, unknown>;
+    /** 上下文预算策略（compaction / context editing） */
+    contextPolicy?: ContextPolicy;
+    /** 幂等键：异步宿主的 at-least-once 去重依据 */
+    idempotencyKey?: string;
+    /** 硬失败是否抛出；缺省 true（异步宿主置 false 落 failed 记录） */
+    rethrow?: boolean;
+    tools?: AgentTool[];
+}
+/** 一次任务的规范化入参：messages（已由 normalizeMessages 规整） */
+export interface RunSpec {
+    messages: Anthropic.MessageParam[];
+    options?: RunInvocationOptions;
+    /** 触发来源标记（sync / async / schedule:<id>），供 run 记录审计 */
+    source?: string;
+}
+/** transport 层接受的原始入参形态 */
+export type RunInput = string | Anthropic.MessageParam[] | {
+    prompt?: string;
+    text?: string;
+    messages?: Anthropic.MessageParam[];
+};
+/** 把任意任务入参规范成 messages（首条缺省包成 user）。 */
+export declare function normalizeMessages(input: RunInput | unknown): Anthropic.MessageParam[];

package/dist/run/spec.js

@@ -0,0 +1,25 @@
+/** 把任意任务入参规范成 messages（首条缺省包成 user）。 */
+export function normalizeMessages(input) {
+    if (typeof input === 'string') {
+        return input ? [{ role: 'user', content: input }] : [];
+    }
+    if (Array.isArray(input)) {
+        if (input.length === 0)
+            throw new Error('任务 messages 不能为空');
+        return input;
+    }
+    if (input && typeof input === 'object') {
+        const o = input;
+        if (Array.isArray(o.messages)) {
+            if (o.messages.length === 0)
+                throw new Error('任务 messages 不能为空');
+            return o.messages;
+        }
+        if (typeof o.prompt === 'string' && o.prompt)
+            return [{ role: 'user', content: o.prompt }];
+        if (typeof o.text === 'string' && o.text)
+            return [{ role: 'user', content: o.text }];
+    }
+    throw new Error(`无法识别为任务输入: ${JSON.stringify(input)?.slice(0, 200)}`);
+}
+//# sourceMappingURL=spec.js.map

package/dist/run/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../src/run/spec.ts"],"names":[],"mappings":"AA0CA,wCAAwC;AACxC,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAC5D,OAAO,KAAiC,CAAC;IAC3C,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,KAAiE,CAAC;QAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC,QAAoC,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3F,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC"}

package/dist/run/store.d.ts

@@ -0,0 +1,40 @@
+import type { AgentRunResult } from '../engine/types.js';
+import type { SpanError } from '../core/trace.js';
+import type { RunStatus } from './types.js';
+import type { RunSpec } from './spec.js';
+/**
+ * Agentia —— run 存储（spec §6.6：异步耐久 = 换宿主不换语义）。
+ * 宿主接口：队列/DB 版只需实现 TaskStore，AsyncRunner/调度逻辑不变。
+ * v1 交付 InMemoryTaskStore；trace 随 result 一同落记录（§9.3 v1：随 run 结果返回）。
+ */
+export interface TaskRecord {
+    taskId: string;
+    status: RunStatus;
+    idempotencyKey?: string;
+    spec: RunSpec;
+    /** 执行完成后回填 runId（runId == traceId） */
+    runId?: string;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    result?: AgentRunResult;
+    error?: SpanError;
+}
+export interface TaskStore {
+    save(rec: TaskRecord): void;
+    get(taskId: string): TaskRecord | undefined;
+    /** 幂等键 → 最近一次任务（last-wins） */
+    byIdempotency(key: string): TaskRecord | undefined;
+    list(): TaskRecord[];
+    clear(): void;
+}
+export declare class InMemoryTaskStore implements TaskStore {
+    private readonly byTask;
+    private readonly byKey;
+    save(rec: TaskRecord): void;
+    get(taskId: string): TaskRecord | undefined;
+    byIdempotency(key: string): TaskRecord | undefined;
+    list(): TaskRecord[];
+    clear(): void;
+    static nextTaskId(): string;
+}

package/dist/run/store.js

@@ -0,0 +1,28 @@
+import { randomUUID } from 'node:crypto';
+export class InMemoryTaskStore {
+    byTask = new Map();
+    byKey = new Map(); // idempotencyKey → taskId
+    save(rec) {
+        this.byTask.set(rec.taskId, rec);
+        if (rec.idempotencyKey)
+            this.byKey.set(rec.idempotencyKey, rec.taskId);
+    }
+    get(taskId) {
+        return this.byTask.get(taskId);
+    }
+    byIdempotency(key) {
+        const taskId = this.byKey.get(key);
+        return taskId ? this.byTask.get(taskId) : undefined;
+    }
+    list() {
+        return [...this.byTask.values()];
+    }
+    clear() {
+        this.byTask.clear();
+        this.byKey.clear();
+    }
+    static nextTaskId() {
+        return `task_${randomUUID()}`;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/run/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/run/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmCzC,MAAM,OAAO,iBAAiB;IACX,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IACvC,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,0BAA0B;IAE9E,IAAI,CAAC,GAAe;QAClB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,GAAG,CAAC,cAAc;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzE,CAAC;IACD,GAAG,CAAC,MAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,aAAa,CAAC,GAAW;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IACD,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,UAAU;QACf,OAAO,QAAQ,UAAU,EAAE,EAAE,CAAC;IAChC,CAAC;CACF"}

package/dist/run/systemPrompt.d.ts

@@ -0,0 +1,25 @@
+import type { SystemParam } from '../engine/types.js';
+/**
+ * SystemPrompt —— 系统提示拼装 + prompt cache 布局（spec §5）。
+ *
+ * 缓存是前缀匹配：渲染序 tools → system → messages。
+ * 规则：稳定段拼接成一整块并打一个 breakpoint（连带缓存 tools），
+ * volatile 段放其后、不带标记（每次重新发送，不污染稳定前缀）。
+ * 不要在此插入 Date.now()/随机 id —— 那是隐形 invalidator。
+ */
+export interface SystemSection {
+    name: string;
+    text: string;
+    /** stable=false 的段不进可缓存前缀，放在 breakpoint 之后 */
+    stable?: boolean;
+}
+export declare class SystemPrompt {
+    private sections;
+    add(section: SystemSection): this;
+    add(name: string, text: string, stable?: boolean): this;
+    get stableText(): string;
+    /** cache=true 时给稳定前缀打 ephemeral breakpoint；否则拼成单个纯文本返回 */
+    build(opts?: {
+        cache?: boolean;
+    }): SystemParam;
+}

package/dist/run/systemPrompt.js

@@ -0,0 +1,41 @@
+export class SystemPrompt {
+    sections = [];
+    add(nameOrSection, text, stable = true) {
+        if (typeof nameOrSection === 'string') {
+            this.sections.push({ name: nameOrSection, text: text ?? '', stable });
+        }
+        else {
+            this.sections.push(nameOrSection);
+        }
+        return this;
+    }
+    get stableText() {
+        return this.sections
+            .filter((s) => s.stable !== false)
+            .map((s) => s.text)
+            .join('\n\n');
+    }
+    /** cache=true 时给稳定前缀打 ephemeral breakpoint；否则拼成单个纯文本返回 */
+    build(opts = {}) {
+        const { cache = false } = opts;
+        const stable = this.sections.filter((s) => s.stable !== false).map((s) => s.text);
+        const volatile = this.sections.filter((s) => s.stable === false).map((s) => s.text);
+        if (!cache) {
+            return [...stable, ...volatile].filter(Boolean).join('\n\n');
+        }
+        const blocks = [];
+        if (stable.length) {
+            blocks.push({
+                type: 'text',
+                text: stable.join('\n\n'),
+                cache_control: { type: 'ephemeral' },
+            });
+        }
+        for (const v of volatile) {
+            if (v)
+                blocks.push({ type: 'text', text: v });
+        }
+        return blocks;
+    }
+}
+//# sourceMappingURL=systemPrompt.js.map

package/dist/run/systemPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemPrompt.js","sourceRoot":"","sources":["../../src/run/systemPrompt.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,YAAY;IACf,QAAQ,GAAoB,EAAE,CAAC;IAIvC,GAAG,CAAC,aAAqC,EAAE,IAAa,EAAE,MAAM,GAAG,IAAI;QACrE,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;YACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;aAClB,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI,GAAwB,EAAE;QAClC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpF,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBACzB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/run/transport.d.ts

@@ -0,0 +1,12 @@
+import type { AppCallable } from './async.js';
+import type { RunInvocationOptions } from './spec.js';
+/**
+ * Agentia —— 同步 RPC 传输（spec §6.3 同步请求 / §6.6 v1 边界）。
+ * 纯适配层：把「任意任务入参 → messages」接 app.run。宿主（HTTP 路由 /
+ * AWS Lambda / RPC handler）直接调用返回的 handler，或 runSync。
+ * 同一入参形态与 AsyncRunner.submit 一致 —— 触发三类共用一份契约。
+ */
+/** 一次同步 run：规范化入参后立即执行并等待终态。 */
+export declare function runSync(app: AppCallable, input: unknown, opts?: RunInvocationOptions): ReturnType<AppCallable['run']>;
+/** 生成 (input, opts?) → run 结果的同步 handler。 */
+export declare function createSyncHandler(app: AppCallable): (input: unknown, opts?: RunInvocationOptions) => ReturnType<AppCallable['run']>;

package/dist/run/transport.js

@@ -0,0 +1,16 @@
+import { normalizeMessages } from './spec.js';
+/**
+ * Agentia —— 同步 RPC 传输（spec §6.3 同步请求 / §6.6 v1 边界）。
+ * 纯适配层：把「任意任务入参 → messages」接 app.run。宿主（HTTP 路由 /
+ * AWS Lambda / RPC handler）直接调用返回的 handler，或 runSync。
+ * 同一入参形态与 AsyncRunner.submit 一致 —— 触发三类共用一份契约。
+ */
+/** 一次同步 run：规范化入参后立即执行并等待终态。 */
+export function runSync(app, input, opts) {
+    return app.run(normalizeMessages(input), opts);
+}
+/** 生成 (input, opts?) → run 结果的同步 handler。 */
+export function createSyncHandler(app) {
+    return (input, opts) => runSync(app, input, opts);
+}
+//# sourceMappingURL=transport.js.map

package/dist/run/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/run/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;;GAKG;AAEH,gCAAgC;AAChC,MAAM,UAAU,OAAO,CACrB,GAAgB,EAChB,KAAc,EACd,IAA2B;IAE3B,OAAO,GAAG,CAAC,GAAG,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB,CAC/B,GAAgB;IAEhB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/run/types.d.ts

@@ -0,0 +1,12 @@
+import type { SpanError } from '../core/trace.js';
+/** run 生命周期状态机（spec §6.1） */
+export type RunStatus = 'queued' | 'running' | 'succeeded' | 'failed';
+export interface RunMeta {
+    runId: string;
+    status: RunStatus;
+    idempotencyKey?: string;
+    createdAt: number;
+    startedAt?: number;
+    finishedAt?: number;
+    error?: SpanError;
+}

package/dist/run/types.js

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

package/dist/run/types.js.map

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

package/dist/toolkit/asset.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agentia —— 文本资产加载（units/<name>/ 目录约定的配套 helper）。
+ *
+ * 一单元一文件夹时，长文本（prompt 模板、子 agent 的 system）放在单元目录里的
+ * .md 文件，单元代码里 `asset(import.meta.url, './system.md')` 直读：
+ *
+ * ```ts
+ * // units/reviewer/index.ts
+ * import { SubAgent, asset } from 'agentia';
+ * export default class Reviewer {
+ *   @SubAgent({ description: '…', schema: {...}, system: asset(import.meta.url, './system.md') })
+ *   reviewer(_input: { doc: string }): void {}
+ * }
+ * ```
+ *
+ * 每次调用现读、不缓存：@Prompt 的 volatile 语义（每次调用重算）要求资产新鲜；
+ * 文本文件读取开销可忽略。要在模块加载期固化，就在模块顶层调用一次存常量。
+ *
+ * @param base 调用方模块的 import.meta.url（相对它解析 rel）
+ * @param rel  相对资产路径（'./system.md'）
+ */
+export declare function asset(base: string | URL, rel: string): string;

package/dist/toolkit/asset.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'node:fs';
+/**
+ * Agentia —— 文本资产加载（units/<name>/ 目录约定的配套 helper）。
+ *
+ * 一单元一文件夹时，长文本（prompt 模板、子 agent 的 system）放在单元目录里的
+ * .md 文件，单元代码里 `asset(import.meta.url, './system.md')` 直读：
+ *
+ * ```ts
+ * // units/reviewer/index.ts
+ * import { SubAgent, asset } from 'agentia';
+ * export default class Reviewer {
+ *   @SubAgent({ description: '…', schema: {...}, system: asset(import.meta.url, './system.md') })
+ *   reviewer(_input: { doc: string }): void {}
+ * }
+ * ```
+ *
+ * 每次调用现读、不缓存：@Prompt 的 volatile 语义（每次调用重算）要求资产新鲜；
+ * 文本文件读取开销可忽略。要在模块加载期固化，就在模块顶层调用一次存常量。
+ *
+ * @param base 调用方模块的 import.meta.url（相对它解析 rel）
+ * @param rel  相对资产路径（'./system.md'）
+ */
+export function asset(base, rel) {
+    return readFileSync(new URL(rel, base), 'utf8');
+}
+//# sourceMappingURL=asset.js.map

package/dist/toolkit/asset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset.js","sourceRoot":"","sources":["../../src/toolkit/asset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,KAAK,CAAC,IAAkB,EAAE,GAAW;IACnD,OAAO,YAAY,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC"}

package/dist/toolkit/discover.d.ts

@@ -0,0 +1,2 @@
+import type { Provider } from '../container/container.js';
+export declare function discoverProviders(dir: string): Promise<Provider[]>;

package/dist/toolkit/discover.js

@@ -0,0 +1,61 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { isProvider } from '../container/container.js';
+/**
+ * Agentia —— 单元目录发现（units/<name>/ 目录约定，spec §7 静态校验仍由装配层统一做）。
+ *
+ * 约定：
+ * - 每个子目录 = 一个单元文件夹，入口为 index.ts / index.mts / index.js / index.mjs（按序取先存在者）；
+ * - 入口 default export 支持三种形态：
+ *   1. 类                → { provide: <文件夹名>, useClass: 该类 }
+ *   2. Provider 对象      → 原样使用（可用 useFactory/useValue 自定义 token）
+ *   3. Provider 数组      → 展开（一个文件夹暴露多个 provider）
+ * - DI token 缺省 = 文件夹名（kebab-case 文件夹即 kebab-case token，单元引用照写）。
+ *
+ * 与手动 providers 可混用：createApp({ providers, discover }) 合并注册，
+ * 重名/引用校验在装配期统一进行（AgentApp 构造函数）。
+ *
+ * 动态 import 决定本函数是异步的 —— createApp 带 discover 时同样返回 Promise。
+ */
+const ENTRY_CANDIDATES = ['index.ts', 'index.mts', 'index.js', 'index.mjs'];
+export async function discoverProviders(dir) {
+    const root = isAbsolute(dir) ? dir : resolve(process.cwd(), dir);
+    if (!existsSync(root)) {
+        throw new Error(`单元目录不存在: ${root}（先创建或用 CLI: agentia g <type> <name>）`);
+    }
+    const providers = [];
+    const entries = readdirSync(root, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .map((e) => e.name)
+        .sort(); // 排序保证装配顺序稳定（菜单顺序 = 目录名序，可复现）
+    for (const name of entries) {
+        const entry = ENTRY_CANDIDATES.map((f) => join(root, name, f)).find(existsSync);
+        if (!entry)
+            continue; // 无入口的目录视为非单元目录（如 assets/），跳过
+        const mod = await import(pathToFileURL(entry).href);
+        const exported = mod.default;
+        providers.push(...normalizeExport(name, exported, entry));
+    }
+    return providers;
+}
+function normalizeExport(name, exported, entry) {
+    if (typeof exported === 'function') {
+        return [{ provide: name, useClass: exported }];
+    }
+    if (isProvider(exported)) {
+        return [exported];
+    }
+    if (Array.isArray(exported) && exported.every(isProvider)) {
+        return exported;
+    }
+    throw new Error(`单元入口 ${entry} 的 default export 形态非法：应为「类 / Provider / Provider[]」，实际 ${describe(exported)}`);
+}
+function describe(x) {
+    if (x === undefined)
+        return 'undefined（缺少 default export？）';
+    if (x === null)
+        return 'null';
+    return typeof x;
+}
+//# sourceMappingURL=discover.js.map

package/dist/toolkit/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/toolkit/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,gBAAgB,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,sCAAsC,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC,CAAC,8BAA8B;IAEzC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK;YAAE,SAAS,CAAC,8BAA8B;QACpD,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAI,GAA6B,CAAC,OAAO,CAAC;QACxD,SAAS,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,QAAiB,EAAE,KAAa;IACrE,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAA4B,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,2DAA2D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAC7F,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,+BAA+B,CAAC;IAC5D,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,OAAO,OAAO,CAAC,CAAC;AAClB,CAAC"}