npcts 0.1.5 → 0.1.7

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,WAAW,CAAC"}

package/dist/adapters/base.js.map

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

package/dist/adapters/electron/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/adapters/electron/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AAM3D,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;AAyFnD,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,WAAW,CAO7D,CAAC"}

package/dist/adapters/electron/bridge.js.map

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

package/dist/adapters/http/index.js

@@ -1,4 +1,4 @@
 /**
  * HTTP Adapters
  */
-export { createHttpSpatialConfigClient, createHttpCommandClient, createHttpImageUploadClient, createHttpSpatialServices, } from './spatialServices';
+export { createHttpSpatialConfigClient, createHttpCommandClient, createHttpImageUploadClient, createHttpSpatialServices, } from './spatialServices.js';

package/dist/adapters/index.js

@@ -1,4 +1,4 @@
 // Adapters module exports
-export * from './base';
-export { createElectronAdapter } from './electron/bridge';
-export * from './http';
+export * from './base.js';
+export { createElectronAdapter } from './electron/bridge.js';
+export * from './http/index.js';

package/dist/core/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/core/browser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC9C,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC/F,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/core/browser.js.map

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

package/dist/core/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/core/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,iBAAiB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACnE,kBAAkB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClE,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9F,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE"}

package/dist/core/chat.js.map

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

package/dist/core/files.d.ts

@@ -15,6 +15,34 @@ export interface FileSystemClient {
     deleteDirectory(path: string): Promise<void>;
     rename(oldPath: string, newPath: string): Promise<void>;
 }
