@moorline/core 0.0.1

package/dist/core/extension/packages/remoteArchiveDownloader.js

@@ -0,0 +1,156 @@
+import { createHash } from 'node:crypto';
+import { writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { FETCH_TIMEOUT_MS, MAX_ARCHIVE_BYTES, MAX_REDIRECTS } from './packageSourceLimits.js';
+import { validateRemoteUrlTarget } from '../../shared/utils/remoteNetworkPolicy.js';
+export class RemoteArchiveDownloadError extends Error {
+    code;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.name = 'RemoteArchiveDownloadError';
+        if (cause !== undefined) {
+            Object.defineProperty(this, 'cause', {
+                value: cause,
+                configurable: true,
+                enumerable: false,
+                writable: false
+            });
+        }
+    }
+}
+function privateRemoteArchiveFetchesEnabled() {
+    return process.env.MOORLINE_ALLOW_PRIVATE_REMOTE_ARCHIVE_URLS === '1';
+}
+const SUPPORTED_ARCHIVE_SUFFIXES = ['.tar.gz', '.tgz', '.zip'];
+const SUPPORTED_INTEGRITY_ALGORITHMS = new Set(['sha256', 'sha384', 'sha512']);
+function hasSupportedArchiveSuffix(filename) {
+    const lower = filename.toLowerCase();
+    return SUPPORTED_ARCHIVE_SUFFIXES.some((suffix) => lower.endsWith(suffix));
+}
+function archiveFilenameFromUrl(url) {
+    if (url.pathname.endsWith('/')) {
+        const digest = createHash('sha256').update(url.toString()).digest('hex').slice(0, 16);
+        return `remote-archive-${digest}.tar.gz`;
+    }
+    const raw = basename(url.pathname).trim();
+    if (!raw) {
+        const digest = createHash('sha256').update(url.toString()).digest('hex').slice(0, 16);
+        return `remote-archive-${digest}.tar.gz`;
+    }
+    if (!hasSupportedArchiveSuffix(raw)) {
+        throw new RemoteArchiveDownloadError(`Unsupported archive filename for ${url.toString()}. Expected one of: ${SUPPORTED_ARCHIVE_SUFFIXES.join(', ')}`, 'validation');
+    }
+    return raw;
+}
+function verifySubresourceIntegrity(input) {
+    const candidates = input.integrity
+        .trim()
+        .split(/\s+/u)
+        .map((entry) => {
+        const [algorithm, digest] = entry.split('-', 2);
+        return {
+            algorithm,
+            digest
+        };
+    })
+        .filter((entry) => Boolean(entry.algorithm && entry.digest));
+    if (candidates.length === 0) {
+        throw new RemoteArchiveDownloadError(`Invalid integrity metadata for ${input.url}`, 'checksum');
+    }
+    const supported = candidates.filter((entry) => SUPPORTED_INTEGRITY_ALGORITHMS.has(entry.algorithm));
+    if (supported.length === 0) {
+        throw new RemoteArchiveDownloadError(`Unsupported integrity algorithm for ${input.url}. Expected one of: ${[...SUPPORTED_INTEGRITY_ALGORITHMS].join(', ')}`, 'checksum');
+    }
+    for (const candidate of supported) {
+        const actual = createHash(candidate.algorithm).update(input.bytes).digest('base64');
+        if (actual === candidate.digest) {
+            return;
+        }
+    }
+    throw new RemoteArchiveDownloadError(`Integrity mismatch for ${input.url}`, 'checksum');
+}
+async function ensureRemoteArchiveUrlAllowed(url) {
+    const allowPrivate = privateRemoteArchiveFetchesEnabled();
+    const parsed = await validateRemoteUrlTarget({
+        rawUrl: url,
+        allowedProtocols: allowPrivate ? ['http:', 'https:'] : ['https:'],
+        allowPrivateTargets: allowPrivate,
+        failOnDnsErrors: true,
+        sourceLabel: 'Remote archive URL'
+    });
+    if (parsed.protocol !== 'https:' && !allowPrivate) {
+        throw new Error(`Remote archives must use HTTPS. Set MOORLINE_ALLOW_PRIVATE_REMOTE_ARCHIVE_URLS=1 to allow private/local HTTP URLs.`);
+    }
+    return parsed;
+}
+export async function downloadRemoteArchive(source, targetDir) {
+    let url;
+    try {
+        url = await ensureRemoteArchiveUrlAllowed(source.url);
+    }
+    catch (error) {
+        throw new RemoteArchiveDownloadError(error instanceof Error ? error.message : String(error), 'network', error);
+    }
+    for (let redirectCount = 0; redirectCount <= MAX_REDIRECTS; redirectCount += 1) {
+        const controller = new globalThis.AbortController();
+        const timeout = globalThis.setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+        try {
+            let response;
+            try {
+                response = await fetch(url, {
+                    redirect: 'manual',
+                    signal: controller.signal
+                });
+            }
+            catch (error) {
+                throw new RemoteArchiveDownloadError(`Unable to download package archive ${url.toString()}: network request failed`, 'network', error);
+            }
+            if (response.status >= 300 && response.status < 400) {
+                const location = response.headers.get('location');
+                if (!location) {
+                    throw new RemoteArchiveDownloadError(`Redirect without location header for ${url.toString()}`, 'redirect');
+                }
+                try {
+                    url = await ensureRemoteArchiveUrlAllowed(new URL(location, url).toString());
+                }
+                catch (error) {
+                    throw new RemoteArchiveDownloadError(error instanceof Error ? error.message : String(error), 'redirect', error);
+                }
+                continue;
+            }
+            if (!response.ok) {
+                throw new RemoteArchiveDownloadError(`Unable to download package archive ${url.toString()}: ${response.status} ${response.statusText}`, 'http');
+            }
+            const declaredLength = Number.parseInt(response.headers.get('content-length') ?? '', 10);
+            if (Number.isFinite(declaredLength) && declaredLength > MAX_ARCHIVE_BYTES) {
+                throw new RemoteArchiveDownloadError(`Archive download exceeds the ${MAX_ARCHIVE_BYTES}-byte limit: ${declaredLength}`, 'size');
+            }
+            const bytes = Buffer.from(await response.arrayBuffer());
+            if (bytes.length > MAX_ARCHIVE_BYTES) {
+                throw new RemoteArchiveDownloadError(`Archive download exceeds the ${MAX_ARCHIVE_BYTES}-byte limit: ${bytes.length}`, 'size');
+            }
+            if (source.sha256) {
+                const actualHash = createHash('sha256').update(bytes).digest('hex');
+                if (actualHash !== source.sha256.toLowerCase()) {
+                    throw new RemoteArchiveDownloadError(`Checksum mismatch for ${url.toString()}: expected ${source.sha256}, received ${actualHash}`, 'checksum');
+                }
+            }
+            if (source.integrity) {
+                verifySubresourceIntegrity({
+                    url: url.toString(),
+                    integrity: source.integrity,
+                    bytes
+                });
+            }
+            const archivePath = join(targetDir, archiveFilenameFromUrl(url));
+            writeFileSync(archivePath, bytes);
+            return archivePath;
+        }
+        finally {
+            globalThis.clearTimeout(timeout);
+        }
+    }
+    throw new RemoteArchiveDownloadError(`Too many redirects while downloading ${source.url}`, 'redirect');
+}
+//# sourceMappingURL=remoteArchiveDownloader.js.map

