@toon-protocol/client-mcp 0.10.0 → 0.10.2

package/dist/daemon.js

@@ -4,7 +4,7 @@ import {
   ClientRunner,
   registerRoutes,
   scaffoldFirstRun
-} from "./chunk-ZIJNTR5Y.js";
+} from "./chunk-557ZV5RR.js";
 import {
   ControlClient,
   ToonClient,
@@ -17,7 +17,7 @@ import {
   resolveConfig,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5Z74D23J.js";
+} from "./chunk-BO5F3VT5.js";
 import "./chunk-32QD72IL.js";
 import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";

package/dist/index.d.ts

@@ -212,6 +212,10 @@ interface ChannelInfo {
     depositTotal?: string;
     /** Spendable balance = depositTotal − cumulativeAmount (clamped ≥ 0), decimal. */
     availableBalance?: string;
+    /** Where the channel sits in the withdraw journey. */
+    closeState?: 'open' | 'closing' | 'settleable' | 'settled';
+    /** Unix SECONDS the channel becomes settleable, when closing. */
+    settleableAt?: string;
 }
 /** `GET /channels` — list tracked channels with nonce watermarks. */
 interface ChannelsResponse {
@@ -248,6 +252,26 @@ interface ChannelDepositResponse {
     /** New on-chain deposit total after the deposit, base units, decimal. */
     depositTotal: string;
 }
+/** `POST /channels/close` — begin the settlement grace period (withdraw, step 1). */
+interface CloseChannelRequest {
+    channelId: string;
+}
+interface CloseChannelResponse {
+    channelId: string;
+    txHash?: string;
+    /** Unix SECONDS when close was initiated. */
+    closedAt: string;
+    /** Unix SECONDS the channel becomes settleable (closedAt + settlementTimeout). */
+    settleableAt: string;
+}
+/** `POST /channels/settle` — release collateral after the grace period (step 2). */
+interface SettleChannelRequest {
+    channelId: string;
+}
+interface SettleChannelResponse {
+    channelId: string;
+    txHash?: string;
+}
 /**
  * `POST /swap` — pay asset A to a swap peer, receive asset B + a signed
  * target-chain claim. The daemon builds the NIP-59 gift-wrapped kind:20032 swap
@@ -509,6 +533,8 @@ declare class ControlClient {
     channels(): Promise<ChannelsResponse>;
     balances(): Promise<BalancesResponse>;
     depositToChannel(body: ChannelDepositRequest): Promise<ChannelDepositResponse>;
+    closeChannel(body: CloseChannelRequest): Promise<CloseChannelResponse>;
+    settleChannel(body: SettleChannelRequest): Promise<SettleChannelResponse>;
     swap(body: SwapRequest): Promise<SwapResponse>;
     httpFetchPaid(body: HttpFetchPaidRequest): Promise<HttpFetchPaidResponse>;
     targets(): Promise<TargetsResponse>;
@@ -933,6 +959,18 @@ interface ToonClientLike {
         txHash?: string;
         depositTotal: string;
     }>;
+    closeChannel(channelId: string): Promise<{
+        channelId: string;
+        txHash?: string;
+        closedAt: string;
+        settleableAt: string;
+    }>;
+    settleChannel(channelId: string): Promise<{
+        channelId: string;
+        txHash?: string;
+    }>;
+    getChannelCloseState(channelId: string): 'open' | 'closing' | 'settleable' | 'settled';
+    getSettleableAt(channelId: string): bigint | undefined;
     sendSwapPacket(params: {
         destination: string;
         amount: bigint;
@@ -1154,6 +1192,16 @@ declare class ClientRunner {
      * the client signs its own on-chain tx.
      */
     depositToChannel(req: ChannelDepositRequest): Promise<ChannelDepositResponse>;
+    /** Close a channel to begin the settlement grace period (withdraw, step 1). */
+    closeChannel(req: CloseChannelRequest): Promise<CloseChannelResponse>;
+    /**
+     * Settle a closed channel to release collateral (withdraw, step 2). The client
+     * enforces the `now >= settleableAt` guard and throws a retryable error if
+     * called early; `mapError` maps that to HTTP 425.
+     */
+    settleChannel(req: SettleChannelRequest): Promise<SettleChannelResponse>;
+    /** Run `fn` against the apex client that tracks `channelId`, else throw. */
+    private withTrackingApex;
     /** Swap source→target asset against a swap peer via the selected apex. */
     swap(req: SwapRequest): Promise<SwapResponse>;
     /**
@@ -1346,4 +1394,4 @@ interface JourneyResult {
  */
 declare function runJourney(plan: JourneyPlan, client: ControlClient): Promise<JourneyResult>;
 
-export { type AddApexRequest, type AddApexResponse, type AddRelayRequest, type ApexNegotiationConfig, type ApexTargetStatus, type BalanceInfo, type BalancesResponse, type ChainStatus, type ChannelDepositRequest, type ChannelDepositResponse, type ChannelInfo, type ChannelsResponse, ClientRunner, type ClientRunnerDeps, ControlApiError, ControlClient, type ControlClientOptions, DEFAULT_KEYSTORE_PASSWORD, type DaemonConfigFile, DaemonUnreachableError, type DrainResult, type ErrorResponse, type EventsQuery, type EventsResponse, type FundWalletRequest, type FundWalletResponse, type HttpFetchPaidRequest, type HttpFetchPaidResponse, type JourneyPlan, type JourneyResult, type JourneyState, type JourneyStep, type JourneyStepResult, type MinimalWebSocket, type NostrFilter, NotReadyError, type OpenChannelRequest, PublishRejectedError, type PublishRequest, type PublishResponse, type PublishUnsignedRequest, type QueryRequest, type QueryResponse, RelaySubscription, type RelaySubscriptionOptions, type RelayTargetStatus, type RemoveApexRequest, type RemoveRelayRequest, type ResolvedDaemonConfig, type SettlementChain, type StatusResponse, type SubscribeRequest, type SubscribeResponse, type SwapClaim, type SwapRequest, type SwapResponse, TOOL_DEFINITIONS, type TargetsResponse, type ToolDefinition, type ToolResult, type ToonClientLike, type UploadMediaRequest, type UploadMediaResponse, type WebSocketFactory, acquireLock, configDir, defaultConfigPath, defaultKeystorePath, dispatchTool, hasConfiguredIdentity, isDaemonRunning, isProcessAlive, readConfigFile, readPid, registerRoutes, releaseLock, resolveConfig, resolveMnemonic, runJourney, scaffoldFirstRun, spawnDaemonDetached, waitForReady };
+export { type AddApexRequest, type AddApexResponse, type AddRelayRequest, type ApexNegotiationConfig, type ApexTargetStatus, type BalanceInfo, type BalancesResponse, type ChainStatus, type ChannelDepositRequest, type ChannelDepositResponse, type ChannelInfo, type ChannelsResponse, ClientRunner, type ClientRunnerDeps, type CloseChannelRequest, type CloseChannelResponse, ControlApiError, ControlClient, type ControlClientOptions, DEFAULT_KEYSTORE_PASSWORD, type DaemonConfigFile, DaemonUnreachableError, type DrainResult, type ErrorResponse, type EventsQuery, type EventsResponse, type FundWalletRequest, type FundWalletResponse, type HttpFetchPaidRequest, type HttpFetchPaidResponse, type JourneyPlan, type JourneyResult, type JourneyState, type JourneyStep, type JourneyStepResult, type MinimalWebSocket, type NostrFilter, NotReadyError, type OpenChannelRequest, PublishRejectedError, type PublishRequest, type PublishResponse, type PublishUnsignedRequest, type QueryRequest, type QueryResponse, RelaySubscription, type RelaySubscriptionOptions, type RelayTargetStatus, type RemoveApexRequest, type RemoveRelayRequest, type ResolvedDaemonConfig, type SettleChannelRequest, type SettleChannelResponse, type SettlementChain, type StatusResponse, type SubscribeRequest, type SubscribeResponse, type SwapClaim, type SwapRequest, type SwapResponse, TOOL_DEFINITIONS, type TargetsResponse, type ToolDefinition, type ToolResult, type ToonClientLike, type UploadMediaRequest, type UploadMediaResponse, type WebSocketFactory, acquireLock, configDir, defaultConfigPath, defaultKeystorePath, dispatchTool, hasConfiguredIdentity, isDaemonRunning, isProcessAlive, readConfigFile, readPid, registerRoutes, releaseLock, resolveConfig, resolveMnemonic, runJourney, scaffoldFirstRun, spawnDaemonDetached, waitForReady };

package/dist/index.js

@@ -8,7 +8,7 @@ import {
   hasConfiguredIdentity,
   registerRoutes,
   scaffoldFirstRun
-} from "./chunk-ZIJNTR5Y.js";
+} from "./chunk-557ZV5RR.js";
 import {
   PUBLISH_TOOL,
   TOOL_DEFINITIONS,
@@ -18,7 +18,7 @@ import {
   buildFollowListFilter,
   buildProfileFilter,
   dispatchTool
-} from "./chunk-KWQKOCE4.js";
+} from "./chunk-3K5LWGQL.js";
 import {
   ControlApiError,
   ControlClient,
@@ -36,7 +36,7 @@ import {
   resolveMnemonic,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5Z74D23J.js";
+} from "./chunk-BO5F3VT5.js";
 import "./chunk-32QD72IL.js";
 import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";

package/dist/mcp.js

@@ -4,7 +4,7 @@ import {
   APP_RESOURCE_URI,
   TOOL_DEFINITIONS,
   dispatchTool
-} from "./chunk-KWQKOCE4.js";
+} from "./chunk-3K5LWGQL.js";
 import {
   ControlClient,
   defaultConfigPath,
@@ -12,7 +12,7 @@ import {
   readConfigFile,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-5Z74D23J.js";
+} from "./chunk-BO5F3VT5.js";
 import "./chunk-32QD72IL.js";
 import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toon-protocol/client-mcp",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Always-on local daemon + MCP server letting a Claude agent (Desktop or Code) act as a TOON Protocol client: pay-to-write publishing, free reads, channel/balance management, and swaps.",
   "license": "MIT",
   "author": "Jonathan Green",
@@ -49,8 +49,8 @@
     "typescript": "^5.3.0",
     "vitest": "^1.0.0",
     "@toon-protocol/arweave": "0.1.1",
-    "@toon-protocol/client": "0.14.7",
-    "@toon-protocol/views": "0.10.0"
+    "@toon-protocol/client": "0.14.8",
+    "@toon-protocol/views": "0.10.2"
   },
   "engines": {
     "node": ">=20"