@osolmaz/pi-workflows 0.15.2 → 0.16.0

package/README.md

@@ -80,10 +80,10 @@ All live workflow and controller state uses one local database:
 ```
 
 Runs, decisions, queues, claims, controllers, session capture, notifications,
-channel transport state, effects, and large text values all live there.
-Viewers open the database read-only, and every write checks its actor,
-expected revision, and owner lease when required. See
-[SQLite state](docs/SQLITE_STATE.md).
+channel transport state, effects, and large text values all live there. The
+package-owned host is the only production process that opens the active
+database. The extension, CLI, Herdr adapter, and `piw` use the same versioned
+local client protocol. See [SQLite state](docs/SQLITE_STATE.md).
 
 ## Quick start
 
@@ -254,8 +254,8 @@ Run the same command after a pi-workflows update. `pi-workflows herdr setup`
 remains an alias for existing installations.
 
 When Pi runs inside Herdr, the workflow widget shows a `Ctrl+Shift+R piw`
-shortcut. The shortcut opens the exact SQLite run state and lets you choose a
-split, tab, or new workspace. `/piw` opens the same menu, and `/piw right`,
+shortcut. The shortcut opens the exact host-owned run view and lets you choose
+a split, tab, or new workspace. `/piw` opens the same menu, and `/piw right`,
 `/piw below`, `/piw left`, `/piw above`, `/piw tab`, or `/piw workspace`
 selects a placement directly. If a viewer for that run already exists,
 pi-workflows focuses it instead of opening a duplicate.

package/dist/client/activity.d.ts

@@ -0,0 +1,2 @@
+export declare const ORIGIN_ACTIVITY_REFRESH_MS = 1000;
+export declare const ORIGIN_ACTIVITY_LEASE_MS = 4000;

package/dist/client/activity.js

@@ -0,0 +1,6 @@
+export const ORIGIN_ACTIVITY_REFRESH_MS = 1_000;
+export const ORIGIN_ACTIVITY_LEASE_MS = 4_000;
+if (ORIGIN_ACTIVITY_REFRESH_MS >= ORIGIN_ACTIVITY_LEASE_MS) {
+    throw new Error("Origin activity refresh period must be shorter than its lease");
+}
+//# sourceMappingURL=activity.js.map

package/dist/client/activity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.js","sourceRoot":"","sources":["../../src/client/activity.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,CAAC;AAE9C,IAAI,0BAA0B,IAAI,wBAAwB,EAAE,CAAC;IAC3D,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;AACnF,CAAC"}

package/dist/client/client.d.ts

@@ -0,0 +1,101 @@
+import { type JsonValue } from "../state/json.js";
+import { type ClientEvent, type ClientHello, type ClientOperation, type ClientResponse } from "./protocol.js";
+import type { ResolvedControllerInitialization, ResolvedSettingsChange, ResolvedWorkflowLaunch } from "./resolver.js";
+import type { WorkflowRunView } from "./view.js";
+export declare class WorkflowClientVersionError extends Error {
+    constructor(message: string);
+}
+export type WorkflowClientOptions = {
+    clientId?: string;
+    databasePath?: string;
+    hostEntryPath?: string;
+    env?: Record<string, string>;
+};
+export declare class WorkflowClient {
+    readonly clientId: string;
+    readonly databasePath: string;
+    readonly endpoint: string;
+    private readonly hostEntryPath;
+    private readonly env;
+    private socket;
+    private connectTask;
+    private hello;
+    private closed;
+    private reconnectTimer;
+    private readonly pending;
+    private readonly subscriptions;
+    constructor(options?: WorkflowClientOptions);
+    get connectionId(): string | undefined;
+    get packageVersion(): string | undefined;
+    connect(): Promise<ClientHello>;
+    request(options: {
+        operation: ClientOperation;
+        requestId?: string;
+        idempotencyKey?: string;
+        runId?: string;
+        expectedRevision?: number;
+        payload?: JsonValue;
+        signal?: AbortSignal;
+    }): Promise<ClientResponse>;
+    requestDurable(options: {
+        operation: ClientOperation;
+        requestId?: string;
+        idempotencyKey: string;
+        runId?: string;
+        expectedRevision?: number;
+        payload?: JsonValue;
+        signal?: AbortSignal;
+    }): Promise<ClientResponse>;
+    getRun(runId: string): Promise<WorkflowRunView | null>;
+    watchRuns(listener: (event: ClientEvent) => void, options?: {
+        subscriptionId?: string;
+        limit?: number;
+    }): Promise<() => Promise<void>>;
+    watchRun(runId: string, listener: (event: ClientEvent) => void, options?: {
+        subscriptionId?: string;
+        revision?: number;
+    }): Promise<() => Promise<void>>;
+    watchSession(sessionId: string, listener: (event: ClientEvent) => void, options?: {
+        subscriptionId?: string;
+    }): Promise<() => Promise<void>>;
+    ensureAvailable(): Promise<ClientHello>;
+    ensureRunning(): Promise<ClientResponse>;
+    readContent(runId: string, contentPath: string): Promise<{
+        mediaType: string;
+        content: Buffer;
+    }>;
+    hydrateContent(runId: string, value: JsonValue): Promise<JsonValue>;
+    private hydrateContentValue;
+    resolveWorkflow(options: {
+        cwd: string;
+        workflowRef: string;
+        timeoutMs?: number;
+    }): Promise<ResolvedWorkflowLaunch>;
+    resolveControllerInitialization(options: {
+        cwd: string;
+        controllerName: string;
+        spec: JsonValue;
+        timeoutMs?: number;
+    }): Promise<ResolvedControllerInitialization>;
+    resolveSettingsChange(options: {
+        cwd: string;
+        workflowRef: string;
+        definitionDigest: string;
+        mountPath: string;
+        current: JsonValue;
+        patch: JsonValue;
+        actorId: string;
+        timeoutMs?: number;
+    }): Promise<ResolvedSettingsChange>;
+    close(): Promise<void>;
+    private subscribe;
+    private requestConnected;
+    private send;
+    private openConnection;
+    private deliverSubscriptionEvent;
+    private restoreSubscriptions;
+    private resetConnection;
+    private scheduleReconnect;
+    private runResolver;
+    private startDetached;
+}