@finalai/agent-definition 0.5.1 → 0.6.0

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

@@ -4,24 +4,24 @@ import {
   describeDynamic,
   needsCombinedMcpServers,
   synthesizedExports
-} from "../../chunk-MBX6PIN7.ts";
-import "../../chunk-GIRUQ7QF.ts";
+} from "../../chunk-FE7PIPSW.ts";
+import "../../chunk-MM4JCZSK.ts";
 import {
   COMBINED_MCP_SERVERS_EXPORT
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-4ERFBLH7.ts";
-import "../../chunk-O2JWY454.ts";
-import "../../chunk-VI5WBWUX.ts";
-import "../../chunk-EAEQQT33.ts";
-import "../../chunk-36MVFRMA.ts";
-import "../../chunk-XJNO7EHQ.ts";
-import "../../chunk-O3JKMLDP.ts";
+import "../../chunk-DRHDNSCQ.ts";
+import "../../chunk-L7YJCQVB.ts";
+import "../../chunk-MPZMRU56.ts";
+import "../../chunk-Q26ZPNVB.ts";
+import "../../chunk-IZJMGIAH.ts";
+import "../../chunk-KNYB36DW.ts";
+import "../../chunk-EKR4AEM5.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-R4IHPPTB.ts";
-import "../../chunk-FU5VHNO4.ts";
-import "../../chunk-KTBNDKGJ.ts";
-import "../../chunk-OX46N5EP.ts";
-import "../../chunk-KTXTYIF4.ts";
+import "../../chunk-UUQAHJRT.ts";
+import "../../chunk-3R7MNW5L.ts";
+import "../../chunk-JZTF36V2.ts";
+import "../../chunk-TCXQ4GLM.ts";
+import "../../chunk-4A4EQHYK.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   COMBINED_MCP_SERVERS_EXPORT,

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

@@ -1,27 +1,29 @@
 import {
   IssueSeverity
-} from "../../chunk-GIRUQ7QF.ts";
+} from "../../chunk-MM4JCZSK.ts";
 import {
   SlotKind
 } from "../../chunk-NMYHO2QN.ts";
-import "../../chunk-4ERFBLH7.ts";
-import "../../chunk-O2JWY454.ts";
-import "../../chunk-VI5WBWUX.ts";
+import "../../chunk-DRHDNSCQ.ts";
+import "../../chunk-L7YJCQVB.ts";
+import "../../chunk-MPZMRU56.ts";
 import {
-  agentAvatarSchema
-} from "../../chunk-EAEQQT33.ts";
-import "../../chunk-36MVFRMA.ts";
-import "../../chunk-XJNO7EHQ.ts";
-import "../../chunk-O3JKMLDP.ts";
+  agentAvatarSchema,
+  channelCredentialsSchema,
+  channelSurfaceSchema
+} from "../../chunk-Q26ZPNVB.ts";
+import "../../chunk-IZJMGIAH.ts";
+import "../../chunk-KNYB36DW.ts";
+import "../../chunk-EKR4AEM5.ts";
 import "../../chunk-7WGYG73V.ts";
 import {
   hostedBindingRequirementSchema
-} from "../../chunk-R4IHPPTB.ts";
+} from "../../chunk-UUQAHJRT.ts";
 import {
   jsonValueSchema
-} from "../../chunk-FU5VHNO4.ts";
-import "../../chunk-KTBNDKGJ.ts";
-import "../../chunk-OX46N5EP.ts";
+} from "../../chunk-3R7MNW5L.ts";
+import "../../chunk-JZTF36V2.ts";
+import "../../chunk-TCXQ4GLM.ts";
 import {
   array,
   boolean,
@@ -31,7 +33,7 @@ import {
   object,
   record,
   string
-} from "../../chunk-KTXTYIF4.ts";
+} from "../../chunk-4A4EQHYK.ts";
 import "../../chunk-32O3ODZE.ts";
 
 // src/runtime/described.ts
