dsh-data-cleaning-agent 0.6.0 → 0.6.2

package/lib/web.js

@@ -10,6 +10,7 @@
 import { parseCsv, parseXlsx, parseJson, detectFormat, toCsv } from './engine.js';
 import { runSync, DataCleaningJobs } from './jobs.js';
 import { QccBridgeError, QccHostBridge } from './qcc.js';
+import { QccCommandStore, registerQccCommandTool, TOOL_QCC_COMMAND } from './qcc-command.js';
 import { fingerprintRequest, G5RunStore } from './qcc-runs.js';
 import { PHASE3_BATCH_LIMITS, Phase3BatchService, Phase3RunStore } from './qcc-phase3-batch.js';
 import { publicWorkflowContract } from './workflow-contract.js';
@@ -68,7 +69,7 @@ function requirePaidConfirmation(payload) {
 }
 
 function qccHttpStatus(code) {
-  if (code === 'QCC_RUN_NOT_FOUND') return 404;
+  if (code === 'QCC_RUN_NOT_FOUND' || code === 'QCC_COMMAND_NOT_FOUND') return 404;
   if (code === 'QCC_AUTH_REQUIRED') return 401;
   if (code === 'QCC_PERMISSION_DENIED') return 403;
   if (code === 'QCC_QUOTA_EXHAUSTED') return 402;
@@ -79,6 +80,8 @@ function qccHttpStatus(code) {
     || code === 'QCC_TOOL_UNAVAILABLE'
     || code === 'QCC_UPSTREAM_UNAVAILABLE'
     || code === 'QCC_IDEMPOTENCY_CAPACITY'
+    || code === 'QCC_COMMAND_CAPACITY'
+    || code === 'QCC_AGENT_COMMAND_UNAVAILABLE'
   ) return 503;
   if (
     code === 'QCC_CONFIRM_REQUIRED'
@@ -89,6 +92,7 @@ function qccHttpStatus(code) {
     || code === 'QCC_OPERATION_IN_PROGRESS'
     || code === 'QCC_RETRY_NOT_FAILED'
     || code === 'QCC_RETRY_NOT_ALLOWED'
+    || code === 'QCC_AGENT_EXECUTION_REQUIRED'
   ) return 409;
   return 400;
 }
@@ -282,6 +286,13 @@ export function mountWebRoutes(wctx, { logger, report, TOOL_NAME, SKILL_NAME })
   const disposers = [];
   const qccBridge = new QccHostBridge({ tools, logger });
   const g5Runs = new G5RunStore();
+  const qccCommands = new QccCommandStore({ bridge: qccBridge, runs: g5Runs });
+  if (typeof tools?.register === 'function') {
+    disposers.push(registerQccCommandTool(tools, qccCommands));
+    report.qccCommandToolRegistered = true;
+  } else {
+    report.qccCommandToolRegistered = false;
+  }
   const phase3Service = new Phase3BatchService(qccBridge);
   const phase3Runs = new Phase3RunStore();
   report.qccBridgeMounted = true;
@@ -449,6 +460,7 @@ export function mountWebRoutes(wctx, { logger, report, TOOL_NAME, SKILL_NAME })
           const artifacts = await artifactStore.createBundle(taskId, {
             rows: payload.rows,
             headers: payload.headers,
+            fieldSelection: readyTask.fieldSelection,
             exceptionRows: payload.exceptionRows,
             baseName: payload.baseName || readyTask.title,
           });
@@ -531,10 +543,52 @@ export function mountWebRoutes(wctx, { logger, report, TOOL_NAME, SKILL_NAME })
       idempotencyRequired: true,
       candidateResume: true,
       manualRetry: true,
+      agentCommandTool: TOOL_QCC_COMMAND,
+      agentCommandToolRegistered: report.qccCommandToolRegistered,
+      agentOwnedExecutionRequired: true,
       runPersistence: 'host-memory',
     });
   });
 
