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

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

@@ -0,0 +1,63 @@
+/**
+ * CLI scratchpad services.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { detectContentType } from "../../../schemas/scratchpad.js";
+import { requireActiveSession } from "./refusals.js";
+export async function executeScratchpadWrite(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    if (!input.content) {
+        throw new CapabilityError('Content required (use --content or pipe via stdin).', 'INVALID_INPUT', {
+            reason: 'scratchpad-content-required'
+        });
+    }
+    const expiresAt = input.expiresIn
+        ? new Date(Date.now() + input.expiresIn * 60 * 1000)
+        : undefined;
+    const contentType = input.contentType ?? detectContentType(input.content);
+    const entry = await session.writeScratchpad(activeSession.id, {
+        key: input.key,
+        content: input.content,
+        contentType,
+        expiresAt,
+        tags: input.tags
+    });
+    return { entry, message: `Scratchpad entry "${input.key}" written` };
+}
+export async function executeScratchpadRead(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const entry = await session.readScratchpad(activeSession.id, input.key);
+    if (!entry) {
+        throw new CapabilityError(`Scratchpad entry "${input.key}" not found.`, 'NOT_FOUND', {
+            reason: 'scratchpad-entry-not-found',
+            details: { key: input.key }
+        });
+    }
+    return { entry };
+}
+/** Scratchpad filters for one page of `limit` entries, by content type when one is selected. */
+function scratchpadFilters(limit, contentType) {
+    const filters = { limit, offset: 0 };
+    if (contentType)
+        filters.contentType = contentType;
+    return filters;
+}
+export async function executeScratchpadList(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const filters = scratchpadFilters(100, input.contentType);
+    const [entries, total] = await Promise.all([
+        session.listScratchpad(activeSession.id, filters),
+        session.countScratchpad(activeSession.id, filters)
+    ]);
+    return { entries, total };
+}
+export async function executeScratchpadSearch(input, context) {
+    const session = context.session;
+    const activeSession = await requireActiveSession(session);
+    const { items: results, total } = await session.searchScratchpad(activeSession.id, input.query, scratchpadFilters(input.limit, input.contentType));
+    return { results, total };
+}
+//# sourceMappingURL=scratchpad.js.map

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

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

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

