@pellux/goodvibes-sdk 0.38.0 → 1.1.0

package/dist/platform/control-plane/session-broker-sessions.js

@@ -2,6 +2,64 @@ import { randomUUID } from 'node:crypto';
 import { dedupeSessionSurfaceKinds } from './session-broker-helpers.js';
 import { upsertSessionParticipant } from './session-broker-state.js';
 export const RESERVED_SHARED_SESSION_IDS = new Set(['', 'system']);
+/**
+ * Metadata key under which a closed session records WHY it was closed. Kept in
+ * `metadata` (not a first-class field) so it rides the wire without a schema
+ * change and 0.38 readers ignore it. See {@link SharedSessionCloseReason}.
+ */
+export const SESSION_CLOSE_REASON_METADATA_KEY = 'closeReason';
+/** Read the close reason off a record's metadata, or undefined when unset/unknown. */
+export function readSessionCloseReason(session) {
+    const raw = session.metadata?.[SESSION_CLOSE_REASON_METADATA_KEY];
+    return raw === 'idle-reaped' || raw === 'user' || raw === 'surface' ? raw : undefined;
+}
+/** Stamp a close reason onto a metadata bag (returns a new object). */
+export function withSessionCloseReason(metadata, reason) {
+    return { ...metadata, [SESSION_CLOSE_REASON_METADATA_KEY]: reason };
+}
+/** Strip any close reason from a metadata bag (returns a new object only if needed). */
+export function withoutSessionCloseReason(metadata) {
+    if (!(SESSION_CLOSE_REASON_METADATA_KEY in metadata))
+        return metadata;
+    const next = { ...metadata };
+    delete next[SESSION_CLOSE_REASON_METADATA_KEY];
+    return next;
+}
+/**
+ * Metadata flag marking a session as SURFACE-MANAGED: a spine-registered surface
+ * (via `sessions.register`) owns turn execution and input collection for it. Set
+ * on every register/heartbeat. Steer/follow-up inputs to such a session (when no
+ * daemon agent is live) route to the surface as a queued input the surface
+ * collects — NOT a daemon executor spawn. Kept in metadata (open record) so it
+ * needs no schema change. Daemon-run origins (companion-task/automation, or a
+ * plain /task session) never call register and stay executor-routed.
+ */
+export const SESSION_SURFACE_MANAGED_METADATA_KEY = 'surfaceManaged';
+/** How recently a participant must have been seen to count as a LIVE surface for
+ * steer/follow-up routing. A surface heartbeats via `sessions.register`; if the
+ * newest heartbeat is older than this, the surface is treated as gone and inputs
+ * fall back to the daemon executor path. */
+export const SURFACE_ROUTE_FRESHNESS_MS = 2 * 60 * 1000;
+export function isSurfaceManagedSession(session) {
+    return session.metadata?.[SESSION_SURFACE_MANAGED_METADATA_KEY] === true;
+}
+/**
+ * True when a participant OTHER than `exclude` (the current input's own surface)
+ * was seen within `freshnessMs`. Excluding the sender prevents a steer's own
+ * just-attached participant from making a surfaceless session look live.
+ */
+export function hasFreshSurfaceParticipant(session, now, freshnessMs, exclude) {
+    return session.participants.some((participant) => {
+        if (exclude?.surfaceId && participant.surfaceId === exclude.surfaceId)
+            return false;
+        return now - participant.lastSeenAt < freshnessMs;
+    });
+}
+/** Steer/follow-up to this session should route to a live surface (queue-for-surface)
+ * rather than spawn a daemon executor. */
+export function shouldRouteInputToSurface(session, now, freshnessMs, exclude) {
+    return isSurfaceManagedSession(session) && hasFreshSurfaceParticipant(session, now, freshnessMs, exclude);
+}
 export function assertSharedSessionIdAllowed(id) {
     if (id === undefined || !RESERVED_SHARED_SESSION_IDS.has(id))
         return;
@@ -17,6 +75,7 @@ export function createSharedSessionRecord(input) {
     return {
         id: sessionId,
         kind: input.kind ?? 'tui',
+        project: input.project?.trim() || 'unknown',
         title: input.title?.trim() || input.routeBinding?.title || `Session ${sessionId}`,
         status: 'active',
         createdAt: now,
@@ -37,7 +96,56 @@ export function createSharedSessionRecord(input) {
         },
     };
 }
-export function closeSharedSessionRecord(session) {
+/**
+ * The idempotent register/heartbeat control-flow with HONEST closed semantics:
+ * a brand-new id is created; an existing OPEN id adopts the participant; an
+ * existing CLOSED id records the heartbeat but stays closed (returning a conflict
+ * marker) UNLESS `reopen: true` is passed. A titled session is never renamed by
+ * the heartbeat (that rule lives in {@link attachSharedSessionParticipantAndRoute}).
+ */
+export async function registerSharedSession(ops, input) {
+    const existing = ops.getSession(input.sessionId);
+    if (!existing) {
+        const created = await ops.createSession({
+            id: input.sessionId,
+            ...(input.kind !== undefined ? { kind: input.kind } : {}),
+            ...(input.project !== undefined ? { project: input.project } : {}),
+            ...(input.title !== undefined ? { title: input.title } : {}),
+            participant: input.participant,
+        });
+        return { record: created, reopened: false };
+    }
+    const attach = participantToAttachInput(input.participant, input.title);
+    if (existing.status === 'closed') {
+        // Reopen honesty: a session the SYSTEM reaper closed ('idle-reaped') reopens
+        // automatically on the next participant heartbeat — the surface never
+        // deliberately closed it, so re-registering is not a conflict. An explicit
+        // 'user'/'surface' close stays closed (honest conflict) unless reopen:true.
+        const systemReaped = readSessionCloseReason(existing) === 'idle-reaped';
+        if (input.reopen === true || systemReaped) {
+            const reopened = (await ops.reopenSession(existing.id)) ?? existing;
+            return { record: await ops.attachParticipant(reopened, attach), reopened: true };
+        }
+        return { record: await ops.attachParticipant(existing, attach), reopened: false, conflict: { status: 'closed' } };
+    }
+    return { record: await ops.attachParticipant(existing, attach), reopened: false };
+}
+export function participantToAttachInput(participant, title) {
+    return {
+        surfaceKind: participant.surfaceKind,
+        surfaceId: participant.surfaceId,
+        externalId: participant.externalId,
+        userId: participant.userId,
+        displayName: participant.displayName,
+        routeId: participant.routeId,
+        ...(title ? { title } : {}),
+        body: '',
+    };
+}
+/** Close a session, recording WHY. Defaults to 'user' — the explicit close verb
+ * (daemon `sessions.close`) is a deliberate user/surface action, which does NOT
+ * auto-reopen on heartbeat. The reaper passes 'idle-reaped'. */
+export function closeSharedSessionRecord(session, reason = 'user') {
     const now = Date.now();
     return {
         ...session,
@@ -45,6 +153,7 @@ export function closeSharedSessionRecord(session) {
         activeAgentId: undefined,
         updatedAt: now,
         closedAt: now,
+        metadata: withSessionCloseReason(session.metadata, reason),
     };
 }
 export function reopenSharedSessionRecord(session) {
@@ -53,6 +162,9 @@ export function reopenSharedSessionRecord(session) {
         status: 'active',
         updatedAt: Date.now(),
         closedAt: undefined,
+        // A reopened session is no longer closed-for-any-reason; clear the marker so
+        // it never carries a stale close reason on the wire.
+        metadata: withoutSessionCloseReason(session.metadata),
     };
 }
 export function bindSharedSessionAgent(session, agentId) {
@@ -65,6 +177,21 @@ export function bindSharedSessionAgent(session, agentId) {
         lastActivityAt: now,
     };
 }
+/**
+ * True when a session title is still the auto-generated placeholder (empty or
+ * `Session <id>`) and can be named by an incoming register/attach. A real,
+ * user-supplied title is never overwritten by this path.
+ */
+export function isPlaceholderSessionTitle(title, id) {
+    const trimmed = title.trim();
+    return trimmed.length === 0 || trimmed === `Session ${id}`;
+}
+/**
+ * Merge a participant + optional route onto a session. This is the HEARTBEAT
+ * path — it records the participant and advances lastSeenAt, but it must NOT by
+ * itself change lifecycle status (a closed session stays closed; reopening is an
+ * explicit verb) and must NOT overwrite a real title (only names a placeholder).
+ */
 export function attachSharedSessionParticipantAndRoute(input) {
     const nextRouteIds = input.binding?.id
         ? [...new Set([...input.session.routeIds, input.binding.id])]
@@ -78,12 +205,23 @@ export function attachSharedSessionParticipantAndRoute(input) {
         routeId: input.binding?.id,
         lastSeenAt: Date.now(),
     });
+    const incomingTitle = input.message.title?.trim();
+    const title = incomingTitle && isPlaceholderSessionTitle(input.session.title, input.session.id)
+        ? incomingTitle
+        : input.session.title;
+    const now = Date.now();
     return {
         ...input.session,
-        title: input.message.title?.trim() || input.session.title,
-        status: input.session.status === 'closed' ? 'active' : input.session.status,
-        updatedAt: Date.now(),
-        closedAt: input.session.status === 'closed' ? undefined : input.session.closedAt,
+        title,
+        // Status is intentionally preserved: the participant merge is a heartbeat and
+        // cannot flip a closed session back to active. Reopening is an explicit verb.
+        status: input.session.status,
+        updatedAt: now,
+        // A register heartbeat IS session activity: advance lastActivityAt (not only
+        // the participant's lastSeenAt) so the idle-empty reaper does not close a
+        // live, message-less surface session out from under a heartbeating participant.
+        lastActivityAt: now,
+        closedAt: input.session.closedAt,
         routeIds: nextRouteIds,
         participants,
         surfaceKinds: dedupeSessionSurfaceKinds(participants),
@@ -92,3 +230,39 @@ export function attachSharedSessionParticipantAndRoute(input) {
         },
     };
 }
+/**
+ * The inverse of {@link attachSharedSessionParticipantAndRoute}: remove EVERY
+ * participant bound to `surfaceId` and unbind the route bindings those
+ * participants alone held. This is "detach != close != kill" — the session and
+ * all other participants keep running; the detached surface simply stops being a
+ * routing target (and, filtered by domain, stops receiving session updates).
+ *
+ * Route pruning is conservative: a routeId is dropped from the session only when
+ * NO surviving participant still references it, so detaching one surface never
+ * severs another surface's live binding.
+ *
+ * Returns `{ session, changed }`. `changed` is false when no participant matched
+ * `surfaceId` (the caller can treat a no-match detach as an idempotent no-op and
+ * skip persistence/emit). Status, title, and closedAt are preserved untouched —
+ * detach is never a lifecycle transition.
+ */
+export function detachSharedSessionParticipant(session, surfaceId) {
+    const remaining = session.participants.filter((participant) => participant.surfaceId !== surfaceId);
+    if (remaining.length === session.participants.length) {
+        return { session, changed: false };
+    }
+    const survivingRouteIds = new Set(remaining
+        .map((participant) => participant.routeId)
+        .filter((routeId) => typeof routeId === 'string'));
+    const routeIds = session.routeIds.filter((routeId) => survivingRouteIds.has(routeId));
+    return {
+        session: {
+            ...session,
+            updatedAt: Date.now(),
+            participants: remaining,
+            surfaceKinds: dedupeSessionSurfaceKinds(remaining),
+            routeIds,
+        },
+        changed: true,
+    };
+}

package/dist/platform/control-plane/session-broker-state.d.ts

@@ -9,11 +9,30 @@ export declare function loadSessionBrokerState(snapshot: SharedSessionStoreSnaps
     readonly messages: Map<string, SharedSessionMessage[]>;
     readonly inputs: Map<string, SharedSessionInputRecord[]>;
 };
+/**
+ * Build the durable snapshot with a PER-SESSION message cap.
+ *
+ * `maxPersistedMessagesPerSession` bounds each session's retained bodies
+ * independently — NOT the flattened total. The old global slice-after-flatten
+ * behaviour silently dropped whole sessions' transcripts (the oldest ones) once
+ * the combined message count crossed the cap, while `messageCount` stayed
+ * inflated. Capping per session keeps every session's most recent bodies and,
+ * when a session IS truncated, stamps `retainedMessageCount` so the loss is
+ * honest rather than silent (see {@link SharedSessionRecord.retainedMessageCount}).
+ */
 export declare function createSessionBrokerSnapshot(state: {
     readonly sessions: ReadonlyMap<string, SharedSessionRecord>;
     readonly messages: ReadonlyMap<string, readonly SharedSessionMessage[]>;
     readonly inputs: ReadonlyMap<string, readonly SharedSessionInputRecord[]>;
-}, maxPersistedMessages: number): SharedSessionStoreSnapshot;
+}, maxPersistedMessagesPerSession: number): SharedSessionStoreSnapshot;
 export declare function upsertSessionParticipant(participants: readonly SharedSessionParticipant[], participant: SharedSessionParticipant): SharedSessionParticipant[];
