@springbrand/agent-runtime 0.3.0-alpha.8 → 0.3.0-alpha.9

package/src/tools/web-search/index.ts

@@ -1,2 +0,0 @@
-export * from "./api";
-export * from "./web-search";

package/src/tools/workspace-state-connector.ts

@@ -1,146 +0,0 @@
-import { STATE_TYPES } from "@cloudflare/shell";
-import type { StateBackend } from "@cloudflare/shell/workers";
-import { StateConnector } from "@cloudflare/shell/workers";
-import type { ConnectorTools } from "@cloudflare/codemode";
-import type { WorkspacePort } from "../config/ports";
-
-export const WORKSPACE_DIRECT_TEXT_READ_MAX_BYTES = 1024 * 1024;
-
-const READ_FILE_PAGE_TYPES = `
-type WorkspaceFilePage =
-  | { kind: "text"; size: number; nextOffset: number | null; content: string }
-  | { kind: "csv"; size: number; nextOffset: number | null; columns: string[] | null; rows: string[][] };
-`;
-
-export const WORKSPACE_STATE_TYPES = `${READ_FILE_PAGE_TYPES}\n${STATE_TYPES.replace(
-  /\n\};$/u,
-  '\n  /** CSV pages have columns and rows; never data. Omit offset first, then pass nextOffset until null. */\n  readFilePage(args: { path: string; offset?: number }): Promise<WorkspaceFilePage | null>;\n};',
-)}`;
-
-export const WORKSPACE_PAGING_INSTRUCTIONS = `For CSV files, do not make a separate probe read or return page contents. Inspect columns and aggregate rows in the same execution with this loop shape:
-
-let page = await state.readFilePage({ path });
-if (!page || page.kind !== "csv") throw new Error("CSV not found");
-const columns = page.columns;
-for (;;) {
-  // Aggregate page.rows here. Do not return raw rows.
-  if (page.nextOffset === null) break;
-  page = await state.readFilePage({ path, offset: page.nextOffset });
-}
-return summary;
-
-CSV pages use page.columns and page.rows; never page.data or page.content. Only the first page has columns. Do not use console.log to inspect a page; explicitly return the final summary.`;
-
-type PagedWorkspacePort = WorkspacePort & {
-  readFilePage: NonNullable<WorkspacePort["readFilePage"]>;
-};
-
-export class WorkspaceStateConnector extends StateConnector {
-  constructor(
-    ctx: DurableObjectState | ExecutionContext,
-    backend: StateBackend,
-    private readonly workspace: PagedWorkspacePort,
-  ) {
-    super(ctx, backend);
-  }
-
-  protected override instructions(): string {
-    const base = super.instructions();
-    return `${base}
-
-${WORKSPACE_PAGING_INSTRUCTIONS}`;
-  }
-
-  protected override tools(): ConnectorTools {
-    const tools = super.tools();
-    const readFile = tools.readFile!;
-    return {
-      ...tools,
-      readFile: {
-        ...readFile,
-        description:
-          `${readFile.description} CSV and files over ${WORKSPACE_DIRECT_TEXT_READ_MAX_BYTES} bytes must use readFilePage.`,
-        execute: async (args, context) => {
-          const path = requiredPath(args, "readFile");
-          const file = await this.workspace.stat(path);
-          if (file?.type === "file" && (
-            file.mimeType === "text/csv" ||
-            file.size > WORKSPACE_DIRECT_TEXT_READ_MAX_BYTES
-          )) {
-            throw new Error(
-              `${path} requires state.readFilePage({ path: ${JSON.stringify(path)} }); continue with nextOffset until it is null`,
-            );
-          }
-          return readFile.execute(args, context);
-        },
-      },
-      readFilePage: {
-        description:
-          "Read up to 512 KiB or 2,000 CSV rows from a Workspace file. " +
-          "A CSV page returns columns and rows and has no data field; rows are string arrays aligned to columns. " +
-          "A text page returns content. Omit offset on the first call, then pass page.nextOffset until it is null. " +
-          "Prefer this over readFile for CSV and large files.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            path: { type: "string", minLength: 1, description: "Absolute Workspace file path." },
-            offset: {
-              type: "integer",
-              minimum: 0,
-              description: "Previous page.nextOffset. Omit on the first call.",
-            },
-          },
-          required: ["path"],
-          additionalProperties: false,
-        },
-        replay: "reexecute",
-        execute: (args) => {
-          const input = readFilePageInput(args);
-          return this.workspace.readFilePage(input.path, input.offset);
-        },
-      },
-    };
-  }
-
-  override async getTypeScriptTypes(): Promise<string> {
-    return WORKSPACE_STATE_TYPES;
-  }
-}
-
-function requiredPath(value: unknown, method: string): string {
-  if (!value || typeof value !== "object" || Array.isArray(value) ||
-      typeof (value as { path?: unknown }).path !== "string" ||
-      !(value as { path: string }).path) {
-    throw new Error(
-      `state.${method} takes one object argument: state.${method}({ path: "/path/to/file" })`,
-    );
-  }
-  return (value as { path: string }).path;
-}
-
-function readFilePageInput(value: unknown): {
-  path: string;
-  offset?: number;
-} {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error("state.readFilePage requires an object argument");
-  }
-  const input = value as Record<string, unknown>;
-  const keys = Object.keys(input);
-  if (keys.some((key) => !["path", "offset"].includes(key))) {
-    throw new Error("state.readFilePage accepts only path and offset");
-  }
-  if (typeof input.path !== "string" || input.path.length === 0) {
-    throw new Error("state.readFilePage requires path");
-  }
-  const offset = input.offset;
-  if (offset !== undefined && (!Number.isInteger(offset) || (offset as number) < 0)) {
-    throw new Error(
-      "state.readFilePage offset must be a previous page.nextOffset; omit it on the first call",
-    );
-  }
-  return {
-    path: input.path,
-    ...(offset === undefined ? {} : { offset: offset as number }),
-  };
-}

package/src/tools/{subagent-types → subagent/types}/registry.ts

@@ -1,6 +1,6 @@
 import { foldAgentTypes } from "./contract";
-import { fanout } from "./fanout";
 import { extract } from "./extract";
+import { fanout } from "./fanout";
 
 /**
  * 提供 Runtime 当前可用的子代理类型查找表。