@qjp88995/agent-runtime 0.0.0-stage → 0.1.0

package/dist/in-process/stream-bus.js

@@ -0,0 +1,200 @@
+import { EventEmitter } from 'node:events';
+import { createSeqCounter } from '../schema/agent-event.js';
+/**
+ * 进程内事件总线。搬自 agent-base `InProcessStreamBus`，改动：
+ * 去掉 Nest；会话面也按 TTL 清理（agent-base 生产走 Redis，进程内的会话面只在单测里用，
+ * 从没清过——在这里它是默认实现，不清就无界增长）；加 `dispose()` 停定时器。
+ *
+ * **只在单进程内成立。**
+ */
+export class InProcessStreamBus {
+    streams = new Map();
+    sessions = new Map();
+    bufferTtlMs;
+    sessionTtlMs;
+    now;
+    timer;
+    constructor(options = {}) {
+        this.bufferTtlMs = options.bufferTtlMs ?? 5 * 60_000;
+        this.sessionTtlMs = options.sessionTtlMs ?? 60 * 60_000;
+        this.now = options.now ?? Date.now;
+        const interval = options.sweepIntervalMs ?? 60_000;
+        this.timer =
+            interval > 0 ? setInterval(() => this.sweep(), interval) : null;
+        this.timer?.unref();
+    }
+    open(streamId) {
+        if (this.streams.has(streamId)) {
+            throw new Error(`stream '${streamId}' already open`);
+        }
+        const emitter = new EventEmitter();
+        emitter.setMaxListeners(0);
+        this.streams.set(streamId, {
+            buffer: [],
+            emitter,
+            controller: new AbortController(),
+            active: true,
+        });
+        return { nextSeq: createSeqCounter() };
+    }
+    publish(event) {
+        if (this.publishToStream(event))
+            this.publishToSession(event);
+    }
+    publishSessionEvent(event) {
+        this.publishToSession(event);
+    }
+    /**
+     * 只喂 per-stream 面。流已 close 或不存在时不接收（不入 buffer、不 emit）。返回是否投递了。
+     * 给子类用：Redis 适配保留进程内的 per-stream 面（pump 与取消信号都在跑这一轮的进程里），
+     * 只把会话面换成跨实例的实现。
+     */
+    publishToStream(event) {
+        const state = this.streams.get(event.streamId);
+        if (!state || !state.active)
+            return false;
+        state.buffer.push(event);
+        state.emitter.emit('event', event);
+        return true;
+    }
+    publishToSession(event) {
+        let s = this.sessions.get(event.rootSessionId);
+        if (!s) {
+            const emitter = new EventEmitter();
+            emitter.setMaxListeners(0);
+            s = { buffer: [], emitter, seq: 0, touchedAt: this.now() };
+            this.sessions.set(event.rootSessionId, s);
+        }
+        s.touchedAt = this.now();
+        const entry = { id: String(++s.seq), event };
+        s.buffer.push(entry);
+        s.emitter.emit('entry', entry);
+    }
+    subscribe(streamId, fromSeq = 1, signal) {
+        const state = this.streams.get(streamId);
+        if (!state)
+            return (async function* () { })();
+        const queue = state.buffer.filter(e => e.seq >= fromSeq);
+        let notify = null;
+        let ended = !state.active;
+        let aborted = signal?.aborted ?? false;
+        const onEvent = (e) => {
+            queue.push(e);
+            notify?.();
+        };
+        const onClose = () => {
+            ended = true;
+            notify?.();
+        };
+        const onAbort = () => {
+            aborted = true;
+            notify?.();
+        };
+        state.emitter.on('event', onEvent);
+        state.emitter.on('close', onClose);
+        signal?.addEventListener('abort', onAbort);
+        return {
+            async *[Symbol.asyncIterator]() {
+                try {
+                    for (;;) {
+                        // abort 只阻止「等待」，不阻止排空已入队的事件。
+                        while (queue.length > 0)
+                            yield queue.shift();
+                        if (ended || aborted || signal?.aborted)
+                            return;
+                        await new Promise(resolve => {
+                            notify = resolve;
+                        });
+                        notify = null;
+                    }
+                }
+                finally {
+                    state.emitter.off('event', onEvent);
+                    state.emitter.off('close', onClose);
+                    signal?.removeEventListener('abort', onAbort);
+                }
+            },
+        };
+    }
+    async *subscribeSession(rootSessionId, fromId, signal) {
+        // 还没有任何事件时也要能订阅：先建出会话面，之后的事件才收得到。
+        let s = this.sessions.get(rootSessionId);
+        if (!s) {
+            const emitter = new EventEmitter();
+            emitter.setMaxListeners(0);
+            s = { buffer: [], emitter, seq: 0, touchedAt: this.now() };
+            this.sessions.set(rootSessionId, s);
+        }
+        const session = s;
+        const from = fromId ? Number(fromId) : 0;
+        const queue = session.buffer.filter(e => Number(e.id) > from);
+        let notify = null;
+        let aborted = signal.aborted;
+        const onEntry = (e) => {
+            queue.push(e);
+            notify?.();
+        };
+        const onAbort = () => {
+            aborted = true;
+            notify?.();
+        };
+        session.emitter.on('entry', onEntry);
+        signal.addEventListener('abort', onAbort);
+        try {
+            for (;;) {
+                while (queue.length > 0)
+                    yield queue.shift();
+                if (aborted || signal.aborted)
+                    return;
+                await new Promise(resolve => {
+                    notify = resolve;
+                });
+                notify = null;
+            }
+        }
+        finally {
+            session.emitter.off('entry', onEntry);
+            signal.removeEventListener('abort', onAbort);
+        }
+    }
+    /** 进程内没有「重放量」这回事：buffer 随 TTL 整体过期，退役是 no-op。 */
+    retireUpTo(_runId, _uptoSeq) { }
+    close(streamId) {
+        const state = this.streams.get(streamId);
+        if (!state || !state.active)
+            return;
+        state.active = false;
+        state.closedAt = this.now();
+        state.emitter.emit('close');
+    }
+    abort(streamId) {
+        this.streams.get(streamId)?.controller.abort();
+    }
+    isActive(streamId) {
+        return this.streams.get(streamId)?.active ?? false;
+    }
+    signalOf(streamId) {
+        return this.streams.get(streamId)?.controller.signal;
+    }
+    /** 清掉过期的流与没人订阅的过期会话面。定时器会调它；单测可以手动调。 */
+    sweep() {
+        const now = this.now();
+        for (const [id, state] of this.streams) {
+            if (!state.active && now - (state.closedAt ?? 0) > this.bufferTtlMs) {
+                this.streams.delete(id);
+            }
+        }
+        for (const [id, s] of this.sessions) {
+            if (now - s.touchedAt > this.sessionTtlMs &&
+                s.emitter.listenerCount('entry') === 0) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+    /** 停掉清理定时器。 */
+    dispose() {
+        if (this.timer)
+            clearInterval(this.timer);
+    }
+}
+//# sourceMappingURL=stream-bus.js.map

package/dist/in-process/stream-bus.js.map

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

package/dist/in-process/vendor-file-cache.d.ts

@@ -0,0 +1,11 @@
+import type { VendorFileCache, VendorFileKey, VendorFileRecord } from '../ports/vendor-file-cache.js';
+/** `VendorFileCache` 的进程内实现：一张 Map。进程重启后要重传（厂商侧旧副本到期自清）。 */
+export declare class InMemoryVendorFileCache implements VendorFileCache {
+    private readonly rows;
+    find(vendor: string, contentHashes: readonly string[]): Promise<VendorFileRecord[]>;
+    put(record: VendorFileRecord): Promise<void>;
+    touch(key: VendorFileKey, at: Date): Promise<void>;
+    forget(vendor: string, account: string, fileIds: readonly string[]): Promise<void>;
+    sweepExpired(now: Date): Promise<number>;
+}
+//# sourceMappingURL=vendor-file-cache.d.ts.map

package/dist/in-process/vendor-file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-file-cache.d.ts","sourceRoot":"","sources":["../../src/in-process/vendor-file-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAKvC,4DAA4D;AAC5D,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuC;IAE5D,IAAI,CACF,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAW9B,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,KAAK,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAMlD,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC;IAchB,YAAY,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;CAUzC"}

package/dist/in-process/vendor-file-cache.js

@@ -0,0 +1,47 @@
+const keyOf = (k) => `${k.vendor}\u0000${k.account}\u0000${k.contentHash}`;
+/** `VendorFileCache` 的进程内实现：一张 Map。进程重启后要重传（厂商侧旧副本到期自清）。 */
+export class InMemoryVendorFileCache {
+    rows = new Map();
+    find(vendor, contentHashes) {
+        const wanted = new Set(contentHashes);
+        const out = [];
+        for (const row of this.rows.values()) {
+            if (row.vendor === vendor && wanted.has(row.contentHash)) {
+                out.push({ ...row });
+            }
+        }
+        return Promise.resolve(out);
+    }
+    put(record) {
+        this.rows.set(keyOf(record), { ...record });
+        return Promise.resolve();
+    }
+    touch(key, at) {
+        const row = this.rows.get(keyOf(key));
+        if (row)
+            row.lastUsedAt = at;
+        return Promise.resolve();
+    }
+    forget(vendor, account, fileIds) {
+        const ids = new Set(fileIds);
+        for (const [k, row] of this.rows) {
+            if (row.vendor === vendor &&
+                row.account === account &&
+                ids.has(row.fileId)) {
+                this.rows.delete(k);
+            }
+        }
+        return Promise.resolve();
+    }
+    sweepExpired(now) {
+        let n = 0;
+        for (const [k, row] of this.rows) {
+            if (row.expiresAt && row.expiresAt.getTime() < now.getTime()) {
+                this.rows.delete(k);
+                n++;
+            }
+        }
+        return Promise.resolve(n);
+    }
+}
+//# sourceMappingURL=vendor-file-cache.js.map

package/dist/in-process/vendor-file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendor-file-cache.js","sourceRoot":"","sources":["../../src/in-process/vendor-file-cache.ts"],"names":[],"mappings":"AAMA,MAAM,KAAK,GAAG,CAAC,CAAgB,EAAE,EAAE,CACjC,GAAG,CAAC,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;AAExD,4DAA4D;AAC5D,MAAM,OAAO,uBAAuB;IACjB,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAE5D,IAAI,CACF,MAAc,EACd,aAAgC;QAEhC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;QACtC,MAAM,GAAG,GAAuB,EAAE,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,MAAwB;QAC1B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,GAAkB,EAAE,EAAQ;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,GAAG;YAAE,GAAG,CAAC,UAAU,GAAG,EAAE,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,CACJ,MAAc,EACd,OAAe,EACf,OAA0B;QAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IACE,GAAG,CAAC,MAAM,KAAK,MAAM;gBACrB,GAAG,CAAC,OAAO,KAAK,OAAO;gBACvB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EACnB,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,YAAY,CAAC,GAAS;QACpB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC7D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpB,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @qjp88995/agent-runtime：agent 运行时。
+ *
+ * 不依赖 Redis、数据库或任何框架：外部件一律经端口（`ports/`），每个端口都有进程内实现
+ * （`in-process/`），零配置单进程能跑；多实例换适配包。宿主的 agent 字段经
+ * `AgentExtensions`（module augmentation）带进工具与钩子。
+ */
+export { type AgentExtensions, type Initiator, NO_INITIATOR, } from './agent-extensions.js';
+export * from './builtins/index.js';
+export * from './context/index.js';
+export { registerRepeatCallHook, REPEAT_CALL_HOOK_META, RepeatCallHook, } from './extensions/repeat-call.hook.js';
+export * from './hooks/index.js';
+export * from './images/index.js';
+export * from './in-process/index.js';
+export * from './loop/index.js';
+export * from './ports/index.js';
+export * from './schema/index.js';
+export * from './subagent/index.js';
+export * from './tools/index.js';
+export * from './turn/index.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;;;;;;GAMG;AACH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,GACf,MAAM,kCAAkC,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+/**
+ * @qjp88995/agent-runtime：agent 运行时。
+ *
+ * 不依赖 Redis、数据库或任何框架：外部件一律经端口（`ports/`），每个端口都有进程内实现
+ * （`in-process/`），零配置单进程能跑；多实例换适配包。宿主的 agent 字段经
+ * `AgentExtensions`（module augmentation）带进工具与钩子。
+ */
+export { NO_INITIATOR, } from './agent-extensions.js';
+export * from './builtins/index.js';
+export * from './context/index.js';
+export { registerRepeatCallHook, REPEAT_CALL_HOOK_META, RepeatCallHook, } from './extensions/repeat-call.hook.js';
+export * from './hooks/index.js';
+export * from './images/index.js';
+export * from './in-process/index.js';
+export * from './loop/index.js';
+export * from './ports/index.js';
+export * from './schema/index.js';
+export * from './subagent/index.js';
+export * from './tools/index.js';
+export * from './turn/index.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;;;;;;GAMG;AACH,OAAO,EAGL,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,GACf,MAAM,kCAAkC,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/loop/active-tick.registry.d.ts

@@ -0,0 +1,31 @@
+import type { StreamBus } from '../ports/stream-bus.js';
+/**
+ * 「本进程此刻有哪些 tick 在跑」的登记簿：sessionId → 该 tick 的 streamId。
+ *
+ * **进程内的**（跟 stream 本身一样）——写方是 `LoopDriver` 的 tick，读方是
+ * `LoopDriver.stopSession`（会话级中断要解析出目标 stream）与停机收尾。跨实例
+ * 仍是 best-effort：tick 可能跑在任何实例上，这里查不到不代表没在跑
+ * （`OrphanRunSweeper` 兜的正是这一类）。
+ */
+export declare class ActiveTickRegistry {
+    private readonly bus;
+    private readonly bySession;
+    constructor(bus: StreamBus);
+    /** tick 开跑：登记它的 stream。 */
+    open(sessionId: string, streamId: string): void;
+    /**
+     * tick 收尾：**只在登记的仍是自己那条 stream 时**才摘（同一会话的下一个 tick
+     * 可能已经登记进来，摘掉别人的会让「停止」按钮对着空气按）。
+     */
+    close(sessionId: string, streamId: string): void;
+    /**
+     * 该会话此刻的活跃 stream，没有则 null。**登记在册还不够**——总线上那条流
+     * 可能已经关了（tick 正走 finally），故再问一次 `isActive`。
+     */
+    streamOf(sessionId: string): string | null;
+    /** 停机收尾用：本进程登记在册的全部 stream（不过滤，见 `streamOf`）。 */
+    streamIds(): string[];
+    /** 停机收尾的等待判据：还有几个 tick 没摘牌。 */
+    get size(): number;
+}
+//# sourceMappingURL=active-tick.registry.d.ts.map

package/dist/loop/active-tick.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-tick.registry.d.ts","sourceRoot":"","sources":["../../src/loop/active-tick.registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAFhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;gBAE1B,GAAG,EAAE,SAAS;IAE3C,2BAA2B;IAC3B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI/C;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMhD;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK1C,iDAAiD;IACjD,SAAS,IAAI,MAAM,EAAE;IAIrB,+BAA+B;IAC/B,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/loop/active-tick.registry.js

@@ -0,0 +1,45 @@
+/**
+ * 「本进程此刻有哪些 tick 在跑」的登记簿：sessionId → 该 tick 的 streamId。
+ *
+ * **进程内的**（跟 stream 本身一样）——写方是 `LoopDriver` 的 tick，读方是
+ * `LoopDriver.stopSession`（会话级中断要解析出目标 stream）与停机收尾。跨实例
+ * 仍是 best-effort：tick 可能跑在任何实例上，这里查不到不代表没在跑
+ * （`OrphanRunSweeper` 兜的正是这一类）。
+ */
+export class ActiveTickRegistry {
+    bus;
+    bySession = new Map();
+    constructor(bus) {
+        this.bus = bus;
+    }
+    /** tick 开跑：登记它的 stream。 */
+    open(sessionId, streamId) {
+        this.bySession.set(sessionId, streamId);
+    }
+    /**
+     * tick 收尾：**只在登记的仍是自己那条 stream 时**才摘（同一会话的下一个 tick
+     * 可能已经登记进来，摘掉别人的会让「停止」按钮对着空气按）。
+     */
+    close(sessionId, streamId) {
+        if (this.bySession.get(sessionId) === streamId) {
+            this.bySession.delete(sessionId);
+        }
+    }
+    /**
+     * 该会话此刻的活跃 stream，没有则 null。**登记在册还不够**——总线上那条流
+     * 可能已经关了（tick 正走 finally），故再问一次 `isActive`。
+     */
+    streamOf(sessionId) {
+        const id = this.bySession.get(sessionId);
+        return id && this.bus.isActive(id) ? id : null;
+    }
+    /** 停机收尾用：本进程登记在册的全部 stream（不过滤，见 `streamOf`）。 */
+    streamIds() {
+        return [...this.bySession.values()];
+    }
+    /** 停机收尾的等待判据：还有几个 tick 没摘牌。 */
+    get size() {
+        return this.bySession.size;
+    }
+}
+//# sourceMappingURL=active-tick.registry.js.map

package/dist/loop/active-tick.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-tick.registry.js","sourceRoot":"","sources":["../../src/loop/active-tick.registry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IAGA;IAFZ,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvD,YAA6B,GAAc;QAAd,QAAG,GAAH,GAAG,CAAW;IAAG,CAAC;IAE/C,2BAA2B;IAC3B,IAAI,CAAC,SAAiB,EAAE,QAAgB;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,SAAiB,EAAE,QAAgB;QACvC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAiB;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACjD,CAAC;IAED,iDAAiD;IACjD,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,+BAA+B;IAC/B,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/loop/index.d.ts

@@ -0,0 +1,6 @@
+export { ActiveTickRegistry } from './active-tick.registry.js';
+export { LOCK_RENEW_INTERVAL_MS, LoopDriver, type LoopDriverDeps, type LoopHost, SHUTDOWN_DRAIN_MS, type TickRunArgs, type TickTurn, } from './loop-driver.js';
+export { INTERRUPTED_PLACEHOLDER, MessageHub, type PostInput, TurnRecorder, type TurnTerminal, } from './message-hub.js';
+export { INTERRUPTED_ERROR, ORPHAN_MIN_AGE_MS, OrphanRunSweeper, type OrphanRunSweeperDeps, SWEEP_INTERVAL_MS, } from './orphan-run.sweeper.js';
+export { createRootTurnHost, type RootTurnHostOptions } from './root-host.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,UAAU,EACV,KAAK,SAAS,EACd,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/loop/index.js

@@ -0,0 +1,6 @@
+export { ActiveTickRegistry } from './active-tick.registry.js';
+export { LOCK_RENEW_INTERVAL_MS, LoopDriver, SHUTDOWN_DRAIN_MS, } from './loop-driver.js';
+export { INTERRUPTED_PLACEHOLDER, MessageHub, TurnRecorder, } from './message-hub.js';
+export { INTERRUPTED_ERROR, ORPHAN_MIN_AGE_MS, OrphanRunSweeper, SWEEP_INTERVAL_MS, } from './orphan-run.sweeper.js';
+export { createRootTurnHost } from './root-host.js';
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EACL,sBAAsB,EACtB,UAAU,EAGV,iBAAiB,GAGlB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,UAAU,EAEV,YAAY,GAEb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAEhB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAA4B,MAAM,gBAAgB,CAAC"}

package/dist/loop/loop-driver.d.ts

@@ -0,0 +1,127 @@
+import type { SessionLock, WakeChannel } from '../ports/coordination.js';
+import { type Logger } from '../ports/logger.js';
+import type { StreamBus } from '../ports/stream-bus.js';
+import type { AgentRuntime } from '../turn/agent-runtime.js';
+import type { RunTurnArgs } from '../turn/turn-run.js';
+import { ActiveTickRegistry } from './active-tick.registry.js';
+import type { MessageHub, PostInput, TurnRecorder } from './message-hub.js';
+/** 锁 TTL 60s（`LOCK_TTL_MS`），20s 续租留足冗余。 */
+export declare const LOCK_RENEW_INTERVAL_MS = 20000;
+/**
+ * 停机时留给在跑的 tick 自行收尾的预算。`docker stop` 默认 SIGTERM 之后 10s
+ * 才 SIGKILL，取 7s 留出余量给宿主其余的关闭钩子。
+ *
+ * 超时**不是**故障：`OrphanRunSweeper` 仍然兜底，只是用户要多等一会儿。故这里
+ * 宁可早点放手，也不能赌满 10s——被 SIGKILL 打断的话，连锁的主动释放都没做成。
+ */
+export declare const SHUTDOWN_DRAIN_MS = 7000;
+/** 一轮开张时 driver 交给宿主的东西。 */
+export interface TickTurn {
+    sessionId: string;
+    /** = streamId = 本轮 assistant 行主键（`MessageHub.openTurn` 铸的）。 */
+    runId: string;
+    streamId: string;
+    /** 本轮的落库口，交给 `createRootTurnHost`（或宿主自己的 `TurnHost`）。 */
+    recorder: TurnRecorder;
+}
+/** 宿主为一轮要组装的 `runTurn` 入参——除了 driver 自己递的那三样。 */
+export type TickRunArgs = Omit<RunTurnArgs, 'nextSeq' | 'sink' | 'abortSignal'>;
+/**
+ * loop 向宿主要的东西：一轮跑什么。会话 / agent / 模型怎么解析、system prompt 拼
+ * 什么、工具摘哪些——全是宿主的事（agent-base 里是形式层 + `prepareTurn`）。
+ *
+ * 拆成两段是因为**两段失败的处置不同**：
+ * - `setupTick` 在流打开之前（取会话行、解析 agent 与模型）。抛错 = 这一轮压根
+ *   跑不起来，driver 落一条可见的 setup-error 占位（不补的话消息已进 inbox、界面
+ *   上却什么都不会发生），再把错误抛给 `onWake` 的调用方。
+ * - `buildTurn` 在流打开之后、拿着本轮的 recorder 组装 `runTurn` 的入参（宿主
+ *   通常在这里 `createRootTurnHost`）。抛错 = 这一 tick 崩了，流照常关闭。
+ */
+export interface LoopHost<TSetup> {
+    setupTick(sessionId: string): Promise<TSetup>;
+    buildTurn(setup: TSetup, turn: TickTurn): Promise<TickRunArgs>;
+    /**
+     * setup 失败时那条占位的正文。缺省 `本轮无法启动：<message>`。宿主可在这里
+     * 净化报错（如去掉第三方服务名）、补一句排查提示。
+     */
+    describeSetupError?(error: unknown): string;
+    /**
+     * tick 收尾（锁已释放）之后、re-wake 之前调，对每个会话无条件调。子 Agent 的
+     * 里程碑回投（`finalizeIfIdle`）挂在这里。
+     *
+     * **必须排在 re-wake 之前**：finalizer 判「子空闲了没」的唯一依据就是 inbox
+     * 空不空，而 re-wake 广播出去之后，某个实例随时会抢到刚释放的锁、起一个新 tick
+     * 把消息 drain 走——那时 finalizer 会把一个正在跑的子判成空闲。放在前面则不存在
+     * 这个窗口：此刻锁虽已释放，但还没有任何人被叫醒。
+     */
+    afterTick?(sessionId: string): Promise<void>;
+}
+export interface LoopDriverDeps<TSetup> {
+    lock: SessionLock;
+    wake: WakeChannel;
+    bus: StreamBus;
+    hub: MessageHub;
+    runtime: AgentRuntime;
+    host: LoopHost<TSetup>;
+    logger?: Logger;
+    /** 缺省 `LOCK_RENEW_INTERVAL_MS`；单测可调小。 */
+    renewIntervalMs?: number;
+}
+/**
+ * inbox 驱动的 agent loop 调度器。`wake` 经 `WakeChannel` 广播（多实例时跨实例）；
+ * 每个实例的订阅者收到即 `onWake` —— 试抢会话锁，只有抢到的那个实例跑一个 tick
+ * （一次 `runTurn` 自驱 loop，drain-first）。tick 收尾释放锁后再查一次 inbox：
+ * 若期间又有新消息进来（插话 / 子 Agent 回投），重新 wake，闭合「刚 drain 完又来
+ * 一条、锁还没放」的丢唤醒窗口。
+ *
+ * 流的生命周期（open / close）完全落在 tick 内，与任何 HTTP 连接解耦。
+ */
+export declare class LoopDriver<TSetup = unknown> {
+    private readonly deps;
+    readonly active: ActiveTickRegistry;
+    private readonly logger;
+    private unsubscribe?;
+    constructor(deps: LoopDriverDeps<TSetup>);
+    /** 订阅唤醒。返回退订函数（`shutdown` 也会退订）。 */
+    start(): () => void;
+    private stopListening;
+    /**
+     * 投递一条消息并唤醒（**post-first**：先写 inbox 再 wake）。宿主的准入检查
+     * （会话能不能发言等）在调它之前自己做。
+     */
+    post(input: PostInput): Promise<{
+        messageId: string;
+    }>;
+    /** 该会话此刻在本进程跑着的流，没有则 null。 */
+    activeStreamOf(sessionId: string): string | null;
+    /**
+     * 会话级中断：解析该会话当前活跃 tick 的流 → abort。跨实例 best-effort（tick 跑在
+     * 别的实例上时这里查不到）。返回是否真的中断了一条流。宿主挂着的同步等待（提问
+     * 面板等）自己作废。
+     */
+    stopSession(sessionId: string): boolean;
+    /**
+     * 停机前把本进程正在跑的 tick 全部 abort 掉，并**等它们收完尾**。
+     *
+     * 不做的话，那些轮次的终态就随进程一起没了：跑次停在 running、消息没盖终态。
+     * sweeper 能修，但代价是至少一个锁 TTL（进程被杀时锁不会主动释放）。主动重启
+     * 占了重启的绝大多数，这条路让它们几乎瞬时收尾，sweeper 退回去只兜底真正的崩溃。
+     *
+     * **走的是内核既有的 abort 路径**：`bus.abort` → `runTurn` 照常以 aborted 收尾 →
+     * `host.persist` 盖终态、发 `run-finish`，等价于用户点了停止。
+     *
+     * **必须等**：abort 只是置了标记，立刻返回就等于没做。等到登记簿清空为准，超时
+     * 则放手交给 sweeper。返回是否在预算内清空。
+     */
+    shutdown(budgetMs?: number): Promise<boolean>;
+    onWake(sessionId: string): Promise<void>;
+    private runTick;
+    /**
+     * setup 阶段：任一步都可能抛（agent 已停用、模型已删除……）。流此时还没开，唯一
+     * 能让用户看到「发生了什么」的办法是补一条可见占位。落占位失败只记日志（不能
+     * 反过来吞掉 / 替换原始 setup 错误），随后原样重新抛出，交由 `onWake` 的 finally
+     * 照常 release 锁。
+     */
+    private resolveSetup;
+}
+//# sourceMappingURL=loop-driver.d.ts.map

package/dist/loop/loop-driver.d.ts.map

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