@animalabs/portal-client 0.1.0

package/dist/src/cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Client-side cache, hydrated from `ready` and kept fresh by dispatch events.
+ * Provides synchronous getters so callers (and the MCPL layer) can resolve
+ * names/ids and capabilities without a round-trip.
+ */
+import type { PortalChannel, PortalEvent, PortalGuild, Persona, ReadyData } from '@animalabs/portal-protocol';
+export declare class ClientCache {
+    persona?: Persona;
+    private guilds;
+    private channels;
+    hydrate(ready: ReadyData): void;
+    /** Apply structural events; returns true if the cache changed. */
+    apply(event: PortalEvent): boolean;
+    getGuild(id: string): PortalGuild | undefined;
+    getChannel(id: string): PortalChannel | undefined;
+    allGuilds(): PortalGuild[];
+    allChannels(): PortalChannel[];
+    /** Threads + channels under a parent. */
+    childrenOf(parentId: string): PortalChannel[];
+    findChannelByName(name: string, guildId?: string): PortalChannel | undefined;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,OAAO,EACP,SAAS,EACV,MAAM,4BAA4B,CAAC;AAEpC,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAoC;IAEpD,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAQ/B,kEAAkE;IAClE,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO;IAkClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAG7C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAGjD,SAAS,IAAI,WAAW,EAAE;IAG1B,WAAW,IAAI,aAAa,EAAE;IAG9B,yCAAyC;IACzC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAG7C,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAK7E"}

package/dist/src/cache.js

@@ -0,0 +1,69 @@
+export class ClientCache {
+    persona;
+    guilds = new Map();
+    channels = new Map();
+    hydrate(ready) {
+        this.persona = ready.persona;
+        this.guilds.clear();
+        this.channels.clear();
+        for (const g of ready.guilds)
+            this.guilds.set(g.id, g);
+        for (const c of ready.channels)
+            this.channels.set(c.id, c);
+    }
+    /** Apply structural events; returns true if the cache changed. */
+    apply(event) {
+        switch (event.type) {
+            case 'channel_create':
+            case 'channel_update':
+            case 'thread_create':
+            case 'thread_update':
+                this.channels.set(event.channel.id, event.channel);
+                return true;
+            case 'channel_delete':
+                return this.channels.delete(event.channelId);
+            case 'thread_delete':
+                return this.channels.delete(event.channelId);
+            case 'guild_create':
+                this.guilds.set(event.guild.id, event.guild);
+                for (const c of event.channels)
+                    this.channels.set(c.id, c);
+                return true;
+            case 'guild_delete':
+                return this.guilds.delete(event.guildId);
+            case 'persona_update':
+                this.persona = event.persona;
+                return true;
+            case 'capabilities_update': {
+                const ch = this.channels.get(event.channelId);
+                if (ch) {
+                    this.channels.set(event.channelId, { ...ch, capabilities: event.capabilities });
+                    return true;
+                }
+                return false;
+            }
+            default:
+                return false;
+        }
+    }
+    getGuild(id) {
+        return this.guilds.get(id);
+    }
+    getChannel(id) {
+        return this.channels.get(id);
+    }
+    allGuilds() {
+        return [...this.guilds.values()];
+    }
+    allChannels() {
+        return [...this.channels.values()];
+    }
+    /** Threads + channels under a parent. */
+    childrenOf(parentId) {
+        return [...this.channels.values()].filter((c) => c.parentId === parentId);
+    }
+    findChannelByName(name, guildId) {
+        return [...this.channels.values()].find((c) => c.name === name && (!guildId || c.guildId === guildId));
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/src/cache.js.map

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

package/dist/src/client.d.ts

@@ -0,0 +1,93 @@
+/**
+ * PortalClient — WS transport + cache + typed RPC + reconnect/resume.
+ *
+ * Lifecycle: connect → hello → identify → ready. On an unexpected close it
+ * reconnects and `resume`s from the last seq; a non-resumable rejection falls
+ * back to a fresh identify. The agent-facing read watermark is NOT here — that
+ * lives in portal-mcpl; this layer only does transport-level resume.
+ */
+import { WebSocket } from 'ws';
+import { type AddressReason, type PortalChannel, type PortalEvent, type PortalMessage, type ReadyData, type RpcMethod, type RpcParams, type RpcResult } from '@animalabs/portal-protocol';
+import { ClientCache } from './cache.js';
+import { TypedEmitter } from './emitter.js';
+export interface PortalClientOptions {
+    url: string;
+    token: string;
+    personaId: string;
+    /** Ambient channel subscriptions to request on connect. */
+    subscriptions?: string[];
+    /** RPC timeout in ms (default 15000). */
+    rpcTimeoutMs?: number;
+    /** Max reconnect backoff in ms (default 30000). */
+    maxBackoffMs?: number;
+    /** Provide a WebSocket impl (tests). Defaults to ws. */
+    wsFactory?: (url: string) => WebSocket;
+}
+type MessageEvent = {
+    message: PortalMessage;
+    addressedToMe: boolean;
+    reasons: AddressReason[];
+};
+export interface PortalClientEvents extends Record<string, (...args: never[]) => void> {
+    ready: (data: ReadyData) => void;
+    resumed: (replayed: number) => void;
+    message: (e: MessageEvent) => void;
+    messageUpdate: (e: MessageEvent) => void;
+    messageDelete: (e: {
+        channelId: string;
+        threadId?: string;
+        messageId: string;
+    }) => void;
+    /** Any dispatch event, after the cache has been updated. */
+    event: (e: PortalEvent) => void;
+    channelChange: (channel: PortalChannel) => void;
+    close: (info: {
+        code: number;
+        willReconnect: boolean;
+    }) => void;
+    error: (err: Error) => void;
+}
+export declare class PortalClient extends TypedEmitter<PortalClientEvents> {
+    readonly cache: ClientCache;
+    private ws?;
+    private opts;
+    private pending;
+    private sessionId?;
+    private lastSeq;
+    private heartbeat?;
+    private backoff;
+    private closedByUser;
+    private ready;
+    constructor(options: PortalClientOptions);
+    /** Connect and resolve once `ready` (or `resumed`) is received. */
+    connect(): Promise<ReadyData>;
+    close(): void;
+    /** Typed RPC call. */
+    call<M extends RpcMethod>(method: M, params: RpcParams<M>): Promise<RpcResult<M>>;
+    sendMessage(params: RpcParams<'send_message'>): Promise<import("@animalabs/portal-protocol").SendMessageResult>;
+    editMessage(messageId: string, content: string): Promise<{
+        [x: string]: never;
+    }>;
+    deleteMessage(messageId: string): Promise<{
+        [x: string]: never;
+    }>;
+    react(messageId: string, emoji: string, visible?: boolean): Promise<{
+        [x: string]: never;
+    }>;
+    fetchHistory(params: RpcParams<'fetch_history'>): Promise<import("@animalabs/portal-protocol").FetchHistoryResult>;
+    subscribe(channelId: string): Promise<{
+        [x: string]: never;
+    }>;
+    unsubscribe(channelId: string): Promise<{
+        [x: string]: never;
+    }>;
+    private open;
+    private onMessage;
+    private onEvent;
+    private identify;
+    private startHeartbeat;
+    private onClose;
+    private sendFrame;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client.d.ts.map

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

package/dist/src/client.js

@@ -0,0 +1,230 @@
+/**
+ * PortalClient — WS transport + cache + typed RPC + reconnect/resume.
+ *
+ * Lifecycle: connect → hello → identify → ready. On an unexpected close it
+ * reconnects and `resume`s from the last seq; a non-resumable rejection falls
+ * back to a fresh identify. The agent-facing read watermark is NOT here — that
+ * lives in portal-mcpl; this layer only does transport-level resume.
+ */
+import { WebSocket } from 'ws';
+import { randomUUID } from 'node:crypto';
+import { PORTAL_PROTOCOL_VERSION, isServerFrame, } from '@animalabs/portal-protocol';
+import { ClientCache } from './cache.js';
+import { TypedEmitter } from './emitter.js';
+export class PortalClient extends TypedEmitter {
+    cache = new ClientCache();
+    ws;
+    opts;
+    pending = new Map();
+    sessionId;
+    lastSeq = 0;
+    heartbeat;
+    backoff = 1000;
+    closedByUser = false;
+    ready = false;
+    constructor(options) {
+        super();
+        this.opts = {
+            url: options.url,
+            token: options.token,
+            personaId: options.personaId,
+            rpcTimeoutMs: options.rpcTimeoutMs ?? 15_000,
+            maxBackoffMs: options.maxBackoffMs ?? 30_000,
+            // Kept as a mutable set so subscribe/unsubscribe stay durable across
+            // reconnects (identify replays this list).
+            subscriptions: options.subscriptions ? [...options.subscriptions] : [],
+            wsFactory: options.wsFactory,
+        };
+    }
+    /** Connect and resolve once `ready` (or `resumed`) is received. */
+    connect() {
+        this.closedByUser = false;
+        return new Promise((resolve, reject) => {
+            const onReady = this.on('ready', (d) => {
+                onReady();
+                onErr();
+                resolve(d);
+            });
+            const onErr = this.on('error', (e) => {
+                if (!this.ready) {
+                    onReady();
+                    onErr();
+                    reject(e);
+                }
+            });
+            this.open();
+        });
+    }
+    close() {
+        this.closedByUser = true;
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.ws?.close(1000, 'client closing');
+    }
+    /** Typed RPC call. */
+    call(method, params) {
+        const id = `rpc_${randomUUID()}`;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`RPC ${method} timed out`));
+            }, this.opts.rpcTimeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            this.sendFrame({ op: 'rpc', d: { id, method, params } });
+        });
+    }
+    // Convenience wrappers
+    sendMessage(params) {
+        return this.call('send_message', params);
+    }
+    editMessage(messageId, content) {
+        return this.call('edit_message', { messageId, content });
+    }
+    deleteMessage(messageId) {
+        return this.call('delete_message', { messageId });
+    }
+    react(messageId, emoji, visible = false) {
+        return this.call('react', { messageId, emoji, visible });
+    }
+    fetchHistory(params) {
+        return this.call('fetch_history', params);
+    }
+    subscribe(channelId) {
+        const subs = (this.opts.subscriptions ??= []);
+        if (!subs.includes(channelId))
+            subs.push(channelId);
+        return this.call('subscribe_channel', { channelId });
+    }
+    unsubscribe(channelId) {
+        this.opts.subscriptions = (this.opts.subscriptions ?? []).filter((c) => c !== channelId);
+        return this.call('unsubscribe_channel', { channelId });
+    }
+    // ── Internals ──
+    open() {
+        const ws = this.opts.wsFactory ? this.opts.wsFactory(this.opts.url) : new WebSocket(this.opts.url);
+        this.ws = ws;
+        ws.on('message', (data) => this.onMessage(data.toString()));
+        ws.on('close', (code) => this.onClose(code));
+        ws.on('error', (err) => this.emit('error', err));
+    }
+    onMessage(raw) {
+        const parsed = safeParse(raw);
+        if (!isServerFrame(parsed))
+            return;
+        const frame = parsed;
+        switch (frame.op) {
+            case 'hello':
+                this.startHeartbeat(frame.d.heartbeatIntervalMs);
+                if (this.sessionId && this.lastSeq >= 0) {
+                    this.sendFrame({ op: 'resume', d: { sessionId: this.sessionId, seq: this.lastSeq } });
+                }
+                else {
+                    this.identify();
+                }
+                return;
+            case 'ready':
+                this.ready = true;
+                this.backoff = 1000;
+                this.sessionId = frame.d.sessionId;
+                this.lastSeq = frame.d.seq;
+                this.cache.hydrate(frame.d);
+                this.emit('ready', frame.d);
+                return;
+            case 'resumed':
+                this.ready = true;
+                this.backoff = 1000;
+                this.emit('resumed', frame.d.replayedEvents);
+                return;
+            case 'invalid_session':
+                // Can't resume — start fresh.
+                this.sessionId = undefined;
+                this.lastSeq = 0;
+                if (frame.d.resumable) {
+                    /* relay said retry resume, but we lack state → identify */
+                }
+                this.identify();
+                return;
+            case 'heartbeat_ack':
+                return;
+            case 'dispatch':
+                this.lastSeq = frame.seq;
+                this.onEvent(frame.d);
+                return;
+            case 'rpc_result': {
+                const p = this.pending.get(frame.d.id);
+                if (!p)
+                    return;
+                this.pending.delete(frame.d.id);
+                clearTimeout(p.timer);
+                if (frame.d.ok)
+                    p.resolve(frame.d.result);
+                else
+                    p.reject(Object.assign(new Error(frame.d.error.message), { code: frame.d.error.code }));
+                return;
+            }
+        }
+    }
+    onEvent(event) {
+        this.cache.apply(event);
+        this.emit('event', event);
+        switch (event.type) {
+            case 'message_create':
+                this.emit('message', { message: event.message, addressedToMe: event.addressedToMe, reasons: event.reasons });
+                break;
+            case 'message_update':
+                this.emit('messageUpdate', { message: event.message, addressedToMe: event.addressedToMe, reasons: event.reasons });
+                break;
+            case 'message_delete':
+                this.emit('messageDelete', { channelId: event.channelId, threadId: event.threadId, messageId: event.messageId });
+                break;
+            case 'channel_create':
+            case 'channel_update':
+            case 'thread_create':
+            case 'thread_update':
+                this.emit('channelChange', event.channel);
+                break;
+        }
+    }
+    identify() {
+        this.sendFrame({
+            op: 'identify',
+            d: {
+                protocolVersion: PORTAL_PROTOCOL_VERSION,
+                token: this.opts.token,
+                personaId: this.opts.personaId,
+                subscriptions: this.opts.subscriptions,
+            },
+        });
+    }
+    startHeartbeat(intervalMs) {
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.heartbeat = setInterval(() => this.sendFrame({ op: 'heartbeat', d: { seq: this.lastSeq } }), intervalMs);
+    }
+    onClose(code) {
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.ready = false;
+        const willReconnect = !this.closedByUser;
+        this.emit('close', { code, willReconnect });
+        if (!willReconnect)
+            return;
+        const delay = Math.min(this.backoff, this.opts.maxBackoffMs);
+        this.backoff = Math.min(this.backoff * 2, this.opts.maxBackoffMs);
+        setTimeout(() => this.open(), delay);
+    }
+    sendFrame(frame) {
+        if (this.ws && this.ws.readyState === this.ws.OPEN) {
+            this.ws.send(JSON.stringify(frame));
+        }
+    }
+}
+function safeParse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client.js.map

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

