pynect 0.0.0-stage → 0.2.0

package/dist/cli/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":";;;;;AAoBA,8CAsCC;AA1DD,gDAAwB;AACxB,yCAA4C;AAC5C,+CAAiD;AACjD,kEAAwD;AAiBxD,SAAgB,iBAAiB;IAC/B,OAAO,IAAI,mBAAO,CAAC,MAAM,CAAC;SACvB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,uBAAuB,EAAE,mDAAmD,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;SAC7D,MAAM,CAAC,2BAA2B,EAAE,+BAA+B,CAAC;SACpE,MAAM,CAAC,4BAA4B,EAAE,2CAA2C,CAAC;SACjF,MAAM,CAAC,wBAAwB,EAAE,qCAAqC,CAAC;SACvE,SAAS,CAAC,aAAa,CAAC,4BAA4B,EAAE,mCAAmC,CAAC,CAAC;SAC3F,SAAS,CAAC,aAAa,CAAC,wBAAwB,EAAE,uBAAuB,CAAC,CAAC;SAC3E,SAAS,CAAC,aAAa,CACtB,wCAAwC,EACxC,kCAAkC,CACnC,CAAC;SACD,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,UAAU,EAAE,uDAAuD,CAAC;SAC3E,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC;SACzE,MAAM,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAC5C,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAW,EAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;gBACrC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;gBAC3C,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;gBAChD,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;gBACvC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM;gBAC7C,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY;aACxC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACjB,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gBAAgB,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,8BAA8B;YAC7E,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,gBAAgB;YACnD,aAAa,MAAM,CAAC,QAAQ,IAAI;YAChC,gBAAgB,cAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CACxD,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,WAAmB;IACvD,OAAO,IAAI,kBAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,IAAA,sBAAY,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACvF,CAAC"}

package/dist/config/project.d.ts

@@ -0,0 +1,57 @@
+export type AutoSyncMode = 'never' | 'if-missing';
+export interface PynectModuleManifest {
+    import: string;
+    include?: string[];
+}
+export interface PynectPackageManifest {
+    schemaVersion?: 1;
+    requiresPython?: string;
+    requirements?: string[];
+    overrides?: Record<string, string>;
+    modules?: Record<string, PynectModuleManifest>;
+    python?: string;
+    managedPython?: string;
+    uvVersion?: string;
+    installPython?: boolean;
+    installUv?: boolean;
+    createVirtualEnvironment?: boolean;
+    autoSync?: AutoSyncMode;
+    lockfile?: string;
+}
+export interface ProjectConfigOverrides {
+    projectRoot?: string;
+    python?: string;
+    requiresPython?: string;
+    managedPython?: string;
+    uvVersion?: string;
+    installPython?: boolean;
+    installUv?: boolean;
+    createVirtualEnvironment?: boolean;
+    autoSync?: AutoSyncMode;
+    lockfile?: string;
+    env?: Record<string, string | undefined>;
+}
+export interface ResolvedProjectConfig {
+    projectRoot: string;
+    python: string;
+    requiresPython: string;
+    managedPython: string;
+    managedPythonExplicit: boolean;
+    uvVersion: string;
+    installPython: boolean;
+    installUv: boolean;
+    createVirtualEnvironment: boolean;
+    autoSync: AutoSyncMode;
+    lockfile: string;
+    packageManifest: PynectPackageManifest;
+    env: NodeJS.ProcessEnv;
+}
+/**
+ * Resolve one project policy for the runtime and CLI.
+ * Precedence is API or CLI overrides, environment, root package.json, then defaults.
+ */
+export declare function resolveProjectConfig(overrides?: ProjectConfigOverrides): ResolvedProjectConfig;
+export declare function readRootPynectManifest(projectRoot: string): PynectPackageManifest;
+export declare function validatePackageManifest(value: unknown, source: string): PynectPackageManifest;
+export declare function parseBoolean(value: string, name: string): boolean;
+//# sourceMappingURL=project.d.ts.map