+  register('/data-cleaning/api/g5/commands', async (req, res) => {
+    if (!isTrusted(req)) return writeJson(res, 403, { ok: false, error: 'untrusted origin' });
+    try {
+      const pathname = new URL(req.url ?? '/data-cleaning/api/g5/commands', 'http://127.0.0.1').pathname;
+      const segments = pathname.split('/').filter(Boolean);
+      const commandsIndex = segments.indexOf('commands');
+      const rest = commandsIndex >= 0 ? segments.slice(commandsIndex + 1) : [];
+      if (rest.length === 0 && req.method === 'POST') {
+        if (!report.qccCommandToolRegistered) {
+          throw new QccBridgeError(
+            'QCC_AGENT_COMMAND_UNAVAILABLE',
+            'The current DSH Host does not expose the Agent command registration API.',
+          );
+        }
+        const payload = JSON.parse((await readBody(req)).toString('utf8'));
+        requirePaidConfirmation(payload);
+        return writeJson(res, 201, {
+          ok: true,
+          marker: 'g5-agent-command',
+          paidCalls: false,
+          command: qccCommands.prepare(payload),
+        });
+      }
+      if (rest.length === 1 && req.method === 'GET') {
+        return writeJson(res, 200, {
+          ok: true,
+          marker: 'g5-agent-command',
+          command: qccCommands.status(decodeURIComponent(rest[0])),
+        });
+      }
+      return writeJson(res, 405, { ok: false, code: 'DC_METHOD', message: 'POST a command or GET one command id' });
+    } catch (error) {
+      if (error instanceof SyntaxError) {
+        return writeJson(res, 400, { ok: false, code: 'DC_BAD_JSON', message: 'Request body must be valid JSON.' });
+      }
+      return writeQccError(res, error);
+    }
+  });
+
   register('/data-cleaning/api/phase2/capabilities', (req, res) => {
     if (!isTrusted(req)) return writeJson(res, 403, { ok: false, error: 'untrusted origin' });
     if (req.method !== 'GET') {

package/lib/workflow-contract.js

@@ -117,6 +117,15 @@ export const FIELD_CATALOG = Object.freeze([
   }),
 ]);
 
+export const FIELD_LABELS = Object.freeze(Object.fromEntries(
+  FIELD_CATALOG.flatMap((group) => group.fields.map((field) => [field.id, field.label])),
+));
+
+export function fieldLabel(fieldId) {
+  const id = String(fieldId ?? '').trim();
+  return FIELD_LABELS[id] ?? id;
+}
+
 const FIELD_IDS = new Set(FIELD_CATALOG.flatMap((group) => group.fields.map((field) => field.id)));
 const STAGE_IDS = new Set(WORKFLOW_STAGES.map((stage) => stage.id));
 const STATE_IDS = new Set(WORKFLOW_STATES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-data-cleaning-agent",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Clean, complete, and profile enterprise name lists in DeepSeek Harness — a data cleaning & completion agent plugin with local CSV/XLSX/JSON engine and optional Qichacha (QCC) MCP enrichment. Maintained by Qichacha/QCC.",
   "type": "module",
   "main": "lib/index.js",
@@ -32,6 +32,8 @@
     "docs/RELEASE-0.5.2.md",
     "docs/RELEASE-0.5.3.md",
     "docs/RELEASE-0.6.0.md",
+    "docs/RELEASE-0.6.1.md",
+    "docs/RELEASE-0.6.2.md",
     "docs/UI-WORKFLOW-V2.md",
     "docs/UI-WORKFLOW-V2-MIGRATION.md",
     "docs/UI-WORKFLOW-V2-ACCEPTANCE.md",
@@ -40,7 +42,7 @@
   ],
   "scripts": {
     "test": "node --test",
-    "lint": "node --check lib/index.js && node --check lib/engine.js && node --check lib/artifacts.js && node --check lib/tools.js && node --check lib/skill.js && node --check lib/qcc-phase2.js && node --check lib/qcc-phase3.js && node --check lib/qcc-phase3-batch.js && node --check lib/qcc-phase2-acceptance.js && node --check lib/skill-enrich.js && node --check lib/jobs.js && node --check lib/workflow-contract.js && node --check lib/workflow.js && node --check lib/qcc-safety.js && node --check lib/qcc.js && node --check lib/qcc-runs.js && node --check lib/web.js && node --check lib/client.js && node --check scripts/check-readme-version.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/g5-e2e.mjs && node --check scripts/phase3-e2e.mjs && node --check scripts/phase2-acceptance.mjs",
+    "lint": "node --check lib/index.js && node --check lib/engine.js && node --check lib/artifacts.js && node --check lib/tools.js && node --check lib/skill.js && node --check lib/qcc-phase2.js && node --check lib/qcc-phase3.js && node --check lib/qcc-phase3-batch.js && node --check lib/qcc-phase2-acceptance.js && node --check lib/skill-enrich.js && node --check lib/jobs.js && node --check lib/workflow-contract.js && node --check lib/workflow.js && node --check lib/qcc-safety.js && node --check lib/qcc.js && node --check lib/qcc-command.js && node --check lib/qcc-runs.js && node --check lib/web.js && node --check lib/client.js && node --check scripts/check-readme-version.mjs && node --check scripts/check-market-registration.mjs && node --check scripts/g5-e2e.mjs && node --check scripts/phase3-e2e.mjs && node --check scripts/phase2-acceptance.mjs",
     "docs:check": "node scripts/check-readme-version.mjs",
     "marketing:check": "node scripts/check-marketing.mjs",
     "verify-pack": "node scripts/verify-pack.mjs",