@robosystems/client 0.3.19 → 0.3.21

package/artifacts/InvestorClient.js

@@ -63,7 +63,7 @@ class InvestorClient {
             confirm_active_positions: options?.confirmActivePositions ?? false,
         };
         const envelope = await this.callOperation('Delete portfolio block', (0, sdk_gen_1.opDeletePortfolioBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? { deleted: true });
+        return envelope.result ?? { deleted: true };
     }
     // ── Securities ──────────────────────────────────────────────────────
     /** List securities with pagination and filters. */
@@ -105,7 +105,7 @@ class InvestorClient {
             path: { graph_id: graphId },
             body: { security_id: securityId },
         }));
-        return (envelope.result ?? { deleted: true });
+        return envelope.result ?? { deleted: true };
     }
     // ── Positions (reads only — writes folded into Portfolio Block) ─────
     /** List positions with pagination and filters. */
@@ -146,6 +146,11 @@ class InvestorClient {
             throw err;
         }
     }
+    // Generic over the SDK call's response shape so typed ops (e.g.
+    // `opCreatePortfolioBlock`, which returns
+    // `OperationEnvelopePortfolioBlockEnvelope`) flow through with a typed
+    // `envelope.result` instead of being widened to `unknown`. Untyped ops
+    // continue to land as `OperationEnvelope` automatically.
     async callOperation(label, call) {
         const response = await call;
         if (response.error !== undefined) {

package/artifacts/InvestorClient.ts

@@ -36,7 +36,6 @@ import type {
   CreatePortfolioBlockRequest,
   CreateSecurityRequest,
   DeletePortfolioBlockOperation,
-  OperationEnvelope,
   PortfolioBlockPortfolioPatch,
   PortfolioBlockPositions,
   UpdatePortfolioBlockOperation,
@@ -206,7 +205,7 @@ export class InvestorClient {
       'Delete portfolio block',
       opDeletePortfolioBlock({ path: { graph_id: graphId }, body })
     )
-    return (envelope.result ?? { deleted: true }) as { deleted: boolean }
+    return envelope.result ?? { deleted: true }
   }
 
   // ── Securities ──────────────────────────────────────────────────────
@@ -288,7 +287,7 @@ export class InvestorClient {
         body: { security_id: securityId },
       })
     )
-    return (envelope.result ?? { deleted: true }) as { deleted: boolean }
+    return envelope.result ?? { deleted: true }
   }
 
   // ── Positions (reads only — writes folded into Portfolio Block) ─────
@@ -370,10 +369,15 @@ export class InvestorClient {
     }
   }
 
