@wowok/agent-mcp 2.6.9 → 2.7.1

package/dist/tools/handlers/task-status.d.ts

@@ -1,170 +1,2 @@
-import { z } from "zod";
 import type { ToolDispatchResult } from "../types.js";
-export declare const QueryTaskStatusInputSchema: z.ZodObject<{
-    task_id: z.ZodOptional<z.ZodString>;
-    project_id: z.ZodOptional<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    project_id?: string | undefined;
-    task_id?: string | undefined;
-}, {
-    project_id?: string | undefined;
-    task_id?: string | undefined;
-}>;
-export declare const TaskStateSchema: z.ZodObject<{
-    task_id: z.ZodString;
-    operation: z.ZodString;
-    status: z.ZodEnum<["pending", "running", "completed", "failed", "cancelled"]>;
-    progress: z.ZodNumber;
-    message: z.ZodString;
-    result: z.ZodNullable<z.ZodUnknown>;
-    error: z.ZodNullable<z.ZodString>;
-    started_at: z.ZodNumber;
-    completed_at: z.ZodNullable<z.ZodNumber>;
-    project_id: z.ZodNullable<z.ZodString>;
-}, "strict", z.ZodTypeAny, {
-    message: string;
-    status: "failed" | "completed" | "pending" | "cancelled" | "running";
-    error: string | null;
-    operation: string;
-    progress: number;
-    completed_at: number | null;
-    project_id: string | null;
-    task_id: string;
-    started_at: number;
-    result?: unknown;
-}, {
-    message: string;
-    status: "failed" | "completed" | "pending" | "cancelled" | "running";
-    error: string | null;
-    operation: string;
-    progress: number;
-    completed_at: number | null;
-    project_id: string | null;
-    task_id: string;
-    started_at: number;
-    result?: unknown;
-}>;
-export declare const QueryTaskStatusOutputSchema: z.ZodObject<{
-    task_id: z.ZodOptional<z.ZodString>;
-    task: z.ZodNullable<z.ZodObject<{
-        task_id: z.ZodString;
-        operation: z.ZodString;
-        status: z.ZodEnum<["pending", "running", "completed", "failed", "cancelled"]>;
-        progress: z.ZodNumber;
-        message: z.ZodString;
-        result: z.ZodNullable<z.ZodUnknown>;
-        error: z.ZodNullable<z.ZodString>;
-        started_at: z.ZodNumber;
-        completed_at: z.ZodNullable<z.ZodNumber>;
-        project_id: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }, {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }>>;
-    tasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        task_id: z.ZodString;
-        operation: z.ZodString;
-        status: z.ZodEnum<["pending", "running", "completed", "failed", "cancelled"]>;
-        progress: z.ZodNumber;
-        message: z.ZodString;
-        result: z.ZodNullable<z.ZodUnknown>;
-        error: z.ZodNullable<z.ZodString>;
-        started_at: z.ZodNumber;
-        completed_at: z.ZodNullable<z.ZodNumber>;
-        project_id: z.ZodNullable<z.ZodString>;
-    }, "strict", z.ZodTypeAny, {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }, {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }>, "many">>;
-}, "strict", z.ZodTypeAny, {
-    task: {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    } | null;
-    task_id?: string | undefined;
-    tasks?: {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }[] | undefined;
-}, {
-    task: {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    } | null;
-    task_id?: string | undefined;
-    tasks?: {
-        message: string;
-        status: "failed" | "completed" | "pending" | "cancelled" | "running";
-        error: string | null;
-        operation: string;
-        progress: number;
-        completed_at: number | null;
-        project_id: string | null;
-        task_id: string;
-        started_at: number;
-        result?: unknown;
-    }[] | undefined;
-}>;
 export declare function handleQueryTaskStatus(args: unknown): Promise<ToolDispatchResult>;

package/dist/tools/handlers/task-status.js

@@ -1,33 +1,4 @@
-import { z } from "zod";
 import { TaskTracker } from "../../project/task-tracker.js";
