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

package/dist/mcp/schemas/tools.js

@@ -0,0 +1,266 @@
+/**
+ * Session MCP Tool Schemas
+ * Zod schemas for MCP tool inputs
+ */
+import z from 'zod/v4';
+import { VibesLinksSchema } from '@vibesdotdev/shared/schemas';
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const PARTICIPANT_SLUG_REGEX = /^[a-z0-9](?:[a-z0-9-]{1,62}[a-z0-9])?$/;
+// Older session rows used stable participant ids such as
+// `participant-cli-cli-repository-collection-b2b9edb4`. Keep those ids addressable while
+// migration is in flight; the resolver still requires a registered profile,
+// so broadening this parser cannot create phantom recipients.
+const LEGACY_PARTICIPANT_ID_REGEX = /^[A-Za-z0-9][A-Za-z0-9_-]{1,127}$/;
+export const ParticipantReferenceSchema = z
+    .string()
+    .min(1)
+    .trim()
+    .refine((value) => UUID_REGEX.test(value) ||
+    PARTICIPANT_SLUG_REGEX.test(value) ||
+    LEGACY_PARTICIPANT_ID_REGEX.test(value), {
+    message: 'Participant reference must be a UUID, lowercase slug, or registered legacy participant id.'
+});
+export const CoordinationScenarioSchema = z.enum(['invite', 'handoff', 'status-update']);
+// SESSION MANAGEMENT SCHEMAS
+export const SessionInitInputSchema = z.object({
+    prepare: z.boolean().optional().describe('Default false: bind immediately. Set true to start workspace services, refresh Atlas, and resolve/link knowledge. Required knowledge policy always prepares.'),
+    title: z.string().min(1).max(200).optional(),
+    description: z.string().max(2000).optional(),
+    projectId: z
+        .uuid()
+        .optional()
+        .describe('Project UUID; when supplied, must equal the checkout ProjectRef'),
+    knowledgeBaseIds: z.array(z.string().min(1)).optional().describe('Knowledge base IDs or slugs'),
+    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.'),
+    participantId: ParticipantReferenceSchema.optional(),
+    clientInfo: 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(),
+        harnessSessionId: z.string().min(1).max(200).optional()
+    })
+        .optional()
+        .describe('Truthful caller identity for a first-party surface or external teammate'),
+    capabilitiesOffered: z.array(z.string().min(1)).optional(),
+    capabilitiesRequired: z.array(z.string().min(1)).optional(),
+    workspacePath: z
+        .string()
+        .trim()
+        .min(1)
+        .optional()
+        .describe('Absolute project workspace path (required for MCP HTTP transport)'),
+    useKnowledgeApi: z
+        .boolean()
+        .optional()
+        .describe('Enable knowledge discovery; defaults to true. Set false to disable it.'),
+    sessionId: z
+        .string()
+        .min(1)
+        .optional()
+        .describe('Rebind to THIS session instead of resolving one from the participant map. Accepts the full UUID or the unique eight-character handle emitted by list/search. Use it after a client/body restart: a respawned connection is issued a new participant id, so the map cannot find the session you were just using. Fails closed when the reference is missing, ambiguous, archived, or belongs to another workspace.'),
+    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.'),
+    newSession: z
+        .boolean()
+        .optional()
+        .describe('Force a brand-new session even when this participant already has an active one. Defaults to reuse: init is idempotent and rebinds to the participant’s existing active session, so a reconnecting body does not mint a duplicate session row.')
+});
+export const SessionGetInputSchema = z.object({
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const SessionStatusInputSchema = z.object({});
+export const SessionContextInputSchema = z.object({
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const SessionListInputSchema = z.object({
+    status: z.enum(['active', 'paused', 'archived', 'all']).default('all'),
+    limit: z.number().int().positive().default(50),
+    offset: z.number().int().nonnegative().default(0)
+});
+export const SessionSearchInputSchema = z.object({
+    query: z.string().min(1),
+    status: z.enum(['active', 'paused', 'archived', 'all']).default('all'),
+    limit: z.number().int().positive().default(50)
+});
+export const SessionUpdateInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    title: z.string().min(1).max(200).optional(),
+    description: z.string().max(2000).optional(),
+    tags: z.array(z.string()).optional()
+});
+export const SessionPauseInputSchema = z.object({
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const SessionResumeInputSchema = z.object({
+    sessionId: z.uuid()
+});
+export const SessionArchiveInputSchema = z.object({
+    sessionId: z.uuid()
+});
+export const SessionSnapshotInputSchema = z.object({
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const SessionCoordinateInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    scenario: CoordinationScenarioSchema.default('handoff'),
+    toParticipants: z.array(ParticipantReferenceSchema).optional(),
+    includeDocs: z.boolean().default(true),
+    includeCommands: z.boolean().default(true),
+    additionalContext: z.string().max(2000).optional()
+});
+export const TodoAddInputSchema = z.object({
+    content: z.string().min(1).max(500),
+    activeForm: z.string().min(1).max(500).optional(),
+    // Accepted at create so an assignment/status supplied to `add` round-trips
+    // instead of being silently stripped (the caller then had to issue a separate
+    // update to set the owner or a blocked-at-create status).
+    status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'cancelled']).optional(),
+    assignedParticipant: ParticipantReferenceSchema.optional(),
+    priority: z.enum(['low', 'medium', 'high', 'urgent']).default('medium'),
+    parentId: z.uuid().optional(),
+    dependencies: z.array(z.uuid()).optional(),
+    tags: z.array(z.string()).optional(),
+    estimatedMinutes: z.number().int().positive().optional(),
+    workItemId: z.uuid().optional(),
+    links: VibesLinksSchema.optional(),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const TodoBatchAddInputSchema = z.object({
+    todos: z
+        .array(z.object({
+        content: z.string().min(1).max(500),
+        activeForm: z.string().min(1).max(500).optional(),
+        // Round-trip assignment/status per item (see TodoAddInputSchema) so a
+        // batch add does not silently drop the owner or a blocked-at-create status.
+        status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'cancelled']).optional(),
+        assignedParticipant: ParticipantReferenceSchema.optional(),
+        priority: z.enum(['low', 'medium', 'high', 'urgent']).default('medium'),
+        parentId: z.uuid().optional(),
+        dependencies: z.array(z.uuid()).optional(),
+        tags: z.array(z.string()).optional(),
+        estimatedMinutes: z.number().int().positive().optional(),
+        workItemId: z.uuid().optional(),
+        links: VibesLinksSchema.optional()
+    }))
+        .min(1)
+        .max(50),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const TodoListInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'cancelled']).optional(),
+    priority: z.enum(['low', 'medium', 'high', 'urgent']).optional(),
+    parentId: z.uuid().optional().nullable(),
+    assignedParticipant: ParticipantReferenceSchema.optional(),
+    mine: z.boolean().default(false),
+    // All-of exact membership: a todo matches when it carries every tag.
+    tags: z.array(z.string().min(1)).min(1).optional(),
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().min(0).optional()
+});
+export const TodoGetInputSchema = z.object({
+    todoId: z.uuid()
+});
+export const TodoUpdateInputSchema = z.object({
+    todoId: z.uuid(),
+    content: z.string().min(1).max(500).optional(),
+    activeForm: z.string().min(1).max(500).optional(),
+    status: z.enum(['pending', 'in_progress', 'completed', 'blocked', 'cancelled']).optional(),
+    priority: z.enum(['low', 'medium', 'high', 'urgent']).optional(),
+    assignedParticipant: ParticipantReferenceSchema.optional(),
+    estimatedMinutes: z.number().int().positive().optional(),
+    actualMinutes: z.number().int().positive().optional(),
+    tags: z.array(z.string()).optional(),
+    workItemId: z.uuid().optional(),
+    links: VibesLinksSchema.optional()
+});
+export const TodoCompleteInputSchema = z.object({
+    todoId: z.uuid()
+});
+export const TodoTreeInputSchema = z.object({
+    parentId: z.uuid().optional().nullable(), // null = root level
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+// SCRATCHPAD SCHEMAS
+export const ScratchpadWriteInputSchema = z.object({
+    key: z.string().min(1).max(200),
+    content: z.string().min(1),
+    contentType: z.enum(['markdown', 'json', 'text', 'code']).default('text'),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const ScratchpadQuickNoteInputSchema = z.object({
+    content: z.string().min(1),
+    contentType: z.enum(['markdown', 'json', 'text', 'code']).default('text'),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const ScratchpadReadInputSchema = z.object({
+    key: z.string().min(1).max(200),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const ScratchpadListInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    contentType: z.enum(['markdown', 'json', 'text', 'code']).optional()
+});
+export const ScratchpadSearchInputSchema = z.object({
+    query: z.string().min(1),
+    sessionId: z.uuid().optional(), // Defaults to active session
+    limit: z.number().int().positive().default(50)
+});
+// JOB TRACKING SCHEMAS
+export const JobTrackInputSchema = z.object({
+    jobId: z.string().min(1),
+    queueName: z.string().min(1),
+    jobType: z.string().min(1),
+    description: z.string().max(500).optional(),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const JobListInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    status: z.enum(['pending', 'processing', 'completed', 'failed', 'cancelled']).optional(),
+    queueName: z.string().optional()
+});
+// PARTICIPANT COMMUNICATION SCHEMAS
+export const MessageSendInputSchema = z.object({
+    toParticipant: ParticipantReferenceSchema,
+    fromParticipant: ParticipantReferenceSchema.optional(),
+    messageType: z.enum(['info', 'request', 'transfer', 'question', 'answer']).default('info'),
+    content: z.string().min(1),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    sessionId: z.uuid().optional() // Defaults to active session
+});
+export const MessageListInputSchema = z.object({
+    sessionId: z.uuid().optional(), // Defaults to active session
+    fromParticipant: ParticipantReferenceSchema.optional(),
+    toParticipant: ParticipantReferenceSchema.optional(),
+    participantId: ParticipantReferenceSchema.optional(), // Caller identity; scopes unreadOnly to the caller
+    unreadOnly: z.boolean().default(false),
+    limit: z.number().int().positive().default(100),
+    offset: z.number().int().nonnegative().default(0)
+});
+export const MessageMarkReadInputSchema = z
+    .object({
+    messageId: z.uuid().optional(),
+    sessionId: z.uuid().optional(),
+    toParticipant: ParticipantReferenceSchema.optional(),
+    participantId: ParticipantReferenceSchema.optional() // Caller identity; enforces own-only mark-read
+})
+    .refine((data) => data.messageId || data.sessionId, {
+    message: 'Either messageId or sessionId is required'
+});
+//# sourceMappingURL=tools.js.map

package/dist/mcp/schemas/tools.js.map

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

package/dist/mcp/types.d.ts

@@ -0,0 +1,3 @@
+/** Compatible type entrypoint; schemas own the session-local MCP boundaries. */
+export type { McpHttpPeerInfo, McpClientInfo, McpConnectionState, McpUser, WorkspaceSource, WorkspaceContext, ApiClientLike, McpToolContext } from '../schemas/mcp.ts';
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,YAAY,EACX,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,OAAO,EAC3D,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAChE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mcp/types.ts"],"names":[],"mappings":""}

package/dist/mcp/utils/coordination.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Coordination helpers for multi-participant workflows.
+ */
+export type { CoordinationScenario, CoordinationPrompt, CoordinationCommand, CoordinationDocRef } from '../schemas/coordination.ts';
+import type { CoordinationDocRef } from '../schemas/coordination.ts';
+export declare const RECOMMENDED_TOOL_GROUPS: {
+    readonly planning: readonly ["session-todo", "session-scratchpad"];
+    readonly coordination: readonly ["session-collaborate", "session-todo"];
+    readonly tracking: readonly ["session-todo"];
+    readonly context: readonly ["session"];
+    readonly knowledge: readonly ["knowledge"];
+};
+export declare const COORDINATION_TIPS: readonly ["Share the full session boilerplate, current TODO tree, and scratchpad keys before collaborators begin.", "Coordinate by pairing `session-collaborate` (action: send --toParticipant) with `session-todo` (action: update --assignedParticipant) — there is no separate coordinate tool.", "Assign tasks with `session-todo` (action: update) so ownership stays explicit and reversible.", "Capture interim findings in `session-scratchpad` (action: write) before transferring responsibility to another participant.", "Before handoff, use `knowledge` (action: create) to preserve reusable discoveries (facts, examples, instructions) for future contributors."];
+export declare const COORDINATION_DOCS: CoordinationDocRef[];
+export declare function buildInvitePrompt(sessionId: string, title: string, invitingSlug: string): string;
+export declare function buildHandoffPrompt(sessionId: string, invitingSlug: string): string;
+//# sourceMappingURL=coordination.d.ts.map

package/dist/mcp/utils/coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/coordination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACX,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,uBAAuB;;;;;;CAM1B,CAAC;AAEX,eAAO,MAAM,iBAAiB,opBAMpB,CAAC;AAEX,eAAO,MAAM,iBAAiB,EAAE,kBAAkB,EAgBjD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAShG;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAUlF"}

package/dist/mcp/utils/coordination.js

@@ -0,0 +1,56 @@
+/**
+ * Coordination helpers for multi-participant workflows.
+ */
+export const RECOMMENDED_TOOL_GROUPS = {
+    planning: ['session-todo', 'session-scratchpad'],
+    coordination: ['session-collaborate', 'session-todo'],
+    tracking: ['session-todo'],
+    context: ['session'],
+    knowledge: ['knowledge']
+};
+export const COORDINATION_TIPS = [
+    'Share the full session boilerplate, current TODO tree, and scratchpad keys before collaborators begin.',
+    'Coordinate by pairing `session-collaborate` (action: send --toParticipant) with `session-todo` (action: update --assignedParticipant) — there is no separate coordinate tool.',
+    'Assign tasks with `session-todo` (action: update) so ownership stays explicit and reversible.',
+    'Capture interim findings in `session-scratchpad` (action: write) before transferring responsibility to another participant.',
+    'Before handoff, use `knowledge` (action: create) to preserve reusable discoveries (facts, examples, instructions) for future contributors.'
+];
+export const COORDINATION_DOCS = [
+    {
+        title: 'Rules Summary',
+        path: 'docs/rules/summary.md',
+        summary: 'Generated checklist of active engineering rules.'
+    },
+    {
+        title: 'Development Cheatsheet',
+        path: 'docs/development/cheatsheet.md',
+        summary: 'Feature topology, schema-first workflow, and coordination guidance.'
+    },
+    {
+        title: 'Session Management Overview',
+        path: 'session/README.md',
+        summary: 'Session tooling reference including MCP, CLI, and collaboration workflows.'
+    }
+];
+export function buildInvitePrompt(sessionId, title, invitingSlug) {
+    return [
+        `You are joining workspace session "${title}" (${sessionId}) as a collaborating participant invited by ${invitingSlug}.`,
+        `1. Attach to THIS session: \`session\` (action: status, sessionId: "${sessionId}"). Do NOT run action: init — init forks a new session; passing the sessionId binds you to the shared one.`,
+        `2. Restate rules (cite ${invitingSlug}) and confirm the active session.`,
+        '3. Review TODOs via `session-todo` (action: list) and claim ownership with `session-todo` (action: update).',
+        '4. Announce your plan using `session-collaborate` (action: send) before executing.',
+        '5. Document progress in the scratchpad and send a status update when complete.'
+    ].join('\n');
+}
+export function buildHandoffPrompt(sessionId, invitingSlug) {
+    return [
+        `Handing off from ${invitingSlug} in session ${sessionId}.`,
+        '- Context accomplished so far: <summaries or links>',
+        '- TODOs reassigned: `session-todo` (action: update) with assignedParticipant <receiver-slug>',
+        '- Scratchpad entries to review: <keys or titles>',
+        '- Knowledge contributed: <items added via knowledge (action: create), or "none yet">',
+        '- Expected next steps: <bulleted list>',
+        'Send `session-collaborate` (action: send, messageType: request) when you pick this up and confirm timing.'
+    ].join('\n');
+}
+//# sourceMappingURL=coordination.js.map

package/dist/mcp/utils/coordination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.js","sourceRoot":"","sources":["../../../src/mcp/utils/coordination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC,QAAQ,EAAE,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAChD,YAAY,EAAE,CAAC,qBAAqB,EAAE,cAAc,CAAC;IACrD,QAAQ,EAAE,CAAC,cAAc,CAAC;IAC1B,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,SAAS,EAAE,CAAC,WAAW,CAAC;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,wGAAwG;IACxG,+KAA+K;IAC/K,+FAA+F;IAC/F,6HAA6H;IAC7H,4IAA4I;CACnI,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAyB;IACtD;QACC,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,kDAAkD;KAC3D;IACD;QACC,KAAK,EAAE,wBAAwB;QAC/B,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE,qEAAqE;KAC9E;IACD;QACC,KAAK,EAAE,6BAA6B;QACpC,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,4EAA4E;KACrF;CACD,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,KAAa,EAAE,YAAoB;IACvF,OAAO;QACN,sCAAsC,KAAK,MAAM,SAAS,+CAA+C,YAAY,GAAG;QACxH,uEAAuE,SAAS,4GAA4G;QAC5L,0BAA0B,YAAY,mCAAmC;QACzE,6GAA6G;QAC7G,oFAAoF;QACpF,gFAAgF;KAChF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,YAAoB;IACzE,OAAO;QACN,oBAAoB,YAAY,eAAe,SAAS,GAAG;QAC3D,qDAAqD;QACrD,8FAA8F;QAC9F,kDAAkD;QAClD,sFAAsF;QACtF,wCAAwC;QACxC,2GAA2G;KAC3G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/mcp/utils/knowledge.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Knowledge context utilities for session-init (injury L-06).
+ *
+ * Pre-fix this module had a divergent, dead resolution path: its ONLY
+ * discovery lane was an HTTP GET against `/api/knowledge/bases` — a route
+ * shape that does not exist anywhere — its config lane was a stub service
+ * that always returned null, and a non-UUID project id (e.g. the atlas
+ * basename 'repository-collection') gated the whole thing into a FALSE 'offline' state.
+ *
+ * Now the knowledge-base discovery resolves through the SAME implementation
+ * the `knowledge` tool serves (ONE path — @vibesdotdev/knowledge's canonical
+ * semantic client, identity-scoped exactly like
+ * items/bases reads). State names are honest:
+ *  - 'explicit'  — caller-provided knowledgeBaseIds
+ *  - 'discovery' — bases found through the knowledge store
+ *  - 'none'      — discovery ran and found nothing
+ *  - 'disabled'  — caller set useKnowledgeApi: false
+ *  - 'project-binding' — project-owned role bindings from platform-web
+ * There is no 'offline': the local store does not need a network, and a
+ * missing project binding is represented by its own readiness snapshot.
+ *
+ * Binding policy (project-bound sessions):
+ *  - 'optional' (default) — bindings win only when ALL three roles are bound
+ *    ('ready'). While the binding is degraded/missing (including reads the
+ *    runtime cannot perform: local-only networking, provider absent, read
+ *    failed), resolution FALLS BACK to the prior explicit → project-ref →
+ *    discovery chain so adopting the binding table never empties a session's
+ *    knowledge context. The honest binding snapshot is persisted either way,
+ *    with a `reason` that distinguishes truly-unbound ('no-roles-bound') from
+ *    an unperformable read ('local-only-networking', 'binding-read-failed',
+ *    'binding-provider-unavailable').
+ *  - 'required' — init fails unless the binding is 'ready'. Local-only
+ *    networking cannot verify bindings, so required + local-only fails too.
+ * The binding read is a REMOTE lane and is skipped under local-only
+ * networking, exactly like project resolution; local discovery never is.
+ */
+import { CapabilityError, type ValueFreeFailure, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { SessionManager } from '../../manager/index.ts';
+import type { Session } from '../../schemas/index.ts';
+import type { SessionInitInput } from '../schemas/tools.ts';
+import type { McpToolContext } from '../types.ts';
+export declare const PROJECT_KNOWLEDGE_BINDING_ROLES: readonly ["dependencies", "rules", "codebase"];
+export type ProjectKnowledgeBindingRole = (typeof PROJECT_KNOWLEDGE_BINDING_ROLES)[number];
+export type KnowledgeBindingPolicy = 'required' | 'optional';
+export type KnowledgeBindingState = 'ready' | 'degraded' | 'missing';
+export type KnowledgeContextSource = 'explicit' | 'project-ref' | 'project-binding' | 'discovery' | 'none' | 'disabled';
+export interface KnowledgeBindingSnapshot {
+    projectId?: string;
+    state: KnowledgeBindingState;
+    policy: KnowledgeBindingPolicy;
+    roles: Partial<Record<ProjectKnowledgeBindingRole, string>>;
+    missingRoles: ProjectKnowledgeBindingRole[];
+    source: 'project-binding' | 'unbound' | 'disabled';
+    reason?: string;
+    /** Why a performable read failed (`binding-read-failed`, `binding-provider-failed`): value-free facts only. */
+    failure?: ValueFreeFailure;
+}
+type KnowledgeContextResolution = {
+    projectId?: string;
+    knowledgeBaseIds: string[];
+    missingKnowledgeBases: string[];
+    source: KnowledgeContextSource;
+    knowledgeBinding: KnowledgeBindingSnapshot;
+    workspacePath?: string;
+    /** Local knowledge-base discovery failed: carried value-free, never reported as 'none' silently. */
+    discoveryFailure?: ValueFreeFailure;
+};
+type SessionMetadata = Session['metadata'];
+/**
+ * A `required` binding policy refused: the project binding is not `ready`.
+ * Typed `PERMISSION_DENIED knowledge-binding-required`; `details` carries the
+ * value-free snapshot facts (project id, state, missing roles).
+ */
+export declare function knowledgeBindingRequired(snapshot: KnowledgeBindingSnapshot): CapabilityError;
+interface ApplyKnowledgeContextOptions {
+    workspacePath?: string;
+    projectIdOverride?: string;
+    knowledgeBaseIdsOverride?: string[];
+    /** The runtime the caller was handed. */
+    runtime: VibesRuntime;
+}
+export declare function applyKnowledgeContext(context: McpToolContext, sessionManager: SessionManager, sessionId: string, args: SessionInitInput, options: ApplyKnowledgeContextOptions): Promise<KnowledgeContextResolution & {
+    metadata: SessionMetadata;
+    knowledgeApiEnabled: boolean;
+    workspacePath?: string;
+    /** Project resolution over the API failed; init continued with the raw identifier. */
+    projectResolutionFailure?: ValueFreeFailure;
+}>;
+export {};
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/mcp/utils/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/mcp/utils/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAGH,OAAO,EACN,eAAe,EAGf,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,aAAa,CAAC;AASjE,eAAO,MAAM,+BAA+B,gDAAiD,CAAC;AAE9F,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3F,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,UAAU,CAAC;AAC7D,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AACrE,MAAM,MAAM,sBAAsB,GACjC,UAAU,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,YAAY,EAAE,2BAA2B,EAAE,CAAC;IAC5C,MAAM,EAAE,iBAAiB,GAAG,SAAS,GAAG,UAAU,CAAC;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+GAA+G;IAC/G,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAQD,KAAK,0BAA0B,GAAG;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oGAAoG;IACpG,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,KAAK,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAwS3C;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,eAAe,CAe5F;AA4CD,UAAU,4BAA4B;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IACpC,yCAAyC;IACzC,OAAO,EAAE,YAAY,CAAC;CACtB;AAuCD,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,4BAA4B,GACnC,OAAO,CACT,0BAA0B,GAAG;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,wBAAwB,CAAC,EAAE,gBAAgB,CAAC;CAC5C,CACD,CAsIA"}