@atolis-hq/wake 0.3.16 → 0.3.18

package/README.md

@@ -173,6 +173,7 @@ any time for the full command list, or see
 - [docs/workflows.md](docs/workflows.md) - how stages, prompts, and runner routes are configured.
 - [docs/prompts.md](docs/prompts.md) - how prompt templates map to workflow stages.
 - [docs/configuration.md](docs/configuration.md) - `config.yaml`/`config.workflows.yaml` options and the operator correlation escape hatch.
+- [docs/public-ui-access.md](docs/public-ui-access.md) - expose the operator UI through ngrok or another secured ingress.
 - [docs/development.md](docs/development.md) - source-checkout dev setup (`wake-dev`), npm scripts, formatting, self-update, GitHub polling.
 - [docs/runner-comparison.md](docs/runner-comparison.md) - capability differences between supported runners.
 

package/dist/src/bootstrap/composition-root.js

@@ -204,6 +204,7 @@ async function composeIntegrationRuntime(input) {
     registry.register(fakeProviderDefinition);
     registry.register(gitHubProviderDefinition);
     const { instances, failures: providerFailures } = registry.compose(await hydrateFakeProviderEvidence(input.wakeRoot, input.config.integrations), {
+        publicUiUrl: input.config.surfaces.web.publicUrl,
         work: input.work,
         resources: input.resources,
         resourceLookup: input.lookup,

package/dist/src/bootstrap/version.js

@@ -108,4 +108,4 @@ export function resolveWakeVersion(options = {}) {
         return `g${headHash.slice(0, 7)}`;
     return '0.1.0-dev';
 }
-export const wakeVersion = "g67a13f9";
+export const wakeVersion = "gaebb12d";

package/dist/src/control-plane/domain/schedule-policy.js

@@ -1,3 +1,4 @@
+import { CronExpressionParser } from 'cron-parser';
 export class SchedulePolicy {
     elapsedSlots(config, now, checkpoint) {
         const end = minute(new Date(now));
@@ -7,13 +8,22 @@ export class SchedulePolicy {
         const fields = config.cron.trim().split(/\s+/);
         if (fields.length !== 5)
             throw new Error(`Schedule ${config.id} must use a five-field cron expression`);
+        if (fields.some(hasUnsupportedSyntax))
+            throw new Error(`Schedule ${config.id} uses unsupported cron syntax`);
+        const expression = CronExpressionParser.parse(config.cron, {
+            currentDate: new Date(start - 1),
+            endDate: new Date(end),
+            tz: 'UTC',
+        });
+        const dayOfMonth = fieldExpression(fields, 2, 4);
+        const dayOfWeek = fieldExpression(fields, 4, 2);
         const slots = [];
-        for (let cursor = start; cursor <= end; cursor += 60_000) {
-            const date = new Date(cursor);
-            if (matches(fields, date)) {
-                const at = date.toISOString();
-                slots.push({ identity: `schedule:${config.id}:${at}`, at });
-            }
+        while (expression.hasNext()) {
+            const date = expression.next().toDate();
+            if (!matchesDays(date, dayOfMonth, dayOfWeek))
+                continue;
+            const at = date.toISOString();
+            slots.push({ identity: `schedule:${config.id}:${at}`, at });
         }
         return slots;
     }
@@ -23,24 +33,16 @@ function minute(value) {
         throw new Error('Schedule timestamps must be valid dates');
     return Math.floor(value.getTime() / 60_000) * 60_000;
 }
-function matches(fields, date) {
-    return (matchesField(fields[0], date.getUTCMinutes(), 0, 59) &&
-        matchesField(fields[1], date.getUTCHours(), 0, 23) &&
-        matchesField(fields[2], date.getUTCDate(), 1, 31) &&
-        matchesField(fields[3], date.getUTCMonth() + 1, 1, 12) &&
-        matchesField(fields[4], date.getUTCDay(), 0, 6));
+function hasUnsupportedSyntax(field) {
+    return /[?#]|(^|[,*/-])H(?=$|[,*/-])|(^|[,*/-])L(?=$|[,*/-])|\dL\b/i.test(field);
 }
-function matchesField(expression, value, minimum, maximum) {
-    return expression.split(',').some((part) => {
-        const [base, stepText] = part.split('/');
-        const step = stepText === undefined ? 1 : Number(stepText);
-        if (!Number.isInteger(step) || step < 1)
-            throw new Error(`Invalid cron step: ${part}`);
-        if (base === '*')
-            return (value - minimum) % step === 0;
-        const number = Number(base);
-        if (!Number.isInteger(number) || number < minimum || number > maximum)
-            throw new Error(`Invalid cron field: ${part}`);
-        return value === number;
-    });
+function fieldExpression(fields, index, wildcardIndex) {
+    if (fields[index] === '*')
+        return null;
+    const constrained = [...fields];
+    constrained[wildcardIndex] = '*';
+    return CronExpressionParser.parse(constrained.join(' '), { tz: 'UTC' });
+}
+function matchesDays(date, dayOfMonth, dayOfWeek) {
+    return (dayOfMonth?.includesDate(date) ?? true) && (dayOfWeek?.includesDate(date) ?? true);
 }

package/dist/src/integrations/github/application/agent-run-comment.js

@@ -3,7 +3,7 @@ export function formatAgentRunComment(value) {
     const sections = [
         '<!-- wake:agent -->',
         `<!-- wake:delivery:${value.idempotencyKey} -->`,
-        `**Wake** _(Wake${details ? ` - ${details}` : ''})_`,
+        `**${wakeHeading(value.publicUiUrl)}** _(Wake${details ? ` - ${details}` : ''})_`,
         `**Outcome:** ${value.awaitingApproval === true ? '⏳ Awaiting approval' : outcome(value.outcome)}`,
         value.displayBody.trim() || fallback(value.outcome),
     ];
@@ -19,6 +19,9 @@ export function formatAgentRunComment(value) {
         sections.push(marker);
     return sections.join('\n\n');
 }
+function wakeHeading(publicUiUrl) {
+    return publicUiUrl === undefined ? 'Wake' : `[Wake](${publicUiUrl})`;
+}
 function watchGateMarkerSection(value) {
     if (value.watchGateVerdict === undefined)
         return undefined;

package/dist/src/integrations/github/application/outbound-translator.js

@@ -3,7 +3,7 @@ import { DeliveryIntentKind } from '../../delivery/contracts/vocabulary.js';
 import { parseGitHubResourceKey } from '../contracts/external-key.js';
 import { GitHubAdapter, GitHubOutboundAction, } from '../contracts/vocabulary.js';
 import { formatAgentRunComment } from './agent-run-comment.js';
-export function translateGitHubOutbound(resource, intent) {
+export function translateGitHubOutbound(resource, intent, options = {}) {
     if (resource.externalKey.adapter !== GitHubAdapter)
         throw new Error('Resource is not a GitHub resource');
     const { owner, repo, number } = parseGitHubResourceKey(resource.externalKey.key);
@@ -20,6 +20,7 @@ export function translateGitHubOutbound(resource, intent) {
                 body: formatAgentRunComment({
                     idempotencyKey: intent.intentEventId,
                     ...intent.payload.report,
+                    publicUiUrl: options.publicUiUrl,
                 }),
             }
             : 'body' in intent.payload

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

@@ -35,7 +35,12 @@ export const gitHubProviderDefinition = {
                 const resource = await services.resources.get(resourceId(intent.resourceId));
                 if (resource === null)
                     throw new Error(`GitHub resource ${intent.resourceId} is unavailable`);
-                return client.deliver({ ...translateGitHubOutbound(resource, intent), idempotencyKey });
+                return client.deliver({
+                    ...translateGitHubOutbound(resource, intent, {
+                        publicUiUrl: services.publicUiUrl,
+                    }),
+                    idempotencyKey,
+                });
             }, async (intent) => {
                 if (intent.kind !== BuiltInActivityName.IssueComplete)
                     return null;

package/dist/src/surfaces/contracts/config.js

@@ -10,7 +10,17 @@ export const surfacesConfigSchema = z
         .strict()
         .default({ enabled: false, host: '127.0.0.1', port: 4317 }),
     web: z
-        .object({ enabled: z.boolean().default(false) })
+        .object({
+        enabled: z.boolean().default(false),
+        publicUrl: z
+            .string()
+            .trim()
+            .url()
+            .refine((value) => new URL(value).protocol === 'https:', {
+            message: 'Web public URL must use HTTPS',
+        })
+            .optional(),
+    })
         .strict()
         .default({ enabled: false }),
 })
@@ -30,5 +40,8 @@ export const surfacesConfigSchema = z
         host: value.api.host ?? '127.0.0.1',
         port: value.api.port ?? 4317,
     },
-    web: { enabled: value.web.enabled ?? false },
+    web: {
+        enabled: value.web.enabled ?? false,
+        ...(value.web.publicUrl === undefined ? {} : { publicUrl: value.web.publicUrl }),
+    },
 }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atolis-hq/wake",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "Local autonomous agent control plane for software development",
   "license": "Apache-2.0",
   "repository": {
@@ -66,6 +66,7 @@
   },
   "dependencies": {
     "@octokit/rest": "^22.0.0",
+    "cron-parser": "^5.10.0",
     "execa": "^10.0.1",
     "handlebars": "^4.7.9",
     "ulid": "^3.0.2",