@downcity/agent 1.1.237 → 1.1.258

package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts

@@ -1,116 +0,0 @@
-/**
- * JsonlSessionHistoryStore：基于 JSONL 的 session records 事实源。
- *
- * 关键点（中文）
- * - 负责 `.downcity/.../messages/messages.jsonl`、`meta.json`、archive 与文件锁。
- * - append 与 compact 共用同一把文件锁，避免并发覆盖。
- * - 不负责为模型组装 messages；组装逻辑放在 `JsonlSessionHistoryComposer`。
- */
-import type { SessionActionRecordV1, SessionRecordV1, SessionMetadataV1 } from "../../../../executor/types/SessionRecords.js";
-import type { SessionHistoryPathOverrides } from "../../../../executor/types/SessionHistoryPaths.js";
-import type { SessionHistoryCompactInput, SessionHistoryStore } from "../../../../executor/store/history/SessionHistoryStore.js";
-/**
- * JSONL history store 构造参数。
- */
-export type JsonlSessionHistoryStoreOptions = {
-    /**
-     * 当前项目根目录。
-     */
-    rootPath: string;
-    /**
-     * 当前 agentId。
-     *
-     * 关键点（中文）
-     * - 仅在未提供 `paths` 覆盖时必需。
-     * - 默认目录统一收敛到 `.downcity/agents/<agentId>/sessions/...`。
-     */
-    agentId?: string;
-    /**
-     * 当前 sessionId。
-     */
-    sessionId?: string;
-    /**
-     * 可选路径覆盖，供 SDK session / task run 复用同一 JSONL store。
-     */
-    paths?: SessionHistoryPathOverrides;
-};
-/**
- * JSONL Session history store。
- */
-export declare class JsonlSessionHistoryStore implements SessionHistoryStore {
-    readonly sessionId: string;
-    private readonly rootPath;
-    private readonly agentId?;
-    private readonly overrideSessionDirPath?;
-    private readonly overrideMessagesDirPath?;
-    private readonly overrideMessagesFilePath?;
-    private readonly overrideMetaFilePath?;
-    private readonly overrideArchiveDirPath?;
-    private readonly overrideInflightFilePath?;
-    constructor(options: JsonlSessionHistoryStoreOptions);
-    private readOptionalPath;
-    private getMessagesDirPath;
-    private getMessagesFilePath;
-    private getMetaFilePath;
-    private getArchiveDirPath;
-    private getInflightFilePath;
-    private getLockFilePath;
-    private ensureLayout;
-    private normalizeText;
-    private normalizePersistedMessage;
-    private normalize_action_record;
-    private hasStructuredAssistantParts;
-    private mergeInflightWithFinal;
-    private readMetaUnsafe;
-    private writeMetaUnsafe;
-    private read_inflight_unsafe;
-    private write_inflight_unsafe;
-    private removeInflightUnsafe;
-    private appendMessageUnsafe;
-    private get_history_bytes_unsafe;
-    private read_persisted_records_unsafe;
-    private write_history_summary_unsafe;
-    private update_history_summary_after_append_unsafe;
-    private rewriteMessagesUnsafe;
-    private upsert_action_record_unsafe;
-    private withWriteLock;
-    private normalizeSystem;
-    compact(input: SessionHistoryCompactInput): Promise<{
-        compacted: boolean;
-        reason?: string;
-    }>;
-    write_record(message: SessionRecordV1): Promise<void>;
-    /**
-     * 批量追加消息。
-     *
-     * 关键点（中文）
-     * - 一次锁、一次 IO，适合 fork 等需要拷贝整段历史的场景。
-     * - 不处理 inflight，调用方需自行确保历史已经收口。
-     */
-    write_records(messages: SessionRecordV1[]): Promise<void>;
-    read_inflight(): Promise<SessionRecordV1 | null>;
-    write_inflight(message: SessionRecordV1): Promise<void>;
-    finalize_inflight(message?: SessionRecordV1 | null): Promise<void>;
-    list_records(): Promise<SessionRecordV1[]>;
-    slice_records(start: number, end: number): Promise<SessionRecordV1[]>;
-    record_count(): Promise<number>;
-    meta(): Promise<Record<string, unknown>>;
-    userText(input: {
-        text: string;
-        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
-        id?: string;
-    }): SessionRecordV1;
-    assistantText(input: {
-        text: string;
-        metadata: Omit<SessionMetadataV1, "v" | "ts"> & Partial<Pick<SessionMetadataV1, "ts">>;
-        id?: string;
-        kind?: "normal" | "summary";
-        source?: "egress" | "compact";
-    }): SessionRecordV1;
-    action(input: {
-        action: SessionActionRecordV1;
-        metadata: Pick<SessionMetadataV1, "sessionId"> & Partial<Pick<SessionMetadataV1, "ts">>;
-        id?: string;
-    }): SessionActionRecordV1;
-}
-//# sourceMappingURL=JsonlSessionHistoryStore.d.ts.map

package/bin/executor/store/history/jsonl/JsonlSessionHistoryStore.d.ts.map

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