@xemahq/contracts 0.1.0

package/dist/execution-environment/lib/execution-environment.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXECUTION_ENVIRONMENT_CONTENT_HASH_DOMAIN = exports.ExecutionEnvironmentSchema = exports.MountPolicySchema = exports.BiomePolicySchema = exports.ConnectorPolicySchema = exports.KnowledgePolicySchema = exports.RuntimeLimitsSchema = exports.BUILT_IN_ENVIRONMENT_REFS = exports.ExecutionEnvironmentRefParseError = exports.ExecutionEnvironmentRefSchema = void 0;
+exports.parseEnvironmentRef = parseEnvironmentRef;
+exports.formatEnvironmentRef = formatEnvironmentRef;
+exports.createExecutionEnvironment = createExecutionEnvironment;
+exports.serializeExecutionEnvironment = serializeExecutionEnvironment;
+exports.computeExecutionEnvironmentContentHash = computeExecutionEnvironmentContentHash;
+const zod_1 = require("zod");
+const capability_1 = require("../../capability");
+const content_address_1 = require("../../content-address");
+const built_in_environments_1 = require("./built-in-environments");
+const approval_rule_1 = require("./approval-rule");
+const environment_reach_ceiling_1 = require("./environment-reach-ceiling");
+const space_1 = require("../../space");
+const EXECUTION_ENVIRONMENT_REF_REGEX = /^environment:[a-z][a-z0-9-]*$/;
+exports.ExecutionEnvironmentRefSchema = zod_1.z.string().regex(EXECUTION_ENVIRONMENT_REF_REGEX, {
+    message: 'ExecutionEnvironmentRef must match `environment:<slug>` (lowercase kebab; must start with a letter).',
+});
+class ExecutionEnvironmentRefParseError extends capability_1.CapabilityError {
+    constructor(args) {
+        super({
+            code: capability_1.CapabilityErrorCode.CapabilityRefInvalid,
+            message: args.message,
+            capability: args.raw,
+        });
+        this.name = 'ExecutionEnvironmentRefParseError';
+    }
+}
+exports.ExecutionEnvironmentRefParseError = ExecutionEnvironmentRefParseError;
+function parseEnvironmentRef(ref) {
+    if (typeof ref !== 'string' || ref.length === 0) {
+        throw new ExecutionEnvironmentRefParseError({
+            message: 'ExecutionEnvironmentRef must be a non-empty string.',
+            raw: String(ref),
+        });
+    }
+    if (!EXECUTION_ENVIRONMENT_REF_REGEX.test(ref)) {
+        throw new ExecutionEnvironmentRefParseError({
+            message: `ExecutionEnvironmentRef "${ref}" does not match \`environment:<slug>\`.`,
+            raw: ref,
+        });
+    }
+    const slug = ref.slice('environment:'.length);
+    return { slug, raw: ref };
+}
+function formatEnvironmentRef(slug) {
+    const raw = `environment:${slug}`;
+    if (!EXECUTION_ENVIRONMENT_REF_REGEX.test(raw)) {
+        throw new ExecutionEnvironmentRefParseError({
+            message: `formatEnvironmentRef produced invalid ref "${raw}".`,
+            raw,
+        });
+    }
+    return raw;
+}
+exports.BUILT_IN_ENVIRONMENT_REFS = Object.freeze(built_in_environments_1.BUILT_IN_ENVIRONMENT_SLUGS.reduce((acc, slug) => {
+    acc[slug] = formatEnvironmentRef(slug);
+    return acc;
+}, {}));
+exports.RuntimeLimitsSchema = zod_1.z.object({
+    maxTokens: zod_1.z.number().int().nonnegative().optional(),
+    maxCostUsd: zod_1.z.number().nonnegative().optional(),
+    maxDurationSeconds: zod_1.z.number().int().nonnegative().optional(),
+    maxToolCalls: zod_1.z.number().int().nonnegative().optional(),
+});
+exports.KnowledgePolicySchema = zod_1.z.object({
+    allowedRefs: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+});
+exports.ConnectorPolicySchema = zod_1.z.object({
+    allowedRefs: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+});
+exports.BiomePolicySchema = zod_1.z.object({
+    allowedRefs: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+});
+exports.MountPolicySchema = zod_1.z.object({
+    allowedRefs: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+});
+exports.ExecutionEnvironmentSchema = zod_1.z
+    .object({
+    ref: exports.ExecutionEnvironmentRefSchema,
+    scope: zod_1.z
+        .string()
+        .min(1)
+        .refine((s) => (0, built_in_environments_1.isExecutionEnvironmentKind)(s), {
+        message: 'ExecutionEnvironment.scope must be an ExecutionEnvironmentKind slug at v1; custom environments are a v2 extension.',
+    }),
+    reachCeiling: capability_1.CapabilityReachSchema,
+    allowedCapabilities: zod_1.z.array(capability_1.CapabilityPolicySchema),
+    allowedKnowledgeScopes: zod_1.z.array(exports.KnowledgePolicySchema),
+    allowedConnectors: zod_1.z.array(exports.ConnectorPolicySchema),
+    allowedBiomes: zod_1.z.array(exports.BiomePolicySchema),
+    allowedMounts: zod_1.z.array(exports.MountPolicySchema),
+    approvalRules: zod_1.z.array(approval_rule_1.ApprovalRuleSchema),
+    runtimeLimits: exports.RuntimeLimitsSchema,
+    maxDataClassification: space_1.DataClassificationSchema,
+})
+    .strict()
+    .superRefine((environment, context) => {
+    if ((0, built_in_environments_1.isExecutionEnvironmentKind)(environment.scope) &&
+        environment.reachCeiling !== (0, environment_reach_ceiling_1.environmentReachCeiling)(environment.scope)) {
+        context.addIssue({
+            code: 'custom',
+            path: ['reachCeiling'],
+            message: 'ExecutionEnvironment.reachCeiling must equal the canonical ceiling derived from scope.',
+        });
+    }
+});
+exports.EXECUTION_ENVIRONMENT_CONTENT_HASH_DOMAIN = 'xema-execution-environment-content-v1';
+function createExecutionEnvironment(input) {
+    return exports.ExecutionEnvironmentSchema.parse(input);
+}
+function serializeExecutionEnvironment(input) {
+    return (0, content_address_1.canonicalJsonStringify)(createExecutionEnvironment(input));
+}
+function computeExecutionEnvironmentContentHash(input) {
+    return (0, content_address_1.canonicalContentHash)({
+        contract: exports.EXECUTION_ENVIRONMENT_CONTENT_HASH_DOMAIN,
+        content: createExecutionEnvironment(input),
+    });
+}
+//# sourceMappingURL=execution-environment.js.map

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

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

