apcore-toolkit 0.1.0

package/dist/output/registry-writer.js

@@ -0,0 +1,42 @@
+import { FunctionModule, jsonSchemaToTypeBox } from 'apcore-js';
+import { annotationsToDict } from '../serializers.js';
+import { resolveTarget } from '../resolve-target.js';
+export class RegistryWriter {
+    async write(modules, registry, options) {
+        const registered = [];
+        for (const mod of modules) {
+            if (options?.dryRun) {
+                registered.push(mod.moduleId);
+                continue;
+            }
+            const fm = await this._toFunctionModule(mod);
+            registry.register(mod.moduleId, fm);
+            registered.push(mod.moduleId);
+        }
+        return registered;
+    }
+    async _toFunctionModule(mod) {
+        const targetFn = (await resolveTarget(mod.target));
+        return new FunctionModule({
+            execute: async (inputs, _context) => {
+                const result = await targetFn(inputs);
+                if (result == null)
+                    return {};
+                if (typeof result !== 'object' || Array.isArray(result))
+                    return { result };
+                return result;
+            },
+            moduleId: mod.moduleId,
+            inputSchema: jsonSchemaToTypeBox(mod.inputSchema),
+            outputSchema: jsonSchemaToTypeBox(mod.outputSchema),
+            description: mod.description,
+            documentation: mod.documentation,
+            tags: mod.tags.length > 0 ? [...mod.tags] : null,
+            version: mod.version,
+            annotations: annotationsToDict(mod.annotations),
+            metadata: Object.keys(mod.metadata).length > 0 ? { ...mod.metadata } : null,
+            examples: mod.examples.length > 0 ? [...mod.examples] : null,
+        });
+    }
+}
+//# sourceMappingURL=registry-writer.js.map

package/dist/output/registry-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-writer.js","sourceRoot":"","sources":["../../src/output/registry-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,KAAK,CACT,OAAwB,EACxB,QAA+D,EAC/D,OAA8B;QAE9B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;gBACpB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;YAC7C,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YACpC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,GAAkB;QAChD,MAAM,QAAQ,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAErC,CAAC;QAEb,OAAO,IAAI,cAAc,CAAC;YACxB,OAAO,EAAE,KAAK,EAAE,MAA+B,EAAE,QAAiB,EAAE,EAAE;gBACpE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACtC,IAAI,MAAM,IAAI,IAAI;oBAAE,OAAO,EAAE,CAAC;gBAC9B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;oBAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC3E,OAAO,MAAiC,CAAC;YAC3C,CAAC;YACD,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,WAAW,EAAE,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC;YACjD,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;YACnD,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;YAChD,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAA6B;YAC3E,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;YAC3E,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAqB,CAAC,CAAC,CAAC,IAAI;SAClF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/output/typescript-writer.d.ts

@@ -0,0 +1,10 @@
+import type { ScannedModule } from '../types.js';
+export declare class TypeScriptWriter {
+    write(modules: ScannedModule[], outputDir: string, options?: {
+        dryRun?: boolean;
+    }): string[];
+    private _generateCode;
+    private _parseTarget;
+    private _sanitizeIdentifier;
+}
+//# sourceMappingURL=typescript-writer.d.ts.map

package/dist/output/typescript-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-writer.d.ts","sourceRoot":"","sources":["../../src/output/typescript-writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,gBAAgB;IAC3B,KAAK,CACH,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,MAAM,EAAE;IAgCX,OAAO,CAAC,aAAa;IAgCrB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,mBAAmB;CAO5B"}

package/dist/output/typescript-writer.js

