@senpi/runtime 1.0.95-dev.runtime-phase-2.20260427204640 → 1.0.95-dev.runtime-phase-2-api.20260505093328

package/dist/runtime-api/readiness.js

@@ -0,0 +1,35 @@
+/**
+ * Three-state readiness contract for `GET /health`.
+ *
+ * S5 (lifecycle layer) wires the lifecycle to flip these states:
+ *  - `"starting"` — initial state; server is binding or warming up.
+ *  - `"ok"`       — server is bound and ready to handle traffic.
+ *  - `"draining"` — graceful-shutdown in progress; stop routing new requests.
+ *
+ * `GET /health` returns `200` for `"ok"` and `503` for the other two states
+ * so load balancers stop routing before the process exits.
+ */
+/**
+ * Create a mutable readiness object.
+ *
+ * The returned object satisfies both the read-only {@link Readiness} interface
+ * and exposes `setOk()` / `setDraining()` mutators for the lifecycle layer
+ * (S5) to call at the appropriate moments.
+ *
+ * Initial state is `"starting"`.
+ *
+ * @returns A combined readiness + mutator object.
+ */
+export function createReadiness() {
+    let s = "starting";
+    return {
+        state: () => s,
+        setOk: () => {
+            s = "ok";
+        },
+        setDraining: () => {
+            s = "draining";
+        },
+    };
+}
+//# sourceMappingURL=readiness.js.map

