@jsm-mit/chat-motoko-package 0.1.0

package/dist/interfaces.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Friendly views of the canister's candid types: `Principal` → text, `opt` → optional,
+ * variants → string unions, sequence numbers → `number` (they stay far below 2^53),
+ * timestamps kept as `bigint` nanoseconds like every other JSM package.
+ */
+export type RoleView = "owner" | "member" | "agent" | "admin";
+export type ChatStatusView = "open" | "closed";
+export interface PolicyView {
+    /** Read by agents, never enforced by the canister. */
+    agentsReply: boolean;
+}
+export interface ProjectView {
+    id: string;
+    createdBy: string;
+    createdAt: bigint;
+    admins: string[];
+    /** Auto-joined as `agent` on every new chat of the project. */
+    agents: string[];
+    agentsMayInvite: boolean;
+    defaultPolicy: PolicyView;
+}
+export interface MemberView {
+    principal: string;
+    role: RoleView;
+    joinedAt: bigint;
+    lastReadSeq: number;
+}
+export interface ChatView {
+    id: string;
+    projectId: string;
+    createdBy: string;
+    createdAt: bigint;
+    title?: string;
+    subject?: string;
+    policy: PolicyView;
+    status: ChatStatusView;
+    members: MemberView[];
+    lastSeq: number;
+    lastMessageAt: bigint;
+}
+export type SystemEventView = {
+    type: "chatCreated";
+} | {
+    type: "memberJoined";
+    principal: string;
+    role: RoleView;
+} | {
+    type: "memberInvited";
+    principal: string;
+    role: RoleView;
+    by: string;
+} | {
+    type: "memberRemoved";
+    principal: string;
+    by: string;
+} | {
+    type: "memberLeft";
+    principal: string;
+} | {
+    type: "policyChanged";
+    policy: PolicyView;
+} | {
+    type: "chatClosed";
+};
+export type MessageKindView = "text" | "toolTrace" | "event";
+export interface MessageView {
+    chatId: string;
+    projectId: string;
+    /** Dense per-chat sequence starting at 1. */
+    seq: number;
+    /** Canister-wide sequence — the poll cursor. */
+    globalSeq: number;
+    author: string;
+    kind: MessageKindView;
+    /** Set when `kind === "event"`. */
+    event?: SystemEventView;
+    text: string;
+    createdAt: bigint;
+}
+export interface MessagesPageView {
+    messages: MessageView[];
+    lastSeq: number;
+}
+export interface PollResultView {
+    messages: MessageView[];
+    /** Pass back as `sinceGlobalSeq` on the next poll. */
+    nextSinceGlobalSeq: number;
+    headGlobalSeq: number;
+}
+export interface CreateProjectInput {
+    id: string;
+    admins: string[];
+    agents: string[];
+    agentsMayInvite: boolean;
+    defaultPolicy: PolicyView;
+}
+export interface UpdateProjectInput {
+    projectId: string;
+    admins?: string[];
+    agents?: string[];
+    agentsMayInvite?: boolean;
+    defaultPolicy?: PolicyView;
+}
+export interface MemberInputView {
+    principal: string;
+    role: RoleView;
+}
+export interface CreateChatInput {
+    projectId: string;
+    /** Besides the caller (always `owner`) and the project's agents (always `agent`). */
+    members?: MemberInputView[];
+    policy?: PolicyView;
+    title?: string;
+    subject?: string;
+    firstMessage?: string;
+}
+export interface InviteMemberInput {
+    chatId: string;
+    principal: string;
+    role: RoleView;
+}
+export interface RemoveMemberInput {
+    chatId: string;
+    principal: string;
+}
+export interface GetMyChatsInput {
+    projectId: string;
+    subject?: string;
+    includeClosed?: boolean;
+    limit?: number;
+}
+export interface PostInput {
+    chatId: string;
+    text: string;
+    /** Defaults to `text`; `toolTrace` needs the `agent` or `admin` role. */
+    kind?: "text" | "toolTrace";
+}
+export interface GetMessagesInput {
+    chatId: string;
+    /** Messages with seq > sinceSeq; defaults to 0. */
+    sinceSeq?: number;
+    limit?: number;
+}
+export interface PollNewMessagesInput {
+    sinceGlobalSeq: number;
+    /** 0 = only the cursors. */
+    limit?: number;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/interfaces.js

@@ -0,0 +1,6 @@
+/**
+ * Friendly views of the canister's candid types: `Principal` → text, `opt` → optional,
+ * variants → string unions, sequence numbers → `number` (they stay far below 2^53),
+ * timestamps kept as `bigint` nanoseconds like every other JSM package.
+ */
+export {};

package/dist/mappers.d.ts

@@ -0,0 +1,17 @@
+import type { Chat, ChatStatus, Member, MemberInput, Message, MessagesPage, PollResult, Project, Role, SystemEvent } from "../declarations/chat-motoko-backend/chat-motoko-backend.did.js";
+import type { ChatStatusView, ChatView, MemberInputView, MemberView, MessageView, MessagesPageView, PollResultView, ProjectView, RoleView, SystemEventView } from "./interfaces.js";
+export declare function fromOpt<T>(opt: [] | [T]): T | undefined;
+export declare function toOpt<T>(value: T | undefined): [] | [T];
+export declare function toOptBigInt(value: number | undefined): [] | [bigint];
+export declare function mapRoleView(role: Role): RoleView;
+export declare function toCandidRole(role: RoleView): Role;
+export declare function toCandidMemberInput(input: MemberInputView): MemberInput;
+export declare function mapChatStatusView(status: ChatStatus): ChatStatusView;
+export declare function mapProjectView(project: Project): ProjectView;
+export declare function mapMemberView(member: Member): MemberView;
+export declare function mapChatView(chat: Chat): ChatView;
+export declare function mapSystemEventView(event: SystemEvent): SystemEventView;
+export declare function mapMessageView(message: Message): MessageView;
+export declare function mapMessagesPageView(page: MessagesPage): MessagesPageView;
+export declare function mapPollResultView(result: PollResult): PollResultView;
+//# sourceMappingURL=mappers.d.ts.map

package/dist/mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.d.ts","sourceRoot":"","sources":["../src/mappers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,WAAW,EACX,OAAO,EACP,YAAY,EACZ,UAAU,EACV,OAAO,EACP,IAAI,EACJ,WAAW,EACd,MAAM,gEAAgE,CAAC;AACxE,OAAO,KAAK,EACR,cAAc,EACd,QAAQ,EACR,eAAe,EACf,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,QAAQ,EACR,eAAe,EAClB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAEvD;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAEvD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAEpE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAOjD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAEvE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAEpE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAU5D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOxD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAchD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CAmBtE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAe5D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,gBAAgB,CAExE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAMpE"}

package/dist/mappers.js

@@ -0,0 +1,109 @@
+import { Principal } from "@icp-sdk/core/principal";
+export function fromOpt(opt) {
+    return opt[0];
+}
+export function toOpt(value) {
+    return value === undefined ? [] : [value];
+}
+export function toOptBigInt(value) {
+    return value === undefined ? [] : [BigInt(value)];
+}
+export function mapRoleView(role) {
+    return Object.keys(role)[0];
+}
+export function toCandidRole(role) {
+    switch (role) {
+        case "owner": return { owner: null };
+        case "member": return { member: null };
+        case "agent": return { agent: null };
+        case "admin": return { admin: null };
+    }
+}
+export function toCandidMemberInput(input) {
+    return { principal: Principal.fromText(input.principal), role: toCandidRole(input.role) };
+}
+export function mapChatStatusView(status) {
+    return Object.keys(status)[0];
+}
+export function mapProjectView(project) {
+    return {
+        id: project.id,
+        createdBy: project.createdBy.toText(),
+        createdAt: project.createdAt,
+        admins: project.admins.map((p) => p.toText()),
+        agents: project.agents.map((p) => p.toText()),
+        agentsMayInvite: project.agentsMayInvite,
+        defaultPolicy: { agentsReply: project.defaultPolicy.agentsReply },
+    };
+}
+export function mapMemberView(member) {
+    return {
+        principal: member.principal.toText(),
+        role: mapRoleView(member.role),
+        joinedAt: member.joinedAt,
+        lastReadSeq: Number(member.lastReadSeq),
+    };
+}
+export function mapChatView(chat) {
+    return {
+        id: chat.id,
+        projectId: chat.projectId,
+        createdBy: chat.createdBy.toText(),
+        createdAt: chat.createdAt,
+        title: fromOpt(chat.title),
+        subject: fromOpt(chat.subject),
+        policy: { agentsReply: chat.policy.agentsReply },
+        status: mapChatStatusView(chat.status),
+        members: chat.members.map(mapMemberView),
+        lastSeq: Number(chat.lastSeq),
+        lastMessageAt: chat.lastMessageAt,
+    };
+}
+export function mapSystemEventView(event) {
+    if ("chatCreated" in event)
+        return { type: "chatCreated" };
+    if ("chatClosed" in event)
+        return { type: "chatClosed" };
+    if ("policyChanged" in event)
+        return { type: "policyChanged", policy: { agentsReply: event.policyChanged.agentsReply } };
+    if ("memberJoined" in event) {
+        return { type: "memberJoined", principal: event.memberJoined.principal.toText(), role: mapRoleView(event.memberJoined.role) };
+    }
+    if ("memberInvited" in event) {
+        return {
+            type: "memberInvited",
+            principal: event.memberInvited.principal.toText(),
+            role: mapRoleView(event.memberInvited.role),
+            by: event.memberInvited.by.toText(),
+        };
+    }
+    if ("memberRemoved" in event) {
+        return { type: "memberRemoved", principal: event.memberRemoved.principal.toText(), by: event.memberRemoved.by.toText() };
+    }
+    return { type: "memberLeft", principal: event.memberLeft.principal.toText() };
+}
+export function mapMessageView(message) {
+    const base = {
+        chatId: message.chatId,
+        projectId: message.projectId,
+        seq: Number(message.seq),
+        globalSeq: Number(message.globalSeq),
+        author: message.author.toText(),
+        text: message.text,
+        createdAt: message.createdAt,
+    };
+    if ("event" in message.kind) {
+        return { ...base, kind: "event", event: mapSystemEventView(message.kind.event) };
+    }
+    return { ...base, kind: "toolTrace" in message.kind ? "toolTrace" : "text" };
+}
+export function mapMessagesPageView(page) {
+    return { messages: page.messages.map(mapMessageView), lastSeq: Number(page.lastSeq) };
+}
+export function mapPollResultView(result) {
+    return {
+        messages: result.messages.map(mapMessageView),
+        nextSinceGlobalSeq: Number(result.nextSinceGlobalSeq),
+        headGlobalSeq: Number(result.headGlobalSeq),
+    };
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+    "name": "@jsm-mit/chat-motoko-package",
+    "version": "0.1.0",
+    "description": "Wrapper TypeScript package for the chat-motoko canister: projects, multi-party chats, messages and a poller for agent hosts.",
+    "license": "ISC",
+    "author": "",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./declarations/*": "./declarations/*"
+    },
+    "files": [
+        "dist/",
+        "declarations/"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "clean": "rm -rf dist",
+        "prepare": "npm run build",
+        "publish-public": "bash scripts/publish-public.sh",
+        "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",
+        "test-access-restrictions": "bash scripts/run-tests.sh tests/test-access-restrictions.ts",
+        "sandbox": "npx tsx sandbox/main.ts",
+        "stamp-canister": "bash scripts/stamp-canister-commit.sh"
+    },
+    "dependencies": {
+        "@jsm-mit/utils-package": "^0.5.0",
+        "rxjs": "^7.8.1"
+    },
+    "peerDependencies": {
+        "@icp-sdk/core": "^6.0.0"
+    },
+    "devDependencies": {
+        "@icp-sdk/core": "^6.1.0",
+        "@jsm-mit/cli-game-helpers": "^0.1.3",
+        "@types/node": "^25.5.2",
+        "dotenv": "^16.3.1",
+        "tsx": "^4.18.0",
+        "typescript": "^5.9.3"
+    },
+    "homepage": "https://github.com/JSM-Common/chat-motoko-package#readme",
+    "bugs": {
+        "url": "https://github.com/JSM-Common/chat-motoko-package/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/JSM-Common/chat-motoko-package.git"
+    },
+    "chatMotoko": {
+        "repo": "chat-motoko",
+        "repoUrl": "https://github.com/JSM-Common/chat-motoko",
+        "commit": "1affa62db4bab4f424f4b633621472dc5f74ca95"
+    }
+}