spexcode 0.6.7 → 0.7.0-next.0

package/node_modules/@spexcode/spec-cli/dist/sessions.d.ts

@@ -1,15 +1,18 @@
 import { type ReviewDiffFile } from '@spexcode/spec-core';
 import { type ConfigPreset, type SpecLite } from '@spexcode/spec-core';
-import { type Harness, type TurnFailure, type DispatchResult, type PaneProbe, type ProcTable } from './harness.js';
+import { type AdapterLoadedReferenceState, type Harness, type TurnFailure, type DispatchResult, type PaneProbe, type ProcTable } from './harness.js';
 import { envSessionId, type RawRecord, type SessionLifecycle, type SessionProposal } from '@spexcode/spec-core';
 import { type SessionWeb } from './session-web.js';
-import { type MessageIdempotency } from '@spexcode/session-core';
+import { type ProductionSessionApplication } from '@spexcode/session-application';
 export declare const TMUX_SOCK: string;
+/** Start the one process-local serial reaper and resume any crash leftovers. */
+export declare function startWorktreeTrashReaper(): void;
 export type { DispatchResult };
 export type Lifecycle = SessionLifecycle;
 export type Proposal = SessionProposal;
 export type DisplayStatus = 'working' | 'idle' | 'offline' | 'starting' | 'review' | 'done' | 'close-pending' | 'parked' | 'error' | 'asking' | 'queued' | 'unknown' | 'corrupt' | 'retired';
 export type Liveness = 'online' | 'starting' | 'offline' | 'unknown';