+/**
+ * File I/O adapter for document viewers (CsvViewer, DocxViewer, PptxViewer).
+ * Abstracts over Electron IPC (window.api) and HTTP fetch so the same
+ * viewer components work in both incognide and web apps.
+ */
+export interface DocumentFileApi {
+    /** Read a file as binary (XLSX, DOCX, PPTX are all ZIP-based) */
+    readFileBuffer(path: string): Promise<ArrayBuffer>;
+    /** Read a file as text (CSV, HTML, plain text) */
+    readFileContent(path: string): Promise<string>;
+    /** Write text content to a file */
+    writeFileContent(path: string, content: string): Promise<void>;
+    /** Write binary content to a file */
+    writeFileBuffer(path: string, buffer: ArrayBuffer | Uint8Array): Promise<void>;
+    /** Convert a DOCX file to HTML via mammoth (optional, DocxViewer only) */
+    convertDocxToHtml?(path: string): Promise<{
+        html: string;
+        fonts?: string[];
+        error?: string;
+    }>;
+    /** Read CSV content as text with error handling (optional, CsvViewer only) */
+    readCsvContent?(path: string): Promise<{
+        content: string;
+        error?: string;
+    }>;
+}
+/** Extract filename from a file path */
+export declare const getFileName: (filePath: string | null | undefined) => string;
 /**
  * Normalize a file path by converting backslashes to forward slashes
  * and removing trailing slashes

package/dist/core/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD"}

package/dist/core/files.js

@@ -1,3 +1,9 @@
+/** Extract filename from a file path */
+export const getFileName = (filePath) => {
+    if (!filePath)
+        return '';
+    return filePath.replace(/\\/g, '/').split('/').pop() || '';
+};
 /**
  * Normalize a file path by converting backslashes to forward slashes
  * and removing trailing slashes

package/dist/core/files.js.map

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

package/dist/core/index.d.ts

@@ -8,3 +8,4 @@ export * from './browser';
 export * from './jobs';
 export * from './database';
 export * from './spatial';
+export * from './jinx';

package/dist/core/index.js

@@ -1,11 +1,12 @@
 // Core module exports
-export * from './types';
-export * from './layout';
-export * from './files';
-export * from './utils';
-export * from './chat';
-export * from './stream';
-export * from './browser';
-export * from './jobs';
-export * from './database';
-export * from './spatial';
+export * from './types.js';
+export * from './layout.js';
+export * from './files.js';
+export * from './utils.js';
+export * from './chat.js';
+export * from './stream.js';
+export * from './browser.js';
+export * from './jobs.js';
+export * from './database.js';
+export * from './spatial.js';
+export * from './jinx.js';

package/dist/core/jinx.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Jinx - TypeScript/TSX workflow engine for npcts
+ *
+ * Mirrors the Python jinx system in npcpy but handles:
+ * - engine: tsx - React components, transpiled with esbuild-wasm
+ * - engine: node - Node.js code execution
+ *
+ * Jinx format (YAML):
+ * ```yaml
+ * jinx_name: tile.db_tool
+ * description: Opens Database Tool pane
+ * inputs:
+ *   - label: "DB Tool"
+ *   - icon: "Database"
+ * steps:
+ *   - name: render
+ *     engine: tsx
+ *     code: |
+ *       export default function({ actions }) {
+ *         return <button onClick={() => actions.createDBToolPane()}>DB</button>
+ *       }
+ * ```
+ */
+import React from 'react';
+/**
+ * Initialize esbuild-wasm (call once at app startup)
+ */
+export declare function initJinxEngine(): Promise<void>;
+/**
+ * Input parameter definition
+ */
+export interface JinxInput {
+    [key: string]: any;
+}
+/**
+ * Step definition
+ */
+export interface JinxStep {
+    name: string;
+    engine: 'tsx' | 'node' | string;
+    code: string;
+}
+/**
+ * Jinx definition (parsed from YAML)
+ */
+export interface JinxDefinition {
+    jinx_name: string;
+    description?: string;
+    inputs?: JinxInput[];
+    steps: JinxStep[];
+    _source_path?: string;
+}
+/**
+ * Execution context passed to jinx code
+ */
+export interface JinxContext {
+    [key: string]: any;
+    output?: any;
+}
+/**
+ * Result of executing a TSX step (returns a React component)
+ */
+export interface TsxStepResult {
+    Component: React.ComponentType<any>;
+    props?: Record<string, any>;
+}
+/**
+ * Jinx class - loads and executes jinx workflows
+ */
+export declare class Jinx {
+    jinx_name: string;
+    description: string;
+    inputs: JinxInput[];
+    steps: JinxStep[];
+    _source_path?: string;
+    constructor(data: JinxDefinition | string, sourcePath?: string);
+    private _loadFromData;
+    /**
+     * Get default input values from the inputs definition
+     */
+    getDefaultInputs(): Record<string, any>;
+    /**
+     * Execute all steps in the jinx
+     */
+    execute(inputValues?: Record<string, any>, extraContext?: Record<string, any>): Promise<JinxContext>;
+    /**
+     * Execute a single step and get a React component (for tsx engine)
+     */
+    executeForComponent(inputValues?: Record<string, any>, extraContext?: Record<string, any>): Promise<TsxStepResult | null>;
+    private _executeStep;
+    /**
+     * Execute a TSX step - transpile and return the component
+     */
+    private _executeTsxStep;
+    /**
+     * Execute a Node step - runs JS code with context available
+     */
+    private _executeNodeStep;
+    /**
+     * Convert to a tool definition (for LLM tool use)
+     */
+    toToolDef(): Record<string, any>;
+    /**
+     * Serialize back to YAML
+     */
+    toYaml(): string;
+}
+/**
+ * Load a jinx from a YAML string
+ */
+export declare function loadJinx(yamlContent: string, sourcePath?: string): Jinx;
+/**
+ * Load multiple jinxes and return a lookup dict
+ */
+export declare function loadJinxes(jinxYamls: Array<{
+    content: string;
+    path?: string;
+}>): Map<string, Jinx>;

package/dist/core/jinx.js

