@candledottv/agent-sdk 0.6.3 → 0.6.5

package/dist/index.js

@@ -2035,18 +2035,55 @@ function perpsCandleWindow(opts, now) {
     return usage(`interval must be one of ${PERPS_CANDLE_INTERVALS.join(" ")}.`);
   const count = bounded(opts.count, 100, 1, 5000, "count");
   const raw = opts.end;
-  const endTime = raw === undefined ? now : typeof raw === "number" || /^\d+$/.test(raw) ? Number(raw) : /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/.test(raw) ? Date.parse(raw) : NaN;
+  const endTime = raw === undefined ? now : epoch(raw);
   const startTime = endTime - count * at(INTERVAL_MS, index);
   if (!Number.isSafeInteger(endTime) || endTime < 0 || endTime > now || startTime < 0)
     return usage("end must be an ISO 8601 time or epoch milliseconds, no later than now.");
   return { interval, count, startTime, endTime };
 }
+function epoch(raw) {
+  return typeof raw === "number" || /^\d+$/.test(raw) ? Number(raw) : /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$/.test(raw) ? Date.parse(raw) : NaN;
+}
+var PERPS_FUNDING_HISTORY_MAX_MS = 30 * 86400000;
+var PERPS_FUNDING_HISTORY_MAX_ROWS = 500;
+function perpsFundingWindow(opts, now) {
+  const endTime = opts.end === undefined ? now : epoch(opts.end);
+  if (!Number.isSafeInteger(endTime) || endTime < 0 || endTime > now)
+    return usage("end must be an ISO 8601 time or epoch milliseconds, no later than now.");
+  const startTime = opts.start === undefined ? endTime - 86400000 : epoch(opts.start);
+  if (!Number.isSafeInteger(startTime) || startTime < 0 || startTime > endTime)
+    return usage("start must be an ISO 8601 time or epoch milliseconds, no later than end.");
+  if (endTime - startTime > PERPS_FUNDING_HISTORY_MAX_MS)
+    return usage("start must be at most 30 days before end.");
+  return { startTime, endTime };
+}
 function bounded(value, fallback, min, max, name) {
   const n = value ?? fallback;
   if (!Number.isInteger(n) || n < min || n > max)
     return usage(`${name} must be an integer from ${min} to ${max}.`);
   return n;
 }
+function parsePerpsFundingHistory(value, coin, window) {
+  if (!Array.isArray(value))
+    return unavailable();
+  const funding = [];
+  for (const row of value) {
+    if (!object(row) || row.coin !== coin || !integer(row.time) || !decimal2(row.fundingRate) || !decimal2(row.premium))
+      return unavailable();
+    if (row.time >= window.startTime && row.time <= window.endTime)
+      funding.push({
+        time: row.time,
+        fundingRate: row.fundingRate,
+        fundingAprPct: fixed(scaled(row.fundingRate) * 876000n, 2),
+        premium: row.premium
+      });
+  }
+  funding.sort((a, b) => a.time - b.time);
+  return {
+    funding: funding.slice(0, PERPS_FUNDING_HISTORY_MAX_ROWS),
+    truncated: funding.length > PERPS_FUNDING_HISTORY_MAX_ROWS
+  };
+}
 
 class PerpsMarketReader {
   opts;
@@ -2324,6 +2361,44 @@ class PerpsMarketReader {
       candles: candles.slice(-window.count)
     };
   }
+  async fundingHistory(coin, opts = {}) {
+    this.key();
+    const window = perpsFundingWindow(opts, this.now());
+    const [config, core] = await Promise.all([this.config(), this.core()]);
+    const canonical2 = at(core.universe, resolve(core, coin)).name;
+    const value = await info(this.opts.fetcher, this.opts.network, {
+      type: "fundingHistory",
+      coin: canonical2,
+      startTime: window.startTime,
+      endTime: window.endTime
+    });
+    return {
+      ...this.envelope(config),
+      coin: canonical2,
+      startTime: window.startTime,
+      endTime: window.endTime,
+      ...parsePerpsFundingHistory(value, canonical2, window)
+    };
+  }
+  async predictedFunding() {
+    this.key();
+    const [config, core, extras] = await Promise.all([this.config(), this.core(), this.extras()]);
+    if (extras.predicted === null)
+      return unavailable();
+    const predicted = [];
+    for (const meta of core.universe) {
+      const row = extras.predicted.get(meta.name);
+      if (row)
+        predicted.push({
+          coin: meta.name,
+          fundingRate: row.fundingRate,
+          fundingAprPct: fixed(scaled(row.fundingRate) * 876000n, 2),
+          nextFundingTime: row.nextFundingTime
+        });
+    }
+    predicted.sort((a, b) => a.coin < b.coin ? -1 : a.coin > b.coin ? 1 : 0);
+    return { ...this.envelope(config, extras.warnings, this.extrasCache?.at ?? this.now()), predicted };
+  }
 }
 
 // src/hyperliquid-risk.ts