package/dist/execution-summary/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/execution-summary';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution-summary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution-summary/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/execution-summary/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/execution-summary"), exports);
+//# sourceMappingURL=index.js.map

package/dist/execution-summary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution-summary/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC"}

package/dist/execution-summary/lib/execution-summary.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { type ExecutionPrincipal } from '../../principal';
+import { type OwnerSpaceRef } from '../../space';
+export declare enum ExecutionKind {
+    AgentInvocation = "agent-invocation",
+    AgentSession = "agent-session",
+    WorkflowRun = "workflow-run",
+    AppRun = "app-run"
+}
+export declare const ExecutionKindSchema: z.ZodEnum<typeof ExecutionKind>;
+export declare enum ExecutionStatus {
+    Pending = "pending",
+    Queued = "queued",
+    Provisioning = "provisioning",
+    Running = "running",
+    WaitingForInput = "waiting-for-input",
+    WaitingForApproval = "waiting-for-approval",
+    Succeeded = "succeeded",
+    Failed = "failed",
+    Denied = "denied",
+    TimedOut = "timed-out",
+    Cancelled = "cancelled"
+}
+export declare const ExecutionStatusSchema: z.ZodEnum<typeof ExecutionStatus>;
+export declare function isTerminalExecutionStatus(status: ExecutionStatus): boolean;
+export declare function canTransitionExecutionStatus(from: ExecutionStatus, to: ExecutionStatus): boolean;
+export declare function assertExecutionStatusTransition(from: ExecutionStatus, to: ExecutionStatus): void;
+export interface ExecutionCost {
+    readonly usd: number;
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly computeMs: number | null;
+}
+export declare const ExecutionCostSchema: z.ZodType<ExecutionCost>;
+export interface ExecutionError {
+    readonly code: string;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly detailsRef: string | null;
+}
+export declare const ExecutionErrorSchema: z.ZodType<ExecutionError>;
+export declare enum ExecutionRemediationKind {
+    Retry = "retry",
+    Resume = "resume",
+    Revise = "revise",
+    OperatorAction = "operator-action"
+}
+export declare const ExecutionRemediationKindSchema: z.ZodEnum<typeof ExecutionRemediationKind>;
+export interface ExecutionRemediation {
+    readonly kind: ExecutionRemediationKind;
+    readonly instruction: string;
+    readonly actionRef: string | null;
+}
+export declare const ExecutionRemediationSchema: z.ZodType<ExecutionRemediation>;
+export interface ExecutionSummary {
+    readonly executionId: string;
+    readonly kind: ExecutionKind;
+    readonly ownerSpaceRef: OwnerSpaceRef;
+    readonly principal: ExecutionPrincipal;
+    readonly correlationId: string;
+    readonly sourceRef: string;
+    readonly releaseRef: string | null;
+    readonly status: ExecutionStatus;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly attempts: number;
+    readonly cost: ExecutionCost | null;
+    readonly auditRef: string | null;
+    readonly outputRefs: readonly string[];
+    readonly error: ExecutionError | null;
+    readonly remediation: ExecutionRemediation | null;
+}
+export declare const ExecutionSummarySchema: z.ZodType<ExecutionSummary>;
+export declare enum ExecutionSummaryEventType {
+    Snapshot = "execution-summary.snapshot"
+}
+export declare const ExecutionSummaryEventTypeSchema: z.ZodEnum<typeof ExecutionSummaryEventType>;
+export interface ExecutionSummaryEvent {
+    readonly eventId: string;
+    readonly eventType: ExecutionSummaryEventType;
+    readonly sequence: number;
+    readonly occurredAt: string;
+    readonly summary: ExecutionSummary;
+}
+export declare const ExecutionSummaryEventSchema: z.ZodType<ExecutionSummaryEvent>;
+export declare function parseExecutionSummary(value: unknown): ExecutionSummary;
+export declare function serializeExecutionSummary(value: ExecutionSummary): string;
+export declare function parseExecutionSummaryEvent(value: unknown): ExecutionSummaryEvent;
+export declare function serializeExecutionSummaryEvent(value: ExecutionSummaryEvent): string;
+//# sourceMappingURL=execution-summary.d.ts.map

