@yeaft/webchat-agent 1.0.565 → 1.0.567

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.565",
+  "version": "1.0.567",
   "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

@@ -28,7 +28,7 @@ const BROWSER_ACTION_DEBUG_OPS = new Set(['get_action_messages', 'get_action_req
 // client-supplied value and only emits files resolved from owned upload ids.
 const BROWSER_FILE_FIELDS = Object.freeze({
   create: [
-    'title', 'goal', 'acceptanceCriteria', 'workItemType', 'workDir', 'deliveryTarget',
+    'title', 'titleSource', 'goal', 'acceptanceCriteria', 'workItemType', 'workDir', 'deliveryTarget', 'deliveryInstructions',
     'reuseMemory', 'files', 'start',
   ],
   post_work_item_message: [

package/yeaft/work-center/coordinator.js

@@ -243,7 +243,7 @@ Return exactly one JSON object and no surrounding prose:
 }
 
 Rules:
-- When workItem.titleSource is coordinator_pending, include a concise title (prefer 6–12 words or a short Chinese phrase; at most 200 characters) in decision.title. This display label summarizes the original goal; it is not a contractPatch and must not rewrite or shorten the goal. Otherwise leave decision.title null. A missing or oversized display title is normalized by the runtime and must not change the substantive decision.
+- When workItem.titleSource is coordinator_pending, include a concise title (prefer 6–12 words or a short Chinese phrase; at most 80 characters) in decision.title. This display label summarizes the original goal; it is not a contractPatch and must not rewrite or shorten the goal. Otherwise leave decision.title null. A missing or oversized display title is normalized by the runtime and must not change the substantive decision.
 - answer: explain state only. Never use it for an automatic advance trigger.
 - Never mutate goal, acceptanceCriteria, or deliveryTarget during automatic advance/recovery. decision.title is the only automatic title-generation path and is allowed only while titleSource is coordinator_pending; contractPatch (including a user-specified title) is allowed only for explicit user-originated refinement, never to make existing evidence pass. For an older WorkItem with no acceptance criteria, request_human to establish its completion condition before commissioning new work.
 - create_actions: create 1..8 currently runnable Actions. Every Action needs type, objective, approach, expectedOutcome, capability, candidateVpIds, assignmentReason, sourceActionIds, workspaceMode, and optional maxAttempts/separateFromActionTypes. sourceActionIds are context/audit references, never scheduling dependencies. Do not include dependsOnActionIds, dependsOnStageIds, stages, or a graph.
@@ -292,11 +292,21 @@ function cleanText(value, limit, name) {
   return text;
 }
 
+function conciseDisplayTitle(value) {
+  const text = String(value || '').trim().replace(/\s+/g, ' ');
+  if (!text) return '';
+  const words = text.split(' ');
+  const concise = words.length > 12 ? `${words.slice(0, 12).join(' ')}…` : text;
+  const characters = [...concise];
+  return characters.length > 80 ? `${characters.slice(0, 79).join('')}…` : concise;
+}
+
 function coordinatorDisplayTitle(value, detail) {
   if (detail.titleSource !== 'coordinator_pending') return null;
   const proposed = typeof value === 'string' ? value.trim() : '';
-  const fallback = String(detail.goal || detail.title || 'Work Item').trim().replace(/\s+/g, ' ');
-  return (proposed || fallback || 'Work Item').slice(0, 200);
+  return conciseDisplayTitle(proposed)
+    || conciseDisplayTitle(detail.goal || detail.title)
+    || 'Work Item';
 }
 
 function requiresDeliveryBoundaryDecision(detail, actions) {
@@ -634,6 +644,7 @@ export function coordinatorSnapshot(detail) {
     titleSource: detail.titleSource || 'explicit',
     goal: truncateUtf8(detail.goal, 4 * 1024),
     deliveryTarget: detail.deliveryTarget || null,
+    deliveryInstructions: truncateUtf8(detail.deliveryInstructions || '', 500) || null,
     acceptanceCriteria,
     workItemType: truncateUtf8(detail.workflowSnapshot?.workItemType, 256) || null,
   };

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

@@ -1,6 +1,6 @@
 import { createHash, randomUUID } from 'node:crypto';
 
-export const WORK_CENTER_SCHEMA_VERSION = 40;
+export const WORK_CENTER_SCHEMA_VERSION = 41;
 
 const MIGRATIONS = [
   ['23-conversation-stream', migrateConversationStream],
@@ -21,6 +21,7 @@ const MIGRATIONS = [
   ['38-action-closure-and-outputs', migrateActionClosureAndOutputs],
   ['39-action-creation-source', migrateActionCreationSource],
   ['40-work-item-schedules', migrateWorkItemSchedules],
+  ['41-delivery-instructions', migrateDeliveryInstructions],
 ];
 
 const MIGRATION_ALIASES = new Map([
@@ -582,6 +583,12 @@ function migrateWorkItemSchedules(db) {
     WHERE schedule_status = 'scheduled'`);
 }
 
+function migrateDeliveryInstructions(db) {
+  if (!hasColumn(db, 'work_items', 'delivery_instructions')) {
+    db.exec('ALTER TABLE work_items ADD COLUMN delivery_instructions TEXT');
+  }
+}
+
 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

@@ -1097,6 +1097,7 @@ export function projectWorkItemDetail(detail, options = {}) {
     schedule: detail.schedule || null,
     deliveryTarget: ['response', 'workspace_files', 'pull_request', 'merge'].includes(detail.deliveryTarget)
       ? detail.deliveryTarget : null,
+    deliveryInstructions: truncateUtf8(detail.deliveryInstructions || '', 2 * 1024),
     waitingReason: sanitizeDiagnosticText(waitingReason(detail), MAX_ACTION_DIAGNOSTIC_CHARS),
     failureReason: workItemFailureReason(detail),
 

package/yeaft/work-center/service.js

@@ -35,6 +35,11 @@ function requiredString(value, name) {
   return value.trim();
 }
 
+function optionalString(value, limit) {
+  if (typeof value !== 'string') return '';
+  return value.trim().slice(0, limit);
+}
+
 function requiredWorkDir(value) {
   const workDir = requiredString(value, 'workDir');
   let canonical;
@@ -164,6 +169,8 @@ export class WorkCenterService {
           watcher: this.watcher.status(),
         };
       }
+      case 'list_delivery_instructions':
+        return { values: this.store.listRecentDeliveryInstructions(payload.limit) };
       case 'get':
         return this.#requiredItem(payload.id);
       case 'get_action_messages': {
@@ -280,6 +287,8 @@ export class WorkCenterService {
             deliveryTarget: requestContext.userOriginated === true
               && ['response', 'workspace_files', 'pull_request', 'merge'].includes(payload.deliveryTarget)
               ? payload.deliveryTarget : null,
+            deliveryInstructions: requestContext.userOriginated === true
+              ? optionalString(payload.deliveryInstructions, 500) : '',
             reuseMemory: payload.reuseMemory !== false,
             origin: payload.origin && typeof payload.origin === 'object'
               ? {

package/yeaft/work-center/store.js

@@ -112,6 +112,7 @@ function mapWorkItem(row) {
     coordinationMode: row.coordination_mode || 'legacy',
     finalResult: parseJson(row.final_result, null),
     deliveryTarget: row.delivery_target || null,
+    deliveryInstructions: row.delivery_instructions || '',
     schedule: row.schedule_status ? {
       status: row.schedule_status,
       scheduledFor: Number(row.scheduled_for) || null,
@@ -863,6 +864,7 @@ export class WorkItemStore {
         coordination_mode TEXT NOT NULL DEFAULT 'legacy',
         final_result TEXT,
         delivery_target TEXT,
+        delivery_instructions TEXT,
         schedule_status TEXT,
         scheduled_for INTEGER,
         schedule_triggered_at INTEGER,
@@ -1161,6 +1163,9 @@ export class WorkItemStore {
     if (!hasColumn(this.db, 'work_items', 'delivery_target')) {
       this.db.exec('ALTER TABLE work_items ADD COLUMN delivery_target TEXT');
     }
+    if (!hasColumn(this.db, 'work_items', 'delivery_instructions')) {
+      this.db.exec('ALTER TABLE work_items ADD COLUMN delivery_instructions TEXT');
+    }
     if (!hasColumn(this.db, 'work_items', 'title_source')) {
       // Old titles were explicit under the previous creation contract.
       this.db.exec("ALTER TABLE work_items ADD COLUMN title_source TEXT NOT NULL DEFAULT 'explicit'");
@@ -2424,15 +2429,16 @@ export class WorkItemStore {
       const id = input.id || randomUUID();
       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,
+        (id, revision, execution_schema_version, ledger_revision, coordination_mode, final_result, delivery_target, delivery_instructions,
          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, 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.deliveryInstructions || null,
         input.schedule?.status || null,
         input.schedule?.scheduledFor || null,
         input.title,
@@ -2463,6 +2469,16 @@ export class WorkItemStore {
     });
   }
 
+  listRecentDeliveryInstructions(limit = 12) {
+    const boundedLimit = Math.min(Math.max(Number(limit) || 12, 1), 24);
+    return this.db.prepare(`SELECT delivery_instructions AS value, MAX(created_at) AS last_used_at
+      FROM work_items
+      WHERE delivery_instructions IS NOT NULL AND trim(delivery_instructions) != ''
+      GROUP BY delivery_instructions
+      ORDER BY last_used_at DESC, value ASC
+      LIMIT ?`).all(boundedLimit).map(row => row.value);
+  }
+
   #insertAction(workItemId, input, sequence, now = this.now(), options = {}) {
     const workItem = this.getWorkItem(workItemId);
     const stageId = input.stageId || input.type;