@finalai/agent-definition 0.1.0

package/dist/modules/runtime/isolate.mjs

@@ -0,0 +1,454 @@
+import {
+  ConversationKind,
+  DynamicEvent,
+  InputApprovalKind,
+  jsonObjectSchema,
+  jsonValueSchema,
+  McpServerBindingKind,
+  mcpServerBindingSchema,
+  ParticipantKind,
+  providerRefSchema,
+  ToolApproval,
+  unopenedRequestOf
+} from "@finalai/agent-provider";
+import * as z from "zod";
+import { lowerApproval } from "../authoring/approval.mjs";
+import { AuthoredKind, authoredKindOf, stamp } from "../authoring/brand.mjs";
+import {
+  TranscriptRole
+} from "../authoring/context.mjs";
+import {
+  hookHandlersFor
+} from "../authoring/hooks.mjs";
+import { registerToolName, toolLabelSchema } from "../authoring/tools.mjs";
+import { AUTHORED_SERVER_KEY } from "./layout.mjs";
+import {
+  isDynamicSentinel,
+  isEnvironmentLike,
+  isOpenRequestLike,
+  lowerConnection,
+  lowerEnvironment,
+  lowerInstructions,
+  lowerSkill,
+  lowerTool,
+  toJson
+} from "./lower.mjs";
+import { validateSchemaValue } from "./schema-validation.mjs";
+import {
+  authoredRecordSchema,
+  callableSchema,
+  entriesOf,
+  fieldOf,
+  isAsyncIterable,
+  isCallable,
+  isObjectLike,
+  isPlainObject,
+  messageOf,
+  optionalValueSchema
+} from "./values.mjs";
+const jsonOf = (value, path) => {
+  const issues = [];
+  const json = toJson(value, { path, issues });
+  const failure = issues.find((issue) => issue.severity === "error");
+  if (failure != null) throw new Error(failure.message);
+  return json;
+};
+const lastSegment = (exportName) => {
+  const base = exportName.split("#")[0] ?? exportName;
+  return base.split("/").at(-1) ?? base;
+};
+const lowerResolvedValue = (value, key) => {
+  if (value == null) return null;
+  const kind = authoredKindOf(value);
+  if (kind === AuthoredKind.Instructions)
+    return jsonOf(lowerInstructions(value, null), "instructions");
+  if (kind === AuthoredKind.Skill) {
+    const lowered = lowerSkill({ key, value });
+    const failure = lowered.issues.find((issue) => issue.severity === "error");
+    if (failure != null) throw new Error(failure.message);
+    return jsonOf(lowered.skill, "skill");
+  }
+  if (isEnvironmentLike(value) || isOpenRequestLike(value)) {
+    const issues = [];
+    const environment = lowerEnvironment(value, "environment", issues);
+    return jsonOf(environment, "environment");
+  }
+  if (isPlainObject(value)) {
+    const entries = entriesOf(value);
+    if (entries.length > 0 && entries.every(([, item]) => authoredKindOf(item) === AuthoredKind.Skill)) {
+      return entries.map(
+        ([entryKey, item]) => jsonOf(lowerSkill({ key: entryKey, value: item }).skill, "skill")
+      );
+    }
+  }
+  return jsonOf(value, "resolved value");
+};
+const throwOnErrors = (issues) => {
+  const failure = issues.find((issue) => issue.severity === "error");
+  if (failure != null) throw new Error(failure.message);
+};
+const combineMcpServers = (entries) => {
+  const handler = (event) => async (payload, ctx) => {
+    const previous = z.array(mcpServerBindingSchema).safeParse(ctx.previousValue).data ?? [];
+    const tools = [];
+    const approvals = {};
+    const connections = [];
+    const addTool = (name, exportName, value, resolver) => {
+      const lowered = lowerTool({ name, exportName, value });
+      throwOnErrors(lowered.issues);
+      registerToolName(value, name);
+      if (resolver != null) {
+        const snapshot = jsonObjectSchema.parse(
+          jsonOf(
+            {
+              resolver,
+              name,
+              event,
+              payload,
+              session: ctx.session,
+              messages: ctx.messages,
+              channel: ctx.channel
+            },
+            "dynamic tool boundary"
+          )
+        );
+        lowered.descriptor.dynamic = snapshot;
+        if (lowered.descriptor.inputApproval != null)
+          lowered.descriptor.inputApproval = {
+            ...lowered.descriptor.inputApproval,
+            dynamic: snapshot
+          };
+      }
+      tools.push(lowered.descriptor);
+      approvals[name] = lowered.approval;
+    };
+    const addConnection = (key, exportName, value, resolver) => {
+      const lowered = lowerConnection({ key, exportName, value });
+      throwOnErrors(lowered.issues);
+      if (resolver != null && lowered.binding.inputApprovals != null) {
+        const snapshot = jsonObjectSchema.parse(
+          jsonOf(
+            {
+              resolver,
+              name: key,
+              event,
+              payload,
+              session: ctx.session,
+              messages: ctx.messages,
+              channel: ctx.channel
+            },
+            "dynamic connection boundary"
+          )
+        );
+        lowered.binding.inputApprovals = Object.fromEntries(
+          Object.entries(lowered.binding.inputApprovals).map(([name, reference]) => [
+            name,
+            { ...reference, dynamic: snapshot }
+          ])
+        );
+      }
+      connections.push(
+        resolver == null ? lowered.binding : { ...lowered.binding, dynamicResolver: resolver }
+      );
+    };
+    for (const entry of entries) {
+      const add = entry.kind === "tool" ? addTool : (name, exportName, value) => addConnection(name, exportName, value);
+      if (!isDynamicSentinel(entry.value)) {
+        add(entry.key, entry.exportName, entry.value);
+        continue;
+      }
+      const resolve = fieldOf(fieldOf(entry.value, "events"), event);
+      if (!isCallable(resolve)) {
+        for (const server of previous) {
+          if (entry.kind === "connection" && server.kind === McpServerBindingKind.Http && server.dynamicResolver === entry.exportName) {
+            connections.push(server);
+          } else if (entry.kind === "tool" && server.kind === McpServerBindingKind.Worker) {
+            for (const tool of server.tools) {
+              if (tool.dynamic?.["resolver"] !== entry.exportName) continue;
+              tools.push(tool);
+              approvals[tool.name] = Object.hasOwn(server.approvals ?? {}, tool.name) ? server.approvals?.[tool.name] ?? ToolApproval.Allow : ToolApproval.Allow;
+            }
+          }
+        }
+        continue;
+      }
+      const result = await resolve(payload, ctx);
+      if (result == null) continue;
+      const kind = authoredKindOf(result);
+      if (kind === AuthoredKind.Tool || kind === AuthoredKind.Connection) {
+        if (entry.kind === "tool") addTool(entry.key, entry.exportName, result, entry.exportName);
+        else addConnection(entry.key, entry.exportName, result, entry.exportName);
+      } else if (isPlainObject(result)) {
+        for (const [name, item] of entriesOf(result)) {
+          if (entry.kind === "tool")
+            addTool(name, `${entry.exportName}#${name}`, item, entry.exportName);
+          else addConnection(name, `${entry.exportName}#${name}`, item, entry.exportName);
+        }
+      }
+    }
+    const servers = [];
+    if (tools.length > 0) {
+      servers.push({
+        key: AUTHORED_SERVER_KEY,
+        kind: McpServerBindingKind.Worker,
+        tools,
+        approvals
+      });
+    }
+    return jsonOf([...servers, ...connections], "mcpServers");
+  };
+  return stamp(
+    {
+      kind: "final:dynamic",
+      events: {
+        [DynamicEvent.SessionStarted]: handler(DynamicEvent.SessionStarted),
+        [DynamicEvent.TurnStarted]: handler(DynamicEvent.TurnStarted)
+      }
+    },
+    AuthoredKind.Dynamic
+  );
+};
+const matchRoute = (pattern, path) => {
+  const patternParts = pattern.split("/").filter((part) => part.length > 0);
+  const pathParts = path.split("/").filter((part) => part.length > 0);
+  if (patternParts.length !== pathParts.length) return false;
+  return patternParts.every((part, index) => part.startsWith(":") || part === pathParts[index]);
+};
+const toolModuleSchema = z.looseObject({
+  execute: callableSchema,
+  inputSchema: optionalValueSchema,
+  outputSchema: optionalValueSchema,
+  toModelOutput: callableSchema.optional(),
+  label: toolLabelSchema.nullish()
+});
+const sentinelSchema = z.looseObject({ events: authoredRecordSchema });
+const channelModuleSchema = z.looseObject({
+  configure: callableSchema.optional(),
+  routes: z.array(z.looseObject({ method: z.string(), path: z.string(), handler: callableSchema }))
+});
+const dynamicToolBoundarySchema = z.object({
+  resolver: z.string(),
+  name: z.string(),
+  event: z.nativeEnum(DynamicEvent),
+  payload: z.object({
+    type: z.nativeEnum(DynamicEvent),
+    prompt: z.array(jsonValueSchema).nullable()
+  }),
+  session: z.object({
+    id: z.string(),
+    organizationId: z.string(),
+    definitionId: z.string(),
+    revisionId: z.string(),
+    conversation: z.object({
+      id: z.string(),
+      kind: z.nativeEnum(ConversationKind),
+      title: z.string().nullable(),
+      metadata: jsonObjectSchema,
+      participants: z.array(
+        z.object({
+          id: z.string(),
+          kind: z.nativeEnum(ParticipantKind),
+          displayName: z.string(),
+          userId: z.string().nullable()
+        })
+      )
+    }).nullable(),
+    author: z.object({
+      participantId: z.string().nullable(),
+      userId: z.string().nullable(),
+      displayName: z.string()
+    }).nullable(),
+    turn: z.object({ id: z.string() }).nullable(),
+    harness: providerRefSchema
+  }),
+  messages: z.array(
+    z.object({
+      role: z.nativeEnum(TranscriptRole),
+      content: z.array(jsonValueSchema),
+      toolCallId: z.string().nullable(),
+      seq: z.number()
+    })
+  ),
+  channel: z.object({ kind: z.string().nullable() })
+});
+const createIsolateRuntime = (modules) => {
+  const lookup = (name) => {
+    if (!(name in modules)) throw new Error(`bundle has no export ${name}`);
+    return modules[name];
+  };
+  const resolveAuthored = async (args) => {
+    if (args.dynamic == null) return lookup(args.exportName);
+    const boundary = dynamicToolBoundarySchema.parse(args.dynamic);
+    if (args.exportName !== boundary.resolver && args.exportName !== `${boundary.resolver}#${boundary.name}`)
+      throw new Error("dynamic export does not match its boundary");
+    const sentinel = lookup(boundary.resolver);
+    if (!isDynamicSentinel(sentinel)) throw new Error("dynamic resolver is not a defineDynamic");
+    const resolve = fieldOf(fieldOf(sentinel, "events"), boundary.event);
+    if (!isCallable(resolve)) throw new Error("dynamic resolver has no boundary handler");
+    const result = await resolve(boundary.payload, {
+      session: boundary.session,
+      messages: boundary.messages,
+      channel: boundary.channel,
+      secrets: args.secrets
+    });
+    const expected = args.kind === InputApprovalKind.Tool ? AuthoredKind.Tool : AuthoredKind.Connection;
+    return authoredKindOf(result) === expected ? result : fieldOf(result, boundary.name);
+  };
+  return {
+    evaluateApproval: async ({ reference, input, secrets }) => {
+      const value = await resolveAuthored({
+        exportName: reference.export,
+        dynamic: reference.dynamic,
+        kind: reference.kind,
+        secrets
+      });
+      let policy;
+      let validated = input;
+      if (reference.kind === InputApprovalKind.Tool) {
+        const tool = toolModuleSchema.parse(value);
+        validated = await validateSchemaValue({
+          schema: tool.inputSchema,
+          value: input,
+          what: "approval input"
+        });
+        policy = fieldOf(value, "approval");
+      } else {
+        if (authoredKindOf(value) !== AuthoredKind.Connection)
+          throw new Error("approval export is not a connection");
+        policy = reference.policyKey == null ? fieldOf(value, "approval") : fieldOf(fieldOf(fieldOf(value, "tools"), "approval"), reference.policyKey);
+      }
+      const lowered = lowerApproval(policy);
+      const predicate = fieldOf(policy, "predicate");
+      if (lowered.error != null || !lowered.inputDependent || !isCallable(predicate))
+        throw new Error("approval reference has no valid input predicate");
+      return z.boolean().parse(await predicate(validated)) ? ToolApproval.Ask : ToolApproval.Allow;
+    },
+    runTool: async (args) => {
+      const value = await resolveAuthored({
+        exportName: args.export,
+        dynamic: args.dynamic,
+        kind: InputApprovalKind.Tool,
+        secrets: args.ctx.secrets
+      });
+      if (args.dynamic != null)
+        registerToolName(value, dynamicToolBoundarySchema.parse(args.dynamic).name);
+      const parsed = toolModuleSchema.safeParse(value);
+      if (!parsed.success) throw new Error(`${args.export} is not a tool`);
+      const tool = parsed.data;
+      const input = await validateSchemaValue({
+        schema: tool.inputSchema,
+        value: args.input,
+        what: "tool input"
+      });
+      const label = isObjectLike(tool.label) ? tool.label : null;
+      const statusLabel = async (callback, values) => {
+        if (callback == null) return void 0;
+        try {
+          const text = z.string().safeParse(await callback(...values));
+          return text.success ? text.data : void 0;
+        } catch {
+          return void 0;
+        }
+      };
+      const started = await statusLabel(label?.start, [input]);
+      if (started != null) args.onProgress?.(null, started);
+      const result = await tool.execute(input, args.ctx);
+      let output = result;
+      if (isAsyncIterable(result)) {
+        for await (const item of result) {
+          output = item;
+          args.onProgress?.(
+            jsonOf(item, "tool progress"),
+            await statusLabel(label?.delta, [input, item])
+          );
+        }
+      }
+      const validated = await validateSchemaValue({
+        schema: tool.outputSchema,
+        value: output,
+        what: "tool output"
+      });
+      const modelOutput = tool.toModelOutput == null ? null : await tool.toModelOutput(validated);
+      const completed = await statusLabel(label?.complete, [input, validated]);
+      if (completed != null) args.onProgress?.(null, completed);
+      return {
+        output: jsonOf(validated ?? null, "tool output"),
+        modelOutput: modelOutput == null ? null : jsonOf(modelOutput, "tool model output")
+      };
+    },
+    resolveDynamic: async (args) => {
+      const sentinel = lookup(args.export);
+      const parsed = sentinelSchema.safeParse(sentinel);
+      if (!isDynamicSentinel(sentinel) || !parsed.success) {
+        throw new Error(`${args.export} is not a defineDynamic resolver`);
+      }
+      const resolve = parsed.data.events[args.event];
+      if (!isCallable(resolve)) return null;
+      let result;
+      try {
+        result = await resolve(args.payload, args.ctx);
+      } catch (cause) {
+        const request = unopenedRequestOf(cause);
+        if (request == null) throw cause;
+        result = request;
+      }
+      return lowerResolvedValue(result, args.key ?? lastSegment(args.export));
+    },
+    dispatchHook: async (args) => {
+      const handlers = hookHandlersFor(lookup(args.export), args.event);
+      const failures = [];
+      for (const invoke of handlers) {
+        try {
+          await invoke(args.event, args.ctx);
+        } catch (cause) {
+          failures.push({ message: messageOf(cause) });
+        }
+      }
+      return { handled: handlers.length, failures };
+    },
+    handleChannelSocket: async (args) => {
+      const original = channelModuleSchema.safeParse(lookup(args.export));
+      if (!original.success) return null;
+      const parsed = original.data.configure == null ? original : channelModuleSchema.safeParse(await original.data.configure(args.configuration ?? {}));
+      if (!parsed.success) throw new Error(`${args.export} configured channel is invalid`);
+      const route = parsed.data.routes.find(
+        (candidate) => candidate.method === "WS" && matchRoute(candidate.path, args.path)
+      );
+      if (route == null) return null;
+      const response = await route.handler({
+        request: args.request,
+        secrets: args.secrets,
+        receive: args.receive,
+        socket: args.socket
+      });
+      if (response != null && !(response instanceof Response))
+        throw new Error(`${args.export} socket route returned an invalid response`);
+      return response;
+    },
+    handleChannelRoute: async (args) => {
+      const original = channelModuleSchema.safeParse(lookup(args.export));
+      if (!original.success) return null;
+      const parsed = original.data.configure == null ? original : channelModuleSchema.safeParse(await original.data.configure(args.configuration ?? {}));
+      if (!parsed.success) throw new Error(`${args.export} configured channel is invalid`);
+      const route = parsed.data.routes.find(
+        (candidate) => candidate.method === args.request.method && matchRoute(candidate.path, args.path)
+      );
+      if (route == null) return null;
+      const response = await route.handler({
+        request: args.request,
+        secrets: args.secrets,
+        receive: args.receive
+      });
+      if (!(response instanceof Response)) {
+        throw new Error(`${args.export} route ${args.path} did not return a Response`);
+      }
+      return response;
+    }
+  };
+};
+export {
+  combineMcpServers,
+  createIsolateRuntime,
+  lowerResolvedValue
+};
+//# sourceMappingURL=isolate.mjs.map

