@standardagents/builder 0.30.1 → 0.31.0

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-import { e as ThreadEnv, A as Agent, r as ThreadMetadata, t as ToolResult, M as Message, k as ClientToolRequest, l as ClientToolResponse, m as ClientStreamRequest, n as ClientStreamResponse, w as FileRecord, F as FlowState, y as FileStats, G as GrepResult, x as AttachmentRef, J as MessageContent, E as Env, q as ThreadInstance } from './index-CcnGEkPh.js';
-export { f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, B as Controller, a as ControllerContext, u as FlowResult, D as ImageContentPart, I as ImageMetadata, L as LLMResponse, H as MultimodalContent, R as RequestContext, S as StorageBackend, v as TelemetryEvent, z as TextContentPart, b as ThreadEndpointContext, T as ToolCall, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-CcnGEkPh.js';
+import { e as ThreadEnv, A as Agent, r as ThreadMetadata, t as ToolResult, M as Message, k as ClientToolRequest, l as ClientToolResponse, m as ClientStreamRequest, n as ClientStreamResponse, w as FileRecord, F as FlowState, y as FileStats, G as GrepResult, x as AttachmentRef, J as MessageContent, E as Env, q as ThreadInstance } from './index-CL7q3PuW.js';
+export { f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, B as Controller, a as ControllerContext, u as FlowResult, D as ImageContentPart, I as ImageMetadata, L as LLMResponse, H as MultimodalContent, R as RequestContext, S as StorageBackend, v as TelemetryEvent, z as TextContentPart, b as ThreadEndpointContext, T as ToolCall, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-CL7q3PuW.js';
 import { CodeExecutionOptions, CodeExecutionResult, SubagentRegistryEntry, InjectMessageInput, QueueMessageInput, CredentialGrant, SkillMetadata, SkillFileInput, ModelDefinition as ModelDefinition$1, ToolArgs, PromptTextPart, PromptEnvPart, VariableDefinition, SubpromptConfig as SubpromptConfig$1, PromptToolConfig as PromptToolConfig$1, SubagentToolConfig as SubagentToolConfig$1, ReasoningConfig, SideConfig as SideConfig$1, LLMProviderInterface, ContentPart, TextPart, ImagePart, FilePart, ThreadState, NamespaceContext, DefinitionLoader } from '@standardagents/spec';
 export { AgentType, DefinitionLoader, GlobalNamespaceContext, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, NamespaceContext, PackageSignature, PackedExports, PackedMeta, PackedMetadata, PackedNamespaceContext, PromptInput, PromptTextPart, ProviderAssistantMessage, ProviderError, ProviderErrorCode, ProviderFactory, ProviderFactoryConfig, ProviderFinishReason, ProviderGeneratedImage, ProviderMessage, ProviderMessageContent, ModelCapabilities as ProviderModelCapabilities, ProviderReasoningDetail, ProviderRequest, ProviderResponse, ProviderStreamChunk, ProviderSystemMessage, ProviderTool, ProviderToolCallPart, ProviderToolMessage, ProviderToolResultContent, ProviderUsage, ProviderUserMessage, ReasoningConfig, StructuredPrompt, TextContent, Tool, ToolArgs, ToolArgsNode, ToolArgsRawShape, ToolContent, belongsToPackage, defineAgent, defineHook, defineModel, definePrompt, defineTool, isPacked, isVisibleInNamespace, mapReasoningLevel } from '@standardagents/spec';
 import { DurableObject, WorkerEntrypoint } from 'cloudflare:workers';
@@ -1241,6 +1241,13 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * Returns null on deployments whose generated config predates the binding.
      */
     private watchdogCompanion;
+    /**
+     * Stamp thread activity on the registry so thread lists can sort by recency
+     * of real work and show which threads are executing right now. Registry
+     * bookkeeping is presentation state: a failure here must never take down the
+     * turn that triggered it.
+     */
+    private recordRegistryActivity;
     /** Arm the standing watchdog for an execution start. One pending row max. */
     private armExecutionWatchdog;
     /** Disarm on clean execution end. Completed check rows are noise, not history. */
@@ -1802,6 +1809,10 @@ interface ThreadRegistryEntry {
     parent: string | null;
     terminated: number | null;
     created_at: number;
+    /** Unix seconds of the last message or execution on this thread (or a descendant). */
+    last_activity_at?: number | null;
+    /** True while the thread is executing a flow (stale markers read as false). */
+    executing?: boolean;
 }
 interface PendingSubagentAttachmentRef {
     path: string;
@@ -1910,6 +1921,8 @@ interface Provider$1 {
     sdk: string;
     api_key: string;
 }
+/** Sort orders supported by `listThreads`. */
+type ThreadListSort = 'activity' | 'created' | 'oldest';
 declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv> extends DurableObject<Env> {
     private migratedToVersion;
     private eventSockets;
@@ -2024,10 +2037,40 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
         limit?: number;
         offset?: number;
         include_children?: boolean;
+        /** Default `activity`: most recently worked-on threads first. */
+        sort?: ThreadListSort;
+        /** `true` → only threads currently executing; `false` → only idle ones. */
+        executing?: boolean;
+        /** `false` hides terminated threads; `true` shows only terminated ones. */
+        terminated?: boolean;
     }): Promise<{
         threads: ThreadRegistryEntry[];
         total: number;
     }>;
+    /**
+     * Distinct owners of threads visible to the caller, with counts, so a thread
+     * list can offer an "owner" filter without exposing the admin-only user
+     * directory (which is unavailable on hosted instances).
+     */
+    listThreadOwners(params?: {
+        user_id?: string;
+    }): Promise<Array<{
+        user_id: string | null;
+        username: string | null;
+        display_name: string | null;
+        email: string | null;
+        thread_count: number;
+    }>>;
+    /**
+     * Record that a thread did work: stamp `last_activity_at` and flip the
+     * executing marker. Activity bubbles up the parent chain so a root thread
+     * sorts by the freshest work anywhere in its subagent tree — otherwise a
+     * long-running subagent would let its parent sink down an activity-sorted
+     * list.
+     */
+    recordThreadActivity(threadId: string, options?: {
+        executing?: boolean;
+    }): Promise<void>;
     /**
      * Delete a thread from the registry.
      */

package/dist/runtime.js

@@ -17790,9 +17790,9 @@ var DurableThread = class _DurableThread extends DurableObject {
    * Each migration is run in order, starting from the current version + 1.
    */
   async runMigrations(fromVersion) {
-    for (const migration47 of migrations) {
-      if (migration47.version > fromVersion) {
-        await migration47.up(this.ctx.storage.sql);
+    for (const migration48 of migrations) {
+      if (migration48.version > fromVersion) {
+        await migration48.up(this.ctx.storage.sql);
       }
     }
   }
@@ -21186,6 +21186,25 @@ ${resultContent}${attachmentSummary}`;
     if (!namespace || typeof namespace.idFromName !== "function") return null;
     return namespace.get(namespace.idFromName(threadId));
   }
+  /**
+   * Stamp thread activity on the registry so thread lists can sort by recency
+   * of real work and show which threads are executing right now. Registry
+   * bookkeeping is presentation state: a failure here must never take down the
+   * turn that triggered it.
+   */
+  async recordRegistryActivity(threadId, executing) {
+    try {
+      const namespace = this.env.AGENT_BUILDER;
+      if (!namespace || typeof namespace.idFromName !== "function") return;
+      const agentBuilder = namespace.get(namespace.idFromName("singleton"));
+      await agentBuilder.recordThreadActivity?.(threadId, { executing });
+    } catch (error) {
+      console.error(
+        "[DurableThread] Failed to record thread activity (non-fatal):",
+        error
+      );
+    }
+  }
   /** Arm the standing watchdog for an execution start. One pending row max. */
   async armExecutionWatchdog(threadId) {
     try {
@@ -21372,6 +21391,7 @@ ${resultContent}${attachmentSummary}`;
       }
       this.isExecuting = false;
       this.currentAbortController = null;
+      await this.recordRegistryActivity(threadId, false);
       tookOver = true;
     } else if (incomplete.length > 0 && silenceMs <= ceiling) {
       return report("observing", "none");
@@ -21575,6 +21595,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
     this.isExecuting = true;
     this.currentAbortController = new AbortController();
     await this.armExecutionWatchdog(threadId);
+    await this.recordRegistryActivity(threadId, true);
     try {
       const agentDef = await this.loadAgent(agentName);
       const packageId = agentDef.__package?.packageId;
@@ -21706,6 +21727,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
       this.isExecuting = false;
       this.currentAbortController = null;
       await this.disarmExecutionWatchdog(threadId);
+      await this.recordRegistryActivity(threadId, false);
     }
   }
   /**
@@ -21766,6 +21788,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
     this.isExecuting = true;
     this.currentAbortController = new AbortController();
     await this.armExecutionWatchdog(threadId);
+    await this.recordRegistryActivity(threadId, true);
     try {
       const agentBuilderId = this.env.AGENT_BUILDER.idFromName("singleton");
       const agentBuilder = this.env.AGENT_BUILDER.get(agentBuilderId);
@@ -21905,6 +21928,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
       this.isExecuting = false;
       this.currentAbortController = null;
       await this.disarmExecutionWatchdog(threadId);
+      await this.recordRegistryActivity(threadId, false);
     }
   }
   /**
@@ -21922,6 +21946,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
     this.isExecuting = true;
     this.currentAbortController = new AbortController();
     await this.armExecutionWatchdog(threadId);
+    await this.recordRegistryActivity(threadId, true);
     try {
       const agentBuilderId = this.env.AGENT_BUILDER.idFromName("singleton");
       const agentBuilder = this.env.AGENT_BUILDER.get(agentBuilderId);
@@ -22031,6 +22056,7 @@ Its execution was lost (the executor restarted or hung) and automatic recovery w
       this.isExecuting = false;
       this.currentAbortController = null;
       await this.disarmExecutionWatchdog(threadId);
+      await this.recordRegistryActivity(threadId, false);
       const latestQueuedSide = await this.getLatestQueuedMessageSide();
       if (latestQueuedSide) {
         await this.ensureQueuedMessageExecution(threadId, latestQueuedSide);
@@ -23124,9 +23150,25 @@ var migration46 = {
   }
 };
 
+// src/durable-objects/agentbuilder-migrations/0013_add_thread_activity.ts
+var migration47 = {
+  version: 13,
+  async up(sql) {
+    sql.exec(`ALTER TABLE threads ADD COLUMN last_activity_at INTEGER`);
+    sql.exec(`ALTER TABLE threads ADD COLUMN executing_since INTEGER`);
+    sql.exec(
+      `CREATE INDEX IF NOT EXISTS idx_threads_last_activity_at ON threads(last_activity_at)`
+    );
+    sql.exec(`UPDATE threads SET last_activity_at = created_at`);
+    sql.exec(`
+      INSERT OR REPLACE INTO _metadata (key, value) VALUES ('schema_version', '13')
+    `);
+  }
+};
+
 // src/durable-objects/agentbuilder-migrations/index.ts
-var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46];
-var LATEST_SCHEMA_VERSION2 = 12;
+var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46, migration47];
+var LATEST_SCHEMA_VERSION2 = 13;
 
 // src/utils/crypto.ts
 var CryptoUtil = class {
@@ -23325,6 +23367,8 @@ function parseStoredPermissions(value) {
     return null;
   }
 }
+var EXECUTING_STALE_AFTER_SECONDS = 15 * 60;
+var isThreadExecuting = (executingSince, nowSeconds) => executingSince != null && nowSeconds - executingSince < EXECUTING_STALE_AFTER_SECONDS;
 var DurableAgentBuilder = class extends DurableObject {
   migratedToVersion = null;
   eventSockets = /* @__PURE__ */ new Set();
@@ -23893,9 +23937,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     }
   }
   async runMigrations(fromVersion) {
-    for (const migration47 of migrations2) {
-      if (migration47.version > fromVersion) {
-        await migration47.up(this.ctx.storage.sql);
+    for (const migration48 of migrations2) {
+      if (migration48.version > fromVersion) {
+        await migration48.up(this.ctx.storage.sql);
       }
     }
   }
@@ -23937,8 +23981,8 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     const encryptedEnv = await this.encryptEnvRecord(env);
     const properties = this.withEnvTypeRecord(params.properties ?? null, envTypes);
     await this.ctx.storage.sql.exec(
-      `INSERT INTO threads (id, agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, ?)`,
+      `INSERT INTO threads (id, agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at, last_activity_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, ?)`,
       id,
       params.agent_name,
       params.user_id || null,
@@ -23947,6 +23991,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       encryptedEnv,
       properties ? JSON.stringify(properties) : null,
       params.parent ?? null,
+      now,
       now
     );
     const thread = {
@@ -23960,7 +24005,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       properties,
       parent: params.parent ?? null,
       terminated: null,
-      created_at: now
+      created_at: now,
+      last_activity_at: now,
+      executing: false
     };
     const eventThread = await this.toThreadEventPayload(thread);
     this.broadcastEvent({ type: "thread_created", thread: eventThread });
@@ -24016,7 +24063,10 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
    */
   async getThread(id) {
     await this.ensureMigrated();
-    const cursor = await this.ctx.storage.sql.exec(`SELECT id, agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at FROM threads WHERE id = ?`, id);
+    const cursor = await this.ctx.storage.sql.exec(
+      `SELECT id, agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at, last_activity_at, executing_since FROM threads WHERE id = ?`,
+      id
+    );
     const rows = cursor.toArray();
     if (rows.length === 0) {
       return null;
@@ -24036,7 +24086,12 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       properties,
       parent: row.parent,
       terminated: row.terminated,
-      created_at: row.created_at
+      created_at: row.created_at,
+      last_activity_at: row.last_activity_at ?? row.created_at,
+      executing: isThreadExecuting(
+        row.executing_since,
+        Math.floor(Date.now() / 1e3)
+      )
     };
   }
   /**
@@ -24077,6 +24132,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
    */
   async listThreads(params) {
     await this.ensureMigrated();
+    const nowSeconds = Math.floor(Date.now() / 1e3);
     const whereClauses = [];
     const args = [];
     if (params?.agent_name) {
@@ -24112,6 +24168,18 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       whereClauses.push("created_at <= ?");
       args.push(params.endDate);
     }
+    if (params?.executing === true) {
+      whereClauses.push("executing_since IS NOT NULL AND executing_since > ?");
+      args.push(nowSeconds - EXECUTING_STALE_AFTER_SECONDS);
+    } else if (params?.executing === false) {
+      whereClauses.push("(executing_since IS NULL OR executing_since <= ?)");
+      args.push(nowSeconds - EXECUTING_STALE_AFTER_SECONDS);
+    }
+    if (params?.terminated === true) {
+      whereClauses.push("terminated IS NOT NULL");
+    } else if (params?.terminated === false) {
+      whereClauses.push("terminated IS NULL");
+    }
     const whereClause = whereClauses.length > 0 ? `WHERE ${whereClauses.join(" AND ")}` : "";
     const countCursor = await this.ctx.storage.sql.exec(
       `SELECT COUNT(*) as count FROM threads ${whereClause}`,
@@ -24120,10 +24188,11 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     const total = countCursor.one().count;
     const limit = params?.limit ?? 100;
     const offset = params?.offset ?? 0;
+    const orderByClause = params?.sort === "created" ? "created_at DESC" : params?.sort === "oldest" ? "created_at ASC" : "COALESCE(last_activity_at, created_at) DESC, created_at DESC";
     const cursor = await this.ctx.storage.sql.exec(
-      `SELECT id, agent_name, user_id, tags, properties, parent, terminated, created_at FROM threads
+      `SELECT id, agent_name, user_id, tags, properties, parent, terminated, created_at, last_activity_at, executing_since FROM threads
        ${whereClause}
-       ORDER BY created_at DESC
+       ORDER BY ${orderByClause}
        LIMIT ? OFFSET ?`,
       ...args,
       limit,
@@ -24143,10 +24212,80 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       properties: row.properties ? JSON.parse(row.properties) : null,
       parent: row.parent,
       terminated: row.terminated,
-      created_at: row.created_at
+      created_at: row.created_at,
+      last_activity_at: row.last_activity_at ?? row.created_at,
+      executing: isThreadExecuting(row.executing_since, nowSeconds)
     }));
     return { threads, total };
   }
+  /**
+   * Distinct owners of threads visible to the caller, with counts, so a thread
+   * list can offer an "owner" filter without exposing the admin-only user
+   * directory (which is unavailable on hosted instances).
+   */
+  async listThreadOwners(params) {
+    await this.ensureMigrated();
+    const whereClause = params?.user_id ? "WHERE t.user_id = ?" : "";
+    const args = params?.user_id ? [params.user_id] : [];
+    const cursor = await this.ctx.storage.sql.exec(
+      `SELECT t.user_id AS user_id,
+              u.username AS username,
+              u.display_name AS display_name,
+              u.email AS email,
+              COUNT(*) AS thread_count
+       FROM threads t
+       LEFT JOIN users u ON u.id = t.user_id
+       ${whereClause}
+       GROUP BY t.user_id
+       ORDER BY thread_count DESC`,
+      ...args
+    );
+    return cursor.toArray();
+  }
+  /**
+   * Record that a thread did work: stamp `last_activity_at` and flip the
+   * executing marker. Activity bubbles up the parent chain so a root thread
+   * sorts by the freshest work anywhere in its subagent tree — otherwise a
+   * long-running subagent would let its parent sink down an activity-sorted
+   * list.
+   */
+  async recordThreadActivity(threadId, options) {
+    await this.ensureMigrated();
+    const now = Math.floor(Date.now() / 1e3);
+    const executing = options?.executing;
+    await this.ctx.storage.sql.exec(
+      `UPDATE threads
+       SET last_activity_at = ?
+       WHERE id IN (
+         WITH RECURSIVE ancestry(id, parent) AS (
+           SELECT id, parent FROM threads WHERE id = ?
+           UNION ALL
+           SELECT t.id, t.parent FROM threads t JOIN ancestry a ON t.id = a.parent
+         )
+         SELECT id FROM ancestry
+       )`,
+      now,
+      threadId
+    );
+    if (executing === true) {
+      await this.ctx.storage.sql.exec(
+        `UPDATE threads SET executing_since = ? WHERE id = ? AND executing_since IS NULL`,
+        now,
+        threadId
+      );
+    } else if (executing === false) {
+      await this.ctx.storage.sql.exec(
+        `UPDATE threads SET executing_since = NULL WHERE id = ?`,
+        threadId
+      );
+    }
+    this.broadcastEvent({
+      type: "thread_activity",
+      threadId,
+      last_activity_at: now,
+      executing: executing === true
+    });
+  }
   /**
    * Delete a thread from the registry.
    */