experimental-agent 0.7.1 → 0.8.0-alpha.2

package/dist/chunk-LMYEJDMD.mjs

@@ -0,0 +1,123 @@
+// package.json
+var package_default = {
+  name: "experimental-agent",
+  version: "0.8.0-alpha.1",
+  main: "./dist/index.js",
+  module: "./dist/index.mjs",
+  types: "./dist/index.d.ts",
+  sideEffects: true,
+  license: "MIT",
+  files: [
+    "dist/**"
+  ],
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.mjs",
+      require: "./dist/index.js"
+    },
+    "./storage": {
+      types: "./dist/storage.d.ts",
+      import: "./dist/storage.mjs",
+      require: "./dist/storage.js"
+    },
+    "./sandbox": {
+      types: "./dist/sandbox.d.ts",
+      import: "./dist/sandbox.mjs",
+      require: "./dist/sandbox.js"
+    },
+    "./next": {
+      types: "./dist/next.d.ts",
+      import: "./dist/next.mjs",
+      require: "./dist/next.js"
+    },
+    "./next/loader": {
+      types: "./dist/next/loader.d.ts",
+      import: "./dist/next/loader.mjs",
+      require: "./dist/next/loader.js"
+    },
+    "./next/agents": {
+      types: "./dist/next/agents.d.ts",
+      import: "./dist/next/agents.mjs",
+      require: "./dist/next/agents.js"
+    },
+    "./framework": {
+      types: "./dist/framework.d.ts",
+      import: "./dist/framework.mjs",
+      require: "./dist/framework.js"
+    },
+    "./framework-runtime": {
+      types: "./dist/framework-runtime.d.ts",
+      import: "./dist/framework-runtime.mjs",
+      require: "./dist/framework-runtime.js"
+    },
+    "./client": {
+      types: "./dist/client.d.ts",
+      import: "./dist/client.mjs",
+      require: "./dist/client.js"
+    },
+    "./lifecycle-workflow": {
+      types: "./dist/lifecycle-workflow.d.ts",
+      import: "./dist/lifecycle-workflow.mjs",
+      require: "./dist/lifecycle-workflow.js"
+    },
+    "./lifecycle-workflow-steps": {
+      types: "./dist/lifecycle-workflow-steps.d.ts",
+      import: "./dist/lifecycle-workflow-steps.mjs",
+      require: "./dist/lifecycle-workflow-steps.js"
+    },
+    "./react": {
+      types: "./dist/react.d.ts",
+      import: "./dist/react.mjs",
+      require: "./dist/react.js"
+    }
+  },
+  scripts: {
+    build: "tsup",
+    dev: "tsup --watch",
+    clean: "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    release: "pnpm build && npm publish",
+    typecheck: "tsc --noEmit",
+    test: "vitest run",
+    "test:watch": "vitest"
+  },
+  dependencies: {
+    "@elysiajs/openapi": "^1.4.14",
+    "@swc/core": "^1.10.0",
+    "@tanstack/react-query": "^5.90.21",
+    "@vercel/kv2": "^0.0.18",
+    "@vercel/oidc": "^3.1.0",
+    "@vercel/sandbox": "1.7.1",
+    "@workflow/serde": "4.1.0-beta.2",
+    "better-all": "^0.0.5",
+    elysia: "^1.4.25",
+    errore: "^0.14.0",
+    "fast-deep-equal": "^3.1.3",
+    ulid: "^3.0.2",
+    zod: "^4.3.6"
+  },
+  devDependencies: {
+    "@agent/tsconfig": "workspace:*",
+    "@ai-sdk/react": "^3.0.88",
+    "@types/node": "^20.11.24",
+    "@types/react": "^19.2.14",
+    dotenv: "^17.2.3",
+    next: "^16.0.0",
+    react: "^19.2.4",
+    tsup: "^8.0.2",
+    typescript: "5.5.4",
+    vitest: "^3.0.0",
+    workflow: "4.2.0-beta.70"
+  },
+  peerDependencies: {
+    ai: "^6.0.0"
+  },
+  publishConfig: {
+    access: "public"
+  }
+};
+
+export {
+  package_default
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vcGFja2FnZS5qc29uIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyJ7XG4gIFwibmFtZVwiOiBcImV4cGVyaW1lbnRhbC1hZ2VudFwiLFxuICBcInZlcnNpb25cIjogXCIwLjguMC1hbHBoYS4xXCIsXG4gIFwibWFpblwiOiBcIi4vZGlzdC9pbmRleC5qc1wiLFxuICBcIm1vZHVsZVwiOiBcIi4vZGlzdC9pbmRleC5tanNcIixcbiAgXCJ0eXBlc1wiOiBcIi4vZGlzdC9pbmRleC5kLnRzXCIsXG4gIFwic2lkZUVmZmVjdHNcIjogdHJ1ZSxcbiAgXCJsaWNlbnNlXCI6IFwiTUlUXCIsXG4gIFwiZmlsZXNcIjogW1xuICAgIFwiZGlzdC8qKlwiXG4gIF0sXG4gIFwiZXhwb3J0c1wiOiB7XG4gICAgXCIuXCI6IHtcbiAgICAgIFwidHlwZXNcIjogXCIuL2Rpc3QvaW5kZXguZC50c1wiLFxuICAgICAgXCJpbXBvcnRcIjogXCIuL2Rpc3QvaW5kZXgubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3QvaW5kZXguanNcIlxuICAgIH0sXG4gICAgXCIuL3N0b3JhZ2VcIjoge1xuICAgICAgXCJ0eXBlc1wiOiBcIi4vZGlzdC9zdG9yYWdlLmQudHNcIixcbiAgICAgIFwiaW1wb3J0XCI6IFwiLi9kaXN0L3N0b3JhZ2UubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3Qvc3RvcmFnZS5qc1wiXG4gICAgfSxcbiAgICBcIi4vc2FuZGJveFwiOiB7XG4gICAgICBcInR5cGVzXCI6IFwiLi9kaXN0L3NhbmRib3guZC50c1wiLFxuICAgICAgXCJpbXBvcnRcIjogXCIuL2Rpc3Qvc2FuZGJveC5tanNcIixcbiAgICAgIFwicmVxdWlyZVwiOiBcIi4vZGlzdC9zYW5kYm94LmpzXCJcbiAgICB9LFxuICAgIFwiLi9uZXh0XCI6IHtcbiAgICAgIFwidHlwZXNcIjogXCIuL2Rpc3QvbmV4dC5kLnRzXCIsXG4gICAgICBcImltcG9ydFwiOiBcIi4vZGlzdC9uZXh0Lm1qc1wiLFxuICAgICAgXCJyZXF1aXJlXCI6IFwiLi9kaXN0L25leHQuanNcIlxuICAgIH0sXG4gICAgXCIuL25leHQvbG9hZGVyXCI6IHtcbiAgICAgIFwidHlwZXNcIjogXCIuL2Rpc3QvbmV4dC9sb2FkZXIuZC50c1wiLFxuICAgICAgXCJpbXBvcnRcIjogXCIuL2Rpc3QvbmV4dC9sb2FkZXIubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3QvbmV4dC9sb2FkZXIuanNcIlxuICAgIH0sXG4gICAgXCIuL25leHQvYWdlbnRzXCI6IHtcbiAgICAgIFwidHlwZXNcIjogXCIuL2Rpc3QvbmV4dC9hZ2VudHMuZC50c1wiLFxuICAgICAgXCJpbXBvcnRcIjogXCIuL2Rpc3QvbmV4dC9hZ2VudHMubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3QvbmV4dC9hZ2VudHMuanNcIlxuICAgIH0sXG4gICAgXCIuL2ZyYW1ld29ya1wiOiB7XG4gICAgICBcInR5cGVzXCI6IFwiLi9kaXN0L2ZyYW1ld29yay5kLnRzXCIsXG4gICAgICBcImltcG9ydFwiOiBcIi4vZGlzdC9mcmFtZXdvcmsubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3QvZnJhbWV3b3JrLmpzXCJcbiAgICB9LFxuICAgIFwiLi9mcmFtZXdvcmstcnVudGltZVwiOiB7XG4gICAgICBcInR5cGVzXCI6IFwiLi9kaXN0L2ZyYW1ld29yay1ydW50aW1lLmQudHNcIixcbiAgICAgIFwiaW1wb3J0XCI6IFwiLi9kaXN0L2ZyYW1ld29yay1ydW50aW1lLm1qc1wiLFxuICAgICAgXCJyZXF1aXJlXCI6IFwiLi9kaXN0L2ZyYW1ld29yay1ydW50aW1lLmpzXCJcbiAgICB9LFxuICAgIFwiLi9jbGllbnRcIjoge1xuICAgICAgXCJ0eXBlc1wiOiBcIi4vZGlzdC9jbGllbnQuZC50c1wiLFxuICAgICAgXCJpbXBvcnRcIjogXCIuL2Rpc3QvY2xpZW50Lm1qc1wiLFxuICAgICAgXCJyZXF1aXJlXCI6IFwiLi9kaXN0L2NsaWVudC5qc1wiXG4gICAgfSxcbiAgICBcIi4vbGlmZWN5Y2xlLXdvcmtmbG93XCI6IHtcbiAgICAgIFwidHlwZXNcIjogXCIuL2Rpc3QvbGlmZWN5Y2xlLXdvcmtmbG93LmQudHNcIixcbiAgICAgIFwiaW1wb3J0XCI6IFwiLi9kaXN0L2xpZmVjeWNsZS13b3JrZmxvdy5tanNcIixcbiAgICAgIFwicmVxdWlyZVwiOiBcIi4vZGlzdC9saWZlY3ljbGUtd29ya2Zsb3cuanNcIlxuICAgIH0sXG4gICAgXCIuL2xpZmVjeWNsZS13b3JrZmxvdy1zdGVwc1wiOiB7XG4gICAgICBcInR5cGVzXCI6IFwiLi9kaXN0L2xpZmVjeWNsZS13b3JrZmxvdy1zdGVwcy5kLnRzXCIsXG4gICAgICBcImltcG9ydFwiOiBcIi4vZGlzdC9saWZlY3ljbGUtd29ya2Zsb3ctc3RlcHMubWpzXCIsXG4gICAgICBcInJlcXVpcmVcIjogXCIuL2Rpc3QvbGlmZWN5Y2xlLXdvcmtmbG93LXN0ZXBzLmpzXCJcbiAgICB9LFxuICAgIFwiLi9yZWFjdFwiOiB7XG4gICAgICBcInR5cGVzXCI6IFwiLi9kaXN0L3JlYWN0LmQudHNcIixcbiAgICAgIFwiaW1wb3J0XCI6IFwiLi9kaXN0L3JlYWN0Lm1qc1wiLFxuICAgICAgXCJyZXF1aXJlXCI6IFwiLi9kaXN0L3JlYWN0LmpzXCJcbiAgICB9XG4gIH0sXG4gIFwic2NyaXB0c1wiOiB7XG4gICAgXCJidWlsZFwiOiBcInRzdXBcIixcbiAgICBcImRldlwiOiBcInRzdXAgLS13YXRjaFwiLFxuICAgIFwiY2xlYW5cIjogXCJybSAtcmYgLnR1cmJvICYmIHJtIC1yZiBub2RlX21vZHVsZXMgJiYgcm0gLXJmIGRpc3RcIixcbiAgICBcInJlbGVhc2VcIjogXCJwbnBtIGJ1aWxkICYmIG5wbSBwdWJsaXNoXCIsXG4gICAgXCJ0eXBlY2hlY2tcIjogXCJ0c2MgLS1ub0VtaXRcIixcbiAgICBcInRlc3RcIjogXCJ2aXRlc3QgcnVuXCIsXG4gICAgXCJ0ZXN0OndhdGNoXCI6IFwidml0ZXN0XCJcbiAgfSxcbiAgXCJkZXBlbmRlbmNpZXNcIjoge1xuICAgIFwiQGVseXNpYWpzL29wZW5hcGlcIjogXCJeMS40LjE0XCIsXG4gICAgXCJAc3djL2NvcmVcIjogXCJeMS4xMC4wXCIsXG4gICAgXCJAdGFuc3RhY2svcmVhY3QtcXVlcnlcIjogXCJeNS45MC4yMVwiLFxuICAgIFwiQHZlcmNlbC9rdjJcIjogXCJeMC4wLjE4XCIsXG4gICAgXCJAdmVyY2VsL29pZGNcIjogXCJeMy4xLjBcIixcbiAgICBcIkB2ZXJjZWwvc2FuZGJveFwiOiBcIjEuNy4xXCIsXG4gICAgXCJAd29ya2Zsb3cvc2VyZGVcIjogXCI0LjEuMC1iZXRhLjJcIixcbiAgICBcImJldHRlci1hbGxcIjogXCJeMC4wLjVcIixcbiAgICBcImVseXNpYVwiOiBcIl4xLjQuMjVcIixcbiAgICBcImVycm9yZVwiOiBcIl4wLjE0LjBcIixcbiAgICBcImZhc3QtZGVlcC1lcXVhbFwiOiBcIl4zLjEuM1wiLFxuICAgIFwidWxpZFwiOiBcIl4zLjAuMlwiLFxuICAgIFwiem9kXCI6IFwiXjQuMy42XCJcbiAgfSxcbiAgXCJkZXZEZXBlbmRlbmNpZXNcIjoge1xuICAgIFwiQGFnZW50L3RzY29uZmlnXCI6IFwid29ya3NwYWNlOipcIixcbiAgICBcIkBhaS1zZGsvcmVhY3RcIjogXCJeMy4wLjg4XCIsXG4gICAgXCJAdHlwZXMvbm9kZVwiOiBcIl4yMC4xMS4yNFwiLFxuICAgIFwiQHR5cGVzL3JlYWN0XCI6IFwiXjE5LjIuMTRcIixcbiAgICBcImRvdGVudlwiOiBcIl4xNy4yLjNcIixcbiAgICBcIm5leHRcIjogXCJeMTYuMC4wXCIsXG4gICAgXCJyZWFjdFwiOiBcIl4xOS4yLjRcIixcbiAgICBcInRzdXBcIjogXCJeOC4wLjJcIixcbiAgICBcInR5cGVzY3JpcHRcIjogXCI1LjUuNFwiLFxuICAgIFwidml0ZXN0XCI6IFwiXjMuMC4wXCIsXG4gICAgXCJ3b3JrZmxvd1wiOiBcIjQuMi4wLWJldGEuNzBcIlxuICB9LFxuICBcInBlZXJEZXBlbmRlbmNpZXNcIjoge1xuICAgIFwiYWlcIjogXCJeNi4wLjBcIlxuICB9LFxuICBcInB1Ymxpc2hDb25maWdcIjoge1xuICAgIFwiYWNjZXNzXCI6IFwicHVibGljXCJcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjtBQUFBO0FBQUEsRUFDRSxNQUFRO0FBQUEsRUFDUixTQUFXO0FBQUEsRUFDWCxNQUFRO0FBQUEsRUFDUixRQUFVO0FBQUEsRUFDVixPQUFTO0FBQUEsRUFDVCxhQUFlO0FBQUEsRUFDZixTQUFXO0FBQUEsRUFDWCxPQUFTO0FBQUEsSUFDUDtBQUFBLEVBQ0Y7QUFBQSxFQUNBLFNBQVc7QUFBQSxJQUNULEtBQUs7QUFBQSxNQUNILE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsSUFDQSxhQUFhO0FBQUEsTUFDWCxPQUFTO0FBQUEsTUFDVCxRQUFVO0FBQUEsTUFDVixTQUFXO0FBQUEsSUFDYjtBQUFBLElBQ0EsYUFBYTtBQUFBLE1BQ1gsT0FBUztBQUFBLE1BQ1QsUUFBVTtBQUFBLE1BQ1YsU0FBVztBQUFBLElBQ2I7QUFBQSxJQUNBLFVBQVU7QUFBQSxNQUNSLE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsSUFDQSxpQkFBaUI7QUFBQSxNQUNmLE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsSUFDQSxpQkFBaUI7QUFBQSxNQUNmLE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsSUFDQSxlQUFlO0FBQUEsTUFDYixPQUFTO0FBQUEsTUFDVCxRQUFVO0FBQUEsTUFDVixTQUFXO0FBQUEsSUFDYjtBQUFBLElBQ0EsdUJBQXVCO0FBQUEsTUFDckIsT0FBUztBQUFBLE1BQ1QsUUFBVTtBQUFBLE1BQ1YsU0FBVztBQUFBLElBQ2I7QUFBQSxJQUNBLFlBQVk7QUFBQSxNQUNWLE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsSUFDQSx3QkFBd0I7QUFBQSxNQUN0QixPQUFTO0FBQUEsTUFDVCxRQUFVO0FBQUEsTUFDVixTQUFXO0FBQUEsSUFDYjtBQUFBLElBQ0EsOEJBQThCO0FBQUEsTUFDNUIsT0FBUztBQUFBLE1BQ1QsUUFBVTtBQUFBLE1BQ1YsU0FBVztBQUFBLElBQ2I7QUFBQSxJQUNBLFdBQVc7QUFBQSxNQUNULE9BQVM7QUFBQSxNQUNULFFBQVU7QUFBQSxNQUNWLFNBQVc7QUFBQSxJQUNiO0FBQUEsRUFDRjtBQUFBLEVBQ0EsU0FBVztBQUFBLElBQ1QsT0FBUztBQUFBLElBQ1QsS0FBTztBQUFBLElBQ1AsT0FBUztBQUFBLElBQ1QsU0FBVztBQUFBLElBQ1gsV0FBYTtBQUFBLElBQ2IsTUFBUTtBQUFBLElBQ1IsY0FBYztBQUFBLEVBQ2hCO0FBQUEsRUFDQSxjQUFnQjtBQUFBLElBQ2QscUJBQXFCO0FBQUEsSUFDckIsYUFBYTtBQUFBLElBQ2IseUJBQXlCO0FBQUEsSUFDekIsZUFBZTtBQUFBLElBQ2YsZ0JBQWdCO0FBQUEsSUFDaEIsbUJBQW1CO0FBQUEsSUFDbkIsbUJBQW1CO0FBQUEsSUFDbkIsY0FBYztBQUFBLElBQ2QsUUFBVTtBQUFBLElBQ1YsUUFBVTtBQUFBLElBQ1YsbUJBQW1CO0FBQUEsSUFDbkIsTUFBUTtBQUFBLElBQ1IsS0FBTztBQUFBLEVBQ1Q7QUFBQSxFQUNBLGlCQUFtQjtBQUFBLElBQ2pCLG1CQUFtQjtBQUFBLElBQ25CLGlCQUFpQjtBQUFBLElBQ2pCLGVBQWU7QUFBQSxJQUNmLGdCQUFnQjtBQUFBLElBQ2hCLFFBQVU7QUFBQSxJQUNWLE1BQVE7QUFBQSxJQUNSLE9BQVM7QUFBQSxJQUNULE1BQVE7QUFBQSxJQUNSLFlBQWM7QUFBQSxJQUNkLFFBQVU7QUFBQSxJQUNWLFVBQVk7QUFBQSxFQUNkO0FBQUEsRUFDQSxrQkFBb0I7QUFBQSxJQUNsQixJQUFNO0FBQUEsRUFDUjtBQUFBLEVBQ0EsZUFBaUI7QUFBQSxJQUNmLFFBQVU7QUFBQSxFQUNaO0FBQ0Y7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/{client-D4AiVqFt.d.ts → client-DIanpEQ_.d.ts}

@@ -6,6 +6,7 @@ import * as ai from 'ai';
 import { UIMessage, InferToolInput, ModelMessage, ToolSet, InferUITools, GatewayModelId } from 'ai';
 import { z } from 'zod';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
+import { S as SkillInput } from './types-B3lbsOa7.js';
 
 type BuiltInBindings = SandboxBinding<"local", LocalBindingConfig, LocalBindingMetadata> | SandboxBinding<"vercel", VercelBindingConfig, VercelBindingMetadata> | SandboxBinding<"docker", DockerBindingConfig, DockerBindingMetadata>;
 
@@ -64,58 +65,6 @@ type SessionUsage = {
     byMessageId: Record<string, UsageSummary | null>;
 };
 
-type SkillSourceType = "sandbox" | "host" | "git" | "inline";
-type SandboxSkillInput = {
-    type: "sandbox";
-    path: string;
-};
-type HostSkillInput = {
-    type: "host";
-    path: string;
-};
-type GitSkillInput = {
-    type: "git";
-    repo: string;
-    ref?: string;
-    path?: string;
-    /**
-     * Skill directory name under `path`.
-     */
-    name?: string;
-};
-type InlineSkillInput = {
-    type: "inline";
-    name: string;
-    description: string;
-    instructions: string;
-};
-type SkillInput = SandboxSkillInput | HostSkillInput | GitSkillInput | InlineSkillInput;
-type SandboxSkillEntry = {
-    type: "sandbox";
-    path: string;
-};
-type HostSkillEntry = {
-    type: "host";
-    path: string;
-};
-type GitSkillEntry = {
-    type: "git";
-    repo: string;
-    ref?: string;
-    path?: string;
-    /**
-     * Skill directory name under `path`.
-     */
-    name?: string;
-};
-type InlineSkillEntry = {
-    type: "inline";
-    name: string;
-    description: string;
-    instructions: string;
-};
-type SkillEntry = SandboxSkillEntry | HostSkillEntry | GitSkillEntry | InlineSkillEntry;
-
 type ToolContext<TContext = Record<string, unknown>, TState = Record<string, unknown>> = {
     context: TContext;
     state: TState;
@@ -486,9 +435,15 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
             signal?: AbortSignal;
         } | undefined) => Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
     };
