@yefengr/pi-reach 0.0.0-stage → 0.0.2

package/dist/timeline/user_delivery_binding.d.ts

@@ -0,0 +1,43 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { ClientFrame, ServerFrame, TimelineEvent } from "../protocol/v2/index.js";
+import type { Correlation, TimelineRuntime, TimelineStarted } from "./runtime.js";
+import { type UserDeliveryEnqueueResult, type UserDeliveryScopeInput, type UserDeliverySteerResult } from "./user_delivery.js";
+import type { TimelineV2Service } from "./v2_service.js";
+type UserMessageFrame = Extract<ClientFrame, {
+    type: "user_message";
+}>;
+export type UserDeliveryTarget = {
+    readonly service: TimelineV2Service;
+    readonly sessionId: string;
+    readonly leafId: string | null;
+};
+export type UserDeliveryBindingOptions = {
+    isIdle: () => boolean;
+    canAcceptNormal: () => boolean;
+    getPi: () => ExtensionAPI | null;
+    getTimeline: () => TimelineRuntime | null;
+    getCurrentSessionId: () => string | null;
+    getCurrentLeafId: () => string | null;
+    findTarget: (ownerId: string) => UserDeliveryTarget | null;
+    sendFrames: (ownerId: string, frames: readonly ServerFrame[]) => void;
+};
+export declare class UserDeliveryBinding {
+    private readonly options;
+    private readonly queue;
+    constructor(options: UserDeliveryBindingOptions);
+    submit(frame: UserMessageFrame, correlation: Correlation, scope: UserDeliveryScopeInput): UserDeliveryEnqueueResult | true;
+    snapshot(ownerId: string, service: TimelineV2Service): ServerFrame[];
+    clearQueued(ownerId: string, service: TimelineV2Service, targetId?: string): string[];
+    steerQueued(ownerId: string, service: TimelineV2Service, targetId: string): UserDeliverySteerResult;
+    onStarted(started: TimelineStarted): void;
+    onPublished(event: TimelineEvent, correlation: Correlation): void;
+    clearOwner(ownerId: string, service?: TimelineV2Service): void;
+    clearAll(): void;
+    scheduleDrain(): void;
+    private sendSteer;
+    private send;
+    private isCurrent;
+    private sendSnapshot;
+    private sendScope;
+}
+export {};

package/dist/timeline/user_delivery_binding.js

