@chatcode/cco-llm-chatcode-config 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,263 @@
+import { Context, Service } from "@deepseek-ai/cordis";
+import { RetryPolicyConfig } from "@deepseek-ai/dsh-llm";
+import { CredentialProvider } from "@deepseek-ai/dsh-credentials";
+import z from "@deepseek-ai/schemastery";
+//#region src/config.d.ts
+/** One user-defined model stored in the plugin-owned settings namespace. */
+interface CustomModel {
+  /** Exact model ID sent to the configured gateway. */
+  model: string;
+  /** Plaintext gateway credential stored in settings.yaml. */
+  apiKey: string;
+  /** Gateway base URL, including any path prefix. */
+  baseUrl: string;
+  /** Optional selector label; the model ID is used when omitted. */
+  description?: string;
+  /** Legacy protocol hint used when protocol is omitted. */
+  provider?: string | null;
+  /** Compatible wire protocol: OpenAI or Anthropic. */
+  protocol?: string;
+  /** Context capacity advertised to ChatCode CLI. */
+  contextWindow?: number;
+  /** Default and maximum output token count. */
+  maxTokens?: number;
+  /** Legacy context-capacity fallback. */
+  maxInputTokens?: number;
+}
+/** One provider/model rule used to classify ChatCode model statistics. */
+interface ModelKindRule {
+  /** Exact ChatCode CLI provider route; omission matches every provider. */
+  provider?: string;
+  /** Exact provider model id; omission matches every model. */
+  model?: string;
+  /** ChatCode model category. */
+  kind: number;
+}
+/** Operational reporting controls for committed ChatCode CLI Session events. */
+interface ReportingConfig {
+  /** Enable reporting when the Session service is available. */
+  enabled: boolean;
+  /** Enable durable AI-generated-code reporting. */
+  codeSave: boolean;
+  /** Enable conversation and message database synchronization. */
+  conversationSync: boolean;
+  /** Enable the user-visible ChatCode message chain. */
+  chatCodeSession: boolean;
+  /** Maximum code records in one save request. */
+  codeBatchItems: number;
+  /** Maximum aggregate code characters in one save request. */
+  codeBatchChars: number;
+  /** Delay before retrying the durable code outbox. */
+  codeRetryDelayMs: number;
+  /** Absolute code outbox directory; an empty value uses the resolved ChatCode CLI Home. */
+  codeOutboxDir: string;
+  /** Include subagent Sessions in conversation database synchronization. */
+  includeSubagentConversationSync: boolean;
+  /** Ordered exact-match overrides applied before backend URL classification. */
+  modelKindRules: ModelKindRule[];
+}
+/** Model sources, account access, and operations-reporting configuration. */
+interface Config {
+  /** Legacy Host JSON file used only when the settings namespace is absent. */
+  settingsPath?: string;
+  /** User-defined models served from the plugin-owned settings namespace. */
+  customModels: CustomModel[];
+  /** Context capacity when a managed entry omits its capacity. */
+  defaultContextWindow: number;
+  /** Output default and ceiling when a managed entry omits maxTokens. */
+  defaultMaxTokens: number;
+  /** Retry policy for every imported route; omission uses the LLM service default. */
+  retryPolicy?: RetryPolicyConfig;
+  /** ChatCode account sign-in and refresh endpoint selection. */
+  auth: {
+    /** Retained for login UI compatibility; it never blocks model calls. */
+    requireLogin: boolean;
+    loginUrl: string;
+    apiBaseUrl: string;
+    pollIntervalMs: number;
+    pollTimeoutMs: number;
+    requestTimeoutMs: number;
+  };
+  /** CVP backend root for generated code, conversation synchronization, and ChatCode message records. */
+  cvpChatCodeApiUrl: string;
+  /** Optional CVP credential override and timeout for launch admission. */
+  startupGate: {
+    token: string;
+    timeoutMs: number;
+  };
+  /** ChatCode operations reporting derived from committed Session events. */
+  reporting: ReportingConfig;
+  /** Runtime-config API queried once when the ChatCode CLI profile starts. */
+  codingPlanEndpoint: string;
+  /** Include the separately configured MAAS catalog in the model selector. */
+  enableMaas: boolean;
+  /** MAAS catalog API, queried only when {@link enableMaas} is true. */
+  maasEndpoint: string;
+  /** Bound one catalog request so a failed control plane cannot block startup indefinitely. */
+  catalogTimeoutMs: number;
+}
+/** Mount input accepts independently partial account and reporting sections. */
+interface ConfigInput extends Omit<Partial<Config>, 'auth' | 'reporting' | 'startupGate'> {
+  auth?: Partial<Config['auth']>;
+  reporting?: Partial<ReportingConfig>;
+  startupGate?: Partial<Config['startupGate']>;
+}
+/** Validate mounting options without exposing control-plane credentials. */
+declare const Config: z<ConfigInput, Config>;
+//#endregion
+//#region src/chatcode-auth.d.ts
+interface ChatCodeLoginState {
+  sessionId: string;
+  state: 'pending' | 'succeeded' | 'failed' | 'timed-out' | 'cancelled';
+  expiresAtMs: number;
+}
+/** Safe UI projection: never add a token or raw upstream response here. */
+interface ChatCodeAuthStatus {
+  required: boolean;
+  configured: boolean;
+  expired: boolean;
+  validation: 'valid' | 'invalid' | 'unavailable' | 'none';
+  expiresAtMs?: number;
+  userName?: string;
+  emailAddress?: string;
+  login?: ChatCodeLoginState;
+}
+interface ChatCodeLoginStart {
+  sessionId: string;
+  url: string;
+}
+interface ChatCodeStatusOptions {
+  /** Bypass the short validation cache and contact the account service again. */
+  force?: boolean;
+}
+interface ChatCodeAuthOptions {
+  requireLogin?: boolean;
+  loginUrl: string;
+  apiBaseUrl: string;
+  pollIntervalMs: number;
+  pollTimeoutMs: number;
+  requestTimeoutMs: number;
+}
+interface ChatCodeAuthApi {
+  status(options?: ChatCodeStatusOptions): Promise<ChatCodeAuthStatus>;
+  startLogin(): Promise<ChatCodeLoginStart>;
+  cancelLogin(sessionId: string): Promise<void>;
+  waitForLogin(sessionId: string, signal?: AbortSignal): Promise<ChatCodeLoginState['state']>;
+  logout(): Promise<void>;
+  /** Host-only accessor; presentation adapters must use status(). */
+  accessToken(signal?: AbortSignal): Promise<string | undefined>;
+  /** Host-only launch fact; reveals presence, never the credential value. */
+  environmentTokenActive(): boolean;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    chatcodeAuth: ChatCodeAuthService;
+  }
+}
+/** One protocol owner, shared across Web and TUI through credentials-local's file lock. */
+declare class ChatCodeAuthService extends Service implements ChatCodeAuthApi {
+  private readonly credentials;
+  private readonly options;
+  private readonly lifetime;
+  private readonly active;
+  private readonly failures;
+  private readonly tasks;
+  /** A new host process must contact ChatCode once before trusting persisted validation metadata. */
+  private startupValidationPending;
+  private readonly environmentAccessToken;
+  constructor(ctx: Context, credentials: CredentialProvider, options: ChatCodeAuthOptions, environmentAccessToken?: string);
+  private mutate;
+  private ensure;
+  status(options?: ChatCodeStatusOptions): Promise<ChatCodeAuthStatus>;
+  accessToken(signal?: AbortSignal): Promise<string | undefined>;
+  environmentTokenActive(): boolean;
+  startLogin(): Promise<ChatCodeLoginStart>;
+  logout(): Promise<void>;
+  cancelLogin(sessionId: string): Promise<void>;
+  waitForLogin(sessionId: string, signal?: AbortSignal): Promise<ChatCodeLoginState['state']>;
+  private finish;
+  private pollAndCommit;
+  private account;
+  private refresh;
+  private request;
+}
+//#endregion
+//#region src/startup-gate.d.ts
+type StartupGateFailure = {
+  ok: false;
+  kind: 'disabled';
+  host: string;
+  disabledReason: string;
+} | {
+  ok: false;
+  kind: 'error';
+  host: string;
+  reason: 'auth' | 'timeout' | 'network' | 'server' | 'invalid';
+  status?: number;
+};
+type StartupGateResult = {
+  ok: true;
+  host: string;
+} | StartupGateFailure;
+interface StartupGateCheckOptions {
+  request?: typeof fetch;
+  environment?: NodeJS.ProcessEnv;
+  readSettings?: () => Promise<unknown>;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    chatcodeStartupGate: ChatCodeStartupGateService;
+  }
+}
+/** Check one launch. Each call contacts CVP unless the explicit legacy bypass applies. */
+declare function checkChatCodeStartupGate(config: Config, options?: StartupGateCheckOptions): Promise<StartupGateResult>;
+/** Localize a failed launch without disclosing the CVP credential or response body. */
+declare function startupGateFailureMessage(failure: StartupGateFailure): string;
+/** Reusable Host service for CLI startup and Web boot admission. */
+declare class ChatCodeStartupGateService extends Service {
+  private readonly config;
+  constructor(ctx: Context, config: Config);
+  /** Read one authoritative CVP launch decision. */
+  check(): Promise<StartupGateResult>;
+  /** Present a failed decision without publishing credentials or raw response bodies. */
+  message(failure: StartupGateFailure): string;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "llm-chatcode-config";
+declare const inject: string[];
+declare const SETTINGS_NAMESPACE = "llm-chatcode-config";
+/** Optional, host-only refresh seam for terminal and browser clients. */
+interface ChatCodeModelCatalogApi {
+  /** Reload CodingPlan and, when enabled, MAAS routes into the LLM registry. */
+  refresh(): Promise<void>;
+  /** Current effective MAAS switch value. */
+  maasEnabled(): boolean;
+  /** Persist the MAAS switch and wait for the matching catalog refresh. */
+  setMaasEnabled(enabled: boolean): Promise<void>;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    chatcodeModelCatalog: ChatCodeModelCatalogService;
+  }
+}
+/**
+ * Keeps catalog I/O in the host bundle: clients ask for a registry refresh but
+ * never receive endpoint or credential-bearing runtime configuration.
+ */
+declare class ChatCodeModelCatalogService extends Service implements ChatCodeModelCatalogApi {
+  private readonly reload;
+  private readonly readMaas;
+  private writeMaas;
+  constructor(ctx: Context, reload: () => Promise<void>, readMaas: () => boolean);
+  refresh(): Promise<void>;
+  maasEnabled(): boolean;
+  setMaasEnabled(enabled: boolean): Promise<void>;
+  /** Bind the durable settings writer once the optional settings service mounts. */
+  bindMaasSettings(write: (enabled: boolean) => Promise<void>): void;
+}
+/** Register ChatCode model sources, account access, and operations reporting. */
+declare function apply(ctx: Context, config: Config): Promise<void>;
+//#endregion
+export { ChatCodeAuthService, ChatCodeModelCatalogApi, ChatCodeModelCatalogService, ChatCodeStartupGateService, Config, type CustomModel, type ModelKindRule, type ReportingConfig, SETTINGS_NAMESPACE, type StartupGateFailure, type StartupGateResult, apply, checkChatCodeStartupGate, inject, name, startupGateFailureMessage };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/config.ts","../src/chatcode-auth.ts","../src/startup-gate.ts","../src/index.ts"],"mappings":";;;;;;UAOiB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,gBAAgB;;;UAID;;EAEf;;EAEA,cAAc;;EAEd;;EAEA;;EAEA,cAAc;;EAEd;;IAEE;IACA;IACA;IACA;IACA;IACA;;;EAGF;;EAEA;IACE;IACA;;;EAGF,WAAW;;EAGX;;EAEA;;EAEA;;EAEA;;;UAIe,oBAAoB,KAAK,QAAQ;EAChD,OAAO,QAAQ;EACf,YAAY,QAAQ;EACpB,cAAc,QAAQ;;;cAIX,QAAQ,EAAE,aAAa;;;UC1FnB;EACf;EACA;EACA;;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;UAEO;EAAqB;EAAmB;;UACxC;;EAEf;;UAEe;EACf;EACA;EACA;EACA;EACA;EACA;;UAEe;EACf,OAAO,UAAU,wBAAwB,QAAQ;EACjD,cAAc,QAAQ;EACtB,YAAY,oBAAoB;EAChC,aAAa,mBAAmB,SAAS,cAAc,QAAQ;EAC/D,UAAU;;EAEV,YAAY,SAAS,cAAc;;EAEnC;;;YAUU;IAAU,cAAc;;;;cAwGvB,4BAA4B,mBAAmB;mBAYvC;mBACA;mBAZF;mBACA;mBACA;mBACA;;UAET;mBAES;EAGf,YAAA,KAAK,SACY,aAAa,oBACb,SAAS,qBAC1B;UAYY;UAaA;EA2CR,OAAO,UAAS,wBAA6B,QAAQ;EA2BrD,YAAY,SAAS,cAAc;EAQzC;EAIM,cAAc,QAAQ;EA2BtB,UAAU;EAUV,YAAY,oBAAoB;EAMhC,aAAa,mBAAmB,SAAS,cAAc,QAAQ;UAWvD;UAIA;UA6BA;UAWA;UAYA;;;;KCxYJ;EACN;EAAW;EAAkB;EAAc;;EAC3C;EAAW;EAAe;EAAc;EAA+D;;KACjG;EAAsB;EAAU;IAAiB;UAE5C;EACf,iBAAiB;EACjB,cAAc,OAAO;EACrB,qBAAqB;;;YAIX;IAAU,qBAAqB;;;;iBAqErB,yBAAyB,QAAQ,QAAQ,UAAS,0BAA+B,QAAQ;;iBAsC/F,0BAA0B,SAAS;;cAYtC,mCAAmC;mBACH;EAA/B,YAAA,KAAK,SAA0B,QAAQ;;EAGnD,SAAS,QAAQ;;EAGjB,QAAQ,SAAS;;;;cCpHN;cACA;cACA;;UAGI;;EAEf,WAAW;;EAEX;;EAEA,eAAe,mBAAmB;;;YAIxB;IAAU,sBAAsB;;;;;;;cAO/B,oCAAoC,mBAAmB;mBAK/C;mBACA;UALX;EAGN,YAAA,KAAK,SACY,cAAc,eACd;EAKnB,WAAW;EAIX;EAIM,eAAe,mBAAmB;;EASxC,iBAAiB,QAAQ,qBAAqB;;;iBAM1B,MAAM,KAAK,SAAS,QAAQ,SAAS"}