harnery 0.42.0 → 0.44.0

package/dist/core/workflow/workspaces/recovery.js

@@ -3,16 +3,6 @@ import { join, resolve } from "node:path";
 import { readWorkflowProof } from "../proof.js";
 export function readWorkflowLiveness(coordRoot, runId) {
     const root = resolve(coordRoot);
-    const proofPath = join(root, ".harnery", "workflows", runId, "proof.json");
-    if (existsSync(proofPath)) {
-        try {
-            const proof = readWorkflowProof(root, runId);
-            return ["succeeded", "failed"].includes(proof.run.status) ? "inactive" : "unknown";
-        }
-        catch {
-            return "unknown";
-        }
-    }
     const transcriptPath = join(root, ".harnery", "workflows", runId, "transcript.jsonl");
     if (!existsSync(transcriptPath))
         return "unknown";
@@ -26,12 +16,16 @@ export function readWorkflowLiveness(coordRoot, runId) {
     catch {
         return "unknown";
     }
-    if (events.some((item) => item.run_id !== runId || typeof item.event !== "string")) {
+    if (events.some((item) => !item ||
+        typeof item !== "object" ||
+        Array.isArray(item) ||
+        item.run_id !== runId ||
+        typeof item.event !== "string")) {
         return "unknown";
     }
     let liveness;
     for (const item of events) {
-        if (item.event === "run.start" || item.event === "run.resume")
+        if (item.event === "run.start" || item.event === "run.resume" || item.event === "agent.start")
             liveness = "active";
         if (item.event === "run.parked")
             liveness = "inactive";
@@ -46,5 +40,19 @@ export function readWorkflowLiveness(coordRoot, runId) {
             liveness = "inactive";
         }
     }
-    return liveness ?? "unknown";
+    // A terminal proof can predate a resumed run. Only the current transcript
+    // can establish that no later activity invalidated that terminal observation.
+    if (liveness !== "inactive")
+        return liveness ?? "unknown";
+    const proofPath = join(root, ".harnery", "workflows", runId, "proof.json");
+    if (existsSync(proofPath)) {
+        try {
+            const proof = readWorkflowProof(root, runId);
+            return ["succeeded", "failed"].includes(proof.run.status) ? "inactive" : "unknown";
+        }
+        catch {
+            return "unknown";
+        }
+    }
+    return "inactive";
 }

package/dist/core/workflow/workspaces/state.d.ts

@@ -44,6 +44,7 @@ export declare function workspaceLockPath(coordRoot: string, providerId: string,
 export declare function writeWorkspaceRequest(coordRoot: string, request: WorkspaceAllocationRequest): string;
 export declare function readWorkspaceRequest(coordRoot: string, runId: string): WorkspaceAllocationRequest | undefined;
 export declare function writeWorkspaceClaim(coordRoot: string, claim: WorkspaceClaim): boolean;
+export declare function readWorkspaceClaims(coordRoot: string, providerId: string): WorkspaceClaim[];
 export declare function readWorkspaceClaim(coordRoot: string, providerId: string, bindingId: string): WorkspaceClaim | undefined;
 export declare function writeWorkspaceBinding(coordRoot: string, binding: WorkspaceBinding): boolean;
 export declare function readWorkspaceBinding(coordRoot: string, providerId: string, bindingId: string): WorkspaceBinding | undefined;

package/dist/core/workflow/workspaces/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/workspaces/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../src/core/workflow/workspaces/state.ts"],"names":[],"mappings":"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"}

package/dist/core/workflow/workspaces/state.js

@@ -1,7 +1,8 @@
-import { chmodSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, statSync, writeFileSync, } from "node:fs";
+import { chmodSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readdirSync, readFileSync, statSync, writeFileSync, } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 import { stateDirMode, stateFileMode } from "../../storage/modes.js";
 import { canonicalJson, fsyncParentDirectory, readJsonRecord, stableDigest, writeImmutableJson, } from "../durable-record.js";
+import { assertClaimAuthority, publishWorkspaceClaim } from "./ownership.js";
 export { appendWorkflowTranscriptEvent } from "../transcript.js";
 const JSON_LIMIT = 512 * 1024;
 const WORKSPACE_EVENT_BYTES = 32 * 1024;
@@ -39,6 +40,9 @@ export function readWorkspaceRequest(coordRoot, runId) {
         : undefined;
 }
 export function writeWorkspaceClaim(coordRoot, claim) {
+    return publishWorkspaceClaim(coordRoot, claim, () => writeClaim(coordRoot, claim));
+}
+function writeClaim(coordRoot, claim) {
     const path = workspaceClaimPath(coordRoot, claim.provider_id, claim.binding_id);
     try {
         return writeImmutableJson(path, claim);
@@ -52,6 +56,22 @@ export function writeWorkspaceClaim(coordRoot, claim) {
         throw error;
     }
 }
+export function readWorkspaceClaims(coordRoot, providerId) {
+    const root = join(resolve(coordRoot), ".harnery", "workspaces", providerId);
+    if (!existsSync(root))
+        return [];
+    return readdirSync(root, { withFileTypes: true })
+        .filter((entry) => entry.name !== ".leases")
+        .map((entry) => {
+        if (!entry.isDirectory())
+            throw new Error("retained workspace inventory is unproven");
+        const claim = readWorkspaceClaim(coordRoot, providerId, entry.name);
+        if (!claim)
+            throw new Error("retained workspace ownership claim is missing");
+        assertClaimAuthority(claim, providerId, entry.name);
+        return claim;
+    });
+}
 export function readWorkspaceClaim(coordRoot, providerId, bindingId) {
     const path = workspaceClaimPath(coordRoot, providerId, bindingId);
     return existsSync(path) ? readJsonRecord(path, "workspace claim") : undefined;

package/dist/lib/browser/windows-chrome.d.ts

@@ -28,31 +28,119 @@ interface CdpCookie {
 }
 /** Keep the sign-in site's cookies and normalize them to the store's shape. */
 export declare function cookiesForDomain(cdpCookies: CdpCookie[], domain: string): Cookie[];
+/**
+ * Regular expression, valid in both JavaScript and .NET, that matches a Chrome
+ * command line running on `profileWindows`. It matches the `--user-data-dir`
+ * argument exactly, with or without quotes around the path, so `...\profile`
+ * never matches `...\profile-2`. Quotes are written as `\x22` so the pattern
+ * survives being passed to PowerShell as an argument. Case-insensitive use is
+ * intended, as Windows paths are.
+ */
+export declare function profileCommandLinePattern(profileWindows: string): string;
+/**
+ * PowerShell that sets the profile's startup preference to "continue where
+ * you left off". Chrome deletes browser-session cookies (cookies with no
+ * expiry) when it exits normally unless that preference is set, and many
+ * sign-ins keep the signed-in state only in such cookies. With it set, the
+ * person can simply close the window and the sign-in survives for the
+ * harvest, and the next sign-in window reopens where they left off.
+ *
+ * The preference is protected against edits to the profile's files, so the
+ * script sets it the way the settings page does: it opens the profile
+ * headless, loads the settings page, and calls the settings API there. When
+ * the profile's preference files already show the value, Chrome is not
+ * started. The script prints `{"changed":bool,"value":n}`.
+ */
+export declare function keepSessionScript(): string;
 /**
  * PowerShell that does the whole read on the Windows side: start Chrome
- * headless on the profile, wait for the DevToolsActivePort file it writes,
- * read every cookie with `Storage.getCookies`, write the raw response to
- * stdout, and close the browser. WSL never touches the profile folder, which
- * it may not be able to list. Every wait carries a deadline.
+ * headless on the profile with its last session restored, read every cookie
+ * with `Storage.getCookies`, list the open pages with `Target.getTargets`,
+ * write both raw responses to stdout as one JSON object, and close the
+ * browser. WSL never touches the profile folder, which it may not be able to
+ * list. Every wait carries a deadline.
+ *
+ * Restoring the session keeps browser-session cookies that a forced stop left
+ * on disk, and it reopens the tabs the person had open, so the harvest can
+ * report the last page they reached on the sign-in site. That page's URL may
+ * carry a per-session token that cookies alone do not replace. The page list
+ * is polled for up to `$PageSeconds` until a page on `$Domain` appears.
  */
 export declare function harvestScript(): string;
+/** Shape `Target.getTargets` returns; extra fields are ignored. */
+interface CdpTargetInfo {
+    type: string;
+    url: string;
+}
 /**
- * Reopen the Windows profile headless, read its cookies for `domain`, and
- * close it. Returns the cookies in the store's shape.
+ * URLs of the open pages on the sign-in site, in the order Chrome lists them,
+ * without duplicates.
+ */
+export declare function sitePages(targets: CdpTargetInfo[], domain: string): string[];
+export interface WindowsChromeHarvest {
+    /** The sign-in site's cookies, browser-session cookies included. */
+    cookies: Cookie[];
+    /** Open pages on the sign-in site; the first is the one to resume from. */
+    pages: string[];
+}
+/** Parse the harvest script's stdout. */
+export declare function parseHarvestOutput(stdout: string, domain: string): WindowsChromeHarvest;
+/**
+ * Reopen the Windows profile headless with its last session restored, read
+ * its cookies for `domain` and its open pages on that site, and close it.
+ * The profile must already be closed; see `stopWindowsChromeProfile`.
  */
 export declare function harvestWindowsChromeCookies(input: {
     chromeWindows: string;
     profileWindows: string;
     domain: string;
     startupTimeoutSeconds?: number;
-}): Cookie[];
+    pageTimeoutSeconds?: number;
+}): WindowsChromeHarvest;
+export interface WindowsChromeKeepSession {
+    /** True when the preference was already set or is now set. */
+    kept: boolean;
+    /** True when this call changed the preference. */
+    changed: boolean;
+}
+/**
+ * Set the profile to keep browser-session cookies across a normal exit; see
+ * `keepSessionScript`. Throws when Chrome is already open on the profile,
+ * since a second sign-in window would hand off to it. Any other failure
+ * returns `kept: false` so the caller can warn and continue.
+ */
+export declare function keepWindowsChromeSession(input: {
+    chromeWindows: string;
+    profileWindows: string;
+    startupTimeoutSeconds?: number;
+}): WindowsChromeKeepSession;
+/**
+ * PowerShell that closes every Chrome whose command line matches `$Pattern`. It asks each window to
+ * close, repeating so a profile with several windows closes them all, which
+ * lets Chrome write its cookies and session to disk. Whatever is still
+ * running after `$CloseSeconds` is stopped by force. The script prints
+ * `{found, forced, remaining}` as JSON; `remaining` lists process ids that
+ * survived even the forced stop.
+ */
+export declare function stopScript(): string;
+export interface WindowsChromeStop {
+    /** Chrome processes running on the profile when the stop began. */
+    found: number;
+    /** Processes that ignored the close request and were stopped by force. */
+    forced: number;
+}
+/** Parse the stop script's stdout; throws when a process survived. */
+export declare function parseStopOutput(stdout: string, profileWindows: string): WindowsChromeStop;
 /**
- * Close any Chrome still running on `profileWindows`, for when the person ends
- * the sign-in from the terminal while the window is open. The profile must be
- * closed before its cookies can be read. Closing the window first lets Chrome
- * write recent cookies to disk; a forced stop is the fallback after 15 s.
+ * Close every Chrome still running on `profileWindows`, for when the person
+ * ends the sign-in from the terminal while the window is open. The profile
+ * must be closed before its cookies can be read. Closing the windows lets
+ * Chrome write recent cookies to disk; a forced stop is the fallback after
+ * `closeSeconds`, and it can lose cookies Chrome had not yet written. Throws
+ * when the stop cannot be confirmed, so the harvest never runs against a
+ * profile that is still open.
  */
-export declare function stopWindowsChromeProfile(profileWindows: string): void;
+export declare function stopWindowsChromeProfile(profileWindows: string, closeSeconds?: number): WindowsChromeStop;
 /** Windows form of a `/mnt/<drive>/...` path. */
 export declare function wslPathToWindows(linuxPath: string): string;
 export {};

package/dist/lib/browser/windows-chrome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows-chrome.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/windows-chrome.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AA4BnD,sEAAsE;AACtE,wBAAgB,iBAAiB,CAC/B,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAoB,EAC9C,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,GAAG,SAAS,CAKpB;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAOxD;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG5E;AAED,oEAAoE;AACpE,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAelF;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAyBtC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GAAG,MAAM,EAAE,CA2CX;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAkBrE;AAED,iDAAiD;AACjD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAI1D"}
+{"version":3,"file":"windows-chrome.d.ts","sourceRoot":"","sources":["../../../src/lib/browser/windows-chrome.ts"],"names":[],"mappings":"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"}