@finalai/agent-definition 0.1.2 → 0.1.3

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

@@ -27,15 +27,15 @@ import {
   skillFileSchema,
   toolDescriptorSchema,
   workerMcpServerBindingSchema
-} from "../chunk-OWC6SFFF.ts";
-import "../chunk-7QP2CKPI.ts";
+} from "../chunk-OO67EO5E.ts";
 import {
   DynamicEvent,
   dynamicSlotSchema,
   findDynamicSlots,
   isDynamicSlot
-} from "../chunk-SKTNMUO7.ts";
-import "../chunk-HGW4YHAY.ts";
+} from "../chunk-MSE7X5YG.ts";
+import "../chunk-4X2DS5BR.ts";
+import "../chunk-3K4C4SVG.ts";
 import "../chunk-32O3ODZE.ts";
 export {
   BaseCapability,

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

@@ -4,11 +4,11 @@ import {
   resolveManifestDetailed,
   slotKindOf,
   validateSlotValue
-} from "../chunk-EVQIK62B.ts";
-import "../chunk-OWC6SFFF.ts";
-import "../chunk-7QP2CKPI.ts";
-import "../chunk-SKTNMUO7.ts";
-import "../chunk-HGW4YHAY.ts";
+} from "../chunk-FHKYXT3F.ts";
+import "../chunk-OO67EO5E.ts";
+import "../chunk-MSE7X5YG.ts";
+import "../chunk-4X2DS5BR.ts";
+import "../chunk-3K4C4SVG.ts";
 import "../chunk-32O3ODZE.ts";
 export {
   SlotValueKind,

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

@@ -1,34 +1,36 @@
+import {
+  combineMcpServers,
+  createIsolateRuntime
+} from "../../chunk-TCKYMNPM.ts";
 import {
   describeBundle,
   needsCombinedMcpServers,
   synthesizedExports
-} from "../../chunk-MZMSKIKU.ts";
-import {
-  combineMcpServers,
-  createIsolateRuntime
-} from "../../chunk-BLB6JGLO.ts";
-import "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-I6U47R5U.ts";
+import "../../chunk-5IZTHCGZ.ts";
 import {
   COMBINED_MCP_SERVERS_EXPORT,
   namedExportName
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-QMWTDPNT.ts";
-import "../../chunk-CWWRTRWW.ts";
+import "../../chunk-TJZS457N.ts";
+import "../../chunk-4E5HECVD.ts";
 import {
   registerToolName
-} from "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
-import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7VSSVZM4.ts";
-import "../../chunk-OWC6SFFF.ts";
-import "../../chunk-5BK6FVRE.ts";
-import "../../chunk-7QP2CKPI.ts";
+} from "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-BEFBCBUL.ts";
+import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-OO67EO5E.ts";
 import "../../chunk-RWUIMTBI.ts";
-import "../../chunk-SKTNMUO7.ts";
-import "../../chunk-T6WG4L4M.ts";
-import "../../chunk-XHKPWT3G.ts";
-import "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-PFLSBTJA.ts";
+import "../../chunk-ULI5WWRR.ts";
+import "../../chunk-W6DOJA4W.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-MSE7X5YG.ts";
+import "../../chunk-4X2DS5BR.ts";
+import "../../chunk-QJ26GEUM.ts";
+import "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 
 // src/runtime/bundle.ts

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

@@ -4,22 +4,24 @@ import {
   describeDynamic,
   needsCombinedMcpServers,
   synthesizedExports
-} from "../../chunk-MZMSKIKU.ts";
-import "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-I6U47R5U.ts";
+import "../../chunk-5IZTHCGZ.ts";
 import {
   COMBINED_MCP_SERVERS_EXPORT
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-BEFBCBUL.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-OO67EO5E.ts";
+import "../../chunk-PFLSBTJA.ts";
+import "../../chunk-ULI5WWRR.ts";
+import "../../chunk-W6DOJA4W.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7VSSVZM4.ts";
-import "../../chunk-OWC6SFFF.ts";
-import "../../chunk-7QP2CKPI.ts";
-import "../../chunk-SKTNMUO7.ts";
-import "../../chunk-T6WG4L4M.ts";
-import "../../chunk-XHKPWT3G.ts";
-import "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-MSE7X5YG.ts";
+import "../../chunk-4X2DS5BR.ts";
+import "../../chunk-QJ26GEUM.ts";
+import "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   COMBINED_MCP_SERVERS_EXPORT,

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

@@ -1,21 +1,25 @@
 import {
   IssueSeverity
-} from "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-5IZTHCGZ.ts";
 import {
   SlotKind
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-BEFBCBUL.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-OO67EO5E.ts";
+import "../../chunk-PFLSBTJA.ts";
+import "../../chunk-ULI5WWRR.ts";
+import "../../chunk-W6DOJA4W.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7VSSVZM4.ts";
-import "../../chunk-OWC6SFFF.ts";
+import {
+  hostedBindingRequirementSchema
+} from "../../chunk-MSE7X5YG.ts";
 import {
   jsonValueSchema
-} from "../../chunk-7QP2CKPI.ts";
-import "../../chunk-SKTNMUO7.ts";
-import "../../chunk-T6WG4L4M.ts";
-import "../../chunk-XHKPWT3G.ts";
-import "../../chunk-JIPNTA56.ts";
+} from "../../chunk-4X2DS5BR.ts";
+import "../../chunk-QJ26GEUM.ts";
+import "../../chunk-TM36NO3C.ts";
 import {
   array,
   boolean,
@@ -25,7 +29,7 @@ import {
   object,
   record,
   string
-} from "../../chunk-HGW4YHAY.ts";
+} from "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 
 // src/runtime/described.ts
@@ -39,6 +43,7 @@ var describedDynamicSchema = object({
   events: array(string()),
   description: string().nullable(),
   preview: string().nullable(),
+  requiredBindings: array(hostedBindingRequirementSchema).optional(),
   provider: providerHintSchema.nullable()
 });
 var describedAgentSchema = object({

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

@@ -2,24 +2,26 @@ import {
   combineMcpServers,
   createIsolateRuntime,
   lowerResolvedValue
-} from "../../chunk-BLB6JGLO.ts";
-import "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-TCKYMNPM.ts";
+import "../../chunk-5IZTHCGZ.ts";
 import "../../chunk-NMYHO2QN.ts";
-import "../../chunk-QMWTDPNT.ts";
-import "../../chunk-CWWRTRWW.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
-import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7VSSVZM4.ts";
-import "../../chunk-OWC6SFFF.ts";
-import "../../chunk-5BK6FVRE.ts";
-import "../../chunk-7QP2CKPI.ts";
+import "../../chunk-TJZS457N.ts";
+import "../../chunk-4E5HECVD.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-BEFBCBUL.ts";
+import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-OO67EO5E.ts";
 import "../../chunk-RWUIMTBI.ts";
-import "../../chunk-SKTNMUO7.ts";
-import "../../chunk-T6WG4L4M.ts";
-import "../../chunk-XHKPWT3G.ts";
-import "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-PFLSBTJA.ts";
+import "../../chunk-ULI5WWRR.ts";
+import "../../chunk-W6DOJA4W.ts";
+import "../../chunk-7WGYG73V.ts";
+import "../../chunk-MSE7X5YG.ts";
+import "../../chunk-4X2DS5BR.ts";
+import "../../chunk-QJ26GEUM.ts";
+import "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   combineMcpServers,

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

@@ -17,18 +17,20 @@ import {
   toJson,
   toJsonSchema,
   warning
-} from "../../chunk-ZDLVA6XF.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
+} from "../../chunk-5IZTHCGZ.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-BEFBCBUL.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-OO67EO5E.ts";
+import "../../chunk-PFLSBTJA.ts";
+import "../../chunk-ULI5WWRR.ts";
+import "../../chunk-W6DOJA4W.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7VSSVZM4.ts";
-import "../../chunk-OWC6SFFF.ts";
-import "../../chunk-7QP2CKPI.ts";
-import "../../chunk-SKTNMUO7.ts";
-import "../../chunk-T6WG4L4M.ts";
-import "../../chunk-XHKPWT3G.ts";
-import "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-MSE7X5YG.ts";
+import "../../chunk-4X2DS5BR.ts";
+import "../../chunk-QJ26GEUM.ts";
+import "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   IssueSeverity,

package/dist/compiler-assets/src/runtime/schema-validation.ts

@@ -5,11 +5,11 @@ import {
   resultMatchesSchema,
   standardValidatorSchema,
   validateSchemaValue
-} from "../../chunk-GNR7XBPN.ts";
+} from "../../chunk-W6DOJA4W.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-7QP2CKPI.ts";
-import "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+import "../../chunk-4X2DS5BR.ts";
+import "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   SchemaIo,

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

@@ -15,8 +15,8 @@ import {
   messageOf,
   optionalValueSchema,
   stringOrNull
-} from "../../chunk-JIPNTA56.ts";
-import "../../chunk-HGW4YHAY.ts";
+} from "../../chunk-TM36NO3C.ts";
+import "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   authoredRecordSchema,

package/dist/modules/authoring/connections.d.mts

@@ -1,4 +1,5 @@
 import type { ApprovalPolicyIface } from "./approval.mjs";
+import { type DynamicSentinelIface } from "./dynamic.mjs";
 export type McpConnectionAuthIface = {
     readonly secretKey: string;
     readonly headerName: string | null;
@@ -21,3 +22,7 @@ export interface McpClientConnectionDefinitionIface {
     readonly instanceKey?: string;
 }
 export declare const defineMcpClientConnection: <TConnection extends McpClientConnectionDefinitionIface>(definition: TConnection) => TConnection;
+export interface HostedConnectionDefinitionIface extends Omit<McpClientConnectionDefinitionIface, 'url' | 'auth' | 'headers' | 'protocolVersionDiscovery' | 'instanceKey'> {
+    readonly binding: string;
+}
+export declare const defineHostedConnection: (definition: HostedConnectionDefinitionIface) => DynamicSentinelIface<McpClientConnectionDefinitionIface>;

package/dist/modules/authoring/connections.mjs

@@ -1,6 +1,42 @@
 import { AuthoredKind, stamp } from "./brand.mjs";
+import { jsonObjectSchema, mcpAuthSchema, requireHostedBinding } from "@finalai/agent-provider";
+import * as z from "zod";
+import { defineDynamic } from "./dynamic.mjs";
 const defineMcpClientConnection = (definition) => stamp({ ...definition }, AuthoredKind.Connection);
+const hostedConnectionSchema = z.strictObject({
+  url: z.string().url(),
+  auth: mcpAuthSchema.nullable().optional(),
+  headers: z.record(z.string(), z.string()).optional()
+});
+const defineHostedConnection = (definition) => {
+  const { binding, description, tools, approval } = definition;
+  if (binding.trim().length === 0) throw new Error("Hosted connection binding must not be empty");
+  return defineDynamic({
+    description: definition.description ?? `Hosted connection ${binding}`,
+    preview: `Resolved by hosting from ${binding}`,
+    requiredBindings: [
+      { name: binding, schema: jsonObjectSchema.parse(z.toJSONSchema(hostedConnectionSchema)) }
+    ],
+    events: {
+      "session.started": async (_event, ctx) => {
+        const value = await requireHostedBinding({ bindings: ctx.bindings, name: binding });
+        const parsed = hostedConnectionSchema.safeParse(value);
+        if (!parsed.success)
+          throw new Error(`Hosted connection ${binding} has invalid configuration`);
+        const { auth, ...transport } = parsed.data;
+        return defineMcpClientConnection({
+          ...transport,
+          description,
+          tools,
+          approval,
+          ...auth == null ? {} : { auth }
+        });
+      }
+    }
+  });
+};
 export {
+  defineHostedConnection,
   defineMcpClientConnection
 };
 //# sourceMappingURL=connections.mjs.map

package/dist/modules/authoring/connections.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/connections.ts"],
-  "sourcesContent": ["import type { ApprovalPolicyIface } from \"./approval.mjs\";\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\n\n// An MCP connection. Secrets are references by\n// name: the MCP host injects them, so they never reach the harness. Final's\n// own MCP server is an ordinary connection with `auth: { kind: 'final-session' }`.\n\nexport type McpConnectionAuthIface =\n  // Sent as `Authorization: Bearer <secret>` when headerName is null.\n  | { readonly secretKey: string; readonly headerName: string | null }\n  | { readonly kind: 'final-session' };\n\nexport interface McpConnectionToolsIface {\n  // Only these tools are exposed; omit to expose every tool the server lists.\n  readonly allow?: readonly string[];\n  // These tools are hidden, whatever `allow` says.\n  readonly deny?: readonly string[];\n  // Per-tool approval; tools not listed use the connection's `approval`.\n  readonly approval?: Readonly<Record<string, ApprovalPolicyIface<never>>>;\n}\n\nexport interface McpClientConnectionDefinitionIface {\n  readonly url: string;\n  readonly description?: string;\n  readonly auth?: McpConnectionAuthIface;\n  readonly headers?: Readonly<Record<string, string>>;\n  readonly tools?: McpConnectionToolsIface;\n  // Default approval for every tool of this connection.\n  readonly approval?: ApprovalPolicyIface<never>;\n  readonly protocolVersionDiscovery?: boolean;\n  readonly instanceKey?: string;\n}\n\nexport const defineMcpClientConnection = <TConnection extends McpClientConnectionDefinitionIface>(\n  definition: TConnection,\n): TConnection => stamp({ ...definition }, AuthoredKind.Connection);\n"],
-  "mappings": "AACA,SAAS,cAAc,aAAa;AAgC7B,MAAM,4BAA4B,CACvC,eACgB,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,UAAU;",
+  "sourcesContent": ["import type { ApprovalPolicyIface } from \"./approval.mjs\";\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport { jsonObjectSchema, mcpAuthSchema, requireHostedBinding } from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { defineDynamic, type DynamicSentinelIface } from \"./dynamic.mjs\";\n\n// An MCP connection. Secrets are references by\n// name: the MCP host injects them, so they never reach the harness. Final's\n// own MCP server is an ordinary connection with `auth: { kind: 'final-session' }`.\n\nexport type McpConnectionAuthIface =\n  // Sent as `Authorization: Bearer <secret>` when headerName is null.\n  | { readonly secretKey: string; readonly headerName: string | null }\n  | { readonly kind: 'final-session' };\n\nexport interface McpConnectionToolsIface {\n  // Only these tools are exposed; omit to expose every tool the server lists.\n  readonly allow?: readonly string[];\n  // These tools are hidden, whatever `allow` says.\n  readonly deny?: readonly string[];\n  // Per-tool approval; tools not listed use the connection's `approval`.\n  readonly approval?: Readonly<Record<string, ApprovalPolicyIface<never>>>;\n}\n\nexport interface McpClientConnectionDefinitionIface {\n  readonly url: string;\n  readonly description?: string;\n  readonly auth?: McpConnectionAuthIface;\n  readonly headers?: Readonly<Record<string, string>>;\n  readonly tools?: McpConnectionToolsIface;\n  // Default approval for every tool of this connection.\n  readonly approval?: ApprovalPolicyIface<never>;\n  readonly protocolVersionDiscovery?: boolean;\n  readonly instanceKey?: string;\n}\n\nexport const defineMcpClientConnection = <TConnection extends McpClientConnectionDefinitionIface>(\n  definition: TConnection,\n): TConnection => stamp({ ...definition }, AuthoredKind.Connection);\n\nexport interface HostedConnectionDefinitionIface extends Omit<\n  McpClientConnectionDefinitionIface,\n  'url' | 'auth' | 'headers' | 'protocolVersionDiscovery' | 'instanceKey'\n> {\n  readonly binding: string;\n}\n\nconst hostedConnectionSchema = z.strictObject({\n  url: z.string().url(),\n  auth: mcpAuthSchema.nullable().optional(),\n  headers: z.record(z.string(), z.string()).optional(),\n});\n\n// Built-in and third-party bindings use the ordinary dynamic connection path.\nexport const defineHostedConnection = (\n  definition: HostedConnectionDefinitionIface,\n): DynamicSentinelIface<McpClientConnectionDefinitionIface> => {\n  const { binding, description, tools, approval } = definition;\n  if (binding.trim().length === 0) throw new Error('Hosted connection binding must not be empty');\n  return defineDynamic({\n    description: definition.description ?? `Hosted connection ${binding}`,\n    preview: `Resolved by hosting from ${binding}`,\n    requiredBindings: [\n      { name: binding, schema: jsonObjectSchema.parse(z.toJSONSchema(hostedConnectionSchema)) },\n    ],\n    events: {\n      'session.started': async (_event, ctx) => {\n        const value = await requireHostedBinding({ bindings: ctx.bindings, name: binding });\n        const parsed = hostedConnectionSchema.safeParse(value);\n        if (!parsed.success)\n          throw new Error(`Hosted connection ${binding} has invalid configuration`);\n        const { auth, ...transport } = parsed.data;\n        return defineMcpClientConnection({\n          ...transport,\n          description,\n          tools,\n          approval,\n          ...(auth == null ? {} : { auth }),\n        });\n      },\n    },\n  });\n};\n"],
+  "mappings": "AACA,SAAS,cAAc,aAAa;AACpC,SAAS,kBAAkB,eAAe,4BAA4B;AACtE,YAAY,OAAO;AACnB,SAAS,qBAAgD;AAgClD,MAAM,4BAA4B,CACvC,eACgB,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,UAAU;AASlE,MAAM,yBAAyB,EAAE,aAAa;AAAA,EAC5C,KAAK,EAAE,OAAO,EAAE,IAAI;AAAA,EACpB,MAAM,cAAc,SAAS,EAAE,SAAS;AAAA,EACxC,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,SAAS;AACrD,CAAC;AAGM,MAAM,yBAAyB,CACpC,eAC6D;AAC7D,QAAM,EAAE,SAAS,aAAa,OAAO,SAAS,IAAI;AAClD,MAAI,QAAQ,KAAK,EAAE,WAAW,EAAG,OAAM,IAAI,MAAM,6CAA6C;AAC9F,SAAO,cAAc;AAAA,IACnB,aAAa,WAAW,eAAe,qBAAqB,OAAO;AAAA,IACnE,SAAS,4BAA4B,OAAO;AAAA,IAC5C,kBAAkB;AAAA,MAChB,EAAE,MAAM,SAAS,QAAQ,iBAAiB,MAAM,EAAE,aAAa,sBAAsB,CAAC,EAAE;AAAA,IAC1F;AAAA,IACA,QAAQ;AAAA,MACN,mBAAmB,OAAO,QAAQ,QAAQ;AACxC,cAAM,QAAQ,MAAM,qBAAqB,EAAE,UAAU,IAAI,UAAU,MAAM,QAAQ,CAAC;AAClF,cAAM,SAAS,uBAAuB,UAAU,KAAK;AACrD,YAAI,CAAC,OAAO;AACV,gBAAM,IAAI,MAAM,qBAAqB,OAAO,4BAA4B;AAC1E,cAAM,EAAE,MAAM,GAAG,UAAU,IAAI,OAAO;AACtC,eAAO,0BAA0B;AAAA,UAC/B,GAAG;AAAA,UACH;AAAA,UACA;AAAA,UACA;AAAA,UACA,GAAI,QAAQ,OAAO,CAAC,IAAI,EAAE,KAAK;AAAA,QACjC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/dist/modules/authoring/context.d.mts

@@ -1,5 +1,5 @@
 import type { ConversationMessageIface } from '@finalai/agent-protocol/agent-platform';
-import type { ConversationKind, JsonObject, JsonValue, NetworkSandboxSessionIface, ParticipantKind, ProviderRef } from '@finalai/agent-provider';
+import type { ConversationKind, HostedBindingsIface, JsonObject, JsonValue, NetworkSandboxSessionIface, ParticipantKind, ProviderRef } from '@finalai/agent-provider';
 export interface ParticipantInfoIface {
     id: string;
     kind: ParticipantKind;
@@ -63,6 +63,7 @@ export interface FinalPlatformClientIface {
     }): Promise<ConversationMessageIface[]>;
 }
 export interface ToolContextIface {
+    readonly bindings?: HostedBindingsIface;
     readonly session: AgentSessionInfoIface;
     readonly callId: string;
     readonly toolName: string;
@@ -73,6 +74,7 @@ export interface ToolContextIface {
     readonly final: FinalPlatformClientIface;
 }
 export interface DynamicResolveContextIface {
+    readonly bindings?: HostedBindingsIface;
     readonly previousValue?: JsonValue | null;
     readonly session: AgentSessionInfoIface;
     readonly messages: readonly TranscriptMessageIface[];

package/dist/modules/authoring/context.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/context.ts"],
-  "sourcesContent": ["import type { ConversationMessageIface } from '@finalai/agent-protocol/agent-platform';\nimport type {\n  ConversationKind,\n  JsonObject,\n  JsonValue,\n  NetworkSandboxSessionIface,\n  ParticipantKind,\n  ProviderRef,\n} from '@finalai/agent-provider';\n\n// What authored code (tools, hooks, dynamic resolvers, channel routes) sees of\n// the session it runs for. Everything is provided by\n// the session service through the Worker isolate; none of it is harness state.\n//\n// Ids are the public API's wire ids (`<prefix>_<base58>`), the same strings the\n// client SDK and `/api/v1` return: a session is `ases_\u2026`, a conversation\n// `conv_\u2026`, a participant `cpart_\u2026`, a turn `atrn_\u2026`, a user `usr_\u2026`. Pass them\n// back unchanged (`ctx.final.post({ conversationId })`, channel platform\n// calls); raw UUIDs are refused. ACP ids (`toolCallId`, prompt message ids)\n// and provider or model ids are passed through as the harness sent them.\n\nexport interface ParticipantInfoIface {\n  // `cpart_\u2026`; `userId` is `usr_\u2026`.\n  id: string;\n  kind: ParticipantKind;\n  displayName: string;\n  userId: string | null;\n}\n\nexport interface ConversationInfoIface {\n  // `conv_\u2026`, as `client` and `/api/v1/conversations` name it.\n  id: string;\n  kind: ConversationKind;\n  title: string | null;\n  metadata: JsonObject;\n  participants: ParticipantInfoIface[];\n}\n\nexport interface PromptAuthorIface {\n  participantId: string | null;\n  userId: string | null;\n  displayName: string;\n}\n\nexport interface AgentSessionInfoIface {\n  // `ases_\u2026`: what `client.sessions.attach(id)` takes.\n  id: string;\n  // `org_\u2026`.\n  organizationId: string;\n  // The agent (`adef_\u2026`) and its published revision (`arev_\u2026`).\n  definitionId: string;\n  revisionId: string;\n  conversation: ConversationInfoIface | null;\n  // Who prompted the current turn; null outside a turn and for system input.\n  author: PromptAuthorIface | null;\n  // `atrn_\u2026`.\n  turn: { id: string } | null;\n  harness: ProviderRef;\n}\n\nexport enum TranscriptRole {\n  User = 'user',\n  Assistant = 'assistant',\n  Tool = 'tool',\n  Thought = 'thought',\n  Summary = 'summary',\n}\n\n// One entry of the transcript rebuilt from the session's ACP log. Not the\n// harness's byte-exact model input (no system prompt).\nexport interface TranscriptMessageIface {\n  role: TranscriptRole;\n  // ACP content blocks.\n  content: JsonValue[];\n  toolCallId: string | null;\n  seq: number;\n}\n\nexport interface SecretsIface {\n  get(name: string): Promise<string | null>;\n}\n\nexport interface PostMessageInputIface {\n  text?: string;\n  // ACP content blocks; appended after `text` when both are given.\n  content?: JsonValue[];\n  // A `conv_\u2026` id; defaults to the session's conversation.\n  conversationId?: string;\n}\n\n// The agent-platform client handed to authored code (a Final addition).\nexport interface FinalPlatformClientIface {\n  // Resolves the posted message's `cnmsg_\u2026` id.\n  post(input: PostMessageInputIface): Promise<{ messageId: string }>;\n  conversation(): Promise<ConversationInfoIface | null>;\n  // The current conversation's visible history, oldest first within the page.\n  // `before` is a cnmsg_\u2026 id; other conversations are refused by the platform.\n  read(options?: {\n    conversationId?: string;\n    limit?: number;\n    before?: string;\n  }): Promise<ConversationMessageIface[]>;\n}\n\nexport interface ToolContextIface {\n  readonly session: AgentSessionInfoIface;\n  // The MCP request id the harness chose; shows up as the ACP toolCallId.\n  readonly callId: string;\n  // Qualified name as the harness saw it.\n  readonly toolName: string;\n  readonly abortSignal: AbortSignal;\n  // The same handle the sandbox MCP server uses; the first call starts the\n  // sandbox. Defaults to the definition's default target.\n  getSandbox(target?: string): Promise<NetworkSandboxSessionIface>;\n  readonly messages: readonly TranscriptMessageIface[];\n  readonly secrets: SecretsIface;\n  readonly final: FinalPlatformClientIface;\n}\n\nexport interface DynamicResolveContextIface {\n  // The persisted value of this slot at its previous lifecycle boundary.\n  readonly previousValue?: JsonValue | null;\n  readonly session: AgentSessionInfoIface;\n  // The transcript at the boundary (empty at session.started for a new session).\n  readonly messages: readonly TranscriptMessageIface[];\n  readonly channel: { kind: string | null };\n  readonly secrets: SecretsIface;\n}\n"],
-  "mappings": "AA4DO,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,aAAU;AALA,SAAAA;AAAA,GAAA;",
+  "sourcesContent": ["import type { ConversationMessageIface } from '@finalai/agent-protocol/agent-platform';\nimport type {\n  ConversationKind,\n  HostedBindingsIface,\n  JsonObject,\n  JsonValue,\n  NetworkSandboxSessionIface,\n  ParticipantKind,\n  ProviderRef,\n} from '@finalai/agent-provider';\n\n// What authored code (tools, hooks, dynamic resolvers, channel routes) sees of\n// the session it runs for. Everything is provided by\n// the session service through the Worker isolate; none of it is harness state.\n//\n// Ids are the public API's wire ids (`<prefix>_<base58>`), the same strings the\n// client SDK and `/api/v1` return: a session is `ases_\u2026`, a conversation\n// `conv_\u2026`, a participant `cpart_\u2026`, a turn `atrn_\u2026`, a user `usr_\u2026`. Pass them\n// back unchanged (`ctx.final.post({ conversationId })`, channel platform\n// calls); raw UUIDs are refused. ACP ids (`toolCallId`, prompt message ids)\n// and provider or model ids are passed through as the harness sent them.\n\nexport interface ParticipantInfoIface {\n  // `cpart_\u2026`; `userId` is `usr_\u2026`.\n  id: string;\n  kind: ParticipantKind;\n  displayName: string;\n  userId: string | null;\n}\n\nexport interface ConversationInfoIface {\n  // `conv_\u2026`, as `client` and `/api/v1/conversations` name it.\n  id: string;\n  kind: ConversationKind;\n  title: string | null;\n  metadata: JsonObject;\n  participants: ParticipantInfoIface[];\n}\n\nexport interface PromptAuthorIface {\n  participantId: string | null;\n  userId: string | null;\n  displayName: string;\n}\n\nexport interface AgentSessionInfoIface {\n  // `ases_\u2026`: what `client.sessions.attach(id)` takes.\n  id: string;\n  // `org_\u2026`.\n  organizationId: string;\n  // The agent (`adef_\u2026`) and its published revision (`arev_\u2026`).\n  definitionId: string;\n  revisionId: string;\n  conversation: ConversationInfoIface | null;\n  // Who prompted the current turn; null outside a turn and for system input.\n  author: PromptAuthorIface | null;\n  // `atrn_\u2026`.\n  turn: { id: string } | null;\n  harness: ProviderRef;\n}\n\nexport enum TranscriptRole {\n  User = 'user',\n  Assistant = 'assistant',\n  Tool = 'tool',\n  Thought = 'thought',\n  Summary = 'summary',\n}\n\n// One entry of the transcript rebuilt from the session's ACP log. Not the\n// harness's byte-exact model input (no system prompt).\nexport interface TranscriptMessageIface {\n  role: TranscriptRole;\n  // ACP content blocks.\n  content: JsonValue[];\n  toolCallId: string | null;\n  seq: number;\n}\n\nexport interface SecretsIface {\n  get(name: string): Promise<string | null>;\n}\n\nexport interface PostMessageInputIface {\n  text?: string;\n  // ACP content blocks; appended after `text` when both are given.\n  content?: JsonValue[];\n  // A `conv_\u2026` id; defaults to the session's conversation.\n  conversationId?: string;\n}\n\n// The agent-platform client handed to authored code (a Final addition).\nexport interface FinalPlatformClientIface {\n  // Resolves the posted message's `cnmsg_\u2026` id.\n  post(input: PostMessageInputIface): Promise<{ messageId: string }>;\n  conversation(): Promise<ConversationInfoIface | null>;\n  // The current conversation's visible history, oldest first within the page.\n  // `before` is a cnmsg_\u2026 id; other conversations are refused by the platform.\n  read(options?: {\n    conversationId?: string;\n    limit?: number;\n    before?: string;\n  }): Promise<ConversationMessageIface[]>;\n}\n\nexport interface ToolContextIface {\n  readonly bindings?: HostedBindingsIface;\n  readonly session: AgentSessionInfoIface;\n  // The MCP request id the harness chose; shows up as the ACP toolCallId.\n  readonly callId: string;\n  // Qualified name as the harness saw it.\n  readonly toolName: string;\n  readonly abortSignal: AbortSignal;\n  // The same handle the sandbox MCP server uses; the first call starts the\n  // sandbox. Defaults to the definition's default target.\n  getSandbox(target?: string): Promise<NetworkSandboxSessionIface>;\n  readonly messages: readonly TranscriptMessageIface[];\n  readonly secrets: SecretsIface;\n  readonly final: FinalPlatformClientIface;\n}\n\nexport interface DynamicResolveContextIface {\n  readonly bindings?: HostedBindingsIface;\n  // The persisted value of this slot at its previous lifecycle boundary.\n  readonly previousValue?: JsonValue | null;\n  readonly session: AgentSessionInfoIface;\n  // The transcript at the boundary (empty at session.started for a new session).\n  readonly messages: readonly TranscriptMessageIface[];\n  readonly channel: { kind: string | null };\n  readonly secrets: SecretsIface;\n}\n"],
+  "mappings": "AA6DO,IAAK,iBAAL,kBAAKA,oBAAL;AACL,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,eAAY;AACZ,EAAAA,gBAAA,UAAO;AACP,EAAAA,gBAAA,aAAU;AACV,EAAAA,gBAAA,aAAU;AALA,SAAAA;AAAA,GAAA;",
   "names": ["TranscriptRole"]
 }

package/dist/modules/authoring/dynamic.d.mts

@@ -1,4 +1,4 @@
-import type { ProviderRef } from '@finalai/agent-provider';
+import type { HostedBindingRequirementIface, ProviderRef } from '@finalai/agent-provider';
 import type { DynamicResolveContextIface } from "./context.mjs";
 export type DynamicHandler<TResult> = (event: DynamicBoundaryEventIface, ctx: DynamicResolveContextIface) => TResult | Promise<TResult>;
 export interface DynamicBoundaryEventIface {
@@ -19,6 +19,7 @@ export interface DynamicDefinitionIface<TResult> {
     readonly description?: string;
     readonly preview?: string;
     readonly provider?: DynamicProviderHint;
+    readonly requiredBindings?: readonly HostedBindingRequirementIface[];
 }
 export interface DynamicSentinelIface<TResult = unknown> {
     readonly kind: 'final:dynamic';
@@ -26,5 +27,6 @@ export interface DynamicSentinelIface<TResult = unknown> {
     readonly description?: string;
     readonly preview?: string;
     readonly provider?: DynamicProviderHint;
+    readonly requiredBindings?: readonly HostedBindingRequirementIface[];
 }
 export declare const defineDynamic: <TResult>(definition: DynamicDefinitionIface<TResult>) => DynamicSentinelIface<TResult>;

package/dist/modules/authoring/dynamic.mjs

@@ -1,12 +1,30 @@
 import { AuthoredKind, stamp } from "./brand.mjs";
+import { validateHostedBindingRequirements } from "../hosted-bindings.mjs";
 const 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
+    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, AuthoredKind.Dynamic);
 };
 export {

package/dist/modules/authoring/dynamic.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/dynamic.ts"],
-  "sourcesContent": ["import type { ProviderRef } from '@finalai/agent-provider';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport type { DynamicResolveContextIface } from \"./context.mjs\";\n\n// defineDynamic: a definition computed at a lifecycle\n// boundary. The directory a file sits in decides what a handler must return.\n// `description` and `preview` are Final additions so Build can render a slot\n// without resolving it.\n\nexport type DynamicHandler<TResult> = (\n  event: DynamicBoundaryEventIface,\n  ctx: DynamicResolveContextIface,\n) => TResult | Promise<TResult>;\n\nexport interface DynamicBoundaryEventIface {\n  type: 'session.started' | 'turn.started';\n  // The prompt that started the turn (turn.started only), as ACP content blocks.\n  prompt: unknown[] | null;\n}\n\nexport interface DynamicEventsIface<TResult> {\n  readonly 'session.started'?: DynamicHandler<TResult>;\n  readonly 'turn.started'?: DynamicHandler<TResult>;\n}\n\n// A sandbox target whose environment is dynamic still needs its provider at\n// compile time: an installed provider helper, a provider defined with\n// defineSandboxProvider, or a provider reference.\nexport type DynamicProviderHint =\n  | ProviderRef\n  | { readonly name: string }\n  | { readonly providerRef: ProviderRef };\n\nexport interface DynamicDefinitionIface<TResult> {\n  readonly events: DynamicEventsIface<TResult>;\n  readonly description?: string;\n  readonly preview?: string;\n  readonly provider?: DynamicProviderHint;\n}\n\nexport interface DynamicSentinelIface<TResult = unknown> {\n  readonly kind: 'final:dynamic';\n  readonly events: DynamicEventsIface<TResult>;\n  readonly description?: string;\n  readonly preview?: string;\n  readonly provider?: DynamicProviderHint;\n}\n\ninterface DynamicSentinelFieldsIface<TResult> {\n  kind: 'final:dynamic';\n  events: DynamicEventsIface<TResult>;\n  description?: string;\n  preview?: string;\n  provider?: DynamicProviderHint;\n}\n\nexport const defineDynamic = <TResult>(\n  definition: DynamicDefinitionIface<TResult>,\n): DynamicSentinelIface<TResult> => {\n  const sentinel: DynamicSentinelFieldsIface<TResult> = {\n    kind: 'final:dynamic',\n    events: definition.events,\n  };\n  if (definition.description != null) sentinel.description = definition.description;\n  if (definition.preview != null) sentinel.preview = definition.preview;\n  if (definition.provider != null) sentinel.provider = definition.provider;\n  return stamp(sentinel, AuthoredKind.Dynamic);\n};\n"],
-  "mappings": "AACA,SAAS,cAAc,aAAa;AAuD7B,MAAM,gBAAgB,CAC3B,eACkC;AAClC,QAAM,WAAgD;AAAA,IACpD,MAAM;AAAA,IACN,QAAQ,WAAW;AAAA,EACrB;AACA,MAAI,WAAW,eAAe,KAAM,UAAS,cAAc,WAAW;AACtE,MAAI,WAAW,WAAW,KAAM,UAAS,UAAU,WAAW;AAC9D,MAAI,WAAW,YAAY,KAAM,UAAS,WAAW,WAAW;AAChE,SAAO,MAAM,UAAU,aAAa,OAAO;AAC7C;",
+  "sourcesContent": ["import type { HostedBindingRequirementIface, ProviderRef } from '@finalai/agent-provider';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport { validateHostedBindingRequirements } from \"../hosted-bindings.mjs\";\nimport type { DynamicResolveContextIface } from \"./context.mjs\";\n\n// defineDynamic: a definition computed at a lifecycle\n// boundary. The directory a file sits in decides what a handler must return.\n// `description` and `preview` are Final additions so Build can render a slot\n// without resolving it.\n\nexport type DynamicHandler<TResult> = (\n  event: DynamicBoundaryEventIface,\n  ctx: DynamicResolveContextIface,\n) => TResult | Promise<TResult>;\n\nexport interface DynamicBoundaryEventIface {\n  type: 'session.started' | 'turn.started';\n  // The prompt that started the turn (turn.started only), as ACP content blocks.\n  prompt: unknown[] | null;\n}\n\nexport interface DynamicEventsIface<TResult> {\n  readonly 'session.started'?: DynamicHandler<TResult>;\n  readonly 'turn.started'?: DynamicHandler<TResult>;\n}\n\n// A sandbox target whose environment is dynamic still needs its provider at\n// compile time: an installed provider helper, a provider defined with\n// defineSandboxProvider, or a provider reference.\nexport type DynamicProviderHint =\n  | ProviderRef\n  | { readonly name: string }\n  | { readonly providerRef: ProviderRef };\n\nexport interface DynamicDefinitionIface<TResult> {\n  readonly events: DynamicEventsIface<TResult>;\n  readonly description?: string;\n  readonly preview?: string;\n  readonly provider?: DynamicProviderHint;\n  readonly requiredBindings?: readonly HostedBindingRequirementIface[];\n}\n\nexport interface DynamicSentinelIface<TResult = unknown> {\n  readonly kind: 'final:dynamic';\n  readonly events: DynamicEventsIface<TResult>;\n  readonly description?: string;\n  readonly preview?: string;\n  readonly provider?: DynamicProviderHint;\n  readonly requiredBindings?: readonly HostedBindingRequirementIface[];\n}\n\ninterface DynamicSentinelFieldsIface<TResult> {\n  kind: 'final:dynamic';\n  events: DynamicEventsIface<TResult>;\n  description?: string;\n  preview?: string;\n  provider?: DynamicProviderHint;\n  requiredBindings?: readonly HostedBindingRequirementIface[];\n}\n\nexport const defineDynamic = <TResult>(\n  definition: DynamicDefinitionIface<TResult>,\n): DynamicSentinelIface<TResult> => {\n  const checked = (\n    handler: DynamicHandler<TResult> | undefined,\n  ): DynamicHandler<TResult> | undefined => {\n    if (handler == null || (definition.requiredBindings?.length ?? 0) === 0) return handler;\n    return async (event, ctx) => {\n      await validateHostedBindingRequirements({\n        requirements: definition.requiredBindings ?? [],\n        bindings: ctx.bindings,\n      });\n      const result = await handler(event, ctx);\n      if (result == null) throw new Error('Required hosted binding resolver returned no value');\n      return result;\n    };\n  };\n  const sentinel: DynamicSentinelFieldsIface<TResult> = {\n    kind: 'final:dynamic',\n    events: {\n      ...definition.events,\n      'session.started': checked(definition.events['session.started']),\n      'turn.started': checked(definition.events['turn.started']),\n    },\n  };\n  if (definition.description != null) sentinel.description = definition.description;\n  if (definition.preview != null) sentinel.preview = definition.preview;\n  if (definition.provider != null) sentinel.provider = definition.provider;\n  if (definition.requiredBindings != null) sentinel.requiredBindings = definition.requiredBindings;\n  return stamp(sentinel, AuthoredKind.Dynamic);\n};\n"],
+  "mappings": "AACA,SAAS,cAAc,aAAa;AACpC,SAAS,yCAAyC;AA0D3C,MAAM,gBAAgB,CAC3B,eACkC;AAClC,QAAM,UAAU,CACd,YACwC;AACxC,QAAI,WAAW,SAAS,WAAW,kBAAkB,UAAU,OAAO,EAAG,QAAO;AAChF,WAAO,OAAO,OAAO,QAAQ;AAC3B,YAAM,kCAAkC;AAAA,QACtC,cAAc,WAAW,oBAAoB,CAAC;AAAA,QAC9C,UAAU,IAAI;AAAA,MAChB,CAAC;AACD,YAAM,SAAS,MAAM,QAAQ,OAAO,GAAG;AACvC,UAAI,UAAU,KAAM,OAAM,IAAI,MAAM,oDAAoD;AACxF,aAAO;AAAA,IACT;AAAA,EACF;AACA,QAAM,WAAgD;AAAA,IACpD,MAAM;AAAA,IACN,QAAQ;AAAA,MACN,GAAG,WAAW;AAAA,MACd,mBAAmB,QAAQ,WAAW,OAAO,iBAAiB,CAAC;AAAA,MAC/D,gBAAgB,QAAQ,WAAW,OAAO,cAAc,CAAC;AAAA,IAC3D;AAAA,EACF;AACA,MAAI,WAAW,eAAe,KAAM,UAAS,cAAc,WAAW;AACtE,MAAI,WAAW,WAAW,KAAM,UAAS,UAAU,WAAW;AAC9D,MAAI,WAAW,YAAY,KAAM,UAAS,WAAW,WAAW;AAChE,MAAI,WAAW,oBAAoB,KAAM,UAAS,mBAAmB,WAAW;AAChF,SAAO,MAAM,UAAU,aAAa,OAAO;AAC7C;",
   "names": []
 }

package/dist/modules/authoring/hooks.d.mts

@@ -1,4 +1,4 @@
-import type { JsonValue, NetworkSandboxSessionIface } from '@finalai/agent-provider';
+import type { HostedBindingsIface, JsonValue, NetworkSandboxSessionIface } from '@finalai/agent-provider';
 import { type AuthoredValue } from "../runtime/values.mjs";
 import type { AgentSessionInfoIface, FinalPlatformClientIface, SecretsIface, TranscriptMessageIface } from "./context.mjs";
 import type { ToolCallEventDataIface } from "./tools.mjs";
@@ -101,6 +101,7 @@ export interface HookContextIface {
     getSandbox(target?: string): Promise<NetworkSandboxSessionIface>;
     cancel(): void;
     readonly secrets: SecretsIface;
+    readonly bindings?: HostedBindingsIface;
     readonly final: FinalPlatformClientIface;
 }
 export type HookHandler<TKey extends string> = (event: HookEventFor<TKey>, ctx: HookContextIface) => void | Promise<void>;

package/dist/modules/authoring/hooks.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/hooks.ts"],
-  "sourcesContent": ["import type { JsonValue, NetworkSandboxSessionIface } from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { authoredRecordSchema, isCallable, type AuthoredValue } from \"../runtime/values.mjs\";\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport type {\n  AgentSessionInfoIface,\n  FinalPlatformClientIface,\n  SecretsIface,\n  TranscriptMessageIface,\n} from \"./context.mjs\";\nimport type { ToolCallEventDataIface } from \"./tools.mjs\";\n\nexport { toolResultFrom } from \"./tools.mjs\";\n\n// Observe-only subscribers to the session's ACP log. Event\n// names are ACP update kinds and request methods plus a few session-service\n// lifecycle events. Only these canonical names are accepted.\n\nexport enum HookEvent {\n  SessionOpened = 'session.opened',\n  TurnStarted = 'turn.started',\n  TurnEnded = 'turn.ended',\n  UserMessageChunk = 'user_message_chunk',\n  AgentMessageChunk = 'agent_message_chunk',\n  AgentMessage = 'agent_message',\n  AgentThoughtChunk = 'agent_thought_chunk',\n  ToolCall = 'tool_call',\n  ToolCallUpdate = 'tool_call_update',\n  ToolCallContentChunk = 'tool_call_content_chunk',\n  Plan = 'plan',\n  PendingCreated = 'pending.created',\n  PendingResolved = 'pending.resolved',\n  StateUpdate = 'state_update',\n  SessionFailed = 'session.failed',\n  SessionClosed = 'session.closed',\n  CompactionUpdate = 'compaction_update',\n  UsageUpdate = 'usage_update',\n  AvailableCommandsUpdate = 'available_commands_update',\n  CurrentModeUpdate = 'current_mode_update',\n  ConfigOptionUpdate = 'config_option_update',\n  SessionInfoUpdate = 'session_info_update',\n  Notice = 'notice',\n}\n\nexport const HOOK_WILDCARD = '*';\n\nconst CANONICAL_EVENTS: ReadonlySet<string> = new Set(Object.values(HookEvent));\n\nexport enum HookEventKeyKind {\n  Canonical = 'canonical',\n  Wildcard = 'wildcard',\n  Unknown = 'unknown',\n}\n\nexport interface NormalizedHookKeyIface {\n  key: string;\n  kind: HookEventKeyKind;\n  // Canonical event names this key subscribes to ('*' for the wildcard).\n  events: string[];\n}\n\nexport const normalizeHookKey = (key: string): NormalizedHookKeyIface => {\n  if (key === HOOK_WILDCARD)\n    return { key, kind: HookEventKeyKind.Wildcard, events: [HOOK_WILDCARD] };\n  if (CANONICAL_EVENTS.has(key) || key.startsWith('_final/')) {\n    return { key, kind: HookEventKeyKind.Canonical, events: [key] };\n  }\n  return { key, kind: HookEventKeyKind.Unknown, events: [] };\n};\n\nexport interface HookEventMetaIface {\n  // '<sessionId>:<seq>' with the session's wire id (`ases_\u2026:12`): sortable\n  // within a session and stable across redelivery.\n  id: string;\n  at: string;\n  seq: number;\n}\n\nexport interface HookEventIface<TType extends string = string, TData = AuthoredValue> {\n  type: TType;\n  data: TData;\n  meta: HookEventMetaIface;\n}\n\n// Lifecycle event data names platform objects by their wire ids, as the public\n// API does: sessions `ases_\u2026`, turns `atrn_\u2026`, participants `cpart_\u2026`, pending\n// requests `apnd_\u2026`. `promptMessageId` is the harness's ACP message id. ACP\n// update events (tool_call, agent_message_chunk, \u2026) carry the ACP payload as is.\nexport interface HookEventDataMapIface {\n  'session.opened': { sessionId: string };\n  'turn.started': {\n    turnId: string;\n    promptMessageId: string | null;\n    authorParticipantId: string | null;\n  };\n  'turn.ended': { turnId: string; stopReason: string | null };\n  tool_call: ToolCallEventDataIface;\n  tool_call_update: ToolCallEventDataIface;\n  tool_call_content_chunk: ToolCallEventDataIface;\n  'pending.created': {\n    pendingId: string;\n    kind: 'permission' | 'elicitation' | 'authorization';\n    request: JsonValue;\n  };\n  'pending.resolved': { pendingId: string; outcome: JsonValue };\n  'session.failed': { reason: string | null };\n  'session.closed': { reason: string | null };\n}\n\ntype CanonicalData<TKey extends string> = TKey extends keyof HookEventDataMapIface\n  ? HookEventDataMapIface[TKey]\n  : Record<string, JsonValue>;\n\nexport type HookEventKey = `${HookEvent}` | typeof HOOK_WILDCARD | `_final/${string}`;\n\nexport type HookEventFor<TKey extends string> = TKey extends typeof HOOK_WILDCARD\n  ? HookEventIface\n  : HookEventIface<TKey, CanonicalData<TKey>>;\n\nexport interface HookSessionInfoIface extends AgentSessionInfoIface {\n  readonly messages: readonly TranscriptMessageIface[];\n}\n\nexport interface HookContextIface {\n  readonly session: HookSessionInfoIface;\n  readonly agent: {\n    readonly definitionId: string;\n    readonly name: string;\n    readonly revisionId: string;\n  };\n  readonly channel: { readonly kind: string | null };\n  getSandbox(target?: string): Promise<NetworkSandboxSessionIface>;\n  // Sends session/cancel for the running turn.\n  cancel(): void;\n  readonly secrets: SecretsIface;\n  readonly final: FinalPlatformClientIface;\n}\n\nexport type HookHandler<TKey extends string> = (\n  event: HookEventFor<TKey>,\n  ctx: HookContextIface,\n) => void | Promise<void>;\n\nexport type HookHandlersIface = { readonly [TKey in HookEventKey]?: HookHandler<TKey> };\n\nexport interface HookDefinitionIface {\n  readonly events?: HookHandlersIface;\n}\n\nexport const defineHook = (definition: HookDefinitionIface): HookDefinitionIface =>\n  stamp({ ...definition }, AuthoredKind.Hook);\n\nexport interface HookDispatchEventIface {\n  type: string;\n  data: AuthoredValue;\n  meta: HookEventMetaIface;\n}\n\nconst keyMatches = (key: string, event: HookDispatchEventIface): boolean =>\n  key === event.type && (CANONICAL_EVENTS.has(key) || key.startsWith('_final/'));\n\nexport type HookInvocable = (event: HookDispatchEventIface, ctx: HookContextIface) => AuthoredValue;\n\nconst hookEventsSchema = z.looseObject({ events: authoredRecordSchema });\n\n// Handlers for one event: typed handlers in declaration order, then the\n// wildcard.\nexport const hookHandlersFor = (\n  hook: AuthoredValue,\n  event: HookDispatchEventIface,\n): HookInvocable[] => {\n  const parsed = hookEventsSchema.safeParse(hook);\n  if (!parsed.success) return [];\n  const typed: HookInvocable[] = [];\n  let wildcard: HookInvocable | null = null;\n  for (const [key, handler] of Object.entries(parsed.data.events)) {\n    if (!isCallable(handler)) continue;\n    const invoke: HookInvocable = (dispatched, ctx) => handler(dispatched, ctx);\n    if (key === HOOK_WILDCARD) wildcard = invoke;\n    else if (keyMatches(key, event)) typed.push(invoke);\n  }\n  return wildcard == null ? typed : [...typed, wildcard];\n};\n"],
-  "mappings": "AACA,YAAY,OAAO;AACnB,SAAS,sBAAsB,kBAAsC;AACrE,SAAS,cAAc,aAAa;AASpC,SAAS,sBAAsB;AAMxB,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,6BAA0B;AAC1B,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,YAAS;AAvBC,SAAAA;AAAA,GAAA;AA0BL,MAAM,gBAAgB;AAE7B,MAAM,mBAAwC,IAAI,IAAI,OAAO,OAAO,SAAS,CAAC;AAEvE,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,aAAU;AAHA,SAAAA;AAAA,GAAA;AAaL,MAAM,mBAAmB,CAAC,QAAwC;AACvE,MAAI,QAAQ;AACV,WAAO,EAAE,KAAK,MAAM,2BAA2B,QAAQ,CAAC,aAAa,EAAE;AACzE,MAAI,iBAAiB,IAAI,GAAG,KAAK,IAAI,WAAW,SAAS,GAAG;AAC1D,WAAO,EAAE,KAAK,MAAM,6BAA4B,QAAQ,CAAC,GAAG,EAAE;AAAA,EAChE;AACA,SAAO,EAAE,KAAK,MAAM,yBAA0B,QAAQ,CAAC,EAAE;AAC3D;AAiFO,MAAM,aAAa,CAAC,eACzB,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,IAAI;AAQ5C,MAAM,aAAa,CAAC,KAAa,UAC/B,QAAQ,MAAM,SAAS,iBAAiB,IAAI,GAAG,KAAK,IAAI,WAAW,SAAS;AAI9E,MAAM,mBAAmB,EAAE,YAAY,EAAE,QAAQ,qBAAqB,CAAC;AAIhE,MAAM,kBAAkB,CAC7B,MACA,UACoB;AACpB,QAAM,SAAS,iBAAiB,UAAU,IAAI;AAC9C,MAAI,CAAC,OAAO,QAAS,QAAO,CAAC;AAC7B,QAAM,QAAyB,CAAC;AAChC,MAAI,WAAiC;AACrC,aAAW,CAAC,KAAK,OAAO,KAAK,OAAO,QAAQ,OAAO,KAAK,MAAM,GAAG;AAC/D,QAAI,CAAC,WAAW,OAAO,EAAG;AAC1B,UAAM,SAAwB,CAAC,YAAY,QAAQ,QAAQ,YAAY,GAAG;AAC1E,QAAI,QAAQ,cAAe,YAAW;AAAA,aAC7B,WAAW,KAAK,KAAK,EAAG,OAAM,KAAK,MAAM;AAAA,EACpD;AACA,SAAO,YAAY,OAAO,QAAQ,CAAC,GAAG,OAAO,QAAQ;AACvD;",
+  "sourcesContent": ["import type {\n  HostedBindingsIface,\n  JsonValue,\n  NetworkSandboxSessionIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { authoredRecordSchema, isCallable, type AuthoredValue } from \"../runtime/values.mjs\";\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport type {\n  AgentSessionInfoIface,\n  FinalPlatformClientIface,\n  SecretsIface,\n  TranscriptMessageIface,\n} from \"./context.mjs\";\nimport type { ToolCallEventDataIface } from \"./tools.mjs\";\n\nexport { toolResultFrom } from \"./tools.mjs\";\n\n// Observe-only subscribers to the session's ACP log. Event\n// names are ACP update kinds and request methods plus a few session-service\n// lifecycle events. Only these canonical names are accepted.\n\nexport enum HookEvent {\n  SessionOpened = 'session.opened',\n  TurnStarted = 'turn.started',\n  TurnEnded = 'turn.ended',\n  UserMessageChunk = 'user_message_chunk',\n  AgentMessageChunk = 'agent_message_chunk',\n  AgentMessage = 'agent_message',\n  AgentThoughtChunk = 'agent_thought_chunk',\n  ToolCall = 'tool_call',\n  ToolCallUpdate = 'tool_call_update',\n  ToolCallContentChunk = 'tool_call_content_chunk',\n  Plan = 'plan',\n  PendingCreated = 'pending.created',\n  PendingResolved = 'pending.resolved',\n  StateUpdate = 'state_update',\n  SessionFailed = 'session.failed',\n  SessionClosed = 'session.closed',\n  CompactionUpdate = 'compaction_update',\n  UsageUpdate = 'usage_update',\n  AvailableCommandsUpdate = 'available_commands_update',\n  CurrentModeUpdate = 'current_mode_update',\n  ConfigOptionUpdate = 'config_option_update',\n  SessionInfoUpdate = 'session_info_update',\n  Notice = 'notice',\n}\n\nexport const HOOK_WILDCARD = '*';\n\nconst CANONICAL_EVENTS: ReadonlySet<string> = new Set(Object.values(HookEvent));\n\nexport enum HookEventKeyKind {\n  Canonical = 'canonical',\n  Wildcard = 'wildcard',\n  Unknown = 'unknown',\n}\n\nexport interface NormalizedHookKeyIface {\n  key: string;\n  kind: HookEventKeyKind;\n  // Canonical event names this key subscribes to ('*' for the wildcard).\n  events: string[];\n}\n\nexport const normalizeHookKey = (key: string): NormalizedHookKeyIface => {\n  if (key === HOOK_WILDCARD)\n    return { key, kind: HookEventKeyKind.Wildcard, events: [HOOK_WILDCARD] };\n  if (CANONICAL_EVENTS.has(key) || key.startsWith('_final/')) {\n    return { key, kind: HookEventKeyKind.Canonical, events: [key] };\n  }\n  return { key, kind: HookEventKeyKind.Unknown, events: [] };\n};\n\nexport interface HookEventMetaIface {\n  // '<sessionId>:<seq>' with the session's wire id (`ases_\u2026:12`): sortable\n  // within a session and stable across redelivery.\n  id: string;\n  at: string;\n  seq: number;\n}\n\nexport interface HookEventIface<TType extends string = string, TData = AuthoredValue> {\n  type: TType;\n  data: TData;\n  meta: HookEventMetaIface;\n}\n\n// Lifecycle event data names platform objects by their wire ids, as the public\n// API does: sessions `ases_\u2026`, turns `atrn_\u2026`, participants `cpart_\u2026`, pending\n// requests `apnd_\u2026`. `promptMessageId` is the harness's ACP message id. ACP\n// update events (tool_call, agent_message_chunk, \u2026) carry the ACP payload as is.\nexport interface HookEventDataMapIface {\n  'session.opened': { sessionId: string };\n  'turn.started': {\n    turnId: string;\n    promptMessageId: string | null;\n    authorParticipantId: string | null;\n  };\n  'turn.ended': { turnId: string; stopReason: string | null };\n  tool_call: ToolCallEventDataIface;\n  tool_call_update: ToolCallEventDataIface;\n  tool_call_content_chunk: ToolCallEventDataIface;\n  'pending.created': {\n    pendingId: string;\n    kind: 'permission' | 'elicitation' | 'authorization';\n    request: JsonValue;\n  };\n  'pending.resolved': { pendingId: string; outcome: JsonValue };\n  'session.failed': { reason: string | null };\n  'session.closed': { reason: string | null };\n}\n\ntype CanonicalData<TKey extends string> = TKey extends keyof HookEventDataMapIface\n  ? HookEventDataMapIface[TKey]\n  : Record<string, JsonValue>;\n\nexport type HookEventKey = `${HookEvent}` | typeof HOOK_WILDCARD | `_final/${string}`;\n\nexport type HookEventFor<TKey extends string> = TKey extends typeof HOOK_WILDCARD\n  ? HookEventIface\n  : HookEventIface<TKey, CanonicalData<TKey>>;\n\nexport interface HookSessionInfoIface extends AgentSessionInfoIface {\n  readonly messages: readonly TranscriptMessageIface[];\n}\n\nexport interface HookContextIface {\n  readonly session: HookSessionInfoIface;\n  readonly agent: {\n    readonly definitionId: string;\n    readonly name: string;\n    readonly revisionId: string;\n  };\n  readonly channel: { readonly kind: string | null };\n  getSandbox(target?: string): Promise<NetworkSandboxSessionIface>;\n  // Sends session/cancel for the running turn.\n  cancel(): void;\n  readonly secrets: SecretsIface;\n  readonly bindings?: HostedBindingsIface;\n  readonly final: FinalPlatformClientIface;\n}\n\nexport type HookHandler<TKey extends string> = (\n  event: HookEventFor<TKey>,\n  ctx: HookContextIface,\n) => void | Promise<void>;\n\nexport type HookHandlersIface = { readonly [TKey in HookEventKey]?: HookHandler<TKey> };\n\nexport interface HookDefinitionIface {\n  readonly events?: HookHandlersIface;\n}\n\nexport const defineHook = (definition: HookDefinitionIface): HookDefinitionIface =>\n  stamp({ ...definition }, AuthoredKind.Hook);\n\nexport interface HookDispatchEventIface {\n  type: string;\n  data: AuthoredValue;\n  meta: HookEventMetaIface;\n}\n\nconst keyMatches = (key: string, event: HookDispatchEventIface): boolean =>\n  key === event.type && (CANONICAL_EVENTS.has(key) || key.startsWith('_final/'));\n\nexport type HookInvocable = (event: HookDispatchEventIface, ctx: HookContextIface) => AuthoredValue;\n\nconst hookEventsSchema = z.looseObject({ events: authoredRecordSchema });\n\n// Handlers for one event: typed handlers in declaration order, then the\n// wildcard.\nexport const hookHandlersFor = (\n  hook: AuthoredValue,\n  event: HookDispatchEventIface,\n): HookInvocable[] => {\n  const parsed = hookEventsSchema.safeParse(hook);\n  if (!parsed.success) return [];\n  const typed: HookInvocable[] = [];\n  let wildcard: HookInvocable | null = null;\n  for (const [key, handler] of Object.entries(parsed.data.events)) {\n    if (!isCallable(handler)) continue;\n    const invoke: HookInvocable = (dispatched, ctx) => handler(dispatched, ctx);\n    if (key === HOOK_WILDCARD) wildcard = invoke;\n    else if (keyMatches(key, event)) typed.push(invoke);\n  }\n  return wildcard == null ? typed : [...typed, wildcard];\n};\n"],
+  "mappings": "AAKA,YAAY,OAAO;AACnB,SAAS,sBAAsB,kBAAsC;AACrE,SAAS,cAAc,aAAa;AASpC,SAAS,sBAAsB;AAMxB,IAAK,YAAL,kBAAKA,eAAL;AACL,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,eAAY;AACZ,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,kBAAe;AACf,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,cAAW;AACX,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,0BAAuB;AACvB,EAAAA,WAAA,UAAO;AACP,EAAAA,WAAA,oBAAiB;AACjB,EAAAA,WAAA,qBAAkB;AAClB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,mBAAgB;AAChB,EAAAA,WAAA,sBAAmB;AACnB,EAAAA,WAAA,iBAAc;AACd,EAAAA,WAAA,6BAA0B;AAC1B,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,wBAAqB;AACrB,EAAAA,WAAA,uBAAoB;AACpB,EAAAA,WAAA,YAAS;AAvBC,SAAAA;AAAA,GAAA;AA0BL,MAAM,gBAAgB;AAE7B,MAAM,mBAAwC,IAAI,IAAI,OAAO,OAAO,SAAS,CAAC;AAEvE,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,aAAU;AAHA,SAAAA;AAAA,GAAA;AAaL,MAAM,mBAAmB,CAAC,QAAwC;AACvE,MAAI,QAAQ;AACV,WAAO,EAAE,KAAK,MAAM,2BAA2B,QAAQ,CAAC,aAAa,EAAE;AACzE,MAAI,iBAAiB,IAAI,GAAG,KAAK,IAAI,WAAW,SAAS,GAAG;AAC1D,WAAO,EAAE,KAAK,MAAM,6BAA4B,QAAQ,CAAC,GAAG,EAAE;AAAA,EAChE;AACA,SAAO,EAAE,KAAK,MAAM,yBAA0B,QAAQ,CAAC,EAAE;AAC3D;AAkFO,MAAM,aAAa,CAAC,eACzB,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,IAAI;AAQ5C,MAAM,aAAa,CAAC,KAAa,UAC/B,QAAQ,MAAM,SAAS,iBAAiB,IAAI,GAAG,KAAK,IAAI,WAAW,SAAS;AAI9E,MAAM,mBAAmB,EAAE,YAAY,EAAE,QAAQ,qBAAqB,CAAC;AAIhE,MAAM,kBAAkB,CAC7B,MACA,UACoB;AACpB,QAAM,SAAS,iBAAiB,UAAU,IAAI;AAC9C,MAAI,CAAC,OAAO,QAAS,QAAO,CAAC;AAC7B,QAAM,QAAyB,CAAC;AAChC,MAAI,WAAiC;AACrC,aAAW,CAAC,KAAK,OAAO,KAAK,OAAO,QAAQ,OAAO,KAAK,MAAM,GAAG;AAC/D,QAAI,CAAC,WAAW,OAAO,EAAG;AAC1B,UAAM,SAAwB,CAAC,YAAY,QAAQ,QAAQ,YAAY,GAAG;AAC1E,QAAI,QAAQ,cAAe,YAAW;AAAA,aAC7B,WAAW,KAAK,KAAK,EAAG,OAAM,KAAK,MAAM;AAAA,EACpD;AACA,SAAO,YAAY,OAAO,QAAQ,CAAC,GAAG,OAAO,QAAQ;AACvD;",
   "names": ["HookEvent", "HookEventKeyKind"]
 }

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

@@ -4,9 +4,11 @@ export { always, never, whenInput } from "./approval.mjs";
 export type { ApprovalPolicyIface } from "./approval.mjs";
 export { DELETE, GET, POST, PUT, WS, defineChannel, defineProviderChannel, disableChannel, } from "./channels.mjs";
 export type { AuthoredChannelDefinitionIface, RouteHandler, RouteHandlerArgsIface, } from "./channels.mjs";
-export { defineMcpClientConnection } from "./connections.mjs";
-export type { McpClientConnectionDefinitionIface, McpConnectionAuthIface } from "./connections.mjs";
+export { defineHostedConnection, defineMcpClientConnection } from "./connections.mjs";
+export type { HostedConnectionDefinitionIface, McpClientConnectionDefinitionIface, McpConnectionAuthIface, } from "./connections.mjs";
 export * from "./context.mjs";
+export { requireHostedBinding } from '@finalai/agent-provider';
+export type { HostedBindingsIface } from '@finalai/agent-provider';
 export { CredentialOwner, CredentialPayer, credentials } from "./credentials.mjs";
 export type { CredentialNode, CredentialPolicyIface } from "./credentials.mjs";
 export { defineDynamic } from "./dynamic.mjs";

package/dist/modules/authoring/index.mjs

@@ -10,8 +10,9 @@ import {
   defineProviderChannel,
   disableChannel
 } from "./channels.mjs";
-import { defineMcpClientConnection } from "./connections.mjs";
+import { defineHostedConnection, defineMcpClientConnection } from "./connections.mjs";
 export * from "./context.mjs";
+import { requireHostedBinding } from "@finalai/agent-provider";
 import { CredentialOwner, CredentialPayer, credentials } from "./credentials.mjs";
 import { defineDynamic } from "./dynamic.mjs";
 import { completeHarnessDescription, defineHarness } from "./harness.mjs";
@@ -46,6 +47,7 @@ export {
   defineDynamic,
   defineHarness,
   defineHook,
+  defineHostedConnection,
   defineInstructions,
   defineMcpClientConnection,
   defineProviderChannel,
@@ -57,6 +59,7 @@ export {
   disableChannel,
   harnessHost,
   never,
+  requireHostedBinding,
   toolResultFrom,
   whenInput
 };