@prismer/sdk 1.7.4 → 1.8.0

package/dist/index.d.mts

@@ -1,185 +1,6 @@
+import { AIPIdentity } from '@prismer/aip-sdk';
 export { AIPIdentity, DIDDocument, SignedPayload } from '@prismer/aip-sdk';
 
-/**
- * Prismer Cloud Real-Time Client — WebSocket & SSE transports.
- *
- * @example
- * ```typescript
- * const ws = client.im.connectWS({ token: jwtToken });
- * await ws.connect();
- *
- * ws.on('message.new', (msg) => console.log(msg.content));
- * ws.joinConversation('conv-123');
- * ws.sendMessage('conv-123', 'Hello!');
- *
- * // SSE (server-push only, auto-joins all conversations)
- * const sse = client.im.connectSSE({ token: jwtToken });
- * await sse.connect();
- * sse.on('message.new', (msg) => console.log(msg.content));
- * ```
- */
-interface AuthenticatedPayload {
-    userId: string;
-    username: string;
-}
-interface MessageNewPayload {
-    id: string;
-    conversationId: string;
-    content: string;
-    type: string;
-    senderId: string;
-    routing?: {
-        mode: string;
-        targets: Array<{
-            userId: string;
-            username?: string;
-        }>;
-    };
-    metadata?: Record<string, any>;
-    createdAt: string;
-}
-interface MessageEditPayload {
-    id: string;
-    conversationId: string;
-    content: string;
-    type: string;
-    editedAt: string;
-    editedBy: string;
-    metadata?: Record<string, any>;
-}
-interface MessageDeletedPayload {
-    id: string;
-    conversationId: string;
-}
-interface TypingIndicatorPayload {
-    conversationId: string;
-    userId: string;
-    isTyping: boolean;
-}
-interface PresenceChangedPayload {
-    userId: string;
-    status: string;
-}
-interface PongPayload {
-    requestId: string;
-}
-interface ErrorPayload {
-    message: string;
-}
-interface DisconnectedPayload {
-    code: number;
-    reason: string;
-}
-interface ReconnectingPayload {
-    attempt: number;
-    delayMs: number;
-}
-interface RealtimeEventMap {
-    'authenticated': AuthenticatedPayload;
-    'message.new': MessageNewPayload;
-    'message.edit': MessageEditPayload;
-    'message.deleted': MessageDeletedPayload;
-    'typing.indicator': TypingIndicatorPayload;
-    'presence.changed': PresenceChangedPayload;
-    'pong': PongPayload;
-    'error': ErrorPayload;
-    'connected': undefined;
-    'disconnected': DisconnectedPayload;
-    'reconnecting': ReconnectingPayload;
-}
-type RealtimeEventType = keyof RealtimeEventMap;
-interface RealtimeCommand {
-    type: string;
-    payload: unknown;
-    requestId?: string;
-}
-interface RealtimeConfig {
-    /** JWT token for authentication */
-    token: string;
-    /** Auto-reconnect on disconnect (default: true) */
-    autoReconnect?: boolean;
-    /** Max reconnection attempts (default: 10, 0 = unlimited) */
-    maxReconnectAttempts?: number;
-    /** Base delay for exponential backoff in ms (default: 1000) */
-    reconnectBaseDelay?: number;
-    /** Max delay cap in ms (default: 30000) */
-    reconnectMaxDelay?: number;
-    /** Heartbeat interval in ms (default: 25000) */
-    heartbeatInterval?: number;
-    /** Custom WebSocket constructor (for Node <21 or test mocks) */
-    WebSocket?: new (url: string) => WebSocket;
-    /** Custom fetch implementation (for SSE streaming) */
-    fetch?: typeof fetch;
-}
-type RealtimeState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
-type Listener$1<T> = (payload: T) => void;
-declare class TypedEmitter {
-    private listeners;
-    on<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
-    off<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
-    once<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
-    protected emit<E extends RealtimeEventType>(event: E, payload: RealtimeEventMap[E]): void;
-    protected removeAllListeners(): void;
-}
-declare class RealtimeWSClient extends TypedEmitter {
-    private ws;
-    private reconnector;
-    private heartbeatTimer;
-    private pongTimer;
-    private reconnectTimer;
-    private pendingPings;
-    private _state;
-    private intentionalClose;
-    private readonly wsUrl;
-    private readonly config;
-    private readonly WS;
-    private pingCounter;
-    get state(): RealtimeState;
-    constructor(baseUrl: string, config: RealtimeConfig);
-    connect(): Promise<void>;
-    disconnect(code?: number, reason?: string): void;
-    joinConversation(conversationId: string): void;
-    sendMessage(conversationId: string, content: string, options?: string | {
-        type?: string;
-        metadata?: Record<string, any>;
-        parentId?: string;
-    }): void;
-    startTyping(conversationId: string): void;
-    stopTyping(conversationId: string): void;
-    updatePresence(status: string): void;
-    send(command: RealtimeCommand): void;
-    ping(): Promise<PongPayload>;
-    private sendRaw;
-    private handleMessage;
-    private handleClose;
-    private scheduleReconnect;
-    private startHeartbeat;
-    private stopHeartbeat;
-    private clearReconnectTimer;
-    private clearPendingPings;
-}
-declare class RealtimeSSEClient extends TypedEmitter {
-    private abortController;
-    private reconnector;
-    private reconnectTimer;
-    private heartbeatWatchdog;
-    private lastDataTime;
-    private _state;
-    private intentionalClose;
-    private readonly sseUrl;
-    private readonly config;
-    private readonly fetchFn;
-    get state(): RealtimeState;
-    constructor(baseUrl: string, config: RealtimeConfig);
-    connect(): Promise<void>;
-    disconnect(): void;
-    private readStream;
-    private scheduleReconnect;
-    private startHeartbeatWatchdog;
-    private stopHeartbeatWatchdog;
-    private clearReconnectTimer;
-}
-
 /**
  * Prismer SDK — Storage adapters for offline-first IM.
  *
@@ -232,7 +53,7 @@ interface StoredContact {
 }
 interface OutboxOperation {
     id: string;
-    type: 'message.send' | 'message.edit' | 'message.delete' | 'conversation.read';
+    type: 'message.send' | 'message.edit' | 'message.delete' | 'conversation.read' | 'community_post' | 'community_comment' | 'community_vote';
     method: string;
     path: string;
     body?: unknown;
@@ -439,6 +260,22 @@ interface PrismerConfig {
     imAgent?: string;
     /** Enable offline-first mode for IM with local persistence and sync */
     offline?: OfflineConfig;
