@jsm-mit/agent-platform-canister-package 0.2.0 → 0.3.0

package/README.md

@@ -90,6 +90,25 @@ const history = await chatHistoryActor.getConversationHistoryAsyncUnsafe(
 );
 ```
 
+### Config change notifications (0.3.0)
+
+The canister can report every real create, change or delete of an agent config
+as one task on a rabbit-motoko channel, so agents-village reloads only that
+agent. `commonId` is the agent id, the payload is
+`{"agentId":"<id>","change":"upserted"|"deleted"}`. Writing identical values
+and refused writes report nothing; a failed report is only logged on the
+canister, the write stands. The agent-platform canister must be allowed to add
+tasks on the channel in rabbit. Admin only.
+
+```typescript
+await adminActor.setConfigChangeNotificationsAsyncUnsafe({
+    rabbitCanisterId: "6aigz-vyaaa-aaaag-ayjqa-cai",
+    channel: "agent-config-changes",
+});
+const settings = await adminActor.getConfigChangeNotificationsAsyncUnsafe(); // or null
+await adminActor.setConfigChangeNotificationsAsyncUnsafe(null); // switch off
+```
+
 ## Error model
 
 Every `...AsyncUnsafe` method throws one of exactly three errors — switch on
@@ -111,7 +130,8 @@ Every `...AsyncUnsafe` method throws one of exactly three errors — switch on
 - `AdminActor` — admin allowlist and diagnostics: `registerAsAdminAsyncUnsafe`,
   `addAdminAsyncUnsafe`, `removeAdminAsyncUnsafe`, `getAdminsAsyncUnsafe`,
   `setLoggingEnabledAsyncUnsafe`, `whoAmIAsyncUnsafe`, `getLogsAsyncUnsafe`,
-  `clearLogsAsyncUnsafe`.
+  `clearLogsAsyncUnsafe`, `setConfigChangeNotificationsAsyncUnsafe`,
+  `getConfigChangeNotificationsAsyncUnsafe` (`ConfigChangeNotificationsSettings | null`).
 - Configs/messages are returned as `AgentConfigView`/`ChatMessageView` (opts
   flattened to optionals, the message role variant as a
   `"user" | "assistant" | "tool"` string union); raw candid types remain

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

@@ -13,36 +13,44 @@ type ToolBinding =
    paramsJson: text;
    tool: text;
  };
+type SetConfigChangeNotificationsArgs = record {
+                                          settings:
+                                           opt ConfigChangeNotifications;};
 type SetAgentPersonaArgs = 
  record {
    agentId: AgentId;
    persona: text;
  };
-type Result_6 = 
+type Result_7 = 
  variant {
    err: Error;
    ok;
  };
-type Result_5 = 
+type Result_6 = 
  variant {
    err: Error;
    ok: vec principal;
  };
-type Result_4 = 
+type Result_5 = 
  variant {
    err: Error;
    ok: vec ChatMessage;
  };
-type Result_3 = 
+type Result_4 = 
  variant {
    err: Error;
    ok: vec AgentConfigView;
  };
-type Result_2 = 
+type Result_3 = 
  variant {
    err: Error;
    ok: principal;
  };
+type Result_2 = 
+ variant {
+   err: Error;
+   ok: opt ConfigChangeNotifications;
+ };
 type Result_1 = 
  variant {
    err: Error;
@@ -80,6 +88,11 @@ type Error =
    logsJson: text;
  };
 type ConversationId = text;
+type ConfigChangeNotifications = 
+ record {
+   channel: text;
+   rabbitCanisterId: principal;
+ };
 type ChatMessageRole = 
  variant {
    assistant;
@@ -114,22 +127,26 @@ service : {
   addAdmin: ("principal": principal) -> (Result_1);
   /// Trusts another app's canister with agents of its own (Sultana's core). Admin only.
   addApp: (args: AppArgs) -> (Result_1);
-  appendMessageBatch: (args: AppendMessageBatchArgs) -> (Result_6);
+  appendMessageBatch: (args: AppendMessageBatchArgs) -> (Result_7);
   clearLogs: () -> ();
-  deleteAgentConfig: (id: AgentId) -> (Result_6);
-  getAdmins: () -> (Result_5) query;
+  deleteAgentConfig: (id: AgentId) -> (Result_7);
+  getAdmins: () -> (Result_6) query;
   getAgentConfig: (id: AgentId) -> (Result) query;
-  getApps: () -> (Result_5) query;
+  getApps: () -> (Result_6) query;
+  getConfigChangeNotifications: () -> (Result_2) query;
   getConversationHistory: (args: GetConversationHistoryArgs) ->
-   (Result_4) query;
+   (Result_5) query;
   getLogs: () -> (text) query;
-  listAgentConfigs: (limit: nat) -> (Result_3) query;
-  registerAsAdmin: () -> (Result_2);
+  listAgentConfigs: (limit: nat) -> (Result_4) query;
+  registerAsAdmin: () -> (Result_3);
   removeAdmin: ("principal": principal) -> (Result_1);
   removeApp: (args: AppArgs) -> (Result_1);
   /// The one field an agent's owner may change — the salon owner editing what their
   /// receptionist says. Admins and the creating app may use it too.
   setAgentPersona: (args: SetAgentPersonaArgs) -> (Result);
+  /// Where agent configuration changes are reported; null switches the reports off. Admin only.
+  setConfigChangeNotifications: (args: SetConfigChangeNotificationsArgs) ->
+   (Result_2);
   setLoggingEnabled: (enabled: bool) -> (Result_1);
   upsertAgentConfig: (args: UpsertAgentConfigArgs) -> (Result);
   whoAmI: () -> (principal) query;

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

@@ -27,6 +27,10 @@ export interface ChatMessage {
 export type ChatMessageRole = { 'tool' : null } |
   { 'user' : null } |
   { 'assistant' : null };
+export interface ConfigChangeNotifications {
+  'rabbitCanisterId' : Principal,
+  'channel' : string,
+}
 export type ConversationId = string;
 export interface Error { 'details' : ErrorDetails, 'logsJson' : string }
 export type ErrorDetails = { 'InterCanisterConnectionError' : null } |
@@ -49,17 +53,22 @@ export type Result = { 'ok' : AgentConfigView } |
   { 'err' : Error };
 export type Result_1 = { 'ok' : boolean } |
   { 'err' : Error };
-export type Result_2 = { 'ok' : Principal } |
+export type Result_2 = { 'ok' : [] | [ConfigChangeNotifications] } |
+  { 'err' : Error };
+export type Result_3 = { 'ok' : Principal } |
   { 'err' : Error };
-export type Result_3 = { 'ok' : Array<AgentConfigView> } |
+export type Result_4 = { 'ok' : Array<AgentConfigView> } |
   { 'err' : Error };
-export type Result_4 = { 'ok' : Array<ChatMessage> } |
+export type Result_5 = { 'ok' : Array<ChatMessage> } |
   { 'err' : Error };
-export type Result_5 = { 'ok' : Array<Principal> } |
+export type Result_6 = { 'ok' : Array<Principal> } |
   { 'err' : Error };
-export type Result_6 = { 'ok' : null } |
+export type Result_7 = { 'ok' : null } |
   { 'err' : Error };
 export interface SetAgentPersonaArgs { 'agentId' : AgentId, 'persona' : string }
+export interface SetConfigChangeNotificationsArgs {
+  'settings' : [] | [ConfigChangeNotifications],
+}
 export interface ToolBinding { 'paramsJson' : string, 'tool' : string }
 export interface UpsertAgentConfigArgs {
   'id' : AgentId,
@@ -76,19 +85,20 @@ export interface _SERVICE {
    * / Trusts another app's canister with agents of its own (Sultana's core). Admin only.
    */
   'addApp' : ActorMethod<[AppArgs], Result_1>,
-  'appendMessageBatch' : ActorMethod<[AppendMessageBatchArgs], Result_6>,
+  'appendMessageBatch' : ActorMethod<[AppendMessageBatchArgs], Result_7>,
   'clearLogs' : ActorMethod<[], undefined>,
-  'deleteAgentConfig' : ActorMethod<[AgentId], Result_6>,
-  'getAdmins' : ActorMethod<[], Result_5>,
+  'deleteAgentConfig' : ActorMethod<[AgentId], Result_7>,
+  'getAdmins' : ActorMethod<[], Result_6>,
   'getAgentConfig' : ActorMethod<[AgentId], Result>,
-  'getApps' : ActorMethod<[], Result_5>,
+  'getApps' : ActorMethod<[], Result_6>,
+  'getConfigChangeNotifications' : ActorMethod<[], Result_2>,
   'getConversationHistory' : ActorMethod<
     [GetConversationHistoryArgs],
-    Result_4
+    Result_5
   >,
   'getLogs' : ActorMethod<[], string>,
-  'listAgentConfigs' : ActorMethod<[bigint], Result_3>,
-  'registerAsAdmin' : ActorMethod<[], Result_2>,
+  'listAgentConfigs' : ActorMethod<[bigint], Result_4>,
+  'registerAsAdmin' : ActorMethod<[], Result_3>,
   'removeAdmin' : ActorMethod<[Principal], Result_1>,
   'removeApp' : ActorMethod<[AppArgs], Result_1>,
   /**
@@ -96,6 +106,13 @@ export interface _SERVICE {
    * / receptionist says. Admins and the creating app may use it too.
    */
   'setAgentPersona' : ActorMethod<[SetAgentPersonaArgs], Result>,
+  /**
+   * / Where agent configuration changes are reported; null switches the reports off. Admin only.
+   */
+  'setConfigChangeNotifications' : ActorMethod<
+    [SetConfigChangeNotificationsArgs],
+    Result_2
+  >,
   'setLoggingEnabled' : ActorMethod<[boolean], Result_1>,
   'upsertAgentConfig' : ActorMethod<[UpsertAgentConfigArgs], Result>,
   'whoAmI' : ActorMethod<[], Principal>,

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

@@ -33,8 +33,8 @@ export const idlFactory = ({ IDL }) => {
   const AppendMessageBatchArgs = IDL.Record({
     'entries' : IDL.Vec(MessageBatchEntry),
   });
-  const Result_6 = IDL.Variant({ 'ok' : IDL.Null, 'err' : Error });
-  const Result_5 = IDL.Variant({
+  const Result_7 = IDL.Variant({ 'ok' : IDL.Null, 'err' : Error });
+  const Result_6 = IDL.Variant({
     'ok' : IDL.Vec(IDL.Principal),
     'err' : Error,
   });
@@ -55,20 +55,31 @@ export const idlFactory = ({ IDL }) => {
     'customConfigJson' : IDL.Opt(IDL.Text),
   });
   const Result = IDL.Variant({ 'ok' : AgentConfigView, 'err' : Error });
+  const ConfigChangeNotifications = IDL.Record({
+    'rabbitCanisterId' : IDL.Principal,
+    'channel' : IDL.Text,
+  });
+  const Result_2 = IDL.Variant({
+    'ok' : IDL.Opt(ConfigChangeNotifications),
+    'err' : Error,
+  });
   const GetConversationHistoryArgs = IDL.Record({
     'limit' : IDL.Nat,
     'conversationId' : ConversationId,
   });
-  const Result_4 = IDL.Variant({ 'ok' : IDL.Vec(ChatMessage), 'err' : Error });
-  const Result_3 = IDL.Variant({
+  const Result_5 = IDL.Variant({ 'ok' : IDL.Vec(ChatMessage), 'err' : Error });
+  const Result_4 = IDL.Variant({
     'ok' : IDL.Vec(AgentConfigView),
     'err' : Error,
   });
-  const Result_2 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
+  const Result_3 = IDL.Variant({ 'ok' : IDL.Principal, 'err' : Error });
   const SetAgentPersonaArgs = IDL.Record({
     'agentId' : AgentId,
     'persona' : IDL.Text,
   });
+  const SetConfigChangeNotificationsArgs = IDL.Record({
+    'settings' : IDL.Opt(ConfigChangeNotifications),
+  });
   const UpsertAgentConfigArgs = IDL.Record({
     'id' : AgentId,
     'tools' : IDL.Vec(ToolBinding),
@@ -81,23 +92,29 @@ export const idlFactory = ({ IDL }) => {
   return IDL.Service({
     'addAdmin' : IDL.Func([IDL.Principal], [Result_1], []),
     'addApp' : IDL.Func([AppArgs], [Result_1], []),
-    'appendMessageBatch' : IDL.Func([AppendMessageBatchArgs], [Result_6], []),
+    'appendMessageBatch' : IDL.Func([AppendMessageBatchArgs], [Result_7], []),
     'clearLogs' : IDL.Func([], [], []),
-    'deleteAgentConfig' : IDL.Func([AgentId], [Result_6], []),
-    'getAdmins' : IDL.Func([], [Result_5], ['query']),
+    'deleteAgentConfig' : IDL.Func([AgentId], [Result_7], []),
+    'getAdmins' : IDL.Func([], [Result_6], ['query']),
     'getAgentConfig' : IDL.Func([AgentId], [Result], ['query']),
-    'getApps' : IDL.Func([], [Result_5], ['query']),
+    'getApps' : IDL.Func([], [Result_6], ['query']),
+    'getConfigChangeNotifications' : IDL.Func([], [Result_2], ['query']),
     'getConversationHistory' : IDL.Func(
         [GetConversationHistoryArgs],
-        [Result_4],
+        [Result_5],
         ['query'],
       ),
     'getLogs' : IDL.Func([], [IDL.Text], ['query']),
-    'listAgentConfigs' : IDL.Func([IDL.Nat], [Result_3], ['query']),
-    'registerAsAdmin' : IDL.Func([], [Result_2], []),
+    'listAgentConfigs' : IDL.Func([IDL.Nat], [Result_4], ['query']),
+    'registerAsAdmin' : IDL.Func([], [Result_3], []),
     'removeAdmin' : IDL.Func([IDL.Principal], [Result_1], []),
     'removeApp' : IDL.Func([AppArgs], [Result_1], []),
     'setAgentPersona' : IDL.Func([SetAgentPersonaArgs], [Result], []),
+    'setConfigChangeNotifications' : IDL.Func(
+        [SetConfigChangeNotificationsArgs],
+        [Result_2],
+        [],
+      ),
     'setLoggingEnabled' : IDL.Func([IDL.Bool], [Result_1], []),
     'upsertAgentConfig' : IDL.Func([UpsertAgentConfigArgs], [Result], []),
     'whoAmI' : IDL.Func([], [IDL.Principal], ['query']),

package/dist/actors/admin-actor.d.ts

@@ -1,5 +1,6 @@
 import { type Identity } from "@icp-sdk/core/agent";
 import { ActorBase, type LogEntry } from "../actor-base.js";
+import type { ConfigChangeNotificationsSettings } from "../interfaces.js";
 /** 1:1 wrapper for the canister's AdminController plus the diagnostic endpoints
  * (whoAmI, getLogs, clearLogs). */
 export declare class AdminActor extends ActorBase {
@@ -96,5 +97,27 @@ export declare class AdminActor extends ActorBase {
      * @throws Error with message `CallRefusedAtInspectionStage` when the canister's `inspect` rejects the call before execution.
      */
     getAppsAsyncUnsafe(): Promise<string[]>;
+    /**
+     * Points the canister's agent configuration change reports at a rabbit-motoko channel,
+     * or switches them off with `null`. Once set, every real create, change or delete of
+     * an agent config adds one task there (commonId = the agent id, payload
+     * `{"agentId":"<id>","change":"upserted"|"deleted"}`), so agents-village reloads only
+     * that agent. The canister must be allowed to add tasks on the channel in rabbit. Admin
+     * only.
+     * @param settings - The rabbit canister (text form) and channel, or `null` to switch off.
+     * @returns The committed settings.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, errorKey `InvalidData` for an anonymous canister or an empty / longer than 100 chars channel). 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.
+     * @throws Error with message `CallRefusedAtInspectionStage` when the canister's `inspect` rejects the call before execution.
+     */
+    setConfigChangeNotificationsAsyncUnsafe(settings: ConfigChangeNotificationsSettings | null): Promise<ConfigChangeNotificationsSettings | null>;
+    /**
+     * Where the canister reports agent configuration changes; `null` when the reports are
+     * off. Admin only.
+     * @throws Error with message `CanisterError` when the caller is not the admin. 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.
+     * @throws Error with message `CallRefusedAtInspectionStage` when the canister's `inspect` rejects the call before execution.
+     */
+    getConfigChangeNotificationsAsyncUnsafe(): Promise<ConfigChangeNotificationsSettings | null>;
 }
 //# sourceMappingURL=admin-actor.d.ts.map

package/dist/actors/admin-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-actor.d.ts","sourceRoot":"","sources":["../../src/actors/admin-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5D;mCACmC;AACnC,qBAAa,UAAW,SAAQ,SAAS;gBACzB,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;OAMG;IACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAOjD;;;;;;;OAOG;IACU,kBAAkB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOtD;;;;OAIG;IACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlD;;;;;;OAMG;IACU,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzE;;;;;;;OAOG;IACU,sBAAsB,CAC/B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;OAMG;IACU,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtD;;;;;;;;OAQG;IACU,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAO1D;;;;;;;OAOG;IACU,4BAA4B,CACrC,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;;;OAQG;IACU,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;;;;;OAMG;IACU,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1E;;;;;OAKG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAIvD"}
+{"version":3,"file":"admin-actor.d.ts","sourceRoot":"","sources":["../../src/actors/admin-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AAG1E;mCACmC;AACnC,qBAAa,UAAW,SAAQ,SAAS;gBACzB,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;OAMG;IACU,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAOjD;;;;;;;OAOG;IACU,kBAAkB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAOtD;;;;OAIG;IACU,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlD;;;;;;OAMG;IACU,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzE;;;;;;;OAOG;IACU,sBAAsB,CAC/B,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;OAMG;IACU,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAOtD;;;;;;;;OAQG;IACU,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAO1D;;;;;;;OAOG;IACU,4BAA4B,CACrC,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC,OAAO,CAAC;IAMnB;;;;;;;;OAQG;IACU,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMvE;;;;;;OAMG;IACU,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM1E;;;;;OAKG;IACU,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKpD;;;;;;;;;;;;OAYG;IACU,uCAAuC,CAChD,QAAQ,EAAE,iCAAiC,GAAG,IAAI,GACnD,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC;IAmBpD;;;;;;OAMG;IACU,uCAAuC,IAAI,OAAO,CAAC,iCAAiC,GAAG,IAAI,CAAC;CAM5G"}

package/dist/actors/admin-actor.js

@@ -2,6 +2,7 @@ import {} from "@icp-sdk/core/agent";
 import { Principal } from "@icp-sdk/core/principal";
 import { BetterJSON } from "@jsm-mit/utils-package";
 import { ActorBase } from "../actor-base.js";
+import { mapConfigChangeNotificationsSettings } from "../mappers.js";
 /** 1:1 wrapper for the canister's AdminController plus the diagnostic endpoints
  * (whoAmI, getLogs, clearLogs). */
 export class AdminActor extends ActorBase {
@@ -127,4 +128,41 @@ export class AdminActor extends ActorBase {
         const apps = await this.executeFunctionAsyncUnsafe(() => this.actor.getApps());
         return apps.map((principal) => principal.toString());
     }
+    /**
+     * Points the canister's agent configuration change reports at a rabbit-motoko channel,
+     * or switches them off with `null`. Once set, every real create, change or delete of
+     * an agent config adds one task there (commonId = the agent id, payload
+     * `{"agentId":"<id>","change":"upserted"|"deleted"}`), so agents-village reloads only
+     * that agent. The canister must be allowed to add tasks on the channel in rabbit. Admin
+     * only.
+     * @param settings - The rabbit canister (text form) and channel, or `null` to switch off.
+     * @returns The committed settings.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, errorKey `InvalidData` for an anonymous canister or an empty / longer than 100 chars channel). 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.
+     * @throws Error with message `CallRefusedAtInspectionStage` when the canister's `inspect` rejects the call before execution.
+     */
+    async setConfigChangeNotificationsAsyncUnsafe(settings) {
+        const committed = await this.executeFunctionAsyncUnsafe(() => this.actor.setConfigChangeNotifications({
+            settings: settings === null
+                ? []
+                : [
+                    {
+                        rabbitCanisterId: Principal.fromText(settings.rabbitCanisterId),
+                        channel: settings.channel,
+                    },
+                ],
+        }));
+        return mapConfigChangeNotificationsSettings(committed);
+    }
+    /**
+     * Where the canister reports agent configuration changes; `null` when the reports are
+     * off. Admin only.
+     * @throws Error with message `CanisterError` when the caller is not the admin. 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.
+     * @throws Error with message `CallRefusedAtInspectionStage` when the canister's `inspect` rejects the call before execution.
+     */
+    async getConfigChangeNotificationsAsyncUnsafe() {
+        const settings = await this.executeFunctionAsyncUnsafe(() => this.actor.getConfigChangeNotifications());
+        return mapConfigChangeNotificationsSettings(settings);
+    }
 }

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { ActorBase, type LogEntry } from "./actor-base.js";
 export { AdminActor } from "./actors/admin-actor.js";
 export { AgentConfigsActor } from "./actors/agent-configs-actor.js";
 export { ChatHistoryActor } from "./actors/chat-history-actor.js";
-export type { ChatMessageRoleView, ChatMessageView, MessageBatchEntryInput, AgentConfigView, UpsertAgentConfigInput, } from "./interfaces.js";
-export { mapChatMessageRoleView, mapChatMessageView, mapAgentConfigView, } from "./mappers.js";
+export type { ChatMessageRoleView, ChatMessageView, MessageBatchEntryInput, AgentConfigView, UpsertAgentConfigInput, ConfigChangeNotificationsSettings, } from "./interfaces.js";
+export { mapChatMessageRoleView, mapChatMessageView, mapAgentConfigView, mapConfigChangeNotificationsSettings, } from "./mappers.js";
 export type { ToolBinding, Error as CanisterErrorShape, ErrorDetails, } from "../declarations/agent-platform-canister/agent-platform-canister.did.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EACR,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EACR,WAAW,EACX,KAAK,IAAI,kBAAkB,EAC3B,YAAY,GACf,MAAM,wEAAwE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EACR,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,sBAAsB,EACtB,iCAAiC,GACpC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,oCAAoC,GACvC,MAAM,cAAc,CAAC;AACtB,YAAY,EACR,WAAW,EACX,KAAK,IAAI,kBAAkB,EAC3B,YAAY,GACf,MAAM,wEAAwE,CAAC"}

package/dist/index.js

@@ -2,4 +2,4 @@ export { ActorBase } from "./actor-base.js";
 export { AdminActor } from "./actors/admin-actor.js";
 export { AgentConfigsActor } from "./actors/agent-configs-actor.js";
 export { ChatHistoryActor } from "./actors/chat-history-actor.js";
-export { mapChatMessageRoleView, mapChatMessageView, mapAgentConfigView, } from "./mappers.js";
+export { mapChatMessageRoleView, mapChatMessageView, mapAgentConfigView, mapConfigChangeNotificationsSettings, } from "./mappers.js";

package/dist/interfaces.d.ts

@@ -50,6 +50,16 @@ export interface AgentConfigView {
     /** Nanoseconds since epoch */
     updatedAt: bigint;
 }
+/** Where the canister reports agent configuration changes: a task on this rabbit-motoko
+ * canister's channel for every real create, change or delete of an agent config
+ * (commonId = the agent id, payload `{"agentId":"<id>","change":"upserted"|"deleted"}`).
+ * Candid `opt ConfigChangeNotifications` with the principal as text; `null` = reports off. */
+export interface ConfigChangeNotificationsSettings {
+    /** The rabbit-motoko canister (text form). The agent-platform canister must be allowed
+     * to add tasks on the channel there. */
+    rabbitCanisterId: string;
+    channel: string;
+}
 /** Input for AgentConfigsActor.upsertAgentConfigAsyncUnsafe — customConfigJson as a
  * plain optional (candid `opt` shaping done by the wrapper); tools is optional here
  * even though the canister's own UpsertAgentConfigArgs requires it — the wrapper

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;;;;iEAI6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;uBAEmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,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;IAC1B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"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;;;;iEAI6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;uBAEmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;8FAG8F;AAC9F,MAAM,WAAW,iCAAiC;IAC9C;4CACwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACnB;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;IAC1B,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/mappers.d.ts

@@ -1,9 +1,10 @@
-import type { AgentConfigView as CandidAgentConfig, ChatMessage, ChatMessageRole } from "../declarations/agent-platform-canister/agent-platform-canister.did.js";
-import type { ChatMessageRoleView, ChatMessageView, AgentConfigView } from "./interfaces.js";
+import type { AgentConfigView as CandidAgentConfig, ChatMessage, ChatMessageRole, ConfigChangeNotifications as CandidConfigChangeNotifications } from "../declarations/agent-platform-canister/agent-platform-canister.did.js";
+import type { ChatMessageRoleView, ChatMessageView, AgentConfigView, ConfigChangeNotificationsSettings } 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 mapAgentConfigView(config: CandidAgentConfig): AgentConfigView;
+export declare function mapConfigChangeNotificationsSettings(settings: [] | [CandidConfigChangeNotifications]): ConfigChangeNotificationsSettings | null;
 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,eAAe,IAAI,iBAAiB,EACpC,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,iBAAiB,GAAG,eAAe,CAa7E;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,eAAe,IAAI,iBAAiB,EACpC,WAAW,EACX,eAAe,EACf,yBAAyB,IAAI,+BAA+B,EAC/D,MAAM,wEAAwE,CAAC;AAChF,OAAO,KAAK,EACR,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,iCAAiC,EACpC,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,iBAAiB,GAAG,eAAe,CAa7E;AAED,wBAAgB,oCAAoC,CAChD,QAAQ,EAAE,EAAE,GAAG,CAAC,+BAA+B,CAAC,GACjD,iCAAiC,GAAG,IAAI,CAQ1C;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/mappers.js

@@ -33,4 +33,13 @@ export function mapAgentConfigView(config) {
         updatedAt: config.updatedAt,
     };
 }
+export function mapConfigChangeNotificationsSettings(settings) {
+    const value = fromOpt(settings);
+    if (value === undefined)
+        return null;
+    return {
+        rabbitCanisterId: value.rabbitCanisterId.toText(),
+        channel: value.channel,
+    };
+}
 export { toOpt };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@jsm-mit/agent-platform-canister-package",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "description": "Wrapper TypeScript package for the agent-platform-canister canister.",
     "license": "ISC",
     "author": "",
@@ -26,6 +26,7 @@
         "typecheck": "tsc --noEmit -p tsconfig.tests.json",
         "sync-declarations": "bash scripts/sync-declarations.sh",
         "test-suite": "bash scripts/run-tests.sh tests/test-suite.ts",
+        "redeploy": "bash scripts/redeploy.sh",
         "sandbox": "npx tsx sandbox/main.ts",
         "format": "prettier --write .",
         "format:check": "prettier --check .",
@@ -49,6 +50,6 @@
     "agentPlatformCanister": {
         "repo": "agent-platform-canister",
         "repoUrl": "https://github.com/JSM-Agent-Platform/agent-platform-canister",
-        "commit": "2d302e673013d54083babbbb9aa79eb718d7bf74"
+        "commit": "ef1892ea4ce350afd6dc13e1452167aa7e9b4970"
     }
 }