package/dist/execution-summary/lib/execution-summary.d.ts.map

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

package/dist/execution-summary/lib/execution-summary.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecutionSummaryEventSchema = exports.ExecutionSummaryEventTypeSchema = exports.ExecutionSummaryEventType = exports.ExecutionSummarySchema = exports.ExecutionRemediationSchema = exports.ExecutionRemediationKindSchema = exports.ExecutionRemediationKind = exports.ExecutionErrorSchema = exports.ExecutionCostSchema = exports.ExecutionStatusSchema = exports.ExecutionStatus = exports.ExecutionKindSchema = exports.ExecutionKind = void 0;
+exports.isTerminalExecutionStatus = isTerminalExecutionStatus;
+exports.canTransitionExecutionStatus = canTransitionExecutionStatus;
+exports.assertExecutionStatusTransition = assertExecutionStatusTransition;
+exports.parseExecutionSummary = parseExecutionSummary;
+exports.serializeExecutionSummary = serializeExecutionSummary;
+exports.parseExecutionSummaryEvent = parseExecutionSummaryEvent;
+exports.serializeExecutionSummaryEvent = serializeExecutionSummaryEvent;
+const zod_1 = require("zod");
+const content_address_1 = require("../../content-address");
+const principal_1 = require("../../principal");
+const space_1 = require("../../space");
+var ExecutionKind;
+(function (ExecutionKind) {
+    ExecutionKind["AgentInvocation"] = "agent-invocation";
+    ExecutionKind["AgentSession"] = "agent-session";
+    ExecutionKind["WorkflowRun"] = "workflow-run";
+    ExecutionKind["AppRun"] = "app-run";
+})(ExecutionKind || (exports.ExecutionKind = ExecutionKind = {}));
+exports.ExecutionKindSchema = zod_1.z.nativeEnum(ExecutionKind);
+var ExecutionStatus;
+(function (ExecutionStatus) {
+    ExecutionStatus["Pending"] = "pending";
+    ExecutionStatus["Queued"] = "queued";
+    ExecutionStatus["Provisioning"] = "provisioning";
+    ExecutionStatus["Running"] = "running";
+    ExecutionStatus["WaitingForInput"] = "waiting-for-input";
+    ExecutionStatus["WaitingForApproval"] = "waiting-for-approval";
+    ExecutionStatus["Succeeded"] = "succeeded";
+    ExecutionStatus["Failed"] = "failed";
+    ExecutionStatus["Denied"] = "denied";
+    ExecutionStatus["TimedOut"] = "timed-out";
+    ExecutionStatus["Cancelled"] = "cancelled";
+})(ExecutionStatus || (exports.ExecutionStatus = ExecutionStatus = {}));
+exports.ExecutionStatusSchema = zod_1.z.nativeEnum(ExecutionStatus);
+const TERMINAL_EXECUTION_STATUSES = new Set([
+    ExecutionStatus.Succeeded,
+    ExecutionStatus.Failed,
+    ExecutionStatus.Denied,
+    ExecutionStatus.TimedOut,
+    ExecutionStatus.Cancelled,
+]);
+const EXECUTION_STATUS_TRANSITIONS = {
+    [ExecutionStatus.Pending]: new Set([
+        ExecutionStatus.Queued,
+        ExecutionStatus.Provisioning,
+        ExecutionStatus.Running,
+        ExecutionStatus.Denied,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.Queued]: new Set([
+        ExecutionStatus.Provisioning,
+        ExecutionStatus.Running,
+        ExecutionStatus.Failed,
+        ExecutionStatus.TimedOut,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.Provisioning]: new Set([
+        ExecutionStatus.Running,
+        ExecutionStatus.Failed,
+        ExecutionStatus.TimedOut,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.Running]: new Set([
+        ExecutionStatus.WaitingForInput,
+        ExecutionStatus.WaitingForApproval,
+        ExecutionStatus.Succeeded,
+        ExecutionStatus.Failed,
+        ExecutionStatus.TimedOut,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.WaitingForInput]: new Set([
+        ExecutionStatus.Running,
+        ExecutionStatus.Failed,
+        ExecutionStatus.TimedOut,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.WaitingForApproval]: new Set([
+        ExecutionStatus.Running,
+        ExecutionStatus.Denied,
+        ExecutionStatus.Failed,
+        ExecutionStatus.TimedOut,
+        ExecutionStatus.Cancelled,
+    ]),
+    [ExecutionStatus.Succeeded]: new Set(),
+    [ExecutionStatus.Failed]: new Set(),
+    [ExecutionStatus.Denied]: new Set(),
+    [ExecutionStatus.TimedOut]: new Set(),
+    [ExecutionStatus.Cancelled]: new Set(),
+};
+function isTerminalExecutionStatus(status) {
+    return TERMINAL_EXECUTION_STATUSES.has(status);
+}
+function canTransitionExecutionStatus(from, to) {
+    return from === to || EXECUTION_STATUS_TRANSITIONS[from].has(to);
+}
+function assertExecutionStatusTransition(from, to) {
+    if (!canTransitionExecutionStatus(from, to)) {
+        throw new Error(`Invalid execution status transition: ${from} -> ${to}.`);
+    }
+}
+exports.ExecutionCostSchema = zod_1.z
+    .object({
+    usd: zod_1.z.number().nonnegative().finite(),
+    inputTokens: zod_1.z.number().int().nonnegative().safe().nullable(),
+    outputTokens: zod_1.z.number().int().nonnegative().safe().nullable(),
+    computeMs: zod_1.z.number().int().nonnegative().safe().nullable(),
+})
+    .strict();
+exports.ExecutionErrorSchema = zod_1.z
+    .object({
+    code: zod_1.z.string().min(1),
+    message: zod_1.z.string().min(1),
+    retryable: zod_1.z.boolean(),
+    detailsRef: zod_1.z.string().min(1).nullable(),
+})
+    .strict();
+var ExecutionRemediationKind;
+(function (ExecutionRemediationKind) {
+    ExecutionRemediationKind["Retry"] = "retry";
+    ExecutionRemediationKind["Resume"] = "resume";
+    ExecutionRemediationKind["Revise"] = "revise";
+    ExecutionRemediationKind["OperatorAction"] = "operator-action";
+})(ExecutionRemediationKind || (exports.ExecutionRemediationKind = ExecutionRemediationKind = {}));
+exports.ExecutionRemediationKindSchema = zod_1.z.nativeEnum(ExecutionRemediationKind);
+exports.ExecutionRemediationSchema = zod_1.z
+    .object({
+    kind: exports.ExecutionRemediationKindSchema,
+    instruction: zod_1.z.string().min(1),
+    actionRef: zod_1.z.string().min(1).nullable(),
+})
+    .strict();
+const timestampSchema = zod_1.z.string().datetime({ offset: true });
+exports.ExecutionSummarySchema = zod_1.z
+    .object({
+    executionId: zod_1.z.string().min(1),
+    kind: exports.ExecutionKindSchema,
+    ownerSpaceRef: space_1.OwnerSpaceRefSchema,
+    principal: principal_1.ExecutionPrincipalSchema,
+    correlationId: zod_1.z.string().min(1),
+    sourceRef: zod_1.z.string().min(1),
+    releaseRef: zod_1.z.string().min(1).nullable(),
+    status: exports.ExecutionStatusSchema,
+    startedAt: timestampSchema.nullable(),
+    finishedAt: timestampSchema.nullable(),
+    attempts: zod_1.z.number().int().nonnegative().safe(),
+    cost: exports.ExecutionCostSchema.nullable(),
+    auditRef: zod_1.z.string().min(1).nullable(),
+    outputRefs: zod_1.z.array(zod_1.z.string().min(1)).readonly(),
+    error: exports.ExecutionErrorSchema.nullable(),
+    remediation: exports.ExecutionRemediationSchema.nullable(),
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    const terminal = isTerminalExecutionStatus(value.status);
+    if (terminal && value.finishedAt === null) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['finishedAt'],
+            message: 'A terminal execution must have finishedAt.',
+        });
+    }
+    if (!terminal && value.finishedAt !== null) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['finishedAt'],
+            message: 'A non-terminal execution cannot have finishedAt.',
+        });
+    }
+    if (value.status !== ExecutionStatus.Pending &&
+        value.status !== ExecutionStatus.Queued &&
+        value.status !== ExecutionStatus.Provisioning &&
+        value.status !== ExecutionStatus.Denied &&
+        value.startedAt === null) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['startedAt'],
+            message: 'An execution that began running must have startedAt.',
+        });
+    }
+    if (value.status === ExecutionStatus.Failed && value.error === null) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['error'],
+            message: 'A failed execution must include an error.',
+        });
+    }
+    if (value.ownerSpaceRef.fence === space_1.OwnerSpaceFence.Tenant &&
+        value.ownerSpaceRef.orgId !== value.principal.orgId) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            path: ['principal', 'orgId'],
+            message: 'Execution principal orgId must match the owner tenant security fence.',
+        });
+    }
+});
+var ExecutionSummaryEventType;
+(function (ExecutionSummaryEventType) {
+    ExecutionSummaryEventType["Snapshot"] = "execution-summary.snapshot";
+})(ExecutionSummaryEventType || (exports.ExecutionSummaryEventType = ExecutionSummaryEventType = {}));
+exports.ExecutionSummaryEventTypeSchema = zod_1.z.nativeEnum(ExecutionSummaryEventType);
+exports.ExecutionSummaryEventSchema = zod_1.z
+    .object({
+    eventId: zod_1.z.string().min(1),
+    eventType: exports.ExecutionSummaryEventTypeSchema,
+    sequence: zod_1.z.number().int().positive().safe(),
+    occurredAt: timestampSchema,
+    summary: exports.ExecutionSummarySchema,
+})
+    .strict();
+function parseExecutionSummary(value) {
+    return exports.ExecutionSummarySchema.parse(value);
+}
+function serializeExecutionSummary(value) {
+    return (0, content_address_1.canonicalJsonStringify)(parseExecutionSummary(value));
+}
+function parseExecutionSummaryEvent(value) {
+    return exports.ExecutionSummaryEventSchema.parse(value);
+}
+function serializeExecutionSummaryEvent(value) {
+    return (0, content_address_1.canonicalJsonStringify)(parseExecutionSummaryEvent(value));
+}
+//# sourceMappingURL=execution-summary.js.map

