@finalai/agent-definition 0.1.3 → 0.1.4

package/dist/modules/runtime/described.mjs

@@ -1,4 +1,8 @@
-import { hostedBindingRequirementSchema, jsonValueSchema } from "@finalai/agent-provider";
+import {
+  agentAvatarSchema,
+  hostedBindingRequirementSchema,
+  jsonValueSchema
+} from "@finalai/agent-provider";
 import * as z from "zod";
 import { SlotKind } from "./layout.mjs";
 import { IssueSeverity } from "./lower.mjs";
@@ -19,7 +23,7 @@ const describedAgentSchema = z.object({
   type: z.literal("agent"),
   name: z.string().nullable(),
   description: z.string().nullable(),
-  avatarUrl: z.string().nullable(),
+  avatar: agentAvatarSchema.nullable().default(null),
   harness: z.object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),
   tools: z.record(z.string(), z.string()).nullable(),
   // Capabilities bound to `harnessHost` (the harness's own host, no target).

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/runtime/described.ts"],
-  "sourcesContent": ["import { hostedBindingRequirementSchema, jsonValueSchema } from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { SlotKind } from \"./layout.mjs\";\nimport { IssueSeverity } from \"./lower.mjs\";\n\n// The static description of a bundle's authored modules, produced inside the\n// evaluation realm and parsed by the compiler. Everything is JSON.\n\nexport const issueSchema = z.object({ severity: z.nativeEnum(IssueSeverity), message: z.string() });\n\nconst providerHintSchema = z.object({\n  ref: jsonValueSchema.nullable(),\n  name: z.string().nullable(),\n});\n\nexport const describedDynamicSchema = z.object({\n  type: z.literal('dynamic'),\n  events: z.array(z.string()),\n  description: z.string().nullable(),\n  preview: z.string().nullable(),\n  requiredBindings: z.array(hostedBindingRequirementSchema).optional(),\n  provider: providerHintSchema.nullable(),\n});\n\nconst describedAgentSchema = z.object({\n  type: z.literal('agent'),\n  name: z.string().nullable(),\n  description: z.string().nullable(),\n  avatarUrl: z.string().nullable(),\n  harness: z.object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),\n  tools: z.record(z.string(), z.string()).nullable(),\n  // Capabilities bound to `harnessHost` (the harness's own host, no target).\n  hostTools: z.array(z.string()).nullable().default(null),\n  toolPolicy: z.record(z.string(), z.string()).nullable(),\n  secrets: z.array(z.string()).nullable(),\n  channels: z\n    .array(\n      z.object({ key: z.string().nullable(), channel: jsonValueSchema, config: jsonValueSchema }),\n    )\n    .nullable(),\n});\n\nconst describedInstructionsSchema = z.object({\n  type: z.literal('instructions'),\n  role: z.string(),\n  content: z.string(),\n});\n\nconst describedSkillSchema = z.object({ type: z.literal('skill'), skill: jsonValueSchema });\n\nconst describedToolSchema = z.object({\n  type: z.literal('tool'),\n  descriptor: jsonValueSchema,\n  approval: z.string(),\n});\n\nconst describedConnectionSchema = z.object({\n  type: z.literal('connection'),\n  binding: jsonValueSchema,\n});\n\nconst describedScheduleSchema = z.object({\n  type: z.literal('schedule'),\n  cron: z.string().nullable(),\n  markdown: z.string().nullable(),\n  timezone: z.string().nullable(),\n  target: z.string().nullable(),\n});\n\nconst describedHookSchema = z.object({ type: z.literal('hook'), keys: z.array(z.string()) });\n\nconst describedChannelSchema = z.object({\n  type: z.literal('channel'),\n  routes: z.array(z.object({ method: z.string(), path: z.string() })),\n  turnPolicy: z.string().nullable(),\n  config: jsonValueSchema,\n  disabled: z.boolean().default(false),\n  installed: jsonValueSchema.nullable().default(null),\n});\n\nexport const describedEnvironmentSchema = z.object({\n  providerName: z.string(),\n  providerRef: jsonValueSchema.nullable(),\n  options: jsonValueSchema,\n  openOptions: jsonValueSchema.nullable(),\n});\n\nconst describedSandboxTargetSchema = z.object({\n  exportName: z.string(),\n  environment: describedEnvironmentSchema.nullable(),\n  dynamic: describedDynamicSchema.nullable(),\n});\n\nconst describedSandboxSchema = z.object({\n  type: z.literal('sandbox'),\n  targets: z.record(z.string(), describedSandboxTargetSchema),\n  // Bundle export name \u2192 provider name, for providers defined in sandbox.ts.\n  providers: z.record(z.string(), z.string()),\n  selector: z.boolean(),\n  defaultTarget: z.string().nullable(),\n});\n\nexport const describedValueSchema = z.discriminatedUnion('type', [\n  describedAgentSchema,\n  describedDynamicSchema,\n  describedInstructionsSchema,\n  describedSkillSchema,\n  describedToolSchema,\n  describedConnectionSchema,\n  describedScheduleSchema,\n  describedHookSchema,\n  describedChannelSchema,\n  describedSandboxSchema,\n]);\n\nexport const describedModuleSchema = z.object({\n  base: z.string(),\n  path: z.string(),\n  slot: z.nativeEnum(SlotKind),\n  key: z.string(),\n  hasDefault: z.boolean(),\n  issues: z.array(issueSchema),\n  value: describedValueSchema.nullable(),\n});\n\nexport const describedBundleSchema = z.object({\n  modules: z.array(describedModuleSchema),\n  // Exports the bundle synthesizes beyond the authored ones.\n  synthesized: z.array(z.string()),\n});\n\nexport type DescribedIssueIface = z.infer<typeof issueSchema>;\nexport type DescribedDynamicIface = z.infer<typeof describedDynamicSchema>;\nexport type DescribedAgentIface = z.infer<typeof describedAgentSchema>;\nexport type DescribedSandboxIface = z.infer<typeof describedSandboxSchema>;\nexport type DescribedSandboxTargetIface = z.infer<typeof describedSandboxTargetSchema>;\nexport type DescribedEnvironmentIface = z.infer<typeof describedEnvironmentSchema>;\nexport type DescribedValue = z.infer<typeof describedValueSchema>;\nexport type DescribedModuleIface = z.infer<typeof describedModuleSchema>;\nexport type DescribedBundleIface = z.infer<typeof describedBundleSchema>;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  agentAvatarSchema,\n  hostedBindingRequirementSchema,\n  jsonValueSchema,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { SlotKind } from \"./layout.mjs\";\nimport { IssueSeverity } from \"./lower.mjs\";\n\n// The static description of a bundle's authored modules, produced inside the\n// evaluation realm and parsed by the compiler. Everything is JSON.\n\nexport const issueSchema = z.object({ severity: z.nativeEnum(IssueSeverity), message: z.string() });\n\nconst providerHintSchema = z.object({\n  ref: jsonValueSchema.nullable(),\n  name: z.string().nullable(),\n});\n\nexport const describedDynamicSchema = z.object({\n  type: z.literal('dynamic'),\n  events: z.array(z.string()),\n  description: z.string().nullable(),\n  preview: z.string().nullable(),\n  requiredBindings: z.array(hostedBindingRequirementSchema).optional(),\n  provider: providerHintSchema.nullable(),\n});\n\nconst describedAgentSchema = z.object({\n  type: z.literal('agent'),\n  name: z.string().nullable(),\n  description: z.string().nullable(),\n  avatar: agentAvatarSchema.nullable().default(null),\n  harness: z.object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),\n  tools: z.record(z.string(), z.string()).nullable(),\n  // Capabilities bound to `harnessHost` (the harness's own host, no target).\n  hostTools: z.array(z.string()).nullable().default(null),\n  toolPolicy: z.record(z.string(), z.string()).nullable(),\n  secrets: z.array(z.string()).nullable(),\n  channels: z\n    .array(\n      z.object({ key: z.string().nullable(), channel: jsonValueSchema, config: jsonValueSchema }),\n    )\n    .nullable(),\n});\n\nconst describedInstructionsSchema = z.object({\n  type: z.literal('instructions'),\n  role: z.string(),\n  content: z.string(),\n});\n\nconst describedSkillSchema = z.object({ type: z.literal('skill'), skill: jsonValueSchema });\n\nconst describedToolSchema = z.object({\n  type: z.literal('tool'),\n  descriptor: jsonValueSchema,\n  approval: z.string(),\n});\n\nconst describedConnectionSchema = z.object({\n  type: z.literal('connection'),\n  binding: jsonValueSchema,\n});\n\nconst describedScheduleSchema = z.object({\n  type: z.literal('schedule'),\n  cron: z.string().nullable(),\n  markdown: z.string().nullable(),\n  timezone: z.string().nullable(),\n  target: z.string().nullable(),\n});\n\nconst describedHookSchema = z.object({ type: z.literal('hook'), keys: z.array(z.string()) });\n\nconst describedChannelSchema = z.object({\n  type: z.literal('channel'),\n  routes: z.array(z.object({ method: z.string(), path: z.string() })),\n  turnPolicy: z.string().nullable(),\n  config: jsonValueSchema,\n  disabled: z.boolean().default(false),\n  installed: jsonValueSchema.nullable().default(null),\n});\n\nexport const describedEnvironmentSchema = z.object({\n  providerName: z.string(),\n  providerRef: jsonValueSchema.nullable(),\n  options: jsonValueSchema,\n  openOptions: jsonValueSchema.nullable(),\n});\n\nconst describedSandboxTargetSchema = z.object({\n  exportName: z.string(),\n  environment: describedEnvironmentSchema.nullable(),\n  dynamic: describedDynamicSchema.nullable(),\n});\n\nconst describedSandboxSchema = z.object({\n  type: z.literal('sandbox'),\n  targets: z.record(z.string(), describedSandboxTargetSchema),\n  // Bundle export name \u2192 provider name, for providers defined in sandbox.ts.\n  providers: z.record(z.string(), z.string()),\n  selector: z.boolean(),\n  defaultTarget: z.string().nullable(),\n});\n\nexport const describedValueSchema = z.discriminatedUnion('type', [\n  describedAgentSchema,\n  describedDynamicSchema,\n  describedInstructionsSchema,\n  describedSkillSchema,\n  describedToolSchema,\n  describedConnectionSchema,\n  describedScheduleSchema,\n  describedHookSchema,\n  describedChannelSchema,\n  describedSandboxSchema,\n]);\n\nexport const describedModuleSchema = z.object({\n  base: z.string(),\n  path: z.string(),\n  slot: z.nativeEnum(SlotKind),\n  key: z.string(),\n  hasDefault: z.boolean(),\n  issues: z.array(issueSchema),\n  value: describedValueSchema.nullable(),\n});\n\nexport const describedBundleSchema = z.object({\n  modules: z.array(describedModuleSchema),\n  // Exports the bundle synthesizes beyond the authored ones.\n  synthesized: z.array(z.string()),\n});\n\nexport type DescribedIssueIface = z.infer<typeof issueSchema>;\nexport type DescribedDynamicIface = z.infer<typeof describedDynamicSchema>;\nexport type DescribedAgentIface = z.infer<typeof describedAgentSchema>;\nexport type DescribedSandboxIface = z.infer<typeof describedSandboxSchema>;\nexport type DescribedSandboxTargetIface = z.infer<typeof describedSandboxTargetSchema>;\nexport type DescribedEnvironmentIface = z.infer<typeof describedEnvironmentSchema>;\nexport type DescribedValue = z.infer<typeof describedValueSchema>;\nexport type DescribedModuleIface = z.infer<typeof describedModuleSchema>;\nexport type DescribedBundleIface = z.infer<typeof describedBundleSchema>;\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/runtime/lower.mjs

@@ -1,8 +1,12 @@
 import {
   InputApprovalKind,
   InstructionRole,
+  isToolDenied,
   McpServerBindingKind,
-  ToolApproval
+  ToolApproval,
+  TOOL_PATTERN_WILDCARD,
+  toolAnnotationSelectorSchema,
+  toolPatternMatches
 } from "@finalai/agent-provider";
 import * as z from "zod";
 import { lowerApproval } from "../authoring/approval.mjs";
@@ -223,9 +227,10 @@ const authoredConnectionSchema = z.looseObject({
   approval: optionalValueSchema,
   toolCall: optionalValueSchema,
   tools: z.looseObject({
-    allow: z.array(z.string()).optional(),
-    deny: z.array(z.string()).optional(),
-    approval: authoredRecordSchema.optional()
+    allow: z.array(z.unknown()).optional(),
+    deny: z.array(z.unknown()).optional(),
+    approval: authoredRecordSchema.optional(),
+    load: z.array(z.string()).optional()
   }).optional()
 });
 const connectionAuthSchema = z.union([
@@ -250,6 +255,25 @@ const lowerAuth = (value, path, issues) => {
   );
   return null;
 };
+const splitToolEntries = (args) => {
+  const names = [];
+  const selectors = [];
+  for (const entry of args.entries) {
+    if (isString(entry)) {
+      names.push(entry);
+      continue;
+    }
+    const parsed = toolAnnotationSelectorSchema.safeParse(entry);
+    if (parsed.success) selectors.push(parsed.data);
+    else
+      args.issues.push(
+        error(
+          `${args.label} entries must be tool names, * patterns, or annotation selectors such as { readOnlyHint: true }`
+        )
+      );
+  }
+  return { names, selectors };
+};
 const lowerConnection = (args) => {
   const issues = [];
   const path = `connection ${args.key}`;
@@ -288,12 +312,29 @@ const lowerConnection = (args) => {
   const overrides = Object.fromEntries(overrideEntries);
   const inputApprovals = Object.fromEntries(inputApprovalEntries);
   for (const key of staticOverrideKeys) delete inputApprovals[key];
-  const defaultPolicy = overrides["*"] ?? defaultApproval.policy;
-  const allow = tools?.allow ?? null;
+  const defaultPolicy = overrides[TOOL_PATTERN_WILDCARD] ?? defaultApproval.policy;
+  const allowEntries = tools?.allow == null ? null : splitToolEntries({ entries: tools.allow, label: `${path} tools.allow`, issues });
+  const allow = allowEntries?.names ?? null;
+  const allowSelectors = allowEntries?.selectors ?? [];
+  const denyEntries = splitToolEntries({
+    entries: tools?.deny ?? [],
+    label: `${path} tools.deny`,
+    issues
+  });
+  const deny = denyEntries.names;
+  const authoredEntries = {
+    allow: allow ?? [],
+    deny,
+    approval: Object.keys(overrides)
+  };
+  for (const [field, entries] of Object.entries(authoredEntries)) {
+    if (entries.some((entry) => entry.trim().length === 0))
+      issues.push(error(`${path} tools.${field} entries must be tool names or * patterns`));
+  }
+  const inherited = Object.hasOwn(inputApprovals, "*") ? inputApprovals["*"] : void 0;
   let approvals = null;
   if (allow != null) {
     approvals = Object.fromEntries(allow.map((tool) => [tool, overrides[tool] ?? defaultPolicy]));
-    const inherited = Object.hasOwn(inputApprovals, "*") ? inputApprovals["*"] : void 0;
     if (inherited != null) {
       for (const tool of allow) {
         if (!Object.hasOwn(overrides, tool))
@@ -306,20 +347,33 @@ const lowerConnection = (args) => {
       }
     }
     for (const tool of Object.keys(overrides)) {
-      if (!allow.includes(tool)) {
-        issues.push(
-          warning(`${path} sets an approval for ${tool}, which tools.allow does not expose`)
-        );
+      if (tool === TOOL_PATTERN_WILDCARD || allow.includes(tool)) continue;
+      if (allow.some((pattern) => toolPatternMatches(pattern, tool))) {
+        approvals[tool] = overrides[tool] ?? defaultPolicy;
+        continue;
       }
+      issues.push(
+        warning(
+          allowSelectors.length > 0 ? `${path} sets an approval for ${tool}, which tools.allow does not name; approvals apply only to named tools` : `${path} sets an approval for ${tool}, which tools.allow does not expose`
+        )
+      );
     }
   } else if (defaultApproval.policy === ToolApproval.Ask || Object.keys(overrides).length > 0) {
     approvals = { "*": defaultApproval.policy, ...overrides };
   }
-  const deny = tools?.deny ?? [];
-  for (const tool of deny) {
-    if (Object.hasOwn(overrides, tool))
+  for (const tool of Object.keys(overrides)) {
+    if (tool !== TOOL_PATTERN_WILDCARD && isToolDenied(deny, tool))
       issues.push(warning(`${path} sets an approval for ${tool}, which tools.deny hides`));
   }
+  const load = tools?.load ?? null;
+  if (load?.some((tool) => tool.trim().length === 0) === true)
+    issues.push(error(`${path} tools.load entries must be tool names or * patterns`));
+  for (const tool of load ?? []) {
+    if (isToolDenied(deny, tool))
+      issues.push(warning(`${path} loads ${tool}, which tools.deny hides`));
+    else if (allow != null && allowSelectors.length === 0 && !allow.some((pattern) => toolPatternMatches(pattern, tool)))
+      issues.push(warning(`${path} loads ${tool}, which tools.allow does not expose`));
+  }
   if (connection?.toolCall != null)
     issues.push(error(`${path} uses toolCall.providedArguments, which is not supported`));
   const binding = {
@@ -331,6 +385,14 @@ const lowerConnection = (args) => {
     approvals
   };
   if (deny.length > 0) binding.deny = [...new Set(deny)];
+  if (load != null) binding.load = [...new Set(load)];
+  if (allowSelectors.length > 0)
+    binding.allowAnnotations = allowSelectors.map((match) => ({
+      match,
+      approval: defaultPolicy,
+      ...inherited == null ? {} : { inputApproval: inherited }
+    }));
+  if (denyEntries.selectors.length > 0) binding.denyAnnotations = denyEntries.selectors;
   if (Object.keys(inputApprovals).length > 0) binding.inputApprovals = inputApprovals;
   return { binding, issues };
 };

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/runtime/lower.ts"],
-  "sourcesContent": ["import {\n  InputApprovalKind,\n  InstructionRole,\n  McpServerBindingKind,\n  ToolApproval,\n  type HttpMcpServerBindingIface,\n  type InputApprovalIface,\n  type InstructionFragmentIface,\n  type JsonObject,\n  type JsonValue,\n  type SkillBundleIface,\n  type ToolDescriptorIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { lowerApproval } from \"../authoring/approval.mjs\";\nimport {\n  AuthoredKind,\n  authoredKindOf,\n  pendingExportName,\n  pendingIndexOf,\n} from \"../authoring/brand.mjs\";\nimport { toolLabelSchema } from \"../authoring/tools.mjs\";\nimport { jsonSchemaDeclarationError, SchemaIo } from \"./schema-validation.mjs\";\nimport {\n  authoredRecordSchema,\n  authoredValueSchema,\n  callableSchema,\n  entriesOf,\n  fieldOf,\n  isBoolean,\n  isCallable,\n  isNumber,\n  isObjectLike,\n  isPlainObject,\n  isString,\n  messageOf,\n  optionalValueSchema,\n  type AuthoredValue,\n} from \"./values.mjs\";\n\n// Lowering of authored values to manifest JSON. Runs inside the realm that\n// evaluated the authored modules (the compiler's vm context, or the agent's\n// Worker isolate for dynamic resolver outputs), so it never crosses realms\n// with live values.\n\nexport enum IssueSeverity {\n  Error = 'error',\n  Warning = 'warning',\n  Note = 'note',\n}\n\nexport interface IssueIface {\n  severity: IssueSeverity;\n  message: string;\n}\n\nexport const error = (message: string): IssueIface => ({ severity: IssueSeverity.Error, message });\nexport const warning = (message: string): IssueIface => ({\n  severity: IssueSeverity.Warning,\n  message,\n});\nexport const note = (message: string): IssueIface => ({ severity: IssueSeverity.Note, message });\n\nexport const childPath = (parent: string, key: string | number): string => {\n  if (isNumber(key)) return `${parent}[${key}]`;\n  return parent.length === 0 ? key : `${parent}.${key}`;\n};\n\nexport interface ToJsonOptionsIface {\n  path: string;\n  issues: IssueIface[];\n  // Replaces an authored value (a dynamic sentinel) with its manifest form;\n  // return undefined to fall back to the default conversion.\n  visit?: (value: AuthoredValue, path: string) => JsonValue | undefined;\n}\n\nconst PENDING_PLACEHOLDER = /^<pending:\\d+>$/;\n\nconst label = (path: string): string => (path.length === 0 ? 'value' : path);\n\n// Plain JSON conversion with diagnostics for values JSON cannot hold.\nexport const toJson = (value: AuthoredValue, options: ToJsonOptionsIface): JsonValue => {\n  const visited = options.visit?.(value, options.path);\n  if (visited !== undefined) return visited;\n  if (value == null) return null;\n  if (isString(value)) {\n    const index = PENDING_PLACEHOLDER.test(value) ? pendingIndexOf(value) : null;\n    return index == null ? value : pendingExportName(index);\n  }\n  if (isNumber(value)) {\n    if (Number.isFinite(value)) return value;\n    options.issues.push(error(`${label(options.path)} is not a finite number`));\n    return null;\n  }\n  if (isBoolean(value)) return value;\n  if (Array.isArray(value)) {\n    return value.map((item, index) =>\n      toJson(item, { ...options, path: childPath(options.path, index) }),\n    );\n  }\n  if (isCallable(value)) {\n    options.issues.push(\n      error(`${label(options.path)} is a function; only static values can appear here`),\n    );\n    return null;\n  }\n  if (isPlainObject(value) || authoredKindOf(value) != null) {\n    const out: JsonObject = {};\n    for (const [key, item] of entriesOf(value)) {\n      if (item === undefined) continue;\n      out[key] = toJson(item, { ...options, path: childPath(options.path, key) });\n    }\n    return out;\n  }\n  options.issues.push(\n    error(`${label(options.path)} is not JSON (${Object.prototype.toString.call(value)})`),\n  );\n  return null;\n};\n\nconst jsonSchemaObjectSchema = z.record(z.string(), authoredValueSchema);\n\nconst standardJsonSchemaSchema = z.looseObject({\n  '~standard': z.looseObject({\n    jsonSchema: z\n      .looseObject({ input: callableSchema, output: callableSchema.optional() })\n      .optional(),\n  }),\n});\n\nconst isZodSchema = (value: AuthoredValue): value is z.ZodType => value instanceof z.ZodType;\n\n// Tool input/output schemas: Standard JSON Schema (zod 4 and others), a zod\n// schema, or a JSON Schema document.\nexport const toJsonSchema = (args: {\n  schema: AuthoredValue;\n  path: string;\n  issues: IssueIface[];\n  io?: SchemaIo;\n}): JsonObject | null => {\n  const { schema, path, issues } = args;\n  const io = args.io ?? SchemaIo.Input;\n  const standard = standardJsonSchemaSchema.safeParse(schema);\n  const jsonSchema = fieldOf(fieldOf(schema, '~standard'), 'jsonSchema');\n  let converted: AuthoredValue = null;\n  if (standard.success && standard.data['~standard'].jsonSchema != null) {\n    try {\n      const convert = standard.data['~standard'].jsonSchema[io];\n      if (convert == null) throw new Error(`Standard JSON Schema has no ${io} converter`);\n      converted = convert.call(jsonSchema, {\n        target: 'draft-2020-12',\n      });\n    } catch (cause) {\n      issues.push(error(`${path} could not be converted to JSON Schema: ${messageOf(cause)}`));\n      return null;\n    }\n  } else if (isZodSchema(schema)) {\n    converted = z.toJSONSchema(schema, { io });\n  } else if (standard.success) {\n    issues.push(\n      error(\n        `${path} is a Standard Schema without JSON Schema support; use zod 4 or a JSON Schema object`,\n      ),\n    );\n    return null;\n  } else if (isPlainObject(schema)) {\n    converted = schema;\n  } else {\n    issues.push(error(`${path} must be a zod schema or a JSON Schema object`));\n    return null;\n  }\n  const json = toJson(converted, { path, issues });\n  if (\n    json == null ||\n    Array.isArray(json) ||\n    !jsonSchemaObjectSchema.safeParse(json).success ||\n    !isPlainObject(json)\n  ) {\n    issues.push(error(`${path} did not produce a JSON Schema object`));\n    return null;\n  }\n  const out: JsonObject = {};\n  for (const [key, item] of Object.entries(json)) {\n    if (key !== '$schema' || (!standard.success && !isZodSchema(schema))) out[key] = item;\n  }\n  const declarationError = jsonSchemaDeclarationError(out);\n  if (declarationError != null) {\n    issues.push(error(`${path} is an invalid JSON Schema: ${declarationError}`));\n    return null;\n  }\n  return out;\n};\n\nconst authoredToolSchema = z.looseObject({\n  description: optionalValueSchema,\n  execute: optionalValueSchema,\n  inputSchema: optionalValueSchema,\n  outputSchema: optionalValueSchema,\n  endsTurn: optionalValueSchema,\n  approval: optionalValueSchema,\n  label: optionalValueSchema,\n  annotations: z\n    .looseObject({\n      title: z.string().optional(),\n      readOnlyHint: z.boolean().optional(),\n      destructiveHint: z.boolean().optional(),\n      idempotentHint: z.boolean().optional(),\n      openWorldHint: z.boolean().optional(),\n    })\n    .optional()\n    .catch(undefined),\n});\n\nexport interface LoweredToolIface {\n  descriptor: ToolDescriptorIface;\n  approval: ToolApproval;\n  issues: IssueIface[];\n}\n\nexport const lowerTool = (args: {\n  name: string;\n  exportName: string;\n  value: AuthoredValue;\n}): LoweredToolIface => {\n  const issues: IssueIface[] = [];\n  const path = `tool ${args.name}`;\n  const parsed = authoredToolSchema.safeParse(args.value);\n  if (!parsed.success) {\n    issues.push(error(`${path} must be defineTool({ description, inputSchema, execute })`));\n    return {\n      descriptor: {\n        name: args.name,\n        description: '',\n        inputSchema: { type: 'object' },\n        export: args.exportName,\n      },\n      approval: ToolApproval.Ask,\n      issues,\n    };\n  }\n  const tool = parsed.data;\n  const description = isString(tool.description) ? tool.description : '';\n  if (description.length === 0) issues.push(error(`${path} needs a description`));\n  if (!isCallable(tool.execute)) issues.push(error(`${path} needs an execute function`));\n  const inputSchema = toJsonSchema({\n    schema: tool.inputSchema,\n    path: `${path} inputSchema`,\n    issues,\n  }) ?? {\n    type: 'object',\n  };\n  if (tool.endsTurn != null && tool.endsTurn !== false) {\n    issues.push(\n      error(`${path} sets endsTurn; it is not supported because the harness owns the loop`),\n    );\n  }\n  const approval = lowerApproval(tool.approval);\n  if (approval.error != null) issues.push(error(`${path}: ${approval.error}`));\n  if (approval.note != null) issues.push(note(`${path}: ${approval.note}`));\n  const descriptor: ToolDescriptorIface = {\n    name: args.name,\n    description,\n    inputSchema,\n    export: args.exportName,\n  };\n  if (approval.inputDependent)\n    descriptor.inputApproval = { kind: InputApprovalKind.Tool, export: args.exportName };\n  if (tool.outputSchema != null) {\n    const outputSchema = toJsonSchema({\n      schema: tool.outputSchema,\n      path: `${path} outputSchema`,\n      issues,\n      io: SchemaIo.Output,\n    });\n    if (outputSchema != null) descriptor.outputSchema = outputSchema;\n  }\n  const annotations: NonNullable<ToolDescriptorIface['annotations']> = { ...tool.annotations };\n  if (tool.label != null && !toolLabelSchema.safeParse(tool.label).success)\n    issues.push(error(`${path} label must be text or { start, delta?, complete? } callbacks`));\n  if (isString(tool.label)) annotations.title = tool.label;\n  if (Object.keys(annotations).length > 0) descriptor.annotations = annotations;\n  return { descriptor, approval: approval.policy, issues };\n};\n\nconst authoredConnectionSchema = z.looseObject({\n  url: optionalValueSchema,\n  auth: optionalValueSchema,\n  headers: optionalValueSchema,\n  approval: optionalValueSchema,\n  toolCall: optionalValueSchema,\n  tools: z\n    .looseObject({\n      allow: z.array(z.string()).optional(),\n      deny: z.array(z.string()).optional(),\n      approval: authoredRecordSchema.optional(),\n    })\n    .optional(),\n});\n\nconst connectionAuthSchema = z.union([\n  z\n    .object({ kind: z.literal('final-session') })\n    .transform(() => ({ kind: 'final-session' as const })),\n  z\n    .looseObject({ secretKey: z.string().min(1), headerName: z.string().nullish() })\n    .transform((auth) => ({ secretKey: auth.secretKey, headerName: auth.headerName ?? null })),\n]);\n\nexport interface LoweredConnectionIface {\n  binding: HttpMcpServerBindingIface;\n  issues: IssueIface[];\n}\n\nconst stringRecord = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): Record<string, string> => {\n  if (value == null) return {};\n  const parsed = z.record(z.string(), z.string()).safeParse(value);\n  if (parsed.success) return parsed.data;\n  issues.push(error(`${path} must be a record of strings (header callbacks are not supported)`));\n  return {};\n};\n\nconst lowerAuth = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): HttpMcpServerBindingIface['auth'] => {\n  if (value == null) return null;\n  const parsed = connectionAuthSchema.safeParse(value);\n  if (parsed.success) return parsed.data;\n  issues.push(\n    error(\n      `${path} must be { secretKey, headerName } or { kind: 'final-session' }; auth providers and callbacks are not supported`,\n    ),\n  );\n  return null;\n};\n\nexport const lowerConnection = (args: {\n  key: string;\n  exportName: string;\n  value: AuthoredValue;\n}): LoweredConnectionIface => {\n  const issues: IssueIface[] = [];\n  const path = `connection ${args.key}`;\n  const parsed = authoredConnectionSchema.safeParse(args.value);\n  const connection = parsed.success ? parsed.data : null;\n  if (connection == null)\n    issues.push(error(`${path} must be defineMcpClientConnection({ url, ... })`));\n  const url = isString(connection?.url) ? connection.url : null;\n  if (url == null || !z.url().safeParse(url).success)\n    issues.push(error(`${path} needs a valid url`));\n  const tools = connection?.tools;\n  const defaultApproval = lowerApproval(connection?.approval);\n  if (defaultApproval.error != null) issues.push(error(`${path}: ${defaultApproval.error}`));\n  if (defaultApproval.note != null) issues.push(note(`${path}: ${defaultApproval.note}`));\n  const overrideEntries: [string, ToolApproval][] = [];\n  const inputApprovalEntries: [string, InputApprovalIface][] = [];\n  const staticOverrideKeys: string[] = [];\n  if (defaultApproval.inputDependent)\n    inputApprovalEntries.push([\n      '*',\n      { kind: InputApprovalKind.Connection, export: args.exportName },\n    ]);\n  for (const [tool, approval] of Object.entries(tools?.approval ?? {})) {\n    const lowered = lowerApproval(approval);\n    if (lowered.error != null)\n      issues.push(error(`${path} tools.approval.${tool}: ${lowered.error}`));\n    if (lowered.note != null) issues.push(note(`${path} tools.approval.${tool}: ${lowered.note}`));\n    overrideEntries.push([tool, lowered.policy]);\n    if (lowered.inputDependent)\n      inputApprovalEntries.push([\n        tool,\n        { kind: InputApprovalKind.Connection, export: args.exportName, policyKey: tool },\n      ]);\n    else staticOverrideKeys.push(tool);\n  }\n  const overrides = Object.fromEntries(overrideEntries);\n  const inputApprovals = Object.fromEntries(inputApprovalEntries);\n  for (const key of staticOverrideKeys) delete inputApprovals[key];\n  const defaultPolicy = overrides['*'] ?? defaultApproval.policy;\n  const allow = tools?.allow ?? null;\n  let approvals: Record<string, ToolApproval> | null = null;\n  if (allow != null) {\n    approvals = Object.fromEntries(allow.map((tool) => [tool, overrides[tool] ?? defaultPolicy]));\n    const inherited = Object.hasOwn(inputApprovals, '*') ? inputApprovals['*'] : undefined;\n    if (inherited != null) {\n      for (const tool of allow) {\n        if (!Object.hasOwn(overrides, tool))\n          Object.defineProperty(inputApprovals, tool, {\n            value: inherited,\n            enumerable: true,\n            configurable: true,\n            writable: true,\n          });\n      }\n    }\n    for (const tool of Object.keys(overrides)) {\n      if (!allow.includes(tool)) {\n        issues.push(\n          warning(`${path} sets an approval for ${tool}, which tools.allow does not expose`),\n        );\n      }\n    }\n  } else if (defaultApproval.policy === ToolApproval.Ask || Object.keys(overrides).length > 0) {\n    // '*' applies to every listed tool without its own entry.\n    approvals = { '*': defaultApproval.policy, ...overrides };\n  }\n  const deny = tools?.deny ?? [];\n  for (const tool of deny) {\n    if (Object.hasOwn(overrides, tool))\n      issues.push(warning(`${path} sets an approval for ${tool}, which tools.deny hides`));\n  }\n  if (connection?.toolCall != null)\n    issues.push(error(`${path} uses toolCall.providedArguments, which is not supported`));\n  const binding: HttpMcpServerBindingIface = {\n    key: args.key,\n    kind: McpServerBindingKind.Http,\n    url: url ?? 'https://invalid.invalid',\n    auth: lowerAuth(connection?.auth, `${path} auth`, issues),\n    headers: stringRecord(connection?.headers, `${path} headers`, issues),\n    approvals,\n  };\n  if (deny.length > 0) binding.deny = [...new Set(deny)];\n  if (Object.keys(inputApprovals).length > 0) binding.inputApprovals = inputApprovals;\n  return { binding, issues };\n};\n\nexport const skillMarkdown = (args: {\n  key: string;\n  description: string;\n  markdown: string;\n}): string =>\n  args.markdown.startsWith('---\\n')\n    ? args.markdown\n    : `---\\nname: ${JSON.stringify(args.key)}\\ndescription: ${JSON.stringify(args.description)}\\n---\\n\\n${args.markdown}`;\n\nconst authoredSkillSchema = z.looseObject({\n  description: optionalValueSchema,\n  markdown: optionalValueSchema,\n  files: authoredRecordSchema.optional().catch(undefined),\n});\n\nexport interface LoweredSkillIface {\n  skill: SkillBundleIface;\n  issues: IssueIface[];\n}\n\nexport const lowerSkill = (args: { key: string; value: AuthoredValue }): LoweredSkillIface => {\n  const issues: IssueIface[] = [];\n  const parsed = authoredSkillSchema.safeParse(args.value);\n  const description =\n    parsed.success && isString(parsed.data.description) ? parsed.data.description : null;\n  const markdown = parsed.success && isString(parsed.data.markdown) ? parsed.data.markdown : null;\n  if (description == null || description.length === 0)\n    issues.push(error(`skill ${args.key} needs a description`));\n  if (markdown == null) issues.push(error(`skill ${args.key} needs markdown`));\n  const files: SkillBundleIface['files'] = [\n    {\n      path: 'SKILL.md',\n      content: skillMarkdown({\n        key: args.key,\n        description: description ?? '',\n        markdown: markdown ?? '',\n      }),\n    },\n  ];\n  for (const [path, content] of Object.entries(\n    (parsed.success ? parsed.data.files : undefined) ?? {},\n  )) {\n    if (path.startsWith('/') || path.split(/[\\\\/]/).includes('..')) {\n      issues.push(error(`skill ${args.key} file ${path} must stay inside the skill directory`));\n    } else if (!isString(content)) {\n      issues.push(warning(`skill ${args.key} file ${path} is binary and was left out`));\n    } else if (path !== 'SKILL.md') files.push({ path, content });\n  }\n  const skill: SkillBundleIface = { key: args.key, files };\n  if (description != null) skill.description = description;\n  return { skill, issues };\n};\n\nconst authoredInstructionsSchema = z.looseObject({\n  content: z.string(),\n  role: z.string().optional(),\n});\n\nexport const lowerInstructions = (\n  value: AuthoredValue,\n  source: string | null,\n): InstructionFragmentIface | null => {\n  const parsed = authoredInstructionsSchema.safeParse(value);\n  if (!parsed.success) return null;\n  const fragment: InstructionFragmentIface = {\n    role: parsed.data.role === InstructionRole.User ? InstructionRole.User : InstructionRole.System,\n    content: parsed.data.content,\n  };\n  if (source != null) fragment.source = source;\n  return fragment;\n};\n\nexport interface LoweredEnvironmentIface {\n  providerName: string;\n  providerRef: JsonValue | null;\n  options: JsonValue;\n  openOptions: JsonValue | null;\n}\n\nconst environmentSchema = z.looseObject({\n  providerName: z.string(),\n  providerRef: optionalValueSchema,\n  options: optionalValueSchema,\n  open: callableSchema,\n});\n\nconst openRequestSchema = z.looseObject({\n  providerName: z.string(),\n  providerRef: optionalValueSchema,\n  environmentOptions: optionalValueSchema,\n  openOptions: optionalValueSchema,\n});\n\nconst sandboxProviderSchema = z.looseObject({\n  name: z.string(),\n  environment: callableSchema,\n  definition: z.looseObject({}),\n});\n\nexport const isEnvironmentLike = (value: AuthoredValue): boolean =>\n  environmentSchema.safeParse(value).success;\n\nexport const isOpenRequestLike = (value: AuthoredValue): boolean =>\n  openRequestSchema.safeParse(value).success &&\n  isObjectLike(value) &&\n  'environmentOptions' in value;\n\nexport const sandboxProviderNameOf = (value: AuthoredValue): string | null => {\n  const parsed = sandboxProviderSchema.safeParse(value);\n  return parsed.success ? parsed.data.name : null;\n};\n\nexport const lowerEnvironment = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): LoweredEnvironmentIface | null => {\n  const warnings = z.array(z.string()).safeParse(fieldOf(value, 'authoringWarnings'));\n  if (warnings.success)\n    for (const message of warnings.data) issues.push(warning(`${path}: ${message}`));\n  const request = isOpenRequestLike(value) ? openRequestSchema.safeParse(value) : null;\n  if (request?.success === true) {\n    return {\n      providerName: request.data.providerName,\n      providerRef:\n        request.data.providerRef == null\n          ? null\n          : toJson(request.data.providerRef, { path, issues }),\n      options: toJson(request.data.environmentOptions ?? {}, { path: `${path} options`, issues }),\n      openOptions: toJson(request.data.openOptions ?? null, {\n        path: `${path} open options`,\n        issues,\n      }),\n    };\n  }\n  const environment = environmentSchema.safeParse(value);\n  if (!environment.success) return null;\n  return {\n    providerName: environment.data.providerName,\n    providerRef:\n      environment.data.providerRef == null\n        ? null\n        : toJson(environment.data.providerRef, { path, issues }),\n    options: toJson(environment.data.options ?? {}, { path: `${path} options`, issues }),\n    openOptions: null,\n  };\n};\n\nexport const isDynamicSentinel = (value: AuthoredValue): boolean =>\n  authoredKindOf(value) === AuthoredKind.Dynamic;\n\nexport const dynamicEventsOf = (value: AuthoredValue): string[] =>\n  entriesOf(fieldOf(value, 'events'))\n    .filter(([, handler]) => isCallable(handler))\n    .map(([event]) => event);\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  InputApprovalKind,\n  InstructionRole,\n  isToolDenied,\n  McpServerBindingKind,\n  ToolApproval,\n  TOOL_PATTERN_WILDCARD,\n  toolAnnotationSelectorSchema,\n  toolPatternMatches,\n  type HttpMcpServerBindingIface,\n  type InputApprovalIface,\n  type InstructionFragmentIface,\n  type JsonObject,\n  type JsonValue,\n  type SkillBundleIface,\n  type ToolAnnotationSelectorIface,\n  type ToolDescriptorIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { lowerApproval } from \"../authoring/approval.mjs\";\nimport {\n  AuthoredKind,\n  authoredKindOf,\n  pendingExportName,\n  pendingIndexOf,\n} from \"../authoring/brand.mjs\";\nimport { toolLabelSchema } from \"../authoring/tools.mjs\";\nimport { jsonSchemaDeclarationError, SchemaIo } from \"./schema-validation.mjs\";\nimport {\n  authoredRecordSchema,\n  authoredValueSchema,\n  callableSchema,\n  entriesOf,\n  fieldOf,\n  isBoolean,\n  isCallable,\n  isNumber,\n  isObjectLike,\n  isPlainObject,\n  isString,\n  messageOf,\n  optionalValueSchema,\n  type AuthoredValue,\n} from \"./values.mjs\";\n\n// Lowering of authored values to manifest JSON. Runs inside the realm that\n// evaluated the authored modules (the compiler's vm context, or the agent's\n// Worker isolate for dynamic resolver outputs), so it never crosses realms\n// with live values.\n\nexport enum IssueSeverity {\n  Error = 'error',\n  Warning = 'warning',\n  Note = 'note',\n}\n\nexport interface IssueIface {\n  severity: IssueSeverity;\n  message: string;\n}\n\nexport const error = (message: string): IssueIface => ({ severity: IssueSeverity.Error, message });\nexport const warning = (message: string): IssueIface => ({\n  severity: IssueSeverity.Warning,\n  message,\n});\nexport const note = (message: string): IssueIface => ({ severity: IssueSeverity.Note, message });\n\nexport const childPath = (parent: string, key: string | number): string => {\n  if (isNumber(key)) return `${parent}[${key}]`;\n  return parent.length === 0 ? key : `${parent}.${key}`;\n};\n\nexport interface ToJsonOptionsIface {\n  path: string;\n  issues: IssueIface[];\n  // Replaces an authored value (a dynamic sentinel) with its manifest form;\n  // return undefined to fall back to the default conversion.\n  visit?: (value: AuthoredValue, path: string) => JsonValue | undefined;\n}\n\nconst PENDING_PLACEHOLDER = /^<pending:\\d+>$/;\n\nconst label = (path: string): string => (path.length === 0 ? 'value' : path);\n\n// Plain JSON conversion with diagnostics for values JSON cannot hold.\nexport const toJson = (value: AuthoredValue, options: ToJsonOptionsIface): JsonValue => {\n  const visited = options.visit?.(value, options.path);\n  if (visited !== undefined) return visited;\n  if (value == null) return null;\n  if (isString(value)) {\n    const index = PENDING_PLACEHOLDER.test(value) ? pendingIndexOf(value) : null;\n    return index == null ? value : pendingExportName(index);\n  }\n  if (isNumber(value)) {\n    if (Number.isFinite(value)) return value;\n    options.issues.push(error(`${label(options.path)} is not a finite number`));\n    return null;\n  }\n  if (isBoolean(value)) return value;\n  if (Array.isArray(value)) {\n    return value.map((item, index) =>\n      toJson(item, { ...options, path: childPath(options.path, index) }),\n    );\n  }\n  if (isCallable(value)) {\n    options.issues.push(\n      error(`${label(options.path)} is a function; only static values can appear here`),\n    );\n    return null;\n  }\n  if (isPlainObject(value) || authoredKindOf(value) != null) {\n    const out: JsonObject = {};\n    for (const [key, item] of entriesOf(value)) {\n      if (item === undefined) continue;\n      out[key] = toJson(item, { ...options, path: childPath(options.path, key) });\n    }\n    return out;\n  }\n  options.issues.push(\n    error(`${label(options.path)} is not JSON (${Object.prototype.toString.call(value)})`),\n  );\n  return null;\n};\n\nconst jsonSchemaObjectSchema = z.record(z.string(), authoredValueSchema);\n\nconst standardJsonSchemaSchema = z.looseObject({\n  '~standard': z.looseObject({\n    jsonSchema: z\n      .looseObject({ input: callableSchema, output: callableSchema.optional() })\n      .optional(),\n  }),\n});\n\nconst isZodSchema = (value: AuthoredValue): value is z.ZodType => value instanceof z.ZodType;\n\n// Tool input/output schemas: Standard JSON Schema (zod 4 and others), a zod\n// schema, or a JSON Schema document.\nexport const toJsonSchema = (args: {\n  schema: AuthoredValue;\n  path: string;\n  issues: IssueIface[];\n  io?: SchemaIo;\n}): JsonObject | null => {\n  const { schema, path, issues } = args;\n  const io = args.io ?? SchemaIo.Input;\n  const standard = standardJsonSchemaSchema.safeParse(schema);\n  const jsonSchema = fieldOf(fieldOf(schema, '~standard'), 'jsonSchema');\n  let converted: AuthoredValue = null;\n  if (standard.success && standard.data['~standard'].jsonSchema != null) {\n    try {\n      const convert = standard.data['~standard'].jsonSchema[io];\n      if (convert == null) throw new Error(`Standard JSON Schema has no ${io} converter`);\n      converted = convert.call(jsonSchema, {\n        target: 'draft-2020-12',\n      });\n    } catch (cause) {\n      issues.push(error(`${path} could not be converted to JSON Schema: ${messageOf(cause)}`));\n      return null;\n    }\n  } else if (isZodSchema(schema)) {\n    converted = z.toJSONSchema(schema, { io });\n  } else if (standard.success) {\n    issues.push(\n      error(\n        `${path} is a Standard Schema without JSON Schema support; use zod 4 or a JSON Schema object`,\n      ),\n    );\n    return null;\n  } else if (isPlainObject(schema)) {\n    converted = schema;\n  } else {\n    issues.push(error(`${path} must be a zod schema or a JSON Schema object`));\n    return null;\n  }\n  const json = toJson(converted, { path, issues });\n  if (\n    json == null ||\n    Array.isArray(json) ||\n    !jsonSchemaObjectSchema.safeParse(json).success ||\n    !isPlainObject(json)\n  ) {\n    issues.push(error(`${path} did not produce a JSON Schema object`));\n    return null;\n  }\n  const out: JsonObject = {};\n  for (const [key, item] of Object.entries(json)) {\n    if (key !== '$schema' || (!standard.success && !isZodSchema(schema))) out[key] = item;\n  }\n  const declarationError = jsonSchemaDeclarationError(out);\n  if (declarationError != null) {\n    issues.push(error(`${path} is an invalid JSON Schema: ${declarationError}`));\n    return null;\n  }\n  return out;\n};\n\nconst authoredToolSchema = z.looseObject({\n  description: optionalValueSchema,\n  execute: optionalValueSchema,\n  inputSchema: optionalValueSchema,\n  outputSchema: optionalValueSchema,\n  endsTurn: optionalValueSchema,\n  approval: optionalValueSchema,\n  label: optionalValueSchema,\n  annotations: z\n    .looseObject({\n      title: z.string().optional(),\n      readOnlyHint: z.boolean().optional(),\n      destructiveHint: z.boolean().optional(),\n      idempotentHint: z.boolean().optional(),\n      openWorldHint: z.boolean().optional(),\n    })\n    .optional()\n    .catch(undefined),\n});\n\nexport interface LoweredToolIface {\n  descriptor: ToolDescriptorIface;\n  approval: ToolApproval;\n  issues: IssueIface[];\n}\n\nexport const lowerTool = (args: {\n  name: string;\n  exportName: string;\n  value: AuthoredValue;\n}): LoweredToolIface => {\n  const issues: IssueIface[] = [];\n  const path = `tool ${args.name}`;\n  const parsed = authoredToolSchema.safeParse(args.value);\n  if (!parsed.success) {\n    issues.push(error(`${path} must be defineTool({ description, inputSchema, execute })`));\n    return {\n      descriptor: {\n        name: args.name,\n        description: '',\n        inputSchema: { type: 'object' },\n        export: args.exportName,\n      },\n      approval: ToolApproval.Ask,\n      issues,\n    };\n  }\n  const tool = parsed.data;\n  const description = isString(tool.description) ? tool.description : '';\n  if (description.length === 0) issues.push(error(`${path} needs a description`));\n  if (!isCallable(tool.execute)) issues.push(error(`${path} needs an execute function`));\n  const inputSchema = toJsonSchema({\n    schema: tool.inputSchema,\n    path: `${path} inputSchema`,\n    issues,\n  }) ?? {\n    type: 'object',\n  };\n  if (tool.endsTurn != null && tool.endsTurn !== false) {\n    issues.push(\n      error(`${path} sets endsTurn; it is not supported because the harness owns the loop`),\n    );\n  }\n  const approval = lowerApproval(tool.approval);\n  if (approval.error != null) issues.push(error(`${path}: ${approval.error}`));\n  if (approval.note != null) issues.push(note(`${path}: ${approval.note}`));\n  const descriptor: ToolDescriptorIface = {\n    name: args.name,\n    description,\n    inputSchema,\n    export: args.exportName,\n  };\n  if (approval.inputDependent)\n    descriptor.inputApproval = { kind: InputApprovalKind.Tool, export: args.exportName };\n  if (tool.outputSchema != null) {\n    const outputSchema = toJsonSchema({\n      schema: tool.outputSchema,\n      path: `${path} outputSchema`,\n      issues,\n      io: SchemaIo.Output,\n    });\n    if (outputSchema != null) descriptor.outputSchema = outputSchema;\n  }\n  const annotations: NonNullable<ToolDescriptorIface['annotations']> = { ...tool.annotations };\n  if (tool.label != null && !toolLabelSchema.safeParse(tool.label).success)\n    issues.push(error(`${path} label must be text or { start, delta?, complete? } callbacks`));\n  if (isString(tool.label)) annotations.title = tool.label;\n  if (Object.keys(annotations).length > 0) descriptor.annotations = annotations;\n  return { descriptor, approval: approval.policy, issues };\n};\n\nconst authoredConnectionSchema = z.looseObject({\n  url: optionalValueSchema,\n  auth: optionalValueSchema,\n  headers: optionalValueSchema,\n  approval: optionalValueSchema,\n  toolCall: optionalValueSchema,\n  tools: z\n    .looseObject({\n      allow: z.array(z.unknown()).optional(),\n      deny: z.array(z.unknown()).optional(),\n      approval: authoredRecordSchema.optional(),\n      load: z.array(z.string()).optional(),\n    })\n    .optional(),\n});\n\nconst connectionAuthSchema = z.union([\n  z\n    .object({ kind: z.literal('final-session') })\n    .transform(() => ({ kind: 'final-session' as const })),\n  z\n    .looseObject({ secretKey: z.string().min(1), headerName: z.string().nullish() })\n    .transform((auth) => ({ secretKey: auth.secretKey, headerName: auth.headerName ?? null })),\n]);\n\nexport interface LoweredConnectionIface {\n  binding: HttpMcpServerBindingIface;\n  issues: IssueIface[];\n}\n\nconst stringRecord = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): Record<string, string> => {\n  if (value == null) return {};\n  const parsed = z.record(z.string(), z.string()).safeParse(value);\n  if (parsed.success) return parsed.data;\n  issues.push(error(`${path} must be a record of strings (header callbacks are not supported)`));\n  return {};\n};\n\nconst lowerAuth = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): HttpMcpServerBindingIface['auth'] => {\n  if (value == null) return null;\n  const parsed = connectionAuthSchema.safeParse(value);\n  if (parsed.success) return parsed.data;\n  issues.push(\n    error(\n      `${path} must be { secretKey, headerName } or { kind: 'final-session' }; auth providers and callbacks are not supported`,\n    ),\n  );\n  return null;\n};\n\ninterface ToolEntriesIface {\n  names: string[];\n  selectors: ToolAnnotationSelectorIface[];\n}\n\n// `tools.allow` and `tools.deny` entries: tool names, or MCP annotation selectors.\nconst splitToolEntries = (args: {\n  entries: readonly unknown[];\n  label: string;\n  issues: IssueIface[];\n}): ToolEntriesIface => {\n  const names: string[] = [];\n  const selectors: ToolAnnotationSelectorIface[] = [];\n  for (const entry of args.entries) {\n    if (isString(entry)) {\n      names.push(entry);\n      continue;\n    }\n    const parsed = toolAnnotationSelectorSchema.safeParse(entry);\n    if (parsed.success) selectors.push(parsed.data);\n    else\n      args.issues.push(\n        error(\n          `${args.label} entries must be tool names, * patterns, or annotation selectors such as { readOnlyHint: true }`,\n        ),\n      );\n  }\n  return { names, selectors };\n};\n\nexport const lowerConnection = (args: {\n  key: string;\n  exportName: string;\n  value: AuthoredValue;\n}): LoweredConnectionIface => {\n  const issues: IssueIface[] = [];\n  const path = `connection ${args.key}`;\n  const parsed = authoredConnectionSchema.safeParse(args.value);\n  const connection = parsed.success ? parsed.data : null;\n  if (connection == null)\n    issues.push(error(`${path} must be defineMcpClientConnection({ url, ... })`));\n  const url = isString(connection?.url) ? connection.url : null;\n  if (url == null || !z.url().safeParse(url).success)\n    issues.push(error(`${path} needs a valid url`));\n  const tools = connection?.tools;\n  const defaultApproval = lowerApproval(connection?.approval);\n  if (defaultApproval.error != null) issues.push(error(`${path}: ${defaultApproval.error}`));\n  if (defaultApproval.note != null) issues.push(note(`${path}: ${defaultApproval.note}`));\n  const overrideEntries: [string, ToolApproval][] = [];\n  const inputApprovalEntries: [string, InputApprovalIface][] = [];\n  const staticOverrideKeys: string[] = [];\n  if (defaultApproval.inputDependent)\n    inputApprovalEntries.push([\n      '*',\n      { kind: InputApprovalKind.Connection, export: args.exportName },\n    ]);\n  for (const [tool, approval] of Object.entries(tools?.approval ?? {})) {\n    const lowered = lowerApproval(approval);\n    if (lowered.error != null)\n      issues.push(error(`${path} tools.approval.${tool}: ${lowered.error}`));\n    if (lowered.note != null) issues.push(note(`${path} tools.approval.${tool}: ${lowered.note}`));\n    overrideEntries.push([tool, lowered.policy]);\n    if (lowered.inputDependent)\n      inputApprovalEntries.push([\n        tool,\n        { kind: InputApprovalKind.Connection, export: args.exportName, policyKey: tool },\n      ]);\n    else staticOverrideKeys.push(tool);\n  }\n  const overrides = Object.fromEntries(overrideEntries);\n  const inputApprovals = Object.fromEntries(inputApprovalEntries);\n  for (const key of staticOverrideKeys) delete inputApprovals[key];\n  const defaultPolicy = overrides[TOOL_PATTERN_WILDCARD] ?? defaultApproval.policy;\n  const allowEntries =\n    tools?.allow == null\n      ? null\n      : splitToolEntries({ entries: tools.allow, label: `${path} tools.allow`, issues });\n  const allow = allowEntries?.names ?? null;\n  const allowSelectors = allowEntries?.selectors ?? [];\n  const denyEntries = splitToolEntries({\n    entries: tools?.deny ?? [],\n    label: `${path} tools.deny`,\n    issues,\n  });\n  const deny = denyEntries.names;\n  const authoredEntries: Record<string, readonly string[]> = {\n    allow: allow ?? [],\n    deny,\n    approval: Object.keys(overrides),\n  };\n  for (const [field, entries] of Object.entries(authoredEntries)) {\n    if (entries.some((entry) => entry.trim().length === 0))\n      issues.push(error(`${path} tools.${field} entries must be tool names or * patterns`));\n  }\n  const inherited = Object.hasOwn(inputApprovals, '*') ? inputApprovals['*'] : undefined;\n  let approvals: Record<string, ToolApproval> | null = null;\n  if (allow != null) {\n    approvals = Object.fromEntries(allow.map((tool) => [tool, overrides[tool] ?? defaultPolicy]));\n    if (inherited != null) {\n      for (const tool of allow) {\n        if (!Object.hasOwn(overrides, tool))\n          Object.defineProperty(inputApprovals, tool, {\n            value: inherited,\n            enumerable: true,\n            configurable: true,\n            writable: true,\n          });\n      }\n    }\n    // A narrower approval inside an allow pattern (`github.delete_*` under\n    // `github.*`) keeps its own key; the most specific key governs a tool.\n    // `*` is the connection default here, already folded into each entry.\n    for (const tool of Object.keys(overrides)) {\n      if (tool === TOOL_PATTERN_WILDCARD || allow.includes(tool)) continue;\n      if (allow.some((pattern) => toolPatternMatches(pattern, tool))) {\n        approvals[tool] = overrides[tool] ?? defaultPolicy;\n        continue;\n      }\n      issues.push(\n        warning(\n          allowSelectors.length > 0\n            ? `${path} sets an approval for ${tool}, which tools.allow does not name; approvals apply only to named tools`\n            : `${path} sets an approval for ${tool}, which tools.allow does not expose`,\n        ),\n      );\n    }\n  } else if (defaultApproval.policy === ToolApproval.Ask || Object.keys(overrides).length > 0) {\n    // '*' applies to every listed tool without its own entry.\n    approvals = { '*': defaultApproval.policy, ...overrides };\n  }\n  for (const tool of Object.keys(overrides)) {\n    if (tool !== TOOL_PATTERN_WILDCARD && isToolDenied(deny, tool))\n      issues.push(warning(`${path} sets an approval for ${tool}, which tools.deny hides`));\n  }\n  const load = tools?.load ?? null;\n  if (load?.some((tool) => tool.trim().length === 0) === true)\n    issues.push(error(`${path} tools.load entries must be tool names or * patterns`));\n  for (const tool of load ?? []) {\n    if (isToolDenied(deny, tool))\n      issues.push(warning(`${path} loads ${tool}, which tools.deny hides`));\n    // A tool an annotation selector exposes cannot be checked by name here.\n    else if (\n      allow != null &&\n      allowSelectors.length === 0 &&\n      !allow.some((pattern) => toolPatternMatches(pattern, tool))\n    )\n      issues.push(warning(`${path} loads ${tool}, which tools.allow does not expose`));\n  }\n  if (connection?.toolCall != null)\n    issues.push(error(`${path} uses toolCall.providedArguments, which is not supported`));\n  const binding: HttpMcpServerBindingIface = {\n    key: args.key,\n    kind: McpServerBindingKind.Http,\n    url: url ?? 'https://invalid.invalid',\n    auth: lowerAuth(connection?.auth, `${path} auth`, issues),\n    headers: stringRecord(connection?.headers, `${path} headers`, issues),\n    approvals,\n  };\n  if (deny.length > 0) binding.deny = [...new Set(deny)];\n  if (load != null) binding.load = [...new Set(load)];\n  // Annotation-selected tools run under the connection default, as unnamed tools do.\n  if (allowSelectors.length > 0)\n    binding.allowAnnotations = allowSelectors.map((match) => ({\n      match,\n      approval: defaultPolicy,\n      ...(inherited == null ? {} : { inputApproval: inherited }),\n    }));\n  if (denyEntries.selectors.length > 0) binding.denyAnnotations = denyEntries.selectors;\n  if (Object.keys(inputApprovals).length > 0) binding.inputApprovals = inputApprovals;\n  return { binding, issues };\n};\n\nexport const skillMarkdown = (args: {\n  key: string;\n  description: string;\n  markdown: string;\n}): string =>\n  args.markdown.startsWith('---\\n')\n    ? args.markdown\n    : `---\\nname: ${JSON.stringify(args.key)}\\ndescription: ${JSON.stringify(args.description)}\\n---\\n\\n${args.markdown}`;\n\nconst authoredSkillSchema = z.looseObject({\n  description: optionalValueSchema,\n  markdown: optionalValueSchema,\n  files: authoredRecordSchema.optional().catch(undefined),\n});\n\nexport interface LoweredSkillIface {\n  skill: SkillBundleIface;\n  issues: IssueIface[];\n}\n\nexport const lowerSkill = (args: { key: string; value: AuthoredValue }): LoweredSkillIface => {\n  const issues: IssueIface[] = [];\n  const parsed = authoredSkillSchema.safeParse(args.value);\n  const description =\n    parsed.success && isString(parsed.data.description) ? parsed.data.description : null;\n  const markdown = parsed.success && isString(parsed.data.markdown) ? parsed.data.markdown : null;\n  if (description == null || description.length === 0)\n    issues.push(error(`skill ${args.key} needs a description`));\n  if (markdown == null) issues.push(error(`skill ${args.key} needs markdown`));\n  const files: SkillBundleIface['files'] = [\n    {\n      path: 'SKILL.md',\n      content: skillMarkdown({\n        key: args.key,\n        description: description ?? '',\n        markdown: markdown ?? '',\n      }),\n    },\n  ];\n  for (const [path, content] of Object.entries(\n    (parsed.success ? parsed.data.files : undefined) ?? {},\n  )) {\n    if (path.startsWith('/') || path.split(/[\\\\/]/).includes('..')) {\n      issues.push(error(`skill ${args.key} file ${path} must stay inside the skill directory`));\n    } else if (!isString(content)) {\n      issues.push(warning(`skill ${args.key} file ${path} is binary and was left out`));\n    } else if (path !== 'SKILL.md') files.push({ path, content });\n  }\n  const skill: SkillBundleIface = { key: args.key, files };\n  if (description != null) skill.description = description;\n  return { skill, issues };\n};\n\nconst authoredInstructionsSchema = z.looseObject({\n  content: z.string(),\n  role: z.string().optional(),\n});\n\nexport const lowerInstructions = (\n  value: AuthoredValue,\n  source: string | null,\n): InstructionFragmentIface | null => {\n  const parsed = authoredInstructionsSchema.safeParse(value);\n  if (!parsed.success) return null;\n  const fragment: InstructionFragmentIface = {\n    role: parsed.data.role === InstructionRole.User ? InstructionRole.User : InstructionRole.System,\n    content: parsed.data.content,\n  };\n  if (source != null) fragment.source = source;\n  return fragment;\n};\n\nexport interface LoweredEnvironmentIface {\n  providerName: string;\n  providerRef: JsonValue | null;\n  options: JsonValue;\n  openOptions: JsonValue | null;\n}\n\nconst environmentSchema = z.looseObject({\n  providerName: z.string(),\n  providerRef: optionalValueSchema,\n  options: optionalValueSchema,\n  open: callableSchema,\n});\n\nconst openRequestSchema = z.looseObject({\n  providerName: z.string(),\n  providerRef: optionalValueSchema,\n  environmentOptions: optionalValueSchema,\n  openOptions: optionalValueSchema,\n});\n\nconst sandboxProviderSchema = z.looseObject({\n  name: z.string(),\n  environment: callableSchema,\n  definition: z.looseObject({}),\n});\n\nexport const isEnvironmentLike = (value: AuthoredValue): boolean =>\n  environmentSchema.safeParse(value).success;\n\nexport const isOpenRequestLike = (value: AuthoredValue): boolean =>\n  openRequestSchema.safeParse(value).success &&\n  isObjectLike(value) &&\n  'environmentOptions' in value;\n\nexport const sandboxProviderNameOf = (value: AuthoredValue): string | null => {\n  const parsed = sandboxProviderSchema.safeParse(value);\n  return parsed.success ? parsed.data.name : null;\n};\n\nexport const lowerEnvironment = (\n  value: AuthoredValue,\n  path: string,\n  issues: IssueIface[],\n): LoweredEnvironmentIface | null => {\n  const warnings = z.array(z.string()).safeParse(fieldOf(value, 'authoringWarnings'));\n  if (warnings.success)\n    for (const message of warnings.data) issues.push(warning(`${path}: ${message}`));\n  const request = isOpenRequestLike(value) ? openRequestSchema.safeParse(value) : null;\n  if (request?.success === true) {\n    return {\n      providerName: request.data.providerName,\n      providerRef:\n        request.data.providerRef == null\n          ? null\n          : toJson(request.data.providerRef, { path, issues }),\n      options: toJson(request.data.environmentOptions ?? {}, { path: `${path} options`, issues }),\n      openOptions: toJson(request.data.openOptions ?? null, {\n        path: `${path} open options`,\n        issues,\n      }),\n    };\n  }\n  const environment = environmentSchema.safeParse(value);\n  if (!environment.success) return null;\n  return {\n    providerName: environment.data.providerName,\n    providerRef:\n      environment.data.providerRef == null\n        ? null\n        : toJson(environment.data.providerRef, { path, issues }),\n    options: toJson(environment.data.options ?? {}, { path: `${path} options`, issues }),\n    openOptions: null,\n  };\n};\n\nexport const isDynamicSentinel = (value: AuthoredValue): boolean =>\n  authoredKindOf(value) === AuthoredKind.Dynamic;\n\nexport const dynamicEventsOf = (value: AuthoredValue): string[] =>\n  entriesOf(fieldOf(value, 'events'))\n    .filter(([, handler]) => isCallable(handler))\n    .map(([event]) => event);\n"],
+  "mappings": "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",
   "names": ["IssueSeverity"]
 }

package/fixtures/assistant/agent/agent.ts

@@ -2,6 +2,13 @@ import { defineAgent, credentials as definitionCredentials } from '@finalai/agen
 import { serverlessPi } from '@finalai/final-agent-provider/harnesses';
 
 export default defineAgent({
+  avatar: {
+    url: 'https://cdn.example.com/assistant/poster.png',
+    states: {
+      idle: { type: 'video', url: 'https://cdn.example.com/assistant/idle.mp4' },
+      researching: { type: 'image', url: 'https://cdn.example.com/assistant/researching.webp' },
+    },
+  },
   harness: serverlessPi({
     credentials: definitionCredentials.chain({
       payer: 'organization',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finalai/agent-definition",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "private": false,
   "description": "Provider-independent agent authoring, manifest schemas, directory compiler, and harness compatibility reports.",
   "license": "Apache-2.0",
@@ -75,8 +75,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@finalai/agent-protocol": "0.1.3",
-    "@finalai/agent-provider": "0.1.3",
+    "@finalai/agent-protocol": "0.1.4",
+    "@finalai/agent-provider": "0.1.4",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "croner": "^10.0.1",