package/dist/modules/runtime/isolate.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/runtime/isolate.ts"],
+  "sourcesContent": ["import {\n  ConversationKind,\n  DynamicEvent,\n  InputApprovalKind,\n  jsonObjectSchema,\n  jsonValueSchema,\n  McpServerBindingKind,\n  mcpServerBindingSchema,\n  ParticipantKind,\n  providerRefSchema,\n  ToolApproval,\n  unopenedRequestOf,\n  type ChannelReceiveResult,\n  type ChannelSocketIface,\n  type InputApprovalIface,\n  type JsonObject,\n  type JsonValue,\n  type McpServerBinding,\n  type ToolDescriptorIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { lowerApproval } from \"../authoring/approval.mjs\";\nimport { AuthoredKind, authoredKindOf, stamp } from \"../authoring/brand.mjs\";\nimport {\n  TranscriptRole,\n  type DynamicResolveContextIface,\n  type ToolContextIface,\n} from \"../authoring/context.mjs\";\nimport type { DynamicBoundaryEventIface } from \"../authoring/dynamic.mjs\";\nimport {\n  hookHandlersFor,\n  type HookContextIface,\n  type HookDispatchEventIface,\n} from \"../authoring/hooks.mjs\";\nimport { registerToolName, toolLabelSchema } from \"../authoring/tools.mjs\";\nimport { AUTHORED_SERVER_KEY } from \"./layout.mjs\";\nimport {\n  isDynamicSentinel,\n  isEnvironmentLike,\n  isOpenRequestLike,\n  lowerConnection,\n  lowerEnvironment,\n  lowerInstructions,\n  lowerSkill,\n  lowerTool,\n  toJson,\n  type IssueIface,\n} from \"./lower.mjs\";\nimport { validateSchemaValue } from \"./schema-validation.mjs\";\nimport {\n  authoredRecordSchema,\n  callableSchema,\n  entriesOf,\n  fieldOf,\n  isAsyncIterable,\n  isCallable,\n  isObjectLike,\n  isPlainObject,\n  messageOf,\n  optionalValueSchema,\n  type AuthoredCallable,\n  type AuthoredRecord,\n  type AuthoredValue,\n} from \"./values.mjs\";\n\n// What an agent bundle exposes to the Worker isolate that runs it (B4/B7):\n// the authored module map plus helpers that run its exports. The bundle is\n// the only place authored code executes.\n\nexport interface RunToolArgsIface {\n  export: string;\n  input: AuthoredValue;\n  dynamic?: JsonValue;\n  ctx: ToolContextIface;\n  // Each yield of an async-generator execute, for MCP progress notifications.\n  onProgress?: (value: JsonValue, label?: string) => void;\n}\n\nexport interface RunToolResultIface {\n  output: JsonValue;\n  // toModelOutput's projection, when the tool has one.\n  modelOutput: JsonValue | null;\n}\n\nexport interface ResolveDynamicArgsIface {\n  export: string;\n  event: DynamicEvent;\n  payload: DynamicBoundaryEventIface;\n  ctx: DynamicResolveContextIface;\n  // Names a single returned skill (defaults to the export's last path segment).\n  key?: string;\n}\n\nexport interface DispatchHookArgsIface {\n  export: string;\n  event: HookDispatchEventIface;\n  ctx: HookContextIface;\n}\n\nexport interface HookFailureIface {\n  message: string;\n}\n\nexport interface ChannelRouteArgsIface {\n  export: string;\n  request: Request;\n  configuration?: JsonObject;\n  // The route path relative to the channel's mount point ('/webhook').\n  path: string;\n  secrets: { get(name: string): Promise<string | null> };\n  receive: (input: JsonValue) => Promise<ChannelReceiveResult>;\n}\n\nexport interface ChannelSocketArgsIface extends ChannelRouteArgsIface {\n  socket: ChannelSocketIface;\n}\n\nexport interface IsolateRuntimeIface {\n  evaluateApproval(args: {\n    reference: InputApprovalIface;\n    input: AuthoredValue;\n    secrets: { get(name: string): Promise<string | null> };\n  }): Promise<ToolApproval>;\n  runTool(args: RunToolArgsIface): Promise<RunToolResultIface>;\n  resolveDynamic(args: ResolveDynamicArgsIface): Promise<JsonValue | null>;\n  dispatchHook(\n    args: DispatchHookArgsIface,\n  ): Promise<{ handled: number; failures: HookFailureIface[] }>;\n  // Null when no route of the channel matches the method and path.\n  handleChannelRoute(args: ChannelRouteArgsIface): Promise<Response | null>;\n  handleChannelSocket(args: ChannelSocketArgsIface): Promise<Response | void | null>;\n}\n\nconst jsonOf = (value: AuthoredValue, path: string): JsonValue => {\n  const issues: IssueIface[] = [];\n  const json = toJson(value, { path, issues });\n  const failure = issues.find((issue) => issue.severity === 'error');\n  if (failure != null) throw new Error(failure.message);\n  return json;\n};\n\nconst lastSegment = (exportName: string): string => {\n  const base = exportName.split('#')[0] ?? exportName;\n  return base.split('/').at(-1) ?? base;\n};\n\n// Lowers a resolver's return value to manifest JSON by what it is.\nexport const lowerResolvedValue = (value: AuthoredValue, key: string): JsonValue | null => {\n  if (value == null) return null;\n  const kind = authoredKindOf(value);\n  if (kind === AuthoredKind.Instructions)\n    return jsonOf(lowerInstructions(value, null), 'instructions');\n  if (kind === AuthoredKind.Skill) {\n    const lowered = lowerSkill({ key, value });\n    const failure = lowered.issues.find((issue) => issue.severity === 'error');\n    if (failure != null) throw new Error(failure.message);\n    return jsonOf(lowered.skill, 'skill');\n  }\n  if (isEnvironmentLike(value) || isOpenRequestLike(value)) {\n    const issues: IssueIface[] = [];\n    const environment = lowerEnvironment(value, 'environment', issues);\n    return jsonOf(environment, 'environment');\n  }\n  if (isPlainObject(value)) {\n    const entries = entriesOf(value);\n    if (\n      entries.length > 0 &&\n      entries.every(([, item]) => authoredKindOf(item) === AuthoredKind.Skill)\n    ) {\n      return entries.map(([entryKey, item]) =>\n        jsonOf(lowerSkill({ key: entryKey, value: item }).skill, 'skill'),\n      );\n    }\n  }\n  return jsonOf(value, 'resolved value');\n};\n\nexport interface CombinedEntryIface {\n  kind: 'tool' | 'connection';\n  key: string;\n  exportName: string;\n  value: AuthoredValue;\n}\n\nconst throwOnErrors = (issues: IssueIface[]): void => {\n  const failure = issues.find((issue) => issue.severity === 'error');\n  if (failure != null) throw new Error(failure.message);\n};\n\n// A resolver for the whole `mcpServers` field, used when any tool or\n// connection is dynamic: the manifest stores one slot and the session gets\n// the static and resolved entries together.\nexport const combineMcpServers = (entries: CombinedEntryIface[]): AuthoredValue => {\n  const handler =\n    (event: DynamicEvent) =>\n    async (payload: DynamicBoundaryEventIface, ctx: DynamicResolveContextIface) => {\n      const previous = z.array(mcpServerBindingSchema).safeParse(ctx.previousValue).data ?? [];\n      const tools: ToolDescriptorIface[] = [];\n      const approvals: Record<string, ToolApproval> = {};\n      const connections: McpServerBinding[] = [];\n      const addTool = (\n        name: string,\n        exportName: string,\n        value: AuthoredValue,\n        resolver?: string,\n      ): void => {\n        const lowered = lowerTool({ name, exportName, value });\n        throwOnErrors(lowered.issues);\n        registerToolName(value, name);\n        if (resolver != null) {\n          const snapshot = jsonObjectSchema.parse(\n            jsonOf(\n              {\n                resolver,\n                name,\n                event,\n                payload,\n                session: ctx.session,\n                messages: ctx.messages,\n                channel: ctx.channel,\n              },\n              'dynamic tool boundary',\n            ),\n          );\n          lowered.descriptor.dynamic = snapshot;\n          if (lowered.descriptor.inputApproval != null)\n            lowered.descriptor.inputApproval = {\n              ...lowered.descriptor.inputApproval,\n              dynamic: snapshot,\n            };\n        }\n        tools.push(lowered.descriptor);\n        approvals[name] = lowered.approval;\n      };\n      const addConnection = (\n        key: string,\n        exportName: string,\n        value: AuthoredValue,\n        resolver?: string,\n      ): void => {\n        const lowered = lowerConnection({ key, exportName, value });\n        throwOnErrors(lowered.issues);\n        if (resolver != null && lowered.binding.inputApprovals != null) {\n          const snapshot = jsonObjectSchema.parse(\n            jsonOf(\n              {\n                resolver,\n                name: key,\n                event,\n                payload,\n                session: ctx.session,\n                messages: ctx.messages,\n                channel: ctx.channel,\n              },\n              'dynamic connection boundary',\n            ),\n          );\n          lowered.binding.inputApprovals = Object.fromEntries(\n            Object.entries(lowered.binding.inputApprovals).map(([name, reference]) => [\n              name,\n              { ...reference, dynamic: snapshot },\n            ]),\n          );\n        }\n        connections.push(\n          resolver == null ? lowered.binding : { ...lowered.binding, dynamicResolver: resolver },\n        );\n      };\n      for (const entry of entries) {\n        const add =\n          entry.kind === 'tool'\n            ? addTool\n            : (name: string, exportName: string, value: AuthoredValue) =>\n                addConnection(name, exportName, value);\n        if (!isDynamicSentinel(entry.value)) {\n          add(entry.key, entry.exportName, entry.value);\n          continue;\n        }\n        const resolve = fieldOf(fieldOf(entry.value, 'events'), event);\n        if (!isCallable(resolve)) {\n          for (const server of previous) {\n            if (\n              entry.kind === 'connection' &&\n              server.kind === McpServerBindingKind.Http &&\n              server.dynamicResolver === entry.exportName\n            ) {\n              connections.push(server);\n            } else if (entry.kind === 'tool' && server.kind === McpServerBindingKind.Worker) {\n              for (const tool of server.tools) {\n                if (tool.dynamic?.['resolver'] !== entry.exportName) continue;\n                tools.push(tool);\n                approvals[tool.name] = Object.hasOwn(server.approvals ?? {}, tool.name)\n                  ? (server.approvals?.[tool.name] ?? ToolApproval.Allow)\n                  : ToolApproval.Allow;\n              }\n            }\n          }\n          continue;\n        }\n        const result = await resolve(payload, ctx);\n        if (result == null) continue;\n        const kind = authoredKindOf(result);\n        if (kind === AuthoredKind.Tool || kind === AuthoredKind.Connection) {\n          if (entry.kind === 'tool') addTool(entry.key, entry.exportName, result, entry.exportName);\n          else addConnection(entry.key, entry.exportName, result, entry.exportName);\n        } else if (isPlainObject(result)) {\n          for (const [name, item] of entriesOf(result)) {\n            if (entry.kind === 'tool')\n              addTool(name, `${entry.exportName}#${name}`, item, entry.exportName);\n            else addConnection(name, `${entry.exportName}#${name}`, item, entry.exportName);\n          }\n        }\n      }\n      const servers: McpServerBinding[] = [];\n      if (tools.length > 0) {\n        servers.push({\n          key: AUTHORED_SERVER_KEY,\n          kind: McpServerBindingKind.Worker,\n          tools,\n          approvals,\n        });\n      }\n      return jsonOf([...servers, ...connections], 'mcpServers');\n    };\n  return stamp(\n    {\n      kind: 'final:dynamic' as const,\n      events: {\n        [DynamicEvent.SessionStarted]: handler(DynamicEvent.SessionStarted),\n        [DynamicEvent.TurnStarted]: handler(DynamicEvent.TurnStarted),\n      },\n    },\n    AuthoredKind.Dynamic,\n  );\n};\n\nconst matchRoute = (pattern: string, path: string): boolean => {\n  const patternParts = pattern.split('/').filter((part) => part.length > 0);\n  const pathParts = path.split('/').filter((part) => part.length > 0);\n  if (patternParts.length !== pathParts.length) return false;\n  return patternParts.every((part, index) => part.startsWith(':') || part === pathParts[index]);\n};\n\nconst toolModuleSchema = z.looseObject({\n  execute: callableSchema,\n  inputSchema: optionalValueSchema,\n  outputSchema: optionalValueSchema,\n  toModelOutput: callableSchema.optional(),\n  label: toolLabelSchema.nullish(),\n});\n\nconst sentinelSchema = z.looseObject({ events: authoredRecordSchema });\n\nconst channelModuleSchema = z.looseObject({\n  configure: callableSchema.optional(),\n  routes: z.array(z.looseObject({ method: z.string(), path: z.string(), handler: callableSchema })),\n});\n\nconst dynamicToolBoundarySchema = z.object({\n  resolver: z.string(),\n  name: z.string(),\n  event: z.nativeEnum(DynamicEvent),\n  payload: z.object({\n    type: z.nativeEnum(DynamicEvent),\n    prompt: z.array(jsonValueSchema).nullable(),\n  }),\n  session: z.object({\n    id: z.string(),\n    organizationId: z.string(),\n    definitionId: z.string(),\n    revisionId: z.string(),\n    conversation: z\n      .object({\n        id: z.string(),\n        kind: z.nativeEnum(ConversationKind),\n        title: z.string().nullable(),\n        metadata: jsonObjectSchema,\n        participants: z.array(\n          z.object({\n            id: z.string(),\n            kind: z.nativeEnum(ParticipantKind),\n            displayName: z.string(),\n            userId: z.string().nullable(),\n          }),\n        ),\n      })\n      .nullable(),\n    author: z\n      .object({\n        participantId: z.string().nullable(),\n        userId: z.string().nullable(),\n        displayName: z.string(),\n      })\n      .nullable(),\n    turn: z.object({ id: z.string() }).nullable(),\n    harness: providerRefSchema,\n  }),\n  messages: z.array(\n    z.object({\n      role: z.nativeEnum(TranscriptRole),\n      content: z.array(jsonValueSchema),\n      toolCallId: z.string().nullable(),\n      seq: z.number(),\n    }),\n  ),\n  channel: z.object({ kind: z.string().nullable() }),\n});\n\nexport const createIsolateRuntime = (modules: AuthoredRecord): IsolateRuntimeIface => {\n  const lookup = (name: string): AuthoredValue => {\n    if (!(name in modules)) throw new Error(`bundle has no export ${name}`);\n    return modules[name];\n  };\n  const resolveAuthored = async (args: {\n    exportName: string;\n    dynamic?: JsonValue;\n    kind: InputApprovalKind;\n    secrets: { get(name: string): Promise<string | null> };\n  }): Promise<AuthoredValue> => {\n    if (args.dynamic == null) return lookup(args.exportName);\n    const boundary = dynamicToolBoundarySchema.parse(args.dynamic);\n    if (\n      args.exportName !== boundary.resolver &&\n      args.exportName !== `${boundary.resolver}#${boundary.name}`\n    )\n      throw new Error('dynamic export does not match its boundary');\n    const sentinel = lookup(boundary.resolver);\n    if (!isDynamicSentinel(sentinel)) throw new Error('dynamic resolver is not a defineDynamic');\n    const resolve = fieldOf(fieldOf(sentinel, 'events'), boundary.event);\n    if (!isCallable(resolve)) throw new Error('dynamic resolver has no boundary handler');\n    const result = await resolve(boundary.payload, {\n      session: boundary.session,\n      messages: boundary.messages,\n      channel: boundary.channel,\n      secrets: args.secrets,\n    });\n    const expected =\n      args.kind === InputApprovalKind.Tool ? AuthoredKind.Tool : AuthoredKind.Connection;\n    return authoredKindOf(result) === expected ? result : fieldOf(result, boundary.name);\n  };\n  return {\n    evaluateApproval: async ({ reference, input, secrets }) => {\n      const value = await resolveAuthored({\n        exportName: reference.export,\n        dynamic: reference.dynamic,\n        kind: reference.kind,\n        secrets,\n      });\n      let policy: AuthoredValue;\n      let validated: AuthoredValue = input;\n      if (reference.kind === InputApprovalKind.Tool) {\n        const tool = toolModuleSchema.parse(value);\n        validated = await validateSchemaValue({\n          schema: tool.inputSchema,\n          value: input,\n          what: 'approval input',\n        });\n        policy = fieldOf(value, 'approval');\n      } else {\n        if (authoredKindOf(value) !== AuthoredKind.Connection)\n          throw new Error('approval export is not a connection');\n        policy =\n          reference.policyKey == null\n            ? fieldOf(value, 'approval')\n            : fieldOf(fieldOf(fieldOf(value, 'tools'), 'approval'), reference.policyKey);\n      }\n      const lowered = lowerApproval(policy);\n      const predicate = fieldOf(policy, 'predicate');\n      if (lowered.error != null || !lowered.inputDependent || !isCallable(predicate))\n        throw new Error('approval reference has no valid input predicate');\n      return z.boolean().parse(await predicate(validated)) ? ToolApproval.Ask : ToolApproval.Allow;\n    },\n    runTool: async (args) => {\n      const value = await resolveAuthored({\n        exportName: args.export,\n        dynamic: args.dynamic,\n        kind: InputApprovalKind.Tool,\n        secrets: args.ctx.secrets,\n      });\n      if (args.dynamic != null)\n        registerToolName(value, dynamicToolBoundarySchema.parse(args.dynamic).name);\n      const parsed = toolModuleSchema.safeParse(value);\n      if (!parsed.success) throw new Error(`${args.export} is not a tool`);\n      const tool = parsed.data;\n      const input = await validateSchemaValue({\n        schema: tool.inputSchema,\n        value: args.input,\n        what: 'tool input',\n      });\n      const label = isObjectLike(tool.label) ? tool.label : null;\n      const statusLabel = async (\n        callback: AuthoredCallable | undefined,\n        values: AuthoredValue[],\n      ): Promise<string | undefined> => {\n        if (callback == null) return undefined;\n        try {\n          const text = z.string().safeParse(await callback(...values));\n          return text.success ? text.data : undefined;\n        } catch {\n          // Display labels must not turn a completed side effect into a tool failure.\n          return undefined;\n        }\n      };\n      const started = await statusLabel(label?.start, [input]);\n      if (started != null) args.onProgress?.(null, started);\n      const result = await tool.execute(input, args.ctx);\n      let output: AuthoredValue = result;\n      if (isAsyncIterable(result)) {\n        for await (const item of result) {\n          output = item;\n          args.onProgress?.(\n            jsonOf(item, 'tool progress'),\n            await statusLabel(label?.delta, [input, item]),\n          );\n        }\n      }\n      const validated = await validateSchemaValue({\n        schema: tool.outputSchema,\n        value: output,\n        what: 'tool output',\n      });\n      const modelOutput = tool.toModelOutput == null ? null : await tool.toModelOutput(validated);\n      const completed = await statusLabel(label?.complete, [input, validated]);\n      if (completed != null) args.onProgress?.(null, completed);\n      return {\n        output: jsonOf(validated ?? null, 'tool output'),\n        modelOutput: modelOutput == null ? null : jsonOf(modelOutput, 'tool model output'),\n      };\n    },\n    resolveDynamic: async (args) => {\n      const sentinel = lookup(args.export);\n      const parsed = sentinelSchema.safeParse(sentinel);\n      if (!isDynamicSentinel(sentinel) || !parsed.success) {\n        throw new Error(`${args.export} is not a defineDynamic resolver`);\n      }\n      const resolve = parsed.data.events[args.event];\n      if (!isCallable(resolve)) return null;\n      let result: AuthoredValue;\n      try {\n        result = await resolve(args.payload, args.ctx);\n      } catch (cause) {\n        // Dynamic handlers describe configurations; live setup belongs in defineSandbox.\n        // `async () => environment.open(...)` is lowered as a request.\n        const request = unopenedRequestOf(cause);\n        if (request == null) throw cause;\n        result = request;\n      }\n      return lowerResolvedValue(result, args.key ?? lastSegment(args.export));\n    },\n    dispatchHook: async (args) => {\n      const handlers = hookHandlersFor(lookup(args.export), args.event);\n      const failures: HookFailureIface[] = [];\n      for (const invoke of handlers) {\n        try {\n          await invoke(args.event, args.ctx);\n        } catch (cause) {\n          failures.push({ message: messageOf(cause) });\n        }\n      }\n      return { handled: handlers.length, failures };\n    },\n    handleChannelSocket: async (args) => {\n      const original = channelModuleSchema.safeParse(lookup(args.export));\n      if (!original.success) return null;\n      const parsed =\n        original.data.configure == null\n          ? original\n          : channelModuleSchema.safeParse(await original.data.configure(args.configuration ?? {}));\n      if (!parsed.success) throw new Error(`${args.export} configured channel is invalid`);\n      const route = parsed.data.routes.find(\n        (candidate) => candidate.method === 'WS' && matchRoute(candidate.path, args.path),\n      );\n      if (route == null) return null;\n      const response = await route.handler({\n        request: args.request,\n        secrets: args.secrets,\n        receive: args.receive,\n        socket: args.socket,\n      });\n      if (response != null && !(response instanceof Response))\n        throw new Error(`${args.export} socket route returned an invalid response`);\n      return response;\n    },\n    handleChannelRoute: async (args) => {\n      const original = channelModuleSchema.safeParse(lookup(args.export));\n      if (!original.success) return null;\n      const parsed =\n        original.data.configure == null\n          ? original\n          : channelModuleSchema.safeParse(await original.data.configure(args.configuration ?? {}));\n      if (!parsed.success) throw new Error(`${args.export} configured channel is invalid`);\n      const route = parsed.data.routes.find(\n        (candidate) =>\n          candidate.method === args.request.method && matchRoute(candidate.path, args.path),\n      );\n      if (route == null) return null;\n      const response = await route.handler({\n        request: args.request,\n        secrets: args.secrets,\n        receive: args.receive,\n      });\n      if (!(response instanceof Response)) {\n        throw new Error(`${args.export} route ${args.path} did not return a Response`);\n      }\n      return response;\n    },\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/runtime/layout.d.mts

@@ -0,0 +1,21 @@
+export declare enum SlotKind {
+    Agent = "agent",
+    Instructions = "instructions",
+    Skill = "skill",
+    Tool = "tool",
+    Connection = "connection",
+    Schedule = "schedule",
+    Hook = "hook",
+    Channel = "channel",
+    Sandbox = "sandbox"
+}
+export interface LayoutModuleIface {
+    base: string;
+    path: string;
+    slot: SlotKind;
+    key: string;
+}
+export declare const AGENT_DYNAMIC_PREFIX = "agent:";
+export declare const COMBINED_MCP_SERVERS_EXPORT = "final:mcpServers";
+export declare const AUTHORED_SERVER_KEY = "authored";
+export declare const namedExportName: (base: string, name: string) => string;

package/dist/modules/runtime/layout.mjs

@@ -0,0 +1,24 @@
+var SlotKind = /* @__PURE__ */ ((SlotKind2) => {
+  SlotKind2["Agent"] = "agent";
+  SlotKind2["Instructions"] = "instructions";
+  SlotKind2["Skill"] = "skill";
+  SlotKind2["Tool"] = "tool";
+  SlotKind2["Connection"] = "connection";
+  SlotKind2["Schedule"] = "schedule";
+  SlotKind2["Hook"] = "hook";
+  SlotKind2["Channel"] = "channel";
+  SlotKind2["Sandbox"] = "sandbox";
+  return SlotKind2;
+})(SlotKind || {});
+const AGENT_DYNAMIC_PREFIX = "agent:";
+const COMBINED_MCP_SERVERS_EXPORT = "final:mcpServers";
+const AUTHORED_SERVER_KEY = "authored";
+const namedExportName = (base, name) => name === "default" ? base : `${base}#${name}`;
+export {
+  AGENT_DYNAMIC_PREFIX,
+  AUTHORED_SERVER_KEY,
+  COMBINED_MCP_SERVERS_EXPORT,
+  SlotKind,
+  namedExportName
+};
+//# sourceMappingURL=layout.mjs.map

package/dist/modules/runtime/layout.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/runtime/layout.ts"],
+  "sourcesContent": ["// The module layout the compiler hands to the bundle entry: every authored\n// module it discovered, in bundle order, with its slot and key.\n\nexport enum SlotKind {\n  Agent = 'agent',\n  Instructions = 'instructions',\n  Skill = 'skill',\n  Tool = 'tool',\n  Connection = 'connection',\n  Schedule = 'schedule',\n  Hook = 'hook',\n  Channel = 'channel',\n  Sandbox = 'sandbox',\n}\n\nexport interface LayoutModuleIface {\n  // Bundle export base: the path without extension ('tools/lookup_release_notes').\n  base: string;\n  path: string;\n  slot: SlotKind;\n  // Name in its slot: tool name, connection key, skill key, hook slug, ...\n  key: string;\n}\n\nexport const AGENT_DYNAMIC_PREFIX = 'agent:';\nexport const COMBINED_MCP_SERVERS_EXPORT = 'final:mcpServers';\nexport const AUTHORED_SERVER_KEY = 'authored';\n\nexport const namedExportName = (base: string, name: string): string =>\n  name === 'default' ? base : `${base}#${name}`;\n"],
+  "mappings": "AAGO,IAAK,WAAL,kBAAKA,cAAL;AACL,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,kBAAe;AACf,EAAAA,UAAA,WAAQ;AACR,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,gBAAa;AACb,EAAAA,UAAA,cAAW;AACX,EAAAA,UAAA,UAAO;AACP,EAAAA,UAAA,aAAU;AACV,EAAAA,UAAA,aAAU;AATA,SAAAA;AAAA,GAAA;AAqBL,MAAM,uBAAuB;AAC7B,MAAM,8BAA8B;AACpC,MAAM,sBAAsB;AAE5B,MAAM,kBAAkB,CAAC,MAAc,SAC5C,SAAS,YAAY,OAAO,GAAG,IAAI,IAAI,IAAI;",
+  "names": ["SlotKind"]
+}

