@stacklink/sdk 0.3.7 → 0.3.9

package/dist/src/sdk/x-chat.d.ts

@@ -0,0 +1,143 @@
+/** Optional browser entry point. No PIN, private key, or plaintext is sent by
+ * this module. Dispatch the prepared ciphertext through normal Stacklink tools. */
+import { type ChatWithJuicebox, type CreateChatOptions, type SendPayload, type PreparedConversationChange, type PublicKeyRegistrationPayload } from '@xdevplatform/chat-xdk';
+export interface XChatPublicKeyRecord {
+    user_id: string;
+    public_key_version: string;
+    public_key: string;
+    signing_public_key: string;
+    identity_public_key_signature: string;
+}
+export declare function createStacklinkXChat(input: {
+    accountId: string;
+    userId: string;
+    signingKeyVersion: string;
+    juiceboxConfig?: string;
+    getAuthToken: CreateChatOptions['getAuthToken'];
+}): Promise<StacklinkXChat>;
+export declare class StacklinkXChat {
+    #private;
+    readonly accountId: string;
+    readonly userId: string;
+    constructor(accountId: string, userId: string, chat: ChatWithJuicebox, signingKeyVersion: string);
+    private current;
+    private withPin;
+    unlock(pin: Uint8Array): Promise<void>;
+    setup(pin: Uint8Array): Promise<import("@xdevplatform/chat-xdk").PublicKeys>;
+    changePin(oldPin: Uint8Array, newPin: Uint8Array): Promise<void>;
+    lock(): Promise<void>;
+    close(): Promise<void>;
+    updateConfig(config: string): void;
+    setIdentityVersion(version: string): void;
+    isUnlocked(): boolean;
+    generateRegistration(): {
+        public_key: {
+            signing_public_key_signature?: string;
+            public_key_fingerprint?: string;
+            identity_public_key_signature: string;
+            public_key: string;
+            registration_method: string;
+            signing_public_key: string;
+        };
+        version?: string;
+        generate_version: boolean;
+    };
+    getPublicKeys(): import("@xdevplatform/chat-xdk").PublicKeys;
+    getPublicKeyFingerprint(): string;
+    setParticipants(records: XChatPublicKeyRecord[]): void;
+    decryptEvents(...args: Parameters<ChatWithJuicebox['decryptEvents']>): import("@xdevplatform/chat-xdk").DecryptEventsResult;
+    decryptEvent(...args: Parameters<ChatWithJuicebox['decryptEvent']>): import("@xdevplatform/chat-xdk").Event;
+    encryptMessage(...args: Parameters<ChatWithJuicebox['encryptMessage']>): {
+        message_id: string;
+        encoded_message_create_event: string;
+        encoded_message_event_signature: string;
+    };
+    encryptReply(...args: Parameters<ChatWithJuicebox['encryptReply']>): {
+        message_id: string;
+        encoded_message_create_event: string;
+        encoded_message_event_signature: string;
+    };
+    encryptEdit(...args: Parameters<ChatWithJuicebox['encryptEdit']>): {
+        message_id: string;
+        encoded_message_create_event: string;
+        encoded_message_event_signature: string;
+    };
+    encryptAddReaction(...args: Parameters<ChatWithJuicebox['encryptAddReaction']>): {
+        message_id: string;
+        encoded_message_create_event: string;
+        encoded_message_event_signature: string;
+    };
+    encryptRemoveReaction(...args: Parameters<ChatWithJuicebox['encryptRemoveReaction']>): {
+        message_id: string;
+        encoded_message_create_event: string;
+        encoded_message_event_signature: string;
+    };
+    prepareMessageDelete(...args: Parameters<ChatWithJuicebox['prepareMessageDelete']>): {
+        message_id: string;
+        encoded_message_event_detail: string;
+        message_event_signature: {
+            signature: string;
+            signature_version: string;
+            public_key_version: string;
+        };
+    };
+    private verifiedParticipants;
+    prepareConversationKeyChange(...args: Parameters<ChatWithJuicebox['prepareConversationKeyChange']>): PreparedConversationChange;
+    prepareGroupCreate(...args: Parameters<ChatWithJuicebox['prepareGroupCreate']>): PreparedConversationChange;
+    prepareGroupMembersChange(...args: Parameters<ChatWithJuicebox['prepareGroupMembersChange']>): PreparedConversationChange;
+    encryptMedia(...args: Parameters<ChatWithJuicebox['encryptStream']>): Uint8Array<ArrayBufferLike>;
+    decryptMedia(...args: Parameters<ChatWithJuicebox['decryptStream']>): Uint8Array<ArrayBufferLike>;
+    mediaEncryptor(...args: Parameters<ChatWithJuicebox['streamEncryptor']>): import("@xdevplatform/chat-xdk").StreamEncryptor;
+    mediaDecryptor(...args: Parameters<ChatWithJuicebox['streamDecryptor']>): import("@xdevplatform/chat-xdk").StreamDecryptor;
+}
+export declare function xChatMessageBody(payload: SendPayload): {
+    message_id: string;
+    encoded_message_create_event: string;
+    encoded_message_event_signature: string;
+};
+/** X's official sample uses colon-separated direct-conversation IDs in signed
+ * crypto events and hyphen-separated IDs in HTTP paths. Never alter group IDs. */
+export declare function xChatApiConversationId(cryptoId: string): string;
+export declare function xChatCryptoConversationId(apiId: string): string;
+export declare function xChatActionSignature(signature: PreparedConversationChange['actionSignatures'][number]): {
+    message_id: string;
+    encoded_message_event_detail: string;
+    message_event_signature: {
+        signature: string;
+        signature_version: string;
+        public_key_version: string;
+    };
+};
+export declare function xChatConversationChangeBody(change: PreparedConversationChange): {
+    conversation_key_version: string;
+    conversation_participant_keys: {
+        user_id: string;
+        encrypted_conversation_key: string;
+        public_key_version: string;
+    }[];
+    action_signatures: {
+        message_id: string;
+        encoded_message_event_detail: string;
+        message_event_signature: {
+            signature: string;
+            signature_version: string;
+            public_key_version: string;
+        };
+    }[];
+};
+export declare function xChatRegistrationBody(registration: PublicKeyRegistrationPayload): {
+    public_key: {
+        signing_public_key_signature?: string;
+        public_key_fingerprint?: string;
+        identity_public_key_signature: string;
+        public_key: string;
+        registration_method: string;
+        signing_public_key: string;
+    };
+    version?: string;
+    generate_version: boolean;
+};
+/** Read only the exact realm requested by the official SDK. Keep the provider's
+ * original config for WASM so realm keys and recovery thresholds are preserved. */
+export declare function xChatRealmToken(juiceboxConfig: string, realmId: string): string;
+//# sourceMappingURL=x-chat.d.ts.map

