experimental-ash 0.1.0-alpha.1

package/dist/src/runtime/harness/workspace/spec.d.ts

@@ -0,0 +1,59 @@
+import type { ResolvedWorkspaceFile } from "../../types.js";
+import type { RuntimeSkillSource } from "../contracts.js";
+import { type HarnessWorkspaceSpec } from "./types.js";
+/**
+ * Minimal runtime-owned context document shape needed to expose authored files
+ * inside a harness workspace.
+ */
+export interface HarnessWorkspaceContextSource {
+    readonly content: string;
+    readonly logicalPath: string;
+}
+/**
+ * Minimal runtime-owned skill shape needed to expose authored files inside a
+ * harness workspace.
+ */
+export interface HarnessWorkspaceSkillSource {
+    readonly assetsPath?: string;
+    readonly logicalPath: string;
+    readonly markdown?: string;
+    readonly referencesPath?: string;
+    readonly rootPath?: string;
+    readonly scriptsPath?: string;
+    readonly skillFilePath?: string;
+    readonly sourceKind: RuntimeSkillSource["sourceKind"];
+}
+/**
+ * Minimal runtime-owned authored workspace file shape needed to expose
+ * compiler-owned workspace seed files inside a harness workspace.
+ */
+export interface HarnessWorkspaceSeedFileSource {
+    readonly logicalPath: string;
+    readonly sourceKind: ResolvedWorkspaceFile["sourceKind"];
+    readonly sourcePath: string;
+}
+/**
+ * Creates the empty runtime-owned workspace seed used when no authored files
+ * need to be exposed.
+ */
+export declare function createEmptyHarnessWorkspaceSpec(): HarnessWorkspaceSpec;
+/**
+ * Builds the serializable workspace seed from runtime-owned context and skill
+ * sources.
+ */
+export declare function createHarnessWorkspaceSpec(input: {
+    readonly contextDocuments?: readonly HarnessWorkspaceContextSource[];
+    readonly skills?: readonly HarnessWorkspaceSkillSource[];
+    readonly workspaceFiles?: readonly HarnessWorkspaceSeedFileSource[];
+}): HarnessWorkspaceSpec;
+/**
+ * Creates the authored-workspace prompt section that advertises the authored
+ * paths visible at the workspace root.
+ */
+export declare function createHarnessWorkspacePromptSection(spec: HarnessWorkspaceSpec): string | undefined;
+/**
+ * Creates the bash-tool instructions that describe the authored files visible
+ * in the live harness workspace.
+ */
+export declare function createHarnessWorkspaceExtraInstructions(spec: HarnessWorkspaceSpec): string | undefined;
+//# sourceMappingURL=spec.d.ts.map

package/dist/src/runtime/harness/workspace/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAML,KAAK,oBAAoB,EAE1B,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,oBAAoB,CAQtE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,6BAA6B,EAAE,CAAC;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,8BAA8B,EAAE,CAAC;CACrE,GAAG,oBAAoB,CA+BvB;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,oBAAoB,GACzB,MAAM,GAAG,SAAS,CAsBpB;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,oBAAoB,GACzB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/src/runtime/harness/workspace/spec.js

