dsh-llm-omp-transports 0.0.0-stage → 0.2.2

package/README.md

@@ -1,3 +1,148 @@
-# Temporary Holding Version
+# dsh-llm-omp-transports
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A DeepSeek Harness LLM transport component for providers whose wire protocols
+the vendored `llm-pi-ai` does not speak. It is published from this repository
+as `dsh-llm-omp-transports` and installed as a dependency of
+`dsh-keys-manager`: installing the Keys Manager plugin brings this component,
+and the plugin page lists both bundle components
+(`dsh-keys-manager` and `llm-omp-transports`).
+
+| Fact | Value |
+|---|---|
+| npm package | `dsh-llm-omp-transports` |
+| Plugin id | `llm-omp-transports` |
+| Route | `cursor` (first provider; the seam is provider-generic) |
+| Credential scope | `llm-omp-transports/<provider>`, today `llm-omp-transports/cursor` |
+| Runtime | Node 24 (the bundle imports Node builtins only) |
+| License | MIT |
+
+The plugin registers its own route on the DSH `llm` seam, so it depends on no
+upstream DSH change. `@oh-my-pi/pi-ai` and `@oh-my-pi/pi-catalog` are used at
+**build time only**: the build inlines the pinned omp Cursor transport into one
+ESM artifact (`lib/omp/cursor.mjs`), and the published package imports nothing
+from `@oh-my-pi/*` or `bun:*` at runtime.
+
+## Cursor support status
+
+- **Text streaming** — yes. Assistant text and usage are projected onto DSH's
+  `StreamChunk` stream.
+- **Reasoning streaming** — yes, with the catalog's effort routing. The
+  selected effort becomes the routed wire model id; an effort the model does
+  not advertise is refused with `UNSUPPORTED_REASONING_EFFORT`.
+- **Tool-call handoff** — yes, through DSH's tool loop. Cursor's server drives
+  execution over its exec channel, so the transport runs in external-executor
+  mode: an unhandled MCP call is emitted as an unresolved tool call and
+  answered with a handoff, DSH runs the tool, and the next request replays the
+  result from history. The adapter never executes a tool itself.
+- **Sign-in and refresh** — yes. The package registers the
+  `llm-omp-transports/cursor` authorization flow (a browser login page plus a
+  poll, no loopback callback and no device code) and refreshes an expiring
+  grant under the credential store's per-key lock. The Keys Manager Web page's
+  **Transport accounts** section is the surface that starts the flow.
+- **Models** — from the pinned catalog: the Cursor slice of
+  `@oh-my-pi/pi-catalog@18.12.3` (123 rows) is generated into
+  `src/catalog/cursor.ts` and served without a network call.
+- **Route** — `cursor`, declared configurable so the Models page has a profile
+  entry for it.
+- **Images** — not yet. The route advertises text-only input and refuses image
+  blocks with `CONTENT_UNSUPPORTED`; see [known limits](docs/known-limits.md).
+
+## Hard constraints
+
+- **Pinned, build-time-only omp.** `@oh-my-pi/pi-ai` and `@oh-my-pi/pi-catalog`
+  are pinned to `18.12.3` and declared as devDependencies. No runtime package
+  may import them: `tests/build.test.ts` checks that every static import of the
+  shipped artifact is a Node builtin.
+- **Node 24 load.** The artifact is imported through a plain Node ESM loader
+  with no Bun global present, and must expose `streamCursor`. The Bun and
+  `@oh-my-pi/pi-utils` surface the bundled graph reaches is covered by the
+  shims in `scripts/omp-shim/`; a missing shim symbol or a new shim category
+  fails the build.
+- **Drift gate.** `scripts/omp-manifest.json` records the pinned versions, the
+  measured artifact, the shim surface and the hashes of every source the
+  transport depends on, plus the shim symbols the esbuild graph actually
+  reaches. `tests/build.test.ts` re-checks all of it, and CI asserts the
+  committed manifest is unchanged after a build, so an omp bump that changes
+  the contract shows up as a reviewable manifest diff before it can reach a
+  request.
+- **Generated catalog.** The Cursor model table is generated from the pinned
+  catalog and is not hand-edited. An omp or catalog bump requires
+  `pnpm -C packages/llm-omp run generate:catalog`.
+
+## Limits and risks
+
+- **Unofficial Cursor client.** The transport reuses Cursor's vendor-internal
+  OAuth client id and announces a released CLI build through the
+  `x-cursor-client-version` / `x-cursor-client-type` request identity. The MIT
+  license covers the code, not the service, so relying on this client carries a
+  terms-of-service (ToS) risk. If Cursor gates non-IDE clients (a `401`/`403`
+  on `Run` with a valid account), this transport stops until the product
+  decision recorded as stop condition **S4**.
+- **Real endpoints unverified.** The login, poll, refresh and agent endpoint
+  shapes are ported from the pinned omp sources; this repository's tests replay
+  recorded fixtures and never call Cursor, so live behavior is unverified until
+  it is exercised against a real account.
+- **In-process checkpoint cache.** Per-conversation checkpoints live in a
+  module-level, in-process LRU (128 conversations) inside the bundled omp
+  transport. Nothing is persisted: an evicted or lost checkpoint rebuilds from
+  the request history, exactly like the first request after a restart, and a
+  multi-step tool turn must replay its history.
+- **Image input is advertised as text-only.** Forwarding is future work; until
+  it lands the projection refuses non-text blocks instead of silently dropping
+  them. 100 of the pinned catalog's 123 rows claim image support but are
+  advertised text-only.
+- **Tool handoff uses DSH's external-executor mode.** A turn that needs a tool
+  stops at the handoff; the result is only replayed on the follow-up request.
+  Tool declarations travel as MCP definitions, and `toolHistory` is accepted
+  but cannot be replayed (the active tool set is the projection).
+- **Only MCP calls are handed off.** Cursor-native exec frames (`read`, `shell`,
+  `write`, `delete`, `grep`, `ls`, `diagnostics`, streamed edits) are answered
+  by the transport with `Tool not available` and are **not** executed by DSH
+  (live reachability unverified).
+- **Advisory request knobs are ignored.** Cursor's agent protocol has no field
+  for an output cap, sampling temperature, stop sequences or an auxiliary-call
+  purpose; DSH's `maxTokens`, `temperature`, `stop` and `purpose` never reach
+  the wire, and Cursor applies the catalog output limit server-side.
+
+## Develop and test
+
+```sh
+pnpm -C packages/llm-omp typecheck
+pnpm -C packages/llm-omp build
+pnpm -C packages/llm-omp test
+pnpm -C packages/llm-omp run generate:catalog
+```
+
+`build` bundles the pinned omp graph from `scripts/omp-entry.ts` into
+`lib/omp/cursor.mjs` and rewrites `scripts/omp-manifest.json`; run it before
+`test` after a pin or shim change. CI runs the same sequence and then fails if
+the committed manifest drifted.
+
+The install proof lives at the repository root and needs `pnpm` and `dsh` on
+`PATH`:
+
+```sh
+node scripts/verify-install.mjs
+```
+
+It packs both packages, installs the root tarball into a fresh DSH profile,
+and asserts that the composed profile carries both loader rows
+(`dsh-keys-manager` and `llm-omp-transports`). It does not exercise the
+plugin-manager UI or any Cursor network behavior.
+
+## Release
+
+This package is released from the same release PR and carries the same version
+as `dsh-keys-manager`; the root `CHANGELOG.md` and its generated sections cover
+the root package only. A release-prep run writes one version to both
+`package.json` files, and the Release workflow publishes both and pushes the
+`dsh-llm-omp-transports@<version>` tag.
+The root [release docs](../../docs/release.md) describe the full flow.
+
+Package documentation is English-only; the root `README.md` /
+`README.zh-CN.md` and the root `docs/*.zh-CN.md` files carry the bilingual
+plugin surface.
+
+## License
+
+Released under the [MIT License](../../LICENSE).

