@finalai/agent-definition 0.1.0

package/dist/modules/compiler/local-isolate.mjs

@@ -0,0 +1,93 @@
+import {
+  jsonValueSchema
+} from "@finalai/agent-provider";
+import {
+  installSandboxOpenScope,
+  withSandboxOpener
+} from "@finalai/agent-provider/sandbox/open-scope-node";
+import { transform } from "esbuild";
+import vm from "node:vm";
+import * as z from "zod";
+import { callableSchema } from "../runtime/values.mjs";
+import { parseLoadedBundle } from "./load.mjs";
+const GLOBAL_NAME = "__finalAgentBundle";
+const workerGlobals = (options) => ({
+  fetch: options.fetch ?? fetch,
+  Request,
+  Response,
+  Headers,
+  FormData,
+  Blob,
+  File,
+  URL,
+  URLSearchParams,
+  TextEncoder,
+  TextDecoder,
+  AbortController,
+  AbortSignal,
+  ReadableStream,
+  WritableStream,
+  TransformStream,
+  EventTarget,
+  Event,
+  WebSocket,
+  crypto,
+  performance,
+  structuredClone,
+  atob,
+  btoa,
+  queueMicrotask,
+  setTimeout,
+  clearTimeout,
+  setInterval,
+  clearInterval,
+  console
+});
+const resultTextSchema = z.string();
+const loadBundleInLocalIsolate = async (code, options = {}) => {
+  const converted = await transform(code, {
+    format: "iife",
+    globalName: GLOBAL_NAME,
+    loader: "js",
+    target: "es2024"
+  });
+  const context = vm.createContext(workerGlobals(options), {
+    name: "final-agent-dev",
+    codeGeneration: { strings: false, wasm: false }
+  });
+  installSandboxOpenScope(context);
+  const namespace = z.unknown().parse(
+    vm.runInContext(`${converted.code}
+;${GLOBAL_NAME};`, context, {
+      filename: "agent-bundle.js",
+      timeout: 1e4
+    })
+  );
+  const loaded = parseLoadedBundle(namespace);
+  return {
+    ...loaded,
+    runSandboxSelector: async (args) => {
+      const selector = callableSchema.safeParse(loaded.modules[args.exportName]);
+      if (!selector.success) throw new Error(`${args.exportName} is not a sandbox selector`);
+      await withSandboxOpener(
+        args.open,
+        () => selector.data({ session: args.session, secrets: args.secrets, open: args.open })
+      );
+    },
+    callExportMethod: async (args) => {
+      const script = `(async () => {
+        const target = ${GLOBAL_NAME}.modules[${JSON.stringify(args.exportName)}];
+        const method = target == null ? undefined : target[${JSON.stringify(args.method)}];
+        if (typeof method !== 'function') throw new Error(${JSON.stringify(`${args.exportName} has no ${args.method}`)});
+        return JSON.stringify((await method.apply(target, ${JSON.stringify(args.args)})) ?? null);
+      })()`;
+      const pending = z.unknown().parse(vm.runInContext(script, context, { timeout: 1e4 }));
+      const text = resultTextSchema.parse(await pending);
+      return jsonValueSchema.parse(JSON.parse(text));
+    }
+  };
+};
+export {
+  loadBundleInLocalIsolate
+};
+//# sourceMappingURL=local-isolate.mjs.map