+    /**
+     * Create a derived agent with merged options. The returned agent is NOT
+     * registered in the workflow registry – it's a one-off instance used by
+     * the framework to layer fs-scanned config onto an agent.ts definition.
+     */
+    extend(fn: (options: AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>) => AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>): Agent<TMessageMetadata, Tools, TSandboxBindings, TContext, TState>;
     /** Phantom property for type inference. Use `typeof myAgent.$UIMessage` to get the typed UIMessage. */
     readonly $UIMessage: UIMessage<TMessageMetadata, AgentDataTypes, InferUITools<typeof builtInTools & Tools>>;
 }
 declare function agent<Tools extends ToolSet = ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>, TState extends Record<string, unknown> = Record<string, unknown>, TMessageMetadata = unknown>(name: string, options?: AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>): Agent<TMessageMetadata, Tools, TSandboxBindings, TContext, TState>;
 
-export { type AnyAgent as A, type BuiltInToolName as B, type GitSkillEntry as G, type HostSkillEntry as H, type InferSession as I, type NeedsApprovalMap as N, type Resolvable as R, type SessionSendArgs as S, type ToolContext as T, type UsageSummary as U, type WorkflowRunLike as W, AgentStatus as a, type SendResult as b, type AgentDataTypes as c, type AgentHooks as d, type AgentOptions as e, type ApprovalData as f, type GitSkillInput as g, type HostSkillInput as h, type InferUIMessage as i, type InlineSkillEntry as j, type InlineSkillInput as k, type ResolvableArgs as l, type SandboxSkillEntry as m, type SandboxSkillInput as n, type SendInput as o, type SessionDefaults as p, type SkillEntry as q, type SkillInput as r, type SkillSourceType as s, type StepUsage as t, agent as u, builtinToolNames as v };
+export { type AnyAgent as A, type BuiltInToolName as B, type InferSession as I, type NeedsApprovalMap as N, type Resolvable as R, type SessionSendArgs as S, type ToolContext as T, type UsageSummary as U, type WorkflowRunLike as W, AgentStatus as a, type SendResult as b, type AgentDataTypes as c, type AgentHooks as d, type AgentOptions as e, type ApprovalData as f, type InferUIMessage as g, type ResolvableArgs as h, type SendInput as i, type SessionDefaults as j, type StepUsage as k, agent as l, builtinToolNames as m };