package/bundle/cordis.patch.yml

@@ -0,0 +1,6 @@
+# Mounts the llm-omp-transports transport plugin when this package is installed on its
+# own. It owns the `cursor` (later `devin`, …) LLM routes and the
+# `llm-omp-transports/<provider>` credential scope.
+- insert:
+    - id: llm-omp-transports
+      name: 'dsh-llm-omp-transports'

package/lib/adapter.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Adapter for the omp-owned `cursor` route.
+ *
+ * The route speaks Cursor's own agent protocol (`agent.v1.AgentService/Run`
+ * over HTTP/2) through the omp build artifact in `lib/omp/cursor.mjs`. The
+ * transport is injected rather than imported so this module stays free of the
+ * 14 MB build artifact and tests can replay recorded event scripts. The plugin
+ * wires the bundled `streamCursor` at registration and the credential seam
+ * provides {@link OmpCursorAdapterConfig.access}, which refreshes an expiring
+ * grant under the store's lock before it answers.
+ *
+ * The catalog is the generated `src/catalog/cursor.ts`, so `listModels` and
+ * `resolveModel` answer without a network call and carry the transport flags the
+ * projection needs (effort routing, max mode, glyph tokenization).
+ *
+ * @module dsh-llm-omp-transports/adapter
+ */
+import { LlmAdapter } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, LlmModelInfo, LlmProviderInfo, LlmResolvedModelInfo, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { OmpCursorTransport } from './omp.js';
+/** The provider route this adapter owns. */
+export declare const CURSOR_ROUTE = "cursor";
+/** Machine code for a model id the generated catalog does not contain. */
+export declare const UNKNOWN_MODEL = "UNKNOWN_MODEL";
+/** Machine code for a provider route this adapter does not serve. */
+export declare const UNKNOWN_PROVIDER = "UNKNOWN_PROVIDER";
+/** What the adapter needs from its host plugin. */
+export interface OmpCursorAdapterConfig {
+    /**
+     * Resolve the Cursor bearer token for one request.
+     *
+     * @remarks
+     * Asynchronous because it reads and refreshes the `llm-omp-transports/cursor`
+     * credential through the credentials seam. The request signal is forwarded
+     * so an aborted turn can abandon a refresh instead of writing it late. Tests
+     * inject a fake.
+     */
+    access: (signal?: AbortSignal) => Promise<string>;
+    /**
+     * The omp transport, normally the `streamCursor` export of
+     * `lib/omp/cursor.mjs`. The seam tests drive it with recorded event scripts.
+     */
+    transport: OmpCursorTransport;
+}
+/** The DSH llm adapter for every route this plugin's omp transport serves. */
+export declare class OmpCursorAdapter extends LlmAdapter {
+    private readonly config;
+    constructor(config: OmpCursorAdapterConfig);
+    /**
+     * Describe the route.
+     *
+     * @remarks
+     * Cursor's agent protocol takes no client-side output cap, sampling
+     * temperature, stop sequence or auxiliary-call purpose: the wire carries no
+     * field for any of them, so the projection ignores those `GenerateOptions`
+     * values instead of forwarding them. Cursor applies the catalog `maxTokens`
+     * limit server-side.
+     */
+    providerInfo(provider: string): LlmProviderInfo;
+    listModels(provider: string): Promise<readonly LlmModelInfo[]>;
+    resolveModel(provider: string, model: string): Promise<LlmResolvedModelInfo>;
+    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
+    private call;
+}