package/dist/runtime-api/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/runtime-api/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe;IAI7B,IAAI,CAAC,GAAmB,UAAU,CAAC;IACnC,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACd,KAAK,EAAE,GAAG,EAAE;YACV,CAAC,GAAG,IAAI,CAAC;QACX,CAAC;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,CAAC,GAAG,UAAU,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime-api/routes/audit.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fastify route: `GET /audit`.
+ *
+ * Proxies a `audit_query` MCP call through the runtime handle matching the
+ * requested wallet address. AbortSignal is wired to the HTTP request lifetime
+ * so MCP cancels in-flight work when the client disconnects.
+ *
+ * Business logic lives entirely in `handlers/audit.ts`. This file contains
+ * only Fastify wiring and query-string coercion.
+ */
+import type { FastifyInstance } from "fastify";
+import type { RuntimeHandle } from "../../runtime/run.js";
+import type { Logger } from "../../utils/logger.js";
+/**
+ * Dependencies injected into the `/audit` route at registration time.
+ */
+export interface AuditRouteDeps {
+    /** Live runtime handles maintained by the plugin, keyed by lowercased address. */
+    runtimeHandles: Map<string, RuntimeHandle>;
+    /** Logger instance for unexpected errors. */
+    logger: Logger;
+}
+/**
+ * Register `GET /audit` on the given Fastify instance.
+ *
+ * Coerces string query-string values to their typed counterparts before
+ * forwarding to `auditHandler`. The `success` field is `"true" | "false"` from
+ * the schema; converted to `boolean`. Integer fields are parsed with
+ * `parseInt`. Missing optional fields are left as `undefined`.
+ *
+ * HTTP status mapping from `AuditQueryError.code`:
+ *  - `NOT_FOUND` → 404
+ *  - `ABORTED`   → 504 (gateway timeout — client disconnected)
+ *  - `UPSTREAM`  → 502 (bad gateway — MCP error)
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export declare function registerAuditRoute(fastify: FastifyInstance, deps: AuditRouteDeps): void;
+//# sourceMappingURL=audit.d.ts.map

package/dist/runtime-api/routes/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,cAAc,GACnB,IAAI,CA4DN"}

package/dist/runtime-api/routes/audit.js

@@ -0,0 +1,82 @@
+/**
+ * Fastify route: `GET /audit`.
+ *
+ * Proxies a `audit_query` MCP call through the runtime handle matching the
+ * requested wallet address. AbortSignal is wired to the HTTP request lifetime
+ * so MCP cancels in-flight work when the client disconnects.
+ *
+ * Business logic lives entirely in `handlers/audit.ts`. This file contains
+ * only Fastify wiring and query-string coercion.
+ */
+import { AuditQuery } from "./audit.schema.js";
+import { auditHandler } from "../handlers/audit.js";
+/**
+ * Register `GET /audit` on the given Fastify instance.
+ *
+ * Coerces string query-string values to their typed counterparts before
+ * forwarding to `auditHandler`. The `success` field is `"true" | "false"` from
+ * the schema; converted to `boolean`. Integer fields are parsed with
+ * `parseInt`. Missing optional fields are left as `undefined`.
+ *
+ * HTTP status mapping from `AuditQueryError.code`:
+ *  - `NOT_FOUND` → 404
+ *  - `ABORTED`   → 504 (gateway timeout — client disconnected)
+ *  - `UPSTREAM`  → 502 (bad gateway — MCP error)
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export function registerAuditRoute(fastify, deps) {
+    fastify.get("/audit", { schema: { querystring: AuditQuery } }, async (req, reply) => {
+        const q = req.query;
+        // Coerce string query-string values to typed handler args.
+        const args = {
+            ...(q.tool_name !== undefined && { tool_name: q.tool_name }),
+            ...(q.action_type !== undefined && { action_type: q.action_type }),
+            ...(q.success !== undefined && { success: q.success === "true" }),
+            ...(q.start_time !== undefined && { start_time: q.start_time }),
+            ...(q.end_time !== undefined && { end_time: q.end_time }),
+            ...(q.min_duration_ms !== undefined && {
+                min_duration_ms: parseInt(q.min_duration_ms, 10),
+            }),
+            ...(q.max_duration_ms !== undefined && {
+                max_duration_ms: parseInt(q.max_duration_ms, 10),
+            }),
+            ...(q.limit !== undefined
+                ? { limit: parseInt(q.limit, 10) }
+                : { limit: 100 }),
+            ...(q.offset !== undefined
+                ? { offset: parseInt(q.offset, 10) }
+                : { offset: 0 }),
+            ...(q.cursor_requested_at !== undefined && {
+                cursor_requested_at: q.cursor_requested_at,
+            }),
+            ...(q.cursor_id !== undefined && { cursor_id: q.cursor_id }),
+        };
+        // Wire AbortSignal to the request close event so MCP cancellation works
+        // when the HTTP client disconnects before the MCP response arrives.
+        const ac = new AbortController();
+        req.raw.on("close", () => {
+            if (req.raw.destroyed)
+                ac.abort();
+        });
+        const result = await auditHandler(q.address, args, deps, ac.signal);
+        if (result.ok) {
+            return reply.send({
+                address: result.address,
+                strategyId: result.strategyId,
+                ...result.result,
+            });
+        }
+        const statusMap = {
+            NOT_FOUND: 404,
+            ABORTED: 504,
+            UPSTREAM: 502,
+        };
+        const status = statusMap[result.code] ?? 502;
+        return reply
+            .status(status)
+            .send({ ok: false, code: result.code, message: result.message });
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/runtime-api/routes/audit.js.map

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

package/dist/runtime-api/routes/audit.schema.d.ts

@@ -0,0 +1,75 @@
+/**
+ * TypeBox schema for the `GET /audit` query string.
+ *
+ * All Fastify query-string values arrive as strings. Integer fields
+ * (`min_duration_ms`, `max_duration_ms`, `limit`, `offset`) and the `success`
+ * boolean are declared as strings here so TypeBox validation passes on the raw
+ * HTTP input. The route handler coerces them to the appropriate types before
+ * forwarding to `auditHandler`.
+ *
+ * Fields excluded from the caller-visible surface (per plan Section 6):
+ *  - `resource_type` — always `"strategy"`, set by `RuntimeHandle.auditQuery`.
+ *  - `resource_id`   — resolved wallet → strategyId, set by the handle.
+ *  - `user_ids`      — server-controlled (the MCP API-key user).
+ *  - `usernames`     — server-controlled (the MCP API-key user).
+ *
+ * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts `auditQueryInputSchema`
+ *   for the upstream MCP Zod schema this mirrors.
+ */
+import { type Static } from "@sinclair/typebox";
+/** TypeBox schema for `GET /audit` query-string parameters. */
+export declare const AuditQuery: import("@sinclair/typebox").TObject<{
+    /**
+     * Wallet address to scope the audit query.
+     * Required — used to look up the matching runtime handle.
+     */
+    address: import("@sinclair/typebox").TString;
+    /** Filter by exact tool name (e.g. `create_position`). */
+    tool_name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /**
+     * Filter by action classification.
+     * One of: `read`, `create`, `update`, `delete`.
+     */
+    action_type: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"read">, import("@sinclair/typebox").TLiteral<"create">, import("@sinclair/typebox").TLiteral<"update">, import("@sinclair/typebox").TLiteral<"delete">]>>;
+    /**
+     * Filter by success/failure.
+     * Query strings arrive as text — coerce `"true"` / `"false"` in the route.
+     */
+    success: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"true">, import("@sinclair/typebox").TLiteral<"false">]>>;
+    /** ISO 8601 inclusive lower bound on `requested_at`. */
+    start_time: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** ISO 8601 inclusive upper bound on `requested_at`. */
+    end_time: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /**
+     * Minimum end-to-end duration in ms.
+     * Arrives as a string; pattern restricts to non-negative integers so
+     * `parseInt` never produces NaN. Coerced to integer in the route handler.
+     */
+    min_duration_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /**
+     * Maximum end-to-end duration in ms.
+     * Arrives as a string; pattern restricts to non-negative integers so
+     * `parseInt` never produces NaN. Coerced to integer in the route handler.
+     */
+    max_duration_ms: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /**
+     * Page size (1–1000, MCP default 100).
+     * Arrives as a string; pattern restricts to non-negative integers.
+     * Coerced to integer in the route handler. Default `100` applied on
+     * missing value. MCP enforces the 1–1000 range.
+     */
+    limit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /**
+     * Offset-based pagination skip count (≥0, MCP default 0).
+     * Arrives as a string; pattern restricts to non-negative integers.
+     * Coerced to integer in the route handler.
+     */
+    offset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Cursor timestamp for keyset pagination (ISO 8601). Must pair with `cursor_id`. */
+    cursor_requested_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Cursor UUID for keyset pagination. Must pair with `cursor_requested_at`. */
+    cursor_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/** TypeScript type for the `GET /audit` query string. */
+export type AuditQueryT = Static<typeof AuditQuery>;
+//# sourceMappingURL=audit.schema.d.ts.map

