@atolis-hq/wake 0.4.37 → 0.4.39

package/dist/src/bootstrap/surface-api-applications.js

@@ -279,6 +279,19 @@ function createSystemApplications(root, now) {
                 meta: sampledMeta(sampledAt),
             };
         },
+        async webhooks() {
+            const sampledAt = now();
+            const adapters = await Promise.all(root.providers.flatMap((instance) => instance.webhook === undefined
+                ? []
+                : [
+                    instance.webhook.setupInstructions().then((hooks) => ({
+                        adapter: instance.adapter,
+                        provider: instance.provider,
+                        hooks,
+                    })),
+                ]));
+            return { data: { adapters }, meta: sampledMeta(sampledAt) };
+        },
     };
 }
 function commandAccepted(command, acceptedAt) {

package/dist/src/bootstrap/version.js

@@ -124,6 +124,6 @@ export function resolveWakeVersion(options = {}) {
         return `g${headHash.slice(0, 7)}`;
     return '0.1.0-dev';
 }
-export const wakeVersion = "v0.4.37";
+export const wakeVersion = "v0.4.39";
 /** The registry-installable version used by packaged sandbox images. */
 export const wakePackageVersion = packageVersion(defaultRepoRoot) ?? wakeVersion;

package/dist/src/integrations/contracts/provider.d.ts

@@ -2,7 +2,7 @@ import type { CheckpointStore, EventJournal } from '@atolis-hq/eventing';
 import type { PullRequestService } from '../../activities/index.js';
 import type { ConversationService } from '../../conversations/index.js';
 import type { RunRepository } from '../../execution/index.js';
-import type { Clock, IdGenerator } from '../../kernel/index.js';
+import { type Clock, type IdGenerator, type ValueOf } from '../../kernel/index.js';
 import type { OrchestrationService, SurfaceCapability, WorkflowCandidate, WorkflowName } from '../../orchestration/index.js';
 import type { ExternalResourceKey, ResourceCapability, ResourceKind, ResourceLookup, ResourceService } from '../../resources/index.js';
 import type { WorkItemId, WorkItemView, WorkService } from '../../work/index.js';
@@ -44,10 +44,14 @@ export interface VerifiedArtifact {
     readonly capabilities: readonly ResourceCapability[];
     readonly revision?: string | undefined;
 }
+export declare const AdapterHealthStatus: {
+    readonly Unknown: "unknown";
+};
+export type AdapterHealthStatus = 'ok' | 'degraded' | ValueOf<typeof AdapterHealthStatus>;
 export interface AdapterHealthCheck {
     readonly scope: string;
     readonly channel: string;
-    readonly status: 'ok' | 'degraded';
+    readonly status: AdapterHealthStatus;
     readonly detail?: string;
     readonly successCount: number;
     readonly failureCount: number;
@@ -79,8 +83,16 @@ export interface ProviderInstance {
 }
 export interface ProviderWebhook {
     provision(): Promise<void>;
+    setupInstructions(): Promise<readonly ProviderWebhookSetup[]>;
     receive(body: Buffer, headers: Readonly<Record<string, string | string[] | undefined>>, trigger: () => void): Promise<404 | 400 | 401 | 202>;
 }
+/** Operator-only material for configuring a provider webhook outside Wake. */
+export interface ProviderWebhookSetup {
+    readonly scope: string;
+    readonly endpoint: string;
+    readonly events: readonly string[];
+    readonly secret: string;
+}
 export type ComposedProviderInstance = Omit<ProviderInstance, 'provider'>;
 export interface ProviderDefinition<Config = unknown> {
     readonly provider: string;

package/dist/src/integrations/contracts/provider.js

@@ -1,4 +1,8 @@
+import { defineClosedVocabulary, } from '../../kernel/index.js';
 import { adapterId } from './identifiers.js';
+export const AdapterHealthStatus = defineClosedVocabulary({
+    Unknown: 'unknown',
+});
 export class ProviderRegistry {
     definitions = new Map();
     register(definition) {

package/dist/src/integrations/github/infrastructure/webhook.js

@@ -55,10 +55,21 @@ export function createGitHubWebhook(adapter, config, publicUrl, root, client, he
                     return 401;
                 if (!events.has(event))
                     return 404;
+                health.recordSuccess(`${owner}/${repo}`, 'webhook');
                 trigger();
                 return 202;
             });
         },
+        async setupInstructions() {
+            if (!config.webhooks.enabled || endpoint === undefined)
+                return [];
+            return Promise.all(config.repositories.map(({ owner, repo }) => state.serialise(owner, repo, async () => ({
+                scope: `${owner}/${repo}`,
+                endpoint,
+                events: [...events],
+                secret: (await state.load(owner, repo)).secret,
+            }))));
+        },
     };
 }
 async function provisionRepository(repository, endpoint, state, client, health) {
@@ -67,7 +78,6 @@ async function provisionRepository(repository, endpoint, state, client, health)
         const saved = await state.load(repository.owner, repository.repo);
         if (saved.hookId !== undefined &&
             (await updateManagedHook(repository, endpoint, saved, client))) {
-            health.recordSuccess(scope, 'webhook');
             return;
         }
         const hookId = await client.createHook({
@@ -77,7 +87,6 @@ async function provisionRepository(repository, endpoint, state, client, health)
             events: [...events],
         });
         await state.save(repository.owner, repository.repo, { ...saved, hookId });
-        health.recordSuccess(scope, 'webhook');
     }
     catch (error) {
         health.recordFailure(scope, 'webhook', error);

package/dist/src/integrations/github/provider.d.ts

@@ -1,3 +1,3 @@
-import type { ProviderDefinition } from '../contracts/provider.js';
+import { type ProviderDefinition } from '../contracts/provider.js';
 import { type GitHubConfig } from './contracts/config.js';
 export declare const gitHubProviderDefinition: ProviderDefinition<GitHubConfig>;

package/dist/src/integrations/github/provider.js

@@ -2,6 +2,7 @@ import { BuiltInActivityName, PullRequestState } from '../../activities/index.js
 import { ConversationSurfaceCapability } from '../../orchestration/index.js';
 import { BuiltInResourceCapability, BuiltInResourceKind, ResourceCorrelationRole, resourceId, resourceKind, } from '../../resources/index.js';
 import { ArtifactVerificationResult } from '../contracts/artifact-vocabulary.js';
+import { AdapterHealthStatus } from '../contracts/provider.js';
 import { InboundTranslator } from './application/inbound-translator.js';
 import { translateGitHubOutbound } from './application/outbound-translator.js';
 import { createGitHubWakeLabelReconciler } from './application/wake-labels.js';
@@ -59,7 +60,15 @@ export const gitHubProviderDefinition = {
                 setLabels: client.setIssueLabels,
                 requests,
             }),
-            health: () => health.snapshotAll(),
+            health: () => health.snapshotAll().flatMap((check) => {
+                if (check.channel !== 'webhook')
+                    return [check];
+                if (!config.webhooks.enabled)
+                    return [];
+                return [
+                    check.successCount === 0 ? { ...check, status: AdapterHealthStatus.Unknown } : check,
+                ];
+            }),
             webhook: createGitHubWebhook(adapter, config, services.publicUiUrl, services.providerStateRoot, client, health),
             commands: () => [
                 ...Object.values(GitHubBuiltInCommand).map((syntax) => ({ syntax })),

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

@@ -154,7 +154,7 @@ export class OrchestrationService {
             throw new GroupBudgetExtensionIneligibleError('Workflow has no durable gate definition to extend');
         const group = childOrchestrationGroupStream(parent.orchestrationGroupId, exhausted.watchId);
         await this.claims.grantBudget(group, exhausted.requestId, context, authority);
-        await this.waitForSignal(parent.workflowInstanceId, parent.waitingFor, context);
+        await this.waitForSignal(parent.workflowInstanceId, { ...parent.waitingFor, suppressWatchDispatch: true }, context);
         return this.requestChild({
             ...exhausted,
             workflowName,

package/dist/src/orchestration/application/watch-reactor.js

@@ -11,6 +11,8 @@ const reconciliationCheckpoint = 'reconciler:orchestration.watch';
 const noWatchEventTypes = () => [];
 export function createWatchReactor(orchestration, watchEventTypes = noWatchEventTypes, runs) {
     const react = async (event, context) => {
+        if (suppressesWatchDispatch(event))
+            return;
         await dispatch(orchestration, runs, event, context, await orchestration.listWatchMatches(event, context));
     };
     return {
@@ -45,6 +47,10 @@ export function createWatchReconciler(orchestration, journal, checkpoints, runs)
             ]));
             let reconciled = 0;
             for (const event of events) {
+                if (suppressesWatchDispatch(event)) {
+                    await checkpoints.save(reconciliationCheckpoint, event.globalPosition);
+                    continue;
+                }
                 const context = reactorCommandContext(event, ApprovalAuthorityKind.Watch, 'watch-reactor');
                 const matches = (await Promise.all((await orchestration.listWatchMatches(event, context)).map(async (match) => {
                     const watches = waiting.get(match.parent.workflowInstanceId);
@@ -63,6 +69,11 @@ export function createWatchReconciler(orchestration, journal, checkpoints, runs)
         },
     };
 }
+function suppressesWatchDispatch(event) {
+    const owned = selectOrchestrationEvent(event);
+    return (owned?.event.eventType === OrchestrationEventType.SignalWaitStarted &&
+        owned.event.payload.suppressWatchDispatch === true);
+}
 async function dispatch(orchestration, runs, event, context, matches) {
     const causalCycle = orchestrationCausalCycleId(selectOrchestrationEvent(event));
     const sourceWorkflowInstanceId = await resolveTriggerWorkflowInstanceId(event, runs);

package/dist/src/orchestration/contracts/event-decoder.d.ts

@@ -71,6 +71,7 @@ export declare const activityRequestedSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const expectationSchema: z.ZodObject<{
     signalKind: z.ZodPipe<z.ZodString, z.ZodTransform<import("./identifiers.js").SignalName, string>>;
+    suppressWatchDispatch: z.ZodOptional<z.ZodLiteral<true>>;
     resourceId: z.ZodOptional<z.ZodString>;
     revision: z.ZodOptional<z.ZodString>;
     from: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/src/orchestration/contracts/event-decoder.js

@@ -121,6 +121,7 @@ const resourceTransitionSchema = z
 export const expectationSchema = z
     .object({
     signalKind: brandedStringSchema(signalName),
+    suppressWatchDispatch: z.literal(true).optional(),
     resourceId: z.string().optional(),
     revision: z.string().optional(),
     from: z.array(approvalAuthoritySchema).min(1).optional(),

package/dist/src/orchestration/contracts/events.d.ts

@@ -187,6 +187,8 @@ export interface ActivityRequestedPayload {
 }
 export interface SignalExpectation {
     readonly signalKind: SignalName;
+    /** Re-arm a blocked gate without treating its wait event as a new watch trigger. */
+    readonly suppressWatchDispatch?: true | undefined;
     readonly resourceId?: string | undefined;
     readonly revision?: string | undefined;
     readonly from?: readonly ApprovalAuthority[] | undefined;

package/dist/src/orchestration/contracts/views.d.ts

@@ -17,6 +17,7 @@ export interface ActivityActivationView {
 }
 export interface SignalExpectationView {
     readonly signalKind: SignalName;
+    readonly suppressWatchDispatch?: true;
     readonly intentEventId?: string;
     readonly resourceId?: string;
     readonly revision?: string;

package/dist/src/orchestration/domain/workflow-instance-events.js

@@ -177,6 +177,7 @@ function applySignalWaitStarted(state, event) {
     state.status = orchestrationStatusTransitions[OrchestrationEventType.SignalWaitStarted];
     state.waitingFor = {
         signalKind: event.payload.signalKind,
+        ...(event.payload.suppressWatchDispatch === true ? { suppressWatchDispatch: true } : {}),
         ...(event.payload.resourceId === undefined ? {} : { resourceId: event.payload.resourceId }),
         ...(event.payload.revision === undefined ? {} : { revision: event.payload.revision }),
         ...(event.payload.from === undefined ? {} : { from: event.payload.from }),

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',
 ];