@eddyskywalker/dsh-chatgpt-subscription 0.2.21 → 0.3.1

package/lib/types/host/relay-probe.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Read-only diagnostic probe for the child→parent subagent relay.
+ *
+ * The probe answers one question with evidence: when a continuable child tells
+ * its parent it finished (`send_message` or the runtime settlement notice),
+ * what did the parent's side actually do — was the message inserted into the
+ * inbox, claimed, turned into a model request, and did that turn produce any
+ * visible content? It observes durable session events plus the live Agent
+ * snapshot and writes metadata-only lines: never prompt text, never file
+ * contents, never credentials. The only message text it copies is a bounded
+ * excerpt of a tool result that matches a known delivery-failure marker.
+ *
+ * It is inert unless {@link RELAY_PROBE_ENV} is truthy, it never throws into the
+ * host (a diagnostic must not break the deployment), and it writes nothing but
+ * the log file.
+ *
+ * @module dsh-chatgpt-subscription/relay-probe
+ */
+/** Environment switch: any of `1`, `true`, `yes`, `on` enables the probe. */
+export declare const RELAY_PROBE_ENV = "DSH_CHATGPT_SUBSCRIPTION_RELAY_PROBE";
+/** Environment override for the log path (default `$DSH_HOME/relay-probe.log`). */
+export declare const RELAY_PROBE_FILE_ENV = "DSH_CHATGPT_SUBSCRIPTION_RELAY_PROBE_FILE";
+/** Default log file name inside the DSH home. */
+export declare const RELAY_PROBE_FILE_NAME = "relay-probe.log";
+/** A probe log is truncated once it grows past this size. */
+export declare const RELAY_PROBE_MAX_BYTES: number;
+/** Message source kinds that cross the child→parent delivery boundary. */
+export declare const RELAY_SOURCE_KINDS: readonly string[];
+/** One Session as this probe reads it. */
+export interface ProbeSession {
+    readonly id: string;
+    /** A real Session header carries many more fields; only two are read here. */
+    readonly header?: {
+        readonly origin?: unknown;
+        readonly parentSession?: unknown;
+        readonly [key: string]: unknown;
+    } | undefined;
+}
+/** One durable session event as this probe reads it. */
+export interface ProbeEvent {
+    readonly type?: unknown;
+    readonly seq?: unknown;
+    readonly data?: unknown;
+}
+/** Live Agent fields this probe snapshots (never mutated). */
+export interface ProbeAgent {
+    readonly status?: unknown;
+    readonly inbox?: {
+        readonly nextStep?: readonly unknown[];
+        readonly nextTurn?: readonly unknown[];
+    } | undefined;
+}
+/** Registry lookup for the live Agent behind a Session id. */
+export interface AgentsLookup {
+    get(id: string): ProbeAgent | undefined;
+}
+/** Where probe lines go. */
+export interface RelayProbeSink {
+    write(line: string): void;
+}
+/** Construction inputs for {@link RelayProbe}. */
+export interface RelayProbeOptions {
+    readonly sink: RelayProbeSink;
+    readonly agents?: AgentsLookup | undefined;
+    readonly clock?: (() => number) | undefined;
+    readonly maxObservedSessions?: number | undefined;
+}
+/** The Context surface {@link installRelayProbe} needs. */
+export interface RelayProbeContext {
+    on(event: 'session/event', listener: (session: ProbeSession, event: ProbeEvent) => void): unknown;
+    get?(name: string): unknown;
+    logger?: {
+        info(message: string): void;
+    } | undefined;
+}
+/**
+ * Observes delivery boundaries and the parent turns they should produce.
+ *
+ * Every method is fail-open: an unexpected shape is dropped, never thrown.
+ */
+export declare class RelayProbe {
+    private readonly options;
+    private readonly observed;
+    private readonly started;
+    private readonly clock;
+    private readonly maxObserved;
+    private seen;
+    /** Count of observations dropped by the fail-open boundary. */
+    failures: number;
+    constructor(options: RelayProbeOptions);
+    /** Observe one durable session event. */
+    observe(session: ProbeSession, event: ProbeEvent): void;
+    private step;
+    /** A delivery entering (or leaving) the parent's inbox. */
+    private onSplice;
+    /** A message committed to the session surface — for a relay, the claim. */
+    private onUserMessage;
+    /** A child attempting to report to its parent. */
+    private onToolCall;
+    /** A tool result that may be a refused delivery. */
+    private onToolResult;
+    private toolResultText;
+    private observedRequest;
+    private turnReason;
+    private formTag;
+    /** Live snapshot of the Agent behind this Session, when it is resident. */
+    private agentState;
+    private pending;
+    private watch;
+    private line;
+    /** One startup line so a captured file says which process wrote it. */
+    head(path: string): void;
+    /** Sessions currently under observation. */
+    get observedCount(): number;
+    /** Event sequence number of the last observed event, when present. */
+    mark(seq: unknown): void;
+    /** Last observed durable sequence number, when the log carried one. */
+    get lastSeq(): number | undefined;
+}
+/** Where the probe reads a fallback value from, beside the process environment. */
+export interface RelayProbeEnvOptions {
+    /**
+     * An env-file consulted after the process environment. Defaults to no file so
+     * a caller (or a test) never reads configuration behind the injected
+     * environment's back; {@link relayProbeEnvFile} names the deployment default.
+     */
+    readonly envFile?: string | null;
+    /** DSH home used for the default log path and env file. */
+    readonly home?: string;
+}
+/** The deployment's env file, `$DSH_HOME/.env`, as the proxy settings already read it. */
+export declare function relayProbeEnvFile(home?: string): string;
+/**
+ * Read one probe key from the process environment, then from the env file.
+ * The key is always one of this module's own constants, so it is safe to
+ * interpolate into the lookup pattern.
+ * @param key - constant probe key.
+ * @param env - environment to read first.
+ * @param options - optional env-file fallback and DSH home.
+ * @returns the trimmed value, or undefined when neither source sets one.
+ */
+export declare function relayProbeEnvValue(key: string, env: Record<string, string | undefined>, options?: RelayProbeEnvOptions): string | undefined;
+/** Whether the environment enables the probe. */
+export declare function relayProbeEnabled(env?: Record<string, string | undefined>, options?: RelayProbeEnvOptions): boolean;
+/** Resolve the probe log path from the environment. */
+export declare function relayProbeLogPath(env?: Record<string, string | undefined>, options?: RelayProbeEnvOptions): string;
+/** Append-only file sink that truncates itself past a size cap. */
+export declare function createFileRelayProbeSink(options: {
+    path: string;
+    maxBytes?: number;
+}): RelayProbeSink;
+/**
+ * Subscribe the probe to durable session events.
+ * @param ctx - host context (or its probe-facing subset).
+ * @param options - sink, optional agent lookup, and optional clock.
+ * @returns the disposer that detaches the listener.
+ */
+export declare function installRelayProbe(ctx: RelayProbeContext, options: RelayProbeOptions & {
+    path?: string;
+}): () => void;
+//# sourceMappingURL=relay-probe.d.ts.map

