dsh-connect-minimaxcode 0.4.2 → 0.5.1

package/lib/client.js

@@ -18,7 +18,15 @@
     const BUNDLE_NAME = 'dsh-connect-minimaxcode';
     const NAMESPACE = 'dsh-connect-minimaxcode';
     const STATUS_PATH = '/plugins/dsh-connect-minimaxcode/status';
+    const ACTION_PATH = '/plugins/dsh-connect-minimaxcode/action';
     const POLL_INTERVAL_MS = 20000;
+    /**
+     * The provider id the host side registers with `llm.registerAdapter`.
+     *
+     * Duplicated here on purpose: this half is a classic script that cannot
+     * import the host's module, and the id is the one the projection reports.
+     */
+    const MINIMAX_PROVIDER_ID = 'minimaxcode';
     const zh = {
         title: 'MiniMax Code 积分',
         balance: '积分 {total}',
@@ -36,9 +44,28 @@
         expiringIn: '{amount} 积分 · {date} 到期',
         expiringNone: '7 天内没有积分到期',
         expiringSoon: '30 天内到期 {amount} 积分',
-        nextExpiry: '最近一笔到期',
+        nextExpiry: '最近到期日',
         lots: '到期批次',
         noLots: '没有待到期的积分批次',
+        loginTitle: '登录',
+        loginPlugin: '已在插件内登录',
+        loginDesktop: '使用 MiniMax Code 桌面 App 的登录态',
+        loginSignedOut: '未登录',
+        loginPending: '等待你在浏览器里确认',
+        loginCode: '设备码',
+        loginOpen: '打开授权页面',
+        loginPolled: '我已授权，检查一下',
+        loginStart: '登录 MiniMax Code',
+        signinTitle: '每日签到',
+        signinToday: '第 {day} 天 · {points} 积分',
+        signinClaimed: '今日已签到',
+        signinClaimable: '今日可签到',
+        signinUnavailable: '签到信息不可用',
+        signinCycle: '一轮共 {points} 积分',
+        signinLast: '上次签到 {day}，{points} 积分',
+        signinAuto: '每天自动签到',
+        signinClaim: '签到',
+        claimableToday: '今日可签到',
     };
     const en = {
         title: 'MiniMax Code credits',
@@ -60,6 +87,25 @@
         nextExpiry: 'Next expiry',
         lots: 'Expiring grants',
         noLots: 'No grant is waiting to expire',
+        loginTitle: 'Sign-in',
+        loginPlugin: 'Signed in through the plugin',
+        loginDesktop: 'Using the MiniMax Code desktop app sign-in',
+        loginSignedOut: 'Not signed in',
+        loginPending: 'Waiting for you to confirm in the browser',
+        loginCode: 'Device code',
+        loginOpen: 'Open the authorization page',
+        loginPolled: 'I authorized it — check',
+        loginStart: 'Sign in to MiniMax Code',
+        signinTitle: 'Daily check-in',
+        signinToday: 'Day {day} · {points} credits',
+        signinClaimed: 'Claimed today',
+        signinClaimable: 'Claimable today',
+        signinUnavailable: 'Check-in information unavailable',
+        signinCycle: '{points} credits per cycle',
+        signinLast: 'Last claim on {day}, {points} credits',
+        signinAuto: 'Claim daily on its own',
+        signinClaim: 'Claim',
+        claimableToday: 'Claimable today',
     };
     const loader = globalThis.__ModuleLoader__;
     if (loader === undefined)
@@ -144,7 +190,7 @@
             function useStatus() {
                 const [status, setStatus] = React.useState(undefined);
                 React.useEffect(() => subscribe(setStatus), []);
-                return status;
+                return [status, () => { void load(); }];
             }
             /** A row of label and value. */
             function row(label, value) {
@@ -162,9 +208,9 @@
                     ? row(t('expiringSoon', { amount: credits(credits_.expiringSoon, 2) }), '')
                     : null, next !== undefined ? row(t('nextExpiry'), day(next)) : null);
             }
