@exaudeus/workrail 3.39.0 → 3.40.0

package/dist/types/workflow-source.js

@@ -15,9 +15,9 @@ exports.createCustomDirectorySource = createCustomDirectorySource;
 exports.createGitRepositorySource = createGitRepositorySource;
 exports.createRemoteRegistrySource = createRemoteRegistrySource;
 exports.createPluginSource = createPluginSource;
-exports.assertNever = assertNever;
 exports.getSourceDisplayName = getSourceDisplayName;
 exports.getSourcePath = getSourcePath;
+const assert_never_js_1 = require("../runtime/assert-never.js");
 exports.WORKFLOW_SOURCE_KINDS = [
     'bundled',
     'user',
@@ -69,9 +69,6 @@ function createRemoteRegistrySource(registryUrl) {
 function createPluginSource(pluginName, pluginVersion) {
     return Object.freeze({ kind: 'plugin', pluginName, pluginVersion });
 }
-function assertNever(x) {
-    throw new Error(`Unexpected source kind: ${JSON.stringify(x)}`);
-}
 function getSourceDisplayName(source) {
     switch (source.kind) {
         case 'bundled':
@@ -89,7 +86,7 @@ function getSourceDisplayName(source) {
         case 'plugin':
             return source.pluginName;
         default:
-            return assertNever(source);
+            return (0, assert_never_js_1.assertNever)(source);
     }
 }
 function getSourcePath(source) {
@@ -105,7 +102,7 @@ function getSourcePath(source) {
         case 'plugin':
             return undefined;
         default:
-            return assertNever(source);
+            return (0, assert_never_js_1.assertNever)(source);
     }
 }
 function extractRepoName(url) {

package/dist/types/workflow.d.ts

@@ -28,4 +28,4 @@ export declare function isWorkflowDefinition(obj: unknown): obj is WorkflowDefin
 export type { WorkflowDefinition, WorkflowStepDefinition, LoopStepDefinition, LoopConfigDefinition, FunctionDefinition, FunctionParameter, FunctionCall } from './workflow-definition';
 export { isLoopStepDefinition, isWorkflowStepDefinition, hasWorkflowDefinitionShape } from './workflow-definition';
 export type { WorkflowSource, WorkflowSourceKind, BundledSource, UserDirectorySource, ProjectDirectorySource, CustomDirectorySource, GitRepositorySource, RemoteRegistrySource, PluginSource } from './workflow-source';
-export { WORKFLOW_SOURCE_KINDS, createBundledSource, createUserDirectorySource, createProjectDirectorySource, createCustomDirectorySource, createGitRepositorySource, createRemoteRegistrySource, createPluginSource, getSourceDisplayName, getSourcePath, assertNever } from './workflow-source';
+export { WORKFLOW_SOURCE_KINDS, createBundledSource, createUserDirectorySource, createProjectDirectorySource, createCustomDirectorySource, createGitRepositorySource, createRemoteRegistrySource, createPluginSource, getSourceDisplayName, getSourcePath, } from './workflow-source';

package/dist/types/workflow.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertNever = exports.getSourcePath = exports.getSourceDisplayName = exports.createPluginSource = exports.createRemoteRegistrySource = exports.createGitRepositorySource = exports.createCustomDirectorySource = exports.createProjectDirectorySource = exports.createUserDirectorySource = exports.createBundledSource = exports.WORKFLOW_SOURCE_KINDS = exports.hasWorkflowDefinitionShape = exports.isWorkflowStepDefinition = exports.isLoopStepDefinition = void 0;
+exports.getSourcePath = exports.getSourceDisplayName = exports.createPluginSource = exports.createRemoteRegistrySource = exports.createGitRepositorySource = exports.createCustomDirectorySource = exports.createProjectDirectorySource = exports.createUserDirectorySource = exports.createBundledSource = exports.WORKFLOW_SOURCE_KINDS = exports.hasWorkflowDefinitionShape = exports.isWorkflowStepDefinition = exports.isLoopStepDefinition = void 0;
 exports.createWorkflow = createWorkflow;
 exports.toWorkflowSummary = toWorkflowSummary;
 exports.toWorkflowSourceInfo = toWorkflowSourceInfo;
@@ -102,4 +102,3 @@ Object.defineProperty(exports, "createRemoteRegistrySource", { enumerable: true,
 Object.defineProperty(exports, "createPluginSource", { enumerable: true, get: function () { return workflow_source_2.createPluginSource; } });
 Object.defineProperty(exports, "getSourceDisplayName", { enumerable: true, get: function () { return workflow_source_2.getSourceDisplayName; } });
 Object.defineProperty(exports, "getSourcePath", { enumerable: true, get: function () { return workflow_source_2.getSourcePath; } });
-Object.defineProperty(exports, "assertNever", { enumerable: true, get: function () { return workflow_source_2.assertNever; } });

package/dist/v2/durable-core/domain/artifact-contract-validator.js

@@ -21,6 +21,10 @@ function validateArtifactContract(artifacts, contract) {
     switch (contractRef) {
         case index_js_1.LOOP_CONTROL_CONTRACT_REF:
             return validateLoopControlContract(artifacts, contractRef, required);
+        case index_js_1.COORDINATOR_SIGNAL_CONTRACT_REF:
+            return validateCoordinatorSignalContract(artifacts, contractRef, required);
+        case index_js_1.REVIEW_VERDICT_CONTRACT_REF:
+            return validateReviewVerdictContract(artifacts, contractRef, required);
         default:
             return {
                 valid: false,
@@ -63,6 +67,68 @@ function validateLoopControlContract(artifacts, contractRef, required) {
     }
     return { valid: true, artifact: parseResult.data };
 }
+function validateCoordinatorSignalContract(artifacts, contractRef, required) {
+    const signalArtifacts = artifacts.filter(index_js_1.isCoordinatorSignalArtifact);
+    if (signalArtifacts.length === 0) {
+        if (required) {
+            return {
+                valid: false,
+                error: {
+                    code: 'MISSING_REQUIRED_ARTIFACT',
+                    contractRef,
+                    message: `Required artifact missing: ${contractRef}. Agent must provide an artifact with kind='wr.coordinator_signal'.`,
+                },
+            };
+        }
+        return { valid: true, artifact: null };
+    }
+    const artifact = signalArtifacts[0];
+    const parseResult = index_js_1.CoordinatorSignalArtifactV1Schema.safeParse(artifact);
+    if (!parseResult.success) {
+        const issues = parseResult.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+        return {
+            valid: false,
+            error: {
+                code: 'INVALID_ARTIFACT_SCHEMA',
+                contractRef,
+                message: `Artifact schema validation failed for ${contractRef}`,
+                issues,
+            },
+        };
+    }
+    return { valid: true, artifact: parseResult.data };
+}
+function validateReviewVerdictContract(artifacts, contractRef, required) {
+    const verdictArtifacts = artifacts.filter(index_js_1.isReviewVerdictArtifact);
+    if (verdictArtifacts.length === 0) {
+        if (required) {
+            return {
+                valid: false,
+                error: {
+                    code: 'MISSING_REQUIRED_ARTIFACT',
+                    contractRef,
+                    message: `Required artifact missing: ${contractRef}. Agent must provide an artifact with kind='wr.review_verdict'.`,
+                },
+            };
+        }
+        return { valid: true, artifact: null };
+    }
+    const artifact = verdictArtifacts[0];
+    const parseResult = index_js_1.ReviewVerdictArtifactV1Schema.safeParse(artifact);
+    if (!parseResult.success) {
+        const issues = parseResult.error.issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`);
+        return {
+            valid: false,
+            error: {
+                code: 'INVALID_ARTIFACT_SCHEMA',
+                contractRef,
+                message: `Artifact schema validation failed for ${contractRef}`,
+                issues,
+            },
+        };
+    }
+    return { valid: true, artifact: parseResult.data };
+}
 function requiresArtifactValidation(outputContract) {
     if (!outputContract)
         return false;

package/dist/v2/durable-core/schemas/artifacts/coordinator-signal.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export declare const COORDINATOR_SIGNAL_CONTRACT_REF: "wr.contracts.coordinator_signal";
+export declare const CoordinatorSignalKindSchema: z.ZodEnum<["progress", "finding", "data_needed", "approval_needed", "blocked"]>;
+export type CoordinatorSignalKind = z.infer<typeof CoordinatorSignalKindSchema>;
+export declare const CoordinatorSignalArtifactV1Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"wr.coordinator_signal">;
+    signalKind: z.ZodEnum<["progress", "finding", "data_needed", "approval_needed", "blocked"]>;
+    payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    kind: "wr.coordinator_signal";
+    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
+    payload: Record<string, unknown>;
+    sessionId?: string | undefined;
+}, {
+    kind: "wr.coordinator_signal";
+    signalKind: "blocked" | "progress" | "finding" | "data_needed" | "approval_needed";
+    payload: Record<string, unknown>;
+    sessionId?: string | undefined;
+}>;
+export type CoordinatorSignalArtifactV1 = z.infer<typeof CoordinatorSignalArtifactV1Schema>;
+export declare function isCoordinatorSignalArtifact(artifact: unknown): artifact is {
+    readonly kind: 'wr.coordinator_signal';
+};
+export declare function parseCoordinatorSignalArtifact(artifact: unknown): CoordinatorSignalArtifactV1 | null;

package/dist/v2/durable-core/schemas/artifacts/coordinator-signal.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoordinatorSignalArtifactV1Schema = exports.CoordinatorSignalKindSchema = exports.COORDINATOR_SIGNAL_CONTRACT_REF = void 0;
+exports.isCoordinatorSignalArtifact = isCoordinatorSignalArtifact;
+exports.parseCoordinatorSignalArtifact = parseCoordinatorSignalArtifact;
+const zod_1 = require("zod");
+exports.COORDINATOR_SIGNAL_CONTRACT_REF = 'wr.contracts.coordinator_signal';
+exports.CoordinatorSignalKindSchema = zod_1.z.enum([
+    'progress',
+    'finding',
+    'data_needed',
+    'approval_needed',
+    'blocked',
+]);
+exports.CoordinatorSignalArtifactV1Schema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('wr.coordinator_signal'),
+    signalKind: exports.CoordinatorSignalKindSchema,
+    payload: zod_1.z.record(zod_1.z.unknown()),
+    sessionId: zod_1.z.string().optional(),
+})
+    .strict();
+function isCoordinatorSignalArtifact(artifact) {
+    return (typeof artifact === 'object' &&
+        artifact !== null &&
+        artifact.kind === 'wr.coordinator_signal');
+}
+function parseCoordinatorSignalArtifact(artifact) {
+    const result = exports.CoordinatorSignalArtifactV1Schema.safeParse(artifact);
+    return result.success ? result.data : null;
+}

package/dist/v2/durable-core/schemas/artifacts/index.d.ts

@@ -1,5 +1,7 @@
 export { ASSESSMENT_CONTRACT_REF, AssessmentArtifactV1Schema, AssessmentDimensionSubmissionSchema, isAssessmentArtifact, parseAssessmentArtifact, type AssessmentArtifactV1, type AssessmentDimensionSubmission, } from './assessment.js';
 export { LOOP_CONTROL_CONTRACT_REF, LoopControlDecisionSchema, LoopControlMetadataV1Schema, LoopControlArtifactV1Schema, isLoopControlArtifact, parseLoopControlArtifact, findLoopControlArtifact, type LoopControlDecision, type LoopControlMetadataV1, type LoopControlArtifactV1, } from './loop-control.js';
-export declare const ARTIFACT_CONTRACT_REFS: readonly ["wr.contracts.assessment", "wr.contracts.loop_control"];
+export { COORDINATOR_SIGNAL_CONTRACT_REF, CoordinatorSignalKindSchema, CoordinatorSignalArtifactV1Schema, isCoordinatorSignalArtifact, parseCoordinatorSignalArtifact, type CoordinatorSignalKind, type CoordinatorSignalArtifactV1, } from './coordinator-signal.js';
+export { REVIEW_VERDICT_CONTRACT_REF, ReviewVerdictArtifactV1Schema, isReviewVerdictArtifact, parseReviewVerdictArtifact, type ReviewVerdictArtifactV1, } from './review-verdict.js';
+export declare const ARTIFACT_CONTRACT_REFS: readonly ["wr.contracts.assessment", "wr.contracts.loop_control", "wr.contracts.coordinator_signal", "wr.contracts.review_verdict"];
 export type ArtifactContractRef = (typeof ARTIFACT_CONTRACT_REFS)[number];
 export declare function isValidContractRef(ref: string): ref is ArtifactContractRef;

package/dist/v2/durable-core/schemas/artifacts/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ARTIFACT_CONTRACT_REFS = exports.findLoopControlArtifact = exports.parseLoopControlArtifact = exports.isLoopControlArtifact = exports.LoopControlArtifactV1Schema = exports.LoopControlMetadataV1Schema = exports.LoopControlDecisionSchema = exports.LOOP_CONTROL_CONTRACT_REF = exports.parseAssessmentArtifact = exports.isAssessmentArtifact = exports.AssessmentDimensionSubmissionSchema = exports.AssessmentArtifactV1Schema = exports.ASSESSMENT_CONTRACT_REF = void 0;
+exports.ARTIFACT_CONTRACT_REFS = exports.parseReviewVerdictArtifact = exports.isReviewVerdictArtifact = exports.ReviewVerdictArtifactV1Schema = exports.REVIEW_VERDICT_CONTRACT_REF = exports.parseCoordinatorSignalArtifact = exports.isCoordinatorSignalArtifact = exports.CoordinatorSignalArtifactV1Schema = exports.CoordinatorSignalKindSchema = exports.COORDINATOR_SIGNAL_CONTRACT_REF = exports.findLoopControlArtifact = exports.parseLoopControlArtifact = exports.isLoopControlArtifact = exports.LoopControlArtifactV1Schema = exports.LoopControlMetadataV1Schema = exports.LoopControlDecisionSchema = exports.LOOP_CONTROL_CONTRACT_REF = exports.parseAssessmentArtifact = exports.isAssessmentArtifact = exports.AssessmentDimensionSubmissionSchema = exports.AssessmentArtifactV1Schema = exports.ASSESSMENT_CONTRACT_REF = void 0;
 exports.isValidContractRef = isValidContractRef;
 var assessment_js_1 = require("./assessment.js");
 Object.defineProperty(exports, "ASSESSMENT_CONTRACT_REF", { enumerable: true, get: function () { return assessment_js_1.ASSESSMENT_CONTRACT_REF; } });
@@ -16,9 +16,22 @@ Object.defineProperty(exports, "LoopControlArtifactV1Schema", { enumerable: true
 Object.defineProperty(exports, "isLoopControlArtifact", { enumerable: true, get: function () { return loop_control_js_1.isLoopControlArtifact; } });
 Object.defineProperty(exports, "parseLoopControlArtifact", { enumerable: true, get: function () { return loop_control_js_1.parseLoopControlArtifact; } });
 Object.defineProperty(exports, "findLoopControlArtifact", { enumerable: true, get: function () { return loop_control_js_1.findLoopControlArtifact; } });
+var coordinator_signal_js_1 = require("./coordinator-signal.js");
+Object.defineProperty(exports, "COORDINATOR_SIGNAL_CONTRACT_REF", { enumerable: true, get: function () { return coordinator_signal_js_1.COORDINATOR_SIGNAL_CONTRACT_REF; } });
+Object.defineProperty(exports, "CoordinatorSignalKindSchema", { enumerable: true, get: function () { return coordinator_signal_js_1.CoordinatorSignalKindSchema; } });
+Object.defineProperty(exports, "CoordinatorSignalArtifactV1Schema", { enumerable: true, get: function () { return coordinator_signal_js_1.CoordinatorSignalArtifactV1Schema; } });
+Object.defineProperty(exports, "isCoordinatorSignalArtifact", { enumerable: true, get: function () { return coordinator_signal_js_1.isCoordinatorSignalArtifact; } });
+Object.defineProperty(exports, "parseCoordinatorSignalArtifact", { enumerable: true, get: function () { return coordinator_signal_js_1.parseCoordinatorSignalArtifact; } });
+var review_verdict_js_1 = require("./review-verdict.js");
+Object.defineProperty(exports, "REVIEW_VERDICT_CONTRACT_REF", { enumerable: true, get: function () { return review_verdict_js_1.REVIEW_VERDICT_CONTRACT_REF; } });
+Object.defineProperty(exports, "ReviewVerdictArtifactV1Schema", { enumerable: true, get: function () { return review_verdict_js_1.ReviewVerdictArtifactV1Schema; } });
+Object.defineProperty(exports, "isReviewVerdictArtifact", { enumerable: true, get: function () { return review_verdict_js_1.isReviewVerdictArtifact; } });
+Object.defineProperty(exports, "parseReviewVerdictArtifact", { enumerable: true, get: function () { return review_verdict_js_1.parseReviewVerdictArtifact; } });
 exports.ARTIFACT_CONTRACT_REFS = [
     'wr.contracts.assessment',
     'wr.contracts.loop_control',
+    'wr.contracts.coordinator_signal',
+    'wr.contracts.review_verdict',
 ];
 function isValidContractRef(ref) {
     return exports.ARTIFACT_CONTRACT_REFS.includes(ref);

package/dist/v2/durable-core/schemas/artifacts/review-verdict.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const REVIEW_VERDICT_CONTRACT_REF: "wr.contracts.review_verdict";
+export declare const ReviewVerdictArtifactV1Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"wr.review_verdict">;
+    verdict: z.ZodEnum<["clean", "minor", "blocking"]>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    findings: z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<["critical", "major", "minor", "nit"]>;
+        summary: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        summary: string;
+        severity: "minor" | "critical" | "major" | "nit";
+    }, {
+        summary: string;
+        severity: "minor" | "critical" | "major" | "nit";
+    }>, "many">;
+    summary: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "wr.review_verdict";
+    summary: string;
+    confidence: "high" | "medium" | "low";
+    verdict: "clean" | "minor" | "blocking";
+    findings: {
+        summary: string;
+        severity: "minor" | "critical" | "major" | "nit";
+    }[];
+}, {
+    kind: "wr.review_verdict";
+    summary: string;
+    confidence: "high" | "medium" | "low";
+    verdict: "clean" | "minor" | "blocking";
+    findings: {
+        summary: string;
+        severity: "minor" | "critical" | "major" | "nit";
+    }[];
+}>;
+export type ReviewVerdictArtifactV1 = z.infer<typeof ReviewVerdictArtifactV1Schema>;
+export declare function isReviewVerdictArtifact(artifact: unknown): artifact is {
+    readonly kind: 'wr.review_verdict';
+};
+export declare function parseReviewVerdictArtifact(artifact: unknown): ReviewVerdictArtifactV1 | null;

package/dist/v2/durable-core/schemas/artifacts/review-verdict.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReviewVerdictArtifactV1Schema = exports.REVIEW_VERDICT_CONTRACT_REF = void 0;
+exports.isReviewVerdictArtifact = isReviewVerdictArtifact;
+exports.parseReviewVerdictArtifact = parseReviewVerdictArtifact;
+const zod_1 = require("zod");
+exports.REVIEW_VERDICT_CONTRACT_REF = 'wr.contracts.review_verdict';
+exports.ReviewVerdictArtifactV1Schema = zod_1.z
+    .object({
+    kind: zod_1.z.literal('wr.review_verdict'),
+    verdict: zod_1.z.enum(['clean', 'minor', 'blocking']),
+    confidence: zod_1.z.enum(['high', 'medium', 'low']),
+    findings: zod_1.z.array(zod_1.z
+        .object({
+        severity: zod_1.z.enum(['critical', 'major', 'minor', 'nit']),
+        summary: zod_1.z.string().min(1),
+    })
+        .strict()),
+    summary: zod_1.z.string().min(1),
+})
+    .strict();
+function isReviewVerdictArtifact(artifact) {
+    return (typeof artifact === 'object' &&
+        artifact !== null &&
+        artifact.kind === 'wr.review_verdict');
+}
+function parseReviewVerdictArtifact(artifact) {
+    const result = exports.ReviewVerdictArtifactV1Schema.safeParse(artifact);
+    return result.success ? result.data : null;
+}