@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/timeline/history.js

@@ -0,0 +1,170 @@
+import { encodeServerFrameV2, getUtf8ByteLengthV2, MAX_FRAGMENT_DECODE_BYTES, MAX_HISTORY_CHUNK_BYTES, MAX_WINDOW_DECODE_BYTES, TimelineEventSchema, } from "../protocol/v2/index.js";
+const DEFAULT_EVENTS_PER_PAGE = 80;
+export class TimelineHistoryPager {
+    sessionManager;
+    recoverFn;
+    constructor(sessionManager, recoverFn) {
+        this.sessionManager = sessionManager;
+        this.recoverFn = recoverFn;
+    }
+    sync(request) {
+        const invalidRequest = this.validateRequest(request);
+        if (invalidRequest)
+            return [invalidRequest];
+        const snapshot = this.captureSnapshot();
+        if (!snapshot)
+            return [this.protocolError(request, "reset_required", "session has no current snapshot head")];
+        const initialScopeMismatch = this.snapshotInvalidReason(snapshot, request.leafId);
+        if (initialScopeMismatch)
+            return [this.reset(request, initialScopeMismatch)];
+        let records;
+        try {
+            records = this.recoverRecords(snapshot);
+        }
+        catch {
+            return [this.protocolError(request, "internal_error", "history recovery failed")];
+        }
+        const changed = this.snapshotInvalidReason(snapshot, request.leafId);
+        if (changed)
+            return [this.reset(request, changed)];
+        const headSeq = records.length;
+        const before = request.before ?? headSeq + 1;
+        if (before > headSeq + 1)
+            return [this.protocolError(request, "invalid_cursor", "history boundary is beyond the current head")];
+        const window = this.selectWindow(records, before, request.limit ?? DEFAULT_EVENTS_PER_PAGE);
+        if (window.kind === "error")
+            return [this.protocolError(request, "too_large", window.message)];
+        const nextBefore = window.records[0]?.event.event_seq;
+        const eos = window.records.length === 0 || nextBefore === 1;
+        try {
+            return this.fragmentWindow(request, snapshot, window.records, eos ? undefined : nextBefore);
+        }
+        catch (error) {
+            return [this.protocolError(request, "too_large", error instanceof Error ? error.message : "history chunk construction failed")];
+        }
+    }
+    validateRequest(request) {
+        if (request.before !== null && (!Number.isSafeInteger(request.before) || request.before < 1))
+            return this.protocolError(request, "invalid_cursor", "history boundary must be a positive safe integer or null");
+        if (request.limit !== undefined && (!Number.isInteger(request.limit) || request.limit < 1 || request.limit > 80))
+            return this.protocolError(request, "invalid_cursor", "history limit must be an integer from 1 through 80");
+        return null;
+    }
+    captureSnapshot() {
+        const sessionId = this.sessionManager.getSessionId();
+        const leafId = this.sessionManager.getLeafId() ?? null;
+        const branch = this.sessionManager.getBranch();
+        if (branch.length > 0 && branch.at(-1)?.id !== leafId)
+            return null;
+        return { sessionId, leafId, branchEntryIds: branch.map((entry) => entry.id) };
+    }
+    snapshotInvalidReason(snapshot, requestedLeafId) {
+        if (this.sessionManager.getSessionId() !== snapshot.sessionId)
+            return "session_replaced";
+        if (requestedLeafId !== snapshot.leafId)
+            return "branch_changed";
+        const currentLeafId = this.sessionManager.getLeafId() ?? null;
+        if (currentLeafId !== snapshot.leafId)
+            return "branch_changed";
+        const currentIds = this.sessionManager.getBranch().map((entry) => entry.id);
+        if (!sameIds(currentIds, snapshot.branchEntryIds))
+            return "branch_changed";
+        const frozenIds = snapshot.leafId === null ? currentIds : this.sessionManager.getBranch(snapshot.leafId).map((entry) => entry.id);
+        return sameIds(frozenIds, snapshot.branchEntryIds) ? null : "branch_changed";
+    }
+    recoverRecords(snapshot) {
+        const records = [];
+        const eventIds = new Set();
+        const sequences = new Set();
+        for (const rawEvent of this.recoverFn(this.sessionManager)) {
+            const parsed = TimelineEventSchema.safeParse(rawEvent);
+            if (!parsed.success || parsed.data.event_seq === undefined)
+                throw new Error("recovery returned an unsequenced timeline event");
+            const event = parsed.data;
+            if (event.session_id !== snapshot.sessionId || event.leaf_id !== snapshot.leafId)
+                throw new Error("recovery returned an event outside the snapshot scope");
+            if (eventIds.has(event.event_id) || sequences.has(event.event_seq))
+                throw new Error("recovery returned duplicate timeline identity");
+            eventIds.add(event.event_id);
+            sequences.add(event.event_seq);
+            records.push({ event, bytes: getUtf8ByteLengthV2(event) });
+        }
+        records.sort((left, right) => left.event.event_seq - right.event.event_seq);
+        if (records.some((record, index) => record.event.event_seq !== index + 1))
+            throw new Error("recovery returned a non-dense timeline sequence");
+        return records;
+    }
+    selectWindow(records, before, limit) {
+        const lower = Math.max(1, before - limit);
+        const requested = records.filter((record) => record.event.event_seq >= lower && record.event.event_seq < before);
+        const selected = [];
+        let bytes = 0;
+        for (let index = requested.length - 1; index >= 0; index -= 1) {
+            const record = requested[index];
+            if (record.bytes > MAX_WINDOW_DECODE_BYTES)
+                return { kind: "error", message: `event ${record.event.event_id} exceeds ${MAX_WINDOW_DECODE_BYTES} bytes` };
+            if (bytes + record.bytes > MAX_WINDOW_DECODE_BYTES)
+                break;
+            selected.unshift(record);
+            bytes += record.bytes;
+        }
+        return { kind: "ok", records: selected };
+    }
+    fragmentWindow(request, snapshot, records, nextBefore) {
+        const tailOverhead = this.finalFrameBytes(request, snapshot, { events: [], fragments: [] }, nextBefore) - this.nonFinalFrameBytes(request, snapshot, { events: [], fragments: [] });
+        const items = [];
+        for (const record of records) {
+            const fullFrame = this.makeChunk(request, snapshot, { events: [record.event], fragments: [] }, true, nextBefore);
+            if (getUtf8ByteLengthV2(fullFrame) <= MAX_HISTORY_CHUNK_BYTES) {
+                items.push({ kind: "event", event: record.event });
+                continue;
+            }
+            const encoded = new TextEncoder().encode(JSON.stringify(record.event));
+            let index = 0;
+            for (let offset = 0; offset < encoded.byteLength; offset += MAX_FRAGMENT_DECODE_BYTES) {
+                const slice = encoded.slice(offset, offset + MAX_FRAGMENT_DECODE_BYTES);
+                items.push({ kind: "fragment", eventId: record.event.event_id, index, dataBase64: Buffer.from(slice).toString("base64"), final: offset + slice.byteLength >= encoded.byteLength });
+                index += 1;
+            }
+        }
+        const payloads = [];
+        let current = { events: [], fragments: [] };
+        for (const item of items) {
+            const repeatedFragment = item.kind === "fragment" && current.fragments.some((fragment) => fragment.event_id === item.eventId);
+            const candidate = appendItem(current, item);
+            if (!repeatedFragment && this.nonFinalFrameBytes(request, snapshot, candidate) + tailOverhead <= MAX_HISTORY_CHUNK_BYTES) {
+                current = candidate;
+                continue;
+            }
+            if (current.events.length === 0 && current.fragments.length === 0)
+                throw new HistoryTooLargeError("history item cannot fit in a 512 KiB chunk");
+            payloads.push(current);
+            current = appendItem({ events: [], fragments: [] }, item);
+        }
+        if (current.events.length > 0 || current.fragments.length > 0 || payloads.length === 0)
+            payloads.push(current);
+        return payloads.map((payload, chunkIndex) => {
+            const final = chunkIndex === payloads.length - 1;
+            const frame = this.makeChunk(request, snapshot, payload, final, nextBefore, chunkIndex);
+            if (getUtf8ByteLengthV2(frame) > MAX_HISTORY_CHUNK_BYTES)
+                throw new HistoryTooLargeError("history chunk exceeds 512 KiB");
+            encodeServerFrameV2(frame);
+            return frame;
+        });
+    }
+    makeChunk(request, snapshot, payload, final, nextBefore, chunkIndex = 0) {
+        const tail = final ? nextBefore === undefined ? { final_chunk: true, eos: true } : { final_chunk: true, eos: false, next_before: nextBefore } : { final_chunk: false };
+        return { protocol_version: 2, type: "session_history_chunk", target_channel_id: request.targetChannelId, in_reply_to: request.requestId, session_id: snapshot.sessionId, leaf_id: snapshot.leafId, chunk_index: chunkIndex, events: payload.events, fragments: payload.fragments, ...tail };
+    }
+    nonFinalFrameBytes(request, snapshot, payload) { return getUtf8ByteLengthV2(this.makeChunk(request, snapshot, payload, false, undefined)); }
+    finalFrameBytes(request, snapshot, payload, nextBefore) { return getUtf8ByteLengthV2(this.makeChunk(request, snapshot, payload, true, nextBefore)); }
+    protocolError(request, code, message) { return { protocol_version: 2, type: "protocol_error", target_channel_id: request.targetChannelId, in_reply_to: request.requestId, code, message }; }
+    reset(request, reason) { return { protocol_version: 2, type: "reset", target_channel_id: request.targetChannelId, session_id: this.sessionManager.getSessionId(), leaf_id: this.sessionManager.getLeafId() ?? null, reason }; }
+}
+class HistoryTooLargeError extends Error {
+    constructor(message) { super(message); this.name = "HistoryTooLargeError"; }
+}
+function sameIds(left, right) { return left.length === right.length && left.every((id, index) => id === right[index]); }
+function appendItem(payload, item) { if (item.kind === "event")
+    return { events: [...payload.events, item.event], fragments: [...payload.fragments] }; return { events: [...payload.events], fragments: [...payload.fragments, { event_id: item.eventId, index: item.index, data_base64: item.dataBase64, final: item.final }] }; }
+//# sourceMappingURL=history.js.map