package/dist/execution-summary/lib/execution-summary.js.map

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

package/dist/execution-target/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/execution-target';
+export * from './lib/execution-target-queue';
+//# sourceMappingURL=index.d.ts.map

package/dist/execution-target/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/execution-target/index.ts"],"names":[],"mappings":"AAQA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/execution-target/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/execution-target"), exports);
+__exportStar(require("./lib/execution-target-queue"), exports);
+//# sourceMappingURL=index.js.map

package/dist/execution-target/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/execution-target/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAQA,yDAAuC;AACvC,+DAA6C"}

package/dist/execution-target/lib/execution-target-queue.d.ts

@@ -0,0 +1,10 @@
+import { TaskQueueName } from '../../workflow';
+export declare const EXECUTION_TARGET_QUEUE_SEPARATOR = "::";
+export declare function executionTargetTaskQueue(targetSlug: string, functional: TaskQueueName): string;
+export interface ExecutionTargetQueue {
+    readonly targetSlug: string;
+    readonly functional: TaskQueueName;
+}
+export declare function parseExecutionTargetTaskQueue(taskQueue: string): ExecutionTargetQueue | null;
+export declare function executionTargetTaskQueues(targetSlug: string, functionals: readonly TaskQueueName[]): readonly string[];
+//# sourceMappingURL=execution-target-queue.d.ts.map