package/dist/core/extension/packages/remoteArchiveDownloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteArchiveDownloader.js","sourceRoot":"","sources":["../../../../../../../src/core/extension/packages/remoteArchiveDownloader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAIpF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAGxC;IAFX,YACE,OAAe,EACN,IAAoC,EAC7C,KAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAgC;QAI7C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACnC,KAAK,EAAE,KAAK;gBACZ,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED,SAAS,kCAAkC;IACzC,OAAO,OAAO,CAAC,GAAG,CAAC,0CAA0C,KAAK,GAAG,CAAC;AACxE,CAAC;AAED,MAAM,0BAA0B,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AACxE,MAAM,8BAA8B,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE/E,SAAS,yBAAyB,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO,0BAA0B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAQ;IACtC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,kBAAkB,MAAM,SAAS,CAAC;IAC3C,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtF,OAAO,kBAAkB,MAAM,SAAS,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,0BAA0B,CAClC,oCAAoC,GAAG,CAAC,QAAQ,EAAE,sBAAsB,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC/G,YAAY,CACb,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAwD;IAC1F,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS;SAC/B,IAAI,EAAE;SACN,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAChD,OAAO;YACL,SAAS;YACT,MAAM;SACP,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAkD,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAE/G,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,0BAA0B,CAAC,kCAAkC,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;IAClG,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACpG,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,0BAA0B,CAClC,uCAAuC,KAAK,CAAC,GAAG,sBAAsB,CAAC,GAAG,8BAA8B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtH,UAAU,CACX,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACpF,IAAI,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO;QACT,CAAC;IACH,CAAC;IAED,MAAM,IAAI,0BAA0B,CAAC,0BAA0B,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;AAC1F,CAAC;AAED,KAAK,UAAU,6BAA6B,CAAC,GAAW;IACtD,MAAM,YAAY,GAAG,kCAAkC,EAAE,CAAC;IAC1D,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC;QAC3C,MAAM,EAAE,GAAG;QACX,gBAAgB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACjE,mBAAmB,EAAE,YAAY;QACjC,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,oBAAoB;KAClC,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,oHAAoH,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAoE,EACpE,SAAiB;IAEjB,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,6BAA6B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,0BAA0B,CAClC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,SAAS,EACT,KAAK,CACN,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,aAAa,GAAG,CAAC,EAAE,aAAa,IAAI,aAAa,EAAE,aAAa,IAAI,CAAC,EAAE,CAAC;QAC/E,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC;YACb,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;oBAC1B,QAAQ,EAAE,QAAQ;oBAClB,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,0BAA0B,CAAC,sCAAsC,GAAG,CAAC,QAAQ,EAAE,0BAA0B,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACzI,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,IAAI,0BAA0B,CAAC,wCAAwC,GAAG,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;gBAC7G,CAAC;gBACD,IAAI,CAAC;oBACH,GAAG,GAAG,MAAM,6BAA6B,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC/E,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,IAAI,0BAA0B,CAClC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EACtD,UAAU,EACV,KAAK,CACN,CAAC;gBACJ,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,0BAA0B,CAClC,sCAAsC,GAAG,CAAC,QAAQ,EAAE,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EACjG,MAAM,CACP,CAAC;YACJ,CAAC;YACD,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACzF,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,iBAAiB,EAAE,CAAC;gBAC1E,MAAM,IAAI,0BAA0B,CAAC,gCAAgC,iBAAiB,gBAAgB,cAAc,EAAE,EAAE,MAAM,CAAC,CAAC;YAClI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YACxD,IAAI,KAAK,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBACrC,MAAM,IAAI,0BAA0B,CAAC,gCAAgC,iBAAiB,gBAAgB,KAAK,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;YAChI,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpE,IAAI,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;oBAC/C,MAAM,IAAI,0BAA0B,CAClC,yBAAyB,GAAG,CAAC,QAAQ,EAAE,cAAc,MAAM,CAAC,MAAM,cAAc,UAAU,EAAE,EAC5F,UAAU,CACX,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,0BAA0B,CAAC;oBACzB,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE;oBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC;YACjE,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAClC,OAAO,WAAW,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,MAAM,IAAI,0BAA0B,CAAC,wCAAwC,MAAM,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC;AACzG,CAAC"}

