@xemahq/agent-session-runtime 0.1.1

package/dist/lib/environment-resolver.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultEnvironmentResolver = void 0;
+exports.mergeSubAgents = mergeSubAgents;
+const node_crypto_1 = require("node:crypto");
+const agent_composition_1 = require("@xemahq/kernel-contracts/agent-composition");
+const mcp_tool_1 = require("@xemahq/kernel-contracts/mcp-tool");
+const workflow_1 = require("@xemahq/kernel-contracts/workflow");
+const errors_1 = require("./errors");
+class DefaultEnvironmentResolver {
+    composer;
+    constructor(composer) {
+        this.composer = composer;
+    }
+    async resolve(req) {
+        this.assertSurfaceCompat(req.manifest, req.surface);
+        const role = req.overrides?.role ?? req.manifest.agent.role;
+        const deliverableSpecRef = req.overrides?.deliverableSpecRef ?? req.manifest.agent.deliverableSpecRef;
+        const mountPlan = await this.composer.compose({
+            orgId: req.surface.orgId,
+            projectId: req.surface.projectId,
+            manifest: req.manifest,
+            agentContext: req.agentContext,
+            ...(req.surface.kind === workflow_1.ManifestSurface.WORKFLOW
+                ? {
+                    workflowRun: {
+                        runId: req.surface.runId,
+                        jobRunId: req.surface.jobRunId,
+                    },
+                }
+                : {
+                    interactive: {
+                        sessionId: req.surface.sessionId,
+                        ...(req.surface.turnGen !== undefined
+                            ? { turnGen: req.surface.turnGen }
+                            : {}),
+                    },
+                }),
+            agentOverrides: {
+                role,
+                ...(deliverableSpecRef !== undefined ? { deliverableSpecRef } : {}),
+            },
+            ...(req.templateResolver !== undefined
+                ? { templateResolver: req.templateResolver }
+                : {}),
+            ...(req.systemSkillSlugs !== undefined
+                ? { systemSkillSlugs: req.systemSkillSlugs }
+                : {}),
+            ...(req.briefcase !== undefined ? { briefcase: req.briefcase } : {}),
+        });
+        const subAgents = mergeSubAgents(req.manifest.agent.subAgents, req.overrides?.subAgents);
+        const model = req.overrides?.model ?? req.manifest.agent.defaultModel;
+        const toolSelection = mergeBriefcaseToolSelection(req.manifest.toolSelection, req.briefcase?.mcpTools);
+        let mcpServers = Object.freeze({});
+        if (req.mcpResolver) {
+            const ctx = req.surface.kind === workflow_1.ManifestSurface.AGENT_SESSION
+                ? {
+                    orgId: req.surface.orgId,
+                    projectId: req.surface.projectId,
+                    sessionId: req.surface.sessionId,
+                }
+                : {
+                    orgId: req.surface.orgId,
+                    projectId: req.surface.projectId,
+                };
+            mcpServers = await req.mcpResolver.resolve(toolSelection, ctx);
+        }
+        const resolved = {
+            surface: req.surface.kind,
+            manifest: {
+                slug: req.manifest.slug,
+                version: req.manifest.version,
+            },
+            display: req.manifest.display,
+            agent: {
+                slug: req.manifest.agent.slug,
+                role,
+                ...(deliverableSpecRef !== undefined ? { deliverableSpecRef } : {}),
+                ...(model !== undefined ? { model } : {}),
+            },
+            subAgents,
+            skills: req.manifest.skills,
+            toolSelection,
+            intrinsicFloorTools: agent_composition_1.INTRINSIC_FLOOR_TOOLS,
+            credentials: req.manifest.credentials,
+            permissions: req.manifest.permissions,
+            persistence: req.manifest.persistence,
+            outputSurface: req.manifest.outputSurface,
+            mountPlan,
+            env: req.manifest.env,
+            mcpServers,
+        };
+        return { ...resolved, hash: hashResolved(resolved) };
+    }
+    assertSurfaceCompat(manifest, surface) {
+        if (!manifest.surfaceCompat.includes(surface.kind)) {
+            throw new errors_1.ManifestSurfaceMismatchError(`Manifest '${manifest.slug}@${manifest.version}' declares surfaceCompat=[${manifest.surfaceCompat.join(', ')}] but was resolved on '${surface.kind}'.`);
+        }
+    }
+}
+exports.DefaultEnvironmentResolver = DefaultEnvironmentResolver;
+function mergeSubAgents(base, overrides) {
+    if (!overrides || overrides.length === 0) {
+        return base;
+    }
+    const overrideBySlug = new Map(overrides.map((s) => [s.slug, s]));
+    const baseSlugs = new Set();
+    const out = [];
+    for (const b of base) {
+        baseSlugs.add(b.slug);
+        out.push(overrideBySlug.get(b.slug) ?? b);
+    }
+    for (const o of overrides) {
+        if (!baseSlugs.has(o.slug)) {
+            out.push(o);
+        }
+    }
+    return out;
+}
+function mergeBriefcaseToolSelection(manifestSelection, briefcaseTools) {
+    if (!briefcaseTools || briefcaseTools.length === 0)
+        return manifestSelection;
+    const out = [...manifestSelection];
+    const seen = new Set(out.map(toolSelectionKey));
+    for (const t of briefcaseTools) {
+        if (!isToolProviderKind(t.providerKind)) {
+            throw new Error(`briefcase.mcpTools[].providerKind='${t.providerKind}' is not a known ToolProviderKind — dispatch must validate at the engine boundary.`);
+        }
+        const entry = t.kind === 'tool'
+            ? {
+                kind: 'tool',
+                providerKind: t.providerKind,
+                resourceId: t.resourceId,
+                toolName: requireToolName(t),
+            }
+            : {
+                kind: 'provider',
+                providerKind: t.providerKind,
+                resourceId: t.resourceId,
+            };
+        const key = toolSelectionKey(entry);
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(entry);
+    }
+    return out;
+}
+function toolSelectionKey(entry) {
+    return entry.kind === 'tool'
+        ? `tool:${entry.providerKind}:${entry.resourceId}:${entry.toolName}`
+        : `provider:${entry.providerKind}:${entry.resourceId}`;
+}
+function isToolProviderKind(value) {
+    return Object.values(mcp_tool_1.ToolProviderKind).includes(value);
+}
+function requireToolName(t) {
+    if (t.toolName === undefined || t.toolName.length === 0) {
+        throw new Error(`briefcase.mcpTools[].toolName is required when kind='tool' (providerKind='${t.providerKind}', resourceId='${t.resourceId}').`);
+    }
+    return t.toolName;
+}
+function hashResolved(resolved) {
+    const { mountPlan: _mountPlan, ...rest } = resolved;
+    return (0, node_crypto_1.createHash)('sha256').update(canonicalJson(rest)).digest('hex');
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map(canonicalJson).join(',')}]`;
+    }
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries
+        .map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`)
+        .join(',')}}`;
+}
+//# sourceMappingURL=environment-resolver.js.map

package/dist/lib/environment-resolver.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,12 @@
+export declare class ManifestSurfaceMismatchError extends Error {
+    readonly name = "ManifestSurfaceMismatchError";
+}
+export declare class UnknownSlotError extends Error {
+    readonly slotKey: string;
+    readonly origin: 'manifest.mounts' | 'manifest.seedFiles' | 'rendered.mounts' | 'inputArtifacts';
+    readonly manifestSlug: string;
+    readonly manifestVersion: string;
+    readonly name = "UnknownSlotError";
+    constructor(slotKey: string, origin: 'manifest.mounts' | 'manifest.seedFiles' | 'rendered.mounts' | 'inputArtifacts', manifestSlug: string, manifestVersion: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAkBA,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,SAAkB,IAAI,kCAAkC;CACzD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAIvC,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,MAAM,EACX,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM;IAVlC,SAAkB,IAAI,sBAAsB;gBAGjC,OAAO,EAAE,MAAM,EACf,MAAM,EACX,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,EACX,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM;CASnC"}

package/dist/lib/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnknownSlotError = exports.ManifestSurfaceMismatchError = void 0;
+const agent_workspace_1 = require("@xemahq/kernel-contracts/agent-workspace");
+class ManifestSurfaceMismatchError extends Error {
+    name = 'ManifestSurfaceMismatchError';
+}
+exports.ManifestSurfaceMismatchError = ManifestSurfaceMismatchError;
+class UnknownSlotError extends Error {
+    slotKey;
+    origin;
+    manifestSlug;
+    manifestVersion;
+    name = 'UnknownSlotError';
+    constructor(slotKey, origin, manifestSlug, manifestVersion) {
+        super(`Workspace manifest '${manifestSlug}@${manifestVersion}' references slot '${slotKey}' from ${origin}, ` +
+            `but AWP_V1_SPEC declares no such slot. Known slots: [${agent_workspace_1.AWP_V1_SPEC.slots
+                .map((s) => s.key)
+                .join(', ')}].`);
+        this.slotKey = slotKey;
+        this.origin = origin;
+        this.manifestSlug = manifestSlug;
+        this.manifestVersion = manifestVersion;
+    }
+}
+exports.UnknownSlotError = UnknownSlotError;
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":";;;AAAA,8EAAuE;AAkBvE,MAAa,4BAA6B,SAAQ,KAAK;IACnC,IAAI,GAAG,8BAA8B,CAAC;CACzD;AAFD,oEAEC;AAED,MAAa,gBAAiB,SAAQ,KAAK;IAI9B;IACA;IAKA;IACA;IAVO,IAAI,GAAG,kBAAkB,CAAC;IAE5C,YACW,OAAe,EACf,MAIW,EACX,YAAoB,EACpB,eAAuB;QAEhC,KAAK,CACH,uBAAuB,YAAY,IAAI,eAAe,sBAAsB,OAAO,UAAU,MAAM,IAAI;YACrG,wDAAwD,6BAAW,CAAC,KAAK;iBACtE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;iBACjB,IAAI,CAAC,IAAI,CAAC,IAAI,CACpB,CAAC;QAdO,YAAO,GAAP,OAAO,CAAQ;QACf,WAAM,GAAN,MAAM,CAIK;QACX,iBAAY,GAAZ,YAAY,CAAQ;QACpB,oBAAe,GAAf,eAAe,CAAQ;IAQlC,CAAC;CACF;AApBD,4CAoBC"}

package/dist/lib/lifecycle-state.d.ts

@@ -0,0 +1,23 @@
+export declare const SessionLifecycleState: {
+    readonly creating: "creating";
+    readonly provisioning: "provisioning";
+    readonly active: "active";
+    readonly paused: "paused";
+    readonly recovering: "recovering";
+    readonly completing: "completing";
+    readonly completed: "completed";
+    readonly failed: "failed";
+    readonly archived: "archived";
+};
+export type SessionLifecycleStateValue = (typeof SessionLifecycleState)[keyof typeof SessionLifecycleState];
+export declare const SessionOwnerKind: {
+    readonly interactive_session: "interactive_session";
+    readonly pipeline_run: "pipeline_run";
+    readonly chat_thread: "chat_thread";
+};
+export type SessionOwnerKindValue = (typeof SessionOwnerKind)[keyof typeof SessionOwnerKind];
+export declare function canTransition(from: SessionLifecycleStateValue, to: SessionLifecycleStateValue): boolean;
+export declare function isTerminal(state: SessionLifecycleStateValue): boolean;
+export declare function isPausable(state: SessionLifecycleStateValue): boolean;
+export declare function isResumable(state: SessionLifecycleStateValue): boolean;
+//# sourceMappingURL=lifecycle-state.d.ts.map

package/dist/lib/lifecycle-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-state.d.ts","sourceRoot":"","sources":["../../src/lib/lifecycle-state.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,qBAAqB;;;;;;;;;;CAUxB,CAAC;AAEX,MAAM,MAAM,0BAA0B,GACpC,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAC;AAYrE,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAiD3D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,0BAA0B,EAChC,EAAE,EAAE,0BAA0B,GAC7B,OAAO,CAET;AAOD,wBAAgB,UAAU,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAMrE;AAQD,wBAAgB,UAAU,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAErE;AAQD,wBAAgB,WAAW,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAEtE"}

package/dist/lib/lifecycle-state.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionOwnerKind = exports.SessionLifecycleState = void 0;
+exports.canTransition = canTransition;
+exports.isTerminal = isTerminal;
+exports.isPausable = isPausable;
+exports.isResumable = isResumable;
+exports.SessionLifecycleState = {
+    creating: 'creating',
+    provisioning: 'provisioning',
+    active: 'active',
+    paused: 'paused',
+    recovering: 'recovering',
+    completing: 'completing',
+    completed: 'completed',
+    failed: 'failed',
+    archived: 'archived',
+};
+exports.SessionOwnerKind = {
+    interactive_session: 'interactive_session',
+    pipeline_run: 'pipeline_run',
+    chat_thread: 'chat_thread',
+};
+const TRANSITIONS = {
+    creating: new Set([
+        exports.SessionLifecycleState.provisioning,
+        exports.SessionLifecycleState.failed,
+    ]),
+    provisioning: new Set([
+        exports.SessionLifecycleState.active,
+        exports.SessionLifecycleState.failed,
+    ]),
+    active: new Set([
+        exports.SessionLifecycleState.paused,
+        exports.SessionLifecycleState.completing,
+        exports.SessionLifecycleState.failed,
+    ]),
+    paused: new Set([
+        exports.SessionLifecycleState.recovering,
+        exports.SessionLifecycleState.archived,
+        exports.SessionLifecycleState.failed,
+    ]),
+    recovering: new Set([
+        exports.SessionLifecycleState.active,
+        exports.SessionLifecycleState.paused,
+        exports.SessionLifecycleState.failed,
+    ]),
+    completing: new Set([
+        exports.SessionLifecycleState.completed,
+        exports.SessionLifecycleState.failed,
+    ]),
+    completed: new Set([exports.SessionLifecycleState.archived]),
+    failed: new Set([exports.SessionLifecycleState.archived]),
+    archived: new Set(),
+};
+function canTransition(from, to) {
+    return TRANSITIONS[from].has(to);
+}
+function isTerminal(state) {
+    return (state === exports.SessionLifecycleState.completed ||
+        state === exports.SessionLifecycleState.failed ||
+        state === exports.SessionLifecycleState.archived);
+}
+function isPausable(state) {
+    return state === exports.SessionLifecycleState.active;
+}
+function isResumable(state) {
+    return state === exports.SessionLifecycleState.paused;
+}
+//# sourceMappingURL=lifecycle-state.js.map

package/dist/lib/lifecycle-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-state.js","sourceRoot":"","sources":["../../src/lib/lifecycle-state.ts"],"names":[],"mappings":";;;AAoGA,sCAKC;AAOD,gCAMC;AAQD,gCAEC;AAQD,kCAEC;AAvHY,QAAA,qBAAqB,GAAG;IACnC,QAAQ,EAAE,UAAU;IACpB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAeE,QAAA,gBAAgB,GAAG;IAC9B,mBAAmB,EAAE,qBAAqB;IAC1C,YAAY,EAAE,cAAc;IAC5B,WAAW,EAAE,aAAa;CAClB,CAAC;AAiBX,MAAM,WAAW,GAEb;IACF,QAAQ,EAAE,IAAI,GAAG,CAAC;QAChB,6BAAqB,CAAC,YAAY;QAClC,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,YAAY,EAAE,IAAI,GAAG,CAAC;QACpB,6BAAqB,CAAC,MAAM;QAC5B,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,MAAM,EAAE,IAAI,GAAG,CAAC;QACd,6BAAqB,CAAC,MAAM;QAC5B,6BAAqB,CAAC,UAAU;QAChC,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,MAAM,EAAE,IAAI,GAAG,CAAC;QACd,6BAAqB,CAAC,UAAU;QAChC,6BAAqB,CAAC,QAAQ;QAC9B,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,UAAU,EAAE,IAAI,GAAG,CAAC;QAClB,6BAAqB,CAAC,MAAM;QAC5B,6BAAqB,CAAC,MAAM;QAC5B,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,UAAU,EAAE,IAAI,GAAG,CAAC;QAClB,6BAAqB,CAAC,SAAS;QAC/B,6BAAqB,CAAC,MAAM;KAC7B,CAAC;IACF,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,6BAAqB,CAAC,QAAQ,CAAC,CAAC;IACpD,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,6BAAqB,CAAC,QAAQ,CAAC,CAAC;IACjD,QAAQ,EAAE,IAAI,GAAG,EAAE;CACpB,CAAC;AAEF,SAAgB,aAAa,CAC3B,IAAgC,EAChC,EAA8B;IAE9B,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACnC,CAAC;AAOD,SAAgB,UAAU,CAAC,KAAiC;IAC1D,OAAO,CACL,KAAK,KAAK,6BAAqB,CAAC,SAAS;QACzC,KAAK,KAAK,6BAAqB,CAAC,MAAM;QACtC,KAAK,KAAK,6BAAqB,CAAC,QAAQ,CACzC,CAAC;AACJ,CAAC;AAQD,SAAgB,UAAU,CAAC,KAAiC;IAC1D,OAAO,KAAK,KAAK,6BAAqB,CAAC,MAAM,CAAC;AAChD,CAAC;AAQD,SAAgB,WAAW,CAAC,KAAiC;IAC3D,OAAO,KAAK,KAAK,6BAAqB,CAAC,MAAM,CAAC;AAChD,CAAC"}

package/dist/lib/skill-bundle-template-resolver.d.ts

@@ -0,0 +1,23 @@
+import type { TemplateResolver } from './types';
+export interface SkillBundleResource {
+    readonly relPath: string;
+    readonly content: string;
+}
+export interface SkillBundle {
+    readonly slug: string;
+    readonly resources: readonly SkillBundleResource[];
+}
+export type SkillBundleFetcher = (slug: string) => Promise<SkillBundle>;
+export type TemplateCompiler = (source: string, vars: Readonly<Record<string, unknown>>) => string;
+export declare class SkillBundleTemplateNotFoundError extends Error {
+    readonly templateName: string;
+    readonly skillSlugs: readonly string[];
+    constructor(templateName: string, skillSlugs: readonly string[]);
+}
+export declare function templateResourceRelPath(templateName: string): string;
+export declare function buildSkillBundleTemplateResolver(params: {
+    readonly skillSlugs: readonly string[];
+    readonly fetchBundle: SkillBundleFetcher;
+    readonly compileTemplate: TemplateCompiler;
+}): TemplateResolver;
+//# sourceMappingURL=skill-bundle-template-resolver.d.ts.map

package/dist/lib/skill-bundle-template-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle-template-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/skill-bundle-template-resolver.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAYhD,MAAM,WAAW,mBAAmB;IAElC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAQD,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAMxE,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACpC,MAAM,CAAC;AAGZ,qBAAa,gCAAiC,SAAQ,KAAK;aAEvC,YAAY,EAAE,MAAM;aACpB,UAAU,EAAE,SAAS,MAAM,EAAE;gBAD7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,SAAS,MAAM,EAAE;CAWhD;AAMD,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEpE;AAeD,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;CAC5C,GAAG,gBAAgB,CAmCnB"}

package/dist/lib/skill-bundle-template-resolver.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillBundleTemplateNotFoundError = void 0;
+exports.templateResourceRelPath = templateResourceRelPath;
+exports.buildSkillBundleTemplateResolver = buildSkillBundleTemplateResolver;
+const TEMPLATE_RESOURCE_PREFIX = 'assets/templates/';
+const TEMPLATE_RESOURCE_SUFFIX = '.hbs';
+class SkillBundleTemplateNotFoundError extends Error {
+    templateName;
+    skillSlugs;
+    constructor(templateName, skillSlugs) {
+        super(`Seed-file template "${templateName}" was not found as ` +
+            `"${TEMPLATE_RESOURCE_PREFIX}${templateName}${TEMPLATE_RESOURCE_SUFFIX}" ` +
+            `in any of the composition's skill bundles ` +
+            `[${skillSlugs.join(', ') || '<none>'}]. The biome that owns the ` +
+            `template must ship it inside a skill bundle the composition references.`);
+        this.templateName = templateName;
+        this.skillSlugs = skillSlugs;
+        this.name = 'SkillBundleTemplateNotFoundError';
+    }
+}
+exports.SkillBundleTemplateNotFoundError = SkillBundleTemplateNotFoundError;
+function templateResourceRelPath(templateName) {
+    return `${TEMPLATE_RESOURCE_PREFIX}${templateName}${TEMPLATE_RESOURCE_SUFFIX}`;
+}
+function buildSkillBundleTemplateResolver(params) {
+    const { skillSlugs, fetchBundle, compileTemplate } = params;
+    const uniqueSlugs = [...new Set(skillSlugs)];
+    const bundleCache = new Map();
+    const loadBundle = (slug) => {
+        const cached = bundleCache.get(slug);
+        if (cached) {
+            return cached;
+        }
+        const pending = fetchBundle(slug);
+        bundleCache.set(slug, pending);
+        return pending;
+    };
+    return {
+        async resolve(name, vars) {
+            const relPath = templateResourceRelPath(name);
+            for (const slug of uniqueSlugs) {
+                const bundle = await loadBundle(slug);
+                const resource = bundle.resources.find((r) => r.relPath === relPath);
+                if (resource) {
+                    const source = Buffer.from(resource.content, 'base64').toString('utf8');
+                    return compileTemplate(source, vars);
+                }
+            }
+            throw new SkillBundleTemplateNotFoundError(name, uniqueSlugs);
+        },
+    };
+}
+//# sourceMappingURL=skill-bundle-template-resolver.js.map

