@absol-labs/agent 0.9.1 → 0.10.0

package/dist/cli/commands/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../../../src/cli/commands/streams.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/watch.d.ts

@@ -0,0 +1,3 @@
+import type { CommandSpec } from "../context.js";
+export declare const watchCommand: CommandSpec;
+//# sourceMappingURL=watch.d.ts.map

package/dist/cli/commands/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAkB,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjE,eAAO,MAAM,YAAY,EAAE,WAyD1B,CAAC"}

package/dist/cli/commands/watch.js

@@ -0,0 +1,55 @@
+import { integerFlag } from "../args.js";
+import { assertTestnetRpc, parseBytes32 } from "../config.js";
+import { describeError, usageError } from "../errors.js";
+import { readStreamReport, streamReportJson, streamReportRows, } from "../status.js";
+const DEFAULT_INTERVAL_SECONDS = 15;
+export const watchCommand = {
+    name: "watch",
+    summary: "Poll a stream's verified accrual until it is closed (Ctrl-C to stop)",
+    usage: "metrik watch <streamId> [--interval 15] [--max-polls N (default: unbounded)]",
+    flags: ["interval", "max-polls"],
+    signs: false,
+    async run(context) {
+        const { args, config, out, deps } = context;
+        const [streamIdArg] = args.positionals;
+        if (streamIdArg === undefined) {
+            throw usageError("metrik watch requires a <streamId>");
+        }
+        const streamId = parseBytes32(streamIdArg, "<streamId>");
+        const interval = integerFlag(args, "interval") ?? DEFAULT_INTERVAL_SECONDS;
+        if (interval <= 0) {
+            throw usageError("--interval must be a positive number of seconds");
+        }
+        const maxPolls = integerFlag(args, "max-polls");
+        const read = deps.createReadClient(config);
+        // Same chain allowlist as the signing paths — see `status`.
+        await assertTestnetRpc(config, () => read.getChainId());
+        out.note(`watching ${streamId} every ${interval}s — the oracle checkpoints roughly every 15-22s.`);
+        for (let poll = 0; maxPolls === undefined || poll < maxPolls; poll++) {
+            if (poll > 0)
+                await deps.sleep(interval * 1_000);
+            let report;
+            try {
+                report = await readStreamReport(read, streamId, deps.nowSeconds());
+            }
+            catch (error) {
+                // A transient RPC blip must not end a long watch.
+                out.note(`read failed, retrying: ${describeError(error)}`);
+                continue;
+            }
+            // `--json` streams one COMPACT JSON object per poll — JSON Lines, as the
+            // docs promise. The pretty-printed form used by the single-shot commands
+            // would put one object across ~30 lines, none of which parses on its own,
+            // which is useless to the line-at-a-time consumer this mode exists for.
+            out.resultLine(streamReportJson(report));
+            out.print(`[${new Date(report.nowSeconds * 1000).toISOString()}] ${streamId}`);
+            out.table(streamReportRows(report));
+            out.print("");
+            if (report.stream.status === "closed") {
+                out.note("stream is closed — watch complete.");
+                return;
+            }
+        }
+    },
+};
+//# sourceMappingURL=watch.js.map

package/dist/cli/commands/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"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"}

package/dist/cli/config.d.ts

