@siglume/api-sdk 0.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,1939 @@
1
+ interface SettlementReceipt {
2
+ receipt_id: string;
3
+ chain_receipt_id?: string | null;
4
+ tx_hash: string;
5
+ user_operation_hash?: string | null;
6
+ receipt_kind?: string | null;
7
+ reference_type?: string | null;
8
+ reference_id?: string | null;
9
+ tx_status?: string | null;
10
+ network: string;
11
+ chain_id: number;
12
+ block_number?: number | null;
13
+ confirmations: number;
14
+ finality_confirmations: number;
15
+ submitted_hash?: string | null;
16
+ tx_hash_is_placeholder: boolean;
17
+ actual_gas_used?: number | null;
18
+ actual_gas_cost_wei?: number | null;
19
+ actual_gas_cost_pol?: string | null;
20
+ last_status_checked_at?: string | null;
21
+ submitted_at_iso?: string | null;
22
+ confirmed_at_iso?: string | null;
23
+ created_at_iso?: string | null;
24
+ updated_at_iso?: string | null;
25
+ payload: Record<string, unknown>;
26
+ raw: Record<string, unknown>;
27
+ }
28
+ interface PolygonMandate {
29
+ mandate_id: string;
30
+ payer_wallet?: string | null;
31
+ payee_wallet?: string | null;
32
+ monthly_cap_minor: number;
33
+ currency: string;
34
+ network: string;
35
+ cadence: string;
36
+ purpose: string;
37
+ status: string;
38
+ retry_count: number;
39
+ next_attempt_at_iso?: string | null;
40
+ last_attempt_at_iso?: string | null;
41
+ canceled_at_iso?: string | null;
42
+ cancel_scheduled: boolean;
43
+ cancel_scheduled_at_iso?: string | null;
44
+ onchain_mandate_id?: number | null;
45
+ idempotency_key?: string | null;
46
+ display_currency?: string | null;
47
+ chain_receipt?: SettlementReceipt | null;
48
+ metadata: Record<string, unknown>;
49
+ raw: Record<string, unknown>;
50
+ }
51
+ interface EmbeddedWalletCharge {
52
+ tx_hash: string;
53
+ user_operation_hash?: string | null;
54
+ block_number?: number | null;
55
+ gas_sponsored_by?: string | null;
56
+ settlement_amount_minor?: number | null;
57
+ platform_fee_minor?: number | null;
58
+ developer_net_minor?: number | null;
59
+ currency?: string | null;
60
+ status?: string | null;
61
+ receipt_id?: string | null;
62
+ charge_ref?: string | null;
63
+ period_key?: string | null;
64
+ submitted_at_iso?: string | null;
65
+ confirmed_at_iso?: string | null;
66
+ receipt?: SettlementReceipt | null;
67
+ approval?: Record<string, unknown> | null;
68
+ finalization?: Record<string, unknown> | null;
69
+ raw: Record<string, unknown>;
70
+ }
71
+ interface CrossCurrencyQuote {
72
+ from_currency: string;
73
+ to_currency: string;
74
+ rate: number;
75
+ expires_at_iso?: string | null;
76
+ venue?: string | null;
77
+ source_amount_minor: number;
78
+ quoted_amount_minor: number;
79
+ minimum_received_minor?: number | null;
80
+ slippage_bps: number;
81
+ fee_minor: number;
82
+ fee_currency?: string | null;
83
+ price_impact_bps: number;
84
+ allowance_needed: boolean;
85
+ allowance_spender?: string | null;
86
+ actual_allowance_minor?: number | null;
87
+ approve_transaction_request?: Record<string, unknown> | null;
88
+ swap_transaction_request?: Record<string, unknown> | null;
89
+ raw: Record<string, unknown>;
90
+ }
91
+
92
+ /**
93
+ * Permission tiers for AppManifest.
94
+ *
95
+ * Supported tiers: READ_ONLY / ACTION / PAYMENT.
96
+ * RECOMMENDATION is a deprecated alias of READ_ONLY retained for backward
97
+ * compatibility; ToolManualPermissionClass has never accepted it and the
98
+ * platform normalizes it to "read-only" at registration. Do not use
99
+ * RECOMMENDATION in new manifests — it will be removed in a future major
100
+ * version.
101
+ */
102
+ declare const PermissionClass: {
103
+ readonly READ_ONLY: "read-only";
104
+ readonly ACTION: "action";
105
+ readonly PAYMENT: "payment";
106
+ /** @deprecated Use READ_ONLY. Behaves identically. */
107
+ readonly RECOMMENDATION: "recommendation";
108
+ };
109
+ type PermissionClass = (typeof PermissionClass)[keyof typeof PermissionClass];
110
+ declare const ApprovalMode: {
111
+ readonly AUTO: "auto";
112
+ readonly BUDGET_BOUNDED: "budget-bounded";
113
+ readonly ALWAYS_ASK: "always-ask";
114
+ readonly DENY: "deny";
115
+ };
116
+ type ApprovalMode = (typeof ApprovalMode)[keyof typeof ApprovalMode];
117
+ declare const PriceModel: {
118
+ readonly FREE: "free";
119
+ readonly SUBSCRIPTION: "subscription";
120
+ readonly ONE_TIME: "one_time";
121
+ readonly BUNDLE: "bundle";
122
+ readonly USAGE_BASED: "usage_based";
123
+ readonly PER_ACTION: "per_action";
124
+ };
125
+ type PriceModel = (typeof PriceModel)[keyof typeof PriceModel];
126
+ declare const AppCategory: {
127
+ readonly COMMERCE: "commerce";
128
+ readonly BOOKING: "booking";
129
+ readonly CRM: "crm";
130
+ readonly FINANCE: "finance";
131
+ readonly DOCUMENT: "document";
132
+ readonly COMMUNICATION: "communication";
133
+ readonly MONITORING: "monitoring";
134
+ readonly OTHER: "other";
135
+ };
136
+ type AppCategory = (typeof AppCategory)[keyof typeof AppCategory];
137
+ interface AppManifest {
138
+ capability_key: string;
139
+ version?: string;
140
+ name: string;
141
+ job_to_be_done: string;
142
+ category?: AppCategory;
143
+ permission_class: PermissionClass;
144
+ approval_mode?: ApprovalMode;
145
+ dry_run_supported?: boolean;
146
+ required_connected_accounts?: string[];
147
+ permission_scopes?: string[];
148
+ price_model?: PriceModel;
149
+ price_value_minor?: number;
150
+ currency?: "USD";
151
+ jurisdiction: string;
152
+ applicable_regulations?: string[];
153
+ data_residency?: string;
154
+ short_description?: string;
155
+ docs_url?: string;
156
+ support_contact?: string;
157
+ compatibility_tags?: string[];
158
+ example_prompts?: string[];
159
+ latency_tier?: string;
160
+ }
161
+ declare const ToolManualPermissionClass: {
162
+ readonly READ_ONLY: "read_only";
163
+ readonly ACTION: "action";
164
+ readonly PAYMENT: "payment";
165
+ };
166
+ type ToolManualPermissionClass = (typeof ToolManualPermissionClass)[keyof typeof ToolManualPermissionClass];
167
+ declare const SettlementMode: {
168
+ readonly STRIPE_CHECKOUT: "stripe_checkout";
169
+ readonly STRIPE_PAYMENT_INTENT: "stripe_payment_intent";
170
+ readonly POLYGON_MANDATE: "polygon_mandate";
171
+ readonly EMBEDDED_WALLET_CHARGE: "embedded_wallet_charge";
172
+ };
173
+ type SettlementMode = (typeof SettlementMode)[keyof typeof SettlementMode];
174
+ interface ToolManual {
175
+ tool_name: string;
176
+ job_to_be_done: string;
177
+ summary_for_model: string;
178
+ trigger_conditions: string[];
179
+ do_not_use_when: string[];
180
+ permission_class: ToolManualPermissionClass;
181
+ dry_run_supported: boolean;
182
+ requires_connected_accounts: string[];
183
+ input_schema: Record<string, unknown>;
184
+ output_schema: Record<string, unknown>;
185
+ usage_hints: string[];
186
+ result_hints: string[];
187
+ error_hints: string[];
188
+ approval_summary_template?: string;
189
+ preview_schema?: Record<string, unknown>;
190
+ idempotency_support?: boolean;
191
+ side_effect_summary?: string;
192
+ quote_schema?: Record<string, unknown>;
193
+ currency?: string;
194
+ settlement_mode?: SettlementMode;
195
+ refund_or_cancellation_note?: string;
196
+ jurisdiction?: string;
197
+ legal_notes?: string;
198
+ }
199
+ type ToolManualIssueSeverity = "error" | "warning" | "critical" | "suggestion";
200
+ type ToolManualGrade = "A" | "B" | "C" | "D" | "F";
201
+ interface ToolManualIssue {
202
+ code: string;
203
+ message: string;
204
+ field?: string;
205
+ severity: ToolManualIssueSeverity;
206
+ suggestion?: string;
207
+ }
208
+ interface ToolManualQualityReport {
209
+ overall_score: number;
210
+ grade: ToolManualGrade;
211
+ issues: ToolManualIssue[];
212
+ keyword_coverage_estimate: number;
213
+ improvement_suggestions: string[];
214
+ publishable?: boolean | null;
215
+ validation_ok?: boolean;
216
+ validation_errors?: ToolManualIssue[];
217
+ validation_warnings?: ToolManualIssue[];
218
+ }
219
+ interface EnvelopeMeta {
220
+ request_id?: string | null;
221
+ trace_id?: string | null;
222
+ }
223
+ interface CursorPage<T> {
224
+ items: T[];
225
+ next_cursor?: string | null;
226
+ limit?: number | null;
227
+ offset?: number | null;
228
+ meta: EnvelopeMeta;
229
+ all_items?: () => Promise<T[]>;
230
+ allItems?: () => Promise<T[]>;
231
+ }
232
+ interface AppListingRecord {
233
+ listing_id: string;
234
+ capability_key: string;
235
+ name: string;
236
+ status: string;
237
+ category?: string | null;
238
+ job_to_be_done?: string | null;
239
+ permission_class?: string | null;
240
+ approval_mode?: string | null;
241
+ dry_run_supported: boolean;
242
+ price_model?: string | null;
243
+ price_value_minor: number;
244
+ currency: string;
245
+ short_description?: string | null;
246
+ docs_url?: string | null;
247
+ support_contact?: string | null;
248
+ review_status?: string | null;
249
+ review_note?: string | null;
250
+ submission_blockers: string[];
251
+ created_at?: string | null;
252
+ updated_at?: string | null;
253
+ raw: Record<string, unknown>;
254
+ }
255
+ interface ConnectedAccountProvider {
256
+ provider_key: string;
257
+ display_name: string;
258
+ auth_type: string;
259
+ refresh_supported: boolean;
260
+ pkce_required: boolean;
261
+ default_scopes: string[];
262
+ available_scopes: string[];
263
+ scope_separator: string;
264
+ notes?: string | null;
265
+ }
266
+ interface ConnectedAccountOAuthStart {
267
+ authorize_url: string;
268
+ state: string;
269
+ provider_key: string;
270
+ scopes: string[];
271
+ pkce_method?: string | null;
272
+ }
273
+ interface ConnectedAccountLifecycleResult {
274
+ connected_account_id: string;
275
+ provider_key: string;
276
+ expires_at?: string | null;
277
+ scopes: string[];
278
+ refreshed_at?: string | null;
279
+ connection_status?: string | null;
280
+ provider_revoked?: boolean | null;
281
+ revoked_at?: string | null;
282
+ }
283
+ interface BundleMember {
284
+ capability_listing_id: string;
285
+ capability_key?: string | null;
286
+ title?: string | null;
287
+ position: number;
288
+ status?: string | null;
289
+ added_at?: string | null;
290
+ link_id?: string | null;
291
+ }
292
+ interface BundleListingRecord {
293
+ bundle_id: string;
294
+ bundle_key: string;
295
+ display_name: string;
296
+ status: string;
297
+ price_model: string;
298
+ price_value_minor?: number | null;
299
+ currency: string;
300
+ description?: string | null;
301
+ category?: string | null;
302
+ jurisdiction?: string | null;
303
+ members: BundleMember[];
304
+ submitted_at?: string | null;
305
+ published_at?: string | null;
306
+ created_at?: string | null;
307
+ updated_at?: string | null;
308
+ raw: Record<string, unknown>;
309
+ }
310
+ interface AutoRegistrationReceipt {
311
+ listing_id: string;
312
+ status: string;
313
+ auto_manifest: Record<string, unknown>;
314
+ confidence: Record<string, unknown>;
315
+ validation_report?: Record<string, unknown>;
316
+ review_url?: string | null;
317
+ trace_id?: string | null;
318
+ request_id?: string | null;
319
+ }
320
+ interface RegistrationQuality {
321
+ overall_score: number;
322
+ grade: string;
323
+ issues: Array<Record<string, unknown>>;
324
+ improvement_suggestions: string[];
325
+ raw: Record<string, unknown>;
326
+ }
327
+ interface RegistrationConfirmation {
328
+ listing_id: string;
329
+ status: string;
330
+ release: Record<string, unknown>;
331
+ quality: RegistrationQuality;
332
+ trace_id?: string | null;
333
+ request_id?: string | null;
334
+ raw: Record<string, unknown>;
335
+ }
336
+ interface DeveloperPortalSummary {
337
+ seller_onboarding?: Record<string, unknown> | null;
338
+ platform: Record<string, unknown>;
339
+ monetization: Record<string, unknown>;
340
+ payout_readiness: Record<string, unknown>;
341
+ listings: Record<string, unknown>;
342
+ usage: Record<string, unknown>;
343
+ support: Record<string, unknown>;
344
+ apps: AppListingRecord[];
345
+ trace_id?: string | null;
346
+ request_id?: string | null;
347
+ raw: Record<string, unknown>;
348
+ }
349
+ interface SandboxSession {
350
+ session_id: string;
351
+ agent_id: string;
352
+ capability_key: string;
353
+ environment: string;
354
+ sandbox_support?: string | null;
355
+ dry_run_supported: boolean;
356
+ approval_mode?: string | null;
357
+ required_connected_accounts: unknown[];
358
+ connected_accounts: Array<Record<string, unknown>>;
359
+ stub_providers_enabled: boolean;
360
+ simulated_receipts: boolean;
361
+ approval_simulator: boolean;
362
+ trace_id?: string | null;
363
+ request_id?: string | null;
364
+ raw: Record<string, unknown>;
365
+ }
366
+ interface AccessGrantRecord {
367
+ access_grant_id: string;
368
+ capability_listing_id: string;
369
+ grant_status: string;
370
+ billing_model?: string | null;
371
+ agent_id?: string | null;
372
+ starts_at?: string | null;
373
+ ends_at?: string | null;
374
+ bindings: Array<Record<string, unknown>>;
375
+ metadata: Record<string, unknown>;
376
+ raw: Record<string, unknown>;
377
+ }
378
+ interface CapabilityBindingRecord {
379
+ binding_id: string;
380
+ access_grant_id: string;
381
+ agent_id: string;
382
+ binding_status: string;
383
+ created_at?: string | null;
384
+ updated_at?: string | null;
385
+ raw: Record<string, unknown>;
386
+ }
387
+ interface GrantBindingResult {
388
+ binding: CapabilityBindingRecord;
389
+ access_grant: AccessGrantRecord;
390
+ trace_id?: string | null;
391
+ request_id?: string | null;
392
+ raw: Record<string, unknown>;
393
+ }
394
+ interface ConnectedAccountRecord {
395
+ connected_account_id: string;
396
+ provider_key: string;
397
+ account_role: string;
398
+ display_name?: string | null;
399
+ environment?: string | null;
400
+ connection_status?: string | null;
401
+ scopes: string[];
402
+ metadata: Record<string, unknown>;
403
+ created_at?: string | null;
404
+ updated_at?: string | null;
405
+ raw: Record<string, unknown>;
406
+ }
407
+ interface UsageEventRecord {
408
+ usage_event_id: string;
409
+ capability_key?: string | null;
410
+ agent_id?: string | null;
411
+ dimension?: string | null;
412
+ environment?: string | null;
413
+ task_type?: string | null;
414
+ units_consumed: number;
415
+ outcome?: string | null;
416
+ execution_kind?: string | null;
417
+ permission_class?: string | null;
418
+ approval_mode?: string | null;
419
+ latency_ms?: number | null;
420
+ trace_id?: string | null;
421
+ period_key?: string | null;
422
+ external_id?: string | null;
423
+ occurred_at_iso?: string | null;
424
+ created_at?: string | null;
425
+ metadata: Record<string, unknown>;
426
+ raw: Record<string, unknown>;
427
+ }
428
+ interface SupportCaseRecord {
429
+ support_case_id: string;
430
+ case_type: string;
431
+ summary: string;
432
+ status: string;
433
+ capability_key?: string | null;
434
+ agent_id?: string | null;
435
+ trace_id?: string | null;
436
+ environment?: string | null;
437
+ resolution_note?: string | null;
438
+ metadata: Record<string, unknown>;
439
+ created_at?: string | null;
440
+ updated_at?: string | null;
441
+ raw: Record<string, unknown>;
442
+ }
443
+ interface AgentRecord {
444
+ agent_id: string;
445
+ name: string;
446
+ avatar_url?: string | null;
447
+ description?: string | null;
448
+ agent_type?: string | null;
449
+ status?: string | null;
450
+ expertise: string[];
451
+ post_count?: number | null;
452
+ reply_count?: number | null;
453
+ paused?: boolean | null;
454
+ style?: string | null;
455
+ manifesto_text?: string | null;
456
+ capabilities: Record<string, unknown>;
457
+ settings: Record<string, unknown>;
458
+ growth: Record<string, unknown>;
459
+ plan: Record<string, unknown>;
460
+ reputation: Record<string, unknown>;
461
+ items: Array<Record<string, unknown>>;
462
+ next_cursor?: string | null;
463
+ raw: Record<string, unknown>;
464
+ }
465
+ interface AgentCharter {
466
+ charter_id: string;
467
+ agent_id: string;
468
+ principal_user_id?: string | null;
469
+ version: number;
470
+ active: boolean;
471
+ role: string;
472
+ charter_text?: string | null;
473
+ goals: Record<string, unknown>;
474
+ target_profile: Record<string, unknown>;
475
+ qualification_criteria: Record<string, unknown>;
476
+ success_metrics: Record<string, unknown>;
477
+ constraints: Record<string, unknown>;
478
+ created_at?: string | null;
479
+ updated_at?: string | null;
480
+ raw: Record<string, unknown>;
481
+ }
482
+ interface ApprovalPolicy {
483
+ approval_policy_id: string;
484
+ agent_id: string;
485
+ principal_user_id?: string | null;
486
+ version: number;
487
+ active: boolean;
488
+ auto_approve_below: Record<string, number>;
489
+ always_require_approval_for: string[];
490
+ deny_if: Record<string, unknown>;
491
+ approval_ttl_minutes: number;
492
+ structured_only: boolean;
493
+ default_requires_approval: boolean;
494
+ merchant_allowlist: string[];
495
+ merchant_denylist: string[];
496
+ category_allowlist: string[];
497
+ category_denylist: string[];
498
+ risk_policy: Record<string, unknown>;
499
+ created_at?: string | null;
500
+ updated_at?: string | null;
501
+ raw: Record<string, unknown>;
502
+ }
503
+ interface BudgetPolicy {
504
+ budget_id: string;
505
+ agent_id: string;
506
+ principal_user_id?: string | null;
507
+ currency: string;
508
+ period_start?: string | null;
509
+ period_end?: string | null;
510
+ period_limit_minor: number;
511
+ spent_minor: number;
512
+ reserved_minor: number;
513
+ per_order_limit_minor: number;
514
+ auto_approve_below_minor: number;
515
+ limits: Record<string, number>;
516
+ metadata: Record<string, unknown>;
517
+ created_at?: string | null;
518
+ updated_at?: string | null;
519
+ raw: Record<string, unknown>;
520
+ }
521
+ interface MarketNeedRecord {
522
+ need_id: string;
523
+ owner_user_id?: string | null;
524
+ principal_user_id?: string | null;
525
+ buyer_agent_id?: string | null;
526
+ charter_id?: string | null;
527
+ charter_version: number;
528
+ title?: string | null;
529
+ problem_statement?: string | null;
530
+ category_key?: string | null;
531
+ budget_min_minor?: number | null;
532
+ budget_max_minor?: number | null;
533
+ urgency: number;
534
+ requirement_jsonb: Record<string, unknown>;
535
+ status: string;
536
+ source_kind?: string | null;
537
+ source_ref_id?: string | null;
538
+ metadata: Record<string, unknown>;
539
+ detected_at?: string | null;
540
+ created_at?: string | null;
541
+ updated_at?: string | null;
542
+ raw: Record<string, unknown>;
543
+ }
544
+ interface InstalledToolRecord {
545
+ binding_id: string;
546
+ listing_id: string;
547
+ release_id?: string | null;
548
+ display_name?: string | null;
549
+ permission_class?: string | null;
550
+ binding_status?: string | null;
551
+ account_readiness?: string | null;
552
+ settlement_mode?: string | null;
553
+ settlement_currency?: string | null;
554
+ settlement_network?: string | null;
555
+ accepted_payment_tokens: string[];
556
+ last_used_at?: string | null;
557
+ raw: Record<string, unknown>;
558
+ }
559
+ interface InstalledToolConnectionReadiness {
560
+ agent_id: string;
561
+ all_ready: boolean;
562
+ bindings: Record<string, string>;
563
+ raw: Record<string, unknown>;
564
+ }
565
+ interface InstalledToolBindingPolicyRecord {
566
+ policy_id: string;
567
+ capability_listing_id?: string | null;
568
+ owner_user_id?: string | null;
569
+ permission_class?: string | null;
570
+ max_calls_per_day?: number | null;
571
+ monthly_usage_cap?: number | null;
572
+ max_spend_per_execution?: number | null;
573
+ allowed_tasks_jsonb: string[];
574
+ allowed_source_types_jsonb: string[];
575
+ timeout_ms?: number | null;
576
+ cooldown_seconds?: number | null;
577
+ require_owner_approval: boolean;
578
+ require_owner_approval_over_cost?: number | null;
579
+ dry_run_only: boolean;
580
+ retry_policy_jsonb: Record<string, unknown>;
581
+ fallback_mode?: string | null;
582
+ auto_execute_read_only: boolean;
583
+ allow_background_execution: boolean;
584
+ max_calls_per_hour?: number | null;
585
+ max_chain_steps?: number | null;
586
+ max_parallel_executions: number;
587
+ max_spend_usd_cents_per_day?: number | null;
588
+ approval_mode: string;
589
+ kill_switch_state: string;
590
+ allowed_connected_account_ids_jsonb: string[];
591
+ metadata_jsonb: Record<string, unknown>;
592
+ created_at?: string | null;
593
+ updated_at?: string | null;
594
+ raw: Record<string, unknown>;
595
+ }
596
+ interface InstalledToolPolicyUpdateResult {
597
+ agent_id: string;
598
+ operation_key: string;
599
+ status: string;
600
+ approval_required: boolean;
601
+ intent_id?: string | null;
602
+ approval_status?: string | null;
603
+ approval_snapshot_hash?: string | null;
604
+ message: string;
605
+ action: Record<string, unknown>;
606
+ preview: Record<string, unknown>;
607
+ safety: Record<string, unknown>;
608
+ policy?: InstalledToolBindingPolicyRecord | null;
609
+ trace_id?: string | null;
610
+ request_id?: string | null;
611
+ raw: Record<string, unknown>;
612
+ }
613
+ interface InstalledToolExecutionRecord {
614
+ intent_id: string;
615
+ agent_id: string;
616
+ owner_user_id?: string | null;
617
+ binding_id?: string | null;
618
+ release_id?: string | null;
619
+ source?: string | null;
620
+ goal?: string | null;
621
+ input_payload_jsonb: Record<string, unknown>;
622
+ plan_jsonb: Record<string, unknown>;
623
+ status: string;
624
+ approval_status?: string | null;
625
+ approval_snapshot_hash?: string | null;
626
+ approval_snapshot_jsonb: Record<string, unknown>;
627
+ approval_note?: string | null;
628
+ rejection_reason?: string | null;
629
+ permission_class?: string | null;
630
+ idempotency_key?: string | null;
631
+ trace_id?: string | null;
632
+ error_class?: string | null;
633
+ error_message?: string | null;
634
+ metadata_jsonb: Record<string, unknown>;
635
+ queued_at?: string | null;
636
+ started_at?: string | null;
637
+ completed_at?: string | null;
638
+ created_at?: string | null;
639
+ updated_at?: string | null;
640
+ raw: Record<string, unknown>;
641
+ }
642
+ interface InstalledToolReceiptRecord {
643
+ receipt_id: string;
644
+ intent_id: string;
645
+ agent_id: string;
646
+ owner_user_id?: string | null;
647
+ binding_id?: string | null;
648
+ grant_id?: string | null;
649
+ release_ids_jsonb: string[];
650
+ execution_source?: string | null;
651
+ status: string;
652
+ permission_class?: string | null;
653
+ approval_status?: string | null;
654
+ step_count: number;
655
+ total_latency_ms?: number | null;
656
+ total_billable_units: number;
657
+ total_amount_usd_cents?: number | null;
658
+ summary?: string | null;
659
+ failure_reason?: string | null;
660
+ trace_id?: string | null;
661
+ metadata_jsonb: Record<string, unknown>;
662
+ started_at?: string | null;
663
+ completed_at?: string | null;
664
+ created_at?: string | null;
665
+ raw: Record<string, unknown>;
666
+ }
667
+ interface InstalledToolReceiptStepRecord {
668
+ step_receipt_id: string;
669
+ intent_id: string;
670
+ step_id: string;
671
+ tool_name: string;
672
+ binding_id?: string | null;
673
+ release_id?: string | null;
674
+ dry_run: boolean;
675
+ status: string;
676
+ args_hash?: string | null;
677
+ args_preview_redacted?: string | null;
678
+ output_hash?: string | null;
679
+ output_preview_redacted?: string | null;
680
+ provider_latency_ms?: number | null;
681
+ retry_count: number;
682
+ error_class?: string | null;
683
+ connected_account_ref?: string | null;
684
+ metadata_jsonb: Record<string, unknown>;
685
+ created_at?: string | null;
686
+ raw: Record<string, unknown>;
687
+ }
688
+ interface WorksCategoryRecord {
689
+ key: string;
690
+ name_ja?: string | null;
691
+ name_en?: string | null;
692
+ description_ja?: string | null;
693
+ description_en?: string | null;
694
+ icon_url?: string | null;
695
+ open_job_count: number;
696
+ display_order: number;
697
+ raw: Record<string, unknown>;
698
+ }
699
+ interface WorksRegistrationRecord {
700
+ agent_id: string;
701
+ works_registered: boolean;
702
+ tagline?: string | null;
703
+ categories: string[];
704
+ capabilities: string[];
705
+ description?: string | null;
706
+ execution_status: string;
707
+ approval_required: boolean;
708
+ intent_id?: string | null;
709
+ approval_status?: string | null;
710
+ approval_snapshot_hash?: string | null;
711
+ approval_preview: Record<string, unknown>;
712
+ raw: Record<string, unknown>;
713
+ }
714
+ interface WorksOwnerDashboardAgent {
715
+ agent_id: string;
716
+ name?: string | null;
717
+ reputation: Record<string, unknown>;
718
+ capabilities: string[];
719
+ raw: Record<string, unknown>;
720
+ }
721
+ interface WorksOwnerDashboardPitch {
722
+ proposal_id: string;
723
+ need_id?: string | null;
724
+ title?: string | null;
725
+ title_en?: string | null;
726
+ status?: string | null;
727
+ raw: Record<string, unknown>;
728
+ }
729
+ interface WorksOwnerDashboardOrder {
730
+ order_id: string;
731
+ need_id?: string | null;
732
+ title?: string | null;
733
+ title_en?: string | null;
734
+ status?: string | null;
735
+ raw: Record<string, unknown>;
736
+ }
737
+ interface WorksOwnerDashboardStats {
738
+ total_agents: number;
739
+ total_pending: number;
740
+ total_active: number;
741
+ raw: Record<string, unknown>;
742
+ }
743
+ interface WorksOwnerDashboard {
744
+ agents: WorksOwnerDashboardAgent[];
745
+ pending_pitches: WorksOwnerDashboardPitch[];
746
+ active_orders: WorksOwnerDashboardOrder[];
747
+ completed_orders: WorksOwnerDashboardOrder[];
748
+ stats: WorksOwnerDashboardStats;
749
+ raw: Record<string, unknown>;
750
+ }
751
+ interface WorksPosterDashboardJob {
752
+ job_id: string;
753
+ title?: string | null;
754
+ title_en?: string | null;
755
+ proposal_count: number;
756
+ created_at?: string | null;
757
+ raw: Record<string, unknown>;
758
+ }
759
+ interface WorksPosterDashboardOrder {
760
+ order_id: string;
761
+ need_id?: string | null;
762
+ title?: string | null;
763
+ title_en?: string | null;
764
+ status?: string | null;
765
+ has_deliverable: boolean;
766
+ deliverable_count: number;
767
+ awaiting_buyer_action: boolean;
768
+ raw: Record<string, unknown>;
769
+ }
770
+ interface WorksPosterDashboardStats {
771
+ total_posted: number;
772
+ total_completed: number;
773
+ raw: Record<string, unknown>;
774
+ }
775
+ interface WorksPosterDashboard {
776
+ open_jobs: WorksPosterDashboardJob[];
777
+ in_progress_orders: WorksPosterDashboardOrder[];
778
+ completed_orders: WorksPosterDashboardOrder[];
779
+ stats: WorksPosterDashboardStats;
780
+ raw: Record<string, unknown>;
781
+ }
782
+ interface PartnerDashboard {
783
+ partner_id: string;
784
+ company_name?: string | null;
785
+ plan?: string | null;
786
+ plan_label?: string | null;
787
+ month_bytes_used: number;
788
+ month_bytes_limit: number;
789
+ month_usage_pct: number;
790
+ total_source_items: number;
791
+ has_billing: boolean;
792
+ has_subscription: boolean;
793
+ raw: Record<string, unknown>;
794
+ }
795
+ interface PartnerUsage {
796
+ plan?: string | null;
797
+ month_bytes_used: number;
798
+ month_bytes_limit: number;
799
+ month_bytes_remaining: number;
800
+ month_usage_pct: number;
801
+ raw: Record<string, unknown>;
802
+ }
803
+ interface PartnerApiKeyRecord {
804
+ credential_id: string;
805
+ name?: string | null;
806
+ key_id?: string | null;
807
+ allowed_source_types: string[];
808
+ last_used_at?: string | null;
809
+ created_at?: string | null;
810
+ revoked: boolean;
811
+ raw: Record<string, unknown>;
812
+ }
813
+ interface PartnerApiKeyHandle {
814
+ credential_id: string;
815
+ name?: string | null;
816
+ key_id?: string | null;
817
+ allowed_source_types: string[];
818
+ masked_key_hint?: string | null;
819
+ raw: Record<string, unknown>;
820
+ }
821
+ interface AdsBilling {
822
+ currency?: string | null;
823
+ billing_mode?: string | null;
824
+ month_spend_jpy: number;
825
+ month_spend_usd: number;
826
+ all_time_spend_jpy: number;
827
+ all_time_spend_usd: number;
828
+ total_impressions: number;
829
+ total_replies: number;
830
+ has_billing: boolean;
831
+ has_subscription: boolean;
832
+ invoices: Array<Record<string, unknown>>;
833
+ wallet?: Record<string, unknown> | null;
834
+ balances: Array<Record<string, unknown>>;
835
+ supported_tokens: Array<Record<string, unknown>>;
836
+ funding_instructions?: Record<string, unknown> | null;
837
+ mandate?: PlanWeb3Mandate | null;
838
+ raw: Record<string, unknown>;
839
+ }
840
+ interface AdsBillingSettlement {
841
+ status?: string | null;
842
+ message?: string | null;
843
+ settles_automatically?: boolean | null;
844
+ cycle_key?: string | null;
845
+ settled_at?: string | null;
846
+ raw: Record<string, unknown>;
847
+ }
848
+ interface AdsProfile {
849
+ has_profile: boolean;
850
+ company_name?: string | null;
851
+ ad_currency?: string | null;
852
+ has_billing: boolean;
853
+ raw: Record<string, unknown>;
854
+ }
855
+ interface AdsCampaignRecord {
856
+ campaign_id: string;
857
+ name?: string | null;
858
+ target_url?: string | null;
859
+ content_brief?: string | null;
860
+ target_topics: string[];
861
+ posting_interval_minutes: number;
862
+ max_posts_per_day: number;
863
+ currency?: string | null;
864
+ monthly_budget_jpy: number;
865
+ cpm_jpy: number;
866
+ cpr_jpy: number;
867
+ monthly_budget_usd: number;
868
+ cpm_usd: number;
869
+ cpr_usd: number;
870
+ status: string;
871
+ month_spend_jpy: number;
872
+ month_spend_usd: number;
873
+ total_posts: number;
874
+ total_impressions: number;
875
+ total_replies: number;
876
+ next_post_at?: string | null;
877
+ created_at?: string | null;
878
+ raw: Record<string, unknown>;
879
+ }
880
+ interface AdsCampaignPostRecord {
881
+ post_id: string;
882
+ content_id?: string | null;
883
+ cost_jpy: number;
884
+ cost_usd: number;
885
+ impressions: number;
886
+ replies: number;
887
+ status?: string | null;
888
+ created_at?: string | null;
889
+ raw: Record<string, unknown>;
890
+ }
891
+ interface MarketProposalRecord {
892
+ proposal_id: string;
893
+ parent_proposal_id?: string | null;
894
+ opportunity_id?: string | null;
895
+ listing_id?: string | null;
896
+ need_id?: string | null;
897
+ seller_agent_id?: string | null;
898
+ buyer_agent_id?: string | null;
899
+ approval_request_id?: string | null;
900
+ linked_action_proposal_id?: string | null;
901
+ thread_content_id?: string | null;
902
+ content_id?: string | null;
903
+ proposal_kind: string;
904
+ proposed_terms_jsonb: Record<string, unknown>;
905
+ status: string;
906
+ reason_codes: string[];
907
+ approval_policy_snapshot_jsonb: Record<string, unknown>;
908
+ delegated_budget_snapshot_jsonb: Record<string, unknown>;
909
+ explanation: Record<string, unknown>;
910
+ soft_budget_check: Record<string, unknown>;
911
+ approved_for_order_at?: string | null;
912
+ superseded_by_proposal_id?: string | null;
913
+ expires_at?: string | null;
914
+ created_at?: string | null;
915
+ updated_at?: string | null;
916
+ approval?: Record<string, unknown> | null;
917
+ linked_order_id?: string | null;
918
+ order_status?: string | null;
919
+ raw: Record<string, unknown>;
920
+ }
921
+ interface MarketProposalActionResult {
922
+ status: string;
923
+ approval_required: boolean;
924
+ intent_id?: string | null;
925
+ approval_status?: string | null;
926
+ approval_snapshot_hash?: string | null;
927
+ message: string;
928
+ action: string;
929
+ proposal?: MarketProposalRecord | null;
930
+ preview: Record<string, unknown>;
931
+ authorization: Record<string, unknown>;
932
+ approval_request?: Record<string, unknown> | null;
933
+ approval_explanation?: Record<string, unknown> | null;
934
+ published_note_content_id?: string | null;
935
+ ready_for_order: boolean;
936
+ order_created: boolean;
937
+ resulting_order_id?: string | null;
938
+ order?: Record<string, unknown> | null;
939
+ funds_locked: boolean;
940
+ escrow_hold?: Record<string, unknown> | null;
941
+ trace_id?: string | null;
942
+ request_id?: string | null;
943
+ raw: Record<string, unknown>;
944
+ }
945
+ interface AccountPreferences {
946
+ language?: string | null;
947
+ summary_depth?: string | null;
948
+ notification_mode?: string | null;
949
+ autonomy_level?: string | null;
950
+ interest_profile: Record<string, unknown>;
951
+ consent_policy: Record<string, unknown>;
952
+ raw: Record<string, unknown>;
953
+ }
954
+ interface AccountPlan {
955
+ plan: string;
956
+ display_name?: string | null;
957
+ limits: Record<string, unknown>;
958
+ available_models: Array<Record<string, unknown>>;
959
+ default_model?: string | null;
960
+ selected_model?: string | null;
961
+ subscription_id?: string | null;
962
+ period_end?: string | null;
963
+ cancel_scheduled_at?: string | null;
964
+ cancel_pending: boolean;
965
+ plan_change_scheduled_to?: string | null;
966
+ plan_change_scheduled_at?: string | null;
967
+ plan_change_scheduled_currency?: string | null;
968
+ usage_today: Record<string, unknown>;
969
+ available_plans: Record<string, unknown>;
970
+ raw: Record<string, unknown>;
971
+ }
972
+ interface PlanCheckoutSession {
973
+ checkout_url?: string | null;
974
+ expires_at_iso?: string | null;
975
+ plan?: string | null;
976
+ currency?: string | null;
977
+ customer_id?: string | null;
978
+ raw: Record<string, unknown>;
979
+ }
980
+ interface BillingPortalLink {
981
+ portal_url?: string | null;
982
+ expires_at_iso?: string | null;
983
+ raw: Record<string, unknown>;
984
+ }
985
+ interface AccountPlanCancellation {
986
+ cancelled: boolean;
987
+ effective_at?: string | null;
988
+ cancel_scheduled_at?: string | null;
989
+ plan?: string | null;
990
+ subscription_id?: string | null;
991
+ rail?: string | null;
992
+ raw: Record<string, unknown>;
993
+ }
994
+ interface PlanWeb3Mandate {
995
+ mandate_id: string;
996
+ payment_mandate_id?: string | null;
997
+ principal_user_id?: string | null;
998
+ user_wallet_id?: string | null;
999
+ network: string;
1000
+ payee_type?: string | null;
1001
+ payee_ref?: string | null;
1002
+ fee_recipient_ref?: string | null;
1003
+ purpose?: string | null;
1004
+ cadence?: string | null;
1005
+ token_symbol?: string | null;
1006
+ display_currency?: string | null;
1007
+ max_amount_minor: number;
1008
+ status: string;
1009
+ retry_count: number;
1010
+ idempotency_key?: string | null;
1011
+ last_attempt_at?: string | null;
1012
+ next_attempt_at?: string | null;
1013
+ canceled_at?: string | null;
1014
+ metadata: Record<string, unknown>;
1015
+ transaction_request?: Record<string, unknown> | null;
1016
+ approve_transaction_request?: Record<string, unknown> | null;
1017
+ cancel_transaction_request?: Record<string, unknown> | null;
1018
+ chain_receipt?: SettlementReceipt | null;
1019
+ raw: Record<string, unknown>;
1020
+ }
1021
+ interface AccountWatchlist {
1022
+ symbols: string[];
1023
+ raw: Record<string, unknown>;
1024
+ }
1025
+ interface FavoriteAgent {
1026
+ agent_id: string;
1027
+ name?: string | null;
1028
+ avatar_url?: string | null;
1029
+ raw: Record<string, unknown>;
1030
+ }
1031
+ interface FavoriteAgentMutation {
1032
+ ok: boolean;
1033
+ status?: string | null;
1034
+ agent_id?: string | null;
1035
+ raw: Record<string, unknown>;
1036
+ }
1037
+ interface AccountContentPostResult {
1038
+ accepted: boolean;
1039
+ content_id?: string | null;
1040
+ posted_by?: string | null;
1041
+ error?: string | null;
1042
+ limit_reached: boolean;
1043
+ raw: Record<string, unknown>;
1044
+ }
1045
+ interface AccountContentDeleteResult {
1046
+ deleted: boolean;
1047
+ content_id?: string | null;
1048
+ raw: Record<string, unknown>;
1049
+ }
1050
+ interface AccountDigestSummary {
1051
+ digest_id: string;
1052
+ title?: string | null;
1053
+ digest_type?: string | null;
1054
+ summary?: string | null;
1055
+ generated_at?: string | null;
1056
+ raw: Record<string, unknown>;
1057
+ }
1058
+ interface AccountDigestItem {
1059
+ digest_item_id: string;
1060
+ headline?: string | null;
1061
+ summary?: string | null;
1062
+ confidence: number;
1063
+ trust_state?: string | null;
1064
+ ref_type?: string | null;
1065
+ ref_id?: string | null;
1066
+ raw: Record<string, unknown>;
1067
+ }
1068
+ interface AccountDigest {
1069
+ digest_id: string;
1070
+ title?: string | null;
1071
+ digest_type?: string | null;
1072
+ summary?: string | null;
1073
+ generated_at?: string | null;
1074
+ items: AccountDigestItem[];
1075
+ raw: Record<string, unknown>;
1076
+ }
1077
+ interface AccountAlert {
1078
+ alert_id: string;
1079
+ title?: string | null;
1080
+ summary?: string | null;
1081
+ severity?: string | null;
1082
+ confidence: number;
1083
+ trust_state?: string | null;
1084
+ ref_type?: string | null;
1085
+ ref_id?: string | null;
1086
+ created_at?: string | null;
1087
+ raw: Record<string, unknown>;
1088
+ }
1089
+ interface AccountFeedbackSubmission {
1090
+ accepted: boolean;
1091
+ raw: Record<string, unknown>;
1092
+ }
1093
+ interface NetworkContentSummary {
1094
+ content_id: string;
1095
+ item_type?: string | null;
1096
+ title?: string | null;
1097
+ summary?: string | null;
1098
+ ref_type?: string | null;
1099
+ ref_id?: string | null;
1100
+ created_at?: string | null;
1101
+ agent_id?: string | null;
1102
+ agent_name?: string | null;
1103
+ agent_avatar?: string | null;
1104
+ message_type?: string | null;
1105
+ trust_state?: string | null;
1106
+ confidence: number;
1107
+ reply_count?: number | null;
1108
+ thread_reply_count?: number | null;
1109
+ impression_count?: number | null;
1110
+ thread_id?: string | null;
1111
+ reply_to?: string | null;
1112
+ reply_to_title?: string | null;
1113
+ reply_to_agent_name?: string | null;
1114
+ stance?: string | null;
1115
+ sentiment: Record<string, unknown>;
1116
+ surface_scores: Array<Record<string, unknown>>;
1117
+ is_ad: boolean;
1118
+ source_uri?: string | null;
1119
+ source_host?: string | null;
1120
+ posted_by?: string | null;
1121
+ raw: Record<string, unknown>;
1122
+ }
1123
+ interface NetworkContentDetail {
1124
+ content_id: string;
1125
+ agent_id?: string | null;
1126
+ thread_id?: string | null;
1127
+ message_type?: string | null;
1128
+ visibility?: string | null;
1129
+ title?: string | null;
1130
+ body: Record<string, unknown>;
1131
+ claims: string[];
1132
+ evidence_refs: string[];
1133
+ trust_state?: string | null;
1134
+ confidence: number;
1135
+ created_at?: string | null;
1136
+ presentation: Record<string, unknown>;
1137
+ signal_packet: Record<string, unknown>;
1138
+ posted_by?: string | null;
1139
+ raw: Record<string, unknown>;
1140
+ }
1141
+ interface NetworkRepliesPage {
1142
+ replies: NetworkContentSummary[];
1143
+ context_head?: NetworkContentSummary | null;
1144
+ thread_summary?: string | null;
1145
+ thread_surface_scores: Array<Record<string, unknown>>;
1146
+ total_count: number;
1147
+ next_cursor?: string | null;
1148
+ raw: Record<string, unknown>;
1149
+ }
1150
+ interface NetworkClaimRecord {
1151
+ claim_id: string;
1152
+ claim_type?: string | null;
1153
+ normalized_text?: string | null;
1154
+ confidence: number;
1155
+ trust_state?: string | null;
1156
+ evidence_refs: string[];
1157
+ signal_packet: Record<string, unknown>;
1158
+ raw: Record<string, unknown>;
1159
+ }
1160
+ interface NetworkEvidenceRecord {
1161
+ evidence_id: string;
1162
+ evidence_type?: string | null;
1163
+ uri?: string | null;
1164
+ excerpt?: string | null;
1165
+ source_reliability: number;
1166
+ signal_packet: Record<string, unknown>;
1167
+ raw: Record<string, unknown>;
1168
+ }
1169
+ interface AgentTopicSubscription {
1170
+ topic_key: string;
1171
+ priority: number;
1172
+ raw: Record<string, unknown>;
1173
+ }
1174
+ interface AgentThreadRecord {
1175
+ thread_id: string;
1176
+ items: NetworkContentDetail[];
1177
+ raw: Record<string, unknown>;
1178
+ }
1179
+ declare const RefundReason: {
1180
+ readonly CUSTOMER_REQUEST: "customer-request";
1181
+ readonly DUPLICATE: "duplicate";
1182
+ readonly FRAUDULENT: "fraudulent";
1183
+ readonly SERVICE_FAILURE: "service-failure";
1184
+ readonly GOODWILL: "goodwill";
1185
+ };
1186
+ type RefundReason = (typeof RefundReason)[keyof typeof RefundReason];
1187
+ declare const DisputeResponse: {
1188
+ readonly ACCEPT: "accept";
1189
+ readonly CONTEST: "contest";
1190
+ };
1191
+ type DisputeResponse = (typeof DisputeResponse)[keyof typeof DisputeResponse];
1192
+ interface RefundRecord {
1193
+ refund_id: string;
1194
+ receipt_id: string;
1195
+ owner_user_id?: string | null;
1196
+ payment_mandate_id?: string | null;
1197
+ usage_event_id?: string | null;
1198
+ chain_receipt_id?: string | null;
1199
+ amount_minor: number;
1200
+ currency: string;
1201
+ status: string;
1202
+ reason_code: string;
1203
+ note?: string | null;
1204
+ idempotency_key?: string | null;
1205
+ on_chain_tx_hash?: string | null;
1206
+ metadata: Record<string, unknown>;
1207
+ idempotent_replay: boolean;
1208
+ created_at?: string | null;
1209
+ updated_at?: string | null;
1210
+ raw: Record<string, unknown>;
1211
+ }
1212
+ interface DisputeRecord {
1213
+ dispute_id: string;
1214
+ receipt_id: string;
1215
+ owner_user_id?: string | null;
1216
+ payment_mandate_id?: string | null;
1217
+ usage_event_id?: string | null;
1218
+ external_dispute_id?: string | null;
1219
+ status: string;
1220
+ reason_code: string;
1221
+ description?: string | null;
1222
+ evidence: Record<string, unknown>;
1223
+ response_decision?: string | null;
1224
+ response_note?: string | null;
1225
+ responded_at?: string | null;
1226
+ metadata: Record<string, unknown>;
1227
+ idempotent_replay: boolean;
1228
+ created_at?: string | null;
1229
+ updated_at?: string | null;
1230
+ raw: Record<string, unknown>;
1231
+ }
1232
+
1233
+ declare const WEBHOOK_EVENT_TYPES: readonly ["subscription.created", "subscription.renewed", "subscription.cancelled", "subscription.paused", "subscription.reinstated", "refund.issued", "payment.succeeded", "payment.failed", "payment.disputed", "capability.published", "capability.delisted", "execution.completed", "execution.failed"];
1234
+ type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[number];
1235
+ interface WebhookSubscriptionRecord {
1236
+ subscription_id: string;
1237
+ owner_user_id: string;
1238
+ callback_url: string;
1239
+ status: string;
1240
+ event_types: string[];
1241
+ description?: string | null;
1242
+ signing_secret_hint?: string | null;
1243
+ signing_secret?: string | null;
1244
+ metadata: Record<string, unknown>;
1245
+ last_delivery_at?: string | null;
1246
+ created_at?: string | null;
1247
+ updated_at?: string | null;
1248
+ raw: Record<string, unknown>;
1249
+ }
1250
+ interface WebhookDeliveryRecord {
1251
+ delivery_id: string;
1252
+ subscription_id: string;
1253
+ event_id: string;
1254
+ event_type: string;
1255
+ idempotency_key: string;
1256
+ callback_url: string;
1257
+ delivery_status: string;
1258
+ request_headers: Record<string, unknown>;
1259
+ request_body: Record<string, unknown>;
1260
+ response_status?: number | null;
1261
+ response_headers: Record<string, unknown>;
1262
+ response_body?: unknown;
1263
+ duration_ms?: number | null;
1264
+ attempt_count: number;
1265
+ last_attempt_at?: string | null;
1266
+ delivered_at?: string | null;
1267
+ error_message?: string | null;
1268
+ trace_id?: string | null;
1269
+ created_at?: string | null;
1270
+ updated_at?: string | null;
1271
+ raw: Record<string, unknown>;
1272
+ }
1273
+ interface WebhookEventBase<T extends WebhookEventType = WebhookEventType, D extends Record<string, unknown> = Record<string, unknown>> {
1274
+ id: string;
1275
+ type: T;
1276
+ api_version: string;
1277
+ occurred_at: string;
1278
+ idempotency_key: string;
1279
+ trace_id?: string | null;
1280
+ data: D;
1281
+ raw: Record<string, unknown>;
1282
+ }
1283
+ interface SubscriptionLifecycleEventData extends Record<string, unknown> {
1284
+ subscription_id?: string;
1285
+ access_grant_id?: string;
1286
+ listing_id?: string;
1287
+ capability_key?: string;
1288
+ buyer_user_id?: string;
1289
+ seller_user_id?: string;
1290
+ billing_model?: string;
1291
+ purchase_path?: string;
1292
+ currency?: string;
1293
+ amount_minor?: number;
1294
+ }
1295
+ interface RefundIssuedEventData extends Record<string, unknown> {
1296
+ refund_id?: string;
1297
+ receipt_id?: string;
1298
+ amount_minor?: number;
1299
+ currency?: string;
1300
+ status?: string;
1301
+ payment_mandate_id?: string;
1302
+ on_chain_tx_hash?: string;
1303
+ }
1304
+ interface PaymentEventData extends SubscriptionLifecycleEventData {
1305
+ payment_status?: string;
1306
+ }
1307
+ interface CapabilityEventData extends Record<string, unknown> {
1308
+ listing_id?: string;
1309
+ capability_key?: string;
1310
+ status?: string;
1311
+ previous_status?: string;
1312
+ owner_user_id?: string;
1313
+ published_at?: string;
1314
+ }
1315
+ interface ExecutionCompletedEventData extends Record<string, unknown> {
1316
+ usage_event_id?: string;
1317
+ access_grant_id?: string;
1318
+ listing_id?: string;
1319
+ capability_key?: string;
1320
+ agent_id?: string;
1321
+ execution_kind?: string;
1322
+ environment?: string;
1323
+ }
1324
+ interface ExecutionFailedEventData extends ExecutionCompletedEventData {
1325
+ reason_code?: string;
1326
+ reason?: string;
1327
+ }
1328
+ interface SubscriptionCreatedEvent extends WebhookEventBase<"subscription.created", SubscriptionLifecycleEventData> {
1329
+ }
1330
+ interface SubscriptionRenewedEvent extends WebhookEventBase<"subscription.renewed", SubscriptionLifecycleEventData> {
1331
+ }
1332
+ interface SubscriptionCancelledEvent extends WebhookEventBase<"subscription.cancelled", SubscriptionLifecycleEventData> {
1333
+ }
1334
+ interface SubscriptionPausedEvent extends WebhookEventBase<"subscription.paused", SubscriptionLifecycleEventData> {
1335
+ }
1336
+ interface SubscriptionReinstatedEvent extends WebhookEventBase<"subscription.reinstated", SubscriptionLifecycleEventData> {
1337
+ }
1338
+ interface RefundIssuedEvent extends WebhookEventBase<"refund.issued", RefundIssuedEventData> {
1339
+ }
1340
+ interface PaymentSucceededEvent extends WebhookEventBase<"payment.succeeded", PaymentEventData> {
1341
+ }
1342
+ interface PaymentFailedEvent extends WebhookEventBase<"payment.failed", PaymentEventData> {
1343
+ }
1344
+ interface PaymentDisputedEvent extends WebhookEventBase<"payment.disputed", PaymentEventData> {
1345
+ }
1346
+ interface CapabilityPublishedEvent extends WebhookEventBase<"capability.published", CapabilityEventData> {
1347
+ }
1348
+ interface CapabilityDelistedEvent extends WebhookEventBase<"capability.delisted", CapabilityEventData> {
1349
+ }
1350
+ interface ExecutionCompletedEvent extends WebhookEventBase<"execution.completed", ExecutionCompletedEventData> {
1351
+ }
1352
+ interface ExecutionFailedEvent extends WebhookEventBase<"execution.failed", ExecutionFailedEventData> {
1353
+ }
1354
+ type SiglumeWebhookEvent = SubscriptionCreatedEvent | SubscriptionRenewedEvent | SubscriptionCancelledEvent | SubscriptionPausedEvent | SubscriptionReinstatedEvent | RefundIssuedEvent | PaymentSucceededEvent | PaymentFailedEvent | PaymentDisputedEvent | CapabilityPublishedEvent | CapabilityDelistedEvent | ExecutionCompletedEvent | ExecutionFailedEvent;
1355
+ interface QueuedWebhookEvent {
1356
+ queued: boolean;
1357
+ event: SiglumeWebhookEvent;
1358
+ }
1359
+
1360
+ interface OperationMetadata {
1361
+ operation_key: string;
1362
+ summary: string;
1363
+ params_summary: string;
1364
+ page_href?: string | null;
1365
+ allowed_params: string[];
1366
+ required_params: string[];
1367
+ requires_params: boolean;
1368
+ param_types: Record<string, string>;
1369
+ permission_class: string;
1370
+ approval_mode: string;
1371
+ input_schema: Record<string, unknown>;
1372
+ output_schema: Record<string, unknown>;
1373
+ agent_id?: string | null;
1374
+ source: string;
1375
+ raw: Record<string, unknown>;
1376
+ }
1377
+ interface OperationExecution {
1378
+ agent_id: string;
1379
+ operation_key: string;
1380
+ message: string;
1381
+ action: string;
1382
+ result: Record<string, unknown>;
1383
+ status?: string;
1384
+ approval_required?: boolean;
1385
+ intent_id?: string | null;
1386
+ approval_status?: string | null;
1387
+ approval_snapshot_hash?: string | null;
1388
+ action_payload?: Record<string, unknown>;
1389
+ safety?: Record<string, unknown>;
1390
+ trace_id?: string | null;
1391
+ request_id?: string | null;
1392
+ raw: Record<string, unknown>;
1393
+ }
1394
+
1395
+ interface SiglumeClientShape {
1396
+ auto_register(manifest: AppManifest | Record<string, unknown>, tool_manual: ToolManual | Record<string, unknown>, options?: {
1397
+ source_code?: string;
1398
+ source_url?: string;
1399
+ runtime_validation?: Record<string, unknown>;
1400
+ metadata?: Record<string, unknown>;
1401
+ source_context?: Record<string, unknown>;
1402
+ input_form_spec?: Record<string, unknown>;
1403
+ }): Promise<AutoRegistrationReceipt>;
1404
+ confirm_registration(listing_id: string, options?: {
1405
+ manifest?: AppManifest | Record<string, unknown>;
1406
+ tool_manual?: ToolManual | Record<string, unknown>;
1407
+ }): Promise<RegistrationConfirmation>;
1408
+ preview_quality_score(tool_manual: ToolManual | Record<string, unknown>): Promise<ToolManualQualityReport>;
1409
+ submit_review(listing_id: string): Promise<AppListingRecord>;
1410
+ list_my_listings(options?: {
1411
+ status?: string;
1412
+ limit?: number;
1413
+ cursor?: string;
1414
+ }): Promise<CursorPage<AppListingRecord>>;
1415
+ get_listing(listing_id: string): Promise<AppListingRecord>;
1416
+ list_capabilities(options?: {
1417
+ mine?: boolean;
1418
+ status?: string;
1419
+ limit?: number;
1420
+ cursor?: string;
1421
+ }): Promise<CursorPage<AppListingRecord>>;
1422
+ list_bundles(options?: {
1423
+ mine?: boolean;
1424
+ status?: string;
1425
+ limit?: number;
1426
+ cursor?: string;
1427
+ }): Promise<CursorPage<BundleListingRecord>>;
1428
+ get_bundle(bundle_id: string): Promise<BundleListingRecord>;
1429
+ create_bundle(input: {
1430
+ bundle_key: string;
1431
+ display_name: string;
1432
+ description?: string;
1433
+ category?: string;
1434
+ price_model?: string;
1435
+ price_value_minor?: number;
1436
+ currency?: string;
1437
+ jurisdiction?: string;
1438
+ metadata?: Record<string, unknown>;
1439
+ }): Promise<BundleListingRecord>;
1440
+ update_bundle(bundle_id: string, patch: {
1441
+ display_name?: string;
1442
+ description?: string;
1443
+ category?: string;
1444
+ price_model?: string;
1445
+ price_value_minor?: number;
1446
+ currency?: string;
1447
+ jurisdiction?: string;
1448
+ metadata?: Record<string, unknown>;
1449
+ }): Promise<BundleListingRecord>;
1450
+ add_bundle_capability(bundle_id: string, input: {
1451
+ capability_listing_id: string;
1452
+ position?: number;
1453
+ }): Promise<BundleListingRecord>;
1454
+ remove_bundle_capability(bundle_id: string, capability_listing_id: string): Promise<BundleListingRecord>;
1455
+ submit_bundle_for_review(bundle_id: string): Promise<BundleListingRecord>;
1456
+ list_connected_account_providers(): Promise<ConnectedAccountProvider[]>;
1457
+ start_connected_account_oauth(input: {
1458
+ listing_id: string;
1459
+ redirect_uri: string;
1460
+ scopes?: string[];
1461
+ account_role?: string;
1462
+ }): Promise<ConnectedAccountOAuthStart>;
1463
+ set_listing_oauth_credentials(listing_id: string, input: {
1464
+ provider_key: string;
1465
+ client_id: string;
1466
+ client_secret: string;
1467
+ required_scopes?: string[];
1468
+ }): Promise<Record<string, unknown>>;
1469
+ get_listing_oauth_credentials_status(listing_id: string): Promise<Record<string, unknown>>;
1470
+ complete_connected_account_oauth(input: {
1471
+ state: string;
1472
+ code: string;
1473
+ }): Promise<Record<string, unknown>>;
1474
+ refresh_connected_account(account_id: string): Promise<ConnectedAccountLifecycleResult>;
1475
+ revoke_connected_account(account_id: string): Promise<ConnectedAccountLifecycleResult>;
1476
+ get_developer_portal(): Promise<DeveloperPortalSummary>;
1477
+ create_sandbox_session(options: {
1478
+ agent_id: string;
1479
+ capability_key: string;
1480
+ }): Promise<SandboxSession>;
1481
+ get_usage(options?: {
1482
+ capability_key?: string;
1483
+ agent_id?: string;
1484
+ outcome?: string;
1485
+ environment?: string;
1486
+ period_key?: string;
1487
+ limit?: number;
1488
+ cursor?: string;
1489
+ }): Promise<CursorPage<UsageEventRecord>>;
1490
+ list_agents(options?: {
1491
+ query?: string;
1492
+ limit?: number;
1493
+ }): Promise<AgentRecord[]>;
1494
+ list_operations(options?: {
1495
+ agent_id?: string;
1496
+ lang?: string;
1497
+ }): Promise<OperationMetadata[]>;
1498
+ get_operation_metadata(operation_key: string, options?: {
1499
+ agent_id?: string;
1500
+ lang?: string;
1501
+ }): Promise<OperationMetadata>;
1502
+ get_account_preferences(): Promise<AccountPreferences>;
1503
+ update_account_preferences(options: {
1504
+ language?: string;
1505
+ summary_depth?: string;
1506
+ notification_mode?: string;
1507
+ autonomy_level?: string;
1508
+ interest_profile?: Record<string, unknown>;
1509
+ consent_policy?: Record<string, unknown>;
1510
+ }): Promise<AccountPreferences>;
1511
+ get_account_plan(): Promise<AccountPlan>;
1512
+ start_plan_checkout(options: {
1513
+ target_tier: string;
1514
+ currency?: string;
1515
+ }): Promise<PlanCheckoutSession>;
1516
+ open_plan_billing_portal(): Promise<BillingPortalLink>;
1517
+ cancel_account_plan(): Promise<AccountPlanCancellation>;
1518
+ create_plan_web3_mandate(options: {
1519
+ target_tier: string;
1520
+ currency?: string;
1521
+ }): Promise<PlanWeb3Mandate>;
1522
+ cancel_plan_web3_mandate(): Promise<PlanWeb3Mandate>;
1523
+ get_account_watchlist(): Promise<AccountWatchlist>;
1524
+ update_account_watchlist(symbols: string[]): Promise<AccountWatchlist>;
1525
+ list_account_favorites(): Promise<FavoriteAgent[]>;
1526
+ add_account_favorite(agent_id: string): Promise<FavoriteAgentMutation>;
1527
+ remove_account_favorite(agent_id: string): Promise<FavoriteAgentMutation>;
1528
+ post_account_content_direct(text: string, options?: {
1529
+ lang?: string;
1530
+ }): Promise<AccountContentPostResult>;
1531
+ delete_account_content(content_id: string): Promise<AccountContentDeleteResult>;
1532
+ list_account_digests(options?: {
1533
+ cursor?: string;
1534
+ limit?: number;
1535
+ }): Promise<CursorPage<AccountDigestSummary>>;
1536
+ get_account_digest(digest_id: string): Promise<AccountDigest>;
1537
+ list_account_alerts(options?: {
1538
+ cursor?: string;
1539
+ limit?: number;
1540
+ }): Promise<CursorPage<AccountAlert>>;
1541
+ get_account_alert(alert_id: string): Promise<AccountAlert>;
1542
+ submit_account_feedback(ref_type: string, ref_id: string, feedback_type: string, options?: {
1543
+ reason?: string;
1544
+ }): Promise<AccountFeedbackSubmission>;
1545
+ get_network_home(options?: {
1546
+ lang?: string;
1547
+ feed?: string;
1548
+ cursor?: string;
1549
+ limit?: number;
1550
+ query?: string;
1551
+ }): Promise<CursorPage<NetworkContentSummary>>;
1552
+ get_network_content(content_id: string): Promise<NetworkContentDetail>;
1553
+ get_network_content_batch(content_ids: string[]): Promise<NetworkContentSummary[]>;
1554
+ list_network_content_replies(content_id: string, options?: {
1555
+ cursor?: string;
1556
+ limit?: number;
1557
+ }): Promise<NetworkRepliesPage>;
1558
+ get_network_claim(claim_id: string): Promise<NetworkClaimRecord>;
1559
+ get_network_evidence(evidence_id: string): Promise<NetworkEvidenceRecord>;
1560
+ get_agent_profile(): Promise<AgentRecord>;
1561
+ list_agent_topics(): Promise<AgentTopicSubscription[]>;
1562
+ get_agent_feed(): Promise<NetworkContentSummary[]>;
1563
+ get_agent_content(content_id: string): Promise<NetworkContentDetail>;
1564
+ get_agent_thread(thread_id: string): Promise<AgentThreadRecord>;
1565
+ get_agent(agent_id: string, options?: {
1566
+ lang?: string;
1567
+ tab?: string;
1568
+ cursor?: string;
1569
+ limit?: number;
1570
+ }): Promise<AgentRecord>;
1571
+ execute_owner_operation(agent_id: string, operation_key: string, params?: Record<string, unknown>, options?: {
1572
+ lang?: string;
1573
+ }): Promise<OperationExecution>;
1574
+ list_market_needs(options?: {
1575
+ agent_id?: string;
1576
+ status?: string;
1577
+ buyer_agent_id?: string;
1578
+ cursor?: string;
1579
+ limit?: number;
1580
+ lang?: string;
1581
+ }): Promise<CursorPage<MarketNeedRecord>>;
1582
+ get_market_need(need_id: string, options?: {
1583
+ agent_id?: string;
1584
+ lang?: string;
1585
+ }): Promise<MarketNeedRecord>;
1586
+ create_market_need(options: {
1587
+ agent_id?: string;
1588
+ buyer_agent_id?: string;
1589
+ title: string;
1590
+ problem_statement: string;
1591
+ category_key: string;
1592
+ budget_min_minor: number;
1593
+ budget_max_minor: number;
1594
+ urgency?: number;
1595
+ requirement_jsonb?: Record<string, unknown>;
1596
+ metadata?: Record<string, unknown>;
1597
+ status?: string;
1598
+ lang?: string;
1599
+ }): Promise<MarketNeedRecord>;
1600
+ update_market_need(need_id: string, options?: {
1601
+ agent_id?: string;
1602
+ buyer_agent_id?: string;
1603
+ title?: string;
1604
+ problem_statement?: string;
1605
+ category_key?: string;
1606
+ budget_min_minor?: number;
1607
+ budget_max_minor?: number;
1608
+ urgency?: number;
1609
+ requirement_jsonb?: Record<string, unknown>;
1610
+ metadata?: Record<string, unknown>;
1611
+ status?: string;
1612
+ lang?: string;
1613
+ }): Promise<MarketNeedRecord>;
1614
+ list_works_categories(options?: {
1615
+ agent_id?: string;
1616
+ lang?: string;
1617
+ }): Promise<WorksCategoryRecord[]>;
1618
+ get_works_registration(options?: {
1619
+ agent_id?: string;
1620
+ lang?: string;
1621
+ }): Promise<WorksRegistrationRecord>;
1622
+ register_for_works(options?: {
1623
+ agent_id?: string;
1624
+ tagline?: string;
1625
+ description?: string;
1626
+ categories?: string[];
1627
+ capabilities?: string[];
1628
+ lang?: string;
1629
+ }): Promise<WorksRegistrationRecord>;
1630
+ get_works_owner_dashboard(options?: {
1631
+ agent_id?: string;
1632
+ lang?: string;
1633
+ }): Promise<WorksOwnerDashboard>;
1634
+ get_works_poster_dashboard(options?: {
1635
+ agent_id?: string;
1636
+ lang?: string;
1637
+ }): Promise<WorksPosterDashboard>;
1638
+ list_market_proposals(options?: {
1639
+ agent_id?: string;
1640
+ status?: string;
1641
+ opportunity_id?: string;
1642
+ listing_id?: string;
1643
+ need_id?: string;
1644
+ seller_agent_id?: string;
1645
+ buyer_agent_id?: string;
1646
+ cursor?: string;
1647
+ limit?: number;
1648
+ lang?: string;
1649
+ }): Promise<CursorPage<MarketProposalRecord>>;
1650
+ get_market_proposal(proposal_id: string, options?: {
1651
+ agent_id?: string;
1652
+ lang?: string;
1653
+ }): Promise<MarketProposalRecord>;
1654
+ create_market_proposal(options: {
1655
+ agent_id?: string;
1656
+ opportunity_id: string;
1657
+ proposal_kind?: string;
1658
+ currency?: string;
1659
+ amount_minor?: number;
1660
+ proposed_terms_jsonb?: Record<string, unknown>;
1661
+ publish_to_thread?: boolean;
1662
+ thread_content_id?: string;
1663
+ reply_to_content_id?: string;
1664
+ note_title?: string;
1665
+ note_summary?: string;
1666
+ note_body?: string;
1667
+ note_visibility?: string;
1668
+ note_content_kind?: string;
1669
+ expires_at?: string;
1670
+ lang?: string;
1671
+ }): Promise<MarketProposalActionResult>;
1672
+ counter_market_proposal(proposal_id: string, options?: {
1673
+ agent_id?: string;
1674
+ proposal_kind?: string;
1675
+ proposed_terms_jsonb?: Record<string, unknown>;
1676
+ publish_to_thread?: boolean;
1677
+ thread_content_id?: string;
1678
+ reply_to_content_id?: string;
1679
+ note_title?: string;
1680
+ note_summary?: string;
1681
+ note_body?: string;
1682
+ note_visibility?: string;
1683
+ note_content_kind?: string;
1684
+ expires_at?: string;
1685
+ lang?: string;
1686
+ }): Promise<MarketProposalActionResult>;
1687
+ accept_market_proposal(proposal_id: string, options?: {
1688
+ agent_id?: string;
1689
+ comment?: string;
1690
+ publish_to_thread?: boolean;
1691
+ thread_content_id?: string;
1692
+ reply_to_content_id?: string;
1693
+ note_title?: string;
1694
+ note_summary?: string;
1695
+ note_visibility?: string;
1696
+ note_content_kind?: string;
1697
+ lang?: string;
1698
+ }): Promise<MarketProposalActionResult>;
1699
+ reject_market_proposal(proposal_id: string, options?: {
1700
+ agent_id?: string;
1701
+ comment?: string;
1702
+ lang?: string;
1703
+ }): Promise<MarketProposalActionResult>;
1704
+ list_installed_tools(options?: {
1705
+ agent_id?: string;
1706
+ lang?: string;
1707
+ }): Promise<InstalledToolRecord[]>;
1708
+ get_installed_tools_connection_readiness(options?: {
1709
+ agent_id?: string;
1710
+ lang?: string;
1711
+ }): Promise<InstalledToolConnectionReadiness>;
1712
+ update_installed_tool_binding_policy(binding_id: string, options?: {
1713
+ agent_id?: string;
1714
+ permission_class?: string;
1715
+ max_calls_per_day?: number;
1716
+ monthly_usage_cap?: number;
1717
+ max_spend_per_execution?: number;
1718
+ allowed_tasks_jsonb?: string[];
1719
+ allowed_source_types_jsonb?: string[];
1720
+ timeout_ms?: number;
1721
+ cooldown_seconds?: number;
1722
+ require_owner_approval?: boolean;
1723
+ require_owner_approval_over_cost?: number;
1724
+ dry_run_only?: boolean;
1725
+ retry_policy_jsonb?: Record<string, unknown>;
1726
+ fallback_mode?: string;
1727
+ auto_execute_read_only?: boolean;
1728
+ allow_background_execution?: boolean;
1729
+ max_calls_per_hour?: number;
1730
+ max_chain_steps?: number;
1731
+ max_parallel_executions?: number;
1732
+ max_spend_usd_cents_per_day?: number;
1733
+ approval_mode?: string;
1734
+ kill_switch_state?: string;
1735
+ allowed_connected_account_ids_jsonb?: string[];
1736
+ metadata_jsonb?: Record<string, unknown>;
1737
+ lang?: string;
1738
+ }): Promise<InstalledToolPolicyUpdateResult>;
1739
+ get_installed_tool_execution(intent_id: string, options?: {
1740
+ agent_id?: string;
1741
+ lang?: string;
1742
+ }): Promise<InstalledToolExecutionRecord>;
1743
+ list_installed_tool_receipts(options?: {
1744
+ agent_id?: string;
1745
+ receipt_agent_id?: string;
1746
+ status?: string;
1747
+ limit?: number;
1748
+ offset?: number;
1749
+ lang?: string;
1750
+ }): Promise<InstalledToolReceiptRecord[]>;
1751
+ get_installed_tool_receipt(receipt_id: string, options?: {
1752
+ agent_id?: string;
1753
+ lang?: string;
1754
+ }): Promise<InstalledToolReceiptRecord>;
1755
+ get_installed_tool_receipt_steps(receipt_id: string, options?: {
1756
+ agent_id?: string;
1757
+ lang?: string;
1758
+ }): Promise<InstalledToolReceiptStepRecord[]>;
1759
+ get_partner_dashboard(options?: {
1760
+ agent_id?: string;
1761
+ lang?: string;
1762
+ }): Promise<PartnerDashboard>;
1763
+ get_partner_usage(options?: {
1764
+ agent_id?: string;
1765
+ lang?: string;
1766
+ }): Promise<PartnerUsage>;
1767
+ list_partner_api_keys(options?: {
1768
+ agent_id?: string;
1769
+ lang?: string;
1770
+ }): Promise<PartnerApiKeyRecord[]>;
1771
+ create_partner_api_key(options?: {
1772
+ agent_id?: string;
1773
+ name?: string;
1774
+ allowed_source_types?: string[];
1775
+ lang?: string;
1776
+ }): Promise<PartnerApiKeyHandle>;
1777
+ get_ads_billing(options?: {
1778
+ agent_id?: string;
1779
+ rail?: string;
1780
+ lang?: string;
1781
+ }): Promise<AdsBilling>;
1782
+ settle_ads_billing(options?: {
1783
+ agent_id?: string;
1784
+ lang?: string;
1785
+ }): Promise<AdsBillingSettlement>;
1786
+ get_ads_profile(options?: {
1787
+ agent_id?: string;
1788
+ lang?: string;
1789
+ }): Promise<AdsProfile>;
1790
+ list_ads_campaigns(options?: {
1791
+ agent_id?: string;
1792
+ lang?: string;
1793
+ }): Promise<AdsCampaignRecord[]>;
1794
+ list_ads_campaign_posts(campaign_id: string, options?: {
1795
+ agent_id?: string;
1796
+ lang?: string;
1797
+ }): Promise<AdsCampaignPostRecord[]>;
1798
+ update_agent_charter(agent_id: string, charter_text: string, options?: {
1799
+ role?: string;
1800
+ target_profile?: Record<string, unknown>;
1801
+ qualification_criteria?: Record<string, unknown>;
1802
+ success_metrics?: Record<string, unknown>;
1803
+ constraints?: Record<string, unknown>;
1804
+ wait_for_completion?: boolean;
1805
+ }): Promise<AgentCharter>;
1806
+ update_approval_policy(agent_id: string, policy: Record<string, unknown>, options?: {
1807
+ wait_for_completion?: boolean;
1808
+ }): Promise<ApprovalPolicy>;
1809
+ update_budget_policy(agent_id: string, policy: Record<string, unknown>, options?: {
1810
+ wait_for_completion?: boolean;
1811
+ }): Promise<BudgetPolicy>;
1812
+ list_access_grants(options?: {
1813
+ status?: string;
1814
+ agent_id?: string;
1815
+ limit?: number;
1816
+ cursor?: string;
1817
+ }): Promise<CursorPage<AccessGrantRecord>>;
1818
+ bind_agent_to_grant(grant_id: string, options: {
1819
+ agent_id: string;
1820
+ binding_status?: string;
1821
+ }): Promise<GrantBindingResult>;
1822
+ list_connected_accounts(options?: {
1823
+ provider_key?: string;
1824
+ environment?: string;
1825
+ limit?: number;
1826
+ cursor?: string;
1827
+ }): Promise<CursorPage<ConnectedAccountRecord>>;
1828
+ create_support_case(subject: string, body: string, options?: {
1829
+ trace_id?: string;
1830
+ case_type?: string;
1831
+ capability_key?: string;
1832
+ agent_id?: string;
1833
+ environment?: string;
1834
+ }): Promise<SupportCaseRecord>;
1835
+ list_support_cases(options?: {
1836
+ capability_key?: string;
1837
+ trace_id?: string;
1838
+ status?: string;
1839
+ limit?: number;
1840
+ cursor?: string;
1841
+ }): Promise<CursorPage<SupportCaseRecord>>;
1842
+ issue_partial_refund(options: {
1843
+ receipt_id: string;
1844
+ amount_minor: number;
1845
+ reason?: RefundReason | string;
1846
+ note?: string;
1847
+ idempotency_key: string;
1848
+ original_amount_minor?: number;
1849
+ }): Promise<RefundRecord>;
1850
+ issue_full_refund(options: {
1851
+ receipt_id: string;
1852
+ reason?: RefundReason | string;
1853
+ note?: string;
1854
+ idempotency_key?: string;
1855
+ }): Promise<RefundRecord>;
1856
+ list_refunds(options?: {
1857
+ receipt_id?: string;
1858
+ limit?: number;
1859
+ }): Promise<RefundRecord[]>;
1860
+ get_refund(refund_id: string): Promise<RefundRecord>;
1861
+ get_refunds_for_receipt(receipt_id: string, options?: {
1862
+ limit?: number;
1863
+ }): Promise<RefundRecord[]>;
1864
+ list_disputes(options?: {
1865
+ receipt_id?: string;
1866
+ limit?: number;
1867
+ }): Promise<DisputeRecord[]>;
1868
+ get_dispute(dispute_id: string): Promise<DisputeRecord>;
1869
+ respond_to_dispute(options: {
1870
+ dispute_id: string;
1871
+ response: DisputeResponse | string;
1872
+ evidence: Record<string, unknown>;
1873
+ note?: string;
1874
+ }): Promise<DisputeRecord>;
1875
+ create_webhook_subscription(options: {
1876
+ callback_url: string;
1877
+ description?: string;
1878
+ event_types: string[];
1879
+ metadata?: Record<string, unknown>;
1880
+ }): Promise<WebhookSubscriptionRecord>;
1881
+ list_webhook_subscriptions(): Promise<WebhookSubscriptionRecord[]>;
1882
+ get_webhook_subscription(subscription_id: string): Promise<WebhookSubscriptionRecord>;
1883
+ rotate_webhook_subscription_secret(subscription_id: string): Promise<WebhookSubscriptionRecord>;
1884
+ pause_webhook_subscription(subscription_id: string): Promise<WebhookSubscriptionRecord>;
1885
+ resume_webhook_subscription(subscription_id: string): Promise<WebhookSubscriptionRecord>;
1886
+ list_webhook_deliveries(options?: {
1887
+ subscription_id?: string;
1888
+ event_type?: string;
1889
+ status?: string;
1890
+ limit?: number;
1891
+ }): Promise<WebhookDeliveryRecord[]>;
1892
+ redeliver_webhook_delivery(delivery_id: string): Promise<WebhookDeliveryRecord>;
1893
+ send_test_webhook_delivery(options: {
1894
+ event_type: string;
1895
+ subscription_ids?: string[];
1896
+ data?: Record<string, unknown>;
1897
+ }): Promise<QueuedWebhookEvent>;
1898
+ list_polygon_mandates(options?: {
1899
+ status?: string;
1900
+ purpose?: string;
1901
+ limit?: number;
1902
+ }): Promise<PolygonMandate[]>;
1903
+ get_polygon_mandate(mandate_id: string, options?: {
1904
+ status?: string;
1905
+ purpose?: string;
1906
+ limit?: number;
1907
+ }): Promise<PolygonMandate>;
1908
+ list_settlement_receipts(options?: {
1909
+ receipt_kind?: string;
1910
+ limit?: number;
1911
+ }): Promise<SettlementReceipt[]>;
1912
+ get_settlement_receipt(receipt_id: string, options?: {
1913
+ receipt_kind?: string;
1914
+ limit?: number;
1915
+ }): Promise<SettlementReceipt>;
1916
+ get_embedded_wallet_charge(options: {
1917
+ tx_hash: string;
1918
+ limit?: number;
1919
+ }): Promise<EmbeddedWalletCharge>;
1920
+ get_cross_currency_quote(options: {
1921
+ from_currency: string;
1922
+ to_currency: string;
1923
+ source_amount_minor: number;
1924
+ slippage_bps?: number;
1925
+ }): Promise<CrossCurrencyQuote>;
1926
+ }
1927
+
1928
+ interface CliProjectDependencies {
1929
+ env?: Record<string, string | undefined>;
1930
+ client_factory?: (api_key: string, base_url?: string) => SiglumeClientShape;
1931
+ }
1932
+
1933
+ interface CliRunDependencies extends CliProjectDependencies {
1934
+ stdout?: (line: string) => void;
1935
+ stderr?: (line: string) => void;
1936
+ }
1937
+ declare function runCli(argv: string[], deps?: CliRunDependencies): Promise<number>;
1938
+
1939
+ export { type CliRunDependencies, runCli };