dsh-codex-community 0.0.1

package/package.json

@@ -0,0 +1,144 @@
+{
+  "name": "dsh-codex-community",
+  "version": "0.0.1",
+  "description": "DeepSeek Harness Codex 社区接入 / Community Codex integration for DeepSeek Harness",
+  "type": "module",
+  "license": "Apache-2.0",
+  "author": "YukiRyou",
+  "engines": {
+    "node": ">=22.19.0 <25"
+  },
+  "packageManager": "pnpm@10.34.5",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yoshino-xiao7/dsh-codex.git"
+  },
+  "homepage": "https://github.com/yoshino-xiao7/dsh-codex#readme",
+  "bugs": {
+    "url": "https://github.com/yoshino-xiao7/dsh-codex/issues"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "codex",
+    "chatgpt",
+    "oauth"
+  ],
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "default": "./dist/host/index.mjs"
+    },
+    "./client": {
+      "types": "./types/client.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./reliability": {
+      "types": "./types/reliability.d.ts",
+      "default": "./dist/internal/reliability.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "codex-community.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "dist",
+    "types",
+    "docs",
+    "codex-community.patch.yml",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "CONTRIBUTING.en.md",
+    "SECURITY.md",
+    "SUPPORT.md",
+    "LICENSE",
+    "NOTICE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "lint": "node scripts/check-syntax.mjs",
+    "typecheck": "tsc -p tsconfig.types.json",
+    "test": "node --test test/*.test.mjs",
+    "test:regression": "node --test test/failure-normalizer.test.mjs test/image-policy.test.mjs test/stream-resilience.test.mjs test/provider-reliability-public-api.test.mjs test/llm-runtime-integration.test.mjs test/codex-session-resources.test.mjs",
+    "smoke:dsh-profile": "node scripts/smoke-dsh-profile.mjs",
+    "check:i18n": "node scripts/check-i18n.mjs",
+    "check:pack": "node scripts/check-pack.mjs",
+    "generate:sbom": "node scripts/generate-sbom.mjs",
+    "release:prepare": "node scripts/prepare-release.mjs",
+    "release:candidate": "node scripts/build-release-candidate.mjs",
+    "release:acceptance": "node scripts/record-release-acceptance.mjs",
+    "verify:release": "node scripts/verify-release.mjs --mode=draft",
+    "verify:release:publish": "node scripts/verify-release.mjs --mode=publish",
+    "check": "npm run lint && npm run typecheck && npm run test && npm run build && npm run check:i18n && npm run check:pack",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run verify:release:publish"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.1 <5",
+    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-commands": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": ">=3.18.1 <4"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-commands": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-app-boot": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-attachment-local": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm-pi-ai": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tool-fs": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "typescript": "5.9.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "provenance": true
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-authorization": "0.1.1-rc.2",
+    "@earendil-works/pi-ai": "0.82.1"
+  }
+}

package/types/client.d.ts

