@1claw/sdk 0.33.0 → 0.34.1

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.
@@ -1742,6 +1742,34 @@ export interface paths {
1742
1742
  patch?: never;
1743
1743
  trace?: never;
1744
1744
  };
1745
+ "/v1/org/bankr-config": {
1746
+ parameters: {
1747
+ query?: never;
1748
+ header?: never;
1749
+ path?: never;
1750
+ cookie?: never;
1751
+ };
1752
+ /**
1753
+ * Get org Bankr partner configuration
1754
+ * @description Returns whether the org has configured Bankr BYOK (partner key prefix and default wallet only — never the secret). Users only.
1755
+ */
1756
+ get: operations["getOrgBankrConfig"];
1757
+ /**
1758
+ * Set org Bankr partner configuration
1759
+ * @description Store or replace the org's Bankr partner key (`bk_ptr_...`) and optional default wallet (`wlt_...`). Owner/admin only. Partner key encrypted at rest.
1760
+ */
1761
+ put: operations["upsertOrgBankrConfig"];
1762
+ post?: never;
1763
+ /**
1764
+ * Remove org Bankr partner configuration
1765
+ * @description Delete BYOK credentials for the org. Owner/admin only.
1766
+ */
1767
+ delete: operations["deleteOrgBankrConfig"];
1768
+ options?: never;
1769
+ head?: never;
1770
+ patch?: never;
1771
+ trace?: never;
1772
+ };
1745
1773
  "/v1/org/invite": {
1746
1774
  parameters: {
1747
1775
  query?: never;
@@ -4024,6 +4052,112 @@ export interface paths {
4024
4052
  patch?: never;
4025
4053
  trace?: never;
4026
4054
  };
4055
+ "/v1/risk/events": {
4056
+ parameters: {
4057
+ query?: never;
4058
+ header?: never;
4059
+ path?: never;
4060
+ cookie?: never;
4061
+ };
4062
+ /**
4063
+ * List risk events
4064
+ * @description Returns risk events detected by the risk engine, ordered by most recent first.
4065
+ * Filter by severity or principal type.
4066
+ */
4067
+ get: operations["listRiskEvents"];
4068
+ put?: never;
4069
+ post?: never;
4070
+ delete?: never;
4071
+ options?: never;
4072
+ head?: never;
4073
+ patch?: never;
4074
+ trace?: never;
4075
+ };
4076
+ "/v1/risk/verdicts": {
4077
+ parameters: {
4078
+ query?: never;
4079
+ header?: never;
4080
+ path?: never;
4081
+ cookie?: never;
4082
+ };
4083
+ /**
4084
+ * List risk verdicts
4085
+ * @description Returns all active risk verdicts for the caller's organization.
4086
+ */
4087
+ get: operations["listRiskVerdicts"];
4088
+ put?: never;
4089
+ post?: never;
4090
+ delete?: never;
4091
+ options?: never;
4092
+ head?: never;
4093
+ patch?: never;
4094
+ trace?: never;
4095
+ };
4096
+ "/v1/risk/verdicts/{principal_type}/{principal_id}": {
4097
+ parameters: {
4098
+ query?: never;
4099
+ header?: never;
4100
+ path?: never;
4101
+ cookie?: never;
4102
+ };
4103
+ /**
4104
+ * Get risk verdict for a principal
4105
+ * @description Returns the current risk verdict for a specific user or agent.
4106
+ */
4107
+ get: operations["getRiskVerdict"];
4108
+ put?: never;
4109
+ post?: never;
4110
+ delete?: never;
4111
+ options?: never;
4112
+ head?: never;
4113
+ patch?: never;
4114
+ trace?: never;
4115
+ };
4116
+ "/v1/risk/honeytokens": {
4117
+ parameters: {
4118
+ query?: never;
4119
+ header?: never;
4120
+ path?: never;
4121
+ cookie?: never;
4122
+ };
4123
+ /**
4124
+ * List honeytokens
4125
+ * @description Returns all honeytokens (canary secrets) configured for the caller's organization.
4126
+ */
4127
+ get: operations["listHoneytokens"];
4128
+ put?: never;
4129
+ /**
4130
+ * Create a honeytoken
4131
+ * @description Register a secret path as a honeytoken (canary). Any access to this secret
4132
+ * triggers a risk event and increments the trigger counter.
4133
+ */
4134
+ post: operations["createHoneytoken"];
4135
+ delete?: never;
4136
+ options?: never;
4137
+ head?: never;
4138
+ patch?: never;
4139
+ trace?: never;
4140
+ };
4141
+ "/v1/risk/honeytokens/{id}": {
4142
+ parameters: {
4143
+ query?: never;
4144
+ header?: never;
4145
+ path?: never;
4146
+ cookie?: never;
4147
+ };
4148
+ get?: never;
4149
+ put?: never;
4150
+ post?: never;
4151
+ /**
4152
+ * Delete a honeytoken
4153
+ * @description Remove a honeytoken registration. The underlying secret is not affected.
4154
+ */
4155
+ delete: operations["deleteHoneytoken"];
4156
+ options?: never;
4157
+ head?: never;
4158
+ patch?: never;
4159
+ trace?: never;
4160
+ };
4027
4161
  }
4028
4162
  export type webhooks = Record<string, never>;
4029
4163
  export interface components {
@@ -5354,6 +5488,20 @@ export interface components {
5354
5488
  /** Format: uuid */
5355
5489
  vault_id?: string;
5356
5490
  };
5491
+ OrgBankrConfigResponse: {
5492
+ configured?: boolean;
5493
+ partner_key_prefix?: string;
5494
+ default_wallet_id?: string;
5495
+ /** Format: date-time */
5496
+ updated_at?: string;
5497
+ using_platform_fallback?: boolean;
5498
+ };
5499
+ UpsertOrgBankrConfigRequest: {
5500
+ /** @description Bankr partner API key (bk_ptr_...) */
5501
+ partner_key: string;
5502
+ /** @description Default provisioned wallet (wlt_...) */
5503
+ default_wallet_id?: string;
5504
+ };
5357
5505
  UsageSummaryResponse: {
5358
5506
  billing_tier?: string;
5359
5507
  free_tier_limit?: number;
@@ -6385,6 +6533,94 @@ export interface components {
6385
6533
  /** Format: date-time */
6386
6534
  created_at: string;
6387
6535
  };
6536
+ RiskEvent: {
6537
+ /** Format: uuid */
6538
+ id: string;
6539
+ /** Format: date-time */
6540
+ occurred_at: string;
6541
+ /** @enum {string} */
6542
+ principal_type: "user" | "agent";
6543
+ /** Format: uuid */
6544
+ principal_id: string;
6545
+ /** Format: uuid */
6546
+ org_id: string;
6547
+ /** @description Risk event type (e.g. first_seen, geo_velocity, honeytoken_access) */
6548
+ event_type: string;
6549
+ ip?: string | null;
6550
+ asn?: number | null;
6551
+ asn_org?: string | null;
6552
+ country_code?: string | null;
6553
+ region?: string | null;
6554
+ city?: string | null;
6555
+ latitude?: number | null;
6556
+ longitude?: number | null;
6557
+ user_agent?: string | null;
6558
+ /** @description Computed severity at event time (low, medium, high, critical) */
6559
+ severity?: string | null;
6560
+ payload: {
6561
+ [key: string]: unknown;
6562
+ };
6563
+ /** Format: date-time */
6564
+ created_at: string;
6565
+ };
6566
+ RiskEventListResponse: {
6567
+ events: components["schemas"]["RiskEvent"][];
6568
+ };
6569
+ RiskVerdictReason: {
6570
+ detector: string;
6571
+ severity: string;
6572
+ description: string;
6573
+ metadata?: {
6574
+ [key: string]: unknown;
6575
+ };
6576
+ };
6577
+ RiskVerdict: {
6578
+ principal_type: string;
6579
+ /** Format: uuid */
6580
+ principal_id: string;
6581
+ /** Format: uuid */
6582
+ org_id: string;
6583
+ /** @description Composite risk score (0.0 – 100.0) */
6584
+ score: number;
6585
+ /** @enum {string} */
6586
+ severity: "low" | "medium" | "high" | "critical";
6587
+ reasons: components["schemas"]["RiskVerdictReason"][];
6588
+ /** Format: date-time */
6589
+ computed_at: string;
6590
+ /** Format: date-time */
6591
+ expires_at: string;
6592
+ };
6593
+ RiskVerdictListResponse: {
6594
+ verdicts: components["schemas"]["RiskVerdict"][];
6595
+ };
6596
+ Honeytoken: {
6597
+ /** Format: uuid */
6598
+ id: string;
6599
+ /** Format: uuid */
6600
+ vault_id: string;
6601
+ /** Format: uuid */
6602
+ org_id: string;
6603
+ secret_path: string;
6604
+ /** Format: uuid */
6605
+ created_by: string;
6606
+ /** Format: date-time */
6607
+ created_at: string;
6608
+ notes?: string | null;
6609
+ triggered_count: number;
6610
+ /** Format: date-time */
6611
+ last_triggered_at?: string | null;
6612
+ };
6613
+ CreateHoneytokenRequest: {
6614
+ /** Format: uuid */
6615
+ vault_id: string;
6616
+ /** @description Vault secret path to monitor as a canary */
6617
+ secret_path: string;
6618
+ /** @description Optional human-readable notes about this honeytoken */
6619
+ notes?: string;
6620
+ };
6621
+ HoneytokenListResponse: {
6622
+ honeytokens: components["schemas"]["Honeytoken"][];
6623
+ };
6388
6624
  };
6389
6625
  responses: {
6390
6626
  /** @description Invalid request */
@@ -9300,6 +9536,75 @@ export interface operations {
9300
9536
  };
9301
9537
  };
9302
9538
  };
9539
+ getOrgBankrConfig: {
9540
+ parameters: {
9541
+ query?: never;
9542
+ header?: never;
9543
+ path?: never;
9544
+ cookie?: never;
9545
+ };
9546
+ requestBody?: never;
9547
+ responses: {
9548
+ /** @description Bankr configuration status */
9549
+ 200: {
9550
+ headers: {
9551
+ [name: string]: unknown;
9552
+ };
9553
+ content: {
9554
+ "application/json": components["schemas"]["OrgBankrConfigResponse"];
9555
+ };
9556
+ };
9557
+ };
9558
+ };
9559
+ upsertOrgBankrConfig: {
9560
+ parameters: {
9561
+ query?: never;
9562
+ header?: never;
9563
+ path?: never;
9564
+ cookie?: never;
9565
+ };
9566
+ requestBody: {
9567
+ content: {
9568
+ "application/json": components["schemas"]["UpsertOrgBankrConfigRequest"];
9569
+ };
9570
+ };
9571
+ responses: {
9572
+ /** @description Configuration saved */
9573
+ 200: {
9574
+ headers: {
9575
+ [name: string]: unknown;
9576
+ };
9577
+ content: {
9578
+ "application/json": components["schemas"]["OrgBankrConfigResponse"];
9579
+ };
9580
+ };
9581
+ };
9582
+ };
9583
+ deleteOrgBankrConfig: {
9584
+ parameters: {
9585
+ query?: never;
9586
+ header?: never;
9587
+ path?: never;
9588
+ cookie?: never;
9589
+ };
9590
+ requestBody?: never;
9591
+ responses: {
9592
+ /** @description Configuration removed */
9593
+ 204: {
9594
+ headers: {
9595
+ [name: string]: unknown;
9596
+ };
9597
+ content?: never;
9598
+ };
9599
+ /** @description Configuration not found */
9600
+ 404: {
9601
+ headers: {
9602
+ [name: string]: unknown;
9603
+ };
9604
+ content?: never;
9605
+ };
9606
+ };
9607
+ };
9303
9608
  inviteMember: {
9304
9609
  parameters: {
9305
9610
  query?: never;
@@ -11638,5 +11943,156 @@ export interface operations {
11638
11943
  401: components["responses"]["Unauthorized"];
11639
11944
  };
11640
11945
  };
11946
+ listRiskEvents: {
11947
+ parameters: {
11948
+ query?: {
11949
+ /** @description Filter events by severity level */
11950
+ severity?: "low" | "medium" | "high" | "critical";
11951
+ /** @description Filter events by principal type */
11952
+ principal_type?: "user" | "agent";
11953
+ limit?: number;
11954
+ offset?: number;
11955
+ };
11956
+ header?: never;
11957
+ path?: never;
11958
+ cookie?: never;
11959
+ };
11960
+ requestBody?: never;
11961
+ responses: {
11962
+ /** @description Risk event list */
11963
+ 200: {
11964
+ headers: {
11965
+ [name: string]: unknown;
11966
+ };
11967
+ content: {
11968
+ "application/json": components["schemas"]["RiskEventListResponse"];
11969
+ };
11970
+ };
11971
+ 401: components["responses"]["Unauthorized"];
11972
+ };
11973
+ };
11974
+ listRiskVerdicts: {
11975
+ parameters: {
11976
+ query?: never;
11977
+ header?: never;
11978
+ path?: never;
11979
+ cookie?: never;
11980
+ };
11981
+ requestBody?: never;
11982
+ responses: {
11983
+ /** @description Verdict list */
11984
+ 200: {
11985
+ headers: {
11986
+ [name: string]: unknown;
11987
+ };
11988
+ content: {
11989
+ "application/json": components["schemas"]["RiskVerdictListResponse"];
11990
+ };
11991
+ };
11992
+ 401: components["responses"]["Unauthorized"];
11993
+ };
11994
+ };
11995
+ getRiskVerdict: {
11996
+ parameters: {
11997
+ query?: never;
11998
+ header?: never;
11999
+ path: {
12000
+ principal_type: "user" | "agent";
12001
+ principal_id: string;
12002
+ };
12003
+ cookie?: never;
12004
+ };
12005
+ requestBody?: never;
12006
+ responses: {
12007
+ /** @description Risk verdict (null if no verdict exists) */
12008
+ 200: {
12009
+ headers: {
12010
+ [name: string]: unknown;
12011
+ };
12012
+ content: {
12013
+ "application/json": {
12014
+ verdict?: components["schemas"]["RiskVerdict"];
12015
+ };
12016
+ };
12017
+ };
12018
+ 401: components["responses"]["Unauthorized"];
12019
+ 404: components["responses"]["NotFound"];
12020
+ };
12021
+ };
12022
+ listHoneytokens: {
12023
+ parameters: {
12024
+ query?: never;
12025
+ header?: never;
12026
+ path?: never;
12027
+ cookie?: never;
12028
+ };
12029
+ requestBody?: never;
12030
+ responses: {
12031
+ /** @description Honeytoken list */
12032
+ 200: {
12033
+ headers: {
12034
+ [name: string]: unknown;
12035
+ };
12036
+ content: {
12037
+ "application/json": components["schemas"]["HoneytokenListResponse"];
12038
+ };
12039
+ };
12040
+ 401: components["responses"]["Unauthorized"];
12041
+ };
12042
+ };
12043
+ createHoneytoken: {
12044
+ parameters: {
12045
+ query?: never;
12046
+ header?: never;
12047
+ path?: never;
12048
+ cookie?: never;
12049
+ };
12050
+ requestBody: {
12051
+ content: {
12052
+ "application/json": components["schemas"]["CreateHoneytokenRequest"];
12053
+ };
12054
+ };
12055
+ responses: {
12056
+ /** @description Honeytoken created */
12057
+ 201: {
12058
+ headers: {
12059
+ [name: string]: unknown;
12060
+ };
12061
+ content: {
12062
+ "application/json": {
12063
+ honeytoken?: components["schemas"]["Honeytoken"];
12064
+ };
12065
+ };
12066
+ };
12067
+ 400: components["responses"]["BadRequest"];
12068
+ 401: components["responses"]["Unauthorized"];
12069
+ };
12070
+ };
12071
+ deleteHoneytoken: {
12072
+ parameters: {
12073
+ query?: never;
12074
+ header?: never;
12075
+ path: {
12076
+ id: string;
12077
+ };
12078
+ cookie?: never;
12079
+ };
12080
+ requestBody?: never;
12081
+ responses: {
12082
+ /** @description Honeytoken deleted */
12083
+ 200: {
12084
+ headers: {
12085
+ [name: string]: unknown;
12086
+ };
12087
+ content: {
12088
+ "application/json": {
12089
+ deleted?: boolean;
12090
+ };
12091
+ };
12092
+ };
12093
+ 401: components["responses"]["Unauthorized"];
12094
+ 404: components["responses"]["NotFound"];
12095
+ };
12096
+ };
11641
12097
  }
11642
12098
  //# sourceMappingURL=api-types.d.ts.map