@@ -60,7 +62,14 @@ var describedAgentSchema = object({
   toolPolicy: record(string(), string()).nullable(),
   secrets: array(string()).nullable(),
   channels: array(
-    object({ key: string().nullable(), channel: jsonValueSchema, config: jsonValueSchema })
+    object({
+      key: string().nullable(),
+      channel: jsonValueSchema,
+      config: jsonValueSchema,
+      install: string().nullable(),
+      credentials: channelCredentialsSchema.nullable(),
+      surface: channelSurfaceSchema.nullable()
+    })
   ).nullable()
 });
 var describedInstructionsSchema = object({
@@ -89,7 +98,10 @@ var describedHookSchema = object({ type: literal("hook"), keys: array(string())
 var describedChannelSchema = object({
   type: literal("channel"),
   routes: array(object({ method: string(), path: string() })),
-  turnPolicy: string().nullable(),
+  room: boolean(),
+  invalidFields: array(string()).default([]),
+  credentials: channelCredentialsSchema.nullable(),
+  surface: channelSurfaceSchema,
   config: jsonValueSchema,
   disabled: boolean().default(false),
   installed: jsonValueSchema.nullable().default(null)

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

@@ -2,26 +2,25 @@ import {
   combineMcpServers,
   createIsolateRuntime,
   lowerResolvedValue
-} from "../../chunk-4T2XPIPH.ts";
-import "../../chunk-GIRUQ7QF.ts";
+} from "../../chunk-BHNF7BEJ.ts";
+import "../../chunk-MM4JCZSK.ts";
 import "../../chunk-NMYHO2QN.ts";
-import "../../chunk-KMBQVNAJ.ts";
-import "../../chunk-KNFPKVUS.ts";
-import "../../chunk-4ERFBLH7.ts";
-import "../../chunk-O2JWY454.ts";
-import "../../chunk-JRKGCYWA.ts";
-import "../../chunk-VI5WBWUX.ts";
-import "../../chunk-EAEQQT33.ts";
+import "../../chunk-AMYJRTAC.ts";
+import "../../chunk-XCX6VAK7.ts";
+import "../../chunk-DRHDNSCQ.ts";
+import "../../chunk-L7YJCQVB.ts";
+import "../../chunk-MPZMRU56.ts";
+import "../../chunk-Q26ZPNVB.ts";
 import "../../chunk-RWUIMTBI.ts";
-import "../../chunk-36MVFRMA.ts";
-import "../../chunk-XJNO7EHQ.ts";
-import "../../chunk-O3JKMLDP.ts";
+import "../../chunk-IZJMGIAH.ts";
+import "../../chunk-KNYB36DW.ts";
+import "../../chunk-EKR4AEM5.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-R4IHPPTB.ts";
-import "../../chunk-FU5VHNO4.ts";
-import "../../chunk-KTBNDKGJ.ts";
-import "../../chunk-OX46N5EP.ts";
-import "../../chunk-KTXTYIF4.ts";
+import "../../chunk-UUQAHJRT.ts";
+import "../../chunk-3R7MNW5L.ts";
+import "../../chunk-JZTF36V2.ts";
+import "../../chunk-TCXQ4GLM.ts";
+import "../../chunk-4A4EQHYK.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   combineMcpServers,

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

@@ -17,20 +17,20 @@ import {
   toJson,
   toJsonSchema,
   warning
-} from "../../chunk-GIRUQ7QF.ts";
-import "../../chunk-4ERFBLH7.ts";
-import "../../chunk-O2JWY454.ts";
-import "../../chunk-VI5WBWUX.ts";
-import "../../chunk-EAEQQT33.ts";
-import "../../chunk-36MVFRMA.ts";
-import "../../chunk-XJNO7EHQ.ts";
-import "../../chunk-O3JKMLDP.ts";
+} from "../../chunk-MM4JCZSK.ts";
+import "../../chunk-DRHDNSCQ.ts";
+import "../../chunk-L7YJCQVB.ts";
+import "../../chunk-MPZMRU56.ts";
+import "../../chunk-Q26ZPNVB.ts";
+import "../../chunk-IZJMGIAH.ts";
+import "../../chunk-KNYB36DW.ts";
+import "../../chunk-EKR4AEM5.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-R4IHPPTB.ts";
-import "../../chunk-FU5VHNO4.ts";
-import "../../chunk-KTBNDKGJ.ts";
-import "../../chunk-OX46N5EP.ts";
-import "../../chunk-KTXTYIF4.ts";
+import "../../chunk-UUQAHJRT.ts";
+import "../../chunk-3R7MNW5L.ts";
+import "../../chunk-JZTF36V2.ts";
+import "../../chunk-TCXQ4GLM.ts";
+import "../../chunk-4A4EQHYK.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-O3JKMLDP.ts";
+} from "../../chunk-EKR4AEM5.ts";
 import "../../chunk-7WGYG73V.ts";
-import "../../chunk-FU5VHNO4.ts";
-import "../../chunk-OX46N5EP.ts";
-import "../../chunk-KTXTYIF4.ts";
+import "../../chunk-3R7MNW5L.ts";
+import "../../chunk-TCXQ4GLM.ts";
+import "../../chunk-4A4EQHYK.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-OX46N5EP.ts";
-import "../../chunk-KTXTYIF4.ts";
+} from "../../chunk-TCXQ4GLM.ts";
+import "../../chunk-4A4EQHYK.ts";
 import "../../chunk-32O3ODZE.ts";
 export {
   authoredRecordSchema,

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

@@ -5,9 +5,33 @@ export interface HarnessBindingValueIface {
     readonly config: unknown;
 }
 export interface ChannelBindingValueIface {
-    readonly channel: ProviderRef;
+    readonly channel?: ProviderRef;
+    readonly installed?: ProviderRef;
+    readonly credentials?: {
+        app: string | null;
+        secrets?: string[];
+    };
+    readonly routes?: readonly {
+        method: string;
+        path: string;
+    }[];
+    readonly listeners?: readonly {
+        key: string;
+    }[];
+    readonly places?: {
+        readonly kinds: readonly string[];
+    };
+    readonly surface?: {
+        routes: {
+            method: string;
+            path: string;
+        }[];
+        listeners: string[];
+        placeKinds: string[];
+    };
     readonly config?: JsonObject;
     readonly key?: string;
+    readonly install?: string;
 }
 export interface AgentDefinitionInputIface {
     readonly name?: string;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/agent.ts"],
-  "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;",
+  "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 installed?: ProviderRef;\n  readonly credentials?: { app: string | null; secrets?: string[] };\n  readonly routes?: readonly { method: string; path: string }[];\n  readonly listeners?: readonly { key: string }[];\n  readonly places?: { readonly kinds: readonly string[] };\n  readonly surface?: {\n    routes: { method: string; path: string }[];\n    listeners: string[];\n    placeKinds: string[];\n  };\n  readonly config?: JsonObject;\n  readonly key?: string;\n  readonly install?: 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;AAmD7B,MAAM,cAAc,CAA2C,eACpE,MAAM,EAAE,GAAG,WAAW,GAAG,aAAa,KAAK;",
   "names": []
 }

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

@@ -12,6 +12,7 @@ export declare enum AuthoredKind {
     HarnessHost = "harness-host",
     Hook = "hook",
     Channel = "channel",
+    RoomSurface = "room-surface",
     Approval = "approval"
 }
 export declare const stamp: <T extends object>(value: T, kind: AuthoredKind) => T;

package/dist/modules/authoring/brand.mjs

@@ -12,6 +12,7 @@ var AuthoredKind = /* @__PURE__ */ ((AuthoredKind2) => {
   AuthoredKind2["HarnessHost"] = "harness-host";
   AuthoredKind2["Hook"] = "hook";
   AuthoredKind2["Channel"] = "channel";
+  AuthoredKind2["RoomSurface"] = "room-surface";
   AuthoredKind2["Approval"] = "approval";
   return AuthoredKind2;
 })(AuthoredKind || {});

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/brand.ts"],
-  "sourcesContent": ["import { isObjectLike, type AuthoredValue } from \"../runtime/values.mjs\";\n\n// Authored values are plain objects (or functions) registered with their\n// kind, so the compiler's evaluation realm and the isolate runtime recognize\n// them without classes or instanceof. The registry lives in the same realm as\n// the authored code, because the authoring module is bundled with it.\n\nexport enum AuthoredKind {\n  Agent = 'agent',\n  Tool = 'tool',\n  Dynamic = 'dynamic',\n  Instructions = 'instructions',\n  Skill = 'skill',\n  Connection = 'connection',\n  Schedule = 'schedule',\n  SandboxSelector = 'sandbox-selector',\n  BaseTools = 'base-tools',\n  HarnessHost = 'harness-host',\n  Hook = 'hook',\n  Channel = 'channel',\n  Approval = 'approval',\n}\n\nconst kinds = new WeakMap<object, AuthoredKind>();\n\nexport const stamp = <T extends object>(value: T, kind: AuthoredKind): T => {\n  kinds.set(value, kind);\n  return value;\n};\n\nexport const authoredKindOf = (value: AuthoredValue): AuthoredKind | null =>\n  isObjectLike(value) ? (kinds.get(value) ?? null) : null;\n\nexport const isAuthored = (value: AuthoredValue, kind: AuthoredKind): boolean =>\n  authoredKindOf(value) === kind;\n\n// Values whose bundle export is unknown where they are created (a custom\n// harness, a custom credential resolver): authoring records them in order and\n// hands out a placeholder; the compiler maps each placeholder to a synthesized\n// bundle export. Evaluation order is the bundle's module order, so the\n// compile-time evaluation and the isolate agree on the numbering.\nconst PENDING_PREFIX = '<pending:';\nconst pendingValues: AuthoredValue[] = [];\n\nexport const registerPending = (value: AuthoredValue): string => {\n  pendingValues.push(value);\n  return `${PENDING_PREFIX}${pendingValues.length - 1}>`;\n};\n\nexport const pendingEntries = (): { placeholder: string; index: number; value: AuthoredValue }[] =>\n  pendingValues.map((value, index) => ({\n    placeholder: `${PENDING_PREFIX}${index}>`,\n    index,\n    value,\n  }));\n\nexport const pendingIndexOf = (placeholder: string): number | null => {\n  const match = /^<pending:(\\d+)>$/.exec(placeholder);\n  return match?.[1] == null ? null : Number(match[1]);\n};\n\nexport const pendingExportName = (index: number): string => `pending:${index}`;\n"],
-  "mappings": "AAAA,SAAS,oBAAwC;AAO1C,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,kBAAe;AACf,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,gBAAa;AACb,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,qBAAkB;AAClB,EAAAA,cAAA,eAAY;AACZ,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,cAAW;AAbD,SAAAA;AAAA,GAAA;AAgBZ,MAAM,QAAQ,oBAAI,QAA8B;AAEzC,MAAM,QAAQ,CAAmB,OAAU,SAA0B;AAC1E,QAAM,IAAI,OAAO,IAAI;AACrB,SAAO;AACT;AAEO,MAAM,iBAAiB,CAAC,UAC7B,aAAa,KAAK,IAAK,MAAM,IAAI,KAAK,KAAK,OAAQ;AAE9C,MAAM,aAAa,CAAC,OAAsB,SAC/C,eAAe,KAAK,MAAM;AAO5B,MAAM,iBAAiB;AACvB,MAAM,gBAAiC,CAAC;AAEjC,MAAM,kBAAkB,CAAC,UAAiC;AAC/D,gBAAc,KAAK,KAAK;AACxB,SAAO,GAAG,cAAc,GAAG,cAAc,SAAS,CAAC;AACrD;AAEO,MAAM,iBAAiB,MAC5B,cAAc,IAAI,CAAC,OAAO,WAAW;AAAA,EACnC,aAAa,GAAG,cAAc,GAAG,KAAK;AAAA,EACtC;AAAA,EACA;AACF,EAAE;AAEG,MAAM,iBAAiB,CAAC,gBAAuC;AACpE,QAAM,QAAQ,oBAAoB,KAAK,WAAW;AAClD,SAAO,QAAQ,CAAC,KAAK,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC;AACpD;AAEO,MAAM,oBAAoB,CAAC,UAA0B,WAAW,KAAK;",
+  "sourcesContent": ["import { isObjectLike, type AuthoredValue } from \"../runtime/values.mjs\";\n\n// Authored values are plain objects (or functions) registered with their\n// kind, so the compiler's evaluation realm and the isolate runtime recognize\n// them without classes or instanceof. The registry lives in the same realm as\n// the authored code, because the authoring module is bundled with it.\n\nexport enum AuthoredKind {\n  Agent = 'agent',\n  Tool = 'tool',\n  Dynamic = 'dynamic',\n  Instructions = 'instructions',\n  Skill = 'skill',\n  Connection = 'connection',\n  Schedule = 'schedule',\n  SandboxSelector = 'sandbox-selector',\n  BaseTools = 'base-tools',\n  HarnessHost = 'harness-host',\n  Hook = 'hook',\n  Channel = 'channel',\n  RoomSurface = 'room-surface',\n  Approval = 'approval',\n}\n\nconst kinds = new WeakMap<object, AuthoredKind>();\n\nexport const stamp = <T extends object>(value: T, kind: AuthoredKind): T => {\n  kinds.set(value, kind);\n  return value;\n};\n\nexport const authoredKindOf = (value: AuthoredValue): AuthoredKind | null =>\n  isObjectLike(value) ? (kinds.get(value) ?? null) : null;\n\nexport const isAuthored = (value: AuthoredValue, kind: AuthoredKind): boolean =>\n  authoredKindOf(value) === kind;\n\n// Values whose bundle export is unknown where they are created (a custom\n// harness, a custom credential resolver): authoring records them in order and\n// hands out a placeholder; the compiler maps each placeholder to a synthesized\n// bundle export. Evaluation order is the bundle's module order, so the\n// compile-time evaluation and the isolate agree on the numbering.\nconst PENDING_PREFIX = '<pending:';\nconst pendingValues: AuthoredValue[] = [];\n\nexport const registerPending = (value: AuthoredValue): string => {\n  pendingValues.push(value);\n  return `${PENDING_PREFIX}${pendingValues.length - 1}>`;\n};\n\nexport const pendingEntries = (): { placeholder: string; index: number; value: AuthoredValue }[] =>\n  pendingValues.map((value, index) => ({\n    placeholder: `${PENDING_PREFIX}${index}>`,\n    index,\n    value,\n  }));\n\nexport const pendingIndexOf = (placeholder: string): number | null => {\n  const match = /^<pending:(\\d+)>$/.exec(placeholder);\n  return match?.[1] == null ? null : Number(match[1]);\n};\n\nexport const pendingExportName = (index: number): string => `pending:${index}`;\n"],
+  "mappings": "AAAA,SAAS,oBAAwC;AAO1C,IAAK,eAAL,kBAAKA,kBAAL;AACL,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,kBAAe;AACf,EAAAA,cAAA,WAAQ;AACR,EAAAA,cAAA,gBAAa;AACb,EAAAA,cAAA,cAAW;AACX,EAAAA,cAAA,qBAAkB;AAClB,EAAAA,cAAA,eAAY;AACZ,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,UAAO;AACP,EAAAA,cAAA,aAAU;AACV,EAAAA,cAAA,iBAAc;AACd,EAAAA,cAAA,cAAW;AAdD,SAAAA;AAAA,GAAA;AAiBZ,MAAM,QAAQ,oBAAI,QAA8B;AAEzC,MAAM,QAAQ,CAAmB,OAAU,SAA0B;AAC1E,QAAM,IAAI,OAAO,IAAI;AACrB,SAAO;AACT;AAEO,MAAM,iBAAiB,CAAC,UAC7B,aAAa,KAAK,IAAK,MAAM,IAAI,KAAK,KAAK,OAAQ;AAE9C,MAAM,aAAa,CAAC,OAAsB,SAC/C,eAAe,KAAK,MAAM;AAO5B,MAAM,iBAAiB;AACvB,MAAM,gBAAiC,CAAC;AAEjC,MAAM,kBAAkB,CAAC,UAAiC;AAC/D,gBAAc,KAAK,KAAK;AACxB,SAAO,GAAG,cAAc,GAAG,cAAc,SAAS,CAAC;AACrD;AAEO,MAAM,iBAAiB,MAC5B,cAAc,IAAI,CAAC,OAAO,WAAW;AAAA,EACnC,aAAa,GAAG,cAAc,GAAG,KAAK;AAAA,EACtC;AAAA,EACA;AACF,EAAE;AAEG,MAAM,iBAAiB,CAAC,gBAAuC;AACpE,QAAM,QAAQ,oBAAoB,KAAK,WAAW;AAClD,SAAO,QAAQ,CAAC,KAAK,OAAO,OAAO,OAAO,MAAM,CAAC,CAAC;AACpD;AAEO,MAAM,oBAAoB,CAAC,UAA0B,WAAW,KAAK;",
   "names": ["AuthoredKind"]
 }

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

@@ -1,100 +1,17 @@
-import type { AcpUpdateKind, KnownAcpUpdateKind, ChannelAddressContextIface, ChannelDefinitionIface, ChannelEventHandler, ChannelReceiveContextIface, ChannelReceiveResult, ChannelSemanticDataByKindIface, HttpChannelRouteDefinitionIface, JsonObject, JsonValue, DecisionEventKind, ProjectionContextIface, TurnPolicy, WebSocketChannelRouteDefinitionIface } from '@finalai/agent-provider';
-export { channelAccessors } from '@finalai/agent-provider';
-export type RouteHandler = HttpChannelRouteDefinitionIface['handler'];
-export type RouteHandlerArgsIface = Parameters<RouteHandler>[0];
-export type AuthoredChannelDefinitionIface = Partial<Omit<ChannelDefinitionIface<JsonValue, JsonValue>, 'turnPolicy' | 'events' | 'receive'>> & {
-    receive?: (input: JsonValue, ctx: ChannelReceiveContextIface & ChannelAddressContextIface) => Promise<ChannelReceiveResult>;
-    events?: AuthoredChannelEventsIface;
-    readonly turnPolicy?: TurnPolicy | `${TurnPolicy}`;
-    readonly config?: JsonObject;
+import type { ChannelDefinitionIface, HttpChannelRouteDefinitionIface, JsonObject, JsonValue, RouteDefinitionIface, RoomSurfaceDefinitionIface, WebSocketChannelRouteDefinitionIface } from '@finalai/agent-provider';
+export type AuthoredChannelDefinitionIface = ChannelDefinitionIface<JsonObject, JsonValue, JsonValue> & {
     readonly disabled?: boolean;
 };
-export interface AuthoredChannelContextIface extends ChannelAddressContextIface {
-    platform: ProjectionContextIface['platform'];
-}
-export interface AuthoredSessionContextIface {
-    sessionId: string | null;
-    turnId: string;
-    state: ProjectionContextIface['state'];
-    config: JsonObject;
-    secrets: ProjectionContextIface['secrets'];
-}
-export type AuthoredSemanticEventsIface = {
-    [Kind in keyof ChannelSemanticDataByKindIface]?: (data: ChannelSemanticDataByKindIface[Kind], channel: AuthoredChannelContextIface, ctx: AuthoredSessionContextIface) => void | Promise<void>;
-};
-type AuthoredSemanticHandlerIface = NonNullable<AuthoredSemanticEventsIface[keyof AuthoredSemanticEventsIface]>;
-export type AuthoredChannelEventsIface = AuthoredSemanticEventsIface & {
-    [Kind in `${DecisionEventKind}` | KnownAcpUpdateKind]?: ChannelEventHandler;
-} & {
-    [kind: AcpUpdateKind]: ChannelEventHandler | AuthoredSemanticHandlerIface | undefined;
-};
-export declare const defineChannel: <TChannel extends AuthoredChannelDefinitionIface>(definition: TChannel) => Omit<TChannel, "configure" | "installed"> & {
-    configure: ((config: JsonObject) => ChannelDefinitionIface<JsonValue, JsonValue>) | undefined;
-    events: {
-        [kind: string]: AuthoredSemanticHandlerIface | ChannelEventHandler | undefined;
-        usage_update?: ChannelEventHandler | undefined;
-        user_message_chunk?: ChannelEventHandler | undefined;
-        user_message?: ChannelEventHandler | undefined;
-        agent_message_chunk?: ChannelEventHandler | undefined;
-        agent_message?: ChannelEventHandler | undefined;
-        agent_thought_chunk?: ChannelEventHandler | undefined;
-        agent_thought?: ChannelEventHandler | undefined;
-        state_update?: ChannelEventHandler | undefined;
-        tool_call_content_chunk?: ChannelEventHandler | undefined;
-        tool_call_update?: ChannelEventHandler | undefined;
-        terminal_update?: ChannelEventHandler | undefined;
-        terminal_output_chunk?: ChannelEventHandler | undefined;
-        plan_update?: ChannelEventHandler | undefined;
-        plan_removed?: ChannelEventHandler | undefined;
-        available_commands_update?: ChannelEventHandler | undefined;
-        config_option_update?: ChannelEventHandler | undefined;
-        session_info_update?: ChannelEventHandler | undefined;
-        notice?: ChannelEventHandler | undefined;
-        compaction_update?: ChannelEventHandler | undefined;
-        compaction_summary_chunk?: ChannelEventHandler | undefined;
-        subagent_update?: ChannelEventHandler | undefined;
-        session_message?: ChannelEventHandler | undefined;
-        session_message_chunk?: ChannelEventHandler | undefined;
-        "decision.created"?: ChannelEventHandler | undefined;
-        "decision.resolved"?: ChannelEventHandler | undefined;
-    };
-};
-export declare const disableChannel: () => Omit<{
-    disabled: true;
-}, "configure" | "installed"> & {
-    configure: ((config: JsonObject) => ChannelDefinitionIface<JsonValue, JsonValue>) | undefined;
-    events: {
-        [kind: string]: AuthoredSemanticHandlerIface | ChannelEventHandler | undefined;
-        usage_update?: ChannelEventHandler | undefined;
-        user_message_chunk?: ChannelEventHandler | undefined;
-        user_message?: ChannelEventHandler | undefined;
-        agent_message_chunk?: ChannelEventHandler | undefined;
-        agent_message?: ChannelEventHandler | undefined;
-        agent_thought_chunk?: ChannelEventHandler | undefined;
-        agent_thought?: ChannelEventHandler | undefined;
-        state_update?: ChannelEventHandler | undefined;
-        tool_call_content_chunk?: ChannelEventHandler | undefined;
-        tool_call_update?: ChannelEventHandler | undefined;
-        terminal_update?: ChannelEventHandler | undefined;
-        terminal_output_chunk?: ChannelEventHandler | undefined;
-        plan_update?: ChannelEventHandler | undefined;
-        plan_removed?: ChannelEventHandler | undefined;
-        available_commands_update?: ChannelEventHandler | undefined;
-        config_option_update?: ChannelEventHandler | undefined;
-        session_info_update?: ChannelEventHandler | undefined;
-        notice?: ChannelEventHandler | undefined;
-        compaction_update?: ChannelEventHandler | undefined;
-        compaction_summary_chunk?: ChannelEventHandler | undefined;
-        subagent_update?: ChannelEventHandler | undefined;
-        session_message?: ChannelEventHandler | undefined;
-        session_message_chunk?: ChannelEventHandler | undefined;
-        "decision.created"?: ChannelEventHandler | undefined;
-        "decision.resolved"?: ChannelEventHandler | undefined;
-    };
+export type RouteHandler = HttpChannelRouteDefinitionIface['handler'];
+export type RouteHandlerArgsIface = Parameters<RouteHandler>[0];
+export declare const defineChannel: <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(definition: ChannelDefinitionIface<Config, Inbound, State>) => ChannelDefinitionIface<Config, Inbound, State>;
+export declare const disableChannel: () => {
+    disabled: boolean;
 };
-export declare const GET: (path: string, handler: RouteHandler) => HttpChannelRouteDefinitionIface;
-export declare const POST: (path: string, handler: RouteHandler) => HttpChannelRouteDefinitionIface;
-export declare const PUT: (path: string, handler: RouteHandler) => HttpChannelRouteDefinitionIface;
-export declare const DELETE: (path: string, handler: RouteHandler) => HttpChannelRouteDefinitionIface;
+export declare const defineProviderChannel: <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(definition: ChannelDefinitionIface<Config, Inbound, State>) => ChannelDefinitionIface<Config, Inbound, State>;
+export declare const defineRoomSurface: <T extends RoomSurfaceDefinitionIface<JsonValue, JsonValue>>(definition: T) => T;
+export declare const GET: (path: string, handler: RouteHandler) => RouteDefinitionIface;
+export declare const POST: (path: string, handler: RouteHandler) => RouteDefinitionIface;
+export declare const PUT: (path: string, handler: RouteHandler) => RouteDefinitionIface;
+export declare const DELETE: (path: string, handler: RouteHandler) => RouteDefinitionIface;
 export declare const WS: (path: string, handler: WebSocketChannelRouteDefinitionIface["handler"]) => WebSocketChannelRouteDefinitionIface;
-export declare const defineProviderChannel: <T extends ChannelDefinitionIface<JsonValue, JsonValue>>(definition: T) => T;

package/dist/modules/authoring/channels.mjs

@@ -1,69 +1,23 @@
-import {
-  channelAccessors,
-  channelMessageCompletedSchema,
-  jsonObjectSchema
-} from "@finalai/agent-provider";
-import { channelAccessors as channelAccessors2 } from "@finalai/agent-provider";
-import * as z from "zod";
 import { AuthoredKind, stamp } from "./brand.mjs";
-const defineChannel = (definition) => {
-  const {
-    "message.delta": delta,
-    "message.completed": completed,
-    "turn.started": started,
-    "turn.completed": ended,
-    ...raw
-  } = definition.events ?? {};
-  const events = { ...raw };
-  const wrap = (schema, handler) => handler == null ? void 0 : async (event, ctx) => handler(
-    schema.parse(event.data),
-    { ...channelAccessors(ctx.platform), platform: ctx.platform },
-    {
-      sessionId: ctx.sessionId ?? null,
-      turnId: ctx.turn.id,
-      state: ctx.state,
-      config: ctx.config,
-      secrets: ctx.secrets
-    }
-  );
-  const semantic = {
-    "message.delta": wrap(z.object({ messageId: z.string(), delta: jsonObjectSchema }), delta),
-    "message.completed": wrap(channelMessageCompletedSchema, completed),
-    "turn.started": wrap(z.object({ turnId: z.string() }), started),
-    "turn.completed": wrap(
-      z.object({ turnId: z.string(), stopReason: z.string().nullable() }),
-      ended
-    )
-  };
-  for (const [kind, handler] of Object.entries(semantic))
-    if (handler != null) events[kind] = handler;
-  const { installed, configure, ...authored } = definition;
-  return stamp(
-    { ...authored, configure: installed == null ? configure : void 0, events },
-    AuthoredKind.Channel
-  );
-};
-const disableChannel = () => defineChannel({ disabled: true });
-const route = (method) => (path, handler) => ({
-  method,
-  path,
-  handler
-});
+const defineChannel = (definition) => stamp(definition, AuthoredKind.Channel);
+const disableChannel = () => stamp({ disabled: true }, AuthoredKind.Channel);
+const defineProviderChannel = defineChannel;
+const defineRoomSurface = (definition) => stamp(definition, AuthoredKind.RoomSurface);
+const route = (method) => (path, handler) => ({ method, path, handler });
 const GET = route("GET");
 const POST = route("POST");
 const PUT = route("PUT");
 const DELETE = route("DELETE");
 const WS = (path, handler) => ({ method: "WS", path, handler });
-const defineProviderChannel = (definition) => stamp(definition, AuthoredKind.Channel);
 export {
   DELETE,
   GET,
   POST,
   PUT,
   WS,
-  channelAccessors2 as channelAccessors,
   defineChannel,
   defineProviderChannel,
+  defineRoomSurface,
   disableChannel
 };
 //# sourceMappingURL=channels.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/channels.ts"],
-  "sourcesContent": ["import type {\n  AcpUpdateKind,\n  KnownAcpUpdateKind,\n  ChannelAddressContextIface,\n  ChannelDefinitionIface,\n  ChannelEventHandler,\n  ChannelReceiveContextIface,\n  ChannelReceiveResult,\n  ChannelSemanticDataByKindIface,\n  HttpChannelRouteDefinitionIface,\n  JsonObject,\n  JsonValue,\n  DecisionEventKind,\n  ProjectionContextIface,\n  TurnPolicy,\n  WebSocketChannelRouteDefinitionIface,\n} from '@finalai/agent-provider';\nimport {\n  channelAccessors,\n  channelMessageCompletedSchema,\n  jsonObjectSchema,\n} from '@finalai/agent-provider';\n\n// Session handles over a projection context's platform (`attachSession(ctx.sessionId)`)\n// for raw event handlers (`decision.created`, ACP updates).\nexport { channelAccessors } from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\n\n// A custom channel in channels/<stem>.ts. Its routes run\n// in the agent's Worker isolate and are mounted by the session service's\n// front door at /<org>/<agent>/<stem><path> (and /b/<bindingId><path>);\n// the members it authors (receive, route, project, events) run there too,\n// driven by the session service exactly like a built-in channel's. What it\n// leaves out is the platform default: receive takes `{ target, content }`,\n// route follows the default routing rules, and the conversation's own channel projects.\n//\n// A bundle channel sees wire ids everywhere (conversations `conv_\u2026`,\n// participants `cpart_\u2026`, messages `cnmsg_\u2026`, users `usr_\u2026`, its binding\n// `chbind_\u2026`, turns `atrn_\u2026`, decisions `adec_\u2026`), the same strings the\n// public API returns, and must pass wire ids back to `ctx.platform`, `receive`\n// results and route decisions; raw UUIDs are refused.\n\nexport type RouteHandler = HttpChannelRouteDefinitionIface['handler'];\nexport type RouteHandlerArgsIface = Parameters<RouteHandler>[0];\n\nexport type AuthoredChannelDefinitionIface = Partial<\n  Omit<ChannelDefinitionIface<JsonValue, JsonValue>, 'turnPolicy' | 'events' | 'receive'>\n> & {\n  receive?: (\n    input: JsonValue,\n    ctx: ChannelReceiveContextIface & ChannelAddressContextIface,\n  ) => Promise<ChannelReceiveResult>;\n  events?: AuthoredChannelEventsIface;\n  readonly turnPolicy?: TurnPolicy | `${TurnPolicy}`;\n  // Static binding config recorded in the manifest.\n  readonly config?: JsonObject;\n  readonly disabled?: boolean;\n};\n\nexport interface AuthoredChannelContextIface extends ChannelAddressContextIface {\n  platform: ProjectionContextIface['platform'];\n}\nexport interface AuthoredSessionContextIface {\n  sessionId: string | null;\n  turnId: string;\n  state: ProjectionContextIface['state'];\n  // The binding's config and the agent's secrets: what a channel needs to post\n  // its replies back to its own service.\n  config: JsonObject;\n  secrets: ProjectionContextIface['secrets'];\n}\nexport type AuthoredSemanticEventsIface = {\n  [Kind in keyof ChannelSemanticDataByKindIface]?: (\n    data: ChannelSemanticDataByKindIface[Kind],\n    channel: AuthoredChannelContextIface,\n    ctx: AuthoredSessionContextIface,\n  ) => void | Promise<void>;\n};\n\ntype AuthoredSemanticHandlerIface = NonNullable<\n  AuthoredSemanticEventsIface[keyof AuthoredSemanticEventsIface]\n>;\n\n// Semantic events (`message.delta`, \u2026) take `(data, channel, ctx)`; decision\n// events and ACP update kinds (`tool_call`, `plan`, \u2026) the raw `(event, ctx)`.\n// Named kinds keep a single handler type, so their parameters are typed from\n// context; ACP kinds the SDK does not name share the open index signature and\n// need annotated parameters.\nexport type AuthoredChannelEventsIface = AuthoredSemanticEventsIface & {\n  [Kind in `${DecisionEventKind}` | KnownAcpUpdateKind]?: ChannelEventHandler;\n} & {\n  [kind: AcpUpdateKind]: ChannelEventHandler | AuthoredSemanticHandlerIface | undefined;\n};\n\nexport const defineChannel = <TChannel extends AuthoredChannelDefinitionIface>(\n  definition: TChannel,\n) => {\n  const {\n    'message.delta': delta,\n    'message.completed': completed,\n    'turn.started': started,\n    'turn.completed': ended,\n    ...raw\n  } = definition.events ?? {};\n  const events = { ...raw };\n  const wrap = <Data>(\n    schema: z.ZodType<Data>,\n    handler:\n      | ((\n          data: Data,\n          channel: AuthoredChannelContextIface,\n          ctx: AuthoredSessionContextIface,\n        ) => void | Promise<void>)\n      | undefined,\n  ): ChannelEventHandler | undefined =>\n    handler == null\n      ? undefined\n      : async (event, ctx) =>\n          handler(\n            schema.parse(event.data),\n            { ...channelAccessors(ctx.platform), platform: ctx.platform },\n            {\n              sessionId: ctx.sessionId ?? null,\n              turnId: ctx.turn.id,\n              state: ctx.state,\n              config: ctx.config,\n              secrets: ctx.secrets,\n            },\n          );\n  const semantic = {\n    'message.delta': wrap(z.object({ messageId: z.string(), delta: jsonObjectSchema }), delta),\n    'message.completed': wrap(channelMessageCompletedSchema, completed),\n    'turn.started': wrap(z.object({ turnId: z.string() }), started),\n    'turn.completed': wrap(\n      z.object({ turnId: z.string(), stopReason: z.string().nullable() }),\n      ended,\n    ),\n  };\n  for (const [kind, handler] of Object.entries(semantic))\n    if (handler != null) events[kind] = handler;\n  const { installed, configure, ...authored } = definition;\n  return stamp(\n    { ...authored, configure: installed == null ? configure : undefined, events },\n    AuthoredKind.Channel,\n  );\n};\n\nexport const disableChannel = () => defineChannel({ disabled: true });\n\nconst route =\n  (method: HttpChannelRouteDefinitionIface['method']) =>\n  (path: string, handler: RouteHandler): HttpChannelRouteDefinitionIface => ({\n    method,\n    path,\n    handler,\n  });\n\nexport const GET = route('GET');\nexport const POST = route('POST');\nexport const PUT = route('PUT');\nexport const DELETE = route('DELETE');\n\nexport const WS = (\n  path: string,\n  handler: WebSocketChannelRouteDefinitionIface['handler'],\n): WebSocketChannelRouteDefinitionIface => ({ method: 'WS', path, handler });\n\n// Provider factories already own their installed reference and runtime handlers.\nexport const defineProviderChannel = <T extends ChannelDefinitionIface<JsonValue, JsonValue>>(\n  definition: T,\n): T => stamp(definition, AuthoredKind.Channel);\n"],
-  "mappings": "AAiBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAIP,SAAS,oBAAAA,yBAAwB;AACjC,YAAY,OAAO;AACnB,SAAS,cAAc,aAAa;AAoE7B,MAAM,gBAAgB,CAC3B,eACG;AACH,QAAM;AAAA,IACJ,iBAAiB;AAAA,IACjB,qBAAqB;AAAA,IACrB,gBAAgB;AAAA,IAChB,kBAAkB;AAAA,IAClB,GAAG;AAAA,EACL,IAAI,WAAW,UAAU,CAAC;AAC1B,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,QAAM,OAAO,CACX,QACA,YAQA,WAAW,OACP,SACA,OAAO,OAAO,QACZ;AAAA,IACE,OAAO,MAAM,MAAM,IAAI;AAAA,IACvB,EAAE,GAAG,iBAAiB,IAAI,QAAQ,GAAG,UAAU,IAAI,SAAS;AAAA,IAC5D;AAAA,MACE,WAAW,IAAI,aAAa;AAAA,MAC5B,QAAQ,IAAI,KAAK;AAAA,MACjB,OAAO,IAAI;AAAA,MACX,QAAQ,IAAI;AAAA,MACZ,SAAS,IAAI;AAAA,IACf;AAAA,EACF;AACR,QAAM,WAAW;AAAA,IACf,iBAAiB,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,iBAAiB,CAAC,GAAG,KAAK;AAAA,IACzF,qBAAqB,KAAK,+BAA+B,SAAS;AAAA,IAClE,gBAAgB,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO;AAAA,IAC9D,kBAAkB;AAAA,MAChB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,MAClE;AAAA,IACF;AAAA,EACF;AACA,aAAW,CAAC,MAAM,OAAO,KAAK,OAAO,QAAQ,QAAQ;AACnD,QAAI,WAAW,KAAM,QAAO,IAAI,IAAI;AACtC,QAAM,EAAE,WAAW,WAAW,GAAG,SAAS,IAAI;AAC9C,SAAO;AAAA,IACL,EAAE,GAAG,UAAU,WAAW,aAAa,OAAO,YAAY,QAAW,OAAO;AAAA,IAC5E,aAAa;AAAA,EACf;AACF;AAEO,MAAM,iBAAiB,MAAM,cAAc,EAAE,UAAU,KAAK,CAAC;AAEpE,MAAM,QACJ,CAAC,WACD,CAAC,MAAc,aAA4D;AAAA,EACzE;AAAA,EACA;AAAA,EACA;AACF;AAEK,MAAM,MAAM,MAAM,KAAK;AACvB,MAAM,OAAO,MAAM,MAAM;AACzB,MAAM,MAAM,MAAM,KAAK;AACvB,MAAM,SAAS,MAAM,QAAQ;AAE7B,MAAM,KAAK,CAChB,MACA,aAC0C,EAAE,QAAQ,MAAM,MAAM,QAAQ;AAGnE,MAAM,wBAAwB,CACnC,eACM,MAAM,YAAY,aAAa,OAAO;",
-  "names": ["channelAccessors"]
+  "sourcesContent": ["import type {\n  ChannelDefinitionIface,\n  HttpChannelRouteDefinitionIface,\n  JsonObject,\n  JsonValue,\n  RouteDefinitionIface,\n  RoomSurfaceDefinitionIface,\n  WebSocketChannelRouteDefinitionIface,\n} from '@finalai/agent-provider';\nimport { AuthoredKind, stamp } from \"./brand.mjs\";\n\nexport type AuthoredChannelDefinitionIface = ChannelDefinitionIface<\n  JsonObject,\n  JsonValue,\n  JsonValue\n> & { readonly disabled?: boolean };\nexport type RouteHandler = HttpChannelRouteDefinitionIface['handler'];\nexport type RouteHandlerArgsIface = Parameters<RouteHandler>[0];\n\nexport const defineChannel = <Config = JsonObject, Inbound = JsonValue, State = JsonValue>(\n  definition: ChannelDefinitionIface<Config, Inbound, State>,\n): ChannelDefinitionIface<Config, Inbound, State> => stamp(definition, AuthoredKind.Channel);\nexport const disableChannel = () => stamp({ disabled: true }, AuthoredKind.Channel);\nexport const defineProviderChannel = defineChannel;\nexport const defineRoomSurface = <T extends RoomSurfaceDefinitionIface<JsonValue, JsonValue>>(\n  definition: T,\n): T => stamp(definition, AuthoredKind.RoomSurface);\n\nconst route =\n  (method: HttpChannelRouteDefinitionIface['method']) =>\n  (path: string, handler: RouteHandler): RouteDefinitionIface => ({ method, path, handler });\nexport const GET = route('GET');\nexport const POST = route('POST');\nexport const PUT = route('PUT');\nexport const DELETE = route('DELETE');\nexport const WS = (\n  path: string,\n  handler: WebSocketChannelRouteDefinitionIface['handler'],\n): WebSocketChannelRouteDefinitionIface => ({ method: 'WS', path, handler });\n"],
+  "mappings": "AASA,SAAS,cAAc,aAAa;AAU7B,MAAM,gBAAgB,CAC3B,eACmD,MAAM,YAAY,aAAa,OAAO;AACpF,MAAM,iBAAiB,MAAM,MAAM,EAAE,UAAU,KAAK,GAAG,aAAa,OAAO;AAC3E,MAAM,wBAAwB;AAC9B,MAAM,oBAAoB,CAC/B,eACM,MAAM,YAAY,aAAa,WAAW;AAElD,MAAM,QACJ,CAAC,WACD,CAAC,MAAc,aAAiD,EAAE,QAAQ,MAAM,QAAQ;AACnF,MAAM,MAAM,MAAM,KAAK;AACvB,MAAM,OAAO,MAAM,MAAM;AACzB,MAAM,MAAM,MAAM,KAAK;AACvB,MAAM,SAAS,MAAM,QAAQ;AAC7B,MAAM,KAAK,CAChB,MACA,aAC0C,EAAE,QAAQ,MAAM,MAAM,QAAQ;",
+  "names": []
 }

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

@@ -2,7 +2,7 @@ export { defineAgent } from "./agent.mjs";
 export type { AgentDefinitionInputIface, ChannelBindingValueIface, HarnessBindingValueIface, } from "./agent.mjs";
 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 { DELETE, GET, POST, PUT, WS, defineChannel, defineRoomSurface, defineProviderChannel, disableChannel, } from "./channels.mjs";
 export type { AuthoredChannelDefinitionIface, RouteHandler, RouteHandlerArgsIface, } from "./channels.mjs";
 export { defineHostedConnection, defineMcpClientConnection } from "./connections.mjs";
 export type { HostedConnectionDefinitionIface, McpClientConnectionDefinitionIface, McpConnectionAuthIface, McpConnectionToolsIface, McpToolAnnotationSelectorIface, McpToolSelector, } from "./connections.mjs";

package/dist/modules/authoring/index.mjs

@@ -7,6 +7,7 @@ import {
   PUT,
   WS,
   defineChannel,
+  defineRoomSurface,
   defineProviderChannel,
   disableChannel
 } from "./channels.mjs";
@@ -51,6 +52,7 @@ export {
   defineInstructions,
   defineMcpClientConnection,
   defineProviderChannel,
+  defineRoomSurface,
   defineSandbox,
   defineSandboxProvider,
   defineSchedule,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/index.ts"],
-  "sourcesContent": ["export { defineAgent } from \"./agent.mjs\";\nexport type {\n  AgentDefinitionInputIface,\n  ChannelBindingValueIface,\n  HarnessBindingValueIface,\n} from \"./agent.mjs\";\nexport { always, never, whenInput } from \"./approval.mjs\";\nexport type { ApprovalPolicyIface } from \"./approval.mjs\";\nexport {\n  DELETE,\n  GET,\n  POST,\n  PUT,\n  WS,\n  defineChannel,\n  defineProviderChannel,\n  disableChannel,\n} from \"./channels.mjs\";\nexport type {\n  AuthoredChannelDefinitionIface,\n  RouteHandler,\n  RouteHandlerArgsIface,\n} from \"./channels.mjs\";\nexport { defineHostedConnection, defineMcpClientConnection } from \"./connections.mjs\";\nexport type {\n  HostedConnectionDefinitionIface,\n  McpClientConnectionDefinitionIface,\n  McpConnectionAuthIface,\n  McpConnectionToolsIface,\n  McpToolAnnotationSelectorIface,\n  McpToolSelector,\n} from \"./connections.mjs\";\nexport * from \"./context.mjs\";\nexport { requireHostedBinding } from '@finalai/agent-provider';\nexport type { HostedBindingsIface } from '@finalai/agent-provider';\nexport { CredentialOwner, CredentialPayer, credentials } from \"./credentials.mjs\";\nexport type { CredentialNode, CredentialPolicyIface } from \"./credentials.mjs\";\nexport { defineDynamic } from \"./dynamic.mjs\";\nexport type { DynamicDefinitionIface, DynamicEventsIface, DynamicSentinelIface } from \"./dynamic.mjs\";\nexport { completeHarnessDescription, defineHarness } from \"./harness.mjs\";\nexport type {\n  AuthoredHarnessCloseContextIface,\n  AuthoredHarnessDescriptionIface,\n  AuthoredHarnessEndpointIface,\n  AuthoredHarnessHealthIface,\n  AuthoredHarnessIface,\n  AuthoredHarnessOpenArgsIface,\n  AuthoredHarnessRefContextIface,\n  AuthoredHarnessResumeArgsIface,\n  AuthoredHarnessSessionRefIface,\n  DefinedAuthoredHarnessIface,\n} from \"./harness.mjs\";\nexport { HookEvent, defineHook } from \"./hooks.mjs\";\nexport type {\n  HookContextIface,\n  HookDefinitionIface,\n  HookEventFor,\n  HookEventIface,\n  HookEventKey,\n} from \"./hooks.mjs\";\nexport { defineInstructions } from \"./instructions.mjs\";\nexport type { DefinedInstructionsIface, InstructionsDefinitionIface } from \"./instructions.mjs\";\nexport {\n  SandboxWire,\n  baseTools,\n  defineSandbox,\n  defineSandboxProvider,\n  harnessHost,\n} from \"./sandbox.mjs\";\nexport type {\n  BaseToolsValueIface,\n  HarnessHostIface,\n  SandboxSelector,\n  SandboxSelectorContextIface,\n  SandboxTargetValue,\n} from \"./sandbox.mjs\";\nexport { defineSchedule } from \"./schedules.mjs\";\nexport type { ScheduleInputIface } from \"./schedules.mjs\";\nexport { defineSkill } from \"./skills.mjs\";\nexport type { SkillDefinitionIface } from \"./skills.mjs\";\nexport { defineTool, toolResultFrom } from \"./tools.mjs\";\nexport type {\n  DefinedToolIface,\n  StandardSchemaLikeIface,\n  ToolCallEventDataIface,\n  ToolDefinitionIface,\n  ToolInputSchema,\n} from \"./tools.mjs\";\n"],
-  "mappings": "AAAA,SAAS,mBAAmB;AAM5B,SAAS,QAAQ,OAAO,iBAAiB;AAEzC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,wBAAwB,iCAAiC;AASlE,cAAc;AACd,SAAS,4BAA4B;AAErC,SAAS,iBAAiB,iBAAiB,mBAAmB;AAE9D,SAAS,qBAAqB;AAE9B,SAAS,4BAA4B,qBAAqB;AAa1D,SAAS,WAAW,kBAAkB;AAQtC,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,sBAAsB;AAE/B,SAAS,mBAAmB;AAE5B,SAAS,YAAY,sBAAsB;",
+  "sourcesContent": ["export { defineAgent } from \"./agent.mjs\";\nexport type {\n  AgentDefinitionInputIface,\n  ChannelBindingValueIface,\n  HarnessBindingValueIface,\n} from \"./agent.mjs\";\nexport { always, never, whenInput } from \"./approval.mjs\";\nexport type { ApprovalPolicyIface } from \"./approval.mjs\";\nexport {\n  DELETE,\n  GET,\n  POST,\n  PUT,\n  WS,\n  defineChannel,\n  defineRoomSurface,\n  defineProviderChannel,\n  disableChannel,\n} from \"./channels.mjs\";\nexport type {\n  AuthoredChannelDefinitionIface,\n  RouteHandler,\n  RouteHandlerArgsIface,\n} from \"./channels.mjs\";\nexport { defineHostedConnection, defineMcpClientConnection } from \"./connections.mjs\";\nexport type {\n  HostedConnectionDefinitionIface,\n  McpClientConnectionDefinitionIface,\n  McpConnectionAuthIface,\n  McpConnectionToolsIface,\n  McpToolAnnotationSelectorIface,\n  McpToolSelector,\n} from \"./connections.mjs\";\nexport * from \"./context.mjs\";\nexport { requireHostedBinding } from '@finalai/agent-provider';\nexport type { HostedBindingsIface } from '@finalai/agent-provider';\nexport { CredentialOwner, CredentialPayer, credentials } from \"./credentials.mjs\";\nexport type { CredentialNode, CredentialPolicyIface } from \"./credentials.mjs\";\nexport { defineDynamic } from \"./dynamic.mjs\";\nexport type { DynamicDefinitionIface, DynamicEventsIface, DynamicSentinelIface } from \"./dynamic.mjs\";\nexport { completeHarnessDescription, defineHarness } from \"./harness.mjs\";\nexport type {\n  AuthoredHarnessCloseContextIface,\n  AuthoredHarnessDescriptionIface,\n  AuthoredHarnessEndpointIface,\n  AuthoredHarnessHealthIface,\n  AuthoredHarnessIface,\n  AuthoredHarnessOpenArgsIface,\n  AuthoredHarnessRefContextIface,\n  AuthoredHarnessResumeArgsIface,\n  AuthoredHarnessSessionRefIface,\n  DefinedAuthoredHarnessIface,\n} from \"./harness.mjs\";\nexport { HookEvent, defineHook } from \"./hooks.mjs\";\nexport type {\n  HookContextIface,\n  HookDefinitionIface,\n  HookEventFor,\n  HookEventIface,\n  HookEventKey,\n} from \"./hooks.mjs\";\nexport { defineInstructions } from \"./instructions.mjs\";\nexport type { DefinedInstructionsIface, InstructionsDefinitionIface } from \"./instructions.mjs\";\nexport {\n  SandboxWire,\n  baseTools,\n  defineSandbox,\n  defineSandboxProvider,\n  harnessHost,\n} from \"./sandbox.mjs\";\nexport type {\n  BaseToolsValueIface,\n  HarnessHostIface,\n  SandboxSelector,\n  SandboxSelectorContextIface,\n  SandboxTargetValue,\n} from \"./sandbox.mjs\";\nexport { defineSchedule } from \"./schedules.mjs\";\nexport type { ScheduleInputIface } from \"./schedules.mjs\";\nexport { defineSkill } from \"./skills.mjs\";\nexport type { SkillDefinitionIface } from \"./skills.mjs\";\nexport { defineTool, toolResultFrom } from \"./tools.mjs\";\nexport type {\n  DefinedToolIface,\n  StandardSchemaLikeIface,\n  ToolCallEventDataIface,\n  ToolDefinitionIface,\n  ToolInputSchema,\n} from \"./tools.mjs\";\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAM5B,SAAS,QAAQ,OAAO,iBAAiB;AAEzC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAMP,SAAS,wBAAwB,iCAAiC;AASlE,cAAc;AACd,SAAS,4BAA4B;AAErC,SAAS,iBAAiB,iBAAiB,mBAAmB;AAE9D,SAAS,qBAAqB;AAE9B,SAAS,4BAA4B,qBAAqB;AAa1D,SAAS,WAAW,kBAAkB;AAQtC,SAAS,0BAA0B;AAEnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAQP,SAAS,sBAAsB;AAE/B,SAAS,mBAAmB;AAE5B,SAAS,YAAY,sBAAsB;",
   "names": []
 }

package/dist/modules/compiler/assemble.d.mts

@@ -17,10 +17,6 @@ export interface AssembleOutputIface {
     manifest: AgentManifestIface | null;
     modules: Record<string, string>;
     sandboxOpeners: Record<string, string>;
-    channelRoutes: Record<string, {
-        method: string;
-        path: string;
-    }[]>;
     directoryFields: {
         instructions: string[];
         skills: string[];