@atolis-hq/wake 0.4.38 → 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.38";
+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/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',
 ];