@senpi/runtime 1.0.95-dev.runtime-phase-2-api.20260505163136 → 1.0.95-dev.runtime-phase-2.20260506193916

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

@@ -1,58 +0,0 @@
-/**
- * TypeBox schema for the `POST /signals` request body.
- *
- * `SignalItemT` is derived from TypeBox `Static<>` and is structurally
- * compatible with the hand-written {@link SignalItem} interface in
- * `handlers/types.ts`. The interface in `handlers/types.ts` is kept as the
- * canonical description (referenced by JSDoc across the codebase); this module
- * derives the runtime-validatable form from TypeBox so both shapes stay in
- * sync at compile-time.
- *
- * Note on `direction`: the TypeBox schema accepts any string so
- * `SignalItemT["direction"]` is `string | undefined`, matching
- * `Signal["direction"]` in `scanners/types.ts`. The tighter
- * `"long" | "short" | null` constraint lives in the MCP layer; the runtime
- * applies it implicitly during scanner-engine ingest.
- *
- * Note on `maxItems`: enforced at handler level using the configured
- * `api.maxItemsPerSignalsRequest` value (default 10). Schema-level cap is
- * kept open-ended so the shape works in tests without recompiling.
- */
-import { Type } from "@sinclair/typebox";
-/** TypeBox schema for one item in the `POST /signals` body. */
-export const SignalItem = Type.Object({
-    /** Wallet address of the target runtime. Lowercased server-side. */
-    address: Type.String({ minLength: 1 }),
-    /** Configured scanner id. */
-    scanner: Type.String({ minLength: 1 }),
-    /** Asset for a single ingested signal. */
-    asset: Type.Optional(Type.String()),
-    /**
-     * Direction for a single ingested signal.
-     * Accepts any string — `"long"` / `"short"` are the conventional values.
-     */
-    direction: Type.Optional(Type.String()),
-    /** Confidence score for a single ingested signal (0–1). */
-    score: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
-    /** Signal classification override for a single ingested signal. */
-    signal_type: Type.Optional(Type.String()),
-    /**
-     * Single ingest payload for signal-producing or context-producing scanners.
-     * Mutually exclusive with `signals[]`.
-     */
-    data: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
-    /**
-     * Batch signal payloads for signal-producing external scanners.
-     * Mutually exclusive with `data`.
-     */
-    signals: Type.Optional(Type.Array(Type.Object({
-        asset: Type.String(),
-        direction: Type.Optional(Type.String()),
-        score: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),
-        signal_type: Type.Optional(Type.String()),
-        data: Type.Record(Type.String(), Type.Unknown()),
-    }))),
-}, { additionalProperties: false });
-/** TypeBox schema for the full `POST /signals` request body array. */
-export const SignalsBody = Type.Array(SignalItem, { minItems: 1 });
-//# sourceMappingURL=signals.schema.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"signals.schema.js","sourceRoot":"","sources":["../../../src/runtime-api/routes/signals.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CACnC;IACE,oEAAoE;IACpE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtC,6BAA6B;IAC7B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtC,0CAA0C;IAC1C,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACnC;;;OAGG;IACH,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,2DAA2D;IAC3D,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7D,mEAAmE;IACnE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/D;;;OAGG;IACH,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,KAAK,CACR,IAAI,CAAC,MAAM,CAAC;QACV,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACvC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;KACjD,CAAC,CACH,CACF;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/runtime-api/server.d.ts

