@finalai/agent-definition 0.1.2 → 0.1.3

package/dist/compiler-assets/{chunk-SKTNMUO7.ts → chunk-MSE7X5YG.ts}

@@ -1,3 +1,7 @@
+import {
+  jsonSchemaSchema,
+  jsonValueSchema
+} from "./chunk-4X2DS5BR.ts";
 import {
   array,
   json,
@@ -7,7 +11,23 @@ import {
   string,
   union,
   unknown
-} from "./chunk-HGW4YHAY.ts";
+} from "./chunk-3K4C4SVG.ts";
+
+// ../agent-provider/src/hosted-bindings.ts
+var requireHostedBinding = async (options) => {
+  if (options.name.trim().length === 0) throw new Error("Hosted binding name must not be empty");
+  if (options.bindings == null)
+    throw new Error(`Hosting does not supply bindings required by ${options.name}`);
+  const value = await options.bindings.get(options.name);
+  if (value == null) throw new Error(`Hosted binding ${options.name} is not configured`);
+  const parsed = jsonValueSchema.safeParse(value);
+  if (!parsed.success) throw new Error(`Hosted binding ${options.name} is not JSON configuration`);
+  return parsed.data;
+};
+var hostedBindingRequirementSchema = object({
+  name: string().trim().min(1),
+  schema: jsonSchemaSchema
+});
 
 // ../agent-provider/src/dynamic.ts
 var DynamicEvent = /* @__PURE__ */ ((DynamicEvent2) => {
@@ -22,7 +42,8 @@ var dynamicSlotSchema = object({
     events: array(nativeEnum(DynamicEvent)).min(1),
     // Final additions so Build can render a slot without resolving it.
     description: string().optional(),
-    preview: string().optional()
+    preview: string().optional(),
+    requiredBindings: array(hostedBindingRequirementSchema).optional()
   })
 });
 var isDynamicSlot = (value) => dynamicSlotSchema.safeParse(value).success;
