@zeitvu97/cms-sdk 0.1.0

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

@@ -0,0 +1,264 @@
+import { ExecutionType } from './rules.type';
+export type ConditionValueType = 'float' | 'integer' | 'string';
+/** ClickHouse metric tables the CMS evaluator resolves condition fields from.
+ *  Mirrors the L1–L3a tables in `eaera_mt5/models` + the `deal` table. */
+export type ConditionTable = 'account_state' | 'account_metric_by_deal' | 'account_symbol_metric_by_deal' | 'account_metric_daily' | 'position_metric_by_deal' | 'deal';
+export interface ConditionField {
+    /** Backend key, e.g. `account_state.equity`. */
+    key: string;
+    /** Human label, e.g. `Account Equity`. */
+    label: string;
+    table: ConditionTable;
+    column: string;
+    valueType: ConditionValueType;
+    description: string;
+    unit: string;
+}
+export declare const CONDITION_FIELDS: readonly ConditionField[];
+/** Comparison operators the condition builder emits into `trigger.conditions[]`.
+ *
+ * These are the **word forms** the CMS condition evaluator expects on the wire
+ * (`eaera_cms/core/rules/conditions.py:_apply_operator`). The evaluator also
+ * accepts the JSON-Logic symbol aliases (`==`, `!=`, `>`, `>=`, `<`, `<=`),
+ * but the canonical contract uses the word forms — see the FEAT-006 testing
+ * guide and `risk-rules-api-guide.md` §4.E.a.
+ *
+ * Operator kind, per the backend `value` semantics:
+ *   - `gt`, `gte`, `lt`, `lte`        — numeric (`account_state.*`,
+ *                                       `account_metric_by_deal.*`)
+ *   - `eq`, `ne`                       — any (string / number / boolean)
+ *   - `in`, `not_in`                   — value MUST be a JSON list
+ *   - `contains`, `startswith`, `endswith` — string substring/affix;
+ *                                       backend coerces entity via `str()`
+ *   - `is_null`, `is_not_null`         — `value` is IGNORED by the backend;
+ *                                       UI should hide the value input
+ *   - `sum_within_days`                — CH-windowed SUM; carries a sibling
+ *                                       `days` window (defaults to 30).
+ *                                       Special — see {@link SUM_WITHIN_DAYS}
+ *                                       constant; not in {@link CONDITION_OPERATORS}.
+ *
+ * The UI renders the friendlier symbol for the 6 numeric word-forms via
+ * {@link CONDITION_OPERATOR_LABELS}; the others have explicit text labels
+ * (see {@link CONDITION_OPERATOR_LABELS} + {@link CONDITION_OPERATOR_LABELS_TEXT}).
+ */
+export declare const CONDITION_OPERATORS: readonly ["gt", "gte", "lt", "lte", "eq", "ne", "in", "not_in", "contains", "startswith", "endswith", "is_null", "is_not_null"];
+export type ConditionOperator = (typeof CONDITION_OPERATORS)[number];
+/** The CH-windowed SUM operator — special, NOT a member of
+ *  {@link CONDITION_OPERATORS} because it carries a sibling `days` key.
+ *  Authored through the rule YAML/expression path or directly via the API.
+ *  The dashboard does not surface this in the standard operator dropdown. */
+export declare const SUM_WITHIN_DAYS: "sum_within_days";
+export type SumWithinDaysOperator = typeof SUM_WITHIN_DAYS;
+/** Symbol label shown in the UI for each numeric word-form operator. */
+export declare const CONDITION_OPERATOR_LABELS: Record<ConditionOperator, string>;
+/** Per-operator value-type metadata. Drives the dashboard's value-input widget:
+ *   - `number`  → numeric input
+ *   - `string`  → single-line text input (substrings/affixes)
+ *   - `list`    → JSON-array editor (CSV/JSON toggle recommended)
+ *   - `none`    → value is ignored by the backend; UI should hide the input
+ */
+export type ConditionOperatorValueKind = 'number' | 'string' | 'list' | 'none';
+export declare const CONDITION_OPERATOR_VALUE_KINDS: Record<ConditionOperator, ConditionOperatorValueKind>;
+/** Symbol form → word form. The backend accepts both on the wire; the dashboard
+ *  canonicalises to the word form on save and on load (`useRuleBuilder`
+ *  `_normalizeOperator`). */
+export declare const CONDITION_OPERATOR_SYMBOL_TO_WORD: Record<string, ConditionOperator>;
+/** Normalise any operator string (symbol, word, or unknown) to a word form.
+ *  Unknown inputs are returned as-is so the backend's `eq`-fallback semantics
+ *  remain the source of truth. */
+export declare const normalizeConditionOperator: (raw: unknown) => string;
+/**
+ * Allowed MT5 leverage values for the `change_leverage` action. MT5 accepts a
+ * constrained integer set; the rule builder offers these as a select rather
+ * than a free-text input. The MT5 worker coerces the value to a positive int
+ * (`worker/tasks/dispatcher.py:_change_leverage`); this list mirrors the
+ * common broker-configured leverages.
+ */
+export declare const LEVERAGE_OPTIONS: readonly [1, 5, 10, 20, 25, 30, 40, 50, 100, 200, 300, 400, 500, 1000];
+export type LeverageOption = (typeof LEVERAGE_OPTIONS)[number];
+/**
+ * Builder action kinds → CMS action wiring. The fixed-rule action chain maps
+ * a UI `kind` to its `actionName` + nested `params` key. Kept here so the FE
+ * serializer (and the docs) stay in sync with the worker dispatcher contract.
+ *
+ * Specialized kinds (`move`, `leverage`, `tag`, `setField`) have dedicated UI
+ * inputs. The `custom` kind is a fallback for any action not in this list — it
+ * renders the `actionName` as read-only and exposes raw `params` as JSON.
+ */
+/** Value-level constants for action kinds — single source of truth. */
+export declare const ACTION_KIND: {
+    readonly MOVE: "move";
+    readonly LEVERAGE: "leverage";
+    readonly TAG: "tag";
+    readonly SET_FIELD: "setField";
+    readonly DISABLE_TRADE: "disableTrade";
+    readonly ENABLE_TRADE: "enableTrade";
+    readonly GENERATE_REPORT: "generateReport";
+    readonly GENERATE_AI_SUMMARY: "generateAiSummary";
+    readonly PROVISION_USER: "provisionUser";
+    readonly CUSTOM: "custom";
+};
+/** Action kind type — derived from {@link ACTION_KIND}. */
+export type RuleActionKind = (typeof ACTION_KIND)[keyof typeof ACTION_KIND];
+export interface ActionKindDef {
+    kind: RuleActionKind;
+    actionName: string;
+    /** Nested `params` key the worker dispatcher reads (camelCase; the CMS
+     *  casing middleware converts to snake_case before the worker sees it). */
+    paramKey?: string;
+    /** Default codeRef (pack handler path) for actions that require one. */
+    defaultCodeRef?: string;
+    /** Human label shown in the UI kind selector. */
+    label: string;
+}
+export declare const ACTION_KINDS: readonly ActionKindDef[];
+/** Lookup an ActionKindDef by backend actionName. Returns undefined for unknown names. */
+export declare const actionDefByActionName: (actionName: string) => ActionKindDef | undefined;
+/** Per-action `result.output` field shapes — the authoritative reference for
+ *  what the CMS completion handler stores at `execution.result.output` after a
+ *  successful action.
+ *
+ *  When the history/detection feeds fetch with `?exclude_params=true`, the
+ *  `params` JSONB is dropped entirely. The dashboard reads action details from
+ *  `result.output` (and `operationName`) instead. This map tells the dashboard
+ *  which keys to expect per action.
+ *
+ *  Source: `eaera-mt5/worker/tasks/dispatcher.py` (worker return shape) +
+ *  `eaera-mt5/eaera_mt5/handlers/*.py` (handler ActionResult.output) +
+ *  `eaera-cms/eaera_cms/core/content/completion.py:427`
+ *  (`execution.result = {"success": True, "output": res.output}`).
+ *
+ *  Each entry lists the keys the output dict carries. The values are always
+ *  primitives (string / number / boolean / string[]). */
+export interface ActionResultField {
+    /** Key in `result.output`. */
+    key: string;
+    /** Human label. */
+    label: string;
+    /** Value type. */
+    type: 'string' | 'number' | 'boolean' | 'string[]';
+}
+export declare const ACTION_RESULT_FIELDS: Record<string, readonly ActionResultField[]>;
+/** Extract a flat `{key: value}` dict from `result.output` for a given action.
+ *  Returns `{}` when output is missing or not an object. */
+export declare const resultOutputOf: (result: Record<string, unknown> | null | undefined, actionName: string) => Record<string, unknown>;
+/** Lookup an ActionKindDef by UI kind. Returns undefined for 'custom'. */
+export declare const actionDefByKind: (kind: RuleActionKind) => ActionKindDef | undefined;
+/** FE-only action step view-model. The single canonical shape used by both
+ *  the Fixed Rules editor and the LLM-rule (skill) editor. The dashboard
+ *  imports this from the SDK so the two editors serialize identically and
+ *  never diverge on what an action looks like. */
+export interface RuleActionView {
+    /** Local UI key — never sent to the backend. */
+    id: string;
+    /** FE-only action kind; maps 1:1 to {@link RuleActionKind}. */
+    kind: RuleActionKind;
+    /** Target group for `kind === 'move'`. */
+    targetGroup?: string;
+    /** Tags array for `kind === 'tag'`. */
+    tags?: string[];
+    /** Tag mode for `kind === 'tag'`. */
+    tagMode?: 'append' | 'replace' | 'remove';
+    /** Field name for `kind === 'setField'` / `kind === 'provisionUser'`. */
+    field?: string;
+    /** Value for `kind === 'leverage'` (numeric) or `kind === 'setField'`
+     *  (stringified). */
+    value?: number | string;
+    /** Report period start (ISO `YYYY-MM-DD`) for `kind === 'generateReport'`. */
+    dateFrom?: string;
+    /** Report period end (ISO `YYYY-MM-DD`) for `kind === 'generateReport'`. */
+    dateTo?: string;
+    /** Reason string for `kind === 'disableTrade' | 'enableTrade'`. */
+    reason?: string;
+    /** Backend actionName — auto-populated for specialized kinds; required for `custom`. */
+    actionName?: string;
+    /** Backend codeRef (handler path). Preserved on load, emitted on save. */
+    codeRef?: string;
+    /** Raw params object — used by `custom` and preserved for round-tripping. */
+    params?: Record<string, unknown>;
+}
+/** Serialize the per-kind `params` payload for the CMS dispatcher.
+ *  Mirrors the historical `useRuleBuilder._serializeActionParams`.
+ *
+ *  Critical contract:
+ *  - The dispatcher passes `params` through `ctx.data` to the worker handler.
+ *  - The MT5 worker reads snake_case keys (`from_time`, `new_group`,
+ *    `new_leverage`, …) and the CMS casing middleware converts our
+ *    camelCase keys to snake_case on the way in.
+ *  - Empty / zero required fields are omitted so the worker doesn't pick
+ *    up its default-0 placeholder and silently fail. The rule can be
+ *    saved with empty inputs; the action will then fail gracefully at
+ *    fire time with a clear error.
+ *  - Do NOT emit `login` / `serverName` placeholders — the runtime context
+ *    (trigger event or fire payload) carries those.
+ */
+export declare const serializeActionParams: (action: RuleActionView) => Record<string, unknown>;
+/** Serialize a single action view into the CMS wire shape
+ *  `{ actionName, codeRef?, params }` — used for both single-step and chain
+ *  rule executionParams. */
+export declare const serializeAction: (action: RuleActionView) => {
+    actionName: string;
+    codeRef?: string;
+    params: Record<string, unknown>;
+};
+/** Build the `executionParams` payload from a list of actions.
+ *
+ * - 0 actions → `executionType: 'action'` with empty params.
+ * - 1 action, kind `SET_FIELD` → `executionType: 'set_field'` with
+ *   `executionParams: { field, value }`. The CMS dispatcher (`_dispatch_target`'s
+ *   `set_field` branch) only takes this dedicated path — emitting it as a
+ *   plain `action` would land on the action-executor path, which requires a
+ *   `code_ref` that `set_field` does not have.
+ * - 1 action, any other kind → `executionType: 'action'` with the
+ *   `serializeAction(...)` shape (actionName + optional codeRef + params).
+ * - 2+ actions → `executionType: 'chain'` with `executionParams.steps[]`.
+ */
+export declare const actionsToExecutionParams: (actions: RuleActionView[]) => {
+    executionType: ExecutionType;
+    executionParams: Record<string, unknown>;
+};
+/** Read the action list back from a stored `ContentRule.executionParams`.
+ *  Supports `set_field`, single-step `action`, and multi-step `chain`
+ *  payloads. */
+export declare const actionsFromExecution: (rule: {
+    executionType: ExecutionType | string;
+    executionParams?: Record<string, unknown> | null;
+}) => RuleActionView[];
+/**
+ * Event-payload fields for `triggerType === 'event'` rules. The CMS
+ * condition evaluator resolves dotted paths from the Kafka event payload
+ * (`event.data.*`) with a fallback to flat fields
+ * (`eaera_cms/core/rules/conditions.py:_resolve_field`). These are NOT
+ * ClickHouse metric fields — they come from the event itself.
+ *
+ * The dashboard tree builder emits these verbatim so the engine can resolve
+ * them at fire time. Source: `eaera-mt5/reference-v0/ch/ddl.py` payload
+ * schemas + `eaera-mt5/worker/tasks/realtime.py` event shapes.
+ */
+/** Top-level key of the event payload each field belongs to. */
+export declare const EVENT_PAYLOAD_SOURCE: {
+    readonly DEAL: "deal";
+    readonly POSITION: "position";
+    readonly ORDER: "order";
+};
+export type EventPayloadSource = (typeof EVENT_PAYLOAD_SOURCE)[keyof typeof EVENT_PAYLOAD_SOURCE];
+export interface EventPayloadField {
+    /** Backend dotted-path key, e.g. `deal.profit`. */
+    key: string;
+    /** Human label, e.g. `Deal Profit`. */
+    label: string;
+    /** Which event payload this field is sourced from. */
+    source: EventPayloadSource;
+    valueType: ConditionValueType;
+    unit: string;
+}
+export declare const EVENT_PAYLOAD_FIELDS: readonly EventPayloadField[];
+/**
+ * Filter the event-payload catalog to a subset appropriate for an event type.
+ * The dashboard uses this to narrow the metric dropdown so a `deal_close`
+ * rule can only select `deal.*` fields, etc. Returns all fields if the event
+ * type doesn't have a known narrowing (e.g. `statement` falls back to CH
+ * catalog fields).
+ */
+export declare const eventPayloadFieldsFor: (_eventType: string | null | undefined) => readonly EventPayloadField[];
+//# sourceMappingURL=conditions.d.ts.map

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

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

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"}