@gobing-ai/ts-runtime 0.2.8 → 0.3.0

package/README.md

@@ -4,14 +4,17 @@ Runtime abstraction layer — environment detection, file system, process execut
 
 ## Overview
 
-`ts-runtime` decouples application code from platform specifics. Instead of importing `node:fs` or `node:child_process` directly, consumers go through interfaces (`FileSystem`, `ProcessExecutor`) that resolve to the correct implementation at startup based on `RuntimeContext`. Node filesystem modules are loaded lazily by `NodeFileSystem`, so importing the package remains safe for Worker bundles that select `CloudflareFileSystem`.
+`ts-runtime` decouples application code from platform specifics. Instead of importing `node:fs` or `node:child_process` directly, consumers go through interfaces (`FileSystem`, `SyncFileSystem`, `ProcessExecutor`, `SyncProcessExecutor`, `PipeProcessSpawner`) that resolve to the correct implementation at startup based on `RuntimeContext`. Node filesystem modules are loaded lazily by `NodeFileSystem`, so importing the package remains safe for Worker bundles that select `CloudflareFileSystem`.
 
 **Key abstractions:**
 
 | Concept | Interface | Bun/Node impl | Cloudflare impl |
 |---------|-----------|---------------|-----------------|
-| File system | `FileSystem` | `NodeFileSystem` | `CloudflareFileSystem` (unsupported filesystem facade) |
-| Process execution | `ProcessExecutor` | `NodeProcessExecutor` | — |
+| Async file system | `FileSystem` | `NodeFileSystem` | `CloudflareFileSystem` (unsupported filesystem facade) |
+| Sync file system | `SyncFileSystem` | `NodeSyncFileSystem` | — |
+| Buffered process execution | `ProcessExecutor` | `NodeProcessExecutor` | — |
+| Sync process execution | `SyncProcessExecutor` | `BunSyncProcessExecutor` | — |
+| Pipe process spawning | `PipeProcessSpawner` | `BunPipeProcessSpawner` | — |
 | Configuration | `Config` (Zod schema) | YAML + env vars | YAML + env vars |
 | Context | `RuntimeContext` | service locator | service locator |
 | Tracing | `SpanContext` | `{ traceId, spanId }` | `{ traceId, spanId }` |
@@ -20,15 +23,6 @@ Runtime abstraction layer — environment detection, file system, process execut
 
 ```mermaid
 classDiagram
-    class RuntimeFactory {
-        <<interface>>
-        +RuntimeName runtimeName
-        +RuntimeCapabilities capabilities
-        +createFileSystem() FileSystem
-        +loadConfig() Promise~Config~
-        +createContext() RuntimeContext
-    }
-
     class RuntimeContext {
         +RuntimeScope scope
         +RuntimeName runtimeName
@@ -82,6 +76,23 @@ classDiagram
         +createLogStream(path) LogStream
     }
 
+    class SyncFileSystem {
+        <<interface>>
+        +readFile(path) string
+        +writeFile(path, content) void
+        +mkdir(path) void
+        +readDir(path) string[]
+        +unlink(path) void
+    }
+
+    class NodeSyncFileSystem {
+        +readFile(path) string
+        +writeFile(path, content) void
+        +mkdir(path) void
+        +readDir(path) string[]
+        +unlink(path) void
+    }
+
     class ProcessExecutor {
         <<interface>>
         +run(options) Promise~ProcessResult~
@@ -91,6 +102,35 @@ classDiagram
         +run(options) Promise~ProcessResult~
     }
 
+    class SyncProcessExecutor {
+        <<interface>>
+        +runSync(options) ProcessResult
+    }
+
+    class BunSyncProcessExecutor {
+        +runSync(options) ProcessResult
+    }
+
+    class PipeProcessSpawner {
+        <<interface>>
+        +spawn(options) PipeProcess
+    }
+
+    class BunPipeProcessSpawner {
+        +spawn(options) PipeProcess
+    }
+
+    class PipeProcess {
+        <<interface>>
+        +pid number?
+        +stdout ReadableStream?
+        +stderr ReadableStream?
+        +exited Promise~number?~
+        +writeStdin(input) void
+        +endStdin() void
+        +kill(signal?) void
+    }
+
     class Config {
         +AppConfig app
         +DatabaseConfig database
@@ -107,20 +147,23 @@ classDiagram
 
     FileSystem <|.. NodeFileSystem : implements
     FileSystem <|.. CloudflareFileSystem : implements
+    SyncFileSystem <|.. NodeSyncFileSystem : implements
     ProcessExecutor <|.. NodeProcessExecutor : implements
+    SyncProcessExecutor <|.. BunSyncProcessExecutor : implements
+    PipeProcessSpawner <|.. BunPipeProcessSpawner : implements
+    BunPipeProcessSpawner --> PipeProcess : creates
     RuntimeContext --> FileSystem : "fileSystem"
     RuntimeContext --> Config : "config"
     RuntimeContext --> ProcessExecutor : "processExecutor"
-    RuntimeFactory --> RuntimeContext : creates
-    RuntimeFactory --> FileSystem : creates
-    RuntimeFactory --> Config : loadConfig()
 ```
 
 ## How It Works
 
