dsh-connect-minimaxcode 0.6.8 → 0.7.0

package/lib/client.js

@@ -83,6 +83,26 @@
         usageRanking: '用量排名前 {percent}%',
         usageBestDay: '最活跃的一天 {date}',
         planNoSubscription: '未订阅 M Plan（仅积分包），因此没有限额窗口',
+        displayTitle: '显示',
+        showPill: '在对话输入框显示积分余额',
+        diagnosticsTitle: '诊断信息',
+        diagnosticsHint: '这一栏是只读的，可整段复制进 issue，它不会改变任何设置。',
+        diagnosticsPluginVersion: '插件版本',
+        diagnosticsRegion: '区域',
+        diagnosticsHosts: '上游地址',
+        diagnosticsAuthSource: '登录来源',
+        diagnosticsCatalogSource: '模型目录来源',
+        diagnosticsCapability: '宿主能力',
+        diagnosticsLastError: '最近一次上游错误',
+        failureCredentials: '登录凭据被拒绝。请在插件页重新登录 MiniMax Code。',
+        failureParameters: '请求的参数被上游拒绝。请调整提示词或选项后重试。',
+        failureSubscription: '账户没有可用的订阅套餐，因此调用被拒绝。请确认 M Plan 订阅是否生效。',
+        failureQuota: '账户的额度已用尽。请等待额度恢复，或查看套餐的限额窗口。',
+        failureRateLimited: '上游正在限流。请稍后重试。',
+        failureLocal: '请求没有发出，因此没有产生任何消耗。',
+        failureUpstream: '上游拒绝了这次请求。请把下面的原文一并反馈，以便定位。',
+        failureCharged: '本次请求可能已被上游计费，请勿立即重试。',
+        failureUpstreamDetail: '上游原文',
         planGeneric: 'M Plan 订阅',
         planExpires: '{date} 到期',
         generateTitle: '生成',
@@ -169,6 +189,26 @@
         usageRanking: 'Top {percent}% by usage',
         usageBestDay: 'Busiest day {date}',
         planNoSubscription: 'No M Plan subscription (credits only), so there are no usage windows',
+        displayTitle: 'Display',
+        showPill: 'Show the credit balance in the composer',
+        diagnosticsTitle: 'Diagnostics',
+        diagnosticsHint: 'This section is read-only. Copy it into an issue as it stands; it changes nothing.',
+        diagnosticsPluginVersion: 'Plugin version',
+        diagnosticsRegion: 'Region',
+        diagnosticsHosts: 'Upstream hosts',
+        diagnosticsAuthSource: 'Signed in via',
+        diagnosticsCatalogSource: 'Catalog source',
+        diagnosticsCapability: 'Host capabilities',
+        diagnosticsLastError: 'Last upstream error',
+        failureCredentials: 'The credential was refused. Sign in to MiniMax Code again on the plugin page.',
+        failureParameters: 'The upstream rejected the request parameters. Adjust the prompt or the options and try again.',
+        failureSubscription: 'The account holds no plan, so the call was refused. Check whether the M Plan subscription is active.',
+        failureQuota: "The allowance is spent. Wait for it to recover, or check the plan's limit windows.",
+        failureRateLimited: 'The upstream is throttling. Try again a little later.',
+        failureLocal: 'The request never left the plugin, so nothing was spent.',
+        failureUpstream: 'The upstream refused the request. Please report the original words below so it can be traced.',
+        failureCharged: 'This request may already have been charged for upstream; do not retry it at once.',
+        failureUpstreamDetail: 'Upstream words',
         planGeneric: 'M Plan subscription',
         planExpires: 'until {date}',
         generateTitle: 'Generate',
@@ -406,6 +446,97 @@
                     return null;
                 return h('div', { style: mutedStyle, 'data-minimax-plan-notice': true }, t('planNoSubscription'));
             }
