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

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

@@ -0,0 +1,219 @@
+import { bindConnectionParticipant, declaredIdentitySlug, ensureParticipantSlug, getBoundConnectionParticipantId, getOrCreateMCPParticipant, getMcpClientInfo, mcpSessionRegistryFor, readHarnessSessionIdFromEnv, reclaimMcpSeat, recordMcpSeat, resolveParticipantReference, retireAmbientMintAfterBind, unixSeatConnectionKey } from "../../../mcp/utils/participant.js";
+import { harnessSeatOf } from "../../../schemas/harness-seat.js";
+export async function stampCallerIdentity(args, session, summary, clientInfo) {
+    if (!clientInfo && !args.capabilitiesOffered?.length)
+        return summary;
+    const capabilities = Array.from(new Set([...summary.profile.capabilities, ...(args.capabilitiesOffered ?? [])])).sort();
+    const metadata = {
+        ...summary.profile.metadata,
+        slug: summary.slug,
+        source: clientInfo
+            ? clientInfo.surface === 'mcp' || clientInfo.surface === 'acp'
+                ? 'external'
+                : (clientInfo.surface ?? 'mcp')
+            : undefined,
+        clientInfo
+    };
+    await session.updateParticipant(summary.participantId, {
+        name: clientInfo?.name ?? summary.profile.name,
+        capabilities,
+        metadata
+    });
+    return {
+        ...summary,
+        profile: {
+            ...summary.profile,
+            name: clientInfo?.name ?? summary.profile.name,
+            capabilities,
+            metadata
+        }
+    };
+}
+/**
+ * Did this seat exist before the connection that is binding it? A row created
+ * after the transport context (HTTP) or after this process started (stdio)
+ * was minted for this very bind.
+ */
+function seatExistedBeforeConnection(session, profile, mcpSessionId) {
+    const created = profile ? new Date(profile.createdAt).getTime() : Number.NaN;
+    if (!Number.isFinite(created))
+        return false;
+    // The connection's own context (HTTP), else when this root's transport
+    // registry began (stdio): a row created after either was minted for this bind.
+    const registry = mcpSessionRegistryFor(session.servingRuntime);
+    const connectionCreatedAt = mcpSessionId ? registry.peek(mcpSessionId)?.createdAt : undefined;
+    return created < (connectionCreatedAt ?? registry.createdAt);
+}
+/**
+ * The MCP adapter stamps `caller.participantId` on EVERY tool call from the
+ * participant it resolved for the connection — on a fresh connection that is
+ * an ambient auto-mint made milliseconds before init ran. It is not the caller
+ * naming itself; treating it as explicit let a throwaway id shadow the seat
+ * the client actually declared or held.
+ */
+function isAmbientCallerIdentity(session, callerParticipantId, mcpSessionId) {
+    if (!callerParticipantId)
+        return false;
+    return getBoundConnectionParticipantId(session, mcpSessionId) === callerParticipantId;
+}
+export async function resolveOwnerParticipant(runtime, args, session, mcpSessionId, caller, workspaceRoot) {
+    const runtimeClientInfo = getMcpClientInfo(session, mcpSessionId);
+    const harnessSessionId = args.clientInfo?.harnessSessionId ??
+        runtimeClientInfo?.harnessSessionId ??
+        (mcpSessionId ? undefined : readHarnessSessionIdFromEnv(runtime));
+    const name = args.clientInfo?.name ?? runtimeClientInfo?.name;
+    const agentId = args.clientInfo?.agentId ?? runtimeClientInfo?.agentId ?? caller?.agentId;
+    const clientInfo = name || harnessSessionId || args.clientInfo || runtimeClientInfo || agentId
+        ? {
+            ...runtimeClientInfo,
+            ...args.clientInfo,
+            name: name || (agentId ? 'agent' : 'mcp-client'),
+            agentId: agentId ? agentId : undefined,
+            harnessSessionId: harnessSessionId ? harnessSessionId : undefined
+        }
+        : undefined;
+    // Durable seat key for unix-RPC transports: the bind below persists under
+    // it so the seat survives daemon restarts (bind-once).
+    const seatKey = mcpSessionId ? undefined : unixSeatConnectionKey(workspaceRoot, caller?.agentId);
+    if (args.participantId) {
+        // Self-identification: init's participantId names the CALLER, so it may
+        // register a fresh seat and must bind this connection for ambient calls.
+        const resolved = await resolveParticipantReference(args.participantId, session, mcpSessionId, {
+            registerIfMissing: true
+        });
+        const summary = await stampCallerIdentity(args, session, resolved, clientInfo);
+        await bindConnectionParticipant(session, summary.participantId, summary.slug, mcpSessionId, seatKey);
+        return {
+            participantId: summary.participantId,
+            summary,
+            clientInfo,
+            identity: 'explicit',
+            reused: !resolved.registered
+        };
+    }
+    const callerParticipantId = caller?.participantId?.trim() || undefined;
+    const callerIsAmbient = isAmbientCallerIdentity(session, callerParticipantId, mcpSessionId);
+    const declaredSlug = declaredIdentitySlug(clientInfo);
+    if (declaredSlug && (!callerParticipantId || callerIsAmbient)) {
+        // The client DECLARED who it is. That beats the ambient mint: resolve by
+        // the same stable-order slug scan self-identification uses, so the seat
+        // that already carries this slug wins. Before, the ambient mint was kept
+        // and RENAMED to the declared slug — two rows answering to one slug, a
+        // new one per restart.
+        // A harness conversation's seat is derived from (agent, harness session),
+        // so the hook that started the conversation and this connection land on
+        // the same participant; any other declaration resolves by slug.
+        const seat = harnessSeatOf(clientInfo);
+        const resolved = seat
+            ? await (async () => {
+                const existed = await session.findHarnessSeat(seat);
+                const profile = await session.ensureHarnessSeat({
+                    ...seat,
+                    name: clientInfo?.name || undefined,
+                    source: 'mcp'
+                });
+                return {
+                    participantId: profile.participantId,
+                    profile,
+                    slug: declaredSlug,
+                    registered: !existed
+                };
+            })()
+            : await resolveParticipantReference(declaredSlug, session, mcpSessionId, {
+                registerIfMissing: true
+            });
+        const summary = await stampCallerIdentity(args, session, resolved, clientInfo);
+        await bindConnectionParticipant(session, summary.participantId, summary.slug, mcpSessionId, seatKey);
+        if (callerIsAmbient && callerParticipantId && callerParticipantId !== summary.participantId) {
+            await retireAmbientMintAfterBind(session, callerParticipantId, mcpSessionId);
+        }
+        return {
+            participantId: summary.participantId,
+            summary,
+            clientInfo,
+            identity: 'declared',
+            reused: !resolved.registered
+        };
+    }
+    // Undeclared (or explicitly stamped) identity: the ambient resolution path.
+    // No preferred slug — a fresh seat is slugged from its client kind and its
+    // own id, and an existing seat keeps the slug others already address.
+    const fallbackParticipantId = await getOrCreateMCPParticipant(clientInfo, {}, mcpSessionId, caller, session, workspaceRoot);
+    const ensured = await ensureParticipantSlug(session, fallbackParticipantId);
+    const resolved = {
+        participantId: ensured.profile.participantId,
+        profile: ensured.profile,
+        slug: ensured.slug
+    };
+    const summary = await stampCallerIdentity(args, session, resolved, clientInfo);
+    // Always stamp the connection: ambient tools resolve identity from the
+    // connection binding, not from the init receipt.
+    await bindConnectionParticipant(session, summary.participantId, summary.slug, mcpSessionId, seatKey);
+    return {
+        participantId: summary.participantId,
+        summary,
+        clientInfo,
+        identity: callerParticipantId && !callerIsAmbient ? 'explicit' : 'ambient',
+        reused: seatExistedBeforeConnection(session, ensured.profile, mcpSessionId)
+    };
+}
+/**
+ * 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 async function reconcileMcpSeat(input) {
+    const { session, owner, args, sessionId, mcpSessionId } = input;
+    if (owner.identity !== 'ambient') {
+        return {
+            participantId: owner.participantId,
+            summary: owner.summary,
+            reused: owner.reused,
+            switched: false
+        };
+    }
+    const reclaimed = await reclaimMcpSeat(session, owner.clientInfo, sessionId, mcpSessionId);
+    if (!reclaimed) {
+        // No key can be formed (unnamed client, non-UUID session) or every
+        // ordinal seat is held by a live connection: keep the provisional seat,
+        // record nothing — never overwrite a seat another live client holds.
+        return {
+            participantId: owner.participantId,
+            summary: owner.summary,
+            reused: owner.reused,
+            switched: false
+        };
+    }
+    if (reclaimed.profile && reclaimed.profile.participantId !== owner.participantId) {
+        const ensured = await ensureParticipantSlug(session, reclaimed.profile.participantId, reclaimed.profile);
+        const summary = await stampCallerIdentity(args, session, { participantId: ensured.profile.participantId, profile: ensured.profile, slug: ensured.slug }, owner.clientInfo);
+        const seatKey = reclaimed.seatKey ?? (mcpSessionId
+            ? undefined
+            : unixSeatConnectionKey(input.workspaceRoot, input.caller?.agentId));
+        await bindConnectionParticipant(session, summary.participantId, summary.slug, mcpSessionId, seatKey);
+        await session.setParticipantActiveSession(summary.participantId, sessionId);
+        await retireAmbientMintAfterBind(session, owner.participantId, mcpSessionId);
+        return {
+            participantId: summary.participantId,
+            summary,
+            reused: true,
+            seat: reclaimed.seatKey,
+            switched: true
+        };
+    }
+    // Free slot, or already ours: record (refresh) the seat under its key.
+    const seat = await recordMcpSeat(session, owner.clientInfo, reclaimed.seatKey, owner.participantId);
+    const seatKey = reclaimed.seatKey ?? (mcpSessionId
+        ? undefined
+        : unixSeatConnectionKey(input.workspaceRoot, input.caller?.agentId));
+    await bindConnectionParticipant(session, owner.participantId, owner.summary.slug, mcpSessionId, seatKey);
+    return {
+        participantId: owner.participantId,
+        summary: owner.summary,
+        reused: owner.reused,
+        seat,
+        switched: false
+    };
+}
+//# sourceMappingURL=participant.js.map

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

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

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

@@ -0,0 +1,106 @@
+/**
+ * Session Init Tool Schemas
+ */
+import z from 'zod/v4';
+export declare const SessionInitInputSchema: z.ZodObject<{
+    prepare: z.ZodOptional<z.ZodBoolean>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodUUID>;
+    participantId: z.ZodOptional<z.ZodString>;
+    clientInfo: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        surface: z.ZodEnum<{
+            cli: "cli";
+            tui: "tui";
+            mcp: "mcp";
+            bridge: "bridge";
+            web: "web";
+            acp: "acp";
+        }>;
+        externalToolId: z.ZodOptional<z.ZodString>;
+        machineId: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+        providerId: z.ZodOptional<z.ZodString>;
+        modelId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    capabilitiesOffered: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    capabilitiesRequired: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    filesPattern: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enrichKnowledge: z.ZodDefault<z.ZodBoolean>;
+    knowledgeThreshold: z.ZodDefault<z.ZodNumber>;
+    workspacePath: z.ZodOptional<z.ZodString>;
+    knowledgeBaseIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    knowledgeBindingPolicy: z.ZodDefault<z.ZodEnum<{
+        optional: "optional";
+        required: "required";
+    }>>;
+    useKnowledgeApi: z.ZodOptional<z.ZodBoolean>;
+    newSession: z.ZodOptional<z.ZodBoolean>;
+    parentSessionId: z.ZodOptional<z.ZodNullable<z.ZodUUID>>;
+    handle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionInitInput = z.infer<typeof SessionInitInputSchema>;
+/** Compact bind receipt — static ceremony lives in docs/descriptors. */
+export declare const SessionInitOutputSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"session.bind-receipt">;
+    sessionId: z.ZodString;
+    title: z.ZodString;
+    status: z.ZodString;
+    reused: z.ZodOptional<z.ZodBoolean>;
+    createdAt: z.ZodString;
+    participant: z.ZodObject<{
+        id: z.ZodString;
+        slug: z.ZodString;
+        name: z.ZodString;
+        capabilities: z.ZodArray<z.ZodString>;
+        clientInfo: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            surface: z.ZodEnum<{
+                cli: "cli";
+                tui: "tui";
+                mcp: "mcp";
+                bridge: "bridge";
+                web: "web";
+                acp: "acp";
+            }>;
+            externalToolId: z.ZodOptional<z.ZodString>;
+            machineId: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            providerId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    instance: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        handle: z.ZodOptional<z.ZodString>;
+        transport: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    preparationAction: z.ZodOptional<z.ZodObject<{
+        tool: z.ZodLiteral<"session">;
+        action: z.ZodLiteral<"init">;
+        sessionId: z.ZodString;
+        prepare: z.ZodLiteral<true>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    nextAction: z.ZodObject<{
+        tool: z.ZodLiteral<"session">;
+        action: z.ZodLiteral<"packet">;
+        sessionId: z.ZodString;
+        reason: z.ZodString;
+    }, z.core.$strip>;
+    nextSteps: z.ZodArray<z.ZodString>;
+    languageServer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    atlasRefresh: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    knowledgeContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    knowledgeEnrichment: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    workspace: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    warning: z.ZodOptional<z.ZodString>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type SessionInitOutput = z.infer<typeof SessionInitOutputSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAavB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoDjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,wEAAwE;AACxE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

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

@@ -0,0 +1,94 @@
+/**
+ * Session Init Tool Schemas
+ */
+import z from 'zod/v4';
+const SessionClientInfoSchema = z.object({
+    name: z.string().min(1).max(100),
+    version: z.string().min(1).max(100).optional(),
+    surface: z.enum(['tui', 'web', 'bridge', 'cli', 'mcp', 'acp']),
+    externalToolId: z.string().min(1).max(100).optional(),
+    machineId: z.string().min(1).max(200).optional(),
+    agentId: z.string().min(1).max(200).optional(),
+    providerId: z.string().min(1).max(200).optional(),
+    modelId: z.string().min(1).max(300).optional()
+});
+export const SessionInitInputSchema = z.object({
+    prepare: z.boolean().optional().describe('Default false: bind immediately. Set true on this session to start language services, refresh Atlas, and resolve/link knowledge. A required knowledge policy always prepares.'),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    projectId: z.uuid().optional(),
+    participantId: z.string().optional(),
+    clientInfo: SessionClientInfoSchema.optional(),
+    capabilitiesOffered: z.array(z.string().min(1)).optional(),
+    capabilitiesRequired: z.array(z.string().min(1)).optional(),
+    sessionId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Rebind to this specific session instead of resolving one from the participant map (needed after a client/body restart, which mints a new participant id).'),
+    filesPattern: z.array(z.string()).optional(),
+    tags: z.array(z.string()).optional(),
+    enrichKnowledge: z.boolean().default(true),
+    knowledgeThreshold: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.8)
+        .describe('Minimum similarity score (0-1) for auto-linking knowledge items. Default 0.8 is conservative.'),
+    workspacePath: z.string().optional(),
+    knowledgeBaseIds: z.array(z.string().min(1)).optional(),
+    knowledgeBindingPolicy: z
+        .enum(['required', 'optional'])
+        .default('optional')
+        .describe('Project knowledge binding policy. Optional reports degraded/missing roles and falls back to explicit/project-ref/discovery resolution; required fails init unless dependencies, rules, and codebase are all bound.'),
+    useKnowledgeApi: z.boolean().optional(),
+    newSession: z
+        .boolean()
+        .optional()
+        .describe('When true, always create a fresh session even if the participant already has one.'),
+    parentSessionId: z
+        .uuid()
+        .nullable()
+        .optional()
+        .describe('For a session this init creates: the session it belongs to. Defaults to the session the caller is working in; null makes it top level.'),
+    handle: z
+        .string()
+        .trim()
+        .min(2)
+        .max(64)
+        .optional()
+        .describe('The name this running instance goes by, unique among live instances. Omit to keep the one you have (a random one is given on your first call). A name another live instance holds is refused, naming the holder.')
+});
+/** Compact bind receipt — static ceremony lives in docs/descriptors. */
+export const SessionInitOutputSchema = z.object({
+    kind: z.literal('session.bind-receipt'),
+    sessionId: z.string(),
+    title: z.string(),
+    status: z.string(),
+    reused: z.boolean().optional(),
+    createdAt: z.string(),
+    participant: z.object({
+        id: z.string(),
+        slug: z.string(),
+        name: z.string(),
+        capabilities: z.array(z.string()),
+        clientInfo: SessionClientInfoSchema.optional()
+    }),
+    instance: z.object({ id: z.string(), handle: z.string().optional(), transport: z.string().optional() }).optional(),
+    preparationAction: z.object({ tool: z.literal('session'), action: z.literal('init'), sessionId: z.string(), prepare: z.literal(true), reason: z.string() }).optional(),
+    nextAction: z.object({
+        tool: z.literal('session'),
+        action: z.literal('packet'),
+        sessionId: z.string(),
+        reason: z.string()
+    }),
+    nextSteps: z.array(z.string()).max(3),
+    languageServer: z.record(z.string(), z.unknown()).optional(),
+    atlasRefresh: z.record(z.string(), z.unknown()).optional(),
+    knowledgeContext: z.record(z.string(), z.unknown()).optional(),
+    knowledgeEnrichment: z.record(z.string(), z.unknown()).optional(),
+    workspace: z.record(z.string(), z.unknown()).optional(),
+    warning: z.string().optional(),
+    message: z.string()
+});
+//# sourceMappingURL=schemas.js.map

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

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

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

@@ -0,0 +1,143 @@
+import type { ValueFreeFailure } from '@vibesdotdev/kernel';
+import type { JsonObject } from '@vibesdotdev/kernel/schemas/json';
+export type { SessionInitInput } from '../../../mcp/schemas/tools.ts';
+export interface WorkspaceContext {
+    path: string;
+    source: 'arguments' | 'context' | 'cli' | 'inferred';
+    /** Set when the resolved path is not a real project root (`/` or `$HOME`). */
+    warning?: string;
+}
+/**
+ * Compact bind receipt from session.init.
+ * Static coordination tips live in descriptors/docs; hydrate state via action:"packet".
+ */
+export interface SessionInitResult {
+    kind: 'session.bind-receipt';
+    sessionId: string;
+    title: string;
+    status: string;
+    /** True when init rebound to an existing session (requested by id, or the participant's) instead of creating a new one. */
+    reused: boolean;
+    /**
+     * Echoed only when the caller named a `sessionId` that could NOT be bound, so a
+     * rejected request is never silent — without it the receipt is indistinguishable
+     * from a normal fresh bind and the caller keeps writing against a stranded id.
+     */
+    requestedSessionId?: string;
+    /** Why the requested session was not bound. */
+    requestedSessionRejected?: 'unresolvable' | 'foreign-workspace' | 'ambiguous';
+    createdAt: string;
+    /** The running instance this caller is: its id and the handle it and others know it by. */
+    instance?: {
+        id: string;
+        handle?: string;
+        transport?: string;
+    };
+    participant: {
+        id: string;
+        slug: string;
+        name: string;
+        capabilities: string[];
+        /**
+         * True when this bind got an EXISTING seat (by explicit id, declared
+         * identity, or the client-kind seat recorded for this session); false when
+         * the participant was minted for this bind. A body restart that changed
+         * who you are is visible here, not discovered later from orphaned mail.
+         */
+        reused: boolean;
+        /** Durable seat key recorded for (client kind, session), when one applies. */
+        seat?: string;
+        clientInfo?: {
+            name: string;
+            version?: string;
+            surface?: 'tui' | 'web' | 'bridge' | 'cli' | 'mcp' | 'acp';
+            externalToolId?: string;
+            machineId?: string;
+            agentId?: string;
+            providerId?: string;
+            modelId?: string;
+        };
+    };
+    /** Present when this bind deferred preparation: re-run init with `prepare: true` to start it. */
+    preparationAction?: {
+        tool: 'session';
+        action: 'init';
+        sessionId: string;
+        prepare: true;
+        reason: string;
+    };
+    /** Machine-readable next action: always the resume packet for this bind. */
+    nextAction: {
+        tool: 'session';
+        action: 'packet';
+        sessionId: string;
+        reason: string;
+    };
+    /** Single clear next step pointing at action:"packet" (no static onboarding guide). */
+    nextSteps: string[];
+    languageServer: {
+        status: string;
+        reason?: string;
+        socketPath?: string;
+        message?: string;
+        /** The value-free facts of a failed start (`status: 'error'`). */
+        failure?: ValueFreeFailure;
+    };
+    atlasRefresh: {
+        status: string;
+        reason?: string;
+        projectId?: string;
+        workspacePath?: string;
+        jobId?: string;
+        jobType?: string;
+        queueName?: string;
+        trackedJobId?: string;
+        error?: string;
+        hints?: string[];
+        message?: string;
+        indexAgeMinutes?: number;
+        /** The value-free facts of a failed refresh step. */
+        failure?: ValueFreeFailure;
+    };
+    /** Present when the workspace intelligence runtime kind is registered. */
+    workspaceIntelligence?: JsonObject;
+    knowledgeContext: {
+        projectId: string | null;
+        knowledgeBaseIds: string[];
+        missingKnowledgeBases: string[];
+        source: string;
+        knowledgeApiEnabled: boolean;
+        workspacePath: string;
+        knowledgeBinding: {
+            projectId?: string;
+            state: 'ready' | 'degraded' | 'missing';
+            policy: 'required' | 'optional';
+            roles: Partial<Record<'dependencies' | 'rules' | 'codebase', string>>;
+            missingRoles: Array<'dependencies' | 'rules' | 'codebase'>;
+            source: 'project-binding' | 'unbound' | 'disabled';
+            reason?: string;
+        };
+    };
+    knowledgeEnrichment: {
+        status: string;
+        reason?: string;
+        linkedCount?: number;
+        query?: string;
+        threshold?: number;
+        searchMode?: string;
+        message?: string;
+        /** The value-free facts of a failed enrichment (`status: 'error'`). */
+        failure?: ValueFreeFailure;
+    };
+    workspace: {
+        path: string;
+        source: string;
+        warning?: string;
+    };
+    /** Top-level, hard-to-miss copy of a workspace mis-anchor warning (if any). */
+    warning?: string;
+    message: string;
+}
+export declare const DEFAULT_PARTICIPANT_SLUG = "session-participant";
+export declare const DEFAULT_KNOWLEDGE_THRESHOLD = 0.8;
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+export const DEFAULT_PARTICIPANT_SLUG = 'session-participant';
+export const DEFAULT_KNOWLEDGE_THRESHOLD = 0.8;
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/types.ts"],"names":[],"mappings":"AAsIA,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAAC;AAC9D,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC"}

package/dist/tools/lifecycle/init/workspace.consumer.d.ts

@@ -0,0 +1,13 @@
+import { type RuntimeInvokeWorkspace, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { SessionInitInput, WorkspaceContext } from './types.ts';
+/**
+ * Resolve the session's workspace: an explicit `workspacePath` argument, else
+ * the call's workspace (`ToolCallContext.workspace`), else the one reader,
+ * `runtime/workspace-path` (rc02-rc03 §2.4). An unbound host fails there with
+ * `workspace-unbound`, whose hint names `--workspace-root`; nothing falls back
+ * to the process cwd, an environment variable or a walk. A bound root that is
+ * `/` or the user's home carries a warning, so the operator sees the injury
+ * instead of silently mis-anchoring.
+ */
+export declare function resolveWorkspaceContext(args: Pick<SessionInitInput, 'workspacePath'>, runtime: VibesRuntime, invokeWorkspace?: RuntimeInvokeWorkspace): Promise<WorkspaceContext>;
+//# sourceMappingURL=workspace.consumer.d.ts.map

package/dist/tools/lifecycle/init/workspace.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.consumer.d.ts","sourceRoot":"","sources":["../../../../src/tools/lifecycle/init/workspace.consumer.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,sBAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2BrE;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CAC5C,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,eAAe,CAAC,EAC7C,OAAO,EAAE,YAAY,EACrB,eAAe,CAAC,EAAE,sBAAsB,GACtC,OAAO,CAAC,gBAAgB,CAAC,CAgB3B"}