@standardagents/builder 0.36.2 → 0.37.0

package/dist/client/index.html

@@ -26,7 +26,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <link rel="icon" type="image/svg+xml" href="/agents/assets/img/favicon-9uH1rb2F.svg">
     <title>AgentBuilder Admin</title>
-    <script type="module" crossorigin src="/agents/index-BTs3PMFs.js"></script>
+    <script type="module" crossorigin src="/agents/index-Df4DTwgs.js"></script>
     <link rel="modulepreload" crossorigin href="/agents/formkit-0eyyCEP_.js">
     <link rel="modulepreload" crossorigin href="/agents/vendor-TPZjEwCU.js">
     <link rel="modulepreload" crossorigin href="/agents/syntax-D-ZcovVx.js">

package/dist/{index-DUIfQjBW.d.ts → index-yV9JL4r3.d.ts}

@@ -407,7 +407,7 @@ interface ThreadInstance {
     }>;
     hasBridge?(): Promise<boolean>;
     failPendingMessagesAndBroadcast?(): Promise<number>;
-    settleTerminalFailure?(errorMessage: string): Promise<void>;
+    settleTerminalFailure?(errorMessage: string, threadId?: string): Promise<void>;
     notifyClientWaiting?(toolCallId: string, threadId: string, userId: string | null): Promise<void>;
     registerCodeExecutionBridge?(runId: string, bridge: {
         call(functionId: string, encodedArgs: unknown[]): Promise<unknown>;
@@ -1237,6 +1237,19 @@ interface LogDetails {
  */
 interface DurableThreadRpc {
     stop(): Promise<Response>;
+    emergencyQuarantine?(input: {
+        actionId: string;
+        reason: string;
+        source?: string;
+        forensicHold?: boolean;
+        observed?: Record<string, number>;
+    }): Promise<unknown>;
+    emergencyResume?(input: {
+        actionId: string;
+        reason: string;
+        releaseForensicHold?: boolean;
+    }): Promise<unknown>;
+    getRuntimeSafetyStatus?(): Promise<unknown>;
     /** Newest non-empty user message on the thread, for thread-list previews. */
     getLatestUserMessagePreview(): Promise<string | null>;
     executeBlocking?(threadId: string, agentId: string, initial_messages?: unknown[], data?: unknown): Promise<{
@@ -1428,6 +1441,8 @@ interface ThreadRegistryEntry {
     executing?: boolean;
     /** Short excerpt of the most recent user message, for thread-list rows. */
     last_message_preview?: string | null;
+    /** Unix seconds of the newest message on this thread (never bumped by background activity). */
+    last_message_at?: number | null;
 }
 /**
  * RPC methods exposed by DurableAgentBuilder for external callers.
@@ -1640,6 +1655,7 @@ interface DurableAgentBuilderRpc {
     recordThreadActivity?(threadId: string, options?: {
         executing?: boolean;
         messagePreview?: string | null;
+        messageAt?: number;
     }): Promise<void>;
     getThreadTreeIds?(threadId: string): Promise<string[]>;
     deleteThread(threadId: string): Promise<void>;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ModelDefinition, AgentDefinition } from './runtime.js';
 export { AgentBuilderEnv, AuthContext, AuthUser, BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, DurableUserHub, FlowStateSdk, FlowStateWithSdk, HubClientInfo, ImageContextConfig, InjectMessageOptions, LLMProviderInterface, NamespaceResolutionError, PromptContent, PromptDefinition, PromptIncludePart, PromptPart, PromptToolConfig, Provider, ProviderContentPart, ProviderFilePart, ProviderImagePart, ProviderRegistry, ProviderTextPart, SessionToolBinding, SessionToolConfig, SideConfig, SubagentToolConfig, SubpromptConfig, ThreadRegistryEntry, ThreadWatchdog, ThreadWatchdogState, ToolConfig, UpdateThreadParams, User, WatchdogCheckin, WatchdogProbeResult, authenticate, buildImageDescription, cat, createNamespaceContext, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateImageDescription, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, move, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, rename, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage } from './runtime.js';
 export { AgentPluginOptions, agentbuilder, builder } from './plugin.js';
-export { A as Agent, x as AttachmentRef, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, m as ClientStreamRequest, n as ClientStreamResponse, k as ClientToolRequest, l as ClientToolResponse, B as Controller, a as ControllerContext, E as Env, w as FileRecord, y as FileStats, u as FlowResult, F as FlowState, G as GrepResult, D as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, J as MessageContent, H as MultimodalContent, R as RequestContext, S as StorageBackend, v as TelemetryEvent, z as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, q as ThreadInstance, r as ThreadMetadata, T as ToolCall, t as ToolResult, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-DUIfQjBW.js';
+export { A as Agent, x as AttachmentRef, f as BuilderThreadEndpointHandler, C as CLIENT_STREAM_CHUNK_BYTES, o as ClientDuplex, p as ClientForwarding, m as ClientStreamRequest, n as ClientStreamResponse, k as ClientToolRequest, l as ClientToolResponse, B as Controller, a as ControllerContext, E as Env, w as FileRecord, y as FileStats, u as FlowResult, F as FlowState, G as GrepResult, D as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, J as MessageContent, H as MultimodalContent, R as RequestContext, S as StorageBackend, v as TelemetryEvent, z as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, q as ThreadInstance, r as ThreadMetadata, T as ToolCall, t as ToolResult, g as callClient, h as callClientStream, c as createThreadEndpointHandler, j as decodeStreamChunk, d as defineController, i as encodeStreamChunk, s as supportsClientForwarding } from './index-yV9JL4r3.js';
 export { AgentType, DefinitionLoader, GlobalNamespaceContext, HookSignatures, ImageContent, ModelCapabilities, ModelProvider, NamespaceContext, PackageSignature, PackedExports, PackedMeta, PackedMetadata, PackedNamespaceContext, PromptInput, PromptTextPart, ProviderAssistantMessage, ProviderConfigSlot, ProviderConfigSlots, ProviderConfigValueSource, ProviderDefinition, ProviderError, ProviderErrorCode, ProviderFactory, ProviderFactoryConfig, ProviderFinishReason, ProviderGeneratedImage, ProviderMessage, ProviderMessageContent, ProviderMethodOverrides, ModelCapabilities as ProviderModelCapabilities, ProviderOverride, ProviderOverrideContext, ProviderReasoningDetail, ProviderRequest, ProviderResponse, ProviderStreamChunk, ProviderSyncOverride, ProviderSystemMessage, ProviderTool, ProviderToolCallPart, ProviderToolMessage, ProviderToolResultContent, ProviderUsage, ProviderUserMessage, ReasoningConfig, StructuredPrompt, TextContent, Tool, ToolArgs, ToolArgsNode, ToolArgsRawShape, ToolContent, belongsToPackage, defineAgent, defineHook, defineModel, definePrompt, defineProvider, defineTool, isPacked, isVisibleInNamespace, mapReasoningLevel, providerConst, providerEnv, providerValue } from '@standardagents/spec';
 export { C as ConstituentItem, D as DiscoveredPackage, N as NamespacedRegistry, P as PackingAnalysis, a as PackingOptions, b as PackingResult, c as UnpackOptions, d as UnpackResult } from './types-Bpe7IANZ.js';
 export { D as DiscoveryConfig, P as PackageDiscoveryService, d as discoverPackages } from './discovery-DiMJWisl.js';
@@ -10,6 +10,64 @@ import 'vite';
 import '@cloudflare/workers-types';
 import 'zod';
 
+/**
+ * The "visible terminal assistant" boundary, server side.
+ *
+ * A client's session-state reducer retires its provisional draft on exactly
+ * this class of record: a durable assistant message that is no longer pending,
+ * is not silent, and carries visible text. Unread state has to agree with that
+ * boundary — a thread is unread when a reply the user has not seen has landed,
+ * which is the same instant the draft stops being provisional. Anything the
+ * reducer refuses to treat as an answer must not stamp recency either:
+ *
+ * - Pending/streaming partials: the answer has not landed yet.
+ * - Empty assistant envelopes: interleaved-reasoning providers persist one at
+ *   every reasoning/generation boundary mid-turn, and a tool-calling step
+ *   persists one with tool_calls and no prose. Neither renders anywhere.
+ * - Reasoning-only records: reasoning lives in its own column and in content
+ *   blocks that carry no `text`, so both flatten to an empty string here.
+ * - Silent rows: never rendered in any head.
+ *
+ * A FAILED record with visible text does stamp, matching the reducer: a
+ * terminal error message is a real, visible end state the user has not read.
+ * A failed record with no content is excluded by the empty-content rule.
+ *
+ * A record carrying TOOL CALLS is never terminal, no matter how much prose
+ * rides along with it: FlowEngine persists the step (content + tool_calls,
+ * status completed) BEFORE executing its tools, so a narrated preamble like
+ * "Let me check the repo…" is a mid-turn working step every client still
+ * renders under a Working indicator. Stamping it would re-mark the thread
+ * unread on every step of a narrated turn — the exact false-dot class this
+ * field exists to eliminate.
+ *
+ * Visibility is text OR attachments: an attachment-only reply (content null
+ * plus generated images) is a supported terminal answer shape that every head
+ * renders, so it must stamp even though its text flattens to empty.
+ */
+declare function isVisibleTerminalAssistantMessage(message: Record<string, unknown> | null | undefined): boolean;
+/**
+ * True when a column holding a JSON array (tool_calls, attachments) actually
+ * carries entries. Rows store these as JSON strings; in-memory records may
+ * hold real arrays. Unparseable non-empty strings count as present — failing
+ * toward "not terminal" for tool_calls is the safe direction, and attachments
+ * only reach here after the text check already failed.
+ */
+declare function hasJsonArrayEntries(raw: unknown): boolean;
+/**
+ * Visible text of a message record, matching the reducer's extractor: plain
+ * string content, or the concatenated `text` of content blocks. Blocks without
+ * a string `text` (reasoning, images, tool payloads) contribute nothing.
+ */
+declare function assistantMessageText(content: unknown): string;
+/**
+ * Unix SECONDS for a message record whose timestamps are stored in
+ * microseconds. Prefers the completion time over the creation time: a pending
+ * row is created when the request goes out, so `created_at` can precede the
+ * visible answer by the whole generation. Returns null when neither column
+ * holds a usable number, letting the registry fall back to its own clock.
+ */
+declare function messageTimestampSeconds(message: Record<string, unknown> | null | undefined): number | null;
+
 /**
  * Options for generating a model file.
  */
@@ -157,4 +215,4 @@ declare function generatePromptFile(data: PromptFileData): string;
  */
 declare function generateAgentFile(data: AgentDefinition): string;
 
-export { AgentDefinition, ModelDefinition, generateAgentFile, generateModelFile, generatePromptFile };
+export { AgentDefinition, ModelDefinition, assistantMessageText, generateAgentFile, generateModelFile, generatePromptFile, hasJsonArrayEntries, isVisibleTerminalAssistantMessage, messageTimestampSeconds };