@xemahq/agent-session-runtime 0.1.1

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

@@ -0,0 +1,44 @@
+import { type CompiledWorkspaceManifest } from '@xemahq/dsl/workspace-manifest';
+export type { CompiledWorkspaceManifest };
+export declare class CompositionMountLayoutError extends Error {
+    constructor(compositionRef: string, detail: string);
+}
+export interface CompositionAgentRunConfigInput {
+    readonly phase: string;
+    readonly role: string;
+    readonly deliverableSpecRef?: string;
+}
+export interface CompositionMountLayoutInput {
+    readonly mounts: Readonly<Record<string, unknown>>;
+    readonly agentRunConfig: CompositionAgentRunConfigInput;
+    readonly seedFiles: readonly unknown[];
+    readonly inputs: Readonly<Record<string, unknown>>;
+}
+export interface CompositionSubAgentBindingInput {
+    readonly slug: string;
+    readonly alias?: string;
+}
+export interface CompositionOutputSurfaceInput {
+    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 CompositionManifestSource {
+    readonly compositionRef: string;
+    readonly primaryAgentSlug: string;
+    readonly subAgentBindings: readonly CompositionSubAgentBindingInput[];
+    readonly mountLayout: CompositionMountLayoutInput | undefined;
+    readonly outputSurface?: CompositionOutputSurfaceInput;
+}
+export interface CompositionManifestImplicitInputs {
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly sessionId?: string;
+}
+export declare function compileCompositionWorkspaceManifest(source: CompositionManifestSource, bindInputs: Readonly<Record<string, unknown>>): CompiledWorkspaceManifest;
+export declare function buildCompositionManifestBindInputs(source: CompositionManifestSource, explicitInputs: Record<string, unknown> | null, implicitInputs: CompositionManifestImplicitInputs): 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":"AAkCA,OAAO,EAEL,KAAK,yBAAyB,EAQ/B,MAAM,gCAAgC,CAAC;AAMxC,YAAY,EAAE,yBAAyB,EAAE,CAAC;AAQ1C,qBAAa,2BAA4B,SAAQ,KAAK;gBACxC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOnD;AAOD,MAAM,WAAW,8BAA8B;IAE7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAKtB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AASD,MAAM,WAAW,2BAA2B;IAE1C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEnD,QAAQ,CAAC,cAAc,EAAE,8BAA8B,CAAC;IAExD,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAC;IAEvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAMD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAcD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAOD,MAAM,WAAW,yBAAyB;IAExC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAElC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,+BAA+B,EAAE,CAAC;IAMtE,QAAQ,CAAC,WAAW,EAAE,2BAA2B,GAAG,SAAS,CAAC;IAU9D,QAAQ,CAAC,aAAa,CAAC,EAAE,6BAA6B,CAAC;CACxD;AAaD,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAwBD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,yBAAyB,EACjC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC5C,yBAAyB,CAoF3B;AA4CD,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,EACjC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAC9C,cAAc,EAAE,iCAAiC,GAChD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6CnC"}

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

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompositionMountLayoutError = void 0;
+exports.compileCompositionWorkspaceManifest = compileCompositionWorkspaceManifest;
+exports.buildCompositionManifestBindInputs = buildCompositionManifestBindInputs;
+const workflow_1 = require("@xemahq/kernel-contracts/workflow");
+const workspace_manifest_1 = require("@xemahq/dsl/workspace-manifest");
+class CompositionMountLayoutError extends Error {
+    constructor(compositionRef, detail) {
+        super(`Cannot derive a workspace mount layout from Agent Composition ` +
+            `"${compositionRef}": ${detail}`);
+        this.name = 'CompositionMountLayoutError';
+    }
+}
+exports.CompositionMountLayoutError = CompositionMountLayoutError;
+function compileCompositionWorkspaceManifest(source, bindInputs) {
+    const mountLayout = source.mountLayout;
+    if (!mountLayout) {
+        throw new CompositionMountLayoutError(source.compositionRef, '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] = splitCompositionRef(source.compositionRef);
+    const subAgents = source.subAgentBindings.map((binding) => ({
+        slug: binding.slug,
+        ...(binding.alias !== undefined ? { alias: binding.alias } : {}),
+    }));
+    const outputSurface = projectOutputSurface(source.outputSurface);
+    const spec = {
+        mounts: mountLayout.mounts,
+        agent: {
+            slug: source.primaryAgentSlug,
+            phase: mountLayout.agentRunConfig.phase,
+            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 }),
+    };
+    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 CompositionMountLayoutError(source.compositionRef, `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 buildCompositionManifestBindInputs(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 CompositionMountLayoutError(source.compositionRef, '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 CompositionMountLayoutError(source.compositionRef, `manifest inputs contain undeclared key "${key}"`);
+        }
+        assertManifestInputValue(source.compositionRef, 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 splitCompositionRef(ref) {
+    const at = ref.lastIndexOf('@');
+    if (at <= 0 || at === ref.length - 1) {
+        throw new CompositionMountLayoutError(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(compositionRef, key, value) {
+    if (value !== null &&
+        typeof value !== 'string' &&
+        typeof value !== 'number' &&
+        typeof value !== 'boolean' &&
+        !Array.isArray(value)) {
+        throw new CompositionMountLayoutError(compositionRef, `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 CompositionMountLayoutError(compositionRef, `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/dist/lib/dispatch-contract.d.ts

@@ -0,0 +1,48 @@
+import type { ArtifactRef } from '@xemahq/kernel-contracts/workflow';
+export declare const AgentSessionDispatchMode: {
+    readonly create_and_run: "create_and_run";
+    readonly resume_and_run: "resume_and_run";
+};
+export type AgentSessionDispatchModeValue = (typeof AgentSessionDispatchMode)[keyof typeof AgentSessionDispatchMode];
+export interface RevisionInput {
+    readonly path: string;
+    readonly contentBase64: string;
+}
+export interface DispatchPromptContext {
+    readonly prompt: string;
+    readonly revisionFilePath?: string;
+    readonly iteration: number;
+}
+export interface CreateAndRunDispatch {
+    readonly mode: typeof AgentSessionDispatchMode.create_and_run;
+    readonly pipelineRunId: string;
+    readonly jobRunId: string;
+    readonly jobKey: string;
+    readonly compositionRef: string;
+    readonly agentSlug: string;
+    readonly promptContext: DispatchPromptContext;
+}
+export interface ResumeAndRunDispatch {
+    readonly mode: typeof AgentSessionDispatchMode.resume_and_run;
+    readonly sessionId: string;
+    readonly revisionInputs: readonly RevisionInput[];
+    readonly promptContext: DispatchPromptContext;
+}
+export type AgentSessionDispatchRequest = CreateAndRunDispatch | ResumeAndRunDispatch;
+export interface AgentSessionDispatchResponse {
+    readonly sessionId: string;
+    readonly snapshotGeneration: number;
+    readonly pausedAt: string;
+    readonly deliverables: readonly ArtifactRef[];
+    readonly structuredOutput: unknown;
+    readonly response: ArtifactRef | null;
+}
+export interface InputsAppendRequest {
+    readonly path: string;
+    readonly contentBase64: string;
+}
+export interface InputsAppendResponse {
+    readonly written: boolean;
+    readonly sha256: string;
+}
+//# sourceMappingURL=dispatch-contract.d.ts.map

package/dist/lib/dispatch-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-contract.d.ts","sourceRoot":"","sources":["../../src/lib/dispatch-contract.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAMrE,eAAO,MAAM,wBAAwB;;;CAK3B,CAAC;AAEX,MAAM,MAAM,6BAA6B,GACvC,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AAa3E,MAAM,WAAW,aAAa;IAM5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAQD,MAAM,WAAW,qBAAqB;IAEpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAMxB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAKnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC,cAAc,CAAC;IAE9D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IASxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;CAC/C;AAOD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,wBAAwB,CAAC,cAAc,CAAC;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;CAC/C;AAED,MAAM,MAAM,2BAA2B,GACnC,oBAAoB,GACpB,oBAAoB,CAAC;AAUzB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAK9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAKnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC;AAQD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/lib/dispatch-contract.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSessionDispatchMode = void 0;
+exports.AgentSessionDispatchMode = {
+    create_and_run: 'create_and_run',
+    resume_and_run: 'resume_and_run',
+};
+//# sourceMappingURL=dispatch-contract.js.map

package/dist/lib/dispatch-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-contract.js","sourceRoot":"","sources":["../../src/lib/dispatch-contract.ts"],"names":[],"mappings":";;;AAoBa,QAAA,wBAAwB,GAAG;IAEtC,cAAc,EAAE,gBAAgB;IAEhC,cAAc,EAAE,gBAAgB;CACxB,CAAC"}

package/dist/lib/drift-detector.d.ts

@@ -0,0 +1,40 @@
+import type { ResolvedEnvironment } from './environment-resolver';
+export declare enum DriftKind {
+    AGENT_CHANGED = "agent-changed",
+    ROLE_CHANGED = "role-changed",
+    MANIFEST_VERSION_CHANGED = "manifest-version-changed",
+    MODEL_CHANGED = "model-changed",
+    SUBAGENT_ADDED = "subagent-added",
+    SUBAGENT_REMOVED = "subagent-removed",
+    SUBAGENT_MODEL_CHANGED = "subagent-model-changed",
+    SKILL_ADDED = "skill-added",
+    SKILL_REMOVED = "skill-removed",
+    SKILL_VERSION_CHANGED = "skill-version-changed",
+    TOOL_SELECTION_ADDED = "tool-selection-added",
+    TOOL_SELECTION_REMOVED = "tool-selection-removed",
+    CREDENTIAL_ADDED = "credential-added",
+    CREDENTIAL_REMOVED = "credential-removed",
+    CREDENTIAL_KIND_CHANGED = "credential-kind-changed",
+    PERMISSION_TIGHTENED = "permission-tightened",
+    PERMISSION_RELAXED = "permission-relaxed",
+    PERSISTENCE_PATH_ADDED = "persistence-path-added",
+    PERSISTENCE_PATH_REMOVED = "persistence-path-removed",
+    OUTPUT_SURFACE_CHANGED = "output-surface-changed",
+    ENV_VAR_ADDED = "env-var-added",
+    ENV_VAR_REMOVED = "env-var-removed",
+    ENV_VAR_VALUE_CHANGED = "env-var-value-changed",
+    MOUNT_ADDED = "mount-added",
+    MOUNT_REMOVED = "mount-removed",
+    MOUNT_MODE_CHANGED = "mount-mode-changed"
+}
+export type DriftSeverity = 'info' | 'warning';
+export interface EnvironmentDrift {
+    readonly kind: DriftKind;
+    readonly severity: DriftSeverity;
+    readonly path: string;
+    readonly before?: unknown;
+    readonly after?: unknown;
+    readonly message: string;
+}
+export declare function diffResolvedEnvironment(prev: ResolvedEnvironment, next: ResolvedEnvironment): readonly EnvironmentDrift[];
+//# sourceMappingURL=drift-detector.d.ts.map

package/dist/lib/drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-detector.d.ts","sourceRoot":"","sources":["../../src/lib/drift-detector.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,oBAAY,SAAS;IACnB,aAAa,kBAAkB;IAC/B,YAAY,iBAAiB;IAC7B,wBAAwB,6BAA6B;IACrD,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,sBAAsB,2BAA2B;IACjD,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,qBAAqB,0BAA0B;IAC/C,oBAAoB,yBAAyB;IAC7C,sBAAsB,2BAA2B;IACjD,gBAAgB,qBAAqB;IACrC,kBAAkB,uBAAuB;IACzC,uBAAuB,4BAA4B;IACnD,oBAAoB,yBAAyB;IAC7C,kBAAkB,uBAAuB;IACzC,sBAAsB,2BAA2B;IACjD,wBAAwB,6BAA6B;IACrD,sBAAsB,2BAA2B;IACjD,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,qBAAqB,0BAA0B;IAC/C,WAAW,gBAAgB;IAC3B,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;CAC1C;AAQD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAYD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,EACzB,IAAI,EAAE,mBAAmB,GACxB,SAAS,gBAAgB,EAAE,CAiB7B"}