charness 3.0.0 → 3.2.0

package/dist/connectors/telegram/commands/fallbackChain.d.ts

@@ -0,0 +1,49 @@
+import type { SessionKey } from '../../../sessionKey';
+import { type FallbackChainEntry, type FallbackDetection } from '../../../utils/fallbackChain';
+import type { BotCore } from './botCore';
+/**
+ * How long opening the screen waits for the usage refresh (one poll is ~0.5 s). A slower one — a hung endpoint
+ * runs into the fetch's own 15 s timeout — keeps going in the background and the next render shows its result.
+ */
+export declare const limitsUsageRefreshBudgetMs = 2000;
+/**
+ * What the chain picker needs from the bot: the shared core, the detection of what is signed in, the topic's
+ * current position (to mark it and to skip it), the instance zone for the limit marks, and the switch a
+ * limit-notice button triggers.
+ */
+export interface FallbackChainPorts extends Pick<BotCore, 'bot' | 'command' | 'getState' | 'replyToThread' | 'editThreadMessage' | 'authoriseContext' | 'withThreadLocale' | 'checkIsGeneral'> {
+    getInstanceTimezone: () => string;
+    /**
+     * Bring the per-profile usage snapshots up to date (`utils/claudeUsageRefresher.ts`) for the usage block; never
+     * throws. Called when the screen is OPENED (bounded by {@link limitsUsageRefreshBudgetMs}), never on a tap.
+     */
+    refreshClaudeUsage: (options: {
+        maxAgeMs?: number;
+    }) => Promise<void>;
+    /** What is connected now: Claude profiles with usage, the OpenCode catalog, the recent picks, the limit marks. */
+    detectFallbackOptions: () => Promise<FallbackDetection>;
+    /** The rung the topic runs on now (its Claude profile + model, or its OpenCode provider/model); `null` for no agent. */
+    getTopicPosition: (key: SessionKey) => FallbackChainEntry | null;
+    /**
+     * A tap on a «switch to …» button of a usage-limit notice (`utils/fallbackChain.ts`): move the topic and
+     * continue its work. The confirmation the notice is edited into, or `null` when the tap is stale.
+     */
+    takeSwitchOffer: (key: SessionKey, episodeId: number, index: number) => Promise<string | null>;
+    /**
+     * Apply the «wait for the reset and continue» setting (`autoContinueLimits.ts`, which also drops an armed
+     * wait that the new value contradicts): `null` = a topic follows General again. The confirmation is ignored
+     * here — `/limits` words its own.
+     */
+    applyAutoContinue: (key: SessionKey, isGeneral: boolean, enabled: boolean | null) => Promise<string>;
+    /** The fire time of the limit wait armed for the topic, or `null` — the screen then offers «skip once». */
+    getArmedLimitRetryFireAt: (key: SessionKey) => number | null;
+}
+/** @description Build the `/limits` feature over its ports: the command (+ the hidden aliases), its buttons, the limit-notice switch button. */
+export declare function createFallbackChain(ports: FallbackChainPorts): {
+    registerFallbackChainCommands: () => void;
+    registerFallbackChainCallbacks: () => void;
+    openLimitsView: (key: SessionKey) => Promise<void>;
+    applyAutoSwitch: (key: SessionKey, isGeneral: boolean, enabled: boolean | null) => Promise<string>;
+    formatFallbackEntry: (entry: FallbackChainEntry) => string;
+};
+//# sourceMappingURL=fallbackChain.d.ts.map

package/dist/connectors/telegram/commands/fallbackChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackChain.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/commands/fallbackChain.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQtD,OAAO,EAmDL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;GAGG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAiChD;;;;GAIG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CACV,OAAO,EACP,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,gBAAgB,CACpI;IACD,mBAAmB,EAAE,MAAM,MAAM,CAAC;IAClC;;;OAGG;IACH,kBAAkB,EAAE,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,kHAAkH;IAClH,qBAAqB,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxD,wHAAwH;IACxH,gBAAgB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACjE;;;OAGG;IACH,eAAe,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/F;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrG,2GAA2G;IAC3G,wBAAwB,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,MAAM,GAAG,IAAI,CAAC;CAC9D;AASD,gJAAgJ;AAChJ,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB;yCAuTjB,IAAI;0CAkHH,IAAI;0BAxFZ,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC;2BAlDzB,UAAU,aAAa,OAAO,WAAW,OAAO,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,CAAC;iCAlRjF,kBAAkB,KAAG,MAAM;EA2iBxD"}