@@ -0,0 +1,61 @@
+import { baseSepolia } from "viem/chains";
+import { type ParsedArgs } from "./args.js";
+/**
+ * TESTNET ONLY — the single allowlist this CLI will settle against.
+ *
+ * Metrik's escrow moves real USDC the moment it is pointed at a mainnet chain,
+ * and this CLI signs with a raw private key read from the environment. So the
+ * chain is an allowlist, not a default: any other chain id is refused outright,
+ * with no override flag. There is deliberately no `--allow-mainnet` — an escape
+ * hatch that re-enables real funds would defeat the guarantee, and a mainnet
+ * deployment is not something a flag can conjure (there is none).
+ *
+ * The allowlist is enforced TWICE: once against the configured/declared chain
+ * id, and again against the chain id the RPC endpoint actually reports before
+ * any fund-moving command signs anything (see `assertTestnetRpc`). The second
+ * check is what stops `--chain-id 84532 --rpc-url <a mainnet RPC>`.
+ */
+export declare const TESTNET_CHAIN_IDS: readonly number[];
+/**
+ * The block `BASE_SEPOLIA_ESCROW_V2` was deployed at — the anchor of every
+ * escrow log scan, because the contract has no history before it.
+ *
+ * Verified against Base Sepolia on 2026-09-17: `eth_getLogs` for this single
+ * block returns 6 escrow logs (the deployment's own events). History is
+ * immutable, so that is a stable known answer forever, which is what lets the
+ * same block serve as the log-retention canary in `metrik streams`.
+ *
+ * It is tied to that ONE address. A run pointed at a different `--escrow` has
+ * no anchor and must be given `--from-block`, rather than silently scanning
+ * from a block that means nothing for it.
+ */
+export declare const BASE_SEPOLIA_ESCROW_V2_DEPLOY_BLOCK = 45892018n;
+export interface CliConfig {
+    readonly chain: typeof baseSepolia;
+    readonly chainId: number;
+    readonly rpcUrl: string;
+    readonly escrow: `0x${string}`;
+    readonly usdc: `0x${string}`;
+    readonly oracleBaseUrl: string;
+    readonly registryUrl: string;
+}
+/**
+ * Resolves settlement configuration from flags, then env, then the baked-in
+ * Base Sepolia defaults — so `metrik discover` works with nothing configured at
+ * all, while every value stays overridable.
+ */
+export declare function resolveConfig(args: ParsedArgs, env: NodeJS.ProcessEnv): CliConfig;
+/** Flags every command accepts for settlement configuration. */
+export declare const CONFIG_FLAGS: readonly string[];
+/** Flags every command accepts for output shape. */
+export declare const GLOBAL_FLAGS: readonly string[];
+export declare function assertTestnetChainId(chainId: number, source: string): void;
+/**
+ * Second half of the testnet guard: the chain the RPC ACTUALLY serves. Called
+ * before any command that can move funds, because a declared chain id is just a
+ * number the caller typed — the endpoint is the thing that settles.
+ */
+export declare function assertTestnetRpc(config: CliConfig, readChainId: () => Promise<number>): Promise<void>;
+/** Parses a `0x`-prefixed 32-byte hex id (stream id / serviceRef). */
+export declare function parseBytes32(value: string, label: string): `0x${string}`;
+//# sourceMappingURL=config.d.ts.map

package/dist/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAqB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mCAAmC,YAAc,CAAC;AAE/D,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,WAAW,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,SAAS,CA2CX;AAED,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAOzC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAqB,CAAC;AAEhE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ1E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,WAAW,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC,CAkBf;AA6CD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,MAAM,EAAE,CAKxE"}

package/dist/cli/config.js