package/lib/types/host/relay-probe.d.ts.map

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

package/lib/types/host/responses-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses-client.d.ts","sourceRoot":"","sources":["../../../src/host/responses-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAwD,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEzF,KAAK,SAAS,GAAG,OAAO,KAAK,CAAA;AAK7B,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAA;IACnD,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAAA;CACtD;AAED,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;gBAGlD,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,EAChH,OAAO,GAAE,sBAA2B;IAUtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAE9C,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC;YA6CrD,IAAI;YAYJ,OAAO;CAsBtB;AAWD,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,qBAAqB,GAAE,WAAW,CAAC,MAAM,CAAa,GACrD,aAAa,CAAC,WAAW,CAAC,CAsO5B"}
+{"version":3,"file":"responses-client.d.ts","sourceRoot":"","sources":["../../../src/host/responses-client.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAwD,KAAK,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAEvH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEzF,KAAK,SAAS,GAAG,OAAO,KAAK,CAAA;AAK7B,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,cAAc,CAAC,EAAE,oBAAoB,CAAA;IACrC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC,eAAe,CAAC,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAA;IACnD,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,qBAAqB,GAAG,IAAI,CAAA;CACtD;AAED,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;IACnC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoC;gBAGlD,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,EAChH,OAAO,GAAE,sBAA2B;IAUtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAE9C,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,CAAC,WAAW,CAAC;YA6CrD,IAAI;YAYJ,OAAO;CAsBtB;AAWD,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,WAAW,EACpB,qBAAqB,GAAE,WAAW,CAAC,MAAM,CAAa,GACrD,aAAa,CAAC,WAAW,CAAC,CAwQ5B"}

package/lib/types/index.d.ts

@@ -20,6 +20,8 @@ export interface Config {
 export declare const Config: z<Config>;
 export declare const inject: string[];
 export declare function apply(ctx: Context, pluginConfig?: Config): void;
+export { RELAY_PROBE_ENV, RELAY_PROBE_FILE_ENV, RELAY_PROBE_FILE_NAME, RELAY_PROBE_MAX_BYTES, RELAY_SOURCE_KINDS, RelayProbe, createFileRelayProbeSink, installRelayProbe, relayProbeEnabled, relayProbeEnvFile, relayProbeEnvValue, relayProbeLogPath, } from './host/relay-probe.ts';
+export type { AgentsLookup, ProbeAgent, ProbeEvent, ProbeSession, RelayProbeContext, RelayProbeOptions, RelayProbeSink, } from './host/relay-probe.ts';
 export { ProxyManager, detectSystemProxy } from './host/proxy-manager.ts';
 export { SUBAGENT_MODEL_SELECTION_NAMESPACE, SUBAGENT_POLICY_EVENT, authorizedRoutesFor, createSubagentAuthorization, delegationDenialReason, installSubagentModelAuthorization, normalizeDelegationToolNames, parseAllowedRoutes, policyRoutesOf, subagentModelSelectionPreference, unauthorizedRouteReason, validateAuthorizationScope, validateDelegationToolNames, } from './host/subagent-model-authorization.ts';
 export { OAuthService } from './host/oauth-service.ts';
@@ -36,6 +38,17 @@ export { LinuxFileTokenStore } from './host/token-store-linux.ts';
 export { WindowsDpapiTokenStore } from './host/token-store-windows.ts';
 export type { TokenStore, StoredOAuthCredentials } from './host/token-store.ts';
 export { AntigravityAdapter } from './host/antigravity/adapter.ts';
+export { CommandCodeAdapter } from './host/command-code/adapter.ts';
+export { FileCredentialStore as CommandCodeCredentialStore, FileModelSettingsStore as CommandCodeModelSettingsStore, credentialPath as commandCodeCredentialPath, modelSettingsPath as commandCodeModelSettingsPath, registerCommandCodePreferenceStore, } from './host/command-code/token-store.ts';
+export { beginWebLogin as startCommandCodeLogin, getWebLoginStatus as getCommandCodeLoginStatus, saveApiKey as saveCommandCodeApiKey, } from './host/command-code/oauth.ts';
+export { getCommandCodeWebStatus, registerCommandCodeRoutes } from './host/command-code/routes.ts';
+export { fetchAccountQuota as fetchCommandCodeQuota, clearCachedQuota as clearCommandCodeQuota, getCachedQuota as getCommandCodeQuota, loadProviderModels as loadCommandCodeModels, } from './host/command-code/client.ts';
+export { KimiCodeAdapter, classifyKimiFailure, KIMI_CODE_RETRY_POLICY_CONFIG } from './host/kimi-code/adapter.ts';
+export { FileCredentialStore as KimiCodeCredentialStore, FileModelSettingsStore as KimiCodeModelSettingsStore, credentialPath as kimiCodeCredentialPath, modelSettingsPath as kimiCodeModelSettingsPath, registerKimiCodePreferenceStore, resolveRegion as resolveKimiCodeRegion, } from './host/kimi-code/token-store.ts';
+export { beginWebLogin as beginKimiCodeLogin, ensureAccessToken as ensureKimiCodeAccessToken, getWebLoginStatus as getKimiCodeLoginStatus, refreshAccessToken as refreshKimiCodeToken, requestDeviceAuthorization as requestKimiCodeDeviceAuthorization, } from './host/kimi-code/oauth.ts';
+export { fetchAccountQuota as fetchKimiCodeQuota, fetchUserInfo as fetchKimiCodeUserInfo, loadProviderModels as loadKimiCodeModels, clearCachedQuota as clearKimiCodeQuota, getCachedQuota as getKimiCodeQuota, } from './host/kimi-code/client.ts';
+export { getKimiCodeWebStatus, registerKimiCodeRoutes } from './host/kimi-code/routes.ts';
+export { KIMI_CODE_MODELS, kimiCodeModelDef, } from './host/kimi-code/model-catalog.ts';
 export { FileCredentialStore, FileModelSettingsStore, credentialPath, modelSettingsPath, } from './host/antigravity/token-store.ts';
 export { loginAndSave, beginWebLogin, refreshAntigravityToken } from './host/antigravity/oauth.ts';
 export { clearCachedQuota, fetchAccountQuota, getCachedQuota } from './host/antigravity/client.ts';

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAsCxC,yDAAyD;AACzD,MAAM,WAAW,MAAM;IACrB;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAA;IACpC,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAA;CAC9C;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAI3B,CAAA;AAEF,eAAO,MAAM,MAAM,UAAqE,CAAA;AAExF,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,GAAE,MAAW,GAAG,IAAI,CAwHnE;AAED,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AACzE,OAAO,EACL,kCAAkC,EAClC,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,sBAAsB,EACtB,iCAAiC,EACjC,4BAA4B,EAC5B,kBAAkB,EAClB,cAAc,EACd,gCAAgC,EAChC,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,sBAAsB,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAA;AAC9G,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAClF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAA;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AACtE,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,mCAAmC,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAClG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/lib/types/shared/command-code-contracts.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Wire contracts between the Command Code host routes and the browser settings
+ * card. Everything here is public: no credential ever crosses this boundary.
+ */
+/** Deployment of the Command Code API a credential was issued against. */
+export type CommandCodeApiEnv = 'prod' | 'staging' | 'local';
+/**
+ * Reasoning levels the provider registry can expose. The exact set is per
+ * model — `minimal` is the cheapest budget, `xhigh` sits between `high` and
+ * `max`, and most models declare only a subset.
+ */
+export type CommandCodeReasoningEffort = 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/** Every level, in escalating order; the settings card renders exactly these. */
+export declare const COMMAND_CODE_REASONING_EFFORTS: readonly CommandCodeReasoningEffort[];
+/** One model offered by the Command Code provider API. */
+export interface CommandCodeModelOption {
+    id: string;
+    name: string;
+    /** Enabled models are the ones DSH offers in the conversation model picker. */
+    enabled: boolean;
+    /** Context window the live catalog reports for this model. */
+    defaultContextWindow: number;
+    /** Effective context window: the override when one is saved, else the default. */
+    contextWindow: number;
+    /** Maximum output tokens this route requests when a caller omits one. */
+    defaultMaxTokens: number;
+    /** Reasoning levels this route exposes; absent for non-reasoning models. */
+    reasoningEfforts?: string[];
+    /** Reasoning dialect the adapter uses on the wire. */
+    wire: CommandCodeWire;
+}
+/** Request/response dialect a model id is served over. */
+export type CommandCodeWire = 'openai' | 'anthropic';
+/** One credit / spend meter reported by the billing service. */
+export interface CommandCodeMeter {
+    id: string;
+    label: string;
+    /** Used fraction in [0, 1] when the service reports a bounded allowance. */
+    usedFraction: number | null;
+    /** Remaining fraction in [0, 1], when the service reports one. */
+    remainingFraction: number | null;
+    used: string | null;
+    limit: string | null;
+    /** Unix milliseconds the meter resets, when reported. */
+    resetsAt: number | null;
+    description: string | null;
+}
+/** Windowed request/token allowance reported by the usage service. */
+export interface CommandCodeUsageWindow {
+    id: string;
+    label: string;
+    usedPercent: number;
+    windowDurationMins: number | null;
+    resetsAt: number | null;
+}
+/** Account identity returned by `/alpha/whoami`. */
+export interface CommandCodeAccount {
+    userId: string | null;
+    userName: string | null;
+    email: string | null;
+    organizationName: string | null;
+    keyName: string | null;
+    planLabel: string | null;
+    planId: string | null;
+    authenticatedAt: number | null;
+}
+/** One point-in-time quota snapshot for the signed-in Command Code account. */
+export interface CommandCodeAccountQuota {
+    account: CommandCodeAccount;
+    /** Credit balance in the provider's own unit, when reported. */
+    creditBalance: string | null;
+    /** True when the plan bills against an unlimited allowance. */
+    unlimited: boolean;
+    /** Machine id the service reports, e.g. `individual-goat`. */
+    planId: string | null;
+    /** Display name for {@link planId}, e.g. `GOAT`. */
+    planName: string | null;
+    /** Monthly credits the plan grants, when the id is recognized. */
+    planMonthlyCredits: number | null;
+    /** Subscription state the service reports, e.g. `active`. */
+    subscriptionStatus: string | null;
+    /** End of the current billing period, as Unix milliseconds. */
+    periodEndsAt: number | null;
+    meters: CommandCodeMeter[];
+    windows: CommandCodeUsageWindow[];
+    /** Raw service payloads, kept for diagnostics in the settings card. */
+    fetchedAt: number;
+    sources: string[];
+}
+/** Everything the settings card and the composer badge render. */
+export interface CommandCodeWebStatus {
+    authenticated: boolean;
+    hasCredentials: boolean;
+    storagePath: string;
+    apiEnv: CommandCodeApiEnv;
+    account: CommandCodeAccount | null;
+    quota: CommandCodeAccountQuota | null;
+    lastFetchedAt: number | null;
+    models: CommandCodeModelOption[];
+    contextWindowOverrides: Record<string, number>;
+    defaultReasoningEffort: CommandCodeReasoningEffort | null;
+    /** Route the plugin currently serves; false when another plugin owns it. */
+    serving: boolean;
+    /** Diagnostic when the route is owned by a different adapter family. */
+    conflict: string | null;
+}
+/** Patch accepted by the models/settings routes. */
+export interface CommandCodeSettingsUpdateDto {
+    enabledModelIds?: string[];
+    contextWindowOverrides?: Record<string, number>;
+    defaultReasoningEffort?: CommandCodeReasoningEffort | null;
+}
+/** Result of a manual API-key submission or a compatibility probe. */
+export interface CommandCodeConnectionDto {
+    connected: boolean;
+    account: CommandCodeAccount | null;
+    checkedAt: number;
+}
+//# sourceMappingURL=command-code-contracts.d.ts.map

package/lib/types/shared/command-code-contracts.d.ts.map

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

package/lib/types/shared/kimi-code-contracts.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Wire contracts between the Kimi Code host routes and the browser settings
+ * card. Everything here is public: no credential ever crosses this boundary.
+ *
+ * Kimi Code (https://www.kimi.com/code) is a Moonshot AI coding subscription,
+ * distinct from the pay-as-you-go Moonshot Open Platform: its credentials come
+ * from an OAuth device flow against auth.kimi.com and its inference lives at
+ * https://api.kimi.com/coding/v1.
+ */
+/** Region a Kimi Code account belongs to; decides which hosts the client uses. */
+export type KimiCodeRegion = 'mainland-cn' | 'global';
+/**
+ * Request/response dialect used for the model calls.
+ *
+ * The official Kimi Code CLI configures its managed provider as `type = "kimi"`,
+ * an OpenAI-compatible chat-completions client, so that is the default here.
+ * The Anthropic Messages dialect is offered too because the service documents
+ * `https://api.kimi.com/coding/` as an Anthropic-compatible base URL for
+ * third-party tools, and some models behave better with a thinking budget.
+ */
+export type KimiCodeWire = 'openai' | 'anthropic';
+/**
+ * Thinking level a Kimi Code model accepts.
+ *
+ * Kimi Code maps a tool's effort onto exactly three K3 levels plus a thinking-off
+ * switch. The documented mapping is authoritative and deliberately narrower than
+ * the generic level set other providers use:
+ *
+ * - `low`   <- `low` / `minimum` / `light`
+ * - `high`  <- `high` / `medium`
+ * - `max`   <- `ultra` / `max` / `xhigh`
+ * - `none`  -> thinking disabled (`thinking.type = "disabled"`)
+ *
+ * Anything else the client sends is rejected by the service with HTTP 400, so
+ * no other level is ever put on the wire.
+ */
+export type KimiCodeReasoningEffort = 'low' | 'high' | 'max' | 'none';
+/** Every level, in escalating order; the settings card renders exactly these. */
+export declare const KIMI_CODE_REASONING_EFFORTS: readonly KimiCodeReasoningEffort[];
+/** One model offered by the Kimi Code coding endpoint. */
+export interface KimiCodeModelOption {
+    id: string;
+    name: string;
+    /** Enabled models are the ones DSH offers in the conversation model picker. */
+    enabled: boolean;
+    /** Context window the catalog reports for this model. */
+    defaultContextWindow: number;
+    /** Effective context window: the override when one is saved, else the default. */
+    contextWindow: number;
+    /** Maximum output tokens this route requests when a caller omits one. */
+    defaultMaxTokens: number;
+    /** Thinking levels this model accepts; absent for a model that cannot reason. */
+    reasoningEfforts?: string[];
+    /** Thinking level used when the conversation does not pick one. */
+    defaultReasoningEffort?: string;
+    /** Request/response dialect the adapter uses on the wire. */
+    wire: KimiCodeWire;
+    /** Human description from the official model table. */
+    description: string | null;
+    /** Whether the model accepts video input as well as images. */
+    supportsVideo: boolean;
+    /**
+     * Whether the model accepts message-level tool declarations
+     * (`messages[].tools`), Kimi's `dynamically_loaded_tools` capability.
+     *
+     * The card shows it because it is the one K3 feature that changes how a
+     * client should be shaped rather than what it may send: a session that
+     * progressively discloses tools keeps its top-level list stable, which is
+     * what protects the prefix cache.
+     */
+    supportsDynamicTools: boolean;
+    /** Subscription tier the model needs, when it is not open to every member. */
+    minimumPlan: string | null;
+}
+/** One quota window reported for the signed-in account. */
+export interface KimiCodeUsageWindow {
+    id: string;
+    label: string;
+    /** Used fraction in [0, 1]. */
+    usedFraction: number;
+    /** Convenience integer for the card and badge. */
+    usedPercent: number;
+    /** Nominal window length in minutes, when the service states one. */
+    windowDurationMins: number | null;
+    /** Unix milliseconds the window resets, when reported. */
+    resetsAt: number | null;
+    /** Allowance as the service reports it (request counts), when reported. */
+    limit: string | null;
+    used: string | null;
+    remaining: string | null;
+}
+/** Pay-as-you-go wallet the account can fall back on once a window is spent. */
+export interface KimiCodeExtraUsage {
+    /** Remaining wallet balance in the currency's minor unit. */
+    balanceCents: number | null;
+    totalCents: number | null;
+    monthlyChargeLimitEnabled: boolean;
+    monthlyChargeLimitCents: number | null;
+    monthlyUsedCents: number | null;
+    currency: string | null;
+}
+/** Account identity, resolved from the token and the usage response. */
+export interface KimiCodeAccount {
+    userId: string | null;
+    nickname: string | null;
+    email: string | null;
+    /** Subscription tier display name, for example Moderato. */
+    planName: string | null;
+    /** Machine tier level when the service reports one. */
+    planLevel: string | null;
+    region: KimiCodeRegion | null;
+    authenticatedAt: number | null;
+}
+/** One point-in-time quota snapshot for the signed-in Kimi Code account. */
+export interface KimiCodeAccountQuota {
+    account: KimiCodeAccount;
+    /** Subscription tier display name, when the service reports one. */
+    planName: string | null;
+    /** Every quota window the account currently has. */
+    windows: KimiCodeUsageWindow[];
+    /** Pay-as-you-go booster wallet, when the account has one. */
+    extraUsage: KimiCodeExtraUsage | null;
+    /** Unix milliseconds this snapshot was fetched. */
+    fetchedAt: number;
+    /** Endpoint paths that answered, kept for diagnostics in the card. */
+    sources: string[];
+}
+/** Everything the settings card and the composer badge render. */
+export interface KimiCodeWebStatus {
+    authenticated: boolean;
+    hasCredentials: boolean;
+    storagePath: string;
+    region: KimiCodeRegion;
+    oauthHost: string;
+    codingBaseUrl: string;
+    account: KimiCodeAccount | null;
+    quota: KimiCodeAccountQuota | null;
+    lastFetchedAt: number | null;
+    /** When true the stored refresh token was rejected and sign-in is required. */
+    credentialsRejected: boolean;
+    /**
+     * Why the quota could not be read, when the last attempt failed.
+     *
+     * Reported beside the snapshot rather than in place of it: a transient
+     * failure should explain itself without hiding the account that is signed in.
+     */
+    quotaError?: string | null;
+    /** Rolling prefix-cache effectiveness for this process, when requests ran. */
+    cache: KimiCodeCacheStatsDto | null;
+    /** Whether Preserved Thinking is currently requested on the wire. */
+    preserveThinking: boolean;
+    models: KimiCodeModelOption[];
+    contextWindowOverrides: Record<string, number>;
+    defaultReasoningEffort: KimiCodeReasoningEffort | null;
+    /** Region used for the next login flow. */
+    loginRegion: KimiCodeRegion;
+    /** Route the plugin currently serves; false when another plugin owns it. */
+    serving: boolean;
+    /** Diagnostic when the route is owned by a different adapter family. */
+    conflict: string | null;
+}
+/**
+ * How well Kimi's automatic prefix cache is working for this process.
+ *
+ * Reported because the cache is invisible otherwise: it is content-hash based
+ * with no marker to set, so the read ratio is the only evidence a session is
+ * actually reusing its prefix.
+ */
+export interface KimiCodeCacheStatsDto {
+    requests: number;
+    cachedTokens: number;
+    freshTokens: number;
+    outputTokens: number;
+    /** Cached / (cached + fresh); null until a request reports usage. */
+    hitRatio: number | null;
+}
+/** Patch accepted by the models/settings routes. */
+export interface KimiCodeSettingsUpdateDto {
+    enabledModelIds?: string[];
+    contextWindowOverrides?: Record<string, number>;
+    defaultReasoningEffort?: KimiCodeReasoningEffort | null;
+}
+/** Live state of the device-code login flow the card polls. */
+export interface KimiCodeLoginFlowStatus {
+    status: 'idle' | 'pending' | 'complete' | 'error';
+    /** Page the user must open, including the pre-filled user code. */
+    verificationUriComplete?: string;
+    verificationUri?: string;
+    userCode?: string;
+    startedAt?: number;
+    completedAt?: number;
+    /** Unix milliseconds the device code stops being valid. */
+    expiresAt?: number;
+    progress?: string;
+    error?: string;
+}
+/** Result of an explicit connection test. */
+export interface KimiCodeConnectionDto {
+    connected: boolean;
+    latencyMs: number;
+    account: KimiCodeAccount | null;
+}
+//# sourceMappingURL=kimi-code-contracts.d.ts.map

package/lib/types/shared/kimi-code-contracts.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eddyskywalker/dsh-chatgpt-subscription",
-  "version": "0.2.21",
+  "version": "0.3.1",
   "description": "DSH provider plugin for Codex access through a ChatGPT subscription.",
   "author": {
     "name": "eddyskywalker",