+            /**
+             * The sentence that says what to do about a failed generation call.
+             *
+             * The kind is the server's verdict on what the failure *is*, and each
+             * kind has one remedy; the upstream's own words are kept beside it
+             * rather than in place of it, because the words are the evidence and
+             * the remedy is the help.
+             */
+            function generationRemedy(t, kind) {
+                switch (kind) {
+                    case 'credentials': return t('failureCredentials');
+                    case 'parameters': return t('failureParameters');
+                    case 'subscription': return t('failureSubscription');
+                    case 'quota': return t('failureQuota');
+                    case 'rate-limited': return t('failureRateLimited');
+                    case 'local': return t('failureLocal');
+                    default: return t('failureUpstream');
+                }
+            }
+            /**
+             * Turn a failed call into what the person is shown.
+             *
+             * Three things travel together: the remedy, whether the upstream had
+             * already accepted the work, and the upstream's own words. The last
+             * one is shown collapsed rather than inline — it can be long, and it is
+             * read when a report is being written, not when the failure happens.
+             */
+            function generationNote(t, failure) {
+                const upstream = failure.upstream?.message ?? failure.error;
+                return {
+                    text: generationRemedy(t, failure.kind),
+                    upstream,
+                    charged: failure.charged === true,
+                };
+            }
+            /**
+             * The diagnostics section: a read-only list of facts about this
+             * installation.
+             *
+             * Its purpose is to be copied. Every line is a fact, nothing here
+             * changes a setting, and the whole thing can be pasted into a report
+             * as it stands — which is the whole point, because the facts a report
+             * needs are exactly the ones nobody can be expected to remember.
+             */
+            function diagnosticsBlock(t, diagnostics) {
+                if (diagnostics === undefined)
+                    return null;
+                const lines = [];
+                const add = (label, value) => {
+                    if (value !== undefined && value.length > 0)
+                        lines.push(`${label}: ${value}`);
+                };
+                add(t('diagnosticsPluginVersion'), diagnostics.pluginVersion);
+                add(t('diagnosticsRegion'), diagnostics.region);
+                add(t('diagnosticsHosts'), diagnostics.hosts?.join('  '));
+                add(t('diagnosticsAuthSource'), diagnostics.authSource);
+                add(t('diagnosticsCatalogSource'), diagnostics.catalogSource);
+                add(t('diagnosticsCapability'), diagnostics.capability === undefined
+                    ? undefined
+                    : Object.entries(diagnostics.capability).map(([key, value]) => `${key}=${value}`).join('  '));
+                add(t('diagnosticsLastError'), diagnostics.lastUpstreamError);
+                if (lines.length === 0)
+                    return null;
+                return h('div', { style: boxStyle, 'data-minimax-diagnostics': true }, h('div', { style: boxTitleStyle }, t('diagnosticsTitle')), h('pre', { style: upstreamTextStyle, 'data-minimax-diagnostics-text': true }, lines.join('\n')), h('div', { style: mutedStyle }, t('diagnosticsHint')));
+            }
+            /**
+             * A note the card shows.
+             *
+             * Most notes are one sentence — the delivery refusals name what is
+             * missing — while a failed call carries its evidence with it. Both are
+             * drawn by the same helper, so the two kinds sit in one place.
+             */
+            function noteBlock(t, note) {
+                if (typeof note === 'string')
+                    return h('span', { style: mutedStyle }, note);
+                return generationNoteBlock(t, note);
+            }
+            /**
+             * The note as it is drawn: the remedy, then the upstream's words.
+             *
+             * The charged case says so in its own line: a person who was told
+             * only "try again" would spend again, and the upstream may already
+             * have taken the first one.
+             */
+            function generationNoteBlock(t, note) {
+                return h('div', { style: mutedStyle, 'data-minimax-generation-note': true }, h('div', null, note.text), note.charged === true
+                    ? h('div', { style: warnStyle, 'data-minimax-generation-charged': true }, t('failureCharged'))
+                    : null, note.upstream === undefined
+                    ? null
+                    : h('details', { style: mutedStyle, 'data-minimax-generation-upstream': true }, h('summary', null, t('failureUpstreamDetail')), h('pre', { style: upstreamTextStyle }, note.upstream)));
+            }
             /**
              * What the page card's plan box says when it has no windows to show.
              *
@@ -546,6 +677,10 @@
                 const provider = (projection?.next ?? projection?.lastUsed)?.provider;
                 if (provider !== undefined && provider !== MINIMAX_PROVIDER_ID)
                     return null;
+                // The balance may be hidden: a display choice, applied at once.
+                const [status] = useStatus();
+                if (status?.showPill === false)
+                    return null;
                 return h(CreditPill, props);
             }
             /**
@@ -610,7 +745,7 @@
                 }, []);
                 const [prompt, setPrompt] = React.useState('');
                 const [busy, setBusy] = React.useState(false);
-                const [note, setNote] = React.useState('');
+                const [note, setNote] = React.useState(undefined);
                 /**
                  * The session's own send path.
                  *
@@ -686,7 +821,7 @@
                     if (text === '')
                         return;
                     setBusy(true);
-                    setNote('');
+                    setNote(undefined);
                     try {
                         const response = await fetch(GENERATE_PATH, {
                             method: 'POST',
@@ -695,7 +830,7 @@
                         });
                         const body = await response.json();
                         if (body.ok !== true || body.dataUrl === undefined) {
-                            setNote(body.error ?? t('generateFailed'));
+                            setNote(generationNote(t, body));
                             return;
                         }
                         const part = imagePart(body.dataUrl, body.mediaType ?? 'image/jpeg');
@@ -737,7 +872,7 @@
                             setOpen(false);
                             // The picture's own arrival is the feedback: it is in the
                             // conversation now, so the composer needs no banner.
-                            setNote('');
+                            setNote(undefined);
                             return;
                         }
                         const drafts = draftFace();
@@ -760,7 +895,7 @@
                             addAttachments(created.map(draft => draft.id));
                             setPrompt('');
                             setOpen(false);
-                            setNote('');
+                            setNote(undefined);
                             return;
                         }
                         setNote(t('generateSendFailed'));
@@ -777,7 +912,7 @@
                         type: 'button',
                         style: buttonStyle,
                         title: t('generateToChatHint'),
-                        onClick: () => { setOpen(true); setNote(''); },
+                        onClick: () => { setOpen(true); setNote(undefined); },
                     }, t('generateToChat'));
                 }
                 return h('div', { style: dockStyle, 'data-minimax-generate-dock': true }, h('input', {
@@ -795,8 +930,8 @@
                     type: 'button',
                     style: buttonStyle,
                     disabled: busy,
-                    onClick: () => { setOpen(false); setPrompt(''); setNote(''); },
-                }, '✕'), note === '' ? null : h('span', { style: mutedStyle }, note));
+                    onClick: () => { setOpen(false); setPrompt(''); setNote(undefined); },
+                }, '✕'), note === undefined ? null : noteBlock(t, note));
             }
             /** Ask the host to do something, and let the card read the result. */
             async function act(action, body) {
@@ -914,14 +1049,14 @@
                 const [resolution, setResolution] = React.useState('2K');
                 const [ratio, setRatio] = React.useState('16:9');
                 const [busy, setBusy] = React.useState(false);
-                const [note, setNote] = React.useState('');
+                const [note, setNote] = React.useState(undefined);
                 const [picture, setPicture] = React.useState(undefined);
                 const [video, setVideo] = React.useState(undefined);
                 const imageModels = options?.imageModels ?? ['MiniMax-H3-Image'];
                 /** Ask for a picture; the answer carries the bytes inline. */
                 async function makeImage() {
                     setBusy(true);
-                    setNote('');
+                    setNote(undefined);
                     setVideo(undefined);
                     try {
                         const response = await fetch(GENERATE_PATH, {
@@ -937,7 +1072,7 @@
                         });
                         const body = await response.json();
                         if (body.ok !== true || body.dataUrl === undefined) {
-                            setNote(body.error ?? t('generateFailed'));
+                            setNote(generationNote(t, body));
                             return;
                         }
                         setPicture({ dataUrl: body.dataUrl, size: body.size, saved: body.attachment !== undefined });
@@ -952,7 +1087,7 @@
                 /** Start a video task, then wait for it the way the upstream does. */
                 async function makeVideo() {
                     setBusy(true);
-                    setNote('');
+                    setNote(undefined);
                     setPicture(undefined);
                     try {
                         const response = await fetch(GENERATE_PATH, {
@@ -968,7 +1103,7 @@
                         });
                         const body = await response.json();
                         if (body.ok !== true || body.taskId === undefined) {
-                            setNote(body.error ?? t('generateFailed'));
+                            setNote(generationNote(t, body));
                             return;
                         }
                         // The task takes a minute and a half; the upstream is asked every
@@ -979,11 +1114,11 @@
                             const task = await polled.json();
                             if (task.url !== undefined) {
                                 setVideo({ url: task.url, status: task.status });
-                                setNote('');
+                                setNote(undefined);
                                 return;
                             }
                             if (task.status !== undefined && /fail|cancel/i.test(task.status)) {
-                                setNote(task.error ?? t('generateFailed'));
+                                setNote(generationNote(t, task));
                                 return;
                             }
                         }
@@ -1022,7 +1157,7 @@
                     style: actionButtonStyle,
                     disabled: busy || prompt.trim() === '',
                     onClick: () => { void (mode === 'image' ? makeImage() : makeVideo()); },
-                }, busy ? (mode === 'video' ? t('generateVideoRunning') : t('generateRunning')) : t('generateRun'))), note === '' ? null : h('div', { style: mutedStyle }, note), picture === undefined
+                }, busy ? (mode === 'video' ? t('generateVideoRunning') : t('generateRunning')) : t('generateRun'))), note === undefined ? null : noteBlock(t, note), picture === undefined
                     ? null
                     : h('div', { style: generationResultStyle, 'data-minimax-generation-image': true }, h('img', { src: picture.dataUrl, alt: prompt, style: generatedImageStyle }), h('div', { style: rowStyle }, h('span', null, picture.size === undefined ? t('generateImageDone') : `${t('generateImageDone')} · ${picture.size}`), picture.saved === true ? h('span', null, t('generateSaved')) : null, h('a', { href: picture.dataUrl, download: 'minimax-h3-image.jpg', style: linkStyle }, t('generateDownload')))), video === undefined
                     ? null
