@robosystems/client 0.3.27 → 0.3.29

package/sdk/types.gen.ts

@@ -120,337 +120,6 @@ export type AddPublishListMembersOperation = {
     list_id: string;
 };
 
-/**
- * AgentListResponse
- *
- * Response for listing available agents.
- */
-export type AgentListResponse = {
-    /**
-     * Agents
-     *
-     * Dictionary of available agents with metadata
-     */
-    agents: {
-        [key: string]: {
-            [key: string]: unknown;
-        };
-    };
-    /**
-     * Total
-     *
-     * Total number of agents
-     */
-    total: number;
-};
-
-/**
- * AgentMessage
- *
- * Message in conversation history.
- */
-export type AgentMessage = {
-    /**
-     * Role
-     *
-     * Message role (user/assistant)
-     */
-    role: string;
-    /**
-     * Content
-     *
-     * Message content
-     */
-    content: string;
-    /**
-     * Timestamp
-     *
-     * Message timestamp
-     */
-    timestamp?: string | null;
-};
-
-/**
- * AgentMetadataResponse
- *
- * Response for agent metadata.
- */
-export type AgentMetadataResponse = {
-    /**
-     * Name
-     *
-     * Agent name
-     */
-    name: string;
-    /**
-     * Description
-     *
-     * Agent description
-     */
-    description: string;
-    /**
-     * Version
-     *
-     * Agent version
-     */
-    version: string;
-    /**
-     * Capabilities
-     *
-     * Agent capabilities
-     */
-    capabilities: Array<string>;
-    /**
-     * Supported Modes
-     *
-     * Supported execution modes
-     */
-    supported_modes: Array<string>;
-    /**
-     * Requires Credits
-     *
-     * Whether agent requires credits
-     */
-    requires_credits: boolean;
-    /**
-     * Author
-     *
-     * Agent author
-     */
-    author?: string | null;
-    /**
-     * Tags
-     *
-     * Agent tags
-     */
-    tags?: Array<string>;
-};
-
-/**
- * AgentMode
- *
- * Agent execution modes.
- */
-export type AgentMode = 'quick' | 'standard' | 'extended' | 'streaming';
-
-/**
- * AgentRecommendation
- *
- * Single agent recommendation.
- */
-export type AgentRecommendation = {
-    /**
-     * Agent Type
-     *
-     * Agent type identifier
-     */
-    agent_type: string;
-    /**
-     * Agent Name
-     *
-     * Agent display name
-     */
-    agent_name: string;
-    /**
-     * Confidence
-     *
-     * Confidence score (0-1)
-     */
-    confidence: number;
-    /**
-     * Capabilities
-     *
-     * Agent capabilities
-     */
-    capabilities: Array<string>;
-    /**
-     * Reason
-     *
-     * Reason for recommendation
-     */
-    reason?: string | null;
-};
-
-/**
- * AgentRecommendationRequest
- *
- * Request for agent recommendations.
- */
-export type AgentRecommendationRequest = {
-    /**
-     * Query
-     *
-     * Query to analyze
-     */
-    query: string;
-    /**
-     * Context
-     *
-     * Additional context
-     */
-    context?: {
-        [key: string]: unknown;
-    } | null;
-};
-
-/**
- * AgentRecommendationResponse
- *
- * Response for agent recommendations.
- */
-export type AgentRecommendationResponse = {
-    /**
-     * Recommendations
-     *
-     * List of agent recommendations sorted by confidence
-     */
-    recommendations: Array<AgentRecommendation>;
-    /**
-     * Query
-     *
-     * The analyzed query
-     */
-    query: string;
-};
-
-/**
- * AgentRequest
- *
- * Request model for agent interactions.
- */
-export type AgentRequest = {
-    /**
-     * Message
-     *
-     * The query or message to process
-     */
-    message: string;
-    /**
-     * History
-     *
-     * Conversation history
-     */
-    history?: Array<AgentMessage>;
-    /**
-     * Context
-     *
-     * Additional context for analysis (e.g., enable_rag, include_schema)
-     */
-    context?: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Execution mode
-     */
-    mode?: AgentMode | null;
-    /**
-     * Agent Type
-     *
-     * Specific agent type to use (optional)
-     */
-    agent_type?: string | null;
-    /**
-     * Criteria for agent selection
-     */
-    selection_criteria?: SelectionCriteria | null;
-    /**
-     * Force Extended Analysis
-     *
-     * Force extended analysis mode with comprehensive research
-     */
-    force_extended_analysis?: boolean;
-    /**
-     * Enable Rag
-     *
-     * Enable RAG context enrichment
-     */
-    enable_rag?: boolean;
-    /**
-     * Stream
-     *
-     * Enable streaming response
-     */
-    stream?: boolean;
-};
-
-/**
- * AgentResponse
- *
- * Response model for agent interactions.
- */
-export type AgentResponse = {
-    /**
-     * Content
-     *
-     * The agent's response content
-     */
-    content: string;
-    /**
-     * Agent Used
-     *
-     * The agent type that handled the request
-     */
-    agent_used: string;
-    /**
-     * The execution mode used
-     */
-    mode_used: AgentMode;
-    /**
-     * Metadata
-     *
-     * Response metadata including routing info
-     */
-    metadata?: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Tokens Used
-     *
-     * Token usage statistics
-     */
-    tokens_used?: {
-        [key: string]: number;
-    } | null;
-    /**
-     * Confidence Score
-     *
-     * Confidence score of the response (0.0-1.0 scale)
-     */
-    confidence_score?: number | null;
-    /**
-     * Operation Id
-     *
-     * Operation ID for SSE monitoring
-     */
-    operation_id?: string | null;
-    /**
-     * Is Partial
-     *
-     * Whether this is a partial response
-     */
-    is_partial?: boolean;
-    /**
-     * Error Details
-     *
-     * Error details if any
-     */
-    error_details?: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Execution Time
-     *
-     * Execution time in seconds
-     */
-    execution_time?: number | null;
-    /**
-     * Timestamp
-     *
-     * Response timestamp
-     */
-    timestamp?: string;
-};
-
 /**
  * ArtifactResponse
  *
@@ -486,7 +155,9 @@ export type ArtifactResponse = {
         kind: 'statement_renderer';
     } & StatementMechanics) | ({
         kind: 'metric';
-    } & MetricMechanics);
+    } & MetricMechanics) | ({
+        kind: 'rollforward';
+    } & RollforwardMechanics);
 };
 
 /**
@@ -560,6 +231,41 @@ export type AssociationResponse = {
     approved_by?: string | null;
 };
 
+/**
+ * AttributionFilter
+ *
+ * One flow-concept attribution rule on a rollforward IB.
+ *
+ * Pairs a target concept (the flow leaf the matched amount counts
+ * toward) with a predicate (which LineItems match). The rollforward's
+ * ``attribution_filters: list[AttributionFilter]`` declares every flow
+ * the BS source decomposes into; the renderer evaluates them all per
+ * period.
+ *
+ * ``target_element_id`` is resolved at create time from ``target_qname``
+ * via the rs-gaap library + tenant taxonomy lookup. Authors only need
+ * to provide the qname; the element_id is filled in by the create
+ * handler and the resolved value is what the envelope round-trips.
+ */
+export type AttributionFilter = {
+    /**
+     * Target Qname
+     *
+     * QName of the flow concept this filter produces facts for — e.g. ``rs-gaap:ProceedsFromIssuanceOfCommonStock``. Resolved to ``target_element_id`` at create time.
+     */
+    target_qname: string;
+    /**
+     * Target Element Id
+     *
+     * Resolved element id for ``target_qname``. Null at create time; populated by the handler before persistence. Round-tripped in the envelope.
+     */
+    target_element_id?: string | null;
+    /**
+     * Predicate that determines which LineItems match this filter.
+     */
+    predicate: LineItemMetadataPredicate;
+};
+
 /**
  * AuthResponse
  *
@@ -611,9 +317,9 @@ export type AuthResponse = {
 /**
  * AutoMapElementsOperation
  *
- * Run the MappingAgent over a mapping structure (async).
+ * Run the MappingOperator over a mapping structure (async).
  *
- * The MappingAgent walks every unmapped CoA element and proposes
+ * The MappingOperator walks every unmapped CoA element and proposes
  * associations to reporting concepts. Confidence thresholds: ≥0.90
  * auto-approved (association created), 0.70-0.89 flagged for review
  * (created with `confidence` set; surface it in your UI), <0.70 skipped.
@@ -940,17 +646,17 @@ export type BackupStatsResponse = {
 };
 
 /**
- * BatchAgentRequest
+ * BatchOperatorRequest
  *
  * Request for batch processing multiple queries.
  */