package/dist/{client-DCtmZCY8.d.mts → client-PuttJd6O.d.mts}

@@ -6,6 +6,7 @@ import * as ai from 'ai';
 import { UIMessage, InferToolInput, ModelMessage, ToolSet, InferUITools, GatewayModelId } from 'ai';
 import { z } from 'zod';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
+import { S as SkillInput } from './types-B3lbsOa7.mjs';
 
 type BuiltInBindings = SandboxBinding<"local", LocalBindingConfig, LocalBindingMetadata> | SandboxBinding<"vercel", VercelBindingConfig, VercelBindingMetadata> | SandboxBinding<"docker", DockerBindingConfig, DockerBindingMetadata>;
 
@@ -64,58 +65,6 @@ type SessionUsage = {
     byMessageId: Record<string, UsageSummary | null>;
 };
 
-type SkillSourceType = "sandbox" | "host" | "git" | "inline";
-type SandboxSkillInput = {
-    type: "sandbox";
-    path: string;
-};
-type HostSkillInput = {
-    type: "host";
-    path: string;
-};
-type GitSkillInput = {
-    type: "git";
-    repo: string;
-    ref?: string;
-    path?: string;
-    /**
-     * Skill directory name under `path`.
-     */
-    name?: string;
-};
-type InlineSkillInput = {
-    type: "inline";
-    name: string;
-    description: string;
-    instructions: string;
-};
-type SkillInput = SandboxSkillInput | HostSkillInput | GitSkillInput | InlineSkillInput;
-type SandboxSkillEntry = {
-    type: "sandbox";
-    path: string;
-};
-type HostSkillEntry = {
-    type: "host";
-    path: string;
-};
-type GitSkillEntry = {
-    type: "git";
-    repo: string;
-    ref?: string;
-    path?: string;
-    /**
-     * Skill directory name under `path`.
-     */
-    name?: string;
-};
-type InlineSkillEntry = {
-    type: "inline";
-    name: string;
-    description: string;
-    instructions: string;
-};
-type SkillEntry = SandboxSkillEntry | HostSkillEntry | GitSkillEntry | InlineSkillEntry;
-
 type ToolContext<TContext = Record<string, unknown>, TState = Record<string, unknown>> = {
     context: TContext;
     state: TState;
@@ -486,9 +435,15 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
             signal?: AbortSignal;
         } | undefined) => Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
     };