package/dist/timeline/history.js.map

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

package/dist/timeline/partial_delta.d.ts

@@ -0,0 +1,2 @@
+/** 按字符上限切分流式增量，不拆开 UTF-16 代理对。 */
+export declare function partialDeltaChunks(delta: string): string[];

package/dist/timeline/partial_delta.js

@@ -0,0 +1,16 @@
+const MAX_PARTIAL_DELTA_CHARS = 64 * 1024;
+/** 按字符上限切分流式增量，不拆开 UTF-16 代理对。 */
+export function partialDeltaChunks(delta) {
+    const chunks = [];
+    for (let offset = 0; offset < delta.length;) {
+        let end = Math.min(delta.length, offset + MAX_PARTIAL_DELTA_CHARS);
+        const finalCodeUnit = delta.charCodeAt(end - 1);
+        const nextCodeUnit = delta.charCodeAt(end);
+        if (end < delta.length && finalCodeUnit >= 0xD800 && finalCodeUnit <= 0xDBFF && nextCodeUnit >= 0xDC00 && nextCodeUnit <= 0xDFFF)
+            end -= 1;
+        chunks.push(delta.slice(offset, end));
+        offset = end;
+    }
+    return chunks;
+}
+//# sourceMappingURL=partial_delta.js.map

package/dist/timeline/partial_delta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial_delta.js","sourceRoot":"","sources":["../../src/timeline/partial_delta.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C,kCAAkC;AAClC,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;QAC5C,IAAI,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,IAAI,MAAM,IAAI,aAAa,IAAI,MAAM,IAAI,YAAY,IAAI,MAAM,IAAI,YAAY,IAAI,MAAM;YAAE,GAAG,IAAI,CAAC,CAAC;QAC3I,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/timeline/run_end.d.ts

