@eggjs/tegg-types 3.83.0 → 3.84.1

package/agent-runtime/AgentMessage.d.ts

@@ -28,29 +28,74 @@ export interface InputMessage {
     content: string | InputContentPart[];
     metadata?: Record<string, unknown>;
 }
-export interface SDKSystemMessage {
+/** Per-message timing, stamped by the executor as each message streams in. */
+export interface MessageTiming {
+    /** Epoch ms when the executor received this message — authoritative per-message time. */
+    receivedAtMs: number;
+    /** Gap in ms since the previous persisted message's `receivedAtMs`. */
+    sincePrevMs?: number;
+    /** assistant only: ms the model took to generate this message (turn `message_start` → arrival). */
+    genMs?: number;
+    /** assistant only: time-to-first-token in ms, carried over from the turn's `stream_event`. */
+    ttftMs?: number;
+}
+/** Precise execution timing for a single tool call, derived from PreToolUse / PostToolUse hooks. */
+export interface ToolTiming {
+    toolUseId: string;
+    name: string;
+    /** Epoch ms when the tool started executing (PreToolUse). */
+    startedAtMs: number;
+    /** Epoch ms when the tool finished (PostToolUse); `null` when interrupted before completion. */
+    endedAtMs: number | null;
+    /** `endedAtMs - startedAtMs`; `null` when the tool did not finish. */
+    durationMs: number | null;
+    isError?: boolean;
+    /** Set when the tool ran inside a sub-agent. */
+    agentId?: string;
+}
+/** Single `eggExt` namespace carrying all framework extension fields on a message. */
+export interface EggExt {
+    /** Owning runId. Mirrored here as the forward-looking canonical location; also kept top-level for back-compat. */
+    runId?: string;
+    /** Per-message timing. */
+    timing?: MessageTiming;
+    /** Per-tool timing; present on `user` messages that carry tool_result blocks. */
+    toolTimings?: ToolTiming[];
+    /**
+     * Epoch ms when the store persisted this message (server-side clock). A
+     * fallback / drift-calibration timestamp stamped on every persisted message;
+     * it never overwrites the executor-stamped per-message `timing`. For input
+     * messages (which carry no `timing`) this is their only time field.
+     */
+    persistedAtMs?: number;
+}
+/** Mixin giving every AgentMessage member the `eggExt` extension namespace. */
+export interface AgentMessageExtensions {
+    eggExt?: EggExt;
+}
+export interface SDKSystemMessage extends AgentMessageExtensions {
     type: 'system';
     subtype: string;
     session_id?: string;
     [key: string]: unknown;
 }
-export interface SDKStreamEvent {
+export interface SDKStreamEvent extends AgentMessageExtensions {
     type: 'stream_event';
     event: unknown;
     session_id?: string;
     [key: string]: unknown;
 }
-export interface SDKUserMessage {
+export interface SDKUserMessage extends AgentMessageExtensions {
     type: 'user';
     message: unknown;
     [key: string]: unknown;
 }
-export interface SDKAssistantMessage {
+export interface SDKAssistantMessage extends AgentMessageExtensions {
     type: 'assistant';
     message: unknown;
     [key: string]: unknown;
 }
-export interface SDKResultMessage {
+export interface SDKResultMessage extends AgentMessageExtensions {
     type: 'result';
     subtype: string;
     usage?: {
@@ -62,7 +107,7 @@ export interface SDKResultMessage {
     };
     [key: string]: unknown;
 }
-export interface SDKGenericMessage {
+export interface SDKGenericMessage extends AgentMessageExtensions {
     type: string;
     [key: string]: unknown;
 }

package/agent-runtime/AgentRuntime.d.ts

@@ -27,6 +27,12 @@ export interface RunObject {
     completedAt?: number | null;
     cancelledAt?: number | null;
     failedAt?: number | null;
+    startedAtMs?: number | null;
+    completedAtMs?: number | null;
+    /** completedAtMs - startedAtMs (end-to-end run wall time in ms). */
+    durationMs?: number | null;
+    /** Sum of result.duration_api_ms across the run (pure model API time in ms). */
+    apiDurationMs?: number | null;
     usage?: {
         promptTokens: number;
         completionTokens: number;

package/agent-runtime/AgentStore.d.ts

@@ -62,6 +62,12 @@ export interface RunRecord {
     completedAt?: number | null;
     cancelledAt?: number | null;
     failedAt?: number | null;
+    startedAtMs?: number | null;
+    completedAtMs?: number | null;
+    /** completedAtMs - startedAtMs (end-to-end run wall time in ms). */
+    durationMs?: number | null;
+    /** Sum of result.duration_api_ms across the run (pure model API time in ms). */
+    apiDurationMs?: number | null;
 }
 export interface AgentStore {
     init?(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/tegg-types",
-  "version": "3.83.0",
+  "version": "3.84.1",
   "description": "tegg types",
   "keywords": [
     "egg",
@@ -45,5 +45,5 @@
     "ts-node": "^10.9.1",
     "typescript": "^5.0.4"
   },
-  "gitHead": "a027c9c8b0a0308f47b678959aae0ae2bfdb183c"
+  "gitHead": "d68d6ad57bca6bab0ebdcc8dae6769d168499220"
 }