agents 0.23.0 → 0.25.0

package/dist/index-kbSUIer3.d.ts

@@ -0,0 +1,343 @@
+import { ToolSet } from "ai";
+
+//#region src/skills/frontmatter.d.ts
+interface ParsedSkillMarkdown {
+  data: Record<string, unknown>;
+  body: string;
+}
+declare function parseSkillFrontmatter(raw: string): ParsedSkillMarkdown;
+declare function parseSkillMarkdown(raw: string): {
+  name: string;
+  description: string;
+  body: string;
+  compatibility?: string;
+  license?: string;
+  allowedTools?: string;
+  metadata?: Record<string, unknown>;
+} | null;
+//#endregion
+//#region src/skills/types.d.ts
+interface SkillDescriptor {
+  name: string;
+  description: string;
+  compatibility?: string;
+  license?: string;
+  allowedTools?: string;
+  metadata?: Record<string, unknown>;
+  sourceId?: string;
+  version?: string;
+}
+interface SkillContent extends SkillDescriptor {
+  body: string;
+  rawContent?: string;
+  resources?: SkillResourceDescriptor[];
+}
+interface SkillResourceDescriptor {
+  path: string;
+  kind: "reference" | "script" | "asset" | "file";
+  size?: number;
+  encoding?: "text" | "base64";
+  mimeType?: string;
+  /**
+   * Set when a script resource was compiled to a self-contained JavaScript
+   * module ahead of time — by the Agents Vite plugin for bundled skills, or via
+   * `compileSkillScript` from `agents/skills/compile` for R2/dynamic skills. The
+   * runtime runs precompiled scripts directly; the runtime ships no in-Worker
+   * bundler, so non-precompiled TypeScript or multi-file scripts cannot run.
+   */
+  precompiled?: boolean;
+}
+interface SkillResource extends SkillResourceDescriptor {
+  content: string;
+}
+interface SkillScriptContext {
+  skill: SkillDescriptor;
+}
+/**
+ * The `ctx` object passed as the second argument to function-style JS/TS
+ * skill scripts (`export default async function run(input, ctx)`).
+ *
+ * Capabilities are gated by the runner: `workspace` throws unless workspace
+ * access is enabled, and `tools` only resolves tools the runner was given.
+ */
+interface SkillRunContext {
+  /** Metadata for the skill that owns this script. */
+  skill: SkillDescriptor;
+  /** Text bundled resources by relative path (e.g. `references/style-guide.md`). */
+  files: Record<string, string>;
+  /** Workspace access, gated by the runner's `workspace` permission. */
+  workspace: {
+    readFile(path: string): Promise<string | null>;
+    listFiles(path?: string): Promise<unknown>;
+    glob(pattern: string): Promise<unknown>;
+    stat(path: string): Promise<{
+      type: string;
+      size: number;
+    } | null>;
+    writeFile(path: string, content: string): Promise<void>;
+  };
+  /** Explicitly granted tools: `tools.call(name, input)` or `tools.<name>(input)`. */
+  tools: {
+    call(name: string, input?: unknown): Promise<unknown>;
+  } & Record<string, (input?: unknown) => Promise<unknown>>;
+  /** Scratch artifacts returned to the model as `outputFiles`. */
+  output: {
+    writeFile(name: string, content: string): Promise<void>;
+  };
+}
+interface SkillScriptRequest {
+  skill: SkillContent;
+  path: string;
+  source: string;
+  input: unknown;
+  resources?: SkillResource[];
+}
+interface SkillScriptRunner {
+  run(request: SkillScriptRequest): Promise<unknown>;
+}
+interface SkillSource {
+  id: string;
+  fingerprint: string;
+  list(): Promise<SkillDescriptor[]>;
+  load(name: string): Promise<SkillContent | null>;
+  readResource?(name: string, path: string): Promise<SkillResource | null>;
+  refresh?(): Promise<void>;
+}
+interface SkillManifestResource extends SkillResourceDescriptor {
+  content: string;
+}
+interface SkillManifestEntry {
+  name: string;
+  description: string;
+  body: string;
+  rawContent?: string;
+  compatibility?: string;
+  license?: string;
+  allowedTools?: string;
+  metadata?: Record<string, unknown>;
+  version?: string;
+  resources?: SkillManifestResource[];
+}
+interface SkillManifest {
+  id: string;
+  fingerprint: string;
+  skills: SkillManifestEntry[];
+}
+interface SkillRegistrySnapshot {
+  fingerprint: string;
+  catalogPrompt: string | null;
+}
+//#endregion
+//#region src/skills/manifest.d.ts
+declare function fromManifest(manifest: SkillManifest): SkillSource;
+//#endregion
+//#region src/skills/r2.d.ts
+interface R2SkillSourceOptions {
+  prefix?: string;
+  skills?: string[];
+  id?: string;
+  fingerprint?: "metadata" | "content";
+  refreshIntervalMs?: number;
+}
+declare function r2(
+  bucket: R2Bucket,
+  options?: R2SkillSourceOptions
+): SkillSource;
+//#endregion
+//#region src/skills/runner.d.ts
+/**
+ * Minimal workspace surface the skill runner needs. A concrete `Workspace`
+ * from `@cloudflare/shell` (or Think's `WorkspaceLike`) satisfies this
+ * structurally, so the runner does not depend on a filesystem package.
+ */
+interface SkillWorkspace {
+  readFile(path: string): Promise<string | null>;
+  writeFile(path: string, content: string): Promise<void>;
+  readDir(path: string): Promise<unknown>;
+  glob(pattern: string): Promise<unknown>;
+  stat(path: string): Promise<{
+    type: string;
+    size?: number;
+  } | null>;
+}
+/**
+ * Options for {@link runner}.
+ *
+ * @experimental Skill script execution is experimental and the option shape
+ * may change before stabilizing.
+ */
+interface WorkerSkillScriptRunnerOptions {
+  loader: WorkerLoader;
+  timeout?: number;
+  network?: boolean;
+  workspace?: "none" | "read" | "read-write";
+  workspaceInstance?: SkillWorkspace;
+  tools?: ToolSet | (() => ToolSet | Promise<ToolSet>);
+}
+/**
+ * Create a skill script runner backed by a Worker Loader.
+ *
+ * Capabilities are opt-in and enforced by a single host bridge: no network and
+ * no tools by default, read-only workspace access when `workspaceInstance` is
+ * provided. JS/TS scripts are function-style (`export default run(input, ctx)`)
+ * and receive `ctx = { skill, files, workspace, tools, output }`. Python and
+ * Bash use the path-based `/skill`, `/input.json`, `/output` contract.
+ *
+ * @experimental Skill script execution is experimental and may change before
+ * stabilizing.
+ */
+declare function runner(
+  options: WorkerSkillScriptRunnerOptions
+): SkillScriptRunner;
+//#endregion
+//#region src/skills/workspace.d.ts
+/**
+ * Computer-style Workspace shape used for Agent Skills projection.
+ * `@cloudflare/computer.Workspace` satisfies this through `workspace.fs`.
+ */
+interface ComputerSkillWorkspace {
+  readonly fs: {
+    stat(path: string): Promise<unknown>;
+    readFile(
+      path: string,
+      options?: {
+        byteOffset?: number;
+        byteLength?: number;
+      }
+    ): Promise<ReadableStream<Uint8Array>>;
+    readFile(path: string, encoding: "utf8"): Promise<string>;
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    mkdir(
+      path: string,
+      options?: {
+        recursive?: boolean;
+      }
+    ): Promise<void>;
+  };
+}
+/**
+ * Legacy direct filesystem shape used for Agent Skills projection.
+ * `@cloudflare/shell.Workspace` and Think `WorkspaceLike` satisfy this shape.
+ */
+interface LegacySkillWorkspace {
+  stat(path: string): Promise<unknown | null>;
+  readFile(path: string): Promise<string | null>;
+  readFileBytes(path: string): Promise<Uint8Array | null>;
+  writeFile(path: string, content: string): Promise<void>;
+  writeFileBytes(
+    path: string,
+    content: Uint8Array | ArrayBuffer,
+    mediaType?: string
+  ): Promise<void>;
+  mkdir(
+    path: string,
+    options?: {
+      recursive?: boolean;
+    }
+  ): Promise<void>;
+}
+/** Workspace accepted by `SkillRegistry.seedWorkspace()`. */
+type SkillProjectionWorkspace = ComputerSkillWorkspace | LegacySkillWorkspace;
+/** Options for projecting Agent Skills into a Workspace. */
+interface SkillWorkspaceSeedOptions {
+  /**
+   * Destination directory. Defaults to `/workspace/.agents/skills` for a
+   * Computer Workspace and `/.agents/skills` for a legacy Shell Workspace.
+   */
+  readonly root?: string;
+  /** Existing-file policy. Default `"preserve"` keeps Workspace edits. */
+  readonly onConflict?: "preserve" | "replace";
+}
+/** Summary returned after projecting Agent Skills into a Workspace. */
+interface SkillWorkspaceSeedResult {
+  /** Files written from source content. */
+  readonly written: number;
+  /** Existing files preserved without a write. */
+  readonly preserved: number;
+  /** Files skipped because their source content could not be read or written. */
+  readonly skipped: number;
+  /** Non-fatal per-file diagnostics. */
+  readonly warnings: readonly string[];
+  /** Absolute Workspace directory containing the projected skills. */
+  readonly root: string;
+}
+//#endregion
+//#region src/skills/registry.d.ts
+declare class SkillRegistry {
+  readonly contextLabel = "think_skills";
+  /**
+   * Non-fatal diagnostics collected during the most recent {@link load} or
+   * {@link refresh} (duplicate skill names, sources that failed to list).
+   * Reset on every load so it never grows unbounded across refreshes.
+   */
+  readonly warnings: string[];
+  private sources;
+  private scriptRunner;
+  private descriptors;
+  private sourceBySkill;
+  private loaded;
+  private workspaceFiles;
+  private workspaceSkillNames;
+  private workspaceResources;
+  constructor(sources: SkillSource[], scriptRunner?: SkillScriptRunner | null);
+  get fingerprint(): string;
+  load(): Promise<void>;
+  refresh(): Promise<void>;
+  /**
+   * Seed resolved Agent Skills into Computer or legacy Shell storage.
+   * Existing files are preserved by default, and become authoritative for
+   * activation, resource reads, and script execution.
+   */
+  seedWorkspace(
+    workspace: SkillProjectionWorkspace,
+    options?: SkillWorkspaceSeedOptions
+  ): Promise<SkillWorkspaceSeedResult>;
+  /**
+   * Route skill reads through an already-seeded Workspace without probing or
+   * rewriting its files. Hosts use this when the durable source fingerprint
+   * matches the recorded projection fingerprint.
+   */
+  useWorkspace(
+    workspace: SkillProjectionWorkspace,
+    options?: SkillWorkspaceSeedOptions
+  ): Promise<void>;
+  private writeSeedFile;
+  snapshot(): Promise<SkillRegistrySnapshot>;
+  systemPrompt(): Promise<string | null>;
+  loadSkill(name: string): Promise<SkillContent | null>;
+  private resolveResourceTarget;
+  private readResource;
+  private readSkillResources;
+  tools(): ToolSet;
+}
+//#endregion
+export {
+  SkillScriptRequest as C,
+  parseSkillMarkdown as D,
+  parseSkillFrontmatter as E,
+  SkillScriptContext as S,
+  SkillSource as T,
+  SkillManifestResource as _,
+  SkillWorkspaceSeedOptions as a,
+  SkillResourceDescriptor as b,
+  WorkerSkillScriptRunnerOptions as c,
+  r2 as d,
+  fromManifest as f,
+  SkillManifestEntry as g,
+  SkillManifest as h,
+  SkillProjectionWorkspace as i,
+  runner as l,
+  SkillDescriptor as m,
+  ComputerSkillWorkspace as n,
+  SkillWorkspaceSeedResult as o,
+  SkillContent as p,
+  LegacySkillWorkspace as r,
+  SkillWorkspace as s,
+  SkillRegistry as t,
+  R2SkillSourceOptions as u,
+  SkillRegistrySnapshot as v,
+  SkillScriptRunner as w,
+  SkillRunContext as x,
+  SkillResource as y
+};
+//# sourceMappingURL=index-kbSUIer3.d.ts.map