@@ -3087,7 +3162,6 @@ var CANDLE_PERPS_WITHDRAW_PINS = {
   depositories: ["0x66cf0aace1b4e562593bec10ec7868fba9932224"],
   amountForm: "fixed6"
 };
-var RELAY_API_URL = "https://api.relay.link";
 var ZERO = "0x0000000000000000000000000000000000000000";
 var EVM_ADDRESS_RE2 = /^0x[0-9a-fA-F]{40}$/;
 var BYTES32_RE = /^0x[0-9a-fA-F]{64}$/;
@@ -3184,8 +3258,10 @@ function verifyWithdrawMapping(build, expect) {
     return refuse("the NonceMapping wallet is not this key's account");
   if (!sameEvm(message.depositor, expect.account))
     return refuse("the NonceMapping depositor is not this key's account");
-  if (typeof message.id !== "string" || !BYTES32_RE.test(message.id) || message.id !== build.relayRequestId)
-    return refuse("the NonceMapping names another Relay request");
+  if (typeof build.relayOrderId !== "string" || !BYTES32_RE.test(build.relayOrderId))
+    return refuse("the build has no Relay order id");
+  if (typeof message.id !== "string" || !BYTES32_RE.test(message.id) || message.id !== build.relayOrderId)
+    return refuse("the NonceMapping names another Relay order");
   if (message.nonce !== build.nonce || !Number.isSafeInteger(build.nonce) || build.nonce <= 0)
     return refuse("the NonceMapping nonce is not the build's");
   return { ok: true };
@@ -3232,24 +3308,6 @@ function verifyWithdrawSendAsset(authorization, expect) {
   }
   return { ok: true };
 }