package/dist/config/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/config/project.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,YAAY,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,wBAAwB,EAAE,OAAO,CAAC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,qBAAqB,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAcD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,sBAA2B,GACrC,qBAAqB,CAwEvB;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CAYjF;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,GACb,qBAAqB,CAyBvB;AAiDD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjE"}

package/dist/config/project.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveProjectConfig = resolveProjectConfig;
+exports.readRootPynectManifest = readRootPynectManifest;
+exports.validatePackageManifest = validatePackageManifest;
+exports.parseBoolean = parseBoolean;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const pyfig_1 = require("pyfig");
+const DEFAULTS = {
+    python: '',
+    requiresPython: pyfig_1.DEFAULT_PYTHON_RANGE,
+    managedPython: pyfig_1.DEFAULT_MANAGED_PYTHON,
+    uvVersion: pyfig_1.DEFAULT_UV_VERSION,
+    installPython: true,
+    installUv: true,
+    createVirtualEnvironment: true,
+    autoSync: 'never',
+    lockfile: 'pynect.lock',
+};
+/**
+ * Resolve one project policy for the runtime and CLI.
+ * Precedence is API or CLI overrides, environment, root package.json, then defaults.
+ */
+function resolveProjectConfig(overrides = {}) {
+    const env = { ...process.env, ...overrides.env };
+    const rootHint = overrides.projectRoot ?? env['PYNECT_PROJECT_ROOT'] ?? env['INIT_CWD'];
+    const projectRoot = path_1.default.resolve(rootHint || (0, pyfig_1.resolveProjectRoot)(process.cwd()));
+    const packageManifest = readRootPynectManifest(projectRoot);
+    const python = first(overrides.python, env['PYNECT_PYTHON'], packageManifest.python, DEFAULTS.python);
+    const requiresPython = first(overrides.requiresPython, env['PYNECT_REQUIRES_PYTHON'], packageManifest.requiresPython, DEFAULTS.requiresPython);
+    const configuredManagedPython = first(overrides.managedPython, env['PYNECT_MANAGED_PYTHON'], env['PYNECT_PYTHON_VERSION'], packageManifest.managedPython);
+    const managedPython = configuredManagedPython ?? DEFAULTS.managedPython;
+    const uvVersion = first(overrides.uvVersion, env['PYNECT_UV_VERSION'], packageManifest.uvVersion, DEFAULTS.uvVersion);
+    const autoSync = parseAutoSync(first(overrides.autoSync, env['PYNECT_AUTO_SYNC'], packageManifest.autoSync, DEFAULTS.autoSync));
+    const lockfile = first(overrides.lockfile, env['PYNECT_LOCKFILE'], packageManifest.lockfile, DEFAULTS.lockfile);
+    return {
+        projectRoot,
+        python,
+        requiresPython,
+        managedPython,
+        managedPythonExplicit: configuredManagedPython !== undefined,
+        uvVersion,
+        installPython: resolveBoolean(overrides.installPython, env['PYNECT_INSTALL_PYTHON'] ?? env['PYNECT_AUTO_INSTALL'], packageManifest.installPython, DEFAULTS.installPython, 'PYNECT_INSTALL_PYTHON'),
+        installUv: resolveBoolean(overrides.installUv, env['PYNECT_INSTALL_UV'], packageManifest.installUv, DEFAULTS.installUv, 'PYNECT_INSTALL_UV'),
+        createVirtualEnvironment: resolveBoolean(overrides.createVirtualEnvironment, env['PYNECT_CREATE_VIRTUAL_ENVIRONMENT'], packageManifest.createVirtualEnvironment, DEFAULTS.createVirtualEnvironment, 'PYNECT_CREATE_VIRTUAL_ENVIRONMENT'),
+        autoSync,
+        lockfile: resolveInsideProject(projectRoot, lockfile, 'pynect.lock'),
+        packageManifest,
+        env,
+    };
+}
+function readRootPynectManifest(projectRoot) {
+    const packagePath = path_1.default.join(projectRoot, 'package.json');
+    if (!fs_1.default.existsSync(packagePath))
+        return {};
+    let contents;
+    try {
+        contents = JSON.parse(fs_1.default.readFileSync(packagePath, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Unable to read ${packagePath}: ${error.message}`);
+    }
+    const value = contents.pynect;
+    if (value === undefined)
+        return {};
+    return validatePackageManifest(value, packagePath);
+}
+function validatePackageManifest(value, source) {
+    if (!isRecord(value))
+        throw new TypeError(`${source}: pynect must be an object.`);
+    if (value['schemaVersion'] !== undefined && value['schemaVersion'] !== 1) {
+        throw new TypeError(`${source}: pynect.schemaVersion must be 1.`);
+    }
+    optionalString(value, 'requiresPython', source);
+    optionalString(value, 'python', source);
+    optionalString(value, 'managedPython', source);
+    optionalString(value, 'uvVersion', source);
+    optionalString(value, 'lockfile', source);
+    optionalBoolean(value, 'installPython', source);
+    optionalBoolean(value, 'installUv', source);
+    optionalBoolean(value, 'createVirtualEnvironment', source);
+    if (value['autoSync'] !== undefined)
+        parseAutoSync(value['autoSync']);
+    if (value['requirements'] !== undefined) {
+        stringArray(value['requirements'], `${source}: pynect.requirements`);
+        for (const requirement of value['requirements']) {
+            if (requirement.startsWith('-') || /[\0\r\n]/u.test(requirement)) {
+                throw new TypeError(`${source}: unsafe Python requirement ${JSON.stringify(requirement)}.`);
+            }
+        }
+    }
+    if (value['modules'] !== undefined)
+        validateModules(value['modules'], source);
+    if (value['overrides'] !== undefined)
+        validateOverrides(value['overrides'], source);
+    return value;
+}
+function validateOverrides(value, source) {
+    if (!isRecord(value))
+        throw new TypeError(`${source}: pynect.overrides must be an object.`);
+    for (const [distribution, constraint] of Object.entries(value)) {
+        if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(distribution) ||
+            typeof constraint !== 'string' || !constraint.trim() || /[\0\r\n]/u.test(constraint)) {
+            throw new TypeError(`${source}: invalid Pynect override for ${JSON.stringify(distribution)}.`);
+        }
+    }
+}
+function validateModules(value, source) {
+    if (!isRecord(value))
+        throw new TypeError(`${source}: pynect.modules must be an object.`);
+    for (const [name, module] of Object.entries(value)) {
+        if (!/^[A-Za-z][A-Za-z0-9._-]*$/.test(name)) {
+            throw new TypeError(`${source}: invalid Pynect module alias ${JSON.stringify(name)}.`);
+        }
+        if (!isRecord(module) || typeof module['import'] !== 'string' ||
+            !/^[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*$/.test(module['import'])) {
+            throw new TypeError(`${source}: pynect.modules.${name}.import must be a Python module name.`);
+        }
+        if (module['include'] !== undefined) {
+            stringArray(module['include'], `${source}: pynect.modules.${name}.include`);
+        }
+    }
+}
+function resolveInsideProject(projectRoot, value, fallback) {
+    const resolved = path_1.default.resolve(projectRoot, value || fallback);
+    const relative = path_1.default.relative(projectRoot, resolved);
+    if (relative.startsWith('..') || path_1.default.isAbsolute(relative)) {
+        throw new TypeError(`Pynect lockfile must be inside the project root: ${resolved}`);
+    }
+    return resolved;
+}
+function resolveBoolean(override, environment, manifest, fallback, name) {
+    if (override !== undefined)
+        return override;
+    if (environment !== undefined)
+        return parseBoolean(environment, name);
+    return manifest ?? fallback;
+}
+function parseBoolean(value, name) {
+    if (/^(1|true|yes|on)$/i.test(value))
+        return true;
+    if (/^(0|false|no|off)$/i.test(value))
+        return false;
+    throw new TypeError(`${name} must be true or false; received ${value}.`);
+}
+function parseAutoSync(value) {
+    if (value === 'never' || value === 'if-missing')
+        return value;
+    throw new TypeError(`autoSync must be "never" or "if-missing"; received ${String(value)}.`);
+}
+function optionalString(value, key, source) {
+    if (value[key] !== undefined && typeof value[key] !== 'string') {
+        throw new TypeError(`${source}: pynect.${key} must be a string.`);
+    }
+}
+function optionalBoolean(value, key, source) {
+    if (value[key] !== undefined && typeof value[key] !== 'boolean') {
+        throw new TypeError(`${source}: pynect.${key} must be a boolean.`);
+    }
+}
+function stringArray(value, source) {
+    if (!Array.isArray(value) || value.some(item => typeof item !== 'string' || !item.trim())) {
+        throw new TypeError(`${source} must be an array of non-empty strings.`);
+    }
+}
+function first(...values) {
+    return values.find(value => value !== undefined);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=project.js.map

package/dist/config/project.js.map

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

package/dist/core/IsolatedWorker.d.ts

@@ -0,0 +1,39 @@
+export interface IsolatedCallOptions {
+    kwargs?: Record<string, unknown>;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+interface IsolatedWorkerOptions {
+    pythonExecutable: string;
+    projectRoot: string;
+    scriptPath: string;
+    cwd: string;
+    timeout: number;
+    env: Record<string, string>;
+    pythonPath: string[];
+    dispatcher: object;
+    includeTracebacks: boolean;
+}
+/** Persistent JSON-only child process used when hard termination is required. */
+export declare class IsolatedWorker {
+    private readonly options;
+    private child?;
+    private lines?;
+    private nextId;
+    private readonly pending;
+    private closing;
+    private stderrTail;
+    constructor(options: IsolatedWorkerOptions);
+    call<T = unknown>(moduleName: string, functionName: string, args?: unknown[], callOptions?: IsolatedCallOptions): Promise<T>;
+    close(): Promise<void>;
+    closeSync(): void;
+    private ensureStarted;
+    private handleLine;
+    private terminate;
+    private rejectAll;
+    private setReferenced;
+    private cleanupPending;
+    private abortError;
+}
+export {};
+//# sourceMappingURL=IsolatedWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IsolatedWorker.d.ts","sourceRoot":"","sources":["../../src/core/IsolatedWorker.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,UAAU,qBAAqB;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAUD,iFAAiF;AACjF,qBAAa,cAAc;IAQb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,KAAK,CAAC,CAAiC;IAC/C,OAAO,CAAC,KAAK,CAAC,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAM;gBAEK,OAAO,EAAE,qBAAqB;IAErD,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAO,EAAO,EACpB,WAAW,GAAE,mBAAwB,GACpC,OAAO,CAAC,CAAC,CAAC;IAoCP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,SAAS,IAAI,IAAI;YAKH,aAAa;IAiD3B,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;CAKnB"}

package/dist/core/IsolatedWorker.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsolatedWorker = void 0;
+const readline_1 = require("readline");
+const PyfigAdapter_1 = require("../env/PyfigAdapter");
+/** Persistent JSON-only child process used when hard termination is required. */
+class IsolatedWorker {
+    options;
+    child;
+    lines;
+    nextId = 0;
+    pending = new Map();
+    closing = false;
+    stderrTail = '';
+    constructor(options) {
+        this.options = options;
+    }
+    async call(moduleName, functionName, args = [], callOptions = {}) {
+        if (callOptions.signal?.aborted)
+            throw this.abortError();
+        const child = await this.ensureStarted();
+        const id = ++this.nextId;
+        const timeout = callOptions.timeout ?? this.options.timeout;
+        return new Promise((resolve, reject) => {
+            const pending = {
+                resolve: value => resolve(value),
+                reject,
+                signal: callOptions.signal,
+            };
+            if (timeout > 0) {
+                pending.timer = setTimeout(() => {
+                    this.terminate(new Error(`Isolated Python call exceeded ${timeout}ms`));
+                }, timeout);
+            }
+            if (callOptions.signal) {
+                pending.onAbort = () => this.terminate(this.abortError());
+                callOptions.signal.addEventListener('abort', pending.onAbort, { once: true });
+            }
+            this.pending.set(id, pending);
+            this.setReferenced(true);
+            const request = {
+                id,
+                module: moduleName,
+                function: functionName,
+                args,
+                kwargs: callOptions.kwargs ?? {},
+                executionTimeout: timeout,
+            };
+            child.stdin.write(`${JSON.stringify(request)}\n`, error => {
+                if (error)
+                    this.terminate(error);
+            });
+        });
+    }
+    async close() {
+        this.closing = true;
+        this.terminate(new Error('Isolated Python worker closed'));
+    }
+    closeSync() {
+        this.closing = true;
+        this.terminate(new Error('Isolated Python worker closed'));
+    }
+    async ensureStarted() {
+        if (this.child && !this.child.killed)
+            return this.child;
+        this.closing = false;
+        this.stderrTail = '';
+        const pythonPath = [
+            ...this.options.pythonPath,
+            process.env['PYTHONPATH'],
+        ].filter(Boolean).join(process.platform === 'win32' ? ';' : ':');
+        const client = (0, PyfigAdapter_1.createPynectPyfig)({
+            projectRoot: this.options.projectRoot,
+            pythonPath: this.options.pythonExecutable,
+            env: this.options.env,
+        });
+        const child = await client.python([this.options.scriptPath], {
+            cwd: this.options.cwd,
+            env: {
+                ...process.env,
+                ...this.options.env,
+                PYTHONPATH: pythonPath,
+                PYNECT_DISPATCHER_CONFIG: JSON.stringify(this.options.dispatcher),
+                PYNECT_INCLUDE_TRACEBACKS: this.options.includeTracebacks ? '1' : '0',
+            },
+            stdio: ['pipe', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        this.child = child;
+        this.lines = (0, readline_1.createInterface)({ input: child.stdout });
+        this.lines.on('line', line => this.handleLine(line));
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', chunk => {
+            this.stderrTail = `${this.stderrTail}${String(chunk)}`.slice(-4000);
+        });
+        child.on('error', error => this.terminate(error));
+        child.on('exit', (code, signal) => {
+            if (this.child !== child)
+                return;
+            this.child = undefined;
+            this.lines?.close();
+            this.lines = undefined;
+            if (!this.closing && this.pending.size) {
+                const detail = this.stderrTail.trim();
+                this.rejectAll(new Error(`Isolated Python worker exited (${signal ?? code ?? 'unknown'})${detail ? `: ${detail}` : ''}`));
+            }
+        });
+        this.setReferenced(false);
+        return child;
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            this.terminate(new Error('Isolated Python worker returned invalid JSON'));
+            return;
+        }
+        if (typeof message.id !== 'number')
+            return;
+        const pending = this.pending.get(message.id);
+        if (!pending)
+            return;
+        this.pending.delete(message.id);
+        this.cleanupPending(pending);
+        if (!this.pending.size)
+            this.setReferenced(false);
+        if (message.ok) {
+            pending.resolve(message.result);
+            return;
+        }
+        const error = new Error(message.error?.message ?? 'Isolated Python call failed');
+        error.name = message.error?.type ?? 'PythonError';
+        if (message.error?.traceback)
+            error.stack = message.error.traceback;
+        pending.reject(error);
+    }
+    terminate(error) {
+        const child = this.child;
+        this.child = undefined;
+        this.lines?.close();
+        this.lines = undefined;
+        if (child && !child.killed)
+            child.kill();
+        this.rejectAll(error);
+    }
+    rejectAll(error) {
+        for (const pending of this.pending.values()) {
+            this.cleanupPending(pending);
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+    setReferenced(referenced) {
+        if (!this.child)
+            return;
+        const method = referenced ? 'ref' : 'unref';
+        this.child[method]();
+        for (const stream of [this.child.stdin, this.child.stdout, this.child.stderr]) {
+            stream[method]?.();
+        }
+    }
+    cleanupPending(pending) {
+        if (pending.timer)
+            clearTimeout(pending.timer);
+        if (pending.signal && pending.onAbort) {
+            pending.signal.removeEventListener('abort', pending.onAbort);
+        }
+    }
+    abortError() {
+        const error = new Error('Isolated Python call was aborted');
+        error.name = 'AbortError';
+        return error;
+    }
+}
+exports.IsolatedWorker = IsolatedWorker;
+//# sourceMappingURL=IsolatedWorker.js.map

package/dist/core/IsolatedWorker.js.map

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

package/dist/core/PyCallable.d.ts

@@ -0,0 +1,67 @@
+/**
+ * pynect - PyCallable
+ * Represents a Python callable (function, method, class constructor).
+ * Extends PyProxy with call metadata and convenience methods.
+ */
+import { PyProxy } from './PyProxy';
+import type { NativeAddon } from '../types/addon';
+import type { PyCallOptions } from '../types/addon';
+import type { PyObjectId, AttributePath, PyCallableInfo } from '../types/python';
+/**
+ * PyCallable - wraps a Python function or method.
+ *
+ * @example
+ * ```typescript
+ * const np = await py.import('numpy');
+ * const zeros = await np.zeros;  // PyCallable
+ * const arr = await zeros([3, 3], { dtype: 'float64' });
+ *
+ * // Or more concisely:
+ * const arr2 = await np.zeros([3, 3]);
+ * ```
+ */
+export declare class PyCallable extends PyProxy {
+    private readonly _callableName;
+    constructor(objectId: PyObjectId, path: AttributePath, callableName: string, addon: NativeAddon, callTimeout?: number, executionTimeout?: number);
+    /** Callable name */
+    get callableName(): string;
+    /**
+     * Call the callable with given arguments.
+     * Same as using the callable directly (proxy syntax).
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.invoke([1, 2, 3], { axis: 0 });
+     * // equivalent to: await callable([1, 2, 3], { axis: 0 })
+     * ```
+     */
+    invoke(...args: unknown[]): Promise<unknown>;
+    /** Invoke with cancellation or per-call timeout overrides. */
+    invokeWithOptions(options: PyCallOptions, ...args: unknown[]): Promise<unknown>;
+    /**
+     * Call with explicit positional args and keyword args.
+     *
+     * @example
+     * ```typescript
+     * const result = await callable.call([1, 2, 3], { axis: 0, keepdims: true });
+     * ```
+     */
+    call(args: unknown[], kwargs?: Record<string, unknown>, options?: PyCallOptions): Promise<unknown>;
+    /**
+     * Partially apply arguments (like functools.partial in Python).
+     *
+     * @example
+     * ```typescript
+     * const readCsvUtf8 = await pd.read_csv.partial({ encoding: 'utf-8' });
+     * const df = await readCsvUtf8('data.csv');
+     * ```
+     */
+    partial(...partialArgs: unknown[]): PyCallable;
+    /**
+     * Get introspection information about this callable.
+     */
+    getInfo(): Promise<PyCallableInfo | null>;
+    static fromProxy(proxy: PyProxy, name: string): PyCallable;
+    toString(): string;
+}
+//# sourceMappingURL=PyCallable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PyCallable.d.ts","sourceRoot":"","sources":["../../src/core/PyCallable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAoB,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjF;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,OAAO;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAGrC,QAAQ,EAAE,UAAU,EACpB,IAAI,EAAE,aAAa,EACnB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,WAAW,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM;IAY3B,oBAAoB;IACpB,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;;;;OASG;IACG,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,8DAA8D;IACxD,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrF;;;;;;;OAOG;IACG,IAAI,CACR,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,OAAO,CAAC;IAInB;;;;;;;;OAQG;IACH,OAAO,CAAC,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,UAAU;IAwB9C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/C,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU;IAYjD,QAAQ,IAAI,MAAM;CAG5B"}