@wowok/agent-mcp 3.4.1 → 3.4.3

package/dist/schemas/query_toolkit.schema.json

@@ -1071,14 +1071,20 @@
           "type": "string"
         },
         "items": {
-          "description": "Basket to quote. Omit to quote EVERY sale with quantity 1 (the floor basket — order quantity is chosen at buy time, so per-unit prices are the authoritative input).",
+          "description": "Basket to quote. Omit to quote EVERY sale with quantity 1 (the floor basket — order quantity is chosen at buy time, so per-unit prices are the authoritative input). Each item names its sale via `name` (exact literal) or `sale_id` (0-based index) — exactly one.",
           "type": "array",
           "items": {
             "type": "object",
             "properties": {
               "name": {
-                "type": "string",
-                "description": "Sale name exactly as configured on the Service."
+                "description": "Sale name exactly as configured on the Service. Required unless sale_id is given.",
+                "type": "string"
+              },
+              "sale_id": {
+                "description": "0-based index of the sale in the Service's configured sales list (same enumeration the buy tool accepts). Required unless name is given.",
+                "type": "integer",
+                "minimum": 0,
+                "maximum": 9007199254740991
               },
               "quantity": {
                 "default": 1,
@@ -1089,7 +1095,6 @@
               }
             },
             "required": [
-              "name",
               "quantity"
             ],
             "additionalProperties": false
@@ -1114,6 +1119,10 @@
             "localnet"
           ],
           "description": "Network for the query — THIS field is `context_network` (the query tools accept no separate `network` key). Defaults to the user's CURRENT network (client UI selection / authority config) when omitted. 'localnet' is for internal test use against a local fullnode."
+        },
+        "no_cache": {
+          "description": "A-5 freshness control, same convention as the panorama family (DEFAULT TRUE = read fresh, bypass the object cache). A quote that feeds an exact total_pay must never come from a stale cache — pass false only for high-frequency polling.",
+          "type": "boolean"
         }
       },
       "required": [
@@ -1157,7 +1166,11 @@
           "const": "object_panorama"
         },
         "object_address": {
-          "description": "On-chain object address (0x followed by 32-64 hex chars) for object_panorama. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error.",
+          "description": "On-chain object address (0x followed by 32-64 hex chars) for object_panorama. Also accepts a LocalMark NAME (resolved automatically). H-06 fix: invalid formats are rejected at the handler level with a descriptive error. F27 (gf32-mn-261103): `object` is accepted as an alias too — the write faces all take `object`, so a driver reusing one helper for reads and writes no longer trips on the key name.",
+          "type": "string"
+        },
+        "object": {
+          "description": "ALIAS of object_address (accepted for write-face key compatibility — every write tool takes `object`). Prefer object_address on query calls. Example: {\"query_type\": \"object_panorama\", \"object\": \"0xabc...\"}.",
           "type": "string"
         },
         "filter": {

package/dist/schemas/wip_file.output.json

@@ -191,7 +191,7 @@
                 "properties": {
                   "hash": {
                     "type": "string",
-                    "description": "WIP file hash (meta.hash)"
+                    "description": "WIP file hash = meta.hash, the CANONICAL commitment hash (sha256 over key-sorted, whitespace-free {wip, payload} JSON, meta excluded) — the same value the Service anchors on-chain as wip_hash, and the key the file is stored/deleted under. NOT the sha256 of the raw file bytes"
                   },
                   "name": {
                     "description": "Optional display name",
@@ -266,7 +266,7 @@
                 "properties": {
                   "hash": {
                     "type": "string",
-                    "description": "WIP file hash (meta.hash)"
+                    "description": "WIP file hash = meta.hash, the CANONICAL commitment hash (sha256 over key-sorted, whitespace-free {wip, payload} JSON, meta excluded) — the same value the Service anchors on-chain as wip_hash, and the key the file is stored/deleted under. NOT the sha256 of the raw file bytes"
                   },
                   "name": {
                     "description": "Optional display name",

package/dist/schemas/wip_file.schema.json

@@ -81,7 +81,7 @@
           "description": "WIP file path to verify. Supports: 1) Local file path (e.g., '/path/to/file.wip', 'C:\\Users\\name\\doc.wip'), 2) Network URL (e.g., 'https://example.com/doc.wip', 'http://site.com/file.wip'), 3) Data URL (e.g., 'data:application/json;base64,eyJ3aXAiOi...')"
         },
         "hash_equal": {
-          "description": "Optional expected hash value. If provided, the function will first verify if the file's hash matches this value. If not matched, returns hash mismatch error.",
+          "description": "Optional expected COMMITMENT hash (F-23 field clarification). Compared against the file's meta.hash — the CANONICAL commitment hash (sha256 over key-sorted, whitespace-free {wip, payload} JSON, meta excluded), which is exactly what the Service anchors on-chain as wip_hash. This is NOT the sha256 of the raw downloaded file bytes (the verify result carries that separately as content_sha256): comparing a raw-file digest against meta.hash / the on-chain wip_hash always false-negatives (ddmc4 B-23). If not matched, returns hash mismatch error.",
           "type": "string"
         },
         "requireSignature": {
@@ -214,7 +214,7 @@
         "wipFilePath"
       ],
       "additionalProperties": false,
-      "description": "Upload a signed WIP file to a wip storage service. The upload request is signed with the account's Falcon512 key; the file is validated (format, size limits, content hash, signatures) and stored under its content hash with a public download URL. When the per-account file limit is reached, the error carries the account's stored file list for deletion. Large, image-heavy WIP files are network-sensitive: keep them small (compress images before generate) and retry on transient network failures. WIP files are off-chain and network-independent: the returned public URL works on both testnet and mainnet"
+      "description": "Upload a signed WIP file to a wip storage service. The upload request is signed with the account's Falcon512 key; the file is validated (format, size limits, content hash, signatures) and stored under its CANONICAL COMMITMENT hash (meta.hash — the same value a Service anchors on-chain as wip_hash; NOT the raw-file sha256) with a public download URL. The upload response's `hash` field IS that commitment value: pass it directly as the sale row's wip_hash (template_generate writes it back automatically when this session performed the upload). When the per-account file limit is reached, the error carries the account's stored file list for deletion. Large, image-heavy WIP files are network-sensitive: keep them small (compress images before generate) and retry on transient network failures. WIP files are off-chain and network-independent: the returned public URL works on both testnet and mainnet"
     },
     {
       "type": "object",

package/dist/schemas/workflow_operation.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://wowok.net/schemas/workflow_operation.json",
   "title": "Workflow - Local-Account Progress Tasks",
-  "description": "workflow_operation input. action='list' enumerates progress related to local accounts (actionable first, plus completed/related progress with viewable history); action='task' builds the SAME snapshot for ONE progress (options may carry empty executable_accounts — the client grays the actions); action='operate' advances/holds/unholds a forward as a chosen local account; action='history' incrementally syncs + returns a progress's on-chain history.",
+  "description": "workflow_operation input. action='list' enumerates progress related to local accounts (actionable first, plus completed/related progress with viewable history); action='task' builds the SAME snapshot for ONE progress (options may carry empty executable_accounts — the client grays the actions); action='operate' advances/holds/unholds a forward as a chosen local account; action='history' incrementally syncs + returns a progress's on-chain history. NETWORK POSITION (single): the native shape takes network at the TOP LEVEL of the input; the onchain progress envelope ({operation_type:'progress', data, env}) takes it in env. A network misplaced inside data (or inside env on the native shape) is REFUSED with a fail-loud error — it never silently falls back to the default network.",
   "oneOf": [
     {
       "type": "object",

package/dist/tools/error-catalog.d.ts

@@ -0,0 +1,17 @@
+import { type ErrorClassification } from "../schema/call/semantic.js";
+export interface ErrorCatalogEntry {
+    module: string;
+    code: string;
+    canonical: string;
+    next_action: string;
+}
+export interface CatalogFields {
+    code: string;
+    canonical: string;
+    next_action: string;
+    detail?: string;
+}
+export declare const ERROR_CATALOG: Record<string, ErrorCatalogEntry>;
+export declare function lookupCatalogEntry(module: string, abortCode: number): ErrorCatalogEntry | undefined;
+export declare function translateVmAbort(raw: unknown): CatalogFields | undefined;
+export declare function catalogFieldsFor(classified: ErrorClassification | undefined, rawError?: unknown): CatalogFields | undefined;

package/dist/tools/error-catalog.js

@@ -0,0 +1 @@
+import{MOVE_ABORT_ERROR_MAP,extractVmDebugAbort,normalizeErrorMessage}from'../schema/call/semantic.js';export const ERROR_CATALOG={'order:7':{'module':'order','code':'E_ORDER_ALREADY_CLAIMED','canonical':'Order\x20already\x20claimed\x20—\x20the\x20arbitration\x20settlement\x20claim\x20is\x20one-shot\x20and\x20this\x20order\x20is\x20sealed.','next_action':'Do\x20NOT\x20re-submit\x20the\x20claim.\x20Verify\x20settlement\x20arrival\x20via\x20onchain_events\x20for\x20the\x20claim\x20recipient,\x20and\x20resolve\x20any\x20missing\x20funds\x20with\x20the\x20counterparty\x20through\x20Messenger.'},'machine:11':{'module':'machine','code':'E_MACHINE_PAUSED','canonical':'Machine\x20is\x20paused\x20—\x20new\x20order/progress\x20creation\x20is\x20blocked.','next_action':'Un-pause\x20via\x20operation_type=machine\x20with\x20pause=false\x20on\x20the\x20machine\x20object;\x20in-flight\x20orders\x20keep\x20advancing\x20while\x20paused.'},'machine:14':{'module':'machine','code':'E_PERMISSION_NOT_DEFINED','canonical':'The\x20caller\x20holds\x20no\x20permission\x20on\x20this\x20machine\x20for\x20the\x20requested\x20forward.','next_action':'Read\x20the\x20machine\x20permission\x20table\x20(query_toolkit\x20machine)\x20and\x20route\x20the\x20call\x20through\x20an\x20account/role\x20bound\x20to\x20the\x20required\x20permission,\x20or\x20ask\x20the\x20machine\x20owner\x20to\x20bind\x20your\x20address.'},'progress:8':{'module':'progress','code':'E_PERMISSION_NOT_DEFINED','canonical':'No\x20permission\x20is\x20defined\x20for\x20this\x20caller\x20on\x20this\x20progress\x20flow\x20step.','next_action':'Read\x20the\x20progress\x20flow\x20(query_toolkit,\x20workflow_guidance)\x20to\x20find\x20which\x20role\x20advances\x20this\x20node,\x20then\x20re-call\x20from\x20that\x20account.'},'progress:13':{'module':'progress','code':'E_ORDER_PAYER_REQUIRED','canonical':'This\x20progress\x20operation\x20requires\x20the\x20order\x20PAYER\x20to\x20act.','next_action':'Switch\x20to\x20the\x20order\x20payer\x20account\x20(or\x20have\x20the\x20payer\x20perform\x20the\x20step),\x20then\x20retry\x20the\x20same\x20call.'},'progress:14':{'module':'progress','code':'E_ORDER_TASK_REQUIRED','canonical':'This\x20Progress\x20has\x20no\x20bound\x20Order\x20task\x20—\x20the\x20order-payer\x20advance\x20has\x20no\x20payer\x20to\x20act.','next_action':'Do\x20NOT\x20switch\x20accounts.\x20Bind\x20the\x20Progress\x20to\x20its\x20Order\x20(or\x20advance\x20the\x20order\x20via\x20its\x20order-bound\x20path);\x20a\x20standalone\x20taskless\x20Progress\x20cannot\x20drive\x20empty-namedOperator\x20forwards.'},'progress:15':{'module':'progress','code':'E_ORDER_PRINCIPAL_REFUNDED','canonical':'The\x20order\x27s\x20escrow\x20principal\x20was\x20fully\x20refunded\x20—\x20further\x20advance/hold\x20is\x20blocked\x20by\x20the\x20zombie-order\x20shield.','next_action':'Stop\x20advancing\x20this\x20order.\x20Verify\x20the\x20refund\x20via\x20onchain_events\x20(PrincipalRefundedEvent)\x20or\x20query\x20order.principal_refunded;\x20settle\x20residual\x20disputes\x20via\x20Messenger/arbitration.'},'service:27':{'module':'service','code':'E_COMPENSATION_NOT_MATCH','canonical':'Compensation\x20mismatch\x20—\x20the\x20attached\x20payment\x20does\x20not\x20satisfy\x20the\x20service\x27s\x20price\x20formula.','next_action':'Re-read\x20the\x20service\x20compensation\x20config\x20(query_toolkit\x20service),\x20recompute\x20the\x20payment\x20to\x20the\x20exact\x20smallest-unit\x20amount,\x20and\x20re-send.'},'guard:guard_data_missing':{'module':'guard','code':'E_GUARD_DATA_MISSING','canonical':'The\x20operation\x20is\x20gated\x20by\x20a\x20Guard\x20but\x20the\x20required\x20guard\x20data\x20was\x20not\x20supplied.','next_action':'Supply\x20the\x20missing\x20guard\x20input\x20in\x20the\x20submission\x20envelope\x20slot,\x20or\x20query\x20the\x20guard\x20config\x20first\x20to\x20see\x20exactly\x20what\x20is\x20required.'},'vm:E_VM_TYPE_MISMATCH':{'module':'vm','code':'E_VM_TYPE_MISMATCH','canonical':'The\x20VM\x20rejected\x20a\x20pure-argument\x20type\x20(bare\x20TypeMismatch\x20carrying\x20an\x20abort\x20code)\x20—\x20the\x20transaction\x20never\x20ran\x20and\x20nothing\x20was\x20committed.','next_action':'Re-check\x20the\x20argument\x20TYPES\x20against\x20the\x20operation\x20schema.\x20For\x20required_info\x20/\x20Proof\x20/\x20Contact\x20credential\x20calls:\x20complete\x20the\x20required_info\x20submission\x20first\x20(deliver\x20via\x20Messenger,\x20record\x20via\x20order_required_info),\x20pass\x20an\x20object\x20of\x20the\x20EXPECTED\x20type\x20(a\x20Proof\x20whose\x20about==order\x20and\x20creator==its\x20owner,\x20or\x20the\x20merchant\x20Contact\x20object\x20address\x20—\x20never\x20a\x20plain\x20wallet\x20address),\x20then\x20re-call.'}};export function lookupCatalogEntry(a,b){return ERROR_CATALOG[a+':'+b];}function firstSentence(a,b=0xdc){const c=a['split'](/(?<=\.)\s/,0x1)[0x0]??a;return c['length']>b?c['slice'](0x0,b-0x1)+'…':c;}function fieldsOf(a,b){const c={'code':a['module']+'::'+a['code'],'canonical':a['canonical'],'next_action':a['next_action']};if(b!==undefined)c['detail']=b;return c;}export function translateVmAbort(a){const b=normalizeErrorMessage(a);if(!b||!/TypeMismatch\s*\{/['test'](b))return undefined;const c=extractVmDebugAbort(b);if(c){const d=lookupCatalogEntry(c['module'],c['code']);if(d)return fieldsOf(d,b);const e=MOVE_ABORT_ERROR_MAP[c['module']+':'+c['code']];return{'code':c['module']+'::ABORT_'+c['code'],'canonical':c['description']??'Chain\x20aborted\x20in\x20module\x20'+c['module']+'\x20(abort\x20code\x20'+c['code']+').','next_action':e?.['recovery_hint']?firstSentence(e['recovery_hint']):'Verify\x20the\x20implicated\x20arguments/state\x20via\x20query_toolkit,\x20fix\x20the\x20cause,\x20then\x20re-call.','detail':b};}if(/abort_code\s*[:=]/['test'](b))return fieldsOf(ERROR_CATALOG['vm:E_VM_TYPE_MISMATCH'],b);return undefined;}export function catalogFieldsFor(a,b){if(!a)return undefined;const c=a['move_abort_info'];if(c){const d=lookupCatalogEntry(c['module'],c['code']);if(d)return fieldsOf(d);const e=MOVE_ABORT_ERROR_MAP[c['module']+':'+c['code']];if(e)return{'code':c['module']+'::ABORT_'+c['code'],'canonical':c['description']??'Chain\x20aborted\x20in\x20module\x20'+c['module']+'\x20(abort\x20code\x20'+c['code']+').','next_action':e['recovery_hint']?firstSentence(e['recovery_hint']):'Verify\x20the\x20implicated\x20arguments/state\x20via\x20query_toolkit,\x20fix\x20the\x20cause,\x20then\x20re-call.'};if(c['description'])return{'code':c['module']+'::ABORT_'+c['code'],'canonical':c['description'],'next_action':'Verify\x20the\x20implicated\x20arguments/state\x20via\x20query_toolkit,\x20fix\x20the\x20cause,\x20then\x20re-call.'};return undefined;}if(a['error_code']==='guard_data_missing')return fieldsOf(ERROR_CATALOG['guard:guard_data_missing']);return translateVmAbort(b);}

package/dist/tools/handlers/benchmark-migration.d.ts

@@ -3,15 +3,11 @@ import { type TemplateScanResult } from "../../knowledge/template-scanner.js";
 import type { DeliverableDefinition } from "../../playbooks/service-build/intent-analyzer.js";
 import type { IndustryMode } from "../../extensions/index.js";
 import type { ToolDispatchResult } from "../types.js";
+import { staleBuildFace, type StaleBuildDisclosure } from "./stale-build-check.js";
+export { staleBuildFace };
+export type { StaleBuildDisclosure };
 export declare function platformMarkRefusal(addr: string, network: string): string | undefined;
-export interface StaleBuildDisclosure {
-    stale: boolean;
-    known: boolean;
-    actionable: boolean;
-    lag_minutes: number | null;
-    detail: string;
-}
-export declare function staleBuildFace(srcDir?: string, distDir?: string): StaleBuildDisclosure;
+export declare function recipientMarkRefusal(mark: string, addr: string, network: string): string | undefined;
 export declare function wipAnchorFace(sales: unknown): {
     status: string;
     rule_id: string;
@@ -19,6 +15,13 @@ export declare function wipAnchorFace(sales: unknown): {
     unpinned_skus: string[];
     remediation: string;
 } | undefined;
+export declare function returnNoExitFace(templateId: string): {
+    status: string;
+    rule_id: string;
+    severity: string;
+    stranded_nodes: string[];
+    remediation: string;
+} | undefined;
 declare function driftFace(templateId: string): {
     template: string;
     state: "current";
@@ -41,6 +44,8 @@ declare function driftFace(templateId: string): {
     repairable: boolean;
     detail: string;
 };
+export declare function planEnvelopeFromInput(planInput: unknown): Record<string, unknown>;
+export declare function templateAdvisoryFaces(templateId: string | undefined): Record<string, unknown>;
 declare function scanSummary(scan: TemplateScanResult, drift?: ReturnType<typeof driftFace>): {
     template_id: string;
     risk_level: import("../../knowledge/template-scanner.js").TemplateRiskLevel;
@@ -72,6 +77,22 @@ declare function scanSummary(scan: TemplateScanResult, drift?: ReturnType<typeof
         detail: string;
     } | undefined;
 };
+export interface PlaceholderResidualHit {
+    placeholder: string;
+    artifact: string;
+    path: string;
+}
+export declare function placeholderResidualCheck(artifacts: Record<string, unknown>): {
+    hits: PlaceholderResidualHit[];
+} | null;
+export interface AllocatorCriteriaIssue {
+    row: string;
+    field: string;
+    problem: string;
+}
+export declare function allocatorCriteriaDryRun(artifacts: Record<string, unknown>): {
+    hits: AllocatorCriteriaIssue[];
+} | null;
 export declare function buildVerdict(summary: ReturnType<typeof scanSummary>, plan: Record<string, unknown>, mirrorGenerateHighGate?: boolean, freshness?: StaleBuildDisclosure): {
     buildable: boolean;
     blockers: string[];