@finalai/agent-definition 0.1.0

package/dist/compiler-assets/src/compiler/evaluate-child.mjs

@@ -0,0 +1,77 @@
+// Runs one agent bundle's top-level code to read its static description.
+// Started by evaluate.ts as a separate Node process with an empty
+// environment, the permission model (no filesystem beyond this file, no
+// network, child processes, workers or addons), a memory cap and a hard
+// timeout. node:vm is not a security boundary; this process is. The vm
+// context below is defense in depth and keeps authored globals predictable.
+//
+// Protocol: the evaluation script on stdin; one JSON line on stdout,
+// { ok: true, described: string } or { ok: false, message: string }.
+import vm from 'node:vm';
+
+const EVALUATION_TIMEOUT_MS = 10_000;
+
+const offline = () => {
+  throw new Error(
+    'network access is not available while compiling; move it into a tool or a defineDynamic resolver',
+  );
+};
+
+const noop = () => undefined;
+
+const createContext = () =>
+  vm.createContext(
+    {
+      console: { log: noop, info: noop, warn: noop, error: noop, debug: noop, trace: noop },
+      URL,
+      URLSearchParams,
+      TextEncoder,
+      TextDecoder,
+      ReadableStream,
+      WritableStream,
+      TransformStream,
+      AbortController,
+      AbortSignal,
+      Headers,
+      Request,
+      Response,
+      Blob,
+      structuredClone,
+      atob,
+      btoa,
+      queueMicrotask,
+      crypto: {
+        randomUUID: () => globalThis.crypto.randomUUID(),
+        getRandomValues: (array) => globalThis.crypto.getRandomValues(array),
+      },
+      fetch: offline,
+      setTimeout: offline,
+      setInterval: offline,
+    },
+    { name: 'final-agent-compile', codeGeneration: { strings: false, wasm: false } },
+  );
+
+const messageOf = (cause) => (cause instanceof Error ? cause.message : String(cause));
+
+const reply = (message) =>
+  new Promise((resolve) => {
+    process.stdout.write(`${JSON.stringify(message)}\n`, () => resolve());
+  });
+
+const chunks = [];
+for await (const chunk of process.stdin) chunks.push(chunk);
+const script = Buffer.concat(chunks).toString('utf8');
+
+try {
+  const described = vm.runInContext(script, createContext(), {
+    timeout: EVALUATION_TIMEOUT_MS,
+    filename: 'agent-bundle.js',
+  });
+  await reply({ ok: true, described: String(described) });
+} catch (cause) {
+  await reply({
+    ok: false,
+    message: `evaluating the authored modules failed: ${messageOf(cause)}`,
+  });
+}
+process.exit(0);

package/dist/compiler-assets/src/index.ts