-export const QueryTaskStatusInputSchema = z.object({
-    task_id: z
-        .string()
-        .optional()
-        .describe("The task ID to query (returned by a prior async operation). " +
-        "If omitted, lists all recent tasks (most recent first, max 50)."),
-    project_id: z
-        .string()
-        .optional()
-        .describe("Optional filter — when listing tasks (task_id omitted), only return tasks for this project."),
-}).strict().describe("Query the status of an async task, or list all recent tasks when task_id is omitted.");
-export const TaskStateSchema = z.object({
-    task_id: z.string().describe("Unique task identifier."),
-    operation: z.string().describe("Operation type that created this task (e.g. 'build_graph')."),
-    status: z.enum(["pending", "running", "completed", "failed", "cancelled"]).describe("Current task status."),
-    progress: z.number().describe("Progress percentage 0-100."),
-    message: z.string().describe("Human-readable progress message."),
-    result: z.unknown().nullable().describe("Result payload (set when status='completed'). null otherwise."),
-    error: z.string().nullable().describe("Error message (set when status='failed'). null otherwise."),
-    started_at: z.number().describe("Timestamp (ms) when the task was created."),
-    completed_at: z.number().nullable().describe("Timestamp (ms) when the task reached a terminal state. null if still running."),
-    project_id: z.string().nullable().describe("Project ID associated with this task, if any."),
-}).strict();
-export const QueryTaskStatusOutputSchema = z.object({
-    task_id: z.string().optional().describe("The queried task ID (present when a single task was queried)."),
-    task: TaskStateSchema.nullable().describe("The task state. null if task_id not found or when listing."),
-    tasks: z.array(TaskStateSchema).optional().describe("List of tasks (present when task_id was omitted)."),
-}).strict();
 export async function handleQueryTaskStatus(args) {
     const validated = (args && typeof args === "object" ? args : {});
     if (validated.task_id) {

package/dist/tools/index.js

@@ -24,9 +24,12 @@ import { handleBridgeOperations } from "./handlers/bridge.js";
 import { handleProjectOperation } from "./handlers/project.js";
 import { handleConfigOperation } from "./handlers/config.js";
 import { handleTrustScore } from "./handlers/trust.js";
-import { handleQueryTaskStatus, QueryTaskStatusInputSchema, QueryTaskStatusOutputSchema } from "./handlers/task-status.js";
+import { handleEvaluationOperation } from "./handlers/evaluation.js";
+import { handlePersonaOperation } from "./handlers/persona.js";
+import { handleIntentRadar } from "./handlers/intent-radar.js";
+import { handleQueryTaskStatus } from "./handlers/task-status.js";
 import { applyOnchainRules } from "./rules-hook.js";
-import { createToolMeta, OnchainOperationsSchema, AccountOperationSchema, LocalMarkOperationSchema, LocalInfoOperationSchema, WipOperationsSchema, MessengerOperationInputSchema, Guard2File_InputSchema, MachineNode2File_InputSchema, WatchQueryOperationsSchema, WatchQueryOperationsResultSchema, OnchainTableDataSchema, OnchainEventsInputSchema, ProtocolInfoQuerySchema, SchemaQueryInputSchema, BridgeOperationsSchema, ProjectOperationInputSchema, ConfigOperationInputSchema, TrustScoreInputSchema, CallOutputSchema, AccountOperationOutputWrappedSchema, LocalMarkOperationOutputWrappedSchema, LocalInfoOperationOutputWrappedSchema, WipOperationOutputSchema, MessengerOperationOutputSchema, Guard2File_OutputWrappedSchema, MachineNode2File_OutputWrappedSchema, OnchainTableDataResultSchema, OnchainEventsResultSchema, ProtocolInfoResultSchema, SchemaQueryOutputSchema, BridgeCallOutputSchema, ProjectOperationOutputSchema, ConfigOperationOutputSchema, TrustScoreOutputSchema, } from "../schema/index.js";
+import { createToolMeta, OnchainOperationsSchema, AccountOperationSchema, LocalMarkOperationSchema, LocalInfoOperationSchema, WipOperationsSchema, MessengerOperationInputSchema, Guard2File_InputSchema, MachineNode2File_InputSchema, WatchQueryOperationsSchema, WatchQueryOperationsResultSchema, OnchainTableDataSchema, OnchainEventsInputSchema, ProtocolInfoQuerySchema, SchemaQueryInputSchema, BridgeOperationsSchema, ProjectOperationInputSchema, ConfigOperationInputSchema, TrustScoreInputSchema, CallOutputSchema, AccountOperationOutputWrappedSchema, LocalMarkOperationOutputWrappedSchema, LocalInfoOperationOutputWrappedSchema, WipOperationOutputSchema, MessengerOperationOutputSchema, Guard2File_OutputWrappedSchema, MachineNode2File_OutputWrappedSchema, OnchainTableDataResultSchema, OnchainEventsResultSchema, ProtocolInfoResultSchema, SchemaQueryOutputSchema, BridgeCallOutputSchema, ProjectOperationOutputSchema, ConfigOperationOutputSchema, TrustScoreOutputSchema, EvaluationOperationInputSchema, EvaluationOperationOutputSchema, PersonaOperationInputSchema, PersonaOperationOutputSchema, IntentRadarInputSchema, IntentRadarOutputSchema, QueryTaskStatusInputSchema, QueryTaskStatusOutputSchema, } from "../schema/index.js";
 export const TOOL_REGISTRY = [
     {
         name: "onchain_operations",
@@ -155,7 +158,7 @@ export const TOOL_REGISTRY = [
                 + "11. onchain_object_history — FORENSICS: all transactions that touched an object (auditing only — prefer assemble_context for AI context building).\n"
                 + "12. onchain_address_activity — FORENSICS: all transactions sent by an address (auditing only).\n"
                 + "13. token_value_convert — Convert between raw on-chain smallest units (u64) and human unit values in EITHER direction (e.g. \"2200000000\" ↔ \"2.2\" WOW). Unit→raw is REFUSED when token precision cannot be resolved (never guesses decimals).\n\n"
-                + "For dynamic table data queries (pagination, table items), use the 'onchain_table_data' tool.\n\n"
+                + "For dynamic table data queries (pagination, table items), use the 'onchain_table_data' tool. For state-transition events, use the 'onchain_events' tool.\n\n"
                 + "💡 Schema hint: Use schema_query with action='get' and name='query_toolkit' to retrieve the exact parameter schema with all query types and field definitions.",
             inputSchema: WatchQueryOperationsSchema,
             outputSchema: WatchQueryOperationsResultSchema,
@@ -167,8 +170,8 @@ export const TOOL_REGISTRY = [
         name: "onchain_table_data",
         handler: handleOnchainTableData,
         config: {
-            title: "📊 Watch WoWok On-chain Table Data Query",
-            description: "Query dynamic table data of on-chain objects — supports paginated table queries and specific table item lookups. Each table item belongs to a parent object type and has a specific meaning:\n\n"
+            title: "📊 Query WoWok On-chain Table Data",
+            description: "Query the dynamic table data of on-chain objects (ONE-TIME query — NOT a realtime subscription). Supports paginated table queries and specific table item lookups. Each table item belongs to a parent object type and has a specific meaning:\n\n"
                 + "1. onchain_table — Paginated query of ANY object's dynamic fields table (Parent: any object). Returns all entries with keys, types, and object IDs. Use to explore all sub-items of an object.\n"
                 + "2. onchain_table_item_repository_data — Query a record from a Repository's on-chain key-value database (Parent: Repository). Key: name + entity (address or number). Returns the stored data record with typed value.\n"
                 + "3. onchain_table_item_permission_perm — Query a permission entry from a Permission object's access control table (Parent: Permission). Key: user address or Guard ID. Returns the permission list (perm[]) granted to that user/guard.\n"
@@ -181,6 +184,7 @@ export const TOOL_REGISTRY = [
                 + "10. onchain_table_item_progress_history — Query a progress step record from a Progress object's history table (Parent: Progress). Key: sequence number (u64). Returns step details: node, next_node, session state, time.\n"
                 + "11. onchain_table_item_address_mark — Query a PUBLIC on-chain name/tag mark from an AddressMark object's table (Parent: AddressMark). Key: address. Returns public labels: entity, name, tags[]. Unlike local marks, these are published on-chain.\n"
                 + "12. onchain_table_item_generic — Query a generic table item from ANY object's dynamic fields (Parent: any object). Supports arbitrary key types (address, u64, string, object ID, etc.). Use for custom objects and general-purpose table lookups. Returns: ObjectBase | undefined.\n\n"
+                + "🧭 Tool selection (avoid confusion): use query_toolkit to query a WHOLE object/balance/profile; use onchain_events to query state-transition events; use onchain_table_data (this tool) to paginate over ONE object's dynamic table fields or read a single table item.\n\n"
                 + "💡 Schema hint: Use schema_query with action='get' and name='onchain_table_data' to retrieve the exact parameter schema with all table item types and field definitions.",
             inputSchema: OnchainTableDataSchema,
             outputSchema: OnchainTableDataResultSchema,
@@ -192,8 +196,8 @@ export const TOOL_REGISTRY = [
         name: "onchain_events",
         handler: handleOnchainEvents,
         config: {
-            title: "📅 Watch WoWok On-chain Events",
-            description: "Watch on-chain WoWok events by type. Supports arbitration events, new order events, progress events, demand presentation events, demand feedback events, and new entity registration events. Use pagination cursor for fetching large result sets. NewOrderEvent.amount includes `_money_display` annotation (unit-converted via the order's Service generic token type; raw-only with retry hint when precision is unavailable).\n\n💡 Schema hint: Use schema_query with action='get' and name='onchain_events' to retrieve the exact parameter schema with all event types and field definitions.",
+            title: "📅 Query WoWok On-chain Events",
+            description: "Query on-chain WoWok state-transition events by type (a ONE-TIME paginated query — NOT a realtime subscription). Supports arbitration events, new order events, progress events, demand presentation events, demand feedback events, and new entity registration events. Use pagination cursor for fetching large result sets. NewOrderEvent.amount includes `_money_display` annotation (unit-converted via the order's Service generic token type; raw-only with retry hint when precision is unavailable).\n\n🧭 Tool selection (avoid confusion): use query_toolkit to query whole objects/balances/profiles; use onchain_table_data to query ONE object's dynamic table fields; use onchain_events (this tool) to query state-transition EVENTS by type.\n\n💡 Schema hint: Use schema_query with action='get' and name='onchain_events' to retrieve the exact parameter schema with all event types and field definitions.",
             inputSchema: OnchainEventsInputSchema,
             outputSchema: OnchainEventsResultSchema,
             annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
@@ -391,6 +395,9 @@ export const TOOL_REGISTRY = [
                 "  • service_basics snapshot (published/paused/sales/guards/arbitrations)\n\n" +
                 "Use this tool when the user asks 'is this service trustworthy?', 'should I buy from this merchant?', " +
                 "'what's the risk of ordering this service?', or any explicit trust/risk inquiry about a Service.\n\n" +
+                "🧭 Tool selection (avoid confusion): trust_score = trust/risk of ONE Service; " +
+                "evaluation_operation = game-theory best-move advice at an Arb/Progress state; " +
+                "project_operation.evaluate_project = multi-object project-level evaluation.\n\n" +
                 "Parameters:\n" +
                 "  • service (required) — Service object ID or local_mark name.\n" +
                 "  • order_amount (optional) — Order amount in smallest token unit (e.g. 2000000000 for 2 WOW). " +
@@ -426,6 +433,75 @@ export const TOOL_REGISTRY = [
             _meta: createToolMeta("task", ["task", "status", "async", "progress", "background", "tracker"]),
         },
     },
+    {
+        name: "evaluation_operation",
+        handler: handleEvaluationOperation,
+        config: {
+            title: "🧠 Evaluation - Pluggable Business Intelligence",
+            description: "Run pluggable business evaluations (data sources + rules + user injection). " +
+                "Each evaluation returns ranked best-move recommendations with payoff notes and risks.\n\n" +
+                "Actions:\n" +
+                "  • arb_game — advise the best move at an Arb state (7-state lifecycle) for a perspective (disputant/arbitrator/voter).\n" +
+                "  • node_game — advise the best move at a Progress node for a perspective (customer/operator).\n\n" +
+                "Read-only: computes recommendations from pure data; never mutates chain state. " +
+                "The caller decides and acts via onchain_operations / messenger_operation.\n\n" +
+                "🧭 Tool selection (avoid confusion): evaluation_operation = best-move advice at an Arb/Progress state (game theory); " +
+                "trust_score = trust/risk of ONE Service; project_operation = project-level evaluation.\n\n" +
+                "💡 Schema hint: Use schema_query with action='get' and name='evaluation_operation' to retrieve the exact parameter schema.",
+            inputSchema: EvaluationOperationInputSchema,
+            outputSchema: EvaluationOperationOutputSchema,
+            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+            _meta: createToolMeta("evaluation", ["evaluate", "risk", "match", "game", "score", "arb", "node", "compose", "gap"]),
+        },
+    },
+    {
+        name: "persona_operation",
+        handler: handlePersonaOperation,
+        config: {
+            title: "👤 Persona - User Identity Setting",
+            description: "Read/write the user's systematic identity setting (persona): preferences, " +
+                "competitive strategy, experience rules, self profile, and spec.\n\n" +
+                "LAYERS: long_term = STABLE identity (USER-DRIVEN only — never auto-rewrite). " +
+                "current = transient context (SMART-UPDATABLE — AI may merge/replace from " +
+                "conversation experience or account behavior). Scope: system (all accounts, " +
+                "be conservative) or account (one chain address, higher priority).\n\n" +
+                "Actions:\n" +
+                "  • get — resolve the priority-merged effective persona (+ injection + context text).\n" +
+                "  • list — list stored personas and built-in industry defaults.\n" +
+                "  • set — user-driven write/update of any layer (≤300 lines enforced).\n" +
+                "  • analyze — extract identity signals from free-form context (website / experience summary).\n" +
+                "  • apply — merge/replace analyzed signals into the CURRENT layer only.\n" +
+                "  • sync — merge account behavior (experience layer) into the CURRENT layer.\n" +
+                "  • remove — delete a persona (fall back to defaults).\n\n" +
+                "Read/write local state only; never mutates chain state.\n\n" +
+                "💡 Schema hint: Use schema_query with action='get' and name='persona_operation' to retrieve the exact parameter schema.",
+            inputSchema: PersonaOperationInputSchema,
+            outputSchema: PersonaOperationOutputSchema,
+            annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+            _meta: createToolMeta("persona", ["persona", "profile", "identity", "preference", "strategy", "spec", "portrait"]),
+        },
+    },
+    {
+        name: "intent_radar",
+        handler: handleIntentRadar,
+        config: {
+            title: "📡 Intent Radar - User Intent × Chain Event Matching",
+            description: "Persist the user's standing business intents and match them against on-chain events/data. " +
+                "This closes the loop: user records an intent (e.g. 'find subscription services'), " +
+                "the system pulls recent chain events and returns ranked hits.\n\n" +
+                "Actions:\n" +
+                "  • save — record an intent (industry/keywords resolved once; optionally bound to an account).\n" +
+                "  • list — list persisted intents (optionally filtered by account).\n" +
+                "  • remove — delete an intent.\n" +
+                "  • match — score events against intents (pass `events` from onchain_events, or auto-pull recent events).\n\n" +
+                "Read-only w.r.t. chain state (reads events + local intent store only).\n\n" +
+                "💡 Schema hint: Use schema_query with action='get' and name='intent_radar' to retrieve the exact parameter schema.",
+            inputSchema: IntentRadarInputSchema,
+            outputSchema: IntentRadarOutputSchema,
+            annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+            _meta: createToolMeta("intent", ["intent", "radar", "match", "event", "watch", "business", "intelligence"]),
+        },
+    },
 ];
 export const TOOL_REGISTRY_MAP = new Map(TOOL_REGISTRY.map(t => [t.name, t]));
 const SUB_TOOL_NAMES = TOOL_REGISTRY.map(t => t.name);

package/dist/tools/wip-deploy-assist.d.ts

@@ -1,4 +1,4 @@
-export type WipPathType = "local_unix" | "local_windows" | "local_relative" | "http_url" | "ipfs" | "data_url" | "unknown";
+export type WipPathType = "local_unix" | "local_windows" | "local_relative" | "local_http" | "http_url" | "ipfs" | "data_url" | "unknown";
 export interface WipPathClassification {
     type: WipPathType;
     is_local: boolean;

package/dist/tools/wip-deploy-assist.js

@@ -38,6 +38,23 @@ export function classifyWipPath(path) {
             description: "IPFS HTTP gateway URL — globally reachable",
         };
     }
+    if (/^https?:\/\/(localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)([:/]|$)/i.test(path)) {
+        return {
+            type: "local_http",
+            is_local: true,
+            is_network: false,
+            description: "Local HTTP URL (localhost/loopback) — reachable only on this machine, NOT by customers",
+        };
+    }
+    const privateIpRe = /^https?:\/\/(10\.\d{1,3}\.\d{1,3}\.\d{1,3}|172\.(1[6-9]|2\d|3[01])\.\d{1,3}\.\d{1,3}|192\.168\.\d{1,3}\.\d{1,3})([:/]|$)/i;
+    if (privateIpRe.test(path)) {
+        return {
+            type: "local_http",
+            is_local: true,
+            is_network: false,
+            description: "LAN HTTP URL (private IP) — reachable only on the local network, NOT by customers",
+        };
+    }
     if (/^https?:\/\//i.test(path)) {
         return {
             type: "http_url",
@@ -199,11 +216,22 @@ export function analyzeWipDeployment(path) {
     let reason;
     let options = [];
     if (needsDeployment) {
-        reason =
-            `The WIP path '${path}' is a LOCAL ${classification.type} path. ` +
-                "Local paths stored on-chain are unreachable by customers and verifiers. " +
-                "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
-                "and update the Service's wip_url with the public URL.";
+        if (classification.type === "local_http") {
+            reason =
+                `The WIP URL '${path}' is a ${classification.description}. ` +
+                    "It is reachable only from the merchant's own machine/LAN — customers and " +
+                    "on-chain verifiers on other machines CANNOT fetch it. Storing it on-chain " +
+                    "makes every customer order fail. " +
+                    "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
+                    "and update the Service's wip_url with the public URL.";
+        }
+        else {
+            reason =
+                `The WIP path '${path}' is a LOCAL ${classification.type} path. ` +
+                    "Local paths stored on-chain are unreachable by customers and verifiers. " +
+                    "Deploy the .wip file to a public host (GitHub Pages, IPFS, or your own website) " +
+                    "and update the Service's wip_url with the public URL.";
+        }
         options = getDeployOptions(path);
     }
     else if (classification.type === "http_url") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.6.9",
+  "version": "2.7.1",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -50,7 +50,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.6.9",
+    "@wowok/wowok": "2.7.1",
     "lodash": "^4.18.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.25.2"