-            /** The pill in the composer's dock. */
+            /** The pill itself; the gate decides whether it is drawn at all. */
             function CreditPill(props) {
-                const status = useStatus();
+                const [status] = useStatus();
                 const [open, setOpen] = React.useState(false);
                 const t = props.t ?? ((key, params) => {
                     const template = zh[key] ?? key;
@@ -192,6 +238,107 @@
                     onClick: () => setOpen(!open),
                 }, label), open ? detail : null);
             }
+            /**
+             * The pill, only while this plugin's own provider is selected.
+             *
+             * The balance belongs to the provider the next request will actually
+             * use, so another connector's model means this balance is the wrong
+             * number to show: the gate hides the readout and — because the pill is
+             * the only subscriber — the polling stops with it. The projection comes
+             * from the host's own `modelSelection`, which is what the model picker
+             * writes, so the readout cannot disagree with the model in effect.
+             *
+             * A host without the projection, or a session where the picker has not
+             * chosen yet, keeps the pill: "I do not know" must not hide a balance
+             * that is true either way.
+             */
+            function CreditPillGate(props) {
+                const projection = props.useProjection?.('modelSelection');
+                const provider = (projection?.next ?? projection?.lastUsed)?.provider;
+                if (provider !== undefined && provider !== MINIMAX_PROVIDER_ID)
+                    return null;
+                return h(CreditPill, props);
+            }
+            /** Ask the host to do something, and let the card read the result. */
+            async function act(action, body) {
+                try {
+                    await fetch(`${ACTION_PATH}?action=${encodeURIComponent(action)}`, {
+                        method: 'POST',
+                        headers: { 'content-type': 'application/json' },
+                        body: JSON.stringify(body ?? {}),
+                    });
+                }
+                catch {
+                    // The card shows the state the host reports; a failed request is
+                    // reported there too.
+                }
+                // Read the state the host produced, so the card shows what happened.
+                void load();
+            }
+            /**
+             * The sign-in block.
+             *
+             * The plugin can sign in on its own: the person authorizes in their own
+             * browser, and the plugin never sees a password. When the desktop app
+             * is already signed in, that credential is used and this block says so.
+             */
+            function loginBlock(t, login, refresh) {
+                if (login === undefined)
+                    return null;
+                if (login.state === 'signed-in') {
+                    return h('div', { style: sectionBoxStyle, 'data-minimax-login': true }, row(t('loginTitle'), login.source === 'plugin' ? t('loginPlugin') : t('loginDesktop')));
+                }
+                if (login.state === 'pending') {
+                    return h('div', { style: sectionBoxStyle, 'data-minimax-login': true }, row(t('loginTitle'), t('loginPending')), login.userCode !== undefined && login.userCode.length > 0
+                        ? row(t('loginCode'), login.userCode)
+                        : null, login.verificationUriComplete !== undefined && login.verificationUriComplete.length > 0
+                        ? h('a', {
+                            href: login.verificationUriComplete,
+                            target: '_blank',
+                            rel: 'noreferrer',
+                            style: linkStyle,
+                        }, t('loginOpen'))
+                        : null, h('button', { type: 'button', style: actionButtonStyle, onClick: () => { void act('login-poll'); } }, t('loginPolled')));
+                }
+                return h('div', { style: sectionBoxStyle, 'data-minimax-login': true }, row(t('loginTitle'), t('loginSignedOut')), h('button', { type: 'button', style: actionButtonStyle, onClick: () => { void act('login-start'); } }, t('loginStart')));
+            }
+            /**
+             * The check-in block.
+             *
+             * The cycle is seven days; the card shows which day it is and what the
+             * day is worth, and lets the person claim it — or leave it to the
+             * plugin, once a day, and only when the server says the day can be
+             * claimed.
+             */
+            function signinBlock(t, signin, refresh) {
+                if (signin === undefined)
+                    return null;
+                return h('div', { style: sectionBoxStyle, 'data-minimax-signin': true }, h('div', { style: sectionTitleStyle }, t('signinTitle')), signin.today === undefined
+                    ? h('div', { style: mutedStyle }, t('signinUnavailable'))
+                    : h('div', { style: rowStyle }, h('span', null, t('signinToday', { day: signin.today.dayNo, points: signin.today.points })), h('span', null, signin.today.claimed ? t('signinClaimed') : signin.today.claimable ? t('signinClaimable') : t('signinUnavailable'))), (signin.days ?? []).length === 0
+                    ? null
+                    : h('div', { style: dayRowStyle }, ...(signin.days ?? []).map(day_ => h('span', {
+                        key: `day-${day_.dayNo}`,
+                        title: `${day_.dayNo}: ${day_.points}`,
+                        style: {
+                            ...dayDotStyle,
+                            ...day_.isToday ? dayTodayStyle : {},
+                            ...day_.status === 3 ? dayClaimedStyle : {},
+                        },
+                    }, String(day_.dayNo)))), signin.cyclePoints !== undefined
+                    ? h('div', { style: mutedStyle }, t('signinCycle', { points: signin.cyclePoints }))
+                    : null, signin.lastClaimDay !== undefined
+                    ? h('div', { style: mutedStyle }, t('signinLast', { day: signin.lastClaimDay, points: signin.lastClaimPoints ?? 0 }))
+                    : null, h('div', { style: rowStyle }, h('label', { style: checkboxStyle }, h('input', {
+                    type: 'checkbox',
+                    checked: signin.autoCheckin === true,
+                    onChange: (event) => {
+                        void act('settings', { autoCheckin: event.target?.checked === true });
+                    },
+                }), h('span', null, t('signinAuto'))), signin.today?.claimable === true
+                    ? h('button', { type: 'button', style: actionButtonStyle, onClick: () => { void act('claim'); } }, t('signinClaim'))
+                    : null), signin.error !== undefined ? h('div', { style: mutedStyle }, signin.error) : null);
+            }
             /**
              * The card on the plugin's own page.
              *
@@ -199,29 +346,31 @@
              * is the full card, where the expiry detail belongs.
              */
             function PluginPage(props) {
-                const status = useStatus();
+                const [status, refresh] = useStatus();
                 const t = props.t ?? ((key, params) => {
                     const template = zh[key] ?? key;
                     return template.replace(/\{(\w+)\}/g, (_match, name) => String(params?.[name] ?? ''));
                 });
                 const credits_ = status?.credits;
                 const usage = status?.usage;
+                const signin = status?.signin;
+                const login = status?.login;
                 const available = credits_?.state === 'ok' && credits_.total !== undefined;
                 if (props.view === 'summary') {
                     if (!available)
                         return h('span', null, t('unavailable'));
                     return h('span', { 'data-minimax-credits-summary': true }, t('balance', { total: credits(credits_.total, 2) }), credits_.expiring !== undefined && credits_.expiring > 0
                         ? ` · ${t('expiringIn', { amount: credits(credits_.expiring, 2), date: day(credits_.nextExpiryAtMs) })}`
-                        : '');
+                        : '', signin?.today?.claimable === true ? ` · ${t('claimableToday')}` : '');
                 }
                 if (!available) {
-                    return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: rowStyle }, h('span', null, t('unavailable')), h('span', null, credits_?.state === 'expired' ? t('expired') : '')));
+                    return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: rowStyle }, h('span', null, t('unavailable')), h('span', null, credits_?.state === 'expired' ? t('expired') : '')), loginBlock(t, login, refresh));
                 }
