@standardagents/builder 0.34.0 → 0.35.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-NmFt-OEl.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-NmFt-OEl.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-D7luZUMB.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-D7luZUMB.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';
@@ -1805,6 +1805,12 @@ interface AgentBuilderEnv {
 interface ThreadRegistryEntry {
     id: string;
     agent_name: string;
+    /**
+     * Agent the thread was CREATED on. Never changed by handoffs
+     * (updateThreadAgent only re-points agent_name), so lists can keep a
+     * handed-off conversation visible on its original agent's page.
+     */
+    origin_agent_name?: string | null;
     user_id: string | null;
     tags: string[] | null;
     env: Record<string, string> | null;
@@ -2114,6 +2120,10 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
     getThreadTreeIds(rootThreadId: string): Promise<string[]>;
     /**
      * Update a thread's agent_name (used during agent handoff).
+     * origin_agent_name is deliberately untouched — it pins the thread to the
+     * agent page it started on. Broadcasts thread_updated so connected clients
+     * re-render the row immediately instead of on the next activity tick
+     * (which is when handed-off threads used to silently vanish mid-watch).
      */
     updateThreadAgent(id: string, agent_name: string): Promise<boolean>;
     /**
@@ -2850,6 +2860,14 @@ interface AgentDefinition<N extends string = string> {
      * @default false
      */
     exposeAsTool?: boolean;
+    /**
+     * Whether this agent is a PRIMARY, user-facing entry point.
+     * Set false on internal handoff targets (e.g. domain-gearbox variants) so
+     * UIs keep them out of top-level agent lists while they stay fully
+     * addressable for handoffs and thread resumption.
+     * @default true
+     */
+    primary?: boolean;
     /** Description shown when agent is used as a tool. */
     toolDescription?: string;
     /**

package/dist/runtime.js

@@ -17802,9 +17802,9 @@ var DurableThread = class _DurableThread extends DurableObject {
    * Each migration is run in order, starting from the current version + 1.
    */
   async runMigrations(fromVersion) {
-    for (const migration50 of migrations) {
-      if (migration50.version > fromVersion) {
-        await migration50.up(this.ctx.storage.sql);
+    for (const migration51 of migrations) {
+      if (migration51.version > fromVersion) {
+        await migration51.up(this.ctx.storage.sql);
       }
     }
   }
@@ -23238,8 +23238,23 @@ var migration49 = {
   }
 };
 
+// src/durable-objects/agentbuilder-migrations/0016_add_origin_agent.ts
+var migration50 = {
+  version: 16,
+  async up(sql) {
+    sql.exec(`ALTER TABLE threads ADD COLUMN origin_agent_name TEXT`);
+    sql.exec(
+      `CREATE INDEX IF NOT EXISTS idx_threads_origin_agent_name ON threads(origin_agent_name)`
+    );
+    sql.exec(`UPDATE threads SET origin_agent_name = agent_name`);
+    sql.exec(`
+      INSERT OR REPLACE INTO _metadata (key, value) VALUES ('schema_version', '16')
+    `);
+  }
+};
+
 // src/durable-objects/agentbuilder-migrations/index.ts
-var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46, migration47, migration48, migration49];
+var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46, migration47, migration48, migration49, migration50];
 var LATEST_SCHEMA_VERSION2 = 15;
 
 // src/utils/crypto.ts
@@ -24016,9 +24031,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     }
   }
   async runMigrations(fromVersion) {
-    for (const migration50 of migrations2) {
-      if (migration50.version > fromVersion) {
-        await migration50.up(this.ctx.storage.sql);
+    for (const migration51 of migrations2) {
+      if (migration51.version > fromVersion) {
+        await migration51.up(this.ctx.storage.sql);
       }
     }
   }
@@ -24060,10 +24075,11 @@ ${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, last_activity_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, ?)`,
+      `INSERT INTO threads (id, agent_name, origin_agent_name, user_id, tags, env, tenvs, properties, parent, terminated, created_at, last_activity_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, ?, ?)`,
       id,
       params.agent_name,
+      params.agent_name,
       params.user_id || null,
       params.tags ? JSON.stringify(params.tags) : null,
       encryptedEnv,
@@ -24076,6 +24092,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     const thread = {
       id,
       agent_name: params.agent_name,
+      origin_agent_name: params.agent_name,
       user_id: params.user_id || null,
       tags: params.tags || null,
       env,
@@ -24143,7 +24160,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, last_message_preview FROM threads WHERE id = ?`,
+      `SELECT id, agent_name, origin_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();
@@ -24157,6 +24174,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     return {
       id: row.id,
       agent_name: row.agent_name,
+      origin_agent_name: row.origin_agent_name,
       user_id: row.user_id,
       tags: row.tags ? JSON.parse(row.tags) : null,
       env,
@@ -24219,16 +24237,16 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       if (params.include_children) {
         whereClauses.push(`id IN (
           WITH RECURSIVE descendants(id) AS (
-            SELECT id FROM threads WHERE agent_name = ?
+            SELECT id FROM threads WHERE agent_name = ? OR origin_agent_name = ?
             UNION ALL
             SELECT t.id FROM threads t JOIN descendants d ON t.parent = d.id
           )
           SELECT id FROM descendants
         )`);
-        args.push(params.agent_name);
+        args.push(params.agent_name, params.agent_name);
       } else {
-        whereClauses.push("agent_name = ?");
-        args.push(params.agent_name);
+        whereClauses.push("(agent_name = ? OR origin_agent_name = ?)");
+        args.push(params.agent_name, params.agent_name);
       }
     }
     if (params?.user_id) {
@@ -24270,7 +24288,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     const offset = params?.offset ?? 0;
     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, last_message_preview FROM threads
+      `SELECT id, agent_name, origin_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 ?`,
@@ -24281,6 +24299,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     const threads = cursor.toArray().map((row) => ({
       id: row.id,
       agent_name: row.agent_name,
+      origin_agent_name: row.origin_agent_name,
       user_id: row.user_id,
       tags: row.tags ? JSON.parse(row.tags) : null,
       env: null,
@@ -24448,6 +24467,10 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
   }
   /**
    * Update a thread's agent_name (used during agent handoff).
+   * origin_agent_name is deliberately untouched — it pins the thread to the
+   * agent page it started on. Broadcasts thread_updated so connected clients
+   * re-render the row immediately instead of on the next activity tick
+   * (which is when handed-off threads used to silently vanish mid-watch).
    */
   async updateThreadAgent(id, agent_name) {
     await this.ensureMigrated();
@@ -24456,6 +24479,14 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
       agent_name,
       id
     );
+    try {
+      const updated = await this.getThread(id);
+      if (updated) {
+        const eventThread = await this.toThreadEventPayload(updated);
+        this.broadcastEvent({ type: "thread_updated", thread: eventThread });
+      }
+    } catch {
+    }
     return true;
   }
   /**