@xemahq/kernel-contracts 0.1.0

package/dist/workflow/lib/mount-plan.d.ts

@@ -0,0 +1,105 @@
+export interface MountPlan {
+    readonly readOnly: readonly MountDeclaration[];
+    readonly readWrite: readonly MountDeclaration[];
+}
+export interface MountDeclaration {
+    readonly key: string;
+}
+export interface ResolvedMountPlan {
+    readonly readOnly: readonly ResolvedMount[];
+    readonly readWrite: readonly ResolvedMount[];
+}
+export interface ResolvedMount {
+    readonly key: string;
+    readonly source: MountSource;
+}
+import type { AgentRunRole } from './agent-role';
+export type { AgentRunRole };
+export type MountSource = {
+    readonly kind: 'artifact-store-collection';
+    readonly collectionId: string;
+} | {
+    readonly kind: 'artifact-version';
+    readonly artifactId: string;
+    readonly version: number;
+    readonly fileName: string;
+    readonly payloadField?: string;
+    readonly contentType?: string;
+} | {
+    readonly kind: 'kb-space';
+    readonly spaceId: string;
+} | {
+    readonly kind: 'kb-pages';
+    readonly spaceId: string;
+    readonly pageSlugs: readonly string[];
+} | {
+    readonly kind: 'scm-repo';
+    readonly repoRef: string;
+    readonly ref: string;
+} | {
+    readonly kind: 'session-attachment';
+    readonly sessionId: string;
+} | {
+    readonly kind: 'deliverable-specs';
+    readonly contractKey: string;
+} | {
+    readonly kind: 'deliverables';
+    readonly contractKey: string;
+} | {
+    readonly kind: 'static-literal';
+    readonly pathWithinWorkspace: string;
+    readonly bytes: string;
+} | {
+    readonly kind: 'agent-definition';
+    readonly orgId: string;
+    readonly agentSlug: string;
+    readonly groupKey: string;
+    readonly agentMode: 'primary' | 'subagent';
+} | {
+    readonly kind: 'skill-bundle';
+    readonly skillKey: string;
+} | {
+    readonly kind: 'instruction-section';
+    readonly orgId: string;
+    readonly sectionKey: string;
+    readonly agentSlug?: string;
+    readonly groupKey?: string;
+} | ({
+    readonly kind: 'rendered-agents-md';
+} & RenderedAgentRunContextParams) | ({
+    readonly kind: 'rendered-system-overlay';
+} & RenderedAgentRunContextParams) | ({
+    readonly kind: 'rendered-context-json';
+} & RenderedAgentRunContextParams);
+export interface RenderedAgentRunContextParams {
+    readonly orgId: string;
+    readonly projectId: string;
+    readonly agentSlug: string;
+    readonly groupKey: string;
+    readonly role: AgentRunRole;
+    readonly sessionId?: string;
+    readonly runId?: string;
+    readonly jobRunId?: string;
+    readonly deliverableSpecRef?: string;
+    readonly workflowInputs?: Readonly<Record<string, unknown>>;
+    readonly mounts?: ReadonlyArray<{
+        readonly mount: string;
+        readonly mode: 'read-only' | 'read-write';
+    }>;
+    readonly inputArtifacts?: ReadonlyArray<{
+        readonly path: string;
+        readonly contentType?: string;
+        readonly sourceArtifactId: string;
+        readonly sourceVersion: number;
+    }>;
+    readonly workingFiles?: ReadonlyArray<{
+        readonly slug: string;
+        readonly path: string;
+        readonly format: 'markdown' | 'html' | 'json' | 'yaml' | 'text';
+        readonly syncDirection: 'down-only' | 'up-only' | 'bidirectional';
+        readonly sourceKind: string;
+        readonly sourceRef: Readonly<Record<string, string>>;
+    }>;
+    readonly hasRetryContext?: boolean;
+}
+//# sourceMappingURL=mount-plan.d.ts.map

package/dist/workflow/lib/mount-plan.d.ts.map

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

package/dist/workflow/lib/mount-plan.js

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

package/dist/workflow/lib/mount-plan.js.map

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

package/dist/workflow/lib/phase-report.d.ts

