@rcrsr/rill 0.16.0 → 0.18.0

package/dist/ext/fs/sandbox.d.ts

@@ -75,3 +75,21 @@ export declare function checkMode(mode: 'read' | 'write' | 'read-write', operati
  * @throws RuntimeError - If mount path invalid or inaccessible
  */
 export declare function initializeMount(mount: MountConfig): Promise<void>;
+/**
+ * Parses a mount-prefixed path into mount name and relative path.
+ *
+ * Uses longest-first prefix matching to support mount names containing slashes.
+ * Strips a leading `/` before matching.
+ * Example: "/workspace/my/file.txt" → { mountName: "workspace", relativePath: "my/file.txt" }
+ * Example: "/the/mount/file.txt" → { mountName: "the/mount", relativePath: "file.txt" }
+ * Example: "/workspace" → { mountName: "workspace", relativePath: "" }
+ *
+ * @param fullPath - Path with leading `/` and mount prefix
+ * @param mounts - Mount configuration map
+ * @returns Parsed mount name and relative path
+ * @throws RuntimeError - If no mount matches the path prefix
+ */
+export declare function parseMountPath(fullPath: string, mounts: Record<string, MountConfig>): {
+    mountName: string;
+    relativePath: string;
+};

package/dist/ext/fs/sandbox.js

@@ -205,3 +205,36 @@ export async function initializeMount(mount) {
         throw error;
     }
 }
+// ============================================================
+// MOUNT PATH PARSING
+// ============================================================
+/**
+ * Parses a mount-prefixed path into mount name and relative path.
+ *
+ * Uses longest-first prefix matching to support mount names containing slashes.
+ * Strips a leading `/` before matching.
+ * Example: "/workspace/my/file.txt" → { mountName: "workspace", relativePath: "my/file.txt" }
+ * Example: "/the/mount/file.txt" → { mountName: "the/mount", relativePath: "file.txt" }
+ * Example: "/workspace" → { mountName: "workspace", relativePath: "" }
+ *
+ * @param fullPath - Path with leading `/` and mount prefix
+ * @param mounts - Mount configuration map
+ * @returns Parsed mount name and relative path
+ * @throws RuntimeError - If no mount matches the path prefix
+ */
+export function parseMountPath(fullPath, mounts) {
+    const normalized = fullPath.startsWith('/') ? fullPath.slice(1) : fullPath;
+    const sortedNames = Object.keys(mounts).sort((a, b) => b.length - a.length);
+    for (const mountName of sortedNames) {
+        if (normalized === mountName) {
+            return { mountName, relativePath: '' };
+        }
+        if (normalized.startsWith(mountName + '/')) {
+            return {
+                mountName,
+                relativePath: normalized.slice(mountName.length + 1),
+            };
+        }
+    }
+    throw new RuntimeError('RILL-R017', `no mount matches path "${fullPath}"`, undefined, { path: fullPath });
+}

package/dist/ext/kv/index.d.ts

@@ -4,7 +4,7 @@
  * Provides key-value store operations with JSON persistence and schema validation.
  * Supports both open mode (any key/value) and declared mode (schema-defined keys only).
  */