@@ -55,6 +76,8 @@ var findDynamicSlots = (value, path = "") => {
 var containsDynamicSlot = (value) => findDynamicSlots(value).length > 0;
 
 export {
+  requireHostedBinding,
+  hostedBindingRequirementSchema,
   DynamicEvent,
   dynamicSlotSchema,
   isDynamicSlot,

package/dist/compiler-assets/{chunk-OWC6SFFF.ts → chunk-OO67EO5E.ts}

@@ -1,13 +1,13 @@
-import {
-  jsonObjectSchema,
-  jsonSchemaSchema,
-  jsonValueSchema
-} from "./chunk-7QP2CKPI.ts";
 import {
   DynamicEvent,
   containsDynamicSlot,
   maybeDynamic
-} from "./chunk-SKTNMUO7.ts";
+} from "./chunk-MSE7X5YG.ts";
+import {
+  jsonObjectSchema,
+  jsonSchemaSchema,
+  jsonValueSchema
+} from "./chunk-4X2DS5BR.ts";
 import {
   array,
   boolean,
@@ -19,7 +19,7 @@ import {
   record,
   string,
   union
-} from "./chunk-HGW4YHAY.ts";
+} from "./chunk-3K4C4SVG.ts";
 
 // ../agent-provider/src/provider-ref.ts
 var packageProviderRefSchema = object({
@@ -45,7 +45,7 @@ var bundleRef = (exportName) => ({
 var formatProviderRef = (ref) => ref.kind === "package" /* Package */ ? `package:${ref.specifier}` : `bundle:${ref.export}`;
 
 // ../agent-provider/src/manifest.ts
-var MANIFEST_VERSION = 2;
+var MANIFEST_VERSION = 3;
 var BaseCapability = /* @__PURE__ */ ((BaseCapability2) => {
   BaseCapability2["Shell"] = "shell";
   BaseCapability2["Files"] = "files";
@@ -197,7 +197,8 @@ var harnessBindingSchema = object({
   config: maybeDynamic(jsonValueSchema)
 });
 var agentManifestSchema = object({
-  version: literal(MANIFEST_VERSION),
+  // Read persisted v2 revisions; v3 writers require hosts enforcing hosted bindings.
+  version: union([literal(2), literal(MANIFEST_VERSION)]),
   identity: identitySchema,
   harness: harnessBindingSchema,
   mcpServers: maybeDynamic(array(mcpServerBindingSchema)),

package/dist/compiler-assets/chunk-PFLSBTJA.ts

@@ -0,0 +1,39 @@
+import {
+  validateHostedBindingRequirements
+} from "./chunk-ULI5WWRR.ts";
+import {
+  stamp
+} from "./chunk-QJ26GEUM.ts";
+
+// src/authoring/dynamic.ts
+var defineDynamic = (definition) => {
+  const checked = (handler) => {
+    if (handler == null || (definition.requiredBindings?.length ?? 0) === 0) return handler;
+    return async (event, ctx) => {
+      await validateHostedBindingRequirements({
+        requirements: definition.requiredBindings ?? [],
+        bindings: ctx.bindings
+      });
+      const result = await handler(event, ctx);
+      if (result == null) throw new Error("Required hosted binding resolver returned no value");
+      return result;
+    };
+  };
+  const sentinel = {
+    kind: "final:dynamic",
+    events: {
+      ...definition.events,
+      "session.started": checked(definition.events["session.started"]),
+      "turn.started": checked(definition.events["turn.started"])
+    }
+  };
+  if (definition.description != null) sentinel.description = definition.description;
+  if (definition.preview != null) sentinel.preview = definition.preview;
+  if (definition.provider != null) sentinel.provider = definition.provider;
+  if (definition.requiredBindings != null) sentinel.requiredBindings = definition.requiredBindings;
+  return stamp(sentinel, "dynamic" /* Dynamic */);
+};
+
+export {
+  defineDynamic
+};

package/dist/compiler-assets/{chunk-XHKPWT3G.ts → chunk-QJ26GEUM.ts}

@@ -1,6 +1,6 @@
 import {
   isObjectLike
-} from "./chunk-JIPNTA56.ts";
+} from "./chunk-TM36NO3C.ts";
 
 // src/authoring/brand.ts
 var AuthoredKind = /* @__PURE__ */ ((AuthoredKind2) => {

package/dist/compiler-assets/{chunk-BLB6JGLO.ts → chunk-TCKYMNPM.ts}

@@ -8,48 +8,48 @@ import {
   lowerSkill,
   lowerTool,
   toJson
-} from "./chunk-ZDLVA6XF.ts";
+} from "./chunk-5IZTHCGZ.ts";
 import {
   AUTHORED_SERVER_KEY
 } from "./chunk-NMYHO2QN.ts";
 import {
   hookHandlersFor
-} from "./chunk-QMWTDPNT.ts";
+} from "./chunk-TJZS457N.ts";
 import {
   unopenedRequestOf
-} from "./chunk-CWWRTRWW.ts";
+} from "./chunk-4E5HECVD.ts";
 import {
   registerToolName,
   toolLabelSchema
-} from "./chunk-TATN3PYK.ts";
-import {
-  validateSchemaValue
-} from "./chunk-GNR7XBPN.ts";
+} from "./chunk-2ZRYQO4Q.ts";
 import {
   lowerApproval
-} from "./chunk-7VSSVZM4.ts";
-import {
-  mcpServerBindingSchema,
-  providerRefSchema
-} from "./chunk-OWC6SFFF.ts";
+} from "./chunk-BEFBCBUL.ts";
 import {
   ConversationKind,
   ParticipantKind
-} from "./chunk-5BK6FVRE.ts";
+} from "./chunk-IF6MR7JF.ts";
 import {
-  jsonObjectSchema,
-  jsonValueSchema
-} from "./chunk-7QP2CKPI.ts";
+  mcpServerBindingSchema,
+  providerRefSchema
+} from "./chunk-OO67EO5E.ts";
 import {
   TranscriptRole
 } from "./chunk-RWUIMTBI.ts";
+import {
+  validateSchemaValue
+} from "./chunk-W6DOJA4W.ts";
 import {
   DynamicEvent
-} from "./chunk-SKTNMUO7.ts";
+} from "./chunk-MSE7X5YG.ts";
+import {
+  jsonObjectSchema,
+  jsonValueSchema
+} from "./chunk-4X2DS5BR.ts";
 import {
   authoredKindOf,
   stamp
-} from "./chunk-XHKPWT3G.ts";
+} from "./chunk-QJ26GEUM.ts";
 import {
   authoredRecordSchema,
   callableSchema,
@@ -61,7 +61,7 @@ import {
   isPlainObject,
   messageOf,
   optionalValueSchema
-} from "./chunk-JIPNTA56.ts";
+} from "./chunk-TM36NO3C.ts";
 import {
   array,
   boolean,
@@ -70,7 +70,7 @@ import {
   number,
   object,
   string
-} from "./chunk-HGW4YHAY.ts";
+} from "./chunk-3K4C4SVG.ts";
 
 // src/runtime/isolate.ts
 var jsonOf = (value, path) => {
@@ -316,18 +316,20 @@ var createIsolateRuntime = (modules) => {
       session: boundary.session,
       messages: boundary.messages,
       channel: boundary.channel,
-      secrets: args.secrets
+      secrets: args.secrets,
+      bindings: args.bindings
     });
     const expected = args.kind === "tool" /* Tool */ ? "tool" /* Tool */ : "connection" /* Connection */;
     return authoredKindOf(result) === expected ? result : fieldOf(result, boundary.name);
   };
   return {
-    evaluateApproval: async ({ reference, input, secrets }) => {
+    evaluateApproval: async ({ reference, input, secrets, bindings }) => {
       const value = await resolveAuthored({
         exportName: reference.export,
         dynamic: reference.dynamic,
         kind: reference.kind,
-        secrets
+        secrets,
+        bindings
       });
       let policy;
       let validated = input;
@@ -355,7 +357,8 @@ var createIsolateRuntime = (modules) => {
         exportName: args.export,
         dynamic: args.dynamic,
         kind: "tool" /* Tool */,
-        secrets: args.ctx.secrets
+        secrets: args.ctx.secrets,
+        bindings: args.ctx.bindings
       });
       if (args.dynamic != null)
         registerToolName(value, dynamicToolBoundarySchema.parse(args.dynamic).name);

package/dist/compiler-assets/{chunk-QMWTDPNT.ts → chunk-TJZS457N.ts}

@@ -1,13 +1,13 @@
 import {
   stamp
-} from "./chunk-XHKPWT3G.ts";
+} from "./chunk-QJ26GEUM.ts";
 import {
   authoredRecordSchema,
   isCallable
-} from "./chunk-JIPNTA56.ts";
+} from "./chunk-TM36NO3C.ts";
 import {
   looseObject
-} from "./chunk-HGW4YHAY.ts";
+} from "./chunk-3K4C4SVG.ts";
 
 // src/authoring/hooks.ts
 var HookEvent = /* @__PURE__ */ ((HookEvent2) => {

package/dist/compiler-assets/{chunk-JIPNTA56.ts → chunk-TM36NO3C.ts}

@@ -7,7 +7,7 @@ import {
   record,
   string,
   unknown
-} from "./chunk-HGW4YHAY.ts";
+} from "./chunk-3K4C4SVG.ts";
 
 // src/runtime/values.ts
 var authoredValueSchema = unknown();

package/dist/compiler-assets/{chunk-QMKWAFVZ.ts → chunk-TS7XNNHN.ts}

@@ -1,12 +1,12 @@
 import {
   harnessDescriptionSchema
-} from "./chunk-JPY4L2UJ.ts";
+} from "./chunk-3YAKMWV4.ts";
 import {
   bundleRef
-} from "./chunk-OWC6SFFF.ts";
+} from "./chunk-OO67EO5E.ts";
 import {
   registerPending
-} from "./chunk-XHKPWT3G.ts";
+} from "./chunk-QJ26GEUM.ts";
 
 // src/authoring/harness.ts
 var completeHarnessDescription = (authored) => {

package/dist/compiler-assets/chunk-ULI5WWRR.ts

@@ -0,0 +1,40 @@
+import {
+  jsonSchemaError
+} from "./chunk-W6DOJA4W.ts";
+import {
+  findDynamicSlots,
+  requireHostedBinding
+} from "./chunk-MSE7X5YG.ts";
+
+// src/hosted-bindings.ts
+var validateHostedBindings = async (options) => {
+  await validateHostedBindingRequirements({
+    requirements: findDynamicSlots(options.manifest).flatMap(
+      ({ slot }) => slot.$dynamic.requiredBindings ?? []
+    ),
+    bindings: options.bindings
+  });
+};
+var validateHostedBindingRequirements = async (options) => {
+  const values = /* @__PURE__ */ new Map();
+  for (const requirement of options.requirements) {
+    let value = values.get(requirement.name);
+    if (value == null) {
+      value = await requireHostedBinding({ bindings: options.bindings, name: requirement.name });
+      values.set(requirement.name, value);
+    }
+    let validationError;
+    try {
+      validationError = jsonSchemaError(requirement.schema, value);
+    } catch {
+      throw new Error(`Hosted binding ${requirement.name} has an invalid schema`);
+    }
+    if (validationError != null)
+      throw new Error(`Hosted binding ${requirement.name} has invalid configuration`);
+  }
+};
+
+export {
+  validateHostedBindings,
+  validateHostedBindingRequirements
+};