@@ -0,0 +1,9 @@
+export declare const COMPLEXITY_TIERS: readonly ["simple", "standard", "complex", "enterprise"];
+export type ComplexityTier = (typeof COMPLEXITY_TIERS)[number];
+export declare const COMPLEXITY_TIER_SET: ReadonlySet<string>;
+export declare function parseComplexityTier(value: string | null | undefined): ComplexityTier | undefined;
+export declare const COMPLEXITY_TIERS_WITH_AUTO: readonly ["auto", "simple", "standard", "complex", "enterprise"];
+export type ComplexityTierOrAuto = (typeof COMPLEXITY_TIERS_WITH_AUTO)[number];
+export declare const COMPLEXITY_TIER_OR_AUTO_SET: ReadonlySet<string>;
+export declare function parseComplexityTierOrAuto(value: string | null | undefined): ComplexityTierOrAuto | undefined;
+//# sourceMappingURL=phase-report.d.ts.map

package/dist/workflow/lib/phase-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-report.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/phase-report.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,gBAAgB,0DAKnB,CAAC;AAGX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAG/D,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAEnD,CAAC;AAMF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,cAAc,GAAG,SAAS,CAK5B;AAMD,eAAO,MAAM,0BAA0B,kEAG7B,CAAC;AAGX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAG/E,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAE3D,CAAC;AAMF,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,oBAAoB,GAAG,SAAS,CAKlC"}

