@xemahq/agent-session-runtime 0.1.1

package/dist/lib/drift-detector.js

@@ -0,0 +1,386 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriftKind = void 0;
+exports.diffResolvedEnvironment = diffResolvedEnvironment;
+var DriftKind;
+(function (DriftKind) {
+    DriftKind["AGENT_CHANGED"] = "agent-changed";
+    DriftKind["ROLE_CHANGED"] = "role-changed";
+    DriftKind["MANIFEST_VERSION_CHANGED"] = "manifest-version-changed";
+    DriftKind["MODEL_CHANGED"] = "model-changed";
+    DriftKind["SUBAGENT_ADDED"] = "subagent-added";
+    DriftKind["SUBAGENT_REMOVED"] = "subagent-removed";
+    DriftKind["SUBAGENT_MODEL_CHANGED"] = "subagent-model-changed";
+    DriftKind["SKILL_ADDED"] = "skill-added";
+    DriftKind["SKILL_REMOVED"] = "skill-removed";
+    DriftKind["SKILL_VERSION_CHANGED"] = "skill-version-changed";
+    DriftKind["TOOL_SELECTION_ADDED"] = "tool-selection-added";
+    DriftKind["TOOL_SELECTION_REMOVED"] = "tool-selection-removed";
+    DriftKind["CREDENTIAL_ADDED"] = "credential-added";
+    DriftKind["CREDENTIAL_REMOVED"] = "credential-removed";
+    DriftKind["CREDENTIAL_KIND_CHANGED"] = "credential-kind-changed";
+    DriftKind["PERMISSION_TIGHTENED"] = "permission-tightened";
+    DriftKind["PERMISSION_RELAXED"] = "permission-relaxed";
+    DriftKind["PERSISTENCE_PATH_ADDED"] = "persistence-path-added";
+    DriftKind["PERSISTENCE_PATH_REMOVED"] = "persistence-path-removed";
+    DriftKind["OUTPUT_SURFACE_CHANGED"] = "output-surface-changed";
+    DriftKind["ENV_VAR_ADDED"] = "env-var-added";
+    DriftKind["ENV_VAR_REMOVED"] = "env-var-removed";
+    DriftKind["ENV_VAR_VALUE_CHANGED"] = "env-var-value-changed";
+    DriftKind["MOUNT_ADDED"] = "mount-added";
+    DriftKind["MOUNT_REMOVED"] = "mount-removed";
+    DriftKind["MOUNT_MODE_CHANGED"] = "mount-mode-changed";
+})(DriftKind || (exports.DriftKind = DriftKind = {}));
+function diffResolvedEnvironment(prev, next) {
+    if (prev.hash === next.hash) {
+        return [];
+    }
+    const drifts = [];
+    diffAgent(prev, next, drifts);
+    diffSubAgents(prev.subAgents, next.subAgents, drifts);
+    diffSkills(prev.skills, next.skills, drifts);
+    diffToolSelection(prev.toolSelection, next.toolSelection, drifts);
+    diffCredentials(prev.credentials, next.credentials, drifts);
+    diffPermissions(prev, next, drifts);
+    diffPersistence(prev, next, drifts);
+    diffOutputSurface(prev, next, drifts);
+    diffEnv(prev, next, drifts);
+    diffMounts(prev, next, drifts);
+    return drifts;
+}
+function diffAgent(prev, next, out) {
+    if (prev.manifest.version !== next.manifest.version) {
+        out.push({
+            kind: DriftKind.MANIFEST_VERSION_CHANGED,
+            severity: 'info',
+            path: '$.manifest.version',
+            before: prev.manifest.version,
+            after: next.manifest.version,
+            message: `Manifest version moved ${prev.manifest.version} → ${next.manifest.version}.`,
+        });
+    }
+    if (prev.agent.slug !== next.agent.slug) {
+        out.push({
+            kind: DriftKind.AGENT_CHANGED,
+            severity: 'warning',
+            path: '$.agent.slug',
+            before: prev.agent.slug,
+            after: next.agent.slug,
+            message: `Primary agent slug changed ${prev.agent.slug} → ${next.agent.slug}; the session resumes with the new agent.`,
+        });
+    }
+    if (prev.agent.role !== next.agent.role) {
+        out.push({
+            kind: DriftKind.ROLE_CHANGED,
+            severity: 'info',
+            path: '$.agent.role',
+            before: prev.agent.role,
+            after: next.agent.role,
+            message: `Agent role changed ${prev.agent.role} → ${next.agent.role}; AGENTS.md will be re-rendered.`,
+        });
+    }
+    const prevModel = JSON.stringify(prev.agent.model ?? null);
+    const nextModel = JSON.stringify(next.agent.model ?? null);
+    if (prevModel !== nextModel) {
+        out.push({
+            kind: DriftKind.MODEL_CHANGED,
+            severity: 'info',
+            path: '$.agent.model',
+            before: prev.agent.model,
+            after: next.agent.model,
+            message: 'Primary agent default model changed.',
+        });
+    }
+}
+function diffSubAgents(prev, next, out) {
+    const prevBySlug = new Map(prev.map((s) => [s.slug, s]));
+    const nextBySlug = new Map(next.map((s) => [s.slug, s]));
+    for (const [slug, n] of nextBySlug) {
+        const p = prevBySlug.get(slug);
+        if (!p) {
+            out.push({
+                kind: DriftKind.SUBAGENT_ADDED,
+                severity: 'info',
+                path: `$.subAgents[${slug}]`,
+                after: n,
+                message: `Sub-agent '${slug}' added.`,
+            });
+            continue;
+        }
+        if (JSON.stringify(p.modelOverride ?? null) !== JSON.stringify(n.modelOverride ?? null)) {
+            out.push({
+                kind: DriftKind.SUBAGENT_MODEL_CHANGED,
+                severity: 'info',
+                path: `$.subAgents[${slug}].modelOverride`,
+                before: p.modelOverride,
+                after: n.modelOverride,
+                message: `Sub-agent '${slug}' model override changed.`,
+            });
+        }
+    }
+    for (const [slug, p] of prevBySlug) {
+        if (!nextBySlug.has(slug)) {
+            out.push({
+                kind: DriftKind.SUBAGENT_REMOVED,
+                severity: 'warning',
+                path: `$.subAgents[${slug}]`,
+                before: p,
+                message: `Sub-agent '${slug}' removed; existing delegations may fail until the session is restarted.`,
+            });
+        }
+    }
+}
+function diffSkills(prev, next, out) {
+    const prevBySlug = new Map(prev.map((s) => [s.slug, s]));
+    const nextBySlug = new Map(next.map((s) => [s.slug, s]));
+    for (const [slug, n] of nextBySlug) {
+        const p = prevBySlug.get(slug);
+        if (!p) {
+            out.push({
+                kind: DriftKind.SKILL_ADDED,
+                severity: 'info',
+                path: `$.skills[${slug}]`,
+                after: n,
+                message: `Skill '${slug}' added.`,
+            });
+            continue;
+        }
+        if (p.version !== n.version) {
+            out.push({
+                kind: DriftKind.SKILL_VERSION_CHANGED,
+                severity: 'info',
+                path: `$.skills[${slug}].version`,
+                before: p.version,
+                after: n.version,
+                message: `Skill '${slug}' version moved ${p.version ?? '*'} → ${n.version ?? '*'}.`,
+            });
+        }
+    }
+    for (const [slug, p] of prevBySlug) {
+        if (!nextBySlug.has(slug)) {
+            out.push({
+                kind: DriftKind.SKILL_REMOVED,
+                severity: 'warning',
+                path: `$.skills[${slug}]`,
+                before: p,
+                message: `Skill '${slug}' removed.`,
+            });
+        }
+    }
+}
+function toolSelectionKey(entry) {
+    return entry.kind === 'tool'
+        ? `tool:${entry.providerKind}:${entry.resourceId}:${entry.toolName}`
+        : `provider:${entry.providerKind}:${entry.resourceId}`;
+}
+function diffToolSelection(prev, next, out) {
+    const prevByKey = new Map(prev.map((e) => [toolSelectionKey(e), e]));
+    const nextByKey = new Map(next.map((e) => [toolSelectionKey(e), e]));
+    for (const [key, n] of nextByKey) {
+        if (!prevByKey.has(key)) {
+            out.push({
+                kind: DriftKind.TOOL_SELECTION_ADDED,
+                severity: 'info',
+                path: `$.toolSelection[${key}]`,
+                after: n,
+                message: `Tool selection entry '${key}' added.`,
+            });
+        }
+    }
+    for (const [key, p] of prevByKey) {
+        if (!nextByKey.has(key)) {
+            out.push({
+                kind: DriftKind.TOOL_SELECTION_REMOVED,
+                severity: 'warning',
+                path: `$.toolSelection[${key}]`,
+                before: p,
+                message: `Tool selection entry '${key}' removed.`,
+            });
+        }
+    }
+}
+function diffCredentials(prev, next, out) {
+    const prevByName = new Map(prev.map((c) => [c.name, c]));
+    const nextByName = new Map(next.map((c) => [c.name, c]));
+    for (const [name, n] of nextByName) {
+        const p = prevByName.get(name);
+        if (!p) {
+            out.push({
+                kind: DriftKind.CREDENTIAL_ADDED,
+                severity: 'info',
+                path: `$.credentials[${name}]`,
+                after: n,
+                message: `Credential '${name}' added.`,
+            });
+            continue;
+        }
+        if (p.kind !== n.kind) {
+            out.push({
+                kind: DriftKind.CREDENTIAL_KIND_CHANGED,
+                severity: 'warning',
+                path: `$.credentials[${name}].kind`,
+                before: p.kind,
+                after: n.kind,
+                message: `Credential '${name}' kind changed ${p.kind} → ${n.kind}; the resolver will re-route it on resume.`,
+            });
+        }
+    }
+    for (const [name, p] of prevByName) {
+        if (!nextByName.has(name)) {
+            out.push({
+                kind: DriftKind.CREDENTIAL_REMOVED,
+                severity: 'warning',
+                path: `$.credentials[${name}]`,
+                before: p,
+                message: `Credential '${name}' removed${p.required ? ' (was required; the session resumes with the remaining credentials)' : ''}.`,
+            });
+        }
+    }
+}
+function diffPermissions(prev, next, out) {
+    const prevAllow = new Set(prev.permissions.tools.allow);
+    const nextAllow = new Set(next.permissions.tools.allow);
+    const prevDeny = new Set(prev.permissions.tools.deny);
+    const nextDeny = new Set(next.permissions.tools.deny);
+    for (const tool of prevAllow) {
+        if (!nextAllow.has(tool) || nextDeny.has(tool)) {
+            out.push({
+                kind: DriftKind.PERMISSION_TIGHTENED,
+                severity: 'warning',
+                path: `$.permissions.tools.${tool}`,
+                before: 'allow',
+                after: nextDeny.has(tool) ? 'deny' : 'unset',
+                message: `Tool '${tool}' is no longer allowed.`,
+            });
+        }
+    }
+    for (const tool of nextAllow) {
+        if (!prevAllow.has(tool) || prevDeny.has(tool)) {
+            out.push({
+                kind: DriftKind.PERMISSION_RELAXED,
+                severity: 'info',
+                path: `$.permissions.tools.${tool}`,
+                before: prevDeny.has(tool) ? 'deny' : 'unset',
+                after: 'allow',
+                message: `Tool '${tool}' is now allowed.`,
+            });
+        }
+    }
+}
+function diffPersistence(prev, next, out) {
+    const prevPaths = new Set(prev.persistence.paths);
+    const nextPaths = new Set(next.persistence.paths);
+    for (const path of nextPaths) {
+        if (!prevPaths.has(path)) {
+            out.push({
+                kind: DriftKind.PERSISTENCE_PATH_ADDED,
+                severity: 'info',
+                path: `$.persistence.paths`,
+                after: path,
+                message: `Persistence path '${path}' added; future pauses will snapshot it.`,
+            });
+        }
+    }
+    for (const path of prevPaths) {
+        if (!nextPaths.has(path)) {
+            out.push({
+                kind: DriftKind.PERSISTENCE_PATH_REMOVED,
+                severity: 'info',
+                path: `$.persistence.paths`,
+                before: path,
+                message: `Persistence path '${path}' removed; future pauses will not snapshot it.`,
+            });
+        }
+    }
+}
+function diffOutputSurface(prev, next, out) {
+    if (prev.outputSurface.kind !== next.outputSurface.kind ||
+        prev.outputSurface.port !== next.outputSurface.port ||
+        prev.outputSurface.healthPath !== next.outputSurface.healthPath ||
+        prev.outputSurface.mode !== next.outputSurface.mode) {
+        out.push({
+            kind: DriftKind.OUTPUT_SURFACE_CHANGED,
+            severity: 'info',
+            path: '$.outputSurface',
+            before: prev.outputSurface,
+            after: next.outputSurface,
+            message: 'Output surface configuration changed.',
+        });
+    }
+}
+function diffEnv(prev, next, out) {
+    const prevByName = new Map(prev.env.map((e) => [e.name, e.value]));
+    const nextByName = new Map(next.env.map((e) => [e.name, e.value]));
+    for (const [name, value] of nextByName) {
+        const prevValue = prevByName.get(name);
+        if (prevValue === undefined) {
+            out.push({
+                kind: DriftKind.ENV_VAR_ADDED,
+                severity: 'info',
+                path: `$.env[${name}]`,
+                after: value,
+                message: `Env var '${name}' added.`,
+            });
+        }
+        else if (prevValue !== value) {
+            out.push({
+                kind: DriftKind.ENV_VAR_VALUE_CHANGED,
+                severity: 'info',
+                path: `$.env[${name}]`,
+                before: prevValue,
+                after: value,
+                message: `Env var '${name}' value changed.`,
+            });
+        }
+    }
+    for (const name of prevByName.keys()) {
+        if (!nextByName.has(name)) {
+            out.push({
+                kind: DriftKind.ENV_VAR_REMOVED,
+                severity: 'warning',
+                path: `$.env[${name}]`,
+                before: prevByName.get(name),
+                message: `Env var '${name}' removed.`,
+            });
+        }
+    }
+}
+function diffMounts(prev, next, out) {
+    const prevSlots = new Map(prev.mountPlan.entries.map((e) => [e.slot, e]));
+    const nextSlots = new Map(next.mountPlan.entries.map((e) => [e.slot, e]));
+    for (const [slot, entry] of nextSlots) {
+        const prevEntry = prevSlots.get(slot);
+        if (!prevEntry) {
+            out.push({
+                kind: DriftKind.MOUNT_ADDED,
+                severity: 'info',
+                path: `$.mounts[${slot}]`,
+                after: { mountKey: entry.mountKey },
+                message: `Mount slot '${slot}' added.`,
+            });
+            continue;
+        }
+        if (prevEntry.mode !== entry.mode) {
+            out.push({
+                kind: DriftKind.MOUNT_MODE_CHANGED,
+                severity: 'warning',
+                path: `$.mounts[${slot}].mode`,
+                before: prevEntry.mode,
+                after: entry.mode,
+                message: `Mount slot '${slot}' mode changed ${prevEntry.mode} → ${entry.mode}.`,
+            });
+        }
+    }
+    for (const slot of prevSlots.keys()) {
+        if (!nextSlots.has(slot)) {
+            out.push({
+                kind: DriftKind.MOUNT_REMOVED,
+                severity: 'warning',
+                path: `$.mounts[${slot}]`,
+                before: { slot },
+                message: `Mount slot '${slot}' removed.`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=drift-detector.js.map

package/dist/lib/drift-detector.js.map

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

package/dist/lib/environment-resolver.d.ts

@@ -0,0 +1,84 @@
+import { IntrinsicFloorTool } from '@xemahq/kernel-contracts/agent-composition';
+import type { WorkspaceMountPlan } from '@xemahq/kernel-contracts/agent-workspace';
+import { type ToolSelectionEntry } from '@xemahq/kernel-contracts/mcp-tool';
+import type { CompiledWorkspaceManifest } from '@xemahq/dsl/workspace-manifest';
+import { ManifestSurface, type AgentRunRole, type Briefcase, type CompiledManifestCredential, type CompiledManifestDisplay, type CompiledManifestPermissions, type CompiledManifestPersistence, type CompiledManifestOutputSurface, type CompiledManifestSkillRef, type ModelRef, type SubAgentBinding } from '@xemahq/kernel-contracts/workflow';
+import type { TemplateResolver, WorkspaceImageComposer } from './types';
+export type SurfaceContext = {
+    readonly kind: typeof ManifestSurface.WORKFLOW;
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly jobRunId: string;
+} | {
+    readonly kind: typeof ManifestSurface.AGENT_SESSION;
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly sessionId: string;
+    readonly turnGen?: number;
+};
+export interface ExplicitEnvironmentOverrides {
+    readonly model?: ModelRef;
+    readonly subAgents?: readonly SubAgentBinding[];
+    readonly role?: AgentRunRole;
+    readonly deliverableSpecRef?: string;
+}
+export interface EnvironmentResolverRequest {
+    readonly manifest: CompiledWorkspaceManifest;
+    readonly surface: SurfaceContext;
+    readonly overrides?: ExplicitEnvironmentOverrides;
+    readonly agentContext: Readonly<Record<string, unknown>>;
+    readonly templateResolver?: TemplateResolver;
+    readonly systemSkillSlugs?: readonly string[];
+    readonly mcpResolver?: McpStanzaResolver;
+    readonly briefcase?: Briefcase;
+}
+export interface McpStanzaResolver {
+    resolve(selection: readonly ToolSelectionEntry[], context: McpStanzaResolverContext): Promise<Record<string, unknown>>;
+}
+export interface McpStanzaResolverContext {
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly sessionId?: string;
+    readonly actorSubject?: string;
+}
+export interface ResolvedEnvironment {
+    readonly surface: ManifestSurface;
+    readonly manifest: {
+        readonly slug: string;
+        readonly version: string;
+    };
+    readonly display: CompiledManifestDisplay;
+    readonly agent: {
+        readonly slug: string;
+        readonly role: AgentRunRole;
+        readonly deliverableSpecRef?: string;
+        readonly model?: ModelRef;
+    };
+    readonly subAgents: readonly SubAgentBinding[];
+    readonly skills: readonly CompiledManifestSkillRef[];
+    readonly toolSelection: readonly ToolSelectionEntry[];
+    readonly intrinsicFloorTools: readonly IntrinsicFloorTool[];
+    readonly credentials: readonly CompiledManifestCredential[];
+    readonly permissions: CompiledManifestPermissions;
+    readonly persistence: CompiledManifestPersistence;
+    readonly outputSurface: CompiledManifestOutputSurface;
+    readonly mountPlan: WorkspaceMountPlan;
+    readonly env: readonly {
+        readonly name: string;
+        readonly value: string;
+    }[];
+    readonly mcpServers: Readonly<Record<string, unknown>>;
+    readonly hash: string;
+}
+export interface EnvironmentResolver {
+    resolve(req: EnvironmentResolverRequest): Promise<ResolvedEnvironment>;
+}
+export declare class DefaultEnvironmentResolver implements EnvironmentResolver {
+    private readonly composer;
+    constructor(composer: WorkspaceImageComposer);
+    resolve(req: EnvironmentResolverRequest): Promise<ResolvedEnvironment>;
+    private assertSurfaceCompat;
+}
+export declare function mergeSubAgents(base: readonly SubAgentBinding[], overrides: readonly SubAgentBinding[] | undefined): readonly SubAgentBinding[];
+//# sourceMappingURL=environment-resolver.d.ts.map

package/dist/lib/environment-resolver.d.ts.map

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