-                return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: bigNumberStyle }, t('balance', { total: credits(credits_.total, 2) })), row(t('free'), credits(credits_.free, 3)), row(t('purchased'), credits(credits_.purchased, 3)), expiryBlock(t, credits_), h('div', { style: sectionTitleStyle }, t('lots')), (credits_.upcoming ?? []).length === 0
+                return h('div', { style: cardStyle, 'data-minimax-credits-card': true }, h('div', { style: cardTitleStyle }, t('title')), h('div', { style: bigNumberStyle }, t('balance', { total: credits(credits_.total, 2) })), row(t('free'), credits(credits_.free, 3)), row(t('purchased'), credits(credits_.purchased, 3)), expiryBlock(t, credits_), signinBlock(t, signin, refresh), h('div', { style: sectionTitleStyle }, t('lots')), (credits_.upcoming ?? []).length === 0
                     ? h('div', { style: mutedStyle }, t('noLots'))
                     : h('ul', { style: listStyle }, ...(credits_.upcoming ?? []).map((lot, index) => h('li', { key: `${lot.expireAtMs}-${index}`, style: rowStyle }, h('span', null, day(lot.expireAtMs)), h('span', null, credits(lot.amount, 2))))), usage !== undefined
                     ? h('div', { style: usageBoxStyle }, row(t('tokens', { count: tokens(usage.inputTokens + usage.outputTokens + usage.cacheReadTokens) }), ''), row(t('cost', { amount: money(usage.estimatedCny) }), ''), usage.requests > 0 ? row(t('requests', { count: usage.requests }), usage.lastModel ?? '') : null)
-                    : null, credits_.updatedAtMs !== undefined
+                    : null, loginBlock(t, login, refresh), credits_.updatedAtMs !== undefined
                     ? h('div', { style: mutedStyle }, t('updated', { time: new Date(credits_.updatedAtMs).toLocaleTimeString() }))
                     : null);
             }