package/dist/workflow/lib/phase-report.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPLEXITY_TIER_OR_AUTO_SET = exports.COMPLEXITY_TIERS_WITH_AUTO = exports.COMPLEXITY_TIER_SET = exports.COMPLEXITY_TIERS = void 0;
+exports.parseComplexityTier = parseComplexityTier;
+exports.parseComplexityTierOrAuto = parseComplexityTierOrAuto;
+exports.COMPLEXITY_TIERS = [
+    'simple',
+    'standard',
+    'complex',
+    'enterprise',
+];
+exports.COMPLEXITY_TIER_SET = new Set(exports.COMPLEXITY_TIERS);
+function parseComplexityTier(value) {
+    if (value && exports.COMPLEXITY_TIER_SET.has(value)) {
+        return value;
+    }
+    return undefined;
+}
+exports.COMPLEXITY_TIERS_WITH_AUTO = [
+    'auto',
+    ...exports.COMPLEXITY_TIERS,
+];
+exports.COMPLEXITY_TIER_OR_AUTO_SET = new Set(exports.COMPLEXITY_TIERS_WITH_AUTO);
+function parseComplexityTierOrAuto(value) {
+    if (value && exports.COMPLEXITY_TIER_OR_AUTO_SET.has(value)) {
+        return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=phase-report.js.map

package/dist/workflow/lib/phase-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-report.js","sourceRoot":"","sources":["../../../src/workflow/lib/phase-report.ts"],"names":[],"mappings":";;;AA4BA,kDAOC;AAuBD,8DAOC;AAxDY,QAAA,gBAAgB,GAAG;IAC9B,QAAQ;IACR,UAAU;IACV,SAAS;IACT,YAAY;CACJ,CAAC;AAME,QAAA,mBAAmB,GAAwB,IAAI,GAAG,CAC7D,wBAAgB,CACjB,CAAC;AAMF,SAAgB,mBAAmB,CACjC,KAAgC;IAEhC,IAAI,KAAK,IAAI,2BAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,KAAuB,CAAC;IACjC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAMY,QAAA,0BAA0B,GAAG;IACxC,MAAM;IACN,GAAG,wBAAgB;CACX,CAAC;AAME,QAAA,2BAA2B,GAAwB,IAAI,GAAG,CACrE,kCAA0B,CAC3B,CAAC;AAMF,SAAgB,yBAAyB,CACvC,KAAgC;IAEhC,IAAI,KAAK,IAAI,mCAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,KAA6B,CAAC;IACvC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/workflow/lib/platform-task-queue.d.ts

@@ -0,0 +1,17 @@
+export declare enum PlatformWorkflowDomain {
+    SESSION_LIFECYCLE = "session-lifecycle",
+    SESSION_MAINTENANCE = "session-maintenance",
+    STUDIO = "studio",
+    DOCUMENTS = "documents",
+    SCM_INGESTION = "scm-ingestion",
+    WORKLOAD = "workload",
+    INTEGRATION_SYNC = "integration-sync",
+    INTEGRATION_LIFECYCLE = "integration-lifecycle",
+    BIOME_LIFECYCLE = "biome-lifecycle",
+    INTEGRATION_INGRESS = "integration-ingress",
+    KNOWLEDGE_BASE = "knowledge-base"
+}
+export declare const PLATFORM_TASK_QUEUE_PREFIX = "xema-platform.";
+export declare function platformTaskQueue(domain: PlatformWorkflowDomain): string;
+export declare function platformWorkflowDomainOfQueue(taskQueue: string): PlatformWorkflowDomain | null;
+//# sourceMappingURL=platform-task-queue.d.ts.map

package/dist/workflow/lib/platform-task-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-task-queue.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/platform-task-queue.ts"],"names":[],"mappings":"AAqBA,oBAAY,sBAAsB;IAEhC,iBAAiB,sBAAsB;IAEvC,mBAAmB,wBAAwB;IAE3C,MAAM,WAAW;IAEjB,SAAS,cAAc;IAEvB,aAAa,kBAAkB;IAE/B,QAAQ,aAAa;IAErB,gBAAgB,qBAAqB;IAMrC,qBAAqB,0BAA0B;IAE/C,eAAe,oBAAoB;IAKnC,mBAAmB,wBAAwB;IAK3C,cAAc,mBAAmB;CAClC;AAGD,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAO3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAExE;AAMD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,GAChB,sBAAsB,GAAG,IAAI,CAQ/B"}

package/dist/workflow/lib/platform-task-queue.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_TASK_QUEUE_PREFIX = exports.PlatformWorkflowDomain = void 0;
+exports.platformTaskQueue = platformTaskQueue;
+exports.platformWorkflowDomainOfQueue = platformWorkflowDomainOfQueue;
+var PlatformWorkflowDomain;
+(function (PlatformWorkflowDomain) {
+    PlatformWorkflowDomain["SESSION_LIFECYCLE"] = "session-lifecycle";
+    PlatformWorkflowDomain["SESSION_MAINTENANCE"] = "session-maintenance";
+    PlatformWorkflowDomain["STUDIO"] = "studio";
+    PlatformWorkflowDomain["DOCUMENTS"] = "documents";
+    PlatformWorkflowDomain["SCM_INGESTION"] = "scm-ingestion";
+    PlatformWorkflowDomain["WORKLOAD"] = "workload";
+    PlatformWorkflowDomain["INTEGRATION_SYNC"] = "integration-sync";
+    PlatformWorkflowDomain["INTEGRATION_LIFECYCLE"] = "integration-lifecycle";
+    PlatformWorkflowDomain["BIOME_LIFECYCLE"] = "biome-lifecycle";
+    PlatformWorkflowDomain["INTEGRATION_INGRESS"] = "integration-ingress";
+    PlatformWorkflowDomain["KNOWLEDGE_BASE"] = "knowledge-base";
+})(PlatformWorkflowDomain || (exports.PlatformWorkflowDomain = PlatformWorkflowDomain = {}));
+exports.PLATFORM_TASK_QUEUE_PREFIX = 'xema-platform.';
+function platformTaskQueue(domain) {
+    return `${exports.PLATFORM_TASK_QUEUE_PREFIX}${domain}`;
+}
+function platformWorkflowDomainOfQueue(taskQueue) {
+    if (!taskQueue.startsWith(exports.PLATFORM_TASK_QUEUE_PREFIX)) {
+        return null;
+    }
+    const domain = taskQueue.slice(exports.PLATFORM_TASK_QUEUE_PREFIX.length);
+    return Object.values(PlatformWorkflowDomain).includes(domain)
+        ? domain
+        : null;
+}
+//# sourceMappingURL=platform-task-queue.js.map

package/dist/workflow/lib/platform-task-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-task-queue.js","sourceRoot":"","sources":["../../../src/workflow/lib/platform-task-queue.ts"],"names":[],"mappings":";;;AAgEA,8CAEC;AAMD,sEAUC;AA7DD,IAAY,sBAiCX;AAjCD,WAAY,sBAAsB;IAEhC,iEAAuC,CAAA;IAEvC,qEAA2C,CAAA;IAE3C,2CAAiB,CAAA;IAEjB,iDAAuB,CAAA;IAEvB,yDAA+B,CAAA;IAE/B,+CAAqB,CAAA;IAErB,+DAAqC,CAAA;IAMrC,yEAA+C,CAAA;IAE/C,6DAAmC,CAAA;IAKnC,qEAA2C,CAAA;IAK3C,2DAAiC,CAAA;AACnC,CAAC,EAjCW,sBAAsB,sCAAtB,sBAAsB,QAiCjC;AAGY,QAAA,0BAA0B,GAAG,gBAAgB,CAAC;AAO3D,SAAgB,iBAAiB,CAAC,MAA8B;IAC9D,OAAO,GAAG,kCAA0B,GAAG,MAAM,EAAE,CAAC;AAClD,CAAC;AAMD,SAAgB,6BAA6B,CAC3C,SAAiB;IAEjB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,kCAA0B,CAAC,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,kCAA0B,CAAC,MAAM,CAAC,CAAC;IAClE,OAAQ,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAc,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzE,CAAC,CAAE,MAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/workflow/lib/review-subject/index.d.ts

@@ -0,0 +1,5 @@
+export { ReviewSubjectKind } from './kinds';
+export { narrowReviewableContent, type ReviewableSubject } from './narrow';
+export { type ArtifactRefReviewSubject } from './producers/artifact-ref';
+export { type StringReviewSubject } from './producers/string';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflow/lib/review-subject/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE3E,OAAO,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/workflow/lib/review-subject/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.narrowReviewableContent = exports.ReviewSubjectKind = void 0;
+var kinds_1 = require("./kinds");
+Object.defineProperty(exports, "ReviewSubjectKind", { enumerable: true, get: function () { return kinds_1.ReviewSubjectKind; } });
+var narrow_1 = require("./narrow");
+Object.defineProperty(exports, "narrowReviewableContent", { enumerable: true, get: function () { return narrow_1.narrowReviewableContent; } });
+//# sourceMappingURL=index.js.map

package/dist/workflow/lib/review-subject/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/index.ts"],"names":[],"mappings":";;;AAUA,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAC1B,mCAA2E;AAAlE,iHAAA,uBAAuB,OAAA"}

package/dist/workflow/lib/review-subject/kinds.d.ts

@@ -0,0 +1,5 @@
+export declare enum ReviewSubjectKind {
+    ARTIFACT_REF = "artifact-ref",
+    STRING = "string"
+}
+//# sourceMappingURL=kinds.d.ts.map

package/dist/workflow/lib/review-subject/kinds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/kinds.ts"],"names":[],"mappings":"AAaA,oBAAY,iBAAiB;IAU3B,YAAY,iBAAiB;IAM7B,MAAM,WAAW;CAClB"}

package/dist/workflow/lib/review-subject/kinds.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewSubjectKind = void 0;
+var ReviewSubjectKind;
+(function (ReviewSubjectKind) {
+    ReviewSubjectKind["ARTIFACT_REF"] = "artifact-ref";
+    ReviewSubjectKind["STRING"] = "string";
+})(ReviewSubjectKind || (exports.ReviewSubjectKind = ReviewSubjectKind = {}));
+//# sourceMappingURL=kinds.js.map

package/dist/workflow/lib/review-subject/kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinds.js","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/kinds.ts"],"names":[],"mappings":";;;AAaA,IAAY,iBAiBX;AAjBD,WAAY,iBAAiB;IAU3B,kDAA6B,CAAA;IAM7B,sCAAiB,CAAA;AACnB,CAAC,EAjBW,iBAAiB,iCAAjB,iBAAiB,QAiB5B"}

package/dist/workflow/lib/review-subject/narrow.d.ts

@@ -0,0 +1,5 @@
+import { type ArtifactRefReviewSubject } from './producers/artifact-ref';
+import { type StringReviewSubject } from './producers/string';
+export type ReviewableSubject = ArtifactRefReviewSubject | StringReviewSubject;
+export declare function narrowReviewableContent(subject: unknown): ReviewableSubject;
+//# sourceMappingURL=narrow.d.ts.map

package/dist/workflow/lib/review-subject/narrow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrow.d.ts","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/narrow.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,KAAK,wBAAwB,EAG9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,KAAK,mBAAmB,EAAgB,MAAM,oBAAoB,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GACzB,wBAAwB,GACxB,mBAAmB,CAAC;AAQxB,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAkB3E"}

package/dist/workflow/lib/review-subject/narrow.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.narrowReviewableContent = narrowReviewableContent;
+const artifact_ref_1 = require("./producers/artifact-ref");
+const kinds_1 = require("./kinds");
+const string_1 = require("./producers/string");
+function narrowReviewableContent(subject) {
+    if (typeof subject === 'string') {
+        return (0, string_1.narrowString)(subject);
+    }
+    if ((0, artifact_ref_1.looksLikeArtifactRef)(subject)) {
+        return (0, artifact_ref_1.narrowArtifactRef)(subject);
+    }
+    if (looksLikeArtifactRefReviewSubject(subject)) {
+        return (0, artifact_ref_1.narrowArtifactRef)(coerceWrappedArtifactRef(subject.ref));
+    }
+    if (looksLikeStringReviewSubject(subject)) {
+        return (0, string_1.narrowString)(subject.value);
+    }
+    throw new Error(`narrowReviewableContent: unrecognized subject shape (expected string or ArtifactRef). ` +
+        `Activities must promote reviewable content to an artifact via finalizeOutputs before review. ` +
+        `Received: ${describeSubject(subject)}`);
+}
+function looksLikeArtifactRefReviewSubject(value) {
+    if (value === null || typeof value !== 'object') {
+        return false;
+    }
+    const rec = value;
+    return (rec.kind === kinds_1.ReviewSubjectKind.ARTIFACT_REF &&
+        ((0, artifact_ref_1.looksLikeArtifactRef)(rec.ref) || looksLikePinnedSubjectArtifact(rec.ref)));
+}
+function looksLikePinnedSubjectArtifact(value) {
+    if (value === null || typeof value !== 'object') {
+        return false;
+    }
+    const rec = value;
+    return (typeof rec.artifactId === 'string' &&
+        typeof rec.versionId === 'string' &&
+        typeof rec.version === 'number' &&
+        Number.isInteger(rec.version) &&
+        typeof rec.hash === 'string');
+}
+function coerceWrappedArtifactRef(value) {
+    if ((0, artifact_ref_1.looksLikeArtifactRef)(value)) {
+        return value;
+    }
+    if (looksLikePinnedSubjectArtifact(value)) {
+        const rec = value;
+        return {
+            artifactId: rec.artifactId,
+            versionId: rec.versionId,
+            version: rec.version,
+            hash: rec.hash,
+            type: 'unknown',
+        };
+    }
+    throw new Error(`narrowReviewableContent: wrapped artifact-ref subject contains invalid ref shape. Received: ${describeSubject(value)}`);
+}
+function looksLikeStringReviewSubject(value) {
+    if (value === null || typeof value !== 'object') {
+        return false;
+    }
+    const rec = value;
+    return (rec.kind === kinds_1.ReviewSubjectKind.STRING && typeof rec.value === 'string');
+}
+function describeSubject(subject) {
+    if (subject === null)
+        return 'null';
+    if (subject === undefined)
+        return 'undefined';
+    if (Array.isArray(subject))
+        return `Array(${subject.length})`;
+    if (typeof subject === 'object') {
+        const keys = Object.keys(subject).slice(0, 8);
+        return `object{${keys.join(',')}}`;
+    }
+    return typeof subject;
+}
+//# sourceMappingURL=narrow.js.map

package/dist/workflow/lib/review-subject/narrow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrow.js","sourceRoot":"","sources":["../../../../src/workflow/lib/review-subject/narrow.ts"],"names":[],"mappings":";;AAqCA,0DAkBC;AArCD,2DAIkC;AAElC,mCAA4C;AAC5C,+CAA4E;AAY5E,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,IAAA,qBAAY,EAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAA,mCAAoB,EAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,IAAA,gCAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,iCAAiC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAA,gCAAiB,EAAC,wBAAwB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAA,qBAAY,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IACD,MAAM,IAAI,KAAK,CACb,wFAAwF;QACtF,+FAA+F;QAC/F,aAAa,eAAe,CAAC,OAAO,CAAC,EAAE,CAC1C,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,KAAc;IAEd,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,yBAAiB,CAAC,YAAY;QAC3C,CAAC,IAAA,mCAAoB,EAAC,GAAG,CAAC,GAAG,CAAC,IAAI,8BAA8B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAC3E,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CAAC,KAAc;IACpD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ;QAClC,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QACjC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;QAC/B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;QAC7B,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,IAAA,mCAAoB,EAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,8BAA8B,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,UAAoB;YACpC,SAAS,EAAE,GAAG,CAAC,SAAmB;YAClC,OAAO,EAAE,GAAG,CAAC,OAAiB;YAC9B,IAAI,EAAE,GAAG,CAAC,IAAc;YACxB,IAAI,EAAE,SAAS;SAChB,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CACb,+FAA+F,eAAe,CAAC,KAAK,CAAC,EAAE,CACxH,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,KAAc;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,yBAAiB,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,CACvE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,OAAO,CAAC,MAAM,GAAG,CAAC;IAC9D,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,OAAO,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,OAAO,CAAC;AACxB,CAAC"}

package/dist/workflow/lib/review-subject/producers/artifact-ref.d.ts

@@ -0,0 +1,9 @@
+import { type ArtifactRef } from '../../artifact-ref';
+import { ReviewSubjectKind } from '../kinds';
+export interface ArtifactRefReviewSubject {
+    readonly kind: ReviewSubjectKind.ARTIFACT_REF;
+    readonly ref: ArtifactRef;
+}
+export declare function looksLikeArtifactRef(value: unknown): value is ArtifactRef;
+export declare function narrowArtifactRef(ref: ArtifactRef): ArtifactRefReviewSubject;
+//# sourceMappingURL=artifact-ref.d.ts.map

package/dist/workflow/lib/review-subject/producers/artifact-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-ref.d.ts","sourceRoot":"","sources":["../../../../../src/workflow/lib/review-subject/producers/artifact-ref.ts"],"names":[],"mappings":"AAeA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,YAAY,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAEzE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,wBAAwB,CAK5E"}

package/dist/workflow/lib/review-subject/producers/artifact-ref.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.looksLikeArtifactRef = looksLikeArtifactRef;
+exports.narrowArtifactRef = narrowArtifactRef;
+const artifact_ref_1 = require("../../artifact-ref");
+const kinds_1 = require("../kinds");
+function looksLikeArtifactRef(value) {
+    return (0, artifact_ref_1.isArtifactRef)(value);
+}
+function narrowArtifactRef(ref) {
+    return {
+        kind: kinds_1.ReviewSubjectKind.ARTIFACT_REF,
+        ref,
+    };
+}
+//# sourceMappingURL=artifact-ref.js.map

package/dist/workflow/lib/review-subject/producers/artifact-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-ref.js","sourceRoot":"","sources":["../../../../../src/workflow/lib/review-subject/producers/artifact-ref.ts"],"names":[],"mappings":";;AAuBA,oDAEC;AAED,8CAKC;AAjBD,qDAAqE;AACrE,oCAA6C;AAO7C,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,IAAA,4BAAa,EAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,iBAAiB,CAAC,GAAgB;IAChD,OAAO;QACL,IAAI,EAAE,yBAAiB,CAAC,YAAY;QACpC,GAAG;KACJ,CAAC;AACJ,CAAC"}

package/dist/workflow/lib/review-subject/producers/string.d.ts

@@ -0,0 +1,7 @@
+import { ReviewSubjectKind } from '../kinds';
+export interface StringReviewSubject {
+    readonly kind: ReviewSubjectKind.STRING;
+    readonly value: string;
+}
+export declare function narrowString(value: string): StringReviewSubject;
+//# sourceMappingURL=string.d.ts.map

package/dist/workflow/lib/review-subject/producers/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../../../src/workflow/lib/review-subject/producers/string.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAK/D"}

package/dist/workflow/lib/review-subject/producers/string.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.narrowString = narrowString;
+const kinds_1 = require("../kinds");
+function narrowString(value) {
+    return {
+        kind: kinds_1.ReviewSubjectKind.STRING,
+        value,
+    };
+}
+//# sourceMappingURL=string.js.map

package/dist/workflow/lib/review-subject/producers/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../../../src/workflow/lib/review-subject/producers/string.ts"],"names":[],"mappings":";;AAkBA,oCAKC;AAZD,oCAA6C;AAO7C,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO;QACL,IAAI,EAAE,yBAAiB,CAAC,MAAM;QAC9B,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/workflow/lib/role-capability.d.ts

@@ -0,0 +1,16 @@
+import type { AgentRunRole } from './agent-role';
+export declare const INVOCATION_SURFACES: readonly ["pipeline-run", "agent-session", "design-system-builder", "gate-review"];
+export type InvocationSurface = (typeof INVOCATION_SURFACES)[number];
+export declare const WRITE_POLICIES: readonly ["read-only", "own-pages-only", "full-write"];
+export type WritePolicy = (typeof WRITE_POLICIES)[number];
+export declare const XEMA_TOOL_READ_ONLY: readonly ["xema_memory_get"];
+export declare const XEMA_TOOL_MEMORY_WRITE: readonly ["xema_memory_set"];
+export interface RoleCapabilityProfile {
+    readonly role: AgentRunRole;
+    readonly surface: InvocationSurface;
+    readonly writePolicy: WritePolicy;
+    readonly mayEditRepos: 'never' | 'when-granted';
+    readonly mayWriteKnowledgeBase: boolean;
+    readonly allowedXemaTools: readonly string[];
+}
+//# sourceMappingURL=role-capability.d.ts.map

package/dist/workflow/lib/role-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-capability.d.ts","sourceRoot":"","sources":["../../../src/workflow/lib/role-capability.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,eAAO,MAAM,mBAAmB,oFAKtB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAYrE,eAAO,MAAM,cAAc,wDAIjB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAW1D,eAAO,MAAM,mBAAmB,8BAEtB,CAAC;AAMX,eAAO,MAAM,sBAAsB,8BAA+B,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAOlC,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,cAAc,CAAC;IAChD,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C"}

package/dist/workflow/lib/role-capability.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XEMA_TOOL_MEMORY_WRITE = exports.XEMA_TOOL_READ_ONLY = exports.WRITE_POLICIES = exports.INVOCATION_SURFACES = void 0;
+exports.INVOCATION_SURFACES = [
+    'pipeline-run',
+    'agent-session',
+    'design-system-builder',
+    'gate-review',
+];
+exports.WRITE_POLICIES = [
+    'read-only',
+    'own-pages-only',
+    'full-write',
+];
+exports.XEMA_TOOL_READ_ONLY = [
+    'xema_memory_get',
+];
+exports.XEMA_TOOL_MEMORY_WRITE = ['xema_memory_set'];
+//# sourceMappingURL=role-capability.js.map

package/dist/workflow/lib/role-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-capability.js","sourceRoot":"","sources":["../../../src/workflow/lib/role-capability.ts"],"names":[],"mappings":";;;AAsBa,QAAA,mBAAmB,GAAG;IACjC,cAAc;IACd,eAAe;IACf,uBAAuB;IACvB,aAAa;CACL,CAAC;AAaE,QAAA,cAAc,GAAG;IAC5B,WAAW;IACX,gBAAgB;IAChB,YAAY;CACJ,CAAC;AAYE,QAAA,mBAAmB,GAAG;IACjC,iBAAiB;CACT,CAAC;AAME,QAAA,sBAAsB,GAAG,CAAC,iBAAiB,CAAU,CAAC"}

package/dist/workflow/lib/run-progress.d.ts

@@ -0,0 +1,100 @@
+export declare enum RunStepKind {
+    THINKING = "thinking",
+    EDITING_FILE = "editing_file",
+    RUNNING_COMMAND = "running_command",
+    READING_FILE = "reading_file",
+    SEARCHING = "searching",
+    FETCHING = "fetching",
+    VALIDATING = "validating",
+    WAITING_INPUT = "waiting_input",
+    SUMMARIZING = "summarizing",
+    POSTING_REVIEW = "posting_review",
+    PUBLISHING = "publishing",
+    OTHER = "other"
+}
+export declare enum RunActivityKind {
+    AGENT_WORK = "agent_work",
+    DELIVERABLE_VALIDATION = "deliverable_validation",
+    REVIEW_POSTING = "review_posting",
+    SCM_MERGE = "scm_merge",
+    SCM_CHECKOUT = "scm_checkout",
+    KB_PUBLISH = "kb_publish",
+    WEBHOOK = "webhook",
+    HTTP = "http",
+    DISPATCH = "dispatch",
+    ARTIFACT_EMIT = "artifact_emit",
+    RECONCILE = "reconcile",
+    ENDPOINT_FETCH = "endpoint_fetch",
+    SCHEDULED_DISPATCH = "scheduled_dispatch",
+    REVIEW = "review",
+    BACKLOG_SYNC = "backlog_sync",
+    RUN_MIGRATIONS = "run_migrations",
+    CHILD_WORKFLOW = "child_workflow"
+}
+export declare enum RunMilestonePhase {
+    STARTED = "started",
+    PROGRESSING = "progressing",
+    COMPLETED = "completed",
+    AWAITING_INPUT = "awaiting_input",
+    FAILED = "failed"
+}
+export interface RunStepAgentProfile {
+    readonly slug: string;
+    readonly displayName: string;
+    readonly avatarSeed: string;
+    readonly avatarStyle: string;
+}
+export type RunStepToolStatus = 'started' | 'completed' | 'error';
+export interface RunStepToolDetails {
+    readonly status?: RunStepToolStatus;
+    readonly tool?: string;
+    readonly toolCallId?: string;
+    readonly args?: unknown;
+    readonly output?: unknown;
+    readonly errorMessage?: string;
+}
+export interface RunStepProgressInput extends RunStepToolDetails {
+    readonly jobKey: string;
+    readonly jobRunId: string;
+    readonly agentSlug?: string;
+    readonly kind: RunStepKind;
+    readonly summary: string;
+    readonly target?: string;
+    readonly at: string;
+}
+export interface RunStepProgress extends RunStepToolDetails {
+    readonly runId: string;
+    readonly jobKey: string;
+    readonly jobRunId: string;
+    readonly agent: RunStepAgentProfile | null;
+    readonly kind: RunStepKind;
+    readonly summary: string;
+    readonly target: string | null;
+    readonly at: string;
+    readonly seq: number;
+}
+export interface RunMilestoneInput {
+    readonly jobKey: string;
+    readonly jobRunId: string;
+    readonly activity: RunActivityKind;
+    readonly phase: RunMilestonePhase;
+    readonly summary: string;
+    readonly at: string;
+    readonly agentSlug?: string;
+}
+export interface RunMilestone {
+    readonly runId: string;
+    readonly jobKey: string;
+    readonly jobRunId: string;
+    readonly agent: RunStepAgentProfile | null;
+    readonly activity: RunActivityKind;
+    readonly phase: RunMilestonePhase;
+    readonly summary: string;
+    readonly at: string;
+}
+export type AgentSessionFrameKind = 'token' | 'tool-call' | 'tool-result' | 'progress' | 'error' | 'question' | 'done';
+export declare function mapSessionFrameKindToStepKind(kind: AgentSessionFrameKind): RunStepKind;
+export declare function mapToolNameToStepKind(toolName: string): RunStepKind;
+export declare const RUN_STEP_SUMMARY_MAX = 140;
+export declare const RUN_STEP_TARGET_MAX = 240;
+//# sourceMappingURL=run-progress.d.ts.map

package/dist/workflow/lib/run-progress.d.ts.map

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