@corenel/harness 0.16.0 → 0.18.0

package/dist/workflows/results/resultStore.js

@@ -0,0 +1,191 @@
+/* Results as files: save, list, read, delete under results/ in the workspace.
+ * Every path in or out is checked to be results/**.md, so a crafted link can
+ * never read or delete anything else. Saving never throws: a run's outcome must
+ * not depend on whether its result could be written. */
+import { isProtectedPath, protectedPathReason } from '@corenel/protocol';
+import { RESULTS_DIR, formatResult, parseResult, resultPath } from './resultFile.js';
+/** At most this many files are read for one listing. */
+const MAX_SCAN = 500;
+function normalize(path) {
+    return path.replace(/\\/g, '/').replace(/^\/+/, '');
+}
+export function isResultPath(path) {
+    const n = normalize(path);
+    return n.startsWith(`${RESULTS_DIR}/`) && n.endsWith('.md') && !n.split('/').some((seg) => seg === '..' || seg === '.' || seg === '');
+}
+export async function saveResult(files, meta, output, ranAt = new Date(meta.ran)) {
+    if (!files)
+        return { error: 'no workspace is open' };
+    if (!files.writable)
+        return { error: 'the workspace is read-only' };
+    const when = Number.isNaN(ranAt.getTime()) ? new Date() : ranAt;
+    const base = resultPath(meta.workflow, meta.slug, when);
+    // cleanName already makes one safe segment; this keeps the write honest if
+    // that ever changes: nothing outside results/**.md is ever written.
+    if (!isResultPath(base))
+        return { error: `not a results path: ${base}` };
+    if (isProtectedPath(base))
+        return { error: protectedPathReason(base) };
+    let path = null;
+    // The name this save holds in `reserved`; released in finally, even on a throw.
+    let claimed = null;
+    try {
+        // stat-then-write is not atomic, so each candidate is CLAIMED in this tab
+        // before the await that checks the disk: two saves finishing together (a
+        // deploy and a job) can never both pick the same free name.
+        for (let n = 1; path === null; n++) {
+            if (n > 99)
+                return { error: 'too many results in one minute' };
+            const candidate = n === 1 ? base : base.replace(/\.md$/, ` (${n}).md`);
+            if (reserved.has(candidate))
+                continue;
+            reserved.add(candidate);
+            claimed = candidate;
+            if (await files.stat(candidate)) {
+                reserved.delete(candidate);
+                claimed = null;
+                continue;
+            }
+            path = candidate;
+        }
+        await files.write(path, formatResult(meta, output));
+        return { path };
+    }
+    catch (e) {
+        return { error: String(e?.message || e) };
+    }
+    finally {
+        if (claimed !== null)
+            reserved.delete(claimed);
+    }
+}
+/** Paths a save in this tab has claimed but not finished writing. */
+const reserved = new Set();
+/** Put an already-formatted result `text` at `path` (results/**.md) or the
+ * next free ` (n)` name, never overwriting anything: a name holding exactly
+ * `text` already is the same result (an earlier copy) and is reported as
+ * `same` with nothing written. Claims names in the SAME in-tab reservation as
+ * saveResult, so a save and a placement finishing together never pick one
+ * name, and writes with `create`, which refuses an existing file, so a file
+ * another tab wrote between the check and the write is not replaced either.
+ * Never throws. */
+export async function placeResultText(files, path, text) {
+    if (!files.writable)
+        return { error: 'the workspace is read-only' };
+    const base = normalize(path);
+    if (!isResultPath(base))
+        return { error: `not a results path: ${base}` };
+    const sameAt = async (candidate) => {
+        try {
+            return (await files.read(candidate)) === text;
+        }
+        catch {
+            return false;
+        }
+    };
+    for (let n = 1; n <= 99; n++) {
+        const candidate = n === 1 ? base : base.replace(/\.md$/, ` (${n}).md`);
+        if (isProtectedPath(candidate))
+            return { error: protectedPathReason(candidate) };
+        if (reserved.has(candidate))
+            continue;
+        reserved.add(candidate);
+        try {
+            if (await files.stat(candidate)) {
+                if (await sameAt(candidate))
+                    return { path: candidate, same: true };
+                continue;
+            }
+            try {
+                await files.create(candidate, text);
+                return { path: candidate, same: false };
+            }
+            catch (e) {
+                // Taken since the check (another tab): treat it as any existing name.
+                // Anything else is a real failure and nothing was written.
+                let now;
+                try {
+                    now = await files.stat(candidate);
+                }
+                catch {
+                    now = null;
+                }
+                if (!now)
+                    return { error: String(e?.message || e) };
+                if (await sameAt(candidate))
+                    return { path: candidate, same: true };
+            }
+        }
+        catch (e) {
+            return { error: String(e?.message || e) };
+        }
+        finally {
+            reserved.delete(candidate);
+        }
+    }
+    return { error: 'too many results with that name' };
+}
+function flatten(nodes, out) {
+    for (const n of nodes) {
+        if (n.kind === 'file')
+            out.push(n);
+        else if (n.children)
+            flatten(n.children, out);
+    }
+}
+// "2026-10-10 0930 (2).md" -> "202610100930002", for newest-first sorting.
+const STAMP = /(\d{4})-(\d{2})-(\d{2}) (\d{2})(\d{2})(?: \((\d+)\))?\.md$/;
+function sortKey(n) {
+    const m = STAMP.exec(n.name);
+    if (m)
+        return `${m[1]}${m[2]}${m[3]}${m[4]}${m[5]}${(m[6] ?? '1').padStart(3, '0')}`;
+    return n.mtime ? `${new Date(n.mtime).toISOString().replace(/\D/g, '').slice(0, 12)}000` : '';
+}
+async function readEntry(files, path, mtime) {
+    try {
+        const { meta, output } = parseResult(await files.read(path));
+        const parsed = meta ? Date.parse(meta.ran) : NaN;
+        return { path, meta, output, ranAt: Number.isNaN(parsed) ? (mtime ?? 0) : parsed };
+    }
+    catch {
+        return null;
+    }
+}
+export async function listResults(files, opts = {}) {
+    if (!files)
+        return [];
+    let nodes;
+    try {
+        nodes = await files.list(RESULTS_DIR);
+    }
+    catch {
+        return [];
+    }
+    const all = [];
+    flatten(nodes, all);
+    const md = all.filter((n) => isResultPath(n.path)).sort((a, b) => sortKey(b).localeCompare(sortKey(a)));
+    const limit = opts.limit ?? 50;
+    const out = [];
+    for (const n of md.slice(0, MAX_SCAN)) {
+        if (out.length >= limit)
+            break;
+        const e = await readEntry(files, n.path, n.mtime);
+        if (!e)
+            continue;
+        if (opts.slug && e.meta?.slug !== opts.slug)
+            continue;
+        out.push(e);
+    }
+    return out;
+}
+export async function readResult(files, path) {
+    if (!files || !isResultPath(path))
+        return null;
+    return readEntry(files, normalize(path));
+}
+export async function deleteResult(files, path) {
+    if (!isResultPath(path))
+        throw new Error(`not a result: ${path}`);
+    await files.remove(normalize(path));
+}
+//# sourceMappingURL=resultStore.js.map