package/dist/execution-target/lib/execution-target-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target-queue.d.ts","sourceRoot":"","sources":["../../../src/execution-target/lib/execution-target-queue.ts"],"names":[],"mappings":"AAgDA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAY/C,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAQrD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,aAAa,GACxB,MAAM,CAGR;AAGD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;CACpC;AAWD,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAkB7B;AAOD,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,SAAS,aAAa,EAAE,GACpC,SAAS,MAAM,EAAE,CAInB"}

package/dist/execution-target/lib/execution-target-queue.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXECUTION_TARGET_QUEUE_SEPARATOR = void 0;
+exports.executionTargetTaskQueue = executionTargetTaskQueue;
+exports.parseExecutionTargetTaskQueue = parseExecutionTargetTaskQueue;
+exports.executionTargetTaskQueues = executionTargetTaskQueues;
+const workflow_1 = require("../../workflow");
+const execution_target_1 = require("./execution-target");
+exports.EXECUTION_TARGET_QUEUE_SEPARATOR = '::';
+function executionTargetTaskQueue(targetSlug, functional) {
+    (0, execution_target_1.assertExecutionTargetSlug)(targetSlug);
+    return `${targetSlug}${exports.EXECUTION_TARGET_QUEUE_SEPARATOR}${functional}`;
+}
+function parseExecutionTargetTaskQueue(taskQueue) {
+    const at = taskQueue.indexOf(exports.EXECUTION_TARGET_QUEUE_SEPARATOR);
+    if (at <= 0) {
+        return null;
+    }
+    const targetSlug = taskQueue.slice(0, at);
+    const functional = taskQueue.slice(at + exports.EXECUTION_TARGET_QUEUE_SEPARATOR.length);
+    if (!Object.values(workflow_1.TaskQueueName).includes(functional)) {
+        return null;
+    }
+    try {
+        (0, execution_target_1.assertExecutionTargetSlug)(targetSlug);
+    }
+    catch {
+        return null;
+    }
+    return { targetSlug, functional: functional };
+}
+function executionTargetTaskQueues(targetSlug, functionals) {
+    return functionals.map((functional) => executionTargetTaskQueue(targetSlug, functional));
+}
+//# sourceMappingURL=execution-target-queue.js.map

