project-cpu-mcp 0.9.1 → 0.11.1

package/dist/tools/transport/constants.js

@@ -1,47 +1,72 @@
 export const TRANSPORT_DESCRIPTION = [
     'Move a resource between cells along a waypoint chain of tokenIds, on-chain (needs a session —',
     '`cpu_authenticate` first). One atomic move: debits the source, pays the $CPU transit fee for every foreign',
-    'Hub on the route (auto-approved once) plus gas, and escrows a time-delayed delivery. Every waypoint must be',
-    'revealed and yours-or-a-finished-Hub; each hop must be within radius(from)+radius(to)−1 grid steps (default',
-    'balance: own↔own 1 = adjacent only, own↔hub 3, hub↔hub 5). Recommended flow:',
-    '`cpu_next_hops` (scout waypoints) → chain them yourself → `cpu_quote_transport` (verify fee/ETA) →',
+    'Hub on the route (auto-approved once) plus gas, and escrows a time-delayed delivery. Source and target must',
+    'be your own cells past their first completed reveal; the waypoints between them may be Virgin ground (no',
+    'completed reveal, minted or not), cells of yours, or any cell with a finished Hub, foreign ones included.',
+    'Each hop must be within radius(from)+radius(to)−1 grid steps, and radius is per cell: a plain cell reaches',
+    'the move radius, a finished Hub the radius its own tier serves. Recommended flow:',
+    '`cpu_route_network` (export the graph and plan over it) or `cpu_next_hops` (scout waypoints leg by leg) →',
+    'chain them yourself → `cpu_quote_transport` (verify fee/ETA) →',
     '`cpu_transport`. Returns the',
     'deliveryId and arrival time; the goods credit to the target only after arrival, when you call',
-    '`cpu_finalize_delivery` (`cpu_list_my_transports` shows what is ready). A route over only your own cells',
-    'pays no fee.',
+    '`cpu_finalize_delivery` (`cpu_list_my_transports` shows what is ready). Every foreign finished Hub on the',
+    'route charges its fee, one standing on ground with no completed reveal included; a route over only your own',
+    'cells and bare Virgin ground pays none.',
 ].join(' ');
 export const ROUTE_NETWORK_DESCRIPTION = [
-    'The road map of the world (read-only): every legal waypoint — your revealed cells and every finished Hub —',
-    'as graph nodes (owner, hub flag, `ready` build state, the exact per-unit transit fee for your `resourceId`',
-    'cargo, pos, connected-component id) plus every hop the contract',
-    'would accept as edges (within radius(a)+radius(b)−1 grid steps; default balance: own↔own 1 = adjacent',
-    'only, own↔hub 3, hub↔hub 5). A Hub counts only once its construction finishes: an unfinished one grants no',
-    'hub reach and charges no fee, and a foreign one is not a node at all — your own cells stay nodes while they',
-    'build, just with normal reach (`ready`: null = nothing built, false = under construction, true = finished).',
-    'Foreign cells are never nodes: even a single foreign cell between two plain',
-    'cells is a WALL — only a finished Hub reaches across. Different component ids show exactly that — no chain',
-    'crosses today, goods stop at the border.',
-    'Bridging is a strategic decision: a border Hub (it still needs an eligible landing point within reach on',
-    'the far side), buying land across, or a detour — the sphere is closed, so a wall must encircle to truly',
-    'seal. Pass from/towards to annotate each node with grid distances (a potential field to reason over).',
-    'Routing over this map is YOUR job: pick the chain, then verify with cpu_quote_transport. WHEN: the heavy',
-    'read — plan a journey or a big replan; for point checks while executing use the cheap cpu_next_hops.',
+    'Export the route graph for ONE move you are planning (read-only, needs `from`, `towards`, `resourceId` and',
+    '`amount`). It does NOT answer with the graph: it writes the graph to a uniquely named JSON file in the',
+    'temporary directory and answers with the file path, the schema and snapshot versions, node and hop counts,',
+    'whether the two ends are connected, ordered instructions, and a prefilled cpu_quote_transport call. Load the',
+    'file with code and plan over it — never paste it into the conversation. USE IT WHEN you have a code runner;',
+    'without one, plan leg by leg with the cheap cpu_next_hops instead.',
+    'Both ends must be your own cells past their first completed reveal — a foreign Hub is passage, never an end',
+    'of a shipment. Nodes are every cell a shipment may pass through: Virgin ground (no completed reveal, minted',
+    'or not, `owner` null when nobody has minted it), your own cells, and any cell with a finished Hub, foreign',
+    'ones included; only foreign land past its first reveal without a finished Hub is closed, and a belt of it',
+    'wider than your reach is the WALL. Each node carries owner, Virgin/own/finished-Hub flags, its own reach',
+    'radius and the exact per-unit transit fee for your cargo. Edges are the hops the contract accepts',
+    '(radius(a)+radius(b)−1 grid steps, so a finished Hub tier reaches as far as its own catalog row serves).',
+    'Only the component(s) your two ends sit in are exported; `connected: false` means no chain exists today —',
+    'goods stop at the border until you bridge it with a border Hub (it still needs an eligible landing point',
+    'within reach on the far side), land across, or a detour.',
+    'Routing over the graph is YOUR job: pick the chain, then verify it with cpu_quote_transport before spending.',
+    'Pass `lotId` to plan one lot’s way home instead: for an Evicted lot the source becomes the hub it was',
+    'listed on, admitted from the lot itself at the reach and the rate recorded there, so the plan holds after',
+    'that hub is demolished, rebuilt, left unfinished or sold. Only the source changes — the destination is',
+    'still your own revealed cell, every later waypoint keeps the ordinary rules, and the prefilled quote call',
+    'becomes cpu_quote_lot_return.',
 ].join(' ');
 export const NEXT_HOPS_DESCRIPTION = [
-    'Survey the legal next waypoints from a cell (read-only). Lists every eligible waypoint — your revealed cells',
-    'and every finished Hub — within one hop under the reach rule: hop ≤ radius(from)+radius(to)−1 grid steps',
-    '(default balance: own↔own 1 = adjacent only, own↔hub 3, hub↔hub 5). A Hub counts only once its construction',
+    'Survey the legal next waypoints from a cell (read-only). Lists every eligible waypoint within one hop under',
+    'the reach rule: hop ≤ radius(from)+radius(to)−1 grid steps. Eligible means Virgin ground (`isVirgin` — no',
+    'completed reveal yet, minted or not, `owner` null when nobody has minted it), any cell you own, or any cell',
+    'carrying a finished Hub, foreign ones included. Only foreign land past its first completed reveal without a',
+    'finished Hub is closed — that, not open ground, is the WALL: a belt of foreign revealed cells wider than',
+    'your reach stops cargo until a finished Hub reaches across. Waypoints are passage only: a shipment still',
+    'starts and ends on your own revealed cells.',
+    'Radius is per cell, never global: a plain cell (Virgin ground included) carries the move radius and each',
+    'finished Hub tier carries the radius its own catalog row serves, so `fromRadius` on the origin and',
+    '`radius` on every candidate is what you add up. A Hub counts only once its construction',
     'finishes: until then it grants no hub reach and charges no fee, and a foreign one is no waypoint at all —',
     '`fromReady` says whether your own origin is still building, which is why its reach may be smaller than you',
-    'expect. Foreign cells are never waypoints, so even a',
-    'single foreign cell between two plain cells is a WALL — only a finished Hub reaches across; empty `hops`',
-    'means goods can only be hauled up to here. Facts per candidate: hop distance, owner, hub flag, `ready` build',
-    'state, the exact per-unit transit fee for your `resourceId` cargo, and — with `towards` —',
+    'expect. Empty `hops`',
+    'means goods can only be hauled up to here. Facts per candidate: hop distance, owner, hub and Virgin flags,',
+    '`ready` build state, the exact per-unit transit fee for your `resourceId` cargo (your own cells charge none,',
+    'a Hub of your own on them included, and so does bare Virgin ground — but a foreign',
+    'finished Hub charges its fee even on a cell with no completed',
+    'reveal), and — with `towards` —',
     'the remaining grid distance (a compass, not a route). Planning is YOUR job: pick each hop yourself (cheap',
     'vs short vs whose hub you trust), chain them into `path`, and verify with cpu_quote_transport. To break a',
     'wall: build a border Hub (it still needs an eligible landing cell within reach on the far side), buy land',
-    'across, or go around. WHEN: the cheap point check — call it right before each leg and after',
+    'across, or go around. Routing is refused until the whole map has loaded, so a missing row can never pass as',
+    'open ground. WHEN: the cheap point check — call it right before each leg and after',
     'cpu_get_changes shows movement (hubs get demolished, fees change while goods travel); replan via',
     'cpu_route_network only when a local fix is impossible.',
+    'Pass `lotId` to survey one lot’s way home instead: for an Evicted lot the origin becomes the hub it was',
+    'listed on, admitted from the lot itself at the reach recorded there, whatever stands on that cell now.',
+    'Only the origin changes — every candidate is still judged on today’s map — and the chain you build is',
+    'verified with cpu_quote_lot_return.',
 ].join(' ');
 //# sourceMappingURL=constants.js.map