@@ -0,0 +1,160 @@
+export declare const CHANNEL: "/dsh-codex"
+export declare const CODEX_PROVIDER: "dsh-codex"
+export declare const NS: "settings.codex"
+export declare const inject: readonly ["slots", "locale", "connection", "settingsScope"]
+
+export interface AuthorizationNotice {
+  message: string
+  url?: string
+  code?: string
+}
+
+export type AuthorizationPrompt =
+  | { kind: "text" | "secret"; message: string; placeholder?: string }
+  | {
+      kind: "select"
+      message: string
+      options: readonly { id: string; label: string; description?: string }[]
+    }
+
+export type AuthorizationEvent =
+  | { seq: number; type: "notice"; notice: AuthorizationNotice }
+  | { seq: number; type: "prompt"; promptId: string; prompt: AuthorizationPrompt }
+  | { seq: number; type: "prompt-closed"; promptId: string }
+  | { seq: number; type: "settled"; status: "authorized" | "cancelled" }
+  | { seq: number; type: "failed"; error: { code: string; message: string } }
+
+export interface AuthorizationStatus {
+  flow?: {
+    key: "dsh-codex/openai-codex"
+    label: string
+    methods: readonly { id: string; label: string }[]
+    inFlight: boolean
+  }
+  credential: {
+    configured: boolean
+    state: "signed-in" | "signed-out" | "invalid"
+    kind?: string
+    writable: boolean
+  }
+  quota:
+    | { readonly status: "unknown" }
+    | { readonly status: "recent-success"; readonly observedAt: number }
+    | {
+        readonly status: "exhausted"
+        readonly observedAt: number
+        readonly resetAt?: number
+      }
+}
+
+export interface AuthorizationClient {
+  describe(signal?: AbortSignal): Promise<AuthorizationStatus>
+  watch(attemptId: string, after: number, signal?: AbortSignal): Promise<{
+    attemptId: string
+    events: readonly AuthorizationEvent[]
+    nextSeq: number
+    done: boolean
+  }>
+  start(method?: string, signal?: AbortSignal): Promise<{ attemptId: string }>
+  answer(attemptId: string, promptId: string, value: string): Promise<{ accepted: boolean }>
+  decline(attemptId: string, promptId: string): Promise<{ accepted: boolean }>
+  cancel(attemptId?: string): Promise<{
+    accepted: boolean
+    reason?: "commit-in-progress"
+  }>
+  logout(): Promise<{ signedOut: boolean }>
+}
+
+export interface CodexModelCatalogEntry {
+  id: string
+  name?: string
+}
+
+export interface CodexModelEnablementSnapshot {
+  kind: "ready"
+  writable: boolean
+  revision: number
+  settingsNs: string
+  settingsPath: string[]
+  models: CodexModelCatalogEntry[]
+  catalogIds: string[]
+  selectedIds: string[]
+  configuredModels: Array<{ id: string; [key: string]: unknown }>
+}
+
+export interface ModelEnablementClient {
+  readonly available: boolean
+  load(signal?: AbortSignal): Promise<CodexModelEnablementSnapshot | { kind: "unavailable" }>
+  save(
+    snapshot: CodexModelEnablementSnapshot,
+    selectedIds: string[],
+    signal?: AbortSignal,
+  ): Promise<CodexModelEnablementSnapshot>
+  subscribe(listener: () => void): () => void
+}
+
+export interface SettingsNamespaceMirrorView {
+  ns: string
+  schema: unknown
+  value: unknown
+  base?: unknown
+  user?: unknown
+  applies: "live" | "restart"
+  secrets: readonly { path: readonly string[]; set: boolean }[]
+  revision: number
+}
+
+export interface SettingsDescribeFace {
+  getSnapshot(): {
+    status: "idle" | "loading" | "ready" | "unavailable"
+    view: {
+      namespaces: readonly SettingsNamespaceMirrorView[]
+      writable: boolean
+      hasDocument: boolean
+    } | undefined
+    error: string | null
+  }
+  subscribe(listener: () => void): () => void
+  ensure(): Promise<void>
+  acceptView(view: SettingsNamespaceMirrorView): void
+}
+
+export interface RpcConnection {
+  rpc: {
+    call(
+      channel: string,
+      endpoint: string,
+      payload: Record<string, unknown>,
+      signal?: AbortSignal,
+    ): Promise<{ ok: true; value: unknown } | { ok: false; error: { code: string; message: string } }>
+  }
+}
+
+export declare function createAuthorizationClient(connection: RpcConnection): AuthorizationClient
+export declare function createModelEnablementClient(
+  connection: unknown,
+  settingsFace?: SettingsDescribeFace,
+): ModelEnablementClient
+export declare function safeQuotaSnapshot(value: unknown, now?: number):
+  | { status: "unknown" }
+  | { status: "recent-success"; observedAt: number }
+  | {
+      status: "exhausted"
+      observedAt: number
+      resetAt?: number
+      remainingMinutes?: number
+    }
+export declare function AuthorizationSettings(props: {
+  client: AuthorizationClient
+  t(key: string): string
+}): unknown
+export declare function ModelEnablementSettings(props: {
+  client: ModelEnablementClient
+  t(key: string): string
+}): unknown
+export declare function CodexSettings(props: {
+  client: AuthorizationClient
+  modelClient: ModelEnablementClient
+  t(key: string): string
+}): unknown
+export declare function apply(ctx: unknown): void

