@qlingzzy/qling 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,221 @@
+export interface RawToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface ToolResult {
+    tool_call_id: string;
+    output: string;
+    is_error?: boolean;
+    error?: {
+        code: string;
+        message: string;
+        retriable?: boolean;
+        category?: "validation" | "permission" | "network" | "io" | "runtime" | "guard";
+    };
+    meta?: Record<string, unknown>;
+}
+export interface Message {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    tool_calls?: RawToolCall[];
+    tool_call_id?: string;
+}
+export interface AgentConfig {
+    apiKey: string;
+    provider?: string;
+    endpoint?: string;
+    model: string;
+    systemPrompt: string;
+    maxIterations: number;
+    tools: ToolDefinition[];
+    tokenBudget?: TokenBudgetConfig;
+    sections?: PromptSectionRegistry;
+    runtime?: {
+        workspaceDir: string | null;
+        fileCacheDir: string;
+        fileStateDir: string;
+        maxSteps: number;
+        parseRetries: number;
+        maxTokenBudget: number;
+        toolRepeatLimit: number;
+        timeoutMs: number;
+    };
+    logging?: {
+        level: "debug" | "info" | "warn" | "error";
+        format: "text" | "json";
+        inspectPrompt: boolean;
+        inspectRequest: boolean;
+        inspectDumpDir: string;
+    };
+}
+export interface ToolParam {
+    type: "string" | "number" | "boolean" | "object" | "array";
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    pattern?: string;
+    minLength?: number;
+    maxLength?: number;
+    minimum?: number;
+    maximum?: number;
+    items?: ToolParam;
+    properties?: Record<string, ToolParam>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    longDescription?: string;
+    parameters: Record<string, unknown>;
+    paramSchema?: Record<string, ToolParam>;
+    readOnly?: boolean;
+    destructive?: boolean;
+    concurrencySafe?: boolean;
+    dangerousPatterns?: string[];
+    effortHint?: "minimal" | "low" | "medium" | "high";
+    examples?: string[];
+    seeAlso?: string[];
+    scenes?: string[];
+    priority?: number;
+}
+export interface TokenBudgetConfig {
+    maxTokens: number;
+    nudgeThreshold: number;
+    totalBudget: number;
+    usedTokens?: number;
+}
+export type HookName = "PreToolUse" | "PostToolUse" | "PostToolUseFailure";
+export type PermissionDecision = "allow" | "deny" | "ask";
+export interface ToolHookContext {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    inputSchema: Record<string, unknown>;
+    isReadOnly: boolean;
+    isDestructive: boolean;
+    isConcurrencySafe: boolean;
+    dangerousPatterns: string[];
+}
+export interface HookResult {
+    decision: PermissionDecision;
+    updatedInput?: Record<string, unknown>;
+    blockingError?: string;
+    preventContinuation?: boolean;
+    additionalContexts?: string[];
+}
+export type PreToolUseHandler = (ctx: ToolHookContext) => HookResult | Promise<HookResult>;
+export type PostToolUseHandler = (ctx: ToolHookContext, result: ToolResult) => void | Promise<void>;
+export type FailureHandler = (ctx: ToolHookContext, error: Error) => void | Promise<void>;
+export type HookHandler = PreToolUseHandler;
+export type ClassifierLabel = "safe" | "dangerous" | "ask";
+export interface ClassifierResult {
+    label: ClassifierLabel;
+    reason?: string;
+    patterns?: string[];
+}
+export interface PromptSection {
+    id: string;
+    title: string;
+    content: string;
+    cacheable?: boolean;
+    cached?: boolean;
+    dynamic?: boolean;
+}
+export declare class PromptSectionRegistry {
+    private sections;
+    private order;
+    register(section: PromptSection): void;
+    unregister(id: string): void;
+    get(id: string): PromptSection | undefined;
+    getAll(): PromptSection[];
+    buildPrompt(): string;
+    markCached(): void;
+    clearCache(): void;
+}
+export interface PermissionRule {
+    pattern: RegExp;
+    decision: PermissionDecision;
+    message?: string;
+}
+export type VerificationVerdict = "PASS" | "FAIL" | "PARTIAL";
+export interface VerificationResult {
+    verdict: VerificationVerdict;
+    details: string;
+    steps: VerificationStep[];
+}
+export interface VerificationStep {
+    description: string;
+    passed: boolean;
+    output?: string;
+}
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    source: "user-feedback" | "auto-dream" | "git" | "manual";
+    createdAt: number;
+    importance: number;
+    accessedAt?: number;
+}
+export interface AutoDreamConfig {
+    enabled: boolean;
+    turnThreshold: number;
+    transcriptWindow?: number;
+}
+export interface PersistedEntry {
+    id: string;
+    content: string;
+    source: string;
+    createdAt: number;
+    importance: number;
+}
+export interface WALEntry {
+    seq: number;
+    op: "add" | "remove" | "update" | "compact";
+    timestamp: number;
+    data: unknown;
+    checksum: string;
+}
+export interface WALState {
+    lastSeq: number;
+    lastCheckpointSeq: number;
+}
+export interface LLMDreamConfig {
+    enabled: boolean;
+    model: string;
+    maxTokens: number;
+    apiKey: string;
+    endpoint: string;
+}
+export interface MCPServerConfig {
+    name: string;
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    enabled: boolean;
+    transport?: "stdio" | "http";
+    url?: string;
+    headers?: Record<string, string>;
+}
+export interface SubtaskConfig {
+    task: string;
+    parentContext?: string;
+    maxIterations?: number;
+    depth?: number;
+    tools?: ToolDefinition[];
+    timeoutMs?: number;
+}
+export interface SubtaskResult {
+    success: boolean;
+    output: string;
+    iterations: number;
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,37 @@
+// ============================================================
+// 轻灵 - 类型定义 v2（参考 Claude Code Agent Deep Dive v2.1）
+// ============================================================
+export class PromptSectionRegistry {
+    sections = new Map();
+    order = [];
+    register(section) {
+        this.sections.set(section.id, section);
+        if (!this.order.includes(section.id))
+            this.order.push(section.id);
+    }
+    unregister(id) {
+        this.sections.delete(id);
+        this.order = this.order.filter((s) => s !== id);
+    }
+    get(id) {
+        return this.sections.get(id);
+    }
+    getAll() {
+        return this.order.map((id) => this.sections.get(id)).filter(Boolean);
+    }
+    buildPrompt() {
+        return this.getAll()
+            .filter((s) => !s.cached)
+            .map((s) => `【${s.title}】\n${s.content}`)
+            .join("\n\n");
+    }
+    markCached() {
+        this.getAll().forEach((s) => {
+            if (s.cacheable !== false)
+                s.cached = true;
+        });
+    }
+    clearCache() {
+        this.getAll().forEach((s) => (s.cached = false));
+    }
+}

package/dist/utils/symbol-extractor.d.ts

@@ -0,0 +1,8 @@
+export interface ExtractedSymbol {
+    name: string;
+    type: "class" | "function" | "interface" | "type" | "struct" | "variable" | "method";
+    line: number;
+    signature: string;
+}
+export declare function extractSymbols(fileContent: string, fileExtension: string): ExtractedSymbol[];
+//# sourceMappingURL=symbol-extractor.d.ts.map

package/dist/utils/symbol-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-extractor.d.ts","sourceRoot":"","sources":["../../src/utils/symbol-extractor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrF,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,EAAE,CAuM5F"}

package/dist/utils/symbol-extractor.js

@@ -0,0 +1,190 @@
+export function extractSymbols(fileContent, fileExtension) {
+    const lines = fileContent.split(/\r?\n/);
+    const symbols = [];
+    const ext = fileExtension.toLowerCase().replace(/^\./, "");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNum = i + 1;
+        if (ext === "ts" || ext === "js" || ext === "tsx" || ext === "jsx") {
+            // 1. TS/JS Class
+            const classMatch = line.match(/^\s*(?:export\s+)?(?:default\s+)?class\s+([a-zA-Z0-9_$]+)/);
+            if (classMatch) {
+                symbols.push({
+                    name: classMatch[1],
+                    type: "class",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 2. TS/JS Function
+            const funcMatch = line.match(/^\s*(?:export\s+)?(?:default\s+)?function\s+([a-zA-Z0-9_$]+)/);
+            if (funcMatch) {
+                symbols.push({
+                    name: funcMatch[1],
+                    type: "function",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 3. TS/JS Arrow Function (const foo = () =>)
+            const arrowMatch = line.match(/^\s*(?:export\s+)?const\s+([a-zA-Z0-9_$]+)\s*=\s*(?:\([^)]*\)|[a-zA-Z0-9_$]+)\s*=>/);
+            if (arrowMatch) {
+                symbols.push({
+                    name: arrowMatch[1],
+                    type: "function",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 4. TS Interface
+            const interfaceMatch = line.match(/^\s*(?:export\s+)?interface\s+([a-zA-Z0-9_$]+)/);
+            if (interfaceMatch) {
+                symbols.push({
+                    name: interfaceMatch[1],
+                    type: "interface",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 5. TS Type Alias
+            const typeMatch = line.match(/^\s*(?:export\s+)?type\s+([a-zA-Z0-9_$]+)/);
+            if (typeMatch) {
+                symbols.push({
+                    name: typeMatch[1],
+                    type: "type",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+        else if (ext === "py") {
+            // 1. Python Class
+            const classMatch = line.match(/^\s*class\s+([a-zA-Z0-9_]+)\s*(?:\(|:)/);
+            if (classMatch) {
+                symbols.push({
+                    name: classMatch[1],
+                    type: "class",
+                    line: lineNum,
+                    signature: line.trim().replace(/:$/, ""),
+                });
+                continue;
+            }
+            // 2. Python Def (top level function or indented method)
+            const defMatch = line.match(/^(\s*)def\s+([a-zA-Z0-9_]+)\s*\(/);
+            if (defMatch) {
+                const isMethod = defMatch[1].length > 0;
+                symbols.push({
+                    name: defMatch[2],
+                    type: isMethod ? "method" : "function",
+                    line: lineNum,
+                    signature: line.trim().replace(/:$/, ""),
+                });
+                continue;
+            }
+        }
+        else if (ext === "go") {
+            // 1. Go Struct
+            const structMatch = line.match(/^\s*type\s+([a-zA-Z0-9_]+)\s+struct/);
+            if (structMatch) {
+                symbols.push({
+                    name: structMatch[1],
+                    type: "struct",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 2. Go Interface
+            const interfaceMatch = line.match(/^\s*type\s+([a-zA-Z0-9_]+)\s+interface/);
+            if (interfaceMatch) {
+                symbols.push({
+                    name: interfaceMatch[1],
+                    type: "interface",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // 3. Go Func
+            const funcMatch = line.match(/^\s*func\s+(?:\([^)]+\)\s+)?([a-zA-Z0-9_]+)\s*\(/);
+            if (funcMatch) {
+                symbols.push({
+                    name: funcMatch[1],
+                    type: "function",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+        else if (ext === "rs") {
+            // Rust fn
+            const fnMatch = line.match(/^\s*(?:pub\s+)?fn\s+([a-zA-Z0-9_]+)\s*\(/);
+            if (fnMatch) {
+                symbols.push({
+                    name: fnMatch[1],
+                    type: "function",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+            // Rust struct
+            const structMatch = line.match(/^\s*(?:pub\s+)?struct\s+([a-zA-Z0-9_]+)/);
+            if (structMatch) {
+                symbols.push({
+                    name: structMatch[1],
+                    type: "struct",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+        // Additional TS/JS: exported const/var assigned function expr (more complete)
+        if (["ts", "js", "tsx", "jsx"].includes(ext)) {
+            const fnExprMatch = line.match(/^\s*(?:export\s+)?(?:const|let|var)\s+([a-zA-Z0-9_$]+)\s*=\s*(?:async\s+)?function/);
+            if (fnExprMatch) {
+                symbols.push({
+                    name: fnExprMatch[1],
+                    type: "function",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+        // Top-level variables (const/let/var not functions)
+        if (["ts", "js", "tsx", "jsx"].includes(ext)) {
+            const varMatch = line.match(/^\s*(?:export\s+)?(?:const|let|var)\s+([a-zA-Z0-9_$]+)\s*[:=](?!\s*(?:async\s+)?(?:function|\(|\s*=>))/);
+            if (varMatch) {
+                symbols.push({
+                    name: varMatch[1],
+                    type: "variable",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+        // Rough class/instance methods (indented name(...) { or : type { )
+        if (["ts", "js", "tsx", "jsx"].includes(ext)) {
+            const methMatch = line.match(/^\s+([a-zA-Z0-9_$]+)\s*\([^)]*\)\s*(?::\s*[^{]+)?\s*[{]/);
+            if (methMatch && !line.trim().startsWith("if ") && !line.trim().startsWith("for ") && !line.trim().startsWith("while ")) {
+                symbols.push({
+                    name: methMatch[1],
+                    type: "method",
+                    line: lineNum,
+                    signature: line.trim(),
+                });
+                continue;
+            }
+        }
+    }
+    return symbols;
+}

package/dist/workflow-runtime.d.ts

@@ -0,0 +1,45 @@
+import { WorkflowDefinition, WorkflowCheckpoint } from "./workflow-types.js";
+import { Message, ToolCall, ToolResult } from "./types.js";
+export declare class WorkflowRuntime {
+    private checkpointDir;
+    private currentCheckpoint;
+    private workflow;
+    constructor(checkpointDir: string);
+    init(): Promise<void>;
+    /**
+     * 开启一个新任务流
+     */
+    start(workflow: WorkflowDefinition, sessionId: string, initialContext: Message[]): Promise<WorkflowCheckpoint>;
+    /**
+     * 从 Checkpoint 恢复
+     */
+    resume(runId: string): Promise<WorkflowCheckpoint>;
+    /**
+     * 状态迁移
+     */
+    transitionTo(nextStateId: string, action?: string): Promise<void>;
+    /**
+     * 更新上下文快照
+     */
+    updateContext(messages: Message[]): Promise<void>;
+    /**
+     * 记录待执行工具
+     */
+    setPendingTools(toolCalls: ToolCall[]): Promise<void>;
+    /**
+     * 记录已完成工具结果
+     */
+    addToolResult(result: ToolResult): Promise<void>;
+    /**
+     * 标记为等待审批
+     */
+    awaitApproval(): Promise<void>;
+    /**
+     * 标记执行失败
+     */
+    fail(message: string, stack?: string): Promise<void>;
+    getCheckpoint(): WorkflowCheckpoint | null;
+    private saveCheckpoint;
+    private getCheckpointPath;
+}
+//# sourceMappingURL=workflow-runtime.d.ts.map

package/dist/workflow-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-runtime.d.ts","sourceRoot":"","sources":["../src/workflow-runtime.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAiB,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAmC;gBAEvC,aAAa,EAAE,MAAM;IAI3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBpH;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkBxD;;OAEG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvD;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO3D;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1D,aAAa,IAAI,kBAAkB,GAAG,IAAI;YAI5B,cAAc;IAM5B,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/workflow-runtime.js

@@ -0,0 +1,146 @@
+// ============================================================
+// 轻灵 - Workflow Runtime (v0.3)
+// 负责状态机执行、Checkpoint 落盘、崩溃恢复
+// ============================================================
+import * as fs from "fs/promises";
+import * as path from "path";
+import { existsSync } from "fs";
+export class WorkflowRuntime {
+    checkpointDir;
+    currentCheckpoint = null;
+    workflow = null;
+    constructor(checkpointDir) {
+        this.checkpointDir = checkpointDir;
+    }
+    async init() {
+        if (!existsSync(this.checkpointDir)) {
+            await fs.mkdir(this.checkpointDir, { recursive: true });
+        }
+    }
+    /**
+     * 开启一个新任务流
+     */
+    async start(workflow, sessionId, initialContext) {
+        this.workflow = workflow;
+        const runId = `run_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+        this.currentCheckpoint = {
+            runId,
+            workflowId: workflow.id,
+            sessionId,
+            status: "running",
+            currentState: workflow.initialState,
+            history: [],
+            contextSnapshot: initialContext,
+            pendingToolCalls: [],
+            completedToolResults: [],
+            updatedAt: Date.now(),
+        };
+        await this.saveCheckpoint();
+        return this.currentCheckpoint;
+    }
+    /**
+     * 从 Checkpoint 恢复
+     */
+    async resume(runId) {
+        const cpPath = this.getCheckpointPath(runId);
+        if (!existsSync(cpPath)) {
+            throw new Error(`Checkpoint not found for runId: ${runId}`);
+        }
+        const raw = await fs.readFile(cpPath, "utf-8");
+        this.currentCheckpoint = JSON.parse(raw);
+        // TODO: 这里需要加载对应的 WorkflowDefinition（可能需要持久化存储定义）
+        this.currentCheckpoint.status = "running";
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+        return this.currentCheckpoint;
+    }
+    /**
+     * 状态迁移
+     */
+    async transitionTo(nextStateId, action) {
+        if (!this.currentCheckpoint || !this.workflow)
+            return;
+        const fromState = this.currentCheckpoint.currentState;
+        this.currentCheckpoint.history.push({
+            timestamp: Date.now(),
+            fromState,
+            toState: nextStateId,
+            action,
+        });
+        this.currentCheckpoint.currentState = nextStateId;
+        this.currentCheckpoint.updatedAt = Date.now();
+        // 检查是否到达终点
+        const stateDef = this.workflow.states[nextStateId];
+        if (stateDef?.type === "end") {
+            this.currentCheckpoint.status = "completed";
+        }
+        await this.saveCheckpoint();
+    }
+    /**
+     * 更新上下文快照
+     */
+    async updateContext(messages) {
+        if (!this.currentCheckpoint)
+            return;
+        this.currentCheckpoint.contextSnapshot = messages;
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+    }
+    /**
+     * 记录待执行工具
+     */
+    async setPendingTools(toolCalls) {
+        if (!this.currentCheckpoint)
+            return;
+        this.currentCheckpoint.pendingToolCalls = toolCalls;
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+    }
+    /**
+     * 记录已完成工具结果
+     */
+    async addToolResult(result) {
+        if (!this.currentCheckpoint)
+            return;
+        this.currentCheckpoint.completedToolResults.push(result);
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+    }
+    /**
+     * 标记为等待审批
+     */
+    async awaitApproval() {
+        if (!this.currentCheckpoint)
+            return;
+        this.currentCheckpoint.status = "awaiting_approval";
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+    }
+    /**
+     * 标记执行失败
+     */
+    async fail(message, stack) {
+        if (!this.currentCheckpoint)
+            return;
+        this.currentCheckpoint.status = "failed";
+        this.currentCheckpoint.error = {
+            message,
+            stack,
+            stateId: this.currentCheckpoint.currentState,
+        };
+        this.currentCheckpoint.updatedAt = Date.now();
+        await this.saveCheckpoint();
+    }
+    getCheckpoint() {
+        return this.currentCheckpoint;
+    }
+    async saveCheckpoint() {
+        if (!this.currentCheckpoint)
+            return;
+        const cpPath = this.getCheckpointPath(this.currentCheckpoint.runId);
+        await fs.writeFile(cpPath, JSON.stringify(this.currentCheckpoint, null, 2), "utf-8");
+    }
+    getCheckpointPath(runId) {
+        return path.join(this.checkpointDir, `${runId}.checkpoint.json`);
+    }
+}