@inflexa-ai/harness 0.47.0 → 0.48.1

package/dist/workspace/session-files.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The files that a session writes outside a run, and the host hook that keeps a copy of each.
+ *
+ * A run registers its step files through `ArtifactRegistry`. A chat thread and a report session write files too:
+ * the scripts and the derived files of `run_script`, and the files of `write_file` and `edit_file`. A host that
+ * keeps the files of an analysis elsewhere binds `syncSessionFile`, and each write reaches it with its bytes. The
+ * call runs inside the tool step of the write, thus a step that runs again after a crash calls the hook again with
+ * the same file.
+ */
+import type { ResultAsync } from "neverthrow";
+import type { AgentSession } from "../auth/types.js";
+import { type NoticeFailure } from "../lib/hooks.js";
+import type { Logger } from "../lib/logger.js";
+/** Who owns a session file. A file in the scratch directory of a thread belongs to that thread. */
+export type SessionFileOwner = {
+    readonly kind: "thread";
+    readonly threadId: string;
+} | {
+    readonly kind: "analysis";
+};
+export type SessionFileWrite = {
+    /** The session of the tool call that wrote the file. */
+    readonly session: AgentSession;
+    readonly owner: SessionFileOwner;
+    /** The analysis-relative path, and the hash and the size of the bytes. */
+    readonly path: string;
+    readonly hash: string;
+    readonly size: number;
+    /** The exact bytes that landed. */
+    readonly content: Uint8Array;
+};
+/** A notice: a failure is logged, and the write stays done. */
+export type SyncSessionFile = (write: SessionFileWrite) => ResultAsync<void, NoticeFailure>;
+/** Give one landed write to the hook of the host. An unbound hook does nothing. */
+export declare function syncWrittenFile(sync: SyncSessionFile | undefined, logger: Logger, write: SessionFileWrite): Promise<void>;

package/dist/workspace/session-files.js

@@ -0,0 +1,16 @@
+/**
+ * The files that a session writes outside a run, and the host hook that keeps a copy of each.
+ *
+ * A run registers its step files through `ArtifactRegistry`. A chat thread and a report session write files too:
+ * the scripts and the derived files of `run_script`, and the files of `write_file` and `edit_file`. A host that
+ * keeps the files of an analysis elsewhere binds `syncSessionFile`, and each write reaches it with its bytes. The
+ * call runs inside the tool step of the write, thus a step that runs again after a crash calls the hook again with
+ * the same file.
+ */
+import { deliverNotice } from "../lib/hooks.js";
+/** Give one landed write to the hook of the host. An unbound hook does nothing. */
+export async function syncWrittenFile(sync, logger, write) {
+    if (sync === undefined)
+        return;
+    await deliverNotice(logger.with({ analysisId: write.session.scope.analysisId, path: write.path }), "syncSessionFile", sync(write));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@inflexa-ai/harness",
-    "version": "0.47.0",
+    "version": "0.48.1",
     "description": "Host-agnostic bioinformatics agent harness — an agent loop on the AI SDK, DBOS-durable workflows, sandboxed compute.",
     "license": "Apache-2.0",
     "type": "module",
@@ -83,6 +83,7 @@
         "dockerode": "^4.0.12",
         "echarts": "6.1.0",
         "fast-xml-parser": "^5.10.1",
+        "fflate": "^0.8.3",
         "hono": "^4.12.34",
         "hyparquet": "^1.28.1",
         "js-tiktoken": "^1.0.21",