@@ -0,0 +1,140 @@
+import { BASE_SEPOLIA_ESCROW_V2, BASE_SEPOLIA_USDC, DEFAULT_ORACLE_BASE_URL, DEFAULT_PUBLIC_REGISTRY_URL, } from "@absol-labs/sdk";
+import { isAddress, getAddress } from "viem";
+import { baseSepolia } from "viem/chains";
+import { CliError, configError, usageError } from "./errors.js";
+import { stringFlag, integerFlag } from "./args.js";
+/**
+ * TESTNET ONLY — the single allowlist this CLI will settle against.
+ *
+ * Metrik's escrow moves real USDC the moment it is pointed at a mainnet chain,
+ * and this CLI signs with a raw private key read from the environment. So the
+ * chain is an allowlist, not a default: any other chain id is refused outright,
+ * with no override flag. There is deliberately no `--allow-mainnet` — an escape
+ * hatch that re-enables real funds would defeat the guarantee, and a mainnet
+ * deployment is not something a flag can conjure (there is none).
+ *
+ * The allowlist is enforced TWICE: once against the configured/declared chain
+ * id, and again against the chain id the RPC endpoint actually reports before
+ * any fund-moving command signs anything (see `assertTestnetRpc`). The second
+ * check is what stops `--chain-id 84532 --rpc-url <a mainnet RPC>`.
+ */
+export const TESTNET_CHAIN_IDS = [baseSepolia.id];
+/**
+ * The block `BASE_SEPOLIA_ESCROW_V2` was deployed at — the anchor of every
+ * escrow log scan, because the contract has no history before it.
+ *
+ * Verified against Base Sepolia on 2026-09-17: `eth_getLogs` for this single
+ * block returns 6 escrow logs (the deployment's own events). History is
+ * immutable, so that is a stable known answer forever, which is what lets the
+ * same block serve as the log-retention canary in `metrik streams`.
+ *
+ * It is tied to that ONE address. A run pointed at a different `--escrow` has
+ * no anchor and must be given `--from-block`, rather than silently scanning
+ * from a block that means nothing for it.
+ */
+export const BASE_SEPOLIA_ESCROW_V2_DEPLOY_BLOCK = 45892018n;
+/**
+ * Resolves settlement configuration from flags, then env, then the baked-in
+ * Base Sepolia defaults — so `metrik discover` works with nothing configured at
+ * all, while every value stays overridable.
+ */
+export function resolveConfig(args, env) {
+    const chainId = integerFlag(args, "chain-id") ??
+        parseEnvChainId(env.METRIK_AGENT_CHAIN_ID) ??
+        baseSepolia.id;
+    assertTestnetChainId(chainId, "the configured chain id");
+    const rpcUrl = stringFlag(args, "rpc-url") ??
+        env.METRIK_AGENT_RPC_URL ??
+        baseSepolia.rpcUrls.default.http[0];
+    if (rpcUrl === undefined || !isHttpUrl(rpcUrl)) {
+        throw configError(`RPC URL must be an http(s) URL (got "${rpcUrl ?? "undefined"}")`, "set --rpc-url or METRIK_AGENT_RPC_URL.");
+    }
+    return {
+        chain: baseSepolia,
+        chainId,
+        rpcUrl,
+        escrow: resolveAddress(stringFlag(args, "escrow") ?? env.METRIK_AGENT_ESCROW, BASE_SEPOLIA_ESCROW_V2, "escrow"),
+        usdc: resolveAddress(stringFlag(args, "usdc") ?? env.METRIK_AGENT_USDC, BASE_SEPOLIA_USDC, "usdc"),
+        oracleBaseUrl: resolveHttpUrl(stringFlag(args, "oracle-url") ?? env.METRIK_AGENT_ORACLE_URL, DEFAULT_ORACLE_BASE_URL, "oracle-url"),
+        registryUrl: resolveHttpUrl(stringFlag(args, "registry-url") ?? env.METRIK_AGENT_REGISTRY_URL, DEFAULT_PUBLIC_REGISTRY_URL, "registry-url"),
+    };
+}
+/** Flags every command accepts for settlement configuration. */
+export const CONFIG_FLAGS = [
+    "chain-id",
+    "rpc-url",
+    "escrow",
+    "usdc",
+    "oracle-url",
+    "registry-url",
+];
+/** Flags every command accepts for output shape. */
+export const GLOBAL_FLAGS = ["json", "help"];
+export function assertTestnetChainId(chainId, source) {
+    if (TESTNET_CHAIN_IDS.includes(chainId))
+        return;
+    throw configError(`refusing to run against chain ${chainId}: ${source} is not a supported testnet`, `this CLI signs with a raw private key and settles real value, so it is testnet-only. Supported: ${TESTNET_CHAIN_IDS.join(", ")} (Base Sepolia). There is no override flag.`);
+}
+/**
+ * Second half of the testnet guard: the chain the RPC ACTUALLY serves. Called
+ * before any command that can move funds, because a declared chain id is just a
+ * number the caller typed — the endpoint is the thing that settles.
+ */
+export async function assertTestnetRpc(config, readChainId) {
+    let observed;
+    try {
+        observed = await readChainId();
+    }
+    catch (error) {
+        throw new CliError(`could not read the chain id from ${config.rpcUrl}`, {
+            exitCode: 3,
+            hint: "the RPC endpoint must be reachable before a fund-moving command runs.",
+            cause: error,
+        });
+    }
+    assertTestnetChainId(observed, `the RPC endpoint ${config.rpcUrl}`);
+    if (observed !== config.chainId) {
+        throw configError(`RPC chain id ${observed} does not match the configured chain id ${config.chainId}`, "point --rpc-url at the configured chain, or fix --chain-id.");
+    }
+}
+function parseEnvChainId(raw) {
+    if (raw === undefined || raw.length === 0)
+        return undefined;
+    if (!/^\d+$/.test(raw)) {
+        throw configError(`METRIK_AGENT_CHAIN_ID must be a positive integer (got "${raw}")`);
+    }
+    return Number(raw);
+}
+function resolveAddress(candidate, fallback, label) {
+    if (candidate === undefined || candidate.length === 0)
+        return fallback;
+    if (!isAddress(candidate)) {
+        throw configError(`--${label} must be an EVM address (got "${candidate}")`);
+    }
+    return getAddress(candidate);
+}
+function resolveHttpUrl(candidate, fallback, label) {
+    if (candidate === undefined || candidate.length === 0)
+        return fallback;
+    if (!isHttpUrl(candidate)) {
+        throw configError(`--${label} must be an http(s) URL (got "${candidate}")`);
+    }
+    return candidate.replace(/\/+$/, "");
+}
+function isHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "http:" || url.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+/** Parses a `0x`-prefixed 32-byte hex id (stream id / serviceRef). */
+export function parseBytes32(value, label) {
+    if (!/^0x[0-9a-fA-F]{64}$/.test(value)) {
+        throw usageError(`${label} must be a 0x-prefixed 32-byte hex value`);
+    }
+    return value.toLowerCase();
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"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"}

