@xemahq/biome-sdk 0.1.1

package/dist/host/lib/default-state.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultEnabledFor = defaultEnabledFor;
+function defaultEnabledFor(manifest) {
+    const xema = manifest.xema;
+    if (xema.mandatory === true)
+        return true;
+    if (xema.scope === 'kernel')
+        return true;
+    if (xema.scope === 'system')
+        return true;
+    if (xema.scope === 'base')
+        return true;
+    if (xema.scope === 'platform')
+        return true;
+    if (xema.scope === 'third-party')
+        return false;
+    return false;
+}
+//# sourceMappingURL=default-state.js.map

package/dist/host/lib/default-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-state.js","sourceRoot":"","sources":["../../../src/host/lib/default-state.ts"],"names":[],"mappings":";;AA8BA,8CASC;AATD,SAAgB,iBAAiB,CAAC,QAAuB;IACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/host/lib/integration-cross-validate.d.ts

@@ -0,0 +1,12 @@
+import type { ServerBiomeManifest } from './biome-manifest';
+export interface ShippedWorkflowSummary {
+    readonly id: string;
+    readonly webhookEvents: readonly string[];
+    readonly requiredAdapterKinds: readonly string[];
+}
+export declare class IntegrationCrossValidationError extends Error {
+    readonly issues: readonly string[];
+    constructor(biomeId: string, issues: readonly string[]);
+}
+export declare function crossValidateIntegrationContract(manifest: ServerBiomeManifest, workflows: readonly ShippedWorkflowSummary[]): void;
+//# sourceMappingURL=integration-cross-validate.d.ts.map

package/dist/host/lib/integration-cross-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-cross-validate.d.ts","sourceRoot":"","sources":["../../../src/host/lib/integration-cross-validate.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,kBAAkB,CAAC;AAQ3E,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAK1C,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAED,qBAAa,+BAAgC,SAAQ,KAAK;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;gBACvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE;CAOvD;AAqBD,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,SAAS,sBAAsB,EAAE,GAC3C,IAAI,CA6CN"}

package/dist/host/lib/integration-cross-validate.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IntegrationCrossValidationError = void 0;
+exports.crossValidateIntegrationContract = crossValidateIntegrationContract;
+const connector_1 = require("@xemahq/kernel-contracts/connector");
+class IntegrationCrossValidationError extends Error {
+    issues;
+    constructor(biomeId, issues) {
+        super(`biome "${biomeId}": integration cross-validation failed:\n  - ${issues.join('\n  - ')}`);
+        this.name = 'IntegrationCrossValidationError';
+        this.issues = issues;
+    }
+}
+exports.IntegrationCrossValidationError = IntegrationCrossValidationError;
+function crossValidateIntegrationContract(manifest, workflows) {
+    const issues = [];
+    const requirements = manifest.xema.integrationRequirements ?? [];
+    const webhookFilters = manifest.xema.webhookFilters ?? [];
+    const requirementKinds = new Set(requirements.map((r) => r.adapterKind));
+    const workflowsById = new Map(workflows.map((w) => [w.id, w]));
+    for (const workflow of workflows) {
+        for (const kind of workflow.requiredAdapterKinds) {
+            if (!requirementKinds.has(kind)) {
+                issues.push(`workflow "${workflow.id}" declares requires.integrations.adapterKind="${kind}" ` +
+                    `but the manifest does not list it under integrationRequirements`);
+            }
+        }
+    }
+    for (const filter of webhookFilters) {
+        const workflow = workflowsById.get(filter.workflowId);
+        if (!workflow) {
+            issues.push(`webhookFilters entry references workflowId="${filter.workflowId}" ` +
+                `which is not among the shipped workflows`);
+            continue;
+        }
+        if (!workflow.webhookEvents.includes(filter.event)) {
+            issues.push(`webhookFilters entry for workflow "${filter.workflowId}" references event="${filter.event}" ` +
+                `which is not declared under that workflow's on.webhook[].event set ` +
+                `(known events: ${workflow.webhookEvents.join(', ') || '(none)'})`);
+        }
+        collectPredicatePathIssues(filter, workflow.requiredAdapterKinds, issues);
+    }
+    if (issues.length > 0) {
+        throw new IntegrationCrossValidationError(manifest.xema.id, issues);
+    }
+}
+function collectPredicatePathIssues(filter, requiredAdapterKinds, issues) {
+    if (requiredAdapterKinds.length === 0)
+        return;
+    const entityKind = filter.entityKind;
+    const paths = (0, connector_1.collectFilterExprPathRefs)(filter.predicate);
+    for (const ref of paths) {
+        if (ref.source !== '$envelope')
+            continue;
+        const acceptedBy = requiredAdapterKinds.filter((kind) => (0, connector_1.isAllowedEnvelopePath)(kind, ref.path, entityKind));
+        if (acceptedBy.length === 0) {
+            const scope = entityKind
+                ? `(adapterKind in [${requiredAdapterKinds.join(', ')}], entityKind="${entityKind}")`
+                : `any required adapterKind (${requiredAdapterKinds.join(', ')})`;
+            issues.push(`webhookFilters entry for workflow "${filter.workflowId}" event="${filter.event}" ` +
+                `references $envelope.${ref.path} which is not a known field on the canonical ` +
+                `envelope for ${scope}`);
+        }
+    }
+}
+//# sourceMappingURL=integration-cross-validate.js.map

