@eaera-com/cms-sdk 0.1.61

package/dist/services/rules/index.d.ts

@@ -0,0 +1,49 @@
+import { $Fetch } from 'ofetch';
+import { ContentRule, ContentRuleListResponse, RuleCreatePayload, RuleListQuery, RuleUpdatePayload, SignalFireContext, SignalFireResponse } from './rules.type';
+export interface IRulesServiceOptions {
+    /** The CMS `$Fetch` instance (one of `sdk.apis`). */
+    api: $Fetch;
+    /** Lazy flag — when true, the service returns fake data. */
+    mock: () => boolean;
+}
+export interface IRulesService {
+    list(query?: RuleListQuery): Promise<ContentRuleListResponse>;
+    detail(uuid: string): Promise<ContentRule>;
+    create(payload: RuleCreatePayload): Promise<ContentRule>;
+    update(uuid: string, payload: RuleUpdatePayload): Promise<ContentRule>;
+    remove(uuid: string): Promise<void>;
+    /**
+     * Manually fire a signal rule (`POST /api/v1/rules/signals/fire`). Runs
+     * synchronously in the API pod — the canonical way to verify an action
+     * handler works without scheduling cron (cron + action is currently broken
+     * backend-side; see `risk-rules-api-guide.md` §8.F).
+     *
+     * Pass `options.timeoutMs` to override the SDK-wide 30s HTTP timeout
+     * (the API pod runs the rule synchronously and a multi-step action chain
+     * can exceed 30s on real traffic — the dashboard's "Fire now" dialog
+     * raises the ceiling to 120s by default).
+     */
+    signalFire(signalName: string, context: SignalFireContext, options?: {
+        timeoutMs?: number;
+    }): Promise<SignalFireResponse>;
+}
+/**
+ * Content-rules service. CRUD over `/api/v1/rules`. Serves both FEAT-002
+ * (`conditionType: 'llm_agent'` skills) and FEAT-004 (expression/chain).
+ *
+ * Endpoint contract (`eaera_cms/core/rules/routes.py`):
+ *   GET    /api/v1/rules          → list (no pagination; `total === items.length`)
+ *   GET    /api/v1/rules/{uuid}   → single rule
+ *   POST   /api/v1/rules          → create (flat payload)
+ *   PUT    /api/v1/rules/{uuid}   → update
+ *   DELETE /api/v1/rules/{uuid}   → remove
+ *   POST   /api/v1/rules/signals/fire → fire a signal rule synchronously
+ *
+ * The route accepts the flat `RuleCreatePayload` (`TriggerCreateRequest`,
+ * `extra: allow`) and the service reads flat top-level keys. See rules.type.ts.
+ *
+ * While `mock()` returns true, all methods resolve against the local fake
+ * dataset and never touch `api`.
+ */
+export declare function createRulesService(opts: IRulesServiceOptions): IRulesService;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAUrC,OAAO,KAAK,EACV,WAAW,EACX,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC;;;;;;;;;;OAUG;IACH,UAAU,CACR,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CA4C5E"}

