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

package/dist/runtime/audit-query.types.d.ts

@@ -1,113 +0,0 @@
-/**
- * Type definitions for the `RuntimeHandle.auditQuery` public method.
- *
- * These mirror the MCP `audit_query` tool contract (defined in
- * senpi-hyperliquid-mcp/src/tools/audit.tools.ts) but expressed as plain
- * TypeScript interfaces — Zod stays inside MCP, TypeBox stays inside
- * runtime-api. Anything new added to the MCP zod schema must be reflected
- * here as well.
- *
- * The implementation owns four MCP arguments and silently overrides any
- * caller-supplied values — these are intentionally absent from
- * {@link AuditQueryArgs}:
- *  - `resource_type` (always `"strategy"`)
- *  - `resource_id`   (resolved wallet → strategyId)
- *  - `user_ids`      (server-controlled — the MCP API key user)
- *  - `usernames`     (server-controlled — same)
- */
-/**
- * Caller-controlled subset of MCP `audit_query` parameters.
- *
- * Every field is optional. Field names match the MCP schema verbatim so
- * pass-through to the underlying tool stays drift-free.
- *
- * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts (`auditQueryInputSchema`)
- */
-export interface AuditQueryArgs {
-    /** Filter by exact tool name (e.g. `create_position`). */
-    tool_name?: string;
-    /** Filter by action classification. */
-    action_type?: "read" | "create" | "update" | "delete";
-    /** Filter by success/failure. */
-    success?: boolean;
-    /** ISO 8601 inclusive lower bound on `requested_at`. */
-    start_time?: string;
-    /** ISO 8601 inclusive upper bound on `requested_at`. */
-    end_time?: string;
-    /** Minimum end-to-end duration in ms (find slow operations). */
-    min_duration_ms?: number;
-    /** Maximum end-to-end duration in ms (find fast operations). */
-    max_duration_ms?: number;
-    /** Page size; MCP defaults to 100, max 1000. */
-    limit?: number;
-    /** Offset-based pagination skip count; MCP default 0. */
-    offset?: number;
-    /** Cursor timestamp for keyset pagination (must pair with `cursor_id`). */
-    cursor_requested_at?: string;
-    /** Cursor id (UUID) for keyset pagination (must pair with `cursor_requested_at`). */
-    cursor_id?: string;
-}
-/**
- * Single audit-log entry as returned by MCP `audit_query`.
- *
- * @see senpi-hyperliquid-mcp/src/tools/audit.tools.ts (JSDoc on `handleAuditQuery`)
- */
-export interface AuditEntry {
-    /** Unique audit-entry identifier. */
-    id: string;
-    /** Request identifier; correlates to MCP request id. */
-    request_id: string;
-    /** When the tool was invoked (ISO 8601). */
-    timestamp: string;
-    /** When execution finished (ISO 8601); may be absent on in-flight or partial entries. */
-    completed_at: string | null;
-    /** End-to-end execution time in milliseconds, including downstream latency. */
-    duration_ms: number | null;
-    /** Authenticated Senpi user id who performed the action. */
-    user_id: string;
-    /** Exact tool name invoked. */
-    tool: string;
-    /** Action classification. */
-    action_type: "read" | "create" | "update" | "delete";
-    /** AI-generated reasoning string; null for read tools. */
-    ai_reasoning: string | null;
-    /** Boolean indicating successful completion. */
-    success: boolean;
-    /** Error code when `success === false`. */
-    error_code: string | null;
-    /** Failure details when `success === false`. */
-    error_message: string | null;
-    /** Resources touched by the action (each `{ type, id }`). */
-    affected_resources: Array<{
-        type: string;
-        id: string;
-    }>;
-}
-/**
- * Pass-through MCP `audit_query` response payload (the `.data` portion of
- * the MCP envelope, after `unwrapEnvelope` strips `success`/`meta`).
- */
-export interface AuditQueryResult {
-    /** Audit entries on the current page. */
-    entries: AuditEntry[];
-    /** Number of entries on the current page. */
-    count: number;
-    /** Approximate total matching entries (exact for small sets). */
-    total: number;
-    /** Whether further results exist beyond the current page. */
-    has_more: boolean;
-}
-/**
- * Discriminated error class thrown by {@link RuntimeHandle.auditQuery}.
- *
- * Codes:
- *  - `NOT_FOUND` — `listStrategies` returned 0 matches for the runtime's
- *    wallet (the wallet does not belong to the API-key user).
- *  - `UPSTREAM`  — MCP returned an error (network, auth, schema).
- *  - `ABORTED`   — caller aborted via `opts.signal` before MCP responded.
- */
-export declare class AuditQueryError extends Error {
-    readonly code: "NOT_FOUND" | "UPSTREAM" | "ABORTED";
-    constructor(code: "NOT_FOUND" | "UPSTREAM" | "ABORTED", message: string);
-}
-//# sourceMappingURL=audit-query.types.d.ts.map

