@standardagents/builder 0.32.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-1AMgutkG.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-1AMgutkG.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. */
@@ -2074,6 +2080,18 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
         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 migration49 of migrations) {
-      if (migration49.version > fromVersion) {
-        await migration49.up(this.ctx.storage.sql);
+    for (const migration50 of migrations) {
+      if (migration50.version > fromVersion) {
+        await migration50.up(this.ctx.storage.sql);
       }
     }
   }
@@ -21208,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 {
@@ -23191,9 +23212,23 @@ var migration48 = {
   }
 };
 
+// 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, migration48];
-var LATEST_SCHEMA_VERSION2 = 14;
+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 {
@@ -23394,6 +23429,7 @@ 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;
@@ -23968,9 +24004,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     }
   }
   async runMigrations(fromVersion) {
-    for (const migration49 of migrations2) {
-      if (migration49.version > fromVersion) {
-        await migration49.up(this.ctx.storage.sql);
+    for (const migration50 of migrations2) {
+      if (migration50.version > fromVersion) {
+        await migration50.up(this.ctx.storage.sql);
       }
     }
   }
@@ -24286,7 +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" ? buildThreadPreview(options.messagePreview) : void 0;
+    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 = ?
@@ -24328,6 +24364,26 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       ...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.
    */