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

package/dist/mcp/utils/surface-sessions.js

@@ -0,0 +1,118 @@
+/**
+ * Surface sessions: the managed participant that owns the sessions an agent
+ * surface (the stdio MCP server) mints for itself, minting one per process,
+ * and reaping the ones a crashed process left `active`.
+ *
+ * Session owns this lifecycle. It moved here from Autoloop's `autoloop.sessions`
+ * client so a public host never mints its session through a premium package.
+ * The participant id is unchanged, so sessions minted before the move are still
+ * recognised by identity and reaped.
+ */
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import * as z from 'zod/v4';
+/** The well-known participant that owns surface-minted sessions (stable across the Autoloop move). */
+export const SURFACE_SESSIONS_PARTICIPANT_ID = '7ab15969-f594-44fb-a314-adf8f43c2ea5';
+const SURFACE_SESSIONS_PARTICIPANT_NAME = 'Vibes Coordinator';
+const DEFAULT_REAP_TTL_MS = 48 * 60 * 60 * 1000;
+const DEFAULT_REAP_MAX_SCAN = 1000;
+const REAP_PAGE_SIZE = 100;
+/** A stored activity instant: listings carry it as a Date or as its serialized string, depending on the storage adapter. */
+const ActivityInstantSchema = z.coerce.date();
+/** Register the managed surface participant once. */
+export async function ensureSurfaceParticipant(manager) {
+    if (await manager.getParticipant(SURFACE_SESSIONS_PARTICIPANT_ID))
+        return;
+    await manager.registerParticipant({
+        participantId: SURFACE_SESSIONS_PARTICIPANT_ID,
+        name: SURFACE_SESSIONS_PARTICIPANT_NAME,
+        role: 'assistant',
+        capabilities: ['coordination', 'job-tracking'],
+        metadata: { source: 'session', managed: true }
+    });
+}
+function workspaceLabel(workspacePath) {
+    const tail = workspacePath.replaceAll('\\', '/').replace(/\/+$/, '').split('/').at(-1);
+    return tail && tail.length > 0 ? tail : 'workspace';
+}
+/** The runtime's bound workspace path; a host bound to no workspace has none (other failures propagate). */
+async function boundWorkspacePath(runtime) {
+    const read = await settle(() => runtime.context('runtime/workspace-path'));
+    if (read.ok)
+        return read.value;
+    if (valueFreeFailure(read.cause).reason === 'workspace-unbound')
+        return undefined;
+    throw read.cause;
+}
+/** Mint a fresh project session owned by the surface participant; resolves to its id. */
+export async function createSurfaceSession(runtime, manager, options = {}) {
+    await ensureSurfaceParticipant(manager);
+    const label = workspaceLabel(options.workspacePath ?? (await boundWorkspacePath(runtime)) ?? '');
+    const session = await manager.createSession({
+        title: options.titleHint ?? `Session ${label}`,
+        description: options.description?.slice(0, 2000),
+        status: 'active',
+        scope: 'project',
+        parentSessionId: options.parentSessionId,
+        ownerParticipant: SURFACE_SESSIONS_PARTICIPANT_ID,
+        assignedParticipant: SURFACE_SESSIONS_PARTICIPANT_ID,
+        tags: ['surface'],
+        metadata: { source: 'session', custom: { workspace: label } }
+    });
+    return session.id;
+}
+/**
+ * Archive surface-owned sessions idle past `ttlMs`. Every stdio connection
+ * mints a fresh session and a clean exit archives it; crashes leak `active`
+ * ones, which this sweep collects. The predicate is identity (owner, status,
+ * idle time), never the title. Ids are collected across pages before any
+ * archive, so archiving cannot shift the status-filtered listing under the
+ * scan. Each archive failure is logged and left for the next sweep.
+ */
+export async function reapStaleSurfaceSessions(runtime, manager, options = {}) {
+    const ttlMs = options.ttlMs ?? DEFAULT_REAP_TTL_MS;
+    const maxScan = options.maxScan ?? DEFAULT_REAP_MAX_SCAN;
+    const cutoff = Date.now() - ttlMs;
+    const staleIds = [];
+    let scanned = 0;
+    for (let offset = 0; offset < maxScan; offset += REAP_PAGE_SIZE) {
+        const page = await manager.listSessions({
+            status: 'active',
+            ownerParticipant: SURFACE_SESSIONS_PARTICIPANT_ID,
+            limit: Math.min(REAP_PAGE_SIZE, maxScan - offset),
+            offset
+        });
+        scanned += page.length;
+        for (const session of page) {
+            if (session.id === options.excludeSessionId)
+                continue;
+            // An instant that does not parse is never treated as stale.
+            const lastActivity = ActivityInstantSchema.safeParse(session.lastActivityAt ?? session.createdAt);
+            if (lastActivity.success && lastActivity.data.getTime() < cutoff)
+                staleIds.push(session.id);
+        }
+        if (page.length < REAP_PAGE_SIZE)
+            break;
+    }
+    const logger = getLogger('session', runtime).child('surface-sessions');
+    let archived = 0;
+    for (const id of staleIds) {
+        const result = await settle(() => manager.archiveSession(id));
+        if (result.ok)
+            archived++;
+        else
+            logger.warn('failed to archive a stale surface session; the next sweep retries it', { id, failure: valueFreeFailure(result.cause) });
+    }
+    if (archived > 0)
+        logger.info('reaped stale surface sessions', { scanned, archived, ttlMs });
+    return { scanned, archived };
+}
+export function surfaceSessions(runtime, manager) {
+    return {
+        participantId: SURFACE_SESSIONS_PARTICIPANT_ID,
+        ensureParticipant: () => ensureSurfaceParticipant(manager),
+        createSession: (options) => createSurfaceSession(runtime, manager, options),
+        reapStale: (options) => reapStaleSurfaceSessions(runtime, manager, options)
+    };
+}
+//# sourceMappingURL=surface-sessions.js.map

