@hyperfixation/core 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { addLabel, listLabels, LABEL_ADD_OPERATION, LABEL_LIST_OPERATION, type L
 export { listOutcomes, recordOutcome, OUTCOME_LIST_OPERATION, OUTCOME_RECORD_OPERATION, type OutcomeListOptions, type OutcomeRecordOptions, type OutcomeRow, } from "./outcomes.js";
 export { pauseApp, resumeApp, PAUSED_MARKER, PAUSE_OPERATION, RESUMED_MARKER, RESUME_OPERATION, type PauseOptions, type PauseResult, type ResumeOptions, type ResumeResult, } from "./pause.js";
 export { archiveRecord, archiveDecisionKey, assertRecordStages, displayColumnOf, ARCHIVED_MARKER, ARCHIVE_OPERATION, DEFAULT_DISPLAY_COLUMN, type ArchiveOptions, type ArchiveResult, type RecordDefinition, type StageDefinition, } from "./records.js";
-export { appStatus, CORE_VERSION, type PeriodStatus, type QueueStatus, type StatusOptions, type StatusReport, } from "./status.js";
+export { appStatus, CORE_VERSION, type LlmMode, type PeriodStatus, type QueueStatus, type StatusOptions, type StatusReport, } from "./status.js";
 export { createStatusHandler, statusRouteOf, STATUS_TOKEN_ACTOR, type StatusHandlerOptions, type StatusRoute, type StatusRouteHandlers, } from "./status-route.js";
 export { bearerToken, hashStatusToken, statusTokenMatches, STATUS_TOKEN_DIGEST, } from "./status-token.js";
 /**

package/dist/status.d.ts

@@ -17,6 +17,11 @@ export interface PeriodStatus {
     ledgerUsd: string;
     driftUsd: string;
 }
+/**
+ * What the app's LLM calls are being answered by, as the process that built the registry
+ * reported it. `unknown` means no process has reported — not that a key is missing.
+ */
+export type LlmMode = "live" | "fixtures" | "unknown";
 export interface StatusReport {
     /** `degraded` when there are anomalies or any period's spend disagrees with its ledger. */
     health: "ok" | "degraded";
@@ -25,6 +30,10 @@ export interface StatusReport {
     coreVersion: string;
     paused: boolean;
     pausedBy: string | null;
+    /** A deploy with no provider key serves fixture drafts; this is where that is visible. */
+    llm: {
+        mode: LlmMode;
+    };
     runs: Record<RunStatus, number>;
     queues: QueueStatus[];
     approvals: Record<string, number>;

package/dist/status.js

@@ -5,7 +5,7 @@ export const CORE_VERSION = createRequire(import.meta.url)("../package.json").ve
  * Every read here is a plain `SELECT` and none of them locks anything — in particular not a
  * budget row, which is the one thing the lock order forbids any of these paths to take.
  */
-const STATE_STATEMENT = "SELECT paused, paused_by, budget_usd::text AS budget_usd FROM hf_app_state WHERE id = 1";
+const STATE_STATEMENT = "SELECT paused, paused_by, budget_usd::text AS budget_usd, llm_mode FROM hf_app_state WHERE id = 1";
 const PERIODS_STATEMENT = "SELECT to_char(date_trunc('month', now() AT TIME ZONE 'UTC'), 'YYYY-MM') AS current_period, " +
     "to_char(date_trunc('month', now() AT TIME ZONE 'UTC') - interval '1 month', 'YYYY-MM') " +
     "AS previous_period";
@@ -40,6 +40,7 @@ const BUDGET_STATEMENT = "SELECT b.period, b.budget_usd::text AS budget_usd, b.s
 const ANOMALIES_STATEMENT = "SELECT count(*)::int AS n FROM hf_run r " +
     "LEFT JOIN dbos.workflow_status w ON w.workflow_uuid = r.current_workflow_id " +
     "WHERE r.status = 'running' AND w.workflow_uuid IS NULL";
+const LLM_MODES = ["live", "fixtures"];
 const RUN_STATUSES = ["running", "waiting", "paused", "done", "failed"];
 /** What `GET /api/status` answers with, and what `hf doctor` reads. */
 export async function appStatus(pool, options) {
@@ -77,6 +78,7 @@ export async function appStatus(pool, options) {
         coreVersion: CORE_VERSION,
         paused: state.rows[0]?.paused ?? false,
         pausedBy: state.rows[0]?.paused_by ?? null,
+        llm: { mode: llmMode(state.rows[0]?.llm_mode ?? null) },
         runs: Object.fromEntries(RUN_STATUSES.map((status) => [status, runs[status] ?? 0])),
         queues: queues.rows.map((row) => ({
             name: row.name,
@@ -93,6 +95,10 @@ export async function appStatus(pool, options) {
         at: new Date().toISOString(),
     };
 }
+/** A stored mode this core does not know reads as `unknown`, the same as none at all. */
+function llmMode(stored) {
+    return LLM_MODES.find((mode) => mode === stored) ?? "unknown";
+}
 async function counts(pool, statement) {
     const { rows } = await pool.query(statement);
     return Object.fromEntries(rows.map((row) => [row.status, row.n]));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixation/core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "license": "MIT",
   "description": "defineApp, registries, resolution, records, activity, tasks, labels, outcomes, and the status endpoint",
   "repository": {
@@ -29,13 +29,13 @@
   ],
   "dependencies": {
     "@dbos-inc/dbos-sdk": "4.27.6",
-    "@hyperfixation/db": "0.1.0",
-    "@hyperfixation/workflows": "0.1.0",
+    "@hyperfixation/db": "0.1.1",
+    "@hyperfixation/workflows": "0.1.1",
     "pg": "^8.23.0"
   },
   "devDependencies": {
-    "@hyperfixation/eslint-config": "0.1.0",
-    "@hyperfixation/testing": "0.1.0",
+    "@hyperfixation/eslint-config": "0.1.1",
+    "@hyperfixation/testing": "0.1.1",
     "@microsoft/api-extractor": "^7.59.1",
     "@types/pg": "^8.23.1",
     "eslint": "^10.10.0",