agents 0.23.0 → 0.25.0

package/dist/skills/index.d.ts

@@ -1,316 +1,32 @@
-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
+import {
+  C as SkillScriptRequest,
+  D as parseSkillMarkdown,
+  E as parseSkillFrontmatter,
+  S as SkillScriptContext,
+  T as SkillSource,
+  _ as SkillManifestResource,
+  a as SkillWorkspaceSeedOptions,
+  b as SkillResourceDescriptor,
+  c as WorkerSkillScriptRunnerOptions,
+  d as r2,
+  f as fromManifest,
+  g as SkillManifestEntry,
+  h as SkillManifest,
+  i as SkillProjectionWorkspace,
+  l as runner,
+  m as SkillDescriptor,
+  n as ComputerSkillWorkspace,
+  o as SkillWorkspaceSeedResult,
+  p as SkillContent,
+  r as LegacySkillWorkspace,
+  s as SkillWorkspace,
+  t as SkillRegistry,
+  u as R2SkillSourceOptions,
+  v as SkillRegistrySnapshot,
+  w as SkillScriptRunner,
+  x as SkillRunContext,
+  y as SkillResource
+} from "../index-kbSUIer3.js";
 export {
   type ComputerSkillWorkspace,
   type LegacySkillWorkspace,
@@ -340,4 +56,3 @@ export {
   r2,
   runner
 };
-//# sourceMappingURL=index.d.ts.map

package/dist/socket-address.d.ts

@@ -0,0 +1,16 @@
+//#region src/socket-address.d.ts
+/**
+ * Set by `useAgent` on the socket it returns: `true` while the hook's options
+ * address a different agent than the socket it is still holding.
+ * `usePartySocket` replaces the socket in an effect, so for at least one
+ * render after `name` (or the host, path, or sub-agent chain) changes the
+ * returned socket still points at the previous agent, with the previous
+ * credentials in its URL.
+ *
+ * A registered symbol, so a separately bundled `useAgentChat` still sees it.
+ */
+declare const SOCKET_ADDRESS_PENDING: unique symbol;
+declare function isSocketAddressPending(socket: object): boolean;
+//#endregion
+export { SOCKET_ADDRESS_PENDING, isSocketAddressPending };
+//# sourceMappingURL=socket-address.d.ts.map

package/dist/socket-address.js

@@ -0,0 +1,19 @@
+//#region src/socket-address.ts
+/**
+* Set by `useAgent` on the socket it returns: `true` while the hook's options
+* address a different agent than the socket it is still holding.
+* `usePartySocket` replaces the socket in an effect, so for at least one
+* render after `name` (or the host, path, or sub-agent chain) changes the
+* returned socket still points at the previous agent, with the previous
+* credentials in its URL.
+*
+* A registered symbol, so a separately bundled `useAgentChat` still sees it.
+*/
+const SOCKET_ADDRESS_PENDING = Symbol.for("cloudflare.agents.socketAddressPending");
+function isSocketAddressPending(socket) {
+	return socket[SOCKET_ADDRESS_PENDING] === true;
+}
+//#endregion
+export { SOCKET_ADDRESS_PENDING, isSocketAddressPending };
+
+//# sourceMappingURL=socket-address.js.map

package/dist/socket-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-address.js","names":[],"sources":["../src/socket-address.ts"],"sourcesContent":["/**\n * Set by `useAgent` on the socket it returns: `true` while the hook's options\n * address a different agent than the socket it is still holding.\n * `usePartySocket` replaces the socket in an effect, so for at least one\n * render after `name` (or the host, path, or sub-agent chain) changes the\n * returned socket still points at the previous agent, with the previous\n * credentials in its URL.\n *\n * A registered symbol, so a separately bundled `useAgentChat` still sees it.\n */\nexport const SOCKET_ADDRESS_PENDING: unique symbol = Symbol.for(\n  \"cloudflare.agents.socketAddressPending\"\n);\n\nexport function isSocketAddressPending(socket: object): boolean {\n  return (\n    (socket as { [SOCKET_ADDRESS_PENDING]?: boolean })[\n      SOCKET_ADDRESS_PENDING\n    ] === true\n  );\n}\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,yBAAwC,OAAO,IAC1D,wCACF;AAEA,SAAgB,uBAAuB,QAAyB;CAC9D,OACG,OACC,4BACI;AAEV"}