package/dist/tools/transport/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/transport/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,+FAA+F;IAC/F,4GAA4G;IAC5G,6GAA6G;IAC7G,6GAA6G;IAC7G,8EAA8E;IAC9E,oGAAoG;IACpG,8BAA8B;IAC9B,+FAA+F;IAC/F,0GAA0G;IAC1G,cAAc;CACjB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,4GAA4G;IAC5G,4GAA4G;IAC5G,iEAAiE;IACjE,uGAAuG;IACvG,4GAA4G;IAC5G,6GAA6G;IAC7G,6GAA6G;IAC7G,6EAA6E;IAC7E,4GAA4G;IAC5G,0CAA0C;IAC1C,0GAA0G;IAC1G,yGAAyG;IACzG,uGAAuG;IACvG,0GAA0G;IAC1G,sGAAsG;CACzG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,8GAA8G;IAC9G,0GAA0G;IAC1G,6GAA6G;IAC7G,2GAA2G;IAC3G,4GAA4G;IAC5G,sDAAsD;IACtD,0GAA0G;IAC1G,8GAA8G;IAC9G,2FAA2F;IAC3F,2GAA2G;IAC3G,2GAA2G;IAC3G,2GAA2G;IAC3G,6FAA6F;IAC7F,kGAAkG;IAClG,wDAAwD;CAC3D,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/tools/transport/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,+FAA+F;IAC/F,4GAA4G;IAC5G,6GAA6G;IAC7G,0GAA0G;IAC1G,2GAA2G;IAC3G,4GAA4G;IAC5G,mFAAmF;IACnF,2GAA2G;IAC3G,gEAAgE;IAChE,8BAA8B;IAC9B,+FAA+F;IAC/F,2GAA2G;IAC3G,6GAA6G;IAC7G,yCAAyC;CAC5C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,4GAA4G;IAC5G,wGAAwG;IACxG,4GAA4G;IAC5G,8GAA8G;IAC9G,6GAA6G;IAC7G,oEAAoE;IACpE,6GAA6G;IAC7G,6GAA6G;IAC7G,4GAA4G;IAC5G,2GAA2G;IAC3G,0GAA0G;IAC1G,mGAAmG;IACnG,0GAA0G;IAC1G,2GAA2G;IAC3G,0GAA0G;IAC1G,0DAA0D;IAC1D,8GAA8G;IAC9G,uGAAuG;IACvG,2GAA2G;IAC3G,wGAAwG;IACxG,2GAA2G;IAC3G,+BAA+B;CAClC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,6GAA6G;IAC7G,2GAA2G;IAC3G,6GAA6G;IAC7G,6GAA6G;IAC7G,0GAA0G;IAC1G,0GAA0G;IAC1G,6CAA6C;IAC7C,0GAA0G;IAC1G,oGAAoG;IACpG,yFAAyF;IACzF,2GAA2G;IAC3G,4GAA4G;IAC5G,sBAAsB;IACtB,4GAA4G;IAC5G,8GAA8G;IAC9G,oFAAoF;IACpF,+DAA+D;IAC/D,iCAAiC;IACjC,2GAA2G;IAC3G,2GAA2G;IAC3G,2GAA2G;IAC3G,6GAA6G;IAC7G,oFAAoF;IACpF,kGAAkG;IAClG,wDAAwD;IACxD,yGAAyG;IACzG,wGAAwG;IACxG,uGAAuG;IACvG,qCAAqC;CACxC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/transport/finalize/finalize-delivery.d.ts