package/dist/services/rules/llm-rule.constant.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Constants for `conditionType: 'llm_agent'` rule configuration.
+ *
+ * The `llm_agent` rule is composed of two parts:
+ *  - **Prompt** — the user-facing Skill entity (`/api/v1/llm/prompts`).
+ *    Owned by the Skills page. The rule references it via
+ *    `trigger.sourceConfig.promptName`.
+ *  - **Rule** — the `ContentRule` (owned by the Fixed Rules editor).
+ *    Carries trigger mode, read-only MCP `queryTools` allowlist,
+ *    `executionParams.llmEval` knobs (`maxIterations` / `budgetUsd`),
+ *    and the `executionType`/`executionParams` shape (single action or
+ *    action chain — same shape the fixed-rule builder emits).
+ *
+ * Reference: `risk-rules-api-guide.md` §7.B (LLM evaluator behaviour),
+ * §7.B Sample 7B.5 (canonical llm_agent payload), §8.B (rule editor knobs).
+ */
+/** The full read-only MCP tool set the evaluator accepts. The dashboard
+ *  only ever offers these — the engine rejects anything else with
+ *  `tool '…' is not available (read-only)`. */
+export declare const LLM_QUERY_TOOL: {
+    readonly CONTENT_QUERY: "content_query";
+    readonly CONTENT_GET: "content_get";
+    readonly EXECUTE_REPORT: "execute_report";
+    readonly GET_SCHEMA: "get_schema";
+    readonly LIST_CTS: "list_cts";
+    readonly CH_QUERY: "ch_query";
+};
+/** Read-only MCP tool union — derived from {@link LLM_QUERY_TOOL}. */
+export type LlmQueryTool = (typeof LLM_QUERY_TOOL)[keyof typeof LLM_QUERY_TOOL];
+/** Human-labelled option for the queryTools multi-select. */
+export interface LlmQueryToolOption {
+    label: string;
+    value: LlmQueryTool;
+    /** Short hint shown under the label — explains what the tool does. */
+    hint: string;
+}
+/** All {@link LlmQueryTool} options in the canonical order. */
+export declare const LLM_QUERY_TOOL_OPTIONS: readonly LlmQueryToolOption[];
+/** The minimum allowlist the engine recommends for scan-mode rules. */
+export declare const DEFAULT_LLM_QUERY_TOOLS: readonly LlmQueryTool[];
+/** Per-rule LLM-eval knobs. Bounds are enforced by
+ *  `eaera_cms/core/rules/llm_evaluator.py`: `maxIterations` defaults to 5
+ *  and is hard-capped at 20; `budgetUsd` defaults to 1.0 and is enforced
+ *  before every LLM call; `maxTokens` caps the per-completion token output
+ *  (no temperature — the backend does not accept it). */
+export declare const LLM_EVAL_BOUNDS: {
+    readonly maxIterations: {
+        readonly min: 1;
+        readonly default: 5;
+        readonly max: 20;
+    };
+    readonly budgetUsd: {
+        readonly min: 0;
+        readonly default: 1;
+    };
+    readonly maxTokens: {
+        readonly min: 1;
+        readonly default: 1024;
+        readonly max: 32000;
+    };
+};
+/** Shape of `executionParams.llmEval` — the engine reads both fields at
+ *  `LLMConditionEvaluator.run_iteration()` time. */
+export interface LlmEval {
+    maxIterations: number;
+    budgetUsd: number;
+    /** Max tokens per completion. */
+    maxTokens?: number;
+}
+/** Read `executionParams.llmEval` from a stored rule, with defaults. */
+export declare const llmEvalOf: (executionParams: Record<string, unknown> | null | undefined) => LlmEval;
+/** Read `trigger.sourceConfig.queryTools` from a stored trigger.
+ *
+ *  ⚠️ **Advisory only.** The dashboard persists the per-rule allowlist
+ *  here, but `LLMConditionEvaluator` (`eaera-cms/core/rules/llm_evaluator.py`)
+ *  uses its own hardcoded `_readonly_tool_names()` set today — the per-rule
+ *  value is NOT yet honoured by the engine. The UI shows the checkbox grid
+ *  and persists the choice so it's ready for the day the backend wires it
+ *  through; until then, restricting this list has no runtime effect on the
+ *  agent. Do not promise the user otherwise in the UI copy. */
+export declare const queryToolsOf: (trigger: Record<string, unknown> | null | undefined) => LlmQueryTool[];
+/** Read `trigger.sourceConfig.promptName` from a stored trigger. */
+export declare const promptNameOf: (trigger: Record<string, unknown> | null | undefined) => string;
+//# sourceMappingURL=llm-rule.constant.d.ts.map

package/dist/services/rules/llm-rule.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-rule.constant.d.ts","sourceRoot":"","sources":["../../../src/services/rules/llm-rule.constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;+CAE+C;AAC/C,eAAO,MAAM,cAAc;;;;;;;CAOjB,CAAC;AAEX,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEhF,6DAA6D;AAC7D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;IACpB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EA+B/D,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,uBAAuB,EAAE,SAAS,YAAY,EAG1D,CAAC;AAEF;;;;yDAIyD;AACzD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAIlB,CAAC;AAEX;oDACoD;AACpD,MAAM,WAAW,OAAO;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wEAAwE;AACxE,eAAO,MAAM,SAAS,GAAI,iBAAiB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,OAYvF,CAAC;AAEF;;;;;;;;+DAQ+D;AAC/D,eAAO,MAAM,YAAY,GACvB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAClD,YAAY,EAOd,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,MAIlF,CAAC"}

package/dist/services/rules/mock.d.ts

