@yeaft/webchat-agent 1.0.559 → 1.0.562

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.559",
+  "version": "1.0.562",
   "description": "Remote worker agent for Yeaft Web Code Agent — connects the native Yeaft engine, CLI providers, and workbench tools",
   "main": "index.js",
   "type": "module",

package/yeaft/work-center/bridge.js

@@ -254,6 +254,7 @@ export async function handleWorkCenterRequest(msg) {
       op,
       ok: false,
       error: err?.message || String(err),
+      ...(err?.code === 'WORK_CENTER_INPUT_STALE' ? { errorCode: err.code } : {}),
       _requestUserId: msg._requestUserId || null,
     });
   }

package/yeaft/work-center/controller.js

@@ -164,6 +164,19 @@ export class WorkflowController {
     return detail;
   }
 
+  startScheduled(id, scheduledAt) {
+    return this.store.startWorkItemAtomic(id, workItem => {
+      const action = initialActionFor(workItem);
+      if (workItem.reuseMemory === false) return action;
+      const context = this.store.getReusableContext(workItem.workDir, workItem.id);
+      return {
+        ...action,
+        context,
+        instruction: actionInstruction(action, workItem, context, renderSessionContextSnapshot(workItem.sessionContext)),
+      };
+    }, { scheduledAt });
+  }
+
   update(id, patch) {
     const updated = this.store.updateWorkItemAtomic(id, patch, initialActionFor);
     if (!updated) throw new Error(`WorkItem not found: ${id}`);
@@ -251,11 +264,14 @@ export class WorkflowController {
       throw new Error('actionId, revision, and generation are required for Action input');
     }
     const graphMode = workItem.workflowSnapshot?.executionMode === 'graph';
+    const concurrentMode = graphMode || workItem.coordinationMode === 'dynamic';
     const targetMatches = targetAction?.workItemId === id
       && targetAction.generation === expectedGeneration
-      && (graphMode || workItem.currentActionId === input.actionId);
+      && (concurrentMode || workItem.currentActionId === input.actionId);
     if (!targetMatches || workItem.revision !== input.revision) {
-      throw new Error('Action changed before input was applied; refresh and try again');
+      const error = new Error('Action changed before input was applied; refresh and try again');
+      error.code = 'WORK_CENTER_INPUT_STALE';
+      throw error;
     }
     if (['ready', 'running'].includes(targetAction.status)) {
       if (targetAction.status === 'running' && addedAttachmentCount > 0) {
@@ -269,7 +285,9 @@ export class WorkflowController {
       }, input.attachments, input.addedAttachments, input.clientMessageId, quote);
     }
     if (!['waiting', 'failed'].includes(targetAction.status)) {
-      throw new Error(`Action in ${targetAction.status} cannot accept input`);
+      const error = new Error(`Action in ${targetAction.status} cannot accept input`);
+      error.code = 'WORK_CENTER_INPUT_STALE';
+      throw error;
     }
     return this.retry(id, {
       answer: text,

package/yeaft/work-center/durable-model.js

@@ -20,6 +20,7 @@ const MIGRATIONS = [
   ['37-run-acceptance-checks', migrateRunAcceptanceChecks],
   ['38-action-closure-and-outputs', migrateActionClosureAndOutputs],
   ['39-action-creation-source', migrateActionCreationSource],
+  ['40-work-item-schedules', migrateWorkItemSchedules],
 ];
 
 const MIGRATION_ALIASES = new Map([
@@ -566,6 +567,21 @@ function migrateActionClosureAndOutputs(db) {
   `);
 }
 
+function migrateWorkItemSchedules(db) {
+  for (const [column, definition] of [
+    ['schedule_status', 'TEXT'],
+    ['scheduled_for', 'INTEGER'],
+    ['schedule_triggered_at', 'INTEGER'],
+  ]) {
+    if (!hasColumn(db, 'work_items', column)) {
+      db.exec(`ALTER TABLE work_items ADD COLUMN ${column} ${definition}`);
+    }
+  }
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_work_items_schedule_due
+    ON work_items(schedule_status, scheduled_for)
+    WHERE schedule_status = 'scheduled'`);
+}
+
 function migrateActionCreationSource(db) {
   if (!hasColumn(db, 'actions', 'creation_source')) {
     db.exec("ALTER TABLE actions ADD COLUMN creation_source TEXT NOT NULL DEFAULT 'legacy'");

package/yeaft/work-center/projection.js

@@ -1094,6 +1094,7 @@ export function projectWorkItemDetail(detail, options = {}) {
     executionControl: detail.executionControl,
     executionStats: combinedExecutionStats(detail),
     reuseMemory: detail.reuseMemory !== false,
+    schedule: detail.schedule || null,
     deliveryTarget: ['response', 'workspace_files', 'pull_request', 'merge'].includes(detail.deliveryTarget)
       ? detail.deliveryTarget : null,
     waitingReason: sanitizeDiagnosticText(waitingReason(detail), MAX_ACTION_DIAGNOSTIC_CHARS),
@@ -1204,6 +1205,7 @@ export function projectWorkItemSummary(detail) {
       executionStats: combinedExecutionStats(detail),
       executionControl: detail.executionControl,
       origin: detail.origin?.sessionId ? { sessionId: detail.origin.sessionId } : null,
+      schedule: detail.schedule || null,
       linkedSessionIds: Array.isArray(detail.linkedSessionIds) ? detail.linkedSessionIds : [],
       attachmentCount: Array.isArray(detail.attachments) ? detail.attachments.length : 0,
       createdAt: detail.createdAt,
@@ -1244,6 +1246,7 @@ export function projectWorkItemSummary(detail) {
     currentAction: projectCurrentActionSummary(action, projectedAction),
     actionStats: projectActionStats(detail, null),
     origin: detail.origin?.sessionId ? { sessionId: detail.origin.sessionId } : null,
+    schedule: detail.schedule || null,
     linkedSessionIds: Array.isArray(detail.linkedSessionIds) ? detail.linkedSessionIds : [],
     attachmentCount: Array.isArray(detail.attachments) ? detail.attachments.length : 0,
     createdAt: detail.createdAt,

package/yeaft/work-center/service.js

@@ -97,6 +97,7 @@ export class WorkCenterService {
   constructor(options) {
     const yeaftDir = requiredString(options?.yeaftDir, 'yeaftDir');
     this.yeaftDir = yeaftDir;
+    this.now = typeof options.now === 'function' ? options.now : () => Date.now();
     this.settingsReader = options.settingsReader || readWorkCenterSettings;
     this.settingsWriter = options.settingsWriter || writeWorkCenterSettings;
     this.runtimeInfoProvider = typeof options.runtimeInfoProvider === 'function'
@@ -246,7 +247,13 @@ export class WorkCenterService {
             root: this.attachmentRoot,
             workItemId,
           });
-          const shouldStart = payload.start === undefined ? settings.startImmediately : payload.start !== false;
+          const scheduledFor = payload.scheduledFor == null || payload.scheduledFor === ''
+            ? null : Number(payload.scheduledFor);
+          if (scheduledFor != null && (!Number.isSafeInteger(scheduledFor) || scheduledFor <= this.now())) {
+            throw new Error('scheduledFor must be in the future');
+          }
+          const shouldStart = scheduledFor == null
+            && (payload.start === undefined ? settings.startImmediately : payload.start !== false);
           const goal = requiredString(payload.goal, 'goal');
           const explicitTitle = payload.titleSource !== 'coordinator_pending' && typeof payload.title === 'string'
             ? payload.title.trim() : '';
@@ -289,6 +296,10 @@ export class WorkCenterService {
               ? normalizeSessionContextSnapshot(payload.sessionContext)
               : [],
             attachments,
+            schedule: scheduledFor == null ? null : {
+              status: payload.scheduleEnabled === false ? 'paused' : 'scheduled',
+              scheduledFor,
+            },
             start: false,
           });
           let detail = this.#requiredItem(workItemId);
@@ -313,6 +324,13 @@ export class WorkCenterService {
         this.#emit({ type: 'work_item.updated', workItem: detail });
         return detail;
       }
+      case 'update_schedule': {
+        const id = requiredString(payload.id, 'id');
+        const detail = this.store.updateWorkItemSchedule(id, payload.schedule || payload);
+        if (!detail) throw new Error(`WorkItem not found: ${id}`);
+        this.#emit({ type: 'work_item.schedule_updated', workItem: detail });
+        return detail;
+      }
       case 'start': {
         const detail = this.controller.start(requiredString(payload.id, 'id'));
         if (detail.coordinationMode === DYNAMIC_COORDINATION_MODE) {
@@ -715,7 +733,16 @@ export class WorkCenterService {
     }
   }
 
+  #scanSchedules() {
+    const now = this.now();
+    for (const id of this.store.listDueScheduledWorkItemIds(now)) {
+      const detail = this.controller.startScheduled(id, now);
+      if (detail) this.#emit({ type: 'work_item.schedule_triggered', workItem: detail });
+    }
+  }
+
   #scanRecoveries() {
+    this.#scanSchedules();
     this.#scanCoordinatorProviderRecoveries();
     this.#scanDynamicCoordinatorWakes();
     this.#scanFailureRecoveries();

package/yeaft/work-center/store.js

@@ -112,6 +112,11 @@ function mapWorkItem(row) {
     coordinationMode: row.coordination_mode || 'legacy',
     finalResult: parseJson(row.final_result, null),
     deliveryTarget: row.delivery_target || null,
+    schedule: row.schedule_status ? {
+      status: row.schedule_status,
+      scheduledFor: Number(row.scheduled_for) || null,
+      triggeredAt: Number(row.schedule_triggered_at) || null,
+    } : null,
     title: row.title,
     titleSource: row.title_source || 'explicit',
     requirement: row.requirement ?? row.goal,
@@ -858,6 +863,9 @@ export class WorkItemStore {
         coordination_mode TEXT NOT NULL DEFAULT 'legacy',
         final_result TEXT,
         delivery_target TEXT,
+        schedule_status TEXT,
+        scheduled_for INTEGER,
+        schedule_triggered_at INTEGER,
         title TEXT NOT NULL,
         title_source TEXT NOT NULL DEFAULT 'explicit',
         requirement TEXT,
@@ -1022,6 +1030,16 @@ export class WorkItemStore {
 
     // The feature shipped first as an unmerged PR, but keep the store tolerant
     // of databases created by review builds.
+    if (!hasColumn(this.db, 'work_items', 'schedule_status')) {
+      this.db.exec('ALTER TABLE work_items ADD COLUMN schedule_status TEXT');
+    }
+    if (!hasColumn(this.db, 'work_items', 'scheduled_for')) {
+      this.db.exec('ALTER TABLE work_items ADD COLUMN scheduled_for INTEGER');
+    }
+    if (!hasColumn(this.db, 'work_items', 'schedule_triggered_at')) {
+      this.db.exec('ALTER TABLE work_items ADD COLUMN schedule_triggered_at INTEGER');
+    }
+
     if (!hasColumn(this.db, 'work_items', 'workspace_key')) {
       withTransaction(this.db, () => {
         this.db.exec("ALTER TABLE work_items ADD COLUMN workspace_key TEXT NOT NULL DEFAULT ''");
@@ -1944,7 +1962,9 @@ export class WorkItemStore {
         ? ['ready', 'running', 'waiting', 'needs_attention']
         : ['ready', 'running'];
       if (!inputStatuses.includes(workItem.status)) {
-        throw new Error(`WorkItem in ${workItem.status} cannot accept Action input`);
+        const error = new Error(`WorkItem in ${workItem.status} cannot accept Action input`);
+        error.code = 'WORK_CENTER_INPUT_STALE';
+        throw error;
       }
       const action = this.getAction(expected.actionId);
       const actionMatches = action?.workItemId === id
@@ -1956,7 +1976,9 @@ export class WorkItemStore {
         || (activeRun?.status === 'running' && activeRun.acceptingInput !== false
           && runMatchesActionIdentity(activeRun, action));
       if (!actionMatches || !runMatches || workItem.revision !== expected.revision) {
-        throw new Error('Action changed before input was applied; refresh and try again');
+        const error = new Error('Action changed before input was applied; refresh and try again');
+        error.code = 'WORK_CENTER_INPUT_STALE';
+        throw error;
       }
       const projectedAttachments = (Array.isArray(addedAttachments) ? addedAttachments : []).map(attachment => ({
         id: attachment.id,
@@ -1998,7 +2020,7 @@ export class WorkItemStore {
         const changedAction = this.db.prepare(`UPDATE actions SET context = ?, instruction = ?, attempt = 0,
           generation = generation + 1, spec_hash = ?, identity_history = ?, result_run_id = NULL,
           workspace = NULL, updated_at = ? WHERE id = ? AND status = 'ready' AND current_run_id IS NULL
-          AND generation = ? AND spec_hash = ?`).run(
+          AND generation = ? AND spec_hash = ? AND contract_revision = ?`).run(
           stringify(context),
           nextAction.instruction,
           nextAction.specHash,
@@ -2007,9 +2029,12 @@ export class WorkItemStore {
           action.id,
           action.generation,
           action.specHash,
+          action.contractRevision,
         );
         if (Number(changedAction.changes) !== 1) {
-          throw new Error('Action changed before input was applied; refresh and try again');
+          const error = new Error('Action changed before input was applied; refresh and try again');
+          error.code = 'WORK_CENTER_INPUT_STALE';
+          throw error;
         }
         this.#supersedePendingActionInputs(
           [action],
@@ -2400,14 +2425,16 @@ export class WorkItemStore {
       const workspaceKey = canonicalWorkspaceKey(input.workDir);
       this.db.prepare(`INSERT INTO work_items
         (id, revision, execution_schema_version, ledger_revision, coordination_mode, final_result, delivery_target,
-         title, title_source, requirement, goal, acceptance_criteria, workflow_template, workflow_snapshot, status,
+         schedule_status, scheduled_for, schedule_triggered_at, title, title_source, requirement, goal, acceptance_criteria, workflow_template, workflow_snapshot, status,
          current_action_id, current_run_id, work_dir, workspace_key, reuse_memory, origin, linked_session_ids,
          session_context, attachments, created_at, updated_at)
-        VALUES (?, 1, ?, 0, ?, NULL, ?, ?, ?, ?, ?, ?, ?, ?, ?, NULL, NULL, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
+        VALUES (?, 1, ?, 0, ?, NULL, ?, ?, ?, NULL, ?, ?, ?, ?, ?, ?, ?, ?, NULL, NULL, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
         id,
         Number.isInteger(input.executionSchemaVersion) ? input.executionSchemaVersion : 2,
         input.coordinationMode || 'legacy',
         input.deliveryTarget || null,
+        input.schedule?.status || null,
+        input.schedule?.scheduledFor || null,
         input.title,
         input.titleSource === 'coordinator_pending' ? 'coordinator_pending' : 'explicit',
         input.goal,
@@ -3092,6 +3119,32 @@ export class WorkItemStore {
       }));
   }
 
+  listDueScheduledWorkItemIds(now = this.now()) {
+    return this.db.prepare(`SELECT id FROM work_items
+      WHERE schedule_status = 'scheduled' AND scheduled_for <= ? AND status = 'draft'
+      ORDER BY scheduled_for, id`).all(now).map(row => row.id);
+  }
+
+  updateWorkItemSchedule(id, input = {}) {
+    return withTransaction(this.db, () => {
+      const row = this.db.prepare('SELECT * FROM work_items WHERE id = ?').get(id);
+      if (!row) return null;
+      if (row.status !== 'draft' || !['scheduled', 'paused'].includes(row.schedule_status)) {
+        throw new Error('Only pending scheduled WorkItems can be changed');
+      }
+      const scheduledFor = input.scheduledFor == null ? Number(row.scheduled_for) : Number(input.scheduledFor);
+      if (!Number.isSafeInteger(scheduledFor) || scheduledFor <= this.now()) {
+        throw new Error('scheduledFor must be in the future');
+      }
+      const status = input.enabled === false ? 'paused' : 'scheduled';
+      const now = this.now();
+      this.db.prepare(`UPDATE work_items SET schedule_status = ?, scheduled_for = ?,
+        revision = revision + 1, updated_at = ? WHERE id = ?`).run(status, scheduledFor, now, id);
+      this.appendEvent(id, 'work_item.schedule_updated', { status, scheduledFor });
+      return this.getWorkItemDetail(id);
+    });
+  }
+
   listWorkItems(filters = {}) {
     const where = [];
     const values = [];
@@ -4485,10 +4538,14 @@ export class WorkItemStore {
     });
   }
 
-  startWorkItemAtomic(id, makeInitialAction) {
+  startWorkItemAtomic(id, makeInitialAction, options = {}) {
     return withTransaction(this.db, () => {
       const workItem = this.getWorkItem(id);
       if (!workItem) return null;
+      const scheduledAt = Number(options.scheduledAt);
+      const scheduledStart = Number.isSafeInteger(scheduledAt);
+      if (scheduledStart && (workItem.status !== 'draft' || workItem.schedule?.status !== 'scheduled'
+          || workItem.schedule.scheduledFor > scheduledAt)) return null;
       if (['done', 'cancelled'].includes(workItem.status)) {
         throw new Error(`Cannot start WorkItem in ${workItem.status}`);
       }
@@ -4498,13 +4555,18 @@ export class WorkItemStore {
         throw new Error(`WorkItem in ${workItem.status} must be resumed with retry`);
       }
       const now = this.now();
+      if (scheduledStart) {
+        this.db.prepare(`UPDATE work_items SET schedule_status = 'triggered',
+          schedule_triggered_at = ?, revision = revision + 1, updated_at = ? WHERE id = ?`)
+          .run(scheduledAt, now, id);
+      }
       if (isDynamicWorkItem(workItem)) {
         this.db.prepare(`UPDATE work_items SET status = 'running', current_action_id = NULL,
           current_run_id = NULL, updated_at = ? WHERE id = ?`).run(now, id);
         this.enqueueCoordinatorMailbox(id, 'work_item_started', {
           trigger: { workItemId: id },
         }, `dynamic:start:${id}:${workItem.revision}`);
-        this.appendEvent(id, 'work_item.started');
+        this.appendEvent(id, 'work_item.started', scheduledStart ? { scheduled: true } : {});
         return this.getWorkItemDetail(id);
       }
       const action = this.#insertAction(id, {
@@ -4513,7 +4575,7 @@ export class WorkItemStore {
       }, this.#nextSequence(id), now);
       this.db.prepare(`UPDATE work_items SET status = 'ready', current_action_id = ?,
         current_run_id = NULL, updated_at = ? WHERE id = ?`).run(action.id, now, id);
-      this.appendEvent(id, 'work_item.started', {}, { actionId: action.id });
+      this.appendEvent(id, 'work_item.started', scheduledStart ? { scheduled: true } : {}, { actionId: action.id });
       return this.getWorkItemDetail(id);
     });
   }
@@ -4536,12 +4598,15 @@ export class WorkItemStore {
       }
       const workItem = this.getWorkItem(id);
       if (!workItem) return null;
+      const dynamicMode = isDynamicWorkItem(workItem);
       const graphMode = usesLegacyGraph(workItem);
-      const retryableWorkItemStatuses = graphMode
+      const retryableWorkItemStatuses = graphMode || dynamicMode
         ? ['ready', 'running', 'waiting', 'needs_attention']
         : ['waiting', 'needs_attention'];
       if (!retryableWorkItemStatuses.includes(workItem.status)) {
-        throw new Error(`WorkItem in ${workItem.status} does not need retry`);
+        const error = new Error(`WorkItem in ${workItem.status} does not need retry`);
+        error.code = 'WORK_CENTER_INPUT_STALE';
+        throw error;
       }
       let previous = workItem.currentActionId ? this.getAction(workItem.currentActionId) : null;
       if (options.expected) {
@@ -4553,10 +4618,12 @@ export class WorkItemStore {
         const hasExpectedGeneration = Number.isInteger(expectedGeneration) && expectedGeneration > 0;
         const expectedMatches = expectedAction?.workItemId === id
           && allowedExpectedStatuses.includes(expectedAction.status)
-          && (graphMode || workItem.currentActionId === options.expected.actionId)
-          && (hasExpectedGeneration ? expectedAction.generation === expectedGeneration : !graphMode);
+          && (graphMode || dynamicMode || workItem.currentActionId === options.expected.actionId)
+          && (hasExpectedGeneration ? expectedAction.generation === expectedGeneration : !(graphMode || dynamicMode));
         if (!expectedMatches || workItem.revision !== options.expected.revision) {
-          throw new Error('Action changed before input was applied; refresh and try again');
+          const error = new Error('Action changed before input was applied; refresh and try again');
+          error.code = 'WORK_CENTER_INPUT_STALE';
+          throw error;
         }
         previous = expectedAction;
       }
@@ -4565,7 +4632,7 @@ export class WorkItemStore {
             AND status != 'running' ORDER BY ended_at DESC, started_at DESC LIMIT 1`).get(id, previous.id))
         : null;
       const now = this.now();
-      const revision = options.expected ? workItem.revision + 1 : workItem.revision;
+      const revision = options.expected && !dynamicMode ? workItem.revision + 1 : workItem.revision;
       const replacement = {
         ...makeAction(workItem, previous, previousRun),
         contractRevision: previous?.contractRevision ?? workItem.revision,
@@ -4573,6 +4640,55 @@ export class WorkItemStore {
       const inputEvent = options.inputEvent && typeof options.inputEvent === 'object'
         ? options.inputEvent
         : null;
+      if (dynamicMode) {
+        if (!previous) throw new Error('Dynamic WorkItem retry target is missing');
+        const candidate = {
+          ...previous,
+          ...replacement,
+          id: previous.id,
+          generation: previous.generation + 1,
+          attempt: 0,
+          currentRunId: null,
+          resultRunId: null,
+          workspace: null,
+        };
+        candidate.instruction = canonicalActionInstruction(workItem, candidate, candidate.context);
+        candidate.specHash = actionSpecHash(candidate);
+        const changed = this.db.prepare(`UPDATE actions SET status = 'ready', attempt = 0,
+          current_run_id = NULL, context = ?, instruction = ?, generation = generation + 1,
+          spec_hash = ?, identity_history = ?, result_run_id = NULL, workspace = NULL, updated_at = ?
+          WHERE id = ? AND work_item_id = ? AND status IN ('waiting', 'failed')
+            AND current_run_id IS NULL AND generation = ? AND spec_hash = ? AND contract_revision = ?`).run(
+          stringify(candidate.context), candidate.instruction, candidate.specHash,
+          stringify(actionIdentityHistory(previous, candidate.generation, candidate.specHash)),
+          now, previous.id, id, previous.generation, previous.specHash, previous.contractRevision,
+        );
+        if (Number(changed.changes) !== 1) {
+          const error = new Error('Action changed before input was applied; refresh and try again');
+          error.code = 'WORK_CENTER_INPUT_STALE';
+          throw error;
+        }
+        const changedWorkItem = this.db.prepare(`UPDATE work_items SET attachments = ?, updated_at = ?
+          WHERE id = ? AND revision = ? AND status NOT IN ('done', 'cancelled')`).run(
+          stringify(Array.isArray(options.attachments) ? options.attachments : workItem.attachments),
+          now, id, workItem.revision,
+        );
+        if (Number(changedWorkItem.changes) !== 1) {
+          const error = new Error('Action changed before input was applied; refresh and try again');
+          error.code = 'WORK_CENTER_INPUT_STALE';
+          throw error;
+        }
+        const action = this.getAction(previous.id);
+        if (inputEvent) {
+          this.appendEvent(id, 'action.input_added', inputEvent, {
+            actionId: action.id,
+            actionGeneration: action.generation,
+          });
+        } else {
+          this.appendEvent(id, 'work_item.retried', {}, { actionId: action.id });
+        }
+        return this.getWorkItemDetail(id);
+      }
       if (graphMode) {
         if (!previous) throw new Error('WorkItem graph retry target is missing');
         const action = this.#resetGraphFromStage(