package/dist/core/extension/packages/runtimeStartability.d.ts

@@ -0,0 +1,16 @@
+import { type MoorlineConfig } from '../../../types/config.js';
+import type { JsonSchemaLike } from '../../../types/package.js';
+import type { PackageInventoryState } from './packageInventoryStore.js';
+interface RuntimeStartabilityCheck {
+    startable: boolean;
+    issues: string[];
+}
+export declare function coerceSurfaceConfigInput(input: {
+    surface: 'transport' | 'provider';
+    packageId: string;
+    schema: JsonSchemaLike | undefined;
+    key: string;
+    rawValue: string;
+}): string | boolean | number;
+export declare function evaluateRuntimeStartability(config: MoorlineConfig, inventory: PackageInventoryState): RuntimeStartabilityCheck;
+export {};

package/dist/core/extension/packages/runtimeStartability.js

@@ -0,0 +1,237 @@
+import { configuredApiAdapterConfig } from '../../../types/config.js';
+import { activatedPackageForUniqueKey, desiredPackageRefsFromConfig, isBuiltInActivatedPackage } from './packageActivation.js';
+import { resolvePackageConfigSchema } from './packageConfigSchema.js';
+import { resolvePackageDependencyErrors } from './packageDependencyResolver.js';
+function desiredStateFromConfig(config) {
+    return {
+        activated: desiredPackageRefsFromConfig(config)
+    };
+}
+function buildInstalledLookup(inventory) {
+    const lookup = {
+        'api-adapter': new Set(),
+        transport: new Set(),
+        provider: new Set(),
+        plugin: new Set(),
+        skill: new Set()
+    };
+    for (const entry of inventory.installed) {
+        const kind = entry.kind ?? entry.surface;
+        if (kind !== 'bundle') {
+            lookup[kind].add(entry.packageId);
+        }
+    }
+    return lookup;
+}
+function schemaTypeMatches(type, value) {
+    if (type === 'boolean') {
+        return typeof value === 'boolean';
+    }
+    if (type === 'number') {
+        return typeof value === 'number' && Number.isFinite(value);
+    }
+    if (type === 'string') {
+        return typeof value === 'string';
+    }
+    return true;
+}
+function isMissingValue(value) {
+    return value === undefined || value === null || (typeof value === 'string' && value.trim().length === 0);
+}
+function effectiveSurfaceConfig(config, surface, packageId) {
+    if (surface === 'api-adapter') {
+        const legacyNested = config.surfaces.apiAdapter.config[packageId];
+        const root = legacyNested && typeof legacyNested === 'object' && !Array.isArray(legacyNested)
+            ? legacyNested
+            : config.surfaces.apiAdapter.config;
+        return {
+            ...root,
+            ...(config.surfaces.apiAdapter.configByPackageId?.[packageId] ?? {})
+        };
+    }
+    if (surface === 'transport') {
+        return {
+            ...config.surfaces.transport.config,
+            ...(config.surfaces.transport.configByPackageId?.[packageId] ?? {})
+        };
+    }
+    return {
+        ...config.surfaces.provider.config,
+        ...(config.surfaces.provider.configByPackageId?.[packageId] ?? {})
+    };
+}
+function validateSurfaceConfigAgainstSchema(input) {
+    const { schema } = input;
+    if (!schema?.properties) {
+        return [];
+    }
+    const issues = [];
+    const knownKeys = new Set(Object.keys(schema.properties));
+    for (const key of Object.keys(input.config)) {
+        if (!input.allowUnknownConfigKeys && !knownKeys.has(key)) {
+            issues.push(`${input.surface} config key ${key} is not declared by ${input.packageId}.`);
+        }
+    }
+    for (const key of schema.required ?? []) {
+        if (isMissingValue(input.config[key])) {
+            issues.push(`${input.surface} config key ${key} is required for ${input.packageId}.`);
+        }
+    }
+    for (const [key, property] of Object.entries(schema.properties)) {
+        const value = input.config[key];
+        if (value === undefined || value === null) {
+            continue;
+        }
+        if (!schemaTypeMatches(property.type, value)) {
+            const expectedType = property.type ?? 'declared schema type';
+            issues.push(`${input.surface} config key ${key} must be a ${expectedType}.`);
+            continue;
+        }
+        if (property.enum && !property.enum.some((entry) => entry === value)) {
+            issues.push(`${input.surface} config key ${key} must be one of: ${property.enum.map((entry) => String(entry)).join(', ')}.`);
+        }
+    }
+    return issues;
+}
+export function coerceSurfaceConfigInput(input) {
+    if (!input.schema?.properties) {
+        return input.rawValue;
+    }
+    const property = input.schema.properties[input.key];
+    if (!property) {
+        throw new Error(`Unknown ${input.surface} config key ${input.key} for ${input.packageId}.`);
+    }
+    const required = new Set(input.schema.required ?? []);
+    const trimmed = input.rawValue.trim();
+    if (required.has(input.key) && trimmed.length === 0) {
+        throw new Error(`${input.surface} config key ${input.key} is required.`);
+    }
+    let value = input.rawValue;
+    if (property.type === 'boolean') {
+        if (trimmed === 'true') {
+            value = true;
+        }
+        else if (trimmed === 'false') {
+            value = false;
+        }
+        else {
+            throw new Error(`${input.surface} config key ${input.key} must be "true" or "false".`);
+        }
+    }
+    else if (property.type === 'number') {
+        const parsed = Number(trimmed);
+        if (!Number.isFinite(parsed)) {
+            throw new Error(`${input.surface} config key ${input.key} must be a finite number.`);
+        }
+        value = parsed;
+    }
+    if (property.enum && !property.enum.some((entry) => entry === value)) {
+        throw new Error(`${input.surface} config key ${input.key} must be one of: ${property.enum.map((entry) => String(entry)).join(', ')}.`);
+    }
+    return value;
+}
+export function evaluateRuntimeStartability(config, inventory) {
+    const desired = desiredStateFromConfig(config);
+    const installedLookup = buildInstalledLookup(inventory);
+    const issueSet = new Set();
+    const issues = [];
+    const addIssue = (issue) => {
+        if (!issueSet.has(issue)) {
+            issueSet.add(issue);
+            issues.push(issue);
+        }
+    };
+    const activeTransport = activatedPackageForUniqueKey(desired.activated, 'transport');
+    const activeProvider = activatedPackageForUniqueKey(desired.activated, 'provider');
+    const activeApiAdapter = activatedPackageForUniqueKey(desired.activated, 'api-adapter');
+    if (!activeTransport) {
+        addIssue('No transport package is activated.');
+    }
+    else if (!installedLookup.transport.has(activeTransport.packageId)) {
+        addIssue(`Activated transport package ${activeTransport.packageId} is not installed.`);
+    }
+    if (!activeProvider) {
+        addIssue('No provider package is activated.');
+    }
+    else if (!installedLookup.provider.has(activeProvider.packageId)) {
+        addIssue(`Activated provider package ${activeProvider.packageId} is not installed.`);
+    }
+    if (!activeApiAdapter) {
+        addIssue('No API adapter package is activated.');
+    }
+    const dependencyErrors = resolvePackageDependencyErrors({
+        installed: inventory.installed,
+        desired,
+        applied: inventory.applied
+    });
+    for (const error of dependencyErrors) {
+        addIssue(error.detail);
+    }
+    for (const ref of desired.activated) {
+        if (isBuiltInActivatedPackage(ref)) {
+            continue;
+        }
+        if (!installedLookup[ref.surface].has(ref.packageId)) {
+            addIssue(`Activated ${ref.surface} package ${ref.packageId} is not installed.`);
+        }
+    }
+    if (activeApiAdapter && (installedLookup['api-adapter'].has(activeApiAdapter.packageId) || isBuiltInActivatedPackage(activeApiAdapter))) {
+        const schema = resolvePackageConfigSchema({
+            runtimeRoot: config.runtimeRoot,
+            surface: 'api-adapter',
+            packageId: activeApiAdapter.packageId
+        });
+        for (const issue of validateSurfaceConfigAgainstSchema({
+            surface: 'api-adapter',
+            packageId: activeApiAdapter.packageId,
+            schema,
+            config: effectiveSurfaceConfig(config, 'api-adapter', activeApiAdapter.packageId),
+            allowUnknownConfigKeys: isBuiltInActivatedPackage(activeApiAdapter)
+        })) {
+            addIssue(issue);
+        }
+        if (activeApiAdapter.packageId === 'official/http') {
+            try {
+                configuredApiAdapterConfig(config, activeApiAdapter.packageId);
+            }
+            catch (error) {
+                addIssue(error instanceof Error ? error.message : String(error));
+            }
+        }
+    }
+    if (activeTransport && installedLookup.transport.has(activeTransport.packageId)) {
+        const schema = resolvePackageConfigSchema({
+            runtimeRoot: config.runtimeRoot,
+            surface: 'transport',
+            packageId: activeTransport.packageId
+        });
+        for (const issue of validateSurfaceConfigAgainstSchema({
+            surface: 'transport',
+            packageId: activeTransport.packageId,
+            schema,
+            config: effectiveSurfaceConfig(config, 'transport', activeTransport.packageId)
+        })) {
+            addIssue(issue);
+        }
+    }
+    if (activeProvider && installedLookup.provider.has(activeProvider.packageId)) {
+        const schema = resolvePackageConfigSchema({
+            runtimeRoot: config.runtimeRoot,
+            surface: 'provider',
+            packageId: activeProvider.packageId
+        });
+        for (const issue of validateSurfaceConfigAgainstSchema({
+            surface: 'provider',
+            packageId: activeProvider.packageId,
+            schema,
+            config: effectiveSurfaceConfig(config, 'provider', activeProvider.packageId)
+        })) {
+            addIssue(issue);
+        }
+    }
+    return {
+        startable: issues.length === 0,
+        issues
+    };
+}
+//# sourceMappingURL=runtimeStartability.js.map