@@ -0,0 +1,195 @@
+import "../chunk-JTGTLYDT.ts";
+import {
+  SlotValueKind,
+  resolveManifest,
+  resolveManifestDetailed,
+  slotKindOf,
+  validateSlotValue
+} from "../chunk-EVQIK62B.ts";
+import {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT
+} from "../chunk-NMYHO2QN.ts";
+import "../chunk-6WR3PGNF.ts";
+import {
+  completeHarnessDescription,
+  defineHarness
+} from "../chunk-QMKWAFVZ.ts";
+import {
+  HookEvent,
+  defineHook
+} from "../chunk-QMWTDPNT.ts";
+import {
+  defineInstructions
+} from "../chunk-VHXHUU7L.ts";
+import {
+  baseTools,
+  defineSandbox,
+  defineSandboxProvider,
+  harnessHost
+} from "../chunk-LUSAAV4L.ts";
+import "../chunk-CWWRTRWW.ts";
+import {
+  SandboxWire
+} from "../chunk-JPY4L2UJ.ts";
+import {
+  defineSchedule
+} from "../chunk-GTUZOATD.ts";
+import {
+  defineSkill
+} from "../chunk-HFS4KLEL.ts";
+import {
+  defineTool,
+  toolResultFrom
+} from "../chunk-TATN3PYK.ts";
+import "../chunk-GNR7XBPN.ts";
+import "../chunk-7WGYG73V.ts";
+import {
+  defineAgent
+} from "../chunk-2CZRHOLL.ts";
+import {
+  always,
+  never,
+  whenInput
+} from "../chunk-7VSSVZM4.ts";
+import {
+  BaseCapability,
+  InstructionRole,
+  MANIFEST_VERSION,
+  McpServerBindingKind,
+  SandboxAccess,
+  SandboxAttach,
+  ScheduleTarget,
+  ToolApproval,
+  agentManifestSchema,
+  baseToolsSchema,
+  bundleSchema,
+  channelBindingSchema,
+  emptyManifest,
+  harnessBindingSchema,
+  hookBindingSchema,
+  httpMcpServerBindingSchema,
+  identitySchema,
+  instructionFragmentSchema,
+  mcpAuthSchema,
+  mcpServerBindingSchema,
+  resolvedAgentManifestSchema,
+  sandboxBindingSchema,
+  scheduleDefinitionSchema,
+  skillBundleSchema,
+  skillFileSchema,
+  toolDescriptorSchema,
+  workerMcpServerBindingSchema
+} from "../chunk-OWC6SFFF.ts";
+import {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  WS,
+  defineChannel,
+  defineProviderChannel,
+  disableChannel
+} from "../chunk-WMXMVFHM.ts";
+import "../chunk-5BK6FVRE.ts";
+import "../chunk-7QP2CKPI.ts";
+import {
+  defineMcpClientConnection
+} from "../chunk-JNJE72EH.ts";
+import {
+  TranscriptRole
+} from "../chunk-RWUIMTBI.ts";
+import {
+  credentials
+} from "../chunk-NYTOYKKF.ts";
+import {
+  CredentialOwner,
+  CredentialPayer
+} from "../chunk-HNPUTP35.ts";
+import {
+  DynamicEvent,
+  dynamicSlotSchema,
+  findDynamicSlots,
+  isDynamicSlot
+} from "../chunk-SKTNMUO7.ts";
+import {
+  defineDynamic
+} from "../chunk-T6WG4L4M.ts";
+import "../chunk-XHKPWT3G.ts";
+import "../chunk-JIPNTA56.ts";
+import "../chunk-HGW4YHAY.ts";
+import "../chunk-32O3ODZE.ts";
+export {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  BaseCapability,
+  COMBINED_MCP_SERVERS_EXPORT,
+  CredentialOwner,
+  CredentialPayer,
+  DELETE,
+  DynamicEvent,
+  GET,
+  HookEvent,
+  InstructionRole,
+  MANIFEST_VERSION,
+  McpServerBindingKind,
+  POST,
+  PUT,
+  SandboxAccess,
+  SandboxAttach,
+  SandboxWire,
+  ScheduleTarget,
+  SlotValueKind,
+  ToolApproval,
+  TranscriptRole,
+  WS,
+  agentManifestSchema,
+  always,
+  baseTools,
+  baseToolsSchema,
+  bundleSchema,
+  channelBindingSchema,
+  completeHarnessDescription,
+  credentials,
+  defineAgent,
+  defineChannel,
+  defineDynamic,
+  defineHarness,
+  defineHook,
+  defineInstructions,
+  defineMcpClientConnection,
+  defineProviderChannel,
+  defineSandbox,
+  defineSandboxProvider,
+  defineSchedule,
+  defineSkill,
+  defineTool,
+  disableChannel,
+  dynamicSlotSchema,
+  emptyManifest,
+  findDynamicSlots,
+  harnessBindingSchema,
+  harnessHost,
+  hookBindingSchema,
+  httpMcpServerBindingSchema,
+  identitySchema,
+  instructionFragmentSchema,
+  isDynamicSlot,
+  mcpAuthSchema,
+  mcpServerBindingSchema,
+  never,
+  resolveManifest,
+  resolveManifestDetailed,
+  resolvedAgentManifestSchema,
+  sandboxBindingSchema,
+  scheduleDefinitionSchema,
+  skillBundleSchema,
+  skillFileSchema,
+  slotKindOf,
+  toolDescriptorSchema,
+  toolResultFrom,
+  validateSlotValue,
+  whenInput,
+  workerMcpServerBindingSchema
+};

package/dist/compiler-assets/src/manifest.ts