@@ -283,6 +432,42 @@
             const sectionTitleStyle = { marginTop: '8px', fontWeight: 600 };
             const mutedStyle = { opacity: 0.7, fontSize: '12px' };
             const listStyle = { listStyle: 'none', margin: 0, padding: 0 };
+            const sectionBoxStyle = {
+                marginTop: '10px',
+                paddingTop: '8px',
+                borderTop: '1px solid var(--dsh-panel-border, currentColor)',
+                display: 'flex',
+                flexDirection: 'column',
+                gap: '6px',
+            };
+            const actionButtonStyle = {
+                appearance: 'none',
+                background: 'transparent',
+                border: '1px solid var(--dsh-panel-border, currentColor)',
+                borderRadius: '6px',
+                color: 'inherit',
+                cursor: 'pointer',
+                font: 'inherit',
+                fontSize: '12px',
+                padding: '2px 10px',
+                width: 'fit-content',
+            };
+            const linkStyle = { color: 'inherit', fontSize: '12px' };
+            const checkboxStyle = { display: 'inline-flex', alignItems: 'center', gap: '6px', fontSize: '12px' };
+            const dayRowStyle = { display: 'flex', gap: '6px', flexWrap: 'wrap' };
+            const dayDotStyle = {
+                display: 'inline-flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                width: '22px',
+                height: '22px',
+                borderRadius: '999px',
+                border: '1px solid var(--dsh-panel-border, currentColor)',
+                fontSize: '11px',
+                opacity: 0.6,
+            };
+            const dayTodayStyle = { opacity: 1, fontWeight: 600 };
+            const dayClaimedStyle = { background: 'var(--dsh-panel-border, currentColor)', opacity: 0.9 };
             const usageBoxStyle = {
                 marginTop: '8px',
                 paddingTop: '6px',
@@ -295,14 +480,17 @@
                     const context = ctx;
                     // Visible text goes through the host's locale service.
                     context.effect(() => context.locale.register(NAMESPACE, { zh, en }), `${BUNDLE_NAME}: locale`);
-                    // The composer dock is the strip under the input box, which is where
-                    // the host itself renders its activity and usage pills.
-                    context.slots.inject('conversation.composer.dock', () => context.slots.register({
-                        name: 'conversation.composer.dock',
+                    // The tool row to the left of the composer — beside the model
+                    // picker — rather than the ambient strip below it: the balance
+                    // belongs to the provider that is selected, so it sits where that
+                    // selection is made, and the gate hides it when another connector's
+                    // model is in effect.
+                    context.slots.inject('conversation.input.left', () => context.slots.register({
+                        name: 'conversation.input.left',
                         id: 'minimax-credits',
-                        order: 2,
+                        order: 4,
                         locale: NAMESPACE,
-                    }, CreditPill));
+                    }, CreditPillGate));
                     // The plugin's own page, keyed by the package name, where the
                     // balance and the expiry schedule are spelled out.
                     context.slots.inject('plugins.bundle.config', () => context.slots.register({

package/lib/index.d.ts

@@ -475,9 +475,306 @@ declare class UsageMeter {
   reset(): void;
 }
 //#endregion
+//#region src/credentials.d.ts
+/** The file the plugin's own credential lives in. */
+declare const PLUGIN_CREDENTIAL_FILENAME = ".minimaxcode-auth.json";
+/** The file the plugin's own settings and session live in. */
+declare const PLUGIN_STATE_FILENAME = ".minimaxcode-state.json";
+/** The credential the plugin obtained for itself. */
+interface PluginCredential {
+  /** The document's shape. */
+  schemaVersion: number;
+  /** The OAuth client the token was issued to. */
+  clientId: string;
+  /** The scopes the token carries. */
+  scopes: string[];
+  /** The audience the token was issued for. */
+  audience: string;
+  /** The `mmoat_` bearer token. */
+  accessToken: string;
+  /** The refresh token, when the server issued one. */
+  refreshToken?: string;
+  /** Expiry in milliseconds since the epoch. */
+  expiresAtMs?: number;
+  /** When the token was obtained, in milliseconds since the epoch. */
+  obtainedAtMs?: number;
+}
+/** A device login waiting for the person to authorize it. */
+interface DeviceLoginSession {
+  /** The device code the token endpoint is polled with. */
+  deviceCode: string;
+  /** The PKCE verifier that goes with the device code. */
+  codeVerifier: string;
+  /** The code the person types on the account page. */
+  userCode: string;
+  /** Where to authorize. */
+  verificationUri: string;
+  /** Where to authorize, with the code filled in. */
+  verificationUriComplete: string;
+  /** When the device code stops working, in milliseconds since the epoch. */
+  expiresAtMs: number;
+}
+/** The plugin's own settings. */
+interface PluginState {
+  /** The document's shape. */
+  schemaVersion: number;
+  /** Whether the plugin claims the daily grant on its own. */
+  autoCheckin: boolean;
+  /** The day the last claim happened, in the account's time zone. */
+  lastClaimDay?: string;
+  /** When the last claim happened, in milliseconds since the epoch. */
+  lastClaimAtMs?: number;
+  /** The points the last claim granted. */
+  lastClaimPoints?: number;
+  /** A device login waiting to be authorized. */
+  deviceLogin?: DeviceLoginSession;
+}
+/**
+ * The Harness home.
+ *
+ * The host resolves it the same way: the `DSH_HOME` environment variable when
+ * it is set, otherwise `~/.dsh`. The plugin resolves it on its own rather
+ * than importing the host's helper, so it also works in a plain command line
+ * where the host's packages are not installed.
+ */
+declare function dshHome(env?: NodeJS.ProcessEnv): string;
+/** Where the plugin's credential lives. */
+declare function pluginCredentialPath(env?: NodeJS.ProcessEnv): string;
+/** Where the plugin's state lives. */
+declare function pluginStatePath(env?: NodeJS.ProcessEnv): string;
+/** Read the plugin's own credential. */
+declare function readPluginCredential(env?: NodeJS.ProcessEnv): Promise<PluginCredential | undefined>;
+/** Write the plugin's own credential. */
+declare function writePluginCredential(credential: PluginCredential, env?: NodeJS.ProcessEnv): Promise<void>;
+/** Read the plugin's own state. */
+declare function readPluginState(env?: NodeJS.ProcessEnv): Promise<PluginState>;
+/** Write the plugin's own state. */
+declare function writePluginState(state: PluginState, env?: NodeJS.ProcessEnv): Promise<void>;
+//#endregion
+//#region src/login.d.ts
+/** The endpoint that issues device codes. */
+declare const DEVICE_CODE_PATH = "/oauth2/device/code";
+/** The device authorization grant type. */
+declare const DEVICE_CODE_GRANT = "urn:ietf:params:oauth:grant-type:device_code";
+/** How a device login is going. */
+type DeviceLoginState =
+/** The person has not authorized it yet. */
+{
+  state: 'pending';
+} |
+/** The authorization server asked the client to slow down. */
+{
+  state: 'slow-down';
+} |
+/** The device code expired before the person authorized it. */
+{
+  state: 'expired';
+  message?: string;
+} |
+/** The person declined. */
+{
+  state: 'denied';
+  message?: string;
+} |
+/** The grant arrived. */
+{
+  state: 'signed-in';
+  credential: PluginCredential;
+};
+/**
+ * Make a PKCE verifier and its S256 challenge.
+ *
+ * The verifier is 43 characters of base64url entropy, which is what RFC 7636
+ * asks for, and it never leaves this process.
+ */
+declare function makePkce(): {
+  verifier: string;
+  challenge: string;
+};
+/**
+ * Ask for a device code.
+ *
+ * @returns The session the person authorizes, or `undefined` when the server
+ *   would not issue one.
+ */
+declare function startDeviceLogin(region: MinimaxRegion, fetchImpl?: typeof fetch, now?: number): Promise<DeviceLoginSession | undefined>;
+/**
+ * Poll for the grant.
+ *
+ * The authorization server answers `400` while the person has not authorized
+ * yet, with `authorization_pending` in the body; that is a normal answer, not
+ * an error.
+ */
+declare function pollDeviceLogin(session: DeviceLoginSession, region: MinimaxRegion, fetchImpl?: typeof fetch, now?: number): Promise<DeviceLoginState>;
+/**
+ * Exchange the stored refresh token for a fresh access token.
+ *
+ * The authorization server rotates the refresh token, so the new pair
+ * replaces the old one wherever it is kept.
+ */
+declare function refreshPluginCredential(credential: PluginCredential, region: MinimaxRegion, fetchImpl?: typeof fetch, now?: number): Promise<PluginCredential>;
+//#endregion
+//#region src/signin.d.ts
+/** The claim endpoint. */
+declare const SIGNIN_CLAIM_PATH = "/minimax-cloud/api/v1/signin/claim";
+/** The cycle endpoint, which reports the panel. */
+declare const SIGNIN_PANEL_PATH = "/minimax-cloud/api/v1/signin/status";
+/** Per-day status, as the desktop app enumerates it. */
+declare const SIGNIN_DAY_STATUS: {
+  /** The day has not come yet. */
+  readonly upcoming: 1;
+  /** The day is today and can be claimed. */
+  readonly claimable: 2;
+  /** The day is claimed. */
+  readonly claimed: 3;
+  /** The day does not grant anything. */
+  readonly disabled: 4;
+};
+/** The status of one day in the cycle. */
+type SigninDayStatus = (typeof SIGNIN_DAY_STATUS)[keyof typeof SIGNIN_DAY_STATUS];
+/** How many days a cycle runs. */
+declare const SIGNIN_CYCLE_DAYS = 7;
+/** The outcome of a claim. */
+declare const SIGNIN_CLAIM_RESULT: {
+  /** The grant was credited. */
+  readonly credited: 1;
+  /** Today was already claimed; nothing was granted. */
+  readonly alreadyClaimed: 2;
+};
+/** The outcome of a claim. */
+type SigninClaimResult = (typeof SIGNIN_CLAIM_RESULT)[keyof typeof SIGNIN_CLAIM_RESULT];
+/** One day of the cycle. */
+interface SigninDay {
+  /** Which day of the cycle this is, 1 to 7. */
+  dayNo: number;
+  /** Points the day grants. */
+  points: number;
+  /** Extra points on top, when the day carries a bonus. */
+  bonusPoints: number;
+  /** The day's status. */
+  status: SigninDayStatus;
+  /** Whether this is today. */
+  isToday: boolean;
+}
+/** The cycle as the server reports it. */
+interface SigninPanel {
+  /** Which cycle the account is in. */
+  scene: number;
+  /** The days of the cycle. */
+  days: SigninDay[];
+}
+/** The result of claiming today's grant. */
+interface SigninClaim {
+  /** The server's identifier for the claim. */
+  claimId: string;
+  /** Whether the grant was credited or the day was already claimed. */
+  result: SigninClaimResult;
+  /** Which day of the cycle was claimed. */
+  dayNo: number;
+  /** Points granted. */
+  points: number;
+  /** Extra points granted. */
+  bonusPoints: number;
+  /** When the granted points expire, in milliseconds since the epoch. */
+  expireAtMs: number;
+  /** The cycle after the claim. */
+  panel?: SigninPanel;
+}
+/**
+ * The time zone the server should treat the request as coming from.
+ *
+ * The server wants an IANA name; an offset or a missing value is refused.
+ * The system's own name is the right answer, since "today" should be the
+ * user's today.
+ */
+declare function timezoneId(): string;
+/**
+ * Read the cycle out of a panel response.
+ *
+ * The server marks exactly one day as today and at most one day as claimable;
+ * a panel that says otherwise is not something to act on, so it is refused
+ * rather than half-believed.
+ */
+declare function parseSigninPanel(document: unknown): SigninPanel | undefined;
+/** Read the result of a claim. */
+declare function parseSigninClaim(document: unknown): SigninClaim | undefined;
+/**
+ * Read the cycle.
+ *
+ * @returns The panel, or `undefined` when the account cannot read it.
+ */
+declare function fetchSigninPanel(credential: OAuthCredential, region: MinimaxRegion, fetchImpl?: typeof fetch, timezone?: string): Promise<SigninPanel | undefined>;
+/**
+ * Claim today's grant.
+ *
+ * This is the only request in the plugin that changes something upstream. It
+ * grants the day's points, which expire thirty days later.
+ *
+ * @returns What the server answered, or `undefined` when it refused.
+ */
+declare function claimSignin(credential: OAuthCredential, region: MinimaxRegion, fetchImpl?: typeof fetch, timezone?: string): Promise<SigninClaim | undefined>;
+/** The day's key in the account's own time zone, `YYYY-MM-DD`. */
+declare function localDay(now?: number, timezone?: string): string;
+//#endregion
 //#region src/status-route.d.ts
 /** Route this plugin mounts, matching its settings card. */
 declare const MINIMAX_STATUS_PATH = "/plugins/dsh-connect-minimaxcode/status";
+/** Route the card posts to when it wants something done rather than read. */
+declare const MINIMAX_ACTION_PATH = "/plugins/dsh-connect-minimaxcode/action";
+/** The daily check-in, as the card reads it. */
+interface SigninStatus {
+  /** Whether the cycle could be read. */
+  state: 'ok' | 'unavailable';
+  /** Today's day in the cycle. */
+  today?: {
+    /** Which day of the cycle it is, 1 to 7. */
+    dayNo: number;
+    /** Points the day grants. */
+    points: number;
+    /** The day's status, as the upstream numbers it. */
+    status: number;
+    /** Whether the day can be claimed. */
+    claimable: boolean;
+    /** Whether the day is already claimed. */
+    claimed: boolean;
+  };
+  /** The days of the cycle. */
+  days?: {
+    dayNo: number;
+    points: number;
+    status: number;
+    isToday: boolean;
+  }[];
+  /** Points the whole cycle is worth. */
+  cyclePoints?: number;
+  /** Whether the plugin claims the day's grant on its own. */
+  autoCheckin: boolean;
+  /** The day the last claim happened. */
+  lastClaimDay?: string;
+  /** When the last claim happened, in milliseconds since the epoch. */
+  lastClaimAtMs?: number;
+  /** Points the last claim granted. */
+  lastClaimPoints?: number;
+  /** Whether the last claim was credited, or the day was already claimed. */
+  lastClaimResult?: number;
+  /** Why the cycle or the claim could not be read. */
+  error?: string;
+}
+/** How the plugin is signed in, as the card reads it. */
+interface LoginStatus {
+  /** Whether the plugin has a usable credential. */
+  state: 'signed-in' | 'signed-out' | 'pending';
+  /** Where the credential came from. */
+  source?: 'plugin' | 'desktop-app';
+  /** The code to type on the account page, while a sign-in is waiting. */
+  userCode?: string;
+  /** Where to authorize. */
+  verificationUri?: string;
+  /** Where to authorize, with the code filled in. */
+  verificationUriComplete?: string;
+  /** When the device code stops working, in milliseconds since the epoch. */
+  expiresAtMs?: number;
+}
 /** The account's credit balance, as the desktop app shows it. */
 interface CreditStatus {
   /** Whether the balance could be read. */
@@ -552,6 +849,10 @@ interface StatusDocument {
   credits?: CreditStatus;
   /** What this host's requests have used. */
   usage?: UsageStatus;
+  /** The daily check-in, when it could be read. */
+  signin?: SigninStatus;
+  /** How the plugin is signed in. */
+  login?: LoginStatus;
 }
 /** Inputs the document is derived from. */
 interface StatusDeps {
@@ -574,6 +875,10 @@ interface StatusDeps {
   credits?: CreditStatus;
   /** What this host's requests have used. */
   usage?: UsageStatus;
+  /** The daily check-in, when the account API could be reached. */
+  signin?: SigninStatus;
+  /** How the plugin is signed in. */
+  login?: LoginStatus;
 }
 /**
  * Build the card's status document.
@@ -646,4 +951,4 @@ declare const inject: string[];
  */
 declare function apply(ctx: Context): void;
 //#endregion
-export { type AuthState, type CatalogModel, type CatalogSource, type Credential, type CreditSummary, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, type MinimaxRegion, type ModelUsage, type OAuthCredential, type OAuthState, type StatusDocument, type TokenClaims, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, inject, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, priceFor, readCredential, readOAuthCredential, refreshOAuthCredential, statusDocument, writeOAuthCredential };
+export { type AuthState, type CatalogModel, type CatalogSource, type Credential, type CreditSummary, DEVICE_CODE_GRANT, DEVICE_CODE_PATH, type DeviceLoginState, EMPTY_USAGE, FALLBACK_MODELS, MEMBERSHIP_PATH, MINIMAXCODE_PROVIDER_ID, MINIMAX_ACTION_PATH, MINIMAX_AUTH_FILENAME, MINIMAX_DATA_DIR, MINIMAX_GATEWAYS, MINIMAX_OAUTH_CLIENT_ID, MINIMAX_REGIONS, MINIMAX_STATUS_PATH, MINIMAX_STREAM_IDLE_TIMEOUT_MS, MODEL_PRICES, MinimaxCatalog, MinimaxCredits, type MinimaxRegion, type ModelUsage, type OAuthCredential, type OAuthState, PLUGIN_CREDENTIAL_FILENAME, PLUGIN_STATE_FILENAME, type PluginCredential, type PluginState, SIGNIN_CLAIM_PATH, SIGNIN_CLAIM_RESULT, SIGNIN_CYCLE_DAYS, SIGNIN_DAY_STATUS, SIGNIN_PANEL_PATH, type SigninClaim, type SigninDay, type SigninPanel, type StatusDocument, type TokenClaims, UsageMeter, apply, authPath, bearerToken, catalogUrl, chatBaseUrl, claimSignin, createMinimaxCodeAdapter, dataDir, daysRemaining, decodeClaims, dshHome, ensureOAuthCredential, estimateCny, expiresInMs, expiryLevel, fetchCreditSummary, fetchSigninPanel, inject, localDay, makePkce, name, parseAuthDocument, parseCatalog, parseCreditSummary, parseOAuthDocument, parseSigninClaim, parseSigninPanel, pluginCredentialPath, pluginStatePath, pollDeviceLogin, priceFor, readCredential, readOAuthCredential, readPluginCredential, readPluginState, refreshOAuthCredential, refreshPluginCredential, startDeviceLogin, statusDocument, timezoneId, writeOAuthCredential, writePluginCredential, writePluginState };