package/dist/mcp/utils/surface-sessions.js.map

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

package/dist/mcp/utils/unbound-guidance.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Unbound-session guidance — the receipt a body gets instead of a silent
+ * mint or a dead "No active session" line.
+ *
+ * Binding is a deliberate seat: tools and hooks name related workspace
+ * sessions and the create path, and they never attach the caller to one.
+ */
+export declare const SESSION_DISCOVERY_ACTIONS: readonly ["init", "status", "list", "search", "get"];
+export type SessionDiscoveryAction = (typeof SESSION_DISCOVERY_ACTIONS)[number];
+/**
+ * Session-family tools that may run before this connection has a bound session.
+ * `action` is the caller's raw tool input: it is parsed here, at the boundary,
+ * and only a listed discovery action admits the call.
+ */
+export declare function isSessionDiscoveryCall<Action>(toolId: string, action: Action): boolean;
+export interface UnboundSessionCandidate {
+    id: string;
+    title?: string | null;
+    status: string;
+    lastActivityAt?: string | Date;
+    createdAt?: string | Date;
+    ownerParticipant?: string;
+    ownerParticipantSlug?: string;
+    workItemTitle?: string | null;
+    gitBranch?: string | null;
+    workspaceRoot?: string | null;
+}
+export type UnboundRelatedSession = {
+    id: string;
+    handle: string;
+    title: string;
+    status: 'active' | 'paused' | 'archived';
+    lastActivityAt?: string;
+    ownerParticipant?: string;
+    workItemTitle?: string;
+    gitBranch?: string;
+    workspaceRoot?: string;
+    bind: {
+        tool: 'session';
+        action: 'init' | 'resume';
+        sessionId: string;
+    };
+};
+export type UnboundSessionAction = {
+    label: string;
+    tool: 'session';
+    action: 'init' | 'list' | 'search' | 'resume';
+    sessionId?: string;
+    newSession?: boolean;
+    status?: 'active';
+};
+/** Why related sessions could not be listed: value-free facts only (class name, code, reason). */
+export type UnboundListingFailure = {
+    name: string;
+    code?: string;
+    reason?: string;
+};
+/** JSON-shaped so it travels as `CapabilityErrorDetails` on a refusal. */
+export type UnboundSessionGuidance = {
+    bound: false;
+    relatedSessions: UnboundRelatedSession[];
+    nextActions: UnboundSessionAction[];
+    /** Present when listing failed: the guidance still names the create path, and says why it names fewer sessions. */
+    listingFailure?: UnboundListingFailure;
+};
+export interface UnboundSessionListManager {
+    listSessions?(filters: {
+        status?: 'active' | 'paused' | 'archived';
+        limit?: number;
+        offset?: number;
+    }): Promise<ReadonlyArray<UnboundSessionCandidate>>;
+}
+export declare function sessionDisplayHandle(id: string): string;
+export declare function rankRelatedSessions(sessions: ReadonlyArray<UnboundSessionCandidate>, options?: {
+    workspacePath?: string;
+    excludeSessionId?: string;
+    limit?: number;
+}): UnboundRelatedSession[];
+export declare function unboundSessionGuidanceFromRelated(relatedSessions: UnboundRelatedSession[]): UnboundSessionGuidance;
+export declare function buildUnboundSessionGuidance(manager: UnboundSessionListManager | null | undefined, options?: {
+    workspacePath?: string;
+    excludeSessionId?: string;
+    limit?: number;
+}): Promise<UnboundSessionGuidance>;
+export declare function renderUnboundSessionGuidance(guidance: UnboundSessionGuidance, nowMs?: number): string;
+export declare const UNBOUND_SESSION_HINT = "Bind with session { action: \"init\", sessionId: \"<id>\" } from the related list, or create with session { action: \"init\", newSession: true }.";
+export declare function unboundSessionErrorFields(manager: UnboundSessionListManager | null | undefined, options?: {
+    workspacePath?: string;
+    excludeSessionId?: string;
+}): Promise<{
+    message: string;
+    hint: string;
+    details: {
+        unbound: UnboundSessionGuidance;
+    };
+}>;
+//# sourceMappingURL=unbound-guidance.d.ts.map

