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

package/dist/cli/scratchpad/session.scratchpad.search.impl.js

@@ -0,0 +1,29 @@
+import { parseCommandInput, runSessionCommand } from "../command.js";
+import { ScratchpadSearchCommandSchema } from "../schemas/commands.js";
+import { executeScratchpadSearch } from "../services/session.cli.consumer.js";
+import { writeSessionJson, writeSessionLines } from "../output.js";
+export default {
+    async execute(args, opts, commandContext) {
+        const input = parseCommandInput(ScratchpadSearchCommandSchema, { args, opts }, 'scratchpad search');
+        await runSessionCommand(commandContext, 'scratchpad search', async (context) => {
+            const result = await executeScratchpadSearch(input, context);
+            if (input.json) {
+                await writeSessionJson(context.runtime, result);
+                return;
+            }
+            if (result.results.length === 0) {
+                await writeSessionLines(context.runtime, [`No scratchpad entries found matching "${input.query}"`]);
+                return;
+            }
+            await writeSessionLines(context.runtime, [
+                `Found ${result.total} entry(ies) matching "${input.query}":`,
+                '',
+                ...result.results.flatMap((entry) => [
+                    `  ${entry.key}`,
+                    `  Type: ${entry.contentType} | Size: ${entry.contentLength} bytes`
+                ])
+            ]);
+        });
+    }
+};
+//# sourceMappingURL=session.scratchpad.search.impl.js.map

package/dist/cli/scratchpad/session.scratchpad.search.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.scratchpad.search.impl.js","sourceRoot":"","sources":["../../../src/cli/scratchpad/session.scratchpad.search.impl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEnE,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,IAAoB,EAAE,IAAoB,EAAE,cAA8B;QACvF,MAAM,KAAK,GAAG,iBAAiB,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACpG,MAAM,iBAAiB,CAAC,cAAc,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC9E,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE7D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAChD,OAAO;YACR,CAAC;YAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,yCAAyC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBACpG,OAAO;YACR,CAAC;YAED,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE;gBACxC,SAAS,MAAM,CAAC,KAAK,yBAAyB,KAAK,CAAC,KAAK,IAAI;gBAC7D,EAAE;gBACF,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACpC,KAAK,KAAK,CAAC,GAAG,EAAE;oBAChB,WAAW,KAAK,CAAC,WAAW,YAAY,KAAK,CAAC,aAAa,QAAQ;iBACnE,CAAC;aACF,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC"}

package/dist/cli/scratchpad/session.scratchpad.write.descriptor.d.ts

@@ -0,0 +1,4 @@
+import type { CLICommandAssetDescriptor } from '@vibesdotdev/cli/schemas/types';
+declare const descriptor: CLICommandAssetDescriptor;
+export default descriptor;
+//# sourceMappingURL=session.scratchpad.write.descriptor.d.ts.map

package/dist/cli/scratchpad/session.scratchpad.write.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.scratchpad.write.descriptor.d.ts","sourceRoot":"","sources":["../../../src/cli/scratchpad/session.scratchpad.write.descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAEhF,QAAA,MAAM,UAAU,EAAE,yBAoBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/scratchpad/session.scratchpad.write.descriptor.js