+/**
+ * Boot-time reconciliation of a freshly-loaded broker state (mutates in place):
+ * cancels inputs stuck in `spawned`/`delivered` from a prior run (agent state is
+ * unknown after a restart) and clears stale `activeAgentId` on every session.
+ * Returns the set of session ids whose input buckets changed so the caller can
+ * refresh their pending counts.
+ */
+export declare function reconcileSessionBrokerBoot(sessions: Map<string, SharedSessionRecord>, inputs: Map<string, SharedSessionInputRecord[]>): Set<string>;
 export declare function countPendingSessionInputs(records: readonly SharedSessionInputRecord[]): number;
 //# sourceMappingURL=session-broker-state.d.ts.map

package/dist/platform/control-plane/session-broker-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-broker-state.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/session-broker-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAyQ9G,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,EAAE,CAE1F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAE5F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,EAAE,CAElG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,GAAG;IAC/F,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;CAC1D,CAsCA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC,CAAC;CAC3E,EACD,oBAAoB,EAAE,MAAM,GAC3B,0BAA0B,CAQ5B;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,wBAAwB,EAAE,EACjD,WAAW,EAAE,wBAAwB,GACpC,wBAAwB,EAAE,CAM5B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAAG,MAAM,CAI9F"}
+{"version":3,"file":"session-broker-state.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/session-broker-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA8Q9G,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,EAAE,CAE1F;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAE5F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,EAAE,CAElG;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,GAAG,SAAS,GAAG;IAC/F,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC,CAAC;CAC1D,CAsCA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE;IACL,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC,CAAC;CAC3E,EACD,8BAA8B,EAAE,MAAM,GACrC,0BAA0B,CA2B5B;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,SAAS,wBAAwB,EAAE,EACjD,WAAW,EAAE,wBAAwB,GACpC,wBAAwB,EAAE,CAM5B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,EAC1C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,wBAAwB,EAAE,CAAC,GAC9C,GAAG,CAAC,MAAM,CAAC,CAkBb;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,SAAS,wBAAwB,EAAE,GAAG,MAAM,CAI9F"}