package/dist/src/emitter.d.ts

@@ -0,0 +1,8 @@
+/** Minimal typed event emitter (no `any`, no Node EventEmitter dependency). */
+export declare class TypedEmitter<Events extends Record<string, (...args: never[]) => void>> {
+    private listeners;
+    on<K extends keyof Events>(event: K, fn: Events[K]): () => void;
+    off<K extends keyof Events>(event: K, fn: Events[K]): void;
+    emit<K extends keyof Events>(event: K, ...args: Parameters<Events[K]>): void;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/src/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/emitter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,qBAAa,YAAY,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,CAAC;IACjF,OAAO,CAAC,SAAS,CAA4D;IAE7E,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAO/D,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1D,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAK7E"}

package/dist/src/emitter.js

@@ -0,0 +1,20 @@
+/** Minimal typed event emitter (no `any`, no Node EventEmitter dependency). */
+export class TypedEmitter {
+    listeners = new Map();
+    on(event, fn) {
+        let set = this.listeners.get(event);
+        if (!set)
+            this.listeners.set(event, (set = new Set()));
+        set.add(fn);
+        return () => this.off(event, fn);
+    }
+    off(event, fn) {
+        this.listeners.get(event)?.delete(fn);
+    }
+    emit(event, ...args) {
+        for (const fn of this.listeners.get(event) ?? []) {
+            fn(...args);
+        }
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/src/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/emitter.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,OAAO,YAAY;IACf,SAAS,GAAG,IAAI,GAAG,EAAiD,CAAC;IAE7E,EAAE,CAAyB,KAAQ,EAAE,EAAa;QAChD,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,GAAG,CAAC,GAAG,CAAC,EAAgC,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,EAAa;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAgC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,GAAG,IAA2B;QACnE,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,EAA4C,CAAC,GAAG,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}

package/dist/src/enroll.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Self-enrollment helpers.
+ *
+ * A brand-new agent with no persona/token opens a short-lived WS connection,
+ * presents an invite (an admin-minted access-rights template) plus a desired
+ * name, and receives minted credentials. The credentials are then persisted and
+ * used by a normal PortalClient `identify` (which also gives transport resume).
+ *
+ * This is deliberately separate from PortalClient: the client stays a pure
+ * identify/resume transport, and enrollment is a one-shot bootstrap.
+ */
+import { WebSocket } from 'ws';
+export interface EnrollOptions {
+    url: string;
+    /** Invite code (access-rights template). */
+    invite: string;
+    /** Desired display name for the new persona. */
+    desiredName: string;
+    /** Optional avatar filename/URL. */
+    avatar?: string;
+    /** Timeout for the enroll handshake (default 15000ms). */
+    timeoutMs?: number;
+    /** Provide a WebSocket impl (tests). Defaults to ws. */
+    wsFactory?: (url: string) => WebSocket;
+}
+export interface PortalCredentials {
+    personaId: string;
+    token: string;
+}
+/** One-shot: open WS, register, return minted credentials, close. */
+export declare function enroll(opts: EnrollOptions): Promise<PortalCredentials>;
+/**
+ * Load persisted credentials, or enroll once and persist them. Idempotent: the
+ * first run of a new agent enrolls and writes `credsPath`; every run after just
+ * reads it. Returns the credentials to hand to a PortalClient.
+ */
+export declare function loadOrEnrollCreds(opts: {
+    url: string;
+    /** Where minted creds are cached (JSON: { personaId, token }). */
+    credsPath: string;
+    /** Required only when no creds exist yet. */
+    invite?: string;
+    desiredName?: string;
+    avatar?: string;
+    wsFactory?: (url: string) => WebSocket;
+}): Promise<PortalCredentials>;
+//# sourceMappingURL=enroll.d.ts.map

package/dist/src/enroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enroll.d.ts","sourceRoot":"","sources":["../../src/enroll.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAK/B,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqDtE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;CACxC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoB7B"}

package/dist/src/enroll.js

@@ -0,0 +1,96 @@
+/**
+ * Self-enrollment helpers.
+ *
+ * A brand-new agent with no persona/token opens a short-lived WS connection,
+ * presents an invite (an admin-minted access-rights template) plus a desired
+ * name, and receives minted credentials. The credentials are then persisted and
+ * used by a normal PortalClient `identify` (which also gives transport resume).
+ *
+ * This is deliberately separate from PortalClient: the client stays a pure
+ * identify/resume transport, and enrollment is a one-shot bootstrap.
+ */
+import { WebSocket } from 'ws';
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { PORTAL_PROTOCOL_VERSION, isServerFrame } from '@animalabs/portal-protocol';
+/** One-shot: open WS, register, return minted credentials, close. */
+export function enroll(opts) {
+    const ws = opts.wsFactory ? opts.wsFactory(opts.url) : new WebSocket(opts.url);
+    const timeoutMs = opts.timeoutMs ?? 15_000;
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const done = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            try {
+                ws.close();
+            }
+            catch {
+                /* ignore */
+            }
+            fn();
+        };
+        const timer = setTimeout(() => done(() => reject(new Error('enroll timed out'))), timeoutMs);
+        ws.on('message', (data) => {
+            let frame;
+            try {
+                frame = JSON.parse(data.toString());
+            }
+            catch {
+                return;
+            }
+            if (!isServerFrame(frame))
+                return;
+            const f = frame;
+            if (f.op === 'hello') {
+                ws.send(JSON.stringify({
+                    op: 'register',
+                    d: {
+                        protocolVersion: PORTAL_PROTOCOL_VERSION,
+                        invite: opts.invite,
+                        desiredName: opts.desiredName,
+                        ...(opts.avatar ? { avatar: opts.avatar } : {}),
+                    },
+                }));
+            }
+            else if (f.op === 'registered') {
+                const d = f.d;
+                done(() => resolve({ personaId: d.personaId, token: d.token }));
+            }
+            else if (f.op === 'invalid_session') {
+                const reason = f.d?.reason ?? 'rejected';
+                done(() => reject(new Error(`enroll rejected: ${reason}`)));
+            }
+        });
+        ws.on('error', (err) => done(() => reject(err)));
+        ws.on('close', () => done(() => reject(new Error('connection closed before register'))));
+    });
+}
+/**
+ * Load persisted credentials, or enroll once and persist them. Idempotent: the
+ * first run of a new agent enrolls and writes `credsPath`; every run after just
+ * reads it. Returns the credentials to hand to a PortalClient.
+ */
+export async function loadOrEnrollCreds(opts) {
+    if (existsSync(opts.credsPath)) {
+        const raw = JSON.parse(readFileSync(opts.credsPath, 'utf8'));
+        if (raw.personaId && raw.token)
+            return { personaId: raw.personaId, token: raw.token };
+    }
+    if (!opts.invite || !opts.desiredName) {
+        throw new Error(`no saved credentials at ${opts.credsPath} and no invite/desiredName to enroll with`);
+    }
+    const creds = await enroll({
+        url: opts.url,
+        invite: opts.invite,
+        desiredName: opts.desiredName,
+        avatar: opts.avatar,
+        wsFactory: opts.wsFactory,
+    });
+    mkdirSync(dirname(opts.credsPath), { recursive: true });
+    writeFileSync(opts.credsPath, JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+    return creds;
+}
+//# sourceMappingURL=enroll.js.map

package/dist/src/enroll.js.map

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

package/dist/src/files.d.ts

@@ -0,0 +1,10 @@
+import type { OutgoingFile } from '@animalabs/portal-protocol';
+/**
+ * Build an `OutgoingFile` from in-memory bytes (the portable way to attach a
+ * file — works from any client/host, no relay-side filesystem access).
+ */
+export declare function fileFromBytes(name: string, data: Buffer | Uint8Array, opts?: {
+    contentType?: string;
+    description?: string;
+}): OutgoingFile;
+//# sourceMappingURL=files.d.ts.map