omkit 0.0.5 → 0.0.6

package/dist/core/action.d.ts

@@ -39,6 +39,12 @@ export interface ActionContext<Events extends object, Handle = void> extends Sys
      * one (e.g. CDP) follows the same pattern over `logs`/`signal`.
      */
     readonly proc: Proc;
+    /**
+     * Absolute path to this run's output folder (`logs/<name>/<date>/<time>/`) —
+     * created and shared across the run. Write action artifacts here so they land
+     * beside `run.log`; the same folder is on the `spin` context.
+     */
+    readonly artifactsFolder: string;
 }
 /** A constructed-but-not-yet-run action: what calling an `Action` produces. */
 export interface ActionInstance<Result = unknown, Events extends object = NoEvents, Handle = void> {

package/dist/core/action.js

@@ -1,6 +1,7 @@
 import { events } from "./events.js";
 import { createProc } from "./process.js";
 import { fingerprint, read, write, resolvePaths } from "./folder-cache.js";
+import { artifactsFolder } from "./output.js";
 /** A promise paired with its settlers, for the set-once handle. */
 const deferred = () => {
     let resolve;
@@ -82,7 +83,13 @@ const build = (name, exec) => {
             // `Promise.resolve().then` normalizes a sync result and routes a sync
             // throw to the `error` path, so exec may be sync or async.
             Promise.resolve()
-                .then(() => exec({ ...system, emit, attach, proc: createProc(system.logs, system.signal) }, ...args))
+                .then(() => exec({
+                ...system,
+                emit,
+                attach,
+                proc: createProc(system.logs, system.signal),
+                artifactsFolder: artifactsFolder(),
+            }, ...args))
                 .then((result) => {
                 systemEmit("done", result);
                 // Settle `ref` if the action finished without attaching, so awaiters

package/dist/core/output.d.ts

@@ -1,4 +1,13 @@
 import type { LogsCollector } from "./log-collector/LogsCollector.ts";
+/**
+ * Absolute path to this run's output folder — `logs/<name>/<date>/<time>/`, where
+ * `run.log`, `run.jsonl`, and snapshots live. Exposed so actions can drop their
+ * own **artifacts** into the same per-run folder (one folder per run; one run per
+ * process). The folder is created on first access — synchronously, so a caller
+ * can write into it in the same tick — and the path is absolute so it's safe to
+ * hand to a child process with a different cwd.
+ */
+export declare const artifactsFolder: () => string;
 /**
  * Drains the collected log to two files in the run's output folder (the common
  * `logs/<name>/<date>/<time>/` convention, local time):

package/dist/core/output.js

@@ -1,4 +1,4 @@
-import { createWriteStream } from "node:fs";
+import { createWriteStream, mkdirSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { log } from "./log-collector/global.js";
@@ -24,6 +24,23 @@ const runDir = () => {
 };
 let made;
 const ensureDir = () => (made ??= mkdir(runDir(), { recursive: true }).then(() => { }));
+let ensuredSync = false;
+/**
+ * Absolute path to this run's output folder — `logs/<name>/<date>/<time>/`, where
+ * `run.log`, `run.jsonl`, and snapshots live. Exposed so actions can drop their
+ * own **artifacts** into the same per-run folder (one folder per run; one run per
+ * process). The folder is created on first access — synchronously, so a caller
+ * can write into it in the same tick — and the path is absolute so it's safe to
+ * hand to a child process with a different cwd.
+ */
+export const artifactsFolder = () => {
+    const abs = path.resolve(runDir());
+    if (!ensuredSync) {
+        mkdirSync(abs, { recursive: true });
+        ensuredSync = true;
+    }
+    return abs;
+};
 /** A compact header block for the top of run.log — legend + run identity. */
 const logHeader = () => {
     const now = new Date();

package/dist/core/spin.d.ts

@@ -32,6 +32,12 @@ export interface SpinContext {
     readonly cancel: Run["cancel"];
     /** The run's abort signal — honor it to stop early. */
     readonly signal: AbortSignal;
+    /**
+     * Absolute path to this run's output folder (`logs/<name>/<date>/<time>/`),
+     * created up front. Hand it to actions (or use `ctx.artifactsFolder` inside
+     * one) to write artifacts beside `run.log`.
+     */
+    readonly artifactsFolder: string;
 }
 /** The body of a {@link spin}: any (async) function — it isn't named or wrapped by you. */
 export type SpinBody = (ctx: SpinContext) => void | Promise<void>;

package/dist/core/spin.js

@@ -1,5 +1,6 @@
 import { action } from "./action.js";
 import { run } from "./run.js";
+import { artifactsFolder } from "./output.js";
 export function spin(a, b) {
     const [options, body] = typeof a === "function" ? [{}, a] : [a, b];
     const { drain: autoDrain = true, ...runOptions } = options;
@@ -20,7 +21,13 @@ export function spin(a, b) {
             host.run(instance);
             return instance;
         };
-        await body({ nod, drain: startDrain, cancel: () => host.cancel(), signal });
+        await body({
+            nod,
+            drain: startDrain,
+            cancel: () => host.cancel(),
+            signal,
+            artifactsFolder: artifactsFolder(),
+        });
     });
     host = run(runOptions, hosted());
     if (autoDrain)

package/dist/index.d.ts

@@ -23,4 +23,5 @@ export type { Logger, LogEntry, LogInput, SubscribeOptions, } from "./core/log-c
 export { log } from "./core/log-collector/global.ts";
 export { snapshot, captureSnapshot } from "./core/output.ts";
 export type { SnapshotRef } from "./core/output.ts";
+export { artifactsFolder } from "./core/output.ts";
 export { fingerprint, cacheDir } from "./core/folder-cache.ts";

package/dist/index.js

@@ -23,6 +23,10 @@ export { LogsCollector } from "./core/log-collector/LogsCollector.js";
 export { log } from "./core/log-collector/global.js";
 // ── Snapshots ──────────────────────────────────────────────────────────────
 export { snapshot, captureSnapshot } from "./core/output.js";
+// ── Artifacts ────────────────────────────────────────────────────────────────
+// This run's output folder (absolute) — also on the `spin`/action `ctx`. Import
+// it directly for artifact-writing helpers that aren't inside an action.
+export { artifactsFolder } from "./core/output.js";
 // ── Folder cache ─────────────────────────────────────────────────────────────
 // Backs the `.withCache(...inputs)` method on instances (fingerprints an
 // action's input files/folders, not its outputs); exported for scripts that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omkit",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "A tiny runtime for developer workflows: typed actions that pass runtime capabilities and emit typed events, under one run and one shared log. The operational/runtime layer to tskb's knowledge layer.",
   "type": "module",
   "main": "./dist/index.js",