@standardagents/builder 0.20.1 → 0.21.1

package/dist/runtime.d.ts

@@ -1,5 +1,5 @@
-import { e as ThreadEnv, h as ThreadMetadata, M as Message, l as FileRecord, F as FlowState, n as FileStats, G as GrepResult, m as AttachmentRef, r as MessageContent, E as Env, g as ThreadInstance } from './index-Bug9ATQX.js';
-export { A as Agent, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, j as FlowResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-Bug9ATQX.js';
+import { e as ThreadEnv, h as ThreadMetadata, M as Message, l as FileRecord, F as FlowState, n as FileStats, G as GrepResult, m as AttachmentRef, r as MessageContent, E as Env, g as ThreadInstance } from './index-CpuS9hHJ.js';
+export { A as Agent, f as BuilderThreadEndpointHandler, B as Controller, a as ControllerContext, j as FlowResult, p as ImageContentPart, I as ImageMetadata, L as LLMResponse, q as MultimodalContent, R as RequestContext, S as StorageBackend, k as TelemetryEvent, o as TextContentPart, b as ThreadEndpointContext, T as ToolCall, i as ToolResult, c as createThreadEndpointHandler, d as defineController } from './index-CpuS9hHJ.js';
 import { CodeExecutionOptions, CodeExecutionResult, SubagentRegistryEntry, InjectMessageInput, QueueMessageInput, 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, 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';
@@ -1140,6 +1140,31 @@ declare class DurableThread<Env extends ThreadEnv = ThreadEnv> extends DurableOb
         success: boolean;
         error: any;
     }>;
+    /**
+     * Move or rename a file or directory (RPC method).
+     * Relocates inline files, chunked files, and whole directory subtrees.
+     */
+    moveFile(sourcePath: string, destinationPath: string): Promise<{
+        success: boolean;
+        file: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+        file?: undefined;
+    }>;
+    /**
+     * Rename a file or directory in place (RPC method).
+     */
+    renameFile(path: string, newName: string): Promise<{
+        success: boolean;
+        file: any;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error: any;
+        file?: undefined;
+    }>;
     /**
      * Get file storage statistics (RPC method)
      */
@@ -1489,6 +1514,15 @@ declare class DurableAgentBuilder<Env extends AgentBuilderEnv = AgentBuilderEnv>
      * Delete a thread from the registry.
      */
     deleteThread(id: string): Promise<boolean>;
+    /**
+     * Delete all singleton AgentBuilder storage for platform-owned teardown.
+     * Used when the hosting platform expires a preview branch deployment after
+     * all thread Durable Objects have already been wiped.
+     */
+    deleteAllStorage(): Promise<{
+        success: boolean;
+        message: string;
+    }>;
     /**
      * Get a thread tree (root + all descendants) in child-first order.
      *
@@ -2573,6 +2607,42 @@ declare function readdir(flow: FlowState, path: string): Promise<FileRecord[]>;
  * ```
  */
 declare function rmdir(flow: FlowState, path: string): Promise<void>;
+/**
+ * Move or rename a file or directory to a new path.
+ *
+ * Works for files (inline or chunked) and directories (the whole subtree is
+ * relocated). The destination must not already exist.
+ *
+ * @param flow - The current FlowState
+ * @param sourcePath - Existing file or directory path
+ * @param destinationPath - New path
+ * @returns The moved file record at its new path
+ *
+ * @example
+ * ```typescript
+ * import { move } from '@standardagents/builder';
+ *
+ * await move(flow, "/drafts/post.md", "/published/post.md");
+ * await move(flow, "/tmp/work", "/archive/2024/work");
+ * ```
+ */
+declare function move(flow: FlowState, sourcePath: string, destinationPath: string): Promise<FileRecord>;
+/**
+ * Rename a file or directory in place, keeping it in the same directory.
+ *
+ * @param flow - The current FlowState
+ * @param path - Existing file or directory path
+ * @param newName - New name (must not contain path separators)
+ * @returns The renamed file record at its new path
+ *
+ * @example
+ * ```typescript
+ * import { rename } from '@standardagents/builder';
+ *
+ * await rename(flow, "/notes/draft.txt", "final.txt");
+ * ```
+ */
+declare function rename(flow: FlowState, path: string, newName: string): Promise<FileRecord>;
 /**
  * Get file storage statistics
  *
@@ -3213,4 +3283,4 @@ declare function createNamespaceContext(agentDef: {
  */
 declare function isQualifiedName(name: string): boolean;
 
-export { type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, Env, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, GrepResult, type ImageContextConfig, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, Message, MessageContent, type ModelDefinition, NamespaceResolutionError, NamespacedRegistry, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type PromptToolConfig, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, ProviderRegistry, type ProviderTextPart, type SessionToolBinding, type SessionToolConfig, type SideConfig, type SubagentToolConfig, type SubpromptConfig, ThreadEnv, ThreadInstance, ThreadMetadata, type ThreadRegistryEntry, type ToolConfig, type UpdateThreadParams, type User, 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, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+export { type AgentBuilderEnv, type AgentDefinition, AttachmentRef, type AuthContext, type AuthUser, type BroadcastOptions, CodeExecutionBridge, DurableAgentBuilder, DurableThread, Env, FileRecord, FileStats, FlowState, FlowStateSdk, type FlowStateWithSdk, GrepResult, type ImageContextConfig, type InjectMessageOptions$1 as InjectMessageOptions, type Provider as LLMProviderInterface, Message, MessageContent, type ModelDefinition, NamespaceResolutionError, NamespacedRegistry, type PromptContent, type PromptDefinition, type PromptIncludePart, type PromptPart, type PromptToolConfig, type Provider$1 as Provider, type ProviderContentPart, type ProviderFilePart, type ProviderImagePart, ProviderRegistry, type ProviderTextPart, type SessionToolBinding, type SessionToolConfig, type SideConfig, type SubagentToolConfig, type SubpromptConfig, ThreadEnv, ThreadInstance, ThreadMetadata, type ThreadRegistryEntry, type ToolConfig, type UpdateThreadParams, type User, 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 };

package/dist/runtime.js

@@ -2504,7 +2504,9 @@ __export(files_exports, {
   dirname: () => dirname,
   isTextMimeType: () => isTextMimeType,
   normalizePath: () => normalizePath,
-  rowToFileRecord: () => rowToFileRecord
+  resolveRenameDestination: () => resolveRenameDestination,
+  rowToFileRecord: () => rowToFileRecord,
+  validateMovePaths: () => validateMovePaths
 });
 function isTextMimeType(mimeType) {
   if (mimeType.startsWith("text/")) return true;
@@ -2537,6 +2539,33 @@ function dirname(path) {
   if (lastSlash <= 0) return "/";
   return normalized.slice(0, lastSlash);
 }
+function validateMovePaths(source, destination, isDirectory) {
+  if (source === "/") {
+    throw new Error("Cannot move the root directory");
+  }
+  if (destination === "/") {
+    throw new Error("Cannot move over the root directory");
+  }
+  if (isDirectory && destination.startsWith(source + "/")) {
+    throw new Error(
+      "Cannot move a directory into itself or one of its descendants"
+    );
+  }
+}
+function resolveRenameDestination(path, newName) {
+  if (typeof newName !== "string" || newName.length === 0) {
+    throw new Error("New name must be a non-empty string");
+  }
+  if (newName.includes("/")) {
+    throw new Error("New name must not contain path separators");
+  }
+  if (newName === "." || newName === "..") {
+    throw new Error("New name must not be '.' or '..'");
+  }
+  const normalized = normalizePath(path);
+  const parent = dirname(normalized);
+  return parent === "/" ? `/${newName}` : `${parent}/${newName}`;
+}
 function rowToFileRecord(row) {
   return {
     path: row.path,
@@ -3013,6 +3042,94 @@ var init_files = __esm({
           normalizedPath
         );
       }
+      /**
+       * Move (or rename) a file or directory from one path to another.
+       *
+       * Works for inline files, chunked files, and directories. Moving a
+       * directory relocates the directory marker and every descendant entry,
+       * preserving their relative layout. The destination must not already
+       * exist, and a directory cannot be moved into itself or one of its own
+       * descendants.
+       *
+       * Implementation note: the `file_chunks` table has a foreign key on
+       * `files(path)` with `ON DELETE CASCADE`, and there is no `ON UPDATE`
+       * action. To keep referential integrity intact (foreign key enforcement
+       * is on in Durable Object SQLite), we copy the affected rows to their new
+       * paths first, then delete the originals — the cascade removes the old
+       * chunks, while the freshly copied chunks already point at the new file
+       * rows. This never leaves an orphaned chunk mid-operation.
+       */
+      async move(sourcePath, destinationPath) {
+        const source = normalizePath(sourcePath);
+        const destination = normalizePath(destinationPath);
+        if (source === destination) {
+          const existing = await this.stat(source);
+          if (!existing) {
+            throw new Error(`Source path does not exist: ${source}`);
+          }
+          return existing;
+        }
+        const record = await this.stat(source);
+        if (!record) {
+          throw new Error(`Source path does not exist: ${source}`);
+        }
+        validateMovePaths(source, destination, record.isDirectory);
+        const destPrefix = destination + "/";
+        const collision = await this.sql.exec(
+          `SELECT COUNT(*) as count FROM files WHERE path = ? OR path LIKE ? || '%'`,
+          destination,
+          destPrefix
+        );
+        if (collision.one().count > 0) {
+          throw new Error(`Destination already exists: ${destination}`);
+        }
+        const sourcePrefix = source + "/";
+        const sourceLen = source.length;
+        const destName = basename(destination);
+        await this.sql.exec(
+          `INSERT INTO files (path, name, mime_type, storage, location, data, content, size, metadata, thumbnail, is_directory, created_at, width, height, is_chunked, chunk_count)
+       SELECT ? || SUBSTR(path, ? + 1), name, mime_type, storage, location, data, content, size, metadata, thumbnail, is_directory, created_at, width, height, is_chunked, chunk_count
+       FROM files
+       WHERE path = ? OR path LIKE ? || '%'`,
+          destination,
+          sourceLen,
+          source,
+          sourcePrefix
+        );
+        await this.sql.exec(
+          `INSERT INTO file_chunks (file_path, chunk_index, data)
+       SELECT ? || SUBSTR(file_path, ? + 1), chunk_index, data
+       FROM file_chunks
+       WHERE file_path = ? OR file_path LIKE ? || '%'`,
+          destination,
+          sourceLen,
+          source,
+          sourcePrefix
+        );
+        await this.sql.exec(
+          `DELETE FROM files WHERE path = ? OR path LIKE ? || '%'`,
+          source,
+          sourcePrefix
+        );
+        await this.sql.exec(
+          `UPDATE files SET name = ? WHERE path = ?`,
+          destName,
+          destination
+        );
+        const moved = await this.stat(destination);
+        if (!moved) {
+          throw new Error(`Failed to move ${source} to ${destination}`);
+        }
+        return moved;
+      }
+      /**
+       * Rename a file or directory in place, keeping it in the same parent
+       * directory. `newName` must be a bare file name with no path separators.
+       */
+      async rename(path, newName) {
+        const destination = resolveRenameDestination(path, newName);
+        return this.move(normalizePath(path), destination);
+      }
       /**
        * Get storage statistics
        */
@@ -9855,6 +9972,22 @@ async function rmdir(flow, path) {
     throw new Error(result.error || "Failed to remove directory");
   }
 }
+async function move(flow, sourcePath, destinationPath) {
+  const instance = flow.thread.instance;
+  const result = await instance.moveFile(sourcePath, destinationPath);
+  if (!result.success) {
+    throw new Error(result.error || "Failed to move file");
+  }
+  return result.file;
+}
+async function rename(flow, path, newName) {
+  const instance = flow.thread.instance;
+  const result = await instance.renameFile(path, newName);
+  if (!result.success) {
+    throw new Error(result.error || "Failed to rename file");
+  }
+  return result.file;
+}
 async function getFileStats(flow) {
   const instance = flow.thread.instance;
   const result = await instance.getFileStats();
@@ -12480,6 +12613,20 @@ var init_ThreadStateImpl = __esm({
       async rmdirFile(path) {
         await this._threadInstance.rmdirFile(path);
       }
+      async moveFile(sourcePath, destinationPath) {
+        const result = await this._threadInstance.moveFile(sourcePath, destinationPath);
+        if (!result.success || !result.file) {
+          throw new Error(result.error || "Failed to move file");
+        }
+        return this._mapFileRecord(result.file);
+      }
+      async renameFile(path, newName) {
+        const result = await this._threadInstance.renameFile(path, newName);
+        if (!result.success || !result.file) {
+          throw new Error(result.error || "Failed to rename file");
+        }
+        return this._mapFileRecord(result.file);
+      }
       async getFileStats() {
         const stats = await this._threadInstance.getFileStats();
         return {
@@ -14769,6 +14916,11 @@ function createEndpointThreadStateBridge(state) {
     unlinkFile: (path) => state.unlinkFile(normalizeEndpointThreadPath(path)),
     mkdirFile: (path) => state.mkdirFile(normalizeEndpointThreadPath(path)),
     rmdirFile: (path) => state.rmdirFile(normalizeEndpointThreadPath(path)),
+    moveFile: (sourcePath, destinationPath) => state.moveFile(
+      normalizeEndpointThreadPath(sourcePath),
+      normalizeEndpointThreadPath(destinationPath)
+    ),
+    renameFile: (path, newName) => state.renameFile(normalizeEndpointThreadPath(path), newName),
     getFileStats: () => state.getFileStats(),
     grepFiles: (pattern) => state.grepFiles(pattern),
     findFiles: (pattern) => state.findFiles(pattern),
@@ -18888,6 +19040,43 @@ ${resultContent}${attachmentSummary}`;
       return { success: false, error: error.message };
     }
   }
+  /**
+   * Move or rename a file or directory (RPC method).
+   * Relocates inline files, chunked files, and whole directory subtrees.
+   */
+  async moveFile(sourcePath, destinationPath) {
+    await this.ensureMigrated();
+    try {
+      const { normalizePath: normalizePath2 } = await Promise.resolve().then(() => (init_files(), files_exports));
+      const fs = this.getFileStorage();
+      const from = normalizePath2(sourcePath);
+      const record = await fs.move(sourcePath, destinationPath);
+      this.broadcastEvent("file_deleted", { path: from });
+      this.broadcastEvent("file_created", { path: record.path, file: record });
+      return { success: true, file: record };
+    } catch (error) {
+      console.error("Error in moveFile:", error);
+      return { success: false, error: error.message };
+    }
+  }
+  /**
+   * Rename a file or directory in place (RPC method).
+   */
+  async renameFile(path, newName) {
+    await this.ensureMigrated();
+    try {
+      const { normalizePath: normalizePath2 } = await Promise.resolve().then(() => (init_files(), files_exports));
+      const fs = this.getFileStorage();
+      const from = normalizePath2(path);
+      const record = await fs.rename(path, newName);
+      this.broadcastEvent("file_deleted", { path: from });
+      this.broadcastEvent("file_created", { path: record.path, file: record });
+      return { success: true, file: record };
+    } catch (error) {
+      console.error("Error in renameFile:", error);
+      return { success: false, error: error.message };
+    }
+  }
   /**
    * Get file storage statistics (RPC method)
    */
@@ -20235,6 +20424,24 @@ ${result ?? error ?? "No result content."}${attachmentSummary}`;
     this.broadcastEvent({ type: "thread_deleted", threadId: id });
     return true;
   }
+  /**
+   * Delete all singleton AgentBuilder storage for platform-owned teardown.
+   * Used when the hosting platform expires a preview branch deployment after
+   * all thread Durable Objects have already been wiped.
+   */
+  async deleteAllStorage() {
+    for (const ws of Array.from(this.eventSockets)) {
+      try {
+        ws.close(1e3, "Instance deleted");
+      } catch {
+      }
+    }
+    this.eventSockets.clear();
+    await this.ctx.storage.deleteAlarm();
+    await this.ctx.storage.deleteAll();
+    this.migratedToVersion = null;
+    return { success: true, message: "AgentBuilder storage completely deleted" };
+  }
   /**
    * Get a thread tree (root + all descendants) in child-first order.
    *
@@ -22214,6 +22421,6 @@ init_context();
 init_ProviderRegistry();
 init_types2();
 
-export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, FlowStateSdk, NamespaceResolutionError, ProviderRegistry, authenticate, buildImageDescription, cat, createNamespaceContext, createThreadEndpointHandler, defineController2 as defineController, emitThreadEvent, enhanceFlowState, exists, find, forceTurn, generateImageDescription, getFileStats, getMessages, getMessagesToSummarize, getShortName, getThumbnail, getUnsummarizedImageAttachments, getVisibleAgentNames, getVisibleModelNames, getVisiblePromptNames, getVisibleToolNames, grep, hasImageAttachments, head, injectMessage, isQualifiedName, linkFile, mkdir, optimizeImageContext, parseQualifiedName, qualifyName, queueTool, readFile, readdir, reloadHistory, replaceImagesWithDescriptions, requireAdmin, requireAuth, resolveAgent, resolveHook, resolveModel, resolvePrompt, resolveTool, rmdir, stat, tail, unlink, updateThread, writeFile, writeImage };
+export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, FlowStateSdk, NamespaceResolutionError, ProviderRegistry, authenticate, buildImageDescription, cat, createNamespaceContext, createThreadEndpointHandler, defineController2 as defineController, 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 };
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map