apcore-js 0.4.0 → 0.6.0

package/dist/bindings.js

@@ -0,0 +1,185 @@
+/**
+ * YAML binding loader for zero-code-modification module integration.
+ */
+import { Type } from '@sinclair/typebox';
+import yaml from 'js-yaml';
+import { FunctionModule } from './decorator.js';
+// Lazy-load Node.js built-in modules for browser compatibility
+let _nodeFs = null;
+let _nodePath = null;
+try {
+    _nodeFs = await import('node:fs');
+}
+catch { /* browser environment */ }
+try {
+    _nodePath = await import('node:path');
+}
+catch { /* browser environment */ }
+import { BindingCallableNotFoundError, BindingFileInvalidError, BindingInvalidTargetError, BindingModuleNotFoundError, BindingNotCallableError, } from './errors.js';
+import { jsonSchemaToTypeBox } from './schema/loader.js';
+export class BindingLoader {
+    async loadBindings(filePath, registry) {
+        const { readFileSync } = _nodeFs;
+        const { dirname } = _nodePath;
+        const bindingFileDir = dirname(filePath);
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch (e) {
+            throw new BindingFileInvalidError(filePath, String(e));
+        }
+        let data;
+        try {
+            data = yaml.load(content);
+        }
+        catch (e) {
+            throw new BindingFileInvalidError(filePath, `YAML parse error: ${e}`);
+        }
+        if (data === null || data === undefined) {
+            throw new BindingFileInvalidError(filePath, 'File is empty');
+        }
+        const dataObj = data;
+        if (!('bindings' in dataObj)) {
+            throw new BindingFileInvalidError(filePath, "Missing 'bindings' key");
+        }
+        const bindings = dataObj['bindings'];
+        if (!Array.isArray(bindings)) {
+            throw new BindingFileInvalidError(filePath, "'bindings' must be a list");
+        }
+        const results = [];
+        for (const entry of bindings) {
+            const entryObj = entry;
+            if (!('module_id' in entryObj)) {
+                throw new BindingFileInvalidError(filePath, "Binding entry missing 'module_id'");
+            }
+            if (!('target' in entryObj)) {
+                throw new BindingFileInvalidError(filePath, "Binding entry missing 'target'");
+            }
+            const fm = await this._createModuleFromBinding(entryObj, bindingFileDir);
+            registry.register(entryObj['module_id'], fm);
+            results.push(fm);
+        }
+        return results;
+    }
+    async loadBindingDir(dirPath, registry, pattern = '*.binding.yaml') {
+        const { existsSync, statSync, readdirSync } = _nodeFs;
+        const { join } = _nodePath;
+        if (!existsSync(dirPath) || !statSync(dirPath).isDirectory()) {
+            throw new BindingFileInvalidError(dirPath, 'Directory does not exist');
+        }
+        const files = readdirSync(dirPath)
+            .filter((f) => {
+            // Simple glob matching for *.binding.yaml
+            const suffix = pattern.replace('*', '');
+            return f.endsWith(suffix);
+        })
+            .sort();
+        const results = [];
+        for (const f of files) {
+            const fms = await this.loadBindings(join(dirPath, f), registry);
+            results.push(...fms);
+        }
+        return results;
+    }
+    async resolveTarget(targetString) {
+        if (!targetString.includes(':')) {
+            throw new BindingInvalidTargetError(targetString);
+        }
+        const [modulePath, callableName] = targetString.split(':', 2);
+        if (modulePath.includes('..')) {
+            throw new BindingInvalidTargetError(`Module path '${modulePath}' must not contain '..' segments`);
+        }
+        if (modulePath.startsWith('file:')) {
+            throw new BindingInvalidTargetError(`Module path '${modulePath}' must not use file: URLs`);
+        }
+        let mod;
+        try {
+            mod = await import(modulePath);
+        }
+        catch (e) {
+            throw new BindingModuleNotFoundError(modulePath);
+        }
+        if (callableName.includes('.')) {
+            const [className, methodName] = callableName.split('.', 2);
+            const cls = mod[className];
+            if (cls == null) {
+                throw new BindingCallableNotFoundError(className, modulePath);
+            }
+            let instance;
+            try {
+                instance = new cls();
+            }
+            catch {
+                throw new BindingCallableNotFoundError(callableName, modulePath);
+            }
+            const method = instance[methodName];
+            if (method == null) {
+                throw new BindingCallableNotFoundError(callableName, modulePath);
+            }
+            if (typeof method !== 'function') {
+                throw new BindingNotCallableError(targetString);
+            }
+            return method.bind(instance);
+        }
+        const result = mod[callableName];
+        if (result == null) {
+            throw new BindingCallableNotFoundError(callableName, modulePath);
+        }
+        if (typeof result !== 'function') {
+            throw new BindingNotCallableError(targetString);
+        }
+        return result;
+    }
+    async _createModuleFromBinding(binding, bindingFileDir) {
+        const { existsSync, readFileSync } = _nodeFs;
+        const { resolve } = _nodePath;
+        const func = await this.resolveTarget(binding['target']);
+        const moduleId = binding['module_id'];
+        let inputSchema;
+        let outputSchema;
+        if ('input_schema' in binding || 'output_schema' in binding) {
+            const inputSchemaDict = binding['input_schema'] ?? {};
+            const outputSchemaDict = binding['output_schema'] ?? {};
+            inputSchema = jsonSchemaToTypeBox(inputSchemaDict);
+            outputSchema = jsonSchemaToTypeBox(outputSchemaDict);
+        }
+        else if ('schema_ref' in binding) {
+            const refPath = resolve(bindingFileDir, binding['schema_ref']);
+            if (!existsSync(refPath)) {
+                throw new BindingFileInvalidError(refPath, 'Schema reference file not found');
+            }
+            let refData;
+            try {
+                refData = yaml.load(readFileSync(refPath, 'utf-8')) ?? {};
+            }
+            catch (e) {
+                throw new BindingFileInvalidError(refPath, `YAML parse error: ${e}`);
+            }
+            inputSchema = jsonSchemaToTypeBox(refData['input_schema'] ?? {});
+            outputSchema = jsonSchemaToTypeBox(refData['output_schema'] ?? {});
+        }
+        else {
+            // No schema, use permissive
+            inputSchema = Type.Record(Type.String(), Type.Unknown());
+            outputSchema = Type.Record(Type.String(), Type.Unknown());
+        }
+        return new FunctionModule({
+            execute: async (inputs, context) => {
+                const result = await func(inputs, context);
+                if (result === null || result === undefined)
+                    return {};
+                if (typeof result === 'object' && !Array.isArray(result))
+                    return result;
+                return { result };
+            },
+            moduleId,
+            inputSchema,
+            outputSchema,
+            description: binding['description'] ?? undefined,
+            tags: binding['tags'] ?? null,
+            version: binding['version'] ?? '1.0.0',
+        });
+    }
+}
+//# sourceMappingURL=bindings.js.map

