@finalai/agent-definition 0.1.2 → 0.1.4

package/dist/compiler-assets/src/hosted-bindings.ts

@@ -0,0 +1,15 @@
+import {
+  validateHostedBindingRequirements,
+  validateHostedBindings
+} from "../chunk-ULI5WWRR.ts";
+import "../chunk-W6DOJA4W.ts";
+import "../chunk-7WGYG73V.ts";
+import "../chunk-MSE7X5YG.ts";
+import "../chunk-4X2DS5BR.ts";
+import "../chunk-TM36NO3C.ts";
+import "../chunk-3K4C4SVG.ts";
+import "../chunk-32O3ODZE.ts";
+export {
+  validateHostedBindingRequirements,
+  validateHostedBindings
+};

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

@@ -5,54 +5,68 @@ import {
   resolveManifestDetailed,
   slotKindOf,
   validateSlotValue
-} from "../chunk-EVQIK62B.ts";
+} from "../chunk-YW7HDGQA.ts";
 import {
   AGENT_DYNAMIC_PREFIX,
   AUTHORED_SERVER_KEY,
   COMBINED_MCP_SERVERS_EXPORT
 } from "../chunk-NMYHO2QN.ts";
-import "../chunk-6WR3PGNF.ts";
+import "../chunk-RMIQJHSL.ts";
 import {
   completeHarnessDescription,
   defineHarness
-} from "../chunk-QMKWAFVZ.ts";
+} from "../chunk-Z5TO7RSJ.ts";
 import {
   HookEvent,
   defineHook
-} from "../chunk-QMWTDPNT.ts";
+} from "../chunk-TJZS457N.ts";
 import {
   defineInstructions
-} from "../chunk-VHXHUU7L.ts";
+} from "../chunk-LHMUAIYJ.ts";
 import {
   baseTools,
   defineSandbox,
   defineSandboxProvider,
   harnessHost
-} from "../chunk-LUSAAV4L.ts";
-import "../chunk-CWWRTRWW.ts";
+} from "../chunk-IZGOMT7K.ts";
+import "../chunk-4E5HECVD.ts";
 import {
   SandboxWire
-} from "../chunk-JPY4L2UJ.ts";
+} from "../chunk-RIEMTCTV.ts";
 import {
   defineSchedule
-} from "../chunk-GTUZOATD.ts";
+} from "../chunk-JGQ2KAN7.ts";
 import {
   defineSkill
-} from "../chunk-HFS4KLEL.ts";
+} from "../chunk-D3SB4CCB.ts";
 import {
   defineTool,
   toolResultFrom
-} from "../chunk-TATN3PYK.ts";
-import "../chunk-GNR7XBPN.ts";
-import "../chunk-7WGYG73V.ts";
+} from "../chunk-2ZRYQO4Q.ts";
 import {
   defineAgent
-} from "../chunk-2CZRHOLL.ts";
+} from "../chunk-7XUPKRZU.ts";
 import {
   always,
   never,
   whenInput
-} from "../chunk-7VSSVZM4.ts";
+} from "../chunk-4A66SVBJ.ts";
+import {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  WS,
+  defineChannel,
+  defineProviderChannel,
+  disableChannel
+} from "../chunk-K7V4IMOB.ts";
+import "../chunk-IF6MR7JF.ts";
+import {
+  defineHostedConnection,
+  defineMcpClientConnection
+} from "../chunk-TJ536HI4.ts";
+import "../chunk-CIWWFQHL.ts";
 import {
   BaseCapability,
   InstructionRole,
@@ -62,7 +76,9 @@ import {
   SandboxAttach,
   ScheduleTarget,
   ToolApproval,
+  agentAvatarSchema,
   agentManifestSchema,
+  avatarMediaSchema,
   baseToolsSchema,
   bundleSchema,
   channelBindingSchema,
@@ -81,44 +97,36 @@ import {
   skillFileSchema,
   toolDescriptorSchema,
   workerMcpServerBindingSchema
-} from "../chunk-OWC6SFFF.ts";
-import {
-  DELETE,
-  GET,
-  POST,
-  PUT,
-  WS,
-  defineChannel,
-  defineProviderChannel,
-  disableChannel
-} from "../chunk-WMXMVFHM.ts";
-import "../chunk-5BK6FVRE.ts";
-import "../chunk-7QP2CKPI.ts";
-import {
-  defineMcpClientConnection
-} from "../chunk-JNJE72EH.ts";
+} from "../chunk-APU2VKLW.ts";
 import {
   TranscriptRole
 } from "../chunk-RWUIMTBI.ts";
 import {
   credentials
-} from "../chunk-NYTOYKKF.ts";
+} from "../chunk-K6D7ZK74.ts";
 import {
   CredentialOwner,
   CredentialPayer
-} from "../chunk-HNPUTP35.ts";
+} from "../chunk-GCFSHHH2.ts";
+import {
+  defineDynamic
+} from "../chunk-PFLSBTJA.ts";
+import {
+  validateHostedBindings
+} from "../chunk-ULI5WWRR.ts";
+import "../chunk-W6DOJA4W.ts";
+import "../chunk-7WGYG73V.ts";
 import {
   DynamicEvent,
   dynamicSlotSchema,
   findDynamicSlots,
-  isDynamicSlot
-} from "../chunk-SKTNMUO7.ts";
-import {
-  defineDynamic
-} from "../chunk-T6WG4L4M.ts";
-import "../chunk-XHKPWT3G.ts";
-import "../chunk-JIPNTA56.ts";
-import "../chunk-HGW4YHAY.ts";
+  isDynamicSlot,
+  requireHostedBinding
+} from "../chunk-MSE7X5YG.ts";
+import "../chunk-4X2DS5BR.ts";
+import "../chunk-QJ26GEUM.ts";
+import "../chunk-TM36NO3C.ts";
+import "../chunk-3K4C4SVG.ts";
 import "../chunk-32O3ODZE.ts";
 export {
   AGENT_DYNAMIC_PREFIX,
@@ -144,8 +152,10 @@ export {
   ToolApproval,
   TranscriptRole,
   WS,
+  agentAvatarSchema,
   agentManifestSchema,
   always,
+  avatarMediaSchema,
   baseTools,
   baseToolsSchema,
   bundleSchema,
@@ -157,6 +167,7 @@ export {
   defineDynamic,
   defineHarness,
   defineHook,
+  defineHostedConnection,
   defineInstructions,
   defineMcpClientConnection,
   defineProviderChannel,
@@ -179,6 +190,7 @@ export {
   mcpAuthSchema,
   mcpServerBindingSchema,
   never,
+  requireHostedBinding,
   resolveManifest,
   resolveManifestDetailed,
   resolvedAgentManifestSchema,
@@ -189,6 +201,7 @@ export {
   slotKindOf,
   toolDescriptorSchema,
   toolResultFrom,
+  validateHostedBindings,
   validateSlotValue,
   whenInput,
   workerMcpServerBindingSchema

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

@@ -8,7 +8,9 @@ import {
   SandboxAttach,
   ScheduleTarget,
   ToolApproval,
+  agentAvatarSchema,
   agentManifestSchema,
+  avatarMediaSchema,
   baseToolsSchema,
   bundleSchema,
   channelBindingSchema,
@@ -27,15 +29,15 @@ import {
   skillFileSchema,
   toolDescriptorSchema,
   workerMcpServerBindingSchema
-} from "../chunk-OWC6SFFF.ts";
-import "../chunk-7QP2CKPI.ts";
+} from "../chunk-APU2VKLW.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,
@@ -47,7 +49,9 @@ export {
   SandboxAttach,
   ScheduleTarget,
   ToolApproval,
+  agentAvatarSchema,
   agentManifestSchema,
+  avatarMediaSchema,
   baseToolsSchema,
   bundleSchema,
   channelBindingSchema,

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-YW7HDGQA.ts";
+import "../chunk-APU2VKLW.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-YWFGIPHD.ts";
 import {
   describeBundle,
   needsCombinedMcpServers,
   synthesizedExports
-} from "../../chunk-MZMSKIKU.ts";
-import {
-  combineMcpServers,
-  createIsolateRuntime
-} from "../../chunk-BLB6JGLO.ts";
-import "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-UBR53WBH.ts";
+import "../../chunk-5NTKRRMC.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-4A66SVBJ.ts";
+import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-APU2VKLW.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-UBR53WBH.ts";
+import "../../chunk-5NTKRRMC.ts";
 import {
   COMBINED_MCP_SERVERS_EXPORT
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-4A66SVBJ.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-APU2VKLW.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,27 @@
 import {
   IssueSeverity
-} from "../../chunk-ZDLVA6XF.ts";
+} from "../../chunk-5NTKRRMC.ts";
 import {
   SlotKind
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-TATN3PYK.ts";
-import "../../chunk-GNR7XBPN.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-4A66SVBJ.ts";
+import "../../chunk-CIWWFQHL.ts";
+import {
+  agentAvatarSchema
+} from "../../chunk-APU2VKLW.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 +31,7 @@ import {
   object,
   record,
   string
-} from "../../chunk-HGW4YHAY.ts";
+} from "../../chunk-3K4C4SVG.ts";
 import "../../chunk-32O3ODZE.ts";
 
 // src/runtime/described.ts
@@ -39,13 +45,14 @@ var describedDynamicSchema = object({
   events: array(string()),
   description: string().nullable(),
   preview: string().nullable(),
+  requiredBindings: array(hostedBindingRequirementSchema).optional(),
   provider: providerHintSchema.nullable()
 });
 var describedAgentSchema = object({
   type: literal("agent"),
   name: string().nullable(),
   description: string().nullable(),
-  avatarUrl: string().nullable(),
+  avatar: agentAvatarSchema.nullable().default(null),
   harness: object({ harness: jsonValueSchema, config: jsonValueSchema }).nullable(),
   tools: record(string(), string()).nullable(),
   // Capabilities bound to `harnessHost` (the harness's own host, no target).

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-YWFGIPHD.ts";
+import "../../chunk-5NTKRRMC.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-4A66SVBJ.ts";
+import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-APU2VKLW.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-5NTKRRMC.ts";
+import "../../chunk-2ZRYQO4Q.ts";
+import "../../chunk-4A66SVBJ.ts";
+import "../../chunk-CIWWFQHL.ts";
+import "../../chunk-APU2VKLW.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/agent.d.mts

@@ -1,4 +1,4 @@
-import type { JsonObject, ProviderRef, ToolApproval } from '@finalai/agent-provider';
+import type { AgentAvatarIface, JsonObject, ProviderRef, ToolApproval } from '@finalai/agent-provider';
 import type { BaseToolsValueIface } from "./sandbox.mjs";
 export interface HarnessBindingValueIface {
     readonly harness: ProviderRef;
@@ -12,7 +12,8 @@ export interface ChannelBindingValueIface {
 export interface AgentDefinitionInputIface {
     readonly name?: string;
     readonly description?: string;
-    readonly avatarUrl?: string;
+    /** Static avatar and optional state artwork. */
+    readonly avatar?: AgentAvatarIface;
     readonly harness: HarnessBindingValueIface;
     readonly tools?: BaseToolsValueIface;
     readonly toolPolicy?: Readonly<Record<string, ToolApproval | `${ToolApproval}`>>;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/agent.ts"],
-  "sourcesContent": ["import type { JsonObject, ProviderRef, ToolApproval } from '@finalai/agent-provider';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport type { BaseToolsValueIface } from \"./sandbox.mjs\";\n\n// A harness binding as authoring helpers produce it: an installed harness\n// helper (`serverlessPi({...})`), a defineHarness result, or a literal.\nexport interface HarnessBindingValueIface {\n  readonly harness: ProviderRef;\n  readonly config: unknown;\n}\n\nexport interface ChannelBindingValueIface {\n  readonly channel: ProviderRef;\n  readonly config?: JsonObject;\n  readonly key?: string;\n}\n\n// agent.ts. The agent names its harness; everything\n// the harness has an opinion about (model, reasoning, credentials, permission\n// mode, instructions, skills) lives in `harness.config`.\nexport interface AgentDefinitionInputIface {\n  readonly name?: string;\n  readonly description?: string;\n  readonly avatarUrl?: string;\n  readonly harness: HarnessBindingValueIface;\n  // Base tool capabilities bound to sandbox targets; none unless declared.\n  readonly tools?: BaseToolsValueIface;\n  // Extra approval policy for MCP tools (`<server>/<tool>`) and base\n  // capabilities (`shell`, `files.write`).\n  readonly toolPolicy?: Readonly<Record<string, ToolApproval | `${ToolApproval}`>>;\n  // Organization secrets this agent's code may read with `ctx.secrets.get(name)`\n  // (tools, hooks, resolvers, channel routes). Names referenced elsewhere in the\n  // definition (connection `auth.secretKey`, `credentials.apiKey({ secret })`)\n  // are added by the compiler; any other secret must be listed here, or reading\n  // it fails at run time.\n  readonly secrets?: readonly string[];\n  // Installed channels (custom channels are files under channels/).\n  readonly channels?: readonly ChannelBindingValueIface[];\n}\n\nexport const defineAgent = <TAgent extends AgentDefinitionInputIface>(definition: TAgent): TAgent =>\n  stamp({ ...definition }, AuthoredKind.Agent);\n"],
-  "mappings": "AACA,SAAS,cAAc,aAAa;AAuC7B,MAAM,cAAc,CAA2C,eACpE,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,KAAK;",
+  "sourcesContent": ["import type {\n  AgentAvatarIface,\n  JsonObject,\n  ProviderRef,\n  ToolApproval,\n} from '@finalai/agent-provider';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\nimport type { BaseToolsValueIface } from \"./sandbox.mjs\";\n\n// A harness binding as authoring helpers produce it: an installed harness\n// helper (`serverlessPi({...})`), a defineHarness result, or a literal.\nexport interface HarnessBindingValueIface {\n  readonly harness: ProviderRef;\n  readonly config: unknown;\n}\n\nexport interface ChannelBindingValueIface {\n  readonly channel: ProviderRef;\n  readonly config?: JsonObject;\n  readonly key?: string;\n}\n\n// agent.ts. The agent names its harness; everything\n// the harness has an opinion about (model, reasoning, credentials, permission\n// mode, instructions, skills) lives in `harness.config`.\nexport interface AgentDefinitionInputIface {\n  readonly name?: string;\n  readonly description?: string;\n  /** Static avatar and optional state artwork. */\n  readonly avatar?: AgentAvatarIface;\n  readonly harness: HarnessBindingValueIface;\n  // Base tool capabilities bound to sandbox targets; none unless declared.\n  readonly tools?: BaseToolsValueIface;\n  // Extra approval policy for MCP tools (`<server>/<tool>`) and base\n  // capabilities (`shell`, `files.write`).\n  readonly toolPolicy?: Readonly<Record<string, ToolApproval | `${ToolApproval}`>>;\n  // Organization secrets this agent's code may read with `ctx.secrets.get(name)`\n  // (tools, hooks, resolvers, channel routes). Names referenced elsewhere in the\n  // definition (connection `auth.secretKey`, `credentials.apiKey({ secret })`)\n  // are added by the compiler; any other secret must be listed here, or reading\n  // it fails at run time.\n  readonly secrets?: readonly string[];\n  // Installed channels (custom channels are files under channels/).\n  readonly channels?: readonly ChannelBindingValueIface[];\n}\n\nexport const defineAgent = <TAgent extends AgentDefinitionInputIface>(definition: TAgent): TAgent =>\n  stamp({ ...definition }, AuthoredKind.Agent);\n"],
+  "mappings": "AAMA,SAAS,cAAc,aAAa;AAwC7B,MAAM,cAAc,CAA2C,eACpE,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,KAAK;",
   "names": []
 }

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

@@ -1,14 +1,23 @@
 import type { ApprovalPolicyIface } from "./approval.mjs";
+import { type DynamicSentinelIface } from "./dynamic.mjs";
 export type McpConnectionAuthIface = {
     readonly secretKey: string;
     readonly headerName: string | null;
 } | {
     readonly kind: 'final-session';
 };
+export interface McpToolAnnotationSelectorIface {
+    readonly readOnlyHint?: boolean;
+    readonly destructiveHint?: boolean;
+    readonly idempotentHint?: boolean;
+    readonly openWorldHint?: boolean;
+}
+export type McpToolSelector = string | McpToolAnnotationSelectorIface;
 export interface McpConnectionToolsIface {
-    readonly allow?: readonly string[];
-    readonly deny?: readonly string[];
+    readonly allow?: readonly McpToolSelector[];
+    readonly deny?: readonly McpToolSelector[];
     readonly approval?: Readonly<Record<string, ApprovalPolicyIface<never>>>;
+    readonly load?: readonly string[];
 }
 export interface McpClientConnectionDefinitionIface {
     readonly url: string;
@@ -21,3 +30,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