@@ -1,4 +1,4 @@
 import type { AppContext } from '../../../types.js';
-import type { ToolRegistrar } from '../../types.js';
+import { type ToolRegistrar } from '../../types.js';
 export declare function registerFinalizeDeliveryTool(server: ToolRegistrar, context: AppContext): void;
 //# sourceMappingURL=finalize-delivery.d.ts.map

package/dist/tools/transport/finalize/finalize-delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalize-delivery.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/finalize/finalize-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAkB7F"}
+{"version":3,"file":"finalize-delivery.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/finalize/finalize-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAInE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAkB7F"}

package/dist/tools/transport/finalize/finalize-delivery.js

@@ -1,3 +1,4 @@
+import { ToolEventType } from '../../types.js';
 import { finalizeDeliveryInputSchema } from '../types.js';
 import { FINALIZE_DELIVERY_DESCRIPTION } from './constants.js';
 export function registerFinalizeDeliveryTool(server, context) {
@@ -8,7 +9,7 @@ export function registerFinalizeDeliveryTool(server, context) {
         return {
             content: [
                 { type: 'text', text: header },
-                { type: 'text', text: JSON.stringify(result) },
+                { type: 'text', text: JSON.stringify({ ...result, eventType: ToolEventType.DeliveryFinalized }) },
             ],
         };
     });