package/dist/src/sdk/x-chat.d.ts.map

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

package/dist/src/sdk/x-chat.js

@@ -0,0 +1,171 @@
+/** Optional browser entry point. No PIN, private key, or plaintext is sent by
+ * this module. Dispatch the prepared ciphertext through normal Stacklink tools. */
+import { createChat } from '@xdevplatform/chat-xdk';
+// The official Juicebox binding has a process-wide auth callback. Serialize
+// backup work across all connected accounts in this JS realm.
+let backupQueue = Promise.resolve();
+function serializeBackup(work) {
+    const result = backupQueue.then(work, work);
+    backupQueue = result.then(() => undefined, () => undefined);
+    return result;
+}
+export async function createStacklinkXChat(input) {
+    if (!('window' in globalThis))
+        throw new Error('Personal X Chat must run on the user device in a browser. Use the official native Chat XDK for bot-owned keys.');
+    if (!input.accountId || !input.userId || !input.signingKeyVersion)
+        throw new Error('Bind Chat to one exact connected account, X user and registered key version.');
+    const chat = await serializeBackup(() => createChat({ ...(input.juiceboxConfig ? { juiceboxConfig: input.juiceboxConfig } : {}), getAuthToken: input.getAuthToken }));
+    chat.setIdentity(input.userId, input.signingKeyVersion);
+    chat.setRejectUnverified(true);
+    chat.setCacheKeys(true);
+    return new StacklinkXChat(input.accountId, input.userId, chat, input.signingKeyVersion);
+}
+export class StacklinkXChat {
+    #chat;
+    #closed = false;
+    #participants = new Map();
+    #signingKeyVersion;
+    #closing;
+    accountId;
+    userId;
+    constructor(accountId, userId, chat, signingKeyVersion) {
+        this.accountId = accountId;
+        this.userId = userId;
+        this.#chat = chat;
+        this.#signingKeyVersion = signingKeyVersion;
+    }
+    current() {
+        if (this.#closed)
+            throw new Error('This X Chat session is closed.');
+        return this.#chat;
+    }
+    async withPin(pin, work) {
+        this.current();
+        const local = pin.slice();
+        try {
+            return await serializeBackup(async () => {
+                this.current();
+                const result = await work(local);
+                // XDK recovery imports key material and clears its session identity.
+                // Restore the exact registered version before any signed operation.
+                this.#chat.setIdentity(this.userId, this.#signingKeyVersion);
+                this.#participants.clear();
+                this.#chat.setSigningKeys([]);
+                return result;
+            });
+        }
+        finally {
+            local.fill(0);
+        }
+    }
+    unlock(pin) { return this.withPin(pin, (local) => this.#chat.unlock(local)); }
+    setup(pin) { return this.withPin(pin, (local) => this.#chat.setup(local)); }
+    async changePin(oldPin, newPin) {
+        const next = newPin.slice();
+        try {
+            await this.withPin(oldPin, (previous) => this.#chat.changePin(previous, next));
+        }
+        finally {
+            next.fill(0);
+        }
+    }
+    async lock() { await serializeBackup(async () => { if (!this.#closed) {
+        this.#chat.lock();
+        this.#participants.clear();
+    } }); }
+    close() {
+        this.#closed = true;
+        this.#participants.clear();
+        this.#closing ??= serializeBackup(async () => { this.#chat.lock(); this.#chat.free(); });
+        return this.#closing;
+    }
+    updateConfig(config) { this.current().updateConfig(config); }
+    setIdentityVersion(version) { this.current().setIdentity(this.userId, version); this.#signingKeyVersion = version; }
+    isUnlocked() { return !this.#closed && this.#chat.isUnlocked(); }
+    generateRegistration() { return xChatRegistrationBody(this.current().generateKeypairs()); }
+    getPublicKeys() { return this.current().getPublicKeys(); }
+    getPublicKeyFingerprint() { return this.current().getPublicKeyFingerprint(); }
+    setParticipants(records) {
+        const chat = this.current();
+        for (const record of records)
+            if (!chat.verifyKeyBinding(record.public_key, record.signing_public_key, record.identity_public_key_signature))
+                throw new Error('X Chat participant key binding is invalid.');
+        this.#participants = new Map(records.map((record) => [JSON.stringify([record.user_id, record.public_key_version]), record.public_key]));
+        chat.setSigningKeys(records.map((record) => ({ userId: record.user_id, publicKeyVersion: record.public_key_version,
+            publicKey: record.signing_public_key, identityPublicKey: record.public_key, identityPublicKeySignature: record.identity_public_key_signature })));
+    }
+    decryptEvents(...args) { return this.current().decryptEvents(...args); }
+    decryptEvent(...args) { return this.current().decryptEvent(...args); }
+    encryptMessage(...args) { return xChatMessageBody(this.current().encryptMessage(...args)); }
+    encryptReply(...args) { return xChatMessageBody(this.current().encryptReply(...args)); }
+    encryptEdit(...args) { return xChatMessageBody(this.current().encryptEdit(...args)); }
+    encryptAddReaction(...args) { return xChatMessageBody(this.current().encryptAddReaction(...args)); }
+    encryptRemoveReaction(...args) { return xChatMessageBody(this.current().encryptRemoveReaction(...args)); }
+    prepareMessageDelete(...args) { return xChatActionSignature(this.current().prepareMessageDelete(...args)); }
+    verifiedParticipants(input) {
+        this.current();
+        for (const key of input.publicKeys)
+            if (this.#participants.get(JSON.stringify([key.userId, key.keyVersion])) !== key.publicKey)
+                throw new Error('Verify every participant key with setParticipants before sharing a conversation key.');
+    }
+    prepareConversationKeyChange(...args) { this.verifiedParticipants(args[0]); return this.current().prepareConversationKeyChange(...args); }
+    prepareGroupCreate(...args) { this.verifiedParticipants(args[0]); return this.current().prepareGroupCreate(...args); }
+    prepareGroupMembersChange(...args) { this.verifiedParticipants(args[0]); return this.current().prepareGroupMembersChange(...args); }
+    encryptMedia(...args) { return this.current().encryptStream(...args); }
+    decryptMedia(...args) { return this.current().decryptStream(...args); }
+    mediaEncryptor(...args) { return this.current().streamEncryptor(...args); }
+    mediaDecryptor(...args) { return this.current().streamDecryptor(...args); }
+}
+export function xChatMessageBody(payload) {
+    return { message_id: payload.messageId, encoded_message_create_event: payload.encryptedContent, encoded_message_event_signature: payload.encodedEventSignature };
+}
+/** X's official sample uses colon-separated direct-conversation IDs in signed
+ * crypto events and hyphen-separated IDs in HTTP paths. Never alter group IDs. */
+export function xChatApiConversationId(cryptoId) {
+    const parts = cryptoId.split(':');
+    if (parts.length === 1)
+        return cryptoId;
+    if (parts.length !== 2 || parts.some((part) => !part.length || part.length > 19 || [...part].some((character) => character < '0' || character > '9')))
+        throw new Error('Invalid X Chat direct conversation ID.');
+    return parts.join('-');
+}
+export function xChatCryptoConversationId(apiId) {
+    const parts = apiId.split('-');
+    if (parts.length === 1)
+        return apiId;
+    if (parts.length !== 2 || parts.some((part) => !part.length || part.length > 19 || [...part].some((character) => character < '0' || character > '9')))
+        throw new Error('Invalid X Chat direct conversation ID.');
+    return parts.join(':');
+}
+export function xChatActionSignature(signature) {
+    return { message_id: signature.messageId, encoded_message_event_detail: signature.encodedMessageEventDetail,
+        message_event_signature: { signature: signature.signature, signature_version: signature.signatureVersion, public_key_version: signature.publicKeyVersion } };
+}
+export function xChatConversationChangeBody(change) {
+    // Deliberately excludes the raw conversation key. Keep that byte array on device.
+    return { conversation_key_version: change.conversationKeyVersion,
+        conversation_participant_keys: change.participantKeys.map((key) => ({ user_id: key.userId, encrypted_conversation_key: key.encryptedKey, public_key_version: key.publicKeyVersion })),
+        action_signatures: change.actionSignatures.map(xChatActionSignature) };
+}
+export function xChatRegistrationBody(registration) {
+    const key = registration.publicKey;
+    return { generate_version: registration.generateVersion, ...(registration.version ? { version: registration.version } : {}), public_key: {
+            identity_public_key_signature: key.identityPublicKeySignature, public_key: key.publicKey,
+            registration_method: key.registrationMethod, signing_public_key: key.signingPublicKey,
+            ...(key.publicKeyFingerprint ? { public_key_fingerprint: key.publicKeyFingerprint } : {}),
+            ...(key.signingPublicKeySignature ? { signing_public_key_signature: key.signingPublicKeySignature } : {}),
+        } };
+}
+/** Read only the exact realm requested by the official SDK. Keep the provider's
+ * original config for WASM so realm keys and recovery thresholds are preserved. */
+export function xChatRealmToken(juiceboxConfig, realmId) {
+    const config = JSON.parse(juiceboxConfig);
+    if (config === null || typeof config !== 'object' || !('token_map' in config) || !Array.isArray(config.token_map))
+        throw new Error('X did not return secure-backup realm tokens.');
+    for (const entry of config.token_map) {
+        if (entry?.key === realmId && typeof entry?.value?.token === 'string' && entry.value.token)
+            return entry.value.token;
+    }
+    throw new Error('Refresh the connected user public-key record to obtain the requested backup realm token.');
+}
+//# sourceMappingURL=x-chat.js.map

package/dist/src/sdk/x-chat.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacklink/sdk",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "TypeScript SDK and agent-harness adapters for Stacklink.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -48,7 +48,11 @@
       "types": "./dist/src/sdk/langchain.d.ts",
       "default": "./dist/src/sdk/langchain.js"
     },
-    "./compatibility.json": "./compatibility.json"
+    "./compatibility.json": "./compatibility.json",
+    "./x-chat": {
+      "types": "./dist/src/sdk/x-chat.d.ts",
+      "default": "./dist/src/sdk/x-chat.js"
+    }
   },
   "dependencies": {
     "ajv": "^8.20.0",
@@ -58,7 +62,9 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.214",
     "@openai/agents": "^0.13.3",
     "ai": "^7.0.0",
-    "openai": "^6.46.0"
+    "openai": "^6.46.0",
+    "@xdevplatform/chat-xdk": "0.5.0",
+    "juicebox-sdk": "0.3.7"
   },
   "peerDependenciesMeta": {
     "@anthropic-ai/claude-agent-sdk": {
@@ -72,6 +78,12 @@
     },
     "openai": {
       "optional": true
+    },
+    "@xdevplatform/chat-xdk": {
+      "optional": true
+    },
+    "juicebox-sdk": {
+      "optional": true
     }
   },
   "scripts": {