package/dist/execution-target/lib/execution-target-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-target-queue.js","sourceRoot":"","sources":["../../../src/execution-target/lib/execution-target-queue.ts"],"names":[],"mappings":";;;AAoEA,4DAMC;AAiBD,sEAoBC;AAOD,8DAOC;AA7ED,6CAA+C;AAE/C,yDAA+D;AAUlD,QAAA,gCAAgC,GAAG,IAAI,CAAC;AAQrD,SAAgB,wBAAwB,CACtC,UAAkB,EAClB,UAAyB;IAEzB,IAAA,4CAAyB,EAAC,UAAU,CAAC,CAAC;IACtC,OAAO,GAAG,UAAU,GAAG,wCAAgC,GAAG,UAAU,EAAE,CAAC;AACzE,CAAC;AAiBD,SAAgB,6BAA6B,CAC3C,SAAiB;IAEjB,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,wCAAgC,CAAC,CAAC;IAC/D,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,CAChC,EAAE,GAAG,wCAAgC,CAAC,MAAM,CAC7C,CAAC;IACF,IAAI,CAAE,MAAM,CAAC,MAAM,CAAC,wBAAa,CAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,IAAA,4CAAyB,EAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAA2B,EAAE,CAAC;AACjE,CAAC;AAOD,SAAgB,yBAAyB,CACvC,UAAkB,EAClB,WAAqC;IAErC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CACpC,wBAAwB,CAAC,UAAU,EAAE,UAAU,CAAC,CACjD,CAAC;AACJ,CAAC"}