@@ -0,0 +1,133 @@
+import { dirname, posix as pathPosix } from "node:path";
+import { stripWorkspaceRootLogicalPath } from "../../../internal/logical-paths.js";
+import { HARNESS_WORKSPACE_ROOT, JUST_BASH_HARNESS_WORKSPACE_BACKEND, } from "./types.js";
+/**
+ * Creates the empty runtime-owned workspace seed used when no authored files
+ * need to be exposed.
+ */
+export function createEmptyHarnessWorkspaceSpec() {
+    return {
+        backend: JUST_BASH_HARNESS_WORKSPACE_BACKEND,
+        cwd: HARNESS_WORKSPACE_ROOT,
+        fileSources: [],
+        projectRootPath: undefined,
+        rootEntries: [],
+    };
+}
+/**
+ * Builds the serializable workspace seed from runtime-owned context and skill
+ * sources.
+ */
+export function createHarnessWorkspaceSpec(input) {
+    const fileSources = [];
+    const rootEntries = new Set();
+    const projectRootPath = resolveProjectRootPath(input.workspaceFiles ?? []);
+    for (const contextDocument of input.contextDocuments ?? []) {
+        fileSources.push(createInlineFileSource(contextDocument.logicalPath, encodeUtf8Content(contextDocument.content)));
+        rootEntries.add("context/");
+    }
+    for (const skill of input.skills ?? []) {
+        addSkillWorkspaceFileSources(skill, fileSources);
+        rootEntries.add("skills/");
+    }
+    if (projectRootPath !== undefined) {
+        rootEntries.add("project/");
+    }
+    return {
+        backend: JUST_BASH_HARNESS_WORKSPACE_BACKEND,
+        cwd: HARNESS_WORKSPACE_ROOT,
+        fileSources,
+        projectRootPath,
+        rootEntries: [...rootEntries].sort((left, right) => left.localeCompare(right)),
+    };
+}
+/**
+ * Creates the authored-workspace prompt section that advertises the authored
+ * paths visible at the workspace root.
+ */
+export function createHarnessWorkspacePromptSection(spec) {
+    if (spec.rootEntries.length === 0) {
+        return undefined;
+    }
+    const lines = [
+        "Workspace",
+        "- Authored files are available at the workspace root.",
+        `- Root entries under ${HARNESS_WORKSPACE_ROOT}/:`,
+        ...spec.rootEntries.map((entry) => `  - ${entry}`),
+        "- Inspect deeper contents with `ls`, `find`, and `rg` when needed.",
+    ];
+    if (spec.projectRootPath !== undefined) {
+        lines.splice(lines.length - 1, 0, "- `project/` contains files from the authored `workspace/` directory.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Creates the bash-tool instructions that describe the authored files visible
+ * in the live harness workspace.
+ */
+export function createHarnessWorkspaceExtraInstructions(spec) {
+    return createHarnessWorkspacePromptSection(spec);
+}
+function addSkillWorkspaceFileSources(skill, fileSources) {
+    if (skill.sourceKind !== "skill-package" && skill.markdown !== undefined) {
+        fileSources.push(createInlineFileSource(skill.logicalPath, encodeUtf8Content(skill.markdown)));
+        return;
+    }
+    if (skill.sourceKind !== "skill-package") {
+        return;
+    }
+    if (skill.rootPath !== undefined) {
+        fileSources.push(createDiskDirectoryFileSource(pathPosix.dirname(skill.logicalPath), skill.rootPath));
+        return;
+    }
+    if (skill.skillFilePath !== undefined) {
+        fileSources.push(createDiskFileSource(skill.logicalPath, skill.skillFilePath));
+    }
+}
+function createDiskDirectoryFileSource(logicalDirectoryPath, sourcePath) {
+    return {
+        kind: "disk-directory",
+        logicalDirectoryPath,
+        sourcePath,
+    };
+}
+function createDiskFileSource(logicalPath, sourcePath) {
+    return {
+        kind: "disk-file",
+        logicalPath,
+        sourcePath,
+    };
+}
+function createInlineFileSource(logicalPath, contentBase64) {
+    return {
+        contentBase64,
+        kind: "inline",
+        logicalPath,
+    };
+}
+function encodeUtf8Content(content) {
+    return Buffer.from(content, "utf8").toString("base64");
+}
+function resolveProjectRootPath(workspaceFiles) {
+    const rootPaths = new Set();
+    for (const workspaceFile of workspaceFiles) {
+        rootPaths.add(resolveWorkspaceSourceRootPath(workspaceFile));
+    }
+    if (rootPaths.size === 0) {
+        return undefined;
+    }
+    if (rootPaths.size > 1) {
+        throw new Error("Expected authored workspace seed files to share one source root path.");
+    }
+    const [rootPath] = rootPaths;
+    return rootPath;
+}
+function resolveWorkspaceSourceRootPath(workspaceFile) {
+    const relativePath = stripWorkspaceRootLogicalPath(workspaceFile.logicalPath);
+    let rootPath = workspaceFile.sourcePath;
+    for (const _segment of relativePath.split("/").filter(Boolean)) {
+        rootPath = dirname(rootPath);
+    }
+    return rootPath;
+}
+//# sourceMappingURL=spec.js.map

package/dist/src/runtime/harness/workspace/spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.js","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/spec.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/harness/workspace/state.d.ts

@@ -0,0 +1,27 @@
+import type { HarnessWorkspaceState } from "./types.js";
+/**
+ * Creates the canonical runtime-owned workspace id for one workflow run.
+ */
+export declare function createHarnessWorkspaceStateId(runId: string): string;
+/**
+ * Creates a deterministic derived workspace id scoped to one parent run.
+ */
+export declare function createDerivedHarnessWorkspaceStateId(input: {
+    readonly runId: string;
+    readonly suffix: string;
+}): string;
+/**
+ * Forks the current parent workspace snapshot into a child-owned workspace id.
+ */
+export declare function forkHarnessWorkspaceState(parent: HarnessWorkspaceState | null, workspaceId: string): HarnessWorkspaceState | null;
+/**
+ * Applies one child workspace snapshot back onto the accumulated parent
+ * workspace state by diffing against the pre-fork base snapshot.
+ */
+export declare function adoptChildWorkspaceState(input: {
+    readonly base: HarnessWorkspaceState | null;
+    readonly child: HarnessWorkspaceState | null;
+    readonly current: HarnessWorkspaceState | null;
+    readonly workspaceId: string;
+}): HarnessWorkspaceState | null;
+//# sourceMappingURL=state.d.ts.map

package/dist/src/runtime/harness/workspace/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvF;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAAC,KAAK,EAAE;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAMT;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,GAAG,IAAI,EACpC,WAAW,EAAE,MAAM,GAClB,qBAAqB,GAAG,IAAI,CAa9B;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,qBAAqB,GAAG,IAAI,CAiC/B"}

package/dist/src/runtime/harness/workspace/state.js

@@ -0,0 +1,144 @@
+/**
+ * Creates the canonical runtime-owned workspace id for one workflow run.
+ */
+export function createHarnessWorkspaceStateId(runId) {
+    return `workspace_${runId}`;
+}
+/**
+ * Creates a deterministic derived workspace id scoped to one parent run.
+ */
+export function createDerivedHarnessWorkspaceStateId(input) {
+    const normalizedSuffix = input.suffix.replaceAll(/[^a-zA-Z0-9_-]+/g, "_");
+    return normalizedSuffix.length === 0
+        ? createHarnessWorkspaceStateId(input.runId)
+        : `${createHarnessWorkspaceStateId(input.runId)}_${normalizedSuffix}`;
+}
+/**
+ * Forks the current parent workspace snapshot into a child-owned workspace id.
+ */
+export function forkHarnessWorkspaceState(parent, workspaceId) {
+    if (parent === null) {
+        return null;
+    }
+    return {
+        ...parent,
+        entries: cloneWorkspaceEntries(parent.entries),
+        env: {
+            ...parent.env,
+        },
+        workspaceId,
+    };
+}
+/**
+ * Applies one child workspace snapshot back onto the accumulated parent
+ * workspace state by diffing against the pre-fork base snapshot.
+ */
+export function adoptChildWorkspaceState(input) {
+    if (input.child === null) {
+        if (input.current === null) {
+            return null;
+        }
+        return {
+            ...input.current,
+            entries: cloneWorkspaceEntries(input.current.entries),
+            env: {
+                ...input.current.env,
+            },
+            workspaceId: input.workspaceId,
+        };
+    }
+    const exemplar = input.current ?? input.base ?? input.child;
+    return {
+        backend: exemplar.backend,
+        entries: mergeWorkspaceEntries({
+            baseEntries: input.base?.entries ?? [],
+            childEntries: input.child.entries,
+            currentEntries: input.current?.entries ?? [],
+        }),
+        env: mergeWorkspaceEnv({
+            baseEnv: input.base?.env ?? {},
+            childEnv: input.child.env,
+            currentEnv: input.current?.env ?? {},
+        }),
+        version: exemplar.version,
+        workspaceId: input.workspaceId,
+    };
+}
+function cloneWorkspaceEntries(entries) {
+    return entries.map((entry) => cloneWorkspaceEntry(entry));
+}
+function cloneWorkspaceEntry(entry) {
+    return entry.kind === "directory"
+        ? {
+            kind: "directory",
+            path: entry.path,
+        }
+        : {
+            contentBase64: entry.contentBase64,
+            kind: "file",
+            path: entry.path,
+        };
+}
+function mergeWorkspaceEntries(input) {
+    const baseEntriesByPath = createWorkspaceEntriesByPath(input.baseEntries);
+    const currentEntriesByPath = createWorkspaceEntriesByPath(input.currentEntries);
+    const childEntriesByPath = createWorkspaceEntriesByPath(input.childEntries);
+    const candidatePaths = new Set([
+        ...baseEntriesByPath.keys(),
+        ...childEntriesByPath.keys(),
+    ]);
+    for (const path of [...candidatePaths].sort((left, right) => left.localeCompare(right))) {
+        const baseEntry = baseEntriesByPath.get(path);
+        const childEntry = childEntriesByPath.get(path);
+        if (areWorkspaceEntriesEqual(baseEntry, childEntry)) {
+            continue;
+        }
+        if (childEntry === undefined) {
+            currentEntriesByPath.delete(path);
+            continue;
+        }
+        currentEntriesByPath.set(path, cloneWorkspaceEntry(childEntry));
+    }
+    return [...currentEntriesByPath.values()].sort((left, right) => {
+        return left.path.localeCompare(right.path);
+    });
+}
+function createWorkspaceEntriesByPath(entries) {
+    return new Map(entries.map((entry) => [entry.path, cloneWorkspaceEntry(entry)]));
+}
+function areWorkspaceEntriesEqual(left, right) {
+    if (left === right) {
+        return true;
+    }
+    if (left === undefined || right === undefined) {
+        return false;
+    }
+    if (left.kind !== right.kind || left.path !== right.path) {
+        return false;
+    }
+    return (left.kind === "directory" ||
+        (left.kind === "file" && right.kind === "file" && left.contentBase64 === right.contentBase64));
+}
+function mergeWorkspaceEnv(input) {
+    const mergedEnv = {
+        ...input.currentEnv,
+    };
+    const candidateKeys = new Set([
+        ...Object.keys(input.baseEnv),
+        ...Object.keys(input.childEnv),
+    ]);
+    for (const key of [...candidateKeys].sort((left, right) => left.localeCompare(right))) {
+        const baseValue = input.baseEnv[key];
+        const childValue = input.childEnv[key];
+        if (baseValue === childValue) {
+            continue;
+        }
+        if (childValue === undefined) {
+            delete mergedEnv[key];
+            continue;
+        }
+        mergedEnv[key] = childValue;
+    }
+    return mergedEnv;
+}
+//# sourceMappingURL=state.js.map

package/dist/src/runtime/harness/workspace/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/state.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/harness/workspace/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Stable root directory where runtime-owned authored files are exposed inside
+ * the harness workspace.
+ */
+export declare const HARNESS_WORKSPACE_ROOT = "/workspace";
+/**
+ * Stable mount path where authored `workspace/` seed files are exposed inside
+ * the live harness workspace as a read-only `project/` subtree.
+ */
+export declare const HARNESS_PROJECT_ROOT = "/workspace/project";
+/**
+ * Backend tag for the first runtime-owned harness workspace implementation.
+ */
+export declare const JUST_BASH_HARNESS_WORKSPACE_BACKEND = "just-bash";
+/**
+ * Version tag for the serialized harness workspace state contract.
+ */
+export declare const HARNESS_WORKSPACE_STATE_VERSION = 4;
+/**
+ * Inline byte file seeded directly into the runtime-owned workspace.
+ */
+export interface HarnessWorkspaceInlineFile {
+    readonly contentBase64: string;
+    readonly kind: "inline";
+    readonly logicalPath: string;
+}
+/**
+ * One authored file mirrored lazily from disk into the runtime-owned workspace.
+ */
+export interface HarnessWorkspaceDiskFile {
+    readonly kind: "disk-file";
+    readonly logicalPath: string;
+    readonly sourcePath: string;
+}
+/**
+ * One authored directory recursively mirrored from disk into the runtime-owned workspace.
+ */
+export interface HarnessWorkspaceDiskDirectory {
+    readonly kind: "disk-directory";
+    readonly logicalDirectoryPath: string;
+    readonly sourcePath: string;
+}
+/**
+ * Serializable file seed used to construct the live harness workspace inside a
+ * step-owned runtime path.
+ */
+export type HarnessWorkspaceFileSource = HarnessWorkspaceDiskDirectory | HarnessWorkspaceDiskFile | HarnessWorkspaceInlineFile;
+/**
+ * Serializable seed data for one runtime-owned harness workspace.
+ */
+export interface HarnessWorkspaceSpec {
+    readonly backend: typeof JUST_BASH_HARNESS_WORKSPACE_BACKEND;
+    readonly cwd: typeof HARNESS_WORKSPACE_ROOT;
+    readonly fileSources: readonly HarnessWorkspaceFileSource[];
+    readonly projectRootPath?: string;
+    readonly rootEntries: readonly string[];
+}
+/**
+ * One serialized workspace directory preserved across runtime turns.
+ */
+export interface HarnessWorkspaceSnapshotDirectory {
+    readonly kind: "directory";
+    readonly path: string;
+}
+/**
+ * One serialized workspace file preserved across runtime turns.
+ */
+export interface HarnessWorkspaceSnapshotFile {
+    readonly contentBase64: string;
+    readonly kind: "file";
+    readonly path: string;
+}
+/**
+ * Serialized workspace entry preserved across runtime turns.
+ */
+export type HarnessWorkspaceSnapshotEntry = HarnessWorkspaceSnapshotDirectory | HarnessWorkspaceSnapshotFile;
+/**
+ * Serializable per-run workspace handle and snapshot preserved in runtime
+ * session state.
+ */
+export interface HarnessWorkspaceState {
+    readonly backend: typeof JUST_BASH_HARNESS_WORKSPACE_BACKEND;
+    readonly entries: readonly HarnessWorkspaceSnapshotEntry[];
+    readonly env: Readonly<Record<string, string>>;
+    readonly version: typeof HARNESS_WORKSPACE_STATE_VERSION;
+    readonly workspaceId: string;
+}
+/**
+ * Result returned by executing one command against the live harness workspace
+ * sandbox.
+ */
+export interface HarnessWorkspaceCommandResult {
+    readonly exitCode: number;
+    readonly stderr: string;
+    readonly stdout: string;
+}
+/**
+ * Minimal filesystem surface exposed from the runtime-owned workspace to a
+ * harness host.
+ */
+export interface HarnessWorkspaceFileSystem {
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+}
+/**
+ * Ash-owned sandbox surface exposed to harness hosts.
+ */
+export interface HarnessWorkspaceSandbox {
+    exec(command: string): Promise<HarnessWorkspaceCommandResult>;
+    readonly fs: HarnessWorkspaceFileSystem;
+}
+/**
+ * Live runtime-owned workspace capability passed into a harness host inside a
+ * step-owned execution path.
+ */
+export interface HarnessWorkspace {
+    readonly cwd: typeof HARNESS_WORKSPACE_ROOT;
+    readonly extraInstructions?: string;
+    readonly sandbox: HarnessWorkspaceSandbox;
+}
+/**
+ * Live workspace handle returned by the runtime when it creates or reattaches
+ * a per-run harness workspace.
+ */
+export interface ManagedHarnessWorkspace {
+    captureState(): Promise<HarnessWorkspaceState>;
+    /**
+     * Releases any process-local resources retained for the live workspace
+     * handle.
+     */
+    dispose(): Promise<void>;
+    readonly workspace: HarnessWorkspace;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/runtime/harness/workspace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/types.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/harness/workspace/types.js

@@ -0,0 +1,19 @@
+/**
+ * Stable root directory where runtime-owned authored files are exposed inside
+ * the harness workspace.
+ */
+export const HARNESS_WORKSPACE_ROOT = "/workspace";
+/**
+ * Stable mount path where authored `workspace/` seed files are exposed inside
+ * the live harness workspace as a read-only `project/` subtree.
+ */
+export const HARNESS_PROJECT_ROOT = "/workspace/project";
+/**
+ * Backend tag for the first runtime-owned harness workspace implementation.
+ */
+export const JUST_BASH_HARNESS_WORKSPACE_BACKEND = "just-bash";
+/**
+ * Version tag for the serialized harness workspace state contract.
+ */
+export const HARNESS_WORKSPACE_STATE_VERSION = 4;
+//# sourceMappingURL=types.js.map

package/dist/src/runtime/harness/workspace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/runtime/harness/workspace/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,YAAY,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,WAAW,CAAC;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC"}

package/dist/src/runtime/json.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+/**
+ * JSON-serializable primitive values that can safely cross workflow and step boundaries.
+ */
+export type JsonPrimitive = boolean | number | string | null;
+/**
+ * JSON-serializable array values that can safely cross workflow and step boundaries.
+ */
+export type JsonArray = readonly JsonValue[];
+/**
+ * JSON-serializable object values that can safely cross workflow and step boundaries.
+ */
+export interface JsonObject {
+    readonly [key: string]: JsonValue;
+}
+/**
+ * JSON-serializable values that can safely cross workflow and step boundaries.
+ */
+export type JsonValue = JsonArray | JsonObject | JsonPrimitive;
+/**
+ * Zod schema for JSON-serializable primitive values.
+ */
+export declare const jsonPrimitiveSchema: z.ZodType<JsonPrimitive>;
+/**
+ * Zod schema for JSON-serializable values.
+ */
+export declare const jsonValueSchema: z.ZodType<JsonValue>;
+/**
+ * Zod schema for JSON-serializable object values.
+ */
+export declare const jsonObjectSchema: z.ZodType<JsonObject>;
+/**
+ * Returns true when a value can be persisted as JSON without losing structure.
+ */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+//# sourceMappingURL=json.d.ts.map

package/dist/src/runtime/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/runtime/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;AAI/D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAKvD,CAAC;AAUH;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAGhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAGlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}

package/dist/src/runtime/json.js

@@ -0,0 +1,55 @@
+import { z } from "zod";
+const INVALID_JSON_VALUE_CANDIDATE = Symbol("invalid-json-value-candidate");
+/**
+ * Zod schema for JSON-serializable primitive values.
+ */
+export const jsonPrimitiveSchema = z.union([
+    z.boolean(),
+    z.number().finite(),
+    z.string(),
+    z.null(),
+]);
+const jsonValueContentSchema = z.lazy(() => z.union([
+    jsonPrimitiveSchema,
+    z.array(jsonValueContentSchema),
+    z.record(z.string(), jsonValueContentSchema),
+]));
+/**
+ * Zod schema for JSON-serializable values.
+ */
+export const jsonValueSchema = z.preprocess((value) => normalizeJsonValueCandidate(value), jsonValueContentSchema);
+/**
+ * Zod schema for JSON-serializable object values.
+ */
+export const jsonObjectSchema = z.preprocess((value) => normalizeJsonValueCandidate(value), z.record(z.string(), jsonValueContentSchema));
+/**
+ * Returns true when a value can be persisted as JSON without losing structure.
+ */
+export function isJsonValue(value) {
+    return jsonValueSchema.safeParse(value).success;
+}
+function normalizeJsonValueCandidate(value, seen = new WeakSet()) {
+    if (value === null || typeof value === "boolean" || typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeJsonValueCandidate(item, seen));
+    }
+    if (typeof value !== "object") {
+        return value;
+    }
+    if (seen.has(value)) {
+        return INVALID_JSON_VALUE_CANDIDATE;
+    }
+    seen.add(value);
+    const normalized = {};
+    for (const [key, entry] of Object.entries(value)) {
+        normalized[key] = normalizeJsonValueCandidate(entry, seen);
+    }
+    seen.delete(value);
+    return normalized;
+}
+//# sourceMappingURL=json.js.map

package/dist/src/runtime/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/runtime/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB,MAAM,4BAA4B,GAAG,MAAM,CAAC,8BAA8B,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA6B,CAAC,CAAC,KAAK,CAAC;IACnE,CAAC,CAAC,OAAO,EAAE;IACX,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE;IACnB,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,IAAI,EAAE;CACT,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAyB,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAC/D,CAAC,CAAC,KAAK,CAAC;IACN,mBAAmB;IACnB,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IAC/B,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC;CAC7C,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAyB,CAAC,CAAC,UAAU,CAC/D,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAC7C,sBAAsB,CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA0B,CAAC,CAAC,UAAU,CACjE,CAAC,KAAK,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAC7C,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAC7C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAClD,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc,EAAE,OAAO,IAAI,OAAO,EAAU;IAC/E,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEhB,MAAM,UAAU,GAA4B,EAAE,CAAC;IAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,UAAU,CAAC,GAAG,CAAC,GAAG,2BAA2B,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnB,OAAO,UAAU,CAAC;AACpB,CAAC"}