-### 1. Runtime detection
+### 1. Runtime selection
 
-At startup, a `RuntimeFactory` is selected based on the environment:
+The active `FileSystem` is a process-global swapped via `setFileSystem` (default: `NodeFileSystem`);
+`getFs()` returns it. A `RuntimeContext` is constructed directly with the scope, capabilities, and
+services for the current environment — there is no factory abstraction (see ADR-008):
 
 ```ts
 import { createRuntimeContext } from '@gobing-ai/ts-runtime';
@@ -217,7 +260,7 @@ await loadStructuredConfig('rules.yaml', { fetch: myFetch });           // or in
 
 ### 5. File system abstraction
 
-All file operations go through the `FileSystem` interface. Swap implementations for testing:
+Most file operations go through the async `FileSystem` interface. Swap implementations for testing:
 
 ```ts
 import { getFs } from '@gobing-ai/ts-runtime';
@@ -227,6 +270,18 @@ await fs.writeFile('output.json', JSON.stringify(data));
 const content = await fs.readFile('output.json');
 ```
 
+Use `SyncFileSystem` only for APIs that must stay synchronous, such as config discovery at module
+boundaries or compatibility wrappers. The sync seam still keeps direct `node:fs` access inside
+`ts-runtime`.
+
+```ts
+import { NodeSyncFileSystem } from '@gobing-ai/ts-runtime';
+
+const fs = new NodeSyncFileSystem();
+fs.writeFile('agents/coder.yaml', 'id: coder\n');
+const files = fs.readDir('agents');
+```
+
 ### 6. Graceful disposal
 
 `RuntimeContext.dispose()` calls `dispose()` on every registered service that implements the pattern:
@@ -302,6 +357,9 @@ const config = buildConfigFromObject({
 
 ### Process execution
 
+`NodeProcessExecutor` is the default buffered async executor. It returns a `ProcessResult` and only
+throws on non-zero exits when `rejectOnError` is set.
+
 ```ts
 import { NodeProcessExecutor } from '@gobing-ai/ts-runtime';
 
@@ -318,6 +376,46 @@ console.log(result.stdout);
 console.log(`Duration: ${result.durationMs}ms`);
 ```
 
+Use `BunSyncProcessExecutor` for synchronous command probes where the caller needs an immediate
+result, for example checking git state while building a prompt preamble.
+
+```ts
+import { BunSyncProcessExecutor } from '@gobing-ai/ts-runtime';
+
+const exec = new BunSyncProcessExecutor();
+
+const branch = exec.runSync({
+    command: 'git',
+    args: ['branch', '--show-current'],
+    cwd: '/path/to/repo',
+    rejectOnError: false,
+});
+
+if (branch.exitCode === 0) {
+    console.log(branch.stdout);
+}
+```
+
+Use `BunPipeProcessSpawner` when the host needs a long-running subprocess with writable stdin and
+readable stdout/stderr streams. This is the primitive used by team-mode agent processes.
+
+```ts
+import { BunPipeProcessSpawner } from '@gobing-ai/ts-runtime';
+
+const process = new BunPipeProcessSpawner().spawn({
+    command: 'codex',
+    args: ['exec', 'Wait for task messages.'],
+    cwd: '/path/to/repo',
+});
+
+process.writeStdin('[task from=operator id=msg-1] Inspect packages/runtime\n');
+process.endStdin();
+
+const exitCode = await process.exited;
+```
+
+Cloudflare Workers do not expose process execution; do not register process executors there.
+
 ### SpanContext (for telemetry)
 
 ```ts