package/dist/execution-target/lib/execution-target.d.ts

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { DataClassification, SpaceKind, type SpaceKindSubset } from '../../space';
+import { RunnerTrustTier, RuntimeIsolationLevel, RuntimeOperatorKind } from '../../runner';
+export declare const EXECUTION_TARGET_SPACE_KINDS: SpaceKindSubset;
+export declare function assertExecutionTargetSpaceKind(kind: SpaceKind): SpaceKind;
+export declare const PLATFORM_EXECUTION_TARGET_SLUG = "xema-managed";
+export declare const EXECUTION_TARGET_SLUG_PATTERN: RegExp;
+export declare function assertExecutionTargetSlug(slug: string): string;
+export declare enum ExecutionTargetLabel {
+    Region = "region",
+    Residency = "residency",
+    Accelerator = "accelerator"
+}
+export declare const EXECUTION_TARGET_LABEL_TOKEN_PATTERN: RegExp;
+export declare function assertExecutionTargetLabels(labels: Readonly<Record<string, string>>): Readonly<Record<string, string>>;
+export declare const ExecutionTargetLabelsSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+export declare enum ExecutionTargetStatus {
+    Provisioning = "provisioning",
+    Active = "active",
+    Draining = "draining",
+    Revoked = "revoked",
+    Failed = "failed"
+}
+export declare const ExecutionTargetStatusSchema: z.ZodEnum<typeof ExecutionTargetStatus>;
+export declare function executionTargetAcceptsNewWork(status: ExecutionTargetStatus): boolean;
+export interface ExecutionTarget {
+    readonly slug: string;
+    readonly displayName: string;
+    readonly ownerSpaceUri: string;
+    readonly ownerSpaceKind: SpaceKind;
+    readonly ownerOrgId: string | null;
+    readonly operatorKind: RuntimeOperatorKind;
+    readonly status: ExecutionTargetStatus;
+    readonly labels: Readonly<Record<string, string>>;
+    readonly isolation: RuntimeIsolationLevel;
+    readonly minTrustTier: RunnerTrustTier;
+    readonly maxTrustTier: RunnerTrustTier;
+    readonly maxDataClassification: DataClassification | null;
+    readonly isDefault: boolean;
+}
+export declare const ExecutionTargetSchema: z.ZodObject<{
+    slug: z.ZodString;
+    displayName: z.ZodString;
+    ownerSpaceUri: z.ZodString;
+    ownerSpaceKind: z.ZodEnum<typeof SpaceKind>;
+    ownerOrgId: z.ZodNullable<z.ZodString>;
+    operatorKind: z.ZodEnum<typeof RuntimeOperatorKind>;
+    status: z.ZodEnum<typeof ExecutionTargetStatus>;
+    labels: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    isolation: z.ZodEnum<typeof RuntimeIsolationLevel>;
+    minTrustTier: z.ZodEnum<typeof RunnerTrustTier>;
+    maxTrustTier: z.ZodEnum<typeof RunnerTrustTier>;
+    maxDataClassification: z.ZodNullable<z.ZodEnum<typeof DataClassification>>;
+    isDefault: z.ZodBoolean;
+}, z.core.$strip>;
+//# sourceMappingURL=execution-target.d.ts.map