@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/api/prediction-v1-build.js

@@ -0,0 +1,73 @@
+/**
+ * prediction.v1 dashboard data assembly.
+ *
+ * Uses the generic task_runs table as the first operator-visible lifecycle
+ * source. Envelope projections remain the richer corpus source once production
+ * writes them, but task_runs is available in the daemon today.
+ */
+import { TaskRunPersistence } from '../harnesses/engine/persistence.js';
+const RECENT_LIMIT = 5;
+export function gatherPredictionV1Status(store, options = {}) {
+    const persistence = new TaskRunPersistence(store.db);
+    const inFlight = persistence.getInFlight().filter(isPredictionV1Run);
+    const complete = persistence.getByState('COMPLETE').filter(isPredictionV1Run);
+    const failed = persistence.getByState('FAILED').filter(isPredictionV1Run);
+    const allRuns = [...inFlight, ...complete, ...failed];
+    const allRecent = [...allRuns].sort((a, b) => b.stateUpdatedAt - a.stateUpdatedAt);
+    const solutions = complete
+        .filter((run) => run.taskRole !== 'evaluation')
+        .sort((a, b) => b.stateUpdatedAt - a.stateUpdatedAt);
+    const verdicts = complete
+        .filter((run) => run.taskRole === 'evaluation')
+        .sort((a, b) => b.stateUpdatedAt - a.stateUpdatedAt);
+    return {
+        operator: options.operator ?? null,
+        ...(options.operatorError ? { operatorError: options.operatorError } : {}),
+        totals: {
+            observedTasks: distinctTaskCount(allRuns),
+            activeTaskRuns: inFlight.length,
+            solutions: solutions.length,
+            verdicts: verdicts.length,
+            failed: failed.length,
+        },
+        latest: {
+            taskAt: latestAt(allRuns),
+            solutionAt: latestAt(solutions),
+            verdictAt: latestAt(verdicts),
+        },
+        recentTasks: allRecent.slice(0, RECENT_LIMIT).map(toSummary),
+        recentSolutions: solutions.slice(0, RECENT_LIMIT).map(toSummary),
+        recentVerdicts: verdicts.slice(0, RECENT_LIMIT).map(toSummary),
+    };
+}
+function isPredictionV1Run(run) {
+    return run.solverType === 'prediction.v1';
+}
+function taskIdentity(run) {
+    return run.taskId ?? run.taskCid;
+}
+function distinctTaskCount(runs) {
+    return new Set(runs.map(taskIdentity)).size;
+}
+function latestAt(runs) {
+    if (runs.length === 0)
+        return null;
+    return Math.max(...runs.map((run) => run.stateUpdatedAt));
+}
+function toSummary(run) {
+    return {
+        requestId: run.requestId,
+        taskId: run.taskId,
+        taskCid: run.taskCid,
+        state: run.state,
+        taskRole: run.taskRole,
+        implName: run.implName,
+        windowStartTs: run.windowStartTs,
+        windowEndTs: run.windowEndTs,
+        stateUpdatedAt: run.stateUpdatedAt,
+        manifestCid: run.manifestCid,
+        deliveryTxHash: run.deliveryTxHash,
+        failureReason: run.failureReason,
+    };
+}
+//# sourceMappingURL=prediction-v1-build.js.map

package/dist/api/prediction-v1-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-v1-build.js","sourceRoot":"","sources":["../../src/api/prediction-v1-build.ts"],"names":[],"mappings":"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"}

package/dist/api/rewards-build.js

@@ -3,13 +3,8 @@
  *
  * Contract: spec/2026-04-14-client-surface.md §2.2 (rewards verb).
  */
+import { isStakedLikeServiceStep } from '../earning/types.js';
 import { displayFleetServiceIndex } from '../earning/fleet-display-index.js';
