praxis-agent 0.1.0

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

@@ -0,0 +1,142 @@
+import type { ClaudeConditionalRuleResolver } from '../compatibility/claude/context.js';
+import { type ClaudeFileResource, type ClaudeFileResourceConfig } from '../compatibility/claude/file-resources.js';
+import { type ModelDocument, type ModelImage, type ModelToolCall, type ModelProvider, type ModelUsage, type PermissionApproval, type PermissionResolver, type RuntimeEventSink, type ToolRegistry } from '../core/runtime.js';
+import type { ModelPricingRegistry } from '../core/usage.js';
+import type { Compactor } from '../core/compaction.js';
+import { ContextBudget } from '../core/context-budget.js';
+import { type ContextAssembler } from '../core/context.js';
+import type { ClaudeExtensionCatalog } from '../extensions/claude-extensions.js';
+import type { ClaudeHookRunner } from '../hooks/claude-hooks.js';
+import { type TranscriptParseIssue } from '../persistence/claude-transcript-store.js';
+import { type AgentPermissionMode } from './subagent-service.js';
+import type { WorkspaceContext } from './session-worktree.js';
+import type { ClaudeInteractiveToolManager } from '../tools/claude-interactive-tools.js';
+export interface ClaudeSessionServiceOptions {
+    configRoot: string;
+    cwd: string;
+    claudeVersion: string;
+    provider?: ModelProvider;
+    tools?: ToolRegistry;
+    permissions?: PermissionResolver;
+    permissionResolverForMode?: (mode: AgentPermissionMode) => PermissionResolver;
+    approveTool?: (call: ModelToolCall, originalCall?: ModelToolCall) => PermissionApproval | Promise<PermissionApproval>;
+    approveRecovery?: (call: ModelToolCall) => boolean | Promise<boolean>;
+    contextAssembler?: ContextAssembler;
+    conditionalRuleResolver?: Pick<ClaudeConditionalRuleResolver, 'resolve'>;
+    extensions?: ClaudeExtensionCatalog;
+    hooks?: ClaudeHookRunner;
+    agent?: string;
+    eventSink?: RuntimeEventSink;
+    compactor?: Compactor;
+    contextBudget?: ContextBudget;
+    contextReserveTokens?: number;
+    enableSubagents?: boolean;
+    subagentToolNames?: readonly string[];
+    taskToolNames?: readonly string[];
+    scheduledToolNames?: readonly string[];
+    enableDynamicWakeups?: boolean;
+    enableWorkflows?: boolean;
+    providerForModel?: (model: string) => ModelProvider;
+    effort?: string;
+    maxModelTurns?: number;
+    betas?: readonly string[];
+    structuredOutputSchema?: Record<string, unknown>;
+    pricing?: ModelPricingRegistry;
+    maxBudgetUsd?: number;
+    emitToolUseSummaries?: boolean;
+    brief?: boolean;
+    collectMetrics?: boolean;
+    sessionPersistence?: boolean;
+    sessionKind?: 'bg';
+    workspace?: WorkspaceContext;
+    initialWorktree?: boolean;
+    initialWorktreeName?: string;
+    enableWorktrees?: boolean;
+    worktreeToolNames?: readonly ('EnterWorktree' | 'ExitWorktree')[];
+    fileResources?: readonly ClaudeFileResource[];
+    fileResourceConfig?: Omit<ClaudeFileResourceConfig, 'sessionId' | 'signal'>;
+    fileCheckpointing?: boolean;
+    fileRewindRoots?: readonly string[];
+    interactiveTools?: ClaudeInteractiveToolManager;
+}
+export interface SessionRunResult {
+    sessionId: string;
+    text: string;
+    usage: ModelUsage;
+    structuredOutput?: unknown;
+    durationApiMs?: number;
+    costUsd?: number;
+    modelUsage?: Readonly<Record<string, ModelUsage>>;
+}
+export interface SessionSummary {
+    sessionId: string;
+    name?: string;
+    lastPrompt: string | null;
+    updatedAt: string;
+    status: SessionStatus;
+    issue: TranscriptParseIssue | null;
+    prNumber?: number;
+    prUrl?: string;
+    prRepository?: string;
+}
+export type SessionStatus = 'ready' | 'read-only' | 'corrupt';
+export interface SessionInspection extends SessionSummary {
+    claudeVersion: string;
+    writeMode: 'read-only' | 'read-write';
+    entryCount: number;
+    byteLength: number;
+    newlineTerminated: boolean;
+}
+export interface ForkResult {
+    sessionId: string;
+    parentSessionId: string;
+}
+export declare function workflowTokenTarget(prompt: string): number | null;
+export declare class ClaudeSessionService {
+    private readonly options;
+    private readonly schema;
+    private readonly inMemoryStores;
+    private readonly scheduledPrompts;
+    private readonly workflowManager;
+    private readonly worktreeManager;
+    private readonly sessionCwds;
+    private readonly hostedSubagents;
+    private readonly downloadedFileResourceSessions;
+    constructor(options: ClaudeSessionServiceOptions);
+    nextScheduledPrompt(signal?: AbortSignal): Promise<import("./scheduled-prompt-manager.js").ScheduledPrompt | null>;
+    workflows(): readonly Record<string, unknown>[];
+    close(): Promise<void>;
+    createHostedToolRegistry(sessionId: string): ToolRegistry;
+    run(prompt: string, signal?: AbortSignal, sessionId?: string, name?: string, images?: readonly ModelImage[], documents?: readonly ModelDocument[]): Promise<SessionRunResult>;
+    resume(sessionId: string, prompt: string, signal?: AbortSignal, name?: string, images?: readonly ModelImage[], documents?: readonly ModelDocument[], resumeSessionAt?: string): Promise<SessionRunResult>;
+    promptSuggestion(sessionId: string, signal?: AbortSignal): Promise<string | null>;
+    sessions(): Promise<SessionSummary[]>;
+    inspect(sessionId: string): Promise<SessionInspection>;
+    export(sessionId: string): Promise<Buffer>;
+    fork(parentSessionId: string, sessionId?: string, resumeSessionAt?: string): Promise<ForkResult>;
+    rewindFiles(sessionId: string, userMessageId: string): Promise<void>;
+    private executeTurn;
+    private ensureFileResources;
+    private translationContext;
+    private attachedRulePaths;
+    private sessionNameEntries;
+    private hasSessionName;
+    private sessionName;
+    private lastMessageUuid;
+    private promptIdForToolCall;
+    private assistantIdForToolCall;
+    private displayRulePath;
+    private activeCwd;
+    private restoreWorktree;
+    private paths;
+    private store;
+    private turnStore;
+    private assertSessionPersistence;
+    private assertWritable;
+    private sessionStatus;
+    private provider;
+    private contextBudget;
+    private append;
+    private logicalTailUuid;
+}
+//# sourceMappingURL=session-service.d.ts.map

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

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