@xemahq/agent-session-runtime 0.6.6 → 0.6.7

package/LICENSE

@@ -1,175 +1,176 @@
-Xema Business Source License 1.1
-
-License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
-"Business Source License" is a trademark of MariaDB Corporation Ab.
-
------------------------------------------------------------------------------
-
-Parameters
-
-Licensor:  Neuralchowder Inc.
-
-Licensed Work:  Xema. The Licensed Work is (c) 2026 Neuralchowder Inc..
-
-  The Licensed Work includes, without limitation, Xema Core, Xema Runtime,
-  Xema Kernel, Xema control plane, Xema application runtime, Xema biome
-  runtime, Xema biome registry, Xema store services, Xema orchestration
-  services, Xema agents, Xema skills, Xema memory services, Xema APIs, Xema
-  user interfaces, Xema command-line tools, Xema deployment artifacts, Xema
-  templates, Xema specifications, Xema schemas, Xema manifests, Xema
-  documentation, Xema examples, and all source code, object code, binaries,
-  packages, modules, configuration files, manifests, schemas, examples,
-  templates, documentation, and derivative works included in or distributed
-  as part of the Xema software project.
-
-  The Licensed Work does not include any third-party software, libraries,
-  dependencies, packages, assets, or components that are distributed with the
-  Licensed Work but are governed by their own separate license terms. Such
-  third-party materials remain subject to their respective licenses.
-
-  A specific file, package, component, or directory may state that it is
-  governed by a different license. In that case, that specific file, package,
-  component, or directory is governed by the license expressly stated therein.
-
-Additional Use Grant:
-
-  You may make production use of the Licensed Work, provided that your use
-  does not include offering, providing, making available, distributing,
-  hosting, managing, embedding, reselling, white-labeling, sublicensing,
-  commercializing, or otherwise making the Licensed Work, or any modified
-  version or derivative work of the Licensed Work, available to Third Parties
-  as part of a Competitive Offering.
-
-The following definitions and clarifications form part of, and govern
-the interpretation of, the Additional Use Grant set out above.
-
-  1. "Production Use" means any use of the Licensed Work other than for
-     development, testing, evaluation, demonstration, experimentation,
-     benchmarking, or other non-production purposes.
-
-  2. "Affiliate" means any entity that, directly or indirectly,
-     controls, is controlled by, or is under common control with you,
-     where "control" means ownership of more than fifty percent (50%) of
-     the voting interests of the entity, or the power to direct its
-     management.
-
-  3. "Third Party" means any natural person or legal entity other than
-     you and your Affiliates.
-
-  4. "Competitive Offering" means any product or service, made available
-     to one or more Third Parties for a fee or other consideration
-     (including without limitation on a paid, subscription,
-     advertising-supported, hosted, or managed-service basis), that is
-     offered or marketed as, or that competes with, a software platform,
-     runtime, orchestration system, agent or automation system,
-     extension or distribution marketplace, or other software system
-     that provides, in substantial part, the same or substantially
-     similar capabilities as those provided by the Licensed Work. A
-     product or service is a Competitive Offering whether the Licensed
-     Work is provided in whole or in part, alone or bundled with other
-     software, and whether modified or unmodified.
-
-  5. Providing, hosting, or managing the Licensed Work for a Third Party,
-     or otherwise making the Licensed Work available to a Third Party as
-     a hosted or managed service such that the Third Party obtains the
-     principal value or functionality of the Licensed Work, is a
-     Competitive Offering and is not permitted by the Additional Use
-     Grant.
-
-  6. Subject to the foregoing, the Additional Use Grant permits you to
-     make Production Use of the Licensed Work for your own internal
-     business purposes and to build, operate, and provide your own
-     products and services to Third Parties, provided that the Licensed
-     Work itself (whether modified or unmodified) is not the product or
-     service, and is not a Competitive Offering, made available to those
-     Third Parties.
-
-  7. You may modify the Licensed Work and create derivative works for
-     any purpose permitted by this License. Any Production Use of such
-     modified or derivative works remains subject to the same
-     restrictions as the Licensed Work, including the prohibition on
-     Competitive Offerings.
-
-  8. Use of the Licensed Work by your own employees, contractors, and
-     agents, acting on your behalf and for your benefit, is not by
-     itself making the Licensed Work available to a Third Party.
-
-  9. Embedding or distributing the Licensed Work as a component of your
-     own product or service is permitted only where the Licensed Work
-     does not constitute the principal value of that product or service
-     and the product or service is not a Competitive Offering.
-
-  10. Nothing in this Additional Use Grant grants any right to use any
-      name, trademark, service mark, or logo of the Licensor or its
-      Affiliates, except as reasonably required for customary
-      attribution.
-
-  11. The rights stated in this Additional Use Grant are the maximum
-      rights granted for Production Use prior to the Change Date. Any
-      Production Use not expressly permitted requires a separate
-      commercial license from the Licensor.
-
-  12. If any provision of this Additional Use Grant is held invalid or
-      unenforceable, that provision shall be limited or eliminated to
-      the minimum extent necessary so that the remainder of this
-      Additional Use Grant, and of this License, remains in full force
-      and effect. The Licensor reserves all rights not expressly granted
-      by this License.
-
-
-Change Date:  Four years from the date the specific version of the Licensed
-  Work is first publicly released by Licensor.
-
-Change License:  Mozilla Public License, Version 2.0
-
-For information about alternative licensing arrangements, commercial
-licensing, enterprise licensing, OEM licensing, appliance licensing, managed
-service licensing, cloud provider licensing, or other commercial use of the
-Licensed Work, please contact: licensing@neuralchowder.com
-
------------------------------------------------------------------------------
-
-Notice
-
-Business Source License 1.1
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph above
-terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works of
-the Licensed Work, are subject to this License. This License applies separately
-for each version of the Licensed Work and the Change Date may vary for each
-version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or modified
-form from a third party, the terms and conditions set forth in this License
-apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of Licensor
-or its affiliates, provided that you may use a trademark or logo of Licensor
-as expressly required by this License.
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
-"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
-OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