-  private async callOperation(
+  // Generic over the SDK call's response shape so typed ops (e.g.
+  // `opCreatePortfolioBlock`, which returns
+  // `OperationEnvelopePortfolioBlockEnvelope`) flow through with a typed
+  // `envelope.result` instead of being widened to `unknown`. Untyped ops
+  // continue to land as `OperationEnvelope` automatically.
+  private async callOperation<T>(
     label: string,
-    call: Promise<{ data?: OperationEnvelope; error?: unknown }>
-  ): Promise<OperationEnvelope> {
+    call: Promise<{ data?: T; error?: unknown }>
+  ): Promise<T> {
     const response = await call
     if (response.error !== undefined) {
       throw new Error(`${label} failed: ${JSON.stringify(response.error)}`)

package/artifacts/LedgerClient.d.ts

@@ -1,4 +1,4 @@
-import type { AutoMapElementsOperation, CreateAgentRequest, CreateEventBlockRequest, CreateEventHandlerRequest, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteMappingAssociationOperation, DeleteTaxonomyBlockRequest, EvaluateRulesRequest, FinancialStatementAnalysisRequest, LinkEntityTaxonomyRequest, LiveFinancialStatementRequest, OperationEnvelope, UpdateAgentRequest, UpdateEntityRequest, UpdateEventBlockRequest, UpdateEventHandlerRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest } from '../types.gen';
+import type { AssociationResponse, AutoMapElementsOperation, CreateAgentRequest, CreateEventBlockRequest, CreateEventHandlerRequest, CreateMappingAssociationOperation, CreateTaxonomyBlockRequest, CreateViewRequest, DeleteInformationBlockResponse, DeleteMappingAssociationOperation, DeleteResult, DeleteTaxonomyBlockRequest, DeleteTaxonomyBlockResponse, EntityTaxonomyResponse, EvaluateRulesRequest, EvaluateRulesResponse, EventBlockEnvelope, EventHandlerResponse, FinancialStatementAnalysisRequest, InformationBlockEnvelope, JournalEntryResponse, LedgerAgentResponse, LinkEntityTaxonomyRequest, LiveFinancialStatementRequest, OperationEnvelope, PreviewEventBlockResponse, PublishListMemberResponse, PublishListResponse, ReportResponse, ShareReportResponse, TaxonomyBlockEnvelope, UpdateAgentRequest, UpdateEntityRequest, UpdateEventBlockRequest, UpdateEventHandlerRequest, UpdateJournalEntryRequest, UpdateTaxonomyBlockRequest } from '../types.gen';
 import type { TokenProvider } from './graphql/client';
 import { type GetInformationBlockQuery, type GetLedgerAccountRollupsQuery, type GetLedgerAccountTreeQuery, type GetLedgerAgentQuery, type GetLedgerClosingBookStructuresQuery, type GetLedgerEntityQuery, type GetLedgerEventBlockQuery, type GetLedgerFiscalCalendarQuery, type GetLedgerMappedTrialBalanceQuery, type GetLedgerMappingCoverageQuery, type GetLedgerMappingQuery, type GetLedgerPeriodCloseStatusQuery, type GetLedgerPeriodDraftsQuery, type GetLedgerPublishListQuery, type GetLedgerReportingTaxonomyQuery, type GetLedgerReportPackageQuery, type GetLedgerReportQuery, type GetLedgerStatementQuery, type GetLedgerSummaryQuery, type GetLedgerTransactionQuery, type GetLedgerTrialBalanceQuery, type ListInformationBlocksQuery, type ListLedgerAccountsQuery, type ListLedgerAgentsQuery, type ListLedgerElementsQuery, type ListLedgerEntitiesQuery, type ListLedgerEventBlocksQuery, type ListLedgerMappingsQuery, type ListLedgerPublishListsQuery, type ListLedgerReportsQuery, type ListLedgerStructuresQuery, type ListLedgerTaxonomiesQuery, type ListLedgerTransactionsQuery, type ListLedgerUnmappedElementsQuery } from './graphql/generated/graphql';
 export type LedgerEntity = NonNullable<GetLedgerEntityQuery['entity']>;
@@ -67,10 +67,17 @@ export interface CreateReportOptions {
     comparative?: boolean;
     periods?: PeriodSpecInput[];
 }
-export interface ReportOperationAck {
+/**
+ * Wrapper returned by report write methods — pairs the audit-side
+ * envelope fields (`operationId`, `status`) with the typed result
+ * payload. Generic on ``T`` so each method advertises its specific
+ * result type (e.g. ``ReportResponse`` for creates, ``DeleteResult``
+ * for deletes).
+ */
+export interface ReportOperationAck<T = unknown> {
     operationId: string;
     status: OperationEnvelope['status'];
-    result: Record<string, unknown> | null;
+    result: T | null;
 }
 export interface InitializeLedgerResult {
     fiscalCalendar: LedgerFiscalCalendar;
@@ -136,6 +143,13 @@ export interface CreateJournalEntryOptions {
     type?: LedgerEntryType;
     status?: 'draft' | 'posted';
     transactionId?: string | null;
+    /**
+     * Who fired the event. Defaults to `'manual'` (user-initiated journal
+     * entry). Sync adapters (QuickBooks, Plaid, etc.) override with their
+     * adapter name. Must match the server's CHECK constraint set:
+     * `manual | schedule | system | quickbooks | xero | plaid`.
+     */
+    source?: string;
     idempotencyKey?: string | null;
 }
 interface LedgerClientConfig {
@@ -252,18 +266,16 @@ export declare class LedgerClient {
      * Link the graph's entity to a taxonomy (ENTITY_HAS_TAXONOMY edge).
      * Idempotent — returns existing linkage if already present.
      */
-    linkEntityTaxonomy(graphId: string, body: LinkEntityTaxonomyRequest): Promise<Record<string, unknown>>;
+    linkEntityTaxonomy(graphId: string, body: LinkEntityTaxonomyRequest): Promise<EntityTaxonomyResponse>;
     /**
      * Create a taxonomy block atomically (taxonomy + structures + elements +
      * associations + rules in one envelope).
      */
-    createTaxonomyBlock(graphId: string, body: CreateTaxonomyBlockRequest, idempotencyKey?: string): Promise<Record<string, unknown>>;
+    createTaxonomyBlock(graphId: string, body: CreateTaxonomyBlockRequest, idempotencyKey?: string): Promise<TaxonomyBlockEnvelope>;
     /** Update a taxonomy block — add/update/remove elements, structures, associations, or rules. */
-    updateTaxonomyBlock(graphId: string, body: UpdateTaxonomyBlockRequest): Promise<Record<string, unknown>>;
+    updateTaxonomyBlock(graphId: string, body: UpdateTaxonomyBlockRequest): Promise<TaxonomyBlockEnvelope>;
     /** Delete a taxonomy block. Cascades through elements, structures, and associations. */
-    deleteTaxonomyBlock(graphId: string, body: DeleteTaxonomyBlockRequest): Promise<{
-        deleted: boolean;
-    }>;
+    deleteTaxonomyBlock(graphId: string, body: DeleteTaxonomyBlockRequest): Promise<DeleteTaxonomyBlockResponse>;
     /** List elements (CoA accounts, GAAP concepts, etc.) with filters. */
     listElements(graphId: string, options?: {
         taxonomyId?: string;
@@ -289,11 +301,9 @@ export declare class LedgerClient {
     /** Mapping coverage stats — how many CoA elements are mapped. */
     getMappingCoverage(graphId: string, mappingId: string): Promise<LedgerMappingCoverage | null>;
     /** Create a manual mapping association between two elements. */
-    createMappingAssociation(graphId: string, body: CreateMappingAssociationOperation): Promise<Record<string, unknown>>;
+    createMappingAssociation(graphId: string, body: CreateMappingAssociationOperation): Promise<AssociationResponse>;
     /** Delete a mapping association. */
-    deleteMappingAssociation(graphId: string, body: DeleteMappingAssociationOperation): Promise<{
-        deleted: boolean;
-    }>;
+    deleteMappingAssociation(graphId: string, body: DeleteMappingAssociationOperation): Promise<DeleteResult>;
     /**
      * Trigger the AI MappingAgent. Returns the operation id — async; the
      * agent runs in the background. Consumers can subscribe to progress
@@ -325,17 +335,17 @@ export declare class LedgerClient {
     /** Update mutable fields on a schedule (name, entry_template, metadata). */
     updateSchedule(graphId: string, structureId: string, options: {
         name?: string;
-    }): Promise<Record<string, unknown>>;
+    }): Promise<InformationBlockEnvelope>;
     /** Permanently delete a schedule (cascades through facts + associations). */
-    deleteSchedule(graphId: string, structureId: string): Promise<{
-        deleted: boolean;
-    }>;
+    deleteSchedule(graphId: string, structureId: string): Promise<DeleteInformationBlockResponse>;
     /**
      * Dispose of a schedule asset — atomically truncates forward facts,
      * deletes the SumEquals rule, and posts a balanced disposal entry.
      *
      * Routes through `create-event-block` with `event_type='asset_disposed'`.
      * `occurred_at` is required and represents the disposal date.
+     * `source` defaults to `'manual'` (user-initiated disposal); sync
+     * adapters override.
      */
     disposeSchedule(graphId: string, options: {
         scheduleId: string;
@@ -345,9 +355,10 @@ export declare class LedgerClient {
         gainLossElementId?: string | null;
         memo?: string | null;
         reason?: string;
-    }): Promise<Record<string, unknown>>;
+        source?: string;
+    }): Promise<EventBlockEnvelope>;
     /** Evaluate taxonomy rules against facts in a structure. */
-    evaluateRules(graphId: string, body: EvaluateRulesRequest): Promise<Record<string, unknown>>;
+    evaluateRules(graphId: string, body: EvaluateRulesRequest): Promise<EvaluateRulesResponse>;
     /** Close status for all schedules in a fiscal period. */
     getPeriodCloseStatus(graphId: string, periodStart: string, periodEnd: string): Promise<LedgerPeriodCloseStatus | null>;
     /** All draft entries in a period, fully expanded for review pre-close. */
@@ -361,7 +372,7 @@ export declare class LedgerClient {
      * the underlying handler is idempotent and dispatches to one of
      * created / unchanged / regenerated / removed / skipped internally.
      */
-    createClosingEntry(graphId: string, structureId: string, postingDate: string, periodStart: string, periodEnd: string, memo?: string): Promise<Record<string, unknown>>;
+    createClosingEntry(graphId: string, structureId: string, postingDate: string, periodStart: string, periodEnd: string, memo?: string): Promise<EventBlockEnvelope>;
     /** Grouped closing book structures for the close-screen sidebar. */
     getClosingBookStructures(graphId: string): Promise<LedgerClosingBookStructures | null>;
     /** Current fiscal calendar state — pointers, gap, closeable status. */
@@ -389,25 +400,25 @@ export declare class LedgerClient {
      * Returns the EventBlockEnvelope (event row fields); query the ledger
      * separately if you need the resulting entry_id.
      */
-    createJournalEntry(graphId: string, options: CreateJournalEntryOptions): Promise<Record<string, unknown>>;
+    createJournalEntry(graphId: string, options: CreateJournalEntryOptions): Promise<EventBlockEnvelope>;
     /** Update a draft journal entry. Posted entries are immutable. */
-    updateJournalEntry(graphId: string, body: UpdateJournalEntryRequest): Promise<Record<string, unknown>>;
+    updateJournalEntry(graphId: string, body: UpdateJournalEntryRequest): Promise<JournalEntryResponse>;
     /** Hard-delete a draft journal entry. Posted entries must be reversed. */
-    deleteJournalEntry(graphId: string, entryId: string): Promise<{
-        deleted: boolean;
-    }>;
+    deleteJournalEntry(graphId: string, entryId: string): Promise<DeleteResult>;
     /**
      * Reverse a posted journal entry — creates an offsetting entry and marks
      * the original as reversed.
      *
      * Routes through `create-event-block` with
-     * `event_type='journal_entry_reversed'`.
+     * `event_type='journal_entry_reversed'`. `source` defaults to `'manual'`
+     * — sync adapters override.
      */
     reverseJournalEntry(graphId: string, entryId: string, options?: {
         postingDate?: string | null;
         memo?: string | null;
         reason?: string | null;
-    }): Promise<Record<string, unknown>>;
+        source?: string;
+    }): Promise<EventBlockEnvelope>;
     /**
      * Dry-run an event block — resolve the handler, evaluate metadata, and
      * return the planned GL rows without writing anything. Companion to
@@ -416,38 +427,38 @@ export declare class LedgerClient {
      * (the underlying `CreateEventBlockRequest`) and inspect what the
      * handler would do.
      */
-    previewEventBlock(graphId: string, body: CreateEventBlockRequest): Promise<Record<string, unknown>>;
+    previewEventBlock(graphId: string, body: CreateEventBlockRequest): Promise<PreviewEventBlockResponse>;
     /**
      * Apply a status transition and/or field corrections to an existing
      * event block. Use for posting drafts (`classified` → `committed` →
      * `fulfilled`), voiding, superseding (correction chains), or patching
      * `description` / `effective_at` / `metadata`.
      */
-    updateEventBlock(graphId: string, body: UpdateEventBlockRequest): Promise<Record<string, unknown>>;
+    updateEventBlock(graphId: string, body: UpdateEventBlockRequest): Promise<EventBlockEnvelope>;
     /**
      * Create an agent — REA counterparty (customer, vendor, employee, etc.)
      * referenced by event blocks via `agent_id`. `(source, external_id)` is
      * unique when `external_id` is provided, so external-source ingestion is
      * idempotent at the DB level.
      */
-    createAgent(graphId: string, body: CreateAgentRequest, idempotencyKey?: string): Promise<Record<string, unknown>>;
+    createAgent(graphId: string, body: CreateAgentRequest, idempotencyKey?: string): Promise<LedgerAgentResponse>;
     /**
      * Update an agent. `metadata_patch` is a partial merge into the existing
      * metadata object; all other fields replace.
      */
-    updateAgent(graphId: string, body: UpdateAgentRequest): Promise<Record<string, unknown>>;
+    updateAgent(graphId: string, body: UpdateAgentRequest): Promise<LedgerAgentResponse>;
     /**
      * Register a tenant-configurable event handler — DSL row in the
      * `event_handlers` table that drives `create-event-block` for event
      * types not covered by a Python handler. Match selectors plus a
      * `transaction_template` describing the GL rows to produce.
      */
-    createEventHandler(graphId: string, body: CreateEventHandlerRequest): Promise<Record<string, unknown>>;
+    createEventHandler(graphId: string, body: CreateEventHandlerRequest): Promise<EventHandlerResponse>;
     /**
      * Update a registered event handler. Pass `approve: true` to flip an
      * AI-suggested handler from unapproved to active.
      */
-    updateEventHandler(graphId: string, body: UpdateEventHandlerRequest): Promise<Record<string, unknown>>;
+    updateEventHandler(graphId: string, body: UpdateEventHandlerRequest): Promise<EventHandlerResponse>;
     /**
      * Live financial statement — pulls facts directly from the graph for
      * an explicit period window (or fiscal year) and returns the statement
@@ -479,7 +490,7 @@ export declare class LedgerClient {
      * Kick off report creation (async). Use the returned `operationId` to
      * subscribe to progress via SSE, then call `getReport()` once finished.
      */
-    createReport(graphId: string, options: CreateReportOptions): Promise<ReportOperationAck>;
+    createReport(graphId: string, options: CreateReportOptions): Promise<ReportOperationAck<ReportResponse>>;
     /** List all reports for a graph (includes received shared reports). */
     listReports(graphId: string): Promise<ReportListItem[]>;
     /** Get a single report with its period list + available structures. */
@@ -501,26 +512,26 @@ export declare class LedgerClient {
      * Regenerate an existing report (async). Returns an operation id;
      * subscribe via SSE for progress.
      */
-    regenerateReport(graphId: string, reportId: string, periodStart?: string, periodEnd?: string): Promise<ReportOperationAck>;
+    regenerateReport(graphId: string, reportId: string, periodStart?: string, periodEnd?: string): Promise<ReportOperationAck<ReportResponse>>;
     /** Delete a report and its generated facts. */
-    deleteReport(graphId: string, reportId: string): Promise<void>;
+    deleteReport(graphId: string, reportId: string): Promise<DeleteResult>;
     /**
-     * Share a published report to every member of a publish list (async).
-     * Each target graph receives a snapshot copy of the report's facts.
+     * Share a published report to every member of a publish list. Each
+     * target graph receives a snapshot copy of the report's facts.
      */
-    shareReport(graphId: string, reportId: string, publishListId: string): Promise<ReportOperationAck>;
+    shareReport(graphId: string, reportId: string, publishListId: string): Promise<ReportOperationAck<ShareReportResponse>>;
     /**
      * Transition a Report's filing_status to 'filed' — locks the package.
      * Allowed from 'draft' or 'under_review'. Stamps filed_at + filed_by
      * from the auth context + server clock.
      */
-    fileReport(graphId: string, reportId: string): Promise<ReportOperationAck>;
+    fileReport(graphId: string, reportId: string): Promise<ReportOperationAck<ReportResponse>>;
     /**
      * Move a Report along the non-file legs of the filing lifecycle
      * (draft ↔ under_review, filed → archived). Use ``fileReport`` to
      * reach 'filed' so the audit fields land cleanly.
      */
-    transitionFilingStatus(graphId: string, reportId: string, targetStatus: string): Promise<ReportOperationAck>;
+    transitionFilingStatus(graphId: string, reportId: string, targetStatus: string): Promise<ReportOperationAck<ReportResponse>>;
     /** Check if a report was received via sharing (vs locally created). */
     isSharedReport(report: Report): boolean;
     /** List publish lists with pagination. */
@@ -529,26 +540,36 @@ export declare class LedgerClient {
         offset?: number;
     }): Promise<PublishList[]>;
     /** Create a new publish list. */
-    createPublishList(graphId: string, name: string, description?: string): Promise<Record<string, unknown>>;
+    createPublishList(graphId: string, name: string, description?: string): Promise<PublishListResponse>;
     /** Get a single publish list with its full member list. */
     getPublishList(graphId: string, listId: string): Promise<PublishListDetail | null>;
     /** Update a publish list's name or description. */
     updatePublishList(graphId: string, listId: string, updates: {
         name?: string;
         description?: string | null;
-    }): Promise<Record<string, unknown>>;
+    }): Promise<PublishListResponse>;
     /** Delete a publish list. */
-    deletePublishList(graphId: string, listId: string): Promise<void>;
+    deletePublishList(graphId: string, listId: string): Promise<DeleteResult>;
     /** Add target graphs as members of a publish list. */
-    addPublishListMembers(graphId: string, listId: string, targetGraphIds: string[]): Promise<Record<string, unknown>>;
+    addPublishListMembers(graphId: string, listId: string, targetGraphIds: string[]): Promise<PublishListMemberResponse[]>;
     /** Remove a single member from a publish list. */
-    removePublishListMember(graphId: string, listId: string, memberId: string): Promise<{
-        deleted: boolean;
-    }>;
+    removePublishListMember(graphId: string, listId: string, memberId: string): Promise<DeleteResult>;
     /**
      * Await an SDK-generated `opXxx(...)` call, throw a readable error on
-     * non-2xx, and return the `OperationEnvelope` on success.
+     * non-2xx, and return the parsed envelope on success.
+     *
+     * Generic over the SDK call's response shape so typed ops (e.g.
+     * `opCreateEventBlock`, which returns
+     * `OperationEnvelopeEventBlockEnvelope`) flow through with a typed
+     * `envelope.result` instead of being widened to `unknown`. Untyped
+     * ops continue to land as `OperationEnvelope` automatically.
      */
     private callOperation;
+    /**
+     * Unwrap the typed result from an OperationEnvelope. Throws when the
+     * server returned an envelope with no `result` field — generally a
+     * sign that a synchronous operation failed silently.
+     */
+    private requireResult;
 }
 export {};

package/artifacts/LedgerClient.js

@@ -150,7 +150,7 @@ class LedgerClient {
      */
     async linkEntityTaxonomy(graphId, body) {
         const envelope = await this.callOperation('Link entity taxonomy', (0, sdk_gen_1.opLinkEntityTaxonomy)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Link entity taxonomy', envelope.result);
     }
     /**
      * Create a taxonomy block atomically (taxonomy + structures + elements +
@@ -159,12 +159,12 @@ class LedgerClient {
     async createTaxonomyBlock(graphId, body, idempotencyKey) {
         const headers = idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : undefined;
         const envelope = await this.callOperation('Create taxonomy block', (0, sdk_gen_1.opCreateTaxonomyBlock)({ path: { graph_id: graphId }, body, headers }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create taxonomy block', envelope.result);
     }
     /** Update a taxonomy block — add/update/remove elements, structures, associations, or rules. */
     async updateTaxonomyBlock(graphId, body) {
         const envelope = await this.callOperation('Update taxonomy block', (0, sdk_gen_1.opUpdateTaxonomyBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update taxonomy block', envelope.result);
     }
     /** Delete a taxonomy block. Cascades through elements, structures, and associations. */
     async deleteTaxonomyBlock(graphId, body) {
@@ -212,7 +212,7 @@ class LedgerClient {
     /** Create a manual mapping association between two elements. */
     async createMappingAssociation(graphId, body) {
         const envelope = await this.callOperation('Create mapping association', (0, sdk_gen_1.opCreateMappingAssociation)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create mapping association', envelope.result);
     }
     /** Delete a mapping association. */
     async deleteMappingAssociation(graphId, body) {
@@ -298,7 +298,7 @@ class LedgerClient {
             payload: { structure_id: structureId, ...options },
         };
         const envelope = await this.callOperation('Update schedule', (0, sdk_gen_1.opUpdateInformationBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update schedule', envelope.result);
     }
     /** Permanently delete a schedule (cascades through facts + associations). */
     async deleteSchedule(graphId, structureId) {
@@ -315,12 +315,14 @@ class LedgerClient {
      *
      * Routes through `create-event-block` with `event_type='asset_disposed'`.
      * `occurred_at` is required and represents the disposal date.
+     * `source` defaults to `'manual'` (user-initiated disposal); sync
+     * adapters override.
      */
     async disposeSchedule(graphId, options) {
         const body = {
             event_type: 'asset_disposed',
             event_category: 'adjustment',
-            source: 'native',
+            source: options.source ?? 'manual',
             occurred_at: options.occurredAt,
             apply_handlers: true,
             metadata: {
@@ -333,12 +335,12 @@ class LedgerClient {
             },
         };
         const envelope = await this.callOperation('Dispose schedule', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Dispose schedule', envelope.result);
     }
     /** Evaluate taxonomy rules against facts in a structure. */
     async evaluateRules(graphId, body) {
         const envelope = await this.callOperation('Evaluate rules', (0, sdk_gen_1.opEvaluateRules)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Evaluate rules', envelope.result);
     }
     // ── Period close ────────────────────────────────────────────────────
     /** Close status for all schedules in a fiscal period. */
@@ -362,7 +364,8 @@ class LedgerClient {
         const body = {
             event_type: 'schedule_entry_due',
             event_category: 'recognition',
-            source: 'scheduled',
+            // Always 'schedule' — this op is schedule-driven by definition.
+            source: 'schedule',
             occurred_at: `${postingDate}T00:00:00Z`,
             apply_handlers: true,
             metadata: {
@@ -374,7 +377,7 @@ class LedgerClient {
             },
         };
         const envelope = await this.callOperation('Create closing entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create closing entry', envelope.result);
     }
     // ── Closing book ───────────────────────────────────────────────────
     /** Grouped closing book structures for the close-screen sidebar. */
@@ -455,7 +458,7 @@ class LedgerClient {
         const body = {
             event_type: 'journal_entry_recorded',
             event_category: 'adjustment',
-            source: 'native',
+            source: options.source ?? 'manual',
             occurred_at: `${options.postingDate}T00:00:00Z`,
             apply_handlers: true,
             metadata: {
@@ -476,12 +479,12 @@ class LedgerClient {
             ? { 'Idempotency-Key': options.idempotencyKey }
             : undefined;
         const envelope = await this.callOperation('Create journal entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body, headers }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create journal entry', envelope.result);
     }
     /** Update a draft journal entry. Posted entries are immutable. */
     async updateJournalEntry(graphId, body) {
         const envelope = await this.callOperation('Update journal entry', (0, sdk_gen_1.opUpdateJournalEntry)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update journal entry', envelope.result);
     }
     /** Hard-delete a draft journal entry. Posted entries must be reversed. */
     async deleteJournalEntry(graphId, entryId) {
@@ -494,14 +497,15 @@ class LedgerClient {
      * the original as reversed.
      *
      * Routes through `create-event-block` with
-     * `event_type='journal_entry_reversed'`.
+     * `event_type='journal_entry_reversed'`. `source` defaults to `'manual'`
+     * — sync adapters override.
      */
     async reverseJournalEntry(graphId, entryId, options) {
         const occurredDate = options?.postingDate ?? new Date().toISOString().slice(0, 10);
         const body = {
             event_type: 'journal_entry_reversed',
             event_category: 'adjustment',
-            source: 'native',
+            source: options?.source ?? 'manual',
             occurred_at: `${occurredDate}T00:00:00Z`,
             apply_handlers: true,
             metadata: {
@@ -512,7 +516,7 @@ class LedgerClient {
             },
         };
         const envelope = await this.callOperation('Reverse journal entry', (0, sdk_gen_1.opCreateEventBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Reverse journal entry', envelope.result);
     }
     // ── Event blocks (generic preview + status transitions) ──────────────
     /**
@@ -525,7 +529,7 @@ class LedgerClient {
      */
     async previewEventBlock(graphId, body) {
         const envelope = await this.callOperation('Preview event block', (0, sdk_gen_1.opPreviewEventBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Preview event block', envelope.result);
     }
     /**
      * Apply a status transition and/or field corrections to an existing
@@ -535,7 +539,7 @@ class LedgerClient {
      */
     async updateEventBlock(graphId, body) {
         const envelope = await this.callOperation('Update event block', (0, sdk_gen_1.opUpdateEventBlock)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update event block', envelope.result);
     }
     // ── Agents (REA counterparties) ───────────────────────────────────────
     /**
@@ -547,7 +551,7 @@ class LedgerClient {
     async createAgent(graphId, body, idempotencyKey) {
         const headers = idempotencyKey ? { 'Idempotency-Key': idempotencyKey } : undefined;
         const envelope = await this.callOperation('Create agent', (0, sdk_gen_1.opCreateAgent)({ path: { graph_id: graphId }, body, headers }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create agent', envelope.result);
     }
     /**
      * Update an agent. `metadata_patch` is a partial merge into the existing
@@ -555,7 +559,7 @@ class LedgerClient {
      */
     async updateAgent(graphId, body) {
         const envelope = await this.callOperation('Update agent', (0, sdk_gen_1.opUpdateAgent)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update agent', envelope.result);
     }
     // ── Event handlers (DSL handler registry) ────────────────────────────
     /**
@@ -566,7 +570,7 @@ class LedgerClient {
      */
     async createEventHandler(graphId, body) {
         const envelope = await this.callOperation('Create event handler', (0, sdk_gen_1.opCreateEventHandler)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create event handler', envelope.result);
     }
     /**
      * Update a registered event handler. Pass `approve: true` to flip an
@@ -574,7 +578,7 @@ class LedgerClient {
      */
     async updateEventHandler(graphId, body) {
         const envelope = await this.callOperation('Update event handler', (0, sdk_gen_1.opUpdateEventHandler)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update event handler', envelope.result);
     }
     // ── Financial statements (graph-backed) ──────────────────────────────
     /**
@@ -704,14 +708,15 @@ class LedgerClient {
     }
     /** Delete a report and its generated facts. */
     async deleteReport(graphId, reportId) {
-        await this.callOperation('Delete report', (0, sdk_gen_1.opDeleteReport)({
+        const envelope = await this.callOperation('Delete report', (0, sdk_gen_1.opDeleteReport)({
             path: { graph_id: graphId },
             body: { report_id: reportId },
         }));
+        return (envelope.result ?? { deleted: true });
     }
     /**
-     * Share a published report to every member of a publish list (async).
-     * Each target graph receives a snapshot copy of the report's facts.
+     * Share a published report to every member of a publish list. Each
+     * target graph receives a snapshot copy of the report's facts.
      */
     async shareReport(graphId, reportId, publishListId) {
         const envelope = await this.callOperation('Share report', (0, sdk_gen_1.opShareReport)({
@@ -778,7 +783,7 @@ class LedgerClient {
             description: description ?? null,
         };
         const envelope = await this.callOperation('Create publish list', (0, sdk_gen_1.opCreatePublishList)({ path: { graph_id: graphId }, body }));
-        return (envelope.result ?? {});
+        return this.requireResult('Create publish list', envelope.result);
     }
     /** Get a single publish list with its full member list. */
     async getPublishList(graphId, listId) {
@@ -794,14 +799,15 @@ class LedgerClient {
                 description: updates.description ?? null,
             },
         }));
-        return (envelope.result ?? {});
+        return this.requireResult('Update publish list', envelope.result);
     }
     /** Delete a publish list. */
     async deletePublishList(graphId, listId) {
-        await this.callOperation('Delete publish list', (0, sdk_gen_1.opDeletePublishList)({
+        const envelope = await this.callOperation('Delete publish list', (0, sdk_gen_1.opDeletePublishList)({
             path: { graph_id: graphId },
             body: { list_id: listId },
         }));
+        return (envelope.result ?? { deleted: true });
     }
     /** Add target graphs as members of a publish list. */
     async addPublishListMembers(graphId, listId, targetGraphIds) {
@@ -812,7 +818,7 @@ class LedgerClient {
                 target_graph_ids: targetGraphIds,
             },
         }));
-        return (envelope.result ?? {});
+        return this.requireResult('Add publish list members', envelope.result);
     }
     /** Remove a single member from a publish list. */
     async removePublishListMember(graphId, listId, memberId) {
@@ -825,7 +831,13 @@ class LedgerClient {
     // ── Internal helpers ────────────────────────────────────────────────
     /**
      * Await an SDK-generated `opXxx(...)` call, throw a readable error on
-     * non-2xx, and return the `OperationEnvelope` on success.
+     * non-2xx, and return the parsed envelope on success.
+     *
+     * Generic over the SDK call's response shape so typed ops (e.g.
+     * `opCreateEventBlock`, which returns
+     * `OperationEnvelopeEventBlockEnvelope`) flow through with a typed
+     * `envelope.result` instead of being widened to `unknown`. Untyped
+     * ops continue to land as `OperationEnvelope` automatically.
      */
     async callOperation(label, call) {
         const response = await call;
@@ -837,6 +849,17 @@ class LedgerClient {
         }
         return response.data;
     }
+    /**
+     * Unwrap the typed result from an OperationEnvelope. Throws when the
+     * server returned an envelope with no `result` field — generally a
+     * sign that a synchronous operation failed silently.
+     */
+    requireResult(label, result) {
+        if (result === null || result === undefined) {
+            throw new Error(`${label}: operation envelope had no result`);
+        }
+        return result;
+    }
 }
 exports.LedgerClient = LedgerClient;
 // ── Module-private conversion helpers ─────────────────────────────────