@atolis-hq/wake 0.4.38 → 0.4.40

package/dist/src/orchestration/application/orchestration-service.d.ts

@@ -61,6 +61,7 @@ export declare class OrchestrationService {
     retryBlockedFailedStage(workflowInstanceId: WorkflowInstanceId, context: CommandContext): Promise<WorkflowInstanceView>;
     restartBlockedFailedStage(workflowInstanceId: WorkflowInstanceId, context: CommandContext): Promise<WorkflowInstanceView>;
     resumeBlockedStageForChanges(workflowInstanceId: WorkflowInstanceId, context: CommandContext): Promise<WorkflowInstanceView | null>;
+    resumeNeedsClarificationStage(workflowInstanceId: WorkflowInstanceId, context: CommandContext): Promise<WorkflowInstanceView | null>;
     extendBlockedGroupBudget(workflowInstanceId: WorkflowInstanceId, authority: {
         readonly kind: string;
     }, context: CommandContext): Promise<import("../contracts/views.js").GroupBudgetExhaustedView | WorkflowInstanceView>;

package/dist/src/orchestration/application/orchestration-service.js

@@ -137,6 +137,9 @@ export class OrchestrationService {
     resumeBlockedStageForChanges(workflowInstanceId, context) {
         return this.transitionWatchChildren(context, () => this.advanceWorkflow.resumeBlockedStageForChanges(workflowInstanceId, context));
     }
+    resumeNeedsClarificationStage(workflowInstanceId, context) {
+        return this.transitionWatchChildren(context, () => this.advanceWorkflow.resumeNeedsClarificationStage(workflowInstanceId, context));
+    }
     async extendBlockedGroupBudget(workflowInstanceId, authority, context) {
         if (authority.kind !== ApprovalAuthorityKind.Human)
             throw new GroupBudgetExtensionIneligibleError('A group budget extension requires human authority');

package/dist/src/orchestration/domain/interpreter.d.ts

@@ -7,7 +7,7 @@ export { acceptSignal, waitForSignal } from './signal-policy.js';
 export type { AcceptSignal } from './signal-policy.js';
 export { requestSupplementalActivity } from './supplemental-policy.js';
 export type { SupplementalActivityRequest } from './supplemental-policy.js';
-export { isChangesResumeEligible, isGroupBudgetExtensionEligible, isOperatorRetryEligible, requestChangesResume, requestFreshOperatorRetry, requestOperatorRetry, selectOperatorRetryTarget, } from './operator-retry-policy.js';
+export { isChangesResumeEligible, isGroupBudgetExtensionEligible, isNeedsClarificationResumeEligible, isOperatorRetryEligible, requestChangesResume, requestFreshOperatorRetry, requestOperatorRetry, selectOperatorRetryTarget, } from './operator-retry-policy.js';
 export type { OperatorRetryRequest } from './operator-retry-policy.js';
 export { isRunnerQuotaRetryEligible, requestRunnerQuotaRetry, } from './runner-quota-retry-policy.js';
 export type { RunnerQuotaRetryRequest } from './runner-quota-retry-policy.js';

package/dist/src/orchestration/domain/interpreter.js

@@ -10,7 +10,7 @@ import { finishRoute } from './transition.js';
 export { startInstance } from './activation-policy.js';
 export { acceptSignal, waitForSignal } from './signal-policy.js';
 export { requestSupplementalActivity } from './supplemental-policy.js';
-export { isChangesResumeEligible, isGroupBudgetExtensionEligible, isOperatorRetryEligible, requestChangesResume, requestFreshOperatorRetry, requestOperatorRetry, selectOperatorRetryTarget, } from './operator-retry-policy.js';
+export { isChangesResumeEligible, isGroupBudgetExtensionEligible, isNeedsClarificationResumeEligible, isOperatorRetryEligible, requestChangesResume, requestFreshOperatorRetry, requestOperatorRetry, selectOperatorRetryTarget, } from './operator-retry-policy.js';
 export { isRunnerQuotaRetryEligible, requestRunnerQuotaRetry, } from './runner-quota-retry-policy.js';
 export function acceptActivityOutcome(definition, state, input) {
     if (!isPendingOutcome(state, input))

package/dist/src/orchestration/domain/operator-retry-policy.d.ts

@@ -7,6 +7,8 @@ export interface OperatorRetryRequest extends DecisionContext {
 export declare function isOperatorRetryEligible(view: WorkflowInstanceView): boolean;
 export declare function selectOperatorRetryTarget(workflows: readonly WorkflowInstanceView[]): WorkflowInstanceView | undefined;
 export declare function isChangesResumeEligible(view: WorkflowInstanceView): boolean;
+/** A clarification reply may be supplied by any conversation participant. */
+export declare function isNeedsClarificationResumeEligible(view: WorkflowInstanceView): boolean;
 export declare function isGroupBudgetExtensionEligible(view: WorkflowInstanceView): boolean;
 export declare function requestOperatorRetry(definition: CompiledWorkflow, state: WorkflowInstanceView, input: OperatorRetryRequest): OrchestrationDecision;
 /** Re-requests the failed stage while requiring a new runner session. */

package/dist/src/orchestration/domain/operator-retry-policy.js

@@ -1,4 +1,4 @@
-import { ActivityOutcomeKind, BuiltInActivityName } from '../../activities/index.js';
+import { ActivityOutcomeKind, BuiltInActivityName, isNeedsClarificationAgentOutcome, } from '../../activities/index.js';
 import { OrchestrationEventType, WatchGateVerdictSignal } from '../contracts/events.js';
 import { signalName, stageName, watchId } from '../contracts/identifiers.js';
 import { ActivityActivationStatus, ApprovalAuthorityKind, WorkflowStatus, } from '../contracts/vocabulary.js';
@@ -49,20 +49,26 @@ export function selectOperatorRetryTarget(workflows) {
         isOperatorRetryEligible(workflow));
 }
 export function isChangesResumeEligible(view) {
-    const pending = view.pendingActivation;
-    const completedAgentStage = pending !== undefined &&
-        pending.activity === BuiltInActivityName.Agent &&
-        pending.status === ActivityActivationStatus.Completed &&
-        pending.supplemental !== true &&
-        pending.followOnIndex === undefined &&
-        view.acceptedOutcomes.includes(pending.activationId);
-    if (!completedAgentStage)
+    if (!isCompletedAgentStage(view))
         return false;
     return ((view.status === WorkflowStatus.Blocked &&
         view.blockReason === 'unconfigured outcome blocked' &&
         view.lastOutcome?.kind === ActivityOutcomeKind.Blocked) ||
         (view.status === WorkflowStatus.Waiting && view.waitingFor !== undefined));
 }
+/** A clarification reply may be supplied by any conversation participant. */
+export function isNeedsClarificationResumeEligible(view) {
+    return isChangesResumeEligible(view) && isNeedsClarificationAgentOutcome(view.lastOutcome);
+}
+function isCompletedAgentStage(view) {
+    const pending = view.pendingActivation;
+    return (pending !== undefined &&
+        pending.activity === BuiltInActivityName.Agent &&
+        pending.status === ActivityActivationStatus.Completed &&
+        pending.supplemental !== true &&
+        pending.followOnIndex === undefined &&
+        view.acceptedOutcomes.includes(pending.activationId));
+}
 export function isGroupBudgetExtensionEligible(view) {
     return (view.status === WorkflowStatus.Blocked &&
         view.blockReason?.startsWith('watch group budget exhausted for ') === true &&

package/dist/src/surfaces/api/contracts/system.d.ts

@@ -1,3 +1,8 @@
+import { type ValueOf } from '../../../kernel/index.js';
+export declare const ApiAdapterHealthStatus: {
+    readonly Unknown: "unknown";
+};
+export type ApiAdapterHealthStatus = 'ok' | 'degraded' | ValueOf<typeof ApiAdapterHealthStatus>;
 export interface HealthResponse {
     readonly status: 'ok' | 'degraded';
     readonly version: string;
@@ -12,7 +17,7 @@ export interface HealthResponse {
         readonly provider: string;
         readonly scope: string;
         readonly channel: string;
-        readonly status: 'ok' | 'degraded';
+        readonly status: ApiAdapterHealthStatus;
         readonly detail?: string;
         readonly successCount: number;
         readonly failureCount: number;
@@ -30,3 +35,15 @@ export interface CommandsResponse {
         }[];
     }[];
 }
+export interface WebhookSetupResponse {
+    readonly adapters: readonly {
+        readonly adapter: string;
+        readonly provider: string;
+        readonly hooks: readonly {
+            readonly scope: string;
+            readonly endpoint: string;
+            readonly events: readonly string[];
+            readonly secret: string;
+        }[];
+    }[];
+}

package/dist/src/surfaces/api/contracts/system.js

@@ -1 +1,4 @@
-export {};
+import { defineClosedVocabulary } from '../../../kernel/index.js';
+export const ApiAdapterHealthStatus = defineClosedVocabulary({
+    Unknown: 'unknown',
+});

package/dist/src/surfaces/api/routes/applications.d.ts

@@ -1,5 +1,5 @@
 import type { RunStatus } from '../../../execution/index.js';
-import type { ApiCommandResult, AuditEventResponse, BoardCardResponse, BoardResponse, CommandsResponse, ConfigurationResponse, ControlPlaneStatusResponse, ConversationMessageRequest, HealthResponse, MetricsResponse, ResourceItemResponse, ResourceResponse, ResponseMeta, RunnerResponse, RunResponse, RunTranscriptResponse, StatusResponse, WorkDetailResponse, WorkflowDiagramsResponse, WorkflowInstanceResponse, WorkItemResponse, WorkItemTranscriptResponse } from '../contracts/index.js';
+import type { ApiCommandResult, AuditEventResponse, BoardCardResponse, BoardResponse, CommandsResponse, ConfigurationResponse, ControlPlaneStatusResponse, ConversationMessageRequest, HealthResponse, MetricsResponse, ResourceItemResponse, ResourceResponse, ResponseMeta, RunnerResponse, RunResponse, RunTranscriptResponse, StatusResponse, WebhookSetupResponse, WorkDetailResponse, WorkflowDiagramsResponse, WorkflowInstanceResponse, WorkItemResponse, WorkItemTranscriptResponse } from '../contracts/index.js';
 export interface CollectionQuery {
     readonly cursor?: {
         readonly position: number;
@@ -34,6 +34,7 @@ export interface ApiSystemApplications {
     health(): Promise<ApiResourceResult<HealthResponse>>;
     configuration(): Promise<ApiResourceResult<ConfigurationResponse>>;
     commands(): Promise<ApiResourceResult<CommandsResponse>>;
+    webhooks?(): Promise<ApiResourceResult<WebhookSetupResponse>>;
 }
 export interface ApiApplications {
     readonly now: () => string;

package/dist/src/surfaces/api/routes/read.js

@@ -38,6 +38,10 @@ async function readSingleton(applications, url) {
             return noQuery(url, async () => ok(await applications.system.configuration()));
         case '/api/v1/system/commands':
             return noQuery(url, async () => ok(await applications.system.commands()));
+        case '/api/v1/system/webhooks':
+            return applications.system.webhooks === undefined
+                ? unavailable('webhooks')
+                : noQuery(url, async () => ok(await applications.system.webhooks()));
         case '/api/v1/workflow-diagrams':
             return readWorkflowDiagrams(applications, url);
         default:

package/dist/src/surfaces/api/routes/system.d.ts

@@ -1 +1 @@
-export declare const systemRoutes: readonly ["/api/v1/system/health", "/api/v1/system/configuration", "/api/v1/system/commands"];
+export declare const systemRoutes: readonly ["/api/v1/system/health", "/api/v1/system/configuration", "/api/v1/system/commands", "/api/v1/system/webhooks"];

package/dist/src/surfaces/api/routes/system.js

@@ -2,4 +2,5 @@ export const systemRoutes = [
     '/api/v1/system/health',
     '/api/v1/system/configuration',
     '/api/v1/system/commands',
+    '/api/v1/system/webhooks',
 ];