@@ -1092,7 +1227,20 @@
                     ? h('div', { style: { ...boxStyle, ...span2Style }, 'data-minimax-usage-profile': true }, h('div', { style: boxTitleStyle }, t('accountUsage')), h('div', { style: profileGridStyle }, ...profileLines.map((line, index) => h('div', { key: `profile-${index}` }, line))))
                     : null, login !== undefined && login.state !== 'signed-in'
                     ? h('div', { style: span2Style }, loginBlock(t, login, refresh))
-                    : null)), 
+                    : null, 
+                // The read-only facts, last in the card: a report is made from
+                // them, and they are of no use to the person using the plugin.
+                diagnosticsBlock(t, status?.diagnostics), 
+                // A display choice: it takes effect at once, with no draft to
+                // save. The other things on this page are facts to read; this
+                // is the one control, and it changes only what is drawn.
+                h('div', { style: { ...boxStyle, ...span2Style }, 'data-minimax-pill-toggle': true }, h('div', { style: boxTitleStyle }, t('displayTitle')), h('label', { style: { display: 'inline-flex', alignItems: 'center', gap: '6px', fontSize: '12px' } }, h('input', {
+                    type: 'checkbox',
+                    checked: status?.showPill !== false,
+                    onChange: (event) => {
+                        void act('pillVisible', { showPill: event.target.checked });
+                    },
+                }), h('span', null, t('showPill')))))), 
                 // The generation panel does not need the balance: it spends the
                 // account's generation allowance, not its credits, so it stays
                 // usable even when the balance cannot be read.