package/dist/runtime-api/routes/audit.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.schema.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/audit.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,+DAA+D;AAC/D,eAAO,MAAM,UAAU;IAEnB;;;OAGG;;IAGH,0DAA0D;;IAG1D;;;OAGG;;IAUH;;;OAGG;;IAKH,wDAAwD;;IAGxD,wDAAwD;;IAGxD;;;;OAIG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;;OAIG;;IAGH,qFAAqF;;IAGrF,+EAA+E;;EAIlF,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/runtime-api/routes/audit.schema.js

@@ -0,0 +1,78 @@
+/**
+ * TypeBox schema for the `GET /audit` query string.
+ *
+ * All Fastify query-string values arrive as strings. Integer fields
+ * (`min_duration_ms`, `max_duration_ms`, `limit`, `offset`) and the `success`
+ * boolean are declared as strings here so TypeBox validation passes on the raw
+ * HTTP input. The route handler coerces them to the appropriate types before
+ * forwarding to `auditHandler`.
+ *
+ * Fields excluded from the caller-visible surface (per plan Section 6):
+ *  - `resource_type` — always `"strategy"`, set by `RuntimeHandle.auditQuery`.
+ *  - `resource_id`   — resolved wallet → strategyId, set by the handle.
+ *  - `user_ids`      — server-controlled (the MCP API-key user).
+ *  - `usernames`     — server-controlled (the MCP API-key user).
+ *
+ * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts `auditQueryInputSchema`
+ *   for the upstream MCP Zod schema this mirrors.
+ */
+import { Type } from "@sinclair/typebox";
+/** TypeBox schema for `GET /audit` query-string parameters. */
+export const AuditQuery = Type.Object({
+    /**
+     * Wallet address to scope the audit query.
+     * Required — used to look up the matching runtime handle.
+     */
+    address: Type.String({ minLength: 1 }),
+    /** Filter by exact tool name (e.g. `create_position`). */
+    tool_name: Type.Optional(Type.String()),
+    /**
+     * Filter by action classification.
+     * One of: `read`, `create`, `update`, `delete`.
+     */
+    action_type: Type.Optional(Type.Union([
+        Type.Literal("read"),
+        Type.Literal("create"),
+        Type.Literal("update"),
+        Type.Literal("delete"),
+    ])),
+    /**
+     * Filter by success/failure.
+     * Query strings arrive as text — coerce `"true"` / `"false"` in the route.
+     */
+    success: Type.Optional(Type.Union([Type.Literal("true"), Type.Literal("false")])),
+    /** ISO 8601 inclusive lower bound on `requested_at`. */
+    start_time: Type.Optional(Type.String()),
+    /** ISO 8601 inclusive upper bound on `requested_at`. */
+    end_time: Type.Optional(Type.String()),
+    /**
+     * Minimum end-to-end duration in ms.
+     * Arrives as a string; pattern restricts to non-negative integers so
+     * `parseInt` never produces NaN. Coerced to integer in the route handler.
+     */
+    min_duration_ms: Type.Optional(Type.String({ pattern: "^\\d+$" })),
+    /**
+     * Maximum end-to-end duration in ms.
+     * Arrives as a string; pattern restricts to non-negative integers so
+     * `parseInt` never produces NaN. Coerced to integer in the route handler.
+     */
+    max_duration_ms: Type.Optional(Type.String({ pattern: "^\\d+$" })),
+    /**
+     * Page size (1–1000, MCP default 100).
+     * Arrives as a string; pattern restricts to non-negative integers.
+     * Coerced to integer in the route handler. Default `100` applied on
+     * missing value. MCP enforces the 1–1000 range.
+     */
+    limit: Type.Optional(Type.String({ pattern: "^\\d+$" })),
+    /**
+     * Offset-based pagination skip count (≥0, MCP default 0).
+     * Arrives as a string; pattern restricts to non-negative integers.
+     * Coerced to integer in the route handler.
+     */
+    offset: Type.Optional(Type.String({ pattern: "^\\d+$" })),
+    /** Cursor timestamp for keyset pagination (ISO 8601). Must pair with `cursor_id`. */
+    cursor_requested_at: Type.Optional(Type.String()),
+    /** Cursor UUID for keyset pagination. Must pair with `cursor_requested_at`. */
+    cursor_id: Type.Optional(Type.String()),
+}, { additionalProperties: false });
+//# sourceMappingURL=audit.schema.js.map