package/dist/tools/transport/finalize/finalize-delivery.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalize-delivery.js","sourceRoot":"","sources":["../../../../src/tools/transport/finalize/finalize-delivery.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,4BAA4B,CAAC,MAAqB,EAAE,OAAmB;IACnF,MAAM,CAAC,YAAY,CACf,uBAAuB,EACvB,EAAE,WAAW,EAAE,6BAA6B,EAAE,WAAW,EAAE,2BAA2B,EAAE,EACxF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GACR,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,uBAAuB,MAAM,CAAC,MAAM,sBAAsB;YAChG,GAAG,MAAM,CAAC,WAAW,qEAAqE,CAAC;QAE/F,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"finalize-delivery.js","sourceRoot":"","sources":["../../../../src/tools/transport/finalize/finalize-delivery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAsB,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAC;AAE/D,MAAM,UAAU,4BAA4B,CAAC,MAAqB,EAAE,OAAmB;IACnF,MAAM,CAAC,YAAY,CACf,uBAAuB,EACvB,EAAE,WAAW,EAAE,6BAA6B,EAAE,WAAW,EAAE,2BAA2B,EAAE,EACxF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GACR,aAAa,MAAM,CAAC,WAAW,CAAC,MAAM,uBAAuB,MAAM,CAAC,MAAM,sBAAsB;YAChG,GAAG,MAAM,CAAC,WAAW,qEAAqE,CAAC;QAE/F,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC9B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,iBAAiB,EAAE,CAAC,EAAE;aACpG;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/transport/network/constants.d.ts

@@ -1,2 +1,20 @@
 export { ROUTE_NETWORK_DESCRIPTION } from '../constants.js';
+export declare const ROUTE_NETWORK_TITLE = "ROUTE GRAPH";
+export declare const ROUTE_NETWORK_LABELS: {
+    graph: string;
+    schema: string;
+    snapshot: string;
+    waypoints: string;
+    hops: string;
+    from: string;
+    towards: string;
+    cargo: string;
+    lot: string;
+    source: string;
+    link: string;
+    next: string;
+    note: string;
+};
+export declare const ROUTE_NETWORK_LINKED = "one graph holds both ends \u2014 compute the chain from the file";
+export declare const ROUTE_NETWORK_SPLIT = "the ends are NOT connected in this graph \u2014 a gap to bridge first";
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/transport/network/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/network/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/network/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;CAchC,CAAC;AAEF,eAAO,MAAM,oBAAoB,qEAAgE,CAAC;AAClG,eAAO,MAAM,mBAAmB,0EAAqE,CAAC"}

package/dist/tools/transport/network/constants.js

@@ -1,2 +1,20 @@
 export { ROUTE_NETWORK_DESCRIPTION } from '../constants.js';
+export const ROUTE_NETWORK_TITLE = 'ROUTE GRAPH';
+export const ROUTE_NETWORK_LABELS = {
+    graph: 'Graph file',
+    schema: 'Schema',
+    snapshot: 'Snapshot',
+    waypoints: 'Waypoints',
+    hops: 'Legal hops',
+    from: 'From',
+    towards: 'Towards',
+    cargo: 'Cargo',
+    lot: 'Lot return',
+    source: 'Source',
+    link: 'Link',
+    next: 'Next',
+    note: 'Note',
+};
+export const ROUTE_NETWORK_LINKED = 'one graph holds both ends — compute the chain from the file';
+export const ROUTE_NETWORK_SPLIT = 'the ends are NOT connected in this graph — a gap to bridge first';
 //# sourceMappingURL=constants.js.map

package/dist/tools/transport/network/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/network/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/network/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAEjD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAChC,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,YAAY;IACjB,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,6DAA6D,CAAC;AAClG,MAAM,CAAC,MAAM,mBAAmB,GAAG,kEAAkE,CAAC"}

package/dist/tools/transport/network/panel.utils.d.ts

@@ -0,0 +1,3 @@
+import type { PlannedRouteNetworkResult } from '../../../services/route.types.js';
+export declare function routeNetworkPanel(result: PlannedRouteNetworkResult): string;
+//# sourceMappingURL=panel.utils.d.ts.map

package/dist/tools/transport/network/panel.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.utils.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/network/panel.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAyBlF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CA8B3E"}

package/dist/tools/transport/network/panel.utils.js

@@ -0,0 +1,52 @@
+import { ROUTE_NETWORK_LABELS, ROUTE_NETWORK_LINKED, ROUTE_NETWORK_SPLIT, ROUTE_NETWORK_TITLE } from './constants.js';
+import { renderPanel } from '../../../utils/panel.utils.js';
+function lotReturnRows(result) {
+    const plan = result.request.lotReturn;
+    if (plan === null) {
+        return [];
+    }
+    const source = plan.historicalSource;
+    return [
+        [
+            { label: ROUTE_NETWORK_LABELS.lot, value: `${plan.lotId} (${plan.lotState})` },
+            {
+                label: ROUTE_NETWORK_LABELS.source,
+                value: source === null
+                    ? 'judged on today’s map, exactly like an ordinary plan'
+                    : `the listed hub of the lot, admitted at reach ${source.radius} and ` +
+                        `${source.transitFeePerUnit} $CPU per unit whatever stands there now`,
+            },
+        ],
+    ];
+}
+export function routeNetworkPanel(result) {
+    const labels = ROUTE_NETWORK_LABELS;
+    const request = result.request;
+    return renderPanel({
+        title: ROUTE_NETWORK_TITLE,
+        rows: [
+            [{ label: labels.graph, value: result.artifactPath }],
+            [
+                { label: labels.schema, value: `${result.schemaVersion}` },
+                { label: labels.snapshot, value: `${result.snapshotVersion}` },
+                { label: labels.waypoints, value: `${result.nodeCount}` },
+                { label: labels.hops, value: `${result.edgeCount}` },
+            ],
+            [
+                { label: labels.from, value: request.from },
+                { label: labels.towards, value: request.towards },
+                { label: labels.cargo, value: `${request.amount} of resource ${request.resourceId}` },
+            ],
+            ...lotReturnRows(result),
+            [{ label: labels.link, value: result.connected ? ROUTE_NETWORK_LINKED : ROUTE_NETWORK_SPLIT }],
+            [
+                {
+                    label: labels.next,
+                    value: `load the file with code, follow every instruction below, then ${result.quoteTemplate.tool}`,
+                },
+            ],
+            [{ label: labels.note, value: result.note }],
+        ],
+    });
+}
+//# sourceMappingURL=panel.utils.js.map

package/dist/tools/transport/network/panel.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.utils.js","sourceRoot":"","sources":["../../../../src/tools/transport/network/panel.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGtH,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,SAAS,aAAa,CAAC,MAAiC;IACpD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACtC,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACrC,OAAO;QACH;YACI,EAAE,KAAK,EAAE,oBAAoB,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,GAAG,EAAE;YAC9E;gBACI,KAAK,EAAE,oBAAoB,CAAC,MAAM;gBAClC,KAAK,EACD,MAAM,KAAK,IAAI;oBACX,CAAC,CAAC,sDAAsD;oBACxD,CAAC,CAAC,gDAAgD,MAAM,CAAC,MAAM,OAAO;wBACpE,GAAG,MAAM,CAAC,iBAAiB,0CAA0C;aAClF;SACJ;KACJ,CAAC;AACN,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiC;IAC/D,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAE/B,OAAO,WAAW,CAAC;QACf,KAAK,EAAE,mBAAmB;QAC1B,IAAI,EAAE;YACF,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;YACrD;gBACI,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,EAAE;gBAC1D,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,eAAe,EAAE,EAAE;gBAC9D,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE;gBACzD,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,EAAE;aACvD;YACD;gBACI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE;gBAC3C,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;gBACjD,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,gBAAgB,OAAO,CAAC,UAAU,EAAE,EAAE;aACxF;YACD,GAAG,aAAa,CAAC,MAAM,CAAC;YACxB,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;YAC9F;gBACI;oBACI,KAAK,EAAE,MAAM,CAAC,IAAI;oBAClB,KAAK,EAAE,iEAAiE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;iBACtG;aACJ;YACD,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;SAC/C;KACJ,CAAC,CAAC;AACP,CAAC"}

package/dist/tools/transport/network/route-network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-network.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/network/route-network.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAyBpD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAmBzF"}
+{"version":3,"file":"route-network.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/network/route-network.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGpD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAuBzF"}

package/dist/tools/transport/network/route-network.js

@@ -1,34 +1,17 @@
 import { ROUTE_NETWORK_DESCRIPTION } from './constants.js';
+import { routeNetworkPanel } from './panel.utils.js';
 import { routeNetworkInputSchema } from '../types.js';
-function summarizeNetwork(result) {
-    const hubs = result.nodes.filter((n) => n.isHub).length;
-    const own = result.nodes.filter((n) => n.isOwn).length;
-    const parts = [
-        `Route network: ${result.nodes.length} waypoints (${own} yours, ${hubs} hubs), ` +
-            `${result.edges.length} legal hops, ${result.components} connected component(s)`,
-    ];
-    if (result.from !== null && result.towards !== null) {
-        const fromNode = result.nodes.find((n) => n.tokenId === result.from);
-        const toNode = result.nodes.find((n) => n.tokenId === result.towards);
-        const linked = fromNode !== undefined && toNode !== undefined && fromNode.component === toNode.component;
-        parts.push(`${result.from} → ${result.towards} is ${result.fromToTarget ?? '?'} grid steps; ` +
-            (linked
-                ? 'both sit in the same component — a chain exists, build it from the edges.'
-                : 'they are NOT connected through the current network — there is a gap to bridge.'));
-    }
-    parts.push(result.note);
-    return parts.join(' ');
-}
 export function registerRouteNetworkTool(server, context) {
     server.registerTool('cpu_route_network', { description: ROUTE_NETWORK_DESCRIPTION, inputSchema: routeNetworkInputSchema }, async (args) => {
         const result = await context.route.network({
             from: args.from,
             towards: args.towards,
             resourceId: args.resourceId,
-        });
+            amount: args.amount,
+        }, args.lotId === null ? null : { lotId: args.lotId });
         return {
             content: [
-                { type: 'text', text: summarizeNetwork(result) },
+                { type: 'text', text: routeNetworkPanel(result) },
                 { type: 'text', text: JSON.stringify(result) },
             ],
         };

package/dist/tools/transport/network/route-network.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-network.js","sourceRoot":"","sources":["../../../../src/tools/transport/network/route-network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,SAAS,gBAAgB,CAAC,MAA0B;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IACvD,MAAM,KAAK,GAAG;QACV,kBAAkB,MAAM,CAAC,KAAK,CAAC,MAAM,eAAe,GAAG,WAAW,IAAI,UAAU;YAC5E,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,gBAAgB,MAAM,CAAC,UAAU,yBAAyB;KACvF,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC;QACzG,KAAK,CAAC,IAAI,CACN,GAAG,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,YAAY,IAAI,GAAG,eAAe;YAC9E,CAAC,MAAM;gBACH,CAAC,CAAC,2EAA2E;gBAC7E,CAAC,CAAC,gFAAgF,CAAC,CAC9F,CAAC;IACN,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAqB,EAAE,OAAmB;IAC/E,MAAM,CAAC,YAAY,CACf,mBAAmB,EACnB,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,uBAAuB,EAAE,EAChF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YACvC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE;gBAChD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"route-network.js","sourceRoot":"","sources":["../../../../src/tools/transport/network/route-network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,UAAU,wBAAwB,CAAC,MAAqB,EAAE,OAAmB;IAC/E,MAAM,CAAC,YAAY,CACf,mBAAmB,EACnB,EAAE,WAAW,EAAE,yBAAyB,EAAE,WAAW,EAAE,uBAAuB,EAAE,EAChF,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CACtC;YACI,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,EACD,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CACrD,CAAC;QAEF,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE;gBACjD,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/transport/next-hops/constants.d.ts

@@ -1,2 +1,3 @@
 export { NEXT_HOPS_DESCRIPTION } from '../constants.js';
+export declare const NEXT_HOPS_SUMMARY_LIMIT = 20;
 //# sourceMappingURL=constants.d.ts.map

package/dist/tools/transport/next-hops/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,eAAO,MAAM,uBAAuB,KAAK,CAAC"}

package/dist/tools/transport/next-hops/constants.js

@@ -1,2 +1,4 @@
 export { NEXT_HOPS_DESCRIPTION } from '../constants.js';
+// Open ground makes every candidate list long; the summary stays readable while the payload stays complete.
+export const NEXT_HOPS_SUMMARY_LIMIT = 20;
 //# sourceMappingURL=constants.js.map

package/dist/tools/transport/next-hops/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC"}

package/dist/tools/transport/next-hops/next-hops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next-hops.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/next-hops.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAmCpD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAmBrF"}
+{"version":3,"file":"next-hops.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/next-hops.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AA6DpD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAsBrF"}

package/dist/tools/transport/next-hops/next-hops.js

@@ -1,5 +1,15 @@
-import { NEXT_HOPS_DESCRIPTION } from './constants.js';
+import { NEXT_HOPS_DESCRIPTION, NEXT_HOPS_SUMMARY_LIMIT } from './constants.js';
 import { nextHopsInputSchema } from '../types.js';
+/** Says out loud why the origin is legal at all — nothing on today's map explains a hop from a razed hub. */
+function returnNote(result) {
+    const source = result.lotReturn?.historicalSource ?? null;
+    if (source === null) {
+        return '';
+    }
+    return (` This survey plans the way home for lot ${result.lotReturn?.lotId ?? ''}: ${result.from} is its listed ` +
+        `hub, admitted from the lot itself with the reach recorded there (${source.radius}), whatever stands ` +
+        'there now. Every candidate below is judged on today’s map as usual.');
+}
 function originNote(result) {
     if (result.fromReady !== false) {
         return '';
@@ -7,21 +17,32 @@ function originNote(result) {
     return (` ${result.from} has a building still under construction, so your reach from here is normal cell reach — ` +
         'a Hub grants hub reach only once its construction finishes.');
 }
+function hopKind(hop) {
+    if (hop.isHub) {
+        return 'hub';
+    }
+    return hop.isVirgin ? 'virgin' : 'own';
+}
+function describeHop(hop) {
+    const fee = hop.transitFeePerUnit !== null ? `, fee ${hop.transitFeePerUnit} $CPU/u` : '';
+    const remaining = hop.distanceToTarget !== null ? `, ${hop.distanceToTarget} steps to target` : '';
+    return `${hop.tokenId} (${hopKind(hop)}, radius ${hop.radius}, ${hop.hopDistance} step hop${fee}${remaining})`;
+}
 function summarizeHops(result) {
     if (result.hops.length === 0) {
-        return (`No eligible waypoints within reach of ${result.from} — the route ends here.` +
-            `${originNote(result)} ` +
+        return (`No eligible waypoints within reach of ${result.from} (radius ${result.fromRadius}) — the route ends ` +
+            'here.' +
+            `${returnNote(result)}${originNote(result)} ` +
             'Build a Hub to bridge the gap, use closer cells, or reveal what you own nearby.');
     }
     const towards = result.towards !== null ? ` towards ${result.towards} (${result.targetDistance ?? '?'} steps away)` : '';
-    const lines = result.hops.map((hop) => {
-        const kind = hop.isOwn ? 'own' : 'hub';
-        const fee = hop.transitFeePerUnit !== null ? `, fee ${hop.transitFeePerUnit} $CPU/u` : '';
-        const remaining = hop.distanceToTarget !== null ? `, ${hop.distanceToTarget} steps to target` : '';
-        return `${hop.tokenId} (${kind}, ${hop.hopDistance} step hop${fee}${remaining})`;
-    });
-    return (`${result.hops.length} legal next hop(s) from ${result.from}${towards}: ${lines.join('; ')}.` +
-        `${originNote(result)} ${result.note}`);
+    const shown = result.hops.slice(0, NEXT_HOPS_SUMMARY_LIMIT);
+    const lines = shown.map(describeHop);
+    const hidden = result.hops.length - shown.length;
+    const rest = hidden > 0 ? ` + ${hidden} more in the JSON payload` : '';
+    return (`${result.hops.length} legal next hop(s) from ${result.from} (radius ${result.fromRadius})${towards}: ` +
+        `${lines.join('; ')}${rest}.` +
+        `${returnNote(result)}${originNote(result)} ${result.note}`);
 }
 export function registerNextHopsTool(server, context) {
     server.registerTool('cpu_next_hops', { description: NEXT_HOPS_DESCRIPTION, inputSchema: nextHopsInputSchema }, async (args) => {
@@ -29,7 +50,7 @@ export function registerNextHopsTool(server, context) {
             from: args.from,
             towards: args.towards,
             resourceId: args.resourceId,
-        });
+        }, args.lotId === null ? null : { lotId: args.lotId });
         return {
             content: [
                 { type: 'text', text: summarizeHops(result) },

package/dist/tools/transport/next-hops/next-hops.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-hops.js","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/next-hops.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,SAAS,UAAU,CAAC,MAAsB;IACtC,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,CACH,IAAI,MAAM,CAAC,IAAI,2FAA2F;QAC1G,6DAA6D,CAChE,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,MAAsB;IACzC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,CACH,yCAAyC,MAAM,CAAC,IAAI,yBAAyB;YAC7E,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG;YACxB,iFAAiF,CACpF,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GACT,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,cAAc,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7G,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,iBAAiB,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,gBAAgB,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,OAAO,GAAG,GAAG,CAAC,OAAO,KAAK,IAAI,KAAK,GAAG,CAAC,WAAW,YAAY,GAAG,GAAG,SAAS,GAAG,CAAC;IACrF,CAAC,CAAC,CAAC;IACH,OAAO,CACH,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,2BAA2B,MAAM,CAAC,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC7F,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CACzC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAqB,EAAE,OAAmB;IAC3E,MAAM,CAAC,YAAY,CACf,eAAe,EACf,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,mBAAmB,EAAE,EACxE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC9B,CAAC,CAAC;QAEH,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE;gBAC7C,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"next-hops.js","sourceRoot":"","sources":["../../../../src/tools/transport/next-hops/next-hops.ts"],"names":[],"mappings":"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"}

package/dist/tools/transport/quote/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/quote/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAO7B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/tools/transport/quote/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,QAc7B,CAAC"}

package/dist/tools/transport/quote/constants.js

@@ -2,8 +2,15 @@ export const QUOTE_TRANSPORT_DESCRIPTION = [
     'Preview a transport route (a waypoint chain of tokenIds) without committing: returns `fee` — the actual $CPU',
     '(decimal) you will pay across foreign hubs — and `discount`, the same-clan member saving already applied',
     '(the nominal fee equals fee + discount), plus the summed grid distance and the arrival timestamp. Read-only',
-    'on-chain view with no side effects. It also validates the route, surfacing the rejection reason if the chain',
-    'is invalid (hop out of range, unrevealed or ineligible waypoint). Scout waypoints with `cpu_next_hops`; use',
-    'this before `cpu_transport`.',
+    'on-chain view with no side effects. It also validates the chain and names the rejection reason: a hop longer',
+    'than radius(from)+radius(to)−1 grid steps, an ineligible waypoint (foreign land past its first completed',
+    'reveal carrying no finished Hub — Virgin ground and foreign finished Hubs are passage, not obstacles), or',
+    'endpoints that are not your own cells past their first completed reveal, or a destination with no room once',
+    'liquid, reserved and pending production are counted. A successful quote validates route mechanics and',
+    'economics at quote time, destination capacity included; it reserves no room and does not promise the later',
+    '`cpu_transport` will succeed — ownership, balances, capacity, pauses, allowances and live state can still',
+    'change before the send. Plan the chain with',
+    '`cpu_route_network` when you have a code runner and with `cpu_next_hops` when you do not; use this before',
+    '`cpu_transport`.',
 ].join(' ');
 //# sourceMappingURL=constants.js.map

package/dist/tools/transport/quote/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/quote/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,8GAA8G;IAC9G,0GAA0G;IAC1G,6GAA6G;IAC7G,8GAA8G;IAC9G,6GAA6G;IAC7G,8BAA8B;CACjC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/tools/transport/quote/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACvC,8GAA8G;IAC9G,0GAA0G;IAC1G,6GAA6G;IAC7G,8GAA8G;IAC9G,0GAA0G;IAC1G,2GAA2G;IAC3G,6GAA6G;IAC7G,uGAAuG;IACvG,4GAA4G;IAC5G,2GAA2G;IAC3G,6CAA6C;IAC7C,2GAA2G;IAC3G,kBAAkB;CACrB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/transport/transport.d.ts

@@ -1,4 +1,4 @@
 import type { AppContext } from '../../types.js';
-import type { ToolRegistrar } from '../types.js';
+import { type ToolRegistrar } from '../types.js';
 export declare function registerTransportTool(server: ToolRegistrar, context: AppContext): void;
 //# sourceMappingURL=transport.d.ts.map

package/dist/tools/transport/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAqBtF"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAqBtF"}

package/dist/tools/transport/transport.js

@@ -1,6 +1,7 @@
 import { TRANSPORT_DESCRIPTION } from './constants.js';
 import { summarizeTransport } from './format.utils.js';
 import { transportInputSchema } from './types.js';
+import { ToolEventType } from '../types.js';
 export function registerTransportTool(server, context) {
     server.registerTool('cpu_transport', { description: TRANSPORT_DESCRIPTION, inputSchema: transportInputSchema }, async (args) => {
         const result = await context.transport.transport({
@@ -12,7 +13,7 @@ export function registerTransportTool(server, context) {
         return {
             content: [
                 { type: 'text', text: summarizeTransport(result, resources) },
-                { type: 'text', text: JSON.stringify(result) },
+                { type: 'text', text: JSON.stringify({ ...result, eventType: ToolEventType.TransportSent }) },
             ],
         };
     });

package/dist/tools/transport/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,OAAmB;IAC5E,MAAM,CAAC,YAAY,CACf,eAAe,EACf,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,oBAAoB,EAAE,EACzE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;gBAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;aACjD;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/tools/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAEhE,MAAM,UAAU,qBAAqB,CAAC,MAAqB,EAAE,OAAmB;IAC5E,MAAM,CAAC,YAAY,CACf,eAAe,EACf,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,oBAAoB,EAAE,EACzE,KAAK,EAAE,IAAI,EAAE,EAAE;QACX,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QAEH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAErD,OAAO;YACH,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE;gBAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,aAAa,EAAE,CAAC,EAAE;aAChG;SACJ,CAAC;IACN,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/tools/transport/types.d.ts

@@ -6,14 +6,17 @@ export declare const transportInputSchema: {
     amount: z.ZodString;
 };
 export declare const routeNetworkInputSchema: {
+    from: z.ZodNumber;
+    towards: z.ZodNumber;
     resourceId: z.ZodNumber;
-    from: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
-    towards: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    amount: z.ZodString;
+    lotId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 };
 export declare const nextHopsInputSchema: {
     from: z.ZodNumber;
     resourceId: z.ZodNumber;
     towards: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    lotId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 };
 export declare const getTransportStatusInputSchema: {
     deliveryId: z.ZodString;

package/dist/tools/transport/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;CAehC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAanC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;CAU/B,CAAC;AAEF,eAAO,MAAM,6BAA6B;;CAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/transport/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,eAAO,MAAM,oBAAoB;;;;CAmBhC,CAAC;AAmBF,eAAO,MAAM,uBAAuB;;;;;;CAqBnC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;CAc/B,CAAC;AAEF,eAAO,MAAM,6BAA6B;;CAEzC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;CAKvC,CAAC"}