@eggjs/agent-runtime 0.0.0 → 3.73.0-beta.0

package/dist/src/OSSObjectStorageClient.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OSSObjectStorageClient = void 0;
+function isOSSError(err, code) {
+    return err != null && typeof err === 'object' && 'code' in err && err.code === code;
+}
+/**
+ * ObjectStorageClient backed by Alibaba Cloud OSS (via oss-client).
+ *
+ * Supports both `put`/`get` for normal objects and `append` for
+ * OSS Appendable Objects. The append path uses a local position cache
+ * to avoid extra HEAD requests; on position mismatch it falls back to
+ * HEAD + retry automatically.
+ *
+ * The OSSObject instance should be constructed and injected by the caller,
+ * following the IoC/DI principle.
+ */
+class OSSObjectStorageClient {
+    constructor(client) {
+        /**
+         * In-memory cache of next-append positions.
+         *
+         * After each successful `append()`, OSS returns `nextAppendPosition`.
+         * We cache it here so the next append can skip a HEAD round-trip.
+         * If the cached position is stale (e.g., process restarted or another
+         * writer appended), the append will fail with PositionNotEqualToLength
+         * and we fall back to HEAD + retry.
+         */
+        this.appendPositions = new Map();
+        this.client = client;
+    }
+    async put(key, value) {
+        await this.client.put(key, Buffer.from(value, 'utf-8'));
+    }
+    async get(key) {
+        try {
+            const result = await this.client.get(key);
+            if (result.content) {
+                return Buffer.isBuffer(result.content) ? result.content.toString('utf-8') : String(result.content);
+            }
+            return null;
+        }
+        catch (err) {
+            if (isOSSError(err, 'NoSuchKey')) {
+                return null;
+            }
+            throw err;
+        }
+    }
+    /**
+     * Append data to an OSS Appendable Object.
+     *
+     * OSS AppendObject requires a `position` parameter that must equal the
+     * current object size. We use a three-step strategy:
+     *
+     * 1. Use the cached position (0 for new objects, or the value from the
+     *    last successful append).
+     * 2. If OSS returns PositionNotEqualToLength (cache is stale), issue a
+     *    HEAD request to learn the current object size, then retry once.
+     * 3. Update the cache with `nextAppendPosition` from the response.
+     *
+     * This gives us single-round-trip performance in the common case (single
+     * writer, no restarts) while still being self-healing when the cache is
+     * stale.
+     */
+    async append(key, value) {
+        var _a, _b;
+        const buf = Buffer.from(value, 'utf-8');
+        const position = (_a = this.appendPositions.get(key)) !== null && _a !== void 0 ? _a : 0;
+        try {
+            const result = await this.client.append(key, buf, { position });
+            this.appendPositions.set(key, Number(result.nextAppendPosition));
+        }
+        catch (err) {
+            // Position mismatch — the object grew since our last cached position.
+            // Fall back to HEAD to learn the actual size, then retry.
+            if (isOSSError(err, 'PositionNotEqualToLength')) {
+                const head = await this.client.head(key);
+                const currentPos = Number((_b = head.res.headers['content-length']) !== null && _b !== void 0 ? _b : 0);
+                const result = await this.client.append(key, buf, { position: currentPos });
+                this.appendPositions.set(key, Number(result.nextAppendPosition));
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+}
+exports.OSSObjectStorageClient = OSSObjectStorageClient;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiT1NTT2JqZWN0U3RvcmFnZUNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9PU1NPYmplY3RTdG9yYWdlQ2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUdBLFNBQVMsVUFBVSxDQUFDLEdBQVksRUFBRSxJQUFZO0lBQzVDLE9BQU8sR0FBRyxJQUFJLElBQUksSUFBSSxPQUFPLEdBQUcsS0FBSyxRQUFRLElBQUksTUFBTSxJQUFJLEdBQUcsSUFBSyxHQUF5QixDQUFDLElBQUksS0FBSyxJQUFJLENBQUM7QUFDN0csQ0FBQztBQUVEOzs7Ozs7Ozs7O0dBVUc7QUFDSCxNQUFhLHNCQUFzQjtJQWNqQyxZQUFZLE1BQWlCO1FBWDdCOzs7Ozs7OztXQVFHO1FBQ2Msb0JBQWUsR0FBRyxJQUFJLEdBQUcsRUFBa0IsQ0FBQztRQUczRCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBRUQsS0FBSyxDQUFDLEdBQUcsQ0FBQyxHQUFXLEVBQUUsS0FBYTtRQUNsQyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxPQUFPLENBQUMsQ0FBQyxDQUFDO0lBQzFELENBQUM7SUFFRCxLQUFLLENBQUMsR0FBRyxDQUFDLEdBQVc7UUFDbkIsSUFBSSxDQUFDO1lBQ0gsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUMxQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLEVBQUUsQ0FBQztnQkFDbkIsT0FBTyxNQUFNLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDckcsQ0FBQztZQUNELE9BQU8sSUFBSSxDQUFDO1FBQ2QsQ0FBQztRQUFDLE9BQU8sR0FBWSxFQUFFLENBQUM7WUFDdEIsSUFBSSxVQUFVLENBQUMsR0FBRyxFQUFFLFdBQVcsQ0FBQyxFQUFFLENBQUM7Z0JBQ2pDLE9BQU8sSUFBSSxDQUFDO1lBQ2QsQ0FBQztZQUNELE1BQU0sR0FBRyxDQUFDO1FBQ1osQ0FBQztJQUNILENBQUM7SUFFRDs7Ozs7Ozs7Ozs7Ozs7O09BZUc7SUFDSCxLQUFLLENBQUMsTUFBTSxDQUFDLEdBQVcsRUFBRSxLQUFhOztRQUNyQyxNQUFNLEdBQUcsR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRSxPQUFPLENBQUMsQ0FBQztRQUN4QyxNQUFNLFFBQVEsR0FBRyxNQUFBLElBQUksQ0FBQyxlQUFlLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxtQ0FBSSxDQUFDLENBQUM7UUFFcEQsSUFBSSxDQUFDO1lBQ0gsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEVBQUUsUUFBUSxFQUFFLENBQUMsQ0FBQztZQUNoRSxJQUFJLENBQUMsZUFBZSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDLE1BQU0sQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDLENBQUM7UUFDbkUsQ0FBQztRQUFDLE9BQU8sR0FBWSxFQUFFLENBQUM7WUFDdEIsc0VBQXNFO1lBQ3RFLDBEQUEwRDtZQUMxRCxJQUFJLFVBQVUsQ0FBQyxHQUFHLEVBQUUsMEJBQTBCLENBQUMsRUFBRSxDQUFDO2dCQUNoRCxNQUFNLElBQUksR0FBRyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO2dCQUN6QyxNQUFNLFVBQVUsR0FBRyxNQUFNLENBQUMsTUFBQSxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxnQkFBZ0IsQ0FBQyxtQ0FBSSxDQUFDLENBQUMsQ0FBQztnQkFDbkUsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLEVBQUUsUUFBUSxFQUFFLFVBQVUsRUFBRSxDQUFDLENBQUM7Z0JBQzVFLElBQUksQ0FBQyxlQUFlLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxNQUFNLENBQUMsTUFBTSxDQUFDLGtCQUFrQixDQUFDLENBQUMsQ0FBQztZQUNuRSxDQUFDO2lCQUFNLENBQUM7Z0JBQ04sTUFBTSxHQUFHLENBQUM7WUFDWixDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7Q0FDRjtBQXpFRCx3REF5RUMifQ==

package/dist/src/RunBuilder.d.ts

@@ -0,0 +1,43 @@
+import type { MessageObject, RunObject, RunRecord } from '@eggjs/tegg-types/agent-runtime';
+/** Accumulated token usage — same shape as non-null RunRecord['usage']. */
+export type RunUsage = NonNullable<RunRecord['usage']>;
+/**
+ * Encapsulates run state transitions.
+ *
+ * Mutation methods (`start`, `complete`, `fail`, `cancel`) update internal
+ * state and return `Partial<RunRecord>` for the store.
+ *
+ * `snapshot()` produces a `RunObject` suitable for API responses and SSE events.
+ */
+export declare class RunBuilder {
+    private readonly id;
+    private readonly threadId;
+    private readonly createdAt;
+    private readonly metadata?;
+    private readonly config?;
+    private status;
+    private startedAt?;
+    private completedAt?;
+    private cancelledAt?;
+    private failedAt?;
+    private lastError?;
+    private usage?;
+    private output?;
+    private constructor();
+    /** Create a RunBuilder from a store RunRecord, using its own threadId. */
+    static fromRecord(run: RunRecord): RunBuilder;
+    /** Create a RunBuilder from a store RunRecord, restoring all mutable state. */
+    static create(run: RunRecord, threadId: string): RunBuilder;
+    /** queued -> in_progress. Returns store update. */
+    start(): Partial<RunRecord>;
+    /** in_progress -> completed. Returns store update. */
+    complete(output: MessageObject[], usage?: RunUsage): Partial<RunRecord>;
+    /** queued/in_progress -> failed. Returns store update. */
+    fail(error: Error): Partial<RunRecord>;
+    /** in_progress/queued -> cancelling (idempotent if already cancelling). Returns store update. */
+    cancelling(): Partial<RunRecord>;
+    /** cancelling -> cancelled. Returns store update. */
+    cancel(): Partial<RunRecord>;
+    /** Produce a RunObject snapshot for API / SSE. */
+    snapshot(): RunObject;
+}

package/dist/src/RunBuilder.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunBuilder = void 0;
+const agent_runtime_1 = require("@eggjs/tegg-types/agent-runtime");
+const AgentStoreUtils_1 = require("./AgentStoreUtils");
+/**
+ * Encapsulates run state transitions.
+ *
+ * Mutation methods (`start`, `complete`, `fail`, `cancel`) update internal
+ * state and return `Partial<RunRecord>` for the store.
+ *
+ * `snapshot()` produces a `RunObject` suitable for API responses and SSE events.
+ */
+class RunBuilder {
+    constructor(id, threadId, createdAt, status, metadata, config) {
+        this.id = id;
+        this.threadId = threadId;
+        this.createdAt = createdAt;
+        this.status = status;
+        this.metadata = metadata;
+        this.config = config;
+    }
+    /** Create a RunBuilder from a store RunRecord, using its own threadId. */
+    static fromRecord(run) {
+        var _a;
+        return RunBuilder.create(run, (_a = run.threadId) !== null && _a !== void 0 ? _a : '');
+    }
+    /** Create a RunBuilder from a store RunRecord, restoring all mutable state. */
+    static create(run, threadId) {
+        var _a, _b, _c, _d, _e;
+        const rb = new RunBuilder(run.id, threadId, run.createdAt, run.status, run.metadata, run.config);
+        rb.startedAt = (_a = run.startedAt) !== null && _a !== void 0 ? _a : undefined;
+        rb.completedAt = (_b = run.completedAt) !== null && _b !== void 0 ? _b : undefined;
+        rb.cancelledAt = (_c = run.cancelledAt) !== null && _c !== void 0 ? _c : undefined;
+        rb.failedAt = (_d = run.failedAt) !== null && _d !== void 0 ? _d : undefined;
+        rb.lastError = (_e = run.lastError) !== null && _e !== void 0 ? _e : undefined;
+        rb.output = run.output;
+        if (run.usage) {
+            rb.usage = { ...run.usage };
+        }
+        return rb;
+    }
+    /** queued -> in_progress. Returns store update. */
+    start() {
+        if (this.status !== agent_runtime_1.RunStatus.Queued) {
+            throw new agent_runtime_1.InvalidRunStateTransitionError(this.status, agent_runtime_1.RunStatus.InProgress);
+        }
+        this.status = agent_runtime_1.RunStatus.InProgress;
+        this.startedAt = (0, AgentStoreUtils_1.nowUnix)();
+        return { status: this.status, startedAt: this.startedAt };
+    }
+    /** in_progress -> completed. Returns store update. */
+    complete(output, usage) {
+        if (this.status !== agent_runtime_1.RunStatus.InProgress) {
+            throw new agent_runtime_1.InvalidRunStateTransitionError(this.status, agent_runtime_1.RunStatus.Completed);
+        }
+        this.status = agent_runtime_1.RunStatus.Completed;
+        this.completedAt = (0, AgentStoreUtils_1.nowUnix)();
+        this.output = output;
+        this.usage = usage;
+        return {
+            status: this.status,
+            output,
+            usage,
+            completedAt: this.completedAt,
+        };
+    }
+    /** queued/in_progress -> failed. Returns store update. */
+    fail(error) {
+        if (this.status !== agent_runtime_1.RunStatus.InProgress && this.status !== agent_runtime_1.RunStatus.Queued) {
+            throw new agent_runtime_1.InvalidRunStateTransitionError(this.status, agent_runtime_1.RunStatus.Failed);
+        }
+        this.status = agent_runtime_1.RunStatus.Failed;
+        this.failedAt = (0, AgentStoreUtils_1.nowUnix)();
+        this.lastError = { code: agent_runtime_1.AgentErrorCode.ExecError, message: error.message };
+        return {
+            status: this.status,
+            lastError: this.lastError,
+            failedAt: this.failedAt,
+        };
+    }
+    /** in_progress/queued -> cancelling (idempotent if already cancelling). Returns store update. */
+    cancelling() {
+        if (this.status === agent_runtime_1.RunStatus.Cancelling) {
+            return { status: this.status };
+        }
+        if (this.status !== agent_runtime_1.RunStatus.InProgress && this.status !== agent_runtime_1.RunStatus.Queued) {
+            throw new agent_runtime_1.InvalidRunStateTransitionError(this.status, agent_runtime_1.RunStatus.Cancelling);
+        }
+        this.status = agent_runtime_1.RunStatus.Cancelling;
+        return { status: this.status };
+    }
+    /** cancelling -> cancelled. Returns store update. */
+    cancel() {
+        if (this.status !== agent_runtime_1.RunStatus.Cancelling) {
+            throw new agent_runtime_1.InvalidRunStateTransitionError(this.status, agent_runtime_1.RunStatus.Cancelled);
+        }
+        this.status = agent_runtime_1.RunStatus.Cancelled;
+        this.cancelledAt = (0, AgentStoreUtils_1.nowUnix)();
+        return {
+            status: this.status,
+            cancelledAt: this.cancelledAt,
+        };
+    }
+    /** Produce a RunObject snapshot for API / SSE. */
+    snapshot() {
+        var _a, _b, _c, _d, _e;
+        return {
+            id: this.id,
+            object: agent_runtime_1.AgentObjectType.ThreadRun,
+            createdAt: this.createdAt,
+            threadId: this.threadId,
+            status: this.status,
+            lastError: this.lastError,
+            startedAt: (_a = this.startedAt) !== null && _a !== void 0 ? _a : null,
+            completedAt: (_b = this.completedAt) !== null && _b !== void 0 ? _b : null,
+            cancelledAt: (_c = this.cancelledAt) !== null && _c !== void 0 ? _c : null,
+            failedAt: (_d = this.failedAt) !== null && _d !== void 0 ? _d : null,
+            usage: (_e = this.usage) !== null && _e !== void 0 ? _e : null,
+            metadata: this.metadata,
+            output: this.output,
+            config: this.config,
+        };
+    }
+}
+exports.RunBuilder = RunBuilder;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUnVuQnVpbGRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9SdW5CdWlsZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLG1FQUE2SDtBQUU3SCx1REFBNEM7QUFLNUM7Ozs7Ozs7R0FPRztBQUNILE1BQWEsVUFBVTtJQWdCckIsWUFDRSxFQUFVLEVBQ1YsUUFBZ0IsRUFDaEIsU0FBaUIsRUFDakIsTUFBaUIsRUFDakIsUUFBa0MsRUFDbEMsTUFBdUI7UUFFdkIsSUFBSSxDQUFDLEVBQUUsR0FBRyxFQUFFLENBQUM7UUFDYixJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQztRQUN6QixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztRQUMzQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsUUFBUSxHQUFHLFFBQVEsQ0FBQztRQUN6QixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBRUQsMEVBQTBFO0lBQzFFLE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBYzs7UUFDOUIsT0FBTyxVQUFVLENBQUMsTUFBTSxDQUFDLEdBQUcsRUFBRSxNQUFBLEdBQUcsQ0FBQyxRQUFRLG1DQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3BELENBQUM7SUFFRCwrRUFBK0U7SUFDL0UsTUFBTSxDQUFDLE1BQU0sQ0FBQyxHQUFjLEVBQUUsUUFBZ0I7O1FBQzVDLE1BQU0sRUFBRSxHQUFHLElBQUksVUFBVSxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsUUFBUSxFQUFFLEdBQUcsQ0FBQyxTQUFTLEVBQUUsR0FBRyxDQUFDLE1BQU0sRUFBRSxHQUFHLENBQUMsUUFBUSxFQUFFLEdBQUcsQ0FBQyxNQUFNLENBQUMsQ0FBQztRQUNqRyxFQUFFLENBQUMsU0FBUyxHQUFHLE1BQUEsR0FBRyxDQUFDLFNBQVMsbUNBQUksU0FBUyxDQUFDO1FBQzFDLEVBQUUsQ0FBQyxXQUFX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

package/dist/src/SSEWriter.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Abstract interface for writing SSE events.
+ * Decouples AgentRuntime from HTTP transport details.
+ */
+export interface SSEWriter {
+    /** Write an SSE event with the given name and JSON-serializable data. */
+    writeEvent(event: string, data: unknown): void;
+    /** Whether the underlying connection has been closed. */
+    readonly closed: boolean;
+    /** End the SSE stream. */
+    end(): void;
+    /** Register a callback for when the client disconnects. */
+    onClose(callback: () => void): void;
+}

package/dist/src/SSEWriter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU1NFV3JpdGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL1NTRVdyaXRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/src/agentDefaults.d.ts

@@ -0,0 +1 @@
+export declare const AGENT_DEFAULT_FACTORIES: Record<string, () => Function>;