@standardagents/builder 0.31.0 → 0.33.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-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 { 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-CqhPhqAI.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-CqhPhqAI.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';
@@ -1248,6 +1248,12 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
      * turn that triggered it.
      */
     private recordRegistryActivity;
+    /**
+     * The newest non-empty user message on this thread, for thread-list previews.
+     * Returns null when the thread has none. The Durable Object does not know its
+     * own thread id, so the caller is the one that stamps the registry.
+     */
+    getLatestUserMessagePreview(): Promise<string | null>;
     /** 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. */
@@ -1813,6 +1819,8 @@ interface ThreadRegistryEntry {
     last_activity_at?: number | null;
     /** True while the thread is executing a flow (stale markers read as false). */
     executing?: boolean;
+    /** Short excerpt of the most recent user message, for thread-list rows. */
+    last_message_preview?: string | null;
 }
 interface PendingSubagentAttachmentRef {
     path: string;
@@ -2070,7 +2078,20 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
      */
     recordThreadActivity(threadId: string, options?: {
         executing?: boolean;
+        messagePreview?: string | null;
     }): Promise<void>;
+    /**
+     * Fill in previews for threads that predate preview tracking. Callers read
+     * each thread's newest user message and stamp the results here in one batch.
+     *
+     * A thread with no user message is stamped with an empty string rather than
+     * left NULL: NULL means "not looked at yet", so without the sentinel an
+     * empty thread would be re-read on every list request forever.
+     */
+    backfillThreadPreviews(entries: Array<{
+        id: string;
+        preview: string | null;
+    }>): 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 migration48 of migrations) {
-      if (migration48.version > fromVersion) {
-        await migration48.up(this.ctx.storage.sql);
+    for (const migration50 of migrations) {
+      if (migration50.version > fromVersion) {
+        await migration50.up(this.ctx.storage.sql);
       }
     }
   }
@@ -21192,12 +21192,15 @@ ${resultContent}${attachmentSummary}`;
    * bookkeeping is presentation state: a failure here must never take down the
    * turn that triggered it.
    */
-  async recordRegistryActivity(threadId, executing) {
+  async recordRegistryActivity(threadId, executing, messagePreview) {
     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 });
+      await agentBuilder.recordThreadActivity?.(threadId, {
+        executing,
+        ...messagePreview !== void 0 ? { messagePreview } : {}
+      });
     } catch (error) {
       console.error(
         "[DurableThread] Failed to record thread activity (non-fatal):",
@@ -21205,6 +21208,27 @@ ${resultContent}${attachmentSummary}`;
       );
     }
   }
+  /**
+   * The newest non-empty user message on this thread, for thread-list previews.
+   * Returns null when the thread has none. The Durable Object does not know its
+   * own thread id, so the caller is the one that stamps the registry.
+   */
+  async getLatestUserMessagePreview() {
+    await this.ensureMigrated();
+    try {
+      const rows = this.ctx.storage.sql.exec(
+        `SELECT content FROM messages
+           WHERE role = 'user'
+             AND content IS NOT NULL AND content != ''
+             AND subagent_id IS NULL
+             AND (silent IS NULL OR silent = 0)
+           ORDER BY created_at DESC LIMIT 1`
+      ).toArray();
+      return rows[0]?.content ?? null;
+    } catch {
+      return null;
+    }
+  }
   /** Arm the standing watchdog for an execution start. One pending row max. */
   async armExecutionWatchdog(threadId) {
     try {
@@ -21788,7 +21812,11 @@ 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);
+    await this.recordRegistryActivity(
+      threadId,
+      true,
+      role === "user" ? content : void 0
+    );
     try {
       const agentBuilderId = this.env.AGENT_BUILDER.idFromName("singleton");
       const agentBuilder = this.env.AGENT_BUILDER.get(agentBuilderId);
@@ -23166,9 +23194,41 @@ var migration47 = {
   }
 };
 
+// src/durable-objects/agentbuilder-migrations/0014_thread_activity_scale.ts
+var migration48 = {
+  version: 14,
+  async up(sql) {
+    sql.exec(`ALTER TABLE threads ADD COLUMN last_message_preview TEXT`);
+    sql.exec(
+      `CREATE INDEX IF NOT EXISTS idx_threads_executing_since
+       ON threads(executing_since) WHERE executing_since IS NOT NULL`
+    );
+    sql.exec(
+      `UPDATE threads SET last_activity_at = created_at WHERE last_activity_at IS NULL`
+    );
+    sql.exec(`
+      INSERT OR REPLACE INTO _metadata (key, value) VALUES ('schema_version', '14')
+    `);
+  }
+};
+
+// src/durable-objects/agentbuilder-migrations/0015_clear_envelope_previews.ts
+var migration49 = {
+  version: 15,
+  async up(sql) {
+    sql.exec(
+      `UPDATE threads SET last_message_preview = NULL
+       WHERE last_message_preview LIKE 'Subagent (reference: %'`
+    );
+    sql.exec(`
+      INSERT OR REPLACE INTO _metadata (key, value) VALUES ('schema_version', '15')
+    `);
+  }
+};
+
 // src/durable-objects/agentbuilder-migrations/index.ts
-var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46, migration47];
-var LATEST_SCHEMA_VERSION2 = 13;
+var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46, migration47, migration48, migration49];
+var LATEST_SCHEMA_VERSION2 = 15;
 
 // src/utils/crypto.ts
 var CryptoUtil = class {
@@ -23368,6 +23428,13 @@ function parseStoredPermissions(value) {
   }
 }
 var EXECUTING_STALE_AFTER_SECONDS = 15 * 60;
