@jsm-mit/chat-motoko-package 0.1.0

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

@@ -0,0 +1,77 @@
+import { type Identity } from "@icp-sdk/core/agent";
+import { ActorBase } from "../actor-base.js";
+import type { ChatView, CreateChatInput, GetMyChatsInput, InviteMemberInput, PolicyView, RemoveMemberInput } from "../interfaces.js";
+/** 1:1 wrapper for the canister's ChatsController — rooms, members, roles and policy. */
+export declare class ChatsActor extends ActorBase {
+    constructor(canisterId: string, identity?: Identity);
+    /**
+     * Creates a chat: the caller becomes `owner`, the project's agents join as `agent`, the
+     * canister writes the `chatCreated` event and — when given — the first text message,
+     * all in one call.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound` for the project, `InvalidData` for members/lengths/quotas). 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.
+     */
+    createChatAsyncUnsafe(input: CreateChatInput): Promise<ChatView>;
+    /**
+     * Adds a member. Owner/admin members, project admins, canister admins — and agent
+     * members when the project allows it (agents may only add `member`s).
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `AlreadyExists`, `InvalidData` for a closed chat / anonymous / limit). 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.
+     */
+    inviteMemberAsyncUnsafe(input: InviteMemberInput): Promise<ChatView>;
+    /**
+     * Removes somebody else; an owner can be removed only by a project admin.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for self-removal / closed chat). 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.
+     */
+    removeMemberAsyncUnsafe(input: RemoveMemberInput): Promise<ChatView>;
+    /**
+     * Leaves the chat. The last owner/admin of an open chat cannot leave — close it instead.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for the last manager). 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.
+     */
+    leaveChatAsyncUnsafe(chatId: string): Promise<boolean>;
+    /**
+     * Changes the policy agents read (e.g. `agentsReply: false` to hand the chat to a human).
+     * Same callers as inviteMember.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for a closed chat). 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.
+     */
+    setPolicyAsyncUnsafe(chatId: string, policy: PolicyView): Promise<ChatView>;
+    /**
+     * Closes the chat for good (no more posts or membership changes). Owner/admin members,
+     * project admins, canister admins — not agents.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` when already closed). 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.
+     */
+    closeChatAsyncUnsafe(chatId: string): Promise<ChatView>;
+    /**
+     * Deletes the chat and every message of it. Canister admin only; irreversible — the
+     * erasure path for personal data.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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.
+     */
+    purgeChatAsyncUnsafe(chatId: string): Promise<boolean>;
+    /**
+     * One chat with its members. Members, project admins, canister admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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.
+     */
+    getChatAsyncUnsafe(chatId: string): Promise<ChatView>;
+    /**
+     * The caller's chats in a project, newest first, optionally filtered by subject.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `InvalidData`). 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.
+     */
+    getMyChatsAsyncUnsafe(input: GetMyChatsInput): Promise<ChatView[]>;
+}
+//# sourceMappingURL=chats-actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chats-actor.d.ts","sourceRoot":"","sources":["../../src/actors/chats-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrI,yFAAyF;AACzF,qBAAa,UAAW,SAAQ,SAAS;gBAEzB,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;;OAOG;IACU,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC;IAc7E;;;;;;OAMG;IACU,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWjF;;;;;OAKG;IACU,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOjF;;;;;OAKG;IACU,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE;;;;;;OAMG;IACU,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOxF;;;;;;OAMG;IACU,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKpE;;;;;;OAMG;IACU,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE;;;;;OAKG;IACU,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAKlE;;;;;OAKG;IACU,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;CAWlF"}

package/dist/actors/chats-actor.js

