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

package/dist/manager/resolve-bound-session.js

@@ -0,0 +1,163 @@
+/**
+ * The ONE decision for "which session does this bind attach to?".
+ *
+ * Two surfaces initialize sessions — the MCP/runtime handler
+ * (`tools/lifecycle/init/handler.ts`) and the `vibes session init` CLI
+ * (`cli/services/session/sessions.ts`) — and they had DIVERGED. The runtime
+ * handler was idempotent (rebind to the participant's active session, and since
+ * #1288 to an explicitly requested one); the CLI unconditionally called
+ * `createSession`, so every `vibes session init` minted a duplicate row and no
+ * CLI caller could ever rebind. Same user-facing verb, two behaviours.
+ *
+ * This is that decision, extracted once and consumed by both. Adding a rule here
+ * changes every surface; adding it to one handler is how they drifted apart.
+ *
+ * Continuity lattice (first match wins):
+ *  1. `newSession` → nothing is reused. This is the only force-fresh control;
+ *     repeating an otherwise identical init after transport recovery must not
+ *     mint a duplicate merely because the original call supplied a title.
+ *  2. Explicit `sessionId` — beats every ambient source; a respawned body is
+ *     issued a NEW participant id, so only an explicit id can name the lane
+ *     the caller was just using.
+ *  3. Scope-bound id (`session.bound` → registry → `scope.actor.sessionId`) — same
+ *     process, ambient continuity without re-naming the id.
+ *  4. Participant→session map — a body-scoped durable identity must beat the
+ *     process-wide fallback or another body's last bind steals this caller.
+ *  5. Durable default (`getDefaultActiveSession`, persisted in session-state) —
+ *     legacy fallback for a caller that has no participant mapping, and only
+ *     when the default's owner is the SAME agent. A new seat is never handed
+ *     another agent's session (a Claude seat once bound Cursor's fleet audit).
+ *     A harness seat skips this rung: ten conversations of one agent share
+ *     the agent, so "same agent" would hand one conversation another's work.
+ *  6. Otherwise `null` — the caller creates one.
+ *
+ * A rejected *requested* id is REPORTED, never swallowed. Ambient sources that
+ * fail (gone, foreign workspace) are skipped quietly so the lattice can fall
+ * through.
+ */
+import * as z from 'zod/v4';
+const SESSION_REFERENCE_PAGE_SIZE = 500;
+const SESSION_DISPLAY_HANDLE = /^[0-9a-f]{8}$/i;
+/** Resolve the copy-safe handle shown by session list without guessing. */
+async function resolveRequestedSessionReference(manager, reference) {
+    const exact = await manager.getSession(reference);
+    if (exact)
+        return { session: exact, ambiguous: false };
+    const prefix = reference.trim().toLowerCase();
+    if (!SESSION_DISPLAY_HANDLE.test(prefix)) {
+        return { session: null, ambiguous: false };
+    }
+    let matchId;
+    for (let offset = 0;; offset += SESSION_REFERENCE_PAGE_SIZE) {
+        const page = await manager.listSessions({
+            status: 'active',
+            limit: SESSION_REFERENCE_PAGE_SIZE,
+            offset
+        });
+        for (const candidate of page) {
+            if (!candidate.id.toLowerCase().startsWith(prefix))
+                continue;
+            if (matchId !== undefined && matchId !== candidate.id) {
+                return { session: null, ambiguous: true };
+            }
+            matchId = candidate.id;
+        }
+        if (page.length < SESSION_REFERENCE_PAGE_SIZE)
+            break;
+    }
+    if (matchId === undefined)
+        return { session: null, ambiguous: false };
+    return { session: await manager.getSession(matchId), ambiguous: false };
+}
+/** The workspace a session was recorded under: a non-string value names none. */
+const SessionWorkspaceSchema = z.object({ workspacePath: z.string().optional().catch(undefined) });
+function sessionWorkspace(session) {
+    return SessionWorkspaceSchema.parse(session.metadata ?? {}).workspacePath;
+}
+/**
+ * Resolve which existing session a bind should attach to.
+ *
+ * A storage or manager failure while reading a candidate propagates to the
+ * caller: an unreadable store is not an empty one, and treating it as "no
+ * session" would mint a duplicate.
+ */
+export async function resolveBoundSession(input) {
+    const { manager, participantId, sessionId, scopeBoundSessionId, newSession, workspacePath } = input;
+    if (newSession) {
+        return { session: null, reused: false, source: 'none' };
+    }
+    const rejected = (reason) => ({
+        session: null,
+        reused: false,
+        requestedSessionRejected: reason,
+        source: 'none'
+    });
+    const tryBind = async (id, source, asRequested) => {
+        const resolved = asRequested
+            ? await resolveRequestedSessionReference(manager, id)
+            : { session: await manager.getSession(id), ambiguous: false };
+        if (resolved.ambiguous)
+            return rejected('ambiguous');
+        const existing = resolved.session;
+        if (!existing || existing.status === 'archived') {
+            return asRequested ? rejected('unresolvable') : null;
+        }
+        const candidateWorkspace = sessionWorkspace(existing);
+        if (candidateWorkspace && workspacePath && candidateWorkspace !== workspacePath) {
+            return asRequested ? rejected('foreign-workspace') : null;
+        }
+        const candidate = existing.status === 'paused' ? await manager.openSessionForWork(existing.id) : existing;
+        // Point this participant at it so later ambient calls resolve too.
+        await manager.setParticipantActiveSession(participantId, candidate.id);
+        return { session: candidate, reused: true, source };
+    };
+    // 2. Explicit request — report rejection; never silently mint a different id.
+    if (sessionId) {
+        const requested = await tryBind(sessionId, 'requested', true);
+        // Either rebound or rejected — stop the lattice either way for a named id.
+        if (requested)
+            return requested;
+    }
+    // 3. Scope-bound ambient (same process after session.bound).
+    if (scopeBoundSessionId && scopeBoundSessionId !== sessionId) {
+        const fromScope = await tryBind(scopeBoundSessionId, 'scope', false);
+        if (fromScope?.session)
+            return fromScope;
+    }
+    // 4. A participant-scoped binding is authoritative over process-global state.
+    const existing = await manager.ensureParticipantSession(participantId);
+    if (existing) {
+        return { session: existing, reused: true, source: 'participant-map' };
+    }
+    // 5. Durable default — legacy fallback only when this participant is unbound.
+    if (!input.harnessSeat) {
+        const defaultId = await manager.getDefaultActiveSession();
+        // Skip ids already attempted as requested / scope so we don't double-call.
+        if (defaultId &&
+            defaultId !== sessionId &&
+            defaultId !== (scopeBoundSessionId ?? undefined) &&
+            (await ownedBySameAgent(manager, defaultId, input.agentId))) {
+            const fromDefault = await tryBind(defaultId, 'default', false);
+            if (fromDefault?.session)
+                return fromDefault;
+        }
+    }
+    return { session: null, reused: false, source: 'none' };
+}
+/**
+ * Whether `sessionId` is owned by a participant acting as `agentId`. Unknown on
+ * either side is "no": the durable default is shared workspace state, and
+ * adopting it without proof hands one agent another agent's session. A read
+ * failure propagates; it is not proof of ownership either way.
+ */
+async function ownedBySameAgent(manager, sessionId, agentId) {
+    if (!agentId)
+        return false;
+    const session = await manager.getSession(sessionId);
+    const owner = session?.ownerParticipant;
+    if (!owner)
+        return false;
+    const profile = await manager.getParticipant(owner);
+    return profile?.metadata?.clientInfo?.agentId === agentId;
+}
+//# sourceMappingURL=resolve-bound-session.js.map

package/dist/manager/resolve-bound-session.js.map

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