@north-light/api 0.3.510 → 0.3.512

package/dist/api/client.d.ts

@@ -1,6 +1,6 @@
 import { ApiError } from './errors.js';
 import type { AppLimitsChangeDTO, LimitsDTO, SetAppLimitsRequest } from './dto/limits.js';
-import type { DaemonAdmitDTO, DaemonRestartDTO, DueDTO, HealthDTO, MigrateStateDTO, MigrateStateRequest, StatusDTO } from './dto/health.js';
+import type { DaemonAdmitDTO, DaemonRestartDTO, DueDTO, HealthDTO, ReadyDTO, MigrateStateDTO, MigrateStateRequest, StatusDTO } from './dto/health.js';
 import type { BashJobStatusDTO, BashJobStopResultDTO } from './dto/bash-jobs.js';
 import type { ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSubjectDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
 import type { NodeOutcomeResponseDTO, OutcomeDeliveryDTO, RegisterOutcomeDeliveryRequest } from './dto/node-outcomes.js';
@@ -123,6 +123,8 @@ export declare class CrtrClient {
     /** One `/healthz` observation without cold-socket recovery. Availability
      * waiters own retry policy and pass their remaining wall-clock budget here. */
     probeHealthz(timeoutMs: number): Promise<HealthDTO>;
+    /** `GET /v1/ready`: 200 ready, 503 not yet; both answer a `ReadyDTO`. */
+    ready(): Promise<ReadyDTO>;
     status(): Promise<StatusDTO>;
     /** Busy and next-due state, the truth behind sandbox sleep and wake. */
     due(): Promise<DueDTO>;

package/dist/api/client.js

@@ -107,6 +107,19 @@ export class CrtrClient {
         }
         return parse(response);
     }
+    /** `GET /v1/ready`: 200 ready, 503 not yet; both answer a `ReadyDTO`. */
+    async ready() {
+        const response = await this.transport('GET', routes.ready(), undefined, {});
+        if (response.status === 503) {
+            try {
+                const body = await response.clone().json();
+                if (body.ready === false)
+                    return body;
+            }
+            catch { /* `parse` reports a malformed 503 normally */ }
+        }
+        return parse(response);
+    }
     status() {
         return this.request('GET', routes.status());
     }

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.20";
+export declare const CONTRACT_LEVEL = "1.22";
 /** 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.20';
+export const CONTRACT_LEVEL = '1.22';
 /** 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/health.d.ts

@@ -13,6 +13,14 @@ export interface HealthDTO {
     /** Always present; only `ready` admits normal daemon work. */
     startup_phase: StartupPhaseDTO;
 }
+/** `GET /v1/ready` — whether this listener can admit ordinary work (200) or not (503, with `reason`). Reveals nothing else. */
+export type ReadyDTO = {
+    ready: true;
+} | {
+    ready: false;
+    reason: 'startup_pending' | 'jwks_pending' | 'grant_snapshot_missing';
+    message: string;
+};
 /** `GET /v1/status` — daemon status snapshot. Backs `crtr sys daemon status`
  *  state and the `crtr canvas dashboard` header. `runtime_version` is also
  *  checked by Core's minimum-runtime capability gate. */

package/dist/api/routes.d.ts

@@ -3,6 +3,7 @@ export declare const API_VERSION = "v1";
 /** Route path builders. Keys mirror the spec §6 route table. */
 export declare const routes: {
     readonly healthz: () => string;
+    readonly ready: () => string;
     readonly status: () => string;
     readonly due: () => string;
     readonly daemonRestart: () => string;

package/dist/api/routes.js

@@ -17,6 +17,7 @@ const V = `/${API_VERSION}`;
 export const routes = {
     // Health / status
     healthz: () => '/healthz',
+    ready: () => `${V}/ready`,
     status: () => `${V}/status`,
     due: () => `${V}/due`,
     daemonRestart: () => `${V}/daemon/restart`,

package/dist/core/subscription-state.js

@@ -41,7 +41,7 @@ catch (error) {
 } if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed) || parsed.version !== 1 || typeof parsed.accounts !== 'object' || parsed.accounts === null || Array.isArray(parsed.accounts))
     throw new Error(`managed credential file ${path} is corrupt`); return parsed; }
 function toPublic(row, file, cooldowns = []) { const stored = file.accounts[row.id]; if (!stored || typeof stored.refresh !== 'string' || typeof stored.access !== 'string' || !Number.isFinite(stored.expires))
-    throw new Error(`managed ${row.providerId} account ${row.id} has no credential record`); return { label: row.label, refresh: stored.refresh, access: stored.access, expires: stored.expires, rateLimitedUntil: row.rateLimitedUntil, lastAttemptAt: row.lastAttemptAt, lastRateLimitedAt: row.lastRateLimitedAt, ...(row.authFailure ? { authFailure: row.authFailure } : {}), ...(stored.accountId ? { accountId: stored.accountId } : {}), ...(stored.clientId ? { clientId: stored.clientId } : {}), ...(cooldowns.length ? { modelCooldowns: Object.fromEntries(cooldowns.map((cooldown) => [cooldown.family, cooldown.rateLimitedUntil])) } : {}) }; }
+    throw new Error(`managed ${row.providerId} account ${row.id} has no credential record`); return { label: row.label, refresh: stored.refresh, access: stored.access, expires: stored.expires, rateLimitedUntil: row.authFailure || !row.lastRateLimitedAt ? row.rateLimitedUntil : Math.min(row.rateLimitedUntil, row.lastRateLimitedAt + MAX_RATE_LIMIT_COOLDOWN_MS), lastAttemptAt: row.lastAttemptAt, lastRateLimitedAt: row.lastRateLimitedAt, ...(row.authFailure ? { authFailure: row.authFailure } : {}), ...(stored.accountId ? { accountId: stored.accountId } : {}), ...(stored.clientId ? { clientId: stored.clientId } : {}), ...(cooldowns.length ? { modelCooldowns: Object.fromEntries(cooldowns.map((cooldown) => [cooldown.family, cooldown.lastRateLimitedAt ? Math.min(cooldown.rateLimitedUntil, cooldown.lastRateLimitedAt + MAX_RATE_LIMIT_COOLDOWN_MS) : cooldown.rateLimitedUntil])) } : {}) }; }
 function rowsWithCredentials(provider, file) { const cooldowns = providerModelCooldownsFor(agentDir(), provider); return providerRows(agentDir(), provider).map((row) => ({ row, entry: toPublic(row, file, cooldowns.get(row.id)) })); }
 function managedCredentialFile(provider) { return new LockedJsonFile(credentialFile(provider), true, '{"version":1,"accounts":{}}\n'); }
 function readFile(provider) { return parseCredentials(credentialFile(provider), managedCredentialFile(provider).readUnlocked()); }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.510",
+  "version": "0.3.512",
   "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",