package/dist/runtime/audit-query.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audit-query.types.d.ts","sourceRoot":"","sources":["../../src/runtime/audit-query.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,0DAA0D;IAC1D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6DAA6D;IAC7D,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;gBAE/C,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM;CAKxE"}

package/dist/runtime/audit-query.types.js

@@ -1,35 +0,0 @@
-/**
- * Type definitions for the `RuntimeHandle.auditQuery` public method.
- *
- * These mirror the MCP `audit_query` tool contract (defined in
- * senpi-hyperliquid-mcp/src/tools/audit.tools.ts) but expressed as plain
- * TypeScript interfaces — Zod stays inside MCP, TypeBox stays inside
- * runtime-api. Anything new added to the MCP zod schema must be reflected
- * here as well.
- *
- * The implementation owns four MCP arguments and silently overrides any
- * caller-supplied values — these are intentionally absent from
- * {@link AuditQueryArgs}:
- *  - `resource_type` (always `"strategy"`)
- *  - `resource_id`   (resolved wallet → strategyId)
- *  - `user_ids`      (server-controlled — the MCP API key user)
- *  - `usernames`     (server-controlled — same)
- */
-/**
- * Discriminated error class thrown by {@link RuntimeHandle.auditQuery}.
- *
- * Codes:
- *  - `NOT_FOUND` — `listStrategies` returned 0 matches for the runtime's
- *    wallet (the wallet does not belong to the API-key user).
- *  - `UPSTREAM`  — MCP returned an error (network, auth, schema).
- *  - `ABORTED`   — caller aborted via `opts.signal` before MCP responded.
- */
-export class AuditQueryError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "AuditQueryError";
-        this.code = code;
-    }
-}
-//# sourceMappingURL=audit-query.types.js.map

