@agent-wire/terminal 1.7.6 → 1.7.9

package/dist/api-token.d.ts

@@ -0,0 +1,7 @@
+interface TokenConfig {
+    apiToken: string;
+    apiTokenFile?: string;
+}
+/** Explicit environment token > environment file > saved configuration. */
+export declare function resolveApiToken(config: TokenConfig, allowInvalidTokenFile?: boolean): TokenConfig;
+export {};

package/dist/api-token.js

@@ -0,0 +1,42 @@
+import { readFileSync } from 'node:fs';
+import { isAbsolute } from 'node:path';
+// Capture credentials for this process; rotating a token file requires a restart.
+const envToken = process.env.WIRE_API_TOKEN;
+const envTokenFile = process.env.WIRE_API_TOKEN_FILE;
+const fileTokens = new Map();
+/** Explicit environment token > environment file > saved configuration. */
+export function resolveApiToken(config, allowInvalidTokenFile = false) {
+    if (envToken)
+        return { apiToken: envToken, apiTokenFile: undefined };
+    const path = envTokenFile ?? config.apiTokenFile;
+    if (path === undefined)
+        return { apiToken: config.apiToken, apiTokenFile: undefined };
+    let token = fileTokens.get(path);
+    if (token === undefined) {
+        if (!isAbsolute(path)) {
+            token = new Error('WIRE_API_TOKEN_FILE must be an absolute path to a file containing only your token');
+        }
+        else {
+            try {
+                token = readFileSync(path, 'utf8').trim();
+                if (!token)
+                    token = new Error('The file referenced by WIRE_API_TOKEN_FILE is empty; it must contain only your token');
+            }
+            catch (error) {
+                // Only expose the OS code, never file contents or an arbitrary error message.
+                const code = error.code ?? 'read failed';
+                token = new Error(`Cannot read the file referenced by WIRE_API_TOKEN_FILE (${code}); set it to an absolute path to a file containing only your token`);
+            }
+        }
+        fileTokens.set(path, token);
+    }
+    if (token instanceof Error) {
+        // Public help/discovery may proceed anonymously; authenticated callers retry
+        // this same cached result and receive the error without exposing the value.
+        if (allowInvalidTokenFile)
+            return { apiToken: '', apiTokenFile: path };
+        throw token;
+    }
+    return { apiToken: token, apiTokenFile: path };
+}
+//# sourceMappingURL=api-token.js.map

package/dist/api-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-token.js","sourceRoot":"","sources":["../src/api-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAOvC,kFAAkF;AAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAC5C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AACrD,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;AAErD,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAAC,MAAmB,EAAE,qBAAqB,GAAG,KAAK;IAChF,IAAI,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC;IACjD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC;IAEtF,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,GAAG,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACzG,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1C,IAAI,CAAC,KAAK;oBAAE,KAAK,GAAG,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;YACxH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,8EAA8E;gBAC9E,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,IAAI,aAAa,CAAC;gBACpE,KAAK,GAAG,IAAI,KAAK,CAAC,2DAA2D,IAAI,oEAAoE,CAAC,CAAC;YACzJ,CAAC;QACH,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,6EAA6E;QAC7E,4EAA4E;QAC5E,IAAI,qBAAqB;YAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACvE,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/api.d.ts

@@ -1,5 +1,11 @@
+import type { CreditAmount } from './contracts/credit-amount.js';
 import type { WireNodeConfig } from './config.js';
 import type { MarketNativeDocsIngestMode, RemoteDocument } from './sync/types.js';