+    /**
+     * Create a derived agent with merged options. The returned agent is NOT
+     * registered in the workflow registry – it's a one-off instance used by
+     * the framework to layer fs-scanned config onto an agent.ts definition.
+     */
+    extend(fn: (options: AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>) => AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>): Agent<TMessageMetadata, Tools, TSandboxBindings, TContext, TState>;
     /** Phantom property for type inference. Use `typeof myAgent.$UIMessage` to get the typed UIMessage. */
     readonly $UIMessage: UIMessage<TMessageMetadata, AgentDataTypes, InferUITools<typeof builtInTools & Tools>>;
 }
 declare function agent<Tools extends ToolSet = ToolSet, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>, TState extends Record<string, unknown> = Record<string, unknown>, TMessageMetadata = unknown>(name: string, options?: AgentOptions<Tools, TSandboxBindings, TContext, TState, TMessageMetadata>): Agent<TMessageMetadata, Tools, TSandboxBindings, TContext, TState>;
 
-export { type AnyAgent as A, type BuiltInToolName as B, type GitSkillEntry as G, type HostSkillEntry as H, type InferSession as I, type NeedsApprovalMap as N, type Resolvable as R, type SessionSendArgs as S, type ToolContext as T, type UsageSummary as U, type WorkflowRunLike as W, AgentStatus as a, type SendResult as b, type AgentDataTypes as c, type AgentHooks as d, type AgentOptions as e, type ApprovalData as f, type GitSkillInput as g, type HostSkillInput as h, type InferUIMessage as i, type InlineSkillEntry as j, type InlineSkillInput as k, type ResolvableArgs as l, type SandboxSkillEntry as m, type SandboxSkillInput as n, type SendInput as o, type SessionDefaults as p, type SkillEntry as q, type SkillInput as r, type SkillSourceType as s, type StepUsage as t, agent as u, builtinToolNames as v };
+export { type AnyAgent as A, type BuiltInToolName as B, type InferSession as I, type NeedsApprovalMap as N, type Resolvable as R, type SessionSendArgs as S, type ToolContext as T, type UsageSummary as U, type WorkflowRunLike as W, AgentStatus as a, type SendResult as b, type AgentDataTypes as c, type AgentHooks as d, type AgentOptions as e, type ApprovalData as f, type InferUIMessage as g, type ResolvableArgs as h, type SendInput as i, type SessionDefaults as j, type StepUsage as k, agent as l, builtinToolNames as m };

