agents 0.31.0 → 0.32.0

package/dist/index-iv9FTXX9.d.ts

@@ -1,311 +0,0 @@
-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/workspace.d.ts
-/**
- * The Workspace Agent Skills read and write: a `Workspace` from
- * `@cloudflare/computer`, or anything with the same `fs` methods.
- */
-interface SkillWorkspace {
-  readonly fs: {
-    stat(path: string): Promise<{
-      size: number;
-      isDirectory: boolean;
-    }>;
-    readFile(path: string): Promise<ReadableStream<Uint8Array>>;
-    writeFile(path: string, content: Uint8Array): Promise<void>;
-    mkdir(
-      path: string,
-      options?: {
-        recursive?: boolean;
-      }
-    ): Promise<void>;
-    readdir(path: string): Promise<
-      Array<{
-        name: string;
-        size: number;
-        isDirectory: boolean;
-      }>
-    >;
-    find(
-      directory: string,
-      pattern?: string
-    ): Promise<
-      Array<{
-        path: string;
-        type: "file" | "dir";
-      }>
-    >;
-  };
-}
-/** Options for projecting Agent Skills into a Workspace. */
-interface SkillWorkspaceSeedOptions {
-  /** Destination directory. Defaults to `/workspace/.agents/skills`. */
-  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/runner.d.ts
-/**
- * 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/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 a Workspace.
-   * Existing files are preserved by default, and become authoritative for
-   * activation, resource reads, and script execution.
-   */
-  seedWorkspace(
-    workspace: SkillWorkspace,
-    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: SkillWorkspace,
-    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 {
-  parseSkillFrontmatter as C,
-  SkillSource as S,
-  SkillResourceDescriptor as _,
-  SkillWorkspaceSeedOptions as a,
-  SkillScriptRequest as b,
-  r2 as c,
-  SkillDescriptor as d,
-  SkillManifest as f,
-  SkillResource as g,
-  SkillRegistrySnapshot as h,
-  SkillWorkspace as i,
-  fromManifest as l,
-  SkillManifestResource as m,
-  WorkerSkillScriptRunnerOptions as n,
-  SkillWorkspaceSeedResult as o,
-  SkillManifestEntry as p,
-  runner as r,
-  R2SkillSourceOptions as s,
-  SkillRegistry as t,
-  SkillContent as u,
-  SkillRunContext as v,
-  parseSkillMarkdown as w,
-  SkillScriptRunner as x,
-  SkillScriptContext as y
-};
-//# sourceMappingURL=index-iv9FTXX9.d.ts.map

package/dist/skills/compile.d.ts

@@ -1,40 +0,0 @@
-//#region src/skills/compile.d.ts
-interface CompiledSkillScript {
-  /** Self-contained ESM source, ready to embed and run without a bundler. */
-  content: string;
-  /** Always `true`; mirrors the `precompiled` flag on skill resources. */
-  precompiled: true;
-}
-interface CompileSkillScriptOptions {
-  /**
-   * JavaScript target for the emitted bundle. Defaults to `es2022`, which the
-   * Workers runtime supports.
-   */
-  target?: string;
-}
-/**
- * Whether a resource path is a skill script that should be compiled ahead of
- * time (i.e. has a `.js`, `.mjs`, `.ts`, or `.tsx` extension).
- */
-declare function isCompilableSkillScript(path: string): boolean;
-/**
- * Compile a skill script file into a single self-contained ESM module.
- *
- * Resolves and inlines sibling imports relative to `entryPath`, strips
- * TypeScript types, and emits ESM so the script can run in the Worker sandbox
- * without an in-Worker bundler.
- *
- * @param entryPath Absolute path to the skill script file on disk.
- */
-declare function compileSkillScript(
-  entryPath: string,
-  options?: CompileSkillScriptOptions
-): Promise<CompiledSkillScript>;
-//#endregion
-export {
-  CompileSkillScriptOptions,
-  CompiledSkillScript,
-  compileSkillScript,
-  isCompilableSkillScript
-};
-//# sourceMappingURL=compile.d.ts.map

package/dist/skills/compile.js

@@ -1,65 +0,0 @@
-import { build } from "esbuild";
-//#region src/skills/compile.ts
-/**
-* Build-time skill-script compiler.
-*
-* Skill scripts must be self-contained JavaScript modules before they can run:
-* the Worker runtime executes them directly through the sandbox and does **not**
-* ship an in-Worker bundler. This module compiles a skill script (TypeScript or
-* multi-file JavaScript) into a single self-contained ESM bundle using esbuild.
-*
-* It runs in Node (build time) only — the Agents Vite plugin uses it to compile
-* bundled skills, and skills served from R2 or other dynamic sources should be
-* compiled with {@link compileSkillScript} before upload.
-*
-* @module
-*/
-/** Skill-script extensions that can (and must) be compiled ahead of time. */
-const COMPILABLE_SCRIPT_EXTENSIONS = /* @__PURE__ */ new Set([
-	".js",
-	".mjs",
-	".ts",
-	".tsx"
-]);
-function extensionOf(path) {
-	const file = path.split("/").at(-1) ?? path;
-	const index = file.lastIndexOf(".");
-	return index === -1 ? "" : file.slice(index).toLowerCase();
-}
-/**
-* Whether a resource path is a skill script that should be compiled ahead of
-* time (i.e. has a `.js`, `.mjs`, `.ts`, or `.tsx` extension).
-*/
-function isCompilableSkillScript(path) {
-	return COMPILABLE_SCRIPT_EXTENSIONS.has(extensionOf(path));
-}
-/**
-* Compile a skill script file into a single self-contained ESM module.
-*
-* Resolves and inlines sibling imports relative to `entryPath`, strips
-* TypeScript types, and emits ESM so the script can run in the Worker sandbox
-* without an in-Worker bundler.
-*
-* @param entryPath Absolute path to the skill script file on disk.
-*/
-async function compileSkillScript(entryPath, options = {}) {
-	const output = (await build({
-		entryPoints: [entryPath],
-		bundle: true,
-		write: false,
-		format: "esm",
-		platform: "browser",
-		target: options.target ?? "es2022",
-		logLevel: "silent",
-		legalComments: "none"
-	})).outputFiles?.[0];
-	if (!output) throw new Error(`esbuild produced no output when compiling skill script "${entryPath}".`);
-	return {
-		content: output.text,
-		precompiled: true
-	};
-}
-//#endregion
-export { compileSkillScript, isCompilableSkillScript };
-
-//# sourceMappingURL=compile.js.map

package/dist/skills/compile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compile.js","names":[],"sources":["../../src/skills/compile.ts"],"sourcesContent":["import { build } from \"esbuild\";\n\n/**\n * Build-time skill-script compiler.\n *\n * Skill scripts must be self-contained JavaScript modules before they can run:\n * the Worker runtime executes them directly through the sandbox and does **not**\n * ship an in-Worker bundler. This module compiles a skill script (TypeScript or\n * multi-file JavaScript) into a single self-contained ESM bundle using esbuild.\n *\n * It runs in Node (build time) only — the Agents Vite plugin uses it to compile\n * bundled skills, and skills served from R2 or other dynamic sources should be\n * compiled with {@link compileSkillScript} before upload.\n *\n * @module\n */\n\n/** Skill-script extensions that can (and must) be compiled ahead of time. */\nconst COMPILABLE_SCRIPT_EXTENSIONS = new Set([\".js\", \".mjs\", \".ts\", \".tsx\"]);\n\nexport interface CompiledSkillScript {\n  /** Self-contained ESM source, ready to embed and run without a bundler. */\n  content: string;\n  /** Always `true`; mirrors the `precompiled` flag on skill resources. */\n  precompiled: true;\n}\n\nexport interface CompileSkillScriptOptions {\n  /**\n   * JavaScript target for the emitted bundle. Defaults to `es2022`, which the\n   * Workers runtime supports.\n   */\n  target?: string;\n}\n\nfunction extensionOf(path: string): string {\n  const file = path.split(\"/\").at(-1) ?? path;\n  const index = file.lastIndexOf(\".\");\n  return index === -1 ? \"\" : file.slice(index).toLowerCase();\n}\n\n/**\n * Whether a resource path is a skill script that should be compiled ahead of\n * time (i.e. has a `.js`, `.mjs`, `.ts`, or `.tsx` extension).\n */\nexport function isCompilableSkillScript(path: string): boolean {\n  return COMPILABLE_SCRIPT_EXTENSIONS.has(extensionOf(path));\n}\n\n/**\n * Compile a skill script file into a single self-contained ESM module.\n *\n * Resolves and inlines sibling imports relative to `entryPath`, strips\n * TypeScript types, and emits ESM so the script can run in the Worker sandbox\n * without an in-Worker bundler.\n *\n * @param entryPath Absolute path to the skill script file on disk.\n */\nexport async function compileSkillScript(\n  entryPath: string,\n  options: CompileSkillScriptOptions = {}\n): Promise<CompiledSkillScript> {\n  const result = await build({\n    entryPoints: [entryPath],\n    bundle: true,\n    write: false,\n    format: \"esm\",\n    platform: \"browser\",\n    target: options.target ?? \"es2022\",\n    logLevel: \"silent\",\n    legalComments: \"none\"\n  });\n\n  const output = result.outputFiles?.[0];\n  if (!output) {\n    throw new Error(\n      `esbuild produced no output when compiling skill script \"${entryPath}\".`\n    );\n  }\n\n  return { content: output.text, precompiled: true };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAM,+CAA+B,IAAI,IAAI;CAAC;CAAO;CAAQ;CAAO;AAAM,CAAC;AAiB3E,SAAS,YAAY,MAAsB;CACzC,MAAM,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK;CACvC,MAAM,QAAQ,KAAK,YAAY,GAAG;CAClC,OAAO,UAAU,KAAK,KAAK,KAAK,MAAM,KAAK,CAAC,CAAC,YAAY;AAC3D;;;;;AAMA,SAAgB,wBAAwB,MAAuB;CAC7D,OAAO,6BAA6B,IAAI,YAAY,IAAI,CAAC;AAC3D;;;;;;;;;;AAWA,eAAsB,mBACpB,WACA,UAAqC,CAAC,GACR;CAY9B,MAAM,UAAS,MAXM,MAAM;EACzB,aAAa,CAAC,SAAS;EACvB,QAAQ;EACR,OAAO;EACP,QAAQ;EACR,UAAU;EACV,QAAQ,QAAQ,UAAU;EAC1B,UAAU;EACV,eAAe;CACjB,CAAC,EAAA,CAEqB,cAAc;CACpC,IAAI,CAAC,QACH,MAAM,IAAI,MACR,2DAA2D,UAAU,GACvE;CAGF,OAAO;EAAE,SAAS,OAAO;EAAM,aAAa;CAAK;AACnD"}