@jsm-mit/agent-platform-canister-package 0.0.1 → 0.0.2

package/declarations/agent-platform-canister/agent-platform-canister.did

@@ -1,5 +1,6 @@
 type UpsertAgentConfigArgs = 
  record {
+   channelType: ChannelType;
    customConfigJson: opt text;
    disclosesAsAi: bool;
    id: AgentId;
@@ -88,10 +89,16 @@ type ChatMessage =
    toolCallId: opt text;
    toolName: opt text;
  };
+type ChannelType = 
+ variant {
+   chat;
+   whatsapp;
+ };
 type AppendMessageBatchArgs = record {entries: vec MessageBatchEntry;};
 type AgentId = text;
 type AgentConfig = 
  record {
+   channelType: opt ChannelType;
    createdAt: int;
    customConfigJson: opt text;
    disclosesAsAi: bool;

package/declarations/agent-platform-canister/agent-platform-canister.did.d.ts

@@ -5,6 +5,7 @@ import type { IDL } from "@icp-sdk/core/candid";
 export interface AgentConfig {
     id: AgentId;
     tools: Array<ToolBinding>;
+    channelType: [] | [ChannelType];
     name: string;
     createdAt: bigint;
     updatedAt: bigint;
@@ -16,6 +17,7 @@ export type AgentId = string;
 export interface AppendMessageBatchArgs {
     entries: Array<MessageBatchEntry>;
 }
+export type ChannelType = { chat: null } | { whatsapp: null };
 export interface ChatMessage {
     content: string;
     role: ChatMessageRole;
@@ -61,6 +63,7 @@ export interface ToolBinding {
 export interface UpsertAgentConfigArgs {
     id: AgentId;
     tools: Array<ToolBinding>;
+    channelType: ChannelType;
     name: string;
     persona: string;
     disclosesAsAi: boolean;

package/declarations/agent-platform-canister/agent-platform-canister.did.js

@@ -41,9 +41,11 @@ export const idlFactory = ({ IDL }) => {
         paramsJson: IDL.Text,
         tool: IDL.Text,
     });
+    const ChannelType = IDL.Variant({ chat: IDL.Null, whatsapp: IDL.Null });
     const AgentConfig = IDL.Record({
         id: AgentId,
         tools: IDL.Vec(ToolBinding),
+        channelType: IDL.Opt(ChannelType),
         name: IDL.Text,
         createdAt: IDL.Int,
         updatedAt: IDL.Int,
@@ -62,6 +64,7 @@ export const idlFactory = ({ IDL }) => {
     const UpsertAgentConfigArgs = IDL.Record({
         id: AgentId,
         tools: IDL.Vec(ToolBinding),
+        channelType: ChannelType,
         name: IDL.Text,
         persona: IDL.Text,
         disclosesAsAi: IDL.Bool,

package/dist/actors/agent-configs-actor.d.ts

@@ -8,7 +8,8 @@ export declare class AgentConfigsActor extends ActorBase {
      * Creates the config on first write, otherwise updates it in place —
      * `createdAt` is preserved across an update. Admin only.
      * @param input - The full desired config; `id` decides create-vs-update. `tools`
-     * defaults to [] (a tool-less agent) when omitted.
+     * defaults to [] (a tool-less agent) when omitted. `channelType` is required —
+     * every agent must declare which outbound channel it uses.
      * @returns The stored config as it now stands.
      * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, or `InvalidData` — a bounded field was too long/too many entries). Examine "cause" for {errorKey, errorMessage, logs}.
      * @throws Error with message `CriticalCanisterError` when there is no communication with the canister or the canister code traps during execution.

package/dist/actors/agent-configs-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-configs-actor.d.ts","sourceRoot":"","sources":["../../src/actors/agent-configs-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,6DAA6D;AAC7D,qBAAa,iBAAkB,SAAQ,SAAS;gBAChC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;;;;OASG;IACU,4BAA4B,CACrC,KAAK,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAc3B;;;;;;OAMG;IACU,yBAAyB,CAClC,EAAE,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC;IAO3B;;;;;;;OAOG;IACU,2BAA2B,CACpC,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;;OAMG;IACU,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKvE"}
+{"version":3,"file":"agent-configs-actor.d.ts","sourceRoot":"","sources":["../../src/actors/agent-configs-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAGhF,6DAA6D;AAC7D,qBAAa,iBAAkB,SAAQ,SAAS;gBAChC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;;;;;OAUG;IACU,4BAA4B,CACrC,KAAK,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC;IAe3B;;;;;;OAMG;IACU,yBAAyB,CAClC,EAAE,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC;IAO3B;;;;;;;OAOG;IACU,2BAA2B,CACpC,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC;IAO7B;;;;;;OAMG;IACU,4BAA4B,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKvE"}

package/dist/actors/agent-configs-actor.js

@@ -1,6 +1,6 @@
 import {} from "@icp-sdk/core/agent";
 import { ActorBase } from "../actor-base.js";
-import { mapAgentConfigView, toOpt } from "../mappers.js";
+import { mapAgentConfigView, toChannelTypeVariant, toOpt } from "../mappers.js";
 /** 1:1 wrapper for the canister's AgentConfigsController. */
 export class AgentConfigsActor extends ActorBase {
     constructor(canisterId, identity) {
@@ -10,7 +10,8 @@ export class AgentConfigsActor extends ActorBase {
      * Creates the config on first write, otherwise updates it in place —
      * `createdAt` is preserved across an update. Admin only.
      * @param input - The full desired config; `id` decides create-vs-update. `tools`
-     * defaults to [] (a tool-less agent) when omitted.
+     * defaults to [] (a tool-less agent) when omitted. `channelType` is required —
+     * every agent must declare which outbound channel it uses.
      * @returns The stored config as it now stands.
      * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, or `InvalidData` — a bounded field was too long/too many entries). Examine "cause" for {errorKey, errorMessage, logs}.
      * @throws Error with message `CriticalCanisterError` when there is no communication with the canister or the canister code traps during execution.
@@ -24,6 +25,7 @@ export class AgentConfigsActor extends ActorBase {
             disclosesAsAi: input.disclosesAsAi,
             tools: input.tools ?? [],
             customConfigJson: toOpt(input.customConfigJson),
+            channelType: toChannelTypeVariant(input.channelType),
         }));
         return mapAgentConfigView(config);
     }

package/dist/interfaces.d.ts

@@ -1,4 +1,8 @@
 export type ChatMessageRoleView = "user" | "assistant" | "tool";
+/** Which outbound channel an agent's replies go out on — decided once at creation,
+ * per AGENT-PLATFORM decision 2026-08-19. "chat" is accepted/stored but nothing
+ * downstream acts on it yet — only "whatsapp" is implemented (agents-village). */
+export type ChannelTypeView = "whatsapp" | "chat";
 /** Candid `ChatMessage` with the role variant as a string union and opts flattened —
  * matches chat-agent-package's own ChatMessage shape so history round-trips without
  * further translation on the consumer side. */
@@ -34,6 +38,9 @@ export interface AgentConfigView {
         paramsJson: string;
     }[];
     customConfigJson?: string;
+    /** Undefined only for an agent created before this field existed and not yet
+     * re-saved — every agent upserted through UpsertAgentConfigInput always has one. */
+    channelType?: ChannelTypeView;
     /** Nanoseconds since epoch */
     createdAt: bigint;
     /** Nanoseconds since epoch */
@@ -43,7 +50,8 @@ export interface AgentConfigView {
  * plain optional (candid `opt` shaping done by the wrapper); tools is optional here
  * even though the canister's own UpsertAgentConfigArgs requires it — the wrapper
  * defaults a missing tools to [] for a tool-less agent, so callers don't have to
- * spell out `tools: []` every time. */
+ * spell out `tools: []` every time. channelType is required — the canister's own
+ * UpsertAgentConfigArgs requires it too, per AGENT-PLATFORM decision 2026-08-19. */
 export interface UpsertAgentConfigInput {
     id: string;
     name: string;
@@ -54,5 +62,6 @@ export interface UpsertAgentConfigInput {
         paramsJson: string;
     }[];
     customConfigJson?: string;
+    channelType: ChannelTypeView;
 }
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE;;+CAE+C;AAC/C,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;wEACwE;AACxE,MAAM,WAAW,sBAAsB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACL,IAAI,EAAE,mBAAmB,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;uCAIuC;AACvC,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE;;kFAEkF;AAClF,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,MAAM,CAAC;AAElD;;+CAE+C;AAC/C,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;wEACwE;AACxE,MAAM,WAAW,sBAAsB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACL,IAAI,EAAE,mBAAmB,CAAC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL;AAED,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;wFACoF;IACpF,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;oFAKoF;AACpF,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,eAAe,CAAC;CAChC"}

package/dist/mappers.d.ts

@@ -1,9 +1,11 @@
-import type { AgentConfig, ChatMessage, ChatMessageRole } from "../declarations/agent-platform-canister/agent-platform-canister.did.js";
-import type { ChatMessageRoleView, ChatMessageView, AgentConfigView } from "./interfaces.js";
+import type { AgentConfig, ChannelType, ChatMessage, ChatMessageRole } from "../declarations/agent-platform-canister/agent-platform-canister.did.js";
+import type { ChannelTypeView, ChatMessageRoleView, ChatMessageView, AgentConfigView } from "./interfaces.js";
 declare function toOpt<T>(value: T | undefined): [] | [T];
 export declare function mapChatMessageRoleView(role: ChatMessageRole): ChatMessageRoleView;
 export declare function toChatMessageRoleVariant(role: ChatMessageRoleView): ChatMessageRole;
 export declare function mapChatMessageView(message: ChatMessage): ChatMessageView;
+export declare function mapChannelTypeView(channelType: ChannelType): ChannelTypeView;
+export declare function toChannelTypeVariant(channelType: ChannelTypeView): ChannelType;
 export declare function mapAgentConfigView(config: AgentConfig): AgentConfigView;
 export { toOpt };
 //# sourceMappingURL=mappers.d.ts.map

package/dist/mappers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACX,eAAe,EAClB,MAAM,wEAAwE,CAAC;AAChF,OAAO,KAAK,EACR,mBAAmB,EACnB,eAAe,EACf,eAAe,EAClB,MAAM,iBAAiB,CAAC;AAMzB,iBAAS,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAEhD;AAED,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,eAAe,GACtB,mBAAmB,CAErB;AAED,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,mBAAmB,GAC1B,eAAe,CAEjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAQxE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAWvE;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,WAAW,EACX,WAAW,EACX,WAAW,EACX,eAAe,EAClB,MAAM,wEAAwE,CAAC;AAChF,OAAO,KAAK,EACR,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,eAAe,EAClB,MAAM,iBAAiB,CAAC;AAMzB,iBAAS,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAEhD;AAED,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,eAAe,GACtB,mBAAmB,CAErB;AAED,wBAAgB,wBAAwB,CACpC,IAAI,EAAE,mBAAmB,GAC1B,eAAe,CAEjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAQxE;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,eAAe,CAE5E;AAED,wBAAgB,oBAAoB,CAChC,WAAW,EAAE,eAAe,GAC7B,WAAW,CAEb;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAiBvE;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/mappers.js

@@ -19,7 +19,14 @@ export function mapChatMessageView(message) {
         timestamp: message.timestamp,
     };
 }
+export function mapChannelTypeView(channelType) {
+    return Object.keys(channelType)[0];
+}
+export function toChannelTypeVariant(channelType) {
+    return { [channelType]: null };
+}
 export function mapAgentConfigView(config) {
+    const channelType = fromOpt(config.channelType);
     return {
         id: config.id,
         name: config.name,
@@ -27,6 +34,9 @@ export function mapAgentConfigView(config) {
         disclosesAsAi: config.disclosesAsAi,
         tools: config.tools,
         customConfigJson: fromOpt(config.customConfigJson),
+        channelType: channelType !== undefined
+            ? mapChannelTypeView(channelType)
+            : undefined,
         createdAt: config.createdAt,
         updatedAt: config.updatedAt,
     };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/agent-platform-canister-package",
-    "version": "0.0.1",
+    "version": "0.0.2",
     "description": "Wrapper TypeScript package for the agent-platform-canister canister.",
     "license": "ISC",
     "author": "",