@ar-agents/mercadopago 0.18.0 → 0.18.2
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.
- package/CHANGELOG.md +12 -0
- package/dist/index.cjs +99 -99
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +8 -8
- package/dist/index.d.ts +8 -8
- package/dist/index.js +99 -99
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
- package/tools.manifest.json +54 -54
package/dist/index.d.cts
CHANGED
|
@@ -1052,7 +1052,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1052
1052
|
/** State adapter for persisting subscription records. */
|
|
1053
1053
|
state: SubscriptionStateAdapter;
|
|
1054
1054
|
/**
|
|
1055
|
-
* Default back_url used when callers don't supply one. MUST be HTTPS
|
|
1055
|
+
* Default back_url used when callers don't supply one. MUST be HTTPS, MP
|
|
1056
1056
|
* rejects http:// and localhost back URLs even in sandbox.
|
|
1057
1057
|
*/
|
|
1058
1058
|
backUrl: string;
|
|
@@ -1064,7 +1064,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1064
1064
|
descriptions?: Partial<Record<ToolName, string>>;
|
|
1065
1065
|
/**
|
|
1066
1066
|
* Default notification webhook URL used when callers don't supply one.
|
|
1067
|
-
* Optional
|
|
1067
|
+
* Optional, MP falls back to dashboard config if not set.
|
|
1068
1068
|
*/
|
|
1069
1069
|
notificationUrl?: string;
|
|
1070
1070
|
/**
|
|
@@ -1078,7 +1078,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1078
1078
|
/**
|
|
1079
1079
|
* OAuth credentials for the marketplace flow. Required for
|
|
1080
1080
|
* `oauth_exchange_code` and `oauth_refresh_token` (the secret cannot be
|
|
1081
|
-
* passed by the agent
|
|
1081
|
+
* passed by the agent, it's a server-side secret). If omitted, those
|
|
1082
1082
|
* tools return `{ available: false }` with setup instructions.
|
|
1083
1083
|
*/
|
|
1084
1084
|
oauth?: {
|
|
@@ -1086,25 +1086,25 @@ interface MercadoPagoToolsOptions {
|
|
|
1086
1086
|
clientSecret: string;
|
|
1087
1087
|
};
|
|
1088
1088
|
/**
|
|
1089
|
-
* v0.10
|
|
1089
|
+
* v0.10, Audit logger. When passed, every state-mutating tool call
|
|
1090
1090
|
* automatically emits an audit entry with operation/actor/inputHash/
|
|
1091
1091
|
* resourceId/outcome/duration. Read-only tools (get/search/list) skip
|
|
1092
1092
|
* audit logging.
|
|
1093
1093
|
*/
|
|
1094
1094
|
audit?: AuditLogger;
|
|
1095
1095
|
/**
|
|
1096
|
-
* v0.10
|
|
1096
|
+
* v0.10, Logical actor for audit entries (e.g., "agent:billing-bot",
|
|
1097
1097
|
* "user:42"). Defaults to the AuditLogger's defaultActor.
|
|
1098
1098
|
*/
|
|
1099
1099
|
auditActor?: string;
|
|
1100
1100
|
/**
|
|
1101
|
-
* v0.10
|
|
1101
|
+
* v0.10, Webhook deduplication for handle_webhook tool. Caches
|
|
1102
1102
|
* processed (topic, dataId, requestId) tuples to short-circuit MP's
|
|
1103
1103
|
* retries (which fire on 5xx and can deliver the same event 5+ times).
|
|
1104
1104
|
*/
|
|
1105
1105
|
webhookDedup?: WebhookDedup;
|
|
1106
1106
|
/**
|
|
1107
|
-
* v0.15
|
|
1107
|
+
* v0.15, Programmatic Human-In-The-Loop gate for irreversible /
|
|
1108
1108
|
* money-moving operations. When set, every call to one of the gated
|
|
1109
1109
|
* tools (cancel_payment, capture_payment, refund_payment,
|
|
1110
1110
|
* delete_customer_card, cancel_qr_payment, cancel_order,
|
|
@@ -1135,7 +1135,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1135
1135
|
* ```
|
|
1136
1136
|
*
|
|
1137
1137
|
* If omitted (default), the description-based HITL is the only line of
|
|
1138
|
-
* defense
|
|
1138
|
+
* defense, fine for trusted/internal agents, NOT recommended for
|
|
1139
1139
|
* untrusted-input agents (anything reading from a public webhook).
|
|
1140
1140
|
*/
|
|
1141
1141
|
requireConfirmation?: (operation: GatedOperation, args: Record<string, unknown>) => Promise<boolean>;
|
package/dist/index.d.ts
CHANGED
|
@@ -1052,7 +1052,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1052
1052
|
/** State adapter for persisting subscription records. */
|
|
1053
1053
|
state: SubscriptionStateAdapter;
|
|
1054
1054
|
/**
|
|
1055
|
-
* Default back_url used when callers don't supply one. MUST be HTTPS
|
|
1055
|
+
* Default back_url used when callers don't supply one. MUST be HTTPS, MP
|
|
1056
1056
|
* rejects http:// and localhost back URLs even in sandbox.
|
|
1057
1057
|
*/
|
|
1058
1058
|
backUrl: string;
|
|
@@ -1064,7 +1064,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1064
1064
|
descriptions?: Partial<Record<ToolName, string>>;
|
|
1065
1065
|
/**
|
|
1066
1066
|
* Default notification webhook URL used when callers don't supply one.
|
|
1067
|
-
* Optional
|
|
1067
|
+
* Optional, MP falls back to dashboard config if not set.
|
|
1068
1068
|
*/
|
|
1069
1069
|
notificationUrl?: string;
|
|
1070
1070
|
/**
|
|
@@ -1078,7 +1078,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1078
1078
|
/**
|
|
1079
1079
|
* OAuth credentials for the marketplace flow. Required for
|
|
1080
1080
|
* `oauth_exchange_code` and `oauth_refresh_token` (the secret cannot be
|
|
1081
|
-
* passed by the agent
|
|
1081
|
+
* passed by the agent, it's a server-side secret). If omitted, those
|
|
1082
1082
|
* tools return `{ available: false }` with setup instructions.
|
|
1083
1083
|
*/
|
|
1084
1084
|
oauth?: {
|
|
@@ -1086,25 +1086,25 @@ interface MercadoPagoToolsOptions {
|
|
|
1086
1086
|
clientSecret: string;
|
|
1087
1087
|
};
|
|
1088
1088
|
/**
|
|
1089
|
-
* v0.10
|
|
1089
|
+
* v0.10, Audit logger. When passed, every state-mutating tool call
|
|
1090
1090
|
* automatically emits an audit entry with operation/actor/inputHash/
|
|
1091
1091
|
* resourceId/outcome/duration. Read-only tools (get/search/list) skip
|
|
1092
1092
|
* audit logging.
|
|
1093
1093
|
*/
|
|
1094
1094
|
audit?: AuditLogger;
|
|
1095
1095
|
/**
|
|
1096
|
-
* v0.10
|
|
1096
|
+
* v0.10, Logical actor for audit entries (e.g., "agent:billing-bot",
|
|
1097
1097
|
* "user:42"). Defaults to the AuditLogger's defaultActor.
|
|
1098
1098
|
*/
|
|
1099
1099
|
auditActor?: string;
|
|
1100
1100
|
/**
|
|
1101
|
-
* v0.10
|
|
1101
|
+
* v0.10, Webhook deduplication for handle_webhook tool. Caches
|
|
1102
1102
|
* processed (topic, dataId, requestId) tuples to short-circuit MP's
|
|
1103
1103
|
* retries (which fire on 5xx and can deliver the same event 5+ times).
|
|
1104
1104
|
*/
|
|
1105
1105
|
webhookDedup?: WebhookDedup;
|
|
1106
1106
|
/**
|
|
1107
|
-
* v0.15
|
|
1107
|
+
* v0.15, Programmatic Human-In-The-Loop gate for irreversible /
|
|
1108
1108
|
* money-moving operations. When set, every call to one of the gated
|
|
1109
1109
|
* tools (cancel_payment, capture_payment, refund_payment,
|
|
1110
1110
|
* delete_customer_card, cancel_qr_payment, cancel_order,
|
|
@@ -1135,7 +1135,7 @@ interface MercadoPagoToolsOptions {
|
|
|
1135
1135
|
* ```
|
|
1136
1136
|
*
|
|
1137
1137
|
* If omitted (default), the description-based HITL is the only line of
|
|
1138
|
-
* defense
|
|
1138
|
+
* defense, fine for trusted/internal agents, NOT recommended for
|
|
1139
1139
|
* untrusted-input agents (anything reading from a public webhook).
|
|
1140
1140
|
*/
|
|
1141
1141
|
requireConfirmation?: (operation: GatedOperation, args: Record<string, unknown>) => Promise<boolean>;
|