package/dist/modules/runtime/lower.d.mts

@@ -0,0 +1,73 @@
+import { ToolApproval, type HttpMcpServerBindingIface, type InstructionFragmentIface, type JsonObject, type JsonValue, type SkillBundleIface, type ToolDescriptorIface } from '@finalai/agent-provider';
+import { SchemaIo } from "./schema-validation.mjs";
+import { type AuthoredValue } from "./values.mjs";
+export declare enum IssueSeverity {
+    Error = "error",
+    Warning = "warning",
+    Note = "note"
+}
+export interface IssueIface {
+    severity: IssueSeverity;
+    message: string;
+}
+export declare const error: (message: string) => IssueIface;
+export declare const warning: (message: string) => IssueIface;
+export declare const note: (message: string) => IssueIface;
+export declare const childPath: (parent: string, key: string | number) => string;
+export interface ToJsonOptionsIface {
+    path: string;
+    issues: IssueIface[];
+    visit?: (value: AuthoredValue, path: string) => JsonValue | undefined;
+}
+export declare const toJson: (value: AuthoredValue, options: ToJsonOptionsIface) => JsonValue;
+export declare const toJsonSchema: (args: {
+    schema: AuthoredValue;
+    path: string;
+    issues: IssueIface[];
+    io?: SchemaIo;
+}) => JsonObject | null;
+export interface LoweredToolIface {
+    descriptor: ToolDescriptorIface;
+    approval: ToolApproval;
+    issues: IssueIface[];
+}
+export declare const lowerTool: (args: {
+    name: string;
+    exportName: string;
+    value: AuthoredValue;
+}) => LoweredToolIface;
+export interface LoweredConnectionIface {
+    binding: HttpMcpServerBindingIface;
+    issues: IssueIface[];
+}
+export declare const lowerConnection: (args: {
+    key: string;
+    exportName: string;
+    value: AuthoredValue;
+}) => LoweredConnectionIface;
+export declare const skillMarkdown: (args: {
+    key: string;
+    description: string;
+    markdown: string;
+}) => string;
+export interface LoweredSkillIface {
+    skill: SkillBundleIface;
+    issues: IssueIface[];
+}
+export declare const lowerSkill: (args: {
+    key: string;
+    value: AuthoredValue;
+}) => LoweredSkillIface;
+export declare const lowerInstructions: (value: AuthoredValue, source: string | null) => InstructionFragmentIface | null;
+export interface LoweredEnvironmentIface {
+    providerName: string;
+    providerRef: JsonValue | null;
+    options: JsonValue;
+    openOptions: JsonValue | null;
+}
+export declare const isEnvironmentLike: (value: AuthoredValue) => boolean;
+export declare const isOpenRequestLike: (value: AuthoredValue) => boolean;
+export declare const sandboxProviderNameOf: (value: AuthoredValue) => string | null;
+export declare const lowerEnvironment: (value: AuthoredValue, path: string, issues: IssueIface[]) => LoweredEnvironmentIface | null;
+export declare const isDynamicSentinel: (value: AuthoredValue) => boolean;
+export declare const dynamicEventsOf: (value: AuthoredValue) => string[];