@struktoai/mirage-node 0.0.5 → 0.0.7-alpha.1

package/dist/commands/native_fixture.js

@@ -0,0 +1,186 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { spawn } from 'node:child_process';
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { RAMResource } from '@struktoai/mirage-core/resource/ram/ram';
+import { MountMode } from '@struktoai/mirage-core/types';
+import { DiskResource } from "../resource/disk/disk.js";
+import { Workspace } from "../workspace.js";
+const DEC = new TextDecoder();
+function runNative(cwd, cmd, stdin) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('/bin/sh', ['-c', cmd], { cwd });
+        const out = [];
+        child.stdout.on('data', (chunk) => {
+            out.push(chunk);
+        });
+        child.on('error', reject);
+        child.on('close', () => {
+            resolve(Buffer.concat(out).toString('utf8'));
+        });
+        // A program that never reads its stdin (`jq -n`) can exit before the
+        // write below lands, and a pipe with no reader left answers EPIPE.
+        // That is the program's own behavior, not a failed run; anything else
+        // still fails the test.
+        child.stdin.on('error', (err) => {
+            if (err.code !== 'EPIPE')
+                reject(err);
+        });
+        if (stdin !== null)
+            child.stdin.write(Buffer.from(stdin));
+        child.stdin.end();
+    });
+}
+function makeRamEnv() {
+    const tmp = mkdtempSync(join(tmpdir(), 'mirage-native-ram-'));
+    const resource = new RAMResource();
+    const ws = new Workspace({ '/data': resource }, { mode: MountMode.WRITE });
+    const env = {
+        kind: 'ram',
+        ws,
+        createFile(relative, content) {
+            const local = join(tmp, relative);
+            mkdirSync(dirname(local), { recursive: true });
+            writeFileSync(local, content);
+            const remote = '/' + relative;
+            const parts = relative.split('/');
+            for (let i = 1; i < parts.length; i++) {
+                resource.store.dirs.add('/' + parts.slice(0, i).join('/'));
+            }
+            resource.store.files.set(remote, content);
+            // Mirror the native side: files on the tmp filesystem carry an
+            // mtime, and -mtime windows exclude unknown-mtime entries.
+            resource.store.modified.set(remote, new Date().toISOString());
+        },
+        native(cmd, stdin = null) {
+            return runNative(tmp, cmd, stdin);
+        },
+        async mirage(cmd, stdin = null) {
+            ws.cwd = '/data';
+            const io = await ws.execute(cmd, stdin === null ? {} : { stdin });
+            return DEC.decode(io.stdout);
+        },
+        async cleanup() {
+            await ws.close();
+            rmSync(tmp, { recursive: true, force: true });
+        },
+    };
+    return env;
+}
+function makeDiskEnv() {
+    const tmp = mkdtempSync(join(tmpdir(), 'mirage-native-disk-'));
+    const diskRoot = join(tmp, 'disk');
+    mkdirSync(diskRoot, { recursive: true });
+    const resource = new DiskResource({ root: diskRoot });
+    const ws = new Workspace({ '/data': resource }, { mode: MountMode.WRITE });
+    const env = {
+        kind: 'disk',
+        ws,
+        createFile(relative, content) {
+            const local = join(diskRoot, relative);
+            mkdirSync(dirname(local), { recursive: true });
+            writeFileSync(local, content);
+        },
+        native(cmd, stdin = null) {
+            return runNative(diskRoot, cmd, stdin);
+        },
+        async mirage(cmd, stdin = null) {
+            ws.cwd = '/data';
+            const io = await ws.execute(cmd, stdin === null ? {} : { stdin });
+            return DEC.decode(io.stdout);
+        },
+        async cleanup() {
+            await ws.close();
+            rmSync(tmp, { recursive: true, force: true });
+        },
+    };
+    return env;
+}
+export const NATIVE_BACKENDS = ['ram', 'disk'];
+export function makeEnv(kind) {
+    if (kind === 'ram')
+        return makeRamEnv();
+    return makeDiskEnv();
+}
+function makeMount(kind, tmp, idx) {
+    if (kind === 'ram') {
+        const resource = new RAMResource();
+        return { kind, resource, diskRoot: null, ramResource: resource };
+    }
+    const diskRoot = join(tmp, `disk${String(idx)}`);
+    mkdirSync(diskRoot, { recursive: true });
+    const resource = new DiskResource({ root: diskRoot });
+    return { kind, resource, diskRoot, ramResource: null };
+}
+function writeToMount(mount, relative, content) {
+    if (mount.kind === 'ram') {
+        const ram = mount.ramResource;
+        if (ram === null)
+            throw new Error('ram mount missing resource');
+        const parts = relative.split('/');
+        for (let i = 1; i < parts.length; i++) {
+            ram.store.dirs.add('/' + parts.slice(0, i).join('/'));
+        }
+        ram.store.files.set('/' + relative, content);
+        ram.store.modified.set('/' + relative, new Date().toISOString());
+        return;
+    }
+    if (mount.diskRoot === null)
+        throw new Error('disk mount missing root');
+    const local = join(mount.diskRoot, relative);
+    mkdirSync(dirname(local), { recursive: true });
+    writeFileSync(local, content);
+}
+export function makeCrossEnv(kinds) {
+    const tmp = mkdtempSync(join(tmpdir(), 'mirage-native-cross-'));
+    const m1 = makeMount(kinds[0], tmp, 1);
+    const m2 = makeMount(kinds[1], tmp, 2);
+    const ws = new Workspace({ '/m1': m1.resource, '/m2': m2.resource }, { mode: MountMode.WRITE });
+    ws.cwd = '/m1';
+    return {
+        kinds,
+        ws,
+        createFile(mountIdx, relative, content) {
+            const mount = mountIdx === 1 ? m1 : m2;
+            writeToMount(mount, relative, content);
+        },
+        async run(cmd) {
+            const io = await ws.execute(cmd);
+            return DEC.decode(io.stdout);
+        },
+        async exit(cmd) {
+            const io = await ws.execute(cmd);
+            return io.exitCode;
+        },
+        async stderr(cmd) {
+            const io = await ws.execute(cmd);
+            return DEC.decode(io.stderr);
+        },
+        async provision(cmd) {
+            return ws.execute(cmd, { provision: true });
+        },
+        async cleanup() {
+            await ws.close();
+            rmSync(tmp, { recursive: true, force: true });
+        },
+    };
+}
+export const CROSS_MOUNT_PAIRS = [
+    ['ram', 'ram'],
+    ['ram', 'disk'],
+    ['disk', 'ram'],
+];
+//# sourceMappingURL=native_fixture.js.map