@@ -0,0 +1,72 @@
+import "../chunk-JTGTLYDT.ts";
+import {
+  BaseCapability,
+  InstructionRole,
+  MANIFEST_VERSION,
+  McpServerBindingKind,
+  SandboxAccess,
+  SandboxAttach,
+  ScheduleTarget,
+  ToolApproval,
+  agentManifestSchema,
+  baseToolsSchema,
+  bundleSchema,
+  channelBindingSchema,
+  emptyManifest,
+  harnessBindingSchema,
+  hookBindingSchema,
+  httpMcpServerBindingSchema,
+  identitySchema,
+  instructionFragmentSchema,
+  mcpAuthSchema,
+  mcpServerBindingSchema,
+  resolvedAgentManifestSchema,
+  sandboxBindingSchema,
+  scheduleDefinitionSchema,
+  skillBundleSchema,
+  skillFileSchema,
+  toolDescriptorSchema,
+  workerMcpServerBindingSchema
+} from "../chunk-OWC6SFFF.ts";
+import "../chunk-7QP2CKPI.ts";
+import {
+  DynamicEvent,
+  dynamicSlotSchema,
+  findDynamicSlots,
+  isDynamicSlot
+} from "../chunk-SKTNMUO7.ts";
+import "../chunk-HGW4YHAY.ts";
+import "../chunk-32O3ODZE.ts";
+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
+};

package/dist/compiler-assets/src/resolve.ts

@@ -0,0 +1,19 @@
+import {
+  SlotValueKind,
+  resolveManifest,
+  resolveManifestDetailed,
+  slotKindOf,
+  validateSlotValue
+} from "../chunk-EVQIK62B.ts";
+import "../chunk-OWC6SFFF.ts";
+import "../chunk-7QP2CKPI.ts";
+import "../chunk-SKTNMUO7.ts";
+import "../chunk-HGW4YHAY.ts";
+import "../chunk-32O3ODZE.ts";
+export {
+  SlotValueKind,
+  resolveManifest,
+  resolveManifestDetailed,
+  slotKindOf,
+  validateSlotValue
+};

package/dist/compiler-assets/src/runtime/bundle.ts

@@ -0,0 +1,72 @@
+import {
+  describeBundle,
+  needsCombinedMcpServers,
+  synthesizedExports
+} from "../../chunk-MZMSKIKU.ts";
+import {
+  combineMcpServers,
+  createIsolateRuntime
+} from "../../chunk-BLB6JGLO.ts";
+import "../../chunk-ZDLVA6XF.ts";
+import {
+  COMBINED_MCP_SERVERS_EXPORT,
+  namedExportName
+} from "../../chunk-NMYHO2QN.ts";
+import "../../chunk-QMWTDPNT.ts";
+import "../../chunk-CWWRTRWW.ts";
+import {
+  registerToolName
+} from "../../chunk-TATN3PYK.ts";
+import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-7VSSVZM4.ts";
+import "../../chunk-OWC6SFFF.ts";
+import "../../chunk-5BK6FVRE.ts";
+import "../../chunk-7QP2CKPI.ts";
+import "../../chunk-RWUIMTBI.ts";
+import "../../chunk-SKTNMUO7.ts";
+import "../../chunk-T6WG4L4M.ts";
+import "../../chunk-XHKPWT3G.ts";
+import "../../chunk-JIPNTA56.ts";
+import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-32O3ODZE.ts";
+
+// src/runtime/bundle.ts
+var createAgentBundle = (args) => {
+  const entries = args.layout.map((layout, index) => ({
+    layout,
+    namespace: { ...args.namespaces[index] }
+  }));
+  const modules = {};
+  for (const entry of entries) {
+    for (const [name, value] of Object.entries(entry.namespace)) {
+      modules[namedExportName(entry.layout.base, name)] = value;
+    }
+    if (entry.layout.slot === "tool" /* Tool */)
+      registerToolName(entry.namespace["default"], entry.layout.key);
+  }
+  const synthesized = synthesizedExports(entries);
+  for (const item of synthesized) modules[item.name] = item.value;
+  const names = synthesized.map((item) => item.name);
+  if (needsCombinedMcpServers(entries)) {
+    modules[COMBINED_MCP_SERVERS_EXPORT] = combineMcpServers(
+      entries.filter(
+        (entry) => entry.layout.slot === "tool" /* Tool */ || entry.layout.slot === "connection" /* Connection */
+      ).filter((entry) => entry.namespace["default"] != null).map((entry) => ({
+        kind: entry.layout.slot === "tool" /* Tool */ ? "tool" : "connection",
+        key: entry.layout.key,
+        exportName: entry.layout.base,
+        value: entry.namespace["default"]
+      }))
+    );
+    names.push(COMBINED_MCP_SERVERS_EXPORT);
+  }
+  return {
+    modules,
+    runtime: createIsolateRuntime(modules),
+    describe: () => JSON.stringify(describeBundle(entries, names))
+  };
+};
+export {
+  createAgentBundle
+};

package/dist/compiler-assets/src/runtime/describe.ts