@@ -0,0 +1,120 @@
+import {} from "@icp-sdk/core/agent";
+import { Principal } from "@icp-sdk/core/principal";
+import { ActorBase } from "../actor-base.js";
+import { mapChatView, toCandidMemberInput, toCandidRole, toOpt, toOptBigInt } from "../mappers.js";
+/** 1:1 wrapper for the canister's ChatsController — rooms, members, roles and policy. */
+export class ChatsActor extends ActorBase {
+    constructor(canisterId, identity) {
+        super(canisterId, identity);
+    }
+    /**
+     * Creates a chat: the caller becomes `owner`, the project's agents join as `agent`, the
+     * canister writes the `chatCreated` event and — when given — the first text message,
+     * all in one call.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound` for the project, `InvalidData` for members/lengths/quotas). 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 createChatAsyncUnsafe(input) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.createChat({
+            projectId: input.projectId,
+            members: (input.members ?? []).map(toCandidMemberInput),
+            policy: toOpt(input.policy === undefined ? undefined : { agentsReply: input.policy.agentsReply }),
+            title: toOpt(input.title),
+            subject: toOpt(input.subject),
+            firstMessage: toOpt(input.firstMessage),
+        }));
+        return mapChatView(chat);
+    }
+    /**
+     * Adds a member. Owner/admin members, project admins, canister admins — and agent
+     * members when the project allows it (agents may only add `member`s).
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `AlreadyExists`, `InvalidData` for a closed chat / anonymous / limit). 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 inviteMemberAsyncUnsafe(input) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.inviteMember({
+            chatId: input.chatId,
+            principal: Principal.fromText(input.principal),
+            role: toCandidRole(input.role),
+        }));
+        return mapChatView(chat);
+    }
+    /**
+     * Removes somebody else; an owner can be removed only by a project admin.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for self-removal / closed chat). 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 removeMemberAsyncUnsafe(input) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.removeMember({ chatId: input.chatId, principal: Principal.fromText(input.principal) }));
+        return mapChatView(chat);
+    }
+    /**
+     * Leaves the chat. The last owner/admin of an open chat cannot leave — close it instead.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for the last manager). 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 leaveChatAsyncUnsafe(chatId) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.leaveChat({ chatId }));
+    }
+    /**
+     * Changes the policy agents read (e.g. `agentsReply: false` to hand the chat to a human).
+     * Same callers as inviteMember.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for a closed chat). 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 setPolicyAsyncUnsafe(chatId, policy) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.setPolicy({ chatId, policy: { agentsReply: policy.agentsReply } }));
+        return mapChatView(chat);
+    }
+    /**
+     * Closes the chat for good (no more posts or membership changes). Owner/admin members,
+     * project admins, canister admins — not agents.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` when already closed). 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 closeChatAsyncUnsafe(chatId) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.closeChat({ chatId }));
+        return mapChatView(chat);
+    }
+    /**
+     * Deletes the chat and every message of it. Canister admin only; irreversible — the
+     * erasure path for personal data.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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 purgeChatAsyncUnsafe(chatId) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.purgeChat({ chatId }));
+    }
+    /**
+     * One chat with its members. Members, project admins, canister admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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 getChatAsyncUnsafe(chatId) {
+        const chat = await this.executeFunctionAsyncUnsafe(() => this.actor.getChat({ chatId }));
+        return mapChatView(chat);
+    }
+    /**
+     * The caller's chats in a project, newest first, optionally filtered by subject.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `InvalidData`). 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 getMyChatsAsyncUnsafe(input) {
+        const chats = await this.executeFunctionAsyncUnsafe(() => this.actor.getMyChats({
+            projectId: input.projectId,
+            subject: toOpt(input.subject),
+            includeClosed: input.includeClosed ?? false,
+            limit: toOptBigInt(input.limit),
+        }));
+        return chats.map(mapChatView);
+    }
+}

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

@@ -0,0 +1,43 @@
+import { type Identity } from "@icp-sdk/core/agent";
+import { ActorBase } from "../actor-base.js";
+import type { GetMessagesInput, MessageView, MessagesPageView, PollNewMessagesInput, PollResultView, PostInput } from "../interfaces.js";
+/** 1:1 wrapper for the canister's MessagesController. */
+export declare class MessagesActor extends ActorBase {
+    constructor(canisterId: string, identity?: Identity);
+    /**
+     * Posts a message as the caller. `text` for any member; `toolTrace` only for `agent`
+     * and `admin` members.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for empty/long text, closed or full chat, daily limit). 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.
+     */
+    postAsyncUnsafe(input: PostInput): Promise<MessageView>;
+    /** Like postAsyncUnsafe but never throws — returns null on any failure. */
+    postAsyncSafe(input: PostInput): Promise<MessageView | null>;
+    /**
+     * Records that the caller has read up to `seq` (never moves backwards).
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` when seq is beyond the newest message). 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.
+     */
+    markReadAsyncUnsafe(chatId: string, seq: number): Promise<boolean>;
+    /**
+     * A chat's messages with seq > sinceSeq, oldest first (max 200 per call). Members,
+     * project admins, canister admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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.
+     */
+    getMessagesAsyncUnsafe(input: GetMessagesInput): Promise<MessagesPageView>;
+    /**
+     * New messages in every chat the caller belongs to, after a global sequence number.
+     * Always returns `nextSinceGlobalSeq` — pass it back next time, whatever matched.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized). 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.
+     */
+    pollNewMessagesAsyncUnsafe(input: PollNewMessagesInput): Promise<PollResultView>;
+    /** Like pollNewMessagesAsyncUnsafe but never throws — returns null on any failure. */
+    pollNewMessagesAsyncSafe(input: PollNewMessagesInput): Promise<PollResultView | null>;
+}
+//# sourceMappingURL=messages-actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages-actor.d.ts","sourceRoot":"","sources":["../../src/actors/messages-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,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGzI,yDAAyD;AACzD,qBAAa,aAAc,SAAQ,SAAS;gBAE5B,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;OAMG;IACU,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAWpE,2EAA2E;IAC9D,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAQzE;;;;;OAKG;IACU,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E;;;;;;OAMG;IACU,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAWvF;;;;;;OAMG;IACU,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAU7F,sFAAsF;IACzE,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAOrG"}

package/dist/actors/messages-actor.js

@@ -0,0 +1,80 @@
+import {} from "@icp-sdk/core/agent";
+import { ActorBase } from "../actor-base.js";
+import { mapMessageView, mapMessagesPageView, mapPollResultView, toOptBigInt } from "../mappers.js";
+/** 1:1 wrapper for the canister's MessagesController. */
+export class MessagesActor extends ActorBase {
+    constructor(canisterId, identity) {
+        super(canisterId, identity);
+    }
+    /**
+     * Posts a message as the caller. `text` for any member; `toolTrace` only for `agent`
+     * and `admin` members.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` for empty/long text, closed or full chat, daily limit). 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 postAsyncUnsafe(input) {
+        const message = await this.executeFunctionAsyncUnsafe(() => this.actor.post({
+            chatId: input.chatId,
+            text: input.text,
+            kind: input.kind === "toolTrace" ? { toolTrace: null } : { text: null },
+        }));
+        return mapMessageView(message);
+    }
+    /** Like postAsyncUnsafe but never throws — returns null on any failure. */
+    async postAsyncSafe(input) {
+        try {
+            return await this.postAsyncUnsafe(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Records that the caller has read up to `seq` (never moves backwards).
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData` when seq is beyond the newest message). 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 markReadAsyncUnsafe(chatId, seq) {
+        return this.executeFunctionAsyncUnsafe(() => this.actor.markRead({ chatId, seq: BigInt(seq) }));
+    }
+    /**
+     * A chat's messages with seq > sinceSeq, oldest first (max 200 per call). Members,
+     * project admins, canister admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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 getMessagesAsyncUnsafe(input) {
+        const page = await this.executeFunctionAsyncUnsafe(() => this.actor.getMessages({
+            chatId: input.chatId,
+            sinceSeq: BigInt(input.sinceSeq ?? 0),
+            limit: toOptBigInt(input.limit),
+        }));
+        return mapMessagesPageView(page);
+    }
+    /**
+     * New messages in every chat the caller belongs to, after a global sequence number.
+     * Always returns `nextSinceGlobalSeq` — pass it back next time, whatever matched.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized). 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 pollNewMessagesAsyncUnsafe(input) {
+        const result = await this.executeFunctionAsyncUnsafe(() => this.actor.pollNewMessages({
+            sinceGlobalSeq: BigInt(input.sinceGlobalSeq),
+            limit: toOptBigInt(input.limit),
+        }));
+        return mapPollResultView(result);
+    }
+    /** Like pollNewMessagesAsyncUnsafe but never throws — returns null on any failure. */
+    async pollNewMessagesAsyncSafe(input) {
+        try {
+            return await this.pollNewMessagesAsyncUnsafe(input);
+        }
+        catch {
+            return null;
+        }
+    }
+}

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

@@ -0,0 +1,38 @@
+import { type Identity } from "@icp-sdk/core/agent";
+import { ActorBase } from "../actor-base.js";
+import type { CreateProjectInput, ProjectView, UpdateProjectInput } from "../interfaces.js";
+/** 1:1 wrapper for the canister's ProjectsController — a project is a consumer's namespace
+ * with its own admins and the agents that auto-join every chat. */
+export declare class ProjectsActor extends ActorBase {
+    constructor(canisterId: string, identity?: Identity);
+    /**
+     * Creates a project. Canister admin only.
+     * @param input - id (max 50 chars), admins and agents (max 10 each, no anonymous), whether agents may invite, the default policy.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `AlreadyExists`, `InvalidData`). 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.
+     */
+    createProjectAsyncUnsafe(input: CreateProjectInput): Promise<ProjectView>;
+    /**
+     * Changes only the given fields. Canister admins and the project's admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData`). 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.
+     */
+    updateProjectAsyncUnsafe(input: UpdateProjectInput): Promise<ProjectView>;
+    /**
+     * One project. Canister admins, the project's admins and its agents.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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.
+     */
+    getProjectAsyncUnsafe(projectId: string): Promise<ProjectView>;
+    /**
+     * Every project. Canister admin only.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized). 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.
+     */
+    listProjectsAsyncUnsafe(limit?: number): Promise<ProjectView[]>;
+}
+//# sourceMappingURL=projects-actor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projects-actor.d.ts","sourceRoot":"","sources":["../../src/actors/projects-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG5F;mEACmE;AACnE,qBAAa,aAAc,SAAQ,SAAS;gBAE5B,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ;IAInD;;;;;;OAMG;IACU,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAatF;;;;;OAKG;IACU,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAatF;;;;;OAKG;IACU,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAK3E;;;;;OAKG;IACU,uBAAuB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAI/E"}

package/dist/actors/projects-actor.js

@@ -0,0 +1,64 @@
+import {} from "@icp-sdk/core/agent";
+import { Principal } from "@icp-sdk/core/principal";
+import { ActorBase } from "../actor-base.js";
+import { mapProjectView, toOpt, toOptBigInt } from "../mappers.js";
+/** 1:1 wrapper for the canister's ProjectsController — a project is a consumer's namespace
+ * with its own admins and the agents that auto-join every chat. */
+export class ProjectsActor extends ActorBase {
+    constructor(canisterId, identity) {
+        super(canisterId, identity);
+    }
+    /**
+     * Creates a project. Canister admin only.
+     * @param input - id (max 50 chars), admins and agents (max 10 each, no anonymous), whether agents may invite, the default policy.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `AlreadyExists`, `InvalidData`). 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 createProjectAsyncUnsafe(input) {
+        const project = await this.executeFunctionAsyncUnsafe(() => this.actor.createProject({
+            id: input.id,
+            admins: input.admins.map((p) => Principal.fromText(p)),
+            agents: input.agents.map((p) => Principal.fromText(p)),
+            agentsMayInvite: input.agentsMayInvite,
+            defaultPolicy: { agentsReply: input.defaultPolicy.agentsReply },
+        }));
+        return mapProjectView(project);
+    }
+    /**
+     * Changes only the given fields. Canister admins and the project's admins.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`, `InvalidData`). 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 updateProjectAsyncUnsafe(input) {
+        const project = await this.executeFunctionAsyncUnsafe(() => this.actor.updateProject({
+            projectId: input.projectId,
+            admins: toOpt(input.admins?.map((p) => Principal.fromText(p))),
+            agents: toOpt(input.agents?.map((p) => Principal.fromText(p))),
+            agentsMayInvite: toOpt(input.agentsMayInvite),
+            defaultPolicy: toOpt(input.defaultPolicy === undefined ? undefined : { agentsReply: input.defaultPolicy.agentsReply }),
+        }));
+        return mapProjectView(project);
+    }
+    /**
+     * One project. Canister admins, the project's admins and its agents.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized, `NotFound`). 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 getProjectAsyncUnsafe(projectId) {
+        const project = await this.executeFunctionAsyncUnsafe(() => this.actor.getProject({ projectId }));
+        return mapProjectView(project);
+    }
+    /**
+     * Every project. Canister admin only.
+     * @throws Error with message `CanisterError` when the canister returns a business error (not authorized). 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 listProjectsAsyncUnsafe(limit) {
+        const projects = await this.executeFunctionAsyncUnsafe(() => this.actor.listProjects({ limit: toOptBigInt(limit) }));
+        return projects.map(mapProjectView);
+    }
+}

package/dist/chat-poller.d.ts

@@ -0,0 +1,36 @@
+import { Observable } from "rxjs";
+import type { MessagesActor } from "./actors/messages-actor.js";
+import type { MessageView } from "./interfaces.js";
+export interface ChatPollerOptions {
+    /** Global sequence to start after. Omitted = the canister's current head (no replay). */
+    startAt?: number;
+    /** Called with every poll failure; a five-minute streak also rebuilds the agent. */
+    onError?: (error: unknown) => void;
+    batchLimit?: number;
+}
+/**
+ * Polls `pollNewMessages` on an interval for the wrapped identity and pushes every new
+ * message it is a member of onto `messages$`, in global order. Filtering out one's own
+ * messages is the consumer's job — the poller reports what the canister reports.
+ *
+ * Browser-safe on purpose: no pigeon, no `node:` imports, so the same package serves the
+ * agent host and the panel.
+ */
+export declare class ChatPoller {
+    private readonly actor;
+    private readonly intervalMilliseconds;
+    private readonly options;
+    private intervalId;
+    private isProcessing;
+    private readonly messageSubject;
+    private lastSuccessfulProcessTs;
+    private sinceGlobalSeq;
+    get messages$(): Observable<MessageView>;
+    /** The cursor the next tick will poll from; undefined until the first successful tick. */
+    get cursor(): number | undefined;
+    constructor(actor: MessagesActor, intervalMilliseconds: number, options?: ChatPollerOptions);
+    private processQueue;
+    run(): void;
+    stop(): void;
+}
+//# sourceMappingURL=chat-poller.d.ts.map

package/dist/chat-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-poller.d.ts","sourceRoot":"","sources":["../src/chat-poller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAW,MAAM,MAAM,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAKnD,MAAM,WAAW,iBAAiB;IAC9B,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IAiBf,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlB5B,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,uBAAuB,CAAc;IAC7C,OAAO,CAAC,cAAc,CAAqB;IAE3C,IAAW,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,CAE9C;IAED,0FAA0F;IAC1F,IAAW,MAAM,IAAI,MAAM,GAAG,SAAS,CAEtC;gBAGoB,KAAK,EAAE,aAAa,EACpB,oBAAoB,EAAE,MAAM,EAC5B,OAAO,GAAE,iBAAsB;YAKtC,YAAY;IAsCnB,GAAG,IAAI,IAAI;IAOX,IAAI,IAAI,IAAI;CAOtB"}

package/dist/chat-poller.js

@@ -0,0 +1,82 @@
+import { Observable, Subject } from "rxjs";
+const STALE_AGENT_THRESHOLD_MS = 5 * 60 * 1000;
+const DEFAULT_BATCH_LIMIT = 200;
+/**
+ * Polls `pollNewMessages` on an interval for the wrapped identity and pushes every new
+ * message it is a member of onto `messages$`, in global order. Filtering out one's own
+ * messages is the consumer's job — the poller reports what the canister reports.
+ *
+ * Browser-safe on purpose: no pigeon, no `node:` imports, so the same package serves the
+ * agent host and the panel.
+ */
+export class ChatPoller {
+    actor;
+    intervalMilliseconds;
+    options;
+    intervalId = null;
+    isProcessing = false;
+    messageSubject = new Subject();
+    lastSuccessfulProcessTs = Date.now();
+    sinceGlobalSeq;
+    get messages$() {
+        return this.messageSubject.asObservable();
+    }
+    /** The cursor the next tick will poll from; undefined until the first successful tick. */
+    get cursor() {
+        return this.sinceGlobalSeq;
+    }
+    constructor(actor, intervalMilliseconds, options = {}) {
+        this.actor = actor;
+        this.intervalMilliseconds = intervalMilliseconds;
+        this.options = options;
+        this.sinceGlobalSeq = options.startAt;
+    }
+    async processQueue() {
+        if (this.isProcessing)
+            return;
+        if (Date.now() - this.lastSuccessfulProcessTs > STALE_AGENT_THRESHOLD_MS) {
+            this.lastSuccessfulProcessTs = Date.now();
+            this.options.onError?.(new Error("ChatPoller: no successful poll in the last 5 minutes — rebuilding the agent"));
+            this.actor.reinitializeAgent();
+        }
+        try {
+            this.isProcessing = true;
+            if (this.sinceGlobalSeq === undefined) {
+                // Seed at the head: limit 0 returns only the cursors.
+                const seed = await this.actor.pollNewMessagesAsyncUnsafe({ sinceGlobalSeq: 0, limit: 0 });
+                this.sinceGlobalSeq = seed.headGlobalSeq;
+            }
+            else {
+                const result = await this.actor.pollNewMessagesAsyncUnsafe({
+                    sinceGlobalSeq: this.sinceGlobalSeq,
+                    limit: this.options.batchLimit ?? DEFAULT_BATCH_LIMIT,
+                });
+                for (const message of result.messages) {
+                    this.messageSubject.next(message);
+                }
+                // A reinstalled canister has a smaller head than our cursor — clamp to it.
+                this.sinceGlobalSeq = Math.min(result.nextSinceGlobalSeq, result.headGlobalSeq);
+            }
+            this.lastSuccessfulProcessTs = Date.now();
+        }
+        catch (error) {
+            this.options.onError?.(error);
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    run() {
+        if (this.intervalId)
+            return;
+        this.intervalId = setInterval(() => void this.processQueue(), this.intervalMilliseconds);
+        void this.processQueue();
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+            this.messageSubject.complete();
+        }
+    }
+}

package/dist/globals.d.ts

@@ -0,0 +1,2 @@
+export declare const componentName = "chat-motoko-package";
+//# sourceMappingURL=globals.d.ts.map

package/dist/globals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals.d.ts","sourceRoot":"","sources":["../src/globals.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,wBAAwB,CAAC"}

package/dist/globals.js

@@ -0,0 +1 @@
+export const componentName = "chat-motoko-package";

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { ActorBase, type LogEntry } from "./actor-base.js";
+export { AdminActor } from "./actors/admin-actor.js";
+export { ProjectsActor } from "./actors/projects-actor.js";
+export { ChatsActor } from "./actors/chats-actor.js";
+export { MessagesActor } from "./actors/messages-actor.js";
+export { ChatPoller, type ChatPollerOptions } from "./chat-poller.js";
+export type { RoleView, ChatStatusView, PolicyView, ProjectView, MemberView, ChatView, SystemEventView, MessageKindView, MessageView, MessagesPageView, PollResultView, CreateProjectInput, UpdateProjectInput, MemberInputView, CreateChatInput, InviteMemberInput, RemoveMemberInput, GetMyChatsInput, PostInput, GetMessagesInput, PollNewMessagesInput, } from "./interfaces.js";
+export { mapProjectView, mapChatView, mapMemberView, mapMessageView, mapMessagesPageView, mapPollResultView, mapSystemEventView, mapRoleView, toCandidRole, } from "./mappers.js";
+export type { Chat, ChatId, ChatStatus, Member, Message, MessageKind, MessagesPage, Policy, PollResult, Project, ProjectId, Role, SystemEvent, Error as CanisterErrorShape, ErrorDetails, } from "../declarations/chat-motoko-backend/chat-motoko-backend.did.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EACR,QAAQ,EACR,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,oBAAoB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,cAAc,EACd,WAAW,EACX,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,YAAY,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EACR,IAAI,EACJ,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,OAAO,EACP,SAAS,EACT,IAAI,EACJ,WAAW,EACX,KAAK,IAAI,kBAAkB,EAC3B,YAAY,GACf,MAAM,gEAAgE,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { ActorBase } from "./actor-base.js";
+export { AdminActor } from "./actors/admin-actor.js";
+export { ProjectsActor } from "./actors/projects-actor.js";
+export { ChatsActor } from "./actors/chats-actor.js";
+export { MessagesActor } from "./actors/messages-actor.js";
+export { ChatPoller } from "./chat-poller.js";
+export { mapProjectView, mapChatView, mapMemberView, mapMessageView, mapMessagesPageView, mapPollResultView, mapSystemEventView, mapRoleView, toCandidRole, } from "./mappers.js";