@volter/twin-openrouter 0.1.0

package/src/openrouter-types.ts

@@ -0,0 +1,49 @@
+// Type-only edge to the scenario module (erased at build — no runtime import cycle).
+import type { OpenRouterScenarioEngine } from './openrouter-scenario.ts';
+
+export type SseEvent = { data?: Record<string, unknown>; done?: boolean };
+export type SseSink = (event: SseEvent) => void;
+
+export type OpenRouterRequest = {
+  method: string;
+  path: string;
+  body?: string;
+  root?: string;
+  readOnly?: boolean;
+  occurredAt?: string;
+  /** Caller disconnect/cancellation, if this request entered through the Fetch adapter. */
+  signal?: AbortSignal;
+  sseSink?: SseSink;
+  /** The pack's scenario engine, mounted by the fetch adapter when a world dir carries a
+   *  handlers/openrouter.json. Absent → the labeled deterministic stub answers, unchanged. */
+  scenarioEngine?: OpenRouterScenarioEngine;
+};
+
+export type OpenRouterResponse = { status: number; body: unknown; headers?: Record<string, string> };
+
+export type ChatMessage = {
+  role: string;
+  content?: unknown;
+  tool_calls?: unknown;
+  cache_control?: unknown;
+};
+
+export type GenerationStat = {
+  id: string;
+  object: 'generation';
+  api_type: 'chat';
+  model: string;
+  provider_name: string;
+  created_at: string;
+  request_id: string;
+  finish_reason: string;
+  native_finish_reason: string;
+  total_cost: number;
+  tokens_prompt: number;
+  tokens_completion: number;
+  native_tokens_prompt: number;
+  native_tokens_completion: number;
+  usage: number;
+  app_id: number | null;
+  streamed: boolean;
+};

package/test-fixtures/openrouter-openapi-operations.SOURCE.md

@@ -0,0 +1,16 @@
+# openrouter-openapi-operations.json — provenance
+
+The operation-inventory denominator for `../openrouter-spec-census.json`: a scope-filtered subset of
+the vendor's published spec, enumerated by `deriveFromOpenAPI` (`packages/world-tooling/src/derive.ts`).
+
+- **Upstream:** https://openrouter.ai/openapi.json — `openapi.json`.
+- **How it was built:** `bun scripts/spec-census-bootstrap.ts --vendor openrouter --from-file <openapi.json> --scope-paths /analytics,/audio,/auth,/byok,/chat/,/credits,/datasets,/embeddings,/files,/generation,/guardrails,/key,/messages,/models,/observability/destinations,/organization/members,/presets,/providers,/rerank,/responses,/videos,/workspaces --apply`
+  over a copy of the upstream file fetched 2026-09-02; operation metadata only (operationId, summary, tags,
+  servers), schemas and response codes dropped. The gate never fetches — refreshing the fixture is
+  `bun scripts/spec-refresh.ts --vendor openrouter --from-file <newer spec> --apply` over a newly fetched copy.
+- **Scope (83 of 101 upstream operations):** every operation whose path starts with one of
+  `/analytics`, `/audio`, `/auth`, `/byok`, `/chat/`, `/credits`, `/datasets`, `/embeddings`, `/files`, `/generation`, `/guardrails`, `/key`, `/messages`, `/models`, `/observability/destinations`, `/organization/members`, `/presets`, `/providers`, `/rerank`, `/responses`, `/videos`, `/workspaces`.
+- **Mapping at birth:** 59 operations mapped to done capability ids by the rules in `scripts/spec-census-map.ts`
+  behind the static served-surface probe; 24 left `unmapped`. The census, not this file, records what
+  happened next: hand rulings (a `$ruled` marker, a remap) and the per-operation probe's demotions
+  (`$probeComment`). This fixture changes only through a spec refresh.