package/dist/lib/skill-bundle-template-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-bundle-template-resolver.js","sourceRoot":"","sources":["../../src/lib/skill-bundle-template-resolver.ts"],"names":[],"mappings":";;;AA0FA,0DAEC;AAeD,4EAuCC;AAvHD,MAAM,wBAAwB,GAAG,mBAAmB,CAAC;AAErD,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAyCxC,MAAa,gCAAiC,SAAQ,KAAK;IAEvC;IACA;IAFlB,YACkB,YAAoB,EACpB,UAA6B;QAE7C,KAAK,CACH,uBAAuB,YAAY,qBAAqB;YACtD,IAAI,wBAAwB,GAAG,YAAY,GAAG,wBAAwB,IAAI;YAC1E,4CAA4C;YAC5C,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,6BAA6B;YAClE,yEAAyE,CAC5E,CAAC;QATc,iBAAY,GAAZ,YAAY,CAAQ;QACpB,eAAU,GAAV,UAAU,CAAmB;QAS7C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;IACjD,CAAC;CACF;AAdD,4EAcC;AAMD,SAAgB,uBAAuB,CAAC,YAAoB;IAC1D,OAAO,GAAG,wBAAwB,GAAG,YAAY,GAAG,wBAAwB,EAAE,CAAC;AACjF,CAAC;AAeD,SAAgB,gCAAgC,CAAC,MAIhD;IACC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC;IAE5D,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAgC,CAAC;IAE5D,MAAM,UAAU,GAAG,CAAC,IAAY,EAAwB,EAAE;QACxD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAClC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,IAAuC;YAEvC,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;gBACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;gBACrE,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAC7D,MAAM,CACP,CAAC;oBACF,OAAO,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACvC,CAAC;YACH,CAAC;YACD,MAAM,IAAI,gCAAgC,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,141 @@
+import type { WorkspaceMountPlan } from '@xemahq/kernel-contracts/agent-workspace';
+import type { CompiledWorkspaceManifest } from '@xemahq/dsl/workspace-manifest';
+import type { AgentRunRole, Briefcase } from '@xemahq/kernel-contracts/workflow';
+export interface WorkerAllocation {
+    readonly proxyUrl: string;
+    readonly password: string;
+    readonly allocationId: string;
+}
+export interface ComposeWorkspaceImageRequest {
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly manifest: CompiledWorkspaceManifest;
+    readonly agentContext: Readonly<Record<string, unknown>>;
+    readonly workflowRun?: {
+        readonly runId: string;
+        readonly jobRunId: string;
+    };
+    readonly interactive?: {
+        readonly sessionId: string;
+        readonly turnGen?: number;
+    };
+    readonly agentOverrides?: {
+        readonly role?: AgentRunRole;
+        readonly deliverableSpecRef?: string;
+    };
+    readonly templateResolver?: TemplateResolver;
+    readonly systemSkillSlugs?: readonly string[];
+    readonly briefcase?: Briefcase;
+}
+export interface TemplateResolver {
+    resolve(name: string, vars: Readonly<Record<string, unknown>>): Promise<string>;
+}
+export interface DrivePromptParams {
+    readonly prompt: string;
+    readonly agentSlug: string;
+    readonly sessionId: string;
+    readonly outputFormat?: AgentOutputFormat;
+    readonly modelOverride?: PromptModelOverride;
+}
+export interface PromptModelOverride {
+    readonly modelId: string;
+    readonly providerSlug?: string;
+    readonly opencodeProviderId?: string;
+}
+export type AgentOutputFormat = {
+    readonly type: 'text';
+} | {
+    readonly type: 'json_schema';
+    readonly schema: Readonly<Record<string, unknown>>;
+    readonly retryCount?: number;
+};
+export type SessionFrame = {
+    readonly kind: 'token';
+    readonly text: string;
+} | {
+    readonly kind: 'tool-call';
+    readonly tool: string;
+    readonly args: unknown;
+    readonly status: 'started' | 'completed' | 'error';
+    readonly toolCallId?: string;
+    readonly summary?: string;
+} | {
+    readonly kind: 'tool-result';
+    readonly tool: string;
+    readonly result: unknown;
+    readonly toolCallId?: string;
+    readonly errorMessage?: string;
+} | {
+    readonly kind: 'progress';
+    readonly stepIndex: number;
+    readonly stepCount: number | undefined;
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+} | {
+    readonly kind: 'tool_pause';
+    readonly toolName: string;
+    readonly toolRequestId: string;
+    readonly promptText: string;
+    readonly choices: readonly string[] | null;
+} | {
+    readonly kind: 'done';
+    readonly turnId: string;
+    readonly finalText: string | null;
+    readonly structuredOutput: unknown;
+};
+export interface DriveResult {
+    readonly turnId: string;
+    readonly stepCount: number;
+    readonly completed: boolean;
+    readonly finalText: string | null;
+    readonly structuredOutput: unknown;
+}
+export interface ApplyWorkspaceImageResult {
+    readonly applyId: string;
+    readonly outcome: 'applied' | 'idempotent';
+    readonly leaseKey: string;
+    readonly entries: ReadonlyArray<{
+        readonly mountKey: string;
+        readonly slot: string;
+        readonly relPath: string;
+        readonly status: 'resolved' | 'applied' | 'failed';
+        readonly bytesWritten: number;
+        readonly errorCode?: string;
+        readonly errorMessage?: string;
+    }>;
+}
+export interface AgentSessionRuntime {
+    readonly composer: WorkspaceImageComposer;
+    readonly applier: WorkspaceImageApplier;
+    readonly driver: AgentSessionDriver;
+}
+export interface WorkspaceImageComposer {
+    compose(req: ComposeWorkspaceImageRequest): Promise<WorkspaceMountPlan>;
+}
+export interface WorkspaceImageApplier {
+    apply(allocation: WorkerAllocation, plan: WorkspaceMountPlan, abortSignal?: AbortSignal): Promise<ApplyWorkspaceImageResult>;
+}
+export type OnAgentToolPauseHook = (frame: {
+    readonly toolName: string;
+    readonly toolRequestId: string;
+    readonly promptText: string;
+    readonly choices: readonly string[] | null;
+}) => Promise<{
+    readonly replyPayload: unknown;
+} | null>;
+export interface DriveToCompletionOptions {
+    readonly onAgentToolPause?: OnAgentToolPauseHook;
+    readonly onFrame?: (frame: SessionFrame) => void;
+    readonly onTokenUsage?: (usage: {
+        readonly totalTokens: number;
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+        readonly reasoningTokens: number;
+    }) => void;
+}
+export interface AgentSessionDriver {
+    drive(allocation: WorkerAllocation, params: DrivePromptParams, abortSignal: AbortSignal): AsyncIterable<SessionFrame>;
+    driveToCompletion(allocation: WorkerAllocation, params: DrivePromptParams, abortSignal: AbortSignal, options?: DriveToCompletionOptions): Promise<DriveResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

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

package/dist/lib/types.js

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

package/dist/lib/types.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@xemahq/agent-session-runtime",
+  "version": "0.1.1",
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "xema-source": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./dispatch-contract": {
+      "types": "./dist/lib/dispatch-contract.d.ts",
+      "xema-source": "./src/lib/dispatch-contract.ts",
+      "default": "./dist/lib/dispatch-contract.js"
+    },
+    "./package.json": "./package.json",
+    "./dist/lib/*": {
+      "types": "./dist/lib/*.d.ts",
+      "default": "./dist/lib/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "@types/node": "25.2.3",
+    "prettier": "3.6.2",
+    "typescript": "5.9.3"
+  },
+  "dependencies": {
+    "@xemahq/dsl": "^0.1.1",
+    "@xemahq/kernel-contracts": "^0.2.0"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}