package/dist/index.d.ts

@@ -1,48 +1,52 @@
 /// <reference path="../skills-module.d.ts" />
 import {
-  b as Connection,
-  w as WSMessage,
-  x as ConnectionContext
-} from "./capability-runner-Be_-PLR1.js";
+  S as ConnectionContext,
+  T as WSMessage,
+  x as Connection
+} from "./capability-runner-DBAnGr6L.js";
 import {
-  i as isDurableObjectStorageReset,
+  a as isDurableObjectStorageReset,
+  c as isPlatformTransientError,
   n as isDurableObjectCodeUpdateReset,
   r as isDurableObjectMemoryLimitReset,
-  s as isPlatformTransientError,
   t as RetryOptions
-} from "./retries-D9Ds-1lz.js";
-import { i as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-Da_C9a3b.js";
+} from "./retries-CV6AkXmQ.js";
+import { i as __DO_NOT_USE_WILL_BREAK__agentContext } from "./current-agent-vAk_5JMt.js";
 import {
   $ as ChatCapableAgentClass,
-  A as StreamingResponse,
-  An as routeSubAgentRequest,
-  At as MCPAITool,
+  A as getCurrentAgent,
+  An as getSubAgentByName,
   B as AgentToolFailure,
   C as MCPServersState,
-  Cn as SubAgentPathMatch,
-  D as StartFiberOptions,
-  E as RPCResponse,
-  F as AgentToolChildAdapter,
+  Cn as BuildAgentPathOptions,
+  D as StartFiberResult,
+  Dn as buildAgentUrl,
+  E as StartFiberOptions,
+  En as buildAgentPath,
+  F as AgentToolDisplayMetadata,
   G as AgentToolProgressSnapshot,
+  Gt as MCP_SERVER_ID_MAX_LENGTH,
   H as AgentToolLifecycleResult,
-  I as AgentToolDisplayMetadata,
+  I as AgentToolEvent,
   J as AgentToolRunPart,
+  Jt as normalizeServerId,
   K as AgentToolRunInfo,
-  Kt as normalizeServerId,
-  L as AgentToolEvent,
-  M as routeAgentEmail,
-  N as AGENT_TOOL_MILESTONE_PART,
-  O as StartFiberResult,
-  On as getSubAgentByName,
-  P as AGENT_TOOL_PROGRESS_PART,
+  L as AgentToolEventDelivery,
+  M as AGENT_TOOL_MILESTONE_PART,
+  Mn as routeSubAgentRequest,
+  Mt as MCPAITool,
+  N as AGENT_TOOL_PROGRESS_PART,
+  Nn as withInvocationScope,
+  Nt as MCPAIToolSet,
+  O as StateUpdateMessage,
+  P as AgentToolChildAdapter,
   Q as AgentToolTerminalStatus,
   R as AgentToolEventMessage,
   S as MCPServerMessage,
-  Sn as SUB_PREFIX,
-  T as RPCRequest,
-  Tn as buildAgentUrl,
+  Sn as AgentPathStep,
+  T as RPCResponse,
+  Tn as SubAgentPathMatch,
   U as AgentToolMilestone,
-  Ut as MCP_SERVER_ID_MAX_LENGTH,
   V as AgentToolInterruptedReason,
   W as AgentToolProgress,
   X as AgentToolRunStatus,
@@ -51,7 +55,7 @@ import {
   _ as FiberRecoveryContext,
   a as routeAgentRequest,
   b as ListFibersOptions,
-  bn as AgentPathStep,
+  bn as DynamicAgentClass,
   c as Agent,
   d as AgentStaticOptions,
   et as DetachedAgentToolConfig,
@@ -59,11 +63,9 @@ import {
   g as FiberInspection,
   h as FiberContext,
   i as getAgentByName,
-  j as getCurrentAgent,
-  jn as withInvocationScope,
-  jt as MCPAIToolSet,
-  k as StateUpdateMessage,
-  kn as parseSubAgentPath,
+  j as routeAgentEmail,
+  jn as parseSubAgentPath,
+  k as StreamingResponse,
   l as AgentContext,
   m as EmailRoutingOptions,
   n as AgentOptions,
@@ -78,15 +80,13 @@ import {
   tt as DetachedRunAgentToolResult,
   u as AgentNamespace,
   v as FiberRecoveryResult,
-  vn as DynamicAgentClass,
-  w as QueueItem,
-  wn as buildAgentPath,
+  w as RPCRequest,
+  wn as SUB_PREFIX,
   x as MCPServer,
-  xn as BuildAgentPathOptions,
+  xn as DynamicAgentStub,
   y as FiberStatus,
-  yn as DynamicAgentStub,
   z as AgentToolEventState
-} from "./agent-routing-DE5zmCQ8.js";
+} from "./agent-routing-0DR0Tk2v.js";
 import {
   a as EmailSendBinding,
   d as createHeaderBasedEmailResolver,
@@ -104,7 +104,8 @@ import {
   a as ScheduleCriteria,
   i as Schedule,
   o as ScheduleOptions
-} from "./scheduler-Dwh85ZGl.js";
+} from "./scheduler-RdACNXDP.js";
+import { i as QueueItem } from "./types-BA4anrjI.js";
 import {
   n as callable,
   s as unstable_callable,
@@ -127,6 +128,7 @@ export {
   type AgentToolChildAdapter,
   type AgentToolDisplayMetadata,
   type AgentToolEvent,
+  type AgentToolEventDelivery,
   type AgentToolEventMessage,
   type AgentToolEventState,
   type AgentToolFailure,
@@ -172,7 +174,7 @@ export {
   MCPServersState,
   MCP_SERVER_ID_MAX_LENGTH,
   MessageType,
-  QueueItem,
+  type QueueItem,
   RPCRequest,
   RPCResponse,
   type RetryOptions,

package/dist/index.js

@@ -7,9 +7,9 @@ import { MessageType } from "./types.js";
 import { createHeaderBasedEmailResolver } from "./email.js";
 import { n as withInvocationScope } from "./cloudflare-Dzvc7V2N.js";
 import { SUB_PREFIX, buildAgentPath, buildAgentUrl, getSubAgentByName, parseSubAgentPath, routeSubAgentRequest } from "./sub-routing.js";
-import { a as routeAgentEmail, i as getCurrentAgent, n as DEFAULT_AGENT_STATIC_OPTIONS, r as StreamingResponse, t as Agent } from "./src-DlSHshb2.js";
+import { a as routeAgentEmail, i as getCurrentAgent, n as DEFAULT_AGENT_STATIC_OPTIONS, r as StreamingResponse, t as Agent } from "./src-BZeu-SCD.js";
 import { isDurableObjectCodeUpdateReset, isDurableObjectMemoryLimitReset, isDurableObjectStorageReset, isPlatformTransientError } from "./retries.js";
 import { SqlError } from "./sql-error.js";
-import { i as normalizeServerId, n as MCP_SERVER_ID_MAX_LENGTH } from "./client-jagG8a9_.js";
+import { i as normalizeServerId, n as MCP_SERVER_ID_MAX_LENGTH } from "./client-fyQrLGkD.js";
 import { DurableObjectOAuthClientProvider } from "./mcp/client/do-oauth-client-provider.js";
 export { AGENT_TOOL_MILESTONE_PART, AGENT_TOOL_PROGRESS_PART, Agent, DEFAULT_AGENT_STATIC_OPTIONS, DurableObjectOAuthClientProvider, MCP_SERVER_ID_MAX_LENGTH, MessageType, SUB_PREFIX, SqlError, StreamingResponse, __DO_NOT_USE_WILL_BREAK__agentContext, withInvocationScope as __DO_NOT_USE_WILL_BREAK__withInvocationScope, buildAgentPath, buildAgentUrl, callable, camelCaseToKebabCase, createHeaderBasedEmailResolver, getAgentByName, getCurrentAgent, getSubAgentByName, isDurableObjectCodeUpdateReset, isDurableObjectMemoryLimitReset, isDurableObjectStorageReset, isPlatformTransientError, normalizeServerId, parseSubAgentPath, routeAgentEmail, routeAgentRequest, routeSubAgentRequest, unstable_callable };

package/dist/internal_context.d.ts

@@ -2,7 +2,7 @@ import {
   i as __DO_NOT_USE_WILL_BREAK__agentContext,
   n as CurrentAgentContext,
   t as AgentContextStore
-} from "./current-agent-Da_C9a3b.js";
+} from "./current-agent-vAk_5JMt.js";
 import { t as AgentEmail } from "./internal_context-BlxFEWfn.js";
 export {
   type AgentContextStore,

package/dist/lifecycle/index.d.ts

@@ -1,14 +1,15 @@
 import {
-  C as ConnectionState,
-  S as ConnectionSetStateFn,
-  _ as LifecycleJobOutcome,
+  C as ConnectionSetStateFn,
+  S as ConnectionContext,
+  T as WSMessage,
+  _ as LifecycleJobContext,
   a as LifecycleEvent,
-  b as Connection,
+  b as LifecycleJobs,
   c as LifecycleEvents,
   d as LifecycleRouteContext,
   f as LifecycleRoutes,
-  g as LifecycleJobContext,
-  h as LifecycleJob,
+  g as LifecycleJob,
+  h as LifecycleStatus,
   i as DurableObjectCapability,
   l as LifecycleHostContextScope,
   m as LifecycleSockets,
@@ -19,19 +20,20 @@ import {
   s as LifecycleCapability,
   t as CapabilityRequestContext,
   u as LifecycleRouteAddress,
-  v as LifecycleJobPushOptions,
-  w as WSMessage,
-  x as ConnectionContext,
-  y as LifecycleJobs
-} from "../capability-runner-Be_-PLR1.js";
+  v as LifecycleJobOutcome,
+  w as ConnectionState,
+  x as Connection,
+  y as LifecycleJobPushOptions
+} from "../capability-runner-DBAnGr6L.js";
+import {
+  n as LifecycleOptions,
+  t as Lifecycle
+} from "../durable-object-lifecycle-HhgOMWq9.js";
 import {
   a as getCurrentAgent,
-  l as LifecycleUseOptions,
   n as CurrentAgentContext,
-  o as Lifecycle,
-  r as LifecycleObject,
-  s as LifecycleOptions
-} from "../current-agent-Da_C9a3b.js";
+  r as LifecycleObject
+} from "../current-agent-vAk_5JMt.js";
 export {
   type CapabilityRequestContext,
   type CapabilityStartContext,
@@ -59,7 +61,7 @@ export {
   type LifecycleRoutes,
   type LifecycleServices,
   type LifecycleSockets,
-  type LifecycleUseOptions,
+  type LifecycleStatus,
   type MemoryLimitContext,
   type WSMessage,
   getCurrentAgent

package/dist/lifecycle/index.js

@@ -1,4 +1,4 @@
 import { n as getCurrentAgent } from "../current-agent-DhoDkSnH.js";
-import { t as LifecycleCapability } from "../capability-BjSKYpzg.js";
-import { t as Lifecycle } from "../lifecycle-CMRGjZdw.js";
+import { t as LifecycleCapability } from "../capability-B4WbF81e.js";
+import { t as Lifecycle } from "../lifecycle-CFu6OV03.js";
 export { Lifecycle, LifecycleCapability, getCurrentAgent };