package/dist/workflows/results/resultStore.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corenel/harness",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "license": "Elastic-2.0",
   "type": "module",
   "description": "Corenel — host-agnostic agent harness (kernel). The app resolves it via the `corenel` path alias (bypasses these exports entirely); vitest aliases it to source too. Everything else — node consumers like @corenel/cli, @corenel/term, @corenel/sidecar — resolves it through this workspace package via the exports map below, which points at dist/ unconditionally (not just at publish) so in-repo and published resolution are identical: a bundle that treats @corenel/harness as external (see packages/term/build.mjs) must see the SAME module instance node sees when it later resolves this package at runtime, and plain node cannot execute the raw .ts sources at all. Run `pnpm build` here (or let a dependent's prebuild do it) before relying on this package outside the app/vitest. NOTE: @xyflow/react and dagre are NOT dependencies here at all — this package has no .tsx files and imports neither. `react` IS a real (small) runtime dependency: `todos.ts` uses `useSyncExternalStore`. It is declared below as an OPTIONAL peer, not a hard dependency, so node-only consumers (cli/term/sidecar) aren't forced to install react; node consumers hoist it today only because something else in the tree happens to pull it in. Do not add @xyflow/react or dagre as dependencies/peers without testing a packed install end to end — an earlier attempt at that (before this package had any .tsx files) failed npm's peer resolution with ERESOLVE.",
@@ -33,7 +33,7 @@
   "dependencies": {
     "openai": "^4.77.0",
     "yaml": "^2.8.3",
-    "@corenel/protocol": "0.15.0"
+    "@corenel/protocol": "0.16.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0"
@@ -44,6 +44,7 @@
     }
   },
   "devDependencies": {
+    "@prompd/core": "0.6.0",
     "@types/ws": "^8.5.13"
   },
   "publishConfig": {