dsh-coding-subscription-oauth 0.5.0

package/lib/index.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Optional xAI Grok Build bundle with OAuth, account model catalog,
+ * and an account section inside dsh Settings.
+ * @module dsh-coding-subscription-oauth
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import { type RetryPolicyConfig } from "@deepseek-ai/dsh-llm";
+import z from "@deepseek-ai/schemastery";
+import { type CapabilitySettingsPatch } from "./capability-settings.js";
+import { type GatewayConfig } from "./gateway-config.js";
+export { createCodingOAuthAdapter, createGrokBuildAdapter, preferredGrokBuildModel } from "./adapter.js";
+export type { AliasLlmRoutePolicy } from "./alias-adapter.js";
+export { AliasLlmAdapter } from "./alias-adapter.js";
+export type { GrokBuildAuthStatus } from "./auth.js";
+export { grokBuildAuthStatus, importGrokBuildFromGrok, importGrokBuildSession, loginGrokBuild, loginGrokBuildSession, logoutGrokBuild, } from "./auth.js";
+export type { CodingOAuthWebStatus, GrokBuildLoginMethod, GrokBuildWebAuthStatus, LoginChallenge, SubscriptionLoginChallenge, SubscriptionWebAuthStatus, } from "./auth-routes.js";
+export { CODING_OAUTH_LOGIN_CANCEL_PATH, CODING_OAUTH_LOGIN_CODE_PATH, CODING_OAUTH_LOGIN_PATH, CODING_OAUTH_LOGOUT_PATH, CODING_OAUTH_MODELS_PATH, CODING_OAUTH_STATUS_PATH, GROK_BUILD_AUTH_IMPORT_PATH, GROK_BUILD_AUTH_LOGIN_CANCEL_PATH, GROK_BUILD_AUTH_LOGIN_CODE_PATH, GROK_BUILD_AUTH_LOGIN_PATH, GROK_BUILD_AUTH_LOGOUT_PATH, GROK_BUILD_AUTH_MODELS_PATH, GROK_BUILD_AUTH_STATUS_PATH, GrokBuildWebAuth, registerCodingOAuthRoutes, registerGrokBuildAuthRoutes, SubscriptionWebAuth, } from "./auth-routes.js";
+export type { CatalogSource, LiveModelDescriptor } from "./catalog.js";
+export { extractLiveModels, extractModelIds, fetchLiveModelIds, fetchLiveModels, materializeLiveModel, mergeLiveCatalog, preferredGrokBuildModelFrom, thinkingLevelMapFromLiveEfforts, } from "./catalog.js";
+export type { GrokImportProbe } from "./grok-import.js";
+export { grokAuthPath, importGrokAuth, parseGrokAuthDocument, probeGrokAuth } from "./grok-import.js";
+export type { CodingOAuthProviderSlug, CodingOAuthRoute } from "./ids.js";
+export { ANTIGRAVITY_ROUTE, CLAUDE_CODE_OAUTH_AUTH_FILENAME, CLAUDE_CODE_OAUTH_MODELS_CACHE_FILENAME, CLAUDE_CODE_OAUTH_ROUTE, CLAUDE_PI_PROVIDER, CODEX_OAUTH_AUTH_FILENAME, CODEX_OAUTH_MODELS_CACHE_FILENAME, CODEX_OAUTH_ROUTE, CODEX_PI_PROVIDER, CODING_OAUTH_ROUTES, DEFAULT_GROK_BUILD_MODEL, GROK_BUILD_AUTH_FILENAME, GROK_BUILD_MODELS_CACHE_FILENAME, GROK_BUILD_ROUTE, GROK_BUILD_STREAM_IDLE_TIMEOUT_MS, KIMI_CODE_OAUTH_AUTH_FILENAME, KIMI_CODE_OAUTH_MODELS_CACHE_FILENAME, KIMI_CODE_OAUTH_ROUTE, KIMI_PI_PROVIDER, XAI_PI_PROVIDER, } from "./ids.js";
+export type { GrokBuildOAuthErrorCode, GrokBuildOAuthParams, PkceLoginCallbacks } from "./oauth.js";
+export { buildAuthorizeUrl, discoverOAuthEndpoints, extractCode, GROK_BUILD_OAUTH_CLIENT_ID, GROK_BUILD_OAUTH_DEFAULT_PORT, GROK_BUILD_OAUTH_ISSUER, GROK_BUILD_OAUTH_SCOPE, GrokBuildOAuthError, generatePkce, loginGrokBuildPkce, refreshGrokBuildToken, resolveOAuthParams, } from "./oauth.js";
+export type { OAuthProviderDefinition, SubscriptionLoginMethod, SubscriptionProviderSlug } from "./oauth-providers.js";
+export { CLAUDE_CODE_OAUTH_PROVIDER, CODEX_OAUTH_PROVIDER, KIMI_CODE_OAUTH_PROVIDER, OAUTH_PROVIDER_DEFINITIONS, oauthProviderDefinition, } from "./oauth-providers.js";
+export type { OAuthProviderStatus } from "./oauth-session.js";
+export { OAuthProviderSession, oauthModelsCachePath } from "./oauth-session.js";
+export { GROK_BUILD_BASE_URL, GROK_BUILD_MODELS_URL, GROK_CLIENT_VERSION, grokBuildBaselineModels, grokBuildFingerprintHeaders, grokBuildProvider, grokBuildReasoningMap, } from "./provider.js";
+export type { CodingOAuthProxyOptions } from "./proxy.js";
+export { codingOAuthProxyInEffect, codingOAuthProxyUnreachableHint, ensureCodingOAuthProxy, ensureGrokBuildProxy, grokBuildProxyInEffect, } from "./proxy.js";
+export { redactProxyUrl, safeMessage } from "./redact.js";
+export { GrokBuildSession } from "./session.js";
+export { GrokBuildCredentialStore, grokBuildAuthPath, OAuthCredentialFileStore, oauthCredentialPath, } from "./store.js";
+/** Stable Cordis plugin name. */
+export declare const name = "llm-grok-build-oauth";
+/** Separate API-key credential used only by official xAI Imagine REST calls. */
+export declare const XAI_API_KEY_CREDENTIAL = "XAI_API_KEY";
+/** Owner-private artifact directory below the resolved DSH home. */
+export declare const IMAGINE_MEDIA_STORE_DIRNAME = ".dsh-coding-subscription-oauth-media";
+/** LLM registry required before the subscription route can register. */
+export declare const inject: string[];
+/** Plugin configuration; every field is optional. */
+export interface Config {
+    /** HTTP(S) proxy URL for the audited coding-subscription host allowlist. */
+    proxy?: string;
+    /** Kimi China traffic stays direct unless explicitly opted into the proxy. */
+    proxyKimi?: boolean;
+    /**
+     * Optional provider retry policy override for the four OAuth routes. When
+     * omitted, the plugin retries transient failures (rate limit, server,
+     * timeout, transport, empty response) plus AUTH — the latter is safe because
+     * the stored credential is invalidated on every AUTH finish, so the retried
+     * step refreshes before reuse. Quota exhaustion is never retried.
+     */
+    retryPolicy?: RetryPolicyConfig;
+    /** Secret-free composition/YAML defaults below live user settings. */
+    capabilities?: CapabilitySettingsPatch;
+    /** Opt-in isolated local OpenAI-compatible gateway. Default off. */
+    gateway?: Partial<GatewayConfig>;
+}
+export declare const Config: z<Config>;
+/**
+ * Register the `grok-build` LLM route with a provider-native OAuth store.
+ * @param ctx - plugin context carrying the LLM registry plus optional web server.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

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