@@ -0,0 +1,78 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+export class TypeScriptWriter {
+    write(modules, outputDir, options) {
+        const dryRun = options?.dryRun ?? false;
+        const results = [];
+        const timestamp = new Date().toISOString();
+        const resolvedOut = dryRun ? '' : resolve(outputDir);
+        if (!dryRun) {
+            mkdirSync(resolvedOut, { recursive: true });
+        }
+        for (const mod of modules) {
+            const code = this._generateCode(mod, timestamp);
+            results.push(code);
+            if (!dryRun) {
+                // Path traversal protection: check raw moduleId before sanitization
+                const rawResolved = resolve(join(resolvedOut, mod.moduleId));
+                if (!rawResolved.startsWith(resolvedOut + '/') && rawResolved !== resolvedOut) {
+                    console.warn('Skipping module with path traversal in id: %s', mod.moduleId);
+                    continue;
+                }
+                const sanitized = this._sanitizeIdentifier(mod.moduleId);
+                const filename = `${sanitized}.ts`;
+                writeFileSync(resolve(join(resolvedOut, filename)), code, 'utf-8');
+            }
+        }
+        return results;
+    }
+    _generateCode(mod, timestamp) {
+        const { modulePath, exportName } = this._parseTarget(mod.target);
+        const lines = [];
+        lines.push(`// Auto-generated apcore module: ${JSON.stringify(mod.moduleId)}`);
+        lines.push(`// Generated: ${timestamp}`);
+        lines.push('// Do not edit manually unless you intend to customize behavior.');
+        lines.push('');
+        lines.push("import { module } from 'apcore-js';");
+        lines.push('');
+        lines.push('export default module({');
+        lines.push(`  id: ${JSON.stringify(mod.moduleId)},`);
+        lines.push(`  description: ${JSON.stringify(mod.description)},`);
+        lines.push(`  inputSchema: ${JSON.stringify(mod.inputSchema)},`);
+        lines.push(`  outputSchema: ${JSON.stringify(mod.outputSchema)},`);
+        lines.push(`  tags: ${JSON.stringify([...mod.tags])},`);
+        lines.push(`  version: ${JSON.stringify(mod.version)},`);
+        if (mod.annotations !== null) {
+            lines.push(`  annotations: ${JSON.stringify(mod.annotations)},`);
+        }
+        lines.push('  async execute(inputs) {');
+        lines.push(`    const { ${exportName}: _original } = await import(${JSON.stringify(modulePath)});`);
+        lines.push('    return _original(inputs);');
+        lines.push('  },');
+        lines.push('});');
+        lines.push('');
+        return lines.join('\n');
+    }
+    _parseTarget(target) {
+        const lastColon = target.lastIndexOf(':');
+        if (lastColon === -1) {
+            throw new Error(`Invalid target format: ${target}`);
+        }
+        const exportName = target.slice(lastColon + 1);
+        if (!/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(exportName)) {
+            throw new Error(`Invalid export name: ${exportName}`);
+        }
+        return {
+            modulePath: target.slice(0, lastColon),
+            exportName,
+        };
+    }
+    _sanitizeIdentifier(name) {
+        let sanitized = name.replace(/[^a-zA-Z0-9_]/g, '_');
+        if (/^[0-9]/.test(sanitized)) {
+            sanitized = `_${sanitized}`;
+        }
+        return sanitized;
+    }
+}
+//# sourceMappingURL=typescript-writer.js.map

package/dist/output/typescript-writer.js.map

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

package/dist/output/yaml-writer.d.ts

@@ -0,0 +1,8 @@
+import type { ScannedModule } from '../types.js';
+export declare class YAMLWriter {
+    write(modules: ScannedModule[], outputDir: string, options?: {
+        dryRun?: boolean;
+    }): Record<string, unknown>[];
+    private _buildBinding;
+}
+//# sourceMappingURL=yaml-writer.d.ts.map

package/dist/output/yaml-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-writer.d.ts","sourceRoot":"","sources":["../../src/output/yaml-writer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD,qBAAa,UAAU;IACrB,KAAK,CACH,OAAO,EAAE,aAAa,EAAE,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE;IAqD5B,OAAO,CAAC,aAAa;CAqBtB"}

package/dist/output/yaml-writer.js