package/dist/lib/composition-resolution.d.ts

@@ -0,0 +1,43 @@
+import { type ModelRef, type NodeOverlayFragment, type SubAgentBinding } from '@xemahq/kernel-contracts/workflow';
+import type { ResolvedAgent, ResolvedAgentNode } from '@xemahq/kernel-contracts/agent-composition';
+import type { PermissionMap } from '@xemahq/kernel-contracts/agent-permission';
+import { type ToolSelectionEntry } from '@xemahq/kernel-contracts/mcp-tool';
+export declare class AgentResolutionError extends Error {
+    constructor(context: string, detail: string);
+}
+export interface FlattenedAgentNode {
+    readonly slug: string;
+    readonly alias?: string;
+    readonly modelOverride?: ModelRef;
+    readonly instructions?: string;
+    readonly permission?: PermissionMap;
+}
+export interface CollectScopeOptions {
+    readonly scope?: 'tree' | 'root';
+}
+export interface RuntimeAgentConfig {
+    readonly agentRef: string;
+    readonly primaryAgentSlug: string;
+    readonly primaryInstructions: string | null;
+    readonly primaryPermission: PermissionMap | null;
+    readonly primaryModelOverride: ModelRef | null;
+    readonly subAgentBindings: readonly SubAgentBinding[];
+    readonly subAgentInstructionsBySlug: Readonly<Record<string, string>>;
+    readonly subAgentPermissionBySlug: Readonly<Record<string, PermissionMap>>;
+    readonly subAgentModelOverridesBySlug: Readonly<Record<string, ModelRef>>;
+    readonly defaultSkillSlugs: readonly string[];
+    readonly allSkillSlugs: readonly string[];
+    readonly defaultToolSelection: readonly ToolSelectionEntry[];
+}
+export declare function flattenAgentTree(root: ResolvedAgentNode): readonly FlattenedAgentNode[];
+export declare function collectSkills(root: ResolvedAgentNode, opts?: CollectScopeOptions): readonly string[];
+export declare function collectTools(root: ResolvedAgentNode, opts?: CollectScopeOptions): readonly ToolSelectionEntry[];
+export declare function collectInstructionsBySlug(root: ResolvedAgentNode): Readonly<Record<string, string>>;
+export declare function collectPermissionsBySlug(root: ResolvedAgentNode): Readonly<Record<string, PermissionMap>>;
+export declare function collectModelOverridesBySlug(root: ResolvedAgentNode): Readonly<Record<string, ModelRef>>;
+export declare function appendInstructions(baseSystemPrompt: string, nodeInstructions: string | null): string;
+export declare function normalizeInstructions(raw: string | undefined): string | null;
+export declare function normalizePermission(raw: PermissionMap | undefined): PermissionMap | null;
+export declare function projectModelOverride(raw: ModelRef | undefined, context: string): ModelRef | null;
+export declare function projectAgentToRuntimeConfig(resolved: ResolvedAgent, overlay?: NodeOverlayFragment): RuntimeAgentConfig;
+//# sourceMappingURL=composition-resolution.d.ts.map