@@ -0,0 +1,20 @@
+import { ContentRule, RuleCreatePayload, RuleListQuery } from './rules.type';
+/**
+ * Fake rules dataset used while the CMS rules endpoints are under
+ * development. Covers both FEAT-002 (`llmAgent`) and FEAT-004
+ * (expression/chain) rule shapes.
+ *
+ * Field names use camelCase to match the backend API response. Action
+ * parameters are nested under `params` and `conditionExpr` references the
+ * real condition-field catalog (`account_state.*` / `account_metric_by_deal.*`).
+ */
+export declare const MOCK_RULES: ContentRule[];
+export declare function mockRuleList(query?: RuleListQuery): {
+    items: ContentRule[];
+    total: number;
+};
+export declare function mockRuleDetail(uuid: string): ContentRule | undefined;
+export declare function mockRuleCreate(payload: RuleCreatePayload): ContentRule;
+export declare function mockRuleUpdate(uuid: string, patch: Partial<RuleCreatePayload>): ContentRule | undefined;
+export declare function mockRuleRemove(uuid: string): boolean;
+//# sourceMappingURL=mock.d.ts.map

package/dist/services/rules/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/services/rules/mock.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElF;;;;;;;;GAQG;AAEH,eAAO,MAAM,UAAU,EAAE,WAAW,EAuHnC,CAAC;AAOF,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG;IACnD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAUA;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAuBtE;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAChC,WAAW,GAAG,SAAS,CAkBzB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD"}

package/dist/services/rules/rules.type.d.ts

