praxis-agent 0.31.0 → 0.33.0

package/dist/application/session-service.d.ts

@@ -4,6 +4,8 @@ import { type DataPlane } from '../persistence/data-plane.js';
 import { type ClaudeFileResource, type ClaudeFileResourceConfig } from '../compatibility/claude/file-resources.js';
 import { type ClaudeDisplayTranscriptItem } from '../compatibility/claude/projection.js';
 import { type ClaudeTranscriptEntry } from '../compatibility/claude/schema.js';
+import { type ClaudeSessionMetadata } from '../compatibility/claude/session-metadata.js';
+import { type ClaudeInterruptionClassification } from '../compatibility/claude/interruption.js';
 import { type ModelDocument, type ModelImage, type ModelToolCall, type ModelProvider, type ModelUsage, type PermissionApproval, type PermissionDecision, type PermissionResolver, type PermissionUpdate, type RuntimeEventSink, type ToolRegistry } from '../core/runtime.js';
 import { type BackgroundTaskSnapshot } from './background-task-runtime.js';
 import type { ModelPricingRegistry } from '../core/usage.js';
@@ -38,6 +40,8 @@ export interface ClaudeSessionServiceOptions {
     persistPermissionUpdates?: (updates: readonly PermissionUpdate[]) => void | Promise<void>;
     approveTool?: (call: ModelToolCall, originalCall?: ModelToolCall, decision?: PermissionDecision) => PermissionApproval | Promise<PermissionApproval>;
     approveRecovery?: (call: ModelToolCall) => boolean | Promise<boolean>;
+    /** Explicit Claude-compatible opt-in for replaying an interrupted turn. */
+    resumeInterruptedTurn?: boolean;
     contextAssembler?: ContextAssembler;
     conditionalRuleResolver?: Pick<ClaudeConditionalRuleResolver, 'resolve'>;
     extensions?: ClaudeExtensionCatalog;
@@ -125,6 +129,12 @@ export interface SideQuestionForkResult {
 export interface SessionSummary {
     sessionId: string;
     name?: string;
+    tag?: string;
+    agentName?: string;
+    agentColor?: string;
+    agentSetting?: string;
+    permissionMode?: string;
+    mode?: string;
     lastPrompt: string | null;
     updatedAt: string;
     status: SessionStatus;
@@ -183,19 +193,26 @@ export declare class ClaudeSessionService {
     private readonly worktreeManager;
     private readonly sessionCwds;
     private readonly discoveredProjectRoots;
+    private readonly explicitSessionFiles;
+    private readonly explicitResumeLeafUuids;
     private readonly sessionPermissionUpdates;
     private readonly hostedSubagents;
     private readonly hostedSubagentsByRegistry;
     private readonly backgroundNotificationWrites;
     private readonly downloadedFileResourceSessions;
+    private readonly detachedHookRuns;
     private activeProvider;
     private mcpClosePromise;
     private readonly sessionCostTrackers;
     private activeCostSessionId;
     private closeCostSavePromise;
+    private closeMetadataSavePromise;
+    private readonly durableMetadataSessions;
+    private readonly durableMetadataSnapshots;
     private readonly sessionMemoryControllers;
     private resolvedSessionMemoryProvider;
     private readonly hookLifecycle;
+    private readonly fileChangeWatcher;
     private runtimeCwd;
     constructor(options: ClaudeSessionServiceOptions);
     nextScheduledPrompt(signal?: AbortSignal): Promise<ScheduledPrompt | null>;
@@ -214,6 +231,23 @@ export declare class ClaudeSessionService {
     close(): Promise<void>;
     transitionHookSession(sessionId: string, reason: Exclude<HookSessionEndReason, 'other'>): Promise<void>;
     reloadContextResources(sessionId: string): void;
+    notify(sessionId: string | undefined, message: string, notificationType: string, title?: string, signal?: AbortSignal): Promise<void>;
+    notifyDetached(sessionId: string | undefined, message: string, notificationType: string, title?: string): void;
+    private drainDetachedHookRuns;
+    instructionsLoaded(sessionId: string, resources: readonly {
+        path: string;
+        scope: 'local' | 'project' | 'user';
+        importedFrom?: string;
+    }[], reason: 'session_start' | 'compact' | 'resource_reload'): Promise<void>;
+    instructionLoaded(sessionId: string, resource: {
+        path: string;
+        memoryType: 'User' | 'Project' | 'Local' | 'Managed';
+        globs?: readonly string[];
+        triggerFilePath?: string;
+        parentFilePath?: string;
+    }, loadReason: 'session_start' | 'nested_traversal' | 'path_glob_match' | 'include' | 'compact'): Promise<void>;
+    private runAdvisoryHook;
+    private cwdChanged;
     createHostedToolRegistry(sessionId: string): ToolRegistry;
     run(prompt: string, signal?: AbortSignal, sessionId?: string, name?: string, images?: readonly ModelImage[], documents?: readonly ModelDocument[]): Promise<SessionRunResult>;
     runShell(command: string, signal?: AbortSignal, sessionId?: string, name?: string): Promise<SessionRunResult>;
@@ -227,8 +261,12 @@ export declare class ClaudeSessionService {
     inspect(sessionId: string): Promise<SessionInspection>;
     readEffectiveAgentColor(sessionId: string): Promise<AgentColorName | undefined>;
     export(sessionId: string): Promise<Buffer>;
+    registerResumePath(requestedPath: string): Promise<SessionSummary>;
     transcript(sessionId: string, resumeSessionAt?: string): Promise<ClaudeDisplayTranscriptItem[]>;
+    interruption(sessionId: string): Promise<ClaudeInterruptionClassification>;
+    metadata(sessionId: string): Promise<ClaudeSessionMetadata>;
     rename(sessionId: string, name: string): Promise<void>;
+    tag(sessionId: string, tag: string): Promise<void>;
     changeCwd(sessionId: string | undefined, requestedCwd: string): Promise<string>;
     recordCdUsage(sessionId: string): Promise<void>;
     approveRecentlyDenied(sessionId: string, display: string): Promise<void>;
@@ -284,7 +322,14 @@ export declare class ClaudeSessionService {
     private cdCommandEntries;
     private localCommandEntries;
     private store;
+    /**
+     * Refreshes metadata under the transcript lease before writing a compact
+     * tail snapshot. This prevents a long-lived process from overwriting a
+     * newer title or tag appended by another writer.
+     */
+    private reappendDurableMetadata;
     private turnStore;
+    private rememberDurableMetadata;
     private assertSessionPersistence;
     private assertWritable;
     private sessionStatus;