package/dist/runtime/audit-query.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"audit-query.types.js","sourceRoot":"","sources":["../../src/runtime/audit-query.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoFH;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,IAAI,CAAuC;IAE3D,YAAY,IAA0C,EAAE,OAAe;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

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

@@ -1,47 +0,0 @@
-/**
- * TypeBox schema and loader for the `api` block in the openclaw plugin config.
- *
- * The `api` block is an optional top-level property inside `openclaw.json`
- * `plugins[*].config`. If the operator omits it entirely — or omits individual
- * fields — this module fills in the documented defaults so the rest of the
- * runtime-api code can rely on a fully-typed, always-present value.
- */
-import { type Static } from "@sinclair/typebox";
-/** TypeBox schema for the `api` config block. Mirrors openclaw.plugin.json. */
-export declare const ApiConfigSchema: import("@sinclair/typebox").TObject<{
-    /**
-     * Bind interface for the HTTP server inside the openclaw container.
-     * Default `127.0.0.1` — container loopback only (most secure).
-     * Set to `0.0.0.0` to enable Docker port mapping for Postman testing.
-     * A boot-time warning is logged when this is not `127.0.0.1`.
-     */
-    host: import("@sinclair/typebox").TString;
-    /**
-     * TCP port the HTTP server listens on.
-     * Default `8787`. Must be in [1, 65535].
-     */
-    port: import("@sinclair/typebox").TInteger;
-    /**
-     * Maximum number of items allowed in a single `POST /signals` request body.
-     * Conservative default of `10` — operators raise it deliberately when
-     * broadcasting to many wallets at once.
-     */
-    maxItemsPerSignalsRequest: import("@sinclair/typebox").TInteger;
-}>;
-/** Typed `api` config block derived from the TypeBox schema. */
-export type ApiConfig = Static<typeof ApiConfigSchema>;
-/**
- * Load and validate the `api` config block from the full plugin config object.
- *
- * Merges operator-supplied values over the defaults, then validates the result
- * against {@link ApiConfigSchema}. Throws if any field is out of range or the
- * wrong type (e.g. a port value of 99999).
- *
- * @param pluginConfig - The entire plugin config object as passed by openclaw to
- *   `register(api)`. May be `undefined`, `null`, or a plain object. The function
- *   reads only the `api` sub-key; all other keys are ignored.
- * @returns A fully-typed {@link ApiConfig} with all defaults applied.
- * @throws {Error} If the merged config fails TypeBox validation (e.g. port out of range).
- */
-export declare function loadApiConfig(pluginConfig: unknown): ApiConfig;
-//# sourceMappingURL=config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/runtime-api/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAGtD,+EAA+E;AAC/E,eAAO,MAAM,eAAe;IAExB;;;;;OAKG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;EAQN,CAAC;AAEF,gEAAgE;AAChE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,eAAe,CAAC,CAAC;AASvD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,OAAO,GAAG,SAAS,CAsB9D"}

package/dist/runtime-api/config.js

@@ -1,74 +0,0 @@
-/**
- * TypeBox schema and loader for the `api` block in the openclaw plugin config.
- *
- * The `api` block is an optional top-level property inside `openclaw.json`
- * `plugins[*].config`. If the operator omits it entirely — or omits individual
- * fields — this module fills in the documented defaults so the rest of the
- * runtime-api code can rely on a fully-typed, always-present value.
- */
-import { Type } from "@sinclair/typebox";
-import { Value } from "@sinclair/typebox/value";
-/** TypeBox schema for the `api` config block. Mirrors openclaw.plugin.json. */
-export const ApiConfigSchema = Type.Object({
-    /**
-     * Bind interface for the HTTP server inside the openclaw container.
-     * Default `127.0.0.1` — container loopback only (most secure).
-     * Set to `0.0.0.0` to enable Docker port mapping for Postman testing.
-     * A boot-time warning is logged when this is not `127.0.0.1`.
-     */
-    host: Type.String({ default: "127.0.0.1" }),
-    /**
-     * TCP port the HTTP server listens on.
-     * Default `8787`. Must be in [1, 65535].
-     */
-    port: Type.Integer({ minimum: 1, maximum: 65535, default: 8787 }),
-    /**
-     * Maximum number of items allowed in a single `POST /signals` request body.
-     * Conservative default of `10` — operators raise it deliberately when
-     * broadcasting to many wallets at once.
-     */
-    maxItemsPerSignalsRequest: Type.Integer({
-        minimum: 1,
-        maximum: 1000,
-        default: 10,
-    }),
-}, { additionalProperties: false });
-/** Default values applied when the operator omits the `api` block or individual fields. */
-const API_CONFIG_DEFAULTS = {
-    host: "127.0.0.1",
-    port: 8787,
-    maxItemsPerSignalsRequest: 10,
-};
-/**
- * Load and validate the `api` config block from the full plugin config object.
- *
- * Merges operator-supplied values over the defaults, then validates the result
- * against {@link ApiConfigSchema}. Throws if any field is out of range or the
- * wrong type (e.g. a port value of 99999).
- *
- * @param pluginConfig - The entire plugin config object as passed by openclaw to
- *   `register(api)`. May be `undefined`, `null`, or a plain object. The function
- *   reads only the `api` sub-key; all other keys are ignored.
- * @returns A fully-typed {@link ApiConfig} with all defaults applied.
- * @throws {Error} If the merged config fails TypeBox validation (e.g. port out of range).
- */
-export function loadApiConfig(pluginConfig) {
-    const raw = pluginConfig !== null &&
-        typeof pluginConfig === "object" &&
-        "api" in pluginConfig
-        ? pluginConfig["api"]
-        : undefined;
-    const merged = {
-        ...API_CONFIG_DEFAULTS,
-        ...(raw !== null && typeof raw === "object" ? raw : {}),
-    };
-    if (!Value.Check(ApiConfigSchema, merged)) {
-        const firstError = Value.Errors(ApiConfigSchema, merged).First();
-        const detail = firstError
-            ? `${firstError.path}: ${firstError.message}`
-            : "unknown validation error";
-        throw new Error(`Invalid runtime api config — ${detail}`);
-    }
-    return merged;
-}
-//# sourceMappingURL=config.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/runtime-api/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAEhD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CACxC;IACE;;;;;OAKG;IACH,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAE3C;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAEjE;;;;OAIG;IACH,yBAAyB,EAAE,IAAI,CAAC,OAAO,CAAC;QACtC,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,EAAE;KACZ,CAAC;CACH,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAKF,2FAA2F;AAC3F,MAAM,mBAAmB,GAAc;IACrC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,IAAI;IACV,yBAAyB,EAAE,EAAE;CAC9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,YAAqB;IACjD,MAAM,GAAG,GACP,YAAY,KAAK,IAAI;QACrB,OAAO,YAAY,KAAK,QAAQ;QAChC,KAAK,IAAK,YAAwC;QAChD,CAAC,CAAE,YAAwC,CAAC,KAAK,CAAC;QAClD,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,MAAM,GAAc;QACxB,GAAG,mBAAmB;QACtB,GAAG,CAAC,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;KAChF,CAAC;IAEF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,UAAU;YACvB,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,OAAO,EAAE;YAC7C,CAAC,CAAC,0BAA0B,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -1,76 +0,0 @@
-/**
- * Shared audit handler for `GET /audit`.
- *
- * Delegates to `RuntimeHandle.auditQuery` and translates `AuditQueryError`
- * codes into the HTTP-layer result shape. Called by the Fastify route (S4).
- *
- * Note: this handler uses `ok` (not `success`) because it is a single-resource
- * response, not a per-item fan-out array. Keep `ok` and `success` distinct —
- * the `POST /signals` shape uses `success` (Section 5 plan).
- */
-import type { AuditQueryArgs, AuditQueryResult } from "../../runtime/audit-query.types.js";
-import type { RuntimeHandle } from "../../runtime/run.js";
-import type { Logger } from "../../utils/logger.js";
-/**
- * Dependencies injected into {@link auditHandler}.
- */
-export interface AuditDeps {
-    /** Live runtime handles maintained by the plugin. */
-    runtimeHandles: Map<string, RuntimeHandle>;
-    /** Logger instance — unexpected errors logged at `error` level. */
-    logger: Logger;
-}
-/**
- * Result returned by {@link auditHandler}.
- *
- * Discriminated on `ok`:
- * - `true`  → audit query succeeded; `address`, `strategyId`, and `result` are present.
- * - `false` → failure; `code` is one of `NOT_FOUND | UPSTREAM | ABORTED`.
- *
- * `NOT_FOUND`  — no running runtime for the given address, or `listStrategies`
- *                returned 0 matches (wallet not owned by the API-key user).
- * `UPSTREAM`   — MCP returned an error (network, auth, schema mismatch, runtime
- *                not started).
- * `ABORTED`    — caller cancelled via `AbortSignal` before MCP responded.
- */
-export type AuditHandlerResult = {
-    ok: true;
-    /** Lowercased wallet address. */
-    address: string;
-    /**
-     * Strategy UUID resolved from the wallet by `listStrategies`.
-     * May be `null` on the first successful call in the unlikely window
-     * between `auditQuery` resolving and `getStrategyId()` being read —
-     * in practice the cache is populated synchronously before the
-     * Promise resolves.
-     */
-    strategyId: string | null;
-    /** Pass-through `audit_query` response payload. */
-    result: AuditQueryResult;
-} | {
-    ok: false;
-    code: "NOT_FOUND" | "UPSTREAM" | "ABORTED";
-    message: string;
-};
-/**
- * Execute an audit query for one wallet via its runtime handle.
- *
- * Steps:
- * 1. Resolve the runtime handle by `address` (case-insensitive lookup).
- *    Returns `NOT_FOUND` on miss.
- * 2. Call `handle.auditQuery(args, { signal })`.
- * 3. Read `handle.getStrategyId()` after a successful call — the id is cached
- *    on the runtime instance from step 2's `listStrategies` resolution.
- * 4. On `AuditQueryError`: map `code` straight through to the result.
- * 5. On any other throw: log + return `UPSTREAM`.
- *
- * @param address  Wallet address to audit (normalised to lowercase internally).
- * @param args     Audit query filters forwarded to `RuntimeHandle.auditQuery`.
- * @param deps     Injected dependencies.
- * @param signal   Optional `AbortSignal` tied to the Fastify request lifetime.
- *                 Threads through to the underlying MCP call so the runtime
- *                 can cancel in-flight work when the HTTP client disconnects.
- * @returns        A resolved `AuditHandlerResult` — never rejects.
- */
-export declare function auditHandler(address: string, args: AuditQueryArgs, deps: AuditDeps, signal?: AbortSignal): Promise<AuditHandlerResult>;
-//# sourceMappingURL=audit.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/handlers/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EACjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,EAAE,EAAE,IAAI,CAAC;IACT,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,CAAC;CAC1B,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAsC7B"}

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

@@ -1,63 +0,0 @@
-/**
- * Shared audit handler for `GET /audit`.
- *
- * Delegates to `RuntimeHandle.auditQuery` and translates `AuditQueryError`
- * codes into the HTTP-layer result shape. Called by the Fastify route (S4).
- *
- * Note: this handler uses `ok` (not `success`) because it is a single-resource
- * response, not a per-item fan-out array. Keep `ok` and `success` distinct —
- * the `POST /signals` shape uses `success` (Section 5 plan).
- */
-import { findRuntimeHandleByAddress } from "./lookup.js";
-import { AuditQueryError } from "../../runtime/audit-query.types.js";
-/**
- * Execute an audit query for one wallet via its runtime handle.
- *
- * Steps:
- * 1. Resolve the runtime handle by `address` (case-insensitive lookup).
- *    Returns `NOT_FOUND` on miss.
- * 2. Call `handle.auditQuery(args, { signal })`.
- * 3. Read `handle.getStrategyId()` after a successful call — the id is cached
- *    on the runtime instance from step 2's `listStrategies` resolution.
- * 4. On `AuditQueryError`: map `code` straight through to the result.
- * 5. On any other throw: log + return `UPSTREAM`.
- *
- * @param address  Wallet address to audit (normalised to lowercase internally).
- * @param args     Audit query filters forwarded to `RuntimeHandle.auditQuery`.
- * @param deps     Injected dependencies.
- * @param signal   Optional `AbortSignal` tied to the Fastify request lifetime.
- *                 Threads through to the underlying MCP call so the runtime
- *                 can cancel in-flight work when the HTTP client disconnects.
- * @returns        A resolved `AuditHandlerResult` — never rejects.
- */
-export async function auditHandler(address, args, deps, signal) {
-    const normalizedAddress = address.toLowerCase();
-    const lookup = findRuntimeHandleByAddress(deps.runtimeHandles, normalizedAddress);
-    if (!lookup.found) {
-        return { ok: false, code: "NOT_FOUND", message: lookup.message };
-    }
-    const { handle } = lookup;
-    try {
-        const result = await handle.auditQuery(args, { signal });
-        // getStrategyId() is synchronous — the cache is populated by auditQuery
-        // before the awaited Promise resolves, so this is always set on success.
-        const strategyId = handle.getStrategyId();
-        return {
-            ok: true,
-            address: normalizedAddress,
-            strategyId,
-            result,
-        };
-    }
-    catch (err) {
-        if (err instanceof AuditQueryError) {
-            return { ok: false, code: err.code, message: err.message };
-        }
-        const message = err instanceof Error
-            ? err.message
-            : `Unexpected audit error: ${String(err)}`;
-        deps.logger.error("[senpi-core][runtime-api][audit] Unexpected error during audit query", { address: normalizedAddress, err });
-        return { ok: false, code: "UPSTREAM", message };
-    }
-}
-//# sourceMappingURL=audit.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../src/runtime-api/handlers/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAqDrE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAe,EACf,IAAoB,EACpB,IAAe,EACf,MAAoB;IAEpB,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEhD,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAClF,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAEzD,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAE1C,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,iBAAiB;YAC1B,UAAU;YACV,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,OAAO,GACX,GAAG,YAAY,KAAK;YAClB,CAAC,CAAC,GAAG,CAAC,OAAO;YACb,CAAC,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,sEAAsE,EACtE,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,CACpC,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/runtime-api/handlers/group-by-scanner.d.ts

@@ -1,43 +0,0 @@
-/**
- * Pure helper that groups a flat `SignalItem[]` by `(address, scanner)` so
- * the route handler can fan-out groups in parallel while keeping items within
- * a group sequential — dodging the per-(address, scanner) ingest lock held by
- * `ScannerEngine` during async ingest
- * (`src/scanners/engine/engine.ts:282-287`).
- */
-import type { SignalItem } from "./types.js";
-/**
- * A `SignalItem` paired with its original zero-based index in the input array.
- * The index is used to re-flatten grouped results back into the caller's
- * requested order after `Promise.all` group settlement.
- */
-export interface IndexedSignalItem {
-    /** Zero-based position in the original input array. */
-    index: number;
-    /** The original signal item. */
-    item: SignalItem;
-}
-/**
- * A sequence of items that share the same `(lowercased address, scanner)` key
- * and must be processed sequentially to avoid the per-(address, scanner) lock.
- */
-export type SignalGroup = IndexedSignalItem[];
-/**
- * Group signal items by `(lowercased address, scanner)`.
- *
- * Items within a group must be processed sequentially — the runtime's scanner
- * engine holds a per-(address, scanner) mutex during the full async ingest
- * chain and throws `UNAVAILABLE` on concurrent calls for the same key.
- *
- * Groups with different keys (different address or different scanner) can be
- * processed in parallel — they do not share the lock.
- *
- * Each item carries its original index so the route handler can sort results
- * back to input order after `Promise.all` resolves.
- *
- * @param items  Flat array of signal items as received in the request body.
- * @returns      Array of groups; order of groups is not guaranteed, but item
- *               order within each group is preserved.
- */
-export declare function groupByAddressScanner(items: SignalItem[]): SignalGroup[];
-//# sourceMappingURL=group-by-scanner.d.ts.map

package/dist/runtime-api/handlers/group-by-scanner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"group-by-scanner.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/handlers/group-by-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAkBxE"}