package/dist/lib/composition-resolution.d.ts.map

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

package/dist/lib/composition-resolution.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentResolutionError = void 0;
+exports.flattenAgentTree = flattenAgentTree;
+exports.collectSkills = collectSkills;
+exports.collectTools = collectTools;
+exports.collectInstructionsBySlug = collectInstructionsBySlug;
+exports.collectPermissionsBySlug = collectPermissionsBySlug;
+exports.collectModelOverridesBySlug = collectModelOverridesBySlug;
+exports.appendInstructions = appendInstructions;
+exports.normalizeInstructions = normalizeInstructions;
+exports.normalizePermission = normalizePermission;
+exports.projectModelOverride = projectModelOverride;
+exports.projectAgentToRuntimeConfig = projectAgentToRuntimeConfig;
+const workflow_1 = require("@xemahq/kernel-contracts/workflow");
+const mcp_tool_1 = require("@xemahq/kernel-contracts/mcp-tool");
+class AgentResolutionError extends Error {
+    constructor(context, detail) {
+        super(`Agent resolution failed for "${context}": ${detail}`);
+        this.name = 'AgentResolutionError';
+    }
+}
+exports.AgentResolutionError = AgentResolutionError;
+function flattenAgentTree(root) {
+    const seen = new Set();
+    const out = [];
+    const visit = (node) => {
+        for (const child of node.children) {
+            const slug = child.kernel.slug;
+            if (slug.length === 0) {
+                continue;
+            }
+            if (!seen.has(slug)) {
+                seen.add(slug);
+                out.push({
+                    slug,
+                    ...(child.alias ? { alias: child.alias } : {}),
+                    ...(child.modelOverride
+                        ? { modelOverride: child.modelOverride }
+                        : {}),
+                    ...(child.instructions ? { instructions: child.instructions } : {}),
+                    ...(child.permission ? { permission: child.permission } : {}),
+                });
+            }
+            visit(child);
+        }
+    };
+    visit(root);
+    return out;
+}
+function collectSkills(root, opts) {
+    const scope = opts?.scope ?? 'tree';
+    const seen = new Set();
+    const out = [];
+    const addNode = (node) => {
+        for (const slug of projectSkillSlugs(node.skills)) {
+            if (!seen.has(slug)) {
+                seen.add(slug);
+                out.push(slug);
+            }
+        }
+    };
+    addNode(root);
+    if (scope === 'tree') {
+        const visit = (node) => {
+            for (const child of node.children) {
+                addNode(child);
+                visit(child);
+            }
+        };
+        visit(root);
+    }
+    return out;
+}
+function collectTools(root, opts) {
+    const scope = opts?.scope ?? 'root';
+    const ctx = root.kernel.slug;
+    if (scope === 'root') {
+        return projectToolSelection(root.tools, ctx);
+    }
+    const out = [...projectToolSelection(root.tools, ctx)];
+    const visit = (node) => {
+        for (const child of node.children) {
+            out.push(...projectToolSelection(child.tools, child.kernel.slug));
+            visit(child);
+        }
+    };
+    visit(root);
+    return out;
+}
+function collectInstructionsBySlug(root) {
+    return collectDescendantOverlay(root, (child) => normalizeInstructions(child.instructions));
+}
+function collectPermissionsBySlug(root) {
+    return collectDescendantOverlay(root, (child) => normalizePermission(child.permission));
+}
+function collectModelOverridesBySlug(root) {
+    return collectDescendantOverlay(root, (child) => projectModelOverride(child.modelOverride, child.kernel.slug));
+}
+function collectDescendantOverlay(root, project) {
+    const out = {};
+    const seen = new Set();
+    const visit = (node) => {
+        for (const child of node.children) {
+            const slug = child.kernel.slug;
+            if (slug.length === 0) {
+                continue;
+            }
+            if (!seen.has(slug)) {
+                seen.add(slug);
+                const value = project(child);
+                if (value !== null) {
+                    out[slug] = value;
+                }
+            }
+            visit(child);
+        }
+    };
+    visit(root);
+    return out;
+}
+function appendInstructions(baseSystemPrompt, nodeInstructions) {
+    const trimmed = nodeInstructions === null ? '' : nodeInstructions.trim();
+    if (trimmed.length === 0) {
+        return baseSystemPrompt;
+    }
+    if (baseSystemPrompt.length === 0) {
+        return trimmed;
+    }
+    return `${baseSystemPrompt}\n\n${trimmed}`;
+}
+function normalizeInstructions(raw) {
+    if (typeof raw !== 'string') {
+        return null;
+    }
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function normalizePermission(raw) {
+    if (!raw || typeof raw !== 'object' || Object.keys(raw).length === 0) {
+        return null;
+    }
+    return raw;
+}
+function projectModelOverride(raw, context) {
+    if (raw === undefined) {
+        return null;
+    }
+    if (raw.kind === workflow_1.ModelRefKind.CONCRETE) {
+        if (typeof raw.modelId !== 'string' || raw.modelId.trim().length === 0) {
+            throw new AgentResolutionError(context, 'concrete modelOverride is missing a modelId');
+        }
+        return raw;
+    }
+    const modelClass = raw.modelClass;
+    if (modelClass === undefined ||
+        !workflow_1.MODEL_CLASS_VALUES.includes(modelClass)) {
+        throw new AgentResolutionError(context, `strategy modelOverride.modelClass must be one of ${workflow_1.MODEL_CLASS_VALUES.join(', ')}`);
+    }
+    return raw;
+}
+function projectSkillSlugs(skills) {
+    if (!Array.isArray(skills)) {
+        return [];
+    }
+    return skills
+        .map((s) => s.slug)
+        .filter((slug) => typeof slug === 'string' && slug.length > 0);
+}
+function projectToolSelection(tools, context) {
+    if (!Array.isArray(tools)) {
+        return [];
+    }
+    const validKinds = new Set(Object.values(mcp_tool_1.ToolProviderKind));
+    const out = [];
+    for (const [idx, tool] of tools.entries()) {
+        if (typeof tool.providerKind !== 'string' ||
+            !validKinds.has(tool.providerKind)) {
+            throw new AgentResolutionError(context, `tools[${idx}].providerKind must be one of ${Object.values(mcp_tool_1.ToolProviderKind).join(', ')}`);
+        }
+        if (typeof tool.resourceId !== 'string' ||
+            tool.resourceId.trim().length === 0) {
+            throw new AgentResolutionError(context, `tools[${idx}].resourceId must be a non-empty string`);
+        }
+        if (tool.kind === 'provider') {
+            out.push({
+                kind: 'provider',
+                providerKind: tool.providerKind,
+                resourceId: tool.resourceId,
+            });
+        }
+        else if (tool.kind === 'tool') {
+            if (typeof tool.toolName !== 'string' ||
+                tool.toolName.trim().length === 0) {
+                throw new AgentResolutionError(context, `tools[${idx}].toolName must be a non-empty string for kind='tool'`);
+            }
+            out.push({
+                kind: 'tool',
+                providerKind: tool.providerKind,
+                resourceId: tool.resourceId,
+                toolName: tool.toolName,
+            });
+        }
+        else {
+            throw new AgentResolutionError(context, `tools[${idx}].kind must be "provider" or "tool"`);
+        }
+    }
+    return out;
+}
+function projectAgentToRuntimeConfig(resolved, overlay) {
+    const root = resolved.root;
+    const agentRef = `${resolved.slug}@${resolved.version}`;
+    const rootInstructions = normalizeInstructions(root.instructions);
+    const overlayInstructions = normalizeInstructions(overlay?.instructions);
+    const primaryInstructions = appendInstructions(rootInstructions ?? '', overlayInstructions);
+    const rootModelOverride = projectModelOverride(root.modelOverride, agentRef);
+    const overlayModelOverride = projectModelOverride(overlay?.modelOverride, `${agentRef}#overlay`);
+    const rootPermission = normalizePermission(root.permission);
+    const overlayPermission = normalizePermission(overlay?.permission);
+    const flattened = flattenAgentTree(root);
+    return {
+        agentRef,
+        primaryAgentSlug: root.kernel.slug,
+        primaryInstructions: primaryInstructions.length > 0 ? primaryInstructions : null,
+        primaryPermission: overlayPermission ?? rootPermission,
+        primaryModelOverride: overlayModelOverride ?? rootModelOverride,
+        subAgentBindings: flattened.map((n) => ({ ...n })),
+        subAgentInstructionsBySlug: collectInstructionsBySlug(root),
+        subAgentPermissionBySlug: collectPermissionsBySlug(root),
+        subAgentModelOverridesBySlug: collectModelOverridesBySlug(root),
+        defaultSkillSlugs: collectSkills(root, { scope: 'root' }),
+        allSkillSlugs: collectSkills(root, { scope: 'tree' }),
+        defaultToolSelection: collectTools(root, { scope: 'root' }),
+    };
+}
+//# sourceMappingURL=composition-resolution.js.map

package/dist/lib/composition-resolution.js.map

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

package/dist/lib/composition-workspace-manifest.d.ts

@@ -0,0 +1,51 @@
+import { type CompiledManifestCredential, type CompiledManifestPermissions, type ModelRef } from '@xemahq/kernel-contracts/workflow';
+import type { PermissionMap } from '@xemahq/kernel-contracts/agent-permission';
+import { type CompiledWorkspaceManifest } from '@xemahq/dsl/workspace-manifest';
+export type { CompiledWorkspaceManifest };
+export declare class AgentMountLayoutError extends Error {
+    constructor(agentRef: string, detail: string);
+}
+export interface AgentRunConfigInput {
+    readonly stage: string;
+    readonly role: string;
+    readonly deliverableSpecRef?: string;
+}
+export interface AgentMountLayoutInput {
+    readonly mounts: Readonly<Record<string, unknown>>;
+    readonly agentRunConfig: AgentRunConfigInput;
+    readonly seedFiles: readonly unknown[];
+    readonly inputs: Readonly<Record<string, unknown>>;
+}
+export interface AgentSubAgentBindingInput {
+    readonly slug: string;
+    readonly alias?: string;
+    readonly modelOverride?: ModelRef;
+    readonly instructions?: string;
+    readonly permission?: PermissionMap;
+}
+export interface AgentOutputSurfaceInput {
+    readonly kind: 'none' | 'web' | 'static' | 'app' | 'tunnel';
+    readonly port?: number;
+    readonly healthPath?: string;
+    readonly autoOpen?: boolean;
+    readonly mode?: 'single' | 'multi';
+    readonly root?: string;
+    readonly defaultDocument?: string;
+}
+export interface AgentManifestSource {
+    readonly agentRef: string;
+    readonly primaryAgentSlug: string;
+    readonly subAgentBindings: readonly AgentSubAgentBindingInput[];
+    readonly mountLayout: AgentMountLayoutInput | undefined;
+    readonly outputSurface?: AgentOutputSurfaceInput;
+    readonly credentials?: readonly CompiledManifestCredential[];
+    readonly permissions?: CompiledManifestPermissions;
+}
+export interface AgentManifestImplicitInputs {
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly sessionId?: string;
+}
+export declare function compileAgentWorkspaceManifest(source: AgentManifestSource, bindInputs: Readonly<Record<string, unknown>>): CompiledWorkspaceManifest;
+export declare function buildAgentManifestBindInputs(source: AgentManifestSource, explicitInputs: Record<string, unknown> | null, implicitInputs: AgentManifestImplicitInputs): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=composition-workspace-manifest.d.ts.map

package/dist/lib/composition-workspace-manifest.d.ts.map

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

package/dist/lib/composition-workspace-manifest.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentMountLayoutError = void 0;
+exports.compileAgentWorkspaceManifest = compileAgentWorkspaceManifest;
+exports.buildAgentManifestBindInputs = buildAgentManifestBindInputs;
+const workflow_1 = require("@xemahq/kernel-contracts/workflow");
+const workspace_manifest_1 = require("@xemahq/dsl/workspace-manifest");
+class AgentMountLayoutError extends Error {
+    constructor(agentRef, detail) {
+        super(`Cannot derive a workspace mount layout from Agent ` +
+            `"${agentRef}": ${detail}`);
+        this.name = 'AgentMountLayoutError';
+    }
+}
+exports.AgentMountLayoutError = AgentMountLayoutError;
+function compileAgentWorkspaceManifest(source, bindInputs) {
+    const mountLayout = source.mountLayout;
+    if (!mountLayout) {
+        throw new AgentMountLayoutError(source.agentRef, 'the composition declares no `workspace.mountLayout` block — its ' +
+            'source workspace manifest was not projected by the llm-registry-api ' +
+            'composition seeder. Re-seed compositions (boot llm-registry-api) or ' +
+            'fix the source manifest.');
+    }
+    const [slug, version] = splitAgentRef(source.agentRef);
+    const subAgents = source.subAgentBindings.map((binding) => ({
+        slug: binding.slug,
+        ...(binding.alias !== undefined ? { alias: binding.alias } : {}),
+        ...(binding.modelOverride !== undefined
+            ? { defaultModel: binding.modelOverride }
+            : {}),
+        ...(binding.instructions !== undefined
+            ? { instructions: binding.instructions }
+            : {}),
+        ...(binding.permission !== undefined
+            ? { permission: binding.permission }
+            : {}),
+    }));
+    const outputSurface = projectOutputSurface(source.outputSurface);
+    const credentials = projectCredentials(source.credentials);
+    const permissions = projectPermissions(source.permissions);
+    const spec = {
+        mounts: mountLayout.mounts,
+        agent: {
+            slug: source.primaryAgentSlug,
+            stage: mountLayout.agentRunConfig.stage,
+            role: mountLayout.agentRunConfig.role,
+            ...(mountLayout.agentRunConfig.deliverableSpecRef !== undefined
+                ? { deliverableSpecRef: mountLayout.agentRunConfig.deliverableSpecRef }
+                : {}),
+            ...(subAgents.length > 0 ? { subAgents } : {}),
+        },
+        ...(Object.keys(mountLayout.inputs).length > 0
+            ? {
+                inputs: mountLayout.inputs,
+            }
+            : {}),
+        ...(mountLayout.seedFiles.length > 0
+            ? {
+                seedFiles: mountLayout.seedFiles,
+            }
+            : {}),
+        ...(outputSurface === undefined ? {} : { outputSurface }),
+        ...(credentials === undefined ? {} : { credentials }),
+        ...(permissions === undefined ? {} : { permissions }),
+    };
+    const envelope = {
+        apiVersion: 'xema.dev/workspace/v1',
+        kind: 'WorkspaceManifest',
+        metadata: {
+            slug,
+            version,
+            surfaceCompat: [workflow_1.ManifestSurface.AGENT_SESSION],
+        },
+        spec,
+    };
+    const result = (0, workspace_manifest_1.compileManifest)(envelope, bindInputs);
+    if (!result.ok) {
+        throw new AgentMountLayoutError(source.agentRef, `reconstructed manifest failed to compile: ${result.errors
+            .map((e) => `${e.path}: ${e.message}`)
+            .join('; ')}`);
+    }
+    return result.compiled;
+}
+function projectOutputSurface(surface) {
+    if (!surface)
+        return undefined;
+    return {
+        kind: surface.kind,
+        ...(surface.port === undefined ? {} : { port: surface.port }),
+        ...(surface.healthPath === undefined
+            ? {}
+            : { healthPath: surface.healthPath }),
+        ...(surface.autoOpen === undefined ? {} : { autoOpen: surface.autoOpen }),
+        ...(surface.mode === undefined ? {} : { mode: surface.mode }),
+        ...(surface.root === undefined ? {} : { root: surface.root }),
+        ...(surface.defaultDocument === undefined
+            ? {}
+            : { defaultDocument: surface.defaultDocument }),
+    };
+}
+function projectCredentials(credentials) {
+    if (credentials === undefined)
+        return undefined;
+    return credentials.map((credential) => ({
+        name: credential.name,
+        kind: credential.kind,
+        sourceRef: credential.sourceRef,
+        required: credential.required,
+    }));
+}
+function projectPermissions(permissions) {
+    if (permissions === undefined)
+        return undefined;
+    return {
+        tools: {
+            allow: permissions.tools.allow,
+            deny: permissions.tools.deny,
+        },
+    };
+}
+function buildAgentManifestBindInputs(source, explicitInputs, implicitInputs) {
+    const declared = new Set(Object.keys(source.mountLayout?.inputs ?? {}));
+    if (declared.size === 0) {
+        return {};
+    }
+    if (explicitInputs !== null &&
+        (typeof explicitInputs !== 'object' || Array.isArray(explicitInputs))) {
+        throw new AgentMountLayoutError(source.agentRef, 'explicit manifest inputs must be an object when provided');
+    }
+    const explicit = explicitInputs ?? {};
+    for (const [key, value] of Object.entries(explicit)) {
+        if (!declared.has(key)) {
+            throw new AgentMountLayoutError(source.agentRef, `manifest inputs contain undeclared key "${key}"`);
+        }
+        assertManifestInputValue(source.agentRef, key, value);
+    }
+    const implicit = {
+        orgId: implicitInputs.orgId,
+        projectId: implicitInputs.projectId,
+        ...(implicitInputs.sessionId !== undefined
+            ? { sessionId: implicitInputs.sessionId }
+            : {}),
+    };
+    const out = {};
+    for (const key of declared) {
+        if (Object.hasOwn(explicit, key)) {
+            out[key] = explicit[key];
+            continue;
+        }
+        if (Object.hasOwn(implicit, key)) {
+            out[key] = implicit[key];
+        }
+    }
+    return out;
+}
+function splitAgentRef(ref) {
+    const at = ref.lastIndexOf('@');
+    if (at <= 0 || at === ref.length - 1) {
+        throw new AgentMountLayoutError(ref, 'expected a version-pinned `slug@version` composition ref — the ' +
+            'session resolver always pins the resolved version');
+    }
+    return [ref.slice(0, at), ref.slice(at + 1)];
+}
+function assertManifestInputValue(agentRef, key, value) {
+    if (value !== null &&
+        typeof value !== 'string' &&
+        typeof value !== 'number' &&
+        typeof value !== 'boolean' &&
+        !Array.isArray(value)) {
+        throw new AgentMountLayoutError(agentRef, `manifest input "${key}" must be a primitive ` +
+            `(string, number, boolean, string[]) — got ${typeof value}`);
+    }
+    if (Array.isArray(value) &&
+        !value.every((entry) => typeof entry === 'string')) {
+        throw new AgentMountLayoutError(agentRef, `manifest input "${key}" is an array — every element must be a string`);
+    }
+}
+//# sourceMappingURL=composition-workspace-manifest.js.map

package/dist/lib/composition-workspace-manifest.js.map

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

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@xemahq/agent-session-runtime",
-  "version": "0.6.6",
+  "version": "0.6.7",
+  "description": "Runtime for composing and running Xema agent sessions — workspace manifests, skill bundles, environment resolution, and drift detection.",
+  "license": "Apache-2.0",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
+  "homepage": "https://xema.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-runtime-core.git",
+    "directory": "packages/runtime/agent-session-runtime"
+  },
+  "bugs": "https://github.com/xema-dev/xema-runtime-core/issues",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -35,11 +45,11 @@
     "prettier": "3.6.2",
     "ts-jest": "^29.4.9",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.15.0"
