@robosystems/client 0.3.26 → 0.3.28

package/types.gen.d.ts

@@ -114,558 +114,236 @@ 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);
 };
 /**
- * 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
+ * AuthResponse
  *
- * Request for agent recommendations.
+ * Authentication response model.
  */
-export type AgentRecommendationRequest = {
+export type AuthResponse = {
     /**
-     * Query
+     * User
      *
-     * Query to analyze
+     * User information
      */
-    query: string;
+    user: {
+        [key: string]: unknown;
+    };
     /**
-     * Context
+     * Org
      *
-     * Additional context
+     * Organization information (personal org created automatically on registration)
      */
-    context?: {
+    org?: {
         [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
+     * 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;
-    /**
-     * 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
- *
- * The block's producible-artifact envelope — topic, template, mechanics.
- */
-export type ArtifactResponse = {
-    /**
-     * Topic
-     *
-     * Structure.description — the block's human-readable topic.
-     */
-    topic?: string | null;
-    /**
-     * Renderer Note
-     *
-     * e.g. 'in thousands', 'except per share'.
-     */
-    renderer_note?: string | null;
-    /**
-     * Template
-     *
-     * 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
-     */
-    mechanics: ({
-        kind: 'closing_entry_generator';
-    } & ScheduleMechanics) | ({
-        kind: 'statement_renderer';
-    } & StatementMechanics) | ({
-        kind: 'metric';
-    } & MetricMechanics);
-};
-/**
- * AssociationResponse
- *
- * One edge between two elements within a structure (parent/child
- * presentation, calculation rollup, mapping, equivalence).
- *
- * ``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 AssociationResponse = {
-    /**
-     * Id
-     */
-    id: string;
-    /**
-     * Structure Id
-     */
-    structure_id: string;
-    /**
-     * From Element Id
-     */
-    from_element_id: string;
-    /**
-     * From Element Name
-     */
-    from_element_name?: string | null;
-    /**
-     * From Element Qname
-     */
-    from_element_qname?: string | null;
-    /**
-     * To Element Id
-     */
-    to_element_id: string;
-    /**
-     * To Element Name
-     */
-    to_element_name?: string | null;
-    /**
-     * To Element Qname
-     */
-    to_element_qname?: string | null;
-    /**
-     * Association Type
-     */
-    association_type: string;
-    /**
-     * Order Value
-     */
-    order_value?: number | null;
-    /**
-     * Weight
-     */
-    weight?: number | null;
-    /**
-     * Confidence
-     */
-    confidence?: number | null;
-    /**
-     * Suggested By
-     */
-    suggested_by?: string | null;
-    /**
-     * Approved By
-     */
-    approved_by?: string | null;
-};
-/**
- * AuthResponse
- *
- * Authentication response model.
- */
-export type AuthResponse = {
-    /**
-     * User
-     *
-     * User information
-     */
-    user: {
-        [key: string]: unknown;
-    };
-    /**
-     * Org
-     *
-     * Organization information (personal org created automatically on registration)
-     */
-    org?: {
-        [key: string]: unknown;
-    } | null;
-    /**
-     * Message
-     *
-     * Success message
-     */
-    message: string;
-    /**
-     * Token
-     *
-     * JWT authentication token (optional for cookie-based auth)
-     */
-    token?: string | null;
-    /**
-     * Expires In
-     *
-     * Token expiry time in seconds from now
-     */
-    expires_in?: number | null;
-    /**
-     * Refresh Threshold
-     *
-     * Recommended refresh threshold in seconds before expiry
-     */
-    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 = {
-    /**
-     * Mapping Id
-     *
-     * The mapping structure to populate.
-     */
-    mapping_id: string;
-};
-/**
- * AvailableExtension
- */
-export type AvailableExtension = {
-    /**
-     * Name
-     */
-    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;
+    backup_type?: string;
     /**
      * Retention Days
      *
@@ -911,17 +589,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 +608,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
      *
@@ -1993,7 +1671,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 +1793,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;
     /**
@@ -6636,294 +6314,521 @@ export type MaterializeOp = {
     /**
      * Ignore Errors
      *
-     * Continue past non-fatal row errors
+     * Continue past non-fatal row errors
+     */
+    ignore_errors?: boolean;
+    /**
+     * Dry Run
+     *
+     * Validate tables without writing to the graph
+     */
+    dry_run?: boolean;
+    /**
+     * Source
+     *
+     * Materialization source: 'extensions' for OLTP, omit for DuckDB staging tables
+     */
+    source?: string | null;
+    /**
+     * Materialize Embeddings
+     *
+     * Generate vector embeddings during materialization
+     */
+    materialize_embeddings?: boolean;
+};
+/**
+ * MetricMechanics
+ *
+ * Derivative mechanics for ``block_type='metric'``.
+ *
+ * A metric block composes its facts from one or more source blocks at
+ * read time — covenant tests, ratios, KPI trend computations. The typed
+ * arm ships today so the discriminated union covers all three
+ * construction modes (declarative / compositional / derivative); the
+ * derivation evaluator that actually computes facts from source-block
+ * FactSets is not yet implemented.
+ *
+ * ``source_block_ids`` is the ordered list of Structure ids this metric
+ * derives from; ``derivation_type`` names the kind of computation
+ * (``ratio``, ``trailing_twelve_month``, ``covenant_test``, …), and
+ * ``expression`` carries the agent-authored derivation string that the
+ * evaluator will consume at envelope build time.
+ */
+export type MetricMechanics = {
+    /**
+     * Kind
+     */
+    kind?: 'metric';
+    /**
+     * Source Block Ids
+     *
+     * Ordered list of Structure ids this metric sources from. Must be non-empty at evaluation time; empty lists are accepted so library scaffolding can register metric templates before source linkage is wired.
+     */
+    source_block_ids?: Array<string>;
+    /**
+     * Derivation Type
+     *
+     * Free-form label for the derivation kind — 'ratio', 'trailing_twelve_month', 'covenant_test', etc. The evaluator dispatches on this tag; the set may be locked with a CHECK constraint once the derivation catalog stabilizes.
+     */
+    derivation_type?: string | null;
+    /**
+     * Expression
+     *
+     * Derivation expression in the metric DSL — evaluated at envelope read time to produce the derivative fact value. Opaque string today; the metric-side parser / evaluator is not yet implemented.
+     */
+    expression?: string | null;
+    /**
+     * Unit
+     *
+     * Output unit of the derived value — 'ratio', 'percent', 'USD', 'count', etc. Used by the renderer to format the metric badge.
+     */
+    unit?: string;
+};
+/**
+ * OAuthCallbackRequest
+ *
+ * OAuth callback parameters.
+ */
+export type OAuthCallbackRequest = {
+    /**
+     * 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
      */
-    ignore_errors?: boolean;
+    ai_operations: {
+        [key: string]: number;
+    };
     /**
-     * Dry Run
+     * Token Pricing
      *
-     * Validate tables without writing to the graph
+     * Token pricing by model
      */
-    dry_run?: boolean;
+    token_pricing: {
+        [key: string]: TokenPricing;
+    };
     /**
-     * Source
+     * Included Operations
      *
-     * Materialization source: 'extensions' for OLTP, omit for DuckDB staging tables
+     * Operations that don't consume credits
      */
-    source?: string | null;
+    included_operations: Array<string>;
     /**
-     * Materialize Embeddings
+     * Notes
      *
-     * Generate vector embeddings during materialization
+     * Important notes about costs
      */
-    materialize_embeddings?: boolean;
+    notes: Array<string>;
 };
 /**
- * MetricMechanics
+ * OperationEnvelope
  *
- * Derivative mechanics for ``block_type='metric'``.
+ * Uniform response shape for every operation endpoint.
  *
- * A metric block composes its facts from one or more source blocks at
- * read time — covenant tests, ratios, KPI trend computations. The typed
- * arm ships today so the discriminated union covers all three
- * construction modes (declarative / compositional / derivative); the
- * derivation evaluator that actually computes facts from source-block
- * FactSets is not yet implemented.
+ * 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.
  *
- * ``source_block_ids`` is the ordered list of Structure ids this metric
- * derives from; ``derivation_type`` names the kind of computation
- * (``ratio``, ``trailing_twelve_month``, ``covenant_test``, …), and
- * ``expression`` carries the agent-authored derivation string that the
- * evaluator will consume at envelope build time.
+ * ``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 MetricMechanics = {
+export type OperationEnvelope = {
     /**
-     * Kind
+     * Operation
+     *
+     * Kebab-case operation name
      */
-    kind?: 'metric';
+    operation: string;
     /**
-     * Source Block Ids
+     * Operationid
      *
-     * Ordered list of Structure ids this metric sources from. Must be non-empty at evaluation time; empty lists are accepted so library scaffolding can register metric templates before source linkage is wired.
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    source_block_ids?: Array<string>;
+    operationId: string;
     /**
-     * Derivation Type
+     * Status
      *
-     * Free-form label for the derivation kind — 'ratio', 'trailing_twelve_month', 'covenant_test', etc. The evaluator dispatches on this tag; the set may be locked with a CHECK constraint once the derivation catalog stabilizes.
+     * Operation lifecycle state
      */
-    derivation_type?: string | null;
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Expression
+     * Result
      *
-     * Derivation expression in the metric DSL — evaluated at envelope read time to produce the derivative fact value. Opaque string today; the metric-side parser / evaluator is not yet implemented.
+     * Command-specific result payload
      */
-    expression?: string | null;
+    result?: unknown | null;
     /**
-     * Unit
+     * At
      *
-     * Output unit of the derived value — 'ratio', 'percent', 'USD', 'count', etc. Used by the renderer to format the metric badge.
+     * ISO-8601 UTC timestamp
      */
-    unit?: string;
+    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;
 };
 /**
- * OAuthCallbackRequest
- *
- * OAuth callback parameters.
+ * OperationEnvelope[AssociationResponse]
  */
-export type OAuthCallbackRequest = {
+export type OperationEnvelopeAssociationResponse = {
     /**
-     * Code
+     * Operation
      *
-     * Authorization code from OAuth provider
+     * Kebab-case operation name
      */
-    code: string;
+    operation: string;
     /**
-     * State
+     * Operationid
      *
-     * OAuth state for verification
+     * op_-prefixed ULID for audit and SSE correlation
      */
-    state: string;
+    operationId: string;
     /**
-     * Realm Id
+     * Status
      *
-     * QuickBooks-specific realm ID
+     * Operation lifecycle state
      */
-    realm_id?: string | null;
+    status: 'completed' | 'pending' | 'failed';
     /**
-     * Error
+     * Command-specific result payload
+     */
+    result?: AssociationResponse | null;
+    /**
+     * At
      *
-     * OAuth error if authorization failed
+     * ISO-8601 UTC timestamp
      */
-    error?: string | null;
+    at: string;
     /**
-     * Error Description
+     * Createdby
      *
-     * OAuth error details
+     * User ID that initiated the operation (null for legacy callers)
      */
-    error_description?: string | null;
+    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;
 };
 /**
- * OAuthInitRequest
- *
- * Request to initiate OAuth flow.
+ * OperationEnvelope[ClosePeriodResponse]
  */
-export type OAuthInitRequest = {
+export type OperationEnvelopeClosePeriodResponse = {
     /**
-     * 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?: ClosePeriodResponse | 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[DeleteInformationBlockResponse]
  */
-export type OfferingRepositoryPlan = {
+export type OperationEnvelopeDeleteInformationBlockResponse = {
     /**
-     * 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?: DeleteInformationBlockResponse | 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[DeletePortfolioBlockResponse]
  */
-export type OperationCosts = {
+export type OperationEnvelopeDeletePortfolioBlockResponse = {
     /**
-     * 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?: DeletePortfolioBlockResponse | 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[DeleteResult]
  */
-export type OperationEnvelope = {
+export type OperationEnvelopeDeleteResult = {
     /**
      * Operation
      *
@@ -6943,11 +6848,9 @@ export type OperationEnvelope = {
      */
     status: 'completed' | 'pending' | 'failed';
     /**
-     * Result
-     *
      * Command-specific result payload
      */
-    result?: unknown | null;
+    result?: DeleteResult | null;
     /**
      * At
      *
@@ -6968,9 +6871,9 @@ export type OperationEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[AssociationResponse]
+ * OperationEnvelope[DeleteTaxonomyBlockResponse]
  */
-export type OperationEnvelopeAssociationResponse = {
+export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     /**
      * Operation
      *
@@ -6992,7 +6895,7 @@ export type OperationEnvelopeAssociationResponse = {
     /**
      * Command-specific result payload
      */
-    result?: AssociationResponse | null;
+    result?: DeleteTaxonomyBlockResponse | null;
     /**
      * At
      *
@@ -7013,9 +6916,9 @@ export type OperationEnvelopeAssociationResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[ClosePeriodResponse]
+ * OperationEnvelope[EntityTaxonomyResponse]
  */
-export type OperationEnvelopeClosePeriodResponse = {
+export type OperationEnvelopeEntityTaxonomyResponse = {
     /**
      * Operation
      *
@@ -7037,7 +6940,7 @@ export type OperationEnvelopeClosePeriodResponse = {
     /**
      * Command-specific result payload
      */
-    result?: ClosePeriodResponse | null;
+    result?: EntityTaxonomyResponse | null;
     /**
      * At
      *
@@ -7058,9 +6961,9 @@ export type OperationEnvelopeClosePeriodResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteInformationBlockResponse]
+ * OperationEnvelope[EvaluateRulesResponse]
  */
-export type OperationEnvelopeDeleteInformationBlockResponse = {
+export type OperationEnvelopeEvaluateRulesResponse = {
     /**
      * Operation
      *
@@ -7082,7 +6985,7 @@ export type OperationEnvelopeDeleteInformationBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteInformationBlockResponse | null;
+    result?: EvaluateRulesResponse | null;
     /**
      * At
      *
@@ -7103,9 +7006,9 @@ export type OperationEnvelopeDeleteInformationBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeletePortfolioBlockResponse]
+ * OperationEnvelope[EventBlockEnvelope]
  */
-export type OperationEnvelopeDeletePortfolioBlockResponse = {
+export type OperationEnvelopeEventBlockEnvelope = {
     /**
      * Operation
      *
@@ -7127,7 +7030,7 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeletePortfolioBlockResponse | null;
+    result?: EventBlockEnvelope | null;
     /**
      * At
      *
@@ -7148,9 +7051,9 @@ export type OperationEnvelopeDeletePortfolioBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteResult]
+ * OperationEnvelope[EventHandlerResponse]
  */
-export type OperationEnvelopeDeleteResult = {
+export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Operation
      *
@@ -7172,7 +7075,7 @@ export type OperationEnvelopeDeleteResult = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteResult | null;
+    result?: EventHandlerResponse | null;
     /**
      * At
      *
@@ -7193,9 +7096,9 @@ export type OperationEnvelopeDeleteResult = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[DeleteTaxonomyBlockResponse]
+ * OperationEnvelope[FiscalCalendarResponse]
  */
-export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
+export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Operation
      *
@@ -7217,7 +7120,7 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: DeleteTaxonomyBlockResponse | null;
+    result?: FiscalCalendarResponse | null;
     /**
      * At
      *
@@ -7238,9 +7141,9 @@ export type OperationEnvelopeDeleteTaxonomyBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EntityTaxonomyResponse]
+ * OperationEnvelope[InformationBlockEnvelope]
  */
-export type OperationEnvelopeEntityTaxonomyResponse = {
+export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Operation
      *
@@ -7262,7 +7165,7 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EntityTaxonomyResponse | null;
+    result?: InformationBlockEnvelope | null;
     /**
      * At
      *
@@ -7283,9 +7186,9 @@ export type OperationEnvelopeEntityTaxonomyResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EvaluateRulesResponse]
+ * OperationEnvelope[InitializeLedgerResponse]
  */
-export type OperationEnvelopeEvaluateRulesResponse = {
+export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Operation
      *
@@ -7307,7 +7210,7 @@ export type OperationEnvelopeEvaluateRulesResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EvaluateRulesResponse | null;
+    result?: InitializeLedgerResponse | null;
     /**
      * At
      *
@@ -7328,9 +7231,9 @@ export type OperationEnvelopeEvaluateRulesResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EventBlockEnvelope]
+ * OperationEnvelope[JournalEntryResponse]
  */
-export type OperationEnvelopeEventBlockEnvelope = {
+export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Operation
      *
@@ -7352,7 +7255,7 @@ export type OperationEnvelopeEventBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: EventBlockEnvelope | null;
+    result?: JournalEntryResponse | null;
     /**
      * At
      *
@@ -7373,9 +7276,9 @@ export type OperationEnvelopeEventBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[EventHandlerResponse]
+ * OperationEnvelope[LedgerAgentResponse]
  */
-export type OperationEnvelopeEventHandlerResponse = {
+export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Operation
      *
@@ -7397,7 +7300,7 @@ export type OperationEnvelopeEventHandlerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: EventHandlerResponse | null;
+    result?: LedgerAgentResponse | null;
     /**
      * At
      *
@@ -7418,9 +7321,9 @@ export type OperationEnvelopeEventHandlerResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[FiscalCalendarResponse]
+ * OperationEnvelope[LedgerEntityResponse]
  */
-export type OperationEnvelopeFiscalCalendarResponse = {
+export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Operation
      *
@@ -7442,7 +7345,7 @@ export type OperationEnvelopeFiscalCalendarResponse = {
     /**
      * Command-specific result payload
      */
-    result?: FiscalCalendarResponse | null;
+    result?: LedgerEntityResponse | null;
     /**
      * At
      *
@@ -7463,9 +7366,9 @@ export type OperationEnvelopeFiscalCalendarResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[InformationBlockEnvelope]
+ * OperationEnvelope[PortfolioBlockEnvelope]
  */
-export type OperationEnvelopeInformationBlockEnvelope = {
+export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Operation
      *
@@ -7487,7 +7390,7 @@ export type OperationEnvelopeInformationBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: InformationBlockEnvelope | null;
+    result?: PortfolioBlockEnvelope | null;
     /**
      * At
      *
@@ -7508,9 +7411,9 @@ export type OperationEnvelopeInformationBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[InitializeLedgerResponse]
+ * OperationEnvelope[PreviewEventBlockResponse]
  */
-export type OperationEnvelopeInitializeLedgerResponse = {
+export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Operation
      *
@@ -7532,7 +7435,7 @@ export type OperationEnvelopeInitializeLedgerResponse = {
     /**
      * Command-specific result payload
      */
-    result?: InitializeLedgerResponse | null;
+    result?: PreviewEventBlockResponse | null;
     /**
      * At
      *
@@ -7553,9 +7456,9 @@ export type OperationEnvelopeInitializeLedgerResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[JournalEntryResponse]
+ * OperationEnvelope[PublishListResponse]
  */
-export type OperationEnvelopeJournalEntryResponse = {
+export type OperationEnvelopePublishListResponse = {
     /**
      * Operation
      *
@@ -7577,7 +7480,7 @@ export type OperationEnvelopeJournalEntryResponse = {
     /**
      * Command-specific result payload
      */
-    result?: JournalEntryResponse | null;
+    result?: PublishListResponse | null;
     /**
      * At
      *
@@ -7598,9 +7501,9 @@ export type OperationEnvelopeJournalEntryResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[LedgerAgentResponse]
+ * OperationEnvelope[ReportResponse]
  */
-export type OperationEnvelopeLedgerAgentResponse = {
+export type OperationEnvelopeReportResponse = {
     /**
      * Operation
      *
@@ -7622,7 +7525,7 @@ export type OperationEnvelopeLedgerAgentResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerAgentResponse | null;
+    result?: ReportResponse | null;
     /**
      * At
      *
@@ -7643,9 +7546,9 @@ export type OperationEnvelopeLedgerAgentResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[LedgerEntityResponse]
+ * OperationEnvelope[SecurityResponse]
  */
-export type OperationEnvelopeLedgerEntityResponse = {
+export type OperationEnvelopeSecurityResponse = {
     /**
      * Operation
      *
@@ -7667,7 +7570,7 @@ export type OperationEnvelopeLedgerEntityResponse = {
     /**
      * Command-specific result payload
      */
-    result?: LedgerEntityResponse | null;
+    result?: SecurityResponse | null;
     /**
      * At
      *
@@ -7688,9 +7591,9 @@ export type OperationEnvelopeLedgerEntityResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PortfolioBlockEnvelope]
+ * OperationEnvelope[ShareReportResponse]
  */
-export type OperationEnvelopePortfolioBlockEnvelope = {
+export type OperationEnvelopeShareReportResponse = {
     /**
      * Operation
      *
@@ -7712,7 +7615,7 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
     /**
      * Command-specific result payload
      */
-    result?: PortfolioBlockEnvelope | null;
+    result?: ShareReportResponse | null;
     /**
      * At
      *
@@ -7733,9 +7636,9 @@ export type OperationEnvelopePortfolioBlockEnvelope = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PreviewEventBlockResponse]
+ * OperationEnvelope[TaxonomyBlockEnvelope]
  */
-export type OperationEnvelopePreviewEventBlockResponse = {
+export type OperationEnvelopeTaxonomyBlockEnvelope = {
     /**
      * Operation
      *
@@ -7757,7 +7660,7 @@ export type OperationEnvelopePreviewEventBlockResponse = {
     /**
      * Command-specific result payload
      */
-    result?: PreviewEventBlockResponse | null;
+    result?: TaxonomyBlockEnvelope | null;
     /**
      * At
      *
@@ -7778,9 +7681,9 @@ export type OperationEnvelopePreviewEventBlockResponse = {
     idempotentReplay?: boolean;
 };
 /**
- * OperationEnvelope[PublishListResponse]
+ * OperationEnvelope[list[PublishListMemberResponse]]
  */
-export type OperationEnvelopePublishListResponse = {
+export type OperationEnvelopeListPublishListMemberResponse = {
     /**
      * Operation
      *
@@ -7800,9 +7703,11 @@ export type OperationEnvelopePublishListResponse = {
      */
     status: 'completed' | 'pending' | 'failed';
     /**
+     * Result
+     *
      * Command-specific result payload
      */
-    result?: PublishListResponse | null;
+    result?: Array<PublishListMemberResponse> | null;
     /**
      * At
      *
@@ -7810,244 +7715,339 @@ export type OperationEnvelopePublishListResponse = {
      */
     at: string;
     /**
-     * Createdby
+     * 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;
+};
+/**
+ * OperatorListResponse
+ *
+ * Response for listing available operators.
+ */
+export type OperatorListResponse = {
+    /**
+     * Operators
+     *
+     * Dictionary of available operators with metadata
+     */
+    operators: {
+        [key: string]: {
+            [key: string]: unknown;
+        };
+    };
+    /**
+     * Total
+     *
+     * Total number of operators
+     */
+    total: number;
+};
+/**
+ * OperatorMessage
+ *
+ * Message in conversation history.
+ */
+export type OperatorMessage = {
+    /**
+     * Role
+     *
+     * Message role (user/assistant)
+     */
+    role: string;
+    /**
+     * Content
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Message content
      */
-    createdBy?: string | null;
+    content: string;
     /**
-     * Idempotentreplay
+     * Timestamp
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Message timestamp
      */
-    idempotentReplay?: boolean;
+    timestamp?: string | null;
 };
 /**
- * OperationEnvelope[ReportResponse]
+ * OperatorMetadataResponse
+ *
+ * Response for operator metadata.
  */
-export type OperationEnvelopeReportResponse = {
+export type OperatorMetadataResponse = {
     /**
-     * Operation
+     * Name
      *
-     * Kebab-case operation name
+     * Operator name
      */
-    operation: string;
+    name: string;
     /**
-     * Operationid
+     * Description
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Operator description
      */
-    operationId: string;
+    description: string;
     /**
-     * Status
+     * Version
      *
-     * Operation lifecycle state
+     * Operator version
      */
-    status: 'completed' | 'pending' | 'failed';
+    version: string;
     /**
-     * Command-specific result payload
+     * Capabilities
+     *
+     * Operator capabilities
      */
-    result?: ReportResponse | null;
+    capabilities: Array<string>;
     /**
-     * At
+     * Supported Modes
      *
-     * ISO-8601 UTC timestamp
+     * Supported execution modes
      */
-    at: string;
+    supported_modes: Array<string>;
     /**
-     * Createdby
+     * Requires Credits
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * Whether operator requires credits
      */
-    createdBy?: string | null;
+    requires_credits: boolean;
     /**
-     * Idempotentreplay
+     * Author
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Operator author
      */
-    idempotentReplay?: boolean;
+    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
      */
-    operationId: string;
+    query: string;
+};
+/**
+ * OperatorRequest
+ *
+ * Request model for operator interactions.
+ */
+export type OperatorRequest = {
     /**
-     * Status
+     * Message
      *
-     * Operation lifecycle state
+     * The query or message to process
      */
-    status: 'completed' | 'pending' | 'failed';
+    message: string;
     /**
-     * Command-specific result payload
+     * History
+     *
+     * Conversation history
      */
-    result?: ShareReportResponse | null;
+    history?: Array<OperatorMessage>;
     /**
-     * At
+     * Context
      *
-     * ISO-8601 UTC timestamp
+     * Additional context for analysis (e.g., enable_rag, include_schema)
      */
-    at: string;
+    context?: {
+        [key: string]: unknown;
+    } | null;
     /**
-     * Createdby
-     *
-     * User ID that initiated the operation (null for legacy callers)
+     * Execution mode
      */
-    createdBy?: string | null;
+    mode?: OperatorMode | null;
     /**
-     * Idempotentreplay
+     * Operator Type
      *
-     * True when this envelope came from the idempotency cache — the underlying command did not execute again. False on fresh executions.
+     * Specific operator type to use (optional)
      */
-    idempotentReplay?: boolean;
-};
-/**
- * OperationEnvelope[TaxonomyBlockEnvelope]
- */
-export type OperationEnvelopeTaxonomyBlockEnvelope = {
+    operator_type?: string | null;
     /**
-     * Operation
-     *
-     * Kebab-case operation name
+     * Criteria for operator selection
      */
-    operation: string;
+    selection_criteria?: SelectionCriteria | null;
     /**
-     * Operationid
+     * Force Extended Analysis
      *
-     * op_-prefixed ULID for audit and SSE correlation
+     * Force extended analysis mode with comprehensive research
      */
-    operationId: string;
+    force_extended_analysis?: boolean;
     /**
-     * Status
+     * Enable Rag
      *
-     * Operation lifecycle state
+     * Enable RAG context enrichment
      */
-    status: 'completed' | 'pending' | 'failed';
+    enable_rag?: boolean;
     /**
-     * Command-specific result payload
+     * Stream
+     *
+     * Enable streaming response
      */
-    result?: TaxonomyBlockEnvelope | null;
+    stream?: boolean;
+};
+/**
+ * OperatorResponse
+ *
+ * Response model for operator interactions.
+ */
+export type OperatorResponse = {
     /**
-     * At
+     * Content
      *
-     * ISO-8601 UTC timestamp
+     * The operator's response content
      */
-    at: string;
+    content: string;
     /**
-     * Createdby
+     * Operator Used
      *
-     * User ID that initiated the operation (null for legacy callers)
+     * The operator type that handled the request
      */
-    createdBy?: string | null;
+    operator_used: string;
     /**
-     * Idempotentreplay
+     * The execution mode used
+     */
+    mode_used: OperatorMode;
+    /**
+     * 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
@@ -10418,7 +10418,7 @@ export type SecurityResponse = {
 /**
  * SelectionCriteria
  *
- * Criteria for agent selection.
+ * Criteria for operator selection.
  */
 export type SelectionCriteria = {
     /**
@@ -10430,13 +10430,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 +10444,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
@@ -11443,6 +11443,11 @@ export type TaxonomyBlockEnvelope = {
  * TaxonomyBlockRule
  *
  * Rule projection for the Taxonomy Block envelope.
+ *
+ * Exactly one of ``rule_pattern`` (arithmetic) or ``rule_check_kind``
+ * (model-structure) is non-null per row, enforced by the
+ * ``check_rule_pattern_kind_xor`` DB constraint. See
+ * information-block.md §5.2.2.
  */
 export type TaxonomyBlockRule = {
     /**
@@ -11460,7 +11465,11 @@ export type TaxonomyBlockRule = {
     /**
      * Rule Pattern
      */
-    rule_pattern: string;
+    rule_pattern?: string | null;
+    /**
+     * Rule Check Kind
+     */
+    rule_check_kind?: string | null;
     /**
      * Rule Expression
      */
@@ -11494,6 +11503,15 @@ export type TaxonomyBlockRule = {
  * Exactly one of ``target_structure_ref``, ``target_element_qname``, or
  * ``target_taxonomy_self`` must be set (or all null for a global rule).
  * The ``model_validator`` enforces this contract at the Pydantic layer.
+ *
+ * Only **arithmetic** rule patterns are user-creatable via this API
+ * (the ``rule_pattern`` Literal below). The 6 model-structure check
+ * kinds (``NoCycles``, ``NoOrphanArcs``, ``ParentBeforeChild``,
+ * ``LeafHasClassification``, ``LibraryOriginImmutability``,
+ * ``UniqueQNameInTaxonomy``) are system-managed — they're auto-emitted
+ * by :func:`emit_auto_rules` at taxonomy-block creation time and
+ * populate ``rules.rule_check_kind`` instead of ``rule_pattern``. See
+ * information-block.md §5.2.2 for the axis split.
  */
 export type TaxonomyBlockRuleRequest = {
     /**
@@ -14761,7 +14779,7 @@ export type SyncConnectionResponses = {
     202: OperationEnvelope;
 };
 export type SyncConnectionResponse = SyncConnectionResponses[keyof SyncConnectionResponses];
-export type ListAgentsData = {
+export type ListOperatorsData = {
     body?: never;
     path: {
         /**
@@ -14777,9 +14795,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
      */
@@ -14809,16 +14827,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
@@ -14833,9 +14851,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
      */
@@ -14869,19 +14887,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: {
         /**
@@ -14889,16 +14907,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
      */
@@ -14928,21 +14946,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
          */
@@ -14956,9 +14974,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
      */
@@ -14992,20 +15010,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
@@ -15013,7 +15031,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 = {
     /**
@@ -15054,11 +15072,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
@@ -15066,9 +15084,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
      */
@@ -15098,14 +15116,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: {