@robosystems/client 0.3.27 → 0.3.29

package/types.gen.d.ts

@@ -114,759 +114,473 @@ export type AddPublishListMembersOperation = {
     list_id: string;
 };
 /**
- * AgentListResponse
+ * ArtifactResponse
  *
- * Response for listing available agents.
+ * The block's producible-artifact envelope — topic, template, mechanics.
  */
-export type AgentListResponse = {
-    /**
-     * Agents
-     *
-     * Dictionary of available agents with metadata
-     */
-    agents: {
-        [key: string]: {
-            [key: string]: unknown;
-        };
-    };
+export type ArtifactResponse = {
     /**
-     * Total
+     * Topic
      *
-     * Total number of agents
+     * Structure.description — the block's human-readable topic.
      */
-    total: number;
-};
-/**
- * AgentMessage
- *
- * Message in conversation history.
- */
-export type AgentMessage = {
+    topic?: string | null;
     /**
-     * Role
+     * Renderer Note
      *
-     * Message role (user/assistant)
+     * e.g. 'in thousands', 'except per share'.
      */
-    role: string;
+    renderer_note?: string | null;
     /**
-     * Content
+     * Template
      *
-     * Message content
+     * Reusable layout (ordering, subtotals, styling) when attached. First-class templates are not yet implemented; this field is always null on currently-shipped block types.
      */
-    content: string;
+    template?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Timestamp
-     *
-     * Message timestamp
+     * Mechanics
      */
-    timestamp?: string | null;
+    mechanics: ({
+        kind: 'closing_entry_generator';
+    } & ScheduleMechanics) | ({
+        kind: 'statement_renderer';
+    } & StatementMechanics) | ({
+        kind: 'metric';
+    } & MetricMechanics) | ({
+        kind: 'rollforward';
+    } & RollforwardMechanics);
 };
 /**
- * AgentMetadataResponse
+ * AssociationResponse
+ *
+ * One edge between two elements within a structure (parent/child
+ * presentation, calculation rollup, mapping, equivalence).
  *
- * Response for agent metadata.
+ * ``association_type`` discriminates the edge semantics. Mapping edges
+ * are the user-facing path (CoA → reporting concept); presentation /
+ * calculation edges express structure layout and roll-ups.
+ * ``confidence`` is set on AI-suggested mappings (≥0.90 auto-approved,
+ * 0.70-0.89 flagged for review).
  */
-export type AgentMetadataResponse = {
+export type AssociationResponse = {
     /**
-     * Name
-     *
-     * Agent name
+     * Id
      */
-    name: string;
+    id: string;
     /**
-     * Description
-     *
-     * Agent description
+     * Structure Id
      */
-    description: string;
+    structure_id: string;
     /**
-     * Version
-     *
-     * Agent version
+     * From Element Id
      */
-    version: string;
+    from_element_id: string;
     /**
-     * Capabilities
-     *
-     * Agent capabilities
+     * From Element Name
      */
-    capabilities: Array<string>;
+    from_element_name?: string | null;
     /**
-     * Supported Modes
-     *
-     * Supported execution modes
+     * From Element Qname
      */
-    supported_modes: Array<string>;
+    from_element_qname?: string | null;
     /**
-     * Requires Credits
-     *
-     * Whether agent requires credits
+     * To Element Id
      */
-    requires_credits: boolean;
+    to_element_id: string;
     /**
-     * Author
-     *
-     * Agent author
+     * To Element Name
      */
-    author?: string | null;
+    to_element_name?: string | null;
     /**
-     * Tags
-     *
-     * Agent tags
+     * To Element Qname
      */
-    tags?: Array<string>;
-};
-/**
- * AgentMode
- *
- * Agent execution modes.
- */
-export type AgentMode = 'quick' | 'standard' | 'extended' | 'streaming';
-/**
- * AgentRecommendation
- *
- * Single agent recommendation.
- */
-export type AgentRecommendation = {
+    to_element_qname?: string | null;
     /**
-     * Agent Type
-     *
-     * Agent type identifier
+     * Association Type
      */
-    agent_type: string;
+    association_type: string;
     /**
-     * Agent Name
-     *
-     * Agent display name
+     * Order Value
+     */
+    order_value?: number | null;
+    /**
+     * Weight
      */
-    agent_name: string;
+    weight?: number | null;
     /**
      * Confidence
-     *
-     * Confidence score (0-1)
      */
-    confidence: number;
+    confidence?: number | null;
     /**
-     * Capabilities
-     *
-     * Agent capabilities
+     * Suggested By
      */
-    capabilities: Array<string>;
+    suggested_by?: string | null;
     /**
-     * Reason
-     *
-     * Reason for recommendation
+     * Approved By
      */
-    reason?: string | null;
+    approved_by?: string | null;
 };
 /**
- * AgentRecommendationRequest
+ * 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.
  *
- * Request for agent recommendations.
+ * ``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 AgentRecommendationRequest = {
+export type AttributionFilter = {
     /**
-     * Query
+     * Target Qname
      *
-     * Query to analyze
+     * QName of the flow concept this filter produces facts for — e.g. ``rs-gaap:ProceedsFromIssuanceOfCommonStock``. Resolved to ``target_element_id`` at create time.
      */
-    query: string;
+    target_qname: string;
     /**
-     * Context
+     * Target Element Id
      *
-     * Additional context
+     * Resolved element id for ``target_qname``. Null at create time; populated by the handler before persistence. Round-tripped in the envelope.
      */
-    context?: {
-        [key: string]: unknown;
-    } | null;
+    target_element_id?: string | null;
+    /**
+     * Predicate that determines which LineItems match this filter.
+     */
+    predicate: LineItemMetadataPredicate;
 };
 /**
- * AgentRecommendationResponse
+ * AuthResponse
  *
- * Response for agent recommendations.
+ * Authentication response model.
  */
-export type AgentRecommendationResponse = {
+export type AuthResponse = {
     /**
-     * Recommendations
+     * User
      *
-     * List of agent recommendations sorted by confidence
+     * User information
      */
-    recommendations: Array<AgentRecommendation>;
+    user: {
+        [key: string]: unknown;
+    };
     /**
-     * Query
+     * Org
      *
-     * The analyzed query
+     * Organization information (personal org created automatically on registration)
      */
-    query: string;
-};
-/**
- * AgentRequest
- *
- * Request model for agent interactions.
- */
-export type AgentRequest = {
+    org?: {
+        [key: string]: unknown;
+    } | null;
     /**
      * Message
      *
-     * The query or message to process
+     * Success message
      */
     message: string;
     /**
-     * History
+     * Token
      *
-     * Conversation history
+     * JWT authentication token (optional for cookie-based auth)
      */
-    history?: Array<AgentMessage>;
+    token?: string | null;
     /**
-     * Context
+     * Expires In
      *
-     * Additional context for analysis (e.g., enable_rag, include_schema)
+     * Token expiry time in seconds from now
      */
-    context?: {
-        [key: string]: unknown;
-    } | null;
+    expires_in?: number | null;
     /**
-     * Execution mode
+     * Refresh Threshold
+     *
+     * Recommended refresh threshold in seconds before expiry
      */
-    mode?: AgentMode | null;
+    refresh_threshold?: number | null;
+};
+/**
+ * AutoMapElementsOperation
+ *
+ * Run the MappingOperator over a mapping structure (async).
+ *
+ * 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.
+ * Returns a `pending` envelope immediately; subscribe to the SSE stream
+ * for progress.
+ */
+export type AutoMapElementsOperation = {
     /**
-     * Agent Type
+     * Mapping Id
      *
-     * Specific agent type to use (optional)
+     * The mapping structure to populate.
      */
-    agent_type?: string | null;
+    mapping_id: string;
+};
+/**
+ * AvailableExtension
+ */
+export type AvailableExtension = {
     /**
-     * Criteria for agent selection
+     * Name
      */
-    selection_criteria?: SelectionCriteria | null;
+    name: string;
     /**
-     * Force Extended Analysis
-     *
-     * Force extended analysis mode with comprehensive research
+     * Description
      */
-    force_extended_analysis?: boolean;
+    description: string;
     /**
-     * Enable Rag
-     *
-     * Enable RAG context enrichment
+     * Enabled
      */
-    enable_rag?: boolean;
+    enabled?: boolean;
+};
+/**
+ * AvailableExtensionsResponse
+ */
+export type AvailableExtensionsResponse = {
     /**
-     * Stream
-     *
-     * Enable streaming response
+     * Extensions
      */
-    stream?: boolean;
+    extensions: Array<AvailableExtension>;
 };
 /**
- * AgentResponse
+ * AvailableGraphTiersResponse
  *
- * Response model for agent interactions.
+ * Response containing available graph tiers.
  */
-export type AgentResponse = {
+export type AvailableGraphTiersResponse = {
     /**
-     * Content
+     * Tiers
      *
-     * The agent's response content
+     * List of available tiers
      */
-    content: string;
+    tiers: Array<GraphTierInfo>;
+};
+/**
+ * BackupCreateRequest
+ *
+ * Request model for creating a backup.
+ */
+export type BackupCreateRequest = {
     /**
-     * Agent Used
+     * Backup Format
      *
-     * The agent type that handled the request
+     * Backup format - only 'full_dump' is supported (complete .lbug database file)
      */
-    agent_used: string;
+    backup_format?: string;
     /**
-     * The execution mode used
+     * Backup Type
+     *
+     * Backup type - only 'full' is supported
      */
-    mode_used: AgentMode;
+    backup_type?: string;
     /**
-     * Metadata
+     * Retention Days
      *
-     * Response metadata including routing info
+     * Retention period in days
      */
-    metadata?: {
-        [key: string]: unknown;
-    } | null;
+    retention_days?: number;
     /**
-     * Tokens Used
+     * Compression
      *
-     * Token usage statistics
+     * Enable compression (always enabled for optimal storage)
      */
-    tokens_used?: {
-        [key: string]: number;
-    } | null;
+    compression?: boolean;
     /**
-     * Confidence Score
+     * Encryption
      *
-     * Confidence score of the response (0.0-1.0 scale)
+     * Enable encryption (encrypted backups cannot be downloaded)
      */
-    confidence_score?: number | null;
+    encryption?: boolean;
     /**
-     * Operation Id
+     * Schedule
      *
-     * Operation ID for SSE monitoring
+     * Optional cron schedule for automated backups
      */
-    operation_id?: string | null;
+    schedule?: string | null;
+};
+/**
+ * BackupDownloadUrlResponse
+ *
+ * Response model for backup download URL generation.
+ */
+export type BackupDownloadUrlResponse = {
     /**
-     * Is Partial
+     * Download Url
      *
-     * Whether this is a partial response
+     * Pre-signed S3 URL for downloading the backup file
      */
-    is_partial?: boolean;
+    download_url: string;
     /**
-     * Error Details
+     * Expires In
      *
-     * Error details if any
+     * URL expiration time in seconds from now
      */
-    error_details?: {
-        [key: string]: unknown;
-    } | null;
+    expires_in: number;
     /**
-     * Execution Time
+     * Expires At
      *
-     * Execution time in seconds
+     * Unix timestamp when the URL expires
      */
-    execution_time?: number | null;
+    expires_at: number;
     /**
-     * Timestamp
+     * Backup Id
      *
-     * Response timestamp
+     * Backup identifier
      */
-    timestamp?: string;
+    backup_id: string;
+    /**
+     * Graph Id
+     *
+     * Graph database identifier
+     */
+    graph_id: string;
 };
 /**
- * ArtifactResponse
+ * BackupLimits
  *
- * The block's producible-artifact envelope — topic, template, mechanics.
+ * Backup operation limits.
  */
-export type ArtifactResponse = {
+export type BackupLimits = {
     /**
-     * Topic
+     * Max Backup Size Gb
      *
-     * Structure.description — the block's human-readable topic.
+     * Maximum backup size in GB
      */
-    topic?: string | null;
+    max_backup_size_gb: number;
     /**
-     * Renderer Note
+     * Backup Retention Days
      *
-     * e.g. 'in thousands', 'except per share'.
+     * Backup retention period in days
      */
-    renderer_note?: string | null;
+    backup_retention_days: number;
     /**
-     * Template
+     * Max Backups Per Day
      *
-     * Reusable layout (ordering, subtotals, styling) when attached. First-class templates are not yet implemented; this field is always null on currently-shipped block types.
-     */
-    template?: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Mechanics
+     * Maximum backups per day
      */
-    mechanics: ({
-        kind: 'closing_entry_generator';
-    } & ScheduleMechanics) | ({
-        kind: 'statement_renderer';
-    } & StatementMechanics) | ({
-        kind: 'metric';
-    } & MetricMechanics);
+    max_backups_per_day: number;
 };
 /**
- * AssociationResponse
- *
- * One edge between two elements within a structure (parent/child
- * presentation, calculation rollup, mapping, equivalence).
+ * BackupListResponse
  *
- * ``association_type`` discriminates the edge semantics. Mapping edges
- * are the user-facing path (CoA → reporting concept); presentation /
- * calculation edges express structure layout and roll-ups.
- * ``confidence`` is set on AI-suggested mappings (≥0.90 auto-approved,
- * 0.70-0.89 flagged for review).
+ * Response model for backup list.
  */
-export type AssociationResponse = {
+export type BackupListResponse = {
     /**
-     * Id
+     * Backups
      */
-    id: string;
+    backups: Array<BackupResponse>;
     /**
-     * Structure Id
+     * Total Count
      */
-    structure_id: string;
+    total_count: number;
     /**
-     * From Element Id
+     * Graph Id
      */
-    from_element_id: string;
+    graph_id: string;
     /**
-     * From Element Name
+     * Is Shared Repository
+     *
+     * Whether this is a shared repository (limits apply)
      */
-    from_element_name?: string | null;
+    is_shared_repository?: boolean;
     /**
-     * From Element Qname
+     * Download quota for shared repositories
      */
-    from_element_qname?: string | null;
+    download_quota?: DownloadQuota | null;
+};
+/**
+ * BackupResponse
+ *
+ * Response model for backup information.
+ */
+export type BackupResponse = {
     /**
-     * To Element Id
+     * Backup Id
      */
-    to_element_id: string;
+    backup_id: string;
     /**
-     * To Element Name
+     * Graph Id
      */
-    to_element_name?: string | null;
+    graph_id: string;
     /**
-     * To Element Qname
+     * Backup Format
      */
-    to_element_qname?: string | null;
+    backup_format: string;
     /**
-     * Association Type
+     * Backup Type
      */
-    association_type: string;
+    backup_type: string;
     /**
-     * Order Value
+     * Status
      */
-    order_value?: number | null;
+    status: string;
     /**
-     * Weight
+     * Original Size Bytes
      */
-    weight?: number | null;
+    original_size_bytes: number;
     /**
-     * Confidence
+     * Compressed Size Bytes
      */
-    confidence?: number | null;
+    compressed_size_bytes: number;
     /**
-     * Suggested By
+     * Compression Ratio
      */
-    suggested_by?: string | null;
+    compression_ratio: number;
     /**
-     * Approved By
+     * Node Count
      */
-    approved_by?: string | null;
-};
-/**
- * AuthResponse
- *
- * Authentication response model.
- */
-export type AuthResponse = {
+    node_count: number;
     /**
-     * User
-     *
-     * User information
+     * Relationship Count
      */
-    user: {
-        [key: string]: unknown;
-    };
+    relationship_count: number;
     /**
-     * Org
-     *
-     * Organization information (personal org created automatically on registration)
+     * Backup Duration Seconds
      */
-    org?: {
-        [key: string]: unknown;
-    } | null;
+    backup_duration_seconds: number;
     /**
-     * Message
-     *
-     * Success message
+     * Encryption Enabled
      */
-    message: string;
+    encryption_enabled: boolean;
     /**
-     * Token
-     *
-     * JWT authentication token (optional for cookie-based auth)
+     * Compression Enabled
      */
-    token?: string | null;
+    compression_enabled: boolean;
     /**
-     * Expires In
-     *
-     * Token expiry time in seconds from now
+     * Allow Export
      */
-    expires_in?: number | null;
+    allow_export: boolean;
     /**
-     * Refresh Threshold
-     *
-     * Recommended refresh threshold in seconds before expiry
+     * Created At
      */
-    refresh_threshold?: number | null;
-};
-/**
- * AutoMapElementsOperation
- *
- * Run the MappingAgent over a mapping structure (async).
- *
- * The MappingAgent 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.
- * Returns a `pending` envelope immediately; subscribe to the SSE stream
- * for progress.
- */
-export type AutoMapElementsOperation = {
+    created_at: string;
     /**
-     * Mapping Id
-     *
-     * The mapping structure to populate.
+     * Completed At
      */
-    mapping_id: string;
+    completed_at: string | null;
+    /**
+     * Expires At
+     */
+    expires_at: string | null;
 };
 /**
- * AvailableExtension
+ * BackupStatsResponse
+ *
+ * Response model for backup statistics.
  */
-export type AvailableExtension = {
+export type BackupStatsResponse = {
     /**
-     * Name
+     * Graph Id
      */
-    name: string;
-    /**
-     * Description
-     */
-    description: string;
-    /**
-     * Enabled
-     */
-    enabled?: boolean;
-};
-/**
- * AvailableExtensionsResponse
- */
-export type AvailableExtensionsResponse = {
-    /**
-     * Extensions
-     */
-    extensions: Array<AvailableExtension>;
-};
-/**
- * AvailableGraphTiersResponse
- *
- * Response containing available graph tiers.
- */
-export type AvailableGraphTiersResponse = {
-    /**
-     * Tiers
-     *
-     * List of available tiers
-     */
-    tiers: Array<GraphTierInfo>;
-};
-/**
- * BackupCreateRequest
- *
- * Request model for creating a backup.
- */
-export type BackupCreateRequest = {
-    /**
-     * Backup Format
-     *
-     * Backup format - only 'full_dump' is supported (complete .lbug database file)
-     */
-    backup_format?: string;
-    /**
-     * Backup Type
-     *
-     * Backup type - only 'full' is supported
-     */
-    backup_type?: string;
-    /**
-     * Retention Days
-     *
-     * Retention period in days
-     */
-    retention_days?: number;
-    /**
-     * Compression
-     *
-     * Enable compression (always enabled for optimal storage)
-     */
-    compression?: boolean;
-    /**
-     * Encryption
-     *
-     * Enable encryption (encrypted backups cannot be downloaded)
-     */
-    encryption?: boolean;
-    /**
-     * Schedule
-     *
-     * Optional cron schedule for automated backups
-     */
-    schedule?: string | null;
-};
-/**
- * BackupDownloadUrlResponse
- *
- * Response model for backup download URL generation.
- */
-export type BackupDownloadUrlResponse = {
-    /**
-     * Download Url
-     *
-     * Pre-signed S3 URL for downloading the backup file
-     */
-    download_url: string;
-    /**
-     * Expires In
-     *
-     * URL expiration time in seconds from now
-     */
-    expires_in: number;
-    /**
-     * Expires At
-     *
-     * Unix timestamp when the URL expires
-     */
-    expires_at: number;
-    /**
-     * Backup Id
-     *
-     * Backup identifier
-     */
-    backup_id: string;
-    /**
-     * Graph Id
-     *
-     * Graph database identifier
-     */
-    graph_id: string;
-};
-/**
- * BackupLimits
- *
- * Backup operation limits.
- */
-export type BackupLimits = {
-    /**
-     * Max Backup Size Gb
-     *
-     * Maximum backup size in GB
-     */
-    max_backup_size_gb: number;
-    /**
-     * Backup Retention Days
-     *
-     * Backup retention period in days
-     */
-    backup_retention_days: number;
-    /**
-     * Max Backups Per Day
-     *
-     * Maximum backups per day
-     */
-    max_backups_per_day: number;
-};
-/**
- * BackupListResponse
- *
- * Response model for backup list.
- */
-export type BackupListResponse = {
-    /**
-     * Backups
-     */
-    backups: Array<BackupResponse>;
-    /**
-     * Total Count
-     */
-    total_count: number;
-    /**
-     * Graph Id
-     */
-    graph_id: string;
-    /**
-     * Is Shared Repository
-     *
-     * Whether this is a shared repository (limits apply)
-     */
-    is_shared_repository?: boolean;
-    /**
-     * Download quota for shared repositories
-     */
-    download_quota?: DownloadQuota | null;
-};
-/**
- * BackupResponse
- *
- * Response model for backup information.
- */
-export type BackupResponse = {
-    /**
-     * Backup Id
-     */
-    backup_id: string;
-    /**
-     * Graph Id
-     */
-    graph_id: string;
-    /**
-     * Backup Format
-     */
-    backup_format: string;
-    /**
-     * Backup Type
-     */
-    backup_type: string;
-    /**
-     * Status
-     */
-    status: string;
-    /**
-     * Original Size Bytes
-     */
-    original_size_bytes: number;
-    /**
-     * Compressed Size Bytes
-     */
-    compressed_size_bytes: number;
-    /**
-     * Compression Ratio
-     */
-    compression_ratio: number;
-    /**
-     * Node Count
-     */
-    node_count: number;
-    /**
-     * Relationship Count
-     */
-    relationship_count: number;
-    /**
-     * Backup Duration Seconds
-     */
-    backup_duration_seconds: number;
-    /**
-     * Encryption Enabled
-     */
-    encryption_enabled: boolean;
-    /**
-     * Compression Enabled
-     */
-    compression_enabled: boolean;
-    /**
-     * Allow Export
-     */
-    allow_export: boolean;
-    /**
-     * Created At
-     */
-    created_at: string;
-    /**
-     * Completed At
-     */
-    completed_at: string | null;
-    /**
-     * Expires At
-     */
-    expires_at: string | null;
-};
-/**
- * BackupStatsResponse
- *
- * Response model for backup statistics.
- */
-export type BackupStatsResponse = {
-    /**
-     * Graph Id
-     */
-    graph_id: string;
+    graph_id: string;
     /**
      * Total Backups
      */
@@ -911,17 +625,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
      *
@@ -930,17 +644,17 @@ export type BatchAgentRequest = {
     parallel?: boolean;
 };
 /**
- * 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
      *
@@ -1732,6 +1446,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
      *
@@ -1984,6 +1704,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);
 /**
@@ -1993,7 +1715,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 = {
@@ -2115,7 +1837,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;
     /**
@@ -2169,7 +1891,56 @@ export type CreateRepositorySubscriptionRequest = {
     plan_name: string;
 };
 /**
- * CreateScheduleRequest
+ * 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
  */
 export type CreateScheduleRequest = {
     /**
@@ -2979,6 +2750,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);
 /**
@@ -3141,6 +2914,23 @@ 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
  *
@@ -4093,6 +3883,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
      *
@@ -4237,6 +4033,68 @@ 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
  *
@@ -6034,6 +5892,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;
 };
 /**
  * JournalEntryLineItemResponse
@@ -6387,6 +6253,41 @@ 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
  *
@@ -6713,217 +6614,489 @@ export type MetricMechanics = {
  */
 export type OAuthCallbackRequest = {
     /**
-     * Code
+     * Code
+     *
+     * Authorization code from OAuth provider
+     */
+    code: string;
+    /**
+     * State
+     *
+     * OAuth state for verification
+     */
+    state: string;
+    /**
+     * Realm Id
+     *
+     * QuickBooks-specific realm ID
+     */
+    realm_id?: string | null;
+    /**
+     * Error
+     *
+     * OAuth error if authorization failed
+     */
+    error?: string | null;
+    /**
+     * Error Description
+     *
+     * OAuth error details
+     */
+    error_description?: string | null;
+};
+/**
+ * OAuthInitRequest
+ *
+ * Request to initiate OAuth flow.
+ */
+export type OAuthInitRequest = {
+    /**
+     * Connection Id
+     *
+     * Connection ID to link OAuth to
+     */
+    connection_id: string;
+    /**
+     * Redirect Uri
+     *
+     * Override default redirect URI
+     */
+    redirect_uri?: string | null;
+    /**
+     * Additional Params
+     *
+     * Provider-specific parameters
+     */
+    additional_params?: {
+        [key: string]: string;
+    } | null;
+};
+/**
+ * OAuthInitResponse
+ *
+ * Response with OAuth authorization URL.
+ */
+export type OAuthInitResponse = {
+    /**
+     * Auth Url
+     *
+     * URL to redirect user for authorization
+     */
+    auth_url: string;
+    /**
+     * State
+     *
+     * OAuth state for security
+     */
+    state: string;
+    /**
+     * Expires At
+     *
+     * When this OAuth request expires
+     */
+    expires_at: string;
+};
+/**
+ * OfferingRepositoryPlan
+ *
+ * Information about a repository plan.
+ */
+export type OfferingRepositoryPlan = {
+    /**
+     * Plan
+     *
+     * Plan identifier
+     */
+    plan: string;
+    /**
+     * Name
+     *
+     * Plan name
+     */
+    name: string;
+    /**
+     * Monthly Price
+     *
+     * Monthly price in USD
+     */
+    monthly_price: number;
+    /**
+     * Monthly Credits
+     *
+     * Monthly credit allocation
+     */
+    monthly_credits: number;
+    /**
+     * Access Level
+     *
+     * Access level
+     */
+    access_level: string;
+    /**
+     * Features
+     *
+     * List of features
+     */
+    features: Array<string>;
+    /**
+     * Rate Limits
+     *
+     * Rate limits for this plan
+     */
+    rate_limits?: {
+        [key: string]: number | null;
+    } | null;
+};
+/**
+ * OperationCosts
+ *
+ * Operation cost information.
+ */
+export type OperationCosts = {
+    /**
+     * Description
+     *
+     * Description of operation costs
+     */
+    description: string;
+    /**
+     * Ai Operations
+     *
+     * Base costs for AI operations
+     */
+    ai_operations: {
+        [key: string]: number;
+    };
+    /**
+     * Token Pricing
+     *
+     * Token pricing by model
+     */
+    token_pricing: {
+        [key: string]: TokenPricing;
+    };
+    /**
+     * Included Operations
+     *
+     * Operations that don't consume credits
+     */
+    included_operations: Array<string>;
+    /**
+     * Notes
+     *
+     * Important notes about costs
+     */
+    notes: Array<string>;
+};
+/**
+ * OperationEnvelope
+ *
+ * Uniform response shape for every operation endpoint.
+ *
+ * Every dispatch through an operation surface returns an envelope carrying
+ * an ``op_<ULID>`` operation_id.  That id is the bridge to the platform's
+ * monitoring surface: pass it to
+ * ``GET /v1/operations/{operation_id}/stream`` (see ``routers/operations.py``)
+ * to subscribe to SSE progress events.  Sync commands complete in the
+ * envelope itself; async commands (``status: "pending"``, HTTP 202) hand
+ * off to a background worker and stream their tail through the same SSE
+ * endpoint until completion.  Failed dispatches still mint an
+ * ``operation_id`` so the audit log and any partial SSE events stay
+ * correlatable.
+ *
+ * ``TResult`` parameterizes the ``result`` field so per-op response shapes
+ * surface in OpenAPI. Operations that pin ``OperationSpec.result_type`` get
+ * ``OperationEnvelope[YourEnvelope]`` as their response model; ops that
+ * don't keep the default ``Any`` shape (`result: any | null` on the wire).
+ *
+ * Fields:
+ * - ``operation``: kebab-case command name (e.g. ``close-period``)
+ * - ``operation_id``: ``op_``-prefixed ULID; always present, usable for
+ * audit correlation and — for async commands — SSE subscription via
+ * ``/v1/operations/{operation_id}/stream``
+ * - ``status``: ``"completed"`` (sync, HTTP 200), ``"pending"``
+ * (async, HTTP 202), or ``"failed"`` (error responses)
+ * - ``result``: the domain-specific payload (the original Pydantic
+ * response) or ``None`` for async/failed cases
+ * - ``at``: ISO-8601 UTC timestamp of when the envelope was minted
+ * - ``created_by``: user ID of the caller who initiated this operation
+ * - ``idempotent_replay``: ``True`` when the dispatcher returned this
+ * envelope from the idempotency cache (the underlying command did NOT
+ * execute again)
+ */
+export type OperationEnvelope = {
+    /**
+     * 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';
+    /**
+     * Result
+     *
+     * Command-specific result payload
+     */
+    result?: unknown | 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[AssociationResponse]
+ */
+export type OperationEnvelopeAssociationResponse = {
+    /**
+     * 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?: AssociationResponse | 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[ClosePeriodResponse]
+ */
+export type OperationEnvelopeClosePeriodResponse = {
+    /**
+     * Operation
+     *
+     * Kebab-case operation name
+     */
+    operation: string;
+    /**
+     * Operationid
      *
-     * Authorization code from OAuth provider
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    code: string;
+    operationId: string;
     /**
-     * State
+     * Status
      *
-     * OAuth state for verification
+     * Operation lifecycle state
      */
-    state: string;
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Realm Id
+     * Command-specific result payload
+     */
+    result?: ClosePeriodResponse | null;
+    /**
+     * At
      *
-     * QuickBooks-specific realm ID
+     * ISO-8601 UTC timestamp
      */
-    realm_id?: string | null;
+    at: string;
     /**
-     * Error
+     * Createdby
      *
-     * OAuth error if authorization failed
+     * User ID that initiated the operation (null for legacy callers)
      */
-    error?: string | null;
+    createdBy?: string | null;
     /**
-     * Error Description
+     * Idempotentreplay
      *
-     * OAuth error details
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
      */
-    error_description?: string | null;
+    idempotentReplay?: boolean;
 };
 /**
- * OAuthInitRequest
- *
- * Request to initiate OAuth flow.
+ * OperationEnvelope[DeleteInformationBlockResponse]
  */
-export type OAuthInitRequest = {
+export type OperationEnvelopeDeleteInformationBlockResponse = {
     /**
-     * Connection Id
+     * Operation
      *
-     * Connection ID to link OAuth to
+     * Kebab-case operation name
      */
-    connection_id: string;
+    operation: string;
     /**
-     * Redirect Uri
+     * Operationid
      *
-     * Override default redirect URI
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    redirect_uri?: string | null;
+    operationId: string;
     /**
-     * Additional Params
+     * Status
      *
-     * Provider-specific parameters
+     * Operation lifecycle state
      */
-    additional_params?: {
-        [key: string]: string;
-    } | null;
-};
-/**
- * OAuthInitResponse
- *
- * Response with OAuth authorization URL.
- */
-export type OAuthInitResponse = {
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Auth Url
+     * Command-specific result payload
+     */
+    result?: DeleteInformationBlockResponse | null;
+    /**
+     * At
      *
-     * URL to redirect user for authorization
+     * ISO-8601 UTC timestamp
      */
-    auth_url: string;
+    at: string;
     /**
-     * State
+     * Createdby
      *
-     * OAuth state for security
+     * User ID that initiated the operation (null for legacy callers)
      */
-    state: string;
+    createdBy?: string | null;
     /**
-     * Expires At
+     * Idempotentreplay
      *
-     * When this OAuth request expires
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
      */
-    expires_at: string;
+    idempotentReplay?: boolean;
 };
 /**
- * OfferingRepositoryPlan
- *
- * Information about a repository plan.
+ * OperationEnvelope[DeletePortfolioBlockResponse]
  */
-export type OfferingRepositoryPlan = {
+export type OperationEnvelopeDeletePortfolioBlockResponse = {
     /**
-     * Plan
+     * Operation
      *
-     * Plan identifier
+     * Kebab-case operation name
      */
-    plan: string;
+    operation: string;
     /**
-     * Name
+     * Operationid
      *
-     * Plan name
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    name: string;
+    operationId: string;
     /**
-     * Monthly Price
+     * Status
      *
-     * Monthly price in USD
+     * Operation lifecycle state
      */
-    monthly_price: number;
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Monthly Credits
-     *
-     * Monthly credit allocation
+     * Command-specific result payload
      */
-    monthly_credits: number;
+    result?: DeletePortfolioBlockResponse | null;
     /**
-     * Access Level
+     * At
      *
-     * Access level
+     * ISO-8601 UTC timestamp
      */
-    access_level: string;
+    at: string;
     /**
-     * Features
+     * Createdby
      *
-     * List of features
+     * User ID that initiated the operation (null for legacy callers)
      */
-    features: Array<string>;
+    createdBy?: string | null;
     /**
-     * Rate Limits
+     * Idempotentreplay
      *
-     * Rate limits for this plan
+     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
      */
-    rate_limits?: {
-        [key: string]: number | null;
-    } | null;
+    idempotentReplay?: boolean;
 };
 /**
- * OperationCosts
- *
- * Operation cost information.
+ * OperationEnvelope[DeleteResult]
  */
-export type OperationCosts = {
+export type OperationEnvelopeDeleteResult = {
     /**
-     * Description
+     * Operation
      *
-     * Description of operation costs
+     * Kebab-case operation name
      */
-    description: string;
+    operation: string;
     /**
-     * Ai Operations
+     * Operationid
      *
-     * Base costs for AI operations
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    ai_operations: {
-        [key: string]: number;
-    };
+    operationId: string;
     /**
-     * Token Pricing
+     * Status
      *
-     * Token pricing by model
+     * Operation lifecycle state
      */
-    token_pricing: {
-        [key: string]: TokenPricing;
-    };
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Included Operations
+     * Command-specific result payload
+     */
+    result?: DeleteResult | null;
+    /**
+     * At
      *
-     * Operations that don't consume credits
+     * ISO-8601 UTC timestamp
      */
-    included_operations: Array<string>;
+    at: string;
     /**
-     * Notes
+     * Createdby
      *
-     * Important notes about costs
+     * User ID that initiated the operation (null for legacy callers)
      */
-    notes: Array<string>;
+    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
- *
- * Uniform response shape for every operation endpoint.
- *
- * Every dispatch through an operation surface returns an envelope carrying
- * an ``op_<ULID>`` operation_id.  That id is the bridge to the platform's
- * monitoring surface: pass it to
- * ``GET /v1/operations/{operation_id}/stream`` (see ``routers/operations.py``)
- * to subscribe to SSE progress events.  Sync commands complete in the
- * envelope itself; async commands (``status: "pending"``, HTTP 202) hand
- * off to a background worker and stream their tail through the same SSE
- * endpoint until completion.  Failed dispatches still mint an
- * ``operation_id`` so the audit log and any partial SSE events stay
- * correlatable.
- *
- * ``TResult`` parameterizes the ``result`` field so per-op response shapes
- * surface in OpenAPI. Operations that pin ``OperationSpec.result_type`` get
- * ``OperationEnvelope[YourEnvelope]`` as their response model; ops that
- * don't keep the default ``Any`` shape (`result: any | null` on the wire).
- *
- * Fields:
- * - ``operation``: kebab-case command name (e.g. ``close-period``)
- * - ``operation_id``: ``op_``-prefixed ULID; always present, usable for
- * audit correlation and — for async commands — SSE subscription via
- * ``/v1/operations/{operation_id}/stream``
- * - ``status``: ``"completed"`` (sync, HTTP 200), ``"pending"``
- * (async, HTTP 202), or ``"failed"`` (error responses)
- * - ``result``: the domain-specific payload (the original Pydantic
- * response) or ``None`` for async/failed cases
- * - ``at``: ISO-8601 UTC timestamp of when the envelope was minted
- * - ``created_by``: user ID of the caller who initiated this operation
- * - ``idempotent_replay``: ``True`` when the dispatcher returned this
- * envelope from the idempotency cache (the underlying command did NOT
- * execute again)
+ * OperationEnvelope[DeleteTaxonomyBlockResponse]
  */
-export type OperationEnvelope = {
+export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     /**
      * Operation
      *
@@ -6943,11 +7116,9 @@ export type OperationEnvelope = {
      */
     status: 'completed' | 'pending' | 'failed';
     /**
-     * Result
-     *
      * Command-specific result payload
      */
-    result?: unknown | null;
+    result?: DeleteTaxonomyBlockResponse | null;
     /**
      * At
      *
@@ -6968,9 +7139,9 @@ export type OperationEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[AssociationResponse]
+ * OperationEnvelope[EntityTaxonomyResponse]
  */
-export type OperationEnvelopeAssociationResponse = {
+export type OperationEnvelopeEntityTaxonomyResponse = {
     /**
      * Operation
      *
@@ -6992,7 +7163,7 @@ export type OperationEnvelopeAssociationResponse = {
     /**
      * Command-specific result payload
      */
-    result?: AssociationResponse | null;
+    result?: EntityTaxonomyResponse | null;
     /**
      * At
      *
@@ -7013,9 +7184,9 @@ export type OperationEnvelopeAssociationResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[ClosePeriodResponse]
+ * OperationEnvelope[EvaluateRulesResponse]
  */
-export type OperationEnvelopeClosePeriodResponse = {
+export type OperationEnvelopeEvaluateRulesResponse = {
     /**
      * Operation
      *
@@ -7037,7 +7208,7 @@ export type OperationEnvelopeClosePeriodResponse = {
     /**
      * Command-specific result payload
      */
-    result?: ClosePeriodResponse | null;
+    result?: EvaluateRulesResponse | null;
     /**
      * At
      *
@@ -7058,9 +7229,9 @@ export type OperationEnvelopeClosePeriodResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteInformationBlockResponse]
+ * OperationEnvelope[EventBlockEnvelope]
  */
-export type OperationEnvelopeDeleteInformationBlockResponse = {
+export type OperationEnvelopeEventBlockEnvelope = {
     /**
      * Operation
      *
@@ -7082,7 +7253,7 @@ export type OperationEnvelopeDeleteInformationBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteInformationBlockResponse | null;
+    result?: EventBlockEnvelope | null;
     /**
      * At
      *
@@ -7103,9 +7274,9 @@ export type OperationEnvelopeDeleteInformationBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeletePortfolioBlockResponse]
+ * OperationEnvelope[EventHandlerResponse]
  */
-export type OperationEnvelopeDeletePortfolioBlockResponse = {
+export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Operation
      *
@@ -7127,7 +7298,7 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeletePortfolioBlockResponse | null;
+    result?: EventHandlerResponse | null;
     /**
      * At
      *
@@ -7148,9 +7319,9 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteResult]
+ * OperationEnvelope[ExecuteEventBlockResponse]
  */
-export type OperationEnvelopeDeleteResult = {
+export type OperationEnvelopeExecuteEventBlockResponse = {
     /**
      * Operation
      *
@@ -7172,7 +7343,7 @@ export type OperationEnvelopeDeleteResult = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteResult | null;
+    result?: ExecuteEventBlockResponse | null;
     /**
      * At
      *
@@ -7193,9 +7364,9 @@ export type OperationEnvelopeDeleteResult = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteTaxonomyBlockResponse]
+ * OperationEnvelope[FiscalCalendarResponse]
  */
-export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
+export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Operation
      *
@@ -7217,7 +7388,7 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteTaxonomyBlockResponse | null;
+    result?: FiscalCalendarResponse | null;
     /**
      * At
      *
@@ -7238,9 +7409,9 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EntityTaxonomyResponse]
+ * OperationEnvelope[InformationBlockEnvelope]
  */
-export type OperationEnvelopeEntityTaxonomyResponse = {
+export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Operation
      *
@@ -7262,7 +7433,7 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EntityTaxonomyResponse | null;
+    result?: InformationBlockEnvelope | null;
     /**
      * At
      *
@@ -7283,9 +7454,9 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EvaluateRulesResponse]
+ * OperationEnvelope[InitializeLedgerResponse]
  */
-export type OperationEnvelopeEvaluateRulesResponse = {
+export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Operation
      *
@@ -7307,7 +7478,7 @@ export type OperationEnvelopeEvaluateRulesResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EvaluateRulesResponse | null;
+    result?: InitializeLedgerResponse | null;
     /**
      * At
      *
@@ -7328,9 +7499,9 @@ export type OperationEnvelopeEvaluateRulesResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EventBlockEnvelope]
+ * OperationEnvelope[JournalEntryResponse]
  */
-export type OperationEnvelopeEventBlockEnvelope = {
+export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Operation
      *
@@ -7352,7 +7523,7 @@ export type OperationEnvelopeEventBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: EventBlockEnvelope | null;
+    result?: JournalEntryResponse | null;
     /**
      * At
      *
@@ -7373,9 +7544,9 @@ export type OperationEnvelopeEventBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EventHandlerResponse]
+ * OperationEnvelope[LedgerAgentResponse]
  */
-export type OperationEnvelopeEventHandlerResponse = {
+export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Operation
      *
@@ -7397,7 +7568,7 @@ export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EventHandlerResponse | null;
+    result?: LedgerAgentResponse | null;
     /**
      * At
      *
@@ -7418,9 +7589,9 @@ export type OperationEnvelopeEventHandlerResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[FiscalCalendarResponse]
+ * OperationEnvelope[LedgerEntityResponse]
  */
-export type OperationEnvelopeFiscalCalendarResponse = {
+export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Operation
      *
@@ -7442,7 +7613,7 @@ export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Command-specific result payload
      */
-    result?: FiscalCalendarResponse | null;
+    result?: LedgerEntityResponse | null;
     /**
      * At
      *
@@ -7463,9 +7634,9 @@ export type OperationEnvelopeFiscalCalendarResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[InformationBlockEnvelope]
+ * OperationEnvelope[PortfolioBlockEnvelope]
  */
-export type OperationEnvelopeInformationBlockEnvelope = {
+export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Operation
      *
@@ -7487,7 +7658,7 @@ export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: InformationBlockEnvelope | null;
+    result?: PortfolioBlockEnvelope | null;
     /**
      * At
      *
@@ -7508,9 +7679,9 @@ export type OperationEnvelopeInformationBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[InitializeLedgerResponse]
+ * OperationEnvelope[PreviewEventBlockResponse]
  */
-export type OperationEnvelopeInitializeLedgerResponse = {
+export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Operation
      *
@@ -7532,7 +7703,7 @@ export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: InitializeLedgerResponse | null;
+    result?: PreviewEventBlockResponse | null;
     /**
      * At
      *
@@ -7553,9 +7724,9 @@ export type OperationEnvelopeInitializeLedgerResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[JournalEntryResponse]
+ * OperationEnvelope[PublishListResponse]
  */
-export type OperationEnvelopeJournalEntryResponse = {
+export type OperationEnvelopePublishListResponse = {
     /**
      * Operation
      *
@@ -7577,7 +7748,7 @@ export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Command-specific result payload
      */
-    result?: JournalEntryResponse | null;
+    result?: PublishListResponse | null;
     /**
      * At
      *
@@ -7598,9 +7769,9 @@ export type OperationEnvelopeJournalEntryResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[LedgerAgentResponse]
+ * OperationEnvelope[ReportResponse]
  */
-export type OperationEnvelopeLedgerAgentResponse = {
+export type OperationEnvelopeReportResponse = {
     /**
      * Operation
      *
@@ -7622,7 +7793,7 @@ export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerAgentResponse | null;
+    result?: ReportResponse | null;
     /**
      * At
      *
@@ -7643,9 +7814,9 @@ export type OperationEnvelopeLedgerAgentResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[LedgerEntityResponse]
+ * OperationEnvelope[SecurityResponse]
  */
-export type OperationEnvelopeLedgerEntityResponse = {
+export type OperationEnvelopeSecurityResponse = {
     /**
      * Operation
      *
@@ -7667,7 +7838,7 @@ export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerEntityResponse | null;
+    result?: SecurityResponse | null;
     /**
      * At
      *
@@ -7688,9 +7859,9 @@ export type OperationEnvelopeLedgerEntityResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PortfolioBlockEnvelope]
+ * OperationEnvelope[ShareReportResponse]
  */
-export type OperationEnvelopePortfolioBlockEnvelope = {
+export type OperationEnvelopeShareReportResponse = {
     /**
      * Operation
      *
@@ -7712,7 +7883,7 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: PortfolioBlockEnvelope | null;
+    result?: ShareReportResponse | null;
     /**
      * At
      *
@@ -7733,9 +7904,9 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PreviewEventBlockResponse]
+ * OperationEnvelope[TaxonomyBlockEnvelope]
  */
-export type OperationEnvelopePreviewEventBlockResponse = {
+export type OperationEnvelopeTaxonomyBlockEnvelope = {
     /**
      * Operation
      *
@@ -7757,7 +7928,7 @@ export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: PreviewEventBlockResponse | null;
+    result?: TaxonomyBlockEnvelope | null;
     /**
      * At
      *
@@ -7778,9 +7949,9 @@ export type OperationEnvelopePreviewEventBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PublishListResponse]
+ * OperationEnvelope[list[PublishListMemberResponse]]
  */
-export type OperationEnvelopePublishListResponse = {
+export type OperationEnvelopeListPublishListMemberResponse = {
     /**
      * Operation
      *
@@ -7800,9 +7971,11 @@ export type OperationEnvelopePublishListResponse = {
      */
     status: 'completed' | 'pending' | 'failed';
     /**
+     * Result
+     *
      * Command-specific result payload
      */
-    result?: PublishListResponse | null;
+    result?: Array<PublishListMemberResponse> | null;
     /**
      * At
      *
@@ -7823,231 +7996,326 @@ export type OperationEnvelopePublishListResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[ReportResponse]
+ * OperatorListResponse
+ *
+ * Response for listing available operators.
  */
-export type OperationEnvelopeReportResponse = {
+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?: ReportResponse | 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[SecurityResponse]
+ * OperatorMode
+ *
+ * Operator execution modes.
  */
-export type OperationEnvelopeSecurityResponse = {
+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?: SecurityResponse | 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[ShareReportResponse]
+ * OperatorRecommendationResponse
+ *
+ * Response for operator recommendations.
  */
-export type OperationEnvelopeShareReportResponse = {
+export type OperatorRecommendationResponse = {
     /**
-     * Operation
+     * Recommendations
      *
-     * Kebab-case operation name
+     * List of operator recommendations sorted by confidence
      */
-    operation: string;
+    recommendations: Array<OperatorRecommendation>;
     /**
-     * Operationid
+     * Query
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * The analyzed query
+     */
+    query: string;
+};
+/**
+ * OperatorRequest
+ *
+ * Request model for operator interactions.
+ */
+export type OperatorRequest = {
+    /**
+     * Message
+     *
+     * The query or message to process
+     */
+    message: string;
+    /**
+     * History
+     *
+     * Conversation history
+     */
+    history?: Array<OperatorMessage>;
+    /**
+     * Context
+     *
+     * Additional context for analysis (e.g., enable_rag, include_schema)
+     */
+    context?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Execution mode
      */
-    operationId: string;
+    mode?: OperatorMode | null;
     /**
-     * Status
+     * 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?: ShareReportResponse | 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[TaxonomyBlockEnvelope]
+ * OperatorResponse
+ *
+ * Response model for operator interactions.
  */
-export type OperationEnvelopeTaxonomyBlockEnvelope = {
-    /**
-     * Operation
-     *
-     * Kebab-case operation name
-     */
-    operation: string;
-    /**
-     * Operationid
-     *
-     * op_-prefixed ULID for audit and SSE correlation
-     */
-    operationId: string;
+export type OperatorResponse = {
     /**
-     * Status
+     * Content
      *
-     * Operation lifecycle state
-     */
-    status: 'completed' | 'pending' | 'failed';
-    /**
-     * Command-specific result payload
+     * The operator's response content
      */
-    result?: TaxonomyBlockEnvelope | null;
+    content: string;
     /**
-     * At
+     * Operator Used
      *
-     * ISO-8601 UTC timestamp
+     * The operator type that handled the request
      */
-    at: string;
+    operator_used: string;
     /**
-     * Createdby
-     *
-     * User ID that initiated the operation (null for legacy callers)
+     * The execution mode used
      */
-    createdBy?: string | null;
+    mode_used: OperatorMode;
     /**
-     * Idempotentreplay
+     * Metadata
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Response metadata including routing info
      */
-    idempotentReplay?: boolean;
-};
-/**
- * OperationEnvelope[list[PublishListMemberResponse]]
- */
-export type OperationEnvelopeListPublishListMemberResponse = {
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Operation
+     * Tokens Used
      *
-     * Kebab-case operation name
+     * Token usage statistics
      */
-    operation: string;
+    tokens_used?: {
+        [key: string]: number;
+    } | null;
     /**
-     * Operationid
+     * Confidence Score
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Confidence score of the response (0.0-1.0 scale)
      */
-    operationId: string;
+    confidence_score?: number | null;
     /**
-     * Status
+     * Operation Id
      *
-     * Operation lifecycle state
+     * Operation ID for SSE monitoring
      */
-    status: 'completed' | 'pending' | 'failed';
+    operation_id?: string | null;
     /**
-     * Result
+     * Is Partial
      *
-     * Command-specific result payload
+     * Whether this is a partial response
      */
-    result?: Array<PublishListMemberResponse> | null;
+    is_partial?: boolean;
     /**
-     * At
+     * Error Details
      *
-     * ISO-8601 UTC timestamp
+     * Error details if any
      */
-    at: string;
+    error_details?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Createdby
+     * Execution Time
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Execution time in seconds
      */
-    createdBy?: string | null;
+    execution_time?: number | null;
     /**
-     * Idempotentreplay
+     * Timestamp
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Response timestamp
      */
-    idempotentReplay?: boolean;
+    timestamp?: string;
 };
 /**
  * OrgDetailResponse
@@ -9683,6 +9951,66 @@ 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
  *
@@ -10418,7 +10746,7 @@ export type SecurityResponse = {
 /**
  * SelectionCriteria
  *
- * Criteria for agent selection.
+ * Criteria for operator selection.
  */
 export type SelectionCriteria = {
     /**
@@ -10430,13 +10758,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
      *
@@ -10444,11 +10772,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>;
 };
 /**
  * ServiceOfferingSummary
@@ -12121,6 +12449,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
      *
@@ -12227,6 +12561,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);
 /**
@@ -12367,6 +12703,51 @@ 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
  *
@@ -12874,6 +13255,27 @@ export type CreateLegacyArm = {
         [key: string]: unknown;
     };
 };
+/**
+ * _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
  *
@@ -12920,6 +13322,26 @@ export type DeleteLegacyArm = {
         [key: string]: unknown;
     };
 };
+/**
+ * _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
  *
@@ -12965,6 +13387,26 @@ export type UpdateLegacyArm = {
         [key: string]: unknown;
     };
 };
+/**
+ * _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
  *
@@ -14779,7 +15221,7 @@ export type SyncConnectionResponses = {
     202: OperationEnvelope;
 };
 export type SyncConnectionResponse = SyncConnectionResponses[keyof SyncConnectionResponses];
-export type ListAgentsData = {
+export type ListOperatorsData = {
     body?: never;
     path: {
         /**
@@ -14795,9 +15237,9 @@ 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
      */
@@ -14827,16 +15269,16 @@ export type ListAgentsErrors = {
      */
     500: ErrorResponse;
 };
-export type ListAgentsError = ListAgentsErrors[keyof ListAgentsErrors];
-export type ListAgentsResponses = {
+export type ListOperatorsError = ListOperatorsErrors[keyof ListOperatorsErrors];
+export type ListOperatorsResponses = {
     /**
      * Successful Response
      */
-    200: AgentListResponse;
+    200: OperatorListResponse;
 };
-export type ListAgentsResponse = ListAgentsResponses[keyof ListAgentsResponses];
-export type AutoSelectAgentData = {
-    body: AgentRequest;
+export type ListOperatorsResponse = ListOperatorsResponses[keyof ListOperatorsResponses];
+export type AutoSelectOperatorData = {
+    body: OperatorRequest;
     path: {
         /**
          * Graph Id
@@ -14851,9 +15293,9 @@ 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
      */
@@ -14887,19 +15329,19 @@ export type AutoSelectAgentErrors = {
      */
     500: ErrorResponse;
 };
-export type AutoSelectAgentError = AutoSelectAgentErrors[keyof AutoSelectAgentErrors];
-export type AutoSelectAgentResponses = {
+export type AutoSelectOperatorError = AutoSelectOperatorErrors[keyof AutoSelectOperatorErrors];
+export type AutoSelectOperatorResponses = {
     /**
      * Successful Response
      */
-    200: AgentResponse;
+    200: OperatorResponse;
     /**
      * Query queued for async processing
      */
     202: unknown;
 };
-export type AutoSelectAgentResponse = AutoSelectAgentResponses[keyof AutoSelectAgentResponses];
-export type GetAgentMetadataData = {
+export type AutoSelectOperatorResponse = AutoSelectOperatorResponses[keyof AutoSelectOperatorResponses];
+export type GetOperatorMetadataData = {
     body?: never;
     path: {
         /**
@@ -14907,16 +15349,16 @@ 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
      */
@@ -14946,21 +15388,21 @@ export type GetAgentMetadataErrors = {
      */
     500: ErrorResponse;
 };
-export type GetAgentMetadataError = GetAgentMetadataErrors[keyof GetAgentMetadataErrors];
-export type GetAgentMetadataResponses = {
+export type GetOperatorMetadataError = GetOperatorMetadataErrors[keyof GetOperatorMetadataErrors];
+export type GetOperatorMetadataResponses = {
     /**
      * Successful Response
      */
-    200: AgentMetadataResponse;
+    200: OperatorMetadataResponse;
 };
-export type GetAgentMetadataResponse = GetAgentMetadataResponses[keyof GetAgentMetadataResponses];
-export type ExecuteSpecificAgentData = {
-    body: AgentRequest;
+export type GetOperatorMetadataResponse = GetOperatorMetadataResponses[keyof GetOperatorMetadataResponses];
+export type ExecuteSpecificOperatorData = {
+    body: OperatorRequest;
     path: {
         /**
-         * Agent Type
+         * Operator Type
          */
-        agent_type: string;
+        operator_type: string;
         /**
          * Graph Id
          */
@@ -14974,9 +15416,9 @@ 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
      */
@@ -15010,20 +15452,20 @@ export type ExecuteSpecificAgentErrors = {
      */
     500: ErrorResponse;
 };
-export type ExecuteSpecificAgentError = ExecuteSpecificAgentErrors[keyof ExecuteSpecificAgentErrors];
-export type ExecuteSpecificAgentResponses = {
+export type ExecuteSpecificOperatorError = ExecuteSpecificOperatorErrors[keyof ExecuteSpecificOperatorErrors];
+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
@@ -15031,7 +15473,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 = {
     /**
@@ -15072,11 +15514,11 @@ 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
@@ -15084,9 +15526,9 @@ 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
      */
@@ -15116,14 +15558,14 @@ export type RecommendAgentErrors = {
      */
     500: ErrorResponse;
 };
-export type RecommendAgentError = RecommendAgentErrors[keyof RecommendAgentErrors];
-export type RecommendAgentResponses = {
+export type RecommendOperatorError = RecommendOperatorErrors[keyof RecommendOperatorErrors];
+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;
     path: {
@@ -19684,6 +20126,65 @@ export type OpUpdateEventBlockResponses = {
     200: OperationEnvelopeEventBlockEnvelope;
 };
 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?: {