@@ -0,0 +1,67 @@
+import yaml from 'js-yaml';
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { resolve, join } from 'node:path';
+import { annotationsToDict } from '../serializers.js';
+export class YAMLWriter {
+    write(modules, outputDir, options) {
+        const dryRun = options?.dryRun ?? false;
+        if (modules.length === 0) {
+            return [];
+        }
+        const outputPath = resolve(outputDir);
+        if (!dryRun) {
+            mkdirSync(outputPath, { recursive: true });
+        }
+        const results = [];
+        const timestamp = new Date().toISOString();
+        for (const module of modules) {
+            const bindingData = this._buildBinding(module);
+            results.push(bindingData);
+            if (!dryRun) {
+                let safeId = module.moduleId.replace(/[^a-zA-Z0-9._-]/g, '_');
+                safeId = safeId.replace(/\.{2,}/g, '_');
+                const filename = `${safeId}.binding.yaml`;
+                const filePath = resolve(join(outputPath, filename));
+                // Path traversal protection
+                if (!filePath.startsWith(outputPath)) {
+                    console.warn('Skipping file outside output directory: %s', filePath);
+                    continue;
+                }
+                if (existsSync(filePath)) {
+                    console.warn('Overwriting existing file: %s', filePath);
+                }
+                const header = `# Auto-generated by apcore-toolkit scanner\n` +
+                    `# Generated: ${timestamp}\n` +
+                    `# Do not edit manually unless you intend to customize schemas.\n\n`;
+                const yamlContent = yaml.dump(bindingData, {
+                    flowLevel: -1,
+                    sortKeys: false,
+                });
+                writeFileSync(filePath, header + yamlContent, 'utf-8');
+            }
+        }
+        return results;
+    }
+    _buildBinding(module) {
+        return {
+            bindings: [
+                {
+                    module_id: module.moduleId,
+                    target: module.target,
+                    description: module.description,
+                    documentation: module.documentation,
+                    tags: [...module.tags],
+                    version: module.version,
+                    annotations: annotationsToDict(module.annotations),
+                    examples: module.examples.length > 0
+                        ? module.examples.map((e) => ({ ...e }))
+                        : [],
+                    metadata: { ...module.metadata },
+                    input_schema: { ...module.inputSchema },
+                    output_schema: { ...module.outputSchema },
+                },
+            ],
+        };
+    }
+}
+//# sourceMappingURL=yaml-writer.js.map

package/dist/output/yaml-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-writer.js","sourceRoot":"","sources":["../../src/output/yaml-writer.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,OAAO,UAAU;IACrB,KAAK,CACH,OAAwB,EACxB,SAAiB,EACjB,OAA8B;QAE9B,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,KAAK,CAAC;QAExC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAA8B,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAE1B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,IAAI,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;gBAC9D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBACxC,MAAM,QAAQ,GAAG,GAAG,MAAM,eAAe,CAAC;gBAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAErD,4BAA4B;gBAC5B,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,OAAO,CAAC,IAAI,CAAC,4CAA4C,EAAE,QAAQ,CAAC,CAAC;oBACrE,SAAS;gBACX,CAAC;gBAED,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,OAAO,CAAC,IAAI,CAAC,+BAA+B,EAAE,QAAQ,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,MAAM,GACV,8CAA8C;oBAC9C,gBAAgB,SAAS,IAAI;oBAC7B,oEAAoE,CAAC;gBAEvE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;oBACzC,SAAS,EAAE,CAAC,CAAC;oBACb,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAC;gBAEH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CAAC,MAAqB;QACzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,SAAS,EAAE,MAAM,CAAC,QAAQ;oBAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;oBACnC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;oBACtB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,WAAW,EAAE,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC;oBAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;wBAClC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;wBACxC,CAAC,CAAC,EAAE;oBACN,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;oBAChC,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;oBACvC,aAAa,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/resolve-target.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dynamically imports a module and resolves a named export.
+ *
+ * Target format: `"module/path:exportName"`.
+ * The LAST `:` is used as the separator so that Node.js built-in prefixes
+ * like `node:path` are supported (e.g. `"node:path:join"`).
+ */
+export declare function resolveTarget(target: string): Promise<unknown>;
+//# sourceMappingURL=resolve-target.d.ts.map

package/dist/resolve-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target.d.ts","sourceRoot":"","sources":["../src/resolve-target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BpE"}

package/dist/resolve-target.js

