@finalai/agent-definition 0.1.5 → 0.1.8

package/dist/compiler-assets/{chunk-IF6MR7JF.ts → chunk-34O434BK.ts}

@@ -14,6 +14,19 @@ import {
 } from "./chunk-3K4C4SVG.ts";
 
 // ../agent-provider/src/channel.ts
+var ChannelPrincipalType = /* @__PURE__ */ ((ChannelPrincipalType2) => {
+  ChannelPrincipalType2["User"] = "user";
+  ChannelPrincipalType2["Service"] = "service";
+  return ChannelPrincipalType2;
+})(ChannelPrincipalType || {});
+var channelAuthSchema = object({
+  principalId: string().min(1),
+  principalType: nativeEnum(ChannelPrincipalType),
+  authenticator: string().min(1),
+  // How the agent and the people reading its reply name the principal.
+  displayName: string().min(1).max(200).optional(),
+  attributes: jsonObjectSchema.default({})
+});
 var ConversationKind = /* @__PURE__ */ ((ConversationKind2) => {
   ConversationKind2["Direct"] = "direct";
   ConversationKind2["Group"] = "group";
@@ -22,12 +35,10 @@ var ConversationKind = /* @__PURE__ */ ((ConversationKind2) => {
 var ParticipantKind = /* @__PURE__ */ ((ParticipantKind2) => {
   ParticipantKind2["User"] = "user";
   ParticipantKind2["Agent"] = "agent";
-  ParticipantKind2["System"] = "system";
   return ParticipantKind2;
 })(ParticipantKind || {});
 var MessageKind = /* @__PURE__ */ ((MessageKind2) => {
   MessageKind2["Message"] = "message";
-  MessageKind2["System"] = "system";
   MessageKind2["Card"] = "card";
   return MessageKind2;
 })(MessageKind || {});
@@ -60,7 +71,8 @@ var pendingCreatedDataSchema = object({
 });
 var pendingResolvedDataSchema = object({
   pendingRequestId: string().min(1),
-  outcome: jsonValueSchema
+  outcome: jsonValueSchema,
+  respondedBy: channelAuthSchema.nullable().default(null)
 });
 var turnEndSchema = looseObject({
   sessionUpdate: literal("state_update"),

package/dist/compiler-assets/{chunk-K7V4IMOB.ts → chunk-KGIUNNCX.ts}

@@ -6,22 +6,18 @@ import {
 } from "./chunk-QJ26GEUM.ts";
 import {
   array,
-  nativeEnum,
   object,
   string
 } from "./chunk-3K4C4SVG.ts";
 
 // ../agent-provider/src/channel-context.ts
-var ChannelPrincipalType = /* @__PURE__ */ ((ChannelPrincipalType2) => {
-  ChannelPrincipalType2["User"] = "user";
-  ChannelPrincipalType2["Service"] = "service";
-  return ChannelPrincipalType2;
-})(ChannelPrincipalType || {});
-var channelAuthSchema = object({
-  principalId: string().min(1),
-  principalType: nativeEnum(ChannelPrincipalType),
-  authenticator: string().min(1),
-  attributes: jsonObjectSchema.default({})
+var channelInputReceiptSchema = object({
+  inputId: string().min(1),
+  sessionId: string().min(1)
+});
+var channelHandoffReceiptSchema = object({
+  inputId: string().min(1).nullable(),
+  sessionId: string().min(1).nullable()
 });
 var channelAccessors = (platform) => {
   const operations = () => {
@@ -76,7 +72,9 @@ var defineChannel = (definition) => {
     {
       sessionId: ctx.sessionId ?? null,
       turnId: ctx.turn.id,
-      state: ctx.state
+      state: ctx.state,
+      config: ctx.config,
+      secrets: ctx.secrets
     }
   );
   const semantic = {
@@ -110,6 +108,7 @@ var WS = (path, handler) => ({ method: "WS", path, handler });
 var defineProviderChannel = (definition) => stamp(definition, "channel" /* Channel */);
 
 export {
+  channelAccessors,
   defineChannel,
   disableChannel,
   GET,

package/dist/compiler-assets/{chunk-B5RJDCXZ.ts → chunk-OEXIS2VK.ts}

@@ -7,7 +7,17 @@ import {
 
 // ../agent-provider/src/sandbox/types.ts
 var defineSandboxProvider = (definition) => ({
-  definition,
+  // An implementation exists only once its options are given, so awaitRunning is
+  // checked as each environment is defined, before anything can start from it.
+  definition: {
+    ...definition,
+    environment: (options) => {
+      const implementation = definition.environment(options);
+      if (typeof implementation.awaitRunning !== "function")
+        throw new Error(`sandbox provider ${definition.name} does not implement awaitRunning`);
+      return implementation;
+    }
+  },
   name: definition.name,
   environment: (options) => ({
     providerName: definition.name,

package/dist/compiler-assets/{chunk-YWFGIPHD.ts → chunk-Z2UDHIJK.ts}

@@ -28,7 +28,7 @@ import {
 import {
   ConversationKind,
   ParticipantKind
-} from "./chunk-IF6MR7JF.ts";
+} from "./chunk-34O434BK.ts";
 import {
   mcpServerBindingSchema,
   providerRefSchema

package/dist/compiler-assets/src/authoring/channels.ts

@@ -4,11 +4,12 @@ import {
   POST,
   PUT,
   WS,
+  channelAccessors,
   defineChannel,
   defineProviderChannel,
   disableChannel
-} from "../../chunk-K7V4IMOB.ts";
-import "../../chunk-IF6MR7JF.ts";
+} from "../../chunk-KGIUNNCX.ts";
+import "../../chunk-34O434BK.ts";
 import "../../chunk-4X2DS5BR.ts";
 import "../../chunk-QJ26GEUM.ts";
 import "../../chunk-TM36NO3C.ts";
@@ -20,6 +21,7 @@ export {
   POST,
   PUT,
   WS,
+  channelAccessors,
   defineChannel,
   defineProviderChannel,
   disableChannel

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

@@ -15,7 +15,7 @@ import {
   defineSandbox,
   defineSandboxProvider,
   harnessHost
-} from "../../chunk-B5RJDCXZ.ts";
+} from "../../chunk-OEXIS2VK.ts";
 import "../../chunk-4E5HECVD.ts";
 import {
   SandboxWire
@@ -47,8 +47,8 @@ import {
   defineChannel,
   defineProviderChannel,
   disableChannel
-} from "../../chunk-K7V4IMOB.ts";
-import "../../chunk-IF6MR7JF.ts";
+} from "../../chunk-KGIUNNCX.ts";
+import "../../chunk-34O434BK.ts";
 import {
   defineHostedConnection,
   defineMcpClientConnection

package/dist/compiler-assets/src/authoring/sandbox.ts

@@ -3,7 +3,7 @@ import {
   defineSandbox,
   defineSandboxProvider,
   harnessHost
-} from "../../chunk-B5RJDCXZ.ts";
+} from "../../chunk-OEXIS2VK.ts";
 import "../../chunk-4E5HECVD.ts";
 import {
   SandboxWire

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

@@ -28,7 +28,7 @@ import {
   defineSandbox,
   defineSandboxProvider,
   harnessHost
-} from "../chunk-B5RJDCXZ.ts";
+} from "../chunk-OEXIS2VK.ts";
 import "../chunk-4E5HECVD.ts";
 import {
   SandboxWire
@@ -60,8 +60,8 @@ import {
   defineChannel,
   defineProviderChannel,
   disableChannel
-} from "../chunk-K7V4IMOB.ts";
-import "../chunk-IF6MR7JF.ts";
+} from "../chunk-KGIUNNCX.ts";
+import "../chunk-34O434BK.ts";
 import {
   defineHostedConnection,
   defineMcpClientConnection

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

@@ -1,7 +1,7 @@
 import {
   combineMcpServers,
   createIsolateRuntime
-} from "../../chunk-YWFGIPHD.ts";
+} from "../../chunk-Z2UDHIJK.ts";
 import {
   describeBundle,
   needsCombinedMcpServers,
@@ -18,7 +18,7 @@ import {
   registerToolName
 } from "../../chunk-2ZRYQO4Q.ts";
 import "../../chunk-4A66SVBJ.ts";
-import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-34O434BK.ts";
 import "../../chunk-CIWWFQHL.ts";
 import "../../chunk-APU2VKLW.ts";
 import "../../chunk-RWUIMTBI.ts";

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

@@ -2,14 +2,14 @@ import {
   combineMcpServers,
   createIsolateRuntime,
   lowerResolvedValue
-} from "../../chunk-YWFGIPHD.ts";
+} from "../../chunk-Z2UDHIJK.ts";
 import "../../chunk-5NTKRRMC.ts";
 import "../../chunk-NMYHO2QN.ts";
 import "../../chunk-TJZS457N.ts";
 import "../../chunk-4E5HECVD.ts";
 import "../../chunk-2ZRYQO4Q.ts";
 import "../../chunk-4A66SVBJ.ts";
-import "../../chunk-IF6MR7JF.ts";
+import "../../chunk-34O434BK.ts";
 import "../../chunk-CIWWFQHL.ts";
 import "../../chunk-APU2VKLW.ts";
 import "../../chunk-RWUIMTBI.ts";

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

@@ -1,9 +1,10 @@
-import type { AcpUpdateKind, ChannelAddressContextIface, ChannelDefinitionIface, ChannelEventHandler, ChannelReceiveContextIface, ChannelReceiveResult, ChannelSemanticDataByKindIface, HttpChannelRouteDefinitionIface, JsonObject, JsonValue, PendingEventKind, ProjectionContextIface, TurnPolicy, WebSocketChannelRouteDefinitionIface } from '@finalai/agent-provider';
+import type { AcpUpdateKind, KnownAcpUpdateKind, ChannelAddressContextIface, ChannelDefinitionIface, ChannelEventHandler, ChannelReceiveContextIface, ChannelReceiveResult, ChannelSemanticDataByKindIface, HttpChannelRouteDefinitionIface, JsonObject, JsonValue, PendingEventKind, 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?: Partial<Record<AcpUpdateKind | `${PendingEventKind}`, ChannelEventHandler>> & AuthoredSemanticEventsIface;
+    events?: AuthoredChannelEventsIface;
     readonly turnPolicy?: TurnPolicy | `${TurnPolicy}`;
     readonly config?: JsonObject;
     readonly disabled?: boolean;
@@ -15,14 +16,47 @@ 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 `${PendingEventKind}` | KnownAcpUpdateKind]?: ChannelEventHandler;
+} & {
+    [kind: AcpUpdateKind]: ChannelEventHandler | AuthoredSemanticHandlerIface | undefined;
+};
 export declare const defineChannel: <TChannel extends AuthoredChannelDefinitionIface>(definition: TChannel) => Omit<TChannel, "installed" | "configure"> & {
     configure: ((config: JsonObject) => ChannelDefinitionIface<JsonValue, JsonValue>) | undefined;
     events: {
-        [x: string]: ChannelEventHandler | undefined;
+        [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;
+        "pending.created"?: ChannelEventHandler | undefined;
+        "pending.resolved"?: ChannelEventHandler | undefined;
     };
 };
 export declare const disableChannel: () => Omit<{
@@ -30,7 +64,32 @@ export declare const disableChannel: () => Omit<{
 }, "installed" | "configure"> & {
     configure: ((config: JsonObject) => ChannelDefinitionIface<JsonValue, JsonValue>) | undefined;
     events: {
-        [x: string]: ChannelEventHandler | undefined;
+        [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;
+        "pending.created"?: ChannelEventHandler | undefined;
+        "pending.resolved"?: ChannelEventHandler | undefined;
     };
 };
 export declare const GET: (path: string, handler: RouteHandler) => HttpChannelRouteDefinitionIface;

package/dist/modules/authoring/channels.mjs

@@ -3,6 +3,7 @@ import {
   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) => {
@@ -20,7 +21,9 @@ const defineChannel = (definition) => {
     {
       sessionId: ctx.sessionId ?? null,
       turnId: ctx.turn.id,
-      state: ctx.state
+      state: ctx.state,
+      config: ctx.config,
+      secrets: ctx.secrets
     }
   );
   const semantic = {
@@ -58,6 +61,7 @@ export {
   POST,
   PUT,
   WS,
+  channelAccessors2 as channelAccessors,
   defineChannel,
   defineProviderChannel,
   disableChannel

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/authoring/channels.ts"],
-  "sourcesContent": ["import type {\n  AcpUpdateKind,\n  ChannelAddressContextIface,\n  ChannelDefinitionIface,\n  ChannelEventHandler,\n  ChannelReceiveContextIface,\n  ChannelReceiveResult,\n  ChannelSemanticDataByKindIface,\n  HttpChannelRouteDefinitionIface,\n  JsonObject,\n  JsonValue,\n  PendingEventKind,\n  ProjectionContextIface,\n  TurnPolicy,\n  WebSocketChannelRouteDefinitionIface,\n} from '@finalai/agent-provider';\nimport {\n  channelAccessors,\n  channelMessageCompletedSchema,\n  jsonObjectSchema,\n} 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`, pending requests `apnd_\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?: Partial<Record<AcpUpdateKind | `${PendingEventKind}`, ChannelEventHandler>> &\n    AuthoredSemanticEventsIface;\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}\nexport type AuthoredSemanticEventsIface = {\n  [Kind in keyof ChannelSemanticDataByKindIface]?: (\n    data: ChannelSemanticDataByKindIface[Kind],\n    channel: AuthoredChannelContextIface,\n    ctx: AuthoredSessionContextIface,\n  ) => void | Promise<void>;\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            },\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": "AAgBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,YAAY,OAAO;AACnB,SAAS,cAAc,aAAa;AAkD7B,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,IACb;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": []
+  "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  PendingEventKind,\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 (`pending.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`, pending requests `apnd_\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)`; pending\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 `${PendingEventKind}` | 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"]
 }

package/package.json

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