@agent-wire/terminal 1.7.6 → 1.7.9

package/dist/api.js

@@ -1,8 +1,27 @@
-import { paginateAll } from './sync/paginate.js';
+const normalizedUrlNotices = new Set();
+export function normalizeWireApiUrl(value) {
+    const url = new URL(value);
+    if (url.pathname === '/' || !url.pathname) {
+        url.pathname = '/api/v1';
+        if (!normalizedUrlNotices.has(value)) {
+            console.error('[wire] WIRE_API_URL has no API path; appended /api/v1.');
+            normalizedUrlNotices.add(value);
+        }
+    }
+    return url.toString().replace(/\/+$/, '');
+}
 const DEFAULT_TRUSTED_CHAIN_TIMEOUT_MS = 600_000;
 const TRUSTED_CHAIN_CLIENT_GRACE_MS = 5_000;
 const DEFAULT_WIRE_SYNC_TIMEOUT_MS = DEFAULT_TRUSTED_CHAIN_TIMEOUT_MS + TRUSTED_CHAIN_CLIENT_GRACE_MS;
 const DEFAULT_ACTION_QUOTE_TIMEOUT_MS = 30_000;
+export class RegistrationError extends Error {
+    status;
+    constructor(status, message) {
+        super(`Registration failed (${status}): ${message}`);
+        this.status = status;
+        this.name = 'RegistrationError';
+    }
+}
 function legacyActionRequestOptions(params) {
     if (params.mode === 'quote') {
         return { body: params, timeoutMs: DEFAULT_ACTION_QUOTE_TIMEOUT_MS };
@@ -13,6 +32,14 @@ function legacyActionRequestOptions(params) {
         timeoutMs: timeoutMs + TRUSTED_CHAIN_CLIENT_GRACE_MS,
     };
 }
+function meshQuery(params, extra = {}) {
+    const query = new URLSearchParams(extra);
+    if (params.scope)
+        query.set('scope', params.scope);
+    if (params.circle_id)
+        query.set('circle_id', params.circle_id);
+    return query.size ? `?${query}` : '';
+}
 const DEFAULT_WAIT_TIMEOUT_SECONDS = 30;
 // Raised from 1800 (30m): the SSE event stream is server-side UNCAPPED + 30s-keepalived, so a long
 // client park is just a client-side deadline, not an infra limit. 86400 = 24h finite ceiling.
@@ -69,7 +96,7 @@ function appendWaitParams(url, params) {
             url.searchParams.set(key, String(value));
     }
 }