-export type BatchAgentRequest = {
+export type BatchOperatorRequest = {
     /**
      * Queries
      *
      * List of queries to process (max 10)
      */
-    queries: Array<AgentRequest>;
+    queries: Array<OperatorRequest>;
     /**
      * Parallel
      *
@@ -960,17 +666,17 @@ export type BatchAgentRequest = {
 };
 
 /**
- * BatchAgentResponse
+ * BatchOperatorResponse
  *
  * Response for batch processing.
  */
-export type BatchAgentResponse = {
+export type BatchOperatorResponse = {
     /**
      * Results
      *
-     * List of agent responses (includes successes and failures)
+     * List of operator responses (includes successes and failures)
      */
-    results: Array<AgentResponse>;
+    results: Array<OperatorResponse>;
     /**
      * Total Execution Time
      *
@@ -1783,6 +1489,12 @@ export type CreateEventBlockRequest = {
      * REA event class. 'economic' events change resources and drive GL postings; 'support' events are audit-trail / value-chain primitives (typically captured with apply_handlers=False).
      */
     event_class?: 'economic' | 'support';
+    /**
+     * Event Action
+     *
+     * Canonical action verb refining `event_category`. Disambiguates concepts ERPs collapse: `transferAllRights` (ownership transfer, no physical movement) vs `transferCustody` (physical only, no rights transfer) — load-bearing for consignment, drop-shipping, marketplace settlement, escrow. Optional; null is valid for legacy events and during adapter rollout.
+     */
+    event_action?: 'produce' | 'raise' | 'consume' | 'lower' | 'use' | 'cite' | 'work' | 'deliverService' | 'pickup' | 'dropoff' | 'accept' | 'transferCustody' | 'transferAllRights' | 'transfer' | 'move' | 'modify' | 'combine' | 'separate' | 'copy' | null;
     /**
      * Agent Id
      *
@@ -2038,6 +1750,8 @@ export type CreateGraphRequest = {
 export type CreateInformationBlockRequest = ({
     block_type: 'schedule';
 } & CreateScheduleArm) | ({
+    block_type: 'rollforward';
+} & CreateRollforwardArm) | ({
     block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric';
 } & CreateLegacyArm);
 
@@ -2048,7 +1762,7 @@ export type CreateInformationBlockRequest = ({
  *
  * This is the iterative, AI-assisted craft path. Each call adds a single
  * association to the target mapping structure. Use `auto-map-elements`
- * to create many at once via the MappingAgent. Reject duplicates: if
+ * to create many at once via the MappingOperator. Reject duplicates: if
  * the (from, to, type) tuple already exists, the call returns 409.
  */
 export type CreateMappingAssociationOperation = {
@@ -2173,7 +1887,7 @@ export type CreateReportRequest = {
     /**
      * Taxonomy Id
      *
-     * Taxonomy that defines the structures (BS / IS / CF / Equity / Schedules) this report can render. Defaults to the platform US GAAP reporting taxonomy.
+     * Taxonomy that defines the structures (BS / IS / CF / Equity / Schedules) this report can render. Accepts either an exact tenant-specific taxonomy UUID or a standard name (e.g. 'rs-gaap'). Standard names resolve to the latest reporting_standard taxonomy with that name. Defaults to 'rs-gaap', the canonical reporting vocabulary.
      */
     taxonomy_id?: string;
     /**
@@ -2228,6 +1942,56 @@ export type CreateRepositorySubscriptionRequest = {
     plan_name: string;
 };
 
+/**
+ * CreateRollforwardRequest
+ *
+ * Create a rollforward Information Block.
+ *
+ * Mirrors :class:`CreateScheduleRequest` in shape. The block decomposes
+ * the period change in ``bs_source_qname`` across the declared
+ * attribution filters. Residual (Δ BS - Σ filter matches) falls back to
+ * the default change tag — or, if no default is declared, surfaces as
+ * an unattributed fact tagged with a synthetic residual concept.
+ */
+export type CreateRollforwardRequest = {
+    /**
+     * Name
+     *
+     * Human-readable block name.
+     */
+    name: string;
+    /**
+     * Bs Source Qname
+     *
+     * QName of the balance-sheet element whose period delta this block decomposes. Resolved to ``bs_source_element_id`` at create time.
+     */
+    bs_source_qname: string;
+    /**
+     * Default Change Tag Qname
+     *
+     * QName of the fallback flow concept (Tier 1 default change tag). Residual amount — Δ BS minus the sum of filter-matched amounts — is attributed to this concept. When omitted, residual surfaces unattributed; the validation_mode setting governs whether that's a hard error.
+     */
+    default_change_tag_qname?: string | null;
+    /**
+     * Attribution Filters
+     *
+     * Filter predicates routing LineItems to flow concepts.
+     */
+    attribution_filters?: Array<AttributionFilter>;
+    /**
+     * Validation Mode
+     *
+     * How the renderer arbitrates when Σ filter matches != Δ BS. ``strict`` raises; ``residual_as_default`` emits the residual as a default-tag fact (the common case); ``warn_only`` logs and lets the imbalance pass.
+     */
+    validation_mode?: 'strict' | 'residual_as_default' | 'warn_only';
+    /**
+     * Taxonomy Id
+     *
+     * Owning taxonomy id (auto-resolved from ``bs_source_qname`` when omitted).
+     */
+    taxonomy_id?: string | null;
+};
+
 /**
  * CreateScheduleRequest
  */
@@ -3054,6 +2818,8 @@ export type DeleteGraphOp = {
 export type DeleteInformationBlockRequest = ({
     block_type: 'schedule';
 } & DeleteScheduleArm) | ({
+    block_type: 'rollforward';
+} & DeleteRollforwardArm) | ({
     block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric';
 } & DeleteLegacyArm);
 
@@ -3225,6 +2991,24 @@ export type DeleteResult = {
     deleted: boolean;
 };
 
+/**
+ * DeleteRollforwardRequest
+ *
+ * Delete a rollforward block.
+ *
+ * Cascades through any synthetic facts produced by this block's filter
+ * evaluations. The underlying ledger LineItems are not touched — only
+ * the rollforward IB's projection of them.
+ */
+export type DeleteRollforwardRequest = {
+    /**
+     * Structure Id
+     *
+     * Structure ID of the rollforward block.
+     */
+    structure_id: string;
+};
+
 /**
  * DeleteScheduleRequest
  *
@@ -4202,6 +3986,12 @@ export type EventBlockEnvelope = {
      * REA event class — `economic` (drives GL postings) or `support` (audit-trail / value-chain primitive, no GL impact).
      */
     event_class: string;
+    /**
+     * Event Action
+     *
+     * Canonical action verb refining `event_category`. Null when the source adapter or capture path didn't supply one.
+     */
+    event_action?: 'produce' | 'raise' | 'consume' | 'lower' | 'use' | 'cite' | 'work' | 'deliverService' | 'pickup' | 'dropoff' | 'accept' | 'transferCustody' | 'transferAllRights' | 'transfer' | 'move' | 'modify' | 'combine' | 'separate' | 'copy' | null;
     /**
      * Agent Id
      *
@@ -4348,6 +4138,70 @@ export type EventHandlerResponse = {
     created_by?: string | null;
 };
 
+/**
+ * ExecuteEventBlockRequest
+ *
+ * Request to publish an event to the source-of-truth system.
+ *
+ * For events on a connection with `write_policy='qb_authoritative'`
+ * (or `'hybrid'`), this triggers a synchronous write to QuickBooks
+ * via the QB API. The returned `qb_txn_id` lands on
+ * `event.metadata.qb_external_id` and the event transitions to
+ * `committed` (in flight) → `fulfilled` (QB accepted) or `pending`
+ * (QB rejected).
+ *
+ * `'native'`-policy events fast-path through with no QB write —
+ * RoboSystems IS the source of truth, no outbound publish needed.
+ */
+export type ExecuteEventBlockRequest = {
+    /**
+     * Event Id
+     *
+     * Event ID (`evt_*` ULID) to publish. The event's `metadata.connection_id` determines which QB connection to write to; the connection's `write_policy` governs whether a write fires.
+     */
+    event_id: string;
+    /**
+     * Connection Id
+     *
+     * Override for the connection to route the write through. Used by the close-period batch path where schedule-originated events don't carry `connection_id` in their metadata. When unset, the command reads `event.metadata.connection_id`.
+     */
+    connection_id?: string | null;
+};
+
+/**
+ * ExecuteEventBlockResponse
+ *
+ * Outcome of an `execute-event-block` call.
+ */
+export type ExecuteEventBlockResponse = {
+    /**
+     * Event Id
+     *
+     * Echo of the event ID.
+     */
+    event_id: string;
+    /**
+     * Status
+     *
+     * Post-execute event status. `'classified'` when no write fired (native policy or no-op). `'committed'` when the QB write was in flight (intermediate state). `'fulfilled'` when QB accepted and local GL drafts were promoted to posted. `'pending'` when QB rejected — see `qb_error` for the rejection detail; retry after fixing the underlying issue.
+     */
+    status: string;
+    /**
+     * Qb External Id
+     *
+     * QB-side transaction ID returned by the JournalEntry API. Null when no write fired (native policy) or when the write was rejected before getting an ID.
+     */
+    qb_external_id?: string | null;
+    /**
+     * Qb Error
+     *
+     * QB rejection detail when status='pending'. Shape: `{code, message, qb_response_at}`. Operator retries after fixing CoA mapping / amount validation / closed-period.
+     */
+    qb_error?: {
+        [key: string]: unknown;
+    } | null;
+};
+
 /**
  * FactLite
  *
@@ -6184,6 +6038,14 @@ export type JournalEntryLineItemInput = {
      * Per-line memo (overrides the entry-level memo on this line).
      */
     description?: string | null;
+    /**
+     * Metadata
+     *
+     * Optional per-line metadata stamped on ``LineItem.metadata_``. Used to carry source-system fields the standard columns don't cover — e.g. an external flow-tag code that drives rollforward attribution (``transaction_description_code``), an external memo, or a cost-center hint. Pass-through is non-validating; the renderer / filter engine reads keys it knows about and ignores the rest. ``None`` is normalized to ``{}`` at persist time.
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
 };
 
 /**
@@ -6542,6 +6404,42 @@ export type LedgerEntityResponse = {
     updated_at?: string | null;
 };
 
+/**
+ * LineItemMetadataPredicate
+ *
+ * Filter ledger LineItems whose ``metadata_[field]`` is in ``values``.
+ *
+ * The single predicate kind shipped in Phase 2 MVP. Sufficient for any
+ * source taxonomy that stamps a flow-tag column on each transaction
+ * line — mini's ``TransactionDescriptionCode``, future XBRL GL
+ * ``GenericFlowCategory`` columns, custom tenant tags.
+ *
+ * ``field`` is the JSONB key under ``line_items.metadata`` (e.g.
+ * ``"transaction_description_code"``). ``values`` is the set of values
+ * that route to the filter's target concept; matched LineItems aggregate
+ * signed into the attributed fact for the period.
+ */
+export type LineItemMetadataPredicate = {
+    /**
+     * Kind
+     *
+     * Discriminator value selecting this predicate shape.
+     */
+    kind?: 'line_item_metadata_field';
+    /**
+     * Field
+     *
+     * JSONB key under ``line_items.metadata`` to match against — e.g. ``transaction_description_code``. The renderer performs an exact-string comparison on the JSONB-extracted text value.
+     */
+    field: string;
+    /**
+     * Values
+     *
+     * Metadata values that route to this filter's target concept. A LineItem matches when ``metadata[field] ∈ values`` AND the line falls within the rollforward's period.
+     */
+    values: Array<string>;
+};
+
 /**
  * LinkEntityTaxonomyRequest
  *
@@ -7322,9 +7220,239 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
 };
 
 /**
- * OperationEnvelope[DeleteResult]
+ * OperationEnvelope[DeleteResult]
+ */
+export type OperationEnvelopeDeleteResult = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: DeleteResult | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
+/**
+ * OperationEnvelope[DeleteTaxonomyBlockResponse]
+ */
+export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: DeleteTaxonomyBlockResponse | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
+/**
+ * OperationEnvelope[EntityTaxonomyResponse]
+ */
+export type OperationEnvelopeEntityTaxonomyResponse = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: EntityTaxonomyResponse | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
+/**
+ * OperationEnvelope[EvaluateRulesResponse]
+ */
+export type OperationEnvelopeEvaluateRulesResponse = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: EvaluateRulesResponse | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
+/**
+ * OperationEnvelope[EventBlockEnvelope]
+ */
+export type OperationEnvelopeEventBlockEnvelope = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
+     *
+     * op_-prefixed ULID for audit and SSE correlation
+     */
+    operationId: string;
+    /**
+     * Status
+     *
+     * Operation lifecycle state
+     */
+    status: 'completed' | 'pending' | 'failed';
+    /**
+     * Command-specific result payload
+     */
+    result?: EventBlockEnvelope | null;
+    /**
+     * At
+     *
+     * ISO-8601 UTC timestamp
+     */
+    at: string;
+    /**
+     * Createdby
+     *
+     * User ID that initiated the operation (null for legacy callers)
+     */
+    createdBy?: string | null;
+    /**
+     * Idempotentreplay
+     *
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     */
+    idempotentReplay?: boolean;
+};
+
+/**
+ * OperationEnvelope[EventHandlerResponse]
  */
-export type OperationEnvelopeDeleteResult = {
+export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Operation
      *
@@ -7346,7 +7474,7 @@ export type OperationEnvelopeDeleteResult = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteResult | null;
+    result?: EventHandlerResponse | null;
     /**
      * At
      *
@@ -7368,9 +7496,9 @@ export type OperationEnvelopeDeleteResult = {
 };
 
 /**
- * OperationEnvelope[DeleteTaxonomyBlockResponse]
+ * OperationEnvelope[ExecuteEventBlockResponse]
  */
-export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
+export type OperationEnvelopeExecuteEventBlockResponse = {
     /**
      * Operation
      *
@@ -7392,7 +7520,7 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteTaxonomyBlockResponse | null;
+    result?: ExecuteEventBlockResponse | null;
     /**
      * At
      *
@@ -7414,9 +7542,9 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
 };
 
 /**
- * OperationEnvelope[EntityTaxonomyResponse]
+ * OperationEnvelope[FiscalCalendarResponse]
  */
-export type OperationEnvelopeEntityTaxonomyResponse = {
+export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Operation
      *
@@ -7438,7 +7566,7 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EntityTaxonomyResponse | null;
+    result?: FiscalCalendarResponse | null;
     /**
      * At
      *
@@ -7460,9 +7588,9 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
 };
 
 /**
- * OperationEnvelope[EvaluateRulesResponse]
+ * OperationEnvelope[InformationBlockEnvelope]
  */
-export type OperationEnvelopeEvaluateRulesResponse = {
+export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Operation
      *
@@ -7484,7 +7612,7 @@ export type OperationEnvelopeEvaluateRulesResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EvaluateRulesResponse | null;
+    result?: InformationBlockEnvelope | null;
     /**
      * At
      *
@@ -7506,9 +7634,9 @@ export type OperationEnvelopeEvaluateRulesResponse = {
 };
 
 /**
- * OperationEnvelope[EventBlockEnvelope]
+ * OperationEnvelope[InitializeLedgerResponse]
  */
-export type OperationEnvelopeEventBlockEnvelope = {
+export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Operation
      *
@@ -7530,7 +7658,7 @@ export type OperationEnvelopeEventBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: EventBlockEnvelope | null;
+    result?: InitializeLedgerResponse | null;
     /**
      * At
      *
@@ -7552,9 +7680,9 @@ export type OperationEnvelopeEventBlockEnvelope = {
 };
 
 /**
- * OperationEnvelope[EventHandlerResponse]
+ * OperationEnvelope[JournalEntryResponse]
  */
-export type OperationEnvelopeEventHandlerResponse = {
+export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Operation
      *
@@ -7576,7 +7704,7 @@ export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EventHandlerResponse | null;
+    result?: JournalEntryResponse | null;
     /**
      * At
      *
@@ -7598,9 +7726,9 @@ export type OperationEnvelopeEventHandlerResponse = {
 };
 
 /**
- * OperationEnvelope[FiscalCalendarResponse]
+ * OperationEnvelope[LedgerAgentResponse]
  */
-export type OperationEnvelopeFiscalCalendarResponse = {
+export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Operation
      *
@@ -7622,7 +7750,7 @@ export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Command-specific result payload
      */
-    result?: FiscalCalendarResponse | null;
+    result?: LedgerAgentResponse | null;
     /**
      * At
      *
@@ -7644,9 +7772,9 @@ export type OperationEnvelopeFiscalCalendarResponse = {
 };
 
 /**
- * OperationEnvelope[InformationBlockEnvelope]
+ * OperationEnvelope[LedgerEntityResponse]
  */
-export type OperationEnvelopeInformationBlockEnvelope = {
+export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Operation
      *
@@ -7668,7 +7796,7 @@ export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: InformationBlockEnvelope | null;
+    result?: LedgerEntityResponse | null;
     /**
      * At
      *
@@ -7690,9 +7818,9 @@ export type OperationEnvelopeInformationBlockEnvelope = {
 };
 
 /**
- * OperationEnvelope[InitializeLedgerResponse]
+ * OperationEnvelope[PortfolioBlockEnvelope]
  */
-export type OperationEnvelopeInitializeLedgerResponse = {
+export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Operation
      *
@@ -7714,7 +7842,7 @@ export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: InitializeLedgerResponse | null;
+    result?: PortfolioBlockEnvelope | null;
     /**
      * At
      *
@@ -7736,9 +7864,9 @@ export type OperationEnvelopeInitializeLedgerResponse = {
 };
 
 /**
- * OperationEnvelope[JournalEntryResponse]
+ * OperationEnvelope[PreviewEventBlockResponse]
  */
-export type OperationEnvelopeJournalEntryResponse = {
+export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Operation
      *
@@ -7760,7 +7888,7 @@ export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Command-specific result payload
      */
-    result?: JournalEntryResponse | null;
+    result?: PreviewEventBlockResponse | null;
     /**
      * At
      *
@@ -7782,9 +7910,9 @@ export type OperationEnvelopeJournalEntryResponse = {
 };
 
 /**
- * OperationEnvelope[LedgerAgentResponse]
+ * OperationEnvelope[PublishListResponse]
  */
-export type OperationEnvelopeLedgerAgentResponse = {
+export type OperationEnvelopePublishListResponse = {
     /**
      * Operation
      *
@@ -7806,7 +7934,7 @@ export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerAgentResponse | null;
+    result?: PublishListResponse | null;
     /**
      * At
      *
@@ -7828,9 +7956,9 @@ export type OperationEnvelopeLedgerAgentResponse = {
 };
 
 /**
- * OperationEnvelope[LedgerEntityResponse]
+ * OperationEnvelope[ReportResponse]
  */
-export type OperationEnvelopeLedgerEntityResponse = {
+export type OperationEnvelopeReportResponse = {
     /**
      * Operation
      *
@@ -7852,7 +7980,7 @@ export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerEntityResponse | null;
+    result?: ReportResponse | null;
     /**
      * At
      *
@@ -7874,9 +8002,9 @@ export type OperationEnvelopeLedgerEntityResponse = {
 };
 
 /**
- * OperationEnvelope[PortfolioBlockEnvelope]
+ * OperationEnvelope[SecurityResponse]
  */
-export type OperationEnvelopePortfolioBlockEnvelope = {
+export type OperationEnvelopeSecurityResponse = {
     /**
      * Operation
      *
@@ -7898,7 +8026,7 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: PortfolioBlockEnvelope | null;
+    result?: SecurityResponse | null;
     /**
      * At
      *
@@ -7920,9 +8048,9 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
 };
 
 /**
- * OperationEnvelope[PreviewEventBlockResponse]
+ * OperationEnvelope[ShareReportResponse]
  */
-export type OperationEnvelopePreviewEventBlockResponse = {
+export type OperationEnvelopeShareReportResponse = {
     /**
      * Operation
      *
@@ -7944,7 +8072,7 @@ export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: PreviewEventBlockResponse | null;
+    result?: ShareReportResponse | null;
     /**
      * At
      *
@@ -7966,9 +8094,9 @@ export type OperationEnvelopePreviewEventBlockResponse = {
 };
 
 /**
- * OperationEnvelope[PublishListResponse]
+ * OperationEnvelope[TaxonomyBlockEnvelope]
  */
-export type OperationEnvelopePublishListResponse = {
+export type OperationEnvelopeTaxonomyBlockEnvelope = {
     /**
      * Operation
      *
@@ -7990,7 +8118,7 @@ export type OperationEnvelopePublishListResponse = {
     /**
      * Command-specific result payload
      */
-    result?: PublishListResponse | null;
+    result?: TaxonomyBlockEnvelope | null;
     /**
      * At
      *
@@ -8012,9 +8140,9 @@ export type OperationEnvelopePublishListResponse = {
 };
 
 /**
- * OperationEnvelope[ReportResponse]
+ * OperationEnvelope[list[PublishListMemberResponse]]
  */
-export type OperationEnvelopeReportResponse = {
+export type OperationEnvelopeListPublishListMemberResponse = {
     /**
      * Operation
      *
@@ -8034,9 +8162,11 @@ export type OperationEnvelopeReportResponse = {
      */
     status: 'completed' | 'pending' | 'failed';
     /**
+     * Result
+     *
      * Command-specific result payload
      */
-    result?: ReportResponse | null;
+    result?: Array<PublishListMemberResponse> | null;
     /**
      * At
      *
@@ -8058,189 +8188,334 @@ export type OperationEnvelopeReportResponse = {
 };
 
 /**
- * OperationEnvelope[SecurityResponse]
+ * OperatorListResponse
+ *
+ * Response for listing available operators.
  */
-export type OperationEnvelopeSecurityResponse = {
+export type OperatorListResponse = {
     /**
-     * Operation
+     * Operators
      *
-     * Kebab-case operation name
+     * Dictionary of available operators with metadata
      */
-    operation: string;
+    operators: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
     /**
-     * Operationid
+     * Total
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Total number of operators
      */
-    operationId: string;
+    total: number;
+};
+
+/**
+ * OperatorMessage
+ *
+ * Message in conversation history.
+ */
+export type OperatorMessage = {
     /**
-     * Status
+     * Role
      *
-     * Operation lifecycle state
+     * Message role (user/assistant)
      */
-    status: 'completed' | 'pending' | 'failed';
+    role: string;
     /**
-     * Command-specific result payload
+     * Content
+     *
+     * Message content
      */
-    result?: SecurityResponse | null;
+    content: string;
     /**
-     * At
+     * Timestamp
      *
-     * ISO-8601 UTC timestamp
+     * Message timestamp
      */
-    at: string;
+    timestamp?: string | null;
+};
+
+/**
+ * OperatorMetadataResponse
+ *
+ * Response for operator metadata.
+ */
+export type OperatorMetadataResponse = {
     /**
-     * Createdby
+     * Name
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Operator name
      */
-    createdBy?: string | null;
+    name: string;
     /**
-     * Idempotentreplay
+     * Description
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Operator description
      */
-    idempotentReplay?: boolean;
+    description: string;
+    /**
+     * Version
+     *
+     * Operator version
+     */
+    version: string;
+    /**
+     * Capabilities
+     *
+     * Operator capabilities
+     */
+    capabilities: Array<string>;
+    /**
+     * Supported Modes
+     *
+     * Supported execution modes
+     */
+    supported_modes: Array<string>;
+    /**
+     * Requires Credits
+     *
+     * Whether operator requires credits
+     */
+    requires_credits: boolean;
+    /**
+     * Author
+     *
+     * Operator author
+     */
+    author?: string | null;
+    /**
+     * Tags
+     *
+     * Operator tags
+     */
+    tags?: Array<string>;
 };
 
 /**
- * OperationEnvelope[ShareReportResponse]
+ * OperatorMode
+ *
+ * Operator execution modes.
  */
-export type OperationEnvelopeShareReportResponse = {
+export type OperatorMode = 'quick' | 'standard' | 'extended' | 'streaming';
+
+/**
+ * OperatorRecommendation
+ *
+ * Single operator recommendation.
+ */
+export type OperatorRecommendation = {
     /**
-     * Operation
+     * Operator Type
      *
-     * Kebab-case operation name
+     * Operator type identifier
      */
-    operation: string;
+    operator_type: string;
     /**
-     * Operationid
+     * Operator Name
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Operator display name
      */
-    operationId: string;
+    operator_name: string;
     /**
-     * Status
+     * Confidence
      *
-     * Operation lifecycle state
+     * Confidence score (0-1)
      */
-    status: 'completed' | 'pending' | 'failed';
+    confidence: number;
     /**
-     * Command-specific result payload
+     * Capabilities
+     *
+     * Operator capabilities
      */
-    result?: ShareReportResponse | null;
+    capabilities: Array<string>;
     /**
-     * At
+     * Reason
      *
-     * ISO-8601 UTC timestamp
+     * Reason for recommendation
      */
-    at: string;
+    reason?: string | null;
+};
+
+/**
+ * OperatorRecommendationRequest
+ *
+ * Request for operator recommendations.
+ */
+export type OperatorRecommendationRequest = {
     /**
-     * Createdby
+     * Query
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Query to analyze
      */
-    createdBy?: string | null;
+    query: string;
     /**
-     * Idempotentreplay
+     * Context
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Additional context
      */
-    idempotentReplay?: boolean;
+    context?: {
+        [key: string]: unknown;
+    } | null;
 };
 
 /**
- * OperationEnvelope[TaxonomyBlockEnvelope]
+ * OperatorRecommendationResponse
+ *
+ * Response for operator recommendations.
  */
-export type OperationEnvelopeTaxonomyBlockEnvelope = {
+export type OperatorRecommendationResponse = {
     /**
-     * Operation
+     * Recommendations
+     *
+     * List of operator recommendations sorted by confidence
+     */
+    recommendations: Array<OperatorRecommendation>;
+    /**
+     * Query
+     *
+     * The analyzed query
+     */
+    query: string;
+};
+
+/**
+ * OperatorRequest
+ *
+ * Request model for operator interactions.
+ */
+export type OperatorRequest = {
+    /**
+     * Message
+     *
+     * The query or message to process
+     */
+    message: string;
+    /**
+     * History
      *
-     * Kebab-case operation name
+     * Conversation history
      */
-    operation: string;
+    history?: Array<OperatorMessage>;
     /**
-     * Operationid
+     * Context
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Additional context for analysis (e.g., enable_rag, include_schema)
      */
-    operationId: string;
+    context?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Status
+     * Execution mode
+     */
+    mode?: OperatorMode | null;
+    /**
+     * Operator Type
      *
-     * Operation lifecycle state
+     * Specific operator type to use (optional)
      */
-    status: 'completed' | 'pending' | 'failed';
+    operator_type?: string | null;
     /**
-     * Command-specific result payload
+     * Criteria for operator selection
      */
-    result?: TaxonomyBlockEnvelope | null;
+    selection_criteria?: SelectionCriteria | null;
     /**
-     * At
+     * Force Extended Analysis
      *
-     * ISO-8601 UTC timestamp
+     * Force extended analysis mode with comprehensive research
      */
-    at: string;
+    force_extended_analysis?: boolean;
     /**
-     * Createdby
+     * Enable Rag
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Enable RAG context enrichment
      */
-    createdBy?: string | null;
+    enable_rag?: boolean;
     /**
-     * Idempotentreplay
+     * Stream
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Enable streaming response
      */
-    idempotentReplay?: boolean;
+    stream?: boolean;
 };
 
 /**
- * OperationEnvelope[list[PublishListMemberResponse]]
+ * OperatorResponse
+ *
+ * Response model for operator interactions.
  */
-export type OperationEnvelopeListPublishListMemberResponse = {
+export type OperatorResponse = {
     /**
-     * Operation
+     * Content
      *
-     * Kebab-case operation name
+     * The operator's response content
      */
-    operation: string;
+    content: string;
     /**
-     * Operationid
+     * Operator Used
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * The operator type that handled the request
      */
-    operationId: string;
+    operator_used: string;
     /**
-     * Status
+     * The execution mode used
+     */
+    mode_used: OperatorMode;
+    /**
+     * Metadata
      *
-     * Operation lifecycle state
+     * Response metadata including routing info
      */
-    status: 'completed' | 'pending' | 'failed';
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Result
+     * Tokens Used
      *
-     * Command-specific result payload
+     * Token usage statistics
      */
-    result?: Array<PublishListMemberResponse> | null;
+    tokens_used?: {
+        [key: string]: number;
+    } | null;
     /**
-     * At
+     * Confidence Score
      *
-     * ISO-8601 UTC timestamp
+     * Confidence score of the response (0.0-1.0 scale)
      */
-    at: string;
+    confidence_score?: number | null;
     /**
-     * Createdby
+     * Operation Id
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Operation ID for SSE monitoring
      */
-    createdBy?: string | null;
+    operation_id?: string | null;
     /**
-     * Idempotentreplay
+     * Is Partial
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Whether this is a partial response
      */
-    idempotentReplay?: boolean;
+    is_partial?: boolean;
+    /**
+     * Error Details
+     *
+     * Error details if any
+     */
+    error_details?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Execution Time
+     *
+     * Execution time in seconds
+     */
+    execution_time?: number | null;
+    /**
+     * Timestamp
+     *
+     * Response timestamp
+     */
+    timestamp?: string;
 };
 
 /**
@@ -9923,6 +10198,67 @@ export type RestoreBackupOp = {
     verify_after_restore?: boolean;
 };
 
+/**
+ * RollforwardMechanics
+ *
+ * Filter-based attribution mechanics for ``block_type='rollforward'``.
+ *
+ * Implements Tier 2 of the rollforward attribution design
+ * (``information-block.md`` §4.5). Each block decomposes one BS
+ * source element's period delta into a list of flow concepts via
+ * declared :class:`AttributionFilter` predicates. The renderer
+ * evaluates the filters against ledger LineItems at envelope-build
+ * time, emits one attributed fact per filter per period, and arbitrates
+ * any residual against the default change tag (Tier 1 fallback).
+ *
+ * Reads directly from the typed ``structures.artifact_mechanics`` JSONB
+ * column. ``attribution_filters`` rides as nested JSON; the predicate
+ * union widens as new predicate shapes ship (Phase 2 MVP carries only
+ * ``line_item_metadata_field``).
+ */
+export type RollforwardMechanics = {
+    /**
+     * Kind
+     */
+    kind?: 'rollforward';
+    /**
+     * Bs Source Element Id
+     *
+     * Element id of the balance-sheet source whose period delta this block decomposes. Resolved from ``bs_source_qname`` at create time.
+     */
+    bs_source_element_id: string;
+    /**
+     * Bs Source Qname
+     *
+     * QName of the BS source element (e.g. ``mini:CashAndCashEquivalents``). Round-tripped for caller convenience; ``bs_source_element_id`` is authoritative.
+     */
+    bs_source_qname: string;
+    /**
+     * Default Change Tag Element Id
+     *
+     * Element id of the Tier 1 default change tag — the fallback flow concept that receives any residual (Δ BS − Σ filter matches). Null when no default is declared; behavior on residual then follows ``validation_mode``.
+     */
+    default_change_tag_element_id?: string | null;
+    /**
+     * Default Change Tag Qname
+     *
+     * QName of the Tier 1 default change tag (e.g. ``rs-gaap:IncreaseDecreaseInCashAndCashEquivalents``). Round-tripped for caller convenience and operator-readable envelopes; ``default_change_tag_element_id`` is authoritative. Null iff ``default_change_tag_element_id`` is null.
+     */
+    default_change_tag_qname?: string | null;
+    /**
+     * Attribution Filters
+     *
+     * Filter predicates routing LineItems to flow concepts. The renderer evaluates each filter against the period's LineItems, aggregates signed amounts, and emits one fact per filter per period.
+     */
+    attribution_filters?: Array<AttributionFilter>;
+    /**
+     * Validation Mode
+     *
+     * Renderer arbitration policy when Σ filter matches != Δ BS. ``strict`` raises; ``residual_as_default`` emits the residual as a default-tag fact (the common case); ``warn_only`` logs and lets the imbalance pass.
+     */
+    validation_mode?: 'strict' | 'residual_as_default' | 'warn_only';
+};
+
 /**
  * RuleLite
  *
@@ -10677,7 +11013,7 @@ export type SecurityResponse = {
 /**
  * SelectionCriteria
  *
- * Criteria for agent selection.
+ * Criteria for operator selection.
  */
 export type SelectionCriteria = {
     /**
@@ -10689,13 +11025,13 @@ export type SelectionCriteria = {
     /**
      * Required Capabilities
      *
-     * Required agent capabilities
+     * Required operator capabilities
      */
     required_capabilities?: Array<string>;
     /**
      * Preferred execution mode
      */
-    preferred_mode?: AgentMode | null;
+    preferred_mode?: OperatorMode | null;
     /**
      * Max Response Time
      *
@@ -10703,11 +11039,11 @@ export type SelectionCriteria = {
      */
     max_response_time?: number;
     /**
-     * Excluded Agents
+     * Excluded Operators
      *
-     * Agents to exclude from selection
+     * Operators to exclude from selection
      */
-    excluded_agents?: Array<string>;
+    excluded_operators?: Array<string>;
 };
 
 /**
@@ -12424,6 +12760,12 @@ export type UpdateEventBlockRequest = {
     metadata_patch?: {
         [key: string]: unknown;
     };
+    /**
+     * Event Action
+     *
+     * Set or correct the canonical action verb. Unset = unchanged. Useful when an adapter improvement makes a previously-NULL verb fillable, or when reclassifying after the fact.
+     */
+    event_action?: 'produce' | 'raise' | 'consume' | 'lower' | 'use' | 'cite' | 'work' | 'deliverService' | 'pickup' | 'dropoff' | 'accept' | 'transferCustody' | 'transferAllRights' | 'transfer' | 'move' | 'modify' | 'combine' | 'separate' | 'copy' | null;
     /**
      * Obligated By Event Id
      *
@@ -12532,6 +12874,8 @@ export type UpdateEventHandlerRequest = {
 export type UpdateInformationBlockRequest = ({
     block_type: 'schedule';
 } & UpdateScheduleArm) | ({
+    block_type: 'rollforward';
+} & UpdateRollforwardArm) | ({
     block_type: 'balance_sheet' | 'cash_flow_statement' | 'comprehensive_income' | 'equity_statement' | 'income_statement' | 'metric';
 } & UpdateLegacyArm);
 
@@ -12679,6 +13023,52 @@ export type UpdatePublishListOperation = {
     list_id: string;
 };
 
+/**
+ * UpdateRollforwardRequest
+ *
+ * Update mutable fields on a rollforward block.
+ *
+ * Editable: name, default_change_tag_qname, attribution_filters,
+ * validation_mode. The BS source is fixed once the block is created
+ * (changing it would invalidate every previously rendered period); to
+ * change BS source, delete and re-create.
+ *
+ * **Partial-update semantics**: omitted (``None``) fields mean "leave
+ * unchanged" — there is no wire-level way to *clear* a previously set
+ * default change tag or empty the attribution_filters list via this
+ * endpoint. To remove the default tag entirely, delete and re-create
+ * the rollforward block. The asymmetry is deliberate: an explicit
+ * clear-sentinel adds wire-shape complexity for a use case that rarely
+ * arises in practice (default tags are typically set during initial
+ * authoring and only swapped, not removed).
+ */
+export type UpdateRollforwardRequest = {
+    /**
+     * Structure Id
+     *
+     * Structure ID of the rollforward block.
+     */
+    structure_id: string;
+    /**
+     * Name
+     */
+    name?: string | null;
+    /**
+     * Default Change Tag Qname
+     *
+     * New default change tag qname. Pass a value to *change* the default; omit (``None``) to leave unchanged. There is no wire-level way to clear a previously set default — see the class docstring.
+     */
+    default_change_tag_qname?: string | null;
+    /**
+     * Attribution Filters
+     */
+    attribution_filters?: Array<AttributionFilter> | null;
+    /**
+     * Validation Mode
+     */
+    validation_mode?: 'strict' | 'residual_as_default' | 'warn_only' | null;
+};
+
 /**
  * UpdateScheduleRequest
  *
@@ -13200,6 +13590,28 @@ export type CreateLegacyArm = {
     };
 };
 
+/**
+ * _CreateRollforwardArm
+ *
+ * Create-information-block body for ``block_type="rollforward"``.
+ *
+ * Carries a typed rollforward payload. The block decomposes the period
+ * change in a BS source element across the declared attribution
+ * filters.
+ */
+export type CreateRollforwardArm = {
+    /**
+     * Block Type
+     *
+     * Discriminator value selecting this arm.
+     */
+    block_type: 'rollforward';
+    /**
+     * Rollforward creation payload.
+     */
+    payload: CreateRollforwardRequest;
+};
+
 /**
  * _CreateScheduleArm
  *
@@ -13248,6 +13660,27 @@ export type DeleteLegacyArm = {
     };
 };
 
+/**
+ * _DeleteRollforwardArm
+ *
+ * Delete-information-block body for ``block_type="rollforward"``.
+ *
+ * Cascades through any synthetic facts produced by this block's filter
+ * evaluations. The underlying ledger LineItems are not touched.
+ */
+export type DeleteRollforwardArm = {
+    /**
+     * Block Type
+     *
+     * Discriminator value selecting this arm.
+     */
+    block_type: 'rollforward';
+    /**
+     * Rollforward delete payload.
+     */
+    payload: DeleteRollforwardRequest;
+};
+
 /**
  * _DeleteScheduleArm
  *
@@ -13295,6 +13728,27 @@ export type UpdateLegacyArm = {
     };
 };
 
+/**
+ * _UpdateRollforwardArm
+ *
+ * Update-information-block body for ``block_type="rollforward"``.
+ *
+ * Carries a typed rollforward update payload. Mutable fields: name,
+ * default_change_tag_qname, attribution_filters, validation_mode.
+ */
+export type UpdateRollforwardArm = {
+    /**
+     * Block Type
+     *
+     * Discriminator value selecting this arm.
+     */
+    block_type: 'rollforward';
+    /**
+     * Rollforward update payload.
+     */
+    payload: UpdateRollforwardRequest;
+};
+
 /**
  * _UpdateScheduleArm
  *
@@ -15317,7 +15771,7 @@ export type SyncConnectionResponses = {
 
 export type SyncConnectionResponse = SyncConnectionResponses[keyof SyncConnectionResponses];
 
-export type ListAgentsData = {
+export type ListOperatorsData = {
     body?: never;
     path: {
         /**
@@ -15333,10 +15787,10 @@ export type ListAgentsData = {
          */
         capability?: string | null;
     };
-    url: '/v1/graphs/{graph_id}/agent';
+    url: '/v1/graphs/{graph_id}/operator';
 };
 
-export type ListAgentsErrors = {
+export type ListOperatorsErrors = {
     /**
      * Invalid request
      */
@@ -15367,19 +15821,19 @@ export type ListAgentsErrors = {
     500: ErrorResponse;
 };
 
-export type ListAgentsError = ListAgentsErrors[keyof ListAgentsErrors];
+export type ListOperatorsError = ListOperatorsErrors[keyof ListOperatorsErrors];
 
-export type ListAgentsResponses = {
+export type ListOperatorsResponses = {
     /**
      * Successful Response
      */
-    200: AgentListResponse;
+    200: OperatorListResponse;
 };
 
-export type ListAgentsResponse = ListAgentsResponses[keyof ListAgentsResponses];
+export type ListOperatorsResponse = ListOperatorsResponses[keyof ListOperatorsResponses];
 
-export type AutoSelectAgentData = {
-    body: AgentRequest;
+export type AutoSelectOperatorData = {
+    body: OperatorRequest;
     path: {
         /**
          * Graph Id
@@ -15394,10 +15848,10 @@ export type AutoSelectAgentData = {
          */
         mode?: ResponseMode | null;
     };
-    url: '/v1/graphs/{graph_id}/agent';
+    url: '/v1/graphs/{graph_id}/operator';
 };
 
-export type AutoSelectAgentErrors = {
+export type AutoSelectOperatorErrors = {
     /**
      * Invalid request
      */
@@ -15432,22 +15886,22 @@ export type AutoSelectAgentErrors = {
     500: ErrorResponse;
 };
 
-export type AutoSelectAgentError = AutoSelectAgentErrors[keyof AutoSelectAgentErrors];
+export type AutoSelectOperatorError = AutoSelectOperatorErrors[keyof AutoSelectOperatorErrors];
 
-export type AutoSelectAgentResponses = {
+export type AutoSelectOperatorResponses = {
     /**
      * Successful Response
      */
-    200: AgentResponse;
+    200: OperatorResponse;
     /**
      * Query queued for async processing
      */
     202: unknown;
 };
 
-export type AutoSelectAgentResponse = AutoSelectAgentResponses[keyof AutoSelectAgentResponses];
+export type AutoSelectOperatorResponse = AutoSelectOperatorResponses[keyof AutoSelectOperatorResponses];
 
-export type GetAgentMetadataData = {
+export type GetOperatorMetadataData = {
     body?: never;
     path: {
         /**
@@ -15455,17 +15909,17 @@ export type GetAgentMetadataData = {
          */
         graph_id: string;
         /**
-         * Agent Type
+         * Operator Type
          *
-         * Agent type identifier (e.g., 'financial', 'research', 'rag')
+         * Operator type identifier (e.g., 'financial', 'research', 'rag')
          */
-        agent_type: string;
+        operator_type: string;
     };
     query?: never;
-    url: '/v1/graphs/{graph_id}/agent/{agent_type}';
+    url: '/v1/graphs/{graph_id}/operator/{operator_type}';
 };
 
-export type GetAgentMetadataErrors = {
+export type GetOperatorMetadataErrors = {
     /**
      * Invalid request
      */
@@ -15496,24 +15950,24 @@ export type GetAgentMetadataErrors = {
     500: ErrorResponse;
 };
 
-export type GetAgentMetadataError = GetAgentMetadataErrors[keyof GetAgentMetadataErrors];
+export type GetOperatorMetadataError = GetOperatorMetadataErrors[keyof GetOperatorMetadataErrors];
 
-export type GetAgentMetadataResponses = {
+export type GetOperatorMetadataResponses = {
     /**
      * Successful Response
      */
-    200: AgentMetadataResponse;
+    200: OperatorMetadataResponse;
 };
 
-export type GetAgentMetadataResponse = GetAgentMetadataResponses[keyof GetAgentMetadataResponses];
+export type GetOperatorMetadataResponse = GetOperatorMetadataResponses[keyof GetOperatorMetadataResponses];
 
-export type ExecuteSpecificAgentData = {
-    body: AgentRequest;
+export type ExecuteSpecificOperatorData = {
+    body: OperatorRequest;
     path: {
         /**
-         * Agent Type
+         * Operator Type
          */
-        agent_type: string;
+        operator_type: string;
         /**
          * Graph Id
          */
@@ -15527,10 +15981,10 @@ export type ExecuteSpecificAgentData = {
          */
         mode?: ResponseMode | null;
     };
-    url: '/v1/graphs/{graph_id}/agent/{agent_type}';
+    url: '/v1/graphs/{graph_id}/operator/{operator_type}';
 };
 
-export type ExecuteSpecificAgentErrors = {
+export type ExecuteSpecificOperatorErrors = {
     /**
      * Invalid request
      */
@@ -15565,23 +16019,23 @@ export type ExecuteSpecificAgentErrors = {
     500: ErrorResponse;
 };
 
-export type ExecuteSpecificAgentError = ExecuteSpecificAgentErrors[keyof ExecuteSpecificAgentErrors];
+export type ExecuteSpecificOperatorError = ExecuteSpecificOperatorErrors[keyof ExecuteSpecificOperatorErrors];
 
-export type ExecuteSpecificAgentResponses = {
+export type ExecuteSpecificOperatorResponses = {
     /**
      * Successful Response
      */
-    200: AgentResponse;
+    200: OperatorResponse;
     /**
      * Query queued for async processing
      */
     202: unknown;
 };
 
-export type ExecuteSpecificAgentResponse = ExecuteSpecificAgentResponses[keyof ExecuteSpecificAgentResponses];
+export type ExecuteSpecificOperatorResponse = ExecuteSpecificOperatorResponses[keyof ExecuteSpecificOperatorResponses];
 
 export type BatchProcessQueriesData = {
-    body: BatchAgentRequest;
+    body: BatchOperatorRequest;
     path: {
         /**
          * Graph Id
@@ -15589,7 +16043,7 @@ export type BatchProcessQueriesData = {
         graph_id: string;
     };
     query?: never;
-    url: '/v1/graphs/{graph_id}/agent/batch';
+    url: '/v1/graphs/{graph_id}/operator/batch';
 };
 
 export type BatchProcessQueriesErrors = {
@@ -15633,13 +16087,13 @@ export type BatchProcessQueriesResponses = {
     /**
      * Successful Response
      */
-    200: BatchAgentResponse;
+    200: BatchOperatorResponse;
 };
 
 export type BatchProcessQueriesResponse = BatchProcessQueriesResponses[keyof BatchProcessQueriesResponses];
 
-export type RecommendAgentData = {
-    body: AgentRecommendationRequest;
+export type RecommendOperatorData = {
+    body: OperatorRecommendationRequest;
     path: {
         /**
          * Graph Id
@@ -15647,10 +16101,10 @@ export type RecommendAgentData = {
         graph_id: string;
     };
     query?: never;
-    url: '/v1/graphs/{graph_id}/agent/recommend';
+    url: '/v1/graphs/{graph_id}/operator/recommend';
 };
 
-export type RecommendAgentErrors = {
+export type RecommendOperatorErrors = {
     /**
      * Invalid request
      */
@@ -15681,16 +16135,16 @@ export type RecommendAgentErrors = {
     500: ErrorResponse;
 };
 
-export type RecommendAgentError = RecommendAgentErrors[keyof RecommendAgentErrors];
+export type RecommendOperatorError = RecommendOperatorErrors[keyof RecommendOperatorErrors];
 
-export type RecommendAgentResponses = {
+export type RecommendOperatorResponses = {
     /**
      * Successful Response
      */
-    200: AgentRecommendationResponse;
+    200: OperatorRecommendationResponse;
 };
 
-export type RecommendAgentResponse = RecommendAgentResponses[keyof RecommendAgentResponses];
+export type RecommendOperatorResponse = RecommendOperatorResponses[keyof RecommendOperatorResponses];
 
 export type ListMcpToolsData = {
     body?: never;
@@ -20662,6 +21116,70 @@ export type OpUpdateEventBlockResponses = {
 
 export type OpUpdateEventBlockResponse = OpUpdateEventBlockResponses[keyof OpUpdateEventBlockResponses];
 
+export type OpExecuteEventBlockData = {
+    body: ExecuteEventBlockRequest;
+    headers?: {
+        /**
+         * Idempotency-Key
+         */
+        'Idempotency-Key'?: string | null;
+    };
+    path: {
+        /**
+         * Graph Id
+         */
+        graph_id: string;
+    };
+    query?: never;
+    url: '/extensions/roboledger/{graph_id}/operations/execute-event-block';
+};
+
+export type OpExecuteEventBlockErrors = {
+    /**
+     * Invalid request
+     */
+    400: ErrorResponse;
+    /**
+     * Authentication required
+     */
+    401: ErrorResponse;
+    /**
+     * Access denied
+     */
+    403: ErrorResponse;
+    /**
+     * Resource not found
+     */
+    404: ErrorResponse;
+    /**
+     * Idempotency-Key conflict — key reused with different body
+     */
+    409: ErrorResponse;
+    /**
+     * Validation error
+     */
+    422: ErrorResponse;
+    /**
+     * Rate limit exceeded
+     */
+    429: ErrorResponse;
+    /**
+     * Internal server error
+     */
+    500: ErrorResponse;
+};
+
+export type OpExecuteEventBlockError = OpExecuteEventBlockErrors[keyof OpExecuteEventBlockErrors];
+
+export type OpExecuteEventBlockResponses = {
+    /**
+     * Successful Response
+     */
+    200: OperationEnvelopeExecuteEventBlockResponse;
+};
+
+export type OpExecuteEventBlockResponse = OpExecuteEventBlockResponses[keyof OpExecuteEventBlockResponses];
+
 export type OpCreateEventHandlerData = {
     body: CreateEventHandlerRequest;
     headers?: {