@@ -0,0 +1,264 @@
+/**
+ * Jinx - TypeScript/TSX workflow engine for npcts
+ *
+ * Mirrors the Python jinx system in npcpy but handles:
+ * - engine: tsx - React components, transpiled with esbuild-wasm
+ * - engine: node - Node.js code execution
+ *
+ * Jinx format (YAML):
+ * ```yaml
+ * jinx_name: tile.db_tool
+ * description: Opens Database Tool pane
+ * inputs:
+ *   - label: "DB Tool"
+ *   - icon: "Database"
+ * steps:
+ *   - name: render
+ *     engine: tsx
+ *     code: |
+ *       export default function({ actions }) {
+ *         return <button onClick={() => actions.createDBToolPane()}>DB</button>
+ *       }
+ * ```
+ */
+import * as esbuild from 'esbuild-wasm';
+import yaml from 'js-yaml';
+import React from 'react';
+// Track esbuild initialization
+let esbuildInitialized = false;
+let esbuildInitPromise = null;
+/**
+ * Initialize esbuild-wasm (call once at app startup)
+ */
+export async function initJinxEngine() {
+    if (esbuildInitialized)
+        return;
+    if (esbuildInitPromise)
+        return esbuildInitPromise;
+    esbuildInitPromise = esbuild.initialize({
+        wasmURL: 'https://unpkg.com/esbuild-wasm@0.24.0/esbuild.wasm',
+    }).then(() => {
+        esbuildInitialized = true;
+    });
+    return esbuildInitPromise;
+}
+/**
+ * Jinx class - loads and executes jinx workflows
+ */
+export class Jinx {
+    constructor(data, sourcePath) {
+        if (typeof data === 'string') {
+            // Parse YAML string
+            const parsed = yaml.load(data);
+            this._loadFromData(parsed);
+        }
+        else {
+            this._loadFromData(data);
+        }
+        if (sourcePath) {
+            this._source_path = sourcePath;
+        }
+    }
+    _loadFromData(data) {
+        if (!data.jinx_name) {
+            throw new Error("Missing 'jinx_name' in jinx definition");
+        }
+        this.jinx_name = data.jinx_name;
+        this.description = data.description || '';
+        this.inputs = data.inputs || [];
+        this.steps = data.steps || [];
+        this._source_path = data._source_path;
+    }
+    /**
+     * Get default input values from the inputs definition
+     */
+    getDefaultInputs() {
+        const defaults = {};
+        for (const input of this.inputs) {
+            if (typeof input === 'object') {
+                for (const [key, value] of Object.entries(input)) {
+                    defaults[key] = value;
+                }
+            }
+        }
+        return defaults;
+    }
+    /**
+     * Execute all steps in the jinx
+     */
+    async execute(inputValues = {}, extraContext = {}) {
+        await initJinxEngine();
+        // Build initial context with defaults + provided inputs
+        const context = {
+            ...this.getDefaultInputs(),
+            ...inputValues,
+            ...extraContext,
+            output: null,
+        };
+        // Execute each step
+        for (const step of this.steps) {
+            await this._executeStep(step, context);
+        }
+        return context;
+    }
+    /**
+     * Execute a single step and get a React component (for tsx engine)
+     */
+    async executeForComponent(inputValues = {}, extraContext = {}) {
+        await initJinxEngine();
+        const context = {
+            ...this.getDefaultInputs(),
+            ...inputValues,
+            ...extraContext,
+            output: null,
+        };
+        // Find the tsx step (usually named 'render')
+        const tsxStep = this.steps.find(s => s.engine === 'tsx');
+        if (!tsxStep) {
+            return null;
+        }
+        const Component = await this._executeTsxStep(tsxStep, context);
+        return Component ? { Component, props: context } : null;
+    }
+    async _executeStep(step, context) {
+        const { engine, code, name } = step;
+        try {
+            switch (engine) {
+                case 'tsx':
+                    const Component = await this._executeTsxStep(step, context);
+                    if (Component) {
+                        context[name] = Component;
+                        context.output = Component;
+                    }
+                    break;
+                case 'node':
+                    await this._executeNodeStep(step, context);
+                    break;
+                default:
+                    console.warn(`Unknown engine '${engine}' in step '${name}'`);
+            }
+        }
+        catch (err) {
+            console.error(`Error executing step '${name}':`, err);
+            context.output = `Error in step '${name}': ${err}`;
+        }
+    }
+    /**
+     * Execute a TSX step - transpile and return the component
+     */
+    async _executeTsxStep(step, context) {
+        const { code, name } = step;
+        try {
+            // Transpile TSX to JS
+            const result = await esbuild.transform(code, {
+                loader: 'tsx',
+                jsx: 'transform',
+                jsxFactory: 'React.createElement',
+                jsxFragment: 'React.Fragment',
+                target: 'es2020',
+            });
+            const transpiledCode = result.code;
+            // Create a module-like execution environment
+            // We'll wrap the code to capture the default export
+            const wrappedCode = `
+        const exports = {};
+        const module = { exports };
+        ${transpiledCode}
+        return module.exports.default || exports.default;
+      `;
+            // Execute with React and context available
+            const execFn = new Function('React', 'context', wrappedCode);
+            const Component = execFn(React, context);
+            return Component;
+        }
+        catch (err) {
+            console.error(`TSX transpile error in step '${name}':`, err);
+            return null;
+        }
+    }
+    /**
+     * Execute a Node step - runs JS code with context available
+     */
+    async _executeNodeStep(step, context) {
+        const { code, name } = step;
+        try {
+            // Wrap code to have context available and handle async
+            const wrappedCode = `
+        return (async function(context) {
+          ${code}
+        })(context);
+      `;
+            const execFn = new Function('context', wrappedCode);
+            await execFn(context);
+        }
+        catch (err) {
+            console.error(`Node execution error in step '${name}':`, err);
+            context.output = `Error: ${err}`;
+        }
+    }
+    /**
+     * Convert to a tool definition (for LLM tool use)
+     */
+    toToolDef() {
+        const properties = {};
+        const required = [];
+        for (const input of this.inputs) {
+            if (typeof input === 'string') {
+                properties[input] = { type: 'string', description: `Parameter: ${input}` };
+                required.push(input);
+            }
+            else if (typeof input === 'object') {
+                const [inputName, defaultValue] = Object.entries(input)[0];
+                properties[inputName] = {
+                    type: 'string',
+                    description: `Parameter: ${inputName}${defaultValue !== '' ? ` (default: ${defaultValue})` : ''}`,
+                };
+            }
+        }
+        return {
+            type: 'function',
+            function: {
+                name: this.jinx_name,
+                description: this.description || `Jinx: ${this.jinx_name}`,
+                parameters: {
+                    type: 'object',
+                    properties,
+                    required,
+                },
+            },
+        };
+    }
+    /**
+     * Serialize back to YAML
+     */
+    toYaml() {
+        return yaml.dump({
+            jinx_name: this.jinx_name,
+            description: this.description,
+            inputs: this.inputs,
+            steps: this.steps,
+        });
+    }
+}
+/**
+ * Load a jinx from a YAML string
+ */
+export function loadJinx(yamlContent, sourcePath) {
+    return new Jinx(yamlContent, sourcePath);
+}
+/**
+ * Load multiple jinxes and return a lookup dict
+ */
+export function loadJinxes(jinxYamls) {
+    const jinxMap = new Map();
+    for (const { content, path } of jinxYamls) {
+        try {
+            const jinx = loadJinx(content, path);
+            jinxMap.set(jinx.jinx_name, jinx);
+        }
+        catch (err) {
+            console.error(`Failed to load jinx from ${path}:`, err);
+        }
+    }
+    return jinxMap;
+}