-function normalizeHelpTopic(topic) {
+export function normalizeHelpTopic(topic) {
     return (topic || '')
         .trim()
         .replace(/^https?:\/\/[^/]+\/api\/v1\/help\/?/i, '')
@@ -130,7 +157,25 @@ function parseSseBlock(block) {
         return { event, data: rawData };
     }
 }
+/** Keep actionable server refusals intact across MCP and terminal transports. */
+export class WireApiRefusal extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(JSON.stringify(body));
+        this.status = status;
+        this.body = body;
+    }
+}
 export class WireAPI {
+    httpFetch;
+    async claims(params) {
+        const { action, claim_id } = params;
+        if (action === 'get' || action === 'list') {
+            return this.request('GET', '/wire/claims' + (claim_id ? `?claim_id=${encodeURIComponent(String(claim_id))}` : ''));
+        }
+        return this.request('POST', '/wire/claims', params, 120_000);
+    }
     baseUrl;
     token;
     nodeId;
@@ -139,8 +184,9 @@ export class WireAPI {
     localNodeEnabled;
     localNodeToken;
     localContributionRouteStatus;
-    constructor(config, threadId) {
-        this.baseUrl = config.apiUrl;
+    constructor(config, threadId, httpFetch) {
+        this.httpFetch = httpFetch;
+        this.baseUrl = normalizeWireApiUrl(config.apiUrl);
         this.token = config.apiToken;
         this.nodeId = config.nodeId;
         this.threadId = threadId || null;
@@ -162,7 +208,7 @@ export class WireAPI {
         if (this.threadId) {
             headers['X-Wire-Thread'] = this.threadId;
         }
-        const res = await fetch(url, {
+        const res = await (this.httpFetch ?? fetch)(url, {
             method,
             headers,
             body: body ? JSON.stringify(body) : undefined,
@@ -170,6 +216,8 @@ export class WireAPI {
         });
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
+            if (err.code === 'confirm_original')
+                throw new WireApiRefusal(res.status, err);
             throw new Error(`API ${method} ${path} failed (${res.status}): ${err.error || res.statusText}`);
         }
         return res.json();
@@ -183,7 +231,7 @@ export class WireAPI {
         if (this.threadId) {
             headers['X-Wire-Thread'] = this.threadId;
         }
-        const res = await fetch(url, {
+        const res = await (this.httpFetch ?? fetch)(url, {
             method,
             headers,
             body: body ? JSON.stringify(body) : undefined,
@@ -222,7 +270,7 @@ export class WireAPI {
         return response;
     }
     async getMe() {
-        return this.request('GET', '/me');
+        return this.unwrapEnvelopeOrPlain(await this.request('GET', '/me'));
     }
     async registerNode(name, capabilities) {
         return this.request('POST', '/node/register', { name, capabilities });
@@ -234,7 +282,7 @@ export class WireAPI {
     async registerAgent(params) {
         // Registration doesn't require auth — use a raw fetch
         const url = `${this.baseUrl}/register`;
-        const res = await fetch(url, {
+        const res = await (this.httpFetch ?? fetch)(url, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(params),
@@ -242,7 +290,7 @@ export class WireAPI {
         });
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
-            throw new Error(`Registration failed (${res.status}): ${err.error || res.statusText}`);
+            throw new RegistrationError(res.status, err.error || res.statusText);
         }
         // Server wraps response in wireEnvelope: { data: { ... }, mesh, fleet, ... }
         const envelope = await res.json();
@@ -263,21 +311,10 @@ export class WireAPI {
     }
     async query(params) {
         const qs = new URLSearchParams();
-        qs.set('text', params.text);
-        qs.set('domain', params.domain || 'all');
-        if (params.limit !== undefined)
-            qs.set('limit', String(params.limit));
-        if (params.offset !== undefined)
-            qs.set('offset', String(params.offset));
-        qs.set('sort', params.sort || 'recency');
-        if (params.watchlist)
-            qs.set('watchlist', 'true');
-        if (params.list)
-            qs.set('list', params.list);
-        if (params.changed_only)
-            qs.set('changed_only', 'true');
-        if (params.price_below !== undefined)
-            qs.set('price_below', String(params.price_below));
+        for (const [key, value] of Object.entries({ domain: 'all', sort: 'recency', ...params })) {
+            if (value !== undefined && value !== null)
+                qs.set(key, String(value));
+        }
         return this.request('GET', `/wire/query?${qs.toString()}`);
     }
     async help(params = {}) {
@@ -337,6 +374,8 @@ export class WireAPI {
         return results;
     }
     async browse(params) {
+        if (params.cursor && (params.item_id || params.entity))
+            throw new Error('cursor applies to item-list browsing; omit item_id/entity.');
         if (params.item_id) {
             if (params.include_definition) {
                 const qs = new URLSearchParams({ mode: 'inspect', include_definition: 'true' });
@@ -354,10 +393,16 @@ export class WireAPI {
                 qs.set('arc', params.arc);
             return this.request('GET', `/wire/entities?${qs.toString()}`);
         }
-        if (params.arc) {
-            return this.request('GET', `/wire/items?arc=${encodeURIComponent(params.arc)}`);
-        }
-        return this.request('GET', '/wire/items');
+        const qs = new URLSearchParams();
+        if (params.arc)
+            qs.set('arc', params.arc);
+        if (params.cursor)
+            qs.set('cursor', params.cursor);
+        if (params.limit !== undefined)
+            qs.set('limit', String(params.limit));
+        if (params.offset !== undefined)
+            qs.set('offset', String(params.offset));
+        return this.request('GET', `/wire/items${qs.size ? '?' + qs : ''}`);
     }
     async flag(params) {
         return this.request('POST', '/flag', params);
@@ -411,7 +456,7 @@ export class WireAPI {
         if (this.localContributionRouteStatus)
             return this.localContributionRouteStatus;
         try {
-            const health = await fetch(`${this.localNodeUrl}/health`, {
+            const health = await (this.httpFetch ?? fetch)(`${this.localNodeUrl}/health`, {
                 method: 'GET',
                 signal: AbortSignal.timeout(2_000),
             });
@@ -419,7 +464,7 @@ export class WireAPI {
                 this.localContributionRouteStatus = 'unavailable';
                 return this.localContributionRouteStatus;
             }
-            const probe = await fetch(`${this.localNodeUrl}${localContributionReadPath('__wire_terminal_route_probe__')}`, {
+            const probe = await (this.httpFetch ?? fetch)(`${this.localNodeUrl}${localContributionReadPath('__wire_terminal_route_probe__')}`, {
                 method: 'GET',
                 headers: this.localHeaders(),
                 signal: AbortSignal.timeout(2_000),
@@ -453,7 +498,7 @@ export class WireAPI {
             return null;
         const path = localContributionReadPath(identifier);
         try {
-            const res = await fetch(`${this.localNodeUrl}${path}`, {
+            const res = await (this.httpFetch ?? fetch)(`${this.localNodeUrl}${path}`, {
                 method: 'GET',
                 headers: this.localHeaders(),
                 signal: AbortSignal.timeout(10_000),
@@ -476,6 +521,55 @@ export class WireAPI {
             return null;
         }
     }
+    // ── Pyramid consume-head proxies (spec green playful/176/24) ───────────
+    // Thin HTTP proxies to the LOCAL AWN node's read-time pyramid routes
+    // (pyramid_routes mounted at /pyramid/*). They forward (slug, args) to the
+    // route and return the parsed JSON as-is. Auth: pass the local Bearer token
+    // (this.localHeaders()); the AWN routes enforce dual-auth + access-tier +
+    // nano-payment. Same local-node fetch pattern as tryLocalContributionRead.
+    /**
+     * Generic local-node fetch for the pyramid consume-head proxies. Returns the
+     * parsed JSON body on success, throws a descriptive error on non-2xx.
+     */
+    async localNodeFetch(method, path, body, timeoutMs = 15_000) {
+        const res = await (this.httpFetch ?? fetch)(`${this.localNodeUrl}${path}`, {
+            method,
+            headers: this.localHeaders(),
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok) {
+            const err = await res.json().catch(() => ({ error: res.statusText }));
+            const message = err.error || res.statusText;
+            throw new Error(`Local node ${method} ${path} failed (${res.status}): ${message}`);
+        }
+        return await res.json();
+    }
+    /**
+     * pyramid_map — GET /pyramid/{slug}/map.
+     * Apex synthesis + freshness counts + nav skeleton + unresolved gaps.
+     * Orient first at boot, then drill via pyramid_hydrate using nav node ids.
+     */
+    async getPyramidMap(slug) {
+        return this.localNodeFetch('GET', `/pyramid/${encodeURIComponent(slug)}/map`);
+    }
+    /**
+     * pyramid_hydrate — GET /pyramid/{slug}/drill/{node_id}.
+     * Returns the DrillResult: full node content (headline/distilled/narrative
+     * via the node payload) plus children, evidence, gaps, web_edges, and
+     * question context. Pull one node/region after orienting via pyramid_map.
+     */
+    async getPyramidDrill(slug, nodeId) {
+        return this.localNodeFetch('GET', `/pyramid/${encodeURIComponent(slug)}/drill/${encodeURIComponent(nodeId)}`);
+    }
+    /**
+     * pyramid_ask — POST /pyramid/{slug}/question  body { question }.
+     * Cheap (<5s, no-LLM) mechanical retrieval over the existing pyramid;
+     * returns a markdown answer plus node-id citations / sources.
+     */
+    async askPyramid(slug, question) {
+        return this.localNodeFetch('POST', `/pyramid/${encodeURIComponent(slug)}/question`, { question });
+    }
     /**
      * Rate a Wire item. Free. Must have accessed it first.
      */
@@ -523,7 +617,8 @@ export class WireAPI {
      * Read a source document by ID.
      */
     async readDocument(documentId) {
-        return this.request('GET', `/wire/documents/${documentId}?include_body=true`, undefined, 30_000);
+        const quote = await this.request('GET', `/wire/documents/${documentId}`, undefined, 30_000);
+        return this.request('POST', `/wire/documents/${quote.id ?? quote.data?.id ?? documentId}`, { max_price: quote.current_price ?? quote.data?.current_price ?? 0 }, 30_000);
     }
     /**
      * Find unscouted documents — unclaimed bounties.
@@ -596,44 +691,44 @@ export class WireAPI {
     /**
      * Get full mesh status: active threads, intents, blackboard.
      */
-    async meshStatus() {
-        return this.request('GET', '/mesh/status');
+    async meshStatus(scope = {}) {
+        return this.request('GET', `/mesh/status${meshQuery(scope)}`);
     }
     /**
      * Read the shared blackboard.
      */
-    async meshBoardRead() {
-        return this.request('GET', '/mesh/board');
+    async meshBoardRead(scope = {}) {
+        return this.request('GET', `/mesh/board${meshQuery(scope)}`);
     }
     /**
      * Write a key-value entry to the shared blackboard.
      */
-    async meshBoardWrite(key, value, ttl) {
-        return this.request('POST', '/mesh/board', { key, value, ttl });
+    async meshBoardWrite(key, value, ttl, scope = {}) {
+        return this.request('POST', '/mesh/board', { key, value, ttl, ...scope });
     }
     /**
      * Delete a key from the shared blackboard.
      */
-    async meshBoardDelete(key) {
-        return this.request('DELETE', `/mesh/board?key=${encodeURIComponent(key)}`);
+    async meshBoardDelete(key, scope = {}) {
+        return this.request('DELETE', `/mesh/board${meshQuery(scope, { key })}`);
     }
     /**
      * Declare an intent (what this thread is about to do).
      */
-    async meshDeclareIntent(action, domain, meta, ttl) {
-        return this.request('POST', '/mesh/intent', { action, domain, meta, ttl });
+    async meshDeclareIntent(action, domain, meta, ttl, scope = {}) {
+        return this.request('POST', '/mesh/intent', { action, domain, meta, ttl, ...scope });
     }
     /**
      * Release (delete) an intent.
      */
-    async meshReleaseIntent(intentId) {
-        return this.request('DELETE', `/mesh/intent?intent_id=${encodeURIComponent(intentId)}`);
+    async meshReleaseIntent(intentId, scope = {}) {
+        return this.request('DELETE', `/mesh/intent${meshQuery(scope, { intent_id: intentId })}`);
     }
     /**
      * Get active intents for this agent.
      */
-    async meshGetIntents() {
-        return this.request('GET', '/mesh/intent');
+    async meshGetIntents(scope = {}) {
+        return this.request('GET', `/mesh/intent${meshQuery(scope)}`);
     }
     // ── Prediction Markets ─────────────────────────────────────
     /**
@@ -645,8 +740,8 @@ export class WireAPI {
      * @param side - 'agree' or 'disagree'
      * @param amount - Number of credits to stake (must be >= market's min_stake)
      */
-    async stakeMarket(contributionId, side, amount) {
-        return this.request('POST', `/wire/market/${contributionId}/stake`, { side, amount });
+    async stakeMarket(contributionId, side, amount, requestId = crypto.randomUUID()) {
+        return this.request('POST', `/wire/market/${contributionId}/stake`, { side, amount, request_id: requestId });
     }
     /**
      * Get the current status of a prediction market, including pool sizes,
@@ -823,7 +918,7 @@ export class WireAPI {
         if (this.threadId) {
             headers['X-Wire-Thread'] = this.threadId;
         }
-        const res = await fetch(url.toString(), {
+        const res = await (this.httpFetch ?? fetch)(url.toString(), {
             method: 'GET',
             headers,
             signal: options.signal,
@@ -1011,7 +1106,7 @@ export class WireAPI {
     async executeSupersession(targetId, newContributionId, allowTypeChange) {
         // allow_type_change forwards to the REST endpoint (which already honors it) so a CROSS-TYPE
         // supersession is reachable via the CLI/MCP, not only via raw REST (WI playful/170/177).
-        const body = { new_contribution_id: newContributionId };
+        const body = { contribution_id: newContributionId };
         if (allowTypeChange)
             body.allow_type_change = true;
         return this.request('POST', `/wire/contributions/${encodeURIComponent(targetId)}/supersede`, body);
@@ -1020,6 +1115,9 @@ export class WireAPI {
     async submitCorrection(targetId, correctionContributionId, depositAmount) {
         return this.request('POST', `/wire/contributions/${encodeURIComponent(targetId)}/correct`, { correction_contribution_id: correctionContributionId, deposit_amount: depositAmount });
     }
+    async withdrawCorrection(correctionId) {
+        return this.request('DELETE', `/wire/contributions/${encodeURIComponent(correctionId)}/endorse-correction`);
+    }
     async endorseCorrection(correctionId, depositAmount) {
         return this.request('POST', `/wire/contributions/${encodeURIComponent(correctionId)}/endorse-correction`, { deposit_amount: depositAmount });
     }
@@ -1187,7 +1285,7 @@ export class WireAPI {
         if (this.threadId) {
             headers['X-Wire-Thread'] = this.threadId;
         }
-        const res = await fetch(url, { method: 'GET', headers, signal: AbortSignal.timeout(30_000) });
+        const res = await (this.httpFetch ?? fetch)(url, { method: 'GET', headers, signal: AbortSignal.timeout(30_000) });
         if (!res.ok) {
             const err = await res.json().catch(() => ({ error: res.statusText }));
             throw new Error(`API GET /wire/documents/${documentId}/body failed (${res.status}): ${err.error || res.statusText}`);
@@ -1250,7 +1348,7 @@ export class WireAPI {
         const body = { email, device_fingerprint: deviceFingerprint };
         if (agentMessage)
             body.agent_message = agentMessage;
-        const res = await fetch(url, {
+        const res = await (this.httpFetch ?? fetch)(url, {
             method: 'POST',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(body),
@@ -1266,7 +1364,7 @@ export class WireAPI {
     async verifyDeviceCode(email, deviceFingerprint, code) {
         // No auth required — raw fetch
         const url = `${this.baseUrl}/wire/device-auth`;
-        const res = await fetch(url, {
+        const res = await (this.httpFetch ?? fetch)(url, {
             method: 'PUT',
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify({ email, device_fingerprint: deviceFingerprint, code }),
@@ -1284,7 +1382,7 @@ export class WireAPI {
             url.searchParams.set('harness', harness);
         if (hintName)
             url.searchParams.set('hint_name', hintName);
-        const res = await fetch(url.toString(), {
+        const res = await (this.httpFetch ?? fetch)(url.toString(), {
             headers: { 'X-Wire-Device-Secret': deviceSecret },
             signal: AbortSignal.timeout(15_000),
         });
@@ -1296,7 +1394,7 @@ export class WireAPI {
         return json.data || json;
     }
     async resumeAgent(agentName, deviceSecret, nonce) {
-        const res = await fetch(`${this.baseUrl}/wire/agent/resume`, {
+        const res = await (this.httpFetch ?? fetch)(`${this.baseUrl}/wire/agent/resume`, {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
@@ -1313,4 +1411,30 @@ export class WireAPI {
         return json.data || json;
     }
 }
+/**
+ * Paginate through all results from a fetch function.
+ * Concatenates pages until a page returns fewer than pageSize items.
+ *
+ * @param fetchPage - Function that fetches a page (1-indexed page number, pageSize)
+ * @param pageSize - Number of items per page (default 100)
+ * @returns All items concatenated
+ */
+export async function paginateAll(fetchPage, pageSize = 100) {
+    const allItems = [];
+    let page = 1;
+    const MAX_PAGES = 500; // 500 pages * 100 per page = 50k docs max
+    while (true) {
+        if (page > MAX_PAGES) {
+            console.error(`[wire-sync] Pagination stopped at ${MAX_PAGES} pages (${allItems.length} items). If your corpus has more documents, contact support.`);
+            break;
+        }
+        const items = await fetchPage(page, pageSize);
+        allItems.push(...items);
+        if (items.length < pageSize) {
+            break;
+        }
+        page++;
+    }
+    return allItems;
+}
 //# sourceMappingURL=api.js.map