-async function relayRecipientProblem(fetchImpl, requestId, recipient, relayUrl = RELAY_API_URL) {
-  let body;
-  try {
-    const res = await fetchImpl(`${relayUrl}/requests/v3?id=${encodeURIComponent(requestId)}`, { method: "GET" });
-    if (!res.ok)
-      return `Relay's record of the request could not be read (HTTP ${res.status})`;
-    body = await res.json();
-  } catch (error) {
-    return `Relay's record of the request could not be read (${error instanceof Error ? error.message : "unknown"})`;
-  }
-  const requests = isObject(body) && Array.isArray(body.requests) ? body.requests : [];
-  const match = requests.find((r) => isObject(r) && r.id === requestId);
-  if (!isObject(match))
-    return "Relay does not list this request";
-  const named = match.recipient;
-  const same = recipient.startsWith("0x") ? sameEvm(named, recipient) : named === recipient;
-  return same ? null : `Relay's request pays ${String(named)}, not this key's wallet ${recipient}`;
-}
 
 // src/internal/rpc-endpoint.ts
 function describeRpcEndpoint(url) {
@@ -4167,15 +4225,59 @@ class CandleClient {
   }
   async previewCloseEmptyAccounts(req = {}) {
     this.requireKey("previewCloseEmptyAccounts()");
-    return this.requestJson("POST", "/api/v1/agent/wallets/embedded/close-empty/preview", req);
+    const { wallet, ...body } = req;
+    return this.requestJson("POST", wallet === undefined ? "/api/v1/agent/wallets/embedded/close-empty/preview" : `/api/v1/agent/wallets/${encodeURIComponent(wallet)}/close-empty/preview`, body);
   }
   async closeEmptyAccounts(req) {
     this.requireKey("closeEmptyAccounts()");
-    return this.requestJson("POST", "/api/v1/agent/wallets/embedded/close-empty", req);
+    const { wallet, privyWalletId, ...body } = req;
+    if (wallet === undefined)
+      return this.requestJson("POST", "/api/v1/agent/wallets/embedded/close-empty", body);
+    if (!privyWalletId)
+      throw new Error("closeEmptyAccounts() with a TEE wallet requires privyWalletId: the same wallet's Privy wallet id, which signLinkedTransaction() signs for");
+    const base = `/api/v1/agent/wallets/${encodeURIComponent(wallet)}/close-empty`;
+    const build = await this.requestJson("POST", `${base}/build`, body);
+    if (build.status === "nothing_to_close")
+      return {
+        closed: [],
+        signatures: [],
+        lamportsRecovered: "0",
+        solRecovered: "0",
+        feeLamports: "0",
+        netLamports: "0",
+        netSol: "0",
+        failed: [],
+        unattempted: [],
+        notClosed: [],
+        skipped: [],
+        remaining: 0,
+        ...build
+      };
+    if (build.submitState !== undefined) {
+      const job = await this.getCloseEmptyAccountsJob(req.clientTradeId, { wallet });
+      const status = job.httpStatus ?? 200;
+      if (status >= 400)
+        throw candleApiErrorFromResponse(status, JSON.stringify(job.result ?? {}));
+      return job.result;
+    }
+    const signed = [];
+    for (const transaction of build.transactions) {
+      const result = await this.signLinkedTransaction({
+        chain: "solana",
+        linkedWalletId: wallet,
+        privyWalletId,
+        unsignedTransactionBase64: transaction.unsignedTransaction
+      });
+      signed.push({ index: transaction.index, signedTransaction: result.signedTransaction });
+    }
+    return this.requestJson("POST", `${base}/submit`, {
+      clientTradeId: req.clientTradeId,
+      signed
+    });
   }
-  async getCloseEmptyAccountsJob(clientTradeId) {
+  async getCloseEmptyAccountsJob(clientTradeId, opts = {}) {
     this.requireKey("getCloseEmptyAccountsJob()");
-    const body = await this.requestJson("GET", `/api/v1/agent/wallets/embedded/close-empty/jobs/${encodeURIComponent(clientTradeId)}`);
+    const body = await this.requestJson("GET", opts.wallet === undefined ? `/api/v1/agent/wallets/embedded/close-empty/jobs/${encodeURIComponent(clientTradeId)}` : `/api/v1/agent/wallets/${encodeURIComponent(opts.wallet)}/close-empty/jobs/${encodeURIComponent(clientTradeId)}`);
     return body.job;
   }
   async importWallet(params) {
@@ -4533,6 +4635,10 @@ class CandleClient {
     const body = { ...req, clientLaunchId };
     return this.runOperation({ clientLaunchId }, "server-executed", (op) => this.postAtomicBuild(body, clientLaunchId, op));
   }
+  async dryRunAtomicLaunch(req) {
+    this.requireKey("dryRunAtomicLaunch()");
+    return this.requestJson("POST", "/api/v1/launch/atomic/dry-run", req);
+  }
   async postAtomicBuild(body, clientLaunchId, op) {
     const built = await this.requestJson("POST", "/api/v1/launch/atomic/build", body, op);
     return { ...built, clientLaunchId };
@@ -4965,7 +5071,8 @@ class CandleClient {
       asset: params.asset,
       amountRaw: params.amountRaw,
       ...params.perpsWalletId !== undefined ? { perpsWalletId: params.perpsWalletId } : {},
-      ...params.maxSlippageBps !== undefined ? { maxSlippageBps: params.maxSlippageBps } : {}
+      ...params.maxSlippageBps !== undefined ? { maxSlippageBps: params.maxSlippageBps } : {},
+      ...params.submit === false ? { preview: true } : {}
     });
     if (build.job !== undefined)
       throw new Error(`perpsDeposit(): ${params.clientDepositId} already names a deposit; read it with perpsDepositStatus()`);
@@ -4974,6 +5081,8 @@ class CandleClient {
       throw new Error(`perps: refused to sign this deposit: ${problem}`);
     if (params.submit === false)
       return { build, submitted: false, result: null };
+    if (build.preview === true || build.depositId === undefined)
+      throw new Error("perps: refused to sign this deposit: the API answered a preview, not a build");
     const submitPath = "/api/v1/agent/perps/deposit/submit";
     const ids = { clientDepositId: params.clientDepositId, depositId: build.depositId };
     if (build.chain === "solana") {
@@ -5192,9 +5301,6 @@ class CandleClient {
     });
     if (!mapping.ok)
       throw new Error(`perpsWithdraw: refused to sign this withdrawal: ${mapping.reason}`);
-    const recipient = await relayRecipientProblem(this.fetchImpl, build.relayRequestId, build.to.address);
-    if (recipient)
-      throw new Error(`perpsWithdraw: refused to sign this withdrawal: ${recipient}`);
     const mappingSignature = await this.signLinkedTypedData({
       linkedWalletId: params.walletId,
       privyWalletId: params.privyWalletId,
@@ -5452,7 +5558,7 @@ function generateClientLaunchId() {
 function generateClientTradeId() {
   return generateSdkId();
 }
-var SDK_VERSION = "0.6.3";
+var SDK_VERSION = "0.6.5";
 var sdkUpdateWarned = false;
 function noteLatestSdkVersion(value) {
   if (sdkUpdateWarned || !value || !/^\d+\.\d+\.\d+$/.test(value))
@@ -5650,6 +5756,188 @@ function planTableMarkdown(table) {
   return [line(headers), line(headers.map(() => "---")), ...rows.map(line)].join(`
 `);
 }
+// src/quant.ts
+var QUANT_AGENT_PATH = "/api/v1/agent/quant";
+var QUANT_CALL_TIMEOUT_MS = 5000;
+var QUANT_POLL_TIMEOUT_MS = 35000;
+var QUANT_DEFAULT_MAX_TEXT_CHARS = 4000;
+function quantCodePoints(text) {
+  let n = 0;
+  for (const _ of text)
+    n++;
+  return n;
+}
+function newClientTurnId() {
+  return crypto.randomUUID();
+}
+function quantRefusalCode(body) {
+  const record = asRecord(body);
+  if (typeof record?.code === "string")
+    return record.code;
+  const inner = asRecord(record?.error);
+  return typeof inner?.code === "string" ? inner.code : undefined;
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function refusalOf(status, body) {
+  const record = asRecord(body) ?? {};
+  const relayCode = typeof record.code === "string" ? record.code : undefined;
+  const code = quantRefusalCode(body) ?? `HTTP_${status}`;
+  const refusal = { code, status, shape: relayCode !== undefined ? "relay" : "envelope" };
+  if (typeof record.retryable === "boolean")
+    refusal.retryable = record.retryable;
+  if (typeof record.resetsAt === "string" || typeof record.resetsAt === "number")
+    refusal.resetsAt = record.resetsAt;
+  if (typeof record.turnId === "string")
+    refusal.turnId = record.turnId;
+  if (typeof record.limit === "number")
+    refusal.limit = record.limit;
+  return refusal;
+}
+function parseStatus(body) {
+  const b = asRecord(body);
+  if (typeof b?.enabled !== "boolean")
+    return;
+  const status = { enabled: b.enabled };
+  if (typeof b.allowed === "boolean")
+    status.allowed = b.allowed;
+  if (typeof b.tier === "string" || b.tier === null)
+    status.tier = b.tier;
+  if (typeof b.marketAccess === "boolean")
+    status.marketAccess = b.marketAccess;
+  if (typeof b.linked === "boolean")
+    status.linked = b.linked;
+  if (typeof b.remaining === "number" || b.remaining === null)
+    status.remaining = b.remaining;
+  if (typeof b.maxTextChars === "number" || b.maxTextChars === null)
+    status.maxTextChars = b.maxTextChars;
+  if (typeof b.activeTurnId === "string" || b.activeTurnId === null)
+    status.activeTurnId = b.activeTurnId;
+  return status;
+}
+function parseTurn(body) {
+  const b = asRecord(body);
+  if (typeof b?.turnId !== "string" || b.turnId.length === 0)
+    return;
+  return { turnId: b.turnId, ...typeof b.cursor === "number" ? { cursor: b.cursor } : {} };
+}
+function parseEvents(body) {
+  const b = asRecord(body);
+  if (!b || !Array.isArray(b.events) || typeof b.next !== "number" || typeof b.status !== "string")
+    return;
+  const events = [];
+  for (const raw of b.events) {
+    const e = asRecord(raw);
+    if (typeof e?.seq !== "number" || typeof e.kind !== "string")
+      continue;
+    events.push({
+      seq: e.seq,
+      kind: e.kind,
+      data: asRecord(e.data) ?? {},
+      ...typeof e.createdAt === "string" ? { createdAt: e.createdAt } : {}
+    });
+  }
+  return { events, next: b.next, status: b.status };
+}
+function parseHistory(body) {
+  const b = asRecord(body);
+  if (!b || !Array.isArray(b.items))
+    return;
+  const items = [];
+  for (const raw of b.items) {
+    const item = asRecord(raw);
+    if (typeof item?.id !== "string" || typeof item.text !== "string")
+      continue;
+    if (item.role !== "user" && item.role !== "assistant")
+      continue;
+    items.push({
+      id: item.id,
+      role: item.role,
+      text: item.text,
+      createdAt: typeof item.createdAt === "string" ? item.createdAt : ""
+    });
+  }
+  return { items, next: typeof b.next === "string" ? b.next : null };
+}
+function createQuantKeyClient(options) {
+  const base = new URL(options.apiUrl);
+  const local = base.hostname === "localhost" || base.hostname === "127.0.0.1" || base.hostname === "[::1]";
+  if (base.protocol !== "https:" && !(base.protocol === "http:" && local)) {
+    throw new Error("Quant needs an https API URL: the key would otherwise travel in clear.");
+  }
+  const root = base.toString().replace(/\/+$/, "");
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const callMs = options.callTimeoutMs ?? QUANT_CALL_TIMEOUT_MS;
+  const pollMs = options.pollTimeoutMs ?? QUANT_POLL_TIMEOUT_MS;
+  async function call(method, path, parse, opts) {
+    const controller = new AbortController;
+    let timedOut = false;
+    const timer = setTimeout(() => {
+      timedOut = true;
+      controller.abort();
+    }, opts.timeoutMs);
+    const onAbort = () => controller.abort();
+    opts.signal?.addEventListener("abort", onAbort, { once: true });
+    try {
+      const response = await doFetch(`${root}${QUANT_AGENT_PATH}${path}`, {
+        method,
+        redirect: "error",
+        signal: controller.signal,
+        headers: {
+          "x-api-key": options.apiKey,
+          accept: "application/json",
+          ...opts.body !== undefined ? { "content-type": "application/json" } : {}
+        },
+        ...opts.body !== undefined ? { body: JSON.stringify(opts.body) } : {}
+      });
+      let body;
+      try {
+        body = await response.json();
+      } catch {
+        body = undefined;
+      }
+      if (!response.ok)
+        return { ok: false, refusal: refusalOf(response.status, body) };
+      const parsed = parse(body);
+      if (parsed === undefined) {
+        return { ok: false, refusal: { code: "BAD_RESPONSE", status: response.status, shape: "transport" } };
+      }
+      return { ok: true, status: response.status, body: parsed };
+    } catch {
+      return {
+        ok: false,
+        refusal: { code: timedOut ? "TIMEOUT" : "NETWORK_ERROR", status: 0, shape: "transport", retryable: true }
+      };
+    } finally {
+      clearTimeout(timer);
+      opts.signal?.removeEventListener("abort", onAbort);
+    }
+  }
+  const turnPath = (turnId) => `/turns/${encodeURIComponent(turnId)}`;
+  return {
+    status: () => call("GET", "/status", parseStatus, { timeoutMs: callMs }),
+    sendTurn: (input) => call("POST", "/turns", parseTurn, {
+      body: { text: input.text, clientTurnId: input.clientTurnId },
+      timeoutMs: callMs
+    }),
+    events: (turnId, after, opts) => call("GET", `${turnPath(turnId)}/events?after=${Math.max(0, Math.floor(after))}`, parseEvents, {
+      timeoutMs: pollMs,
+      ...opts?.signal ? { signal: opts.signal } : {}
+    }),
+    cancel: (turnId) => call("POST", `${turnPath(turnId)}/cancel`, (body) => asRecord(body) ?? {}, { timeoutMs: callMs }),
+    history: (input = {}) => {
+      const query = new URLSearchParams;
+      if (input.before !== undefined)
+        query.set("before", input.before);
+      if (input.limit !== undefined)
+        query.set("limit", String(input.limit));
+      const encoded = query.toString();
+      const suffix = encoded ? `?${encoded}` : "";
+      return call("GET", `/history${suffix}`, parseHistory, { timeoutMs: callMs });
+    }
+  };
+}
 // src/file-lock.ts
 var STALE_MS = 30000;
 var RETRY_MS = 25;
@@ -5815,10 +6103,11 @@ export {
   verifyWebhookSignature,
   verifyPerpsBuildAgainstVenue,
   verifyPerpsBuild,
-  relayRecipientProblem,
   readPerpsRisk,
   readPerpsHistoryPage,
   readHyperliquidMarkets,
+  quantRefusalCode,
+  quantCodePoints,
   planTableRows,
   planTableMarkdown,
   planPromotionLine,
@@ -5828,11 +6117,14 @@ export {
   perpsRiskExitCode,
   perpsPortfolioSection,
   perpsMarketGate,
+  perpsFundingWindow,
   perpsDepositProblem,
   perpsCandleWindow,
   parseWithdrawAmount,
   parseSendAssetAmount,
+  parsePerpsFundingHistory,
   operationIds,
+  newClientTurnId,
   isSolanaRpcErrorData,
   hyperliquidWalletSnapshot,
   hyperliquidRiskReport,
@@ -5844,10 +6136,15 @@ export {
   formatPlanBps,
   encryptWalletKeyForImport,
   effectivePerpsRisk,
+  createQuantKeyClient,
   TradeLegOutcomeError,
   TradeLandedUnconfirmedError,
   TradeLandedFeeLegError,
   SelfLaunchOutcomeError,
+  QUANT_POLL_TIMEOUT_MS,
+  QUANT_DEFAULT_MAX_TEXT_CHARS,
+  QUANT_CALL_TIMEOUT_MS,
+  QUANT_AGENT_PATH,
   PerpsWorkflowError,
   PerpsMarketReader,
   PerpsMarketError,
@@ -5856,6 +6153,8 @@ export {
   PLAN_CAPABILITY_LABELS,
   PERPS_HISTORY_MAX_LIMIT,
   PERPS_HISTORY_DEFAULT_LIMIT,
+  PERPS_FUNDING_HISTORY_MAX_ROWS,
+  PERPS_FUNDING_HISTORY_MAX_MS,
   PERPS_FLATTEN_MAX_STEPS,
   PERPS_CANDLE_INTERVALS,
   KeychainSecretStore,

package/dist/quant.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Quant over an agent key (BE-1678's `/api/v1/agent/quant/*`; spec S5 Q-2, BE-1737): a plain HTTP
+ * client for the five key routes, with the route spec's timing rules. It holds no state: the caller
+ * keeps the `clientTurnId`, the poll cursor and anything it shows.
+ *
+ *   GET  /status                     5 s
+ *   POST /turns {text, clientTurnId}  5 s   (resend the same `clientTurnId` after a lost answer)
+ *   GET  /turns/:id/events?after=    35 s  (one held poll, about 25 s on the server)
+ *   POST /turns/:id/cancel           5 s
+ *   GET  /history?before=&limit=     5 s
+ *
+ * A refusal is read as `body.code ?? body.error?.code`: the Quant handlers answer `{code, ...}` (the
+ * relay shape), the key middleware answers `{success: false, error: {code}}` (the envelope shape),
+ * and `RATE_LIMITED` comes in both, meaning different limits. `shape` says which one arrived.
+ *
+ * The key is sent as `x-api-key` and never follows a redirect (`redirect: "error"`), so it cannot be
+ * forwarded to another host. Use a Read key (`account:read`): Quant needs nothing more.
+ *
+ * Dependency-free on purpose. The CLI carries a byte-identical copy (`packages/cli/src/quant.ts`,
+ * kept equal by `quant.drift.test.ts`). Copy any change verbatim:
+ * `cp packages/sdk/src/quant.ts packages/cli/src/quant.ts`.
+ */
+export declare const QUANT_AGENT_PATH = "/api/v1/agent/quant";
+export declare const QUANT_CALL_TIMEOUT_MS = 5000;
+export declare const QUANT_POLL_TIMEOUT_MS = 35000;
+/** hacc's B0 figure, used until a status read says otherwise (the route's `DEFAULT_MAX_TEXT_CHARS`). */
+export declare const QUANT_DEFAULT_MAX_TEXT_CHARS = 4000;
+/** `GET /status`. With the switch off the route answers `{enabled: false}` and nothing else. */
+export interface QuantKeyStatus {
+    enabled: boolean;
+    allowed?: boolean;
+    tier?: string | null;
+    marketAccess?: boolean;
+    linked?: boolean;
+    remaining?: number | null;
+    maxTextChars?: number | null;
+    activeTurnId?: string | null;
+}
+export interface QuantTurnStarted {
+    turnId: string;
+    cursor?: number;
+}
+/** One event of a turn: `turn_started`, `working`, `tool_started`, `tool_finished`, `text`, `done`, `error`. */
+export interface QuantTurnEvent {
+    seq: number;
+    kind: string;
+    data: Record<string, unknown>;
+    createdAt?: string;
+}
+export interface QuantEventsPage {
+    events: QuantTurnEvent[];
+    next: number;
+    /** `running`, or the terminal state (`done`, `error`, `cancelled`, ...). */
+    status: string;
+}
+export interface QuantHistoryItem {
+    id: string;
+    role: "user" | "assistant";
+    text: string;
+    createdAt: string;
+}
+export interface QuantHistoryPage {
+    items: QuantHistoryItem[];
+    next: string | null;
+}
+/**
+ * Why a call did not succeed. `shape` is `relay` for `{code}`, `envelope` for `{error: {code}}`, and
+ * `transport` when no answer arrived (`NETWORK_ERROR`, `TIMEOUT`) or it could not be read
+ * (`BAD_RESPONSE`): a lost answer to `POST /turns` is safe to resend with the same `clientTurnId`.
+ */
+export interface QuantRefusal {
+    code: string;
+    status: number;
+    shape: "relay" | "envelope" | "transport";
+    retryable?: boolean;
+    resetsAt?: string | number;
+    turnId?: string;
+    limit?: number;
+}
+export type QuantAnswer<T> = {
+    ok: true;
+    status: number;
+    body: T;
+} | {
+    ok: false;
+    refusal: QuantRefusal;
+};
+export interface QuantKeyClientOptions {
+    apiUrl: string;
+    apiKey: string;
+    fetch?: typeof fetch;
+    callTimeoutMs?: number;
+    pollTimeoutMs?: number;
+}
+export interface QuantKeyClient {
+    status(): Promise<QuantAnswer<QuantKeyStatus>>;
+    sendTurn(input: {
+        text: string;
+        clientTurnId: string;
+    }): Promise<QuantAnswer<QuantTurnStarted>>;
+    events(turnId: string, after: number, options?: {
+        signal?: AbortSignal;
+    }): Promise<QuantAnswer<QuantEventsPage>>;
+    cancel(turnId: string): Promise<QuantAnswer<Record<string, unknown>>>;
+    history(input?: {
+        before?: string;
+        limit?: number;
+    }): Promise<QuantAnswer<QuantHistoryPage>>;
+}
+/** Unicode code points, the unit hacc counts `maxTextChars` in. */
+export declare function quantCodePoints(text: string): number;
+/** A `clientTurnId`: a uuid v4, kept with the draft until a `turnId` arrives. */
+export declare function newClientTurnId(): string;
+/** The refusal code of a body in either shape, or undefined when it names none. */
+export declare function quantRefusalCode(body: unknown): string | undefined;
+/** The key client. Refuses an `http://` API URL other than this machine's: the key would travel in clear. */
+export declare function createQuantKeyClient(options: QuantKeyClientOptions): QuantKeyClient;
+//# sourceMappingURL=quant.d.ts.map

package/dist/quant.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@candledottv/agent-sdk",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "TypeScript SDK for the Candle agent rail: typed headless launches, market reads, and webhook verification",
   "type": "module",
   "main": "./dist/index.js",