package/dist/bindings.js.map

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

package/dist/cancel.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cooperative cancellation support for apcore module execution.
+ */
+export declare class ExecutionCancelledError extends Error {
+    constructor(message?: string);
+}
+export declare class CancelToken {
+    private _cancelled;
+    get isCancelled(): boolean;
+    cancel(): void;
+    check(): void;
+    reset(): void;
+}
+//# sourceMappingURL=cancel.d.ts.map

package/dist/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../src/cancel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,GAAE,MAAkC;CAIxD;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAkB;IAEpC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAMb,KAAK,IAAI,IAAI;CAGd"}

package/dist/cancel.js

@@ -0,0 +1,27 @@
+/**
+ * Cooperative cancellation support for apcore module execution.
+ */
+export class ExecutionCancelledError extends Error {
+    constructor(message = "Execution was cancelled") {
+        super(message);
+        this.name = "ExecutionCancelledError";
+    }
+}
+export class CancelToken {
+    _cancelled = false;
+    get isCancelled() {
+        return this._cancelled;
+    }
+    cancel() {
+        this._cancelled = true;
+    }
+    check() {
+        if (this._cancelled) {
+            throw new ExecutionCancelledError();
+        }
+    }
+    reset() {
+        this._cancelled = false;
+    }
+}
+//# sourceMappingURL=cancel.js.map