@@ -0,0 +1,107 @@
+import { UserDeliveryQueue, } from "./user_delivery.js";
+export class UserDeliveryBinding {
+    options;
+    queue;
+    constructor(options) {
+        this.options = options;
+        this.queue = new UserDeliveryQueue({
+            isIdle: options.isIdle,
+            isCurrent: (scope) => this.isCurrent(scope),
+            send: (content, correlation, sendOptions) => this.send(content, correlation, sendOptions),
+            onUnknownDelivery: (scope) => this.sendScope(scope, scope.service.unknownDelivery(scope.clientRequestId)),
+            onQueueChanged: (scope) => this.sendSnapshot(scope),
+            canQueueItem: (scope, item) => scope.service.canQueueItem(item),
+        });
+    }
+    submit(frame, correlation, scope) {
+        if (frame.streaming_behavior === "steer")
+            return this.sendSteer(messageContent(frame), correlation);
+        if (!this.options.canAcceptNormal())
+            return false;
+        return this.queue.enqueue(messageContent(frame), correlation, scope, messagePayload(frame));
+    }
+    snapshot(ownerId, service) {
+        return service.queueSnapshot(this.queue.snapshot(ownerId, service));
+    }
+    clearQueued(ownerId, service, targetId) {
+        return this.queue.clearQueued(ownerId, service, targetId).map((scope) => scope.clientRequestId);
+    }
+    steerQueued(ownerId, service, targetId) {
+        return this.queue.steer(ownerId, service, targetId);
+    }
+    onStarted(started) {
+        if (started.role !== "user")
+            return;
+        const scope = this.queue.onUserStarted(started);
+        if (!scope)
+            return;
+        this.sendScope(scope, scope.service.started(started));
+        this.sendSnapshot(scope);
+    }
+    onPublished(event, correlation) {
+        if (event.kind !== "user")
+            return;
+        const scope = this.queue.onUserPublished(event, correlation);
+        if (scope)
+            this.sendScope(scope, scope.service.commit(scope.clientRequestId, event.event_id, event.group_id));
+    }
+    clearOwner(ownerId, service) {
+        this.queue.clearOwner(ownerId, service);
+    }
+    clearAll() {
+        this.queue.clearAll();
+    }
+    scheduleDrain() {
+        this.queue.scheduleDrain();
+    }
+    sendSteer(content, correlation) {
+        try {
+            this.send(content, correlation, { deliverAs: "steer" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    send(content, correlation, options) {
+        const pi = this.options.getPi();
+        if (!pi)
+            throw new Error("Pi API is unavailable");
+        const send = () => pi.sendUserMessage(content, options);
+        const timeline = this.options.getTimeline();
+        if (timeline)
+            timeline.runWithCorrelation(correlation, send);
+        else
+            send();
+    }
+    isCurrent(scope) {
+        const target = this.options.findTarget(scope.ownerId);
+        return target?.service === scope.service
+            && target.sessionId === scope.sessionId
+            && this.options.getCurrentSessionId() === scope.sessionId
+            && this.options.getCurrentLeafId() === scope.leafId;
+    }
+    sendSnapshot(scope) {
+        if (this.isCurrent(scope))
+            this.options.sendFrames(scope.ownerId, this.snapshot(scope.ownerId, scope.service));
+    }
+    sendScope(scope, frames) {
+        if (this.isCurrent(scope))
+            this.options.sendFrames(scope.ownerId, frames);
+    }
+}
+function messageContent(frame) {
+    if (!frame.images?.length)
+        return frame.text;
+    return [
+        ...frame.images.map((image) => ({ type: "image", data: image.data, mimeType: image.mime })),
+        { type: "text", text: frame.text },
+    ];
+}
+function messagePayload(frame) {
+    return {
+        text: frame.text,
+        ...(frame.images?.length ? { images: frame.images.map((image) => ({ ...image })) } : {}),
+    };
+}
+//# sourceMappingURL=user_delivery_binding.js.map

package/dist/timeline/user_delivery_binding.js.map

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

package/dist/timeline/v2_service.d.ts

@@ -0,0 +1,82 @@
+import type { SessionManager } from "@earendil-works/pi-coding-agent";
+import { type ClientFrame, type ServerFrame, type TimelineEvent, type TimelinePartial } from "../protocol/v2/index.js";
+import type { Correlation, TimelineRuntime, TimelineStarted } from "./runtime.js";
+export type V2ActionFrame = Extract<ClientFrame, {
+    type: "session_new" | "session_compact" | "model_set" | "thinking_set";
+}>;
+export type V2ServiceOptions = {
+    sessionManager: SessionManager;
+    senderRef: string;
+    runtime: TimelineRuntime;
+    onUserMessage: (frame: Extract<ClientFrame, {
+        type: "user_message";
+    }>, correlation: Correlation) => boolean | "queued" | "duplicate" | "conflict" | "rejected";
+    onCancel?: () => boolean;
+    onAction?: (frame: V2ActionFrame) => void;
+    onQueueSnapshot?: () => ServerFrame[];
+    onQueuedMessageClear?: (targetId?: string) => string[];
+    onQueuedMessageSteer?: (targetId: string) => "sent" | "failed" | "missing";
+    onListModels?: () => Pick<Extract<ServerFrame, {
+        type: "models_list";
+    }>, "models" | "current">;
+};
+export type V2Broadcast = Extract<ServerFrame, {
+    type: "timeline_event" | "timeline_partial" | "timeline_event_fragment";
+}>;
+type QueuedMessageItem = Extract<ServerFrame, {
+    type: "queued_message_state";
+}>["items"][number];
+export declare class TimelineV2Service {
+    private readonly state;
+    private readonly pager;
+    private readonly sessionManager;
+    private readonly senderRef;
+    private readonly runtime;
+    private readonly onUserMessage;
+    private readonly onCancel?;
+    private readonly onAction?;
+    private readonly onQueueSnapshot?;
+    private readonly onQueuedMessageClear?;
+    private readonly onQueuedMessageSteer?;
+    private readonly onListModels?;
+    private readonly requestChannels;
+    constructor(options: V2ServiceOptions);
+    get sessionId(): string;
+    get leafId(): string | null;
+    canQueueItem(item: QueuedMessageItem): boolean;
+    queueSnapshot(items: readonly QueuedMessageItem[]): ServerFrame[];
+    reset(reason: "branch_changed" | "session_replaced"): ServerFrame[];
+    refreshScope(): boolean;
+    handle(frame: ClientFrame): ServerFrame[];
+    started(started: TimelineStarted): ServerFrame[];
+    commit(clientRequestId: string, messageId: string, groupId?: string): ServerFrame[];
+    canDrain(clientRequestId: string): boolean;
+    unknownDelivery(clientRequestId: string): ServerFrame[];
+    partial(partial: TimelinePartial): V2Broadcast | null;
+    publish(event: TimelineEvent): V2Broadcast | null;
+    publishFrames(event: TimelineEvent): V2Broadcast[];
+    private ready;
+    private handleHistory;
+    private handlePing;
+    private handleQueuedMessageClear;
+    private handleQueuedMessageSteer;
+    private handleCancel;
+    private handleObserved;
+    private handleUserMessage;
+    private replay;
+    private status;
+    private handleListModels;
+    private handleAction;
+    private requireReady;
+    private ensureReady;
+    private currentQueueSnapshot;
+    private queueFrame;
+    private frameBytes;
+    private terminateQueuedRequest;
+    private direct;
+    private error;
+    private idempotencyPayload;
+    private recordKey;
+    private findRecord;
+}
+export {};