package/dist/runtime-api/handlers/group-by-scanner.js

@@ -1,43 +0,0 @@
-/**
- * Pure helper that groups a flat `SignalItem[]` by `(address, scanner)` so
- * the route handler can fan-out groups in parallel while keeping items within
- * a group sequential — dodging the per-(address, scanner) ingest lock held by
- * `ScannerEngine` during async ingest
- * (`src/scanners/engine/engine.ts:282-287`).
- */
-/**
- * Group signal items by `(lowercased address, scanner)`.
- *
- * Items within a group must be processed sequentially — the runtime's scanner
- * engine holds a per-(address, scanner) mutex during the full async ingest
- * chain and throws `UNAVAILABLE` on concurrent calls for the same key.
- *
- * Groups with different keys (different address or different scanner) can be
- * processed in parallel — they do not share the lock.
- *
- * Each item carries its original index so the route handler can sort results
- * back to input order after `Promise.all` resolves.
- *
- * @param items  Flat array of signal items as received in the request body.
- * @returns      Array of groups; order of groups is not guaranteed, but item
- *               order within each group is preserved.
- */
-export function groupByAddressScanner(items) {
-    const grouped = new Map();
-    for (let index = 0; index < items.length; index++) {
-        const item = items[index];
-        // item is always defined inside bounds; the cast avoids a superfluous
-        // non-null assertion in strict mode.
-        const safeItem = item;
-        const key = `${safeItem.address.toLowerCase()}::${safeItem.scanner}`;
-        const existing = grouped.get(key);
-        if (existing !== undefined) {
-            existing.push({ index, item: safeItem });
-        }
-        else {
-            grouped.set(key, [{ index, item: safeItem }]);
-        }
-    }
-    return Array.from(grouped.values());
-}
-//# sourceMappingURL=group-by-scanner.js.map