package/dist/commands/native_fixture.js.map

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

package/dist/compression_codecs.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compression_codecs.d.ts.map

package/dist/compression_codecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression_codecs.d.ts","sourceRoot":"","sources":["../src/compression_codecs.ts"],"names":[],"mappings":""}

package/dist/compression_codecs.js

@@ -0,0 +1,34 @@
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+import { createRequire } from 'node:module';
+import { registerCompressionCodec } from '@struktoai/mirage-core/utils/compress';
+// seek-bzip and @napi-rs/lzma are CommonJS; load them via createRequire so
+// the built ESM output resolves their exports without named-import interop
+// pitfalls (mirrors the createRequire usage in workspace.ts).
+const requireCjs = createRequire(import.meta.url);
+const bunzip = requireCjs('seek-bzip');
+const { xz } = requireCjs('@napi-rs/lzma');
+// bzip2 is decompress-only on purpose: seek-bzip is the maintained
+// permissively licensed implementation and it only decodes, so `tar -cj`
+// reports unsupported while `-xj` / `-tj` work. The pure-JS compressor that
+// used to sit here (compressjs) is GPL, which an Apache-2.0 package cannot
+// ship.
+registerCompressionCodec('bzip2', {
+    decompress: (bytes) => Promise.resolve(Uint8Array.from(bunzip.decode(bytes))),
+});
+registerCompressionCodec('xz', {
+    compress: async (bytes) => new Uint8Array(await xz.compress(Buffer.from(bytes))),
+    decompress: async (bytes) => new Uint8Array(await xz.decompress(Buffer.from(bytes))),
+});
+//# sourceMappingURL=compression_codecs.js.map

package/dist/compression_codecs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression_codecs.js","sourceRoot":"","sources":["../src/compression_codecs.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,iDAAiD;AACjD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,uEAAuE;AAEvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAA;AAWhF,2EAA2E;AAC3E,2EAA2E;AAC3E,8DAA8D;AAC9D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACjD,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAiB,CAAA;AACtD,MAAM,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,eAAe,CAAqB,CAAA;AAE9D,mEAAmE;AACnE,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,QAAQ;AACR,wBAAwB,CAAC,OAAO,EAAE;IAChC,UAAU,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CAC9E,CAAC,CAAA;AAEF,wBAAwB,CAAC,IAAI,EAAE;IAC7B,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;CACrF,CAAC,CAAA"}

