@plurnk/plurnk-providers 1.18.0 → 1.19.0

package/src/errors.test.ts

@@ -15,7 +15,7 @@ const apiError = (statusCode: number, responseBody = "body") => new APICallError
 
 const SOURCE_PATTERN = /^[a-z]+(:[a-z][a-z0-9-]*)?$/;
 
-test("HTTP request rejection preserves its cause without becoming a response-contract strike", () => {
+test("{§provider-request-rejection} HTTP request rejection preserves its cause without becoming a response-contract strike", () => {
     for (const status of [400, 404, 405, 422]) {
         const message = "The requested model is not available on this endpoint.";
         const cause = apiError(status, JSON.stringify({ error: { message } }));
@@ -54,7 +54,7 @@ test("classifyProviderError maps HTTP status to kind", () => {
     assert.equal(k(404), "request_rejected");
 });
 
-test("capacity normalization prefers structured provider codes and keeps generic 400s distinct", () => {
+test("{§provider-capacity-failure} capacity normalization prefers structured provider codes and keeps generic 400s distinct", () => {
     const openai = apiError(400, JSON.stringify({
         error: {
             type: "invalid_request_error",

package/src/index.ts

@@ -78,7 +78,6 @@ export {
 } from "./cost.ts";
 export {
     aggregateProviderAccounting,
-    plurnkCostNormalizer,
     providerCostNormalizer,
     validateProviderRequestAccounting,
 } from "./accounting.ts";

package/src/inputModalities.test.ts

@@ -16,6 +16,7 @@ const parts: ChatMessage = {
         { type: "text", text: "look at this" },
         { type: "file", data: PNG, mediaType: "image/png" },
         { type: "file", data: PDF, mediaType: "application/pdf" },
+        { type: "file", data: new Uint8Array([82, 73, 70, 70]), mediaType: "audio/wav" },
     ],
 };
 
@@ -37,7 +38,7 @@ test("{§provider-input-modalities} the Mock declares modalities by option and r
     const seeing = new Mock({ contextWindow: 200000, responses: [], inputModalities: ["image", "pdf"] });
     assert.ok(seeing.inputModalities.has("image") && seeing.inputModalities.has("pdf") && !seeing.inputModalities.has("audio"));
     assert.equal(tokensOf(await seeing.countPromptTokens([parts])), Math.ceil("look at this".length / 2));
-    await assert.rejects(seeing.generate({ messages: [parts], maxOutputTokens: 16, workerId: "1", primaryWorkerId: "1", callKind: "bare" } as never));
+    await assert.rejects(seeing.generate({ messages: [parts], maxOutputTokens: 16, workerId: "1", callKind: "bare" } as never));
     assert.equal(seeing.received.length, 1, "the request was recorded before the empty queue refused it");
     const received = seeing.received[0]?.[0]?.content;
     assert.ok(Array.isArray(received) && received[1]?.type === "file" && received[1].mediaType === "image/png" && received[2]?.type === "file" && received[2].mediaType === "application/pdf");

package/src/sdkModels.test.ts

@@ -103,7 +103,7 @@ test("{§model-catalog-readiness}: an authenticated operator declaration reports
     );
 });
 
-test("createSdkModel uses Models.dev provider facts and operator credentials", () => {
+test("{§provider-sdk-boundary} createSdkModel uses Models.dev provider facts and operator credentials", () => {
     const sdk = createSdkModel("xai", "grok-build-0.1", { XAI_API_KEY: "test-key" });
     assert.notEqual(sdk, null);
     assert.equal(sdk?.catalog?.npm, "@ai-sdk/xai");

package/src/types.ts

@@ -230,16 +230,13 @@ export type ProviderAttempt = ProviderResponse<ProviderAttemptFinishReason>;
 export interface ProviderGenerateArgs {
     readonly messages: ChatMessage[];
     readonly workerId: string;
-    readonly primaryWorkerId?: string;
     readonly signal?: AbortSignal;
     readonly grammar?: string;
     readonly maxOutputTokens?: number;
-    readonly attributions?: string[];
-    readonly client?: string;
-    readonly strikes?: number;
+    // The workspace this call serves: ordinary call context for an adapter that
+    // fronts more than one workspace. It is never transported to a backend and
+    // never model-facing.
     readonly workspaceId?: string;
-    readonly loop?: number;
-    readonly turn?: number;
     readonly sampling?: Record<string, unknown>;
     readonly observeRequest?: ProviderRequestObserver;
     readonly observeReasoning?: ProviderReasoningObserver;
@@ -265,42 +262,18 @@ export interface Provider {
     // its content. The consumer never sees or chooses backend resources
     // (slot integers, connections); the mechanism is the provider's.
     //
-    // `attributions` is opaque consumer-supplied creator telemetry; the consumer
-    // owns what contribution that set claims ({§attribution}). `client` is the
-    // consumer's workspace-stable, self-identified frontend. They are forwarded ONLY by a
-    // provider whose spec opts in (the first-party `plurnk` endpoint, via
-    // `Plurnk-Attribution` / `Plurnk-Client` headers); every other provider DROPS
-    // them — the gate is structural so first-party metadata can never leak to a
-    // third-party backend.
-    //
     // `sampling` is an optional bag of standard OpenAI-compat sampling params
     // (temperature, top_p, top_k, min_p, penalties, stop, seed, …) forwarded into
     // the request body UNDER the provider's managed fields — model/messages/grammar/
     // reasoning/max_tokens/slot always win, and transport/protocol keys (stream,
     // response_format, grammar, id_slot) are stripped, so it carries sampling intent
     // only and can't bypass grammar transport ({§provider-request-authority}). A
-    // proxy consumer (the
-    // plurnk endpoint fronting its own backends) uses it to pass its caller's sampling
-    // knobs through; a direct consumer typically leaves it unset.
-    //
-    // `strikes` is the worker's CURRENT rail-strike streak at time-of-generate
-    // (0 = clean; a clean turn zeroes it; every loop starts at 0 — contract
-    // {§strikes-first-party-metadata}). Forwarded as a `Plurnk-Strikes` header ONLY under the
-    // same firstPartyMetadata gate as attributions/client; dropped everywhere
-    // else. Headers only — the packet NEVER carries strike state (the model must
-    // not see engine accounting; it would become a metric to game).
-    //
-    // `workspaceId`/`loop`/`turn` are the turn coordinate ({§lifecycle-terms}) — the
-    // daemon-side sequence of the turn being generated, which the endpoint can
-    // never scrape from the wire. Forwarded as `Plurnk-Workspace-Id`/`Plurnk-Loop`/
-    // `Plurnk-Turn` ONLY under the same firstPartyMetadata gate; dropped
-    // everywhere else. Coordinates are 1-based: absent/0 emits no header (no
-    // strikes-style zero exception). Headers only, never the packet.
+    // proxy consumer fronting its own backends uses it to pass its caller's
+    // sampling knobs through; a direct consumer typically leaves it unset.
     //
-    // `callKind` is the caller's explicit output contract. It is transported as
-    // `Plurnk-Call-Kind` only under the first-party metadata gate and never
-    // inferred from the request shape. Generic callers may omit it; Core always
-    // supplies `emission` or `bare`.
+    // `callKind` is the caller's explicit output contract, never inferred from
+    // the request shape. Generic callers may omit it; Core always supplies
+    // `emission` or `bare`.
     generate(args: ProviderGenerateArgs): Promise<ProviderResponse>;
     // {§model-fact-resolution} — effective total context envelope in tokens,
     // including any stricter operator cap. `null` means unknown; under