package/dist/config.d.ts

@@ -29,6 +29,15 @@ export declare const configSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Config = z.output<typeof configSchema>;
+/** Raised when a YAML text cannot be parsed as a plain object. */
+export declare class YamlParseError extends Error {
+    readonly innerError?: unknown | undefined;
+    constructor(message: string, innerError?: unknown | undefined);
+}
+/** Parse YAML text into a plain object. Returns `{}` for null/undefined/empty input. */
+export declare function parseYamlObject(text: string): Record<string, unknown>;
+/** Serialize a plain object to a YAML string. */
+export declare function stringifyYamlObject(value: Record<string, unknown>): string;
 export declare class ConfigLoadError extends Error {
     readonly issues: ZodIssue[];
     constructor(message: string, issues?: ZodIssue[]);
@@ -37,11 +46,9 @@ export declare function getNodeEnv(): string;
 export declare function isTestEnv(): boolean;
 export declare function getProcessEnv(): Record<string, string | undefined>;
 export declare function getDatabaseUrl(): string | undefined;
+/** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
 export declare function interpolateEnv(value: string): string;
 export declare function interpolateTree(value: unknown): unknown;
-export declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): Record<string, unknown>;
-export declare function flattenKeys(obj: Record<string, unknown>, prefix?: string): Record<string, string>;
-export declare function deFlattenKeys(entries: Record<string, string>): Record<string, unknown>;
 export declare function buildConfigFromObject(raw: Record<string, unknown>, options?: {
     overrides?: Partial<Config>;
 }): Config;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEvC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAInD,qBAAa,eAAgB,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,EAAO;CAKvD;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAElE;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUnH;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,SAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW7F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAetF;AAED,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAC9C,MAAM,CAUR;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,MAAM,CAE3G"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAEvC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsBvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAInD,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,KAAK;IAGjC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO;gBAD7B,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAerE;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1E;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,QAAQ,EAAO;CAKvD;AAKD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAElE;AAED,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAEnD;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAOvD;AAED,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAC9C,MAAM,CAUR;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzE;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,MAAM,CAE3G"}

package/dist/config.js

@@ -1,4 +1,5 @@
-import { parse as parseYaml } from 'yaml';
+import { deepMerge } from '@gobing-ai/ts-utils';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
 import { z } from 'zod';
 export const configSchema = z.object({
     app: z
@@ -24,6 +25,35 @@ export const configSchema = z.object({
         .default({ level: 'info', console: true, file: false, json: false }),
 });
 const ENV_INTERPOLATION_RE = /\$\{([A-Z_][A-Z0-9_]*)\}/g;
+/** Raised when a YAML text cannot be parsed as a plain object. */
+export class YamlParseError extends Error {
+    innerError;
+    constructor(message, innerError) {
+        super(message);
+        this.innerError = innerError;
+        this.name = 'YamlParseError';
+    }
+}
+/** Parse YAML text into a plain object. Returns `{}` for null/undefined/empty input. */
+export function parseYamlObject(text) {
+    let parsed;
+    try {
+        parsed = parseYaml(text);
+    }
+    catch (error) {
+        throw new YamlParseError(`YAML parsing failed: ${error.message}`, error instanceof Error ? error : undefined);
+    }
+    if (parsed === null || parsed === undefined)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new YamlParseError('YAML must parse to an object');
+    }
+    return parsed;
+}
+/** Serialize a plain object to a YAML string. */
+export function stringifyYamlObject(value) {
+    return stringifyYaml(value);
+}
 export class ConfigLoadError extends Error {
     issues;
     constructor(message, issues = []) {
@@ -32,6 +62,8 @@ export class ConfigLoadError extends Error {
         this.issues = issues;
     }
 }
+// These accessors read `process.env` directly and are node-bun only (ADR-008). On
+// `cloudflare-workers` there is no `process`; inject config explicitly rather than calling these.
 export function getNodeEnv() {
     return process.env.NODE_ENV ?? 'development';
 }
@@ -44,6 +76,7 @@ export function getProcessEnv() {
 export function getDatabaseUrl() {
     return process.env.DATABASE_URL;
 }
+/** Node-bun only: interpolates `${VAR}` from `process.env` (see note above). */
 export function interpolateEnv(value) {
     return value.replace(ENV_INTERPOLATION_RE, (_match, name) => process.env[name] ?? `\${${name}}`);
 }
@@ -57,48 +90,6 @@ export function interpolateTree(value) {
     }
     return value;
 }
-export function deepMerge(target, source) {
-    const result = { ...target };
-    for (const [key, value] of Object.entries(source)) {
-        if (isPlainObject(value) && isPlainObject(result[key])) {
-            result[key] = deepMerge(result[key], value);
-        }
-        else {
-            result[key] = value;
-        }
-    }
-    return result;
-}
-export function flattenKeys(obj, prefix = '') {
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        const fullKey = prefix ? `${prefix}.${key}` : key;
-        if (isPlainObject(value)) {
-            Object.assign(result, flattenKeys(value, fullKey));
-        }
-        else {
-            result[fullKey] = JSON.stringify(value);
-        }
-    }
-    return result;
-}
-export function deFlattenKeys(entries) {
-    const result = {};
-    for (const [key, rawValue] of Object.entries(entries)) {
-        const parts = key.split('.');
-        let current = result;
-        for (const part of parts.slice(0, -1)) {
-            if (!isPlainObject(current[part]))
-                current[part] = {};
-            current = current[part];
-        }
-        const last = parts.at(-1);
-        if (last === undefined)
-            continue;
-        current[last] = parseConfigValue(rawValue);
-    }
-    return result;
-}
 export function buildConfigFromObject(raw, options = {}) {
     const interpolated = interpolateTree(raw);
     const merged = options.overrides
@@ -112,13 +103,7 @@ export function buildConfigFromObject(raw, options = {}) {
 }
 export function parseConfigYaml(yamlText) {
     try {
-        const parsed = parseYaml(yamlText);
-        if (parsed === null || parsed === undefined)
-            return {};
-        if (!isPlainObject(parsed)) {
-            throw new ConfigLoadError('Config YAML must parse to an object');
-        }
-        return parsed;
+        return parseYamlObject(yamlText);
     }
     catch (error) {
         if (error instanceof ConfigLoadError)
@@ -129,14 +114,6 @@ export function parseConfigYaml(yamlText) {
 export function buildConfigFromYaml(yamlText, options = {}) {
     return buildConfigFromObject(parseConfigYaml(yamlText), options);
 }
-function parseConfigValue(value) {
-    try {
-        return JSON.parse(value);
-    }
-    catch {
-        return value;
-    }
-}
 function isPlainObject(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/context.d.ts

@@ -1,6 +1,6 @@
 import type { Config } from './config';
 import type { FileSystem } from './fs';
-import type { RuntimeCapabilities, RuntimeFactory, RuntimeName } from './types';
+import type { RuntimeCapabilities, RuntimeName } from './types';
 export type RuntimeScope = 'process' | 'server-request' | 'scheduled-event' | 'test';
 export interface RuntimeServiceMap {
     config: Config;
@@ -12,7 +12,6 @@ export interface RuntimeContextOptions<TServices extends RuntimeServiceMap = Run
     runtimeName?: RuntimeName;
     capabilities?: RuntimeCapabilities;
     services?: Partial<TServices>;
-    factory?: RuntimeFactory;
 }
 export declare class RuntimeContext<TServices extends RuntimeServiceMap = RuntimeServiceMap> {
     readonly scope: RuntimeScope;

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhF,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC1F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,qBAAa,cAAc,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,mDAA0D;gBAE/D,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM;IAsB1D,QAAQ,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhE,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAQxD,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAIzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAejC;AAMD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB,EACxF,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC/C,cAAc,CAAC,SAAS,CAAC,CAE3B"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC1F,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CACjC;AAED,qBAAa,cAAc,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IAC/E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,mDAA0D;gBAE/D,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM;IAqB1D,QAAQ,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhE,OAAO,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;IAQxD,GAAG,CAAC,CAAC,SAAS,MAAM,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAIzC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAejC;AAMD,wBAAgB,oBAAoB,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB,EACxF,OAAO,GAAE,qBAAqB,CAAC,SAAS,CAAM,GAC/C,cAAc,CAAC,SAAS,CAAC,CAE3B"}

package/dist/context.js

@@ -7,10 +7,9 @@ export class RuntimeContext {
     services = new Map();
     constructor(options = {}) {
         this.scope = options.scope ?? 'process';
-        this.runtimeName = options.runtimeName ?? options.factory?.runtimeName ?? 'node-bun';
+        this.runtimeName = options.runtimeName ?? 'node-bun';
         this.capabilities =
             options.capabilities ??
-                options.factory?.capabilities ??
                 {
                     hasFilesystem: true,
                     hasProcessExecution: true,

package/dist/fs.d.ts

@@ -22,6 +22,15 @@ export interface FileSystem {
     rename(src: string, dest: string): Promise<void>;
     createLogStream(path: string): LogStream;
 }
+export interface SyncFileSystem {
+    readFile(path: string): string;
+    writeFile(path: string, content: string): void;
+    mkdir(path: string): void;
+    exists(path: string): boolean;
+    readDir(path: string): string[];
+    stat(path: string): FileStat | null;
+    unlink(path: string): void;
+}
 export declare class NodeFileSystem implements FileSystem {
     readFile(path: string): Promise<string>;
     writeFile(path: string, content: string): Promise<void>;
@@ -36,6 +45,15 @@ export declare class NodeFileSystem implements FileSystem {
     rename(src: string, dest: string): Promise<void>;
     createLogStream(path: string): LogStream;
 }
+export declare class NodeSyncFileSystem implements SyncFileSystem {
+    readFile(path: string): string;
+    writeFile(path: string, content: string): void;
+    mkdir(path: string): void;
+    exists(path: string): boolean;
+    readDir(path: string): string[];
+    stat(path: string): FileStat | null;
+    unlink(path: string): void;
+}
 export declare class CloudflareFileSystem implements FileSystem {
     readFile(path: string): Promise<string>;
     writeFile(path: string, _content: string): Promise<void>;
@@ -53,6 +71,7 @@ export declare class CloudflareFileSystem implements FileSystem {
 export declare function setFileSystem(fileSystem: FileSystem): () => void;
 export declare function getFs(): FileSystem;
 export declare function ensureDirForFile(path: string, fs?: FileSystem): Promise<void>;
+export declare function ensureDirForFileSync(path: string, fs: SyncFileSystem): void;
 export declare function atomicWriteFile(path: string, content: string, fs?: FileSystem): Promise<void>;
 export declare function atomicWriteJson(path: string, value: unknown, fs?: FileSystem): Promise<void>;
 export declare function readJsonFile<T = unknown>(path: string, fs?: FileSystem): Promise<T>;

package/dist/fs.d.ts.map

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

package/dist/fs.js

@@ -1,3 +1,5 @@
+import { mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { dirnamePath, getProcessCwd, joinPath, resolvePath } from './path.js';
 let fsPromisesModule = null;
 let fsModule = null;
 function nodeFsPromises() {
@@ -76,37 +78,74 @@ export class NodeFileSystem {
         return new LazyNodeLogStream(path);
     }
 }
+export class NodeSyncFileSystem {
+    readFile(path) {
+        return readFileSync(path, 'utf-8');
+    }
+    writeFile(path, content) {
+        ensureDirForFileSync(path, this);
+        writeFileSync(path, content, 'utf-8');
+    }
+    mkdir(path) {
+        mkdirSync(path, { recursive: true });
+    }
+    exists(path) {
+        try {
+            return this.stat(path) !== null;
+        }
+        catch {
+            return false;
+        }
+    }
+    readDir(path) {
+        return readdirSync(path);
+    }
+    stat(path) {
+        try {
+            const value = statSync(path);
+            return {
+                isFile: () => value.isFile(),
+                isDirectory: () => value.isDirectory(),
+                size: value.size,
+                mtimeMs: value.mtimeMs,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    unlink(path) {
+        rmSync(path, { recursive: true, force: true });
+    }
+}
 class LazyNodeLogStream {
     ready;
     ended = false;
-    pending = [];
+    // Single serialized chain: every write/end is appended here, so the underlying stream observes
+    // them in call order regardless of how the resolving microtasks interleave. A per-write `shift()`
+    // off a shared buffer (the previous approach) could reorder writes that arrived in the same tick.
+    tail;
     constructor(path) {
         this.ready = nodeFs().then(({ createWriteStream, mkdirSync }) => {
             mkdirSync(dirnamePath(path), { recursive: true });
             const stream = createWriteStream(path, { flags: 'a' });
-            for (const chunk of this.pending.splice(0))
-                stream.write(chunk);
-            if (this.ended)
-                stream.end();
             return {
                 write: (chunk) => stream.write(chunk),
                 end: () => stream.end(),
             };
         });
+        this.tail = this.ready;
     }
     write(chunk) {
         if (this.ended)
             return;
-        this.pending.push(chunk);
-        void this.ready.then((stream) => {
-            const next = this.pending.shift();
-            if (next !== undefined)
-                stream.write(next);
-        });
+        this.tail = this.tail.then(() => this.ready.then((stream) => stream.write(chunk)));
     }
     end() {
+        if (this.ended)
+            return;
         this.ended = true;
-        void this.ready.then((stream) => stream.end());
+        this.tail = this.tail.then(() => this.ready.then((stream) => stream.end()));
     }
 }
 const CLOUDFLARE_FS_ERROR = 'FileSystem is not available on Cloudflare Workers. Use D1, KV, or R2.';
@@ -165,9 +204,12 @@ export function getFs() {
 export async function ensureDirForFile(path, fs = getFs()) {
     await fs.mkdir(dirnamePath(path));
 }
+export function ensureDirForFileSync(path, fs) {
+    fs.mkdir(dirnamePath(path));
+}
 export async function atomicWriteFile(path, content, fs = getFs()) {
     await ensureDirForFile(path, fs);
-    const tempPath = `${path}.${getProcessPid()}.${Date.now()}.tmp`;
+    const tempPath = `${path}.${getProcessPid()}.${uniqueToken()}.tmp`;
     await fs.writeFile(tempPath, content);
     await fs.rename(tempPath, path);
 }
@@ -223,55 +265,8 @@ function hasBunFile(path) {
 function getProcessPid() {
     return globalThis.process?.pid ?? 0;
 }
-function getProcessCwd() {
-    return globalThis.process?.cwd?.() ?? '/';
-}
-function normalizeSeparators(path) {
-    return path.replaceAll('\\', '/');
-}
-function isAbsolutePath(path) {
-    return path.startsWith('/') || /^[A-Za-z]:\//.test(normalizeSeparators(path));
-}
-function dirnamePath(path) {
-    const input = normalizeSeparators(path);
-    if (/^\/+$/.test(input))
-        return '/';
-    const normalized = input.replace(/\/+$/, '');
-    if (normalized === '' || normalized === '/')
-        return normalized || '.';
-    const index = normalized.lastIndexOf('/');
-    if (index < 0)
-        return '.';
-    if (index === 0)
-        return '/';
-    return normalized.slice(0, index);
-}
-function joinPath(...segments) {
-    const filtered = segments.filter((segment) => segment.length > 0).map(normalizeSeparators);
-    if (filtered.length === 0)
-        return '.';
-    const absolute = isAbsolutePath(filtered[0] ?? '');
-    const joined = filtered.join('/').replace(/\/+/g, '/');
-    return absolute ? joined : joined.replace(/^\//, '');
-}
-function resolvePath(...segments) {
-    const candidates = segments.length === 0 ? [getProcessCwd()] : segments;
-    let resolved = '';
-    for (const segment of candidates.map(normalizeSeparators)) {
-        if (segment.length === 0)
-            continue;
-        resolved = isAbsolutePath(segment) ? segment : joinPath(resolved || getProcessCwd(), segment);
-    }
-    const parts = [];
-    const absolute = isAbsolutePath(resolved);
-    for (const part of resolved.split('/')) {
-        if (part === '' || part === '.')
-            continue;
-        if (part === '..') {
-            parts.pop();
-            continue;
-        }
-        parts.push(part);
-    }
-    return `${absolute ? '/' : ''}${parts.join('/')}` || (absolute ? '/' : '.');
+// Two writers to the same path in the same millisecond must not share a temp name, or one clobbers
+// the other before rename. randomUUID disambiguates; Date.now keeps names sortable for debugging.
+function uniqueToken() {
+    return `${Date.now()}.${crypto.randomUUID()}`;
 }

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './config';
 export * from './context';
 export * from './fs';
+export * from './path';
 export * from './process-executor';
 export * from './schema-validation';
 export * from './types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,QAAQ,CAAC;AACvB,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC"}