package/dist/modules/compiler/local-isolate.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/local-isolate.ts"],
+  "sourcesContent": ["import {\n  jsonValueSchema,\n  type JsonValue,\n  type SandboxOpener,\n  type SecretReaderIface,\n} from '@finalai/agent-provider';\nimport {\n  installSandboxOpenScope,\n  withSandboxOpener,\n} from '@finalai/agent-provider/sandbox/open-scope-node';\nimport { transform } from 'esbuild';\nimport vm from 'node:vm';\nimport * as z from 'zod';\nimport type { AgentSessionInfoIface } from \"../authoring/context.mjs\";\nimport { callableSchema } from \"../runtime/values.mjs\";\nimport { parseLoadedBundle, type LoadedBundleIface } from \"./load.mjs\";\n\n// A local stand-in for the Worker isolate (agent-harness-workers) that runs a\n// compiled bundle for `final agents dev` and `final agents build`: its own\n// realm with only the Web platform globals a Worker has (fetch,\n// Request/Response, crypto, timers, streams), no Node built-ins and no\n// `process`. node:vm is not a security boundary; this runs the author's own\n// code on the author's machine.\n\nconst GLOBAL_NAME = '__finalAgentBundle';\n\nexport interface LocalIsolateOptionsIface {\n  // Replaces the realm's fetch (tests, or a proxy for outbound requests).\n  fetch?: typeof fetch;\n}\n\nexport interface LocalIsolateBundleIface extends LoadedBundleIface {\n  // Calls `<export>.<method>(...args)` inside the realm with JSON arguments\n  // and returns its JSON result: a bundle harness's describe, for example.\n  callExportMethod(args: {\n    exportName: string;\n    method: string;\n    args: JsonValue[];\n  }): Promise<JsonValue>;\n  // Runs sandbox.ts's default selector the way the Worker isolate does:\n  // `open` (and awaiting an environment's `open(...)` inside it) reaches the\n  // target through `args.open`.\n  runSandboxSelector(args: {\n    exportName: string;\n    session: AgentSessionInfoIface;\n    secrets: SecretReaderIface;\n    open: SandboxOpener;\n  }): Promise<void>;\n}\n\nconst workerGlobals = (options: LocalIsolateOptionsIface) => ({\n  fetch: options.fetch ?? fetch,\n  Request,\n  Response,\n  Headers,\n  FormData,\n  Blob,\n  File,\n  URL,\n  URLSearchParams,\n  TextEncoder,\n  TextDecoder,\n  AbortController,\n  AbortSignal,\n  ReadableStream,\n  WritableStream,\n  TransformStream,\n  EventTarget,\n  Event,\n  WebSocket,\n  crypto,\n  performance,\n  structuredClone,\n  atob,\n  btoa,\n  queueMicrotask,\n  setTimeout,\n  clearTimeout,\n  setInterval,\n  clearInterval,\n  console,\n});\n\nconst resultTextSchema = z.string();\n\nexport const loadBundleInLocalIsolate = async (\n  code: string,\n  options: LocalIsolateOptionsIface = {},\n): Promise<LocalIsolateBundleIface> => {\n  const converted = await transform(code, {\n    format: 'iife',\n    globalName: GLOBAL_NAME,\n    loader: 'js',\n    target: 'es2024',\n  });\n  const context = vm.createContext(workerGlobals(options), {\n    name: 'final-agent-dev',\n    codeGeneration: { strings: false, wasm: false },\n  });\n  installSandboxOpenScope(context);\n  const namespace = z.unknown().parse(\n    vm.runInContext(`${converted.code}\\n;${GLOBAL_NAME};`, context, {\n      filename: 'agent-bundle.js',\n      timeout: 10_000,\n    }),\n  );\n  const loaded = parseLoadedBundle(namespace);\n  return {\n    ...loaded,\n    runSandboxSelector: async (args) => {\n      const selector = callableSchema.safeParse(loaded.modules[args.exportName]);\n      if (!selector.success) throw new Error(`${args.exportName} is not a sandbox selector`);\n      await withSandboxOpener(args.open, () =>\n        selector.data({ session: args.session, secrets: args.secrets, open: args.open }),\n      );\n    },\n    callExportMethod: async (args) => {\n      // The names and arguments are embedded as JSON literals; the call runs in\n      // the realm, so authored values never cross into this one.\n      const script = `(async () => {\n        const target = ${GLOBAL_NAME}.modules[${JSON.stringify(args.exportName)}];\n        const method = target == null ? undefined : target[${JSON.stringify(args.method)}];\n        if (typeof method !== 'function') throw new Error(${JSON.stringify(`${args.exportName} has no ${args.method}`)});\n        return JSON.stringify((await method.apply(target, ${JSON.stringify(args.args)})) ?? null);\n      })()`;\n      const pending = z.unknown().parse(vm.runInContext(script, context, { timeout: 10_000 }));\n      const text = resultTextSchema.parse(await pending);\n      return jsonValueSchema.parse(JSON.parse(text));\n    },\n  };\n};\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,SAAS,iBAAiB;AAC1B,OAAO,QAAQ;AACf,YAAY,OAAO;AAEnB,SAAS,sBAAsB;AAC/B,SAAS,yBAAiD;AAS1D,MAAM,cAAc;AA0BpB,MAAM,gBAAgB,CAAC,aAAuC;AAAA,EAC5D,OAAO,QAAQ,SAAS;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,mBAAmB,EAAE,OAAO;AAE3B,MAAM,2BAA2B,OACtC,MACA,UAAoC,CAAC,MACA;AACrC,QAAM,YAAY,MAAM,UAAU,MAAM;AAAA,IACtC,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AACD,QAAM,UAAU,GAAG,cAAc,cAAc,OAAO,GAAG;AAAA,IACvD,MAAM;AAAA,IACN,gBAAgB,EAAE,SAAS,OAAO,MAAM,MAAM;AAAA,EAChD,CAAC;AACD,0BAAwB,OAAO;AAC/B,QAAM,YAAY,EAAE,QAAQ,EAAE;AAAA,IAC5B,GAAG,aAAa,GAAG,UAAU,IAAI;AAAA,GAAM,WAAW,KAAK,SAAS;AAAA,MAC9D,UAAU;AAAA,MACV,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACA,QAAM,SAAS,kBAAkB,SAAS;AAC1C,SAAO;AAAA,IACL,GAAG;AAAA,IACH,oBAAoB,OAAO,SAAS;AAClC,YAAM,WAAW,eAAe,UAAU,OAAO,QAAQ,KAAK,UAAU,CAAC;AACzE,UAAI,CAAC,SAAS,QAAS,OAAM,IAAI,MAAM,GAAG,KAAK,UAAU,4BAA4B;AACrF,YAAM;AAAA,QAAkB,KAAK;AAAA,QAAM,MACjC,SAAS,KAAK,EAAE,SAAS,KAAK,SAAS,SAAS,KAAK,SAAS,MAAM,KAAK,KAAK,CAAC;AAAA,MACjF;AAAA,IACF;AAAA,IACA,kBAAkB,OAAO,SAAS;AAGhC,YAAM,SAAS;AAAA,yBACI,WAAW,YAAY,KAAK,UAAU,KAAK,UAAU,CAAC;AAAA,6DAClB,KAAK,UAAU,KAAK,MAAM,CAAC;AAAA,4DAC5B,KAAK,UAAU,GAAG,KAAK,UAAU,WAAW,KAAK,MAAM,EAAE,CAAC;AAAA,4DAC1D,KAAK,UAAU,KAAK,IAAI,CAAC;AAAA;AAE/E,YAAM,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,QAAQ,SAAS,EAAE,SAAS,IAAO,CAAC,CAAC;AACvF,YAAM,OAAO,iBAAiB,MAAM,MAAM,OAAO;AACjD,aAAO,gBAAgB,MAAM,KAAK,MAAM,IAAI,CAAC;AAAA,IAC/C;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/compiler/packages.d.mts

@@ -0,0 +1,66 @@
+import * as z from 'zod';
+import { type DiagnosticIface } from "./diagnostics.mjs";
+export interface VendoredPackageIface {
+    files: Record<string, string>;
+    loadError?: string;
+}
+type ExportsTargetIface = string | null | ExportsTargetIface[] | {
+    [key: string]: ExportsTargetIface;
+};
+declare const packageJsonSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    main: z.ZodOptional<z.ZodString>;
+    module: z.ZodOptional<z.ZodString>;
+    exports: z.ZodOptional<z.ZodType<ExportsTargetIface, unknown, z.core.$ZodTypeInternals<ExportsTargetIface, unknown>>>;
+    imports: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ExportsTargetIface, unknown, z.core.$ZodTypeInternals<ExportsTargetIface, unknown>>>>;
+    devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export type PackageJsonIface = z.infer<typeof packageJsonSchema>;
+export declare const parsePackageJson: (text: string | undefined) => PackageJsonIface | null;
+export declare const packageImportTarget: (args: {
+    packageJson: string | undefined;
+    specifier: string;
+    require: boolean;
+}) => string | null;
+export declare const splitSpecifier: (specifier: string) => {
+    name: string;
+    subpath: string;
+} | null;
+export interface PackageEntryIface {
+    path: string | null;
+    wanted: string;
+    exported: boolean;
+}
+export declare const packageEntry: (args: {
+    pkg: VendoredPackageIface;
+    subpath: string;
+    require: boolean;
+    resolve: (path: string) => string | null;
+}) => PackageEntryIface;
+export declare const PLATFORM_PACKAGES: ReadonlySet<string>;
+export declare enum WorkspaceDependencyKind {
+    Workspace = "workspace",
+    Path = "path"
+}
+export interface WorkspaceDependencyIface {
+    name: string;
+    kind: WorkspaceDependencyKind;
+    path: string | null;
+}
+export declare const workspaceDependencies: (packageJson: string | undefined, includeDevDependencies?: boolean) => WorkspaceDependencyIface[];
+export declare const declaredDependencyDiagnostics: (args: {
+    packageJson: string | undefined;
+    vendored: ReadonlySet<string>;
+    local: boolean;
+}) => DiagnosticIface[];
+export declare const workspacePackageGlobs: (args: {
+    pnpmWorkspaceYaml: string | undefined;
+    rootPackageJson: string | undefined;
+}) => string[];
+export declare const workspacePackageCandidates: (args: {
+    paths: readonly string[];
+    globs: readonly string[];
+    name: string;
+}) => string[];
+export {};

package/dist/modules/compiler/packages.mjs

@@ -0,0 +1,307 @@
+import { posix } from "node:path";
+import { parse as parseYaml } from "yaml";
+import * as z from "zod";
+import {
+  diagnostic,
+  DiagnosticCode,
+  DiagnosticSeverity
+} from "./diagnostics.mjs";
+const conditionsSchema = z.lazy(
+  () => z.union([
+    z.string(),
+    z.null(),
+    z.array(conditionsSchema),
+    z.record(z.string(), conditionsSchema)
+  ])
+);
+const packageJsonSchema = z.looseObject({
+  name: z.string().optional(),
+  main: z.string().optional(),
+  module: z.string().optional(),
+  exports: conditionsSchema.optional(),
+  imports: z.record(z.string(), conditionsSchema).optional(),
+  devDependencies: z.record(z.string(), z.string()).optional(),
+  dependencies: z.record(z.string(), z.string()).optional()
+});
+const parsePackageJson = (text) => {
+  if (text == null) return null;
+  try {
+    const parsed = packageJsonSchema.safeParse(JSON.parse(text));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+};
+const conditionsFor = (require2) => /* @__PURE__ */ new Set(["workerd", "worker", "browser", require2 ? "require" : "import", "module", "default"]);
+var PickKind = /* @__PURE__ */ ((PickKind2) => {
+  PickKind2["Matched"] = "matched";
+  PickKind2["Excluded"] = "excluded";
+  PickKind2["Unmatched"] = "unmatched";
+  return PickKind2;
+})(PickKind || {});
+const pick = (target, conditions) => {
+  if (target == null) return { kind: "excluded" /* Excluded */ };
+  const text = z.string().safeParse(target);
+  if (text.success) return { kind: "matched" /* Matched */, path: text.data };
+  if (Array.isArray(target)) {
+    let excluded = false;
+    for (const item of target) {
+      const picked = pick(item, conditions);
+      excluded ||= picked.kind === "excluded" /* Excluded */;
+      if (picked.kind === "matched" /* Matched */ && picked.path.startsWith("./") && !picked.path.split("/").slice(1).some((part) => part === ".." || part === "node_modules"))
+        return picked;
+    }
+    return { kind: excluded ? "excluded" /* Excluded */ : "unmatched" /* Unmatched */ };
+  }
+  const record = z.record(z.string(), conditionsSchema).safeParse(target);
+  if (!record.success) return { kind: "unmatched" /* Unmatched */ };
+  for (const [condition, value] of Object.entries(record.data)) {
+    if (!conditions.has(condition)) continue;
+    const picked = pick(value, conditions);
+    if (picked.kind !== "unmatched" /* Unmatched */) return picked;
+  }
+  return { kind: "unmatched" /* Unmatched */ };
+};
+const pickTarget = (target, conditions) => {
+  const picked = pick(target, conditions);
+  return picked.kind === "matched" /* Matched */ ? picked.path : null;
+};
+const exportFor = (exports, subpath, conditions) => {
+  if (exports == null) return null;
+  const record = z.record(z.string(), conditionsSchema).safeParse(exports);
+  if (record.success && Object.keys(record.data).some((key) => key.startsWith(".") || key.startsWith("#"))) {
+    const exact = record.data[subpath];
+    if (exact !== void 0) return pickTarget(exact, conditions);
+    let best = null;
+    for (const [pattern, target] of Object.entries(record.data)) {
+      const star = pattern.indexOf("*");
+      if (star < 0 || pattern.indexOf("*", star + 1) >= 0) continue;
+      const prefix = pattern.slice(0, star);
+      const suffix = pattern.slice(star + 1);
+      if (subpath.length < pattern.length) continue;
+      if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix)) continue;
+      if (best == null || prefix.length > best.prefix.length || prefix.length === best.prefix.length && pattern.length > best.pattern.length)
+        best = { prefix, pattern, target };
+    }
+    if (best == null) return null;
+    const suffixLength = best.pattern.length - best.prefix.length - 1;
+    const middle = subpath.slice(best.prefix.length, subpath.length - suffixLength);
+    if (middle.split("/").some((part) => part === "." || part === ".." || part === "node_modules"))
+      return null;
+    return pickTarget(best.target, conditions)?.replaceAll("*", () => middle) ?? null;
+  }
+  return subpath === "." ? pickTarget(exports, conditions) : null;
+};
+const packageImportTarget = (args) => exportFor(
+  parsePackageJson(args.packageJson)?.imports,
+  args.specifier,
+  conditionsFor(args.require)
+);
+const splitSpecifier = (specifier) => {
+  const segments = specifier.split("/");
+  const nameLength = segments[0]?.startsWith("@") ? 2 : 1;
+  if (segments.length < nameLength || segments.slice(0, nameLength).some((part) => part === ""))
+    return null;
+  const name = segments.slice(0, nameLength).join("/");
+  const rest = segments.slice(nameLength).join("/");
+  return { name, subpath: rest.length === 0 ? "." : `./${rest}` };
+};
+const packageEntry = (args) => {
+  const json = parsePackageJson(args.pkg.files["package.json"]);
+  const exported = exportFor(json?.exports, args.subpath, conditionsFor(args.require));
+  if ((exported == null || !exported.startsWith("./")) && json?.exports != null)
+    return { path: null, wanted: args.subpath, exported: false };
+  const candidates = [];
+  if (exported != null) candidates.push(exported);
+  else if (json?.exports == null) {
+    if (args.subpath === ".") {
+      if (json?.module != null) candidates.push(json.module);
+      if (json?.main != null) candidates.push(json.main);
+      candidates.push("./index");
+    } else candidates.push(args.subpath);
+  }
+  for (const candidate of candidates) {
+    const normalized = posix.normalize(candidate).replace(/^\.\//, "");
+    if (normalized === ".." || normalized.startsWith("../") || normalized.startsWith("/")) continue;
+    const resolved = args.resolve(normalized);
+    if (resolved != null) return { path: resolved, wanted: candidate, exported: true };
+  }
+  return { path: null, wanted: candidates[0] ?? args.subpath, exported: true };
+};
+const PLATFORM_PACKAGES = /* @__PURE__ */ new Set(["zod", "yaml", "croner", "re2js"]);
+var WorkspaceDependencyKind = /* @__PURE__ */ ((WorkspaceDependencyKind2) => {
+  WorkspaceDependencyKind2["Workspace"] = "workspace";
+  WorkspaceDependencyKind2["Path"] = "path";
+  return WorkspaceDependencyKind2;
+})(WorkspaceDependencyKind || {});
+const workspaceDependencies = (packageJson, includeDevDependencies = true) => {
+  const parsed = parsePackageJson(packageJson);
+  const entries = Object.entries(parsed?.dependencies ?? {});
+  if (includeDevDependencies) {
+    for (const entry of Object.entries(parsed?.devDependencies ?? {}))
+      if (!Object.hasOwn(parsed?.dependencies ?? {}, entry[0])) entries.push(entry);
+  }
+  return entries.flatMap(([name, spec]) => {
+    if (spec.startsWith("workspace:"))
+      return [{ name, kind: "workspace" /* Workspace */, path: null }];
+    const path = /^(?:file|link):(.+)$/u.exec(spec)?.[1];
+    return path == null ? [] : [{ name, kind: "path" /* Path */, path }];
+  });
+};
+const declaredDependencyDiagnostics = (args) => {
+  const json = parsePackageJson(args.packageJson);
+  if (json == null) return [];
+  const workspace = new Set(workspaceDependencies(args.packageJson).map((entry) => entry.name));
+  const out = [];
+  for (const name of Object.keys(json.dependencies ?? {})) {
+    if (args.vendored.has(name) || PLATFORM_PACKAGES.has(name)) continue;
+    if (name === "@finalai/agents" || name.startsWith("@finalai/")) continue;
+    if (workspace.has(name)) {
+      if (args.local) continue;
+      out.push(
+        diagnostic({
+          severity: DiagnosticSeverity.Warning,
+          code: DiagnosticCode.Dependencies,
+          message: `package.json depends on the workspace package ${name}, which was not found in the repository at this commit`,
+          path: "package.json"
+        })
+      );
+      continue;
+    }
+    out.push(
+      diagnostic({
+        severity: DiagnosticSeverity.Warning,
+        code: DiagnosticCode.Dependencies,
+        message: `package.json depends on ${name} from npm; agents are compiled without installing npm packages, so only workspace packages from this repository and ${[...PLATFORM_PACKAGES].join(", ")} can be imported`,
+        path: "package.json"
+      })
+    );
+  }
+  return out;
+};
+const pnpmWorkspaceSchema = z.looseObject({ packages: z.array(z.string()).optional() });
+const rootWorkspacesSchema = z.looseObject({
+  workspaces: z.union([z.array(z.string()), z.looseObject({ packages: z.array(z.string()).optional() })]).optional()
+});
+const workspacePackageGlobs = (args) => {
+  if (args.pnpmWorkspaceYaml != null) {
+    try {
+      const parsed = pnpmWorkspaceSchema.safeParse(parseYaml(args.pnpmWorkspaceYaml));
+      if (parsed.success && parsed.data.packages != null) return parsed.data.packages;
+    } catch {
+    }
+  }
+  if (args.rootPackageJson == null) return [];
+  try {
+    const parsed = rootWorkspacesSchema.safeParse(JSON.parse(args.rootPackageJson));
+    const workspaces = parsed.success ? parsed.data.workspaces : void 0;
+    if (workspaces == null) return [];
+    return Array.isArray(workspaces) ? workspaces : workspaces.packages ?? [];
+  } catch {
+    return [];
+  }
+};
+const expandGlob = (glob) => {
+  if (glob.length > 512) throw new Error("Workspace glob exceeds 512 characters.");
+  let variants = [glob];
+  while (true) {
+    const next = [];
+    let expanded = false;
+    for (const variant of variants) {
+      const brace = /\{([^{}]+)\}/u.exec(variant);
+      if (brace?.[1] == null) next.push(variant);
+      else {
+        expanded = true;
+        for (const choice of brace[1].split(",")) {
+          if (next.length >= 128) throw new Error("Workspace globs exceed 128 expanded patterns.");
+          next.push(
+            variant.slice(0, brace.index) + choice + variant.slice(brace.index + brace[0].length)
+          );
+        }
+      }
+    }
+    if (next.length > 128) throw new Error("Workspace globs exceed 128 expanded patterns.");
+    if (!expanded) return next;
+    variants = next;
+  }
+};
+const segmentMatches = ({ directory, glob, consumeWork }) => {
+  const text = Array.from(directory);
+  const tokens = Array.from(glob);
+  let d = 0;
+  let p = 0;
+  let star = null;
+  let matched = 0;
+  while (d < text.length) {
+    consumeWork();
+    if (tokens[p] === "?" || tokens[p] !== "*" && tokens[p] === text[d]) {
+      d += 1;
+      p += 1;
+    } else if (tokens[p] === "*") {
+      star = p;
+      p += 1;
+      matched = d;
+    } else if (star != null) {
+      p = star + 1;
+      matched += 1;
+      d = matched;
+    } else return false;
+  }
+  while (tokens[p] === "*") p += 1;
+  return p === tokens.length;
+};
+const globMatches = ({ directory, glob, consumeWork }) => {
+  const dirParts = directory.split("/");
+  const parts = glob.replace(/^\.\//u, "").replace(/\/+$/u, "").split("/");
+  const memo = /* @__PURE__ */ new Map();
+  const walk = (d, p) => {
+    consumeWork();
+    const key = `${d}:${p}`;
+    const existing = memo.get(key);
+    if (existing != null) return existing;
+    const part = parts[p];
+    const found = p === parts.length ? d === dirParts.length : part === "**" ? walk(d, p + 1) || d < dirParts.length && walk(d + 1, p) : d < dirParts.length && part != null && segmentMatches({ directory: dirParts[d] ?? "", glob: part, consumeWork }) && walk(d + 1, p + 1);
+    memo.set(key, found);
+    return found;
+  };
+  return walk(0, 0);
+};
+const workspacePackageCandidates = (args) => {
+  const expanded = [];
+  for (const glob of args.globs) {
+    const patterns = expandGlob(glob);
+    if (expanded.length + patterns.length > 128)
+      throw new Error("Workspace globs exceed 128 expanded patterns.");
+    expanded.push(...patterns);
+  }
+  let remainingWork = 1e6;
+  const consumeWork = () => {
+    remainingWork -= 1;
+    if (remainingWork < 0)
+      throw new Error(
+        "Workspace glob matching exceeds its work budget; use narrower globs or file: dependencies."
+      );
+  };
+  const include = expanded.filter((glob) => !glob.startsWith("!"));
+  const exclude = expanded.filter((glob) => glob.startsWith("!")).map((glob) => glob.slice(1));
+  const unscoped = args.name.split("/").at(-1) ?? args.name;
+  const directories = args.paths.filter((path) => path.endsWith("/package.json") && !path.split("/").includes("node_modules")).map((path) => path.slice(0, -"/package.json".length)).filter(
+    (directory) => include.some((glob) => globMatches({ directory, glob, consumeWork })) && !exclude.some((glob) => globMatches({ directory, glob, consumeWork }))
+  );
+  return directories.toSorted(
+    (a, b) => Number(posix.basename(b) === unscoped) - Number(posix.basename(a) === unscoped) || (a < b ? -1 : a > b ? 1 : 0)
+  );
+};
+export {
+  PLATFORM_PACKAGES,
+  WorkspaceDependencyKind,
+  declaredDependencyDiagnostics,
+  packageEntry,
+  packageImportTarget,
+  parsePackageJson,
+  splitSpecifier,
+  workspaceDependencies,
+  workspacePackageCandidates,
+  workspacePackageGlobs
+};
+//# sourceMappingURL=packages.mjs.map

package/dist/modules/compiler/packages.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/packages.ts"],
+  "sourcesContent": ["import { posix } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport * as z from 'zod';\nimport {\n  diagnostic,\n  DiagnosticCode,\n  DiagnosticSeverity,\n  type DiagnosticIface,\n} from \"./diagnostics.mjs\";\n\n// Workspace packages share code between agent directories. Repository compilation\n// reads source without\n// installing anything, so a package is vendored source: the files of a\n// directory in the same repository, at the same commit, that the agent's\n// package.json depends on (`workspace:`, `file:` or `link:`). Their own\n// imports resolve the same way; anything else resolves only to what the\n// platform ships (the authoring API and this package's dependencies).\n\nexport interface VendoredPackageIface {\n  // Package-relative path \u2192 text, including package.json.\n  files: Record<string, string>;\n  // A bounded repository read failed; report it only if this package is imported.\n  loadError?: string;\n}\n\nconst conditionsSchema: z.ZodType<ExportsTargetIface> = z.lazy(() =>\n  z.union([\n    z.string(),\n    z.null(),\n    z.array(conditionsSchema),\n    z.record(z.string(), conditionsSchema),\n  ]),\n);\ntype ExportsTargetIface =\n  | string\n  | null\n  | ExportsTargetIface[]\n  | { [key: string]: ExportsTargetIface };\n\nconst packageJsonSchema = z.looseObject({\n  name: z.string().optional(),\n  main: z.string().optional(),\n  module: z.string().optional(),\n  exports: conditionsSchema.optional(),\n  imports: z.record(z.string(), conditionsSchema).optional(),\n  devDependencies: z.record(z.string(), z.string()).optional(),\n  dependencies: z.record(z.string(), z.string()).optional(),\n});\n\nexport type PackageJsonIface = z.infer<typeof packageJsonSchema>;\n\nexport const parsePackageJson = (text: string | undefined): PackageJsonIface | null => {\n  if (text == null) return null;\n  try {\n    const parsed = packageJsonSchema.safeParse(JSON.parse(text));\n    return parsed.success ? parsed.data : null;\n  } catch {\n    return null;\n  }\n};\n\n// The conditions the Worker build resolves with (`import` for ESM imports,\n// `require` for require() calls); a conditions object picks its first key,\n// in declaration order, that is one of them.\nconst conditionsFor = (require: boolean): ReadonlySet<string> =>\n  new Set(['workerd', 'worker', 'browser', require ? 'require' : 'import', 'module', 'default']);\n\n// Node's target resolution: a conditions object takes its first active\n// condition that matches; an explicit null excludes the export (resolution\n// stops); a nested object with no active condition is unmatched (try on).\nenum PickKind {\n  Matched = 'matched',\n  Excluded = 'excluded',\n  Unmatched = 'unmatched',\n}\n\ntype PickIface =\n  | { kind: PickKind.Matched; path: string }\n  | { kind: PickKind.Excluded | PickKind.Unmatched };\n\nconst pick = (target: ExportsTargetIface, conditions: ReadonlySet<string>): PickIface => {\n  if (target == null) return { kind: PickKind.Excluded };\n  const text = z.string().safeParse(target);\n  if (text.success) return { kind: PickKind.Matched, path: text.data };\n  if (Array.isArray(target)) {\n    let excluded = false;\n    for (const item of target) {\n      const picked = pick(item, conditions);\n      excluded ||= picked.kind === PickKind.Excluded;\n      if (\n        picked.kind === PickKind.Matched &&\n        picked.path.startsWith('./') &&\n        !picked.path\n          .split('/')\n          .slice(1)\n          .some((part) => part === '..' || part === 'node_modules')\n      )\n        return picked;\n    }\n    return { kind: excluded ? PickKind.Excluded : PickKind.Unmatched };\n  }\n  const record = z.record(z.string(), conditionsSchema).safeParse(target);\n  if (!record.success) return { kind: PickKind.Unmatched };\n  for (const [condition, value] of Object.entries(record.data)) {\n    if (!conditions.has(condition)) continue;\n    const picked = pick(value, conditions);\n    if (picked.kind !== PickKind.Unmatched) return picked;\n  }\n  return { kind: PickKind.Unmatched };\n};\n\nconst pickTarget = (target: ExportsTargetIface, conditions: ReadonlySet<string>): string | null => {\n  const picked = pick(target, conditions);\n  return picked.kind === PickKind.Matched ? picked.path : null;\n};\n\n// `exports` for a subpath ('.' or './x'): a subpath map, or the root's\n// conditions/string when the package exports only '.'.\nconst exportFor = (\n  exports: ExportsTargetIface | undefined,\n  subpath: string,\n  conditions: ReadonlySet<string>,\n): string | null => {\n  if (exports == null) return null;\n  const record = z.record(z.string(), conditionsSchema).safeParse(exports);\n  if (\n    record.success &&\n    Object.keys(record.data).some((key) => key.startsWith('.') || key.startsWith('#'))\n  ) {\n    const exact = record.data[subpath];\n    if (exact !== undefined) return pickTarget(exact, conditions);\n    // `./*` patterns: the most specific match (longest prefix, then longest\n    // pattern) wins, as in Node's resolver.\n    let best: { prefix: string; pattern: string; target: ExportsTargetIface } | null = null;\n    for (const [pattern, target] of Object.entries(record.data)) {\n      const star = pattern.indexOf('*');\n      if (star < 0 || pattern.indexOf('*', star + 1) >= 0) continue;\n      const prefix = pattern.slice(0, star);\n      const suffix = pattern.slice(star + 1);\n      if (subpath.length < pattern.length) continue;\n      if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix)) continue;\n      if (\n        best == null ||\n        prefix.length > best.prefix.length ||\n        (prefix.length === best.prefix.length && pattern.length > best.pattern.length)\n      )\n        best = { prefix, pattern, target };\n    }\n    if (best == null) return null;\n    const suffixLength = best.pattern.length - best.prefix.length - 1;\n    const middle = subpath.slice(best.prefix.length, subpath.length - suffixLength);\n    if (middle.split('/').some((part) => part === '.' || part === '..' || part === 'node_modules'))\n      return null;\n    return pickTarget(best.target, conditions)?.replaceAll('*', () => middle) ?? null;\n  }\n  return subpath === '.' ? pickTarget(exports, conditions) : null;\n};\n\nexport const packageImportTarget = (args: {\n  packageJson: string | undefined;\n  specifier: string;\n  require: boolean;\n}): string | null =>\n  exportFor(\n    parsePackageJson(args.packageJson)?.imports,\n    args.specifier,\n    conditionsFor(args.require),\n  );\n\nexport const splitSpecifier = (specifier: string): { name: string; subpath: string } | null => {\n  const segments = specifier.split('/');\n  const nameLength = segments[0]?.startsWith('@') ? 2 : 1;\n  if (segments.length < nameLength || segments.slice(0, nameLength).some((part) => part === ''))\n    return null;\n  const name = segments.slice(0, nameLength).join('/');\n  const rest = segments.slice(nameLength).join('/');\n  return { name, subpath: rest.length === 0 ? '.' : `./${rest}` };\n};\n\n// The package-relative file a specifier's subpath names: its `exports` entry,\n// else `module`/`main` for the root, else the subpath itself; null when the\n// package does not provide it. `wanted` is reported when the target is not in\n// the repository (build output is not read).\nexport interface PackageEntryIface {\n  // The package-relative file, or null when the package does not have it.\n  path: string | null;\n  // The target the package names, for the error when it is missing.\n  wanted: string;\n  // False when the package's `exports` do not export the subpath to Workers.\n  exported: boolean;\n}\n\nexport const packageEntry = (args: {\n  pkg: VendoredPackageIface;\n  subpath: string;\n  // A require() call rather than an import.\n  require: boolean;\n  resolve: (path: string) => string | null;\n}): PackageEntryIface => {\n  const json = parsePackageJson(args.pkg.files['package.json']);\n  const exported = exportFor(json?.exports, args.subpath, conditionsFor(args.require));\n  if ((exported == null || !exported.startsWith('./')) && json?.exports != null)\n    return { path: null, wanted: args.subpath, exported: false };\n  const candidates: string[] = [];\n  if (exported != null) candidates.push(exported);\n  else if (json?.exports == null) {\n    if (args.subpath === '.') {\n      if (json?.module != null) candidates.push(json.module);\n      if (json?.main != null) candidates.push(json.main);\n      candidates.push('./index');\n    } else candidates.push(args.subpath);\n  }\n  for (const candidate of candidates) {\n    const normalized = posix.normalize(candidate).replace(/^\\.\\//, '');\n    if (normalized === '..' || normalized.startsWith('../') || normalized.startsWith('/')) continue;\n    const resolved = args.resolve(normalized);\n    if (resolved != null) return { path: resolved, wanted: candidate, exported: true };\n  }\n  return { path: null, wanted: candidates[0] ?? args.subpath, exported: true };\n};\n\n// npm packages the platform's compiler ships and resolves without installing\n// (this package's own runtime dependencies that run in a Worker); the\n// authoring API is aliased separately.\nexport const PLATFORM_PACKAGES: ReadonlySet<string> = new Set(['zod', 'yaml', 'croner', 're2js']);\n\nexport enum WorkspaceDependencyKind {\n  // `workspace:*`: found by name among the repository's workspace packages.\n  Workspace = 'workspace',\n  // `file:` / `link:`: a directory relative to the declaring package.\n  Path = 'path',\n}\n\nexport interface WorkspaceDependencyIface {\n  name: string;\n  kind: WorkspaceDependencyKind;\n  // For Path: the directory, relative to the declaring package's directory.\n  path: string | null;\n}\n\n// The dependencies of a package.json the platform vendors from the repository.\nexport const workspaceDependencies = (\n  packageJson: string | undefined,\n  includeDevDependencies = true,\n): WorkspaceDependencyIface[] => {\n  const parsed = parsePackageJson(packageJson);\n  const entries = Object.entries(parsed?.dependencies ?? {});\n  if (includeDevDependencies) {\n    for (const entry of Object.entries(parsed?.devDependencies ?? {}))\n      if (!Object.hasOwn(parsed?.dependencies ?? {}, entry[0])) entries.push(entry);\n  }\n  return entries.flatMap(([name, spec]): WorkspaceDependencyIface[] => {\n    if (spec.startsWith('workspace:'))\n      return [{ name, kind: WorkspaceDependencyKind.Workspace, path: null }];\n    const path = /^(?:file|link):(.+)$/u.exec(spec)?.[1];\n    return path == null ? [] : [{ name, kind: WorkspaceDependencyKind.Path, path }];\n  });\n};\n\nexport const declaredDependencyDiagnostics = (args: {\n  packageJson: string | undefined;\n  vendored: ReadonlySet<string>;\n  // A checkout compiled in place resolves its installed node_modules.\n  local: boolean;\n}): DiagnosticIface[] => {\n  const json = parsePackageJson(args.packageJson);\n  if (json == null) return [];\n  const workspace = new Set(workspaceDependencies(args.packageJson).map((entry) => entry.name));\n  const out: DiagnosticIface[] = [];\n  for (const name of Object.keys(json.dependencies ?? {})) {\n    if (args.vendored.has(name) || PLATFORM_PACKAGES.has(name)) continue;\n    if (name === '@finalai/agents' || name.startsWith('@finalai/')) continue;\n    if (workspace.has(name)) {\n      if (args.local) continue;\n      // A warning: importing it fails to bundle, declaring it alone does not.\n      out.push(\n        diagnostic({\n          severity: DiagnosticSeverity.Warning,\n          code: DiagnosticCode.Dependencies,\n          message: `package.json depends on the workspace package ${name}, which was not found in the repository at this commit`,\n          path: 'package.json',\n        }),\n      );\n      continue;\n    }\n    out.push(\n      diagnostic({\n        severity: DiagnosticSeverity.Warning,\n        code: DiagnosticCode.Dependencies,\n        message: `package.json depends on ${name} from npm; agents are compiled without installing npm packages, so only workspace packages from this repository and ${[...PLATFORM_PACKAGES].join(', ')} can be imported`,\n        path: 'package.json',\n      }),\n    );\n  }\n  return out;\n};\n\n// Where a `workspace:` dependency can live: the repository root's\n// pnpm-workspace.yaml `packages`, else its package.json `workspaces`.\nconst pnpmWorkspaceSchema = z.looseObject({ packages: z.array(z.string()).optional() });\nconst rootWorkspacesSchema = z.looseObject({\n  workspaces: z\n    .union([z.array(z.string()), z.looseObject({ packages: z.array(z.string()).optional() })])\n    .optional(),\n});\n\nexport const workspacePackageGlobs = (args: {\n  pnpmWorkspaceYaml: string | undefined;\n  rootPackageJson: string | undefined;\n}): string[] => {\n  if (args.pnpmWorkspaceYaml != null) {\n    try {\n      const parsed = pnpmWorkspaceSchema.safeParse(parseYaml(args.pnpmWorkspaceYaml));\n      if (parsed.success && parsed.data.packages != null) return parsed.data.packages;\n    } catch {\n      // An unreadable workspace file names no packages.\n    }\n  }\n  if (args.rootPackageJson == null) return [];\n  try {\n    const parsed = rootWorkspacesSchema.safeParse(JSON.parse(args.rootPackageJson));\n    const workspaces = parsed.success ? parsed.data.workspaces : undefined;\n    if (workspaces == null) return [];\n    return Array.isArray(workspaces) ? workspaces : (workspaces.packages ?? []);\n  } catch {\n    return [];\n  }\n};\n\n// `packages/*` (one segment), `packages/**` (any depth) and exact directories;\n// `!` patterns exclude.\nconst expandGlob = (glob: string): string[] => {\n  if (glob.length > 512) throw new Error('Workspace glob exceeds 512 characters.');\n  let variants = [glob];\n  while (true) {\n    const next: string[] = [];\n    let expanded = false;\n    for (const variant of variants) {\n      const brace = /\\{([^{}]+)\\}/u.exec(variant);\n      if (brace?.[1] == null) next.push(variant);\n      else {\n        expanded = true;\n        for (const choice of brace[1].split(',')) {\n          if (next.length >= 128) throw new Error('Workspace globs exceed 128 expanded patterns.');\n          next.push(\n            variant.slice(0, brace.index) + choice + variant.slice(brace.index + brace[0].length),\n          );\n        }\n      }\n    }\n    if (next.length > 128) throw new Error('Workspace globs exceed 128 expanded patterns.');\n    if (!expanded) return next;\n    variants = next;\n  }\n};\n\ninterface GlobMatchOptionsIface {\n  directory: string;\n  glob: string;\n  consumeWork: () => void;\n}\n\nconst segmentMatches = ({ directory, glob, consumeWork }: GlobMatchOptionsIface): boolean => {\n  const text = Array.from(directory);\n  const tokens = Array.from(glob);\n  let d = 0;\n  let p = 0;\n  let star: number | null = null;\n  let matched = 0;\n  while (d < text.length) {\n    consumeWork();\n    if (tokens[p] === '?' || (tokens[p] !== '*' && tokens[p] === text[d])) {\n      d += 1;\n      p += 1;\n    } else if (tokens[p] === '*') {\n      star = p;\n      p += 1;\n      matched = d;\n    } else if (star != null) {\n      p = star + 1;\n      matched += 1;\n      d = matched;\n    } else return false;\n  }\n  while (tokens[p] === '*') p += 1;\n  return p === tokens.length;\n};\n\nconst globMatches = ({ directory, glob, consumeWork }: GlobMatchOptionsIface): boolean => {\n  const dirParts = directory.split('/');\n  const parts = glob.replace(/^\\.\\//u, '').replace(/\\/+$/u, '').split('/');\n  const memo = new Map<string, boolean>();\n  const walk = (d: number, p: number): boolean => {\n    consumeWork();\n    const key = `${d}:${p}`;\n    const existing = memo.get(key);\n    if (existing != null) return existing;\n    const part = parts[p];\n    const found =\n      p === parts.length\n        ? d === dirParts.length\n        : part === '**'\n          ? walk(d, p + 1) || (d < dirParts.length && walk(d + 1, p))\n          : d < dirParts.length &&\n            part != null &&\n            segmentMatches({ directory: dirParts[d] ?? '', glob: part, consumeWork }) &&\n            walk(d + 1, p + 1);\n    memo.set(key, found);\n    return found;\n  };\n  return walk(0, 0);\n};\n\n// Directories that may hold workspace package `name`, most likely first\n// (the directory named like the package), from the repository's file list.\nexport const workspacePackageCandidates = (args: {\n  paths: readonly string[];\n  globs: readonly string[];\n  name: string;\n}): string[] => {\n  const expanded: string[] = [];\n  for (const glob of args.globs) {\n    const patterns = expandGlob(glob);\n    if (expanded.length + patterns.length > 128)\n      throw new Error('Workspace globs exceed 128 expanded patterns.');\n    expanded.push(...patterns);\n  }\n  let remainingWork = 1_000_000;\n  const consumeWork = () => {\n    remainingWork -= 1;\n    if (remainingWork < 0)\n      throw new Error(\n        'Workspace glob matching exceeds its work budget; use narrower globs or file: dependencies.',\n      );\n  };\n  const include = expanded.filter((glob) => !glob.startsWith('!'));\n  const exclude = expanded.filter((glob) => glob.startsWith('!')).map((glob) => glob.slice(1));\n  const unscoped = args.name.split('/').at(-1) ?? args.name;\n  const directories = args.paths\n    .filter((path) => path.endsWith('/package.json') && !path.split('/').includes('node_modules'))\n    .map((path) => path.slice(0, -'/package.json'.length))\n    .filter(\n      (directory) =>\n        include.some((glob) => globMatches({ directory, glob, consumeWork })) &&\n        !exclude.some((glob) => globMatches({ directory, glob, consumeWork })),\n    );\n  return directories.toSorted(\n    (a, b) =>\n      Number(posix.basename(b) === unscoped) - Number(posix.basename(a) === unscoped) ||\n      (a < b ? -1 : a > b ? 1 : 0),\n  );\n};\n"],
+  "mappings": "AAAA,SAAS,aAAa;AACtB,SAAS,SAAS,iBAAiB;AACnC,YAAY,OAAO;AACnB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAiBP,MAAM,mBAAkD,EAAE;AAAA,EAAK,MAC7D,EAAE,MAAM;AAAA,IACN,EAAE,OAAO;AAAA,IACT,EAAE,KAAK;AAAA,IACP,EAAE,MAAM,gBAAgB;AAAA,IACxB,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB;AAAA,EACvC,CAAC;AACH;AAOA,MAAM,oBAAoB,EAAE,YAAY;AAAA,EACtC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,SAAS,iBAAiB,SAAS;AAAA,EACnC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,EAAE,SAAS;AAAA,EACzD,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EAC3D,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS;AAC1D,CAAC;AAIM,MAAM,mBAAmB,CAAC,SAAsD;AACrF,MAAI,QAAQ,KAAM,QAAO;AACzB,MAAI;AACF,UAAM,SAAS,kBAAkB,UAAU,KAAK,MAAM,IAAI,CAAC;AAC3D,WAAO,OAAO,UAAU,OAAO,OAAO;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKA,MAAM,gBAAgB,CAACA,aACrB,oBAAI,IAAI,CAAC,WAAW,UAAU,WAAWA,WAAU,YAAY,UAAU,UAAU,SAAS,CAAC;AAK/F,IAAK,WAAL,kBAAKC,cAAL;AACE,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,eAAY;AAHT,SAAAA;AAAA,GAAA;AAUL,MAAM,OAAO,CAAC,QAA4B,eAA+C;AACvF,MAAI,UAAU,KAAM,QAAO,EAAE,MAAM,0BAAkB;AACrD,QAAM,OAAO,EAAE,OAAO,EAAE,UAAU,MAAM;AACxC,MAAI,KAAK,QAAS,QAAO,EAAE,MAAM,yBAAkB,MAAM,KAAK,KAAK;AACnE,MAAI,MAAM,QAAQ,MAAM,GAAG;AACzB,QAAI,WAAW;AACf,eAAW,QAAQ,QAAQ;AACzB,YAAM,SAAS,KAAK,MAAM,UAAU;AACpC,mBAAa,OAAO,SAAS;AAC7B,UACE,OAAO,SAAS,2BAChB,OAAO,KAAK,WAAW,IAAI,KAC3B,CAAC,OAAO,KACL,MAAM,GAAG,EACT,MAAM,CAAC,EACP,KAAK,CAAC,SAAS,SAAS,QAAQ,SAAS,cAAc;AAE1D,eAAO;AAAA,IACX;AACA,WAAO,EAAE,MAAM,WAAW,4BAAoB,4BAAmB;AAAA,EACnE;AACA,QAAM,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,EAAE,UAAU,MAAM;AACtE,MAAI,CAAC,OAAO,QAAS,QAAO,EAAE,MAAM,4BAAmB;AACvD,aAAW,CAAC,WAAW,KAAK,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC5D,QAAI,CAAC,WAAW,IAAI,SAAS,EAAG;AAChC,UAAM,SAAS,KAAK,OAAO,UAAU;AACrC,QAAI,OAAO,SAAS,4BAAoB,QAAO;AAAA,EACjD;AACA,SAAO,EAAE,MAAM,4BAAmB;AACpC;AAEA,MAAM,aAAa,CAAC,QAA4B,eAAmD;AACjG,QAAM,SAAS,KAAK,QAAQ,UAAU;AACtC,SAAO,OAAO,SAAS,0BAAmB,OAAO,OAAO;AAC1D;AAIA,MAAM,YAAY,CAChB,SACA,SACA,eACkB;AAClB,MAAI,WAAW,KAAM,QAAO;AAC5B,QAAM,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,gBAAgB,EAAE,UAAU,OAAO;AACvE,MACE,OAAO,WACP,OAAO,KAAK,OAAO,IAAI,EAAE,KAAK,CAAC,QAAQ,IAAI,WAAW,GAAG,KAAK,IAAI,WAAW,GAAG,CAAC,GACjF;AACA,UAAM,QAAQ,OAAO,KAAK,OAAO;AACjC,QAAI,UAAU,OAAW,QAAO,WAAW,OAAO,UAAU;AAG5D,QAAI,OAA+E;AACnF,eAAW,CAAC,SAAS,MAAM,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AAC3D,YAAM,OAAO,QAAQ,QAAQ,GAAG;AAChC,UAAI,OAAO,KAAK,QAAQ,QAAQ,KAAK,OAAO,CAAC,KAAK,EAAG;AACrD,YAAM,SAAS,QAAQ,MAAM,GAAG,IAAI;AACpC,YAAM,SAAS,QAAQ,MAAM,OAAO,CAAC;AACrC,UAAI,QAAQ,SAAS,QAAQ,OAAQ;AACrC,UAAI,CAAC,QAAQ,WAAW,MAAM,KAAK,CAAC,QAAQ,SAAS,MAAM,EAAG;AAC9D,UACE,QAAQ,QACR,OAAO,SAAS,KAAK,OAAO,UAC3B,OAAO,WAAW,KAAK,OAAO,UAAU,QAAQ,SAAS,KAAK,QAAQ;AAEvE,eAAO,EAAE,QAAQ,SAAS,OAAO;AAAA,IACrC;AACA,QAAI,QAAQ,KAAM,QAAO;AACzB,UAAM,eAAe,KAAK,QAAQ,SAAS,KAAK,OAAO,SAAS;AAChE,UAAM,SAAS,QAAQ,MAAM,KAAK,OAAO,QAAQ,QAAQ,SAAS,YAAY;AAC9E,QAAI,OAAO,MAAM,GAAG,EAAE,KAAK,CAAC,SAAS,SAAS,OAAO,SAAS,QAAQ,SAAS,cAAc;AAC3F,aAAO;AACT,WAAO,WAAW,KAAK,QAAQ,UAAU,GAAG,WAAW,KAAK,MAAM,MAAM,KAAK;AAAA,EAC/E;AACA,SAAO,YAAY,MAAM,WAAW,SAAS,UAAU,IAAI;AAC7D;AAEO,MAAM,sBAAsB,CAAC,SAKlC;AAAA,EACE,iBAAiB,KAAK,WAAW,GAAG;AAAA,EACpC,KAAK;AAAA,EACL,cAAc,KAAK,OAAO;AAC5B;AAEK,MAAM,iBAAiB,CAAC,cAAgE;AAC7F,QAAM,WAAW,UAAU,MAAM,GAAG;AACpC,QAAM,aAAa,SAAS,CAAC,GAAG,WAAW,GAAG,IAAI,IAAI;AACtD,MAAI,SAAS,SAAS,cAAc,SAAS,MAAM,GAAG,UAAU,EAAE,KAAK,CAAC,SAAS,SAAS,EAAE;AAC1F,WAAO;AACT,QAAM,OAAO,SAAS,MAAM,GAAG,UAAU,EAAE,KAAK,GAAG;AACnD,QAAM,OAAO,SAAS,MAAM,UAAU,EAAE,KAAK,GAAG;AAChD,SAAO,EAAE,MAAM,SAAS,KAAK,WAAW,IAAI,MAAM,KAAK,IAAI,GAAG;AAChE;AAeO,MAAM,eAAe,CAAC,SAMJ;AACvB,QAAM,OAAO,iBAAiB,KAAK,IAAI,MAAM,cAAc,CAAC;AAC5D,QAAM,WAAW,UAAU,MAAM,SAAS,KAAK,SAAS,cAAc,KAAK,OAAO,CAAC;AACnF,OAAK,YAAY,QAAQ,CAAC,SAAS,WAAW,IAAI,MAAM,MAAM,WAAW;AACvE,WAAO,EAAE,MAAM,MAAM,QAAQ,KAAK,SAAS,UAAU,MAAM;AAC7D,QAAM,aAAuB,CAAC;AAC9B,MAAI,YAAY,KAAM,YAAW,KAAK,QAAQ;AAAA,WACrC,MAAM,WAAW,MAAM;AAC9B,QAAI,KAAK,YAAY,KAAK;AACxB,UAAI,MAAM,UAAU,KAAM,YAAW,KAAK,KAAK,MAAM;AACrD,UAAI,MAAM,QAAQ,KAAM,YAAW,KAAK,KAAK,IAAI;AACjD,iBAAW,KAAK,SAAS;AAAA,IAC3B,MAAO,YAAW,KAAK,KAAK,OAAO;AAAA,EACrC;AACA,aAAW,aAAa,YAAY;AAClC,UAAM,aAAa,MAAM,UAAU,SAAS,EAAE,QAAQ,SAAS,EAAE;AACjE,QAAI,eAAe,QAAQ,WAAW,WAAW,KAAK,KAAK,WAAW,WAAW,GAAG,EAAG;AACvF,UAAM,WAAW,KAAK,QAAQ,UAAU;AACxC,QAAI,YAAY,KAAM,QAAO,EAAE,MAAM,UAAU,QAAQ,WAAW,UAAU,KAAK;AAAA,EACnF;AACA,SAAO,EAAE,MAAM,MAAM,QAAQ,WAAW,CAAC,KAAK,KAAK,SAAS,UAAU,KAAK;AAC7E;AAKO,MAAM,oBAAyC,oBAAI,IAAI,CAAC,OAAO,QAAQ,UAAU,OAAO,CAAC;AAEzF,IAAK,0BAAL,kBAAKC,6BAAL;AAEL,EAAAA,yBAAA,eAAY;AAEZ,EAAAA,yBAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AAeL,MAAM,wBAAwB,CACnC,aACA,yBAAyB,SACM;AAC/B,QAAM,SAAS,iBAAiB,WAAW;AAC3C,QAAM,UAAU,OAAO,QAAQ,QAAQ,gBAAgB,CAAC,CAAC;AACzD,MAAI,wBAAwB;AAC1B,eAAW,SAAS,OAAO,QAAQ,QAAQ,mBAAmB,CAAC,CAAC;AAC9D,UAAI,CAAC,OAAO,OAAO,QAAQ,gBAAgB,CAAC,GAAG,MAAM,CAAC,CAAC,EAAG,SAAQ,KAAK,KAAK;AAAA,EAChF;AACA,SAAO,QAAQ,QAAQ,CAAC,CAAC,MAAM,IAAI,MAAkC;AACnE,QAAI,KAAK,WAAW,YAAY;AAC9B,aAAO,CAAC,EAAE,MAAM,MAAM,6BAAmC,MAAM,KAAK,CAAC;AACvE,UAAM,OAAO,wBAAwB,KAAK,IAAI,IAAI,CAAC;AACnD,WAAO,QAAQ,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,MAAM,mBAA8B,KAAK,CAAC;AAAA,EAChF,CAAC;AACH;AAEO,MAAM,gCAAgC,CAAC,SAKrB;AACvB,QAAM,OAAO,iBAAiB,KAAK,WAAW;AAC9C,MAAI,QAAQ,KAAM,QAAO,CAAC;AAC1B,QAAM,YAAY,IAAI,IAAI,sBAAsB,KAAK,WAAW,EAAE,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC;AAC5F,QAAM,MAAyB,CAAC;AAChC,aAAW,QAAQ,OAAO,KAAK,KAAK,gBAAgB,CAAC,CAAC,GAAG;AACvD,QAAI,KAAK,SAAS,IAAI,IAAI,KAAK,kBAAkB,IAAI,IAAI,EAAG;AAC5D,QAAI,SAAS,qBAAqB,KAAK,WAAW,WAAW,EAAG;AAChE,QAAI,UAAU,IAAI,IAAI,GAAG;AACvB,UAAI,KAAK,MAAO;AAEhB,UAAI;AAAA,QACF,WAAW;AAAA,UACT,UAAU,mBAAmB;AAAA,UAC7B,MAAM,eAAe;AAAA,UACrB,SAAS,iDAAiD,IAAI;AAAA,UAC9D,MAAM;AAAA,QACR,CAAC;AAAA,MACH;AACA;AAAA,IACF;AACA,QAAI;AAAA,MACF,WAAW;AAAA,QACT,UAAU,mBAAmB;AAAA,QAC7B,MAAM,eAAe;AAAA,QACrB,SAAS,2BAA2B,IAAI,uHAAuH,CAAC,GAAG,iBAAiB,EAAE,KAAK,IAAI,CAAC;AAAA,QAChM,MAAM;AAAA,MACR,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;AAIA,MAAM,sBAAsB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;AACtF,MAAM,uBAAuB,EAAE,YAAY;AAAA,EACzC,YAAY,EACT,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EACxF,SAAS;AACd,CAAC;AAEM,MAAM,wBAAwB,CAAC,SAGtB;AACd,MAAI,KAAK,qBAAqB,MAAM;AAClC,QAAI;AACF,YAAM,SAAS,oBAAoB,UAAU,UAAU,KAAK,iBAAiB,CAAC;AAC9E,UAAI,OAAO,WAAW,OAAO,KAAK,YAAY,KAAM,QAAO,OAAO,KAAK;AAAA,IACzE,QAAQ;AAAA,IAER;AAAA,EACF;AACA,MAAI,KAAK,mBAAmB,KAAM,QAAO,CAAC;AAC1C,MAAI;AACF,UAAM,SAAS,qBAAqB,UAAU,KAAK,MAAM,KAAK,eAAe,CAAC;AAC9E,UAAM,aAAa,OAAO,UAAU,OAAO,KAAK,aAAa;AAC7D,QAAI,cAAc,KAAM,QAAO,CAAC;AAChC,WAAO,MAAM,QAAQ,UAAU,IAAI,aAAc,WAAW,YAAY,CAAC;AAAA,EAC3E,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAIA,MAAM,aAAa,CAAC,SAA2B;AAC7C,MAAI,KAAK,SAAS,IAAK,OAAM,IAAI,MAAM,wCAAwC;AAC/E,MAAI,WAAW,CAAC,IAAI;AACpB,SAAO,MAAM;AACX,UAAM,OAAiB,CAAC;AACxB,QAAI,WAAW;AACf,eAAW,WAAW,UAAU;AAC9B,YAAM,QAAQ,gBAAgB,KAAK,OAAO;AAC1C,UAAI,QAAQ,CAAC,KAAK,KAAM,MAAK,KAAK,OAAO;AAAA,WACpC;AACH,mBAAW;AACX,mBAAW,UAAU,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG;AACxC,cAAI,KAAK,UAAU,IAAK,OAAM,IAAI,MAAM,+CAA+C;AACvF,eAAK;AAAA,YACH,QAAQ,MAAM,GAAG,MAAM,KAAK,IAAI,SAAS,QAAQ,MAAM,MAAM,QAAQ,MAAM,CAAC,EAAE,MAAM;AAAA,UACtF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AACA,QAAI,KAAK,SAAS,IAAK,OAAM,IAAI,MAAM,+CAA+C;AACtF,QAAI,CAAC,SAAU,QAAO;AACtB,eAAW;AAAA,EACb;AACF;AAQA,MAAM,iBAAiB,CAAC,EAAE,WAAW,MAAM,YAAY,MAAsC;AAC3F,QAAM,OAAO,MAAM,KAAK,SAAS;AACjC,QAAM,SAAS,MAAM,KAAK,IAAI;AAC9B,MAAI,IAAI;AACR,MAAI,IAAI;AACR,MAAI,OAAsB;AAC1B,MAAI,UAAU;AACd,SAAO,IAAI,KAAK,QAAQ;AACtB,gBAAY;AACZ,QAAI,OAAO,CAAC,MAAM,OAAQ,OAAO,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,GAAI;AACrE,WAAK;AACL,WAAK;AAAA,IACP,WAAW,OAAO,CAAC,MAAM,KAAK;AAC5B,aAAO;AACP,WAAK;AACL,gBAAU;AAAA,IACZ,WAAW,QAAQ,MAAM;AACvB,UAAI,OAAO;AACX,iBAAW;AACX,UAAI;AAAA,IACN,MAAO,QAAO;AAAA,EAChB;AACA,SAAO,OAAO,CAAC,MAAM,IAAK,MAAK;AAC/B,SAAO,MAAM,OAAO;AACtB;AAEA,MAAM,cAAc,CAAC,EAAE,WAAW,MAAM,YAAY,MAAsC;AACxF,QAAM,WAAW,UAAU,MAAM,GAAG;AACpC,QAAM,QAAQ,KAAK,QAAQ,UAAU,EAAE,EAAE,QAAQ,SAAS,EAAE,EAAE,MAAM,GAAG;AACvE,QAAM,OAAO,oBAAI,IAAqB;AACtC,QAAM,OAAO,CAAC,GAAW,MAAuB;AAC9C,gBAAY;AACZ,UAAM,MAAM,GAAG,CAAC,IAAI,CAAC;AACrB,UAAM,WAAW,KAAK,IAAI,GAAG;AAC7B,QAAI,YAAY,KAAM,QAAO;AAC7B,UAAM,OAAO,MAAM,CAAC;AACpB,UAAM,QACJ,MAAM,MAAM,SACR,MAAM,SAAS,SACf,SAAS,OACP,KAAK,GAAG,IAAI,CAAC,KAAM,IAAI,SAAS,UAAU,KAAK,IAAI,GAAG,CAAC,IACvD,IAAI,SAAS,UACb,QAAQ,QACR,eAAe,EAAE,WAAW,SAAS,CAAC,KAAK,IAAI,MAAM,MAAM,YAAY,CAAC,KACxE,KAAK,IAAI,GAAG,IAAI,CAAC;AACzB,SAAK,IAAI,KAAK,KAAK;AACnB,WAAO;AAAA,EACT;AACA,SAAO,KAAK,GAAG,CAAC;AAClB;AAIO,MAAM,6BAA6B,CAAC,SAI3B;AACd,QAAM,WAAqB,CAAC;AAC5B,aAAW,QAAQ,KAAK,OAAO;AAC7B,UAAM,WAAW,WAAW,IAAI;AAChC,QAAI,SAAS,SAAS,SAAS,SAAS;AACtC,YAAM,IAAI,MAAM,+CAA+C;AACjE,aAAS,KAAK,GAAG,QAAQ;AAAA,EAC3B;AACA,MAAI,gBAAgB;AACpB,QAAM,cAAc,MAAM;AACxB,qBAAiB;AACjB,QAAI,gBAAgB;AAClB,YAAM,IAAI;AAAA,QACR;AAAA,MACF;AAAA,EACJ;AACA,QAAM,UAAU,SAAS,OAAO,CAAC,SAAS,CAAC,KAAK,WAAW,GAAG,CAAC;AAC/D,QAAM,UAAU,SAAS,OAAO,CAAC,SAAS,KAAK,WAAW,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;AAC3F,QAAM,WAAW,KAAK,KAAK,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,KAAK;AACrD,QAAM,cAAc,KAAK,MACtB,OAAO,CAAC,SAAS,KAAK,SAAS,eAAe,KAAK,CAAC,KAAK,MAAM,GAAG,EAAE,SAAS,cAAc,CAAC,EAC5F,IAAI,CAAC,SAAS,KAAK,MAAM,GAAG,CAAC,gBAAgB,MAAM,CAAC,EACpD;AAAA,IACC,CAAC,cACC,QAAQ,KAAK,CAAC,SAAS,YAAY,EAAE,WAAW,MAAM,YAAY,CAAC,CAAC,KACpE,CAAC,QAAQ,KAAK,CAAC,SAAS,YAAY,EAAE,WAAW,MAAM,YAAY,CAAC,CAAC;AAAA,EACzE;AACF,SAAO,YAAY;AAAA,IACjB,CAAC,GAAG,MACF,OAAO,MAAM,SAAS,CAAC,MAAM,QAAQ,IAAI,OAAO,MAAM,SAAS,CAAC,MAAM,QAAQ,MAC7E,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI;AAAA,EAC9B;AACF;",
+  "names": ["require", "PickKind", "WorkspaceDependencyKind"]
+}

package/dist/modules/index.d.mts

@@ -0,0 +1,7 @@
+export * from "./authoring/index.mjs";
+export * from "./manifest.mjs";
+export { SlotValueKind, resolveManifest, resolveManifestDetailed, slotKindOf, validateSlotValue, } from "./resolve.mjs";
+export type { ResolveManifestArgsIface, ResolveSlot, ResolvedManifestDetailIface } from "./resolve.mjs";
+export type { AgentBundleIface } from "./runtime/bundle.mjs";
+export type { ChannelRouteArgsIface, ChannelSocketArgsIface, DispatchHookArgsIface, IsolateRuntimeIface, ResolveDynamicArgsIface, RunToolArgsIface, RunToolResultIface, } from "./runtime/isolate.mjs";
+export { AGENT_DYNAMIC_PREFIX, AUTHORED_SERVER_KEY, COMBINED_MCP_SERVERS_EXPORT, } from "./runtime/layout.mjs";

package/dist/modules/index.mjs

@@ -0,0 +1,25 @@
+export * from "./authoring/index.mjs";
+export * from "./manifest.mjs";
+import {
+  SlotValueKind,
+  resolveManifest,
+  resolveManifestDetailed,
+  slotKindOf,
+  validateSlotValue
+} from "./resolve.mjs";
+import {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT
+} from "./runtime/layout.mjs";
+export {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT,
+  SlotValueKind,
+  resolveManifest,
+  resolveManifestDetailed,
+  slotKindOf,
+  validateSlotValue
+};
+//# sourceMappingURL=index.mjs.map

package/dist/modules/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/index.ts"],
+  "sourcesContent": ["// Authoring API, the manifest schema and per-session dynamic resolution. The\n// compiler (esbuild, Node) is `@finalai/agent-definition/compiler`; the\n// compatibility report (ajv) is `@finalai/agent-definition/compatibility`.\nexport * from \"./authoring/index.mjs\";\nexport * from \"./manifest.mjs\";\nexport {\n  SlotValueKind,\n  resolveManifest,\n  resolveManifestDetailed,\n  slotKindOf,\n  validateSlotValue,\n} from \"./resolve.mjs\";\nexport type { ResolveManifestArgsIface, ResolveSlot, ResolvedManifestDetailIface } from \"./resolve.mjs\";\nexport type { AgentBundleIface } from \"./runtime/bundle.mjs\";\nexport type {\n  ChannelRouteArgsIface,\n  ChannelSocketArgsIface,\n  DispatchHookArgsIface,\n  IsolateRuntimeIface,\n  ResolveDynamicArgsIface,\n  RunToolArgsIface,\n  RunToolResultIface,\n} from \"./runtime/isolate.mjs\";\nexport {\n  AGENT_DYNAMIC_PREFIX,\n  AUTHORED_SERVER_KEY,\n  COMBINED_MCP_SERVERS_EXPORT,\n} from \"./runtime/layout.mjs\";\n"],
+  "mappings": "AAGA,cAAc;AACd,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAYP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;",
+  "names": []
+}

