@eggjs/tegg-types 3.80.1 → 3.82.0

package/agent-runtime/AgentRuntime.d.ts

@@ -47,6 +47,14 @@ export interface CreateRunInput {
         messages: import('./AgentMessage').InputMessage[];
     };
     config?: AgentRunConfig;
+    /**
+     * Metadata for the run. Stored verbatim on the run record, and additionally
+     * shallow-merged into the thread metadata (`meta.json`):
+     * - For an auto-created thread, it initializes the thread metadata.
+     * - For an existing thread, the keys are shallow-merged: new values overwrite
+     *   matching keys, while keys not present are preserved.
+     * - An omitted or empty object leaves the thread metadata unchanged.
+     */
     metadata?: Record<string, unknown>;
 }
 /**
@@ -54,8 +62,7 @@ export interface CreateRunInput {
  *
  * `metadata` is forwarded verbatim to {@link AgentStore.createThread} so callers
  * can persist additional business semantics on the thread record (e.g. the
- * resolved agent name, owning sandbox id, trace id). It is stored once at
- * creation time and never overwritten by subsequent runs on the same thread.
+ * resolved agent name, owning sandbox id, trace id).
  */
 export interface CreateThreadOptions {
     metadata?: Record<string, unknown>;

package/agent-runtime/AgentStore.d.ts

@@ -31,6 +31,14 @@ export interface ThreadRecord {
     messages: AgentMessage[];
     metadata: Record<string, unknown>;
     createdAt: number;
+    /**
+     * Id of the most recently created run on this thread, maintained by
+     * `createRun` as a best-effort pointer so callers can resolve a thread's
+     * latest run without an external index. Absent on threads that have no
+     * runs yet, and on threads created before this field existed — a missing
+     * value must be treated as "no recent run".
+     */
+    latestRunId?: string;
 }
 export interface RunRecord {
     id: string;
@@ -60,8 +68,20 @@ export interface AgentStore {
     destroy?(): Promise<void>;
     createThread(metadata?: Record<string, unknown>): Promise<ThreadRecord>;
     getThread(threadId: string, options?: GetThreadOptions): Promise<ThreadRecord>;
+    /**
+     * Shallow-merge metadata into an existing thread.
+     * New values overwrite matching keys; omitted keys are preserved.
+     */
+    updateThreadMetadata?(threadId: string, metadata: Record<string, unknown>): Promise<void>;
     appendMessages(threadId: string, messages: AgentMessage[]): Promise<void>;
     createRun(input: InputMessage[], threadId?: string, config?: AgentRunConfig, metadata?: Record<string, unknown>): Promise<RunRecord>;
     getRun(runId: string): Promise<RunRecord>;
+    /**
+     * Id of the most recent run created on the thread, or `null` when the
+     * thread exists but has no recorded run (including threads created before
+     * run tracking existed). Throws AgentNotFoundError when the thread itself
+     * does not exist.
+     */
+    getLatestRunId(threadId: string): Promise<string | null>;
     updateRun(runId: string, updates: Partial<RunRecord>): Promise<void>;
 }

package/agent-runtime/errors.d.ts

@@ -7,6 +7,13 @@ export declare class AgentNotFoundError extends Error {
     status: number;
     constructor(message: string);
 }
+/**
+ * Error thrown when an agent API request contains invalid input.
+ */
+export declare class AgentInvalidRequestError extends Error {
+    status: number;
+    constructor(message: string);
+}
 /**
  * Error thrown when an operation conflicts with the current state
  * (e.g., cancelling a completed run).

package/agent-runtime/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentTimeoutError = exports.InvalidRunStateTransitionError = exports.AgentConflictError = exports.AgentNotFoundError = void 0;
+exports.AgentTimeoutError = exports.InvalidRunStateTransitionError = exports.AgentConflictError = exports.AgentInvalidRequestError = exports.AgentNotFoundError = void 0;
 /**
  * Error thrown when a thread or run is not found.
  * The `status` property is recognized by Koa/Egg error handling
@@ -14,6 +14,17 @@ class AgentNotFoundError extends Error {
     }
 }
 exports.AgentNotFoundError = AgentNotFoundError;
+/**
+ * Error thrown when an agent API request contains invalid input.
+ */
+class AgentInvalidRequestError extends Error {
+    constructor(message) {
+        super(message);
+        this.status = 400;
+        this.name = 'AgentInvalidRequestError';
+    }
+}
+exports.AgentInvalidRequestError = AgentInvalidRequestError;
 /**
  * Error thrown when an operation conflicts with the current state
  * (e.g., cancelling a completed run).
@@ -53,4 +64,4 @@ class AgentTimeoutError extends Error {
     }
 }
 exports.AgentTimeoutError = AgentTimeoutError;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBOzs7O0dBSUc7QUFDSCxNQUFhLGtCQUFtQixTQUFRLEtBQUs7SUFHM0MsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUhqQixXQUFNLEdBQUcsR0FBRyxDQUFDO1FBSVgsSUFBSSxDQUFDLElBQUksR0FBRyxvQkFBb0IsQ0FBQztJQUNuQyxDQUFDO0NBQ0Y7QUFQRCxnREFPQztBQUVEOzs7R0FHRztBQUNILE1BQWEsa0JBQW1CLFNBQVEsS0FBSztJQUczQyxZQUFZLE9BQWU7UUFDekIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBSGpCLFdBQU0sR0FBRyxHQUFHLENBQUM7UUFJWCxJQUFJLENBQUMsSUFBSSxHQUFHLG9CQUFvQixDQUFDO0lBQ25DLENBQUM7Q0FDRjtBQVBELGdEQU9DO0FBRUQ7OztHQUdHO0FBQ0gsTUFBYSw4QkFBK0IsU0FBUSxLQUFLO0lBR3ZELFlBQVksSUFBWSxFQUFFLEVBQVU7UUFDbEMsS0FBSyxDQUFDLGtDQUFrQyxJQUFJLFNBQVMsRUFBRSxHQUFHLENBQUMsQ0FBQztRQUg5RCxXQUFNLEdBQUcsR0FBRyxDQUFDO1FBSVgsSUFBSSxDQUFDLElBQUksR0FBRyxnQ0FBZ0MsQ0FBQztJQUMvQyxDQUFDO0NBQ0Y7QUFQRCx3RUFPQztBQUVEOzs7Ozs7R0FNRztBQUNILE1BQWEsaUJBQWtCLFNBQVEsS0FBSztJQUcxQyxZQUFZLE9BQWU7UUFDekIsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBSGpCLFdBQU0sR0FBRyxHQUFHLENBQUM7UUFJWCxJQUFJLENBQUMsSUFBSSxHQUFHLG1CQUFtQixDQUFDO0lBQ2xDLENBQUM7Q0FDRjtBQVBELDhDQU9DIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBOzs7O0dBSUc7QUFDSCxNQUFhLGtCQUFtQixTQUFRLEtBQUs7SUFHM0MsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUhqQixXQUFNLEdBQUcsR0FBRyxDQUFDO1FBSVgsSUFBSSxDQUFDLElBQUksR0FBRyxvQkFBb0IsQ0FBQztJQUNuQyxDQUFDO0NBQ0Y7QUFQRCxnREFPQztBQUVEOztHQUVHO0FBQ0gsTUFBYSx3QkFBeUIsU0FBUSxLQUFLO0lBR2pELFlBQVksT0FBZTtRQUN6QixLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFIakIsV0FBTSxHQUFHLEdBQUcsQ0FBQztRQUlYLElBQUksQ0FBQyxJQUFJLEdBQUcsMEJBQTBCLENBQUM7SUFDekMsQ0FBQztDQUNGO0FBUEQsNERBT0M7QUFFRDs7O0dBR0c7QUFDSCxNQUFhLGtCQUFtQixTQUFRLEtBQUs7SUFHM0MsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUhqQixXQUFNLEdBQUcsR0FBRyxDQUFDO1FBSVgsSUFBSSxDQUFDLElBQUksR0FBRyxvQkFBb0IsQ0FBQztJQUNuQyxDQUFDO0NBQ0Y7QUFQRCxnREFPQztBQUVEOzs7R0FHRztBQUNILE1BQWEsOEJBQStCLFNBQVEsS0FBSztJQUd2RCxZQUFZLElBQVksRUFBRSxFQUFVO1FBQ2xDLEtBQUssQ0FBQyxrQ0FBa0MsSUFBSSxTQUFTLEVBQUUsR0FBRyxDQUFDLENBQUM7UUFIOUQsV0FBTSxHQUFHLEdBQUcsQ0FBQztRQUlYLElBQUksQ0FBQyxJQUFJLEdBQUcsZ0NBQWdDLENBQUM7SUFDL0MsQ0FBQztDQUNGO0FBUEQsd0VBT0M7QUFFRDs7Ozs7O0dBTUc7QUFDSCxNQUFhLGlCQUFrQixTQUFRLEtBQUs7SUFHMUMsWUFBWSxPQUFlO1FBQ3pCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUhqQixXQUFNLEdBQUcsR0FBRyxDQUFDO1FBSVgsSUFBSSxDQUFDLElBQUksR0FBRyxtQkFBbUIsQ0FBQztJQUNsQyxDQUFDO0NBQ0Y7QUFQRCw4Q0FPQyJ9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/tegg-types",
-  "version": "3.80.1",
+  "version": "3.82.0",
   "description": "tegg types",
   "keywords": [
     "egg",
@@ -45,5 +45,5 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.0.4"
   },
-  "gitHead": "e2c8edcc9c90b024ad4dbe1f67731abe784cb809"
+  "gitHead": "19b3a51a3fb53ea6e2afa3798e838f229a3077b6"
 }