@@ -0,0 +1,277 @@
+/**
+ * CLI session lifecycle/query services.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import type { SessionCLIContext } from '../session-cli-context.ts';
+import type { SessionInitInput, SessionStatusInput, SessionListInput, SessionResumeInput, SessionPauseInput, SessionArchiveInput, SessionSearchInput } from '../../schemas/commands.ts';
+import { type RequestedSessionRejection } from '../../../manager/resolve-bound-session.ts';
+/**
+ * The refusal for a named `--session-id` that cannot be bound. A named
+ * session never mints a replacement, so init fails instead of silently
+ * starting another one.
+ */
+export declare function requestedSessionRefusal(sessionId: string, reason: RequestedSessionRejection): CapabilityError;
+export declare function executeSessionInit(input: SessionInitInput, context: SessionCLIContext): Promise<{
+    session: {
+        id: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        scope: "local" | "global" | "project";
+        tags: string[];
+        ownerParticipant: string;
+        metadata: {
+            [x: string]: unknown;
+            source?: string | undefined;
+            version?: string | undefined;
+            gitBranch?: string | undefined;
+            gitCommit?: string | undefined;
+            linearIssueId?: string | undefined;
+            githubPrNumber?: number | undefined;
+            sessionType?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        lastActivityAt: Date;
+        description?: string | undefined;
+        projectId?: string | undefined;
+        filesPattern?: string[] | undefined;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentSessionId?: string | null | undefined;
+        assignedParticipant?: string | undefined;
+        pausedAt?: Date | undefined;
+        archivedAt?: Date | undefined;
+    };
+    reused: boolean;
+    requestedSessionId: string | undefined;
+    requestedSessionRejected: RequestedSessionRejection | undefined;
+    knowledgeCount: number;
+    participant: {
+        id: string;
+        slug: string;
+    };
+    message: string;
+}>;
+export declare function executeSessionStatus(_input: SessionStatusInput, context: SessionCLIContext): Promise<{
+    hasSession: false;
+    message: string;
+    session?: undefined;
+    stats?: undefined;
+} | {
+    hasSession: true;
+    session: {
+        id: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        scope: "local" | "global" | "project";
+        tags: string[];
+        ownerParticipant: string;
+        metadata: {
+            [x: string]: unknown;
+            source?: string | undefined;
+            version?: string | undefined;
+            gitBranch?: string | undefined;
+            gitCommit?: string | undefined;
+            linearIssueId?: string | undefined;
+            githubPrNumber?: number | undefined;
+            sessionType?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        lastActivityAt: Date;
+        description?: string | undefined;
+        projectId?: string | undefined;
+        filesPattern?: string[] | undefined;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentSessionId?: string | null | undefined;
+        assignedParticipant?: string | undefined;
+        pausedAt?: Date | undefined;
+        archivedAt?: Date | undefined;
+    };
+    stats: {
+        session: {
+            id: string;
+            title: string;
+            status: "active" | "paused" | "archived";
+            scope: "local" | "global" | "project";
+            tags: string[];
+            ownerParticipant: string;
+            metadata: {
+                [x: string]: unknown;
+                source?: string | undefined;
+                version?: string | undefined;
+                gitBranch?: string | undefined;
+                gitCommit?: string | undefined;
+                linearIssueId?: string | undefined;
+                githubPrNumber?: number | undefined;
+                sessionType?: string | undefined;
+                custom?: Record<string, unknown> | undefined;
+            };
+            createdAt: Date;
+            updatedAt: Date;
+            lastActivityAt: Date;
+            description?: string | undefined;
+            projectId?: string | undefined;
+            filesPattern?: string[] | undefined;
+            workItemId?: string | undefined;
+            links?: {
+                kind: string;
+                id: string;
+                source: string;
+                role: string;
+            }[] | undefined;
+            parentSessionId?: string | null | undefined;
+            assignedParticipant?: string | undefined;
+            pausedAt?: Date | undefined;
+            archivedAt?: Date | undefined;
+        };
+        todos: {
+            total: number;
+            completed: number;
+            active: number;
+            blocked: number;
+            awaitingDependencies: number;
+            pending: number;
+        };
+        scratchpad: {
+            total: number;
+            byType: Record<string, number>;
+        };
+        jobs: {
+            total: number;
+            completed: number;
+            pending: number;
+            processing: number;
+            failed: number;
+        };
+        messages: {
+            total: number;
+            unread: number;
+            scope: "session" | "participant";
+            participantId: string | undefined;
+        };
+    } | null;
+    message?: undefined;
+}>;
+export declare function executeSessionList(input: SessionListInput, context: SessionCLIContext): Promise<{
+    sessions: {
+        id: string;
+        title: string;
+        createdAt: Date;
+        tags: string[];
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        lastActivityAt: Date;
+        todoCount: number;
+        completedTodoCount: number;
+        scratchpadEntryCount: number;
+        jobCount: number;
+        messageCount: number;
+        assignedParticipant?: string | undefined;
+        ownerParticipantId?: string | undefined;
+        ownerParticipantSlug?: string | undefined;
+        ownerParticipantName?: string | undefined;
+        assignedParticipantId?: string | undefined;
+        assignedParticipantSlug?: string | undefined;
+        assignedParticipantName?: string | undefined;
+        workItemId?: string | undefined;
+        workItemTitle?: string | undefined;
+        workspaceRoot?: string | undefined;
+        gitBranch?: string | undefined;
+        worktree?: string | undefined;
+    }[];
+    count: number;
+    total: number;
+}>;
+export declare function executeSessionResume(input: SessionResumeInput, context: SessionCLIContext): Promise<{
+    session: {
+        id: string;
+        title: string;
+        status: "active" | "paused" | "archived";
+        scope: "local" | "global" | "project";
+        tags: string[];
+        ownerParticipant: string;
+        metadata: {
+            [x: string]: unknown;
+            source?: string | undefined;
+            version?: string | undefined;
+            gitBranch?: string | undefined;
+            gitCommit?: string | undefined;
+            linearIssueId?: string | undefined;
+            githubPrNumber?: number | undefined;
+            sessionType?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        lastActivityAt: Date;
+        description?: string | undefined;
+        projectId?: string | undefined;
+        filesPattern?: string[] | undefined;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentSessionId?: string | null | undefined;
+        assignedParticipant?: string | undefined;
+        pausedAt?: Date | undefined;
+        archivedAt?: Date | undefined;
+    };
+    participant: {
+        id: string;
+        slug: string;
+    };
+    message: string;
+}>;
+export declare function executeSessionPause(input: SessionPauseInput, context: SessionCLIContext): Promise<{
+    message: string;
+}>;
+export declare function executeSessionArchive(input: SessionArchiveInput, context: SessionCLIContext): Promise<{
+    message: string;
+}>;
+export declare function executeSessionSearch(input: SessionSearchInput, context: SessionCLIContext): Promise<{
+    results: {
+        id: string;
+        title: string;
+        createdAt: Date;
+        tags: string[];
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        lastActivityAt: Date;
+        todoCount: number;
+        completedTodoCount: number;
+        scratchpadEntryCount: number;
+        jobCount: number;
+        messageCount: number;
+        assignedParticipant?: string | undefined;
+        ownerParticipantId?: string | undefined;
+        ownerParticipantSlug?: string | undefined;
+        ownerParticipantName?: string | undefined;
+        assignedParticipantId?: string | undefined;
+        assignedParticipantSlug?: string | undefined;
+        assignedParticipantName?: string | undefined;
+        workItemId?: string | undefined;
+        workItemTitle?: string | undefined;
+        workspaceRoot?: string | undefined;
+        gitBranch?: string | undefined;
+        worktree?: string | undefined;
+    }[];
+    total: number;
+}>;
+//# sourceMappingURL=sessions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/sessions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAuB,KAAK,yBAAyB,EAAE,MAAM,2CAA2C,CAAC;AAGhH;;;;GAIG;AACH,wBAAgB,uBAAuB,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,yBAAyB,GAC/B,eAAe,CAwBjB;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6D3F;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAehG;AASD,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAe3F;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAc/F;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;;GAI7F;AAED,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,mBAAmB,EAC1B,OAAO,EAAE,iBAAiB;;GAK1B;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAO/F"}

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

@@ -0,0 +1,149 @@
+/**
+ * CLI session lifecycle/query services.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getOrCreateCliParticipantIdentity } from "./participant.js";
+import { cliBodyConnectionKey } from "../../../manager/cli-body-connection.js";
+import { resolveBoundSession } from "../../../manager/resolve-bound-session.js";
+import { confirmationRequired } from "./refusals.js";
+/**
+ * The refusal for a named `--session-id` that cannot be bound. A named
+ * session never mints a replacement, so init fails instead of silently
+ * starting another one.
+ */
+export function requestedSessionRefusal(sessionId, reason) {
+    if (reason === 'ambiguous') {
+        return new CapabilityError(`Requested session ${sessionId} matches more than one active session; use the full UUID.`, 'CONFLICT', { reason: 'requested-session-ambiguous', details: { sessionId } });
+    }
+    if (reason === 'foreign-workspace') {
+        return new CapabilityError(`Requested session ${sessionId} belongs to another workspace.`, 'PERMISSION_DENIED', { reason: 'requested-session-foreign-workspace', details: { sessionId } });
+    }
+    return new CapabilityError(`Requested session ${sessionId} is unresolvable (missing or archived). A named sessionId does not mint a replacement.`, 'NOT_FOUND', {
+        reason: 'requested-session-unresolvable',
+        recoveryHint: 'Run "vibes session list" for bindable sessions, or pass --new-session.',
+        details: { sessionId }
+    });
+}
+export async function executeSessionInit(input, context) {
+    const session = context.session;
+    const { participantId, slug } = await getOrCreateCliParticipantIdentity(context, input.participantId);
+    // Same bind decision the MCP/runtime handler uses. Continuity lattice:
+    // requested id → participant map → durable default → mint.
+    const bound = await resolveBoundSession({
+        manager: session,
+        participantId,
+        sessionId: input.sessionId,
+        newSession: input.newSession,
+        workspacePath: context.cli?.cwd,
+        // The CLI acts for the agent its shell names (process-scope actor).
+        agentId: context.runtime.scope.actor?.agentId
+    });
+    if (input.sessionId && bound.requestedSessionRejected && !input.newSession) {
+        throw requestedSessionRefusal(input.sessionId, bound.requestedSessionRejected);
+    }
+    const create = {
+        title: input.title || `Session ${new Date().toISOString().split('T')[0]}`,
+        description: input.description,
+        ownerParticipant: participantId,
+        filesPattern: input.files,
+        tags: input.tags,
+        status: 'active',
+        metadata: context.cli?.cwd ? { workspacePath: context.cli.cwd } : undefined
+    };
+    let newSession = bound.session;
+    if (!newSession) {
+        newSession = await session.createSession(create);
+        // Record it as this participant's active session. Without this the
+        // participant→session map stays EMPTY for CLI callers, so the reuse path
+        // above can never find anything and every `vibes session init` mints
+        // another row — the duplicate-session flood the runtime handler already
+        // fixed for MCP. Caught by live-certifying the CLI, not by unit tests:
+        // they mock the manager, so an unwritten map looks identical to a hit.
+        await session.setParticipantActiveSession(participantId, newSession.id);
+    }
+    // Persist the body and session as one routing decision. A later `vibes
+    // tools run` process must restore both before it invokes workspace-lock;
+    // restoring only the session silently creates participant-null custody.
+    await session.setDefaultActiveBinding(newSession.id, participantId);
+    return {
+        session: newSession,
+        reused: bound.reused,
+        // Present only for a rejected request (with --new-session); JSON omits the undefined pair.
+        requestedSessionId: bound.requestedSessionRejected ? input.sessionId : undefined,
+        requestedSessionRejected: bound.requestedSessionRejected,
+        knowledgeCount: 0,
+        participant: { id: participantId, slug },
+        message: bound.reused
+            ? 'Session rebound successfully'
+            : 'Session initialized successfully'
+    };
+}
+export async function executeSessionStatus(_input, context) {
+    const session = context.session;
+    const bodyKey = cliBodyConnectionKey(context.runtime);
+    const participant = bodyKey ? await session.getParticipantByConnection(bodyKey) : null;
+    const bodySessionId = participant
+        ? await session.getParticipantActiveSession(participant.participantId)
+        : null;
+    const defaultBinding = bodyKey || bodySessionId ? null : await session.getDefaultActiveBinding();
+    const activeSessionId = bodySessionId ?? defaultBinding?.sessionId ?? null;
+    const activeSession = activeSessionId ? await session.getSession(activeSessionId) : null;
+    if (!activeSession) {
+        return { hasSession: false, message: 'No active session' };
+    }
+    const stats = await session.getSessionStats(activeSession.id);
+    return { hasSession: true, session: activeSession, stats };
+}
+/** The list filters a `session list` input selects: `all` adds no status filter. */
+function sessionListFilters(input) {
+    const filters = { limit: input.limit, offset: input.offset };
+    if (input.status !== 'all')
+        filters.status = input.status;
+    return filters;
+}
+export async function executeSessionList(input, context) {
+    const session = context.session;
+    const filters = sessionListFilters(input);
+    const sessions = await session.listSessions(filters);
+    // `count` is the page size returned; `total` is the unfiltered set
+    // size so paginating routines can stop when offset >= total.
+    const total = await session.countSessions(filters.status ? { status: filters.status } : undefined);
+    return {
+        sessions,
+        count: sessions.length,
+        total
+    };
+}
+export async function executeSessionResume(input, context) {
+    const session = context.session;
+    const resumed = await session.resumeSession(input.sessionId);
+    const { participantId, slug } = await getOrCreateCliParticipantIdentity(context, input.participantId);
+    await session.setParticipantActiveSession(participantId, resumed.id);
+    await session.setDefaultActiveBinding(resumed.id, participantId);
+    return {
+        session: resumed,
+        participant: { id: participantId, slug },
+        message: `Session "${resumed.title}" resumed`
+    };
+}
+export async function executeSessionPause(input, context) {
+    if (!input.confirm)
+        throw confirmationRequired();
+    await context.session.pauseActiveSession();
+    return { message: 'Active session paused' };
+}
+export async function executeSessionArchive(input, context) {
+    if (!input.confirm)
+        throw confirmationRequired();
+    await context.session.archiveSession(input.sessionId);
+    return { message: 'Session archived' };
+}
+export async function executeSessionSearch(input, context) {
+    // L-31: use true match total from storage COUNT, not page length (L-11 class).
+    const { results, total } = await context.session.searchSessionsPaged(input.query, {
+        limit: input.limit,
+        offset: 0
+    });
+    return { results, total };
+}
+//# sourceMappingURL=sessions.js.map

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

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

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

@@ -0,0 +1,132 @@
+/**
+ * CLI TODO services.
+ */
+import type { SessionCLIContext } from '../session-cli-context.ts';
+import type { TodoAddInput, TodoListInput, TodoCompleteInput, TodoUpdateInput, TodoTreeInput } from '../../schemas/commands.ts';
+export declare function executeTodoAdd(input: TodoAddInput, context: SessionCLIContext): Promise<{
+    todo: {
+        id: string;
+        sessionId: string;
+        content: string;
+        activeForm: string;
+        status: "cancelled" | "pending" | "blocked" | "completed" | "in_progress";
+        priority: "low" | "medium" | "high" | "urgent";
+        dependencies: string[];
+        tags: string[];
+        metadata: {
+            [x: string]: unknown;
+            filePaths?: string[] | undefined;
+            lineNumbers?: number[] | undefined;
+            knowledgeItemIds?: string[] | undefined;
+            jobIds?: string[] | undefined;
+            externalIssueId?: string | undefined;
+            issueTracker?: "other" | "linear" | "github" | "jira" | undefined;
+            category?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentId?: string | undefined;
+        assignedParticipant?: string | undefined;
+        estimatedMinutes?: number | undefined;
+        actualMinutes?: number | undefined;
+        startedAt?: Date | undefined;
+        completedAt?: Date | undefined;
+        blockedAt?: Date | undefined;
+    };
+    message: string;
+}>;
+export declare function executeTodoList(input: TodoListInput, context: SessionCLIContext): Promise<{
+    todos: {
+        id: string;
+        sessionId: string;
+        content: string;
+        activeForm: string;
+        status: "cancelled" | "pending" | "blocked" | "completed" | "in_progress";
+        priority: "low" | "medium" | "high" | "urgent";
+        dependencies: string[];
+        tags: string[];
+        metadata: {
+            [x: string]: unknown;
+            filePaths?: string[] | undefined;
+            lineNumbers?: number[] | undefined;
+            knowledgeItemIds?: string[] | undefined;
+            jobIds?: string[] | undefined;
+            externalIssueId?: string | undefined;
+            issueTracker?: "other" | "linear" | "github" | "jira" | undefined;
+            category?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentId?: string | undefined;
+        assignedParticipant?: string | undefined;
+        estimatedMinutes?: number | undefined;
+        actualMinutes?: number | undefined;
+        startedAt?: Date | undefined;
+        completedAt?: Date | undefined;
+        blockedAt?: Date | undefined;
+    }[];
+    total: number;
+}>;
+export declare function executeTodoComplete(input: TodoCompleteInput, context: SessionCLIContext): Promise<{
+    message: string;
+}>;
+export declare function executeTodoUpdate(input: TodoUpdateInput, context: SessionCLIContext): Promise<{
+    message: string;
+}>;
+export declare function executeTodoTree(input: TodoTreeInput, context: SessionCLIContext): Promise<{
+    todos: {
+        id: string;
+        sessionId: string;
+        content: string;
+        activeForm: string;
+        status: "cancelled" | "pending" | "blocked" | "completed" | "in_progress";
+        priority: "low" | "medium" | "high" | "urgent";
+        dependencies: string[];
+        tags: string[];
+        metadata: {
+            [x: string]: unknown;
+            filePaths?: string[] | undefined;
+            lineNumbers?: number[] | undefined;
+            knowledgeItemIds?: string[] | undefined;
+            jobIds?: string[] | undefined;
+            externalIssueId?: string | undefined;
+            issueTracker?: "other" | "linear" | "github" | "jira" | undefined;
+            category?: string | undefined;
+            custom?: Record<string, unknown> | undefined;
+        };
+        createdAt: Date;
+        updatedAt: Date;
+        workItemId?: string | undefined;
+        links?: {
+            kind: string;
+            id: string;
+            source: string;
+            role: string;
+        }[] | undefined;
+        parentId?: string | undefined;
+        assignedParticipant?: string | undefined;
+        estimatedMinutes?: number | undefined;
+        actualMinutes?: number | undefined;
+        startedAt?: Date | undefined;
+        completedAt?: Date | undefined;
+        blockedAt?: Date | undefined;
+    }[];
+    total: number;
+}>;
+//# sourceMappingURL=todos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"todos.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/session/todos.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EACX,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,MAAM,2BAA2B,CAAC;AAGnC,wBAAsB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgBnF;AAaD,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAWrF;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,iBAAiB;;GAG7F;AAED,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB;;GAWzF;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwBrF"}