import type { Logger } from "@onenomad/przm-cortex-core";
import type { AnyMcpTool } from "./mcp/tool.js";
/**
 * Loader for private/personal Cortex modules.
 *
 * A private module is a directory with a `dist/index.js` that
 * exports an `mcpTools` array — same shape as the built-in tools.
 * Cortex loads each configured path at server startup and merges
 * the returned tools into the main MCP tool surface, so Claude
 * sees them alongside everything else with no additional MCP
 * server configuration needed.
 *
 * This is the `packages/adapter-github`-style "module" idea, but
 * for code living outside the public Cortex repo — personal stuff
 * (job profile, private playbooks, workflow helpers). Keeps the
 * public codebase pristine while letting Cortex still host them.
 *
 * Config shape:
 *   ```yaml
 *   privateModules:
 *     - /root/.cortex-private/packages/cortex-job-profile
 *   ```
 *
 * Paths must point to module root directories; the loader resolves
 * `<path>/dist/index.js` as the import target.
 */
export interface PrivateModule {
    /** Source directory this module was loaded from. */
    path: string;
    /** Package name from its package.json, if discoverable. */
    name?: string;
    /** Tools the module exports. */
    tools: AnyMcpTool[];
}
export declare function loadPrivateModules(paths: readonly string[], logger: Logger): Promise<PrivateModule[]>;
//# sourceMappingURL=private-modules.d.ts.map