+    "@xemahq/kernel-contracts": "^0.58.0"
   },
   "dependencies": {
-    "@xemahq/dsl": "^0.5.4",
-    "@xemahq/kernel-contracts": "^0.15.0"
+    "@xemahq/dsl": "^0.6.1",
+    "@xemahq/kernel-contracts": "^0.58.0"
   },
   "peerDependencies": {
     "@xemahq/kernel-contracts": ">=0.13.0"

package/src/lib/agent-workspace-manifest.ts

@@ -1,7 +1,7 @@
 // ═══════════════════════════════════════════════════════════════════════════
 // ── Agent → CompiledWorkspaceManifest reconstruction ──
 //
-// Phase 10 (`workspace-manifests-api` retirement). The composer turns a
+// The composer turns a
 // `CompiledWorkspaceManifest` into a `WorkspaceMountPlan`; before this
 // module the only way to obtain that compiled manifest was to fetch the
 // `WorkspaceManifest` row from `workspace-manifests-api` and run
@@ -47,7 +47,7 @@ import {
   type ManifestSeedFile,
   type ManifestSubAgent,
   type ManifestWorkingFile,
-  type WorkspaceManifest as DslWorkspaceManifest,
+  type AgentWorkspaceSpec as DslWorkspaceManifest,
   type WorkspaceManifestSpec,
 } from '@xemahq/dsl/workspace-manifest';
 

package/src/lib/composer.ts

@@ -328,8 +328,8 @@ export class DefaultWorkspaceImageComposer implements WorkspaceImageComposer {
     // `/<skillKey>` in a session loads and applies that skill natively.
     //
     // Kernel-shipped System skills are PREPENDED to whatever skills the
-    // caller already named in `agentContext.skills` (see
-    // `.claude/rules/skills-and-composition.md` — `SkillSpace.System`
+    // caller already named in `agentContext.skills` (per the skill
+    // composition rules — `SkillSpace.System`
     // skills are auto-injected into every agent's mounted bundle).
     // `dedupe` collapses any overlap so a caller that re-mentions a
     // System skill in `agentContext.skills` does not double-mount it.

package/src/lib/drift-detector.ts

@@ -57,8 +57,8 @@ export enum DriftKind {
 
 /**
  * Advisory drift severity — `info` (benign) or `warning` (worth a look).
- * There is deliberately no `critical`: resume is non-blocking by design
- * (plan Epic D §D4), so severity only drives how the operator's drift
+ * There is deliberately no `critical`: resume is non-blocking by design,
+ * so severity only drives how the operator's drift
  * toast renders, never whether the session resumes.
  */
 export type DriftSeverity = 'info' | 'warning';

package/src/lib/environment-resolver.ts

@@ -124,7 +124,7 @@ export interface EnvironmentResolverRequest {
    */
   readonly systemSkillSlugs?: readonly string[];
   /**
-   * Optional MCP stanza resolver (Phase D1). Translates the manifest's
+   * Optional MCP stanza resolver. Translates the manifest's
    * `toolSelection` into a `mcpServers` map suitable for direct write
    * into `opencode.jsonc:mcp`. When absent, the resolved environment
    * carries no MCP stanzas — appropriate for workflow surfaces today
@@ -205,7 +205,7 @@ export interface ResolvedEnvironment {
   readonly mountPlan: WorkspaceMountPlan;
   readonly env: readonly { readonly name: string; readonly value: string }[];
   /**
-   * Phase D1: resolved `mcpServers` map ready to drop into
+   * Resolved `mcpServers` map ready to drop into
    * `opencode.jsonc:mcp`. Empty `{}` when the manifest declares no
    * toolSelection or when the request omits an `mcpResolver`. Keeps
    * the snapshot self-contained so downstream callers (workflow
@@ -279,7 +279,7 @@ export class DefaultEnvironmentResolver implements EnvironmentResolver {
       req.briefcase?.mcpTools,
     );
 
-    // Phase H.2: capability federation. When an `mcpResolver` is wired
+    // Capability federation. When an `mcpResolver` is wired
     // (session-boot, workflow-runtime-worker) the resolver ALWAYS runs —
     // the returned stanza is the fixed three meta-tool surface
     // (`xema-capabilities-{list,describe,invoke}`), regardless of

package/src/lib/skill-bundle-template-resolver.ts

@@ -1,7 +1,7 @@
 // ═══════════════════════════════════════════════════════════════════════════
 // ── Skill-bundle-backed TemplateResolver ──
 //
-// Phase 10 (workspace-manifests-api retirement). Seed-file templates used to
+// Seed-file templates used to
 // live in `workspace-manifests-api` (the `workspace_manifest_templates` table)
 // and were fetched by name. They are now SKILL-BUNDLE RESOURCES served by
 // `skill-registry-api` (`GET /skills/bundle`): a biome that ships templates

package/src/lib/types.ts

@@ -69,7 +69,7 @@ export interface ComposeWorkspaceImageRequest {
   readonly templateResolver?: TemplateResolver;
   /**
    * Kernel-shipped System-scope skill slugs to PREPEND to the composer's
-   * mounted skill set. Per `.claude/rules/skills-and-composition.md`,
+   * mounted skill set. Per the skill composition rules,
    * skills owned by `SkillSpace.System` are auto-injected into every
    * agent's mounted bundle — they ship from `@xemahq/system-skills`
    * via the System-tier seeder in `skill-registry-api`. The caller