package/dist/framework-DH4Z1NLV.d.ts

@@ -0,0 +1,61 @@
+import { S as SkillInput } from './types-B3lbsOa7.js';
+
+type AgentDir = {
+    name: string;
+    absolutePath: string;
+    hasAgentConfig: boolean;
+};
+type ScannedAgent = AgentDir & {
+    skills: SkillInput[];
+    systemPrompt: string | undefined;
+    tsSkillImportPaths: string[];
+};
+
+declare function generateRegistry(opts: {
+    agents: ScannedAgent[];
+    outputDir: string;
+}): string;
+
+/**
+ * Framework-agnostic core for filesystem-based agent discovery and
+ * registry code generation. Adapters like {@link Next} receive a
+ * `Framework` instance and use it to scan agents and produce registry
+ * source code.
+ */
+declare class Framework {
+    readonly cwd: string;
+    readonly agentsDir: string | undefined;
+    readonly log: (...args: unknown[]) => void;
+    constructor(opts: {
+        /**
+         * Project root directory.
+         * @defaultValue `process.cwd()`
+         */
+        cwd?: string;
+        /**
+         * Path to the agents directory, relative to `cwd`.
+         * When omitted, auto-detected as the first existing directory
+         * among `src/agents` and `agents`.
+         */
+        agentsDir?: string;
+        /** Enable verbose logging to stdout. */
+        debug?: boolean;
+    });
+    /**
+     * Scan the agents directory and return metadata for every agent found.
+     * Each subfolder inside the agents directory becomes one agent.
+     * Returns an empty array when no agents directory exists.
+     */
+    discoverAgents(): ScannedAgent[];
+    /**
+     * Generate the TypeScript source for an agent registry module.
+     *
+     * @param opts.agents - Scanned agents to include in the registry.
+     * @param opts.outputDir - Directory where the registry file will be written
+     *   (used to compute relative import paths to each agent's config module).
+     * @returns The full source text of the generated `_registry.ts` file.
+     */
+    generateRegistrySource: typeof generateRegistry;
+}
+
+export { Framework as F };