package/dist/host/lib/integration-cross-validate.js.map

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

package/dist/host/lib/system-overlay-contribution.d.ts

@@ -0,0 +1,14 @@
+export interface SystemOverlayRunContext {
+    readonly orgId: string;
+    readonly projectId: string | null;
+    readonly role: string;
+    readonly surface: string;
+    readonly phaseKey: string | null;
+    readonly runId: string | null;
+}
+export interface SystemOverlayContribution {
+    readonly id: string;
+    readonly priority: number;
+    readonly render: (ctx: SystemOverlayRunContext) => string | null;
+}
+//# sourceMappingURL=system-overlay-contribution.d.ts.map

package/dist/host/lib/system-overlay-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-overlay-contribution.d.ts","sourceRoot":"","sources":["../../../src/host/lib/system-overlay-contribution.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAUD,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAMpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,MAAM,GAAG,IAAI,CAAC;CAClE"}

package/dist/host/lib/system-overlay-contribution.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=system-overlay-contribution.js.map

package/dist/host/lib/system-overlay-contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-overlay-contribution.js","sourceRoot":"","sources":["../../../src/host/lib/system-overlay-contribution.ts"],"names":[],"mappings":""}

package/dist/host/lib/topology.d.ts

@@ -0,0 +1,7 @@
+import type { BiomeManifest, ServerBiomeManifest } from './biome-manifest';
+export declare const TIER_ORDER: Readonly<Record<string, number>>;
+export declare function findIllegalDependencies(manifest: ServerBiomeManifest, allManifestsById: ReadonlyMap<string, ServerBiomeManifest>): string[];
+export declare function topoSortServerBiomes(manifestsById: ReadonlyMap<string, ServerBiomeManifest>): string[];
+export declare function validateServerDependencies(manifestsById: ReadonlyMap<string, ServerBiomeManifest>): void;
+export declare function validateWebToServerCrossDeps(webManifestsById: ReadonlyMap<string, BiomeManifest>, serverIds: ReadonlySet<string>): void;
+//# sourceMappingURL=topology.d.ts.map

package/dist/host/lib/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../../src/host/lib/topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAc3E,eAAO,MAAM,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvD,CAAC;AAiCF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,mBAAmB,EAC7B,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACzD,MAAM,EAAE,CAaV;AAUD,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACtD,MAAM,EAAE,CAmCV;AAMD,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACtD,IAAI,CAqBN;AAYD,wBAAgB,4BAA4B,CAC1C,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,EACpD,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,IAAI,CAaN"}

