@standardagents/builder 0.27.1 → 0.27.3

package/dist/{index-DJ7B8CTp.d.ts → index-DReIS8eP.d.ts}

@@ -262,6 +262,7 @@ interface ThreadInstance {
     hooks(): HookRegistry;
     getValue<T = unknown>(key: string): Promise<T | null>;
     setValue(key: string, value: unknown): Promise<void>;
+    emitThreadEvent?(threadId: string, event: string, data: unknown): void | Promise<void>;
     callClientTool?(request: ClientToolRequest): Promise<ClientToolResponse>;
     registerCodeExecutionBridge?(runId: string, bridge: {
         call(functionId: string, encodedArgs: unknown[]): Promise<unknown>;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ModelDefinition, AgentDefinition } from './runtime.js';
 export { AgentBuilderEnv, AuthContext, AuthUser, BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, FlowStateSdk, FlowStateWithSdk, 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, m as AttachmentRef, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, E as Env, l as FileRecord, n as FileStats, j as FlowResult, F as FlowState, G as GrepResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, r as MessageContent, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, g as ThreadInstance, h as ThreadMetadata, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-DJ7B8CTp.js';
+export { A as Agent, m as AttachmentRef, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, E as Env, l as FileRecord, n as FileStats, j as FlowResult, F as FlowState, G as GrepResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, M as Message, r as MessageContent, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, e as ThreadEnv, g as ThreadInstance, h as ThreadMetadata, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-DReIS8eP.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';

package/dist/index.js

@@ -12703,6 +12703,7 @@ var init_ThreadStateImpl = __esm({
       _executionState = null;
       _childrenCache = [];
       _terminatedCache = null;
+      _pendingEventDeliveries = /* @__PURE__ */ new Set();
       constructor(flowState, threadInstance, metadata, runtimeContext = {}) {
         this._flowState = flowState;
         this._threadInstance = threadInstance;
@@ -13154,6 +13155,22 @@ var init_ThreadStateImpl = __esm({
       emit(event, data) {
         if (this._flowState?.emitEvent) {
           this._flowState.emitEvent(event, data);
+          return;
+        }
+        if (this._threadInstance.emitThreadEvent) {
+          const delivery = this._threadInstance.emitThreadEvent(this.threadId, event, data);
+          if (delivery && typeof delivery.then === "function") {
+            const pending = Promise.resolve(delivery).catch((error) => {
+              console.error(`[ThreadState] Custom event "${event}" delivery failed:`, error);
+            }).finally(() => this._pendingEventDeliveries.delete(pending));
+            this._pendingEventDeliveries.add(pending);
+          }
+        }
+      }
+      /** Runtime-only drain used by thread endpoint wrappers before responding. */
+      async flushPendingEventDeliveries() {
+        while (this._pendingEventDeliveries.size > 0) {
+          await Promise.all([...this._pendingEventDeliveries]);
         }
       }
       // ─────────────────────────────────────────────────────────────────────────
@@ -22230,7 +22247,9 @@ function createThreadEndpointHandler(handler) {
         }
         endpointParams[key === "_" ? "*" : key] = value;
       }
-      return await handler(req, threadState, endpointParams);
+      const response = await handler(req, threadState, endpointParams);
+      await threadState.flushPendingEventDeliveries();
+      return response;
     } catch (error) {
       console.error(`Error in thread endpoint for ${threadId}:`, error);
       return Response.json(
@@ -25587,9 +25606,9 @@ var DurableThread = class _DurableThread extends DurableObject {
    * Each migration is run in order, starting from the current version + 1.
    */
   async runMigrations(fromVersion) {
-    for (const migration46 of migrations) {
-      if (migration46.version > fromVersion) {
-        await migration46.up(this.ctx.storage.sql);
+    for (const migration47 of migrations) {
+      if (migration47.version > fromVersion) {
+        await migration47.up(this.ctx.storage.sql);
       }
     }
   }
@@ -28341,6 +28360,9 @@ ${resultContent}${attachmentSummary}`;
    * Broadcast a custom event to all connected message WebSocket clients
    * Used by tools via emitThreadEvent() to send user-defined events
    */
+  emitThreadEvent(_threadId, type, data) {
+    this.broadcastEvent(type, data);
+  }
   broadcastEvent(type, data) {
     const payload = JSON.stringify({
       type: "event",
@@ -30291,9 +30313,119 @@ var migration45 = {
   }
 };
 
+// src/durable-objects/agentbuilder-migrations/0012_allow_api_instance_role.ts
+var migration46 = {
+  version: 12,
+  async up(sql) {
+    sql.exec(`CREATE TABLE oauth_accounts_0012_backup AS SELECT * FROM oauth_accounts`);
+    sql.exec(`CREATE TABLE api_keys_0012_backup AS SELECT * FROM api_keys`);
+    sql.exec(`CREATE TABLE sessions_0012_backup AS SELECT * FROM sessions`);
+    sql.exec(`DROP TABLE oauth_accounts`);
+    sql.exec(`DROP TABLE api_keys`);
+    sql.exec(`DROP TABLE sessions`);
+    sql.exec(`ALTER TABLE users RENAME TO users_0012_old`);
+    sql.exec(`
+      CREATE TABLE users (
+        id TEXT PRIMARY KEY NOT NULL,
+        username TEXT UNIQUE NOT NULL,
+        password_hash TEXT NOT NULL,
+        role TEXT NOT NULL DEFAULT 'admin' CHECK (role IN ('admin')),
+        created_at INTEGER DEFAULT (strftime('%s', 'now')),
+        updated_at INTEGER DEFAULT (strftime('%s', 'now')),
+        platform_user_id TEXT,
+        email TEXT,
+        display_name TEXT,
+        avatar_url TEXT,
+        instance_role TEXT NOT NULL DEFAULT 'admin' CHECK (instance_role IN ('admin', 'user', 'api')),
+        source TEXT NOT NULL DEFAULT 'local' CHECK (source IN ('local', 'standard_agents')),
+        replica_active INTEGER NOT NULL DEFAULT 1,
+        replica_updated_at INTEGER,
+        deleted_at INTEGER,
+        permissions TEXT
+      )
+    `);
+    sql.exec(`
+      INSERT INTO users (
+        id, username, password_hash, role, created_at, updated_at,
+        platform_user_id, email, display_name, avatar_url, instance_role,
+        source, replica_active, replica_updated_at, deleted_at, permissions
+      )
+      SELECT
+        id, username, password_hash, role, created_at, updated_at,
+        platform_user_id, email, display_name, avatar_url, instance_role,
+        source, replica_active, replica_updated_at, deleted_at, permissions
+      FROM users_0012_old
+    `);
+    sql.exec(`DROP TABLE users_0012_old`);
+    sql.exec(`CREATE INDEX idx_users_username ON users(username)`);
+    sql.exec(`CREATE INDEX idx_users_role ON users(role)`);
+    sql.exec(`CREATE INDEX idx_users_platform_user_id ON users(platform_user_id)`);
+    sql.exec(`CREATE INDEX idx_users_replica_active ON users(replica_active)`);
+    sql.exec(`CREATE INDEX idx_users_instance_role ON users(instance_role)`);
+    sql.exec(`
+      CREATE TABLE oauth_accounts (
+        id TEXT PRIMARY KEY NOT NULL,
+        user_id TEXT NOT NULL,
+        provider TEXT NOT NULL CHECK (provider IN ('github', 'google')),
+        provider_user_id TEXT NOT NULL,
+        provider_username TEXT,
+        created_at INTEGER DEFAULT (strftime('%s', 'now')),
+        FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+      )
+    `);
+    sql.exec(`INSERT INTO oauth_accounts SELECT * FROM oauth_accounts_0012_backup`);
+    sql.exec(`CREATE UNIQUE INDEX idx_oauth_accounts_provider ON oauth_accounts(provider, provider_user_id)`);
+    sql.exec(`CREATE INDEX idx_oauth_accounts_user_id ON oauth_accounts(user_id)`);
+    sql.exec(`
+      CREATE TABLE api_keys (
+        id TEXT PRIMARY KEY NOT NULL,
+        name TEXT NOT NULL,
+        key_hash TEXT NOT NULL,
+        key_prefix TEXT NOT NULL,
+        last_five TEXT NOT NULL,
+        user_id TEXT NOT NULL,
+        created_at INTEGER DEFAULT (strftime('%s', 'now')),
+        last_used_at INTEGER,
+        platform_key_id TEXT,
+        scope TEXT,
+        source TEXT NOT NULL DEFAULT 'local' CHECK (source IN ('local', 'standard_agents')),
+        replica_active INTEGER NOT NULL DEFAULT 1,
+        replica_updated_at INTEGER,
+        FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+      )
+    `);
+    sql.exec(`INSERT INTO api_keys SELECT * FROM api_keys_0012_backup`);
+    sql.exec(`CREATE INDEX idx_api_keys_key_hash ON api_keys(key_hash)`);
+    sql.exec(`CREATE INDEX idx_api_keys_user_id ON api_keys(user_id)`);
+    sql.exec(`CREATE INDEX idx_api_keys_key_prefix ON api_keys(key_prefix)`);
+    sql.exec(`CREATE INDEX idx_api_keys_platform_key_id ON api_keys(platform_key_id)`);
+    sql.exec(`CREATE INDEX idx_api_keys_replica_active ON api_keys(replica_active)`);
+    sql.exec(`
+      CREATE TABLE sessions (
+        id TEXT PRIMARY KEY NOT NULL,
+        user_id TEXT NOT NULL,
+        token_hash TEXT NOT NULL,
+        expires_at INTEGER NOT NULL,
+        created_at INTEGER DEFAULT (strftime('%s', 'now')),
+        FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+      )
+    `);
+    sql.exec(`INSERT INTO sessions SELECT * FROM sessions_0012_backup`);
+    sql.exec(`CREATE INDEX idx_sessions_token_hash ON sessions(token_hash)`);
+    sql.exec(`CREATE INDEX idx_sessions_user_id ON sessions(user_id)`);
+    sql.exec(`CREATE INDEX idx_sessions_expires_at ON sessions(expires_at)`);
+    sql.exec(`DROP TABLE oauth_accounts_0012_backup`);
+    sql.exec(`DROP TABLE api_keys_0012_backup`);
+    sql.exec(`DROP TABLE sessions_0012_backup`);
+    sql.exec(`
+      INSERT OR REPLACE INTO _metadata (key, value) VALUES ('schema_version', '12')
+    `);
+  }
+};
+
 // src/durable-objects/agentbuilder-migrations/index.ts
-var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45];
-var LATEST_SCHEMA_VERSION2 = 11;
+var migrations2 = [migration35, migration36, migration37, migration38, migration39, migration40, migration41, migration42, migration43, migration44, migration45, migration46];
+var LATEST_SCHEMA_VERSION2 = 12;
 
 // src/utils/crypto.ts
 var CryptoUtil = class {
@@ -31055,9 +31187,9 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     }
   }
   async runMigrations(fromVersion) {
-    for (const migration46 of migrations2) {
-      if (migration46.version > fromVersion) {
-        await migration46.up(this.ctx.storage.sql);
+    for (const migration47 of migrations2) {
+      if (migration47.version > fromVersion) {
+        await migration47.up(this.ctx.storage.sql);
       }
     }
   }
@@ -32412,7 +32544,7 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     return cursor.toArray().map((row) => ({
       id: row.id,
       username: row.username,
-      role: row.role === "user" ? "user" : "admin",
+      role: row.role === "user" ? "user" : row.role === "api" ? "api" : "admin",
       platform_user_id: row.platform_user_id ?? null,
       email: row.email ?? null,
       display_name: row.display_name ?? null,