@cello-protocol/client 0.0.2

package/dist/types.d.ts

@@ -0,0 +1,408 @@
+/**
+ * @cello-protocol/client — types.ts
+ *
+ * Public types for the CelloClient (MSG-002, SESSION-002, MSG-004, ADAPTER-003).
+ */
+export type SessionStatus = "active" | "transport_lost" | "sealing" | "sealed" | "seal_rejected" | "seal_deferred";
+export interface SessionRecord {
+    session_id: Uint8Array;
+    counterparty_pubkey: Uint8Array;
+    counterparty_peer_id: string;
+    counterparty_multiaddrs: string[];
+    relay_endpoint: {
+        peer_id: string;
+        multiaddrs: string[];
+    };
+    directory_endpoint: {
+        peer_id: string;
+        multiaddrs: string[];
+    };
+    directory_pubkey: Uint8Array;
+    genesis_prev_root: Uint8Array;
+    /**
+     * MSG-004: highest global relay sequence_number of *counterparty* leaves confirmed on this session.
+     * Used as `last_seen_seq` in the next outbound Structure 1 TBS.
+     * Updated only when a counterparty leaf is confirmed (never on own-send echoes).
+     * Starts at 0 (no counterparty messages confirmed yet).
+     */
+    last_seen_seq: number;
+    /**
+     * MSG-004: highest global relay sequence_number of *own* leaves echoed back.
+     * Used by the client-side causal-chain check: incoming last_seen_seq must be <= this.
+     * Updated only when own-send echoes are confirmed.
+     * Starts at 0.
+     */
+    last_sent_seq: number;
+    status: SessionStatus;
+    /** Sealed root after seal completes. SESSION-003. */
+    sealed_root?: Uint8Array;
+    /** Directory-identity signature over the SealNotarization. SESSION-003. MCP-002 AC-004. */
+    directory_signature?: Uint8Array;
+    /** Unix timestamp (ms) when the seal was confirmed. SESSION-003. MCP-002 AC-004. */
+    close_timestamp?: number;
+    /**
+     * SESSION-005: seal notarization type.
+     * 'frost' — directory co-signed via FROST ceremony; fully notarized.
+     * 'bilateral' — directory unreachable at seal time; bilateral K_local seal only.
+     * Undefined until a seal ceremony completes (status becomes 'sealed' or 'seal_deferred').
+     */
+    seal_type?: "frost" | "bilateral" | "unilateral";
+    /**
+     * SESSION-005: FROST combined signature on the SealNotarization.
+     * Populated when seal_type === 'frost'.
+     */
+    frost_signature?: Uint8Array;
+    /**
+     * SESSION-005: signer_pubkey from the session_sealed frame — initiator's primary_pubkey.
+     * Used by the counterparty to verify the FROST signature without a directory lookup.
+     */
+    signer_pubkey?: Uint8Array;
+    /** Ordered list of accepted leaves; used to recompute prev_root locally. MSG-004. */
+    local_tree_leaves: Array<{
+        kind: "msg" | "ctrl";
+        s2_cbor: Uint8Array;
+    }>;
+    /** Next expected sequence number from the relay (starts at 1). MSG-004. */
+    next_expected_seq: number;
+    /** Fail-closed flag. Once true all send/receive return session_desynchronized. MSG-004. */
+    desynchronized: boolean;
+}
+/**
+ * Result of receiveSessionAssignment().
+ *
+ * Failure reasons:
+ *   relay_auth_failed            — relay explicitly rejected the auth response.
+ *   relay_auth_error             — could not open a stream to the relay or read the challenge.
+ *   dial_counterparty_failed     — reserved for future use.
+ *   unsupported_signature_type   — SESSION-004: M1 'single' signature type refused by M2+ clients.
+ *   frost_signature_invalid      — SESSION-004: FROST threshold signature verification failed.
+ *   frost_signer_not_configured  — SESSION-004: initiator has no IThresholdSigner injected;
+ *                                  cannot derive verification key for own primary_pubkey.
+ *
+ * NOTE (SESSION-004 L-5): `directory_signature_invalid` has been removed.
+ * It was the M1 Ed25519 single-key failure reason. In M2, `signature_type: 'single'` frames
+ * are hard-refused with `unsupported_signature_type` before any signature verification,
+ * and FROST signature failures surface as `frost_signature_invalid`. There is no code path
+ * that returns `directory_signature_invalid` in M2.
+ */
+export type ReceiveAssignmentResult = {
+    ok: true;
+    sessionId: Uint8Array;
+} | {
+    ok: false;
+    reason: "relay_auth_failed" | "relay_auth_error" | "dial_counterparty_failed" | "unsupported_signature_type" | "frost_signature_invalid" | "frost_signer_not_configured";
+};
+export interface PeerEntry {
+    /** libp2p transport Peer ID string */
+    peerId: string;
+    /** multiaddrs for this peer */
+    multiaddrs: string[];
+    /** whether a live connection exists */
+    connected: boolean;
+}
+export type SendFailureReason = "peer_not_connected" | "content_too_large" | "peer_unreachable" | "remote_rejected" | "connection_lost" | "transport_not_started";
+export type SendResult = {
+    delivered: true;
+    contentHash: string;
+} | {
+    delivered: false;
+    reason: SendFailureReason;
+};
+/**
+ * A cross-checked, verified message OR lifecycle event delivered from a session.
+ * SESSION-007 extends this from a plain message shape to a discriminated union so
+ * that session_sealed lifecycle events can be surfaced inline by receiveMessage /
+ * receiveAnyMessage without a separate API.
+ */
+export type ReceivedMessage = {
+    type: "message";
+    content: Uint8Array;
+    senderPubkey: Uint8Array;
+    sequenceNumber: number;
+    /** SHA-256(leaf_kind_byte || structure2_cbor) per MERKLE-001 (RFC 6962). */
+    leafHash: Uint8Array;
+    /** SESSION-007: other active sessions that have queued messages. */
+    otherSessionsPending?: string[];
+} | {
+    type: "session_sealed";
+    sessionIdHex: string;
+    sealedRoot: Uint8Array;
+    closeTimestamp: number;
+    checkpointStatus: "pending" | "confirmed";
+    /** SESSION-007: other active sessions that have queued messages. */
+    otherSessionsPending?: string[];
+};
+export type SendMessageFailureReason = "session_not_found" | "session_desynchronized" | "session_sealed" | "transport_unavailable" | "relay_rejected" | "content_path_failed";
+export type SendMessageResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: SendMessageFailureReason;
+};
+export interface ReceivedEnvelope {
+    content: Uint8Array;
+    senderPubkey: Uint8Array;
+    contentHash: Uint8Array;
+    timestamp: number;
+}
+/**
+ * Result of initiateSession().
+ *
+ * Success: session_id and genesis_prev_root from the directory-signed SessionAssignment.
+ * Failure reasons:
+ *   target_offline       — directory reports the target pubkey has no authenticated stream.
+ *   relay_unavailable    — directory cannot assign a relay for the session.
+ *   target_busy          — simultaneous initiation: target is already mid-handshake.
+ *   timeout              — no directory response within the configured timeout.
+ *   directory_unreachable — cannot open or authenticate the signaling stream.
+ */
+export type InitiateSessionResult = {
+    ok: true;
+    sessionId: Uint8Array;
+    genesisPrevRoot: Uint8Array;
+} | {
+    ok: false;
+    reason: "target_offline" | "relay_unavailable" | "target_busy" | "timeout" | "directory_unreachable" | "frost_signer_not_configured" | "directory_below_threshold" | "ceremony_conflict" | "no_connection";
+};
+export interface CelloClient {
+    /**
+     * Register this agent with the directory.
+     * Generates (or loads) ML-DSA-44 keypair, opens signaling stream, and completes
+     * the REG-001 registration ceremony (register_request → register_success).
+     *
+     * Returns RegistrationState on success, or { error: reason } on failure.
+     * Idempotent: second call returns { error: 'already_registered' } if already done.
+     *
+     * REG-001 AC-001, AC-002, AC-008, AC-010.
+     */
+    register(phoneStub: string, preAuthToken?: string): Promise<import("@cello-protocol/protocol-types").RegistrationState | {
+        error: string;
+    }>;
+    /**
+     * Return the cached registration state, or null if not yet registered.
+     * CELLO-MCP-003.
+     */
+    getRegistrationState(): import("@cello-protocol/protocol-types").RegistrationState | null;
+    /**
+     * Return the configured directory peer ID (from CELLO_DIRECTORY_MULTIADDR), or null.
+     * Used by directoryReachable() to check live libp2p connection state.
+     */
+    getDirectoryPeerId(): string | null;
+    /**
+     * Set the connection policy for evaluating inbound connection requests.
+     * Replaces any previously configured policy.
+     * CELLO-MCP-003.
+     */
+    setPolicy(policy: import("./connection-policy.js").SignalRequirementPolicy): void;
+    /**
+     * Return the current connection policy.
+     * CELLO-MCP-003.
+     */
+    getPolicy(): import("./connection-policy.js").SignalRequirementPolicy;
+    /**
+     * Check if a connection exists with the given counterparty pubkey.
+     * Returns the connection_id if found, null otherwise.
+     * CELLO-MCP-003.
+     */
+    hasConnection(counterpartyPubkeyHex: string): string | null;
+    /**
+     * Accept a pending inbound connection request (inference review mode).
+     * Sends connection_response { verdict: 'accept' } to the directory.
+     * Returns { accepted: true, connection_id } on success, or { error: { reason } }.
+     * CELLO-MCP-003.
+     */
+    acceptConnection(connectionRequestId: string): Promise<{
+        accepted: true;
+        connection_id: string;
+    } | {
+        error: {
+            reason: "no_pending_request" | "already_decided";
+        };
+    }>;
+    /**
+     * Reject a pending inbound connection request (inference review mode).
+     * Sends connection_response { verdict: 'reject' } to the directory.
+     * Returns { rejected: true } on success, or { error: { reason } }.
+     * CELLO-MCP-003.
+     */
+    rejectConnection(connectionRequestId: string, reason?: string): Promise<{
+        rejected: true;
+    } | {
+        error: {
+            reason: "no_pending_request" | "already_decided";
+        };
+    }>;
+    /**
+     * Ask for more disclosure from sender (Round 2 initiation by target).
+     * Returns { request_sent: true } on success, or { error: { reason } }.
+     * CELLO-MCP-003.
+     */
+    requestMoreDisclosure(connectionRequestId: string, requestedItems: unknown[]): Promise<{
+        request_sent: true;
+    } | {
+        error: {
+            reason: "no_pending_request" | "already_decided" | "max_rounds_reached";
+        };
+    }>;
+    /**
+     * Block until an inbound connection request arrives for agent review,
+     * or until timeoutMs elapses.
+     * Returns pending_review with ConnectionReport, or { type: 'timeout' }.
+     * CELLO-MCP-003.
+     */
+    awaitConnectionRequest(timeoutMs?: number): Promise<{
+        type: "pending_review";
+        connection_request_id: string;
+        from_pubkey: string;
+        report: Extract<import("./connection-policy.js").ConnectionReport, {
+            verdict: "pending_agent_review";
+        }>;
+    } | {
+        type: "timeout";
+    }>;
+    /**
+     * List all active connection records.
+     * CELLO-MCP-003.
+     */
+    listConnections(): import("@cello-protocol/protocol-types").ClientConnectionRecord[];
+    /**
+     * Register a peer in the local registry.
+     * Called by MCP-001 cello_connect_peer after dialing succeeds.
+     */
+    addPeer(peerPubkeyHex: string, peerId: string, multiaddrs: string[]): void;
+    /**
+     * Send content to the peer identified by their K_local pubkey hex.
+     * Resolves with the delivery outcome — never throws.
+     */
+    send(peerPubkeyHex: string, content: Uint8Array): Promise<SendResult>;
+    /**
+     * Register the inbound stream handler on the node.
+     * Must be called once after node.start().
+     */
+    registerHandler(): Promise<void>;
+    /**
+     * Dequeue the oldest received envelope from a given sender.
+     * Returns null if the queue is empty.
+     */
+    receive(senderPubkeyHex: string): ReceivedEnvelope | null;
+    /**
+     * Return all queued envelopes (in arrival order) regardless of sender.
+     * Non-destructive — items remain in the queue until receive() drains them.
+     */
+    peekAll(): Array<{
+        senderPubkeyHex: string;
+        envelope: ReceivedEnvelope;
+    }>;
+    /**
+     * Process an inbound SessionAssignment pushed by the directory.
+     * Verifies the directory signature, computes genesis prev_root, dials the relay
+     * on /cello/relay/1.0.0, authenticates, dials the counterparty on /cello/content/1.0.0,
+     * and stores the session record.
+     * Resolves with ok:true and the session_id on success, ok:false with a reason on failure.
+     * SESSION-002 AC-002, AC-003, AC-004, AC-005, SI-003.
+     */
+    receiveSessionAssignment(assignment: import("@cello-protocol/protocol-types").SessionAssignment, myPubkey: Uint8Array): Promise<ReceiveAssignmentResult>;
+    /**
+     * Return all currently known session records.
+     * SESSION-002 AC-004.
+     */
+    listSessions(): SessionRecord[];
+    /**
+     * Send content on an active session using the dual-path protocol:
+     * hash on /cello/relay/1.0.0 and content on /cello/content/1.0.0.
+     * Serializes sends per session; the next send is not constructed until
+     * the relay has echoed back our own Structure 2 leaf_deliver.
+     * Never throws — returns SendMessageResult.
+     * MSG-004.
+     */
+    sendMessage(sessionIdHex: string, content: Uint8Array): Promise<SendMessageResult>;
+    /**
+     * Dequeue the oldest verified ReceivedMessage for the given session.
+     * Returns null if the queue is empty. MSG-004.
+     */
+    receiveMessage(sessionIdHex: string): ReceivedMessage | null;
+    /**
+     * Dequeue the oldest verified ReceivedMessage from any session (FIFO arrival order).
+     * Returns null if all queues are empty. MSG-004.
+     */
+    receiveAnyMessage(): {
+        sessionIdHex: string;
+        message: ReceivedMessage;
+    } | null;
+    /**
+     * SESSION-007: Block until a message (or session_sealed event) arrives on ANY active
+     * session, or timeout_ms elapses. Returns { type: 'timeout' } on timeout.
+     * The response includes sessionIdHex so the caller knows which session it came from.
+     * Wakes immediately if any queue is non-empty.
+     */
+    receiveMessageAsync(timeoutMs: number): Promise<(ReceivedMessage & {
+        sessionIdHex: string;
+    }) | {
+        type: "timeout";
+    }>;
+    /**
+     * SESSION-007: Block until a message (or session_sealed event) arrives on the given
+     * session, or timeout_ms elapses. Returns null on timeout.
+     * Wakes immediately if a message is already queued.
+     */
+    receiveSessionMessageAsync(sessionIdHex: string, timeoutMs: number): Promise<ReceivedMessage | null>;
+    /**
+     * Initiate the bilateral SEAL ceremony. Constructs and submits the initiator SEAL
+     * ctrl leaf, transitions session to `sealing`. SESSION-003.
+     * Returns ok:false if the session is not active, already sealing/sealed, or if the
+     * relay submit fails.
+     */
+    initiateSessionSeal(sessionIdHex: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    /**
+     * Close and remove a session record. Call after a desynchronized or sealed session
+     * can no longer be used. Idempotent — no-op if the session does not exist. MSG-004.
+     */
+    closeSession(sessionIdHex: string): void;
+    /**
+     * Register a handler that fires when a `session_assignment` frame arrives for an
+     * inbound session (one where this client is participant B — the session was initiated
+     * by a remote peer). The MCP server uses this to populate its inbound session queue
+     * so `cello_await_session` can return the new session to the agent.
+     *
+     * The handler receives a rich event with all session fields pre-encoded as hex strings
+     * so the MCP layer does not need to re-encode them.
+     * Multiple calls to onSessionAssignment replace the previous handler (last-writer wins).
+     * CELLO-MCP-002.
+     */
+    onSessionAssignment(handler: (event: SessionAssignmentEvent) => void): void;
+    /**
+     * Send a `session_request` over the persistent directory signaling stream and await
+     * the `session_assignment` or error response. On success, completes relay auth and
+     * content-path dial (same as receiveSessionAssignment), and returns the session_id
+     * and genesis_prev_root.
+     *
+     * Opens the signaling stream inline if not already open (DB-001: single retry).
+     * Returns { ok: false, reason: 'directory_unreachable' } if the stream cannot be
+     * established within the tool's timeout.
+     *
+     * CELLO-ADAPTER-003.
+     */
+    initiateSession(targetPubkeyHex: string, opts?: {
+        /** Directory peer ID to connect to (overrides configured directoryEndpoint). */
+        directoryPeerId?: string;
+        /** Directory multiaddr for initial dial (overrides configured directoryEndpoint). */
+        directoryMultiaddr?: string;
+        /** Timeout in ms. Default: 30_000. */
+        timeoutMs?: number;
+    }): Promise<InitiateSessionResult>;
+}
+/** Event fired by CelloClient when an inbound session_assignment arrives. CELLO-MCP-002. */
+export interface SessionAssignmentEvent {
+    /** Session ID as lowercase hex. */
+    sessionIdHex: string;
+    /** Counterparty K_local pubkey as lowercase hex. */
+    counterpartyPubkeyHex: string;
+    /** Genesis prev_root as lowercase hex. */
+    genesisPrevRootHex: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @cello-protocol/client — types.ts
+ *
+ * Public types for the CelloClient (MSG-002, SESSION-002, MSG-004, ADAPTER-003).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@cello-protocol/client",
+  "version": "0.0.2",
+  "private": false,
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "3.1051.0",
+    "@cello-protocol/interfaces": "0.0.1",
+    "@journeyapps/sqlcipher": "^6.0.0",
+    "@libp2p/interface": "^3.2.2",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@noble/curves": "^2.2.0",
+    "cbor-x": "^1.6.0",
+    "it-length-prefixed": "^10.0.1",
+    "it-pipe": "^3.0.1",
+    "zod": "^4.4.2",
+    "@cello-protocol/crypto": "0.0.2",
+    "@cello-protocol/protocol-types": "0.0.2",
+    "@cello-protocol/transport": "0.0.2"
+  },
+  "devDependencies": {
+    "@claude-flow/testing": "3.0.0-alpha.6",
+    "@types/node": "^25.6.2",
+    "@cello-protocol/test-fixtures": "0.0.2"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "test": "vitest run"
+  }
+}