@@ -1,79 +0,0 @@
-/**
- * `createApi()` — Fastify server factory for the runtime HTTP API.
- *
- * Wires the Fastify instance with:
- *  - `POST /signals` — ingest signals for one or more wallets.
- *  - `GET  /audit`   — MCP audit-query proxy scoped to one wallet.
- *  - `GET  /health`  — three-state readiness + per-runtime queue depth.
- *
- * Returns the Fastify instance, the mutable readiness flag, and the boot
- * timestamp. The lifecycle layer (S5) calls `fastify.listen()` and flips
- * `readiness.setOk()` / `readiness.setDraining()` around start/stop.
- *
- * This module owns only wiring — no business logic. All route logic
- * delegates to the shared handlers in `handlers/`.
- */
-import { type FastifyInstance } from "fastify";
-import { createReadiness } from "./readiness.js";
-import type { RuntimeHandle } from "../runtime/run.js";
-import type { Logger } from "../utils/logger.js";
-import type { ApiConfig } from "./config.js";
-/**
- * Dependencies passed to {@link createApi}.
- */
-export interface CreateApiDeps {
-    /** Live runtime handles maintained by the plugin, keyed by lowercased address. */
-    runtimeHandles: Map<string, RuntimeHandle>;
-    /** Validated `api` config block (host, port, maxItemsPerSignalsRequest). */
-    apiConfig: ApiConfig;
-    /** Logger instance — forwarded to shared handlers for structured error logging. */
-    logger: Logger;
-    /**
-     * Plugin version string read from `openclaw.plugin.json` at boot.
-     * Exposed in `GET /health` so callers can correlate requests with deployments.
-     */
-    version: string;
-}
-/**
- * Artifacts returned by {@link createApi}.
- *
- * Ownership:
- *  - `fastify`   — call `.listen()` and `.close()` in the lifecycle layer (S5).
- *  - `readiness` — call `setOk()` after `.listen()` resolves; `setDraining()`
- *                  before `.close()` during graceful shutdown.
- *  - `bootedAt`  — Unix epoch ms recorded when `createApi()` was called;
- *                  used by `GET /health` to compute `uptime_ms`.
- */
-export interface ApiArtifacts {
-    fastify: FastifyInstance;
-    readiness: ReturnType<typeof createReadiness>;
-    bootedAt: number;
-}
-/**
- * Create and configure the Fastify HTTP server.
- *
- * Does NOT start listening. Call `artifacts.fastify.listen(...)` from the
- * lifecycle layer (S5) after `createApi()` returns.
- *
- * Error handler behaviour:
- *  - `400` (schema validation), `413` (body too large), `415` (wrong
- *    content-type) are passed through as `INVALID_REQUEST` with the original
- *    Fastify message so callers can read the validation detail.
- *  - All other errors are logged and returned as `500 / UNAVAILABLE`.
- *
- * Request timeout strategy (resolved in S5):
- *  A single server-wide `requestTimeout: 30_000` covers all routes.
- *  The plan called for per-route values (10s for `/signals` + `/health`,
- *  30s for `/audit`), but Fastify v5 does not expose a declarative per-route
- *  `requestTimeout` and wiring an `onRequest` hook with manual `setTimeout`
- *  calls adds meaningful complexity for a localhost-only server where requests
- *  that genuinely hang are almost always MCP-side.  The 30s ceiling is driven
- *  entirely by `/audit` (MCP round-trip); `/signals` and `/health` both
- *  complete in well under 1s in practice.  If per-route enforcement becomes
- *  necessary, add an `onRequest` hook in this file.
- *
- * @param deps  Dependencies injected by the plugin entry point.
- * @returns     `{ fastify, readiness, bootedAt }`.
- */
-export declare function createApi(deps: CreateApiDeps): ApiArtifacts;
-//# sourceMappingURL=server.d.ts.map

package/dist/runtime-api/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/runtime-api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAIxD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,4EAA4E;IAC5E,SAAS,EAAE,SAAS,CAAC;IACrB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,YAAY,CAiE3D"}

package/dist/runtime-api/server.js