package/dist/core/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/core/jobs.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,SAAS;IACxB,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/core/jobs.js.map

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

package/dist/core/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/core/layout.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAClC,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,SAAS,CACP,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjD"}

package/dist/core/layout.js.map

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

package/dist/core/spatial.d.ts

@@ -41,11 +41,13 @@ export interface DoorConfig {
     leadsTo: string;
     orientation: DoorDirection;
     image?: string;
+    type?: 'room' | 'outside';
 }
 export interface Door extends BoundingBox {
     leadsTo: string;
     orientation: DoorDirection;
     image?: string;
+    type?: 'room' | 'outside';
 }
 export interface MenuItemConfig {
     name: string;
@@ -88,6 +90,7 @@ export interface RoomConfig {
     floor_tile_size?: number;
     floor_pattern?: string;
     floor_pattern_size?: string;
+    outside?: boolean;
 }
 export interface Room {
     walls: Record<string, Wall>;
@@ -259,3 +262,51 @@ export interface LoadedImage {
     src: string;
     finalPath?: string;
 }
+export type AvatarAccessory = 'none' | 'hat' | 'glasses' | 'crown' | 'halo' | 'horns' | 'cat-ears' | 'headphones' | 'bow' | 'bandana';
+export type AvatarTrailEffect = 'none' | 'sparkle' | 'glow' | 'shadow' | 'hearts' | 'fire' | 'ice' | 'leaves';
+export type AvatarEmote = 'neutral' | 'happy' | 'sad' | 'angry' | 'surprised' | 'sleeping' | 'love' | 'cool';
+export interface AvatarSettings {
+    name: string;
+    primaryColor: string;
+    secondaryColor: string;
+    outlineColor: string;
+    size: number;
+    showNameTag: boolean;
+    nameTagColor: string;
+    trailEffect: AvatarTrailEffect;
+    accessory: AvatarAccessory;
+    statusMessage?: string;
+    emote?: AvatarEmote;
+    moveSpeed?: number;
+    nameTagStyle?: 'default' | 'bubble' | 'minimal' | 'fancy';
+    useCustomColors?: boolean;
+}
+export interface RemotePlayer {
+    id: string;
+    name: string;
+    x: number;
+    y: number;
+    direction: CharacterDirection;
+    frame: number;
+    isMoving: boolean;
+    avatarSettings?: AvatarSettings;
+    spriteSheets: SpriteSheets;
+}
+export interface OutsideZoneConfig {
+    name: string;
+    walls: Record<WallPosition, WallConfig>;
+    doors: Record<string, DoorConfig>;
+    applications: Record<string, ApplicationConfig>;
+    floor_image?: string;
+    floor_tile?: boolean;
+    floor_tile_size?: number;
+    floor_pattern?: string;
+    floor_pattern_size?: string;
+}
+export interface OutsideChatMessage {
+    id: string;
+    senderId: string;
+    senderName: string;
+    content: string;
+    timestamp: number;
+}

package/dist/core/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/core/stream.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc,CAAC,MAAM;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC"}

package/dist/core/stream.js.map

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

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5E,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export * from "./core/files";
 export * from "./core/utils";
 export * from "./core/database";
 export * from "./core/vm";
-export type { Vector2D, Dimensions, BoundingBox, WallOrientation, DoorDirection, CharacterDirection, WallStyle, WallPosition, WallConfig, DoorConfig, MenuItemConfig, ApplicationConfig, RoomConfig, CharacterConfig, SpriteSheets, SpatialWorldConfig, CharacterState, SpatialWorldState, CommandResult, RunningApp, ImageUploadResult, CollisionCheckResult, CollisionContext, SpatialEventType, SpatialEvent, RoomChangeEvent, AppOpenEvent, CharacterMoveEvent, EditorSelection, DragState, ViewportDimensions, LoadedImage, SpatialConfigClient, CommandExecutionClient, ImageUploadClient, Wall as WallData, Door as DoorData, Application as ApplicationData, Room as RoomData, Character as CharacterData, } from "./core/spatial";
+export type { Vector2D, Dimensions, BoundingBox, WallOrientation, DoorDirection, CharacterDirection, WallStyle, WallPosition, WallConfig, DoorConfig, MenuItemConfig, ApplicationConfig, RoomConfig, CharacterConfig, SpriteSheets, SpatialWorldConfig, CharacterState, SpatialWorldState, CommandResult, RunningApp, ImageUploadResult, CollisionCheckResult, CollisionContext, SpatialEventType, SpatialEvent, RoomChangeEvent, AppOpenEvent, CharacterMoveEvent, EditorSelection, DragState, ViewportDimensions, LoadedImage, SpatialConfigClient, CommandExecutionClient, ImageUploadClient, RemotePlayer, OutsideZoneConfig, OutsideChatMessage, Wall as WallData, Door as DoorData, Application as ApplicationData, Room as RoomData, Character as CharacterData, } from "./core/spatial";
 export * from "./adapters/base";
 export { createElectronAdapter } from "./adapters/electron/bridge";
 export * from "./adapters/http";

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAE7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9E,cAAc,wBAAwB,CAAC"}