package/dist/cli/context.d.ts

@@ -0,0 +1,29 @@
+import type { ParsedArgs } from "./args.js";
+import type { CliConfig } from "./config.js";
+import type { CliDependencies } from "./deps.js";
+import type { Printer } from "./output.js";
+/** Everything a command needs, assembled once by the runner. */
+export interface CommandContext {
+    readonly args: ParsedArgs;
+    readonly config: CliConfig;
+    readonly env: NodeJS.ProcessEnv;
+    readonly out: Printer;
+    readonly deps: CliDependencies;
+}
+export interface CommandSpec {
+    readonly name: string;
+    readonly summary: string;
+    readonly usage: string;
+    /** Command-specific flags, on top of the global + config flags. */
+    readonly flags: readonly string[];
+    /** True when the command broadcasts a transaction that can move funds. */
+    readonly signs: boolean;
+    /**
+     * True when the command needs `METRIK_AGENT_PRIVATE_KEY` even though it
+     * broadcasts nothing — `invoke` signs an off-chain capability. Defaults to
+     * `signs`, since everything that broadcasts obviously needs a key.
+     */
+    readonly requiresKey?: boolean;
+    readonly run: (context: CommandContext) => Promise<void>;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D"}

package/dist/cli/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":""}

package/dist/cli/deps.d.ts

@@ -0,0 +1,145 @@
+import { type CheckpointProof, type HireComputeInput, type HireComputeResult, type HireTxPreview, type StreamV2, type StreamProofTransactionResult } from "@absol-labs/sdk";
+import { type LocalAccount } from "viem";
+import { type DiscoverResult, type DiscoverServicesOptions, type ServiceListing } from "../discovery/registry.js";
+import { type InvokeOptions, type InvokeResult, type InvokeServiceInput, type InvokeStreamReader } from "../sdk/invoke.js";
+import { type MandateAuthorizedStreamActionInput, type OpenVerifiedStreamInput, type ReclaimAuthorizedStreamInput, type ReclaimVerifiedStreamResult } from "../sdk/client.js";
+import type { CliConfig } from "./config.js";
+/**
+ * Everything the CLI touches that is not pure computation, behind one
+ * injectable surface. Commands are written against these interfaces so the test
+ * suite exercises the real argument parsing, config resolution, testnet guard,
+ * retry logic and rendering against doubles — without a key, an RPC, or a
+ * single transaction.
+ */
+export interface CliReadClient {
+    /** The chain id the RPC endpoint actually serves (half of the testnet guard). */
+    getChainId(): Promise<number>;
+    getStreamV2(streamId: `0x${string}`): Promise<StreamV2>;
+    /**
+     * The ONLY live reading of accrual. `StreamEscrowV2.getStream` reports
+     * `claimedCumulative = 0` and `settledCumulative = 0` for a stream's entire
+     * active life — `settledCumulative` is written by `reclaim`, not by accrual —
+     * so a status command that reads a stream field would always print zero. The
+     * oracle's checkpoint proof carries the real earned-so-far figure.
+     */
+    checkpointProof(streamId: `0x${string}`): Promise<CheckpointProof>;
+    claimableForV2(streamId: `0x${string}`, cumulativeAmount: bigint): Promise<bigint>;
+    reclaimableForV2(streamId: `0x${string}`, cumulativeAmount: bigint): Promise<bigint>;
+    /** Live protocol fee, read from the escrow rather than hardcoded. */
+    protocolFeeBps(): Promise<number>;
+    /**
+     * `StreamEscrowV2.escapeGraceSeconds` (public immutable). The buyer's no-proof
+     * escape hatch unlocks at `expiresAt + escapeGraceSeconds`, so this is half of
+     * every readiness answer the CLI gives about it.
+     */
+    escapeGraceSeconds(): Promise<number>;
+    /**
+     * `StreamEscrowV2.latestCheckpointCheckedAt` — how far the oracle has
+     * published. A buyer reading "the last checkpoint is two hours old" is reading
+     * the reason their proof-based reclaim is blocked.
+     */
+    latestCheckpointCheckedAt(): Promise<number>;
+    /**
+     * `StreamEscrowV2.getOracleSigners` — every address whose signature can carry
+     * a checkpoint into the escrow.
+     *
+     * Read so the CLI can say who attests. A buyer told a listing is
+     * "cryptographically verified" is entitled to know whether the operator they
+     * are about to pay is ALSO one of the parties attesting that the delivery
+     * happened; on the live deployment that overlap exists. Disclosure only — the
+     * CLI does not refuse such a listing, it names the fact.
+     */
+    oracleSigners(): Promise<readonly `0x${string}`[]>;
+    /**
+     * The timestamp of the latest block. The escape hatch is gated on
+     * `block.timestamp`, not on the caller's clock, so readiness is answered
+     * against the chain rather than against a laptop that may be skewed.
+     */
+    latestBlockTimestamp(): Promise<number>;
+    /**
+     * Native balance of an address, in wei. Read before a fund-moving command so
+     * an unfunded wallet is reported as an unfunded wallet, rather than as the
+     * raw node error `gas required exceeds allowance (0)`.
+     */
+    nativeBalance(address: `0x${string}`): Promise<bigint>;
+    /**
+     * USDC balance of an address, in base units. Gas and deposit are SEPARATE
+     * balances, so `assertCanPayGas` passing says nothing about whether the hire
+     * can be funded — see `assertCanFundStream`.
+     */
+    usdcBalance(address: `0x${string}`): Promise<bigint>;
+    /** Current chain head, the upper bound of every log scan. */
+    blockNumber(): Promise<bigint>;
+    /**
+     * `StreamOpened` logs for one indexed party over one inclusive block window.
+     *
+     * `buyer` and `operator` are INDEXED on the event, so `role` becomes an
+     * `eth_getLogs` topic filter the NODE evaluates: the response carries only
+     * that wallet's streams regardless of how wide the window is. What bounds a
+     * window is the endpoint's per-call BLOCK RANGE cap, not the response size —
+     * see `./scan-range.ts`.
+     */
+    streamOpenedLogs(query: StreamOpenedQuery): Promise<readonly OpenedStream[]>;
+    /**
+     * Count of ANY escrow log in a single block. Used as a known-answer retention
+     * canary: a node that has pruned its log index answers a range it no longer
+     * retains with a SUCCESSFUL EMPTY result, so an empty scan is only honest
+     * from an endpoint that demonstrably still serves the oldest block in range.
+     */
+    escrowLogCountAt(block: bigint): Promise<number>;
+}
+/** One indexed party filter over one inclusive block window. */
+export interface StreamOpenedQuery {
+    readonly role: "buyer" | "operator";
+    readonly address: `0x${string}`;
+    readonly fromBlock: bigint;
+    readonly toBlock: bigint;
+}
+/** The immutable facts `StreamOpened` carries, which later state cannot restate. */
+export interface OpenedStream {
+    readonly streamId: `0x${string}`;
+    readonly buyer: `0x${string}`;
+    readonly operator: `0x${string}`;
+    readonly serviceRef: `0x${string}`;
+    /**
+     * The amount originally escrowed. V2 MUTATES `Stream.deposit` on reclaim, so
+     * the event is the only place the opening figure survives.
+     */
+    readonly deposit: bigint;
+    readonly ratePerSecond: bigint;
+    readonly expiresAt: number;
+    readonly blockNumber: bigint;
+}
+export interface CliWriteClient {
+    /** Build + best-effort simulate the hire WITHOUT broadcasting (`--dry-run`). */
+    buildHireTx(input: HireComputeInput): Promise<HireTxPreview>;
+    openVerifiedStream(input: OpenVerifiedStreamInput): Promise<HireComputeResult>;
+    closeStream(input: MandateAuthorizedStreamActionInput): Promise<StreamProofTransactionResult>;
+    reclaimStream(input: ReclaimAuthorizedStreamInput): Promise<ReclaimVerifiedStreamResult>;
+    /**
+     * The no-proof escape hatch. Separate from {@link reclaimStream} because it is
+     * a different transaction with a different outcome, not a mode of the same one
+     * — see `VerifiedStreamAgentClient.reclaimUnverifiedStream`.
+     */
+    reclaimUnverifiedStream(input: MandateAuthorizedStreamActionInput): Promise<StreamProofTransactionResult>;
+    /** Operator-only: redeem the verified-earned balance for a stream. */
+    claimStream(input: MandateAuthorizedStreamActionInput): Promise<StreamProofTransactionResult>;
+}
+export interface CliDependencies {
+    readonly createReadClient: (config: CliConfig) => CliReadClient;
+    /**
+     * `account` is nullable because `open --dry-run` broadcasts nothing and must
+     * work for someone who has no key yet. Without one the SDK still builds the
+     * calldata and simply reports that the allowance read and simulation were
+     * skipped; every fund-moving method throws rather than inventing a signer.
+     */
+    readonly createWriteClient: (config: CliConfig, account: LocalAccount | null) => CliWriteClient;
+    readonly discover: (options: DiscoverServicesOptions) => Promise<DiscoverResult>;
+    readonly invoke: (streamId: `0x${string}`, request: InvokeServiceInput, options: InvokeOptions) => Promise<InvokeResult>;
+    readonly createInvokeStreamReader: (config: CliConfig) => InvokeStreamReader;
+    readonly nowSeconds: () => number;
+    readonly sleep: (ms: number) => Promise<void>;
+}
+export declare const defaultCliDependencies: CliDependencies;
+export type { DiscoverResult, ServiceListing };
+//# sourceMappingURL=deps.d.ts.map

package/dist/cli/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../src/cli/deps.ts"],"names":[],"mappings":"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"}