package/dist/framework-c9fvEy0o.d.mts

@@ -0,0 +1,61 @@
+import { S as SkillInput } from './types-B3lbsOa7.mjs';
+
+type AgentDir = {
+    name: string;
+    absolutePath: string;
+    hasAgentConfig: boolean;
+};
+type ScannedAgent = AgentDir & {
+    skills: SkillInput[];
+    systemPrompt: string | undefined;
+    tsSkillImportPaths: string[];
+};
+
+declare function generateRegistry(opts: {
+    agents: ScannedAgent[];
+    outputDir: string;
+}): string;
+
+/**
+ * Framework-agnostic core for filesystem-based agent discovery and
+ * registry code generation. Adapters like {@link Next} receive a
+ * `Framework` instance and use it to scan agents and produce registry
+ * source code.
+ */
+declare class Framework {
+    readonly cwd: string;
+    readonly agentsDir: string | undefined;
+    readonly log: (...args: unknown[]) => void;
+    constructor(opts: {
+        /**
+         * Project root directory.
+         * @defaultValue `process.cwd()`
+         */
+        cwd?: string;
+        /**
+         * Path to the agents directory, relative to `cwd`.
+         * When omitted, auto-detected as the first existing directory
+         * among `src/agents` and `agents`.
+         */
+        agentsDir?: string;
+        /** Enable verbose logging to stdout. */
+        debug?: boolean;
+    });
+    /**
+     * Scan the agents directory and return metadata for every agent found.
+     * Each subfolder inside the agents directory becomes one agent.
+     * Returns an empty array when no agents directory exists.
+     */
+    discoverAgents(): ScannedAgent[];
+    /**
+     * Generate the TypeScript source for an agent registry module.
+     *
+     * @param opts.agents - Scanned agents to include in the registry.
+     * @param opts.outputDir - Directory where the registry file will be written
+     *   (used to compute relative import paths to each agent's config module).
+     * @returns The full source text of the generated `_registry.ts` file.
+     */
+    generateRegistrySource: typeof generateRegistry;
+}
+
+export { Framework as F };

