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

package/dist/cockpit/build-state.js

@@ -0,0 +1,273 @@
+/**
+ * Canonical Session Cockpit page projection (D-063).
+ *
+ * Localdb and cloud readers supply storage-neutral, independently bounded pages
+ * plus full-source totals/roster/summary. This module owns wire mapping,
+ * newest-first ordering, participant enrichment, and opaque older cursors.
+ */
+import { getSessionManagerAsync } from "../mcp/utils/participant.js";
+import { messageListHandler } from "../tools/messages/handlers.js";
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+const LOCAL_READ_BATCH = 1_000;
+const DEFAULT_PAGE_LIMIT = 50;
+function toIso(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return value ?? null;
+}
+function deriveRole(profileRole) {
+    if (profileRole === 'human')
+        return 'human';
+    if (profileRole === 'lane')
+        return 'lane';
+    return 'agent';
+}
+function toBase64Url(value) {
+    return btoa(value).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/g, '');
+}
+function fromBase64Url(value) {
+    const padded = value
+        .replace(/-/g, '+')
+        .replace(/_/g, '/')
+        .padEnd(Math.ceil(value.length / 4) * 4, '=');
+    return atob(padded);
+}
+export function encodeCockpitCursor(cursor) {
+    return toBase64Url(JSON.stringify([cursor.createdAt, cursor.id]));
+}
+/** A cursor token decodes to exactly `[createdAt, id]`, two strings. */
+const CursorTupleSchema = z.tuple([z.string(), z.string()]);
+export function decodeCockpitCursor(token) {
+    try {
+        const [createdAt, id] = CursorTupleSchema.parse(JSON.parse(fromBase64Url(token)));
+        return { createdAt, id };
+    }
+    catch (error) {
+        throw new CapabilityError('The cockpit cursor is not one this server issued.', 'INVALID_INPUT', {
+            reason: 'cockpit-cursor-invalid',
+            cause: error
+        });
+    }
+}
+function newestFirst(items, createdAt, id) {
+    return [...items].sort((a, b) => {
+        const byTime = createdAt(b).localeCompare(createdAt(a));
+        return byTime || id(b).localeCompare(id(a));
+    });
+}
+function projectWindow(source, createdAt, id) {
+    const items = newestFirst(source.items, createdAt, id);
+    const oldest = items.at(-1);
+    if (source.hasMore && !oldest) {
+        throw new CapabilityError('A cockpit page reported more items without a cursor-bearing item.', 'INTERNAL', {
+            reason: 'cockpit-page-inconsistent'
+        });
+    }
+    return {
+        items,
+        nextCursor: source.hasMore && oldest
+            ? encodeCockpitCursor({ createdAt: createdAt(oldest), id: id(oldest) })
+            : null,
+        hasMore: source.hasMore,
+        total: source.total
+    };
+}
+/** Pure canonical projection shared by local and cloud adapters. */
+export async function projectSessionCockpitPage(inputs, resolvers) {
+    const presenceById = new Map();
+    for (const record of inputs.presence) {
+        if (record.participantId)
+            presenceById.set(record.participantId, record.status);
+    }
+    const participantIds = [...new Set(inputs.participantIds)].sort();
+    const participants = await Promise.all(participantIds.map(async (id) => {
+        const profile = await resolvers.getParticipant(id);
+        return {
+            id,
+            slug: profile?.slug ?? null,
+            name: profile?.name ?? null,
+            capabilities: profile?.capabilities ?? [],
+            presence: presenceById.get(id) ?? 'idle',
+            role: deriveRole(profile?.role),
+            lastSeenAt: toIso(profile?.lastSeenAt)
+        };
+    }));
+    const slugCache = new Map(participants.map((participant) => [participant.id, participant.slug]));
+    const resolveSlug = async (participantId) => {
+        if (!participantId)
+            return null;
+        if (slugCache.has(participantId))
+            return slugCache.get(participantId) ?? null;
+        const slug = await resolvers.resolveAssignedSlug(participantId);
+        slugCache.set(participantId, slug);
+        return slug;
+    };
+    const todos = await Promise.all(inputs.todos.items.map(async (todo) => ({
+        id: todo.id,
+        content: todo.content,
+        status: todo.status,
+        priority: todo.priority ?? null,
+        assignedParticipant: todo.assignedParticipant ?? null,
+        assignedParticipantSlug: await resolveSlug(todo.assignedParticipant),
+        createdAt: toIso(todo.createdAt) ?? ''
+    })));
+    const decisions = inputs.decisions.items.map((entry) => ({
+        key: entry.key,
+        title: null,
+        contentType: entry.contentType,
+        excerpt: entry.preview,
+        createdAt: toIso(entry.createdAt) ?? ''
+    }));
+    const work = inputs.work.items.map((entry) => ({
+        id: entry.id,
+        jobId: entry.jobId,
+        jobType: entry.jobType,
+        description: entry.description,
+        status: entry.status,
+        createdAt: toIso(entry.createdAt) ?? '',
+        completedAt: toIso(entry.completedAt)
+    }));
+    return {
+        sessionId: inputs.sessionId,
+        title: inputs.session.title,
+        status: inputs.session.status,
+        participants,
+        messages: projectWindow(inputs.messages, (message) => message.createdAt, (message) => message.id),
+        todos: {
+            ...projectWindow({ ...inputs.todos, items: todos }, (todo) => todo.createdAt, (todo) => todo.id),
+            statusFilter: inputs.todoStatus
+        },
+        decisions: projectWindow({ ...inputs.decisions, items: decisions }, (decision) => decision.createdAt, (decision) => decision.key),
+        work: {
+            ...projectWindow({ ...inputs.work, items: work }, (entry) => entry.createdAt, (entry) => entry.id),
+            available: inputs.work.available
+        },
+        summary: inputs.summary,
+        serverTime: inputs.serverTime ?? new Date().toISOString()
+    };
+}
+function isOlderThan(item, cursor, createdAt, id) {
+    const itemTime = createdAt(item);
+    return itemTime < cursor.createdAt || (itemTime === cursor.createdAt && id(item) < cursor.id);
+}
+function selectLocalWindow(allItems, limit, before, createdAt, id) {
+    const ordered = newestFirst(allItems, createdAt, id);
+    const cursor = before ? decodeCockpitCursor(before) : null;
+    const remaining = cursor
+        ? ordered.filter((item) => isOlderThan(item, cursor, createdAt, id))
+        : ordered;
+    return {
+        items: remaining.slice(0, limit),
+        hasMore: remaining.length > limit,
+        total: allItems.length
+    };
+}
+async function drainSource(total, load) {
+    const items = [];
+    while (items.length < total) {
+        const page = await load(LOCAL_READ_BATCH, items.length);
+        if (page.length === 0) {
+            throw new Error(`Cockpit source ended at ${items.length} rows but reported ${total}`);
+        }
+        items.push(...page);
+    }
+    return items;
+}
+/**
+ * Localdb adapter. It drains sources in bounded reads because the current
+ * StorageRecord API has no tuple-cursor primitive; callers still receive the
+ * same opaque cursor contract as the cloud adapter.
+ *
+ * @security This function does not authorize the caller. Consumers must
+ * authorize access before serializing the returned page.
+ */
+export async function buildSessionCockpitPage(runtime, sessionId, opts = {}) {
+    const manager = await getSessionManagerAsync(runtime);
+    const session = await manager.getSession(sessionId);
+    if (!session) {
+        throw new CapabilityError('The session does not exist.', 'NOT_FOUND', {
+            reason: 'session-not-found',
+            details: { kind: 'session', id: sessionId }
+        });
+    }
+    const limit = Math.max(1, Math.min(opts.limit ?? DEFAULT_PAGE_LIMIT, 100));
+    const [messageCount, todoCount, decisionCount, workCount] = await Promise.all([
+        manager.countMessages(sessionId),
+        manager.countTodos(sessionId),
+        manager.countScratchpad(sessionId),
+        manager.countJobRefs(sessionId)
+    ]);
+    const [messages, todos, decisions, work, presence, todoByStatus, urgentTodoCount] = await Promise.all([
+        drainSource(messageCount, async (pageLimit, offset) => (await messageListHandler({
+            sessionId,
+            limit: pageLimit,
+            offset,
+            unreadOnly: false,
+            participantId: opts.viewerParticipantId
+        }, null, runtime)).messages),
+        drainSource(todoCount, (pageLimit, offset) => manager.listTodosWithComputed(sessionId, { limit: pageLimit, offset })),
+        drainSource(decisionCount, (pageLimit, offset) => manager.listScratchpad(sessionId, { limit: pageLimit, offset })),
+        drainSource(workCount, (pageLimit, offset) => manager.getJobRefs(sessionId, { limit: pageLimit, offset })),
+        manager.getActivePresence(sessionId),
+        Promise.all([
+            manager.countTodos(sessionId, { status: 'pending' }),
+            manager.countTodos(sessionId, { status: 'in_progress' }),
+            manager.countTodos(sessionId, { status: 'blocked' }),
+            manager.countTodos(sessionId, { status: 'completed' }),
+            manager.countTodos(sessionId, { status: 'cancelled' })
+        ]),
+        manager.countTodos(sessionId, { priority: 'urgent' })
+    ]);
+    const filteredTodos = opts.todoStatus
+        ? todos.filter((todo) => todo.status === opts.todoStatus)
+        : todos;
+    const participantIds = new Set([session.ownerParticipant]);
+    if (session.assignedParticipant)
+        participantIds.add(session.assignedParticipant);
+    for (const message of messages) {
+        participantIds.add(message.fromParticipant);
+        if (message.toParticipant && message.toParticipant !== 'all')
+            participantIds.add(message.toParticipant);
+    }
+    for (const todo of todos)
+        if (todo.assignedParticipant)
+            participantIds.add(todo.assignedParticipant);
+    const summary = {
+        participantCount: participantIds.size,
+        messageCount,
+        todoCount,
+        decisionCount,
+        workCount,
+        lastActivityAt: toIso(session.lastActivityAt),
+        todoByStatus: {
+            pending: todoByStatus[0],
+            in_progress: todoByStatus[1],
+            blocked: todoByStatus[2],
+            completed: todoByStatus[3],
+            cancelled: todoByStatus[4]
+        },
+        urgentTodoCount
+    };
+    return projectSessionCockpitPage({
+        sessionId,
+        session: { title: session.title, status: session.status },
+        participantIds: [...participantIds],
+        presence,
+        messages: selectLocalWindow(messages, limit, opts.messageBefore, (item) => item.createdAt, (item) => item.id),
+        todos: selectLocalWindow(filteredTodos, limit, opts.todoBefore, (item) => toIso(item.createdAt) ?? '', (item) => item.id),
+        decisions: selectLocalWindow(decisions, limit, opts.decisionBefore, (item) => toIso(item.createdAt) ?? '', (item) => item.key),
+        work: {
+            ...selectLocalWindow(work, limit, opts.workBefore, (item) => toIso(item.createdAt) ?? '', (item) => item.id),
+            available: true
+        },
+        todoStatus: opts.todoStatus ?? null,
+        summary
+    }, {
+        getParticipant: (id) => manager.getParticipant(id),
+        // Every todo assignee is already in the roster (participantIds above), so the
+        // projection answers each slug from it and never asks for one it lacks.
+        resolveAssignedSlug: async () => null
+    });
+}
+//# sourceMappingURL=build-state.js.map

