@north-light/api 0.3.501 → 0.3.503

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.16";
+export declare const CONTRACT_LEVEL = "1.17";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -12,7 +12,7 @@
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export const CONTRACT_LEVEL = '1.16';
+export const CONTRACT_LEVEL = '1.17';
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export const REQUIRED_CONTRACT_HEADER = 'Crouter-Required-Contract';
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/dto/grants.d.ts

@@ -22,9 +22,9 @@ export interface GrantGetDTO {
         mode: 'always' | 'ask';
     }[];
     spend_cap: number | null;
-    payer: 'user';
+    payer: 'user' | 'app';
     /** `{ <setup id>: ProviderDependency }` (a setup id is a provider id such as `context`, or a dotted level such as `context.deep`) as the directory's grant sync carried it; `{}` when the grantee has none. The daemon performs no `requires` check: an app follows this with the SDK grant watch (`oauth.watchGrants`, or `grant.get` with `wait`/`since`) and refuses its own operation with `provider_setup_pending`. When an entry's `state` is not `ready`, show its `message` (the provider's own sentence, when it has one) and send the person to its `next` (the directory's setup page; not for `unavailable`, where there is nothing for them to do) — never copy the provider's prose into the app. */
     dependencies: Record<string, ProviderDependency>;
-    /** Opaque; changes exactly when `rev`, `resolved_scopes`, `spend_cap`, `payer` or `dependencies` changes (never on a periodic sync alone or a new token). Pass it back as `since` with `wait` to hold the read until it changes. */
+    /** Opaque; changes exactly when `rev`, `resolved_scopes`, `spend_cap`, `payer`, `inference_endpoint` or `dependencies` changes (never on a periodic sync alone or a new token). Pass it back as `since` with `wait` to hold the read until it changes. */
     version: string;
 }

package/dist/api/dto/run-events.d.ts

@@ -94,7 +94,7 @@ export interface RunStartedEvent extends RunEventBaseDTO {
      *  default model, not one actually served. The served model is on `usage`. */
     served_model?: string | null;
     scopes: string[] | null;
-    payer: 'user';
+    payer: 'user' | 'app';
     usage: RunUsageDTO;
     /** Present when a schedule's firing started the run. */
     schedule_id?: string;
@@ -170,6 +170,8 @@ export interface RunUsageEvent extends RunEventBaseDTO, RunUsageDTO {
     type: 'usage';
     /** One model call's model; its tokens and cost are the event's own counts. */
     served_model: string;
+    /** Who paid for this call: the run's grant's payer. */
+    payer: 'user' | 'app';
     /** The run's cumulative usage after this call. */
     usage: RunUsageDTO;
     entry_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.501",
+  "version": "0.3.503",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",