@@ -0,0 +1,23 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'session.scratchpad.write',
+    name: 'write',
+    description: 'Write to scratchpad',
+    group: 'session.scratchpad',
+    arguments: [{ name: 'key', description: 'Scratchpad key', required: true, variadic: false }],
+    options: [
+        { flags: '-c, --content <text>', description: 'Content (or use stdin)' },
+        {
+            flags: '-t, --content-type <type>',
+            description: 'Content type: text, markdown, json, code',
+            default: 'text'
+        },
+        { flags: '-e, --expires-in <minutes>', description: 'Expires in N minutes' },
+        { flags: '--tags <tags>', description: 'Tags (comma-separated)' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=session.scratchpad.write.descriptor.js.map

package/dist/cli/scratchpad/session.scratchpad.write.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.scratchpad.write.descriptor.js","sourceRoot":"","sources":["../../../src/cli/scratchpad/session.scratchpad.write.descriptor.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,qBAAqB;IAClC,KAAK,EAAE,oBAAoB;IAC3B,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC5F,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,wBAAwB,EAAE;QACxE;YACC,KAAK,EAAE,2BAA2B;YAClC,WAAW,EAAE,0CAA0C;YACvD,OAAO,EAAE,MAAM;SACf;QACD,EAAE,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,sBAAsB,EAAE;QAC5E,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,wBAAwB,EAAE;KACjE;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/cli/scratchpad/session.scratchpad.write.impl.d.ts

@@ -0,0 +1,6 @@
+import type { CommandContext, CommandOptions } from '@vibesdotdev/cli';
+declare const _default: {
+    execute(args: CommandOptions, opts: CommandOptions, commandContext: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=session.scratchpad.write.impl.d.ts.map

package/dist/cli/scratchpad/session.scratchpad.write.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.scratchpad.write.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/scratchpad/session.scratchpad.write.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;;kBAOlD,cAAc,QAAQ,cAAc,kBAAkB,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADzG,wBAYE"}

package/dist/cli/scratchpad/session.scratchpad.write.impl.js

@@ -0,0 +1,18 @@
+import { parseCommandInput, runSessionCommand } from "../command.js";
+import { ScratchpadWriteCommandSchema } from "../schemas/commands.js";
+import { executeScratchpadWrite } from "../services/session.cli.consumer.js";
+import { writeSessionJson, writeSessionLines } from "../output.js";
+export default {
+    async execute(args, opts, commandContext) {
+        const input = parseCommandInput(ScratchpadWriteCommandSchema, { args, opts }, 'scratchpad write');
+        await runSessionCommand(commandContext, 'scratchpad write', async (context) => {
+            const result = await executeScratchpadWrite(input, context);
+            if (input.json) {
+                await writeSessionJson(context.runtime, result);
+                return;
+            }
+            await writeSessionLines(context.runtime, [`\u2713 ${result.message}`]);
+        });
+    }
+};
+//# sourceMappingURL=session.scratchpad.write.impl.js.map

package/dist/cli/scratchpad/session.scratchpad.write.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.scratchpad.write.impl.js","sourceRoot":"","sources":["../../../src/cli/scratchpad/session.scratchpad.write.impl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEnE,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,IAAoB,EAAE,IAAoB,EAAE,cAA8B;QACvF,MAAM,KAAK,GAAG,iBAAiB,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,kBAAkB,CAAC,CAAC;QAClG,MAAM,iBAAiB,CAAC,cAAc,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC7E,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5D,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAChD,OAAO;YACR,CAAC;YACD,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,UAAU,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC"}

package/dist/cli/services/session/jobs.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CLI job tracking services.
+ */
+import type { SessionCLIContext } from '../session-cli-context.ts';
+import type { JobsListInput, JobsTrackInput } from '../../schemas/commands.ts';
+export declare function executeJobsList(input: JobsListInput, context: SessionCLIContext): Promise<{
+    jobs: {
+        id: string;
+        description: string;
+        createdAt: Date;
+        status: "cancelled" | "failed" | "deferred" | "pending" | "processing" | "completed";
+        jobId: string;
+        jobType: string;
+        queueName: string;
+        progress?: number | undefined;
+        completedAt?: Date | undefined;
+        duration?: number | undefined;
+    }[];
+    total: number;
+}>;
+export declare function executeJobsTrack(input: JobsTrackInput, context: SessionCLIContext): Promise<{
+    job: {
+        id: string;
+        sessionId: string;
+        jobId: string;
+        queueName: string;
+        jobType: string;
+        description: string;
+        status: "cancelled" | "failed" | "deferred" | "pending" | "processing" | "completed";
+        metadata: {
+            [x: string]: unknown;
+            priority?: "low" | "high" | "critical" | "normal" | undefined;
+            initiatedBy?: string | undefined;
+            todoId?: string | undefined;
+            participantId?: string | undefined;
+            retries?: number | undefined;
+            maxRetries?: number | undefined;
+            deferralAttempts?: number | undefined;
+            deferralExpiresAt?: Date | undefined;
+            deferralReason?: "missing_context" | "stale_context" | "pending_validation" | "circular_dependency" | "rate_limited" | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        progress?: number | undefined;
+        result?: {
+            [x: string]: unknown;
+            success?: boolean | undefined;
+            data?: unknown;
+            message?: string | undefined;
+            itemsProcessed?: number | undefined;
+            durationMs?: number | undefined;
+            custom?: Record<string, unknown> | undefined;
+        } | undefined;
+        error?: string | undefined;
+        startedAt?: Date | undefined;
+        completedAt?: Date | undefined;
+    };
+    message: string;
+}>;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/cli/services/session/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/jobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAW/E,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;GAUrF;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAavF"}

package/dist/cli/services/session/jobs.js

@@ -0,0 +1,36 @@
+/**
+ * CLI job tracking services.
+ */
+import { requireActiveSession } from "./refusals.js";
+/** The list filters a `jobs` input selects: `all` adds no status filter. */
+function jobListFilters(input) {
+    const filters = { limit: 100, offset: 0 };
+    if (input.status !== 'all')
+        filters.status = input.status;
+    if (input.jobType)
+        filters.jobType = input.jobType;
+    return filters;
+}
+export async function executeJobsList(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const filters = jobListFilters(input);
+    const [jobs, total] = await Promise.all([
+        session.getJobRefs(activeSession.id, filters),
+        session.countJobRefs(activeSession.id, filters)
+    ]);
+    return { jobs, total };
+}
+export async function executeJobsTrack(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const job = await session.addJobRef(activeSession.id, {
+        jobId: input.jobId,
+        jobType: input.jobType,
+        queueName: input.queueName,
+        description: input.description ?? `${input.queueName}:${input.jobType}:${input.jobId}`,
+        status: 'pending'
+    });
+    return { job, message: `Job ${input.jobId} tracked` };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/cli/services/session/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../../../src/cli/services/session/jobs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,4EAA4E;AAC5E,SAAS,cAAc,CAAC,KAAoB;IAC3C,MAAM,OAAO,GAAe,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1D,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IACnD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAoB,EAAE,OAA0B;IACrF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACvC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC;QAC7C,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC;KAC/C,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAqB,EAAE,OAA0B;IACvF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE1D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE;QACrD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE;QACtF,MAAM,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,KAAK,CAAC,KAAK,UAAU,EAAE,CAAC;AACvD,CAAC"}

package/dist/cli/services/session/participant.d.ts

@@ -0,0 +1,9 @@
+/**
+ * CLI participant identity helpers.
+ */
+import type { SessionCLIContext } from '../session-cli-context.ts';
+export declare function getOrCreateCliParticipantIdentity(context: SessionCLIContext, preferredId: string | undefined): Promise<{
+    participantId: string;
+    slug: string;
+}>;
+//# sourceMappingURL=participant.d.ts.map

package/dist/cli/services/session/participant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participant.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/participant.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAgCnE,wBAAsB,iCAAiC,CACtD,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoElD"}

package/dist/cli/services/session/participant.js

@@ -0,0 +1,93 @@
+/**
+ * CLI participant identity helpers.
+ */
+import { sanitizeSlugCandidate, ensureParticipantSlug, resolveParticipantReference } from "../../../mcp/utils/participant.js";
+import { cliBodyConnectionKey } from "../../../manager/cli-body-connection.js";
+const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Deterministic 8-hex digest of the full workspace path.
+ *
+ * The identity suffix used to be `randomUUID().slice(0, 8)` — a fresh value on
+ * EVERY invocation. That made the CLI participant unstable across processes, so
+ * `ensureParticipantSession` could never hit and every `vibes session init`
+ * minted a new participant AND a new session. Only the tail of the cwd was in
+ * the id, so two checkouts whose last path segment matched would otherwise
+ * collide; hashing the FULL path keeps them distinct while staying stable.
+ *
+ * FNV-1a, inline: this module is imported on universal paths and must not pull
+ * `node:crypto` in for an 8-character non-cryptographic label.
+ */
+function stableWorkspaceDigest(workspace) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < workspace.length; i++) {
+        hash ^= workspace.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return hash.toString(16).padStart(8, '0');
+}
+export async function getOrCreateCliParticipantIdentity(context, preferredId) {
+    const session = context.session;
+    const connectionKey = cliBodyConnectionKey(context.runtime);
+    if (!preferredId && connectionKey) {
+        const connected = await session.getParticipantByConnection(connectionKey);
+        if (connected) {
+            const ensured = await ensureParticipantSlug(session, connected.participantId, connected);
+            return { participantId: connected.participantId, slug: ensured.slug };
+        }
+    }
+    let participantId;
+    let resolvedSlug;
+    if (preferredId && UUID_REGEX.test(preferredId)) {
+        participantId = preferredId;
+    }
+    else if (preferredId) {
+        // Same slug scan MCP self-identification uses. Prefixing `participant-`
+        // skipped the existing seat: `--participant-id grok-tuna` minted
+        // `participant-grok-tuna` instead of reusing slug `grok-tuna`.
+        const resolved = await resolveParticipantReference(preferredId, session, null, {
+            registerIfMissing: true
+        });
+        participantId = resolved.participantId;
+        resolvedSlug = resolved.slug;
+    }
+    else {
+        const commandSegment = context.cli?.command.join('-') ?? 'cli';
+        // The participant is keyed on the workspace: an explicit `cli.cwd`, else
+        // the bound workspace (`runtime/workspace-path`). An unbound host fails
+        // with `workspace-unbound` rather than hashing an empty string (which
+        // would give every workspace the SAME digest, the FNV offset basis) or
+        // reading the process cwd.
+        const workspace = context.cli?.cwd ?? (await context.runtime.context('runtime/workspace-path'));
+        const workspaceSegment = workspace.split('/').pop() ?? 'workspace';
+        const slug = sanitizeSlugCandidate(`${commandSegment}-${workspaceSegment}-${stableWorkspaceDigest(workspace)}`);
+        participantId = `participant-cli-${slug}`;
+    }
+    const existing = await session.getParticipant(participantId);
+    if (!existing) {
+        const displayName = preferredId ? `CLI Participant (${participantId})` : 'CLI Participant';
+        await session.registerParticipant({
+            participantId,
+            name: displayName,
+            role: 'user',
+            capabilities: ['session-management', 'todo-tracking', 'planning'],
+            metadata: {
+                source: 'cli',
+                command: context.cli?.command,
+                cwd: context.cli?.cwd,
+                providedId: preferredId
+            }
+        });
+    }
+    const ensured = resolvedSlug
+        ? { slug: resolvedSlug }
+        : await ensureParticipantSlug(session, participantId, existing ?? undefined);
+    if (connectionKey) {
+        await session.recordConnection({
+            connectionId: connectionKey,
+            participantId,
+            clientName: 'Vibes CLI'
+        });
+    }
+    return { participantId, slug: ensured.slug };
+}
+//# sourceMappingURL=participant.js.map

package/dist/cli/services/session/participant.js.map

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

package/dist/cli/services/session/participants.d.ts

@@ -0,0 +1,84 @@
+/**
+ * CLI participant + message services.
+ */
+import type { SessionCLIContext } from '../session-cli-context.ts';
+import type { ParticipantsListInput, ChatListInput } from '../../schemas/commands.ts';
+export declare function executeParticipantsList(input: ParticipantsListInput, context: SessionCLIContext): Promise<{
+    participants: {
+        participantId: string;
+        name: string;
+        capabilities: string[];
+        preferences: {
+            [x: string]: unknown;
+            communicationStyle?: "concise" | "detailed" | "technical" | "casual" | undefined;
+            notifications?: boolean | undefined;
+            notificationChannels?: string[] | undefined;
+            language?: string | undefined;
+            timezone?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        metadata: {
+            [x: string]: unknown;
+            avatarUrl?: string | undefined;
+            bio?: string | undefined;
+            organization?: string | undefined;
+            team?: string | undefined;
+            slug?: string | undefined;
+            source?: string | undefined;
+            clientInfo?: {
+                name: string;
+                version?: string | undefined;
+                surface?: "cli" | "tui" | "mcp" | "bridge" | "web" | "acp" | undefined;
+                externalToolId?: string | undefined;
+                machineId?: string | undefined;
+                agentId?: string | undefined;
+                providerId?: string | undefined;
+                modelId?: string | undefined;
+                harnessSessionId?: string | undefined;
+            } | undefined;
+            transport?: "http" | "stdio" | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        lastSeenAt: Date;
+        role?: string | undefined;
+    }[];
+    total: number;
+}>;
+export declare function executeChatList(input: ChatListInput, context: SessionCLIContext): Promise<{
+    messages: {
+        id: string;
+        sessionId: string;
+        fromParticipant: string;
+        messageType: "request" | "info" | "transfer" | "question" | "answer";
+        content: string;
+        attachments: {
+            type: "file" | "knowledge" | "job" | "todo" | "scratchpad";
+            id: string;
+            metadata?: {
+                [x: string]: unknown;
+                displayName?: string | undefined;
+                fileSize?: number | undefined;
+                mimeType?: string | undefined;
+                preview?: string | undefined;
+                custom?: Record<string, unknown> | undefined;
+            } | undefined;
+        }[];
+        metadata: {
+            [x: string]: unknown;
+            priority?: "low" | "high" | "normal" | "urgent" | undefined;
+            threadId?: string | undefined;
+            replyToId?: string | undefined;
+            requiresAck?: boolean | undefined;
+            todoId?: string | undefined;
+            jobId?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        isRead: boolean;
+        createdAt: Date;
+        toParticipant?: string | undefined;
+        readAt?: Date | undefined;
+    }[];
+    total: number;
+}>;
+//# sourceMappingURL=participants.d.ts.map

package/dist/cli/services/session/participants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"participants.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/participants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAGtF,wBAAsB,uBAAuB,CAC5C,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAc1B;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBrF"}

package/dist/cli/services/session/participants.js

@@ -0,0 +1,33 @@
+/**
+ * CLI participant + message services.
+ */
+import { requireActiveSession } from "./refusals.js";
+export async function executeParticipantsList(input, context) {
+    const session = context.session;
+    const filters = {
+        limit: 100,
+        offset: 0,
+        active: input.isActive,
+        role: input.role,
+        search: input.search
+    };
+    const participants = await session.listParticipants(filters);
+    return { participants, total: participants.length };
+}
+export async function executeChatList(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const filters = {
+        limit: input.limit,
+        offset: 0,
+        fromParticipant: input.fromParticipant,
+        toParticipant: input.toParticipant,
+        isRead: input.unreadOnly ? false : undefined
+    };
+    const [messages, total] = await Promise.all([
+        session.getMessages(activeSession.id, filters),
+        session.countMessages(activeSession.id, filters)
+    ]);
+    return { messages, total };
+}
+//# sourceMappingURL=participants.js.map

package/dist/cli/services/session/participants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"participants.js","sourceRoot":"","sources":["../../../../src/cli/services/session/participants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,KAA4B,EAC5B,OAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAEhC,MAAM,OAAO,GAAuB;QACnC,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC;QACT,MAAM,EAAE,KAAK,CAAC,QAAQ;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAoB,EAAE,OAA0B;IACrF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAmB;QAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,CAAC;QACT,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAC5C,CAAC;IAEF,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC;QAC9C,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC;KAChD,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/cli/services/session/refusals.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The typed refusals the session CLI services raise. Each names the failure
+ * by code and reason; a message repeats only what the caller typed (a key, a
+ * todo or session id), never stored or adapter text.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { SessionManager } from '../../../manager/index.ts';
+import type { Session } from '../../../schemas/index.ts';
+/** `NOT_FOUND` / `no-active-session`: the command needs a bound session and there is none. */
+export declare function noActiveSession(): CapabilityError;
+/** The workspace's active session, or the `no-active-session` refusal. */
+export declare function requireActiveSession(session: SessionManager): Promise<Session>;
+/** `INVALID_INPUT` / `confirmation-required`: a destructive command was run without `--confirm`. */
+export declare function confirmationRequired(): CapabilityError;
+//# sourceMappingURL=refusals.d.ts.map

package/dist/cli/services/session/refusals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/refusals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,8FAA8F;AAC9F,wBAAgB,eAAe,IAAI,eAAe,CAKjD;AAED,0EAA0E;AAC1E,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAIpF;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,IAAI,eAAe,CAKtD"}

package/dist/cli/services/session/refusals.js

@@ -0,0 +1,28 @@
+/**
+ * The typed refusals the session CLI services raise. Each names the failure
+ * by code and reason; a message repeats only what the caller typed (a key, a
+ * todo or session id), never stored or adapter text.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+/** `NOT_FOUND` / `no-active-session`: the command needs a bound session and there is none. */
+export function noActiveSession() {
+    return new CapabilityError('No active session.', 'NOT_FOUND', {
+        reason: 'no-active-session',
+        recoveryHint: 'Run "vibes session init" to start or bind a session.'
+    });
+}
+/** The workspace's active session, or the `no-active-session` refusal. */
+export async function requireActiveSession(session) {
+    const active = await session.getActiveSession();
+    if (!active)
+        throw noActiveSession();
+    return active;
+}
+/** `INVALID_INPUT` / `confirmation-required`: a destructive command was run without `--confirm`. */
+export function confirmationRequired() {
+    return new CapabilityError('Confirmation required. Use --confirm.', 'INVALID_INPUT', {
+        reason: 'confirmation-required',
+        recoveryHint: 'Re-run the command with --confirm.'
+    });
+}
+//# sourceMappingURL=refusals.js.map

package/dist/cli/services/session/refusals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusals.js","sourceRoot":"","sources":["../../../../src/cli/services/session/refusals.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD,8FAA8F;AAC9F,MAAM,UAAU,eAAe;IAC9B,OAAO,IAAI,eAAe,CAAC,oBAAoB,EAAE,WAAW,EAAE;QAC7D,MAAM,EAAE,mBAAmB;QAC3B,YAAY,EAAE,sDAAsD;KACpE,CAAC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAuB;IACjE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,MAAM,eAAe,EAAE,CAAC;IACrC,OAAO,MAAM,CAAC;AACf,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,oBAAoB;IACnC,OAAO,IAAI,eAAe,CAAC,uCAAuC,EAAE,eAAe,EAAE;QACpF,MAAM,EAAE,uBAAuB;QAC/B,YAAY,EAAE,oCAAoC;KAClD,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/services/session/scratchpad.d.ts

@@ -0,0 +1,89 @@
+/**
+ * CLI scratchpad services.
+ */
+import type { SessionCLIContext } from '../session-cli-context.ts';
+import type { ScratchpadWriteInput, ScratchpadReadInput, ScratchpadListInput, ScratchpadSearchInput } from '../../schemas/commands.ts';
+export declare function executeScratchpadWrite(input: ScratchpadWriteInput, context: SessionCLIContext): Promise<{
+    entry: {
+        id: string;
+        sessionId: string;
+        key: string;
+        content: string;
+        contentType: "code" | "text" | "json" | "markdown";
+        tags: string[];
+        metadata: {
+            [x: string]: unknown;
+            source?: string | undefined;
+            version?: string | undefined;
+            filePath?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            todoId?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        language?: string | undefined;
+        expiresAt?: Date | undefined;
+    };
+    message: string;
+}>;
+export declare function executeScratchpadRead(input: ScratchpadReadInput, context: SessionCLIContext): Promise<{
+    entry: {
+        id: string;
+        sessionId: string;
+        key: string;
+        content: string;
+        contentType: "code" | "text" | "json" | "markdown";
+        tags: string[];
+        metadata: {
+            [x: string]: unknown;
+            source?: string | undefined;
+            version?: string | undefined;
+            filePath?: string | undefined;
+            lineRange?: {
+                start: number;
+                end: number;
+            } | undefined;
+            todoId?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        language?: string | undefined;
+        expiresAt?: Date | undefined;
+    };
+}>;
+export declare function executeScratchpadList(input: ScratchpadListInput, context: SessionCLIContext): Promise<{
+    entries: {
+        key: string;
+        id: string;
+        createdAt: Date;
+        tags: string[];
+        updatedAt: Date;
+        contentType: "code" | "text" | "json" | "markdown";
+        contentLength: number;
+        preview: string;
+        expiresAt?: Date | undefined;
+        language?: string | undefined;
+    }[];
+    total: number;
+}>;
+export declare function executeScratchpadSearch(input: ScratchpadSearchInput, context: SessionCLIContext): Promise<{
+    results: {
+        key: string;
+        id: string;
+        createdAt: Date;
+        tags: string[];
+        updatedAt: Date;
+        contentType: "code" | "text" | "json" | "markdown";
+        contentLength: number;
+        preview: string;
+        expiresAt?: Date | undefined;
+        language?: string | undefined;
+    }[];
+    total: number;
+}>;
+//# sourceMappingURL=scratchpad.d.ts.map

package/dist/cli/services/session/scratchpad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/scratchpad.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EACX,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,MAAM,2BAA2B,CAAC;AAGnC,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;GAyB1B;AAED,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;GAc1B;AASD,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;GAW1B;AAED,wBAAsB,uBAAuB,CAC5C,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;GAW1B"}