@@ -0,0 +1,16 @@
+import { type MarkerV2, type TimelineEvent } from "../protocol/v2/index.js";
+export type RunEndStatus = "complete" | "interrupted" | "error";
+export type RunEndMarker = Extract<MarkerV2, {
+    kind: "run_end";
+}>;
+/** 以本次运行最后一条 assistant 消息的 stopReason 决定结束状态；没有 assistant 输出即视为被中断。 */
+export declare function runEndStatus(messages: readonly unknown[] | undefined): RunEndStatus;
+export declare function runEndMarker(groupId: string, status: RunEndStatus): RunEndMarker;
+export declare function isRunEndMarker(marker: MarkerV2): marker is RunEndMarker;
+/** run_end 没有对应的 Pi 消息，marker 条目本身就是正式事件，时间取条目写入时间。 */
+export declare function runEndEvent(marker: RunEndMarker, base: {
+    event_id: string;
+    session_id: string;
+    leaf_id: string | null;
+    timestamp: number;
+}): TimelineEvent;

package/dist/timeline/run_end.js

@@ -0,0 +1,23 @@
+import { MarkerSchemaV2, TimelineEventSchema } from "../protocol/v2/index.js";
+/** 以本次运行最后一条 assistant 消息的 stopReason 决定结束状态；没有 assistant 输出即视为被中断。 */
+export function runEndStatus(messages) {
+    const assistant = [...(messages ?? [])].reverse().find((message) => typeof message === "object" && message !== null && message.role === "assistant");
+    if (!assistant)
+        return "interrupted";
+    if (assistant.stopReason === "error")
+        return "error";
+    if (assistant.stopReason === "aborted")
+        return "interrupted";
+    return "complete";
+}
+export function runEndMarker(groupId, status) {
+    return MarkerSchemaV2.parse({ version: 2, group_id: groupId, kind: "run_end", status });
+}
+export function isRunEndMarker(marker) {
+    return marker.kind === "run_end";
+}
+/** run_end 没有对应的 Pi 消息，marker 条目本身就是正式事件，时间取条目写入时间。 */
+export function runEndEvent(marker, base) {
+    return TimelineEventSchema.parse({ ...base, group_id: marker.group_id, kind: "run_end", status: marker.status });
+}
+//# sourceMappingURL=run_end.js.map