package/dist/mcp/utils/unbound-guidance.d.ts.map

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

package/dist/mcp/utils/unbound-guidance.js

@@ -0,0 +1,236 @@
+/**
+ * Unbound-session guidance — the receipt a body gets instead of a silent
+ * mint or a dead "No active session" line.
+ *
+ * Binding is a deliberate seat: tools and hooks name related workspace
+ * sessions and the create path, and they never attach the caller to one.
+ */
+import * as z from 'zod/v4';
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+export const SESSION_DISCOVERY_ACTIONS = [
+    'init',
+    'status',
+    'list',
+    'search',
+    'get'
+];
+const SessionDiscoveryActionSchema = z.enum(SESSION_DISCOVERY_ACTIONS);
+/**
+ * Session-family tools that may run before this connection has a bound session.
+ * `action` is the caller's raw tool input: it is parsed here, at the boundary,
+ * and only a listed discovery action admits the call.
+ */
+export function isSessionDiscoveryCall(toolId, action) {
+    return toolId === 'session' && SessionDiscoveryActionSchema.safeParse(action).success;
+}
+const RELATED_LIMIT = 5;
+const ACTIVE_PAGE = 50;
+const PAUSED_PAGE = 20;
+const ARCHIVED_PAGE = 10;
+export function sessionDisplayHandle(id) {
+    return id.replace(/-/g, '').slice(0, 8);
+}
+function normalizePath(path) {
+    if (!path)
+        return undefined;
+    const normalized = path.replaceAll('\\', '/').replace(/\/+$/, '');
+    return normalized.length > 0 ? normalized : '/';
+}
+function activityMs(session) {
+    const raw = session.lastActivityAt ?? session.createdAt;
+    if (!raw)
+        return 0;
+    const value = raw instanceof Date ? raw.getTime() : new Date(raw).getTime();
+    return Number.isFinite(value) ? value : 0;
+}
+function isoTimestamp(value) {
+    if (!value)
+        return undefined;
+    const date = value instanceof Date ? value : new Date(value);
+    return Number.isFinite(date.getTime()) ? date.toISOString() : undefined;
+}
+function asStatus(status) {
+    if (status === 'active' || status === 'paused' || status === 'archived')
+        return status;
+    return null;
+}
+function rankScore(session, workspacePath) {
+    const status = asStatus(session.status);
+    let score = 0;
+    if (status === 'active')
+        score += 300;
+    else if (status === 'paused')
+        score += 200;
+    else if (status === 'archived')
+        score += 100;
+    const sessionRoot = normalizePath(session.workspaceRoot);
+    const callerRoot = normalizePath(workspacePath);
+    if (sessionRoot && callerRoot && sessionRoot === callerRoot)
+        score += 50;
+    return score;
+}
+export function rankRelatedSessions(sessions, options = {}) {
+    const limit = options.limit ?? RELATED_LIMIT;
+    const exclude = options.excludeSessionId;
+    const ranked = sessions
+        .filter((session) => session.id && session.id !== exclude && asStatus(session.status))
+        .slice()
+        .sort((a, b) => {
+        const byScore = rankScore(b, options.workspacePath) - rankScore(a, options.workspacePath);
+        if (byScore !== 0)
+            return byScore;
+        const byActivity = activityMs(b) - activityMs(a);
+        if (byActivity !== 0)
+            return byActivity;
+        return a.id.localeCompare(b.id);
+    });
+    const live = ranked.filter((session) => session.status !== 'archived');
+    const chosen = (live.length >= limit ? live : ranked).slice(0, limit);
+    return chosen.map(toRelatedSession);
+}
+function toRelatedSession(session) {
+    const status = asStatus(session.status) ?? 'active';
+    const title = session.title?.trim() || 'untitled';
+    return {
+        id: session.id,
+        handle: sessionDisplayHandle(session.id),
+        title,
+        status,
+        lastActivityAt: isoTimestamp(session.lastActivityAt),
+        ownerParticipant: session.ownerParticipantSlug || session.ownerParticipant
+            ? (session.ownerParticipantSlug ?? session.ownerParticipant)
+            : undefined,
+        workItemTitle: session.workItemTitle ? session.workItemTitle : undefined,
+        gitBranch: session.gitBranch ? session.gitBranch : undefined,
+        workspaceRoot: session.workspaceRoot ? session.workspaceRoot : undefined,
+        bind: {
+            tool: 'session',
+            action: status === 'archived' ? 'resume' : 'init',
+            sessionId: session.id
+        }
+    };
+}
+function nextActionsFor(related) {
+    const actions = related.slice(0, 3).map((session) => ({
+        label: session.status === 'archived'
+            ? `resume ${session.handle} (${session.title})`
+            : `bind ${session.handle} (${session.title})`,
+        tool: 'session',
+        action: session.bind.action,
+        sessionId: session.id
+    }));
+    actions.push({
+        label: 'create a new session',
+        tool: 'session',
+        action: 'init',
+        newSession: true
+    });
+    actions.push({
+        label: 'list active sessions',
+        tool: 'session',
+        action: 'list',
+        status: 'active'
+    });
+    actions.push({
+        label: 'search sessions by topic',
+        tool: 'session',
+        action: 'search'
+    });
+    return actions;
+}
+export function unboundSessionGuidanceFromRelated(relatedSessions) {
+    return {
+        bound: false,
+        relatedSessions,
+        nextActions: nextActionsFor(relatedSessions)
+    };
+}
+export async function buildUnboundSessionGuidance(manager, options = {}) {
+    // Only a caller with no session listing at all gets empty guidance; a
+    // listing that fails propagates rather than claiming no related sessions.
+    const listSessions = manager?.listSessions?.bind(manager);
+    if (!listSessions)
+        return unboundSessionGuidanceFromRelated([]);
+    let live;
+    try {
+        const [active, paused] = await Promise.all([
+            listSessions({ status: 'active', limit: ACTIVE_PAGE, offset: 0 }),
+            listSessions({ status: 'paused', limit: PAUSED_PAGE, offset: 0 })
+        ]);
+        live = [...active, ...paused];
+    }
+    catch (error) {
+        // The refusal this guidance decorates still stands, and still names the
+        // create path; the listing failure travels with it, value-free.
+        return { ...unboundSessionGuidanceFromRelated([]), listingFailure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+    let related = rankRelatedSessions(live, options);
+    if (related.length < (options.limit ?? RELATED_LIMIT)) {
+        let archived;
+        try {
+            archived = await listSessions({ status: 'archived', limit: ARCHIVED_PAGE, offset: 0 });
+        }
+        catch (error) {
+            return { ...unboundSessionGuidanceFromRelated(related), listingFailure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+        }
+        related = rankRelatedSessions([...live, ...archived], options);
+    }
+    return unboundSessionGuidanceFromRelated(related);
+}
+function formatAge(iso, nowMs) {
+    if (!iso)
+        return '';
+    const then = new Date(iso).getTime();
+    if (!Number.isFinite(then))
+        return '';
+    const minutes = Math.floor((nowMs - then) / 60_000);
+    if (minutes < 1)
+        return 'just now';
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+export function renderUnboundSessionGuidance(guidance, nowMs = Date.now()) {
+    const lines = [
+        'This connection is not bound to a Vibes session. Bind to a related session, or create a new one, before coordinating, locking, or writing session state.'
+    ];
+    if (guidance.relatedSessions.length > 0) {
+        lines.push('Related sessions:');
+        for (const session of guidance.relatedSessions) {
+            const age = formatAge(session.lastActivityAt, nowMs);
+            const extra = [
+                session.status,
+                age,
+                session.ownerParticipant ? `owner ${session.ownerParticipant}` : '',
+                session.gitBranch ? session.gitBranch : ''
+            ]
+                .filter(Boolean)
+                .join(', ');
+            lines.push(`- ${session.handle}  "${session.title}"${extra ? `  (${extra})` : ''}`);
+            lines.push(`  ${session.bind.action === 'resume' ? 'resume' : 'bind'}: session { action: "${session.bind.action}", sessionId: "${session.id}" }`);
+        }
+    }
+    else if (!guidance.listingFailure) {
+        lines.push('No related sessions were listed in this workspace.');
+    }
+    if (guidance.listingFailure) {
+        lines.push('Related sessions could not be listed; the session store failed to answer.');
+    }
+    lines.push('Create: session { action: "init", newSession: true }');
+    lines.push('List: session { action: "list", status: "active" }');
+    lines.push('Search: session { action: "search", query: "<topic>" }');
+    return lines.join('\n');
+}
+export const UNBOUND_SESSION_HINT = 'Bind with session { action: "init", sessionId: "<id>" } from the related list, or create with session { action: "init", newSession: true }.';
+export async function unboundSessionErrorFields(manager, options = {}) {
+    const unbound = await buildUnboundSessionGuidance(manager, options);
+    return {
+        message: renderUnboundSessionGuidance(unbound),
+        hint: UNBOUND_SESSION_HINT,
+        details: { unbound }
+    };
+}
+//# sourceMappingURL=unbound-guidance.js.map

package/dist/mcp/utils/unbound-guidance.js.map

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