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

package/dist/tools/lifecycle/init/handler.js

@@ -0,0 +1,353 @@
+import { StoredClientInfoSchema } from "../../../schemas/participant.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { getLogger } from '@vibesdotdev/logging';
+import { createSessionToolError, ensureSessionContext, ensureSessionContextWithManager, getScopeBoundSessionId, getSessionManagerAsync } from "../../../mcp/utils/participant.js";
+import { applyKnowledgeContext } from "../../../mcp/utils/knowledge.js";
+import { emitSessionBound } from "../../../events/session.bound.event.descriptor.js";
+import { refreshAtlasIndex } from "./atlas.consumer.js";
+import { ensureLanguageServerReady } from "./language.js";
+import { enrichKnowledgeContext } from "./knowledge.js";
+import { reconcileMcpSeat, resolveOwnerParticipant } from "./participant.js";
+import { resolveWorkspaceContext } from "./workspace.consumer.js";
+import { resolveProjectRefPort, resolveWorkspaceServedPort } from "../workspace-capabilities.js";
+import { resolveBoundSession } from "../../../manager/resolve-bound-session.js";
+import { harnessSeatOf } from "../../../schemas/harness-seat.js";
+import { DEFAULT_KNOWLEDGE_THRESHOLD } from "./types.js";
+import { bestEffortValue, settleBestEffort } from "../../best-effort.js";
+import { callTransportKey } from "../../tool-runtime.js";
+/** The call's MCP transport key: the adapter's transport session id, its connection key, or the caller's connection id. */
+function getMcpSessionId(ctx) {
+    return callTransportKey(ctx, ['mcp.transportSessionId', 'mcp.connectionKey', 'caller.connectionId']);
+}
+function getMcpBindingScope(ctx) {
+    return ctx?.metadata?.['mcp.transportMode'] === 'http' ? 'request' : 'ambient';
+}
+/** Surface tag for session.bound — prefer the runtime's own scope surface. */
+function resolveBoundSurface(runtime) {
+    return runtime.scope?.surface || 'session-init';
+}
+const WORKSPACE_INTELLIGENCE_KIND = 'workspace/intelligence-summary';
+/** The receipt's client info, read from the participant's stored profile metadata. */
+function participantClientInfoOf(metadata) {
+    return StoredClientInfoSchema.parse(metadata.clientInfo);
+}
+async function resolveWorkspaceIntelligence(runtime, workspacePath, projectId) {
+    // A host that composes no intelligence summary has nothing to report; a
+    // registered provider that fails is a failure of this init.
+    // An unbound checkout has no project intelligence; never invent its identity.
+    if (!projectId || !runtime.hasKind(WORKSPACE_INTELLIGENCE_KIND))
+        return undefined;
+    const summary = runtime
+        .query(WORKSPACE_INTELLIGENCE_KIND)
+        .withId('workspace.intelligence-summary');
+    if (summary.descriptors().length === 0)
+        return undefined;
+    const provider = await summary.resolve();
+    const computed = JsonObjectSchema.safeParse(await provider.compute({ projectId, workspacePath, environmentKind: runtime.scope.hardware }));
+    if (!computed.success) {
+        throw new CapabilityError('The workspace intelligence summary is not a JSON object.', 'INTERNAL', {
+            reason: 'workspace-intelligence-invalid'
+        });
+    }
+    return computed.data;
+}
+/**
+ * Announce the newly created session on the runtime-native `session.bound` bus.
+ * Fans out to the scope-publish subscription so the runtime carries both the
+ * session and caller participant; `brain.pulse` resolves this session instead
+ * of falling back to `"ephemeral"`, and shared rooms keep distinct seats.
+ * Scope binding is committed synchronously before best-effort subscriber
+ * fanout, so a broken awareness/workspace subscriber cannot leave stale
+ * session identity behind.
+ */
+async function announceInitSessionBound(runtime, sessionId, participantId, bindingScope, reused) {
+    // Subscriber fanout is best-effort: emitSessionBound already committed the
+    // canonical session identity before attempting it. A failure is reported once,
+    // value-free, never dropped.
+    const announced = await settleBestEffort(() => emitSessionBound({
+        runtime,
+        sessionId,
+        participantId,
+        surface: resolveBoundSurface(runtime),
+        bindingScope,
+        reused
+    }));
+    if (announced.ok)
+        return;
+    getLogger('session:init', runtime).warn('session.bound subscriber fanout failed', {
+        collaborationSessionId: sessionId,
+        error: announced.failure
+    });
+}
+export async function sessionInitHandler(args, runtime, ctx) {
+    const mcpSessionId = getMcpSessionId(ctx);
+    // Async manager: on a fresh daemon nothing has touched the manager yet and
+    // the sync getter throws SESSION_MANAGER_UNAVAILABLE — which is exactly
+    // when a seat's first init runs. Every sibling handler uses the async form.
+    const hasRuntimeSessionManager = runtime.hasContext?.('session/manager') === true;
+    const session = hasRuntimeSessionManager
+        ? await runtime.context('session/manager')
+        : await getSessionManagerAsync(runtime);
+    // Optional collaborators: a host that composes none of them has nothing to
+    // wire; one that composes them and fails to resolve fails this init.
+    const pm = runtime.hasContext('pm/client')
+        ? await runtime.context('pm/client')
+        : undefined;
+    const api = runtime.hasContext('app/api-client')
+        ? await runtime.context('app/api-client')
+        : undefined;
+    const auth = runtime.hasContext('auth/context')
+        ? await runtime.context('auth/context')
+        : undefined;
+    const owner = await resolveOwnerParticipant(runtime, args, session, mcpSessionId, ctx?.caller, ctx?.workspace?.root);
+    let participantId = owner.participantId;
+    let participantSummary = owner.summary;
+    // An EXPLICITLY requested session wins over the participant→session map.
+    //
+    // The map is keyed by participant, and a respawned MCP body is issued a NEW
+    // participant id — so after `/mcp` reconnect (or any client restart)
+    // `ensureParticipantSession` cannot find the session the caller was using
+    // moments earlier. Without this branch, passing `sessionId` was silently
+    // IGNORED and init minted a fresh session, stranding the named one along with
+    // its todos, notes, and history. That is the opposite of what a continuity
+    // substrate is for, and it is exactly when continuity matters most.
+    //
+    // Guarded: bind a session that exists in this workspace. A paused session
+    // resumes. Never adopt across workspaces on a caller-supplied id, and never
+    // mint a different id when the caller named one.
+    //
+    // The handed runtime owns the workspace, including any admitted invocation
+    // overlay. Tool arguments cannot retarget project authority. An unbound host fails with
+    // `workspace-unbound`; nothing falls back to the process cwd.
+    const resolvedWorkspace = await resolveWorkspaceContext({}, runtime);
+    const projectRefs = await resolveProjectRefPort(runtime);
+    const projectRef = projectRefs?.resolve() ?? projectRefs?.resolve({ cwd: resolvedWorkspace.path }) ?? null;
+    (await resolveWorkspaceServedPort(runtime))?.register({
+        root: resolvedWorkspace.path,
+        label: resolvedWorkspace.path.split('/').filter(Boolean).at(-1),
+        projectId: projectRef?.projectId ?? null
+    });
+    // ONE bind decision, shared with `vibes session init` — see
+    // `manager/resolve-bound-session.ts`. Continuity lattice: requested id →
+    // scope-bound → participant map → durable default → mint.
+    const bound = await resolveBoundSession({
+        manager: session,
+        participantId,
+        sessionId: args.sessionId,
+        scopeBoundSessionId: getScopeBoundSessionId(runtime, ctx?.caller),
+        newSession: args.newSession,
+        workspacePath: resolvedWorkspace.path,
+        agentId: ctx?.caller?.agentId ?? runtime.scope.actor?.agentId,
+        harnessSeat: harnessSeatOf(owner.clientInfo) !== undefined
+    });
+    if (args.sessionId && bound.requestedSessionRejected && !args.newSession) {
+        const rejection = bound.requestedSessionRejected;
+        throw createSessionToolError(rejection === 'ambiguous'
+            ? 'SESSION_REFERENCE_AMBIGUOUS'
+            : 'REQUESTED_SESSION_UNRESOLVABLE', rejection === 'ambiguous'
+            ? `Session reference ${args.sessionId} matches more than one active session.`
+            : `Session ${args.sessionId} could not be bound (${rejection}).`, rejection === 'ambiguous'
+            ? 'Copy the full session UUID from session list/search.'
+            : rejection === 'foreign-workspace'
+                ? 'That session belongs to another workspace. Pass newSession:true only if you intend to start a different collaboration.'
+                : 'The id was not found or is archived. A named sessionId never mints a replacement.', { requestedSessionId: args.sessionId, requestedSessionRejected: rejection });
+    }
+    const existingSession = bound.session;
+    const reusedExisting = bound.reused;
+    const requestedSessionRejected = bound.requestedSessionRejected;
+    const boundSession = existingSession ??
+        (await session.createSession({
+            projectId: projectRef?.projectId,
+            title: args.title || `Session ${new Date().toISOString().split('T')[0]}`,
+            description: args.description,
+            ownerParticipant: participantId,
+            filesPattern: args.filesPattern,
+            tags: args.tags,
+            status: 'active',
+            // Stamp workspace so later rebinds can refuse foreign workspaces.
+            metadata: resolvedWorkspace.path ? { workspacePath: resolvedWorkspace.path } : undefined
+        }, { adoptAsDefault: !mcpSessionId }));
+    // Durable default on REBIND: createSession already stamps it on mint.
+    // Without this, a successful rebind left default pointing at a stale or
+    // null id and the next reconnect (new participant) fell through to mint.
+    if (!mcpSessionId && reusedExisting) {
+        await session.setDefaultActiveSession(boundSession.id);
+    }
+    // Seat identity is keyed on (client kind, THIS session) for a client that
+    // declared nothing: the same Claude Code conversation rebinding after a body
+    // restart gets its previous seat back instead of a fresh participant per
+    // transport connection. Explicit/declared identities pass through.
+    const seat = await reconcileMcpSeat({
+        session,
+        owner,
+        args,
+        sessionId: boundSession.id,
+        mcpSessionId,
+        caller: ctx?.caller,
+        workspaceRoot: ctx?.workspace?.root
+    });
+    participantId = seat.participantId;
+    participantSummary = seat.summary;
+    const participantReused = seat.reused;
+    const resolutionOptions = {
+        caller: ctx?.caller,
+        workspaceRoot: ctx?.workspace?.root
+    };
+    if (hasRuntimeSessionManager) {
+        await ensureSessionContextWithManager(session, runtime, boundSession.id, participantId, mcpSessionId, resolutionOptions);
+    }
+    else {
+        await ensureSessionContext(boundSession.id, participantId, mcpSessionId, resolutionOptions);
+    }
+    // WS-A3: bind session into runtime scope so brain.pulse is non-ephemeral.
+    // Same path as MCP serve lifecycle / CLI bootstrap (emit session.bound →
+    // on-session-bound-scope records it in the session registry).
+    await announceInitSessionBound(runtime, boundSession.id, participantId, getMcpBindingScope(ctx), reusedExisting);
+    // Binding is the latency-critical operation. Operational preparation stays
+    // available explicitly; a required knowledge policy must still gate this bind.
+    const prepare = args.prepare === true || args.knowledgeBindingPolicy === 'required';
+    const languageServerPromise = prepare
+        ? ensureLanguageServerReady(runtime, pm, resolvedWorkspace.path)
+        : Promise.resolve({ status: 'deferred', reason: 'session-init-prepare-required' });
+    const atlasRefresh = prepare
+        ? await refreshAtlasIndex(runtime, { workspacePath: resolvedWorkspace.path, pm })
+        : { status: 'deferred', reason: 'session-init-prepare-required' };
+    const workspaceIntelligence = await resolveWorkspaceIntelligence(runtime, resolvedWorkspace.path, projectRef?.projectId);
+    let trackedAtlasJobId;
+    const queuedAtlasJobId = atlasRefresh.status === 'queued' ? atlasRefresh.jobId : undefined;
+    if (queuedAtlasJobId) {
+        // The refresh is queued either way; an untracked job is reported once and
+        // the receipt omits the tracked id.
+        const trackedJob = await bestEffortValue(getLogger('session:init', runtime), 'session init could not track the atlas refresh job', { collaborationSessionId: boundSession.id, jobId: queuedAtlasJobId }, () => session.addJobRef(boundSession.id, {
+            jobId: queuedAtlasJobId,
+            jobType: atlasRefresh.jobType ?? 'dev.atlas.index',
+            queueName: atlasRefresh.queueName ?? 'dev-atlas-jobs',
+            description: `Code Atlas refresh (${atlasRefresh.projectId ?? 'unknown'})`,
+            status: 'pending',
+            metadata: {
+                source: 'session-init',
+                workspacePath: resolvedWorkspace.path
+            }
+        }));
+        trackedAtlasJobId = trackedJob?.id;
+    }
+    const normalizedArgs = {
+        ...args,
+        projectId: projectRef?.projectId,
+        enrichKnowledge: args.enrichKnowledge ?? true,
+        knowledgeThreshold: args.knowledgeThreshold ?? DEFAULT_KNOWLEDGE_THRESHOLD
+    };
+    // Build thin McpToolContext for applyKnowledgeContext
+    const mcpContext = {
+        api,
+        auth,
+        config: {},
+        environment: {},
+        workspace: {
+            path: resolvedWorkspace.path,
+            source: resolvedWorkspace.source
+        },
+        workspacePath: resolvedWorkspace.path,
+        user: null,
+        timestamp: new Date()
+    };
+    const deferredKnowledgeContext = {
+        projectId: projectRef?.projectId ?? null,
+        knowledgeBaseIds: projectRef?.knowledgeBaseIds ?? [],
+        missingKnowledgeBases: [],
+        source: 'deferred',
+        knowledgeApiEnabled: args.useKnowledgeApi ?? true,
+        workspacePath: resolvedWorkspace.path,
+        knowledgeBinding: {
+            projectId: projectRef?.projectId,
+            state: 'missing',
+            policy: args.knowledgeBindingPolicy ?? 'optional',
+            roles: {},
+            missingRoles: ['dependencies', 'rules', 'codebase'],
+            source: projectRef ? 'project-binding' : 'unbound',
+            reason: 'preparation-deferred'
+        }
+    };
+    const knowledgeContext = prepare ? await applyKnowledgeContext(mcpContext, session, boundSession.id, normalizedArgs, 
+    // runtime: knowledge-base discovery resolves through the SAME local
+    // record-store impls the knowledge tool serves (injury L-06).
+    {
+        workspacePath: resolvedWorkspace.path,
+        projectIdOverride: projectRef?.projectId,
+        knowledgeBaseIdsOverride: projectRef?.knowledgeBaseIds,
+        runtime
+    }) : deferredKnowledgeContext;
+    const knowledgeEnrichment = prepare ? await enrichKnowledgeContext(session, boundSession.id, normalizedArgs, runtime) : { status: 'deferred', reason: 'session-init-prepare-required' };
+    const languageServer = await languageServerPromise;
+    const participantClientInfo = participantClientInfoOf(participantSummary.profile.metadata);
+    // Compact bind receipt: static coordination ceremony lives in descriptors/docs
+    // (COORDINATION_TIPS, session docs). Hydrate work state via action:"packet".
+    const nextAction = {
+        tool: 'session',
+        action: 'packet',
+        sessionId: boundSession.id,
+        reason: 'Hydrate roster, assigned/blocked todos, handoff notes, and unread messages'
+    };
+    return {
+        kind: 'session.bind-receipt',
+        sessionId: boundSession.id,
+        title: boundSession.title,
+        status: boundSession.status,
+        reused: reusedExisting,
+        // A caller-named session that could NOT be bound is reported, never dropped
+        // in silence — otherwise the receipt looks like a normal fresh bind and the
+        // caller keeps writing against an id that no longer routes anywhere.
+        requestedSessionId: requestedSessionRejected ? args.sessionId : undefined,
+        requestedSessionRejected,
+        createdAt: boundSession.createdAt instanceof Date
+            ? boundSession.createdAt.toISOString()
+            : boundSession.createdAt,
+        participant: {
+            id: participantSummary.participantId,
+            slug: participantSummary.slug,
+            name: participantSummary.profile.name ?? participantSummary.slug,
+            capabilities: participantSummary.profile.capabilities,
+            // Whether this bind got an existing seat back or minted one — so a
+            // body restart that changed who you are is visible in the receipt,
+            // not discovered later from orphaned mail.
+            reused: participantReused,
+            seat: seat.seat,
+            clientInfo: participantClientInfo
+        },
+        nextAction,
+        preparationAction: prepare ? undefined : {
+            tool: 'session', action: 'init', sessionId: boundSession.id, prepare: true,
+            reason: 'Start workspace services, refresh Atlas, and resolve/link knowledge'
+        },
+        // Single clear next step — no static 10–15 string onboarding guide.
+        nextSteps: [
+            `session { action: "packet", sessionId: "${boundSession.id}" } — hydrate resume state for this bind`
+        ],
+        languageServer,
+        atlasRefresh: trackedAtlasJobId
+            ? { ...atlasRefresh, trackedJobId: trackedAtlasJobId }
+            : atlasRefresh,
+        workspaceIntelligence,
+        knowledgeContext: {
+            projectId: knowledgeContext.projectId ?? null,
+            knowledgeBaseIds: knowledgeContext.knowledgeBaseIds,
+            missingKnowledgeBases: knowledgeContext.missingKnowledgeBases,
+            source: knowledgeContext.source,
+            knowledgeApiEnabled: knowledgeContext.knowledgeApiEnabled,
+            knowledgeBinding: knowledgeContext.knowledgeBinding,
+            workspacePath: knowledgeContext.workspacePath ?? resolvedWorkspace.path
+        },
+        knowledgeEnrichment,
+        workspace: {
+            path: resolvedWorkspace.path,
+            source: resolvedWorkspace.source,
+            warning: resolvedWorkspace.warning
+        },
+        warning: resolvedWorkspace.warning,
+        message: reusedExisting
+            ? `Rebound to existing session for ${participantSummary.slug} (${participantSummary.profile.name ?? participantSummary.slug}); participant ${participantReused ? 'reused' : 'minted'}; pass newSession:true to force a fresh one. Next: session { action: "packet" }.`
+            : `Session initialized for ${participantSummary.slug} (${participantSummary.profile.name ?? participantSummary.slug}); participant ${participantReused ? 'reused' : 'minted'}. Next: session { action: "packet" }.`
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/tools/lifecycle/init/handler.js.map

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

package/dist/tools/lifecycle/init/knowledge.d.ts

@@ -0,0 +1,18 @@
+import type { SessionManager } from '../../../manager/index.ts';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type SessionInitInput, type SessionInitResult } from './types.ts';
+/** The receipt's enrichment report. */
+type KnowledgeEnrichment = SessionInitResult['knowledgeEnrichment'];
+/**
+ * Link the knowledge items most relevant to the session's title or
+ * description. The search is Knowledge's own consumer composition: semantic
+ * through the knowledge API when reachable, an honestly labelled (`degraded`)
+ * local fulltext lane for an offline or signed-out caller, any other failure
+ * thrown. A degraded lane carries no semantic score, so its top matches are
+ * linked directly (`searchMode: 'local-fallback'`) instead of thresholded.
+ * Enrichment never fails the bind: a failure is reported with its value-free
+ * facts, never its message.
+ */
+export declare function enrichKnowledgeContext(session: SessionManager, sessionId: string, args: SessionInitInput, runtime: VibesRuntime): Promise<KnowledgeEnrichment>;
+export {};
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/tools/lifecycle/init/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAA+E,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrI,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAA+B,MAAM,YAAY,CAAC;AAIxG,uCAAuC;AACvC,KAAK,mBAAmB,GAAG,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;AAYpE;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC3C,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,mBAAmB,CAAC,CA0B9B"}

package/dist/tools/lifecycle/init/knowledge.js

@@ -0,0 +1,86 @@
+import { getLogger } from '@vibesdotdev/logging';
+import { KnowledgeEnrichmentSearchSchema } from "../../../schemas/knowledge.js";
+import { captureValue, CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { DEFAULT_KNOWLEDGE_THRESHOLD } from "./types.js";
+/**
+ * Whether this runtime composes Knowledge: its `knowledge` tool is the
+ * declared fact. A runtime without it skips enrichment (confirmed absence);
+ * a composed Knowledge that fails is reported as an error, never as absence.
+ */
+function knowledgeComposed(runtime) {
+    if (!runtime.hasKind('tools/tool'))
+        return false;
+    return runtime.query('tools/tool').withId('knowledge').descriptors().length > 0;
+}
+/**
+ * Link the knowledge items most relevant to the session's title or
+ * description. The search is Knowledge's own consumer composition: semantic
+ * through the knowledge API when reachable, an honestly labelled (`degraded`)
+ * local fulltext lane for an offline or signed-out caller, any other failure
+ * thrown. A degraded lane carries no semantic score, so its top matches are
+ * linked directly (`searchMode: 'local-fallback'`) instead of thresholded.
+ * Enrichment never fails the bind: a failure is reported with its value-free
+ * facts, never its message.
+ */
+export async function enrichKnowledgeContext(session, sessionId, args, runtime) {
+    if (args.enrichKnowledge === false) {
+        return { status: 'skipped', reason: 'disabled' };
+    }
+    const query = (args.description || args.title || '').trim();
+    if (query.length < 3) {
+        return { status: 'skipped', reason: 'insufficient-query' };
+    }
+    const threshold = args.knowledgeThreshold ?? DEFAULT_KNOWLEDGE_THRESHOLD;
+    if (!knowledgeComposed(runtime)) {
+        return { status: 'skipped', reason: 'knowledge-unavailable', threshold };
+    }
+    try {
+        return await linkRelevantKnowledge(session, sessionId, runtime, query, threshold);
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            reason: 'knowledge-enrichment-failed',
+            threshold,
+            message: 'Knowledge enrichment failed; the session is bound without linked knowledge.',
+            failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+        };
+    }
+}
+async function linkRelevantKnowledge(session, sessionId, runtime, query, threshold) {
+    const searchResult = await runtime.assets('tools/tool').executeDiscriminated('knowledge', captureValue({
+        action: 'semantic-search', query, limit: 10, searchMode: 'hybrid',
+        vectorWeight: 0.7, textWeight: 0.3, includeContent: false
+    }), runtime, KnowledgeEnrichmentSearchSchema, { callId: crypto.randomUUID(), logger: getLogger('session:knowledge', runtime), metadata: {} });
+    const isLocalFallback = searchResult.degraded === true;
+    const qualifyingItems = isLocalFallback
+        ? searchResult.results
+        : searchResult.results.filter((item) => item.score >= threshold);
+    const uniqueItems = Array.from(new Map(qualifyingItems.map((item) => [item.id, item])).values()).slice(0, 5);
+    let linked = 0;
+    for (const item of uniqueItems) {
+        if (!item.id)
+            continue;
+        const metadata = { score: item.score };
+        if (item.contentType) {
+            metadata.contentType = item.contentType;
+        }
+        if (item.excerpt) {
+            metadata.excerpt = item.excerpt;
+        }
+        await session.addKnowledgeRef(sessionId, {
+            knowledgeItemId: item.id,
+            reason: 'semantic_match',
+            metadata
+        });
+        linked += 1;
+    }
+    return {
+        status: linked > 0 ? 'linked' : 'none',
+        linkedCount: linked,
+        query,
+        threshold,
+        searchMode: isLocalFallback ? 'local-fallback' : searchResult.searchMode
+    };
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/tools/lifecycle/init/knowledge.js.map

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

package/dist/tools/lifecycle/init/language.d.ts

@@ -0,0 +1,10 @@
+import type { PMContext } from '@vibesdotdev/pm/context';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { SessionInitResult } from './types.ts';
+/**
+ * Start (or adopt) the workspace's TypeScript language server. Its failure
+ * never fails the bind: the receipt reports `status: 'error'` with the
+ * failure's value-free facts, never its message.
+ */
+export declare function ensureLanguageServerReady(runtime: VibesRuntime, pm?: PMContext, workspacePath?: string): Promise<SessionInitResult['languageServer']>;
+//# sourceMappingURL=language.d.ts.map

package/dist/tools/lifecycle/init/language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/language.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAyC,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC9C,OAAO,EAAE,YAAY,EACrB,EAAE,CAAC,EAAE,SAAS,EACd,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAiB9C"}

package/dist/tools/lifecycle/init/language.js

@@ -0,0 +1,26 @@
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import { resolveLanguageServerPort } from "../workspace-capabilities.js";
+/**
+ * Start (or adopt) the workspace's TypeScript language server. Its failure
+ * never fails the bind: the receipt reports `status: 'error'` with the
+ * failure's value-free facts, never its message.
+ */
+export async function ensureLanguageServerReady(runtime, pm, workspacePath) {
+    if (!pm) {
+        return { status: 'skipped', reason: 'pm-unavailable' };
+    }
+    try {
+        const languageServer = await resolveLanguageServerPort(runtime);
+        const { socketPath } = await languageServer.ensureRunning({ languageId: 'typescript', workspacePath });
+        return { status: 'ready', socketPath };
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            reason: 'language-server-unavailable',
+            message: 'The TypeScript language server did not start for this workspace.',
+            failure: valueFreeFailure(CaughtFailureSchema.parse(error))
+        };
+    }
+}
+//# sourceMappingURL=language.js.map

package/dist/tools/lifecycle/init/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/language.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAqB,MAAM,qBAAqB,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,OAAqB,EACrB,EAAc,EACd,aAAsB;IAEtB,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,cAAc,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,cAAc,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;QACvG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,6BAA6B;YACrC,OAAO,EAAE,kEAAkE;YAC3E,OAAO,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SAC3D,CAAC;IACH,CAAC;AACF,CAAC"}

package/dist/tools/lifecycle/init/participant.d.ts

@@ -0,0 +1,58 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { SessionManager } from '../../../manager/index.ts';
+import type { McpClientInfo } from '../../../mcp/types.ts';
+import type { ParticipantProfile } from '../../../schemas/index.ts';
+import type { SessionInitInput } from './types.ts';
+type RuntimeInvokeCaller = import('@vibesdotdev/kernel/schemas/invoke-caller').RuntimeInvokeCaller;
+type ResolvedParticipantSummary = {
+    participantId: string;
+    profile: ParticipantProfile;
+    slug: string;
+};
+/**
+ * How the caller's seat was established.
+ * - `explicit`: the caller named itself (`participantId`, or a caller identity
+ *   the transport stamped that is NOT this connection's ambient mint).
+ * - `declared`: the client declared who it is (agentId / externalToolId /
+ *   harness session) and the seat was resolved by that slug.
+ * - `ambient`: nothing stable was declared; the seat is keyed on the session
+ *   the bind attaches to (see {@link reconcileMcpSeat}).
+ */
+export type OwnerIdentityKind = 'explicit' | 'declared' | 'ambient';
+export interface ResolvedOwnerParticipant {
+    participantId: string;
+    summary: ResolvedParticipantSummary;
+    clientInfo: McpClientInfo | undefined;
+    identity: OwnerIdentityKind;
+    /** True when the seat existed before this bind rather than being minted for it. */
+    reused: boolean;
+}
+export declare function stampCallerIdentity(args: SessionInitInput, session: SessionManager, summary: ResolvedParticipantSummary, clientInfo: McpClientInfo | undefined): Promise<ResolvedParticipantSummary>;
+export declare function resolveOwnerParticipant(runtime: VibesRuntime, args: SessionInitInput, session: SessionManager, mcpSessionId?: string | null, caller?: RuntimeInvokeCaller, workspaceRoot?: string | null): Promise<ResolvedOwnerParticipant>;
+export interface ReconciledSeat {
+    participantId: string;
+    summary: ResolvedParticipantSummary;
+    /** True when the seat existed before this bind. */
+    reused: boolean;
+    /** Durable seat key recorded for (client kind, session), when one applies. */
+    seat?: string;
+    /** True when the bind moved from the provisional participant to a reclaimed seat. */
+    switched: boolean;
+}
+/**
+ * Once the bind knows WHICH session it attaches to, an undeclared client's
+ * seat is keyed on (client kind, that session): reclaim the seat this kind
+ * already holds there, or record the provisional participant as that seat.
+ * Explicit and declared identities are stable on their own and pass through.
+ */
+export declare function reconcileMcpSeat(input: {
+    session: SessionManager;
+    owner: ResolvedOwnerParticipant;
+    args: SessionInitInput;
+    sessionId: string;
+    mcpSessionId?: string | null;
+    caller?: RuntimeInvokeCaller;
+    workspaceRoot?: string | null;
+}): Promise<ReconciledSeat>;
+export {};
+//# sourceMappingURL=participant.d.ts.map

package/dist/tools/lifecycle/init/participant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/participant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAgBpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,KAAK,mBAAmB,GAAG,OAAO,2CAA2C,EAAE,mBAAmB,CAAC;AAEnG,KAAK,0BAA0B,GAAG;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,0BAA0B,CAAC;IACpC,UAAU,EAAE,aAAa,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,mFAAmF;IACnF,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,mBAAmB,CACxC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,0BAA0B,EACnC,UAAU,EAAE,aAAa,GAAG,SAAS,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA8BrC;AAqCD,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,CAAC,EAAE,mBAAmB,EAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,wBAAwB,CAAC,CAkHnC;AAED,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,0BAA0B,CAAC;IACpC,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,wBAAwB,CAAC;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CA+D1B"}