-const STAKED_LIKE_STEPS = new Set([
-    'staked',
-    'mech_deployed',
-    'complete',
-    'service_staked',
-]);
 export function assembleRewardsV1(raw) {
     const total = raw.pendingStakingRewardsWei ?? '0';
     const list = raw.fleet?.services ?? [];
@@ -20,7 +15,7 @@ export function assembleRewardsV1(raw) {
     if (pendingByKeys.length === 0 && list.length > 0) {
         try {
             if (total !== '0' && BigInt(total) > 0n) {
-                const s = list.find(svc => STAKED_LIKE_STEPS.has(svc.step)) ?? list[0];
+                const s = list.find(svc => isStakedLikeServiceStep(svc.step)) ?? list[0];
                 if (s)
                     legacyPendingIndex = displayFleetServiceIndex(s);
             }
@@ -31,7 +26,7 @@ export function assembleRewardsV1(raw) {
     }
     const services = list.map((svc) => {
         const index = displayFleetServiceIndex(svc);
-        const stakedLike = STAKED_LIKE_STEPS.has(svc.step);
+        const stakedLike = isStakedLikeServiceStep(svc.step);
         const claimed = claimedByService[index]?.total ?? '0';
         return {
             index,

package/dist/api/rewards-build.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewards-build.js","sourceRoot":"","sources":["../../src/api/rewards-build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,QAAQ;IACR,eAAe;IACf,UAAU;IACV,gBAAgB;CACjB,CAAC,CAAC;AAiBH,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC;IAClD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACpD,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpD,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;gBACxC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;gBACvE,IAAI,CAAC;oBAAE,kBAAkB,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;QACtD,OAAO;YACL,KAAK;YACL,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;oBACtB,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;wBAChB,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,kBAAkB,KAAK,KAAK;4BAC5B,CAAC,CAAC,KAAK;4BACP,CAAC,CAAC,GAAG,CAAC,CAAC;gBACf,CAAC,CAAC,GAAG;YACP,OAAO;YACP,KAAK,EAAE,QAAiB;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW,EAAE,GAAG,CAAC,qBAAqB;QACtC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;QAC9C,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"rewards-build.js","sourceRoot":"","sources":["../../src/api/rewards-build.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,uBAAuB,EAAqB,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAiB7E,MAAM,UAAU,iBAAiB,CAAC,GAAsB;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC;IAClD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACpD,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACpD,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,IAAI,KAAK,KAAK,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,CAAC;gBACxC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;gBACzE,IAAI,CAAC;oBAAE,kBAAkB,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAChC,MAAM,KAAK,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,GAAG,CAAC;QACtD,OAAO;YACL,KAAK;YACL,OAAO,EAAE,UAAU;gBACjB,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC;oBACtB,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;wBAChB,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,kBAAkB,KAAK,KAAK;4BAC5B,CAAC,CAAC,KAAK;4BACP,CAAC,CAAC,GAAG,CAAC,CAAC;gBACf,CAAC,CAAC,GAAG;YACP,OAAO;YACP,KAAK,EAAE,QAAiB;SACzB,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,WAAW,EAAE,GAAG,CAAC,qBAAqB;QACtC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;QAC9C,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/api/server.d.ts

@@ -7,15 +7,43 @@
  *   GET  /v1/status  (daemon health, fleet hints, RPC — best-effort)
  *   GET  /artifacts/search?tags=a,b&outcome=SUCCESS&limit=50
  *   GET  /artifacts/:id/content
- *   POST /artifacts  { id, desiredStateId, requestId, title, content, tags, outcome }
+ *   POST /artifacts  { id, taskId, requestId, title, content, tags, outcome }
  *   GET  /x402/artifacts/:id/content  (payment-gated, if x402 configured)
  */
+import { Hono } from 'hono';
+import type { Server as HttpServer } from 'node:http';
 import type { Store } from '../store/store.js';
 import { type X402Config } from '../x402/handler.js';
 import { type StatusGatherConfig } from './gather-status.js';
+import type { Corpus } from '../corpus/index.js';
+import { type BootstrapEndpointConfig } from './bootstrap-endpoint.js';
+import { type SolverNetsRegistry } from './solvernets-endpoint.js';
+import { type SolverNetsEndpointsDeps } from './solvernets-endpoints.js';
+import { type AgentBindingRoutesConfig } from './agent-binding-endpoint.js';
+import { type SetupRoutesConfig } from './setup-endpoints.js';
+import { type HarnessStatusDeps } from './harness-status-endpoint.js';
+import { type LauncherRoutesDeps } from './launcher-endpoints.js';
+import { type OperatorArtifactsRoutesConfig } from './operator-artifacts-endpoint.js';
+import { type StopHookRoutesDeps } from './stop-hook.js';
+import { type CapturesRoutesDeps } from './captures.js';
 export interface ApiServerConfig {
     port: number;
+    /**
+     * Bind host. Defaults to `127.0.0.1` so the daemon API is unreachable
+     * across the network unless the operator explicitly opts in via
+     * `apiBindHost` / `JINN_API_BIND_HOST`. Cost-mutating routes additionally
+     * require a bearer token; the bind host is the outer firewall.
+     */
+    bindHost?: string;
     store: Store;
+    /**
+     * Bearer token required on cost-mutating routes (`POST /artifacts`,
+     * `POST /v1/artifacts/acquire`). Generated at daemon startup (or read
+     * from `DAEMON_API_TOKEN`) and threaded into the MCP subprocess via
+     * the same env var. Read-only routes (`GET /v1/status`, search,
+     * x402 cross-operator content) stay public.
+     */
+    apiToken: string;
     requireAuth?: boolean;
     onArtifactPublished?: (artifact: {
         id: string;
@@ -26,9 +54,86 @@ export interface ApiServerConfig {
     x402?: X402Config;
     /** When set, GET /v1/status includes fleet file + RPC reads. */
     status?: StatusGatherConfig;
+    /**
+     * Daemon-side Corpus instance. When set, exposes
+     * `POST /v1/artifacts/acquire` so the MCP subprocess (and other in-host
+     * consumers) can fetch artifacts without ever seeing the agent EOA private
+     * key.
+     *
+     * SECURITY: this route signs x402 payments with the agent EOA. It has no
+     * UI authentication; callers need the daemon bearer token. An attacker who
+     * can reach this port and token can post fabricated
+     * `access.endpoint` URLs and drain the operator's USDC balance via the
+     * payment dance.
+     *
+     * Asymmetry with `search_records` / `inspect_record`: record discovery is
+     * keyless (subgraph + IPFS gateway only) and stays client-side in the MCP
+     * server. Artifact acquisition is the only path that needs the signing key
+     * for x402 payments, so it's the only one that moves to the daemon. See
+     * spec/2026-04-30-phase-a-umbrella.md §4.
+     */
+    corpus?: Corpus | (() => Corpus | undefined);
+    /** When set, GET /v1/bootstrap reads <earningDir>/earning_state.json. */
+    bootstrap?: BootstrapEndpointConfig;
+    /** Optional panel-driven setup actions such as testnet faucet funding. */
+    setup?: SetupRoutesConfig;
+    /**
+     * Launcher mode routes (`/v1/launcher/*`). Mounted only when supplied so
+     * tests and bootstrap-only API instances don't pay the deps wiring cost.
+     * Gated by the same UI token as `/v1/setup/*` — see the `app.use` block
+     * inside `startApiServer` below.
+     */
+    launcher?: LauncherRoutesDeps;
+    /** When set, GET /v1/solvernets exposes the catalog from a daemon registry. */
+    solverNets?: {
+        registry: SolverNetsRegistry;
+    };
+    /**
+     * jinn-mono-hqz0: SolverNet creation/launch endpoints (drafts CRUD,
+     * launched CRUD, registry list/by-cid). Deps are populated AFTER
+     * startApiServer returns (the SolverNet subsystem in main.ts depends on
+     * post-bootstrap state), so we accept a holder ref. Routes register
+     * eagerly here and dereference `holder.current` per-request, returning
+     * 503 until the holder is populated.
+     */
+    solverNetsLauncher?: {
+        holder: {
+            current: SolverNetsEndpointsDeps | undefined;
+        };
+    };
+    /** When set, POST /v1/setup/agent-binding/retry is mounted so the SPA can
+     *  retry the ERC-1271 bind step for unbound services. */
+    agentBinding?: AgentBindingRoutesConfig;
+    /** When set, /auth/handshake is mounted and SPA-only routes are gated by the token. */
+    ui?: {
+        token: string;
+        handshakeKey: string;
+    };
+    /** Admin endpoint for operator MCP write tools. Only mounted when ui is also configured. */
+    admin?: {
+        onRestartRequested: () => void;
+    };
+    /**
+     * When set, mounts `GET /api/harness/status` under the UI token gate.
+     * Powers the dashboard's HarnessStatusPanel (mode + codeDigest + lastModeSwitchAt).
+     */
+    harnessStatus?: HarnessStatusDeps;
+    /** Operator-local artifact inventory + future-artifact pricing controls. */
+    operatorArtifacts?: Omit<OperatorArtifactsRoutesConfig, 'store'>;
+    /** Path D local session-end hook endpoint. */
+    stopHook?: StopHookRoutesDeps;
+    /** Operator review API for pending captures. */
+    captures?: CapturesRoutesDeps;
 }
 export interface ApiServer {
     port: number;
     close(): Promise<void>;
+    /** Underlying node http.Server, exposed so other subsystems (e.g. agent WS bridge)
+     *  can mount on the same port. */
+    server: HttpServer;
+    /** Hono app, exposed so subsystems initialised AFTER startApiServer (e.g. the
+     *  SolverNet subsystem in main.ts) can mount their routes on the same instance.
+     *  See jinn-mono-hqz0. */
+    app: Hono;
 }
 export declare function startApiServer(config: ApiServerConfig): Promise<ApiServer>;