@vibesdotdev/session 0.0.0-stage → 1.0.0-rc.2

package/dist/tools/lifecycle/packet/handler.d.ts

@@ -0,0 +1,490 @@
+/**
+ * Read-only session resume packet.
+ *
+ * Deterministic hydration for reconnect. Renews the caller membership lease
+ * only; never mutates session lifecycle status (use action:"resume").
+ */
+import type { SessionManager } from '../../../manager.ts';
+import type { Session } from '../../../schemas/index.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export interface SessionPacketInput {
+    sessionId?: string;
+    /** Max assigned/blocked todos (default 20). */
+    todoLimit?: number;
+    /** Max handoff note bodies (default 5). */
+    noteLimit?: number;
+    /** Max unread and failed messages per collection (default 20). */
+    messageLimit?: number;
+}
+type PacketSessionManager = Pick<SessionManager, 'acquireMembershipLease' | 'getMessages' | 'getParticipant' | 'getScratchpadEntry' | 'getSessionStats' | 'listActiveMembershipLeases' | 'listScratchpad' | 'listTodos'> & {
+    getConnectionHistory?: SessionManager['getConnectionHistory'];
+};
+/** The failure facts a failed-message entry reports: bounded, and the free-text reason credential-redacted. */
+interface PacketFailureMetadata {
+    status: 'failed';
+    code?: string;
+    reason?: string;
+    batchId?: string;
+    retryable?: boolean;
+    batchIndex?: number;
+}
+export declare function buildSessionResumePacket(input: {
+    session: PacketSessionManager;
+    sessionData: Session;
+    sessionId: string;
+    participantId?: string | null;
+    mcpSessionId?: string | null;
+    connectionKey?: string | null;
+    limits?: Pick<SessionPacketInput, 'todoLimit' | 'noteLimit' | 'messageLimit'>;
+    /** The invoking runtime, whose Logging receives the packet's degradation reports. */
+    runtime?: VibesRuntime;
+}): Promise<{
+    kind: "session.resume-packet";
+    identity: {
+        sessionId: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        callerParticipantId: string | null;
+        projectId: string | undefined;
+    };
+    workContinuity: {
+        kind: "work.continuity-receipt";
+        session: {
+            id: string;
+            participantId: string | null;
+            connectionKey: string | null;
+            state: "active" | "paused" | "archived";
+        };
+        workspace: {
+            workspaceId: string;
+            projectId: string | undefined;
+            cwdLabel: string | undefined;
+        };
+        links: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[];
+        roster: {
+            participantId: string;
+            name: string;
+            slug: string | null;
+            participantRole: string | null;
+            capabilities: string[];
+            clientInfo: {
+                name?: string | undefined;
+                version?: string | undefined;
+                surface?: string | undefined;
+                externalToolId?: string | undefined;
+                machineId?: string | undefined;
+            } | null;
+            connectionKey: string;
+            connectionKeys: string[];
+            connectionCount: number;
+            connections: {
+                connectionKey: string;
+                role: "owner" | "member";
+                joinedAt: string | undefined;
+                lastHeartbeatAt: string | undefined;
+                expiresAt: string | undefined;
+            }[];
+            role: "owner" | "member";
+            joinedAt: string;
+            lastHeartbeatAt: string | undefined;
+            expiresAt: string | undefined;
+            claimedTodoIds: string[];
+        }[];
+        capabilitySnapshot: {
+            available: string[];
+            linkedOnly: string[];
+            degraded: string[];
+        };
+        status: {
+            phase: "active" | "paused" | "archived";
+            lastActivityAt: string | undefined;
+            assignedOrBlocked: number;
+            unread: number;
+            failed: number;
+        };
+        continuity: "degraded" | "applied";
+    };
+    roster: {
+        participantId: string;
+        name: string;
+        slug: string | null;
+        participantRole: string | null;
+        capabilities: string[];
+        clientInfo: {
+            name?: string | undefined;
+            version?: string | undefined;
+            surface?: string | undefined;
+            externalToolId?: string | undefined;
+            machineId?: string | undefined;
+        } | null;
+        connectionKey: string;
+        connectionKeys: string[];
+        connectionCount: number;
+        connections: {
+            connectionKey: string;
+            role: "owner" | "member";
+            joinedAt: string | undefined;
+            lastHeartbeatAt: string | undefined;
+            expiresAt: string | undefined;
+        }[];
+        role: "owner" | "member";
+        joinedAt: string;
+        lastHeartbeatAt: string | undefined;
+        expiresAt: string | undefined;
+        claimedTodoIds: string[];
+    }[];
+    todos: {
+        items: import("./todos.ts").PacketTodoEntry[];
+        returned: number;
+        hasMore: boolean;
+    };
+    handoffNotes: {
+        items: {
+            key: string;
+            contentType: "code" | "text" | "json" | "markdown";
+            body: string;
+            updatedAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+    };
+    unread: {
+        items: {
+            id: string;
+            fromParticipant: string;
+            toParticipant: string | null;
+            content: string;
+            createdAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+        count: number;
+    };
+    failed: {
+        items: {
+            metadata: PacketFailureMetadata;
+            id: string;
+            fromParticipant: string;
+            toParticipant: string | null;
+            content: string;
+            createdAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+        count: number;
+    };
+    stats: {
+        session: {
+            id: string;
+            title: string;
+            status: "active" | "paused" | "archived";
+            scope: "local" | "global" | "project";
+            tags: string[];
+            ownerParticipant: string;
+            metadata: {
+                [x: string]: unknown;
+                source?: string | undefined;
+                version?: string | undefined;
+                gitBranch?: string | undefined;
+                gitCommit?: string | undefined;
+                linearIssueId?: string | undefined;
+                githubPrNumber?: number | undefined;
+                sessionType?: string | undefined;
+                custom?: Record<string, unknown> | undefined;
+            };
+            createdAt: Date;
+            updatedAt: Date;
+            lastActivityAt: Date;
+            description?: string | undefined;
+            projectId?: string | undefined;
+            filesPattern?: string[] | undefined;
+            workItemId?: string | undefined;
+            links?: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            }[] | undefined;
+            parentSessionId?: string | null | undefined;
+            assignedParticipant?: string | undefined;
+            pausedAt?: Date | undefined;
+            archivedAt?: Date | undefined;
+        };
+        todos: {
+            total: number;
+            completed: number;
+            active: number;
+            blocked: number;
+            awaitingDependencies: number;
+            pending: number;
+        };
+        scratchpad: {
+            total: number;
+            byType: Record<string, number>;
+        };
+        jobs: {
+            total: number;
+            completed: number;
+            pending: number;
+            processing: number;
+            failed: number;
+        };
+        messages: {
+            total: number;
+            unread: number;
+            scope: "session" | "participant";
+            participantId: string | undefined;
+        };
+    } | null;
+    capabilities: {
+        membershipLeases: boolean;
+        callerLeaseRenewed: boolean;
+        collections: {
+            membershipLeases: "ok" | "degraded";
+            participants: "ok" | "degraded";
+            todos: "ok" | "degraded";
+            handoffNotes: "ok" | "degraded";
+            messages: "ok" | "degraded";
+            stats: "ok" | "degraded";
+        };
+        degraded: string[];
+    };
+    callerLease: {
+        id: string;
+        expiresAt: string | undefined;
+        connectionKey: string;
+        role: "owner" | "member";
+    } | null;
+}>;
+export declare function sessionPacketHandler(args: SessionPacketInput, mcpSessionId?: string | null, runtime?: VibesRuntime, ctx?: import('@vibesdotdev/kernel/schemas/tool-call').ToolCallContext): Promise<{
+    kind: "session.resume-packet";
+    identity: {
+        sessionId: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        callerParticipantId: string | null;
+        projectId: string | undefined;
+    };
+    workContinuity: {
+        kind: "work.continuity-receipt";
+        session: {
+            id: string;
+            participantId: string | null;
+            connectionKey: string | null;
+            state: "active" | "paused" | "archived";
+        };
+        workspace: {
+            workspaceId: string;
+            projectId: string | undefined;
+            cwdLabel: string | undefined;
+        };
+        links: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[];
+        roster: {
+            participantId: string;
+            name: string;
+            slug: string | null;
+            participantRole: string | null;
+            capabilities: string[];
+            clientInfo: {
+                name?: string | undefined;
+                version?: string | undefined;
+                surface?: string | undefined;
+                externalToolId?: string | undefined;
+                machineId?: string | undefined;
+            } | null;
+            connectionKey: string;
+            connectionKeys: string[];
+            connectionCount: number;
+            connections: {
+                connectionKey: string;
+                role: "owner" | "member";
+                joinedAt: string | undefined;
+                lastHeartbeatAt: string | undefined;
+                expiresAt: string | undefined;
+            }[];
+            role: "owner" | "member";
+            joinedAt: string;
+            lastHeartbeatAt: string | undefined;
+            expiresAt: string | undefined;
+            claimedTodoIds: string[];
+        }[];
+        capabilitySnapshot: {
+            available: string[];
+            linkedOnly: string[];
+            degraded: string[];
+        };
+        status: {
+            phase: "active" | "paused" | "archived";
+            lastActivityAt: string | undefined;
+            assignedOrBlocked: number;
+            unread: number;
+            failed: number;
+        };
+        continuity: "degraded" | "applied";
+    };
+    roster: {
+        participantId: string;
+        name: string;
+        slug: string | null;
+        participantRole: string | null;
+        capabilities: string[];
+        clientInfo: {
+            name?: string | undefined;
+            version?: string | undefined;
+            surface?: string | undefined;
+            externalToolId?: string | undefined;
+            machineId?: string | undefined;
+        } | null;
+        connectionKey: string;
+        connectionKeys: string[];
+        connectionCount: number;
+        connections: {
+            connectionKey: string;
+            role: "owner" | "member";
+            joinedAt: string | undefined;
+            lastHeartbeatAt: string | undefined;
+            expiresAt: string | undefined;
+        }[];
+        role: "owner" | "member";
+        joinedAt: string;
+        lastHeartbeatAt: string | undefined;
+        expiresAt: string | undefined;
+        claimedTodoIds: string[];
+    }[];
+    todos: {
+        items: import("./todos.ts").PacketTodoEntry[];
+        returned: number;
+        hasMore: boolean;
+    };
+    handoffNotes: {
+        items: {
+            key: string;
+            contentType: "code" | "text" | "json" | "markdown";
+            body: string;
+            updatedAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+    };
+    unread: {
+        items: {
+            id: string;
+            fromParticipant: string;
+            toParticipant: string | null;
+            content: string;
+            createdAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+        count: number;
+    };
+    failed: {
+        items: {
+            metadata: PacketFailureMetadata;
+            id: string;
+            fromParticipant: string;
+            toParticipant: string | null;
+            content: string;
+            createdAt: string | undefined;
+        }[];
+        returned: number;
+        hasMore: boolean;
+        count: number;
+    };
+    stats: {
+        session: {
+            id: string;
+            title: string;
+            status: "active" | "paused" | "archived";
+            scope: "local" | "global" | "project";
+            tags: string[];
+            ownerParticipant: string;
+            metadata: {
+                [x: string]: unknown;
+                source?: string | undefined;
+                version?: string | undefined;
+                gitBranch?: string | undefined;
+                gitCommit?: string | undefined;
+                linearIssueId?: string | undefined;
+                githubPrNumber?: number | undefined;
+                sessionType?: string | undefined;
+                custom?: Record<string, unknown> | undefined;
+            };
+            createdAt: Date;
+            updatedAt: Date;
+            lastActivityAt: Date;
+            description?: string | undefined;
+            projectId?: string | undefined;
+            filesPattern?: string[] | undefined;
+            workItemId?: string | undefined;
+            links?: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            }[] | undefined;
+            parentSessionId?: string | null | undefined;
+            assignedParticipant?: string | undefined;
+            pausedAt?: Date | undefined;
+            archivedAt?: Date | undefined;
+        };
+        todos: {
+            total: number;
+            completed: number;
+            active: number;
+            blocked: number;
+            awaitingDependencies: number;
+            pending: number;
+        };
+        scratchpad: {
+            total: number;
+            byType: Record<string, number>;
+        };
+        jobs: {
+            total: number;
+            completed: number;
+            pending: number;
+            processing: number;
+            failed: number;
+        };
+        messages: {
+            total: number;
+            unread: number;
+            scope: "session" | "participant";
+            participantId: string | undefined;
+        };
+    } | null;
+    capabilities: {
+        membershipLeases: boolean;
+        callerLeaseRenewed: boolean;
+        collections: {
+            membershipLeases: "ok" | "degraded";
+            participants: "ok" | "degraded";
+            todos: "ok" | "degraded";
+            handoffNotes: "ok" | "degraded";
+            messages: "ok" | "degraded";
+            stats: "ok" | "degraded";
+        };
+        degraded: string[];
+    };
+    callerLease: {
+        id: string;
+        expiresAt: string | undefined;
+        connectionKey: string;
+        role: "owner" | "member";
+    } | null;
+}>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/dist/tools/lifecycle/packet/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/packet/handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAsB,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAG7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAOxD,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,oBAAoB,GAAG,IAAI,CAC/B,cAAc,EACZ,wBAAwB,GACxB,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,iBAAiB,GACjB,4BAA4B,GAC5B,gBAAgB,GAChB,WAAW,CACb,GAAG;IACH,oBAAoB,CAAC,EAAE,cAAc,CAAC,sBAAsB,CAAC,CAAC;CAC9D,CAAC;AA2KF,+GAA+G;AAC/G,UAAU,qBAAqB;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AA+BD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE;IACrD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC,CAAC;IAC9E,qFAAqF;IACrF,OAAO,CAAC,EAAE,YAAY,CAAC;CACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8RA;AAED,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,kBAAkB,EACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,YAAY,EACtB,GAAG,CAAC,EAAE,OAAO,uCAAuC,EAAE,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCrE"}