@@ -0,0 +1,262 @@
+import { SerializationFormat } from '../../common/constants/http.constant';
+import { TriggerTypeValue } from './triggers';
+export type TriggerType = TriggerTypeValue;
+/**
+ * Wire-level `trigger_type` union (schema-validated by
+ * `eaera_cms/core/rules/definitions.py:33-39`).
+ *
+ * Note this is **different** from the `source_type` value the engine matcher
+ * reads (`event_dto | cron | batch | stream | signal`). The canonical
+ * pair for event rules is `trigger_type: "event"` +
+ * `source_type: "event_dto"` — see `packs/registry.py:463-470` and the
+ * SDK `TRIGGER_TYPE` / `TRIGGER_MODE` constants in `triggers.ts`.
+ *
+ * Aliased to `TriggerType` via the `index.ts` barrel for backwards
+ * compatibility with consumers that imported it from this module.
+ */
+/**
+ * One row in `trigger.conditions[]` — the flat AND list the engine evaluates
+ * when `conditionType` is `'trigger_conds'` or omitted. The dashboard's visual
+ * tree builder (`LogicTree.vue`) emits these; backend-authored packs (`*.yaml`)
+ * emit them too. `field` is either a CH catalog key (`account_state.equity`),
+ * a dotted event-payload path (`deal.profit`), or a flat event field
+ * (`profit` — engine fallback).
+ *
+ * `operator` is one of the word forms exposed by the SDK
+ * (`CONDITION_OPERATORS`: `gt`/`gte`/`lt`/`lte`/`eq`/`ne`/`in`/`not_in`/
+ * `contains`/`startswith`/`endswith`/`is_null`/`is_not_null`) plus the
+ * cron-specific `sum_within_days` (carries a numeric `days` window).
+ *
+ * `value` shape depends on the operator — see
+ * `cms-sdk/src/services/rules/conditions.ts:CONDITION_OPERATOR_VALUE_KINDS`:
+ *   - numeric operators → number
+ *   - `in` / `not_in`   → array of primitives
+ *   - string operators  → string (entity is coerced via `str()`)
+ *   - `is_null` / `is_not_null` → ignored (send `null`)
+ *   - `sum_within_days` → number (threshold), `days` is the window
+ */
+export interface TriggerConditionRow {
+    field: string;
+    operator: string;
+    value: unknown;
+    /** Cron-only: window size for `sum_within_days`. */
+    days?: number;
+}
+export interface TriggerDefinition {
+    /**
+     * The backend SQL filter (`trigger_api.py:fire_signal`) and engine matcher
+     * (`engine.py:_match_trigger`) read `trigger.source_type`, NOT
+     * `trigger.trigger_type`. Builders in `triggers.ts` emit BOTH
+     * `sourceType` and `triggerType` (camelCase) so the CMS casing middleware
+     * produces both keys in the stored JSONB.
+     *
+     * IMPORTANT: for event rules the two values DIVERGE — see the canonical
+     * contract documented on `TRIGGER_MODE` / `TRIGGER_TYPE` in
+     * `cms-sdk/src/services/rules/triggers.ts`. `sourceType: 'event_dto'`
+     * (engine matcher), `triggerType: 'event'` (schema validator). Earlier
+     * SDK builds emitted both as `'event_dto'`, which drifted from the
+     * pack-authored contract.
+     */
+    sourceType?: 'event_dto' | 'cron' | 'batch' | 'stream' | 'signal';
+    triggerType: TriggerType;
+    topic?: string;
+    /**
+     * Top-level AND condition list. Backend reads this when
+     * `conditionType` is `'trigger_conds'` (or omitted). Dashboard tree
+     * builder emits here; the Fixed Rules editor's `trigger_conds` path
+     * goes through here too.
+     */
+    conditions?: TriggerConditionRow[];
+    /**
+     * Type-specific trigger config ONLY — e.g. `signalName`, `topic`, `schedule`,
+     * `timezone`, `streamName`, `windowSeconds`, `contentTypes`, `eventTypes`,
+     * `promptName` (LLM rules), `queryTools` (LLM rules).
+     *
+     * There is **no `scope` concept** on a rule. A rule is scoped by `contentType`
+     * + trigger-source matching + the `conditionExpr`; do not write a `scope`
+     * (`groups`/`symbols`/`logins`/`emails`) key here — the backend ignores it.
+     */
+    sourceConfig: Record<string, unknown>;
+}
+/** Value-level constants for ConditionType — single source of truth. */
+export declare const CONDITION_TYPE: {
+    readonly EXPRESSION: "expression";
+    readonly CODE: "code";
+    readonly LLM_AGENT: "llm_agent";
+    readonly TRIGGER_CONDS: "trigger_conds";
+};
+/** Condition type — derived from {@link CONDITION_TYPE}. */
+export type ConditionType = (typeof CONDITION_TYPE)[keyof typeof CONDITION_TYPE];
+/** Value-level constants for ExecutionType — single source of truth. */
+export declare const EXECUTION_TYPE: {
+    readonly ACTION: "action";
+    readonly SET_FIELD: "set_field";
+    readonly NOTIFY: "notify";
+    readonly TRANSITION: "transition";
+    readonly HTTP_CALL: "http_call";
+    readonly CHAIN: "chain";
+};
+/** Execution type — derived from {@link EXECUTION_TYPE}. */
+export type ExecutionType = (typeof EXECUTION_TYPE)[keyof typeof EXECUTION_TYPE];
+/**
+ * One action invocation. The dispatcher reads `actionName` and a **nested**
+ * `params`; e.g. a group move is `{ actionName: 'change_group', params: { newGroup } }`
+ * and a leverage change is `{ actionName: 'change_leverage', params: { newLeverage } }`.
+ */
+export interface ActionExecutionParams {
+    actionName: string;
+    /** Action-specific payload (`{ newGroup }` / `{ newLeverage }`). */
+    params: Record<string, unknown>;
+}
+/**
+ * One step in an ordered action chain. Each step dispatches via its own
+ * `type` (any `ExecutionType` except `chain`); an `action` step uses
+ * {@link ActionExecutionParams} as its `params`.
+ */
+export interface ChainStep {
+    type: Exclude<ExecutionType, typeof EXECUTION_TYPE.CHAIN>;
+    params: Record<string, unknown>;
+}
+/**
+ * Flat execution params stored on `ContentRule.executionParams`. The backend
+ * dispatcher (`dispatch_target`) selects behaviour by `executionType`:
+ *
+ * - `action`    → `{ actionName, params }`
+ * - `set_field` → `{ field, value }`
+ * - `notify`    → `{ data?, notificationType?, recipient? }`
+ * - `transition`→ `{ transitionName, params }`
+ * - `http_call` → `{ url, method?, params?, headers?, timeout? }`
+ * - `chain`     → `{ steps: ChainStep[], stepParams?: Record<string, Record<string, unknown>> }`
+ *
+ * Action parameters are **nested** under `params` — `{ actionName, newGroup }`
+ * (flat) is silently dropped. See {@link ActionExecutionParams}.
+ */
+export interface ExecutionParams {
+    actionName?: string;
+    params?: Record<string, unknown>;
+    field?: string;
+    value?: unknown;
+    data?: Record<string, unknown>;
+    notificationType?: string;
+    recipient?: string;
+    transitionName?: string;
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    timeout?: number;
+    steps?: ChainStep[];
+    stepParams?: Record<string, Record<string, unknown>>;
+    [key: string]: unknown;
+}
+/** POST /api/v1/rules body (flat — matches `create_trigger()`). */
+export interface RuleCreatePayload {
+    name: string;
+    description?: string;
+    /** `null`/omitted = global rule. Backend reads `contentType`, not `typeName`. */
+    contentType?: string | null;
+    trigger: TriggerDefinition;
+    /** Default `'expression'`. */
+    conditionType?: ConditionType;
+    /** Inline Python expression (conditionType=expression). */
+    conditionExpr?: string | null;
+    /** Full Python code block (conditionType=code). */
+    conditionCode?: string | null;
+    /** Default `'action'`. */
+    executionType?: ExecutionType;
+    executionParams?: ExecutionParams | null;
+    cronSchedule?: string | null;
+    cronTimeZone?: string | null;
+    /** Default `0`. */
+    priority?: number;
+    /** Default `true`. */
+    isActive?: boolean;
+    /** 1-3600, default 30. */
+    timeoutSeconds?: number;
+}
+/** PUT /api/v1/rules/{uuid} body (all optional, same flat keys). */
+export interface RuleUpdatePayload {
+    name?: string;
+    description?: string;
+    contentType?: string | null;
+    trigger?: TriggerDefinition;
+    conditionType?: ConditionType;
+    conditionExpr?: string | null;
+    conditionCode?: string | null;
+    executionType?: ExecutionType;
+    executionParams?: ExecutionParams | null;
+    priority?: number;
+    isActive?: boolean;
+    timeoutSeconds?: number;
+}
+/** GET /api/v1/rules, GET /api/v1/rules/{uuid} (`ContentRuleResponse`). */
+export interface ContentRule {
+    id: number;
+    uuid: string;
+    name: string;
+    description?: string | null;
+    /** Echoes `contentType` on the response. */
+    typeName?: string | null;
+    /** Default `'python'`. */
+    codeType: string;
+    /** AES-256-GCM encrypted. */
+    conditionCode?: string | null;
+    conditionType?: ConditionType;
+    conditionExpr?: string | null;
+    /** Inline trigger JSONB (`{ sourceType, sourceConfig, conditions, settings }`). */
+    trigger: Record<string, unknown>;
+    executionType: ExecutionType;
+    executionParams?: Record<string, unknown> | null;
+    priority: number;
+    isActive: boolean;
+    timeoutSeconds: number;
+    /** Cron: top-level normalized schedule. Dashboard emits via
+     *  `trigger.sourceConfig.schedule`; the backend reads both. */
+    cronSchedule?: string | null;
+    cronTimezone?: string | null;
+    /** ISO 8601. */
+    nextTriggerAt?: string | null;
+    /** ISO 8601 — FEAT-004 sidebar "last triggered". */
+    lastFiredAt?: string | null;
+    packId?: string | null;
+    createdBy?: number | null;
+    updatedBy?: number | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface ContentRuleListResponse {
+    items: ContentRule[];
+    /** `=== items.length` — the list endpoint does NOT paginate. */
+    total: number;
+}
+/**
+ * Signal-fire context (`POST /api/v1/rules/signals/fire`). Carries the target
+ * account + any extra payload the engine/condition evaluator reads. A `null`
+ * `contentUuid` means scan-mode (the LLM discovers candidates itself).
+ */
+export interface SignalFireContext {
+    /** Content type of the target (e.g. `'Mt5Account'`). */
+    typeName?: string;
+    /** Target account UUID, or `null` for scan-mode `llm_agent` rules. */
+    contentUuid?: string | null;
+    /** Extra payload (e.g. `{ serverName, login }`). */
+    data?: Record<string, unknown>;
+}
+/** `POST /api/v1/rules/signals/fire` response. */
+export interface SignalFireResponse {
+    /** Number of rules that matched and were dispatched. */
+    triggeredCount: number;
+    /** UUIDs of the matched rules. */
+    matchedRules: string[];
+}
+/** Query params for GET /api/v1/rules (route-level Query() params; no limit/offset). */
+export interface RuleListQuery {
+    sourceType?: string;
+    executionType?: ExecutionType;
+    /** contentType filter. */
+    typeName?: string;
+    isActive?: boolean;
+    /** UUID or slug (FEAT-008 v1.1). */
+    packId?: string;
+    format?: SerializationFormat;
+}
+//# sourceMappingURL=rules.type.d.ts.map

package/dist/services/rules/rules.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.type.d.ts","sourceRoot":"","sources":["../../../src/services/rules/rules.type.ts"],"names":[],"mappings":"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"}

package/dist/services/rules/triggers.d.ts

@@ -0,0 +1,140 @@
+import { TriggerDefinition, TriggerType } from './rules.type';
+/** Value-level constants for trigger modes (the *builder* view used by the
+ *  dashboard UI). Each entry's string is the *backend* `source_type` value
+ *  read off `ContentRule.trigger` by `engine.py:_match_trigger` and the SQL
+ *  filter at `trigger_api.py:fire_signal`:
+ *
+ *  - `SIGNAL` → `"signal"` (API pod, `POST /api/v1/rules/signals/fire`).
+ *  - `CRON`   → `"cron"`   (cron evaluator pod).
+ *  - `EVENT`  → `"event_dto"` (NOT `"event"` — the engine matcher reads
+ *    `source_type` as `"event_dto"`).
+ *
+ *  Use {@link TRIGGER_TYPE} for the wire-level `trigger_type` value (which
+ *  uses `"event"`, not `"event_dto"`). */
+export declare const TRIGGER_MODE: {
+    readonly SIGNAL: "signal";
+    readonly CRON: "cron";
+    readonly EVENT: "event_dto";
+};
+/** The trigger modes the dashboard builders author — derived from {@link TRIGGER_MODE}. */
+export type TriggerMode = (typeof TRIGGER_MODE)[keyof typeof TRIGGER_MODE];
+/** Value-level constants for the *wire-level* `trigger_type` field (the
+ *  schema-validated field on `TriggerDefinition`,
+ *  `eaera_cms/core/rules/definitions.py:33-39`).
+ *
+ *  For event rules the wire value is `"event"`, NOT `"event_dto"` — the
+ *  latter is the `source_type` value. The two diverge on purpose; the
+ *  pack loader emits `trigger_type: "event"` + `source_type: "event_dto"`
+ *  (`packs/registry.py:463-470`).
+ *
+ *  - `SIGNAL` → `"signal"`
+ *  - `CRON`   → `"cron"`
+ *  - `EVENT`  → `"event"`
+ *  - `STREAM` → `"stream"` (backend-only — no SDK builder). */
+export declare const TRIGGER_TYPE: {
+    readonly SIGNAL: "signal";
+    readonly CRON: "cron";
+    readonly EVENT: "event";
+    readonly STREAM: "stream";
+};
+/** The wire-level `trigger_type` union — derived from {@link TRIGGER_TYPE}. */
+export type TriggerTypeValue = (typeof TRIGGER_TYPE)[keyof typeof TRIGGER_TYPE];
+/** The Kafka `content.events` event types the trigger pod subscribes to.
+ *
+ *  Authoritative list — `eaera-mt5/eaera_mt5/pipeline/event_publisher.py` (the
+ *  four MT5 pipeline publishers) and `eaera-mt5/worker/sync/account_sync.py`
+ *  (`_emit_account_upsert_events`). The CMS schema validator does not whitelist
+ *  the value (any string is accepted), but the engine matcher and the
+ *  `Mt5AccountSyncService` only act on these five. */
+export declare const EVENT_TYPE: {
+    readonly DEAL_CLOSE: "deal_close";
+    readonly STATEMENT: "statement";
+    readonly POSITION: "position";
+    readonly ORDER: "order";
+    /** FEAT-009 identity-provisioning bridge — emitted by the MT5 `account_sync`
+     *  worker whenever an account is upserted. The trigger service ALSO
+     *  auto-upserts an `Mt5Account` content row on `(server_name, login)` via
+     *  `Mt5AccountSyncService` before evaluating rules. Common use: provision
+     *  a CMS user when the account email is present (the live `user_sync` rule
+     *  uses `event: 'mt5_account_upsert'` + `trigger.conditions: [email contains '@']`). */
+    readonly MT5_ACCOUNT_UPSERT: "mt5_account_upsert";
+};
+/** Event type union — derived from {@link EVENT_TYPE}. */
+export type EventType = (typeof EVENT_TYPE)[keyof typeof EVENT_TYPE];
+/** A labelled option for the event-payload picker. */
+export interface EventTypeOption {
+    label: string;
+    value: EventType;
+    /** Short human hint shown in tooltips / Data Set reference. */
+    hint?: string;
+}
+/** Human labels for the {@link EVENT_TYPE} options. */
+export declare const EVENT_TYPE_OPTIONS: readonly EventTypeOption[];
+/** Helper: true iff the given string is a known event type. */
+export declare const isKnownEventType: (raw: unknown) => raw is EventType;
+/** Coerce an arbitrary event-type string (e.g. from a stored `sourceConfig.event`)
+ *  to a known {@link EventType}. Falls back to {@link EVENT_TYPE.DEAL_CLOSE} for
+ *  unknown / missing values so the rule editor always has a valid pick. */
+export declare const coerceEventType: (raw: unknown) => EventType;
+/** A labelled cron preset for the schedule picker. */
+export interface CronPreset {
+    label: string;
+    value: string;
+}
+/** Human cron presets (standard 5-field expressions). */
+export declare const CRON_PRESETS: readonly CronPreset[];
+/** Default cron schedule when none is provided (skills' historical default). */
+export declare const DEFAULT_CRON_SCHEDULE = "*/5 * * * *";
+/** Default Kafka topic for event triggers. Sourced from `CONTENT_TYPE.MT5_ACCOUNT`. */
+export declare const DEFAULT_EVENT_CONTENT_TYPE: "Mt5Account";
+/** Build a signal trigger over the metric stream.
+ *
+ *  Emits the canonical pair:
+ *  - `triggerType: 'signal'` (schema-validated)
+ *  - `sourceType: 'signal'` (engine matcher)
+ *
+ *  Both are the same value for signal rules. */
+export declare const buildSignalTrigger: (signalName: string) => TriggerDefinition;
+/**
+ * Build a cron trigger. `schedule` is a standard 5-field cron expression;
+ * `extra` is merged into `sourceConfig` (e.g. skills pass `promptName` /
+ * `queryTools`).
+ *
+ *  Emits the canonical pair:
+ *  - `triggerType: 'cron'` (schema-validated)
+ *  - `sourceType: 'cron'` (engine matcher)
+ */
+export declare const buildCronTrigger: (schedule: string, extra?: Record<string, unknown>, timezone?: string) => TriggerDefinition;
+/**
+ * Build an event trigger on the Kafka `content.events` topic.
+ *
+ *  Emits the canonical pair — NOT the same value on both fields:
+ *  - `triggerType: 'event'` (schema-validated, `definitions.py:36`)
+ *  - `sourceType: 'event_dto'` (engine matcher, `engine.py:369`)
+ *
+ *  Earlier SDK builds emitted both as `"event_dto"`, which passed engine
+ *  matching but drifted from the canonical pack-authored contract
+ *  (`packs/registry.py:463-470`). This builder now emits the correct pair.
+ *
+ *  The `event` (singular) and `eventTypes`/`contentTypes` (plural) shapes
+ *  are both stored so the engine reads either form.
+ */
+export declare const buildEventTrigger: (event: EventType, contentType?: string, extra?: Record<string, unknown>) => TriggerDefinition;
+/** Derive the builder trigger mode from a stored `ContentRule.trigger`.
+ *
+ *  Accepts BOTH the camelCase fields the SDK writes (`sourceType`,
+ *  `triggerType`) and the snake_case JSONB keys the backend reads
+ *  (`source_type`, `trigger_type`) so rules authored before the trigger
+ *  wire-shape fix still load in the Fixed Rules editor without showing up
+ *  as the wrong mode.
+ *
+ *  Both `source_type === "event_dto"` (engine matcher) and `trigger_type
+ *  === "event"` (schema-validated) map to the builder's `EVENT` mode. */
+export declare const triggerModeOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => TriggerMode;
+/** Read the cron `schedule` out of a stored `ContentRule.trigger`. */
+export declare const scheduleOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => string;
+/** Read the signal `signalName` out of a stored `ContentRule.trigger`. */
+export declare const signalNameOf: (trigger: TriggerDefinition | Record<string, unknown> | null | undefined) => string;
+export type { TriggerType };
+export { TRIGGER_TYPE as TRIGGER_TYPE_VALUE };
+//# sourceMappingURL=triggers.d.ts.map

package/dist/services/rules/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../../src/services/rules/triggers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;;;;;;;;0CAW0C;AAC1C,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE3E;;;;;;;;;;;;+DAY+D;AAC/D,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAEhF;;;;;;sDAMsD;AACtD,eAAO,MAAM,UAAU;;;;;IAKrB;;;;;4FAKwF;;CAEhF,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAErE,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,eAAO,MAAM,kBAAkB,EAAE,SAAS,eAAe,EAUxD,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,KAAG,GAAG,IAAI,SAGtD,CAAC;AAEF;;2EAE2E;AAC3E,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,KAAG,SACM,CAAC;AAEtD,sDAAsD;AACtD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAO7C,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AAEnD,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,EAAG,YAAqB,CAAC;AAEhE;;;;;;gDAMgD;AAChD,eAAO,MAAM,kBAAkB,GAAI,YAAY,MAAM,KAAG,iBAItD,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,WAAW,MAAM,KAChB,iBAID,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,SAAS,EAChB,cAAa,MAAmC,EAChD,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KAClC,iBASD,CAAC;AAEH;;;;;;;;;yEASyE;AACzE,eAAO,MAAM,aAAa,GACxB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,WAoBF,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,UAAU,GACrB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,MAKF,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,YAAY,GACvB,SAAS,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,KACtE,MAKF,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,CAAC;AAC5B,OAAO,EAAE,YAAY,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/services/settings/index.d.ts

@@ -0,0 +1,36 @@
+import { $Fetch } from 'ofetch';
+import { IPublicMarketsData } from './settings.type';
+export interface ISettingsServiceOptions {
+    /** The CMS `$Fetch` instance (one of `sdk.apis`). */
+    api: $Fetch;
+    /** Lazy flag — when true, the service returns fake data. */
+    mock: () => boolean;
+}
+export interface ISettingsService {
+    getMonitoredGroups(): Promise<string[]>;
+    setMonitoredGroups(groups: string[]): Promise<string[]>;
+    /**
+     * Anonymous UI defaults from `setting.public.markets` (api-inventory §5.7.5):
+     * the default MT5 server id + the curated common-symbol list (order is
+     * significant). Readable without a JWT — the backend returns the schema
+     * defaults when no record has been written yet.
+     */
+    getPublicMarkets(): Promise<IPublicMarketsData>;
+}
+/**
+ * Settings service. The CMS is the source of truth for monitored groups;
+ * the service reads/writes the generic setting
+ * `setting.dashboard.monitored_groups`.
+ *
+ * Endpoint contract (`eaera_cms/settings/routes.py`):
+ *   GET /api/v1/settings/{typeName} → { typeName, displayName, data, exists }
+ *   PUT /api/v1/settings/{typeName} → { ..., data }  (body = key/value pairs)
+ *
+ * NOTE: the CT `setting.dashboard.monitored_groups` (schema `{ groups: string[] }`)
+ * must be registered in the CMS settings catalog for these calls to succeed.
+ *
+ * While `mock()` returns true, all methods resolve against the local fake
+ * dataset and never touch `api`.
+ */
+export declare function createSettingsService(opts: ISettingsServiceOptions): ISettingsService;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAOrC,OAAO,KAAK,EAGV,kBAAkB,EAEnB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,IAAI,EAAE,MAAM,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD;;;;;OAKG;IACH,gBAAgB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,uBAAuB,GAAG,gBAAgB,CA+BrF"}

package/dist/services/settings/mock.d.ts

@@ -0,0 +1,14 @@
+/** Fake monitored-groups set used while the settings endpoint is under development. */
+export declare const MOCK_MONITORED_GROUPS: string[];
+export declare function mockGetMonitoredGroups(): string[];
+export declare function mockSetMonitoredGroups(groups: string[]): string[];
+/** Fake public-markets payload (mirrors the schema defaults in api-inventory §5.7.5). */
+export declare const MOCK_PUBLIC_MARKETS: {
+    readonly defaultServer: "live";
+    readonly commonSymbols: readonly ["EURUSD", "GBPUSD", "USDJPY", "XAUUSD", "XAGUSD", "BTCUSD", "ETHUSD"];
+};
+export declare function mockGetPublicMarkets(): {
+    defaultServer: string;
+    commonSymbols: string[];
+};
+//# sourceMappingURL=mock.d.ts.map

package/dist/services/settings/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/services/settings/mock.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAIzC,CAAC;AAKF,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAEjD;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAGjE;AAED,yFAAyF;AACzF,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX,wBAAgB,oBAAoB,IAAI;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAKA"}