@@ -0,0 +1,31 @@
+import {
+  collectAgentDynamics,
+  describeBundle,
+  describeDynamic,
+  needsCombinedMcpServers,
+  synthesizedExports
+} from "../../chunk-MZMSKIKU.ts";
+import "../../chunk-ZDLVA6XF.ts";
+import {
+  COMBINED_MCP_SERVERS_EXPORT
+} from "../../chunk-NMYHO2QN.ts";
+import "../../chunk-TATN3PYK.ts";
+import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-7VSSVZM4.ts";
+import "../../chunk-OWC6SFFF.ts";
+import "../../chunk-7QP2CKPI.ts";
+import "../../chunk-SKTNMUO7.ts";
+import "../../chunk-T6WG4L4M.ts";
+import "../../chunk-XHKPWT3G.ts";
+import "../../chunk-JIPNTA56.ts";
+import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-32O3ODZE.ts";
+export {
+  COMBINED_MCP_SERVERS_EXPORT,
+  collectAgentDynamics,
+  describeBundle,
+  describeDynamic,
+  needsCombinedMcpServers,
+  synthesizedExports
+};

package/dist/compiler-assets/src/runtime/described.ts

@@ -0,0 +1,142 @@
+import {
+  IssueSeverity
+} from "../../chunk-ZDLVA6XF.ts";
+import {
+  SlotKind
+} from "../../chunk-NMYHO2QN.ts";
+import "../../chunk-TATN3PYK.ts";
+import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-7VSSVZM4.ts";
+import "../../chunk-OWC6SFFF.ts";
+import {
+  jsonValueSchema
+} from "../../chunk-7QP2CKPI.ts";
+import "../../chunk-SKTNMUO7.ts";
+import "../../chunk-T6WG4L4M.ts";
+import "../../chunk-XHKPWT3G.ts";
+import "../../chunk-JIPNTA56.ts";
+import {
+  array,
+  boolean,
+  discriminatedUnion,
+  literal,
+  nativeEnum,
+  object,
+  record,
+  string
+} from "../../chunk-HGW4YHAY.ts";
+import "../../chunk-32O3ODZE.ts";
+
+// src/runtime/described.ts
+var issueSchema = object({ severity: nativeEnum(IssueSeverity), message: string() });
+var providerHintSchema = object({
+  ref: jsonValueSchema.nullable(),
+  name: string().nullable()
+});
+var describedDynamicSchema = object({
+  type: literal("dynamic"),
+  events: array(string()),
+  description: string().nullable(),
+  preview: string().nullable(),
+  provider: providerHintSchema.nullable()
+});
+var describedAgentSchema = object({
+  type: literal("agent"),
+  name: string().nullable(),
+  description: string().nullable(),
+  avatarUrl: string().nullable(),
+  harness: object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),
+  tools: record(string(), string()).nullable(),
+  // Capabilities bound to `harnessHost` (the harness's own host, no target).
+  hostTools: array(string()).nullable().default(null),
+  toolPolicy: record(string(), string()).nullable(),
+  secrets: array(string()).nullable(),
+  channels: array(
+    object({ key: string().nullable(), channel: jsonValueSchema, config: jsonValueSchema })
+  ).nullable()
+});
+var describedInstructionsSchema = object({
+  type: literal("instructions"),
+  role: string(),
+  content: string()
+});
+var describedSkillSchema = object({ type: literal("skill"), skill: jsonValueSchema });
+var describedToolSchema = object({
+  type: literal("tool"),
+  descriptor: jsonValueSchema,
+  approval: string()
+});
+var describedConnectionSchema = object({
+  type: literal("connection"),
+  binding: jsonValueSchema
+});
+var describedScheduleSchema = object({
+  type: literal("schedule"),
+  cron: string().nullable(),
+  markdown: string().nullable(),
+  timezone: string().nullable(),
+  target: string().nullable()
+});
+var describedHookSchema = object({ type: literal("hook"), keys: array(string()) });
+var describedChannelSchema = object({
+  type: literal("channel"),
+  routes: array(object({ method: string(), path: string() })),
+  turnPolicy: string().nullable(),
+  config: jsonValueSchema,
+  disabled: boolean().default(false),
+  installed: jsonValueSchema.nullable().default(null)
+});
+var describedEnvironmentSchema = object({
+  providerName: string(),
+  providerRef: jsonValueSchema.nullable(),
+  options: jsonValueSchema,
+  openOptions: jsonValueSchema.nullable()
+});
+var describedSandboxTargetSchema = object({
+  exportName: string(),
+  environment: describedEnvironmentSchema.nullable(),
+  dynamic: describedDynamicSchema.nullable()
+});
+var describedSandboxSchema = object({
+  type: literal("sandbox"),
+  targets: record(string(), describedSandboxTargetSchema),
+  // Bundle export name → provider name, for providers defined in sandbox.ts.
+  providers: record(string(), string()),
+  selector: boolean(),
+  defaultTarget: string().nullable()
+});
+var describedValueSchema = discriminatedUnion("type", [
+  describedAgentSchema,
+  describedDynamicSchema,
+  describedInstructionsSchema,
+  describedSkillSchema,
+  describedToolSchema,
+  describedConnectionSchema,
+  describedScheduleSchema,
+  describedHookSchema,
+  describedChannelSchema,
+  describedSandboxSchema
+]);
+var describedModuleSchema = object({
+  base: string(),
+  path: string(),
+  slot: nativeEnum(SlotKind),
+  key: string(),
+  hasDefault: boolean(),
+  issues: array(issueSchema),
+  value: describedValueSchema.nullable()
+});
+var describedBundleSchema = object({
+  modules: array(describedModuleSchema),
+  // Exports the bundle synthesizes beyond the authored ones.
+  synthesized: array(string())
+});
+export {
+  describedBundleSchema,
+  describedDynamicSchema,
+  describedEnvironmentSchema,
+  describedModuleSchema,
+  describedValueSchema,
+  issueSchema
+};

