@amodalai/core 0.1.0

package/dist/src/packages/resolver.js

@@ -0,0 +1,353 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import * as path from 'node:path';
+import { parseConnection, parseSkill, parseKnowledge, parseAutomation } from '../repo/parsers.js';
+import { parseJsonImport, parseMarkdownFrontmatter } from './frontmatter.js';
+import { mergeAccessJson, mergeConcatenation, mergeEntities, mergeSpecJson, mergeSurface } from './merge-engine.js';
+import { readPackageFile } from './manifest-reader.js';
+import { getPackageDir } from './npm-context.js';
+import { makePackageRef, parsePackageKey } from './package-types.js';
+// --- Helpers ---
+async function readOptionalFile(filePath) {
+    try {
+        return await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    }
+}
+async function dirExists(dirPath) {
+    try {
+        const s = await stat(dirPath);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function listSubdirs(dirPath) {
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+function hasImportHeader(content) {
+    // JSON import
+    if (content.trim().startsWith('{')) {
+        try {
+            const { import: imp } = parseJsonImport(content);
+            return imp !== undefined;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Markdown import
+    const { frontmatter } = parseMarkdownFrontmatter(content);
+    return frontmatter !== null && typeof frontmatter['import'] === 'string';
+}
+// --- Connection resolution ---
+/**
+ * Resolve a single connection by merging package + repo files.
+ */
+export async function resolveConnection(name, repoDir, packageDir) {
+    if (!repoDir && !packageDir)
+        return null;
+    const location = repoDir ?? packageDir;
+    // Helper to read from package
+    async function readPkg(filename) {
+        if (!packageDir)
+            return null;
+        return readPackageFile(packageDir, filename);
+    }
+    // Helper to read from repo
+    async function readRepo(filename) {
+        if (!repoDir)
+            return null;
+        return readOptionalFile(path.join(repoDir, filename));
+    }
+    // Resolve each file type with merge logic
+    const repoSpec = await readRepo('spec.json');
+    const pkgSpec = await readPkg('spec.json');
+    let specJson;
+    if (repoSpec && pkgSpec && hasImportHeader(repoSpec)) {
+        const merged = mergeSpecJson(pkgSpec, repoSpec);
+        specJson = JSON.stringify(merged);
+    }
+    else if (repoSpec) {
+        specJson = repoSpec;
+    }
+    else if (pkgSpec) {
+        specJson = pkgSpec;
+    }
+    else {
+        return null; // spec.json is required
+    }
+    const repoAccess = await readRepo('access.json');
+    const pkgAccess = await readPkg('access.json');
+    let accessJson;
+    if (repoAccess && pkgAccess && hasImportHeader(repoAccess)) {
+        const merged = mergeAccessJson(pkgAccess, repoAccess);
+        accessJson = JSON.stringify(merged);
+    }
+    else if (repoAccess) {
+        accessJson = repoAccess;
+    }
+    else if (pkgAccess) {
+        accessJson = pkgAccess;
+    }
+    else {
+        return null; // access.json is required
+    }
+    // surface.md (optional)
+    const repoSurface = await readRepo('surface.md');
+    const pkgSurface = await readPkg('surface.md');
+    let surfaceMd;
+    if (repoSurface && pkgSurface && hasImportHeader(repoSurface)) {
+        surfaceMd = mergeSurface(pkgSurface, repoSurface);
+    }
+    else if (repoSurface) {
+        surfaceMd = repoSurface;
+    }
+    else if (pkgSurface) {
+        surfaceMd = pkgSurface;
+    }
+    // entities.md (optional)
+    const repoEntities = await readRepo('entities.md');
+    const pkgEntities = await readPkg('entities.md');
+    let entitiesMd;
+    if (repoEntities && pkgEntities && hasImportHeader(repoEntities)) {
+        entitiesMd = mergeEntities(pkgEntities, repoEntities);
+    }
+    else if (repoEntities) {
+        entitiesMd = repoEntities;
+    }
+    else if (pkgEntities) {
+        entitiesMd = pkgEntities;
+    }
+    // rules.md (optional, concatenation)
+    const repoRules = await readRepo('rules.md');
+    const pkgRules = await readPkg('rules.md');
+    let rulesMd;
+    if (repoRules && pkgRules && hasImportHeader(repoRules)) {
+        rulesMd = mergeConcatenation(pkgRules, repoRules);
+    }
+    else if (repoRules) {
+        rulesMd = repoRules;
+    }
+    else if (pkgRules) {
+        rulesMd = pkgRules;
+    }
+    return parseConnection(name, { specJson, accessJson, surfaceMd, entitiesMd, rulesMd }, location);
+}
+// --- Skill resolution ---
+/**
+ * Resolve a single skill by merging package + repo files.
+ */
+export async function resolveSkill(name, repoDir, packageDir) {
+    if (!repoDir && !packageDir)
+        return null;
+    const location = repoDir ?? packageDir;
+    const repoContent = repoDir
+        ? await readOptionalFile(path.join(repoDir, 'SKILL.md'))
+        : null;
+    const pkgContent = packageDir
+        ? await readPackageFile(packageDir, 'SKILL.md')
+        : null;
+    let content = null;
+    if (repoContent && pkgContent && hasImportHeader(repoContent)) {
+        content = mergeConcatenation(pkgContent, repoContent);
+    }
+    else if (repoContent) {
+        content = repoContent;
+    }
+    else if (pkgContent) {
+        content = pkgContent;
+    }
+    if (!content)
+        return null;
+    return parseSkill(content, location);
+}
+// --- Automation resolution ---
+/**
+ * Resolve a single automation by merging package + repo file.
+ */
+export async function resolveAutomation(name, repoDir, packageDir) {
+    if (!repoDir && !packageDir)
+        return null;
+    const location = repoDir ?? packageDir;
+    const repoContent = repoDir
+        ? await readOptionalFile(path.join(repoDir, `${name}.md`))
+        : null;
+    const pkgContent = packageDir
+        ? await readPackageFile(packageDir, `${name}.md`)
+        : null;
+    let content = null;
+    if (repoContent && pkgContent && hasImportHeader(repoContent)) {
+        content = mergeConcatenation(pkgContent, repoContent);
+    }
+    else if (repoContent) {
+        content = repoContent;
+    }
+    else if (pkgContent) {
+        content = pkgContent;
+    }
+    if (!content)
+        return null;
+    return parseAutomation(content, name, location);
+}
+// --- Knowledge resolution ---
+/**
+ * Resolve a single knowledge file by merging package + repo file.
+ */
+export async function resolveKnowledge(name, repoDir, packageDir) {
+    if (!repoDir && !packageDir)
+        return null;
+    const location = repoDir ?? packageDir;
+    const repoContent = repoDir
+        ? await readOptionalFile(path.join(repoDir, `${name}.md`))
+        : null;
+    const pkgContent = packageDir
+        ? await readPackageFile(packageDir, `${name}.md`)
+        : null;
+    let content = null;
+    if (repoContent && pkgContent && hasImportHeader(repoContent)) {
+        content = mergeConcatenation(pkgContent, repoContent);
+    }
+    else if (repoContent) {
+        content = repoContent;
+    }
+    else if (pkgContent) {
+        content = pkgContent;
+    }
+    if (!content)
+        return null;
+    return parseKnowledge(content, name, location);
+}
+// --- Full resolution ---
+/**
+ * Resolve all packages: merge lock file packages with repo directories.
+ */
+export async function resolveAllPackages(options) {
+    const { repoPath, lockFile } = options;
+    const warnings = [];
+    const connections = new Map();
+    const skills = [];
+    const automations = [];
+    const knowledge = [];
+    // Build union of names from lock file + repo directories
+    const connectionNames = new Set();
+    const skillNames = new Set();
+    const automationNames = new Set();
+    const knowledgeNames = new Set();
+    // From lock file
+    if (lockFile) {
+        for (const key of Object.keys(lockFile.packages)) {
+            const parsed = parsePackageKey(key);
+            switch (parsed.type) {
+                case 'connection':
+                    connectionNames.add(parsed.name);
+                    break;
+                case 'skill':
+                    skillNames.add(parsed.name);
+                    break;
+                case 'automation':
+                    automationNames.add(parsed.name);
+                    break;
+                case 'knowledge':
+                    knowledgeNames.add(parsed.name);
+                    break;
+                default:
+                    break;
+            }
+        }
+    }
+    // From repo directories
+    const connDirs = await listSubdirs(path.join(repoPath, 'connections'));
+    for (const d of connDirs)
+        connectionNames.add(d);
+    const skillDirs = await listSubdirs(path.join(repoPath, 'skills'));
+    for (const d of skillDirs)
+        skillNames.add(d);
+    // For automations and knowledge, list .md files
+    const autoDir = path.join(repoPath, 'automations');
+    const knowledgeDir = path.join(repoPath, 'knowledge');
+    try {
+        const autoFiles = await readdir(autoDir);
+        for (const f of autoFiles) {
+            if (f.endsWith('.md'))
+                automationNames.add(f.replace(/\.md$/, ''));
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    try {
+        const knowledgeFiles = await readdir(knowledgeDir);
+        for (const f of knowledgeFiles) {
+            if (f.endsWith('.md'))
+                knowledgeNames.add(f.replace(/\.md$/, ''));
+        }
+    }
+    catch {
+        // Directory doesn't exist
+    }
+    // Helper to get package directory for a name
+    async function getPkgDir(type, name) {
+        const ref = makePackageRef(type, name);
+        const dir = await getPackageDir(repoPath, ref);
+        if (!dir && lockFile && lockFile.packages[ref.key]) {
+            warnings.push(`Package ${ref.key} is in lock file but not installed (broken symlink?)`);
+        }
+        return dir;
+    }
+    // Resolve connections
+    const connTasks = [...connectionNames].map(async (name) => {
+        const repoDir = path.join(repoPath, 'connections', name);
+        const repoDirExists = await dirExists(repoDir);
+        const pkgDir = await getPkgDir('connection', name);
+        const result = await resolveConnection(name, repoDirExists ? repoDir : null, pkgDir);
+        if (result)
+            connections.set(name, result);
+    });
+    // Resolve skills
+    const skillTasks = [...skillNames].map(async (name) => {
+        const repoDir = path.join(repoPath, 'skills', name);
+        const repoDirExists = await dirExists(repoDir);
+        const pkgDir = await getPkgDir('skill', name);
+        const result = await resolveSkill(name, repoDirExists ? repoDir : null, pkgDir);
+        if (result)
+            skills.push(result);
+    });
+    // Resolve automations
+    const autoTasks = [...automationNames].map(async (name) => {
+        const repoDir = path.join(repoPath, 'automations');
+        const repoDirExists = await dirExists(repoDir);
+        const pkgDir = await getPkgDir('automation', name);
+        const result = await resolveAutomation(name, repoDirExists ? repoDir : null, pkgDir);
+        if (result)
+            automations.push(result);
+    });
+    // Resolve knowledge
+    const knowledgeTasks = [...knowledgeNames].map(async (name) => {
+        const repoDir = path.join(repoPath, 'knowledge');
+        const repoDirExists = await dirExists(repoDir);
+        const pkgDir = await getPkgDir('knowledge', name);
+        const result = await resolveKnowledge(name, repoDirExists ? repoDir : null, pkgDir);
+        if (result)
+            knowledge.push(result);
+    });
+    await Promise.all([...connTasks, ...skillTasks, ...autoTasks, ...knowledgeTasks]);
+    return { connections, skills, automations, knowledge, warnings };
+}
+//# sourceMappingURL=resolver.js.map

package/dist/src/packages/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/packages/resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAC,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAGhG,OAAO,EAAC,eAAe,EAAE,wBAAwB,EAAC,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAC,eAAe,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAC,cAAc,EAAE,eAAe,EAAC,MAAM,oBAAoB,CAAC;AAcnE,kBAAkB;AAElB,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,uEAAuE;QACvE,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAC,aAAa,EAAE,IAAI,EAAC,CAAC,CAAC;QAC9D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,cAAc;IACd,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,EAAC,MAAM,EAAE,GAAG,EAAC,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC/C,OAAO,GAAG,KAAK,SAAS,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,kBAAkB;IAClB,MAAM,EAAC,WAAW,EAAC,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,WAAW,KAAK,IAAI,IAAI,OAAO,WAAW,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC;AAC3E,CAAC;AAED,gCAAgC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAAsB,EACtB,UAAyB;IAEzB,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,IAAI,UAAW,CAAC;IAExC,8BAA8B;IAC9B,KAAK,UAAU,OAAO,CAAC,QAAgB;QACrC,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,2BAA2B;IAC3B,KAAK,UAAU,QAAQ,CAAC,QAAgB;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,QAAgB,CAAC;IACrB,IAAI,QAAQ,IAAI,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,QAAQ,GAAG,QAAQ,CAAC;IACtB,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,UAAkB,CAAC;IACvB,IAAI,UAAU,IAAI,SAAS,IAAI,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACtD,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,UAAU,GAAG,UAAU,CAAC;IAC1B,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,OAAO,IAAI,CAAC,CAAC,0BAA0B;IACzC,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/C,IAAI,SAA6B,CAAC;IAClC,IAAI,WAAW,IAAI,UAAU,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,SAAS,GAAG,WAAW,CAAC;IAC1B,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,SAAS,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,yBAAyB;IACzB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,IAAI,UAA8B,CAAC;IACnC,IAAI,YAAY,IAAI,WAAW,IAAI,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QACjE,UAAU,GAAG,aAAa,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,YAAY,EAAE,CAAC;QACxB,UAAU,GAAG,YAAY,CAAC;IAC5B,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,UAAU,GAAG,WAAW,CAAC;IAC3B,CAAC;IAED,qCAAqC;IACrC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,OAA2B,CAAC;IAChC,IAAI,SAAS,IAAI,QAAQ,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QACxD,OAAO,GAAG,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,SAAS,EAAE,CAAC;QACrB,OAAO,GAAG,SAAS,CAAC;IACtB,CAAC;SAAM,IAAI,QAAQ,EAAE,CAAC;QACpB,OAAO,GAAG,QAAQ,CAAC;IACrB,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,EAAE,EAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,EAAE,QAAQ,CAAC,CAAC;AACjG,CAAC;AAED,2BAA2B;AAE3B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,OAAsB,EACtB,UAAyB;IAEzB,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,IAAI,UAAW,CAAC;IAExC,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACxD,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,MAAM,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC;QAC/C,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,IAAI,UAAU,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,OAAO,GAAG,WAAW,CAAC;IACxB,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO,GAAG,UAAU,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,gCAAgC;AAEhC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAAsB,EACtB,UAAyB;IAEzB,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,IAAI,UAAW,CAAC;IAExC,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,MAAM,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,IAAI,UAAU,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,OAAO,GAAG,WAAW,CAAC;IACxB,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO,GAAG,UAAU,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED,+BAA+B;AAE/B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,OAAsB,EACtB,UAAyB;IAEzB,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,IAAI,UAAW,CAAC;IAExC,MAAM,WAAW,GAAG,OAAO;QACzB,CAAC,CAAC,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;QAC1D,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,UAAU,GAAG,UAAU;QAC3B,CAAC,CAAC,MAAM,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC;QACjD,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,WAAW,IAAI,UAAU,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9D,OAAO,GAAG,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACxD,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,OAAO,GAAG,WAAW,CAAC;IACxB,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,OAAO,GAAG,UAAU,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED,0BAA0B;AAE1B;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAGxC;IACC,MAAM,EAAC,QAAQ,EAAE,QAAQ,EAAC,GAAG,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,WAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IACxD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAsB,EAAE,CAAC;IAExC,yDAAyD;IACzD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,iBAAiB;IACjB,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACpC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpB,KAAK,YAAY;oBACf,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACjC,MAAM;gBACR,KAAK,OAAO;oBACV,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC5B,MAAM;gBACR,KAAK,YAAY;oBACf,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACjC,MAAM;gBACR,KAAK,WAAW;oBACd,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAChC,MAAM;gBACR;oBACE,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAE7C,gDAAgD;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEtD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;IAED,6CAA6C;IAC7C,KAAK,UAAU,SAAS,CAAC,IAAiB,EAAE,IAAY;QACtD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,sDAAsD,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,sBAAsB;IACtB,MAAM,SAAS,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,IAAI,EACJ,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAC9B,MAAM,CACP,CAAC;QACF,IAAI,MAAM;YAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,iBAAiB;IACjB,MAAM,UAAU,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,YAAY,CAC/B,IAAI,EACJ,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAC9B,MAAM,CACP,CAAC;QACF,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,SAAS,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,IAAI,EACJ,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAC9B,MAAM,CACP,CAAC;QACF,IAAI,MAAM;YAAE,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,cAAc,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,IAAI,EACJ,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAC9B,MAAM,CACP,CAAC;QACF,IAAI,MAAM;YAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC;IAElF,OAAO,EAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAC,CAAC;AACjE,CAAC"}

package/dist/src/platform/config-builder.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalConfigExtensions } from '../amodal-config.js';
+import type { VersionManager } from '../versions/version-manager.js';
+import type { AgentSDKConfig } from './platform-types.js';
+/**
+ * The subset of AmodalConfigExtensions that comes from version bundles
+ * and SDK-level settings, plus a versionBundleVersion string.
+ */
+export type PlatformConfigParams = AmodalConfigExtensions & {
+    versionBundleVersion?: string;
+};
+/**
+ * Merge version config (from VersionManager) and SDK config into
+ * fields suitable for the AmodalConfig constructor.
+ *
+ * Bundle-derived fields (tools, roles, handlers) come from versionConfig.
+ * Operational fields (connections, audit, activeRole) come from sdkConfig.
+ * The bundle version string is used as auditVersion.
+ */
+export declare function buildPlatformConfigParams(versionConfig: ReturnType<VersionManager['getVersionConfig']>, sdkConfig: AgentSDKConfig): Partial<PlatformConfigParams>;

package/dist/src/platform/config-builder.js

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Merge version config (from VersionManager) and SDK config into
+ * fields suitable for the AmodalConfig constructor.
+ *
+ * Bundle-derived fields (tools, roles, handlers) come from versionConfig.
+ * Operational fields (connections, audit, activeRole) come from sdkConfig.
+ * The bundle version string is used as auditVersion.
+ */
+export function buildPlatformConfigParams(versionConfig, sdkConfig) {
+    const params = {};
+    // Platform API credentials from SDK config
+    if (sdkConfig.platform) {
+        params.platformApiUrl = sdkConfig.platform.apiUrl;
+        params.platformApiKey = sdkConfig.platform.apiKey;
+    }
+    // Application and tenant IDs
+    if (sdkConfig.applicationId) {
+        params.applicationId = sdkConfig.applicationId;
+    }
+    if (sdkConfig.tenantId) {
+        params.tenantId = sdkConfig.tenantId;
+    }
+    // Agent context from SDK config (may be auto-detected from org)
+    if (sdkConfig.agentContext) {
+        params.agentContext = sdkConfig.agentContext;
+    }
+    // Disabled platform tools from SDK config (fetched from application)
+    if (sdkConfig.disabledPlatformTools && sdkConfig.disabledPlatformTools.length > 0) {
+        params.disabledBuiltInTools = sdkConfig.disabledPlatformTools;
+    }
+    // Connections from SDK config (local secrets, never from platform)
+    if (sdkConfig.connections) {
+        params.connections = sdkConfig.connections;
+    }
+    // Active role from SDK config
+    if (sdkConfig.activeRole) {
+        params.activeRole = sdkConfig.activeRole;
+    }
+    // Audit config from SDK config
+    if (sdkConfig.auditConfig != null) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- audit config from SDK
+        params.auditConfig = sdkConfig.auditConfig;
+    }
+    if (sdkConfig.auditUser) {
+        params.auditUser = sdkConfig.auditUser;
+    }
+    if (sdkConfig.auditSource) {
+        params.auditSource = sdkConfig.auditSource;
+    }
+    // Version bundle fields
+    if (versionConfig) {
+        params.httpToolConfigs = versionConfig.httpToolConfigs;
+        params.chainToolConfigs = versionConfig.chainToolConfigs;
+        params.functionToolConfigs = versionConfig.functionToolConfigs;
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- handler map from version manager
+        params.functionToolHandlers = versionConfig.functionToolHandlers;
+        params.roleDefinitions = versionConfig.roleDefinitions;
+        params.auditVersion = versionConfig.version;
+        params.versionBundleVersion = versionConfig.version;
+        params.bundleSkills = versionConfig.skills;
+        params.automationDefinitions = versionConfig.automations;
+    }
+    return params;
+}
+//# sourceMappingURL=config-builder.js.map

package/dist/src/platform/config-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-builder.js","sourceRoot":"","sources":["../../../src/platform/config-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,aAA6D,EAC7D,SAAyB;IAEzB,MAAM,MAAM,GAAkC,EAAE,CAAC;IAEjD,2CAA2C;IAC3C,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAClD,MAAM,CAAC,cAAc,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IACpD,CAAC;IAED,6BAA6B;IAC7B,IAAI,SAAS,CAAC,aAAa,EAAE,CAAC;QAC5B,MAAM,CAAC,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC;IACjD,CAAC;IACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;IACvC,CAAC;IAED,gEAAgE;IAChE,IAAI,SAAS,CAAC,YAAY,EAAE,CAAC;QAC3B,MAAM,CAAC,YAAY,GAAG,SAAS,CAAC,YAAY,CAAC;IAC/C,CAAC;IAED,qEAAqE;IACrE,IAAI,SAAS,CAAC,qBAAqB,IAAI,SAAS,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClF,MAAM,CAAC,oBAAoB,GAAG,SAAS,CAAC,qBAAqB,CAAC;IAChE,CAAC;IAED,mEAAmE;IACnE,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;IAC7C,CAAC;IAED,8BAA8B;IAC9B,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACzB,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CAAC;IAC3C,CAAC;IAED,+BAA+B;IAC/B,IAAI,SAAS,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;QAClC,gGAAgG;QAChG,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,WAAoD,CAAC;IACtF,CAAC;IACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACxB,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC;QAC1B,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;IAC7C,CAAC;IAED,wBAAwB;IACxB,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,eAAe,GAAG,aAAa,CAAC,eAAe,CAAC;QACvD,MAAM,CAAC,gBAAgB,GAAG,aAAa,CAAC,gBAAgB,CAAC;QACzD,MAAM,CAAC,mBAAmB,GAAG,aAAa,CAAC,mBAAmB,CAAC;QAC/D,2GAA2G;QAC3G,MAAM,CAAC,oBAAoB,GAAG,aAAa,CAAC,oBAA0D,CAAC;QAEvG,MAAM,CAAC,eAAe,GAAG,aAAa,CAAC,eAA4B,CAAC;QACpE,MAAM,CAAC,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC;QAC5C,MAAM,CAAC,oBAAoB,GAAG,aAAa,CAAC,OAAO,CAAC;QACpD,MAAM,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC;QAE3C,MAAM,CAAC,qBAAqB,GAAG,aAAa,CAAC,WAAwB,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/platform/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './platform-types.js';
+export * from './platform-client.js';
+export * from './config-builder.js';

package/dist/src/platform/index.js

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export * from './platform-types.js';
+export * from './platform-client.js';
+export * from './config-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/src/platform/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platform/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/dist/src/platform/platform-client.d.ts

@@ -0,0 +1,160 @@
+/**
+ * @license
+ * Copyright 2026 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { VersionBundle, BundleToolConfig, BundleSkill, SubagentConfig } from '../versions/version-bundle-types.js';
+import type { PlatformConfig, ConnectionInfo } from './platform-types.js';
+import type { KBDocument, ScopeType } from '../knowledge/kb-types.js';
+/**
+ * Organization record returned by the platform API.
+ */
+export interface OrgRecord {
+    id: string;
+    name: string;
+    agent_context?: string;
+}
+/**
+ * Application record returned by the platform API.
+ */
+export interface AppRecord {
+    id: string;
+    org_id: string;
+    name: string;
+    base_prompt?: string;
+    agent_context?: string;
+    disabled_platform_tools?: string[];
+    model?: string;
+    simple_model?: string;
+    advanced_model?: string;
+    provider?: string;
+    provider_base_url?: string;
+    provider_api_key?: string;
+}
+/**
+ * A resolved secret (name + decrypted value) returned by the platform API.
+ */
+export interface ResolvedSecret {
+    name: string;
+    value: string;
+}
+/**
+ * Request config for a connection, describing how to build HTTP requests.
+ */
+export interface RequestConfigRecord {
+    base_url_field: string;
+    auth: Array<{
+        header: string;
+        value_template: string;
+    }>;
+    default_headers: Record<string, string>;
+}
+/**
+ * A resolved connection with credentials and optional request config.
+ */
+export interface ResolvedConnection {
+    credentials: Record<string, string>;
+    request_config?: RequestConfigRecord;
+}
+/**
+ * Map of connection names to their resolved credentials and request config.
+ */
+export type ResolvedConnectionMap = Record<string, ResolvedConnection>;
+/**
+ * Client for communicating with the platform API.
+ * Fetches version bundles for a specific deployment.
+ */
+export declare class PlatformClient {
+    private readonly config;
+    constructor(config: PlatformConfig);
+    /**
+     * Fetch the latest version bundle for this deployment.
+     */
+    fetchLatestBundle(timeout?: number): Promise<VersionBundle>;
+    /**
+     * Fetch knowledge base documents for a given scope.
+     *
+     * @param scopeType 'application' or 'tenant'
+     * @param scopeId The application or tenant ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchDocuments(scopeType: ScopeType, scopeId: string, sessionType?: string, timeout?: number): Promise<KBDocument[]>;
+    /**
+     * Fetch documents matching any of the given tags.
+     */
+    fetchDocumentsByTags(scopeType: ScopeType, scopeId: string, tags: string[], timeout?: number): Promise<KBDocument[]>;
+    /**
+     * Search documents by title keyword.
+     */
+    searchDocuments(scopeType: ScopeType, scopeId: string, query: string, timeout?: number): Promise<KBDocument[]>;
+    /**
+     * Fetch specific documents by their IDs.
+     */
+    fetchDocumentsByIds(scopeType: ScopeType, scopeId: string, ids: string[], timeout?: number): Promise<KBDocument[]>;
+    /**
+     * Internal helper: fetch documents with optional query params.
+     */
+    private fetchDocumentsWithParams;
+    /**
+     * Fetch organization details.
+     *
+     * @param orgId The organization ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchOrganization(orgId: string, timeout?: number): Promise<OrgRecord>;
+    /**
+     * Fetch application details (including base_prompt and agent_context).
+     *
+     * @param appId The application ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchApplication(appId: string, timeout?: number): Promise<AppRecord>;
+    /**
+     * Fetch the active deployment snapshot blob.
+     * Returns the raw snapshot record or null if none is active.
+     */
+    fetchActiveSnapshot(timeout?: number, deployId?: string): Promise<Record<string, unknown> | null>;
+    /**
+     * Resolve decrypted secrets for a tenant.
+     *
+     * @param tenantId The tenant ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    resolveSecrets(tenantId: string, timeout?: number): Promise<ResolvedSecret[]>;
+    /**
+     * Resolve connections for a tenant — returns per-connection credentials + request_config.
+     *
+     * @param tenantId The tenant ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    resolveConnections(tenantId: string, timeout?: number): Promise<ResolvedConnectionMap>;
+    /**
+     * Fetch custom tools for a deployment (application).
+     *
+     * @param appId The application/deployment ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchTools(appId: string, sessionType?: string, timeout?: number): Promise<BundleToolConfig[]>;
+    /**
+     * Fetch skills for a deployment (application).
+     *
+     * @param appId The application/deployment ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchSkills(appId: string, sessionType?: string, timeout?: number): Promise<BundleSkill[]>;
+    /**
+     * Fetch subagent (task agent) configurations for a deployment.
+     *
+     * @param appId The application/deployment ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchSubagents(appId: string, sessionType?: string, timeout?: number): Promise<SubagentConfig[]>;
+    /**
+     * Fetch connection metadata for an application.
+     * Returns name, provider, and description for each connection — no credentials.
+     *
+     * @param appId The application ID
+     * @param timeout Request timeout in ms (default 30000)
+     */
+    fetchConnections(appId: string, sessionType?: string, timeout?: number): Promise<ConnectionInfo[]>;
+}