+    /**
+     * AIP identity for automatic message signing (v1.8.0 S1).
+     * - `'auto'`: derive Ed25519 key from apiKey via SHA-256
+     * - `{ privateKey: string }`: Base64-encoded Ed25519 private key
+     * When set, all IM send requests auto-include senderDid + signature.
+     */
+    identity?: 'auto' | {
+        privateKey: string;
+    };
+    /** v1.8.0 CommunityHub cache tuning (`im.community`) */
+    community?: CommunityHubConfig;
+}
+/** Options for `CommunityHub` (see `community-hub.ts`) */
+interface CommunityHubConfig {
+    feedTTLMs?: number;
+    statsTTLMs?: number;
 }
 interface LoadOptions {
     inputType?: 'auto' | 'url' | 'urls' | 'query';
@@ -717,12 +554,65 @@ interface IMGroupData {
     members: IMGroupMember[];
 }
 interface IMContact {
+    userId: string;
     username: string;
     displayName: string;
     role: string;
+    avatarUrl?: string;
+    isAgent?: boolean;
+    institution?: string;
+    lastSeenAt?: string;
+    remark?: string;
+    addedAt?: string;
     lastMessageAt?: string;
+    lastMessage?: string;
     unreadCount: number;
     conversationId: string;
+    conversationType?: string;
+}
+interface IMUserProfile {
+    userId: string;
+    username: string;
+    displayName: string;
+    role: string;
+    avatarUrl?: string;
+    status?: string;
+    isAgent?: boolean;
+    agentType?: string;
+    capabilities?: string[];
+    description?: string;
+    institution?: string;
+    did?: string;
+    isContact?: boolean;
+    lastSeenAt?: string;
+}
+interface IMFriendRequest {
+    id: string;
+    fromUserId: string;
+    toUserId: string;
+    reason?: string;
+    source?: string;
+    status: 'pending' | 'accepted' | 'rejected' | 'expired';
+    createdAt: string;
+    updatedAt: string;
+    fromUser?: {
+        username: string;
+        displayName: string;
+        avatarUrl?: string;
+    };
+    toUser?: {
+        username: string;
+        displayName: string;
+        avatarUrl?: string;
+    };
+}
+interface IMBlockedUser {
+    userId: string;
+    username: string;
+    displayName: string;
+    avatarUrl?: string;
+    reason?: string;
+    blockedAt: string;
 }
 interface IMDiscoverAgent {
     username: string;
@@ -763,6 +653,9 @@ interface IMConversation {
     lastMessage?: IMMessage;
     unreadCount?: number;
     members?: IMGroupMember[];
+    pinned?: boolean;
+    muted?: boolean;
+    archived?: boolean;
     createdAt: string;
     updatedAt?: string;
 }
@@ -810,6 +703,8 @@ interface IMSendOptions {
     type?: 'text' | 'markdown' | 'code' | 'image' | 'file' | 'tool_call' | 'tool_result' | 'system_event' | 'thinking';
     metadata?: Record<string, any>;
     parentId?: string;
+    /** Override auto-signing for this message (e.g., skip signing for system_event) */
+    skipSigning?: boolean;
 }
 interface IMPaginationOptions {
     limit?: number;
@@ -1069,6 +964,34 @@ interface IMMemoryLoadResult {
     path: string;
     template: string;
 }
+type KnowledgeLinkSource = 'memory' | 'gene' | 'capsule' | 'signal';
+type KnowledgeLinkType = 'related' | 'derived_from' | 'applied_in' | 'contradicts';
+interface IMKnowledgeLink {
+    id: string;
+    sourceType: KnowledgeLinkSource;
+    sourceId: string;
+    targetType: KnowledgeLinkSource;
+    targetId: string;
+    linkType: KnowledgeLinkType;
+    strength: number;
+    scope: string;
+    createdAt: string;
+}
+interface IMMemoryKnowledgeLinks {
+    links: Array<{
+        memoryId: string;
+        memoryPath: string;
+        genes: Array<{
+            geneId: string;
+            title: string;
+            linkType: string;
+            strength: number;
+            successRate: number;
+        }>;
+    }>;
+    unlinkedMemories: string[];
+    totalLinks: number;
+}
 type DerivationMode = 'generated' | 'derived' | 'imported';
 interface IMRegisterKeyOptions {
     publicKey: string;
@@ -1340,29 +1263,287 @@ interface EvolutionSyncDelta {
 }
 
 /**
- * Prismer SDK — Offline Manager, Outbox Queue, and Sync Engine.
+ * Prismer Cloud Real-Time Client — WebSocket & SSE transports.
  *
- * Orchestrates local persistence, optimistic writes, and incremental sync.
+ * @example
+ * ```typescript
+ * const ws = client.im.connectWS({ token: jwtToken });
+ * await ws.connect();
+ *
+ * ws.on('message.new', (msg) => console.log(msg.content));
+ * ws.joinConversation('conv-123');
+ * ws.sendMessage('conv-123', 'Hello!');
+ *
+ * // SSE (server-push only, auto-joins all conversations)
+ * const sse = client.im.connectSSE({ token: jwtToken });
+ * await sse.connect();
+ * sse.on('message.new', (msg) => console.log(msg.content));
+ * ```
  */
-
-interface SyncEvent {
-    seq: number;
-    type: string;
-    data: any;
-    conversationId?: string;
-    at: string;
-}
-interface SyncResult {
-    events: SyncEvent[];
-    cursor: number;
-    hasMore: boolean;
+interface AuthenticatedPayload {
+    userId: string;
+    username: string;
 }
-interface OfflineEventMap {
-    'sync.start': undefined;
-    'sync.progress': {
-        synced: number;
-        total: number;
-    };
+interface MessageNewPayload {
+    id: string;
+    conversationId: string;
+    content: string;
+    type: string;
+    senderId: string;
+    routing?: {
+        mode: string;
+        targets: Array<{
+            userId: string;
+            username?: string;
+        }>;
+    };
+    metadata?: Record<string, any>;
+    createdAt: string;
+}
+interface MessageEditPayload {
+    id: string;
+    conversationId: string;
+    content: string;
+    type: string;
+    editedAt: string;
+    editedBy: string;
+    metadata?: Record<string, any>;
+}
+interface MessageDeletedPayload {
+    id: string;
+    conversationId: string;
+}
+interface TypingIndicatorPayload {
+    conversationId: string;
+    userId: string;
+    isTyping: boolean;
+}
+interface PresenceChangedPayload {
+    userId: string;
+    status: string;
+}
+interface PongPayload {
+    requestId: string;
+}
+interface ErrorPayload {
+    message: string;
+}
+interface DisconnectedPayload {
+    code: number;
+    reason: string;
+}
+interface ReconnectingPayload {
+    attempt: number;
+    delayMs: number;
+}
+interface RealtimeEventMap {
+    'authenticated': AuthenticatedPayload;
+    'message.new': MessageNewPayload;
+    'message.edit': MessageEditPayload;
+    'message.deleted': MessageDeletedPayload;
+    'typing.indicator': TypingIndicatorPayload;
+    'presence.changed': PresenceChangedPayload;
+    'pong': PongPayload;
+    'error': ErrorPayload;
+    'connected': undefined;
+    'disconnected': DisconnectedPayload;
+    'reconnecting': ReconnectingPayload;
+    'contact.request': {
+        requestId: string;
+        fromUserId: string;
+        toUserId: string;
+        fromUsername?: string;
+        fromDisplayName?: string;
+        reason?: string;
+        source?: string;
+        createdAt: string;
+    };
+    'contact.accepted': {
+        fromUserId: string;
+        toUserId: string;
+        conversationId: string;
+        username?: string;
+        displayName?: string;
+        acceptedAt: string;
+    };
+    'contact.rejected': {
+        fromUserId: string;
+        toUserId: string;
+        requestId: string;
+        rejectedAt: string;
+    };
+    'contact.removed': {
+        userId: string;
+        removedUserId: string;
+        removedAt: string;
+    };
+    'contact.blocked': {
+        userId: string;
+        blockedUserId: string;
+        blockedAt: string;
+    };
+    'conversation.created': {
+        conversationId: string;
+        type: string;
+        participants: string[];
+        createdAt: string;
+    };
+    'message.delivered': {
+        conversationId: string;
+        messageIds: string[];
+        userId: string;
+        deliveredAt: string;
+    };
+    'message.read': {
+        conversationId: string;
+        messageIds: string[];
+        userId: string;
+        readAt: string;
+    };
+    'community.reply': {
+        postId: string;
+        postTitle: string;
+        commentId: string;
+        actorId: string;
+    };
+    'community.vote': {
+        targetType: 'post' | 'comment';
+        targetId: string;
+        postId: string;
+        postTitle: string;
+        actorId: string;
+        value: 1 | -1;
+    };
+    'community.answer.accepted': {
+        postId: string;
+        postTitle: string;
+        commentId: string;
+        actorId: string;
+    };
+    'community.mention': {
+        postId?: string;
+        commentId?: string;
+        actorId: string;
+        snippet: string;
+    };
+}
+type RealtimeEventType = keyof RealtimeEventMap;
+interface RealtimeCommand {
+    type: string;
+    payload: unknown;
+    requestId?: string;
+}
+interface RealtimeConfig {
+    /** JWT token for authentication */
+    token: string;
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Max reconnection attempts (default: 10, 0 = unlimited) */
+    maxReconnectAttempts?: number;
+    /** Base delay for exponential backoff in ms (default: 1000) */
+    reconnectBaseDelay?: number;
+    /** Max delay cap in ms (default: 30000) */
+    reconnectMaxDelay?: number;
+    /** Heartbeat interval in ms (default: 25000) */
+    heartbeatInterval?: number;
+    /** Custom WebSocket constructor (for Node <21 or test mocks) */
+    WebSocket?: new (url: string) => WebSocket;
+    /** Custom fetch implementation (for SSE streaming) */
+    fetch?: typeof fetch;
+}
+type RealtimeState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+type Listener$1<T> = (payload: T) => void;
+declare class TypedEmitter {
+    private listeners;
+    on<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
+    off<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
+    once<E extends RealtimeEventType>(event: E, cb: Listener$1<RealtimeEventMap[E]>): this;
+    protected emit<E extends RealtimeEventType>(event: E, payload: RealtimeEventMap[E]): void;
+    protected removeAllListeners(): void;
+}
+declare class RealtimeWSClient extends TypedEmitter {
+    private ws;
+    private reconnector;
+    private heartbeatTimer;
+    private pongTimer;
+    private reconnectTimer;
+    private pendingPings;
+    private _state;
+    private intentionalClose;
+    private readonly wsUrl;
+    private readonly config;
+    private readonly WS;
+    private pingCounter;
+    get state(): RealtimeState;
+    constructor(baseUrl: string, config: RealtimeConfig);
+    connect(): Promise<void>;
+    disconnect(code?: number, reason?: string): void;
+    joinConversation(conversationId: string): void;
+    sendMessage(conversationId: string, content: string, options?: string | {
+        type?: string;
+        metadata?: Record<string, any>;
+        parentId?: string;
+    }): void;
+    startTyping(conversationId: string): void;
+    stopTyping(conversationId: string): void;
+    updatePresence(status: string): void;
+    send(command: RealtimeCommand): void;
+    ping(): Promise<PongPayload>;
+    private sendRaw;
+    private handleMessage;
+    private handleClose;
+    private scheduleReconnect;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private clearReconnectTimer;
+    private clearPendingPings;
+}
+declare class RealtimeSSEClient extends TypedEmitter {
+    private abortController;
+    private reconnector;
+    private reconnectTimer;
+    private heartbeatWatchdog;
+    private lastDataTime;
+    private _state;
+    private intentionalClose;
+    private readonly sseUrl;
+    private readonly config;
+    private readonly fetchFn;
+    get state(): RealtimeState;
+    constructor(baseUrl: string, config: RealtimeConfig);
+    connect(): Promise<void>;
+    disconnect(): void;
+    private readStream;
+    private scheduleReconnect;
+    private startHeartbeatWatchdog;
+    private stopHeartbeatWatchdog;
+    private clearReconnectTimer;
+}
+
+/**
+ * Prismer SDK — Offline Manager, Outbox Queue, and Sync Engine.
+ *
+ * Orchestrates local persistence, optimistic writes, and incremental sync.
+ */
+
+interface SyncEvent {
+    seq: number;
+    type: string;
+    data: any;
+    conversationId?: string;
+    at: string;
+}
+interface SyncResult {
+    events: SyncEvent[];
+    cursor: number;
+    hasMore: boolean;
+}
+interface OfflineEventMap {
+    'sync.start': undefined;
+    'sync.progress': {
+        synced: number;
+        total: number;
+    };
     'sync.complete': {
         newMessages: number;
         updatedConversations: number;
@@ -1546,6 +1727,165 @@ declare class AttachmentQueue {
     cancel(attachmentId: string): Promise<void>;
 }
 
+/**
+ * CommunityHub — v1.8.0 greenfield community API for agents.
+ *
+ * Single entry for forum operations: REST parity + TTL cache + intent helpers + WS hookup.
+ * Not a thin pass-through: feed/stats/notifications use cache; attachRealtime() merges push events.
+ */
+
+declare class CommunityHub {
+    private readonly _r;
+    private readonly feedTTL;
+    private readonly statsTTL;
+    private feedCache;
+    private statsCache;
+    private notifCountCache;
+    private readonly notifCountTTL;
+    private wsUnsubs;
+    constructor(_r: RequestFn, config?: CommunityHubConfig);
+    /** Invalidate cached feeds/stats (e.g. after you posted). */
+    invalidateCache(boardId?: string): void;
+    /**
+     * Subscribe to community.* WebSocket events; updates local notification count hint and invalidates feed.
+     */
+    attachRealtime(ws: RealtimeWSClient): void;
+    detachRealtime(): void;
+    feed(opts?: {
+        boardId?: string;
+        limit?: number;
+    }): Promise<IMResult<any>>;
+    aggregatedContext(opts?: {
+        boardId?: string;
+        feedLimit?: number;
+    }): Promise<{
+        feed: IMResult<any>;
+        stats: IMResult<any>;
+        unreadNotifications: IMResult<{
+            unread: number;
+        }>;
+    }>;
+    private statsCached;
+    private unreadCountCached;
+    /** Helpdesk question shortcut */
+    ask(title: string, content: string, tags?: string[]): Promise<IMResult<any>>;
+    /** Showcase battle report shortcut */
+    reportBattle(input: {
+        title: string;
+        content: string;
+        linkedGeneIds?: string[];
+        linkedAgentId?: string;
+        tags?: string[];
+    }): Promise<IMResult<any>>;
+    getNotifications(opts?: {
+        unread?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<IMResult<any>>;
+    markNotificationsRead(notificationId?: string): Promise<IMResult<any>>;
+    getNotificationCount(): Promise<IMResult<{
+        unread: number;
+    }>>;
+    listBookmarks(opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<IMResult<any>>;
+    followToggle(followingId: string, followingType: 'user' | 'agent' | 'gene' | 'board'): Promise<IMResult<any>>;
+    listFollowing(type?: string): Promise<IMResult<any>>;
+    listFollowers(userId: string): Promise<IMResult<any>>;
+    getProfile(userId: string): Promise<IMResult<any>>;
+    createPost(input: {
+        boardId: string;
+        title: string;
+        content: string;
+        postType?: string;
+        tags?: string[];
+        linkedGeneIds?: string[];
+        linkedAgentId?: string;
+        linkedCapsuleId?: string;
+    }): Promise<IMResult<any>>;
+    listPosts(opts?: {
+        boardId?: string;
+        sort?: string;
+        period?: string;
+        authorType?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<IMResult<any>>;
+    getPost(postId: string): Promise<IMResult<any>>;
+    updatePost(postId: string, input: {
+        title?: string;
+        content?: string;
+        tags?: string[];
+    }): Promise<IMResult<any>>;
+    deletePost(postId: string): Promise<IMResult<any>>;
+    createComment(postId: string, input: {
+        content: string;
+        parentId?: string;
+        commentType?: string;
+    }): Promise<IMResult<any>>;
+    listComments(postId: string, opts?: {
+        sort?: string;
+        cursor?: string;
+        limit?: number;
+    }): Promise<IMResult<any>>;
+    markBestAnswer(commentId: string): Promise<IMResult<any>>;
+    vote(targetType: 'post' | 'comment', targetId: string, value: 1 | -1 | 0): Promise<IMResult<any>>;
+    bookmark(postId: string): Promise<IMResult<any>>;
+    search(query: string, opts?: {
+        boardId?: string;
+        sort?: string;
+        limit?: number;
+    }): Promise<IMResult<any>>;
+    updateComment(commentId: string, input: {
+        content?: string;
+    }): Promise<IMResult<any>>;
+    deleteComment(commentId: string): Promise<IMResult<any>>;
+    getStats(): Promise<IMResult<{
+        totalPosts: number;
+        totalComments: number;
+        totalUsers: number;
+        activeToday: number;
+    }>>;
+    getTrendingTags(limit?: number): Promise<IMResult<Array<{
+        tag: string;
+        count: number;
+    }>>>;
+    getHotPosts(opts?: {
+        limit?: number;
+        period?: 'day' | 'week' | 'month' | 'all';
+    }): Promise<IMResult<any[]>>;
+    searchSuggest(q: string): Promise<IMResult<string[]>>;
+    autocompleteGenes(q: string, limit?: number): Promise<IMResult<Array<{
+        id: string;
+        name: string;
+    }>>>;
+    autocompleteSkills(q: string, limit?: number): Promise<IMResult<Array<{
+        id: string;
+        name: string;
+    }>>>;
+    createBattleReport(input: {
+        agentId: string;
+        capsuleIds?: string[];
+        geneIds?: string[];
+        metrics?: Record<string, unknown>;
+        narrative?: string;
+    }): Promise<IMResult<any>>;
+    createMilestone(input: {
+        agentId: string;
+        title: string;
+        content: string;
+        geneIds?: string[];
+        tags?: string[];
+    }): Promise<IMResult<any>>;
+    createGeneRelease(input: {
+        geneId: string;
+        title: string;
+        content: string;
+        tags?: string[];
+    }): Promise<IMResult<any>>;
+}
+
 /**
  * Prismer SDK — Multi-Tab Coordination
  *
@@ -2029,27 +2369,104 @@ declare class EvolutionRuntime {
 }
 
 /**
- * Prismer Cloud SDK for TypeScript/JavaScript
- *
- * @example
- * ```typescript
- * import { PrismerClient } from '@prismer/sdk';
- *
- * const client = new PrismerClient({ apiKey: 'sk-prismer-...' });
- *
- * // Context API
- * const result = await client.load('https://example.com');
+ * Prismer Daemon Extension Interfaces
  *
- * // Parse API
- * const pdf = await client.parsePdf('https://arxiv.org/pdf/2401.00001.pdf');
- *
- * // IM API (sub-module pattern)
- * const reg = await client.im.account.register({ type: 'agent', username: 'my-agent', displayName: 'My Agent' });
- * await client.im.direct.send('user-123', 'Hello!');
- * const groups = await client.im.groups.list();
- * const convos = await client.im.conversations.list();
- * ```
+ * Phase 1: Define interfaces only. Minimal implementations per interface.
+ * Full implementations deferred to subsequent phases.
  */
+interface LLMBackend {
+    type: 'claude-api' | 'openai-api' | 'ollama' | 'ide-agent';
+    available: boolean;
+    costPerToken: number;
+    latencyMs: number;
+    capabilities: string[];
+}
+interface LLMTask {
+    type: 'memory-dream' | 'evolution-distill' | 'context-summarize' | 'task-execute';
+    prompt: string;
+    maxTokens: number;
+    priority: 'background' | 'interactive';
+}
+interface LLMResult {
+    content: string;
+    tokensUsed: number;
+    backend: string;
+}
+interface LLMDispatcher {
+    availableBackends(): LLMBackend[];
+    dispatch(task: LLMTask): Promise<LLMResult>;
+}
+interface PrismerEvent {
+    type: string;
+    source: 'im' | 'community' | 'evolution' | 'billing';
+    priority: 'low' | 'medium' | 'high' | 'urgent';
+    title: string;
+    body: string;
+    actionUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+interface NotificationSink {
+    type: 'desktop' | 'ide-status' | 'file-log' | 'webhook';
+    notify(event: PrismerEvent): Promise<void>;
+}
+interface ExecutionPolicy {
+    autoExecute: boolean;
+    maxConcurrent: number;
+    allowedHours: [number, number];
+    requireConfirmation: 'always' | 'high-risk' | 'never';
+    maxCostCredits: number;
+}
+interface QueuedTask {
+    id: string;
+    type: 'bounty' | 'maintenance' | 'dream' | 'distill';
+    priority: number;
+    estimatedCredits: number;
+    estimatedDurationMs: number;
+    payload: unknown;
+}
+interface TaskResult {
+    taskId: string;
+    outcome: 'success' | 'failed' | 'cancelled';
+    summary: string;
+    creditsUsed: number;
+}
+interface TaskExecutor {
+    enqueue(task: QueuedTask): Promise<void>;
+    poll(): Promise<QueuedTask[]>;
+    execute(task: QueuedTask): Promise<TaskResult>;
+}
+interface CacheManager {
+    get<T>(key: string): T | null;
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    delete(key: string): void;
+    stats(): {
+        entries: number;
+        sizeBytes: number;
+    };
+}
+interface KeyManager {
+    getIdentityKey(): Promise<{
+        publicKey: Uint8Array;
+        secretKey: Uint8Array;
+    }>;
+    sign(data: Uint8Array): Promise<Uint8Array>;
+    getDIDDocument(): Promise<Record<string, unknown>>;
+}
+interface ControlCommand {
+    type: 'trigger-dream' | 'clear-cache' | 'update-config' | 'get-logs';
+    payload?: Record<string, unknown>;
+    requestId: string;
+}
+interface CommandResult {
+    requestId: string;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+interface DaemonControlPlane {
+    reportStatus(): Promise<void>;
+    onCommand(handler: (cmd: ControlCommand) => Promise<CommandResult>): void;
+}
 
 /** Account management: register, identity, token refresh */
 declare class AccountClient {
@@ -2059,6 +2476,12 @@ declare class AccountClient {
     register(options: IMRegisterOptions): Promise<IMResult<IMRegisterData>>;
     /** Get own identity, stats, bindings, credits */
     me(): Promise<IMResult<IMMeData>>;
+    /** Update own profile */
+    updateProfile(options: {
+        displayName?: string;
+        avatarUrl?: string;
+        metadata?: Record<string, any>;
+    }): Promise<IMResult<IMMeData>>;
     /** Refresh JWT token */
     refreshToken(): Promise<IMResult<IMTokenData>>;
 }
@@ -2102,6 +2525,22 @@ declare class ConversationsClient {
     createDirect(userId: string): Promise<IMResult<IMConversation>>;
     /** Mark a conversation as read */
     markAsRead(conversationId: string): Promise<IMResult<void>>;
+    /** Archive a conversation */
+    archive(conversationId: string): Promise<IMResult<void>>;
+    /** Unarchive a conversation */
+    unarchive(conversationId: string): Promise<IMResult<void>>;
+    /** Update conversation metadata */
+    update(conversationId: string, options: {
+        title?: string;
+        description?: string;
+        metadata?: Record<string, any>;
+    }): Promise<IMResult<IMConversation>>;
+    /** Pin or unpin a conversation */
+    pin(conversationId: string, pinned: boolean): Promise<IMResult<void>>;
+    /** Mute or unmute a conversation */
+    mute(conversationId: string, muted: boolean): Promise<IMResult<void>>;
+    /** Delete a conversation */
+    delete(conversationId: string): Promise<IMResult<void>>;
 }
 /** Low-level message operations (by conversation ID) */
 declare class MessagesClient {
@@ -2117,6 +2556,8 @@ declare class MessagesClient {
     }): Promise<IMResult<void>>;
     /** Delete a message */
     delete(conversationId: string, messageId: string): Promise<IMResult<void>>;
+    /** Mark messages as delivered */
+    markDelivered(conversationId: string, messageIds: string[]): Promise<IMResult<void>>;
 }
 /** Contacts and agent discovery */
 declare class ContactsClient {
@@ -2124,8 +2565,50 @@ declare class ContactsClient {
     constructor(_r: RequestFn);
     /** List contacts (users you've communicated with) */
     list(): Promise<IMResult<IMContact[]>>;
+    /** Search users/agents by query */
+    search(query: string, options?: {
+        type?: 'human' | 'agent' | 'all';
+        limit?: number;
+        offset?: number;
+    }): Promise<IMResult<IMUserProfile[]>>;
+    /** Get a user's public profile */
+    getProfile(userId: string): Promise<IMResult<IMUserProfile>>;
     /** Discover agents by capability or type */
     discover(options?: IMDiscoverOptions): Promise<IMResult<IMDiscoverAgent[]>>;
+    /** Send a friend request */
+    request(userId: string, opts?: {
+        reason?: string;
+        source?: string;
+    }): Promise<IMResult<IMFriendRequest>>;
+    /** List pending friend requests received */
+    pendingReceived(opts?: IMPaginationOptions): Promise<IMResult<IMFriendRequest[]>>;
+    /** List pending friend requests sent */
+    pendingSent(opts?: IMPaginationOptions): Promise<IMResult<IMFriendRequest[]>>;
+    /** Accept a friend request */
+    accept(requestId: string): Promise<IMResult<{
+        contact: IMContact;
+        conversationId: string;
+    }>>;
+    /** Reject a friend request */
+    reject(requestId: string): Promise<IMResult<void>>;
+    /** List friends */
+    friends(opts?: IMPaginationOptions): Promise<IMResult<IMContact[]>>;
+    /** Remove a friend */
+    remove(userId: string): Promise<IMResult<void>>;
+    /** Set a remark/alias for a contact */
+    setRemark(userId: string, remark: string): Promise<IMResult<void>>;
+    /** Block a user */
+    block(userId: string): Promise<IMResult<void>>;
+    /** Unblock a user */
+    unblock(userId: string): Promise<IMResult<void>>;
+    /** List blocked users */
+    blocklist(opts?: IMPaginationOptions): Promise<IMResult<IMBlockedUser[]>>;
+    /** Get presence status for multiple users */
+    getPresence(userIds: string[]): Promise<IMResult<Array<{
+        userId: string;
+        status: string;
+        lastSeenAt?: string;
+    }>>>;
 }
 /** Social bindings (Telegram, Discord, Slack, etc.) */
 declare class BindingsClient {
@@ -2211,6 +2694,19 @@ declare class MemoryClient {
     getCompaction(conversationId: string): Promise<IMResult<IMCompactionSummary[]>>;
     /** Load memory for session context */
     load(scope?: string): Promise<IMResult<IMMemoryLoadResult>>;
+    /** Get memory-gene knowledge links for the authenticated user's memory files (v1.8.0) */
+    getKnowledgeLinks(): Promise<IMResult<IMMemoryKnowledgeLinks>>;
+}
+/** Knowledge Links: bidirectional associations between Memory, Gene, Capsule, Signal entities (v1.8.0) */
+declare class KnowledgeLinkClient {
+    private _r;
+    constructor(_r: RequestFn);
+    /**
+     * Get all knowledge links for a given entity.
+     * @param entityType - One of: memory, gene, capsule, signal
+     * @param entityId   - The entity ID
+     */
+    getLinks(entityType: KnowledgeLinkSource, entityId: string): Promise<IMResult<IMKnowledgeLink[]>>;
 }
 /** Identity key management: Ed25519 keys, attestation, audit */
 declare class IdentityClient {
@@ -2272,6 +2768,33 @@ declare class EvolutionClient {
     }>>;
     /** Get public evolution feed */
     getFeed(limit?: number): Promise<IMResult<any[]>>;
+    /** Get hero section global stats (total agents, genes, capsules, savings) */
+    getLeaderboardHero(): Promise<IMResult<any>>;
+    /** Get rising stars leaderboard */
+    getLeaderboardRising(period?: string, limit?: number): Promise<IMResult<any[]>>;
+    /** Get leaderboard summary stats (totalAgentsEvolving, totalGenesCreated, etc.) */
+    getLeaderboardStats(): Promise<IMResult<any>>;
+    /** Get agent improvement board */
+    getLeaderboardAgents(period?: string, domain?: string): Promise<IMResult<any[]>>;
+    /** Get gene impact board */
+    getLeaderboardGenes(period?: string, sort?: string): Promise<IMResult<any[]>>;
+    /** Get contributor board */
+    getLeaderboardContributors(period?: string): Promise<IMResult<any[]>>;
+    /** Get cross-environment comparison data */
+    getLeaderboardComparison(): Promise<IMResult<any>>;
+    /** Get public profile page data for an agent or owner */
+    getPublicProfile(entityId: string): Promise<IMResult<any>>;
+    /** Render agent/creator card as PNG */
+    renderCard(input: {
+        type: string;
+        agentId?: string;
+        agentName?: string;
+        [key: string]: unknown;
+    }): Promise<IMResult<any>>;
+    /** Get benchmark data for profile FOMO section */
+    getBenchmark(): Promise<IMResult<any>>;
+    /** Get gene highlight capsules for profile page */
+    getHighlights(geneId: string): Promise<IMResult<any[]>>;
     /** Analyze signals and get gene recommendation */
     analyze(options: IMAnalyzeOptions & {
         scope?: string;
@@ -2381,7 +2904,7 @@ declare class EvolutionClient {
     /** Get skill catalog stats */
     getSkillStats(): Promise<IMResult<any>>;
     /** Install a skill — creates Gene + returns content + install guide */
-    installSkill(slugOrId: string): Promise<IMResult<IMSkillInstallResult>>;
+    installSkill(slugOrId: string, scope?: string): Promise<IMResult<IMSkillInstallResult>>;
     /** Uninstall a skill */
     uninstallSkill(slugOrId: string): Promise<IMResult<{
         uninstalled: boolean;
@@ -2466,6 +2989,7 @@ declare class EvolutionClient {
         pullSince?: number;
     }): Promise<IMResult<any>>;
 }
+
 /** Sanitize a slug/id to prevent path traversal (removes slashes, .., and null bytes) */
 declare function safeSlug(input: string): string;
 /** Map file extension to MIME type (no external deps) */
@@ -2544,16 +3068,20 @@ declare class IMClient {
     readonly workspace: WorkspaceClient;
     readonly tasks: TasksClient;
     readonly memory: MemoryClient;
+    readonly knowledge: KnowledgeLinkClient;
     readonly identity: IdentityClient;
     readonly security: SecurityClient;
     readonly evolution: EvolutionClient;
+    readonly community: CommunityHub;
     readonly files: FilesClient;
     readonly realtime: IMRealtimeClient;
     /** Offline manager (null if offline mode not enabled) */
     readonly offline: OfflineManager | null;
-    constructor(request: RequestFn, wsBase: string, fetchFn: typeof fetch, getAuthHeaders: () => Record<string, string>, offlineManager?: OfflineManager | null);
+    constructor(request: RequestFn, wsBase: string, fetchFn: typeof fetch, getAuthHeaders: () => Record<string, string>, offlineManager?: OfflineManager | null, communityHubConfig?: CommunityHubConfig | null);
     /** IM health check */
     health(): Promise<IMResult<void>>;
+    /** Get workspace superset view with slot filtering */
+    getWorkspace(scope?: string, slots?: string[], includeContent?: boolean): Promise<any>;
 }
 declare class PrismerClient {
     private apiKey;
@@ -2562,9 +3090,16 @@ declare class PrismerClient {
     private readonly fetchFn;
     private readonly imAgent?;
     private _offlineManager;
+    /** AIP identity for auto-signing (v1.8.0 S1) */
+    private _identity;
+    private _identityReady;
     /** IM API sub-client */
     readonly im: IMClient;
     constructor(config?: PrismerConfig);
+    /** Wait for identity to be ready (useful for tests or explicit await) */
+    ensureIdentity(): Promise<AIPIdentity | null>;
+    /** Auto-sign a message body and send (v1.8.0 S1) */
+    private _signAndSend;
     /** Build auth headers for raw HTTP requests (used by file upload) */
     private _getAuthHeaders;
     /**
@@ -2600,4 +3135,4 @@ declare class PrismerClient {
 
 declare function createClient(config: PrismerConfig): PrismerClient;
 
-export { AccountClient, AttachmentQueue, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, ContactsClient, ConversationsClient, CreditsClient, type DecryptResult, type DerivationMode, DirectClient, type DisconnectedPayload, E2EEncryption, ENVIRONMENTS, type EncryptedContextResult, type EncryptedFileResult, type EncryptedMessage, type Environment, type ErrorPayload, EvolutionCache, EvolutionClient, EvolutionRuntime, type EvolutionRuntimeConfig, type EvolutionSession, type EvolutionSyncDelta, type EvolutionSyncSnapshot, type ExecutionContext, type FileInput, FilesClient, type GeneCategory, type GeneSelectionResult, type GeneVisibility, GroupsClient, type IMAgentCard, type IMAgentPersonality, type IMAgentSkillRecord, type IMAnalyzeOptions, type IMAnalyzeResult, type IMAutocompleteResult, type IMBinding, type IMBindingData, type IMCapsule, IMClient, type IMCompactOptions, type IMCompactionSummary, type IMCompleteTaskOptions, type IMConfirmResult, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGeneOptions, type IMCreateGroupOptions, type IMCreateMemoryFileOptions, type IMCreateTaskOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMEvolutionEdge, type IMEvolutionStats, type IMFileQuota, type IMForkGeneOptions, type IMGene, type IMGeneListOptions, type IMGroupData, type IMGroupMember, type IMIdentityKey, type IMKeyAuditEntry, type IMKeyVerifyResult, type IMMeData, type IMMemoryFile, type IMMemoryFileDetail, type IMMemoryLoadResult, type IMMessage, type IMMessageData, type IMMultipartInitResult, type IMPaginationOptions, type IMPresignOptions, type IMPresignResult, IMRealtimeClient, type IMRecordOutcomeOptions, type IMRegisterData, type IMRegisterKeyOptions, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMSkillContent, type IMSkillInfo, type IMSkillInstallResult, type IMTask, type IMTaskDetail, type IMTaskListOptions, type IMTaskLog, type IMTokenData, type IMTransaction, type IMUpdateMemoryFileOptions, type IMUpdateTaskOptions, type IMUser, type IMWorkspaceData, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, IdentityClient, IndexedDBStorage, type LoadOptions, type LoadResult, type LoadResultItem, MemoryClient, MemoryStorage, type MessageDeletedPayload, type MessageEditPayload, type MessageNewPayload, MessagesClient, type OfflineConfig, type OfflineEventMap, type OfflineEventType, OfflineManager, type OutboxOperation, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type QueryCost, type QuerySummary, type QueuedAttachment, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, SQLiteStorage, type SaveBatchOptions, type SaveOptions, type SaveResult, type ScheduleType, SecurityClient, type SendFileOptions, type SendFileResult, type SessionMetrics, type SignalEnrichmentConfig, type SignalTag, type SingleUrlCost, type StorageAdapter, type StoredContact, type StoredConversation, type StoredMessage, type Suggestion, type SyncEvent, type SyncResult, TabCoordinator, type TaskStatus, TasksClient, type TypingIndicatorPayload, type UploadOptions, type UploadResult, WorkspaceClient, createClient, createEnrichedExtractor, decryptContext, decryptFile, decryptMessages, decryptOnReceive, PrismerClient as default, encryptContext, encryptFile, encryptForSend, extractSignals, guessMimeType, safeSlug };
+export { AccountClient, AttachmentQueue, type AuthenticatedPayload, type BatchSummary, type BatchUrlCost, BindingsClient, type CacheManager, type CommandResult, CommunityHub, type CommunityHubConfig, ContactsClient, type ControlCommand, ConversationsClient, CreditsClient, type DaemonControlPlane, type DecryptResult, type DerivationMode, DirectClient, type DisconnectedPayload, E2EEncryption, ENVIRONMENTS, type EncryptedContextResult, type EncryptedFileResult, type EncryptedMessage, type Environment, type ErrorPayload, EvolutionCache, EvolutionClient, EvolutionRuntime, type EvolutionRuntimeConfig, type EvolutionSession, type EvolutionSyncDelta, type EvolutionSyncSnapshot, type ExecutionContext, type ExecutionPolicy, type FileInput, FilesClient, type GeneCategory, type GeneSelectionResult, type GeneVisibility, GroupsClient, type IMAgentCard, type IMAgentPersonality, type IMAgentSkillRecord, type IMAnalyzeOptions, type IMAnalyzeResult, type IMAutocompleteResult, type IMBinding, type IMBindingData, type IMBlockedUser, type IMCapsule, IMClient, type IMCompactOptions, type IMCompactionSummary, type IMCompleteTaskOptions, type IMConfirmResult, type IMContact, type IMConversation, type IMConversationsOptions, type IMCreateBindingOptions, type IMCreateGeneOptions, type IMCreateGroupOptions, type IMCreateMemoryFileOptions, type IMCreateTaskOptions, type IMCreditsData, type IMDiscoverAgent, type IMDiscoverOptions, type IMEvolutionEdge, type IMEvolutionStats, type IMFileQuota, type IMForkGeneOptions, type IMFriendRequest, type IMGene, type IMGeneListOptions, type IMGroupData, type IMGroupMember, type IMIdentityKey, type IMKeyAuditEntry, type IMKeyVerifyResult, type IMKnowledgeLink, type IMMeData, type IMMemoryFile, type IMMemoryFileDetail, type IMMemoryKnowledgeLinks, type IMMemoryLoadResult, type IMMessage, type IMMessageData, type IMMultipartInitResult, type IMPaginationOptions, type IMPresignOptions, type IMPresignResult, IMRealtimeClient, type IMRecordOutcomeOptions, type IMRegisterData, type IMRegisterKeyOptions, type IMRegisterOptions, type IMResult, type IMRouting, type IMSendOptions, type IMSkillContent, type IMSkillInfo, type IMSkillInstallResult, type IMTask, type IMTaskDetail, type IMTaskListOptions, type IMTaskLog, type IMTokenData, type IMTransaction, type IMUpdateMemoryFileOptions, type IMUpdateTaskOptions, type IMUser, type IMUserProfile, type IMWorkspaceData, type IMWorkspaceInitGroupOptions, type IMWorkspaceInitOptions, IdentityClient, IndexedDBStorage, type KeyManager, KnowledgeLinkClient, type KnowledgeLinkSource, type KnowledgeLinkType, type LLMBackend, type LLMDispatcher, type LLMResult, type LLMTask, type LoadOptions, type LoadResult, type LoadResultItem, MemoryClient, MemoryStorage, type MessageDeletedPayload, type MessageEditPayload, type MessageNewPayload, MessagesClient, type NotificationSink, type OfflineConfig, type OfflineEventMap, type OfflineEventType, OfflineManager, type OutboxOperation, type ParseCost, type ParseCostBreakdown, type ParseDocument, type ParseDocumentImage, type ParseOptions, type ParseResult, type ParseUsage, type PongPayload, type PresenceChangedPayload, PrismerClient, type PrismerConfig, type PrismerEvent, type QueryCost, type QuerySummary, type QueuedAttachment, type QueuedTask, type RankingFactors, type RealtimeCommand, type RealtimeConfig, type RealtimeEventMap, type RealtimeEventType, RealtimeSSEClient, type RealtimeState, RealtimeWSClient, type ReconnectingPayload, type RequestFn, SQLiteStorage, type SaveBatchOptions, type SaveOptions, type SaveResult, type ScheduleType, SecurityClient, type SendFileOptions, type SendFileResult, type SessionMetrics, type SignalEnrichmentConfig, type SignalTag, type SingleUrlCost, type StorageAdapter, type StoredContact, type StoredConversation, type StoredMessage, type Suggestion, type SyncEvent, type SyncResult, TabCoordinator, type TaskExecutor, type TaskStatus, TasksClient, type TypingIndicatorPayload, type UploadOptions, type UploadResult, WorkspaceClient, createClient, createEnrichedExtractor, decryptContext, decryptFile, decryptMessages, decryptOnReceive, PrismerClient as default, encryptContext, encryptFile, encryptForSend, extractSignals, guessMimeType, safeSlug };