package/dist/modules/manifest.d.mts

@@ -0,0 +1,2 @@
+export { BaseCapability, DynamicEvent, InstructionRole, MANIFEST_VERSION, McpServerBindingKind, SandboxAccess, SandboxAttach, ScheduleTarget, ToolApproval, agentManifestSchema, baseToolsSchema, bundleSchema, channelBindingSchema, dynamicSlotSchema, emptyManifest, findDynamicSlots, harnessBindingSchema, hookBindingSchema, httpMcpServerBindingSchema, identitySchema, instructionFragmentSchema, isDynamicSlot, mcpAuthSchema, mcpServerBindingSchema, resolvedAgentManifestSchema, sandboxBindingSchema, scheduleDefinitionSchema, skillBundleSchema, skillFileSchema, toolDescriptorSchema, workerMcpServerBindingSchema, } from '@finalai/agent-provider';
+export type { AgentManifestIface, BaseToolsIface, BundleIface, ChannelBindingIface, DynamicSlotIface, DynamicSlotLocationIface, HarnessBindingIface, HookBindingIface, HttpMcpServerBindingIface, IdentityIface, InstructionFragmentIface, McpAuth, McpServerBinding, ResolvedAgentManifestIface, ResolvedSandboxBindingIface, SandboxBindingIface, ScheduleDefinitionIface, SkillBundleIface, ToolDescriptorIface, WorkerMcpServerBindingIface, } from '@finalai/agent-provider';