package/dist/runtime-api/handlers/group-by-scanner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"group-by-scanner.js","sourceRoot":"","sources":["../../../src/runtime-api/handlers/group-by-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAmB;IACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,sEAAsE;QACtE,qCAAqC;QACrC,MAAM,QAAQ,GAAG,IAAkB,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrE,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC"}

package/dist/runtime-api/handlers/ingest-signals.d.ts

@@ -1,54 +0,0 @@
-/**
- * Shared ingest handler for `POST /signals`.
- *
- * Called by the HTTP route (S4) and the gateway-method shim (S6). Contains
- * all business logic for one ingest item — lookup, validation, execution, and
- * error translation — so neither transport duplicates logic.
- */
-import type { SignalItem, SignalResult } from "./types.js";
-import type { RuntimeHandle } from "../../runtime/run.js";
-import type { Logger } from "../../utils/logger.js";
-/**
- * Dependencies injected into {@link ingestSignalsHandler}.
- *
- * Keeping deps explicit (rather than closing over module-level state) makes
- * unit-testing straightforward and keeps the function pure with respect to
- * side effects outside the deps object.
- */
-export interface IngestSignalsDeps {
-    /** Live runtime handles maintained by the plugin. */
-    runtimeHandles: Map<string, RuntimeHandle>;
-    /** Logger instance — errors logged at `error`, unexpected throws at `error`. */
-    logger: Logger;
-    /**
-     * Transport tag forwarded to future tracking events so the telemetry
-     * pipeline can distinguish HTTP-originated ingests from gateway-shim
-     * ingests on the migration dashboard.
-     */
-    transport: "http" | "gateway";
-}
-/**
- * Ingest one signal item.
- *
- * Looks up the runtime by address, validates handler-level constraints, calls
- * `RuntimeHandle.ingestExternalScannerData`, and translates all error shapes
- * into the uniform `{ success: false, code, message }` discriminant. Never
- * throws — all error paths return a `SignalResult`.
- *
- * Validation rules (beyond TypeBox):
- * - At least one of `asset`, `data`, or `signals` must be present; an item
- *   with none of those fields has nothing to ingest → `INVALID_REQUEST`.
- * - `data` and `signals` are mutually exclusive → `INVALID_REQUEST`.
- *   (The runtime also enforces this, but we check early to surface a clear
- *   message before the engine lock is acquired.)
- *
- * Per-(address, scanner) ingest lock is the engine's concern; callers should
- * use {@link groupByAddressScanner} or nest multiple signals in `signals[]`
- * rather than submitting concurrent top-level items for the same key.
- *
- * @param item  A single element from the `POST /signals` request body.
- * @param deps  Injected dependencies.
- * @returns     A resolved `SignalResult` — never rejects.
- */
-export declare function ingestSignalsHandler(item: SignalItem, deps: IngestSignalsDeps): Promise<SignalResult>;
-//# sourceMappingURL=ingest-signals.d.ts.map

package/dist/runtime-api/handlers/ingest-signals.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-signals.d.ts","sourceRoot":"","sources":["../../../src/runtime-api/handlers/ingest-signals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,CAAC,CAiIvB"}