package/dist/timeline/run_end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_end.js","sourceRoot":"","sources":["../../src/timeline/run_end.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAqC,MAAM,yBAAyB,CAAC;AAKjH,uEAAuE;AACvE,MAAM,UAAU,YAAY,CAAC,QAAwC;IACnE,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAA0D,EAAE,CACzH,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAK,OAA8B,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IAC3G,IAAI,CAAC,SAAS;QAAE,OAAO,aAAa,CAAC;IACrC,IAAI,SAAS,CAAC,UAAU,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACrD,IAAI,SAAS,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC;IAC7D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAoB;IAChE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAiB,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAgB;IAC7C,OAAO,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC;AACnC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CACzB,MAAoB,EACpB,IAAyF;IAEzF,OAAO,mBAAmB,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AACnH,CAAC"}

package/dist/timeline/runtime.d.ts

@@ -0,0 +1,89 @@
+import type { MessageUpdateEvent, SessionManager, ToolExecutionEndEvent, ToolExecutionStartEvent, ToolExecutionUpdateEvent } from "@earendil-works/pi-coding-agent";
+import { type JsonValue, type TimelineEvent, type TimelinePartial } from "../protocol/v2/index.js";
+export declare const TIMELINE_MARKER: "pi-reach:timeline-v2";
+type MessageRole = "user" | "assistant" | "toolResult";
+export type Correlation = {
+    /** 内部投递令牌只在内存回调链中流转，不写入 marker 或协议帧。 */
+    deliveryToken?: string;
+    clientRequestId?: string;
+    channelId?: string;
+    requestId?: string;
+    origin: "pwa" | "extension" | "unknown";
+    delivery: "normal" | "queued" | "unknown";
+    senderRef?: string;
+};
+type SessionEntry = ReturnType<SessionManager["getBranch"]>[number];
+export type TimelineStarted = {
+    eventId: string;
+    groupId: string;
+    role: MessageRole;
+    correlation: Correlation;
+    blocks: JsonValue[];
+};
+export type TimelineRuntimeOptions = {
+    onStarted?: (started: TimelineStarted) => void;
+    onPublished?: (event: TimelineEvent, correlation: Correlation) => void;
+    onPartial?: (partial: TimelinePartial, correlation: Correlation) => void;
+};
+export declare class TimelineRuntime {
+    private readonly correlations;
+    private readonly messageCorrelations;
+    private readonly pending;
+    private readonly pendingByRole;
+    private readonly published;
+    private readonly toolAssociations;
+    private sessionManager;
+    private epoch;
+    private stateRevision;
+    private activeGroupId;
+    private active;
+    private readonly onStarted?;
+    private readonly onPublished?;
+    private readonly onPartial?;
+    constructor(options?: TimelineRuntimeOptions);
+    attach(sessionManager: SessionManager): void;
+    resetSession(sessionManager: SessionManager): void;
+    private resetState;
+    get sessionId(): string | null;
+    get leafId(): string | null;
+    get currentEpoch(): number;
+    get currentGroupId(): string | null;
+    getPublishedEvents(): readonly TimelineEvent[];
+    getCorrelation(message: object): Correlation | undefined;
+    publishSessionEntry(entry: SessionEntry, sessionManager: SessionManager): TimelineEvent | null;
+    runWithCorrelation<T>(correlation: Correlation, callback: () => T): T;
+    currentCorrelation(): Correlation | undefined;
+    onAgentStart(): void;
+    /** 为本次运行的组写入 run_end marker，并在同组正式消息发布之后推送。 */
+    onAgentEnd(messages?: readonly unknown[]): void;
+    onMessageStart(message: unknown, sessionManager: SessionManager): TimelineStarted | null;
+    onMessageUpdate(event: MessageUpdateEvent, sessionManager: SessionManager): void;
+    onMessageEnd(message: unknown, sessionManager: SessionManager): void;
+    private publishWhenVisible;
+    onToolExecutionStart(event: ToolExecutionStartEvent, sessionManager: SessionManager): void;
+    onToolExecutionUpdate(event: ToolExecutionUpdateEvent, sessionManager: SessionManager): void;
+    onToolExecutionEnd(event: ToolExecutionEndEvent, sessionManager: SessionManager): void;
+    private publishToolPartial;
+    recover(sessionManager: SessionManager): TimelineEvent[];
+    private findPending;
+    private messageIdentity;
+    private publish;
+    private publishPartial;
+    private correlationFor;
+    private buildMarker;
+    private parseMarker;
+    private correlationFromMarker;
+    private roleForMarker;
+    private scanTargetAfterMarker;
+    private toTimelineEvent;
+    private toSystemEvent;
+    private asMessageRecord;
+    private messageRole;
+    private timestamp;
+    private userBlocks;
+    private assistantBlocks;
+    private textFromContent;
+    private nonEmpty;
+    private base64Length;
+}
+export {};