package/dist/runtime-api/routes/audit.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.schema.js","sourceRoot":"","sources":["../../../src/runtime-api/routes/audit.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CACnC;IACE;;;OAGG;IACH,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAEtC,0DAA0D;IAC1D,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAEvC;;;OAGG;IACH,WAAW,EAAE,IAAI,CAAC,QAAQ,CACxB,IAAI,CAAC,KAAK,CAAC;QACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QACtB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KACvB,CAAC,CACH;IAED;;;OAGG;IACH,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAC1D;IAED,wDAAwD;IACxD,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAExC,wDAAwD;IACxD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAEtC;;;;OAIG;IACH,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAElE;;;;OAIG;IACH,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAElE;;;;;OAKG;IACH,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExD;;;;OAIG;IACH,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAEzD,qFAAqF;IACrF,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAEjD,+EAA+E;IAC/E,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACxC,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC"}

package/dist/runtime-api/routes/health.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Fastify route: `GET /health`.
+ *
+ * Returns a three-state readiness signal (`starting` | `ok` | `draining`)
+ * suitable for load-balancer / Kubernetes liveness and readiness probes.
+ * Also exposes per-runtime signal-queue depth for capacity planning.
+ *
+ * HTTP status:
+ *  - `200` when `status === "ok"`.
+ *  - `503` when `status === "starting"` or `"draining"` — load balancer
+ *    should stop routing new requests but the process is still alive.
+ */
+import type { FastifyInstance } from "fastify";
+import type { Readiness } from "../readiness.js";
+import type { RuntimeHandle } from "../../runtime/run.js";
+/**
+ * Dependencies injected into the `/health` route at registration time.
+ */
+export interface HealthRouteDeps {
+    /** Live runtime handles maintained by the plugin, keyed by lowercased address. */
+    runtimeHandles: Map<string, RuntimeHandle>;
+    /** Subset of `ApiConfig` needed for the response body. */
+    apiConfig: {
+        host: string;
+        port: number;
+    };
+    /**
+     * Three-state readiness flag.
+     * S5 (lifecycle) flips it to `"ok"` after the server binds and to
+     * `"draining"` during graceful shutdown.
+     */
+    readiness: Readiness;
+    /**
+     * Plugin version string (read from `openclaw.plugin.json` at boot).
+     * Included in the response so callers can correlate logs with deployments.
+     */
+    version: string;
+    /** Unix epoch ms timestamp recorded when `createApi()` was called. */
+    bootedAt: number;
+}
+/**
+ * Register `GET /health` on the given Fastify instance.
+ *
+ * Response is never cached (`Cache-Control: no-store`). The shape is stable
+ * across minor versions — callers may rely on `status`, `runtimes.count`, and
+ * `runtimes.items[].signalQueueDepth` being present whenever the server is
+ * reachable.
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export declare function registerHealthRoute(fastify: FastifyInstance, deps: HealthRouteDeps): void;
+//# sourceMappingURL=health.d.ts.map

package/dist/runtime-api/routes/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,0DAA0D;IAC1D,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C;;;;OAIG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,eAAe,GACpB,IAAI,CAyBN"}

package/dist/runtime-api/routes/health.js

@@ -0,0 +1,48 @@
+/**
+ * Fastify route: `GET /health`.
+ *
+ * Returns a three-state readiness signal (`starting` | `ok` | `draining`)
+ * suitable for load-balancer / Kubernetes liveness and readiness probes.
+ * Also exposes per-runtime signal-queue depth for capacity planning.
+ *
+ * HTTP status:
+ *  - `200` when `status === "ok"`.
+ *  - `503` when `status === "starting"` or `"draining"` — load balancer
+ *    should stop routing new requests but the process is still alive.
+ */
+/**
+ * Register `GET /health` on the given Fastify instance.
+ *
+ * Response is never cached (`Cache-Control: no-store`). The shape is stable
+ * across minor versions — callers may rely on `status`, `runtimes.count`, and
+ * `runtimes.items[].signalQueueDepth` being present whenever the server is
+ * reachable.
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export function registerHealthRoute(fastify, deps) {
+    fastify.get("/health", async (_req, reply) => {
+        const status = deps.readiness.state();
+        const httpStatus = status === "ok" ? 200 : 503;
+        const items = Array.from(deps.runtimeHandles, ([_id, handle]) => ({
+            address: handle.wallet.toLowerCase(),
+            signalQueueDepth: handle.getSignalQueueDepth(),
+        }));
+        return reply
+            .status(httpStatus)
+            .header("Cache-Control", "no-store")
+            .send({
+            status,
+            version: deps.version,
+            uptime_ms: Date.now() - deps.bootedAt,
+            runtimes: { count: items.length, items },
+            api: { host: deps.apiConfig.host, port: deps.apiConfig.port },
+            build: {
+                commit: process.env.SENPI_GIT_COMMIT ?? null,
+                node: process.version,
+            },
+        });
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/runtime-api/routes/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../src/runtime-api/routes/health.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6BH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB,EACxB,IAAqB;IAErB,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAE/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAChE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE;YACpC,gBAAgB,EAAE,MAAM,CAAC,mBAAmB,EAAE;SAC/C,CAAC,CAAC,CAAC;QAEJ,OAAO,KAAK;aACT,MAAM,CAAC,UAAU,CAAC;aAClB,MAAM,CAAC,eAAe,EAAE,UAAU,CAAC;aACnC,IAAI,CAAC;YACJ,MAAM;YACN,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ;YACrC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE;YACxC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;YAC7D,KAAK,EAAE;gBACL,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,IAAI;gBAC5C,IAAI,EAAE,OAAO,CAAC,OAAO;aACtB;SACF,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runtime-api/routes/signals.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Fastify route: `POST /signals`.
+ *
+ * Accepts a batch of signal items targeting one or more runtime wallets,
+ * groups them by `(address, scanner)` to avoid the per-key ingest lock, fans
+ * out groups in parallel, processes items within each group sequentially, and
+ * returns per-item results in input order.
+ *
+ * Business logic lives entirely in:
+ *  - `handlers/ingest-signals.ts` — per-item dispatch + error translation.
+ *  - `handlers/group-by-scanner.ts` — lock-aware grouping helper.
+ *
+ * This file contains only Fastify wiring and the handler-level cap check.
+ */
+import type { FastifyInstance } from "fastify";
+import type { RuntimeHandle } from "../../runtime/run.js";
+import type { Logger } from "../../utils/logger.js";
+/**
+ * Dependencies injected into the `/signals` route at registration time.
+ */
+export interface SignalsRouteDeps {
+    /** Live runtime handles maintained by the plugin, keyed by lowercased address. */
+    runtimeHandles: Map<string, RuntimeHandle>;
+    /** Logger instance for unexpected errors. */
+    logger: Logger;
+    /**
+     * Maximum number of items allowed in a single request.
+     * Sourced from `config.api.maxItemsPerSignalsRequest` (default 10).
+     */
+    maxItems: number;
+    /**
+     * Transport tag forwarded to the ingest handler for telemetry.
+     * Fixed as `"http"` for this route; the gateway shim passes `"gateway"`.
+     */
+    transport: "http" | "gateway";
+}
+/**
+ * Register `POST /signals` on the given Fastify instance.
+ *
+ * The route validates the body against the `SignalsBody` TypeBox schema, then:
+ * 1. Rejects oversized batches (handler-level cap, configurable).
+ * 2. Groups items by `(address, scanner)` via `groupByAddressScanner`.
+ * 3. Runs groups in parallel; items within each group run sequentially.
+ * 4. Re-flattens results back to input order before responding.
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export declare function registerSignalsRoute(fastify: FastifyInstance, deps: SignalsRouteDeps): void;
+//# sourceMappingURL=signals.d.ts.map

package/dist/runtime-api/routes/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/routes/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,gBAAgB,GACrB,IAAI,CA6CN"}

package/dist/runtime-api/routes/signals.js

@@ -0,0 +1,65 @@
+/**
+ * Fastify route: `POST /signals`.
+ *
+ * Accepts a batch of signal items targeting one or more runtime wallets,
+ * groups them by `(address, scanner)` to avoid the per-key ingest lock, fans
+ * out groups in parallel, processes items within each group sequentially, and
+ * returns per-item results in input order.
+ *
+ * Business logic lives entirely in:
+ *  - `handlers/ingest-signals.ts` — per-item dispatch + error translation.
+ *  - `handlers/group-by-scanner.ts` — lock-aware grouping helper.
+ *
+ * This file contains only Fastify wiring and the handler-level cap check.
+ */
+import { SignalsBody } from "./signals.schema.js";
+import { ingestSignalsHandler } from "../handlers/ingest-signals.js";
+import { groupByAddressScanner } from "../handlers/group-by-scanner.js";
+/**
+ * Register `POST /signals` on the given Fastify instance.
+ *
+ * The route validates the body against the `SignalsBody` TypeBox schema, then:
+ * 1. Rejects oversized batches (handler-level cap, configurable).
+ * 2. Groups items by `(address, scanner)` via `groupByAddressScanner`.
+ * 3. Runs groups in parallel; items within each group run sequentially.
+ * 4. Re-flattens results back to input order before responding.
+ *
+ * @param fastify  Fastify instance to register the route on.
+ * @param deps     Route dependencies injected at plugin start.
+ */
+export function registerSignalsRoute(fastify, deps) {
+    fastify.post("/signals", { schema: { body: SignalsBody } }, async (req, reply) => {
+        const items = req.body;
+        // Handler-level cap — operator-tunable, not encoded in the TypeBox schema.
+        if (items.length > deps.maxItems) {
+            return reply.status(400).send({
+                success: false,
+                code: "INVALID_REQUEST",
+                message: `Exceeded api.maxItemsPerSignalsRequest=${deps.maxItems}; got ${items.length}.`,
+            });
+        }
+        // Group by (address, scanner) — each group is a SignalGroup (IndexedSignalItem[]).
+        const groups = groupByAddressScanner(items);
+        // Fan out across groups in parallel; process items within each group sequentially.
+        const grouped = await Promise.all(groups.map(async (group) => {
+            const out = [];
+            for (const { index, item } of group) {
+                out.push({
+                    index,
+                    result: await ingestSignalsHandler(item, {
+                        runtimeHandles: deps.runtimeHandles,
+                        logger: deps.logger,
+                        transport: deps.transport,
+                    }),
+                });
+            }
+            return out;
+        }));
+        // Re-flatten in input order.
+        const flat = grouped.flat();
+        flat.sort((a, b) => a.index - b.index);
+        const results = flat.map((entry) => entry.result);
+        return reply.send({ results });
+    });
+}
+//# sourceMappingURL=signals.js.map

package/dist/runtime-api/routes/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../src/runtime-api/routes/signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAyBxE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAwB,EACxB,IAAsB;IAEtB,OAAO,CAAC,IAAI,CACV,UAAU,EACV,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EACjC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACnB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAoB,CAAC;QAEvC,2EAA2E;QAC3E,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC5B,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,0CAA0C,IAAI,CAAC,QAAQ,SAAS,KAAK,CAAC,MAAM,GAAG;aACzF,CAAC,CAAC;QACL,CAAC;QAED,mFAAmF;QACnF,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE5C,mFAAmF;QACnF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,GAAG,GAAmD,EAAE,CAAC;YAC/D,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;gBACpC,GAAG,CAAC,IAAI,CAAC;oBACP,KAAK;oBACL,MAAM,EAAE,MAAM,oBAAoB,CAAC,IAAI,EAAE;wBACvC,cAAc,EAAE,IAAI,CAAC,cAAc;wBACnC,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B,CAAC;iBACH,CAAC,CAAC;YACL,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CACH,CAAC;QAEF,6BAA6B;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,GAAmB,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAElE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IACjC,CAAC,CACF,CAAC;AACJ,CAAC"}