package/dist/config.d.ts

@@ -0,0 +1,191 @@
+import type { CacheConfig } from '@struktoai/mirage-core/cache/file/config';
+import type { Resource } from '@struktoai/mirage-core/resource/base';
+import { ConsistencyPolicy, Limit, MountBackend, MountMode } from '@struktoai/mirage-core/types';
+import type { WorkspaceOptions } from '@struktoai/mirage-core/workspace/workspace/workspace';
+import './secrets/constants.ts';
+import type { S3Config } from './resource/s3/config.ts';
+export declare function interpolateEnv<T>(value: T, env: Record<string, string>): T;
+export interface MountBlock {
+    resource: string;
+    mode?: string;
+    config?: Record<string, unknown>;
+    command_limits?: Record<string, Record<string, unknown>>;
+    /** vfs (default), fuse, or fskit. Mirrors Python's MountBlock.backend. */
+    backend?: string;
+    mountpoint?: string;
+}
+interface RamIndexBlock {
+    type?: 'ram';
+    ttl?: number;
+}
+interface RedisIndexBlock {
+    type: 'redis';
+    ttl?: number;
+    url?: string;
+    keyPrefix?: string;
+}
+interface RamConsoleBlock {
+    type?: 'ram';
+}
+interface RedisConsoleBlock {
+    type: 'redis';
+    url?: string;
+    keyPrefix?: string;
+    /** Keys expire this long after the last append; null keeps them. */
+    ttlSeconds?: number | null;
+}
+interface RamStoreGroupBlock {
+    type?: 'ram';
+}
+interface DiskStoreGroupBlock {
+    type: 'disk';
+    root?: string;
+}
+interface RedisStoreGroupBlock {
+    type: 'redis';
+    url?: string;
+    keyPrefix?: string;
+}
+/**
+ * An S3 group IS an S3Config plus the discriminator, so its keys are
+ * the backend's, validated by the s3 config model rather than here.
+ * It hosts only the sessions+meta plane (conditional-PUT CAS), so it
+ * is valid as the `workspace` override and never as the default.
+ */
+interface S3StoreGroupBlock extends Partial<S3Config> {
+    type: 's3';
+}
+type StoreGroupBlock = RamStoreGroupBlock | DiskStoreGroupBlock | RedisStoreGroupBlock | S3StoreGroupBlock;
+/**
+ * The workspace state store: one block, four planes. The top-level
+ * type/url/keyPrefix pick the default backend for every control-plane
+ * group (namespace nodes, observer events, sessions + workspace
+ * metadata); the optional per-group overrides redirect one group to a
+ * different backend. Sessions and workspace metadata move together by
+ * design, so there is one `workspace` override, not two.
+ */
+interface StoreBlock {
+    type?: 'ram' | 'disk' | 'redis';
+    url?: string;
+    keyPrefix?: string;
+    root?: string;
+    namespace?: StoreGroupBlock | null;
+    observer?: StoreGroupBlock | null;
+    workspace?: StoreGroupBlock | null;
+}
+/**
+ * One `clis:` entry: install a named CLISpec with its own config. The
+ * section key is the installed head word. Exactly one handler source:
+ * `cli` names a registered spec tree; `script` references a program
+ * file whose content is embedded at load (the docker build-context
+ * model). `runtime` optionally pins the world runtime entry that runs
+ * the script; unset picks the first entry speaking the script's
+ * language. `config` validates through the spec's configModel at
+ * install time (fail loud). A CLI never takes a mode and never shares
+ * a mount's credentials: a binary has no mode, the credential does.
+ */
+interface CLIBlock {
+    cli?: string;
+    script?: string;
+    runtime?: string;
+    config?: Record<string, unknown>;
+}
+export interface WorkspaceConfigRaw {
+    mounts: Record<string, MountBlock>;
+    clis?: Record<string, CLIBlock> | null;
+    runtimes?: (string | Record<string, unknown>)[] | null;
+    routePolicy?: string | null;
+    /** The profiles (`profiles:`); every entry validated by parseProfiles. */
+    profiles?: unknown;
+    /** Which profile shapes a session created without one. */
+    profile?: unknown;
+    mode?: string;
+    consistency?: string;
+    defaultSessionId?: string;
+    defaultAgentId?: string;
+    workspaceId?: string;
+    /**
+     * The normalized block IS a `CacheConfig` — so it is handed to the
+     * workspace as one rather than built here. A store the workspace
+     * builds is a store the workspace closes; building it here would
+     * leave a redis client with no owner once the workspace shut down.
+     */
+    cache?: CacheConfig | null;
+    index?: RamIndexBlock | RedisIndexBlock | null;
+    store?: StoreBlock | null;
+    /**
+     * Where background-job consoles live. The redis form keys one stream
+     * per job, so a reader in another process can follow a running job;
+     * ram (the default) keeps consoles in memory. Mirrors Python's
+     * ConsoleBlock.
+     */
+    console?: RamConsoleBlock | RedisConsoleBlock | null;
+    /**
+     * The environment plane: one map, name -> entry. A bare string is
+     * the literal short form; a mapping is an env entry, either a
+     * literal with attrs or a managed pointer (`from`/`ref`/`key`/
+     * `fetch`). Validated by `validateEnvBlock`, translated by the
+     * workspace.
+     */
+    env?: Record<string, unknown> | null;
+    /**
+     * The source table: one map, instance name -> declaration, spelled
+     * the way `mounts:` is. A managed env entry's `from` names an
+     * instance here, or a source directly when the deployment has one
+     * account of it and nothing to configure.
+     */
+    secrets?: Record<string, unknown> | null;
+}
+/**
+ * Interpolate `${VAR}` and check every key, leaving the spelling alone.
+ *
+ * This is the shape that travels: the CLI prepares a config here and
+ * POSTs it, and the daemon runs the same check on what arrives, so the
+ * wire carries Python's snake_case exactly as `model_dump()` does on
+ * that side. Camelizing before sending would make the loader have to
+ * accept its own output, which is how a camelCase spelling Python
+ * rejects would creep back in.
+ */
+export declare function checkWorkspaceConfig(source: Record<string, unknown>, env?: Record<string, string>): Record<string, unknown>;
+export declare function loadWorkspaceConfig(source: Record<string, unknown>, env?: Record<string, string>): WorkspaceConfigRaw;
+/**
+ * Resolve relative script paths and code refs against the config file's
+ * directory.
+ *
+ * A path-form `script`/`route_policy`, a `cli: ./tool.mjs:TREE`, a
+ * `resource: ./wiki.mjs:WikiResource` and a runtime entry's
+ * `name: ./box.mjs:EchoBox` in a config file all mean "next to the file"
+ * (the docker build-context model), never "wherever the server happens
+ * to run". In-memory object configs are untouched. Exported so
+ * the CLI applies the same rebase to a `load`/`clone` override, which is
+ * read without validation and so cannot go through
+ * `checkWorkspaceConfigFile`; mirrors `_absolutize_scripts` in
+ * `mirage/config.py`.
+ */
+export declare function absolutizeScripts(raw: Record<string, unknown>, base: string): void;
+/**
+ * Read a config file into the shape that travels: checked, env
+ * interpolated, script paths resolved against the file's directory —
+ * and still spelled the way the file spelled it. What a CLI sends to
+ * the daemon.
+ */
+export declare function checkWorkspaceConfigFile(path: string, env?: Record<string, string>): Record<string, unknown>;
+export declare function loadWorkspaceConfigFile(path: string, env?: Record<string, string>): WorkspaceConfigRaw;
+export interface WorkspaceArgs {
+    resources: Record<string, [Resource, MountMode, Record<string, Limit>]>;
+    /**
+     * Exactly what `new Workspace` takes, minus the two the loader always
+     * resolves. Spelling the fields out here instead is what once dropped
+     * `clis` and the deny rules on the way to the daemon: a config knob was
+     * parsed and validated, then discarded by a list nobody remembered to
+     * extend.
+     */
+    options: WorkspaceOptions & {
+        mode: MountMode;
+        consistency: ConsistencyPolicy;
+    };
+    kernelMounts: Record<string, [MountBackend, string | undefined]>;
+}
+export declare function configToWorkspaceArgs(cfg: WorkspaceConfigRaw): Promise<WorkspaceArgs>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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