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

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 VIBES DEV LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,70 @@
-# Temporary Holding Version
+# @vibesdotdev/session
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Session coordination primitives for Vibes clients, tools, and local development workflows.
+
+This package is part of the public Vibes framework package set. The source repository is private while the public repository split is being prepared, so package documentation is published on the Vibes docs site.
+
+## Install
+
+```sh
+bun add @vibesdotdev/session
+# or
+npm install @vibesdotdev/session
+```
+
+## Runtime ownership
+
+Compose a session plugin with storage and logging. The plugin
+registers `runtime/client:session` and activates its transport owner.
+Resolve `getVibesClient<SessionClient>('session', runtime)` for the semantic
+client, or keep using `runtime.context('session/manager')` and
+`getVibesSessionManagerAsync(runtime)` for the same manager.
+
+The kernel constructs the client per lifecycle; its manager and connection
+handles are root state shared by every view, generation and fork of one root.
+Independent roots have separate managers and connection handles. Manager
+initialization is lazy and retryable; runtime disposal closes both resources.
+Synchronous `mcpSessionRegistryFor(runtime)` requires plugin activation and
+refuses `session-client-unavailable` when no active owner exists. Fabricated
+runtimes refuse `session-runtime-unidentified`.
+
+## Plugin surfaces
+
+| Import | Use |
+| --- | --- |
+| `@vibesdotdev/session/plugin` or `/consumer.plugin` | Compatible full consumer composition: shared capabilities, consumer init, knowledge source, CLI commands and binding restoration. |
+| `@vibesdotdev/session/core.plugin` or `/browser.plugin` | Scope-neutral capabilities without consumer or CLI loaders. |
+| `@vibesdotdev/session/cloud.plugin` | Core plus cloud init's typed `UNAVAILABLE / session-init-consumer-required` refusal. |
+| `@vibesdotdev/session/cli/plugin` | CLI additions when composing slices explicitly, after a session capability plugin. |
+| `@vibesdotdev/session/tui/plugin` | Sessions list/detail, open command and registry state; also compose the TUI owner. |
+| `@vibesdotdev/session/svelte/plugin` | Session tool-call widgets for Svelte hosts. |
+
+Choose one capability composition per host; each keeps plugin id `session`.
+Core retains tools, eleven storage records, events, the scope subscription,
+backup target and docs. Hosts supply their storage adapters. Browser and cloud
+bundles should select their narrow slice; runtime scope tags alone cannot stop
+a bundler from traversing a consumer loader.
+
+The TUI loads detail collections when their tab opens, offers no resume controls for archived sessions, ignores action shortcuts while text entry owns focus,
+and pauses the selected session by id. Workflow Monitor receives the selected
+session's route context.
+
+## Verify locally
+
+Run `bun run check`, `bun test`, and `bun run build` in the package. The checking
+project includes all source TypeScript and TSX, including tests and Svelte-side
+TypeScript. Core emission excludes tests and Svelte; Svelte has a separate
+packaging config. Tests use disposable homes and real composed session owners;
+HTTP isolation and handler behavior dispatch registered tools with real identity
+resolution. Knowledge discovery uses its semantic client without minting defaults;
+enrichment uses its registered search tool and reports degraded local results.
+See [SPEC.md](SPEC.md#verification) for rules and lint commands.
+
+## Documentation
+
+- Package guide: https://docs.vibes.dev/session
+- Vibes docs: https://docs.vibes.dev
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/backup/session.sessions.target.descriptor.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Backup target — the session store (`sessions.db`).
+ *
+ * Rooms (`sessions`), their messages (`participant_messages`) and scratchpads
+ * (`scratchpad_entries`) live here. Session owns the database, so session
+ * registers its `backup/target`; storage's daily `backup.snapshot` job
+ * enumerates the kind and snapshots it on the same schedule, verify step and
+ * rotation as the presence and awareness targets.
+ *
+ * Declared as data: the runtime holds the descriptor until storage's backup
+ * plugin registers the `backup/target` kind, so session takes no runtime edge
+ * on the backup plugin.
+ */
+export declare const SESSION_BACKUP_TARGET_ID = "session.sessions";
+export declare const sessionBackupTargetDescriptor: {
+    kind: "backup/target";
+    id: string;
+    name: string;
+    owner: string;
+    source: {
+        kind: "file" | "directory" | "sqlite";
+        path: string;
+        sidecars: string[];
+        required: boolean;
+        agentHomes?: {
+            root: string;
+            marker: string;
+        } | undefined;
+    };
+    rotation: {
+        keepDaily: number;
+        keepWeekly: number;
+        keepMonthly: number;
+        keepForever: boolean;
+    };
+    verify: {
+        requiredTables: string[];
+        minRows?: number | undefined;
+    };
+    tags: string[];
+    enabled: boolean;
+    description?: string | undefined;
+    destinationDir?: string | undefined;
+    preflight?: string[] | undefined;
+};
+export default sessionBackupTargetDescriptor;
+//# sourceMappingURL=session.sessions.target.descriptor.d.ts.map

package/dist/backup/session.sessions.target.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.sessions.target.descriptor.d.ts","sourceRoot":"","sources":["../../src/backup/session.sessions.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,eAAO,MAAM,wBAAwB,qBAAqB,CAAC;AAE3D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBxC,CAAC;AAEH,eAAe,6BAA6B,CAAC"}

package/dist/backup/session.sessions.target.descriptor.js

@@ -0,0 +1,41 @@
+/**
+ * Backup target — the session store (`sessions.db`).
+ *
+ * Rooms (`sessions`), their messages (`participant_messages`) and scratchpads
+ * (`scratchpad_entries`) live here. Session owns the database, so session
+ * registers its `backup/target`; storage's daily `backup.snapshot` job
+ * enumerates the kind and snapshots it on the same schedule, verify step and
+ * rotation as the presence and awareness targets.
+ *
+ * Declared as data: the runtime holds the descriptor until storage's backup
+ * plugin registers the `backup/target` kind, so session takes no runtime edge
+ * on the backup plugin.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export const SESSION_BACKUP_TARGET_ID = 'session.sessions';
+export const sessionBackupTargetDescriptor = createRuntimeAsset({
+    kind: 'backup/target',
+    id: SESSION_BACKUP_TARGET_ID,
+    name: 'Session Store',
+    description: 'Rooms, messages and scratchpads (sessions.db)',
+    owner: 'session',
+    source: {
+        kind: 'sqlite',
+        path: '{vibesHome}/sessions.db',
+        sidecars: [],
+        required: false
+    },
+    rotation: {
+        keepDaily: 7,
+        keepWeekly: 4,
+        keepMonthly: 6,
+        keepForever: false
+    },
+    verify: {
+        requiredTables: ['sessions', 'participant_messages', 'scratchpad_entries']
+    },
+    tags: ['session', 'rooms', 'messages', 'scratchpads', 'priority:high'],
+    enabled: true
+});
+export default sessionBackupTargetDescriptor;
+//# sourceMappingURL=session.sessions.target.descriptor.js.map

package/dist/backup/session.sessions.target.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.sessions.target.descriptor.js","sourceRoot":"","sources":["../../src/backup/session.sessions.target.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAyB;IACvF,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,+CAA+C;IAC5D,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,yBAAyB;QAC/B,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,KAAK;KACf;IACD,QAAQ,EAAE;QACT,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;QACb,WAAW,EAAE,CAAC;QACd,WAAW,EAAE,KAAK;KAClB;IACD,MAAM,EAAE;QACP,cAAc,EAAE,CAAC,UAAU,EAAE,sBAAsB,EAAE,oBAAoB,CAAC;KAC1E;IACD,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,CAAC;IACtE,OAAO,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,eAAe,6BAA6B,CAAC"}

package/dist/cli/chat/session.chat.descriptor.d.ts

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

package/dist/cli/chat/session.chat.descriptor.d.ts.map

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

package/dist/cli/chat/session.chat.descriptor.js

@@ -0,0 +1,19 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'session.chat',
+    name: 'chat',
+    description: 'View participant messages',
+    group: 'session',
+    options: [
+        { flags: '--from <participant>', description: 'Filter by sender' },
+        { flags: '--to <participant>', description: 'Filter by recipient' },
+        { flags: '--unread-only', description: 'Show only unread messages' },
+        { flags: '-l, --limit <number>', description: 'Limit results', default: '50' },
+        { flags: '--json', description: 'Output as JSON' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=session.chat.descriptor.js.map

package/dist/cli/chat/session.chat.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.chat.descriptor.js","sourceRoot":"","sources":["../../../src/cli/chat/session.chat.descriptor.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,2BAA2B;IACxC,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,kBAAkB,EAAE;QAClE,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,qBAAqB,EAAE;QACnE,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,2BAA2B,EAAE;QACpE,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE;QAC9E,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KAClD;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/chat/session.chat.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.chat.impl.d.ts.map

package/dist/cli/chat/session.chat.impl.d.ts.map

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

package/dist/cli/chat/session.chat.impl.js

@@ -0,0 +1,37 @@
+import { parseCommandInput, runSessionCommand } from "../command.js";
+import { ChatListCommandSchema } from "../schemas/commands.js";
+import { executeChatList } from "../services/session.cli.consumer.js";
+import { formatDisplayDate } from "../display.js";
+import { writeSessionJson, writeSessionLines } from "../output.js";
+function messageLines(message) {
+    const readIcon = message.isRead ? '  ' : '● ';
+    const excerpt = `${message.content.slice(0, 100)}${message.content.length > 100 ? '...' : ''}`;
+    return [
+        `${readIcon}From: ${message.fromParticipant} → To: ${message.toParticipant}`,
+        `  Type: ${message.messageType} | ${formatDisplayDate(message.createdAt)}`,
+        `  ${excerpt}`,
+        ''
+    ];
+}
+export default {
+    async execute(args, opts, commandContext) {
+        const input = parseCommandInput(ChatListCommandSchema, { args, opts }, 'chat');
+        await runSessionCommand(commandContext, 'chat', async (context) => {
+            const result = await executeChatList(input, context);
+            if (input.json) {
+                await writeSessionJson(context.runtime, result);
+                return;
+            }
+            if (result.messages.length === 0) {
+                await writeSessionLines(context.runtime, ['No messages found']);
+                return;
+            }
+            await writeSessionLines(context.runtime, [
+                `Found ${result.total} message(s):`,
+                '',
+                ...result.messages.flatMap(messageLines)
+            ]);
+        });
+    }
+};
+//# sourceMappingURL=session.chat.impl.js.map

package/dist/cli/chat/session.chat.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.chat.impl.js","sourceRoot":"","sources":["../../../src/cli/chat/session.chat.impl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,SAAS,YAAY,CAAC,OAA2B;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC/F,OAAO;QACN,GAAG,QAAQ,SAAS,OAAO,CAAC,eAAe,UAAU,OAAO,CAAC,aAAa,EAAE;QAC5E,WAAW,OAAO,CAAC,WAAW,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAC1E,KAAK,OAAO,EAAE;QACd,EAAE;KACF,CAAC;AACH,CAAC;AAED,eAAe;IACd,KAAK,CAAC,OAAO,CAAC,IAAoB,EAAE,IAAoB,EAAE,cAA8B;QACvF,MAAM,KAAK,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/E,MAAM,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAErD,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,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBAChE,OAAO;YACR,CAAC;YAED,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE;gBACxC,SAAS,MAAM,CAAC,KAAK,cAAc;gBACnC,EAAE;gBACF,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;aACxC,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC"}

package/dist/cli/chat/session.jobs.descriptor.d.ts

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

package/dist/cli/chat/session.jobs.descriptor.d.ts.map

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

package/dist/cli/chat/session.jobs.descriptor.js

@@ -0,0 +1,17 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'session.jobs',
+    name: 'jobs',
+    description: 'List tracked jobs',
+    group: 'session',
+    options: [
+        { flags: '-s, --status <status>', description: 'Filter by status', default: 'all' },
+        { flags: '-t, --job-type <type>', description: 'Filter by job type' },
+        { flags: '--json', description: 'Output as JSON' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=session.jobs.descriptor.js.map

package/dist/cli/chat/session.jobs.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.jobs.descriptor.js","sourceRoot":"","sources":["../../../src/cli/chat/session.jobs.descriptor.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,mBAAmB;IAChC,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;QACnF,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACrE,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KAClD;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/chat/session.jobs.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.jobs.impl.d.ts.map

package/dist/cli/chat/session.jobs.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.jobs.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/chat/session.jobs.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,wBA0BE"}

package/dist/cli/chat/session.jobs.impl.js

@@ -0,0 +1,29 @@
+import { parseCommandInput, runSessionCommand } from "../command.js";
+import { JobsListCommandSchema } from "../schemas/commands.js";
+import { executeJobsList } from "../services/session.cli.consumer.js";
+import { writeSessionJson, writeSessionLines } from "../output.js";
+export default {
+    async execute(args, opts, commandContext) {
+        const input = parseCommandInput(JobsListCommandSchema, { args, opts }, 'jobs');
+        await runSessionCommand(commandContext, 'jobs', async (context) => {
+            const result = await executeJobsList(input, context);
+            if (input.json) {
+                await writeSessionJson(context.runtime, result);
+                return;
+            }
+            if (result.jobs.length === 0) {
+                await writeSessionLines(context.runtime, ['No tracked jobs']);
+                return;
+            }
+            await writeSessionLines(context.runtime, [
+                `Found ${result.total} job(s):`,
+                '',
+                ...result.jobs.flatMap((job) => [
+                    `  ${job.jobId} - ${job.description || 'No description'}`,
+                    `  Type: ${job.jobType} | Queue: ${job.queueName} | Status: ${job.status}`
+                ])
+            ]);
+        });
+    }
+};
+//# sourceMappingURL=session.jobs.impl.js.map

package/dist/cli/chat/session.jobs.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.jobs.impl.js","sourceRoot":"","sources":["../../../src/cli/chat/session.jobs.impl.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,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,qBAAqB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/E,MAAM,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACjE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAErD,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,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAC9D,OAAO;YACR,CAAC;YAED,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE;gBACxC,SAAS,MAAM,CAAC,KAAK,UAAU;gBAC/B,EAAE;gBACF,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC;oBAC/B,KAAK,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,WAAW,IAAI,gBAAgB,EAAE;oBACzD,WAAW,GAAG,CAAC,OAAO,aAAa,GAAG,CAAC,SAAS,cAAc,GAAG,CAAC,MAAM,EAAE;iBAC1E,CAAC;aACF,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC"}

package/dist/cli/chat/session.participants.descriptor.d.ts

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

package/dist/cli/chat/session.participants.descriptor.d.ts.map

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

package/dist/cli/chat/session.participants.descriptor.js

@@ -0,0 +1,18 @@
+const descriptor = {
+    kind: 'cli/command',
+    id: 'session.participants',
+    name: 'participants',
+    description: 'List participants',
+    group: 'session',
+    options: [
+        { flags: '--active-only', description: 'Show only active participants' },
+        { flags: '--role <role>', description: 'Filter participants by role' },
+        { flags: '--search <query>', description: 'Search participants by name or ID' },
+        { flags: '--json', description: 'Output as JSON' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+};
+export default descriptor;
+//# sourceMappingURL=session.participants.descriptor.js.map

package/dist/cli/chat/session.participants.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.participants.descriptor.js","sourceRoot":"","sources":["../../../src/cli/chat/session.participants.descriptor.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,GAA8B;IAC7C,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,mBAAmB;IAChC,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,+BAA+B,EAAE;QACxE,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,6BAA6B,EAAE;QACtE,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,mCAAmC,EAAE;QAC/E,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;KAClD;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/chat/session.participants.impl.d.ts

@@ -0,0 +1,12 @@
+import type { CommandContext, CommandOptions } from '@vibesdotdev/cli';
+import type { ParticipantProfile } from '../../schemas/index.ts';
+import { type DisplayTimestamp } from '../display.ts';
+type ParticipantForDisplay = Omit<ParticipantProfile, 'lastSeenAt'> & {
+    lastSeenAt: DisplayTimestamp;
+};
+export declare function formatParticipantLines(participant: ParticipantForDisplay, nowMs?: number): string[];
+declare const _default: {
+    execute(args: CommandOptions, opts: CommandOptions, commandContext: CommandContext): Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=session.participants.impl.d.ts.map

package/dist/cli/chat/session.participants.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.participants.impl.d.ts","sourceRoot":"","sources":["../../../src/cli/chat/session.participants.impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMxE,KAAK,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,GAAG;IACrE,UAAU,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF,wBAAgB,sBAAsB,CACrC,WAAW,EAAE,qBAAqB,EAClC,KAAK,SAAa,GAChB,MAAM,EAAE,CAUV;;kBAGoB,cAAc,QAAQ,cAAc,kBAAkB,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AADzG,wBAuBE"}

package/dist/cli/chat/session.participants.impl.js

@@ -0,0 +1,37 @@
+import { parseCommandInput, runSessionCommand } from "../command.js";
+import { ParticipantsListCommandSchema } from "../schemas/commands.js";
+import { executeParticipantsList } from "../services/session.cli.consumer.js";
+import { parseDisplayDate } from "../display.js";
+import { writeSessionJson, writeSessionLines } from "../output.js";
+export function formatParticipantLines(participant, nowMs = Date.now()) {
+    const lastSeenAt = parseDisplayDate(participant.lastSeenAt);
+    const isActive = lastSeenAt ? nowMs - lastSeenAt.getTime() < 5 * 60 * 1000 : false;
+    const lastSeenLabel = lastSeenAt ? lastSeenAt.toLocaleString() : 'unknown';
+    return [
+        `  ${participant.participantId} - ${participant.name}`,
+        `  Role: ${participant.role || 'N/A'} | Active: ${isActive}`,
+        `  Last seen: ${lastSeenLabel}`
+    ];
+}
+export default {
+    async execute(args, opts, commandContext) {
+        const input = parseCommandInput(ParticipantsListCommandSchema, { args, opts }, 'participants');
+        await runSessionCommand(commandContext, 'participants', async (context) => {
+            const result = await executeParticipantsList(input, context);
+            if (input.json) {
+                await writeSessionJson(context.runtime, result);
+                return;
+            }
+            if (result.participants.length === 0) {
+                await writeSessionLines(context.runtime, ['No participants found']);
+                return;
+            }
+            await writeSessionLines(context.runtime, [
+                `Found ${result.total} participant(s):`,
+                '',
+                ...result.participants.flatMap((participant) => formatParticipantLines(participant))
+            ]);
+        });
+    }
+};
+//# sourceMappingURL=session.participants.impl.js.map

package/dist/cli/chat/session.participants.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.participants.impl.js","sourceRoot":"","sources":["../../../src/cli/chat/session.participants.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;AAE9E,OAAO,EAAE,gBAAgB,EAAyB,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASnE,MAAM,UAAU,sBAAsB,CACrC,WAAkC,EAClC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE;IAElB,MAAM,UAAU,GAAG,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACnF,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,OAAO;QACN,KAAK,WAAW,CAAC,aAAa,MAAM,WAAW,CAAC,IAAI,EAAE;QACtD,WAAW,WAAW,CAAC,IAAI,IAAI,KAAK,cAAc,QAAQ,EAAE;QAC5D,gBAAgB,aAAa,EAAE;KAC/B,CAAC;AACH,CAAC;AAED,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,cAAc,CAAC,CAAC;QAC/F,MAAM,iBAAiB,CAAC,cAAc,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACzE,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,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC,CAAC;gBACpE,OAAO;YACR,CAAC;YAED,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE;gBACxC,SAAS,MAAM,CAAC,KAAK,kBAAkB;gBACvC,EAAE;gBACF,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;aACpF,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACJ,CAAC;CACD,CAAC"}

package/dist/cli/command.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The one failure boundary for `vibes session …` command impls.
+ *
+ * A command never catches and prints. Its input is parsed once at the
+ * Commander boundary ({@link parseCommandInput}: a malformed flag is a typed
+ * `INVALID_INPUT` naming only the field paths and the schema's own messages,
+ * never the value), and its body runs inside {@link runSessionCommand}: a
+ * typed `CapabilityError` from below passes through unchanged, so the CLI's
+ * failure renderer prints its code, reason and exit code; anything else
+ * becomes a value-free `INTERNAL` failure that keeps the original as `cause`
+ * (rendered, redacted, only under `-v`). Raw storage or adapter text never
+ * reaches the terminal, and a failure never exits 0.
+ */
+import type { CommandContext } from '@vibesdotdev/cli';
+import type * as z from 'zod/v4';
+import { type SessionCLIContext } from './services/session-cli-context.ts';
+/** The `vibes session …` commands, as their path after `session`. */
+export type SessionCommandName = 'init' | 'status' | 'list' | 'pause' | 'resume' | 'archive' | 'search' | 'chat' | 'jobs' | 'participants' | 'todo add' | 'todo complete' | 'todo list' | 'todo tree' | 'todo update' | 'scratchpad list' | 'scratchpad read' | 'scratchpad search' | 'scratchpad write';
+/** The arguments and options Commander handed one command, merged (options win on a shared name). */
+export interface CommandInvocation {
+    readonly args: object;
+    readonly opts: object;
+}
+/** A command's two input schemas: its Commander flags (converted, renamed) and the service input they become. */
+export interface SessionCommandSchemas<Input extends z.ZodType> {
+    readonly flags: z.ZodType;
+    readonly input: Input;
+}
+/**
+ * Parse a command's Commander input: its flags schema reads and converts the
+ * declared flags, then the service input schema parses the result. Either
+ * failure is `INVALID_INPUT` / `invalid-command-input`: the message lists
+ * each failing field path with the schema's message (Zod's messages name the
+ * expected shape, not the received value), and `details.fields` lists the
+ * paths.
+ */
+export declare function parseCommandInput<Input extends z.ZodType>(schemas: SessionCommandSchemas<Input>, invocation: CommandInvocation, command: SessionCommandName): z.output<Input>;
+/**
+ * Run one command body against the session manager of the command's runtime.
+ * A typed failure passes through; any other failure is reported as
+ * `INTERNAL` / `session-command-failed` with the original kept as `cause`.
+ */
+export declare function runSessionCommand(commandContext: CommandContext, command: SessionCommandName, run: (context: SessionCLIContext) => Promise<void>): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,KAAK,CAAC,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAC3B,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,MAAM,GACN,MAAM,GACN,cAAc,GACd,UAAU,GACV,eAAe,GACf,WAAW,GACX,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,CAAC;AAEtB,qGAAqG;AACrG,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,iHAAiH;AACjH,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO;IAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,EACxD,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,EACrC,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,kBAAkB,GACzB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAWjB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,cAAc,EAAE,cAAc,EAC9B,OAAO,EAAE,kBAAkB,EAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/cli/command.js

@@ -0,0 +1,57 @@
+/**
+ * The one failure boundary for `vibes session …` command impls.
+ *
+ * A command never catches and prints. Its input is parsed once at the
+ * Commander boundary ({@link parseCommandInput}: a malformed flag is a typed
+ * `INVALID_INPUT` naming only the field paths and the schema's own messages,
+ * never the value), and its body runs inside {@link runSessionCommand}: a
+ * typed `CapabilityError` from below passes through unchanged, so the CLI's
+ * failure renderer prints its code, reason and exit code; anything else
+ * becomes a value-free `INTERNAL` failure that keeps the original as `cause`
+ * (rendered, redacted, only under `-v`). Raw storage or adapter text never
+ * reaches the terminal, and a failure never exits 0.
+ */
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { getSessionCLIContext } from "./services/session-cli-context.js";
+/**
+ * Parse a command's Commander input: its flags schema reads and converts the
+ * declared flags, then the service input schema parses the result. Either
+ * failure is `INVALID_INPUT` / `invalid-command-input`: the message lists
+ * each failing field path with the schema's message (Zod's messages name the
+ * expected shape, not the received value), and `details.fields` lists the
+ * paths.
+ */
+export function parseCommandInput(schemas, invocation, command) {
+    const flags = schemas.flags.safeParse({ ...invocation.args, ...invocation.opts });
+    const parsed = flags.success ? schemas.input.safeParse(flags.data) : flags;
+    if (parsed.success)
+        return parsed.data;
+    const fields = parsed.error.issues.map((issue) => issue.path.map(String).join('.') || '(input)');
+    const problems = parsed.error.issues.map((issue, index) => `${fields[index]}: ${issue.message}`);
+    throw new CapabilityError(`Invalid input for vibes session ${command}: ${problems.join('; ')}`, 'INVALID_INPUT', {
+        reason: 'invalid-command-input',
+        recoveryHint: `Run "vibes session ${command} --help" for the accepted flags.`,
+        details: { command, fields: fields.join(',') }
+    });
+}
+/**
+ * Run one command body against the session manager of the command's runtime.
+ * A typed failure passes through; any other failure is reported as
+ * `INTERNAL` / `session-command-failed` with the original kept as `cause`.
+ */
+export async function runSessionCommand(commandContext, command, run) {
+    try {
+        await run(await getSessionCLIContext(commandContext.runtime));
+    }
+    catch (error) {
+        if (isCapabilityError(CaughtFailureSchema.parse(error)))
+            throw error;
+        throw new CapabilityError(`vibes session ${command} failed.`, 'INTERNAL', {
+            reason: 'session-command-failed',
+            recoveryHint: 'Re-run with -v to see the underlying failure.',
+            details: { command },
+            cause: error
+        });
+    }
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,OAAO,EAAE,oBAAoB,EAA0B,MAAM,mCAAmC,CAAC;AAoCjG;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAqC,EACrC,UAA6B,EAC7B,OAA2B;IAE3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC3E,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjG,MAAM,IAAI,eAAe,CAAC,mCAAmC,OAAO,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,EAAE;QAChH,MAAM,EAAE,uBAAuB;QAC/B,YAAY,EAAE,sBAAsB,OAAO,kCAAkC;QAC7E,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;KAC9C,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,cAA8B,EAC9B,OAA2B,EAC3B,GAAkD;IAElD,IAAI,CAAC;QACJ,MAAM,GAAG,CAAC,MAAM,oBAAoB,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAAE,MAAM,KAAK,CAAC;QACrE,MAAM,IAAI,eAAe,CAAC,iBAAiB,OAAO,UAAU,EAAE,UAAU,EAAE;YACzE,MAAM,EAAE,wBAAwB;YAChC,YAAY,EAAE,+CAA+C;YAC7D,OAAO,EAAE,EAAE,OAAO,EAAE;YACpB,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;AACF,CAAC"}

package/dist/cli/display.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Display helpers shared by the session command impls.
+ */
+/** A stored timestamp as a command prints it: a `Date`, or the ISO string / epoch number storage round-trips it as. */
+export type DisplayTimestamp = Date | string | number;
+/** The instant a stored timestamp names, or `null` when it names none. */
+export declare function parseDisplayDate(value: DisplayTimestamp): Date | null;
+/** A stored timestamp in the user's locale, or `unknown` when it names no instant. */
+export declare function formatDisplayDate(value: DisplayTimestamp): string;
+//# sourceMappingURL=display.d.ts.map

package/dist/cli/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/cli/display.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,uHAAuH;AACvH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAKtD,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAGrE;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAEjE"}

package/dist/cli/display.js

@@ -0,0 +1,16 @@
+/**
+ * Display helpers shared by the session command impls.
+ */
+import * as z from 'zod/v4';
+/** A valid instant from any stored timestamp form; an unparseable value or an invalid date fails. */
+const DisplayDateSchema = z.union([z.date(), z.string(), z.number()]).pipe(z.coerce.date());
+/** The instant a stored timestamp names, or `null` when it names none. */
+export function parseDisplayDate(value) {
+    const parsed = DisplayDateSchema.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+/** A stored timestamp in the user's locale, or `unknown` when it names no instant. */
+export function formatDisplayDate(value) {
+    return parseDisplayDate(value)?.toLocaleString() ?? 'unknown';
+}
+//# sourceMappingURL=display.js.map

package/dist/cli/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/cli/display.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAK5B,qGAAqG;AACrG,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AAE5F,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAAC,KAAuB;IACvD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,KAAuB;IACxD,OAAO,gBAAgB,CAAC,KAAK,CAAC,EAAE,cAAc,EAAE,IAAI,SAAS,CAAC;AAC/D,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Session CLI
+ * Command-line interface for session management
+ */
+export { SessionInitInputSchema, SessionStatusInputSchema, SessionListInputSchema, SessionResumeInputSchema, SessionPauseInputSchema, SessionArchiveInputSchema, SessionSearchInputSchema, TodoAddInputSchema, TodoListInputSchema, TodoCompleteInputSchema, TodoUpdateInputSchema, TodoTreeInputSchema, ScratchpadWriteInputSchema, ScratchpadReadInputSchema, ScratchpadListInputSchema, ScratchpadSearchInputSchema, JobsListInputSchema, JobsTrackInputSchema, ParticipantsListInputSchema, ChatListInputSchema } from './schemas/commands.ts';
+export type { SessionInitInput, SessionStatusInput, SessionListInput, SessionResumeInput, SessionPauseInput, SessionArchiveInput, SessionSearchInput, TodoAddInput, TodoListInput, TodoCompleteInput, TodoUpdateInput, TodoTreeInput, ScratchpadWriteInput, ScratchpadReadInput, ScratchpadListInput, ScratchpadSearchInput, JobsListInput, JobsTrackInput, ParticipantsListInput, ChatListInput } from './schemas/commands.ts';
+export { executeSessionInit, executeSessionStatus, executeSessionList, executeSessionResume, executeSessionPause, executeSessionArchive, executeSessionSearch, executeTodoAdd, executeTodoList, executeTodoComplete, executeTodoUpdate, executeTodoTree, executeScratchpadWrite, executeScratchpadRead, executeScratchpadList, executeScratchpadSearch, executeJobsList, executeJobsTrack, executeParticipantsList, executeChatList } from './services/session.cli.consumer.ts';
+//# sourceMappingURL=index.d.ts.map