@caupulican/pi-agent-core 0.93.18 → 0.94.0

package/dist/session/lifecycle-ledger.d.ts

@@ -0,0 +1,173 @@
+import type { SessionEntry, SessionEntryBase } from "./session-manager.ts";
+/** Maximum serialized size for one lifecycle payload. Lifecycle records are a ledger, not a payload store. */
+export declare const MAX_LIFECYCLE_PAYLOAD_CHARS: number;
+export interface RequestSnapshotEntry extends SessionEntryBase {
+    type: "request_snapshot";
+    requestId: string;
+    reason: "initial" | "resume" | "change";
+    api: string;
+    provider: string;
+    modelId: string;
+    effectiveConfigFingerprint: string;
+    systemFingerprint: string;
+    toolsFingerprint: string;
+    historyFingerprint: string;
+    messageEntryIds: string[];
+}
+export type SessionRequestSnapshotInput = Omit<RequestSnapshotEntry, "type" | "id" | "parentId" | "timestamp">;
+export interface ForegroundToolStartEntry extends SessionEntryBase {
+    type: "foreground_tool_start";
+    requestId: string;
+    assistantMessageEntryId: string;
+    callId: string;
+    toolName: string;
+}
+export type ForegroundToolStartInput = Omit<ForegroundToolStartEntry, "type" | "id" | "parentId" | "timestamp">;
+export interface ForegroundToolTerminalEntry extends SessionEntryBase {
+    type: "foreground_tool_terminal";
+    requestId: string;
+    assistantMessageEntryId: string;
+    callId: string;
+    toolName: string;
+    outcome: "success" | "error" | "cancelled";
+    resultMessageEntryId: string;
+    errorKind?: "tool_failure" | "operation_outcome";
+}
+export interface CompactionStartEntry extends SessionEntryBase {
+    type: "compaction_start";
+    compactionId: string;
+    firstKeptEntryId: string;
+    tokensBefore: number;
+}
+export interface CompactionEndEntry extends SessionEntryBase {
+    type: "compaction_end";
+    compactionId: string;
+    outcome: "success" | "failure" | "cancelled" | "interrupted";
+    compactionEntryId?: string;
+    error?: string;
+}
+export type SessionLifecycleEntry = RequestSnapshotEntry | ForegroundToolStartEntry | ForegroundToolTerminalEntry | CompactionStartEntry | CompactionEndEntry;
+export declare const TOOL_NOT_STARTED = "TOOL_NOT_STARTED";
+export declare const TOOL_OUTCOME_UNKNOWN = "TOOL_OUTCOME_UNKNOWN";
+/** Runtime validation for all persisted lifecycle records. */
+export declare function validateSessionLifecycleEntry(value: unknown): asserts value is SessionLifecycleEntry;
+export declare function isSessionLifecycleEntry(entry: SessionEntry): entry is SessionLifecycleEntry;
+export declare function validateLoadedLifecycleEntries(entries: readonly (SessionEntry | {
+    type: "session";
+})[]): void;
+export declare function encodeSessionLifecycleEntry(entry: SessionLifecycleEntry): string;
+export declare function decodeSessionLifecycleEntry(value: unknown): SessionLifecycleEntry;
+export declare function encodeSessionEntry(entry: SessionEntry): string;
+export interface SessionLifecycleAssistantToolCall {
+    requestId?: string;
+    assistantMessageEntryId: string;
+    callId: string;
+    modelOrder: number;
+    position: number;
+    toolName: string;
+}
+export interface SessionLifecycleToolResult {
+    requestId?: string;
+    assistantMessageEntryId?: string;
+    callId: string;
+    resultMessageEntryId: string;
+    position: number;
+    toolName: string;
+    isError: boolean;
+    errorKind?: "tool_failure" | "operation_outcome";
+}
+export interface SessionLifecycleToolRecord {
+    starts: readonly ForegroundToolStartEntry[];
+    terminals: readonly ForegroundToolTerminalEntry[];
+    assistantCalls: readonly SessionLifecycleAssistantToolCall[];
+    results: readonly SessionLifecycleToolResult[];
+    start?: ForegroundToolStartEntry;
+    terminal?: ForegroundToolTerminalEntry;
+    result?: SessionLifecycleToolResult;
+}
+export interface SessionLifecycleCompactionRecord {
+    starts: readonly CompactionStartEntry[];
+    ends: readonly CompactionEndEntry[];
+    start?: CompactionStartEntry;
+    end?: CompactionEndEntry;
+}
+export interface SessionLifecycleIndex {
+    branchEntryIds: readonly string[];
+    entryPositions: ReadonlyMap<string, number>;
+    entryTypes: ReadonlyMap<string, string>;
+    entriesById: ReadonlyMap<string, SessionEntry>;
+    requestSnapshots: readonly RequestSnapshotEntry[];
+    assistantToolCalls: readonly SessionLifecycleAssistantToolCall[];
+    toolResults: readonly SessionLifecycleToolResult[];
+    toolsByIdentity: ReadonlyMap<string, SessionLifecycleToolRecord>;
+    compactionsById: ReadonlyMap<string, SessionLifecycleCompactionRecord>;
+    ambiguousResultEntryIds: readonly string[];
+    unmatchedResultEntryIds: readonly string[];
+}
+export interface SessionLifecycleUnstartedTool {
+    requestId?: string;
+    assistantMessageEntryId: string;
+    toolName: string;
+    callId: string;
+}
+export interface SessionLifecycleUnknownToolOutcome {
+    requestId: string;
+    assistantMessageEntryId: string;
+    toolName: string;
+    callId: string;
+    startEntryId: string;
+}
+export interface SessionLifecycleTerminalPromotion {
+    requestId?: string;
+    assistantMessageEntryId: string;
+    toolName: string;
+    callId: string;
+    resultMessageEntryId: string;
+    outcome: "success" | "error";
+    errorKind?: "tool_failure" | "operation_outcome";
+}
+export interface SessionLifecycleInspection extends SessionLifecycleIndex {
+    refusalReasons: readonly string[];
+    duplicateRequestSnapshots: readonly RequestSnapshotEntry[];
+    unmatchedToolStarts: readonly ForegroundToolStartEntry[];
+    unmatchedToolTerminals: readonly ForegroundToolTerminalEntry[];
+    duplicateToolStarts: readonly ForegroundToolStartEntry[];
+    duplicateToolTerminals: readonly ForegroundToolTerminalEntry[];
+    duplicateAssistantToolCalls: readonly SessionLifecycleAssistantToolCall[];
+    duplicateToolResults: readonly SessionLifecycleToolResult[];
+    mismatchedToolEntries: readonly string[];
+    outOfOrderToolEntries: readonly string[];
+    unstartedTools: readonly SessionLifecycleUnstartedTool[];
+    unknownToolOutcomes: readonly SessionLifecycleUnknownToolOutcome[];
+    unmatchedCompactionEnds: readonly CompactionEndEntry[];
+    duplicateCompactionStarts: readonly CompactionStartEntry[];
+    duplicateCompactionEnds: readonly CompactionEndEntry[];
+    outOfOrderCompactionEntries: readonly string[];
+    invalidCompactionReferences: readonly string[];
+    orphanedCompactions: readonly CompactionStartEntry[];
+    terminalPromotions: readonly SessionLifecycleTerminalPromotion[];
+    balanced: boolean;
+}
+export interface SessionLifecycleRepairPlan {
+    refused: boolean;
+    refusalReasons: readonly string[];
+    toolClosers: readonly {
+        requestId?: string;
+        assistantMessageEntryId: string;
+        toolName: string;
+        callId: string;
+        code: typeof TOOL_NOT_STARTED | typeof TOOL_OUTCOME_UNKNOWN;
+        sourceEntryId?: string;
+    }[];
+    terminalPromotions: readonly SessionLifecycleTerminalPromotion[];
+    compactionClosers: readonly {
+        compactionId: string;
+        sourceEntryId: string;
+        outcome: "interrupted";
+    }[];
+}
+export declare function sessionLifecycleToolIdentityKey(requestId: string | undefined, assistantMessageEntryId: string, callId: string): string;
+export declare function indexSessionLifecycle(entries: readonly SessionEntry[], leafId?: string | null): SessionLifecycleIndex;
+export declare function inspectSessionLifecycle(entries: readonly SessionEntry[], leafId?: string | null): SessionLifecycleInspection;
+export declare function planSessionLifecycleRepair(entries: readonly SessionEntry[], leafId?: string | null): SessionLifecycleRepairPlan;
+//# sourceMappingURL=lifecycle-ledger.d.ts.map

package/dist/session/lifecycle-ledger.d.ts.map

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