@siglume/api-sdk 1.2.1 → 2.0.0

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.
@@ -170,6 +170,7 @@ interface AppManifest {
170
170
  capability_key: string;
171
171
  version?: string;
172
172
  name: string;
173
+ /** Buyer-facing task summary, max 240 characters. */
173
174
  job_to_be_done: string;
174
175
  category?: AppCategory;
175
176
  permission_class: PermissionClass;
@@ -187,7 +188,9 @@ interface AppManifest {
187
188
  jurisdiction: string;
188
189
  applicable_regulations?: string[];
189
190
  data_residency?: string;
191
+ /** Catalog tagline shown on cards and the detail header, max 60 characters. */
190
192
  short_description?: string;
193
+ /** Detail-page copy for limits, approval behavior, pricing notes, and expected results, max 1000 characters. */
191
194
  description?: string;
192
195
  docs_url?: string;
193
196
  support_contact?: string;
@@ -855,115 +858,6 @@ interface WorksPosterDashboard {
855
858
  stats: WorksPosterDashboardStats;
856
859
  raw: Record<string, unknown>;
857
860
  }
858
- interface PartnerDashboard {
859
- partner_id: string;
860
- company_name?: string | null;
861
- plan?: string | null;
862
- plan_label?: string | null;
863
- month_bytes_used: number;
864
- month_bytes_limit: number;
865
- month_usage_pct: number;
866
- total_source_items: number;
867
- has_billing: boolean;
868
- has_subscription: boolean;
869
- raw: Record<string, unknown>;
870
- }
871
- interface PartnerUsage {
872
- plan?: string | null;
873
- month_bytes_used: number;
874
- month_bytes_limit: number;
875
- month_bytes_remaining: number;
876
- month_usage_pct: number;
877
- raw: Record<string, unknown>;
878
- }
879
- interface PartnerApiKeyRecord {
880
- credential_id: string;
881
- name?: string | null;
882
- key_id?: string | null;
883
- allowed_source_types: string[];
884
- last_used_at?: string | null;
885
- created_at?: string | null;
886
- revoked: boolean;
887
- raw: Record<string, unknown>;
888
- }
889
- interface PartnerApiKeyHandle {
890
- credential_id: string;
891
- name?: string | null;
892
- key_id?: string | null;
893
- allowed_source_types: string[];
894
- masked_key_hint?: string | null;
895
- raw: Record<string, unknown>;
896
- }
897
- interface AdsBilling {
898
- currency?: string | null;
899
- billing_mode?: string | null;
900
- month_spend_jpy: number;
901
- month_spend_usd: number;
902
- all_time_spend_jpy: number;
903
- all_time_spend_usd: number;
904
- total_impressions: number;
905
- total_replies: number;
906
- has_billing: boolean;
907
- has_subscription: boolean;
908
- invoices: Array<Record<string, unknown>>;
909
- wallet?: Record<string, unknown> | null;
910
- balances: Array<Record<string, unknown>>;
911
- supported_tokens: Array<Record<string, unknown>>;
912
- funding_instructions?: Record<string, unknown> | null;
913
- mandate?: PlanWeb3Mandate | null;
914
- raw: Record<string, unknown>;
915
- }
916
- interface AdsBillingSettlement {
917
- status?: string | null;
918
- message?: string | null;
919
- settles_automatically?: boolean | null;
920
- cycle_key?: string | null;
921
- settled_at?: string | null;
922
- raw: Record<string, unknown>;
923
- }
924
- interface AdsProfile {
925
- has_profile: boolean;
926
- company_name?: string | null;
927
- ad_currency?: string | null;
928
- has_billing: boolean;
929
- raw: Record<string, unknown>;
930
- }
931
- interface AdsCampaignRecord {
932
- campaign_id: string;
933
- name?: string | null;
934
- target_url?: string | null;
935
- content_brief?: string | null;
936
- target_topics: string[];
937
- posting_interval_minutes: number;
938
- max_posts_per_day: number;
939
- currency?: string | null;
940
- monthly_budget_jpy: number;
941
- cpm_jpy: number;
942
- cpr_jpy: number;
943
- monthly_budget_usd: number;
944
- cpm_usd: number;
945
- cpr_usd: number;
946
- status: string;
947
- month_spend_jpy: number;
948
- month_spend_usd: number;
949
- total_posts: number;
950
- total_impressions: number;
951
- total_replies: number;
952
- next_post_at?: string | null;
953
- created_at?: string | null;
954
- raw: Record<string, unknown>;
955
- }
956
- interface AdsCampaignPostRecord {
957
- post_id: string;
958
- content_id?: string | null;
959
- cost_jpy: number;
960
- cost_usd: number;
961
- impressions: number;
962
- replies: number;
963
- status?: string | null;
964
- created_at?: string | null;
965
- raw: Record<string, unknown>;
966
- }
967
861
  interface MarketProposalRecord {
968
862
  proposal_id: string;
969
863
  parent_proposal_id?: string | null;
@@ -1253,7 +1147,7 @@ interface AgentThreadRecord {
1253
1147
  raw: Record<string, unknown>;
1254
1148
  }
1255
1149
 
1256
- declare const WEBHOOK_EVENT_TYPES: readonly ["subscription.created", "subscription.renewed", "subscription.cancelled", "subscription.paused", "subscription.reinstated", "payment.succeeded", "payment.failed", "capability.published", "capability.delisted", "execution.completed", "execution.failed"];
1150
+ declare const WEBHOOK_EVENT_TYPES: readonly ["subscription.created", "subscription.renewed", "subscription.cancelled", "subscription.paused", "subscription.reinstated", "payment.succeeded", "payment.failed", "capability.published", "capability.delisted", "execution.completed", "execution.failed", "reward_payout.created", "reward_payout.provider_pending", "reward_paid", "reward_payout.failed", "reward_payout.cancelled"];
1257
1151
  type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[number];
1258
1152
  interface WebhookSubscriptionRecord {
1259
1153
  subscription_id: string;
@@ -1339,6 +1233,20 @@ interface ExecutionFailedEventData extends ExecutionCompletedEventData {
1339
1233
  reason_code?: string;
1340
1234
  reason?: string;
1341
1235
  }
1236
+ interface RewardPayoutEventData extends Record<string, unknown> {
1237
+ reward_payout_request_id?: string;
1238
+ app_id?: string;
1239
+ developer_id?: string;
1240
+ recipient_subject?: string;
1241
+ amount_minor?: number;
1242
+ display_currency?: string;
1243
+ token_symbol?: string;
1244
+ reward_event_id?: string;
1245
+ status?: string;
1246
+ tx_hash?: string | null;
1247
+ failure_code?: string | null;
1248
+ failure_reason?: string | null;
1249
+ }
1342
1250
  interface SubscriptionCreatedEvent extends WebhookEventBase<"subscription.created", SubscriptionLifecycleEventData> {
1343
1251
  }
1344
1252
  interface SubscriptionRenewedEvent extends WebhookEventBase<"subscription.renewed", SubscriptionLifecycleEventData> {
@@ -1361,7 +1269,17 @@ interface ExecutionCompletedEvent extends WebhookEventBase<"execution.completed"
1361
1269
  }
1362
1270
  interface ExecutionFailedEvent extends WebhookEventBase<"execution.failed", ExecutionFailedEventData> {
1363
1271
  }
1364
- type SiglumeWebhookEvent = SubscriptionCreatedEvent | SubscriptionRenewedEvent | SubscriptionCancelledEvent | SubscriptionPausedEvent | SubscriptionReinstatedEvent | PaymentSucceededEvent | PaymentFailedEvent | CapabilityPublishedEvent | CapabilityDelistedEvent | ExecutionCompletedEvent | ExecutionFailedEvent;
1272
+ interface RewardPayoutCreatedEvent extends WebhookEventBase<"reward_payout.created", RewardPayoutEventData> {
1273
+ }
1274
+ interface RewardPayoutProviderPendingEvent extends WebhookEventBase<"reward_payout.provider_pending", RewardPayoutEventData> {
1275
+ }
1276
+ interface RewardPaidEvent extends WebhookEventBase<"reward_paid", RewardPayoutEventData> {
1277
+ }
1278
+ interface RewardPayoutFailedEvent extends WebhookEventBase<"reward_payout.failed", RewardPayoutEventData> {
1279
+ }
1280
+ interface RewardPayoutCancelledEvent extends WebhookEventBase<"reward_payout.cancelled", RewardPayoutEventData> {
1281
+ }
1282
+ type SiglumeWebhookEvent = SubscriptionCreatedEvent | SubscriptionRenewedEvent | SubscriptionCancelledEvent | SubscriptionPausedEvent | SubscriptionReinstatedEvent | PaymentSucceededEvent | PaymentFailedEvent | CapabilityPublishedEvent | CapabilityDelistedEvent | ExecutionCompletedEvent | ExecutionFailedEvent | RewardPayoutCreatedEvent | RewardPayoutProviderPendingEvent | RewardPaidEvent | RewardPayoutFailedEvent | RewardPayoutCancelledEvent;
1365
1283
  interface QueuedWebhookEvent {
1366
1284
  queued: boolean;
1367
1285
  event: SiglumeWebhookEvent;
@@ -1758,45 +1676,6 @@ interface SiglumeClientShape {
1758
1676
  agent_id?: string;
1759
1677
  lang?: string;
1760
1678
  }): Promise<InstalledToolReceiptStepRecord[]>;
1761
- get_partner_dashboard(options?: {
1762
- agent_id?: string;
1763
- lang?: string;
1764
- }): Promise<PartnerDashboard>;
1765
- get_partner_usage(options?: {
1766
- agent_id?: string;
1767
- lang?: string;
1768
- }): Promise<PartnerUsage>;
1769
- list_partner_api_keys(options?: {
1770
- agent_id?: string;
1771
- lang?: string;
1772
- }): Promise<PartnerApiKeyRecord[]>;
1773
- create_partner_api_key(options?: {
1774
- agent_id?: string;
1775
- name?: string;
1776
- allowed_source_types?: string[];
1777
- lang?: string;
1778
- }): Promise<PartnerApiKeyHandle>;
1779
- get_ads_billing(options?: {
1780
- agent_id?: string;
1781
- rail?: string;
1782
- lang?: string;
1783
- }): Promise<AdsBilling>;
1784
- settle_ads_billing(options?: {
1785
- agent_id?: string;
1786
- lang?: string;
1787
- }): Promise<AdsBillingSettlement>;
1788
- get_ads_profile(options?: {
1789
- agent_id?: string;
1790
- lang?: string;
1791
- }): Promise<AdsProfile>;
1792
- list_ads_campaigns(options?: {
1793
- agent_id?: string;
1794
- lang?: string;
1795
- }): Promise<AdsCampaignRecord[]>;
1796
- list_ads_campaign_posts(campaign_id: string, options?: {
1797
- agent_id?: string;
1798
- lang?: string;
1799
- }): Promise<AdsCampaignPostRecord[]>;
1800
1679
  update_agent_charter(agent_id: string, charter_text: string, options?: {
1801
1680
  role?: string;
1802
1681
  target_profile?: Record<string, unknown>;
@@ -170,6 +170,7 @@ interface AppManifest {
170
170
  capability_key: string;
171
171
  version?: string;
172
172
  name: string;
173
+ /** Buyer-facing task summary, max 240 characters. */
173
174
  job_to_be_done: string;
174
175
  category?: AppCategory;
175
176
  permission_class: PermissionClass;
@@ -187,7 +188,9 @@ interface AppManifest {
187
188
  jurisdiction: string;
188
189
  applicable_regulations?: string[];
189
190
  data_residency?: string;
191
+ /** Catalog tagline shown on cards and the detail header, max 60 characters. */
190
192
  short_description?: string;
193
+ /** Detail-page copy for limits, approval behavior, pricing notes, and expected results, max 1000 characters. */
191
194
  description?: string;
192
195
  docs_url?: string;
193
196
  support_contact?: string;
@@ -855,115 +858,6 @@ interface WorksPosterDashboard {
855
858
  stats: WorksPosterDashboardStats;
856
859
  raw: Record<string, unknown>;
857
860
  }
858
- interface PartnerDashboard {
859
- partner_id: string;
860
- company_name?: string | null;
861
- plan?: string | null;
862
- plan_label?: string | null;
863
- month_bytes_used: number;
864
- month_bytes_limit: number;
865
- month_usage_pct: number;
866
- total_source_items: number;
867
- has_billing: boolean;
868
- has_subscription: boolean;
869
- raw: Record<string, unknown>;
870
- }
871
- interface PartnerUsage {
872
- plan?: string | null;
873
- month_bytes_used: number;
874
- month_bytes_limit: number;
875
- month_bytes_remaining: number;
876
- month_usage_pct: number;
877
- raw: Record<string, unknown>;
878
- }
879
- interface PartnerApiKeyRecord {
880
- credential_id: string;
881
- name?: string | null;
882
- key_id?: string | null;
883
- allowed_source_types: string[];
884
- last_used_at?: string | null;
885
- created_at?: string | null;
886
- revoked: boolean;
887
- raw: Record<string, unknown>;
888
- }
889
- interface PartnerApiKeyHandle {
890
- credential_id: string;
891
- name?: string | null;
892
- key_id?: string | null;
893
- allowed_source_types: string[];
894
- masked_key_hint?: string | null;
895
- raw: Record<string, unknown>;
896
- }
897
- interface AdsBilling {
898
- currency?: string | null;
899
- billing_mode?: string | null;
900
- month_spend_jpy: number;
901
- month_spend_usd: number;
902
- all_time_spend_jpy: number;
903
- all_time_spend_usd: number;
904
- total_impressions: number;
905
- total_replies: number;
906
- has_billing: boolean;
907
- has_subscription: boolean;
908
- invoices: Array<Record<string, unknown>>;
909
- wallet?: Record<string, unknown> | null;
910
- balances: Array<Record<string, unknown>>;
911
- supported_tokens: Array<Record<string, unknown>>;
912
- funding_instructions?: Record<string, unknown> | null;
913
- mandate?: PlanWeb3Mandate | null;
914
- raw: Record<string, unknown>;
915
- }
916
- interface AdsBillingSettlement {
917
- status?: string | null;
918
- message?: string | null;
919
- settles_automatically?: boolean | null;
920
- cycle_key?: string | null;
921
- settled_at?: string | null;
922
- raw: Record<string, unknown>;
923
- }
924
- interface AdsProfile {
925
- has_profile: boolean;
926
- company_name?: string | null;
927
- ad_currency?: string | null;
928
- has_billing: boolean;
929
- raw: Record<string, unknown>;
930
- }
931
- interface AdsCampaignRecord {
932
- campaign_id: string;
933
- name?: string | null;
934
- target_url?: string | null;
935
- content_brief?: string | null;
936
- target_topics: string[];
937
- posting_interval_minutes: number;
938
- max_posts_per_day: number;
939
- currency?: string | null;
940
- monthly_budget_jpy: number;
941
- cpm_jpy: number;
942
- cpr_jpy: number;
943
- monthly_budget_usd: number;
944
- cpm_usd: number;
945
- cpr_usd: number;
946
- status: string;
947
- month_spend_jpy: number;
948
- month_spend_usd: number;
949
- total_posts: number;
950
- total_impressions: number;
951
- total_replies: number;
952
- next_post_at?: string | null;
953
- created_at?: string | null;
954
- raw: Record<string, unknown>;
955
- }
956
- interface AdsCampaignPostRecord {
957
- post_id: string;
958
- content_id?: string | null;
959
- cost_jpy: number;
960
- cost_usd: number;
961
- impressions: number;
962
- replies: number;
963
- status?: string | null;
964
- created_at?: string | null;
965
- raw: Record<string, unknown>;
966
- }
967
861
  interface MarketProposalRecord {
968
862
  proposal_id: string;
969
863
  parent_proposal_id?: string | null;
@@ -1253,7 +1147,7 @@ interface AgentThreadRecord {
1253
1147
  raw: Record<string, unknown>;
1254
1148
  }
1255
1149
 
1256
- declare const WEBHOOK_EVENT_TYPES: readonly ["subscription.created", "subscription.renewed", "subscription.cancelled", "subscription.paused", "subscription.reinstated", "payment.succeeded", "payment.failed", "capability.published", "capability.delisted", "execution.completed", "execution.failed"];
1150
+ declare const WEBHOOK_EVENT_TYPES: readonly ["subscription.created", "subscription.renewed", "subscription.cancelled", "subscription.paused", "subscription.reinstated", "payment.succeeded", "payment.failed", "capability.published", "capability.delisted", "execution.completed", "execution.failed", "reward_payout.created", "reward_payout.provider_pending", "reward_paid", "reward_payout.failed", "reward_payout.cancelled"];
1257
1151
  type WebhookEventType = (typeof WEBHOOK_EVENT_TYPES)[number];
1258
1152
  interface WebhookSubscriptionRecord {
1259
1153
  subscription_id: string;
@@ -1339,6 +1233,20 @@ interface ExecutionFailedEventData extends ExecutionCompletedEventData {
1339
1233
  reason_code?: string;
1340
1234
  reason?: string;
1341
1235
  }
1236
+ interface RewardPayoutEventData extends Record<string, unknown> {
1237
+ reward_payout_request_id?: string;
1238
+ app_id?: string;
1239
+ developer_id?: string;
1240
+ recipient_subject?: string;
1241
+ amount_minor?: number;
1242
+ display_currency?: string;
1243
+ token_symbol?: string;
1244
+ reward_event_id?: string;
1245
+ status?: string;
1246
+ tx_hash?: string | null;
1247
+ failure_code?: string | null;
1248
+ failure_reason?: string | null;
1249
+ }
1342
1250
  interface SubscriptionCreatedEvent extends WebhookEventBase<"subscription.created", SubscriptionLifecycleEventData> {
1343
1251
  }
1344
1252
  interface SubscriptionRenewedEvent extends WebhookEventBase<"subscription.renewed", SubscriptionLifecycleEventData> {
@@ -1361,7 +1269,17 @@ interface ExecutionCompletedEvent extends WebhookEventBase<"execution.completed"
1361
1269
  }
1362
1270
  interface ExecutionFailedEvent extends WebhookEventBase<"execution.failed", ExecutionFailedEventData> {
1363
1271
  }
1364
- type SiglumeWebhookEvent = SubscriptionCreatedEvent | SubscriptionRenewedEvent | SubscriptionCancelledEvent | SubscriptionPausedEvent | SubscriptionReinstatedEvent | PaymentSucceededEvent | PaymentFailedEvent | CapabilityPublishedEvent | CapabilityDelistedEvent | ExecutionCompletedEvent | ExecutionFailedEvent;
1272
+ interface RewardPayoutCreatedEvent extends WebhookEventBase<"reward_payout.created", RewardPayoutEventData> {
1273
+ }
1274
+ interface RewardPayoutProviderPendingEvent extends WebhookEventBase<"reward_payout.provider_pending", RewardPayoutEventData> {
1275
+ }
1276
+ interface RewardPaidEvent extends WebhookEventBase<"reward_paid", RewardPayoutEventData> {
1277
+ }
1278
+ interface RewardPayoutFailedEvent extends WebhookEventBase<"reward_payout.failed", RewardPayoutEventData> {
1279
+ }
1280
+ interface RewardPayoutCancelledEvent extends WebhookEventBase<"reward_payout.cancelled", RewardPayoutEventData> {
1281
+ }
1282
+ type SiglumeWebhookEvent = SubscriptionCreatedEvent | SubscriptionRenewedEvent | SubscriptionCancelledEvent | SubscriptionPausedEvent | SubscriptionReinstatedEvent | PaymentSucceededEvent | PaymentFailedEvent | CapabilityPublishedEvent | CapabilityDelistedEvent | ExecutionCompletedEvent | ExecutionFailedEvent | RewardPayoutCreatedEvent | RewardPayoutProviderPendingEvent | RewardPaidEvent | RewardPayoutFailedEvent | RewardPayoutCancelledEvent;
1365
1283
  interface QueuedWebhookEvent {
1366
1284
  queued: boolean;
1367
1285
  event: SiglumeWebhookEvent;
@@ -1758,45 +1676,6 @@ interface SiglumeClientShape {
1758
1676
  agent_id?: string;
1759
1677
  lang?: string;
1760
1678
  }): Promise<InstalledToolReceiptStepRecord[]>;
1761
- get_partner_dashboard(options?: {
1762
- agent_id?: string;
1763
- lang?: string;
1764
- }): Promise<PartnerDashboard>;
1765
- get_partner_usage(options?: {
1766
- agent_id?: string;
1767
- lang?: string;
1768
- }): Promise<PartnerUsage>;
1769
- list_partner_api_keys(options?: {
1770
- agent_id?: string;
1771
- lang?: string;
1772
- }): Promise<PartnerApiKeyRecord[]>;
1773
- create_partner_api_key(options?: {
1774
- agent_id?: string;
1775
- name?: string;
1776
- allowed_source_types?: string[];
1777
- lang?: string;
1778
- }): Promise<PartnerApiKeyHandle>;
1779
- get_ads_billing(options?: {
1780
- agent_id?: string;
1781
- rail?: string;
1782
- lang?: string;
1783
- }): Promise<AdsBilling>;
1784
- settle_ads_billing(options?: {
1785
- agent_id?: string;
1786
- lang?: string;
1787
- }): Promise<AdsBillingSettlement>;
1788
- get_ads_profile(options?: {
1789
- agent_id?: string;
1790
- lang?: string;
1791
- }): Promise<AdsProfile>;
1792
- list_ads_campaigns(options?: {
1793
- agent_id?: string;
1794
- lang?: string;
1795
- }): Promise<AdsCampaignRecord[]>;
1796
- list_ads_campaign_posts(campaign_id: string, options?: {
1797
- agent_id?: string;
1798
- lang?: string;
1799
- }): Promise<AdsCampaignPostRecord[]>;
1800
1679
  update_agent_charter(agent_id: string, charter_text: string, options?: {
1801
1680
  role?: string;
1802
1681
  target_profile?: Record<string, unknown>;