@@ -1232,6 +1380,20 @@
             };
             const planExpiryStyle = { fontSize: '13px', fontWeight: 400, lineHeight: '1.6' };
             const mutedStyle = { opacity: 0.7, fontSize: '12px' };
+            /**
+             * The upstream's own words, as they arrive.
+             *
+             * Kept monospaced and wrapped, because it is quoted evidence: a report
+             * should carry it exactly as the upstream wrote it.
+             */
+            const upstreamTextStyle = {
+                margin: '4px 0 0',
+                whiteSpace: 'pre-wrap',
+                wordBreak: 'break-word',
+                fontFamily: 'var(--dsh-mono, ui-monospace, monospace)',
+                fontSize: '11px',
+                opacity: 0.9,
+            };
             const actionButtonStyle = {
                 appearance: 'none',
                 background: 'transparent',

package/lib/index.d.ts

@@ -719,6 +719,15 @@ interface PluginState {
   schemaVersion: number;
   /** Whether the plugin claims the daily grant on its own. */
   autoCheckin: boolean;
+  /**
+   * Whether the balance shows in the composer.
+   *
+   * A display choice rather than a setting about the account: it changes
+   * nothing upstream and nothing about what the plugin does, only whether
+   * the balance is drawn beside the composer. It therefore takes effect at
+   * once, with no draft to save — see the note on the settings below.
+   */
+  showPill?: 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. */
@@ -1026,6 +1035,29 @@ interface UsageStatus {
   /** How many requests were measured. */
   requests: number;
 }
+/**
+ * The facts a report needs, gathered in one place.
+ *
+ * The point of this section is that it can be copied as a whole into a
+ * report: every line is a fact about this installation, and nothing here
+ * changes any setting — there is no control on it, by design.
+ */
+interface DiagnosticsStatus {
+  /** This plugin's own version. */
+  pluginVersion?: string;
+  /** The region this plugin talks to. */
+  region?: string;
+  /** The upstream hosts this plugin uses. */
+  hosts?: string[];
+  /** How the plugin is signed in. */
+  authSource?: string;
+  /** Where the model catalog came from. */
+  catalogSource?: string;
+  /** The most recent upstream failure, in its own words. */
+  lastUpstreamError?: string;
+  /** What the host offered the card, one entry per piece. */
+  capability?: Record<string, string>;
+}
 /** The plan the account subscribes to, as the card reads it. */
 interface PlanStatus {
   /** Whether the account holds a plan. */
@@ -1137,6 +1169,10 @@ interface StatusDocument {
   usageProfile?: UsageProfileStatus;
   /** The plan the account subscribes to, when there is one. */
   plan?: PlanStatus;
+  /** The facts a report needs, gathered in one place. */
+  diagnostics?: DiagnosticsStatus;
+  /** Whether the balance is drawn beside the composer. */
+  showPill?: boolean;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
   /** What the host offered the card the last time it looked. */
@@ -1178,6 +1214,10 @@ interface StatusDeps {
   usageProfile?: UsageProfileStatus;
   /** The plan the account subscribes to, when there is one. */
   plan?: PlanStatus;
+  /** The facts a report needs, gathered in one place. */
+  diagnostics?: DiagnosticsStatus;
+  /** Whether the balance is drawn beside the composer. */
+  showPill?: boolean;
   /** The choices the generation endpoints offer. */
   generation?: GenerationOptions;
   /** What the host offered the card the last time it looked. */