package/dist/core/extension/packages/runtimeStartability.js.map

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

package/dist/core/extension/plugins/pluginHost.d.ts

@@ -0,0 +1,50 @@
+import type { RuntimeActionDefinition, RuntimeTransportEvent } from '../../../types/transport.js';
+import type { AfterAgentResponseInput, BeforeAgentPromptInput, RuntimeActionDispatchResult, RuntimeManagementContribution, RuntimePlugin, RuntimePluginContext, RuntimeToolContext, RuntimeToolDefinition } from '../../../types/plugin.js';
+import type { ProviderRuntimeEvent } from '../../../types/runtime.js';
+import type { RuntimeActivityRecord } from '../../system/projection/runtimeActivityStore.js';
+import type { RuntimeDomainEvent, RuntimeReceiptRecord } from '../../runtime/execution/runtimeDomain.js';
+type ActionEvent = Extract<RuntimeTransportEvent, {
+    type: 'action.invoked';
+}>;
+type PluginHookName = 'onRuntimeStarted' | 'onTransportEvent' | 'onAction' | 'beforeAgentPrompt' | 'afterAgentResponse' | 'onRuntimeEvent' | 'onDomainEvent' | 'onRuntimeReceipt' | 'onRuntimeActivity';
+export interface PluginHookFailureRecord {
+    pluginId: string;
+    hook: PluginHookName;
+    error: string;
+    timeout: boolean;
+    timeoutMs: number;
+    durationMs: number;
+}
+interface PluginHostOptions {
+    hookTimeoutMs?: number;
+    onHookFailure?(failure: PluginHookFailureRecord): void;
+}
+export declare class PluginHost {
+    private readonly plugins;
+    private readonly hookTimeoutMs;
+    private readonly onHookFailure;
+    constructor(plugins: RuntimePlugin[], options?: PluginHostOptions);
+    listActions(contextFactory: (pluginId: string) => RuntimePluginContext): RuntimeActionDefinition[];
+    listManagementContributions(contextFactory: (pluginId: string) => RuntimePluginContext): RuntimeManagementContribution[];
+    listTools(contextFactory: (pluginId: string) => RuntimeToolContext): RuntimeToolDefinition[];
+    onRuntimeStarted(contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    handleTransportEvent(event: RuntimeTransportEvent, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<RuntimeActionDispatchResult>;
+    handleAction(event: ActionEvent, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<RuntimeActionDispatchResult>;
+    executeAction(actionId: string, input: Record<string, unknown>, actor: {
+        scopeId: string;
+        spaceId?: string;
+        actorId: string;
+        displayName?: string;
+    }, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<RuntimeActionDispatchResult>;
+    beforeAgentPrompt(input: BeforeAgentPromptInput, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<string[]>;
+    afterAgentResponse(input: AfterAgentResponseInput, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    onRuntimeEvent(event: ProviderRuntimeEvent, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    onDomainEvent(event: RuntimeDomainEvent, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    onRuntimeReceipt(receipt: RuntimeReceiptRecord, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    onRuntimeActivity(activity: RuntimeActivityRecord, contextFactory: (pluginId: string) => RuntimePluginContext): Promise<void>;
+    private runHook;
+    private runRequiredHook;
+    private runWithTimeout;
+    private reportHookFailure;
+}
+export {};