package/lib/adapter.js

@@ -0,0 +1,167 @@
+/**
+ * Adapter for the omp-owned `cursor` route.
+ *
+ * The route speaks Cursor's own agent protocol (`agent.v1.AgentService/Run`
+ * over HTTP/2) through the omp build artifact in `lib/omp/cursor.mjs`. The
+ * transport is injected rather than imported so this module stays free of the
+ * 14 MB build artifact and tests can replay recorded event scripts. The plugin
+ * wires the bundled `streamCursor` at registration and the credential seam
+ * provides {@link OmpCursorAdapterConfig.access}, which refreshes an expiring
+ * grant under the store's lock before it answers.
+ *
+ * The catalog is the generated `src/catalog/cursor.ts`, so `listModels` and
+ * `resolveModel` answer without a network call and carry the transport flags the
+ * projection needs (effort routing, max mode, glyph tokenization).
+ *
+ * @module dsh-llm-omp-transports/adapter
+ */
+import { LlmAdapter, LlmError, ReasoningEffortId, assertUsableApiKey } from '@deepseek-ai/dsh-llm';
+import { CURSOR_MODELS } from './catalog/cursor.js';
+import { CURSOR_CREDENTIAL_KEY } from './cursor/credentials.js';
+import { abortedFinish, projectEvents, projectRequest } from './projection.js';
+/** The provider route this adapter owns. */
+export const CURSOR_ROUTE = 'cursor';
+/** Machine code for a model id the generated catalog does not contain. */
+export const UNKNOWN_MODEL = 'UNKNOWN_MODEL';
+/** Machine code for a provider route this adapter does not serve. */
+export const UNKNOWN_PROVIDER = 'UNKNOWN_PROVIDER';
+/**
+ * Input modalities every advertised row carries.
+ *
+ * shortcut: the projection carries text only and refuses every non-text block
+ * with `CONTENT_UNSUPPORTED`, so advertising the catalog row's `input` verbatim
+ * (100 of 123 rows say `image`) would promise a turn this route fails after
+ * DSH's own image→text fallback is skipped. Task 2/3 add image forwarding; that
+ * is when `row.input` becomes advertisable again.
+ */
+const INPUT_MODALITIES = ['text'];
+/** Display names for the catalog's reasoning efforts. */
+const EFFORT_NAMES = {
+    minimal: 'Minimal',
+    low: 'Low',
+    medium: 'Medium',
+    high: 'High',
+    xhigh: 'Extra high',
+    max: 'Max',
+};
+/** The generated catalog, indexed for exact-model resolution. */
+const MODELS_BY_ID = new Map(CURSOR_MODELS.map(row => [row.id, row]));
+/** The DSH llm adapter for every route this plugin's omp transport serves. */
+export class OmpCursorAdapter extends LlmAdapter {
+    config;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Describe the route.
+     *
+     * @remarks
+     * Cursor's agent protocol takes no client-side output cap, sampling
+     * temperature, stop sequence or auxiliary-call purpose: the wire carries no
+     * field for any of them, so the projection ignores those `GenerateOptions`
+     * values instead of forwarding them. Cursor applies the catalog `maxTokens`
+     * limit server-side.
+     */
+    providerInfo(provider) {
+        return { id: provider, name: 'Cursor' };
+    }
+    async listModels(provider) {
+        assertRoute(provider);
+        return CURSOR_MODELS.map(row => ({
+            provider,
+            id: row.id,
+            name: row.name,
+            inputModalities: [...INPUT_MODALITIES],
+        }));
+    }
+    async resolveModel(provider, model) {
+        assertRoute(provider);
+        return modelInfo(provider, rowFor(model));
+    }
+    stream(options) {
+        return this.call(options);
+    }
+    async *call(options) {
+        // Read the live signal each time: it can abort while the credential is read.
+        const aborted = () => options.signal?.aborted === true;
+        // An already-cancelled turn must not pay a credential read (nor, once the
+        // resolver refreshes, a CAS write) or open a stream.
+        if (aborted()) {
+            yield abortedFinish();
+            return;
+        }
+        const row = rowFor(options.model);
+        // Validate and project before touching the credential: a refused request
+        // must not pay a credential read (nor, once the resolver refreshes, a CAS
+        // write). Only a request that can be served resolves `access` and carries
+        // its token into the transport options.
+        const request = projectRequest(row, options);
+        let credential;
+        try {
+            credential = await this.config.access(options.signal);
+        }
+        catch (error) {
+            // The resolver rejects when the caller aborts (a refresh is abandoned,
+            // not failed), so that rejection is the turn's cancellation. A genuine
+            // credential failure has no aborted signal and still propagates.
+            if (!aborted())
+                throw error;
+            yield abortedFinish();
+            return;
+        }
+        const accessKey = assertUsableApiKey(credential, 'llm-omp-transports', CURSOR_CREDENTIAL_KEY);
+        if (aborted()) {
+            yield abortedFinish();
+            return;
+        }
+        const transportOptions = { ...request.options, apiKey: accessKey };
+        yield* projectEvents(this.config.transport(request.model, request.context, transportOptions), options.signal);
+    }
+}
+/** Resolve one catalog row, refusing ids the pinned catalog does not serve. */
+function rowFor(model) {
+    const row = MODELS_BY_ID.get(model);
+    if (row === undefined) {
+        throw new LlmError(`llm-omp-transports: the cursor route has no model "${model}"`, UNKNOWN_MODEL);
+    }
+    return row;
+}
+/** Refuse routes this adapter does not own instead of describing another provider's models. */
+function assertRoute(provider) {
+    if (provider !== CURSOR_ROUTE) {
+        throw new LlmError(`llm-omp-transports: the cursor adapter does not serve provider "${provider}"`, UNKNOWN_PROVIDER);
+    }
+}
+/** Build the seam's exact-model metadata from one catalog row. */
+function modelInfo(provider, row) {
+    const efforts = row.thinking?.efforts ?? [];
+    return {
+        provider,
+        id: row.id,
+        name: row.name,
+        inputModalities: [...INPUT_MODALITIES],
+        context: { contextWindow: row.contextWindow },
+        // No `defaultMaxTokens`. The seam materializes that number into `maxTokens`
+        // on every request that omits one, and Cursor's wire has no per-request
+        // output-cap field: the projection ignores `maxTokens` rather than
+        // forwarding it, so advertising a default would only promise a cap nothing
+        // enforces. Cursor applies the catalog cap server-side, from the `maxTokens`
+        // the model object already carries.
+        // Every effort list is advertised exactly as the catalog declares it. On a
+        // row with no `effortRouting` entry each advertised effort resolves to the
+        // same wire id — the row's own — so those selections are wire-level no-ops,
+        // exactly as in omp.
+        ...(efforts.length > 0
+            ? {
+                reasoning: {
+                    efforts: efforts.map(effort => ({
+                        id: ReasoningEffortId(effort),
+                        name: EFFORT_NAMES[effort] ?? effort,
+                    })),
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/catalog/cursor.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generated Cursor model table — do not edit by hand.
+ *
+ * Source: `@oh-my-pi/pi-catalog@18.12.3` `src/models.json` key `cursor`
+ * (123 rows, sha256:39fb09654ee3812043bc062e426d8e7aa13cd273435fa7b8a203a76246c8735c). Regenerate with `pnpm -C packages/llm-omp run generate:catalog`.
+ *
+ * The drift gate in `tests/build.test.ts` pins the same package version and
+ * source hash, so an omp bump fails there before this table can describe the
+ * wrong models.
+ *
+ * Rows that advertise efforts without routing them are carried unchanged, and
+ * on each of them every advertised effort resolves to the same wire id (the
+ * row's own, `requestModelId ?? id`): selecting one is a wire-level no-op,
+ * exactly as in omp. No row's effort list is filtered.
+ *
+ * @module dsh-llm-omp-transports/catalog/cursor
+ */
+import type { CursorModelRow } from '../omp.js';
+/** Provenance of {@link CURSOR_MODELS}. */
+export declare const CURSOR_CATALOG_SOURCE: {
+    readonly package: "@oh-my-pi/pi-catalog";
+    readonly version: "18.12.3";
+    readonly file: "src/models.json";
+    readonly key: "cursor";
+    readonly sourceHash: "sha256:39fb09654ee3812043bc062e426d8e7aa13cd273435fa7b8a203a76246c8735c";
+    readonly rowCount: 123;
+};
+/** Every Cursor model the pinned catalog serves, sorted by id. */
+export declare const CURSOR_MODELS: readonly CursorModelRow[];