+export declare function normalizeWireApiUrl(value: string): string;
+export declare class RegistrationError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
 type LegacyActionInvokeParams = {
     action_id: string;
     mode: string;
@@ -11,8 +17,19 @@ type LegacyActionInvokeParams = {
 type LegacyActionChainParams = LegacyActionInvokeParams & {
     chain_id?: string;
 };
+export interface MeshScopeParams {
+    scope?: 'agent' | 'fleet' | 'circle';
+    circle_id?: string;
+}
 export interface QueryParams {
-    text: string;
+    count?: 'exact';
+    text?: string;
+    types?: string | string[];
+    type?: string;
+    exclude_types?: string | string[];
+    exclude_type?: string;
+    creator?: string;
+    agent?: string;
     domain?: string;
     limit?: number;
     offset?: number;
@@ -24,6 +41,7 @@ export interface QueryParams {
 }
 export interface ContributeParams {
     type: string;
+    original?: boolean;
     contribution_type?: 'mechanical' | 'intelligence';
     title: string;
     body: string;
@@ -46,14 +64,14 @@ export interface ContributeParams {
         claim: string;
         trackable: boolean;
     }>;
-    price?: number;
+    price?: CreditAmount;
     pricing_curve?: Array<{
         credits: number;
         after_hours: number;
     }>;
     curve_power?: number;
     bid?: {
-        amount: number;
+        amount: CreditAmount;
         duration_hours: number;
     };
     embargo_until?: string;
@@ -88,6 +106,9 @@ export interface BrowseParams {
     include_definition?: boolean;
     definition_purpose?: string;
     definition_scope?: string;
+    cursor?: string;
+    limit?: number;
+    offset?: number;
 }
 export interface FlagParams {
     item_id: string;
@@ -111,7 +132,7 @@ export interface StakeResult {
     position: {
         id: string;
         side: string;
-        amount: number;
+        amount: CreditAmount;
         created_at: string;
     };
     market: {
@@ -133,7 +154,7 @@ export interface MarketStatus {
     your_positions: Array<{
         id: string;
         side: string;
-        amount: number;
+        amount: CreditAmount;
         created_at: string;
     }>;
     resolution: {
@@ -165,8 +186,8 @@ export interface PinPreview {
 export interface RetractionResult {
     retracted: boolean;
     contribution_id: string;
-    deposit_refund: number;
-    deposit_forfeit: number;
+    deposit_refund: CreditAmount;
+    deposit_forfeit: CreditAmount;
     bounty_clawback: number;
 }
 export interface RateParams {
@@ -272,13 +293,21 @@ export type WireEventStreamMessage = {
     data: unknown;
 };
 export declare function normalizeWaitTimeoutSeconds(timeoutSeconds: number | undefined): number;
-declare function normalizeHelpTopic(topic: string | undefined): string;
+export declare function normalizeHelpTopic(topic: string | undefined): string;
 export declare const __wireApiTestInternals: {
     normalizeHelpTopic: typeof normalizeHelpTopic;
     parseSseBlock: typeof parseSseBlock;
 };
 declare function parseSseBlock(block: string): WireEventStreamMessage | null;
+/** Keep actionable server refusals intact across MCP and terminal transports. */
+export declare class WireApiRefusal extends Error {
+    readonly status: number;
+    readonly body: Record<string, unknown>;
+    constructor(status: number, body: Record<string, unknown>);
+}
 export declare class WireAPI {
+    private httpFetch?;
+    claims(params: Record<string, unknown>): Promise<unknown>;
     private baseUrl;
     private token;
     private nodeId;
@@ -287,7 +316,7 @@ export declare class WireAPI {
     private localNodeEnabled;
     private localNodeToken;
     private localContributionRouteStatus;
-    constructor(config: WireNodeConfig, threadId?: string);
+    constructor(config: WireNodeConfig, threadId?: string, httpFetch?: typeof fetch | undefined);
     /** Set or update the thread ID (used for mesh coordination) */
     setThreadId(id: string): void;
     request<T>(method: string, path: string, body?: unknown, timeoutMs?: number): Promise<T>;
@@ -328,7 +357,7 @@ export declare class WireAPI {
     }>;
     submitResult(workId: string, result: Record<string, unknown>): Promise<{
         credits_awarded: number;
-        balance_after: number;
+        balance_after: CreditAmount;
     }>;
     heartbeat(nodeId: string): Promise<{
         status: string;
@@ -362,6 +391,30 @@ export declare class WireAPI {
     private localHeaders;
     private localAuthToken;
     private 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.
+     */
+    private localNodeFetch;
+    /**
+     * 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.
+     */
+    getPyramidMap(slug: string): Promise<Record<string, unknown>>;
+    /**
+     * 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.
+     */
+    getPyramidDrill(slug: string, nodeId: string): Promise<Record<string, unknown>>;
+    /**
+     * 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.
+     */
+    askPyramid(slug: string, question: string): Promise<Record<string, unknown>>;
     /**
      * Rate a Wire item. Free. Must have accessed it first.
      */
@@ -418,31 +471,31 @@ export declare class WireAPI {
     /**
      * Get full mesh status: active threads, intents, blackboard.
      */
-    meshStatus(): Promise<Record<string, unknown>>;
+    meshStatus(scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Read the shared blackboard.
      */
-    meshBoardRead(): Promise<Record<string, unknown>>;
+    meshBoardRead(scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Write a key-value entry to the shared blackboard.
      */
-    meshBoardWrite(key: string, value: unknown, ttl?: number): Promise<Record<string, unknown>>;
+    meshBoardWrite(key: string, value: unknown, ttl?: number, scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Delete a key from the shared blackboard.
      */
-    meshBoardDelete(key: string): Promise<Record<string, unknown>>;
+    meshBoardDelete(key: string, scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Declare an intent (what this thread is about to do).
      */
-    meshDeclareIntent(action: string, domain?: string, meta?: Record<string, unknown>, ttl?: number): Promise<Record<string, unknown>>;
+    meshDeclareIntent(action: string, domain?: string, meta?: Record<string, unknown>, ttl?: number, scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Release (delete) an intent.
      */
-    meshReleaseIntent(intentId: string): Promise<Record<string, unknown>>;
+    meshReleaseIntent(intentId: string, scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Get active intents for this agent.
      */
-    meshGetIntents(): Promise<Record<string, unknown>>;
+    meshGetIntents(scope?: MeshScopeParams): Promise<Record<string, unknown>>;
     /**
      * Stake credits on a prediction market attached to a contribution.
      * The contribution must have a claim with `market.enabled: true`.
@@ -452,7 +505,7 @@ export declare class WireAPI {
      * @param side - 'agree' or 'disagree'
      * @param amount - Number of credits to stake (must be >= market's min_stake)
      */
-    stakeMarket(contributionId: string, side: 'agree' | 'disagree', amount: number): Promise<StakeResult>;
+    stakeMarket(contributionId: string, side: 'agree' | 'disagree', amount: CreditAmount, requestId?: string): Promise<StakeResult>;
     /**
      * Get the current status of a prediction market, including pool sizes,
      * your positions, and resolution status if resolved.
@@ -619,8 +672,9 @@ export declare class WireAPI {
     acceptSupersession(proposalId: string): Promise<Record<string, unknown>>;
     rejectSupersession(proposalId: string): Promise<Record<string, unknown>>;
     executeSupersession(targetId: string, newContributionId: string, allowTypeChange?: boolean): Promise<Record<string, unknown>>;
-    submitCorrection(targetId: string, correctionContributionId: string, depositAmount: number): Promise<Record<string, unknown>>;
-    endorseCorrection(correctionId: string, depositAmount: number): Promise<Record<string, unknown>>;
+    submitCorrection(targetId: string, correctionContributionId: string, depositAmount: CreditAmount): Promise<Record<string, unknown>>;
+    withdrawCorrection(correctionId: string): Promise<Record<string, unknown>>;
+    endorseCorrection(correctionId: string, depositAmount: CreditAmount): Promise<Record<string, unknown>>;
     listCircles(): Promise<Record<string, unknown>>;
     createCircle(name: string, partnerEmail: string, description?: string): Promise<Record<string, unknown>>;
     joinCircle(circleId: string): Promise<Record<string, unknown>>;
@@ -704,7 +758,7 @@ export declare class WireAPI {
         material_class?: string;
         visibility?: string;
         themes?: string[];
-        attestation_tier?: string;
+        attestation_tier: 'ownership' | 'authorization' | 'good_faith';
         authorizing_party?: string;
         authorization_basis?: string;
         rights_basis?: string;
@@ -729,4 +783,13 @@ export declare class WireAPI {
     getRosterWithDeviceSecret(deviceSecret: string, harness?: string, hintName?: string): Promise<Record<string, unknown>>;
     resumeAgent(agentName: string, deviceSecret: string, nonce: string): Promise<Record<string, unknown>>;
 }
+/**
+ * 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 declare function paginateAll<T>(fetchPage: (page: number, pageSize: number) => Promise<T[]>, pageSize?: number): Promise<T[]>;
 export {};