package/dist/compiler-assets/src/runtime/isolate.ts

@@ -0,0 +1,28 @@
+import {
+  combineMcpServers,
+  createIsolateRuntime,
+  lowerResolvedValue
+} from "../../chunk-BLB6JGLO.ts";
+import "../../chunk-ZDLVA6XF.ts";
+import "../../chunk-NMYHO2QN.ts";
+import "../../chunk-QMWTDPNT.ts";
+import "../../chunk-CWWRTRWW.ts";
+import "../../chunk-TATN3PYK.ts";
+import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-7VSSVZM4.ts";
+import "../../chunk-OWC6SFFF.ts";
+import "../../chunk-5BK6FVRE.ts";
+import "../../chunk-7QP2CKPI.ts";
+import "../../chunk-RWUIMTBI.ts";
+import "../../chunk-SKTNMUO7.ts";
+import "../../chunk-T6WG4L4M.ts";
+import "../../chunk-XHKPWT3G.ts";
+import "../../chunk-JIPNTA56.ts";
+import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-32O3ODZE.ts";
+export {
+  combineMcpServers,
+  createIsolateRuntime,
+  lowerResolvedValue
+};

package/dist/compiler-assets/src/runtime/layout.ts

@@ -0,0 +1,15 @@
+import {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT,
+  SlotKind,
+  namedExportName
+} from "../../chunk-NMYHO2QN.ts";
+import "../../chunk-32O3ODZE.ts";
+export {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT,
+  SlotKind,
+  namedExportName
+};

package/dist/compiler-assets/src/runtime/lower.ts

@@ -0,0 +1,52 @@
+import {
+  IssueSeverity,
+  childPath,
+  dynamicEventsOf,
+  error,
+  isDynamicSentinel,
+  isEnvironmentLike,
+  isOpenRequestLike,
+  lowerConnection,
+  lowerEnvironment,
+  lowerInstructions,
+  lowerSkill,
+  lowerTool,
+  note,
+  sandboxProviderNameOf,
+  skillMarkdown,
+  toJson,
+  toJsonSchema,
+  warning
+} from "../../chunk-ZDLVA6XF.ts";
+import "../../chunk-TATN3PYK.ts";
+import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-7VSSVZM4.ts";
+import "../../chunk-OWC6SFFF.ts";
+import "../../chunk-7QP2CKPI.ts";
+import "../../chunk-SKTNMUO7.ts";
+import "../../chunk-T6WG4L4M.ts";
+import "../../chunk-XHKPWT3G.ts";
+import "../../chunk-JIPNTA56.ts";
+import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-32O3ODZE.ts";
+export {
+  IssueSeverity,
+  childPath,
+  dynamicEventsOf,
+  error,
+  isDynamicSentinel,
+  isEnvironmentLike,
+  isOpenRequestLike,
+  lowerConnection,
+  lowerEnvironment,
+  lowerInstructions,
+  lowerSkill,
+  lowerTool,
+  note,
+  sandboxProviderNameOf,
+  skillMarkdown,
+  toJson,
+  toJsonSchema,
+  warning
+};