-import type { ExtensionResult, ExtensionConfigSchema, ExtensionManifest } from '../../runtime/ext/extensions.js';
+import type { ExtensionFactoryResult, ExtensionConfigSchema, ExtensionManifest } from '../../runtime/ext/extensions.js';
 import { type SchemaEntry } from './store.js';
 /** Configuration for a single KV mount */
 export interface KvMountConfig {
@@ -51,7 +51,7 @@ export declare const configSchema: ExtensionConfigSchema;
  * Returns 11 functions: get, get_or, set, merge, delete, keys, has, clear, getAll, schema, mounts.
  *
  * @param config - Store configuration (mount-based or single-store)
- * @returns ExtensionResult with 11 KV functions and dispose handler
+ * @returns ExtensionFactoryResult with 11 KV functions and dispose handler
  * @throws RuntimeError if store file is corrupt (EC-25)
  *
  * @example
@@ -78,5 +78,5 @@ export declare const configSchema: ExtensionConfigSchema;
  * });
  * ```
  */
-export declare function createKvExtension(config: KvConfig): ExtensionResult;
+export declare function createKvExtension(config: KvConfig): ExtensionFactoryResult;
 export declare const extensionManifest: ExtensionManifest;

package/dist/ext/kv/index.js

@@ -5,9 +5,10 @@
  * Supports both open mode (any key/value) and declared mode (schema-defined keys only).
  */
 import { RuntimeError } from '../../error-classes.js';
+import { toCallable } from '../../runtime/core/callable.js';
 import { isDict } from '../../runtime/core/callable.js';
 import { createStore } from './store.js';
-import { rillTypeToTypeValue, } from '../../runtime/core/values.js';
+import { structureToTypeValue } from '../../runtime/core/values.js';
 export const configSchema = {
     store: { type: 'string' },
     mounts: { type: 'string' },
@@ -22,7 +23,7 @@ export const configSchema = {
  * Returns 11 functions: get, get_or, set, merge, delete, keys, has, clear, getAll, schema, mounts.
  *
  * @param config - Store configuration (mount-based or single-store)
- * @returns ExtensionResult with 11 KV functions and dispose handler
+ * @returns ExtensionFactoryResult with 11 KV functions and dispose handler
  * @throws RuntimeError if store file is corrupt (EC-25)
  *
  * @example
@@ -279,204 +280,205 @@ export function createKvExtension(config) {
     // ============================================================
     // EXTENSION RESULT
     // ============================================================
-    const result = {
-        get: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
+    return {
+        value: {
+            get: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to retrieve' },
+                    },
+                ],
+                fn: get,
+                annotations: { description: 'Get value or schema default' },
+                returnType: structureToTypeValue({ kind: 'any' }),
+            }),
+            get_or: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to retrieve' },
+                    },
+                    {
+                        name: 'fallback',
+                        type: { kind: 'any' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Fallback value if key missing' },
+                    },
+                ],
+                fn: get_or,
+                annotations: {
+                    description: 'Get value or return fallback if key missing',
                 },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to retrieve' },
+                returnType: structureToTypeValue({ kind: 'any' }),
+            }),
+            set: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to set' },
+                    },
+                    {
+                        name: 'value',
+                        type: { kind: 'any' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Value to store' },
+                    },
+                ],
+                fn: set,
+                annotations: { description: 'Set value with validation' },
+                returnType: structureToTypeValue({ kind: 'bool' }),
+            }),
+            merge: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to merge into' },
+                    },
+                    {
+                        name: 'partial',
+                        type: { kind: 'dict' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Partial dict to merge' },
+                    },
+                ],
+                fn: merge,
+                annotations: {
+                    description: 'Merge partial dict into existing dict value',
                 },
-            ],
-            fn: get,
-            annotations: { description: 'Get value or schema default' },
-            returnType: rillTypeToTypeValue({ type: 'any' }),
-        },
-        get_or: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to retrieve' },
-                },
-                {
-                    name: 'fallback',
-                    type: { type: 'any' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Fallback value if key missing' },
-                },
-            ],
-            fn: get_or,
-            annotations: {
-                description: 'Get value or return fallback if key missing',
-            },
-            returnType: rillTypeToTypeValue({ type: 'any' }),
-        },
-        set: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to set' },
-                },
-                {
-                    name: 'value',
-                    type: { type: 'any' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Value to store' },
-                },
-            ],
-            fn: set,
-            annotations: { description: 'Set value with validation' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        merge: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to merge into' },
-                },
-                {
-                    name: 'partial',
-                    type: { type: 'dict' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Partial dict to merge' },
-                },
-            ],
-            fn: merge,
-            annotations: {
-                description: 'Merge partial dict into existing dict value',
-            },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        delete: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to delete' },
-                },
-            ],
-            fn: deleteKey,
-            annotations: { description: 'Delete key' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        keys: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: keys,
-            annotations: { description: 'Get all keys in mount' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
-        },
-        has: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-                {
-                    name: 'key',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Key to check' },
-                },
-            ],
-            fn: has,
-            annotations: { description: 'Check key existence' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        clear: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: clear,
-            annotations: { description: 'Clear all keys in mount' },
-            returnType: rillTypeToTypeValue({ type: 'bool' }),
-        },
-        getAll: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: getAll,
-            annotations: { description: 'Get all entries as dict' },
-            returnType: rillTypeToTypeValue({ type: 'dict' }),
-        },
-        schema: {
-            params: [
-                {
-                    name: 'mount',
-                    type: { type: 'string' },
-                    defaultValue: undefined,
-                    annotations: { description: 'Mount name' },
-                },
-            ],
-            fn: schema,
-            annotations: { description: 'Get schema information' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
-        },
-        mounts: {
-            params: [],
-            fn: mountsList,
-            annotations: { description: 'Get list of mount metadata' },
-            returnType: rillTypeToTypeValue({ type: 'list' }),
+                returnType: structureToTypeValue({ kind: 'bool' }),
+            }),
+            delete: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to delete' },
+                    },
+                ],
+                fn: deleteKey,
+                annotations: { description: 'Delete key' },
+                returnType: structureToTypeValue({ kind: 'bool' }),
+            }),
+            keys: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: keys,
+                annotations: { description: 'Get all keys in mount' },
+                returnType: structureToTypeValue({ kind: 'list' }),
+            }),
+            has: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                    {
+                        name: 'key',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Key to check' },
+                    },
+                ],
+                fn: has,
+                annotations: { description: 'Check key existence' },
+                returnType: structureToTypeValue({ kind: 'bool' }),
+            }),
+            clear: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: clear,
+                annotations: { description: 'Clear all keys in mount' },
+                returnType: structureToTypeValue({ kind: 'bool' }),
+            }),
+            getAll: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: getAll,
+                annotations: { description: 'Get all entries as dict' },
+                returnType: structureToTypeValue({ kind: 'dict' }),
+            }),
+            schema: toCallable({
+                params: [
+                    {
+                        name: 'mount',
+                        type: { kind: 'string' },
+                        defaultValue: undefined,
+                        annotations: { description: 'Mount name' },
+                    },
+                ],
+                fn: schema,
+                annotations: { description: 'Get schema information' },
+                returnType: structureToTypeValue({ kind: 'list' }),
+            }),
+            mounts: toCallable({
+                params: [],
+                fn: mountsList,
+                annotations: { description: 'Get list of mount metadata' },
+                returnType: structureToTypeValue({ kind: 'list' }),
+            }),
         },
+        dispose,
     };
-    result.dispose = dispose;
-    return result;
 }
 // ============================================================
 // MANIFEST

package/dist/ext/kv/store.d.ts

@@ -4,7 +4,7 @@
  * Provides JSON-based key-value persistence with schema validation.
  * Lifecycle: Load (read store file) -> Execute (in-memory operations) -> Flush (atomic write on dispose)
  */
-import type { RillValue } from '../../runtime/core/values.js';
+import type { RillValue } from '../../runtime/core/types/structures.js';
 /** Schema entry defining type and default for a key */
 export interface SchemaEntry {
     type: 'string' | 'number' | 'bool' | 'list' | 'dict';

package/dist/ext/kv/store.js

@@ -7,6 +7,7 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { RuntimeError } from '../../error-classes.js';
+import { deserializeValue } from '../../runtime/core/types/registrations.js';
 // ============================================================
 // STORE IMPLEMENTATION
 // ============================================================
@@ -52,7 +53,7 @@ export async function createStore(config) {
             // Load declared keys with defaults, validate existing values
             for (const [key, schemaEntry] of Object.entries(schema)) {
                 if (key in parsed) {
-                    const value = parsed[key];
+                    const value = deserializeValue(parsed[key], schemaEntry.type);
                     validateType(key, value, schemaEntry.type, storePath);
                     data.set(key, value);
                 }

package/dist/ext-parse-bridge.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge for runtime/ext modules that need parse().
+ *
+ * Import boundary note (§NOD.2.1):
+ * - This file lives at src/ level (not in runtime/), so it may import
+ *   from the parser barrel.
+ * - runtime/ext/test-context.ts imports from this file
+ *   (../../ext-parse-bridge.js), which is NOT in parser/* — boundary preserved.
+ */
+export { parse as parseSource } from './parser/index.js';

package/dist/ext-parse-bridge.js

@@ -0,0 +1,10 @@
+/**
+ * Bridge for runtime/ext modules that need parse().
+ *
+ * Import boundary note (§NOD.2.1):
+ * - This file lives at src/ level (not in runtime/), so it may import
+ *   from the parser barrel.
+ * - runtime/ext/test-context.ts imports from this file
+ *   (../../ext-parse-bridge.js), which is NOT in parser/* — boundary preserved.
+ */
+export { parse as parseSource } from './parser/index.js';