package/dist/platform/control-plane/session-broker-state.js

@@ -1,6 +1,6 @@
 import { SHARED_SESSION_INPUT_INTENTS, SHARED_SESSION_INPUT_STATES, } from './session-intents.js';
 import { isRecord } from '../utils/record-coerce.js';
-const SESSION_KINDS = new Set(['tui', 'companion-task', 'companion-chat']);
+const SESSION_KINDS = new Set(['tui', 'agent', 'webui', 'companion-task', 'companion-chat', 'automation']);
 const SESSION_STATUSES = new Set(['active', 'closed']);
 const MESSAGE_ROLES = new Set(['user', 'assistant', 'system']);
 function isFiniteNumber(value) {
@@ -78,6 +78,7 @@ function normalizeSessionRecord(value, messages, inputs) {
     validateOptionalNumber(value['updatedAt']);
     validateOptionalNumber(value['lastActivityAt']);
     validateOptionalNumber(value['messageCount']);
+    validateOptionalNumber(value['retainedMessageCount']);
     validateOptionalNumber(value['pendingInputCount']);
     validateOptionalNumber(value['lastMessageAt']);
     validateOptionalNumber(value['closedAt']);
@@ -120,6 +121,7 @@ function normalizeSessionRecord(value, messages, inputs) {
         kind: typeof value['kind'] === 'string' && SESSION_KINDS.has(value['kind'])
             ? value['kind']
             : 'tui',
+        project: typeof value['project'] === 'string' && value['project'].length > 0 ? value['project'] : 'unknown',
         title: typeof value['title'] === 'string' && value['title'].trim().length > 0 ? value['title'] : `Session ${id}`,
         status: typeof value['status'] === 'string' && SESSION_STATUSES.has(value['status'])
             ? value['status']
@@ -130,6 +132,9 @@ function normalizeSessionRecord(value, messages, inputs) {
         ...(closedAt !== undefined ? { closedAt } : {}),
         lastActivityAt,
         messageCount: Math.max(isFiniteNumber(value['messageCount']) ? value['messageCount'] : 0, messages.length),
+        ...(isFiniteNumber(value['retainedMessageCount']) && value['retainedMessageCount'] < Math.max(isFiniteNumber(value['messageCount']) ? value['messageCount'] : 0, messages.length)
+            ? { retainedMessageCount: value['retainedMessageCount'] }
+            : {}),
         pendingInputCount: Math.max(isFiniteNumber(value['pendingInputCount']) ? value['pendingInputCount'] : 0, countPendingSessionInputs(inputs)),
         routeIds,
         surfaceKinds,
@@ -284,12 +289,43 @@ export function loadSessionBrokerState(snapshot) {
     }
     return { sessions, messages, inputs };
 }
-export function createSessionBrokerSnapshot(state, maxPersistedMessages) {
-    const messages = [...state.messages.values()].flatMap((bucket) => bucket);
+/**
+ * Build the durable snapshot with a PER-SESSION message cap.
+ *
+ * `maxPersistedMessagesPerSession` bounds each session's retained bodies
+ * independently — NOT the flattened total. The old global slice-after-flatten
+ * behaviour silently dropped whole sessions' transcripts (the oldest ones) once
+ * the combined message count crossed the cap, while `messageCount` stayed
+ * inflated. Capping per session keeps every session's most recent bodies and,
+ * when a session IS truncated, stamps `retainedMessageCount` so the loss is
+ * honest rather than silent (see {@link SharedSessionRecord.retainedMessageCount}).
+ */
+export function createSessionBrokerSnapshot(state, maxPersistedMessagesPerSession) {
+    const cap = Math.max(1, maxPersistedMessagesPerSession);
+    const cappedMessages = [];
+    const retainedBySession = new Map();
+    for (const [sessionId, bucket] of state.messages.entries()) {
+        const retained = sortMessages(bucket).slice(-cap);
+        for (const message of retained)
+            cappedMessages.push(message);
+        retainedBySession.set(sessionId, retained.length);
+    }
     const inputs = [...state.inputs.values()].flatMap((bucket) => bucket);
+    const sessions = sortSessions(state.sessions.values()).map((session) => {
+        const retained = retainedBySession.get(session.id) ?? 0;
+        if (retained < session.messageCount) {
+            return { ...session, retainedMessageCount: retained };
+        }
+        // Nothing pruned — drop any stale marker so the common case carries none.
+        if (session.retainedMessageCount !== undefined) {
+            const { retainedMessageCount: _drop, ...rest } = session;
+            return rest;
+        }
+        return session;
+    });
     return {
-        sessions: sortSessions(state.sessions.values()),
-        messages: sortMessages(messages).slice(-maxPersistedMessages),
+        sessions,
+        messages: sortMessages(cappedMessages),
         inputs: sortInputs(inputs),
     };
 }
@@ -300,6 +336,32 @@ export function upsertSessionParticipant(participants, participant) {
         participant,
     ];
 }
+/**
+ * Boot-time reconciliation of a freshly-loaded broker state (mutates in place):
+ * cancels inputs stuck in `spawned`/`delivered` from a prior run (agent state is
+ * unknown after a restart) and clears stale `activeAgentId` on every session.
+ * Returns the set of session ids whose input buckets changed so the caller can
+ * refresh their pending counts.
+ */
+export function reconcileSessionBrokerBoot(sessions, inputs) {
+    const restartReason = 'daemon restart — agent state unknown';
+    const changed = new Set();
+    for (const [sessionId, bucket] of inputs.entries()) {
+        for (let i = 0; i < bucket.length; i++) {
+            const entry = bucket[i];
+            if (entry.state === 'spawned' || entry.state === 'delivered') {
+                bucket[i] = { ...entry, state: 'cancelled', updatedAt: Date.now(), error: restartReason };
+                changed.add(sessionId);
+            }
+        }
+    }
+    for (const [sessionId, session] of sessions.entries()) {
+        if (session.activeAgentId) {
+            sessions.set(sessionId, { ...session, activeAgentId: undefined, updatedAt: Date.now() });
+        }
+    }
+    return changed;
+}
 export function countPendingSessionInputs(records) {
     return records.filter((entry) => entry.state === 'queued' || entry.state === 'delivered' || entry.state === 'spawned').length;
 }

package/dist/platform/control-plane/session-broker.d.ts

@@ -1,9 +1,8 @@
 import { PersistentStore } from '../state/persistent-store.js';
 import type { RuntimeEventBus } from '../runtime/events/index.js';
 import { RouteBindingManager } from '../channels/index.js';
-import type { AutomationRouteBinding } from '../automation/routes.js';
 import type { SharedSessionCompletion, SharedSessionContinuationRunner, SharedSessionInputRecord } from './session-intents.js';
-import type { FindSharedSessionOptions, SharedSessionMessage, SharedSessionParticipant, SharedSessionRecord, SharedSessionSubmission, SteerSharedSessionMessageInput, SubmitSharedSessionMessageInput } from './session-types.js';
+import type { CreateSharedSessionInput, EnsureSharedSessionInput, FindSharedSessionOptions, ListSharedSessionsOptions, RegisterSharedSessionInput, SharedSessionMessage, SharedSessionRecord, SharedSessionRegisterResult, SharedSessionSubmission, SteerSharedSessionMessageInput, SubmitSharedSessionMessageInput } from './session-types.js';
 import { type SharedSessionAgentStatusProvider, type SharedSessionEventPublisher, type SharedSessionMessageSender, type SharedSessionStoreSnapshot } from './session-broker-helpers.js';
 export declare class SharedSessionBroker {
     private readonly store;
@@ -22,10 +21,10 @@ export declare class SharedSessionBroker {
     private readonly _idleEmptyMs;
     /** Default idle threshold for sessions with content (ms). */
     private readonly _idleLongMs;
-    /**
-     * @param config.idleEmptyMs - Idle timeout for empty (0-message) sessions (default: 10 minutes).
-     * @param config.idleLongMs  - Idle timeout for sessions with content (default: 24 hours).
-     */
+    /** Retention window (ms since closedAt) for CLOSED sessions; Infinity = retain forever. */
+    private readonly _deletionRetentionMs;
+    /** @param config idleEmptyMs (empty-session idle, default 10m), idleLongMs (default
+     * 24h), deletionRetentionMs (closed-session delete age, default Infinity = retain). */
     constructor(config: {
         readonly store?: PersistentStore<SharedSessionStoreSnapshot> | undefined;
         readonly storePath?: string | undefined;
@@ -34,6 +33,7 @@ export declare class SharedSessionBroker {
         readonly messageSender: SharedSessionMessageSender;
         readonly idleEmptyMs?: number | undefined;
         readonly idleLongMs?: number | undefined;
+        readonly deletionRetentionMs?: number | undefined;
     });
     setEventPublisher(publisher: SharedSessionEventPublisher | null): void;
     /**
@@ -61,28 +61,43 @@ export declare class SharedSessionBroker {
     attachRuntimeBus(bus: RuntimeEventBus, sessionResolver: (agentId: string) => string | null): () => void;
     setContinuationRunner(runner: SharedSessionContinuationRunner | null): void;
     start(): Promise<void>;
-    listSessions(limit?: number): SharedSessionRecord[];
+    listSessions(limit?: number, options?: ListSharedSessionsOptions): SharedSessionRecord[];
     getSession(sessionId: string): SharedSessionRecord | null;
     findPreferredSession(options?: FindSharedSessionOptions): Promise<SharedSessionRecord | null>;
-    ensureSession(input?: {
-        readonly sessionId?: string | undefined;
-        readonly title?: string | undefined;
-        readonly metadata?: Record<string, unknown> | undefined;
-        readonly routeBinding?: AutomationRouteBinding | undefined;
-        readonly participant?: SharedSessionParticipant | undefined;
-    }): Promise<SharedSessionRecord>;
+    ensureSession(input?: EnsureSharedSessionInput): Promise<SharedSessionRecord>;
+    /** Idempotent register/heartbeat; a brand-new session is born ALREADY
+     * surface-managed (avoids a create-then-patch race where a concurrent steer
+     * sees active-but-not-yet-managed and hits the executor path). */
+    register(input: RegisterSharedSessionInput): Promise<SharedSessionRegisterResult>;
+    private markSurfaceManaged;
     getMessages(sessionId: string, limit?: number): SharedSessionMessage[];
     getInputs(sessionId: string, limit?: number): SharedSessionInputRecord[];
-    createSession(input?: {
-        readonly id?: string | undefined;
-        readonly title?: string | undefined;
-        readonly metadata?: Record<string, unknown> | undefined;
-        readonly routeBinding?: AutomationRouteBinding | undefined;
-        readonly participant?: SharedSessionParticipant | undefined;
-        readonly kind?: SharedSessionRecord['kind'] | undefined;
-    }): Promise<SharedSessionRecord>;
+    createSession(input?: CreateSharedSessionInput): Promise<SharedSessionRecord>;
     closeSession(sessionId: string): Promise<SharedSessionRecord | null>;
     reopenSession(sessionId: string): Promise<SharedSessionRecord | null>;
+    /**
+     * Permanently remove a shared session record and its queued messages/inputs
+     * from the home-scoped store (see CHANGELOG 1.0.0: a real hard-delete verb, distinct from
+     * `closeSession` — closed sessions are HISTORY and are never touched by this
+     * path unless explicitly asked). Requires the session to already be closed:
+     * deleting a still-active session returns `'active'` so the caller can
+     * surface an honest 409 (close it, then delete) rather than yanking a
+     * record out from under a live participant/agent. An unknown OR
+     * already-deleted id returns `'not-found'` — delete is not a 200-noop; a
+     * second delete of the same id is an honest 404 at the route layer.
+     *
+     * Emits `session-deleted` on the same `session-update` wire channel as
+     * close/reopen/detach so subscribers drop the row live.
+     */
+    deleteSession(sessionId: string): Promise<'deleted' | 'not-found' | 'active'>;
+    /**
+     * Detach a surface's participant + route binding without closing or killing the
+     * session ("detach != close != kill"). Emits `session-detached`. Idempotent:
+     * unknown session -> null (404); closed session or no matching participant ->
+     * returned unchanged (a closed session emits no updates, so "stop receiving
+     * updates" is already satisfied). See {@link detachSharedSessionParticipant}.
+     */
+    detachParticipant(sessionId: string, surfaceId: string): Promise<SharedSessionRecord | null>;
     bindAgent(sessionId: string, agentId: string): Promise<SharedSessionRecord | null>;
     submitMessage(input: SubmitSharedSessionMessageInput): Promise<SharedSessionSubmission>;
     steerMessage(input: SteerSharedSessionMessageInput): Promise<SharedSessionSubmission>;
@@ -113,27 +128,25 @@ export declare class SharedSessionBroker {
     private publishUpdate;
     private publishInputLifecycleEvent;
     private handleIntent;
-    private recordInput;
-    private updateInput;
-    private claimNextQueuedInput;
-    private finalizeAgentInputs;
+    /** Collection read for a live surface (see {@link filterSessionInputsSince}). */
+    getInputsSince(sessionId: string, options?: {
+        readonly state?: SharedSessionInputRecord['state'] | undefined;
+        readonly since?: number | undefined;
+        readonly limit?: number | undefined;
+    }): SharedSessionInputRecord[];
+    /** A live surface reports a collected input delivered (`consumed:false`) or
+     * consumed/completed (`consumed:true`); emits a session_update. Lifecycle rules
+     * live in {@link markSurfaceInputDelivered}. */
+    markInputDelivered(sessionId: string, inputId: string, options?: {
+        readonly consumed?: boolean | undefined;
+    }): Promise<SharedSessionInputRecord | null>;
     private runQueuedFollowUp;
     private sessionInputStore;
     private messageStore;
     private touch;
     private refreshPendingInputCount;
-    /**
-     * Periodic idle-session GC sweep.
-     *
-     * Policy:
-     * - Sessions with messageCount === 0 AND no active agent AND idle longer than
-     *   `_idleEmptyMs` (default 10min) are closed with reason `idle-empty`.
-     * - Sessions with messageCount > 0 AND no active agent AND idle longer than
-     *   `_idleLongMs` (default 24h) are closed with reason `idle-long`.
-     *
-     * "Idle" is measured from `lastActivityAt` (updated on createInput/bindAgent/
-     * appendMessage). Sessions with an active agent are never GC'd.
-     */
+    /** Periodic sweep: idle-close active sessions and (only under a finite retention
+     * window) delete closed ones. Full policy lives in {@link sweepSharedSessions}. */
     private gcSweep;
 }
 //# sourceMappingURL=session-broker.d.ts.map

package/dist/platform/control-plane/session-broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-broker.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/session-broker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-broker.d.ts","sourceRoot":"","sources":["../../../src/platform/control-plane/session-broker.ts"],"names":[],"mappings":"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"}