@finalai/agent-definition 0.1.0

package/dist/modules/compiler/files.mjs

@@ -0,0 +1,90 @@
+import { readdir, readFile, realpath } from "node:fs/promises";
+import { join, posix, sep } from "node:path";
+const MAX_FILES = 400;
+const MAX_DEPTH = 10;
+const MAX_FILE_BYTES = 512e3;
+const IGNORED_NAME = (name) => name.startsWith(".") || name === "node_modules" || name === "__tests__" || /\.(test|spec)\.[cm]?[jt]sx?$/.test(name);
+const isResourcePath = (path) => path.startsWith("workspace/") || path.startsWith("skills/");
+const ignoredResourceName = (name) => name === ".git" || name === "node_modules" || name === ".DS_Store" || name.startsWith("._") || name === ".env" || name.startsWith(".env.") && ![".env.example", ".env.template"].includes(name);
+const readAgentDirectory = async (directory) => {
+  const root = await realpath(directory);
+  const files = {};
+  let count = 0;
+  const walk = async (relative, depth) => {
+    if (depth > MAX_DEPTH) throw new Error("Agent directory nesting is too deep");
+    const absolute = relative.length === 0 ? root : join(root, ...relative.split("/"));
+    const children = await readdir(absolute, { withFileTypes: true });
+    for (const child of children.toSorted((a, b) => a.name.localeCompare(b.name))) {
+      const path = relative.length === 0 ? child.name : `${relative}/${child.name}`;
+      if (isResourcePath(path) ? ignoredResourceName(child.name) : IGNORED_NAME(child.name))
+        continue;
+      const target = await realpath(join(absolute, child.name));
+      if (target !== root && !target.startsWith(`${root}${sep}`)) {
+        throw new Error(`${path} leaves the agent directory`);
+      }
+      if (child.isDirectory() || child.isSymbolicLink() && await readdir(target).then(
+        () => true,
+        () => false
+      )) {
+        await walk(path, depth + 1);
+        continue;
+      }
+      count += 1;
+      if (count > MAX_FILES) throw new Error(`Agent directory has more than ${MAX_FILES} files`);
+      const bytes = await readFile(target);
+      if (bytes.byteLength > MAX_FILE_BYTES)
+        throw new Error(`${path} is larger than ${MAX_FILE_BYTES} bytes`);
+      let text;
+      try {
+        text = new TextDecoder("utf-8", { fatal: isResourcePath(path), ignoreBOM: true }).decode(
+          bytes
+        );
+      } catch {
+        throw new Error(
+          `${path} must contain valid UTF-8 text; binary workspace and skill resources are unsupported`
+        );
+      }
+      files[path] = text;
+    }
+  };
+  await walk("", 0);
+  return { root, files };
+};
+const normalizeFiles = (input, options = {}) => {
+  const files = {};
+  const problems = [];
+  for (const [rawPath, content] of Object.entries(input)) {
+    const path = posix.normalize(rawPath.replaceAll("\\", "/")).replace(/^\.\//, "");
+    if (path.startsWith("/") || path === ".." || path.startsWith("../") || path.length === 0) {
+      problems.push({
+        path: rawPath,
+        message: "file paths must be relative and stay inside the agent directory"
+      });
+      continue;
+    }
+    if (path.split("/").some(isResourcePath(path) ? ignoredResourceName : IGNORED_NAME)) continue;
+    if (options.enforceSizeLimits !== false && Buffer.byteLength(content) > MAX_FILE_BYTES) {
+      problems.push({ path, message: `larger than ${MAX_FILE_BYTES} bytes` });
+      continue;
+    }
+    files[path] = content;
+  }
+  if (options.enforceSizeLimits !== false && Object.keys(files).length > MAX_FILES) {
+    problems.push({ path: ".", message: `more than ${MAX_FILES} files` });
+  }
+  return { files, problems };
+};
+const preparationFiles = (files) => Object.fromEntries(
+  Object.entries(files).filter(
+    ([path]) => path.startsWith("workspace/") || path.startsWith("skills/")
+  )
+);
+export {
+  MAX_DEPTH,
+  MAX_FILES,
+  MAX_FILE_BYTES,
+  normalizeFiles,
+  preparationFiles,
+  readAgentDirectory
+};
+//# sourceMappingURL=files.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/files.ts"],
+  "sourcesContent": ["import { readdir, readFile, realpath } from 'node:fs/promises';\nimport { join, posix, sep } from 'node:path';\n\nexport const MAX_FILES = 400;\nexport const MAX_DEPTH = 10;\nexport const MAX_FILE_BYTES = 512_000;\n\nconst IGNORED_NAME = (name: string): boolean =>\n  name.startsWith('.') ||\n  name === 'node_modules' ||\n  name === '__tests__' ||\n  /\\.(test|spec)\\.[cm]?[jt]sx?$/.test(name);\nconst isResourcePath = (path: string): boolean =>\n  path.startsWith('workspace/') || path.startsWith('skills/');\nconst ignoredResourceName = (name: string): boolean =>\n  name === '.git' ||\n  name === 'node_modules' ||\n  name === '.DS_Store' ||\n  name.startsWith('._') ||\n  name === '.env' ||\n  (name.startsWith('.env.') && !['.env.example', '.env.template'].includes(name));\n\nexport interface DirectoryFilesIface {\n  root: string;\n  files: Record<string, string>;\n}\n\n// Reads an agent directory into a path \u2192 text map (directory-relative,\n// forward slashes). Symlinks that leave the directory are rejected.\nexport const readAgentDirectory = async (directory: string): Promise<DirectoryFilesIface> => {\n  const root = await realpath(directory);\n  const files: Record<string, string> = {};\n  let count = 0;\n  const walk = async (relative: string, depth: number): Promise<void> => {\n    if (depth > MAX_DEPTH) throw new Error('Agent directory nesting is too deep');\n    const absolute = relative.length === 0 ? root : join(root, ...relative.split('/'));\n    const children = await readdir(absolute, { withFileTypes: true });\n    for (const child of children.toSorted((a, b) => a.name.localeCompare(b.name))) {\n      const path = relative.length === 0 ? child.name : `${relative}/${child.name}`;\n      if (isResourcePath(path) ? ignoredResourceName(child.name) : IGNORED_NAME(child.name))\n        continue;\n      const target = await realpath(join(absolute, child.name));\n      if (target !== root && !target.startsWith(`${root}${sep}`)) {\n        throw new Error(`${path} leaves the agent directory`);\n      }\n      if (\n        child.isDirectory() ||\n        (child.isSymbolicLink() &&\n          (await readdir(target).then(\n            () => true,\n            () => false,\n          )))\n      ) {\n        await walk(path, depth + 1);\n        continue;\n      }\n      count += 1;\n      if (count > MAX_FILES) throw new Error(`Agent directory has more than ${MAX_FILES} files`);\n      const bytes = await readFile(target);\n      if (bytes.byteLength > MAX_FILE_BYTES)\n        throw new Error(`${path} is larger than ${MAX_FILE_BYTES} bytes`);\n      let text: string;\n      try {\n        text = new TextDecoder('utf-8', { fatal: isResourcePath(path), ignoreBOM: true }).decode(\n          bytes,\n        );\n      } catch {\n        throw new Error(\n          `${path} must contain valid UTF-8 text; binary workspace and skill resources are unsupported`,\n        );\n      }\n      files[path] = text;\n    }\n  };\n  await walk('', 0);\n  return { root, files };\n};\n\nexport interface NormalizedFilesIface {\n  files: Record<string, string>;\n  problems: { path: string; message: string }[];\n}\n\n// Normalizes a caller-supplied file map: forward slashes, no leading './',\n// nothing outside the directory, ignored names dropped.\nexport const normalizeFiles = (\n  input: Record<string, string>,\n  options: { enforceSizeLimits?: boolean } = {},\n): NormalizedFilesIface => {\n  const files: Record<string, string> = {};\n  const problems: { path: string; message: string }[] = [];\n  for (const [rawPath, content] of Object.entries(input)) {\n    const path = posix.normalize(rawPath.replaceAll('\\\\', '/')).replace(/^\\.\\//, '');\n    if (path.startsWith('/') || path === '..' || path.startsWith('../') || path.length === 0) {\n      problems.push({\n        path: rawPath,\n        message: 'file paths must be relative and stay inside the agent directory',\n      });\n      continue;\n    }\n    if (path.split('/').some(isResourcePath(path) ? ignoredResourceName : IGNORED_NAME)) continue;\n    if (options.enforceSizeLimits !== false && Buffer.byteLength(content) > MAX_FILE_BYTES) {\n      problems.push({ path, message: `larger than ${MAX_FILE_BYTES} bytes` });\n      continue;\n    }\n    files[path] = content;\n  }\n  if (options.enforceSizeLimits !== false && Object.keys(files).length > MAX_FILES) {\n    problems.push({ path: '.', message: `more than ${MAX_FILES} files` });\n  }\n  return { files, problems };\n};\n\nexport const preparationFiles = (files: Record<string, string>): Record<string, string> =>\n  Object.fromEntries(\n    Object.entries(files).filter(\n      ([path]) => path.startsWith('workspace/') || path.startsWith('skills/'),\n    ),\n  );\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,9 @@
+import { type JsonObject } from '@finalai/agent-provider';
+export interface FrontMatterIface {
+    data: JsonObject;
+    body: string;
+    error: string | null;
+}
+export declare const parseFrontMatter: (text: string) => FrontMatterIface;
+export declare const frontMatterString: (data: JsonObject, key: string) => string | null;
+export declare const firstParagraphLine: (markdown: string) => string | null;

package/dist/modules/compiler/frontmatter.mjs

@@ -0,0 +1,34 @@
+import { jsonObjectSchema } from "@finalai/agent-provider";
+import { parse } from "yaml";
+import * as z from "zod";
+const parseFrontMatter = (text) => {
+  const normalized = text.replace(/^/, "").replaceAll("\r\n", "\n");
+  if (!normalized.startsWith("---\n")) return { data: {}, body: normalized, error: null };
+  const end = normalized.indexOf("\n---", 4);
+  if (end < 0) return { data: {}, body: normalized, error: "front matter is not closed with ---" };
+  const yamlText = normalized.slice(4, end);
+  const rest = normalized.slice(end + 4).replace(/^[^\n]*\n?/, "");
+  let data;
+  try {
+    data = parse(yamlText);
+  } catch (cause) {
+    const detail = cause instanceof Error ? cause.message : String(cause);
+    return { data: {}, body: rest, error: `front matter is not valid YAML: ${detail}` };
+  }
+  if (data == null) return { data: {}, body: rest, error: null };
+  const parsed = jsonObjectSchema.safeParse(data);
+  if (!parsed.success)
+    return { data: {}, body: rest, error: "front matter must be a YAML mapping" };
+  return { data: parsed.data, body: rest, error: null };
+};
+const frontMatterString = (data, key) => {
+  const parsed = z.string().safeParse(data[key]);
+  return parsed.success ? parsed.data : null;
+};
+const firstParagraphLine = (markdown) => markdown.split("\n").map((line) => line.trim()).find((line) => line.length > 0 && !line.startsWith("```"))?.replace(/^[#>*-]+\s*/, "") ?? null;
+export {
+  firstParagraphLine,
+  frontMatterString,
+  parseFrontMatter
+};
+//# sourceMappingURL=frontmatter.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/frontmatter.ts"],
+  "sourcesContent": ["import { jsonObjectSchema, type JsonObject } from '@finalai/agent-provider';\nimport { parse } from 'yaml';\nimport * as z from 'zod';\n\nexport interface FrontMatterIface {\n  data: JsonObject;\n  body: string;\n  error: string | null;\n}\n\n// `---\\n<yaml>\\n---\\n<body>`; text without front matter is all body.\nexport const parseFrontMatter = (text: string): FrontMatterIface => {\n  const normalized = text.replace(/^\uFEFF/, '').replaceAll('\\r\\n', '\\n');\n  if (!normalized.startsWith('---\\n')) return { data: {}, body: normalized, error: null };\n  const end = normalized.indexOf('\\n---', 4);\n  if (end < 0) return { data: {}, body: normalized, error: 'front matter is not closed with ---' };\n  const yamlText = normalized.slice(4, end);\n  const rest = normalized.slice(end + 4).replace(/^[^\\n]*\\n?/, '');\n  let data;\n  try {\n    data = parse(yamlText);\n  } catch (cause) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    return { data: {}, body: rest, error: `front matter is not valid YAML: ${detail}` };\n  }\n  if (data == null) return { data: {}, body: rest, error: null };\n  const parsed = jsonObjectSchema.safeParse(data);\n  if (!parsed.success)\n    return { data: {}, body: rest, error: 'front matter must be a YAML mapping' };\n  return { data: parsed.data, body: rest, error: null };\n};\n\nexport const frontMatterString = (data: JsonObject, key: string): string | null => {\n  const parsed = z.string().safeParse(data[key]);\n  return parsed.success ? parsed.data : null;\n};\n\nexport const firstParagraphLine = (markdown: string): string | null =>\n  markdown\n    .split('\\n')\n    .map((line) => line.trim())\n    .find((line) => line.length > 0 && !line.startsWith('```'))\n    ?.replace(/^[#>*-]+\\s*/, '') ?? null;\n"],
+  "mappings": "AAAA,SAAS,wBAAyC;AAClD,SAAS,aAAa;AACtB,YAAY,OAAO;AASZ,MAAM,mBAAmB,CAAC,SAAmC;AAClE,QAAM,aAAa,KAAK,QAAQ,MAAM,EAAE,EAAE,WAAW,QAAQ,IAAI;AACjE,MAAI,CAAC,WAAW,WAAW,OAAO,EAAG,QAAO,EAAE,MAAM,CAAC,GAAG,MAAM,YAAY,OAAO,KAAK;AACtF,QAAM,MAAM,WAAW,QAAQ,SAAS,CAAC;AACzC,MAAI,MAAM,EAAG,QAAO,EAAE,MAAM,CAAC,GAAG,MAAM,YAAY,OAAO,sCAAsC;AAC/F,QAAM,WAAW,WAAW,MAAM,GAAG,GAAG;AACxC,QAAM,OAAO,WAAW,MAAM,MAAM,CAAC,EAAE,QAAQ,cAAc,EAAE;AAC/D,MAAI;AACJ,MAAI;AACF,WAAO,MAAM,QAAQ;AAAA,EACvB,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,WAAO,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,OAAO,mCAAmC,MAAM,GAAG;AAAA,EACpF;AACA,MAAI,QAAQ,KAAM,QAAO,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,OAAO,KAAK;AAC7D,QAAM,SAAS,iBAAiB,UAAU,IAAI;AAC9C,MAAI,CAAC,OAAO;AACV,WAAO,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,OAAO,sCAAsC;AAC9E,SAAO,EAAE,MAAM,OAAO,MAAM,MAAM,MAAM,OAAO,KAAK;AACtD;AAEO,MAAM,oBAAoB,CAAC,MAAkB,QAA+B;AACjF,QAAM,SAAS,EAAE,OAAO,EAAE,UAAU,KAAK,GAAG,CAAC;AAC7C,SAAO,OAAO,UAAU,OAAO,OAAO;AACxC;AAEO,MAAM,qBAAqB,CAAC,aACjC,SACG,MAAM,IAAI,EACV,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,EACzB,KAAK,CAAC,SAAS,KAAK,SAAS,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,GACxD,QAAQ,eAAe,EAAE,KAAK;",
+  "names": []
+}

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

@@ -0,0 +1,49 @@
+import { type AgentManifestIface, type HarnessDescriptionIface, type ProviderRef } from '@finalai/agent-provider';
+import { type CompatibilityReportIface } from "../compatibility.mjs";
+import { type DiagnosticIface } from "./diagnostics.mjs";
+import { type VendoredPackageIface } from "./packages.mjs";
+export type { CompatibilityReportIface } from "../compatibility.mjs";
+export { DiagnosticCode, DiagnosticSeverity, hasErrors } from "./diagnostics.mjs";
+export type { DiagnosticIface } from "./diagnostics.mjs";
+export { discover } from "./discovery.mjs";
+export { loadBundle } from "./load.mjs";
+export type { LoadedBundleIface } from "./load.mjs";
+export { loadBundleInLocalIsolate } from "./local-isolate.mjs";
+export type { LocalIsolateOptionsIface } from "./local-isolate.mjs";
+export { parsePackageJson, PLATFORM_PACKAGES, splitSpecifier, workspaceDependencies, WorkspaceDependencyKind, workspacePackageCandidates, workspacePackageGlobs, } from "./packages.mjs";
+export type { VendoredPackageIface, WorkspaceDependencyIface } from "./packages.mjs";
+export interface CompileOptionsIface {
+    dir?: string;
+    files?: Record<string, string>;
+    defaultFiles?: Readonly<Record<string, string>>;
+    name?: string;
+    harnessDescriptions?: (ref: ProviderRef, context: HarnessDescriptionContextIface) => Promise<HarnessDescriptionIface | null>;
+    packageRoot?: string;
+    packages?: Record<string, VendoredPackageIface>;
+    providerModules?: Readonly<Record<string, string>>;
+    installedSandboxProviders?: Readonly<Record<string, string>>;
+}
+export interface HarnessDescriptionContextIface {
+    bundle: {
+        hash: string;
+        code: string;
+    } | null;
+}
+export interface CompiledBundleIface {
+    files?: Record<string, string>;
+    hash: string;
+    code: string;
+    modules: Record<string, string>;
+    sandboxOpeners: Record<string, string>;
+    channelRoutes: Record<string, {
+        method: string;
+        path: string;
+    }[]>;
+}
+export interface CompileResultIface {
+    manifest: AgentManifestIface | null;
+    bundle: CompiledBundleIface | null;
+    diagnostics: DiagnosticIface[];
+    report: CompatibilityReportIface | null;
+}
+export declare const compile: (options: CompileOptionsIface) => Promise<CompileResultIface>;

package/dist/modules/compiler/index.mjs

@@ -0,0 +1,244 @@
+import {
+  jsonValueSchema
+} from "@finalai/agent-provider";
+import { sandboxPreparationInputs, sandboxSeedFiles } from "@finalai/agent-provider/sandbox";
+import { basename, dirname } from "node:path";
+import * as z from "zod";
+import { compatibilityReport } from "../compatibility.mjs";
+import { assemble } from "./assemble.mjs";
+import { bundleAgent } from "./bundle.mjs";
+import {
+  diagnostic,
+  DiagnosticCode,
+  DiagnosticSeverity,
+  hasErrors
+} from "./diagnostics.mjs";
+import { discover } from "./discovery.mjs";
+import { evaluateBundle } from "./evaluate.mjs";
+import { normalizeFiles, preparationFiles, readAgentDirectory } from "./files.mjs";
+import { declaredDependencyDiagnostics } from "./packages.mjs";
+import { DiagnosticCode as DiagnosticCode2, DiagnosticSeverity as DiagnosticSeverity2, hasErrors as hasErrors2 } from "./diagnostics.mjs";
+import { discover as discover2 } from "./discovery.mjs";
+import { loadBundle } from "./load.mjs";
+import { loadBundleInLocalIsolate } from "./local-isolate.mjs";
+import {
+  parsePackageJson,
+  PLATFORM_PACKAGES,
+  splitSpecifier,
+  workspaceDependencies,
+  WorkspaceDependencyKind,
+  workspacePackageCandidates,
+  workspacePackageGlobs
+} from "./packages.mjs";
+const directoryName = (dir) => {
+  const name = basename(dir);
+  return name === "agent" ? basename(dirname(dir)) : name;
+};
+const configObjectSchema = z.record(z.string(), jsonValueSchema);
+const schemaPropertiesSchema = z.object({ properties: z.record(z.string(), jsonValueSchema) });
+const withoutUndeclaredDirectoryFields = (args) => {
+  const config = configObjectSchema.safeParse(args.manifest.harness.config);
+  if (!config.success) return args.manifest;
+  const declared = schemaPropertiesSchema.safeParse(args.configSchema);
+  const properties = declared.success ? declared.data.properties : {};
+  const next = { ...config.data };
+  const fields = [
+    ["instructions", args.directoryFields.instructions],
+    ["skills", args.directoryFields.skills]
+  ];
+  for (const [field, sources] of fields) {
+    if (sources.length === 0 || field in properties || !(field in next)) continue;
+    delete next[field];
+    args.diagnostics.push(
+      diagnostic({
+        severity: DiagnosticSeverity.Warning,
+        code: DiagnosticCode.Compatibility,
+        message: `the harness has no ${field} field, so ${sources.join(", ")} ${sources.length === 1 ? "is" : "are"} unused`
+      })
+    );
+  }
+  return { ...args.manifest, harness: { ...args.manifest.harness, config: next } };
+};
+const compile = async (options) => {
+  const diagnostics = [];
+  const fail = (message) => ({
+    manifest: null,
+    bundle: null,
+    diagnostics: [
+      ...diagnostics,
+      diagnostic({ severity: DiagnosticSeverity.Error, code: DiagnosticCode.Input, message })
+    ],
+    report: null
+  });
+  let root = null;
+  let rawFiles;
+  if (options.dir != null) {
+    if (options.files != null) return fail("pass either dir or files, not both");
+    try {
+      const read = await readAgentDirectory(options.dir);
+      root = read.root;
+      rawFiles = read.files;
+    } catch (cause) {
+      return fail(cause instanceof Error ? cause.message : String(cause));
+    }
+  } else if (options.files != null) rawFiles = options.files;
+  else return fail("pass dir or files");
+  const normalized = normalizeFiles(rawFiles);
+  for (const problem of normalized.problems) {
+    diagnostics.push(
+      diagnostic({
+        severity: DiagnosticSeverity.Error,
+        code: DiagnosticCode.Input,
+        message: problem.message,
+        path: problem.path
+      })
+    );
+  }
+  const { files } = normalized;
+  const defaultModuleKeys = /* @__PURE__ */ new Set();
+  for (const [path, source] of Object.entries(options.defaultFiles ?? {})) {
+    const stem = path.replace(/\.(ts|mts|js|mjs)$/, "");
+    if (!Object.keys(files).some((file) => file.replace(/\.(ts|mts|js|mjs)$/, "") === stem)) {
+      files[path] = source;
+      defaultModuleKeys.add(stem.replace(/^channels\//, ""));
+    }
+  }
+  try {
+    sandboxSeedFiles(sandboxPreparationInputs(files));
+  } catch (cause) {
+    return fail(cause instanceof Error ? cause.message : String(cause));
+  }
+  const packages = {};
+  for (const [name, pkg] of Object.entries(options.packages ?? {})) {
+    const vendored = normalizeFiles(pkg.files, { enforceSizeLimits: false });
+    for (const problem of vendored.problems) {
+      diagnostics.push(
+        diagnostic({
+          severity: DiagnosticSeverity.Error,
+          code: DiagnosticCode.Input,
+          message: `${name}: ${problem.message}`,
+          path: problem.path
+        })
+      );
+    }
+    Object.defineProperty(packages, name, {
+      value: { ...pkg, files: vendored.files },
+      enumerable: true,
+      configurable: true,
+      writable: true
+    });
+  }
+  diagnostics.push(
+    ...declaredDependencyDiagnostics({
+      packageJson: files["package.json"],
+      vendored: new Set(Object.keys(packages)),
+      local: root != null
+    })
+  );
+  const discovery = discover(Object.keys(files));
+  let bundle = null;
+  let described = null;
+  if (discovery.modules.length > 0) {
+    const bundled = await bundleAgent({
+      files,
+      layout: discovery.modules,
+      root,
+      packageRoot: options.packageRoot,
+      packages,
+      providerModules: options.providerModules
+    });
+    for (const problem of bundled.problems) {
+      diagnostics.push(
+        diagnostic({
+          severity: DiagnosticSeverity.Error,
+          code: problem.builtin ? DiagnosticCode.NodeBuiltin : DiagnosticCode.Bundle,
+          message: problem.message,
+          path: problem.path
+        })
+      );
+    }
+    if (bundled.code != null && bundled.hash != null) {
+      bundle = { hash: bundled.hash, code: bundled.code };
+      const evaluated = await evaluateBundle(bundled.code, { packageRoot: options.packageRoot });
+      if (evaluated.ok) described = evaluated.described;
+      else
+        diagnostics.push(
+          diagnostic({
+            severity: DiagnosticSeverity.Error,
+            code: DiagnosticCode.Evaluation,
+            message: evaluated.message
+          })
+        );
+    }
+  }
+  if (hasErrors(diagnostics)) return { manifest: null, bundle: null, diagnostics, report: null };
+  const assembled = assemble({
+    files,
+    discovery,
+    described,
+    fallbackName: options.name ?? (options.dir == null ? "agent" : directoryName(root ?? options.dir)),
+    bundle,
+    installedSandboxProviders: options.installedSandboxProviders
+  });
+  if (assembled.manifest != null) {
+    for (const key of defaultModuleKeys) {
+      const source = assembled.manifest.channelSources?.[key];
+      if (source != null) source.source = "default";
+      for (const channel of assembled.manifest.channels)
+        if (channel.key === key) channel.source = "default";
+    }
+  }
+  diagnostics.push(...assembled.diagnostics);
+  const manifest = assembled.manifest;
+  const compiledBundle = manifest?.bundle == null || bundle == null ? null : {
+    ...bundle,
+    files: preparationFiles(files),
+    modules: assembled.modules,
+    sandboxOpeners: assembled.sandboxOpeners,
+    channelRoutes: assembled.channelRoutes
+  };
+  let report = null;
+  let finalManifest = manifest;
+  if (manifest != null && options.harnessDescriptions != null) {
+    const description = await options.harnessDescriptions(manifest.harness.harness, { bundle });
+    if (description == null) {
+      diagnostics.push(
+        diagnostic({
+          severity: DiagnosticSeverity.Warning,
+          code: DiagnosticCode.Compatibility,
+          message: "the harness description is unavailable, so there is no compatibility report"
+        })
+      );
+    } else {
+      report = compatibilityReport({
+        manifest,
+        description,
+        directoryFiles: assembled.directoryFields
+      });
+      finalManifest = withoutUndeclaredDirectoryFields({
+        manifest,
+        configSchema: description.configSchema,
+        directoryFields: assembled.directoryFields,
+        diagnostics
+      });
+    }
+  }
+  return { manifest: finalManifest, bundle: compiledBundle, diagnostics, report };
+};
+export {
+  DiagnosticCode2 as DiagnosticCode,
+  DiagnosticSeverity2 as DiagnosticSeverity,
+  PLATFORM_PACKAGES,
+  WorkspaceDependencyKind,
+  compile,
+  discover2 as discover,
+  hasErrors2 as hasErrors,
+  loadBundle,
+  loadBundleInLocalIsolate,
+  parsePackageJson,
+  splitSpecifier,
+  workspaceDependencies,
+  workspacePackageCandidates,
+  workspacePackageGlobs
+};
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/index.ts"],
+  "sourcesContent": ["import {\n  jsonValueSchema,\n  type AgentManifestIface,\n  type HarnessDescriptionIface,\n  type JsonSchema,\n  type ProviderRef,\n} from '@finalai/agent-provider';\nimport { sandboxPreparationInputs, sandboxSeedFiles } from '@finalai/agent-provider/sandbox';\nimport { basename, dirname } from 'node:path';\nimport * as z from 'zod';\nimport { compatibilityReport, type CompatibilityReportIface } from \"../compatibility.mjs\";\nimport { assemble } from \"./assemble.mjs\";\nimport { bundleAgent } from \"./bundle.mjs\";\nimport {\n  diagnostic,\n  DiagnosticCode,\n  DiagnosticSeverity,\n  hasErrors,\n  type DiagnosticIface,\n} from \"./diagnostics.mjs\";\nimport { discover } from \"./discovery.mjs\";\nimport { evaluateBundle } from \"./evaluate.mjs\";\nimport { normalizeFiles, preparationFiles, readAgentDirectory } from \"./files.mjs\";\nimport { declaredDependencyDiagnostics, type VendoredPackageIface } from \"./packages.mjs\";\n\nexport type { CompatibilityReportIface } from \"../compatibility.mjs\";\nexport { DiagnosticCode, DiagnosticSeverity, hasErrors } from \"./diagnostics.mjs\";\nexport type { DiagnosticIface } from \"./diagnostics.mjs\";\nexport { discover } from \"./discovery.mjs\";\nexport { loadBundle } from \"./load.mjs\";\nexport type { LoadedBundleIface } from \"./load.mjs\";\nexport { loadBundleInLocalIsolate } from \"./local-isolate.mjs\";\nexport type { LocalIsolateOptionsIface } from \"./local-isolate.mjs\";\nexport {\n  parsePackageJson,\n  PLATFORM_PACKAGES,\n  splitSpecifier,\n  workspaceDependencies,\n  WorkspaceDependencyKind,\n  workspacePackageCandidates,\n  workspacePackageGlobs,\n} from \"./packages.mjs\";\nexport type { VendoredPackageIface, WorkspaceDependencyIface } from \"./packages.mjs\";\n\nexport interface CompileOptionsIface {\n  // An agent directory on disk (the repository's `agent/` directory)...\n  dir?: string;\n  // ...or its files, directory-relative (what Build reads from git).\n  files?: Record<string, string>;\n  // Optional modules supplied by the host when the author did not provide them.\n  defaultFiles?: Readonly<Record<string, string>>;\n  // Identity name when agent.ts sets none; defaults to the directory name.\n  name?: string;\n  // Looks up the chosen harness's description for the compatibility report.\n  // A bundle harness is described from the bundle being compiled.\n  harnessDescriptions?: (\n    ref: ProviderRef,\n    context: HarnessDescriptionContextIface,\n  ) => Promise<HarnessDescriptionIface | null>;\n  // This package's installed root, when the compiler runs from a bundle.\n  packageRoot?: string;\n  // Workspace packages from the agent's repository it imports, by name\n  // (packages.ts); the platform passes them since it compiles without installing.\n  packages?: Record<string, VendoredPackageIface>;\n  // Authoring modules of the provider packages the host installed, by import\n  // specifier \u2192 source file (`@finalai/daytona-agent-provider/sandboxes`), which\n  // authored code may import though this package does not depend on them. A\n  // compile of files without a checkout resolves packages from this package's\n  // dependencies only.\n  providerModules?: Readonly<Record<string, string>>;\n  // Explicit provider defaults used to infer a dynamic sandbox target by name.\n  installedSandboxProviders?: Readonly<Record<string, string>>;\n}\n\nexport interface HarnessDescriptionContextIface {\n  // The compiled bundle; null when the definition has no authored modules.\n  bundle: { hash: string; code: string } | null;\n}\n\nexport interface CompiledBundleIface {\n  // Pinned workspace and skill files used by sandbox provider preparation.\n  files?: Record<string, string>;\n  hash: string;\n  // One ESM module for the Worker isolate; exports `modules` and `runtime`.\n  code: string;\n  // Bundle export \u2192 directory-relative source path, for everything the\n  // runtime calls (tools, channels, hooks, resolvers, selectors, providers).\n  modules: Record<string, string>;\n  // Target \u2192 bundle export of the sandbox.ts selector that opens it.\n  sandboxOpeners: Record<string, string>;\n  // Bundle channel export ('channels/github') \u2192 its routes, so the platform\n  // shows route URLs without running the bundle.\n  channelRoutes: Record<string, { method: string; path: string }[]>;\n}\n\nexport interface CompileResultIface {\n  // Null when there are errors.\n  manifest: AgentManifestIface | null;\n  bundle: CompiledBundleIface | null;\n  diagnostics: DiagnosticIface[];\n  report: CompatibilityReportIface | null;\n}\n\nconst directoryName = (dir: string): string => {\n  const name = basename(dir);\n  return name === 'agent' ? basename(dirname(dir)) : name;\n};\n\nconst configObjectSchema = z.record(z.string(), jsonValueSchema);\nconst schemaPropertiesSchema = z.object({ properties: z.record(z.string(), jsonValueSchema) });\n\nconst withoutUndeclaredDirectoryFields = (args: {\n  manifest: AgentManifestIface;\n  configSchema: JsonSchema;\n  directoryFields: { instructions: string[]; skills: string[] };\n  diagnostics: DiagnosticIface[];\n}): AgentManifestIface => {\n  const config = configObjectSchema.safeParse(args.manifest.harness.config);\n  if (!config.success) return args.manifest;\n  const declared = schemaPropertiesSchema.safeParse(args.configSchema);\n  const properties = declared.success ? declared.data.properties : {};\n  const next = { ...config.data };\n  const fields: ['instructions' | 'skills', string[]][] = [\n    ['instructions', args.directoryFields.instructions],\n    ['skills', args.directoryFields.skills],\n  ];\n  for (const [field, sources] of fields) {\n    if (sources.length === 0 || field in properties || !(field in next)) continue;\n    delete next[field];\n    args.diagnostics.push(\n      diagnostic({\n        severity: DiagnosticSeverity.Warning,\n        code: DiagnosticCode.Compatibility,\n        message: `the harness has no ${field} field, so ${sources.join(', ')} ${sources.length === 1 ? 'is' : 'are'} unused`,\n      }),\n    );\n  }\n  return { ...args.manifest, harness: { ...args.manifest.harness, config: next } };\n};\n\nexport const compile = async (options: CompileOptionsIface): Promise<CompileResultIface> => {\n  const diagnostics: DiagnosticIface[] = [];\n  const fail = (message: string): CompileResultIface => ({\n    manifest: null,\n    bundle: null,\n    diagnostics: [\n      ...diagnostics,\n      diagnostic({ severity: DiagnosticSeverity.Error, code: DiagnosticCode.Input, message }),\n    ],\n    report: null,\n  });\n  let root: string | null = null;\n  let rawFiles: Record<string, string>;\n  if (options.dir != null) {\n    if (options.files != null) return fail('pass either dir or files, not both');\n    try {\n      const read = await readAgentDirectory(options.dir);\n      root = read.root;\n      rawFiles = read.files;\n    } catch (cause) {\n      return fail(cause instanceof Error ? cause.message : String(cause));\n    }\n  } else if (options.files != null) rawFiles = options.files;\n  else return fail('pass dir or files');\n  const normalized = normalizeFiles(rawFiles);\n  for (const problem of normalized.problems) {\n    diagnostics.push(\n      diagnostic({\n        severity: DiagnosticSeverity.Error,\n        code: DiagnosticCode.Input,\n        message: problem.message,\n        path: problem.path,\n      }),\n    );\n  }\n  const { files } = normalized;\n  const defaultModuleKeys = new Set<string>();\n  for (const [path, source] of Object.entries(options.defaultFiles ?? {})) {\n    const stem = path.replace(/\\.(ts|mts|js|mjs)$/, '');\n    if (!Object.keys(files).some((file) => file.replace(/\\.(ts|mts|js|mjs)$/, '') === stem)) {\n      files[path] = source;\n      defaultModuleKeys.add(stem.replace(/^channels\\//, ''));\n    }\n  }\n  try {\n    sandboxSeedFiles(sandboxPreparationInputs(files));\n  } catch (cause) {\n    return fail(cause instanceof Error ? cause.message : String(cause));\n  }\n  const packages: Record<string, VendoredPackageIface> = {};\n  for (const [name, pkg] of Object.entries(options.packages ?? {})) {\n    const vendored = normalizeFiles(pkg.files, { enforceSizeLimits: false });\n    for (const problem of vendored.problems) {\n      diagnostics.push(\n        diagnostic({\n          severity: DiagnosticSeverity.Error,\n          code: DiagnosticCode.Input,\n          message: `${name}: ${problem.message}`,\n          path: problem.path,\n        }),\n      );\n    }\n    Object.defineProperty(packages, name, {\n      value: { ...pkg, files: vendored.files },\n      enumerable: true,\n      configurable: true,\n      writable: true,\n    });\n  }\n  diagnostics.push(\n    ...declaredDependencyDiagnostics({\n      packageJson: files['package.json'],\n      vendored: new Set(Object.keys(packages)),\n      local: root != null,\n    }),\n  );\n  const discovery = discover(Object.keys(files));\n\n  let bundle: { hash: string; code: string } | null = null;\n  let described = null;\n  if (discovery.modules.length > 0) {\n    const bundled = await bundleAgent({\n      files,\n      layout: discovery.modules,\n      root,\n      packageRoot: options.packageRoot,\n      packages,\n      providerModules: options.providerModules,\n    });\n    for (const problem of bundled.problems) {\n      diagnostics.push(\n        diagnostic({\n          severity: DiagnosticSeverity.Error,\n          code: problem.builtin ? DiagnosticCode.NodeBuiltin : DiagnosticCode.Bundle,\n          message: problem.message,\n          path: problem.path,\n        }),\n      );\n    }\n    if (bundled.code != null && bundled.hash != null) {\n      bundle = { hash: bundled.hash, code: bundled.code };\n      const evaluated = await evaluateBundle(bundled.code, { packageRoot: options.packageRoot });\n      if (evaluated.ok) described = evaluated.described;\n      else\n        diagnostics.push(\n          diagnostic({\n            severity: DiagnosticSeverity.Error,\n            code: DiagnosticCode.Evaluation,\n            message: evaluated.message,\n          }),\n        );\n    }\n  }\n  if (hasErrors(diagnostics)) return { manifest: null, bundle: null, diagnostics, report: null };\n\n  const assembled = assemble({\n    files,\n    discovery,\n    described,\n    fallbackName:\n      options.name ?? (options.dir == null ? 'agent' : directoryName(root ?? options.dir)),\n    bundle,\n    installedSandboxProviders: options.installedSandboxProviders,\n  });\n  if (assembled.manifest != null) {\n    for (const key of defaultModuleKeys) {\n      const source = assembled.manifest.channelSources?.[key];\n      if (source != null) source.source = 'default';\n      for (const channel of assembled.manifest.channels)\n        if (channel.key === key) channel.source = 'default';\n    }\n  }\n  diagnostics.push(...assembled.diagnostics);\n  const manifest = assembled.manifest;\n  const compiledBundle: CompiledBundleIface | null =\n    manifest?.bundle == null || bundle == null\n      ? null\n      : {\n          ...bundle,\n          files: preparationFiles(files),\n          modules: assembled.modules,\n          sandboxOpeners: assembled.sandboxOpeners,\n          channelRoutes: assembled.channelRoutes,\n        };\n\n  let report: CompatibilityReportIface | null = null;\n  let finalManifest = manifest;\n  if (manifest != null && options.harnessDescriptions != null) {\n    const description = await options.harnessDescriptions(manifest.harness.harness, { bundle });\n    if (description == null) {\n      diagnostics.push(\n        diagnostic({\n          severity: DiagnosticSeverity.Warning,\n          code: DiagnosticCode.Compatibility,\n          message: 'the harness description is unavailable, so there is no compatibility report',\n        }),\n      );\n    } else {\n      report = compatibilityReport({\n        manifest,\n        description,\n        directoryFiles: assembled.directoryFields,\n      });\n      // Directory instructions and skills fill harness config fields\n      // only when the harness declares them; otherwise they are reported unused.\n      finalManifest = withoutUndeclaredDirectoryFields({\n        manifest,\n        configSchema: description.configSchema,\n        directoryFields: assembled.directoryFields,\n        diagnostics,\n      });\n    }\n  }\n  return { manifest: finalManifest, bundle: compiledBundle, diagnostics, report };\n};\n"],
+  "mappings": "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",
+  "names": ["DiagnosticCode", "DiagnosticSeverity", "hasErrors", "discover"]
+}

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

@@ -0,0 +1,8 @@
+import type { IsolateRuntimeIface } from "../runtime/isolate.mjs";
+import { type AuthoredRecord, type AuthoredValue } from "../runtime/values.mjs";
+export interface LoadedBundleIface {
+    modules: AuthoredRecord;
+    runtime: IsolateRuntimeIface;
+}
+export declare const parseLoadedBundle: (namespace: AuthoredValue) => LoadedBundleIface;
+export declare const loadBundle: (code: string) => Promise<LoadedBundleIface>;

package/dist/modules/compiler/load.mjs

@@ -0,0 +1,45 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import * as z from "zod";
+import {
+  authoredRecordSchema,
+  callableSchema
+} from "../runtime/values.mjs";
+const loadedBundleSchema = z.looseObject({
+  modules: authoredRecordSchema,
+  runtime: z.custom(
+    (value) => z.looseObject({
+      runTool: callableSchema,
+      evaluateApproval: callableSchema,
+      resolveDynamic: callableSchema,
+      dispatchHook: callableSchema,
+      handleChannelRoute: callableSchema,
+      handleChannelSocket: callableSchema
+    }).safeParse(value).success
+  )
+});
+const parseLoadedBundle = (namespace) => {
+  const parsed = loadedBundleSchema.safeParse(namespace);
+  if (!parsed.success) throw new Error("not an agent bundle");
+  return { modules: parsed.data.modules, runtime: parsed.data.runtime };
+};
+const loadBundle = async (code) => {
+  const directory = await mkdtemp(join(tmpdir(), "final-agent-bundle-"));
+  const file = join(directory, "bundle.mjs");
+  try {
+    await writeFile(file, code, { mode: 384 });
+    return parseLoadedBundle(await import(
+      /* @vite-ignore */
+      pathToFileURL(file).href
+    ));
+  } finally {
+    await rm(directory, { recursive: true, force: true });
+  }
+};
+export {
+  loadBundle,
+  parseLoadedBundle
+};
+//# sourceMappingURL=load.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/compiler/load.ts"],
+  "sourcesContent": ["import { mkdtemp, rm, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport * as z from 'zod';\nimport type { IsolateRuntimeIface } from \"../runtime/isolate.mjs\";\nimport {\n  authoredRecordSchema,\n  callableSchema,\n  type AuthoredRecord,\n  type AuthoredValue,\n} from \"../runtime/values.mjs\";\n\nexport interface LoadedBundleIface {\n  modules: AuthoredRecord;\n  runtime: IsolateRuntimeIface;\n}\n\nconst loadedBundleSchema = z.looseObject({\n  modules: authoredRecordSchema,\n  runtime: z.custom<IsolateRuntimeIface>(\n    (value) =>\n      z\n        .looseObject({\n          runTool: callableSchema,\n          evaluateApproval: callableSchema,\n          resolveDynamic: callableSchema,\n          dispatchHook: callableSchema,\n          handleChannelRoute: callableSchema,\n          handleChannelSocket: callableSchema,\n        })\n        .safeParse(value).success,\n  ),\n});\n\nexport const parseLoadedBundle = (namespace: AuthoredValue): LoadedBundleIface => {\n  const parsed = loadedBundleSchema.safeParse(namespace);\n  if (!parsed.success) throw new Error('not an agent bundle');\n  return { modules: parsed.data.modules, runtime: parsed.data.runtime };\n};\n\n// Imports a compiled bundle in this Node process, for local development and\n// tests of the code that drives the isolate. Production runs bundles in the\n// Worker isolate (agent-harness-workers), never in a Node service.\nexport const loadBundle = async (code: string): Promise<LoadedBundleIface> => {\n  const directory = await mkdtemp(join(tmpdir(), 'final-agent-bundle-'));\n  const file = join(directory, 'bundle.mjs');\n  try {\n    await writeFile(file, code, { mode: 0o600 });\n    return parseLoadedBundle(await import(/* @vite-ignore */ pathToFileURL(file).href));\n  } finally {\n    await rm(directory, { recursive: true, force: true });\n  }\n};\n"],
+  "mappings": "AAAA,SAAS,SAAS,IAAI,iBAAiB;AACvC,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,qBAAqB;AAC9B,YAAY,OAAO;AAEnB;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AAOP,MAAM,qBAAqB,EAAE,YAAY;AAAA,EACvC,SAAS;AAAA,EACT,SAAS,EAAE;AAAA,IACT,CAAC,UACC,EACG,YAAY;AAAA,MACX,SAAS;AAAA,MACT,kBAAkB;AAAA,MAClB,gBAAgB;AAAA,MAChB,cAAc;AAAA,MACd,oBAAoB;AAAA,MACpB,qBAAqB;AAAA,IACvB,CAAC,EACA,UAAU,KAAK,EAAE;AAAA,EACxB;AACF,CAAC;AAEM,MAAM,oBAAoB,CAAC,cAAgD;AAChF,QAAM,SAAS,mBAAmB,UAAU,SAAS;AACrD,MAAI,CAAC,OAAO,QAAS,OAAM,IAAI,MAAM,qBAAqB;AAC1D,SAAO,EAAE,SAAS,OAAO,KAAK,SAAS,SAAS,OAAO,KAAK,QAAQ;AACtE;AAKO,MAAM,aAAa,OAAO,SAA6C;AAC5E,QAAM,YAAY,MAAM,QAAQ,KAAK,OAAO,GAAG,qBAAqB,CAAC;AACrE,QAAM,OAAO,KAAK,WAAW,YAAY;AACzC,MAAI;AACF,UAAM,UAAU,MAAM,MAAM,EAAE,MAAM,IAAM,CAAC;AAC3C,WAAO,kBAAkB,MAAM;AAAA;AAAA,MAA0B,cAAc,IAAI,EAAE;AAAA,KAAK;AAAA,EACpF,UAAE;AACA,UAAM,GAAG,WAAW,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,EACtD;AACF;",
+  "names": []
+}

package/dist/modules/compiler/local-isolate.d.mts

@@ -0,0 +1,20 @@
+import { type JsonValue, type SandboxOpener, type SecretReaderIface } from '@finalai/agent-provider';
+import type { AgentSessionInfoIface } from "../authoring/context.mjs";
+import { type LoadedBundleIface } from "./load.mjs";
+export interface LocalIsolateOptionsIface {
+    fetch?: typeof fetch;
+}
+export interface LocalIsolateBundleIface extends LoadedBundleIface {
+    callExportMethod(args: {
+        exportName: string;
+        method: string;
+        args: JsonValue[];
+    }): Promise<JsonValue>;
+    runSandboxSelector(args: {
+        exportName: string;
+        session: AgentSessionInfoIface;
+        secrets: SecretReaderIface;
+        open: SandboxOpener;
+    }): Promise<void>;
+}
+export declare const loadBundleInLocalIsolate: (code: string, options?: LocalIsolateOptionsIface) => Promise<LocalIsolateBundleIface>;