package/dist/host/lib/topology.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIER_ORDER = void 0;
+exports.findIllegalDependencies = findIllegalDependencies;
+exports.topoSortServerBiomes = topoSortServerBiomes;
+exports.validateServerDependencies = validateServerDependencies;
+exports.validateWebToServerCrossDeps = validateWebToServerCrossDeps;
+exports.TIER_ORDER = {
+    kernel: 0,
+    system: 1,
+    base: 2,
+    platform: 3,
+    'third-party': 4,
+};
+const ALLOWED_DEPENDENCY_SCOPES = {
+    kernel: new Set(['kernel']),
+    system: new Set(['kernel', 'system']),
+    base: new Set(['kernel', 'system', 'base']),
+    platform: new Set(['kernel', 'system', 'base', 'platform']),
+    'third-party': new Set(['kernel', 'system', 'base', 'platform', 'third-party']),
+};
+function findIllegalDependencies(manifest, allManifestsById) {
+    const allowed = ALLOWED_DEPENDENCY_SCOPES[manifest.xema.scope];
+    if (!allowed)
+        return [];
+    const deps = manifest.xema.dependencies ?? [];
+    const illegal = [];
+    for (const depId of deps) {
+        const dep = allManifestsById.get(depId);
+        if (!dep)
+            continue;
+        if (!allowed.has(dep.xema.scope)) {
+            illegal.push(depId);
+        }
+    }
+    return illegal;
+}
+function topoSortServerBiomes(manifestsById) {
+    const visited = new Set();
+    const visiting = new Set();
+    const result = [];
+    function visit(id, stack) {
+        if (visited.has(id))
+            return;
+        if (visiting.has(id)) {
+            throw new Error(`biome-host: dependency cycle detected: ${[...stack, id].join(' → ')}`);
+        }
+        const m = manifestsById.get(id);
+        if (!m)
+            return;
+        visiting.add(id);
+        for (const depId of m.xema.dependencies ?? []) {
+            visit(depId, [...stack, id]);
+        }
+        visiting.delete(id);
+        visited.add(id);
+        result.push(id);
+    }
+    const ids = Array.from(manifestsById.keys()).sort((a, b) => {
+        const ma = manifestsById.get(a);
+        const mb = manifestsById.get(b);
+        if (!ma || !mb)
+            return a.localeCompare(b);
+        const ta = exports.TIER_ORDER[ma.xema.scope] ?? 99;
+        const tb = exports.TIER_ORDER[mb.xema.scope] ?? 99;
+        if (ta !== tb)
+            return ta - tb;
+        return a.localeCompare(b);
+    });
+    for (const id of ids)
+        visit(id, []);
+    return result;
+}
+function validateServerDependencies(manifestsById) {
+    for (const manifest of manifestsById.values()) {
+        const deps = manifest.xema.dependencies ?? [];
+        for (const depId of deps) {
+            if (!manifestsById.has(depId)) {
+                throw new Error(`biome-host: server biome "${manifest.xema.id}" declares dependency "${depId}" ` +
+                    `which is not registered. Known server biomes: [${Array.from(manifestsById.keys()).join(', ')}].`);
+            }
+        }
+        const illegal = findIllegalDependencies(manifest, manifestsById);
+        if (illegal.length > 0) {
+            const scope = manifest.xema.scope;
+            const allowed = Array.from(ALLOWED_DEPENDENCY_SCOPES[scope] ?? []).join(', ');
+            throw new Error(`biome-host: ${scope} biome "${manifest.xema.id}" depends on biomes with disallowed scope ` +
+                `[${illegal.join(', ')}]. A ${scope} biome may only depend on biomes with scope: [${allowed}].`);
+        }
+    }
+}
+function validateWebToServerCrossDeps(webManifestsById, serverIds) {
+    for (const manifest of webManifestsById.values()) {
+        if (manifest.xema.target !== 'web')
+            continue;
+        const refs = manifest.xema.requiresServerBiomes ?? [];
+        for (const ref of refs) {
+            if (!serverIds.has(ref)) {
+                throw new Error(`biome-host: web biome "${manifest.xema.id}" requires server biome "${ref}" ` +
+                    `which is not registered. Known server biomes: [${Array.from(serverIds).join(', ')}].`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=topology.js.map

package/dist/host/lib/topology.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from '@xemahq/kernel-contracts/contribution';
+export * from '@xemahq/kernel-contracts/capability';
+export { XemaObjectKind, ObjectLifecycle, ObjectLifecycleSchema, XemaObjectRefSchema, xemaObjectSchema, XemaObjectRefParseError, parseXemaObjectRef, formatXemaObjectRef, SubjectRefSchema as XsiSubjectRefSchema, } from '@xemahq/kernel-contracts/object';
+export type { XemaObjectRef, XemaObjectRefParts, XemaObject, SubjectRef as XsiSubjectRef, } from '@xemahq/kernel-contracts/object';
+export { SpaceKind, SpaceKindSchema, SpaceRefSchema, spaceRefToPath, } from '@xemahq/kernel-contracts/space';
+export type { SpaceRef } from '@xemahq/kernel-contracts/space';
+export * from '@xemahq/kernel-contracts/biome';
+export * from '@xemahq/kernel-contracts/execution-environment';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0BA,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AAKpD,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,IAAI,mBAAmB,GACxC,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,UAAU,EACV,UAAU,IAAI,aAAa,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gDAAgD,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spaceRefToPath = exports.SpaceRefSchema = exports.SpaceKindSchema = exports.SpaceKind = exports.XsiSubjectRefSchema = exports.formatXemaObjectRef = exports.parseXemaObjectRef = exports.XemaObjectRefParseError = exports.xemaObjectSchema = exports.XemaObjectRefSchema = exports.ObjectLifecycleSchema = exports.ObjectLifecycle = exports.XemaObjectKind = void 0;
+__exportStar(require("@xemahq/kernel-contracts/contribution"), exports);
+__exportStar(require("@xemahq/kernel-contracts/capability"), exports);
+var object_1 = require("@xemahq/kernel-contracts/object");
+Object.defineProperty(exports, "XemaObjectKind", { enumerable: true, get: function () { return object_1.XemaObjectKind; } });
+Object.defineProperty(exports, "ObjectLifecycle", { enumerable: true, get: function () { return object_1.ObjectLifecycle; } });
+Object.defineProperty(exports, "ObjectLifecycleSchema", { enumerable: true, get: function () { return object_1.ObjectLifecycleSchema; } });
+Object.defineProperty(exports, "XemaObjectRefSchema", { enumerable: true, get: function () { return object_1.XemaObjectRefSchema; } });
+Object.defineProperty(exports, "xemaObjectSchema", { enumerable: true, get: function () { return object_1.xemaObjectSchema; } });
+Object.defineProperty(exports, "XemaObjectRefParseError", { enumerable: true, get: function () { return object_1.XemaObjectRefParseError; } });
+Object.defineProperty(exports, "parseXemaObjectRef", { enumerable: true, get: function () { return object_1.parseXemaObjectRef; } });
+Object.defineProperty(exports, "formatXemaObjectRef", { enumerable: true, get: function () { return object_1.formatXemaObjectRef; } });
+Object.defineProperty(exports, "XsiSubjectRefSchema", { enumerable: true, get: function () { return object_1.SubjectRefSchema; } });
+var space_1 = require("@xemahq/kernel-contracts/space");
+Object.defineProperty(exports, "SpaceKind", { enumerable: true, get: function () { return space_1.SpaceKind; } });
+Object.defineProperty(exports, "SpaceKindSchema", { enumerable: true, get: function () { return space_1.SpaceKindSchema; } });
+Object.defineProperty(exports, "SpaceRefSchema", { enumerable: true, get: function () { return space_1.SpaceRefSchema; } });
+Object.defineProperty(exports, "spaceRefToPath", { enumerable: true, get: function () { return space_1.spaceRefToPath; } });
+__exportStar(require("@xemahq/kernel-contracts/biome"), exports);
+__exportStar(require("@xemahq/kernel-contracts/execution-environment"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA0BA,wEAAsD;AACtD,sEAAoD;AAKpD,0DAUyC;AATvC,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,+GAAA,qBAAqB,OAAA;AACrB,6GAAA,mBAAmB,OAAA;AACnB,0GAAA,gBAAgB,OAAA;AAChB,iHAAA,uBAAuB,OAAA;AACvB,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAuB;AAQzC,wDAKwC;AAJtC,kGAAA,SAAS,OAAA;AACT,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,uGAAA,cAAc,OAAA;AAGhB,iEAA+C;AAC/C,iFAA+D"}

package/dist/orchestrator-adapter/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/orchestrator-adapter';
+export * from './lib/orchestrator-adapter-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestrator-adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestrator-adapter/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC"}

package/dist/orchestrator-adapter/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/orchestrator-adapter"), exports);
+__exportStar(require("./lib/orchestrator-adapter-registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/orchestrator-adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestrator-adapter/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,sEAAoD"}

package/dist/orchestrator-adapter/lib/orchestrator-adapter-registry.d.ts

@@ -0,0 +1,6 @@
+import { Registry } from '@xemahq/registry';
+import type { OrchestratorAdapterRegistration } from './orchestrator-adapter';
+export declare class OrchestratorAdapterRegistry extends Registry<string, OrchestratorAdapterRegistration> {
+    constructor(seed?: readonly OrchestratorAdapterRegistration[]);
+}
+//# sourceMappingURL=orchestrator-adapter-registry.d.ts.map

package/dist/orchestrator-adapter/lib/orchestrator-adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-adapter-registry.d.ts","sourceRoot":"","sources":["../../../src/orchestrator-adapter/lib/orchestrator-adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AAE9E,qBAAa,2BAA4B,SAAQ,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;gBACpF,IAAI,CAAC,EAAE,SAAS,+BAA+B,EAAE;CAG9D"}

package/dist/orchestrator-adapter/lib/orchestrator-adapter-registry.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestratorAdapterRegistry = void 0;
+const registry_1 = require("@xemahq/registry");
+class OrchestratorAdapterRegistry extends registry_1.Registry {
+    constructor(seed) {
+        super(seed ? { name: 'OrchestratorAdapterRegistry', seed } : { name: 'OrchestratorAdapterRegistry' });
+    }
+}
+exports.OrchestratorAdapterRegistry = OrchestratorAdapterRegistry;
+//# sourceMappingURL=orchestrator-adapter-registry.js.map

package/dist/orchestrator-adapter/lib/orchestrator-adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-adapter-registry.js","sourceRoot":"","sources":["../../../src/orchestrator-adapter/lib/orchestrator-adapter-registry.ts"],"names":[],"mappings":";;;AAAA,+CAA4C;AAG5C,MAAa,2BAA4B,SAAQ,mBAAiD;IAChG,YAAY,IAAiD;QAC3D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,6BAA6B,EAAE,CAAC,CAAC;IACxG,CAAC;CACF;AAJD,kEAIC"}

package/dist/orchestrator-adapter/lib/orchestrator-adapter.d.ts

@@ -0,0 +1,11 @@
+export interface OrchestratorAdapter<TInvocationContext = unknown, TInvocationResult = unknown> {
+    readonly id: string;
+    readonly displayName: string;
+    invoke(ctx: TInvocationContext): Promise<TInvocationResult>;
+}
+export interface OrchestratorAdapterRegistration {
+    readonly key: string;
+    readonly displayName: string;
+    readonly create: () => OrchestratorAdapter;
+}
+//# sourceMappingURL=orchestrator-adapter.d.ts.map

package/dist/orchestrator-adapter/lib/orchestrator-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-adapter.d.ts","sourceRoot":"","sources":["../../../src/orchestrator-adapter/lib/orchestrator-adapter.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,mBAAmB,CAAC,kBAAkB,GAAG,OAAO,EAAE,iBAAiB,GAAG,OAAO;IAC5F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,mBAAmB,CAAC;CAC5C"}

package/dist/orchestrator-adapter/lib/orchestrator-adapter.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=orchestrator-adapter.js.map

package/dist/orchestrator-adapter/lib/orchestrator-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-adapter.js","sourceRoot":"","sources":["../../../src/orchestrator-adapter/lib/orchestrator-adapter.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@xemahq/biome-sdk",
+  "version": "0.1.1",
+  "description": "Consolidated biome-authoring SDK for Xema. One package, per-surface subpath exports: the root meta-import re-exports every kernel contract a biome author needs; `./builder` is the defineBiome entry; `./host` ships framework-agnostic host primitives; `./api` (+ `./api/nest`) ships HTTP-API presets; `./adapter` the integration-adapter contract; `./orchestrator-adapter` and `./agent-workspace` the orchestrator/workspace adapter SDKs.",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@nestjs/common": "11.1.13",
+    "@nestjs/core": "11.1.13",
+    "@nestjs/swagger": "11.2.6",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "25.2.3",
+    "prettier": "3.6.2",
+    "reflect-metadata": "0.2.2",
+    "typescript": "5.9.3"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "11.1.13",
+    "@nestjs/core": "11.1.13",
+    "@nestjs/swagger": "11.2.6",
+    "@xemahq/event-hub-client": "^8.3.1",
+    "@xemahq/events": "^0.1.1",
+    "reflect-metadata": "0.2.2"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    },
+    "@nestjs/swagger": {
+      "optional": true
+    },
+    "@xemahq/event-hub-client": {
+      "optional": true
+    },
+    "@xemahq/events": {
+      "optional": true
+    },
+    "reflect-metadata": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@xemahq/kernel-contracts": "^0.2.0",
+    "js-yaml": "^4.1.0",
+    "zod": "^4.3.6",
+    "@xemahq/registry": "0.1.1"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "xema-source": "./src/*/index.ts",
+      "default": "./dist/*/index.js"
+    },
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "builder": [
+        "./dist/builder/index.d.ts"
+      ],
+      "host": [
+        "./dist/host/index.d.ts"
+      ],
+      "api": [
+        "./dist/api/index.d.ts"
+      ],
+      "api/nest": [
+        "./dist/api/nest/index.d.ts"
+      ],
+      "adapter": [
+        "./dist/adapter/index.d.ts"
+      ],
+      "orchestrator-adapter": [
+        "./dist/orchestrator-adapter/index.d.ts"
+      ],
+      "agent-workspace": [
+        "./dist/agent-workspace/index.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}

package/src/adapter/index.ts

@@ -0,0 +1,6 @@
+export * from './lib/action';
+export * from './lib/provider-module';
+export * from './lib/resource';
+export * from './lib/result';
+export * from './lib/sidecar-contract';
+export * from './lib/webhook';

package/src/adapter/lib/action.ts

@@ -0,0 +1,60 @@
+import type { MintedToken } from '@xemahq/kernel-contracts/connector';
+
+import type { Result } from './result';
+
+/**
+ * Outbound-action contract. A workflow activity that needs to "post
+ * a PR comment", "create an issue", "send a message" calls
+ * `POST /adapters/:provider/actions/:action` on the registry; the
+ * registry resolves credentials via `/credentials/resolve` (Phase 6)
+ * and invokes the matching handler.
+ *
+ * `schema` is the input contract (JSON Schema). The registry validates
+ * `params` against this BEFORE invoking `execute`, so handlers can
+ * assume well-formed input. Biomes ship the schema as part of their
+ * manifest content so the workflow DSL compiler can also do compile-
+ * time validation of action calls.
+ *
+ * No provider SDK imports in biome workflow code — activities always
+ * go through this registry-mediated path.
+ */
+export interface OutboundActionHandler {
+  readonly action: string;
+  readonly schema: JsonSchemaLike;
+  execute(input: OutboundActionInput): Promise<Result<OutboundActionResult>>;
+}
+
+export interface OutboundActionInput {
+  readonly credential: MintedToken;
+  readonly params: Readonly<Record<string, unknown>>;
+}
+
+export interface OutboundActionResult {
+  /** Provider-native id of the entity created/updated by the action. */
+  readonly externalId?: string;
+  /**
+   * Free-form structured result the workflow can read via
+   * `${{ steps.<id>.outputs.<field> }}` bindings. Keep keys closed
+   * inside each biome — DSL compile-time validation drives off the
+   * schema below.
+   */
+  readonly outputs?: Readonly<Record<string, unknown>>;
+}
+
+/**
+ * Structural subtype of a JSON Schema object that captures what the
+ * adapter-sdk needs at the contract layer. We intentionally do NOT
+ * pull in `@types/json-schema` or `ajv` types here — Kernel rule:
+ * adapter-sdk has zero runtime deps beyond `integration-contracts`.
+ * Domain code that needs richer validation casts to a concrete JSON
+ * Schema type at the consumer boundary.
+ */
+export interface JsonSchemaLike {
+  readonly $id?: string;
+  readonly type?: 'object' | 'string' | 'number' | 'boolean' | 'array';
+  readonly properties?: Readonly<Record<string, JsonSchemaLike>>;
+  readonly required?: readonly string[];
+  readonly items?: JsonSchemaLike;
+  readonly enum?: readonly (string | number | boolean | null)[];
+  readonly description?: string;
+}