+var THREAD_PREVIEW_MAX_CHARS = 140;
+var isRuntimeSubagentEnvelope = (content) => /^Subagent \(reference: /.test(content.trimStart());
+var buildThreadPreview = (content) => {
+  const collapsed = content.replace(/\s+/g, " ").trim();
+  if (!collapsed) return null;
+  return collapsed.length > THREAD_PREVIEW_MAX_CHARS ? `${collapsed.slice(0, THREAD_PREVIEW_MAX_CHARS - 1)}\u2026` : collapsed;
+};
 var isThreadExecuting = (executingSince, nowSeconds) => executingSince != null && nowSeconds - executingSince < EXECUTING_STALE_AFTER_SECONDS;
 var DurableAgentBuilder = class extends DurableObject {
   migratedToVersion = null;
@@ -23937,9 +24004,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     }
   }
   async runMigrations(fromVersion) {
-    for (const migration48 of migrations2) {
-      if (migration48.version > fromVersion) {
-        await migration48.up(this.ctx.storage.sql);
+    for (const migration50 of migrations2) {
+      if (migration50.version > fromVersion) {
+        await migration50.up(this.ctx.storage.sql);
       }
     }
   }
@@ -24064,7 +24131,7 @@ ${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, last_activity_at, executing_since FROM threads WHERE id = ?`,
+      `SELECT id, agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at, last_activity_at, executing_since, last_message_preview FROM threads WHERE id = ?`,
       id
     );
     const rows = cursor.toArray();
@@ -24091,7 +24158,8 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       executing: isThreadExecuting(
         row.executing_since,
         Math.floor(Date.now() / 1e3)
-      )
+      ),
+      last_message_preview: row.last_message_preview
     };
   }
   /**
@@ -24188,9 +24256,9 @@ ${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 orderByClause = params?.sort === "created" ? "created_at DESC" : params?.sort === "oldest" ? "created_at ASC" : "last_activity_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, last_activity_at, executing_since FROM threads
+      `SELECT id, agent_name, user_id, tags, properties, parent, terminated, created_at, last_activity_at, executing_since, last_message_preview FROM threads
        ${whereClause}
        ORDER BY ${orderByClause}
        LIMIT ? OFFSET ?`,
@@ -24214,7 +24282,8 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       terminated: row.terminated,
       created_at: row.created_at,
       last_activity_at: row.last_activity_at ?? row.created_at,
-      executing: isThreadExecuting(row.executing_since, nowSeconds)
+      executing: isThreadExecuting(row.executing_since, nowSeconds),
+      last_message_preview: row.last_message_preview
     }));
     return { threads, total };
   }
@@ -24253,6 +24322,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     await this.ensureMigrated();
     const now = Math.floor(Date.now() / 1e3);
     const executing = options?.executing;
+    const preview = typeof options?.messagePreview === "string" && !isRuntimeSubagentEnvelope(options.messagePreview) ? buildThreadPreview(options.messagePreview) : void 0;
     await this.ctx.storage.sql.exec(
       `UPDATE threads
        SET last_activity_at = ?
@@ -24279,13 +24349,41 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
         threadId
       );
     }
+    if (preview !== void 0) {
+      await this.ctx.storage.sql.exec(
+        `UPDATE threads SET last_message_preview = ? WHERE id = ?`,
+        preview,
+        threadId
+      );
+    }
     this.broadcastEvent({
       type: "thread_activity",
       threadId,
       last_activity_at: now,
-      executing: executing === true
+      executing: executing === true,
+      ...preview !== void 0 ? { last_message_preview: preview } : {}
     });
   }
+  /**
+   * Fill in previews for threads that predate preview tracking. Callers read
+   * each thread's newest user message and stamp the results here in one batch.
+   *
+   * A thread with no user message is stamped with an empty string rather than
+   * left NULL: NULL means "not looked at yet", so without the sentinel an
+   * empty thread would be re-read on every list request forever.
+   */
+  async backfillThreadPreviews(entries) {
+    if (entries.length === 0) return;
+    await this.ensureMigrated();
+    for (const entry of entries) {
+      const preview = typeof entry.preview === "string" && !isRuntimeSubagentEnvelope(entry.preview) ? buildThreadPreview(entry.preview) ?? "" : "";
+      await this.ctx.storage.sql.exec(
+        `UPDATE threads SET last_message_preview = ? WHERE id = ? AND last_message_preview IS NULL`,
+        preview,
+        entry.id
+      );
+    }
+  }
   /**
    * Delete a thread from the registry.
    */