package/dist/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../src/cancel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,UAAkB,yBAAyB;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,WAAW;IACd,UAAU,GAAY,KAAK,CAAC;IAEpC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,uBAAuB,EAAE,CAAC;QACtC,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Configuration accessor with dot-path key support.
+ */
+export declare class Config {
+    private _data;
+    constructor(data?: Record<string, unknown>);
+    get(key: string, defaultValue?: unknown): unknown;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAA0B;gBAE3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;CAYlD"}

package/dist/config.js

@@ -0,0 +1,23 @@
+/**
+ * Configuration accessor with dot-path key support.
+ */
+export class Config {
+    _data;
+    constructor(data) {
+        this._data = data ?? {};
+    }
+    get(key, defaultValue) {
+        const parts = key.split('.');
+        let current = this._data;
+        for (const part of parts) {
+            if (current !== null && typeof current === 'object' && part in current) {
+                current = current[part];
+            }
+            else {
+                return defaultValue;
+            }
+        }
+        return current;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,MAAM;IACT,KAAK,CAA0B;IAEvC,YAAY,IAA8B;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,YAAsB;QACrC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,IAAI,IAAK,OAAmC,EAAE,CAAC;gBACpG,OAAO,GAAI,OAAmC,CAAC,IAAI,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,OAAO,YAAY,CAAC;YACtB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/context.d.ts

@@ -0,0 +1,50 @@
+import type { CancelToken } from './cancel.js';
+import type { TraceParent } from './trace-context.js';
+/**
+ * Execution context, identity, and context creation.
+ */
+export interface Identity {
+    readonly id: string;
+    readonly type: string;
+    readonly roles: readonly string[];
+    readonly attrs: Readonly<Record<string, unknown>>;
+}
+export declare function createIdentity(id: string, type?: string, roles?: string[], attrs?: Record<string, unknown>): Identity;
+export declare class Context {
+    readonly traceId: string;
+    readonly callerId: string | null;
+    readonly callChain: readonly string[];
+    readonly executor: unknown;
+    readonly identity: Identity | null;
+    redactedInputs: Record<string, unknown> | null;
+    readonly data: Record<string, unknown>;
+    readonly cancelToken: CancelToken | null;
+    constructor(traceId: string, callerId?: string | null, callChain?: string[], executor?: unknown, identity?: Identity | null, redactedInputs?: Record<string, unknown> | null, data?: Record<string, unknown>, cancelToken?: CancelToken | null);
+    /**
+     * Create a new top-level Context with a generated UUID v4 traceId.
+     *
+     * When `traceParent` is provided, its `traceId` (32 hex chars) is
+     * converted to UUID format (8-4-4-4-12) and used instead of generating
+     * a new one.
+     */
+    static create(executor?: unknown, identity?: Identity | null, data?: Record<string, unknown>, traceParent?: TraceParent | null): Context;
+    toJSON(): Record<string, unknown>;
+    static fromJSON(data: Record<string, unknown>, executor?: unknown): Context;
+    get logger(): {
+        debug: (...args: unknown[]) => void;
+        info: (...args: unknown[]) => void;
+        warn: (...args: unknown[]) => void;
+        error: (...args: unknown[]) => void;
+    };
+    child(targetModuleId: string): Context;
+}
+/**
+ * Interface for creating Context from framework-specific requests.
+ *
+ * Web framework integrations should implement this to extract Identity
+ * from HTTP requests (e.g., Express request, JWT tokens, API keys).
+ */
+export interface ContextFactory {
+    createContext(request: unknown): Context;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAe,EACrB,KAAK,GAAE,MAAM,EAAO,EACpB,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,QAAQ,CAEV;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAM,GAAG,IAAW,EAC9B,SAAS,GAAE,MAAM,EAAO,EACxB,QAAQ,GAAE,OAAc,EACxB,QAAQ,GAAE,QAAQ,GAAG,IAAW,EAChC,cAAc,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAW,EACrD,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,WAAW,GAAE,WAAW,GAAG,IAAW;IAYxC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CACX,QAAQ,GAAE,OAAc,EACxB,QAAQ,GAAE,QAAQ,GAAG,IAAW,EAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC/B,OAAO;IAmBV,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAsBjC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO;IAmB3E,IAAI,MAAM,IAAI;QAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAQjK;IAED,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;CAYvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CAC1C"}

package/dist/context.js

@@ -0,0 +1,87 @@
+import { v4 as uuidv4 } from 'uuid';
+export function createIdentity(id, type = 'user', roles = [], attrs = {}) {
+    return Object.freeze({ id, type, roles: Object.freeze([...roles]), attrs: Object.freeze({ ...attrs }) });
+}
+export class Context {
+    traceId;
+    callerId;
+    callChain;
+    executor;
+    identity;
+    redactedInputs;
+    data;
+    cancelToken;
+    constructor(traceId, callerId = null, callChain = [], executor = null, identity = null, redactedInputs = null, data = {}, cancelToken = null) {
+        this.traceId = traceId;
+        this.callerId = callerId;
+        this.callChain = Object.freeze([...callChain]);
+        this.executor = executor;
+        this.identity = identity;
+        this.redactedInputs = redactedInputs;
+        this.data = data;
+        this.cancelToken = cancelToken;
+    }
+    /**
+     * Create a new top-level Context with a generated UUID v4 traceId.
+     *
+     * When `traceParent` is provided, its `traceId` (32 hex chars) is
+     * converted to UUID format (8-4-4-4-12) and used instead of generating
+     * a new one.
+     */
+    static create(executor = null, identity = null, data, traceParent) {
+        let traceId;
+        if (traceParent) {
+            const h = traceParent.traceId;
+            traceId = `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20)}`;
+        }
+        else {
+            traceId = uuidv4();
+        }
+        return new Context(traceId, null, [], executor, identity, null, data ?? {});
+    }
+    toJSON() {
+        const publicData = {};
+        for (const [key, value] of Object.entries(this.data)) {
+            if (!key.startsWith('_')) {
+                publicData[key] = value;
+            }
+        }
+        return {
+            traceId: this.traceId,
+            callerId: this.callerId,
+            callChain: [...this.callChain],
+            identity: this.identity ? {
+                id: this.identity.id,
+                type: this.identity.type,
+                roles: [...this.identity.roles],
+                attrs: { ...this.identity.attrs },
+            } : null,
+            redactedInputs: this.redactedInputs ? { ...this.redactedInputs } : null,
+            data: publicData,
+        };
+    }
+    static fromJSON(data, executor) {
+        const identityData = data.identity;
+        const identity = identityData ? {
+            id: identityData.id,
+            type: identityData.type ?? 'user',
+            roles: Object.freeze([...(Array.isArray(identityData.roles) ? identityData.roles : [])]),
+            attrs: Object.freeze((identityData.attrs && typeof identityData.attrs === 'object' ? identityData.attrs : {})),
+        } : null;
+        return new Context(data.traceId, data.callerId ?? null, data.callChain ?? [], executor ?? null, identity, data.redactedInputs ?? null, data.data ? { ...data.data } : {});
+    }
+    get logger() {
+        const prefix = `[apcore:${this.callerId ?? 'unknown'}]`;
+        return {
+            debug: (...args) => console.debug(prefix, ...args),
+            info: (...args) => console.info(prefix, ...args),
+            warn: (...args) => console.warn(prefix, ...args),
+            error: (...args) => console.error(prefix, ...args),
+        };
+    }
+    child(targetModuleId) {
+        return new Context(this.traceId, this.callChain.length > 0 ? this.callChain[this.callChain.length - 1] : null, [...this.callChain, targetModuleId], this.executor, this.identity, null, this.data, // shared reference
+        this.cancelToken);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/decorator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Module factory, FunctionModule wrapper.
+ *
+ * TypeScript version uses explicit TypeBox schemas instead of runtime type inference.
+ */
+import type { TSchema } from '@sinclair/typebox';
+import type { Context } from './context.js';
+import type { ModuleAnnotations, ModuleExample } from './module.js';
+export declare function normalizeResult(result: unknown): Record<string, unknown>;
+export declare class FunctionModule {
+    readonly moduleId: string;
+    readonly inputSchema: TSchema;
+    readonly outputSchema: TSchema;
+    readonly description: string;
+    readonly documentation: string | null;
+    readonly tags: string[] | null;
+    readonly version: string;
+    readonly annotations: ModuleAnnotations | null;
+    readonly metadata: Record<string, unknown> | null;
+    readonly examples: ModuleExample[] | null;
+    private _executeFn;
+    constructor(options: {
+        execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
+        moduleId: string;
+        inputSchema: TSchema;
+        outputSchema: TSchema;
+        description?: string;
+        documentation?: string | null;
+        tags?: string[] | null;
+        version?: string;
+        annotations?: ModuleAnnotations | null;
+        metadata?: Record<string, unknown> | null;
+        examples?: ModuleExample[] | null;
+    });
+    execute(inputs: Record<string, unknown>, context: Context): Promise<Record<string, unknown>>;
+}
+export declare function makeAutoId(name: string): string;
+/**
+ * Create a FunctionModule from options. TypeScript version requires explicit schemas.
+ */
+export declare function module(options: {
+    id?: string;
+    inputSchema: TSchema;
+    outputSchema: TSchema;
+    description?: string;
+    documentation?: string | null;
+    annotations?: ModuleAnnotations | null;
+    tags?: string[] | null;
+    version?: string;
+    metadata?: Record<string, unknown> | null;
+    examples?: ModuleExample[] | null;
+    execute: (inputs: Record<string, unknown>, context: Context) => Promise<Record<string, unknown>> | Record<string, unknown>;
+    registry?: {
+        register(moduleId: string, module: unknown): void;
+    } | null;
+}): FunctionModule;
+//# sourceMappingURL=decorator.d.ts.map

package/dist/decorator.d.ts.map

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

package/dist/decorator.js

@@ -0,0 +1,74 @@
+/**
+ * Module factory, FunctionModule wrapper.
+ *
+ * TypeScript version uses explicit TypeBox schemas instead of runtime type inference.
+ */
+export function normalizeResult(result) {
+    if (result === null || result === undefined)
+        return {};
+    if (typeof result === 'object' && !Array.isArray(result))
+        return result;
+    return { result };
+}
+export class FunctionModule {
+    moduleId;
+    inputSchema;
+    outputSchema;
+    description;
+    documentation;
+    tags;
+    version;
+    annotations;
+    metadata;
+    examples;
+    _executeFn;
+    constructor(options) {
+        this.moduleId = options.moduleId;
+        this.inputSchema = options.inputSchema;
+        this.outputSchema = options.outputSchema;
+        this.description = options.description ?? `Module ${options.moduleId}`;
+        this.documentation = options.documentation ?? null;
+        this.tags = options.tags ?? null;
+        this.version = options.version ?? '1.0.0';
+        this.annotations = options.annotations ?? null;
+        this.metadata = options.metadata ?? null;
+        this.examples = options.examples ?? null;
+        this._executeFn = options.execute;
+    }
+    async execute(inputs, context) {
+        const result = await this._executeFn(inputs, context);
+        return normalizeResult(result);
+    }
+}
+export function makeAutoId(name) {
+    let raw = name.toLowerCase();
+    raw = raw.replace(/[^a-z0-9_.]/g, '_');
+    const segments = raw.split('.');
+    return segments
+        .map((s) => (s && s[0] >= '0' && s[0] <= '9' ? '_' + s : s))
+        .join('.');
+}
+/**
+ * Create a FunctionModule from options. TypeScript version requires explicit schemas.
+ */
+export function module(options) {
+    const moduleId = options.id ?? makeAutoId('anonymous');
+    const fm = new FunctionModule({
+        execute: options.execute,
+        moduleId,
+        inputSchema: options.inputSchema,
+        outputSchema: options.outputSchema,
+        description: options.description,
+        documentation: options.documentation,
+        tags: options.tags,
+        version: options.version,
+        annotations: options.annotations,
+        metadata: options.metadata,
+        examples: options.examples,
+    });
+    if (options.registry) {
+        options.registry.register(fm.moduleId, fm);
+    }
+    return fm;
+}
+//# sourceMappingURL=decorator.js.map

package/dist/decorator.js.map

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