@@ -0,0 +1,28 @@
+/**
+ * Dynamically imports a module and resolves a named export.
+ *
+ * Target format: `"module/path:exportName"`.
+ * The LAST `:` is used as the separator so that Node.js built-in prefixes
+ * like `node:path` are supported (e.g. `"node:path:join"`).
+ */
+export async function resolveTarget(target) {
+    const lastColon = target.lastIndexOf(":");
+    if (lastColon === -1) {
+        throw new Error(`Invalid target format: "${target}". Expected "module/path:exportName".`);
+    }
+    const modulePath = target.slice(0, lastColon);
+    const exportName = target.slice(lastColon + 1);
+    let mod;
+    try {
+        mod = (await import(modulePath));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to import module "${modulePath}": ${message}`);
+    }
+    if (mod[exportName] === undefined) {
+        throw new Error(`Export "${exportName}" not found in module "${modulePath}".`);
+    }
+    return mod[exportName];
+}
+//# sourceMappingURL=resolve-target.js.map

package/dist/resolve-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-target.js","sourceRoot":"","sources":["../src/resolve-target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAc;IAChD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,2BAA2B,MAAM,uCAAuC,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAE/C,IAAI,GAA4B,CAAC;IACjC,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAA4B,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,MAAM,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,WAAW,UAAU,0BAA0B,UAAU,IAAI,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC,UAAU,CAAC,CAAC;AACzB,CAAC"}

package/dist/scanner.d.ts

@@ -0,0 +1,13 @@
+import type { ModuleAnnotations } from 'apcore-js';
+import type { ScannedModule } from './types.js';
+export declare abstract class BaseScanner {
+    abstract scan(...args: unknown[]): ScannedModule[] | Promise<ScannedModule[]>;
+    abstract getSourceName(): string;
+    filterModules(modules: ScannedModule[], options?: {
+        include?: string;
+        exclude?: string;
+    }): ScannedModule[];
+    static inferAnnotationsFromMethod(method: string): ModuleAnnotations;
+    deduplicateIds(modules: ScannedModule[]): ScannedModule[];
+}
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,8BAAsB,WAAW;IAC/B,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAC7E,QAAQ,CAAC,aAAa,IAAI,MAAM;IAEhC,aAAa,CACX,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/C,aAAa,EAAE;IAgBlB,MAAM,CAAC,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IAgBpE,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE;CA2B1D"}

package/dist/scanner.js

@@ -0,0 +1,53 @@
+import { DEFAULT_ANNOTATIONS } from 'apcore-js';
+import { cloneModule } from './types.js';
+export class BaseScanner {
+    filterModules(modules, options) {
+        let result = modules;
+        if (options?.include != null) {
+            const include = options.include;
+            result = result.filter((m) => new RegExp(include).test(m.moduleId));
+        }
+        if (options?.exclude != null) {
+            const exclude = options.exclude;
+            result = result.filter((m) => !new RegExp(exclude).test(m.moduleId));
+        }
+        return result;
+    }
+    static inferAnnotationsFromMethod(method) {
+        const upper = method.toUpperCase();
+        if (upper === 'GET') {
+            return { ...DEFAULT_ANNOTATIONS, readonly: true };
+        }
+        if (upper === 'DELETE') {
+            return { ...DEFAULT_ANNOTATIONS, destructive: true };
+        }
+        if (upper === 'PUT') {
+            return { ...DEFAULT_ANNOTATIONS, idempotent: true };
+        }
+        return { ...DEFAULT_ANNOTATIONS };
+    }
+    deduplicateIds(modules) {
+        const seen = new Map();
+        const result = [];
+        for (const module of modules) {
+            const mid = module.moduleId;
+            const count = seen.get(mid) ?? 0;
+            seen.set(mid, count + 1);
+            if (count > 0) {
+                const newId = `${mid}_${count + 1}`;
+                result.push(cloneModule(module, {
+                    moduleId: newId,
+                    warnings: [
+                        ...module.warnings,
+                        `Module ID renamed from '${mid}' to '${newId}' to avoid collision`,
+                    ],
+                }));
+            }
+            else {
+                result.push(module);
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,OAAgB,WAAW;IAI/B,aAAa,CACX,OAAwB,EACxB,OAAgD;QAEhD,IAAI,MAAM,GAAG,OAAO,CAAC;QAErB,IAAI,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAChC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,0BAA0B,CAAC,MAAc;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAEnC,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,EAAE,GAAG,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACpD,CAAC;QACD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,OAAO,EAAE,GAAG,mBAAmB,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACvD,CAAC;QACD,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;YACpB,OAAO,EAAE,GAAG,mBAAmB,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACtD,CAAC;QAED,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACpC,CAAC;IAED,cAAc,CAAC,OAAwB;QACrC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,MAAM,MAAM,GAAoB,EAAE,CAAC;QAEnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAEzB,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,MAAM,EAAE;oBAClB,QAAQ,EAAE,KAAK;oBACf,QAAQ,EAAE;wBACR,GAAG,MAAM,CAAC,QAAQ;wBAClB,2BAA2B,GAAG,SAAS,KAAK,sBAAsB;qBACnE;iBACF,CAAC,CACH,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/schema-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Enrich a JSON Schema's property descriptions from an external map.
+ *
+ * Returns the original schema reference when no enrichment is needed;
+ * otherwise returns a deep copy with descriptions merged in.
+ */
+export declare function enrichSchemaDescriptions(schema: Record<string, unknown>, paramDescriptions: Record<string, string>, options?: {
+    overwrite?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=schema-utils.d.ts.map

package/dist/schema-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.d.ts","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6BzB"}

package/dist/schema-utils.js

@@ -0,0 +1,28 @@
+/**
+ * Enrich a JSON Schema's property descriptions from an external map.
+ *
+ * Returns the original schema reference when no enrichment is needed;
+ * otherwise returns a deep copy with descriptions merged in.
+ */
+export function enrichSchemaDescriptions(schema, paramDescriptions, options) {
+    if (Object.keys(paramDescriptions).length === 0) {
+        return schema;
+    }
+    const properties = schema.properties;
+    if (!properties) {
+        return schema;
+    }
+    const overwrite = options?.overwrite ?? false;
+    const result = structuredClone(schema);
+    const resultProps = result.properties;
+    for (const [name, desc] of Object.entries(paramDescriptions)) {
+        if (name in resultProps) {
+            const prop = resultProps[name];
+            if (overwrite || !("description" in prop)) {
+                prop.description = desc;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=schema-utils.js.map

package/dist/schema-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-utils.js","sourceRoot":"","sources":["../src/schema-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAA+B,EAC/B,iBAAyC,EACzC,OAAiC;IAEjC,IAAI,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAEb,CAAC;IACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC;IAC9C,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,UAG1B,CAAC;IAEF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7D,IAAI,IAAI,IAAI,WAAW,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,SAAS,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/serializers.d.ts

@@ -0,0 +1,16 @@
+import type { ScannedModule } from './types.js';
+/**
+ * Converts annotations to a plain dictionary.
+ * Returns null for null/undefined or unrecognised types.
+ */
+export declare function annotationsToDict(annotations: unknown): Record<string, unknown> | null;
+/**
+ * Serializes a ScannedModule to a plain dictionary with snake_case keys,
+ * matching the Python SDK's output format.
+ */
+export declare function moduleToDict(module: ScannedModule): Record<string, unknown>;
+/**
+ * Batch-converts an array of ScannedModules to plain dictionaries.
+ */
+export declare function modulesToDicts(modules: ScannedModule[]): Record<string, unknown>[];
+//# sourceMappingURL=serializers.d.ts.map

package/dist/serializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../src/serializers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,OAAO,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBhC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,EAAE,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B"}

package/dist/serializers.js

@@ -0,0 +1,44 @@
+/**
+ * Converts annotations to a plain dictionary.
+ * Returns null for null/undefined or unrecognised types.
+ */
+export function annotationsToDict(annotations) {
+    if (annotations == null) {
+        return null;
+    }
+    if (typeof annotations === 'object' &&
+        !Array.isArray(annotations)) {
+        return { ...annotations };
+    }
+    console.warn('Unrecognised annotations type %s: %o — returning null', typeof annotations, annotations);
+    return null;
+}
+/**
+ * Serializes a ScannedModule to a plain dictionary with snake_case keys,
+ * matching the Python SDK's output format.
+ */
+export function moduleToDict(module) {
+    return {
+        module_id: module.moduleId,
+        description: module.description,
+        documentation: module.documentation,
+        tags: [...module.tags],
+        version: module.version,
+        target: module.target,
+        annotations: annotationsToDict(module.annotations),
+        examples: module.examples.length > 0
+            ? module.examples.map((e) => ({ ...e }))
+            : [],
+        metadata: { ...module.metadata },
+        input_schema: { ...module.inputSchema },
+        output_schema: { ...module.outputSchema },
+        warnings: [...module.warnings],
+    };
+}
+/**
+ * Batch-converts an array of ScannedModules to plain dictionaries.
+ */
+export function modulesToDicts(modules) {
+    return modules.map(moduleToDict);
+}
+//# sourceMappingURL=serializers.js.map

package/dist/serializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../src/serializers.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAoB;IAEpB,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IACE,OAAO,WAAW,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B,CAAC;QACD,OAAO,EAAE,GAAI,WAAuC,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,CAAC,IAAI,CACV,uDAAuD,EACvD,OAAO,WAAW,EAClB,WAAW,CACZ,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB;IAErB,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC;QAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAClC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACxC,CAAC,CAAC,EAAE;QACN,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QAChC,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;QACvC,aAAa,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE;QACzC,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAwB;IAExB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AACnC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+import type { ModuleAnnotations, ModuleExample } from 'apcore-js';
+export interface ScannedModule {
+    readonly moduleId: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly outputSchema: Record<string, unknown>;
+    readonly tags: readonly string[];
+    readonly target: string;
+    readonly version: string;
+    readonly annotations: ModuleAnnotations | null;
+    readonly documentation: string | null;
+    readonly examples: readonly ModuleExample[];
+    readonly metadata: Record<string, unknown>;
+    readonly warnings: readonly string[];
+}
+export declare function createScannedModule(options: {
+    moduleId: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+    tags: string[];
+    target: string;
+    version?: string;
+    annotations?: ModuleAnnotations | null;
+    documentation?: string | null;
+    examples?: ModuleExample[];
+    metadata?: Record<string, unknown>;
+    warnings?: string[];
+}): ScannedModule;
+export declare function cloneModule(module: ScannedModule, overrides?: Partial<ScannedModule>): ScannedModule;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,aAAa,CAehB;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EACrB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAWf"}

package/dist/types.js

@@ -0,0 +1,29 @@
+export function createScannedModule(options) {
+    return {
+        moduleId: options.moduleId,
+        description: options.description,
+        inputSchema: { ...options.inputSchema },
+        outputSchema: { ...options.outputSchema },
+        tags: [...options.tags],
+        target: options.target,
+        version: options.version ?? '1.0.0',
+        annotations: options.annotations ?? null,
+        documentation: options.documentation ?? null,
+        examples: [...(options.examples ?? [])],
+        metadata: { ...(options.metadata ?? {}) },
+        warnings: [...(options.warnings ?? [])],
+    };
+}
+export function cloneModule(module, overrides) {
+    const merged = { ...module, ...overrides };
+    return {
+        ...merged,
+        tags: [...merged.tags],
+        examples: [...merged.examples],
+        metadata: { ...merged.metadata },
+        warnings: [...merged.warnings],
+        inputSchema: { ...merged.inputSchema },
+        outputSchema: { ...merged.outputSchema },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,mBAAmB,CAAC,OAanC;IACC,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE;QACvC,YAAY,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE;QACzC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;QACnC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACvC,QAAQ,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE;QACzC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAqB,EACrB,SAAkC;IAElC,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IAC3C,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QACtB,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC9B,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QAChC,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC9B,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE;QACtC,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,YAAY,EAAE;KACzC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "apcore-toolkit",
+  "version": "0.1.0",
+  "description": "Shared scanner, schema extraction, and output toolkit for apcore framework adapters",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "license": "Apache-2.0",
+  "author": {
+    "name": "aipartnerup",
+    "email": "tercel.yi@gmail.com"
+  },
+  "keywords": [
+    "apcore",
+    "mcp",
+    "scanner",
+    "schema",
+    "yaml",
+    "openapi",
+    "toolkit"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aipartnerup/apcore-toolkit-typescript"
+  },
+  "homepage": "https://aipartnerup.com",
+  "bugs": {
+    "url": "https://github.com/aipartnerup/apcore-toolkit-typescript/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "apcore-js": ">=0.9.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "apdev-js": "^0.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0",
+    "@vitest/coverage-v8": "^3.0.0",
+    "eslint": "^9.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "apdev": {
+    "base_package": "apcore-toolkit"
+  }
+}