package/dist/cockpit/build-state.js.map

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

package/dist/cockpit/resolve-participant.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Canonical participant resolver (D-054).
+ *
+ * ONE kernel for "stable auth link → canonical session participant", used
+ * resolve-first / mint-once / link so an authenticated identity never spawns a
+ * duplicate participant. web-apps consumes it via `getOrCreateWebParticipant`
+ * (link key `webUserId`); the MCP participant minter is a planned second
+ * consumer (post-M1 refactor) so the two surfaces cannot drift and re-open the
+ * duplicate-identity bug (DT's composition flag, chair-endorsed D-054).
+ *
+ * Trusted-context: callers pass a SERVER-DERIVED identity (never a client body).
+ * The link value (e.g. the authed hq-web user id) is the canonical key; it is
+ * stored as `metadata[linkKey]` on the participant profile — additive on the
+ * `looseObject` profile metadata, no migration.
+ */
+import type { SessionManager } from '../manager/index.ts';
+export interface ParticipantLinkInput {
+    /** Metadata key the canonical link is stored under, e.g. 'webUserId'. */
+    linkKey: string;
+    /** Stable auth identifier (the authed user id). */
+    linkValue: string;
+    /** Display name for a freshly-minted participant. */
+    displayName: string;
+    /** Role for a freshly-minted participant (default 'human'). */
+    role?: string;
+    /** Capabilities for a freshly-minted participant (default []). */
+    capabilities?: string[];
+    /** Short-circuit: caller already knows the participant id (still backfills the link). */
+    existingParticipantId?: string;
+}
+/**
+ * Resolve-first / mint-once / link. Returns the canonical participantId,
+ * idempotent and cross-session-stable:
+ *   (a) `existingParticipantId` if the caller knows it (backfills the link),
+ *   (b) a participant whose `metadata[linkKey] === linkValue`,
+ *   (c) else mint ONCE with `role` and write `metadata[linkKey]=linkValue`.
+ */
+export declare function resolveOrCreateParticipantByLink(input: ParticipantLinkInput, manager?: SessionManager): Promise<string>;
+/** Server-derived authed viewer identity (normalized from the surface's auth; never a client body). */
+export interface WebAuthedIdentity {
+    /** Stable authed user id (canonical link key). */
+    userId: string;
+    /** Display name (falls back to userId). */
+    displayName?: string;
+    /** Optional: the surface already knows the viewer's participant id. */
+    existingParticipantId?: string;
+}
+/**
+ * Resolve (or mint-once) the session participant for an authenticated web
+ * viewer, keyed by `webUserId`. `sessionId` is part of the surface contract and
+ * reserved for session-scoped binding; participant profiles are global today,
+ * and the route passes the explicit `sessionId` to the write tools.
+ */
+export declare function getOrCreateWebParticipant(sessionId: string, identity: WebAuthedIdentity, manager?: SessionManager): Promise<string>;
+//# sourceMappingURL=resolve-participant.d.ts.map

package/dist/cockpit/resolve-participant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-participant.d.ts","sourceRoot":"","sources":["../../src/cockpit/resolve-participant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmB1D,MAAM,WAAW,oBAAoB;IACpC,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA6CD;;;;;;GAMG;AACH,wBAAsB,gCAAgC,CACrD,KAAK,EAAE,oBAAoB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED,uGAAuG;AACvG,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC9C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAYjB"}

package/dist/cockpit/resolve-participant.js

@@ -0,0 +1,116 @@
+/**
+ * Canonical participant resolver (D-054).
+ *
+ * ONE kernel for "stable auth link → canonical session participant", used
+ * resolve-first / mint-once / link so an authenticated identity never spawns a
+ * duplicate participant. web-apps consumes it via `getOrCreateWebParticipant`
+ * (link key `webUserId`); the MCP participant minter is a planned second
+ * consumer (post-M1 refactor) so the two surfaces cannot drift and re-open the
+ * duplicate-identity bug (DT's composition flag, chair-endorsed D-054).
+ *
+ * Trusted-context: callers pass a SERVER-DERIVED identity (never a client body).
+ * The link value (e.g. the authed hq-web user id) is the canonical key; it is
+ * stored as `metadata[linkKey]` on the participant profile — additive on the
+ * `looseObject` profile metadata, no migration.
+ */
+import * as z from 'zod/v4';
+import { getSessionManagerAsync, ensureParticipantSlug, sanitizeSlugCandidate, stableParticipantPages } from "../mcp/utils/participant.js";
+const SCAN_PAGE = 200;
+// Bounded scan (≤5000 profiles) for the metadata link. The bound is SAFE
+// because mint (c) uses a DETERMINISTIC id (`web-<sanitized-linkValue>`): a
+// scan-miss beyond the bound falls through to the clash check and CONVERGES on
+// the same row rather than duplicating. The ONE residual duplicate path is a
+// link previously backfilled (via path (a)) onto a NON-deterministic id when
+// >5000 profiles exist — a far edge. Do NOT widen this bound blindly to "fix"
+// a miss; the convergence guarantee, not the bound, is what prevents dupes.
+const SCAN_MAX_PAGES = 25;
+/** A stored link is a non-empty string under `metadata[linkKey]`; anything else is no link. */
+const LinkValueSchema = z.string().min(1);
+function readLink(metadata, linkKey) {
+    const value = LinkValueSchema.safeParse(metadata?.[linkKey]);
+    return value.success ? value.data : undefined;
+}
+/** Ensure the participant's metadata carries `linkKey === linkValue` (backfill once). */
+async function ensureLink(session, participantId, metadata, linkKey, linkValue) {
+    if (readLink(metadata, linkKey) === linkValue)
+        return;
+    const base = metadata ?? {};
+    await session.updateParticipant(participantId, {
+        metadata: { ...base, [linkKey]: linkValue }
+    });
+}
+/** Bounded scan for a participant whose `metadata[linkKey] === linkValue`. */
+async function scanParticipantByLink(session, linkKey, linkValue) {
+    let pages = 0;
+    for await (const participants of stableParticipantPages(session, SCAN_PAGE)) {
+        for (const participant of participants) {
+            if (readLink(participant.metadata, linkKey) === linkValue) {
+                return { participantId: participant.participantId };
+            }
+        }
+        if (++pages >= SCAN_MAX_PAGES)
+            break;
+    }
+    return null;
+}
+/**
+ * Resolve-first / mint-once / link. Returns the canonical participantId,
+ * idempotent and cross-session-stable:
+ *   (a) `existingParticipantId` if the caller knows it (backfills the link),
+ *   (b) a participant whose `metadata[linkKey] === linkValue`,
+ *   (c) else mint ONCE with `role` and write `metadata[linkKey]=linkValue`.
+ */
+export async function resolveOrCreateParticipantByLink(input, manager) {
+    const session = manager ?? (await getSessionManagerAsync());
+    const { linkKey, linkValue, displayName, role, capabilities, existingParticipantId } = input;
+    // (a) explicit existing id
+    if (existingParticipantId) {
+        const existing = await session.getParticipant(existingParticipantId);
+        if (existing) {
+            await ensureLink(session, existing.participantId, existing.metadata, linkKey, linkValue);
+            return existing.participantId;
+        }
+    }
+    // (b) resolve by the canonical link
+    const linked = await scanParticipantByLink(session, linkKey, linkValue);
+    if (linked)
+        return linked.participantId;
+    // (c) mint once + link. Deterministic id so a race resolves to the same row.
+    const participantId = `web-${sanitizeSlugCandidate(linkValue)}`;
+    const clash = await session.getParticipant(participantId);
+    if (clash) {
+        await ensureLink(session, clash.participantId, clash.metadata, linkKey, linkValue);
+        return clash.participantId;
+    }
+    await session.registerParticipant({
+        participantId,
+        name: displayName,
+        role: role ?? 'human',
+        capabilities: capabilities ?? [],
+        metadata: {
+            [linkKey]: linkValue,
+            source: 'web',
+            slug: sanitizeSlugCandidate(displayName),
+            registeredAt: new Date().toISOString()
+        }
+    });
+    await ensureParticipantSlug(session, participantId);
+    return participantId;
+}
+/**
+ * Resolve (or mint-once) the session participant for an authenticated web
+ * viewer, keyed by `webUserId`. `sessionId` is part of the surface contract and
+ * reserved for session-scoped binding; participant profiles are global today,
+ * and the route passes the explicit `sessionId` to the write tools.
+ */
+export async function getOrCreateWebParticipant(sessionId, identity, manager) {
+    void sessionId; // reserved for future session-scoped binding; see doc above.
+    return resolveOrCreateParticipantByLink({
+        linkKey: 'webUserId',
+        linkValue: identity.userId,
+        displayName: identity.displayName ?? identity.userId,
+        role: 'human',
+        existingParticipantId: identity.existingParticipantId
+    }, manager);
+}
+//# sourceMappingURL=resolve-participant.js.map

package/dist/cockpit/resolve-participant.js.map

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

package/dist/docs/session.docs.descriptor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Session docs/topic descriptors (Rule 11).
+ *
+ * `@vibesdotdev/session` ships five `tools/tool` descriptors
+ * (session, session-todo, session-scratchpad, session-collaborate,
+ * session-workspace), eleven storage record/manifest descriptors, and three
+ * CLI groups (session, session.todo, session.scratchpad) — but had zero
+ * docs/topic coverage. This file defines the parent `session` topic plus
+ * child topics so the docs surface (CLI `vibes docs`, web, in-app, MCP
+ * tool-help) can resolve real help instead of a synthesized stub.
+ *
+ * Topic tree:
+ *   session              (parent — overview + manifest + tools + CLI map)
+ *   ├─ session.state     (session-state storage manifest + records)
+ *   ├─ session.todo      (session-todo tool + todo CLI group)
+ *   ├─ session.scratchpad(session-scratchpad tool + scratchpad CLI group)
+ *   └─ session.collaborate (session-collaborate + session-workspace tools)
+ *
+ * Each child is registered in `session.plugin.ts` `descriptors[]`.
+ */
+import type { DocsTopicDescriptor } from '@vibesdotdev/docs-contracts';
+export declare const sessionDocsDescriptors: DocsTopicDescriptor[];
+export default sessionDocsDescriptors;
+//# sourceMappingURL=session.docs.descriptor.d.ts.map

package/dist/docs/session.docs.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.docs.descriptor.d.ts","sourceRoot":"","sources":["../../src/docs/session.docs.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAokBvE,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAMvD,CAAC;AAEF,eAAe,sBAAsB,CAAC"}