package/dist/framework-runtime.d.mts

@@ -0,0 +1,37 @@
+import { r as resolveFrameworkAgent } from './resolve-Cma6YFgx.mjs';
+import './client-PuttJd6O.mjs';
+import '@vercel/sandbox';
+import './steps-ChOeFWAq.mjs';
+import './adapter-CFq5IeYI.mjs';
+import '@workflow/serde';
+import 'ai';
+import './entry-CRBUC5DB.mjs';
+import 'zod';
+import './types-B3lbsOa7.mjs';
+
+/**
+ * Request-time utilities for the framework router.
+ *
+ * Used inside generated route handlers to resolve an agent by name
+ * from a registry produced at build time.
+ *
+ * @example
+ * ```ts
+ * import { runtime } from "experimental-agent/framework-runtime";
+ *
+ * const agent = await runtime.resolveAgent({ name, agents });
+ * ```
+ */
+declare const runtime: {
+    /**
+     * Look up an agent by name from a generated registry, merging any
+     * filesystem-scanned config (system prompts, skills) on top of the
+     * agent's own options. Results are cached for the lifetime of the
+     * process.
+     *
+     * Returns `null` when the name doesn't match any registry entry.
+     */
+    resolveAgent: typeof resolveFrameworkAgent;
+};
+
+export { runtime };

package/dist/framework-runtime.d.ts

@@ -0,0 +1,37 @@
+import { r as resolveFrameworkAgent } from './resolve-BZ26gcyj.js';
+import './client-DIanpEQ_.js';
+import '@vercel/sandbox';
+import './steps-DWTQiAPt.js';
+import './adapter-CFq5IeYI.js';
+import '@workflow/serde';
+import 'ai';
+import './entry-BUYBv4Cu.js';
+import 'zod';
+import './types-B3lbsOa7.js';
+
+/**
+ * Request-time utilities for the framework router.
+ *
+ * Used inside generated route handlers to resolve an agent by name
+ * from a registry produced at build time.
+ *
+ * @example
+ * ```ts
+ * import { runtime } from "experimental-agent/framework-runtime";
+ *
+ * const agent = await runtime.resolveAgent({ name, agents });
+ * ```
+ */
+declare const runtime: {
+    /**
+     * Look up an agent by name from a generated registry, merging any
+     * filesystem-scanned config (system prompts, skills) on top of the
+     * agent's own options. Results are cached for the lifetime of the
+     * process.
+     *
+     * Returns `null` when the name doesn't match any registry entry.
+     */
+    resolveAgent: typeof resolveFrameworkAgent;
+};
+
+export { runtime };