@xemahq/agent-session-runtime 0.6.0 → 0.6.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from './lib/types';
 export * from './lib/composer';
-export * from './lib/composition-workspace-manifest';
-export * from './lib/composition-resolution';
+export * from './lib/agent-workspace-manifest';
+export * from './lib/agent-resolution';
 export * from './lib/skill-bundle-template-resolver';
 export * from './lib/errors';
 export * from './lib/environment-resolver';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sCAAsC,CAAC;AACrD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,sCAAsC,CAAC;AACrD,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -16,8 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/types"), exports);
 __exportStar(require("./lib/composer"), exports);
-__exportStar(require("./lib/composition-workspace-manifest"), exports);
-__exportStar(require("./lib/composition-resolution"), exports);
+__exportStar(require("./lib/agent-workspace-manifest"), exports);
+__exportStar(require("./lib/agent-resolution"), exports);
 __exportStar(require("./lib/skill-bundle-template-resolver"), exports);
 __exportStar(require("./lib/errors"), exports);
 __exportStar(require("./lib/environment-resolver"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAyBA,8CAA4B;AAC5B,iDAA+B;AAC/B,uEAAqD;AACrD,+DAA6C;AAC7C,uEAAqD;AACrD,+CAA6B;AAC7B,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAyBA,8CAA4B;AAC5B,iDAA+B;AAC/B,iEAA+C;AAC/C,yDAAuC;AACvC,uEAAqD;AACrD,+CAA6B;AAC7B,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,0DAAwC"}

package/dist/lib/agent-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=agent-resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-resolution.d.ts","sourceRoot":"","sources":["../../src/lib/agent-resolution.ts"],"names":[],"mappings":"AA4BA,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EAClB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,mCAAmC,CAAC;AAU3C,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAI5C;AAWD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAGD,MAAM,WAAW,mBAAmB;IAKlC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAClC;AAOD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C,QAAQ,CAAC,iBAAiB,EAAE,aAAa,GAAG,IAAI,CAAC;IAEjD,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IACtD,QAAQ,CAAC,0BAA0B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,4BAA4B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE1E,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAE9C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAE1C,QAAQ,CAAC,oBAAoB,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAC9D;AAaD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,GACtB,SAAS,kBAAkB,EAAE,CA0B/B;AAQD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,IAAI,CAAC,EAAE,mBAAmB,GACzB,SAAS,MAAM,EAAE,CAuBnB;AAQD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,iBAAiB,EACvB,IAAI,CAAC,EAAE,mBAAmB,GACzB,SAAS,kBAAkB,EAAE,CAe/B;AAOD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,iBAAiB,GACtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIlC;AAMD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,iBAAiB,GACtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAIzC;AAOD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,iBAAiB,GACtB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAIpC;AA2CD,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAC9B,MAAM,CAWR;AAWD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAM5E;AAQD,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,GAAG,SAAS,GAC7B,aAAa,GAAG,IAAI,CAKtB;AAOD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,IAAI,CA4BjB;AAqGD,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,CAyCpB"}

package/dist/lib/agent-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=agent-resolution.js.map

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

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

package/dist/lib/agent-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=agent-workspace-manifest.d.ts.map

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

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

package/dist/lib/agent-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=agent-workspace-manifest.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/agent-session-runtime",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
@@ -34,11 +34,14 @@
     "jest": "^30.3.0",
     "prettier": "3.6.2",
     "ts-jest": "^29.4.9",
-    "typescript": "5.9.3"
+    "typescript": "5.9.3",
+    "@xemahq/kernel-contracts": "^0.13.0"
   },
   "dependencies": {
-    "@xemahq/dsl": "^0.4.0",
-    "@xemahq/kernel-contracts": "^0.6.0"
+    "@xemahq/dsl": "^0.5.3"
+  },
+  "peerDependencies": {
+    "@xemahq/kernel-contracts": ">=0.13.0"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/index.ts

@@ -25,8 +25,8 @@
 
 export * from './lib/types';
 export * from './lib/composer';
-export * from './lib/composition-workspace-manifest';
-export * from './lib/composition-resolution';
+export * from './lib/agent-workspace-manifest';
+export * from './lib/agent-resolution';
 export * from './lib/skill-bundle-template-resolver';
 export * from './lib/errors';
 export * from './lib/environment-resolver';