package/types/index.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from "@deepseek-ai/cordis"
+import type Schema from "@deepseek-ai/schemastery"
+
+export interface Config {
+  partialResponseRecovery?: boolean
+  models?: Array<{
+    id: string
+    name?: string
+    contextWindow?: number
+    maxTokens?: number
+  }>
+  cacheRetention?: "none" | "short" | "long"
+  streamIdleTimeoutMs?: number
+  maxRequestImageBytes?: number
+  requestImagePixelBudget?: number
+  requestImageMaxBytes?: number
+}
+
+export declare const name: "dsh-codex"
+export declare const inject: readonly ["llm", "authorization", "credentials"]
+export declare const Config: Schema<Config>
+export declare function apply(ctx: Context, config?: Config): void

package/types/reliability.d.ts

@@ -0,0 +1,78 @@
+import type { GenerateOptions, LlmFailure, StreamChunk } from "@deepseek-ai/dsh-llm"
+
+export interface ResolvedImagePolicy {
+  readonly maxRequestImageBytes: number
+  readonly requestImagePixelBudget: number
+  readonly requestImageMaxBytes: number
+}
+
+export interface AttachmentRequestPolicy {
+  readonly maxPixels: number
+  readonly maxBytes: number
+}
+
+export interface CodexFailureFacts {
+  readonly kind: "account-quota" | "ambiguous-limit" | "transport" | "other"
+  readonly status?: number
+  readonly reset?: {
+    readonly raw: string
+    readonly epochMs?: number
+    readonly iso?: string
+  }
+  readonly requestId?: string
+}
+
+export interface NormalizedCodexFailure {
+  readonly changed: boolean
+  readonly failure: LlmFailure
+  readonly facts: CodexFailureFacts
+}
+
+export type CodexQuotaSnapshot =
+  | { readonly status: "unknown" }
+  | { readonly status: "recent-success"; readonly observedAt: number }
+  | {
+      readonly status: "exhausted"
+      readonly observedAt: number
+      readonly resetAt?: number
+    }
+
+export interface CodexQuotaObserver {
+  observeSuccess(now: number): CodexQuotaSnapshot
+  observeQuota(observation: { observedAt: number; resetAt?: number }): CodexQuotaSnapshot
+  snapshot(): CodexQuotaSnapshot
+}
+
+export declare const DEFAULT_IMAGE_POLICY: ResolvedImagePolicy
+export declare function resolveImagePolicy(input?: Partial<ResolvedImagePolicy>): ResolvedImagePolicy
+export declare function toAttachmentRequestPolicy(input?: Partial<ResolvedImagePolicy>): AttachmentRequestPolicy
+export declare function parseEmbeddedJsonObjects(text: string): Record<string, unknown>[]
+export declare function inspectCodexFailure(failure: LlmFailure | unknown): CodexFailureFacts
+export declare function normalizeCodexFailure(failure: LlmFailure): NormalizedCodexFailure
+export declare function createQuotaObserver(options?: {
+  clock?: () => number
+  staleMs?: number
+  maxResetHorizonMs?: number
+}): CodexQuotaObserver
+export declare function stabilizeCodexStream(
+  options: GenerateOptions,
+  next: () => AsyncIterable<StreamChunk>,
+  config?: {
+    partialResponseRecovery?: boolean
+    onRecovery?: (detail: {
+      provider: string
+      model: string
+      code: string
+      requestId?: string
+    }) => void
+    onQuota?: (detail: {
+      provider: string
+      model: string
+      resetAt?: number
+    }) => void
+    onSuccess?: (detail: {
+      provider: string
+      model: string
+    }) => void
+  },
+): AsyncIterable<StreamChunk>