@@ -1,105 +0,0 @@
-/**
- * `createApi()` — Fastify server factory for the runtime HTTP API.
- *
- * Wires the Fastify instance with:
- *  - `POST /signals` — ingest signals for one or more wallets.
- *  - `GET  /audit`   — MCP audit-query proxy scoped to one wallet.
- *  - `GET  /health`  — three-state readiness + per-runtime queue depth.
- *
- * Returns the Fastify instance, the mutable readiness flag, and the boot
- * timestamp. The lifecycle layer (S5) calls `fastify.listen()` and flips
- * `readiness.setOk()` / `readiness.setDraining()` around start/stop.
- *
- * This module owns only wiring — no business logic. All route logic
- * delegates to the shared handlers in `handlers/`.
- */
-import Fastify from "fastify";
-import { registerSignalsRoute } from "./routes/signals.js";
-import { registerAuditRoute } from "./routes/audit.js";
-import { registerHealthRoute } from "./routes/health.js";
-import { createReadiness } from "./readiness.js";
-/**
- * Create and configure the Fastify HTTP server.
- *
- * Does NOT start listening. Call `artifacts.fastify.listen(...)` from the
- * lifecycle layer (S5) after `createApi()` returns.
- *
- * Error handler behaviour:
- *  - `400` (schema validation), `413` (body too large), `415` (wrong
- *    content-type) are passed through as `INVALID_REQUEST` with the original
- *    Fastify message so callers can read the validation detail.
- *  - All other errors are logged and returned as `500 / UNAVAILABLE`.
- *
- * Request timeout strategy (resolved in S5):
- *  A single server-wide `requestTimeout: 30_000` covers all routes.
- *  The plan called for per-route values (10s for `/signals` + `/health`,
- *  30s for `/audit`), but Fastify v5 does not expose a declarative per-route
- *  `requestTimeout` and wiring an `onRequest` hook with manual `setTimeout`
- *  calls adds meaningful complexity for a localhost-only server where requests
- *  that genuinely hang are almost always MCP-side.  The 30s ceiling is driven
- *  entirely by `/audit` (MCP round-trip); `/signals` and `/health` both
- *  complete in well under 1s in practice.  If per-route enforcement becomes
- *  necessary, add an `onRequest` hook in this file.
- *
- * @param deps  Dependencies injected by the plugin entry point.
- * @returns     `{ fastify, readiness, bootedAt }`.
- */
-export function createApi(deps) {
-    const bootedAt = Date.now();
-    const readiness = createReadiness();
-    const fastify = Fastify({
-        logger: { level: "info" },
-        bodyLimit: 256 * 1024, // 256 KB — generous for signal batches, hard cap on abuse.
-        disableRequestLogging: false,
-        /**
-         * 30s request ceiling — driven by `/audit` (MCP round-trip).
-         * `/signals` and `/health` complete far faster; we accept the unified
-         * ceiling to avoid per-route hook complexity on a localhost-only server.
-         * Documented in docs/runtime-docs/runtime-api.md.
-         */
-        requestTimeout: 30_000,
-    });
-    // Custom error handler — normalises Fastify validation / payload errors into
-    // the same `{ success, code, message }` envelope used by all three routes.
-    fastify.setErrorHandler((error, _req, reply) => {
-        // Fastify v5 types setErrorHandler with `unknown`; cast once for the handler.
-        const err = error;
-        const statusCode = err.statusCode;
-        if (statusCode === 400 ||
-            statusCode === 413 ||
-            statusCode === 415) {
-            return reply.status(statusCode).send({
-                success: false,
-                code: "INVALID_REQUEST",
-                message: err.message,
-            });
-        }
-        deps.logger.error("[senpi-core][runtime-api] Unhandled error", {
-            err,
-        });
-        return reply.status(500).send({
-            success: false,
-            code: "UNAVAILABLE",
-            message: err.message,
-        });
-    });
-    registerSignalsRoute(fastify, {
-        runtimeHandles: deps.runtimeHandles,
-        logger: deps.logger,
-        maxItems: deps.apiConfig.maxItemsPerSignalsRequest,
-        transport: "http",
-    });
-    registerAuditRoute(fastify, {
-        runtimeHandles: deps.runtimeHandles,
-        logger: deps.logger,
-    });
-    registerHealthRoute(fastify, {
-        runtimeHandles: deps.runtimeHandles,
-        apiConfig: { host: deps.apiConfig.host, port: deps.apiConfig.port },
-        readiness,
-        version: deps.version,
-        bootedAt,
-    });
-    return { fastify, readiness, bootedAt };
-}
-//# sourceMappingURL=server.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/runtime-api/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,OAAiC,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAsCjD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC5B,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAG,OAAO,CAAC;QACtB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACzB,SAAS,EAAE,GAAG,GAAG,IAAI,EAAE,2DAA2D;QAClF,qBAAqB,EAAE,KAAK;QAC5B;;;;;WAKG;QACH,cAAc,EAAE,MAAM;KACvB,CAAC,CAAC;IAEH,6EAA6E;IAC7E,2EAA2E;IAC3E,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QAC7C,8EAA8E;QAC9E,MAAM,GAAG,GAAG,KAAwC,CAAC;QACrD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAClC,IACE,UAAU,KAAK,GAAG;YAClB,UAAU,KAAK,GAAG;YAClB,UAAU,KAAK,GAAG,EAClB,CAAC;YACD,OAAO,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC;gBACnC,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,EAAE;YAC7D,GAAG;SACJ,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YAC5B,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,oBAAoB,CAAC,OAAO,EAAE;QAC5B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,yBAAyB;QAClD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IAEH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,mBAAmB,CAAC,OAAO,EAAE;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QACnE,SAAS;QACT,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ;KACT,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC"}