+export declare function displayStatusForProposal(proposal: Proposal | null | undefined): DisplayStatus;
 export type Session = {
     id: string;
     node: string | null;
@@ -34,6 +37,7 @@ export type Session = {
     liveness: Liveness;
     note: string | null;
     archived: boolean;
+    closedAt: string | null;
     archiveHazard?: string | null;
     prompt: string | null;
     promptPreview: string | null;
@@ -50,11 +54,6 @@ export type CloseSource = {
 } | {
     kind: 'user';
 };
-export type SessionClosure = {
-    id: string;
-    closedAt: string;
-};
-export declare function findSessionClosure(selector: string): SessionClosure | null;
 export declare const HEADLINE_PREVIEW_COLUMNS = 60;
 export declare const deriveLabel: (r: {
     name?: string | null;
@@ -104,20 +103,34 @@ export type SessRec = {
     createdAt: number;
     harness: string;
     harnessSessionId: string | null;
+    runtimeStartToken: string | null;
     stopped: boolean;
     archived: boolean;
+    closedAt: string | null;
     coldProof?: string | null;
     adapterRecovery?: string | null;
     launcher: string | null;
     launchCmd: string | null;
     launchOwner: string | null;
+    launchReadinessStartedAt?: number | null;
     createRequestId?: string | null;
     createPayloadHash?: string | null;
     zcodeChildSessionIds?: string[];
     base?: string | null;
+    forkCommit?: string | null;
+    diffComments?: DiffComment[];
     launchReadinessPending?: LaunchReadinessPending | null;
 };
-type LaunchReadinessOriginal = Pick<SessRec, 'status' | 'proposal' | 'note' | 'stopped' | 'archived' | 'coldProof' | 'adapterRecovery'>;
+export type DiffComment = {
+    id: string;
+    filePath: string;
+    lineStart: number;
+    lineEnd: number;
+    body: string;
+    diffIdentity: string;
+    sentAt: string | null;
+};
+type LaunchReadinessOriginal = Pick<SessRec, 'status' | 'proposal' | 'note' | 'stopped' | 'archived' | 'closedAt' | 'coldProof' | 'adapterRecovery'>;
 type LaunchReadinessPending = {
     version: 1;
     startedAt: number;
@@ -136,7 +149,6 @@ export declare class SessionRecordUnusable extends Error {
     constructor(code: 'corrupt' | 'retired', session: string, message: string);
 }
 export declare function withSessionRecordLockSync<T>(id: string, body: () => T): T;
-export declare function withSessionInputLock<T>(id: string, body: () => T): T | null;
 export declare function fromRaw(raw: RawRecord & {
     launch_owner?: string;
 }): SessRec;
@@ -185,6 +197,13 @@ export type ReviewIdentity = {
     label: string;
 };
 export declare function reviewIdentity(id: string): ReviewIdentity | null;
+export type SessionHookState = {
+    governed: boolean;
+    status: Lifecycle;
+    proposal: Proposal | null;
+    note: string | null;
+};
+export declare function sessionHookState(id: string): SessionHookState | null;
 export declare function toSession(rec: SessRec, status: DisplayStatus, lv: Liveness, activity?: string | null): Session;
 export type ZCodeChildSessionLink = {
     sessionId: string;
@@ -195,6 +214,17 @@ export declare function linkZCodeChildSession(sessionId: string, childSessionId:
 export declare function renameSession(id: string, name: string): Promise<boolean>;
 export declare function setSessionSort(id: string, key: number | null): Promise<boolean>;
 export declare function sessionPrompt(id: string): Promise<string | null>;
+export type ArchiveSessionIndexRow = {
+    id: string;
+    title: string;
+    label: string;
+    closedAt: string | null;
+    node: string | null;
+};
+export type ArchiveSessionIndexProbe = {
+    promptReads?: number;
+};
+export declare function listArchivedSessionIndex(probe?: ArchiveSessionIndexProbe): Promise<ArchiveSessionIndexRow[]>;
 export declare function listSessions(includeArchived?: boolean): Promise<Session[]>;
 export type ApiBaseSource = 'flag' | 'worker-env' | 'record' | 'env-fallback' | 'default';
 export type ApiBaseInfo = {
@@ -238,7 +268,22 @@ export type LaunchBlock = {
     message: string;
 };
 export declare function launchPreflight(rec: SessRec): LaunchBlock | null;
+export declare function launchShellCommand(file: string): string;
 export declare function launchScript(id: string, tail: string, harness?: Harness, cmd?: string): string;
+export declare function canonicalWatchRecipients(application: Pick<ProductionSessionApplication, 'topology'>, sessionId: string, status: string): string[];
+export declare function sessionHasPendingDelivery(id: string, application?: Pick<ProductionSessionApplication, 'readPendingMessages'> & Partial<Pick<ProductionSessionApplication, 'resolveRuntime'>> | null): boolean;
+export declare function canonicalRecordProjection<T extends Pick<SessRec, 'status' | 'stopped' | 'archived'>>(rec: T, canonical: {
+    status: string;
+    proposal: string | null;
+    note: string | null;
+    parentSessionId: string | null;
+} | null | undefined): T & {
+    status: Lifecycle;
+    proposal: Proposal | null;
+    note: string | null;
+    parent: string | null;
+};
+export declare function adapterResidentLiveness(rec: SessRec, resident: AdapterLoadedReferenceState | undefined): Liveness;
 export declare const drainQueue: () => Promise<void>;
 export declare function superviseQueue(intervalMs?: number): void;
 export declare function superviseDelivery(intervalMs?: number): void;
@@ -260,6 +305,7 @@ type SessionCreateRequestOptions = {
     requestKey?: string;
     signal?: AbortSignal;
     timeoutMs?: number;
+    onPublished?: (session: Session) => void | Promise<void>;
 };
 export type SessionCreateRequestResult = {
     status: 201;
@@ -274,6 +320,7 @@ export declare function sessionCreateTimeoutMs(env?: NodeJS.ProcessEnv): number;
 export declare function sessionIdForCreateKey(key: string): string;
 export declare function sessionCreateRequest(body: unknown, options?: SessionCreateRequestOptions): Promise<SessionCreateRequestResult>;
 export declare function createSession(prompt: string, launcher?: string, name?: string, base?: string): Promise<Session>;
+export declare function projectCreatedSession(session: Session): void;
 export declare function spawnerClause(p: SessRec | null): string;
 export declare function pendingSessionCreateWorktreePaths(): Set<string>;
 export declare function bootstrapMaterialize(rec: SessRec, doMaterialize?: (proj: string) => unknown): void;
@@ -292,10 +339,15 @@ export declare function markState(status: Lifecycle, opts?: {
     note?: string;
     sessionId?: string;
 }): boolean;
+export declare function markHumanPromptActive(sessionId: string): boolean;
 export declare const markDone: (proposal?: Proposal, sessionId?: string, note?: string) => boolean;
-export declare const markError: (sessionId?: string) => boolean;
 export declare function markTurnFailure(sessionId: string | undefined, note: string): boolean;
+export declare const INTERRUPTED_NOTE = "interrupted: the human stopped this turn; the next message continues the conversation";
+export declare function stampInterrupt(id: string): void;
+export declare function clearInterruptMarker(id: string): void;
+export declare const markInterrupted: (sessionId: string) => boolean;
 export declare function markHeadlessTurnFailure(sessionId: string, harness: string, exitCode: string): boolean;
+export declare function existingHarnessLaunchTarget(id: string): string | null;
 export declare function stageHarnessLaunchProof(sessionId: string | undefined, harnessSessionId: string | undefined, launchPayload: string): boolean;
 export declare function markHarnessSessionId(sessionId: string | undefined, harnessSessionId: string | undefined): boolean;
 export declare function markIdle(sessionId?: string): boolean;
@@ -312,7 +364,7 @@ export type ReviewEvalFacts = {
 export type ReviewEvalGate = ({
     phase: 'ready';
 } & ReviewEvalFacts) | {
-    phase: 'unavailable' | 'loading' | 'updating' | 'error';
+    phase: 'unavailable' | 'loading' | 'updating' | 'error' | 'dormant';
 };
 export type ReviewGates = {
     conflictsWithMain: boolean;
@@ -335,14 +387,47 @@ export type ReviewPayload = {
         note: string | null;
     };
 };
+export type SessionDiffFile = ReviewDiffFile & {
+    patch: string;
+    diffIdentity: string;
+};
+export type DiffScope = 'branch' | 'working';
+export type BranchState = 'no-commits' | 'merged' | 'open';
+export type SessionDiffPayload = {
+    id: string;
+    scope: 'branch';
+    branch: string;
+    baseRef: string;
+    base: string;
+    head: string;
+    mergeBase: string;
+    branchState: BranchState;
+    commitUrl: string | null;
+    files: SessionDiffFile[];
+    working: {
+        readable: boolean;
+        files: SessionDiffFile[];
+    };
+    comments: DiffComment[];
+};
+export declare function commitUrlForRemote(remote: string, commit: string): string | null;
+export declare function sessionDiff(id: string, filePath?: string, offset?: number, limit?: number, scope?: DiffScope): Promise<SessionDiffPayload | null>;
+export declare function saveDiffComment(id: string, input: Omit<DiffComment, 'id' | 'sentAt'> & {
+    id?: string;
+}): Promise<DiffComment | null>;
+export declare function retractDiffComment(id: string, commentId: string): Promise<DiffComment | null>;
+export declare function sendDiffComments(id: string, ids?: string[]): Promise<{
+    ok: boolean;
+    sentAt?: string;
+    count?: number;
+    error?: string;
+}>;
 export declare function reviewPayload(id: string): Promise<ReviewPayload | null>;
 export type MergeSessionResult = {
     dispatched: true;
 } | {
     dispatched: false;
     reason: string;
-    code?: 'session_merge_not_proposed';
-    status?: 409;
 };
 export declare function mergeSession(id: string): Promise<MergeSessionResult>;
 export type SessionLeafReceipt = {
@@ -366,7 +451,6 @@ export type SessionLeafProcessProbe = Readonly<{
 }>;
 export declare function installSessionLeafProcessProbeForTest(probe: SessionLeafProcessProbe): () => void;
 export declare const stopSession: (id: string) => Promise<boolean>;
-export declare const archiveSession: (id: string, on?: boolean) => Promise<boolean>;
 export declare const closeSession: (id: string, rawSource?: unknown) => Promise<boolean>;
 export type CorruptRecordQuarantineWitness = {
     adapter: string;
@@ -415,19 +499,32 @@ export type SessionTableScope = {
     parent: string;
 };
 export declare function formatTable(sessions: Session[], color?: boolean, scope?: SessionTableScope): string;
+type MessageIdempotency = {
+    operation: string;
+    requestDigest: string;
+    payloadHash: string;
+};
 type DispatchIdempotency = MessageIdempotency;
-type DispatchAcceptCode = 'dispatch_key_reused' | 'session_merge_not_proposed';
+type DispatchAcceptCode = 'dispatch_key_reused';
+export declare const EMPTY_PROMPT_ERROR = "empty prompt \u2014 nothing to dispatch";
 type AcceptedDispatch = DispatchResult & {
     replayed?: boolean;
     code?: DispatchAcceptCode;
+    delivery?: 'accepted' | 'queued' | 'deferred';
 };
 type SendTextOptions = {
     replyVia?: 'note';
     idempotency?: DispatchIdempotency;
+    deliveryKey?: string;
     acceptGuard?: (record: SessRec) => Promise<void>;
     deferDrain?: boolean;
+    allowStranded?: boolean;
 };
 export declare function sendText(id: string, text: string, from?: string, opts?: SendTextOptions): Promise<AcceptedDispatch>;
 export declare function drainSession(id: string): Promise<void>;
+export declare function canonicalMessageText(message: {
+    kind: string;
+    body: Uint8Array;
+}, recipient: SessRec): string;
 export declare function interruptSession(id: string): Promise<DispatchResult>;
 export declare function rawKey(id: string, key: string | string[]): Promise<boolean>;