@agent-vm/agent-portal-sdk 0.0.148 → 0.0.150

package/contract-fixtures/portable-contracts/approval/managed-google-challenge.fixture.json

@@ -0,0 +1,66 @@
+{
+	"caseId": "managed-google-challenge",
+	"schemaId": "portal.call.item-result",
+	"tags": ["accepted", "approval", "google"],
+	"input": {
+		"approvalChallenge": {
+			"challengeId": "22222222-2222-4222-8222-222222222222",
+			"expiresAt": "2026-09-06T20:00:00.000Z",
+			"kind": "managed_google",
+			"managedGoogleDisplay": {
+				"accountId": "11111111-1111-4111-8111-111111111111",
+				"authorizationId": "33333333-3333-4333-8333-333333333333",
+				"accountAlias": "Personal mailbox",
+				"applicationLabel": "Gmail, Calendar & Contacts",
+				"authorizationMetadataRevision": 1
+			}
+		},
+		"error": {
+			"code": "approval_required",
+			"message": "Approval required",
+			"retryable": false
+		},
+		"id": "google-call",
+		"operationId": "operation-1",
+		"outcome": {
+			"kind": "not-dispatched",
+			"certainty": "proven",
+			"retryClass": "safe-before-dispatch"
+		},
+		"owningGeneration": "epoch-1",
+		"status": "approval_required"
+	},
+	"expectation": {
+		"kind": "accepted",
+		"normalized": {
+			"approvalChallenge": {
+				"challengeId": "22222222-2222-4222-8222-222222222222",
+				"expiresAt": "2026-09-06T20:00:00.000Z",
+				"kind": "managed_google",
+				"managedGoogleDisplay": {
+					"accountId": "11111111-1111-4111-8111-111111111111",
+					"authorizationId": "33333333-3333-4333-8333-333333333333",
+					"accountAlias": "Personal mailbox",
+					"applicationLabel": "Gmail, Calendar & Contacts",
+					"authorizationMetadataRevision": 1
+				}
+			},
+			"error": {
+				"code": "approval_required",
+				"message": "Approval required",
+				"retryable": false
+			},
+			"id": "google-call",
+			"operationId": "operation-1",
+			"outcome": {
+				"kind": "not-dispatched",
+				"certainty": "proven",
+				"retryClass": "safe-before-dispatch"
+			},
+			"owningGeneration": "epoch-1",
+			"status": "approval_required"
+		},
+		"canonicalJson": "{\"approvalChallenge\":{\"challengeId\":\"22222222-2222-4222-8222-222222222222\",\"expiresAt\":\"2026-09-06T20:00:00.000Z\",\"kind\":\"managed_google\",\"managedGoogleDisplay\":{\"accountAlias\":\"Personal mailbox\",\"accountId\":\"11111111-1111-4111-8111-111111111111\",\"applicationLabel\":\"Gmail, Calendar & Contacts\",\"authorizationId\":\"33333333-3333-4333-8333-333333333333\",\"authorizationMetadataRevision\":1}},\"error\":{\"code\":\"approval_required\",\"message\":\"Approval required\",\"retryable\":false},\"id\":\"google-call\",\"operationId\":\"operation-1\",\"outcome\":{\"certainty\":\"proven\",\"kind\":\"not-dispatched\",\"retryClass\":\"safe-before-dispatch\"},\"owningGeneration\":\"epoch-1\",\"status\":\"approval_required\"}",
+		"refinementIdentities": ["portal.request-id.not-reserved", "portal.result.outcome-algebra"]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/describe-result.fixture.json

@@ -17,6 +17,10 @@
 			"ok": true
 		},
 		"canonicalJson": "{\"items\":[{\"id\":\"describe-1\",\"status\":\"ok\",\"value\":{\"namespaceDiscovery\":[],\"tools\":[]}}],\"ok\":true}",
-		"refinementIdentities": ["portal.request-id.not-reserved", "portal.result.aggregate-status"]
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
 	}
 }

package/contract-fixtures/portable-contracts/discovery/google-describe-duplicate-availability.fixture.json

@@ -0,0 +1,103 @@
+{
+	"caseId": "google-describe-duplicate-availability",
+	"schemaId": "portal.describe.result",
+	"tags": ["rejected", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "describe-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									},
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"annotations": {},
+							"related": []
+						}
+					]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "rejected",
+		"errorCodes": ["portal.google.discovery-policy"],
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/google-describe-duplicate-requirements.fixture.json

@@ -0,0 +1,83 @@
+{
+	"caseId": "google-describe-duplicate-requirements",
+	"schemaId": "portal.describe.result",
+	"tags": ["rejected", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "describe-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									},
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"annotations": {},
+							"related": []
+						}
+					]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "rejected",
+		"errorCodes": ["portal.google.discovery-policy"],
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/google-describe-unverified-ready.fixture.json

@@ -0,0 +1,78 @@
+{
+	"caseId": "google-describe-unverified-ready",
+	"schemaId": "portal.describe.result",
+	"tags": ["rejected", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "describe-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "unavailable"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"annotations": {},
+							"related": []
+						}
+					]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "rejected",
+		"errorCodes": ["portal.google.discovery-policy"],
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/google-describe-valid.fixture.json

@@ -0,0 +1,144 @@
+{
+	"caseId": "google-describe-valid",
+	"schemaId": "portal.describe.result",
+	"tags": ["accepted", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "describe-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"annotations": {},
+							"related": []
+						}
+					]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "accepted",
+		"normalized": {
+			"items": [
+				{
+					"id": "describe-google",
+					"status": "ok",
+					"value": {
+						"namespaceDiscovery": [],
+						"tools": [
+							{
+								"namespace": "google",
+								"name": "gog",
+								"toolRef": "google.gog",
+								"callDisposition": {
+									"kind": "invocation-dependent",
+									"describeBeforeCall": true
+								},
+								"oauthRequirement": {
+									"kind": "google-account",
+									"accountArgument": "accountId",
+									"describeBeforeCall": true,
+									"operations": [
+										{
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										}
+									]
+								},
+								"oauthAvailability": {
+									"kind": "operation-options",
+									"items": [
+										{
+											"requirement": {
+												"applicationId": "communications-app",
+												"operationId": "gmail.read"
+											},
+											"availability": {
+												"kind": "accounts",
+												"accounts": [
+													{
+														"accountId": "11111111-1111-4111-8111-111111111111",
+														"metadata": {
+															"kind": "verified",
+															"accountAlias": "Personal mailbox"
+														},
+														"availability": {
+															"kind": "ready",
+															"disposition": "ask",
+															"overrideRevision": 1,
+															"defaultsRevision": "defaults-v1"
+														}
+													}
+												]
+											}
+										}
+									]
+								},
+								"annotations": {},
+								"related": []
+							}
+						]
+					}
+				}
+			],
+			"ok": true
+		},
+		"canonicalJson": "{\"items\":[{\"id\":\"describe-google\",\"status\":\"ok\",\"value\":{\"namespaceDiscovery\":[],\"tools\":[{\"annotations\":{},\"callDisposition\":{\"describeBeforeCall\":true,\"kind\":\"invocation-dependent\"},\"name\":\"gog\",\"namespace\":\"google\",\"oauthAvailability\":{\"items\":[{\"availability\":{\"accounts\":[{\"accountId\":\"11111111-1111-4111-8111-111111111111\",\"availability\":{\"defaultsRevision\":\"defaults-v1\",\"disposition\":\"ask\",\"kind\":\"ready\",\"overrideRevision\":1},\"metadata\":{\"accountAlias\":\"Personal mailbox\",\"kind\":\"verified\"}}],\"kind\":\"accounts\"},\"requirement\":{\"applicationId\":\"communications-app\",\"operationId\":\"gmail.read\"}}],\"kind\":\"operation-options\"},\"oauthRequirement\":{\"accountArgument\":\"accountId\",\"describeBeforeCall\":true,\"kind\":\"google-account\",\"operations\":[{\"applicationId\":\"communications-app\",\"operationId\":\"gmail.read\"}]},\"related\":[],\"toolRef\":\"google.gog\"}]}}],\"ok\":true}",
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/google-list-duplicate-availability.fixture.json

@@ -0,0 +1,109 @@
+{
+	"caseId": "google-list-duplicate-availability",
+	"schemaId": "portal.list.result",
+	"tags": ["rejected", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "list-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									},
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"input": {
+								"optional": [],
+								"propertyCount": 1,
+								"required": ["accountId"],
+								"type": "object"
+							},
+							"safety": {}
+						}
+					],
+					"namespaces": ["google"]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "rejected",
+		"errorCodes": ["portal.google.discovery-policy"],
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}

package/contract-fixtures/portable-contracts/discovery/google-list-duplicate-requirements.fixture.json

@@ -0,0 +1,89 @@
+{
+	"caseId": "google-list-duplicate-requirements",
+	"schemaId": "portal.list.result",
+	"tags": ["rejected", "discovery", "google"],
+	"input": {
+		"items": [
+			{
+				"id": "list-google",
+				"status": "ok",
+				"value": {
+					"namespaceDiscovery": [],
+					"tools": [
+						{
+							"namespace": "google",
+							"name": "gog",
+							"toolRef": "google.gog",
+							"callDisposition": {
+								"kind": "invocation-dependent",
+								"describeBeforeCall": true
+							},
+							"oauthRequirement": {
+								"kind": "google-account",
+								"accountArgument": "accountId",
+								"describeBeforeCall": true,
+								"operations": [
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									},
+									{
+										"applicationId": "communications-app",
+										"operationId": "gmail.read"
+									}
+								]
+							},
+							"oauthAvailability": {
+								"kind": "operation-options",
+								"items": [
+									{
+										"requirement": {
+											"applicationId": "communications-app",
+											"operationId": "gmail.read"
+										},
+										"availability": {
+											"kind": "accounts",
+											"accounts": [
+												{
+													"accountId": "11111111-1111-4111-8111-111111111111",
+													"metadata": {
+														"kind": "verified",
+														"accountAlias": "Personal mailbox"
+													},
+													"availability": {
+														"kind": "ready",
+														"disposition": "ask",
+														"overrideRevision": 1,
+														"defaultsRevision": "defaults-v1"
+													}
+												}
+											]
+										}
+									}
+								]
+							},
+							"input": {
+								"optional": [],
+								"propertyCount": 1,
+								"required": ["accountId"],
+								"type": "object"
+							},
+							"safety": {}
+						}
+					],
+					"namespaces": ["google"]
+				}
+			}
+		],
+		"ok": true
+	},
+	"expectation": {
+		"kind": "rejected",
+		"errorCodes": ["portal.google.discovery-policy"],
+		"refinementIdentities": [
+			"portal.google.discovery-policy",
+			"portal.request-id.not-reserved",
+			"portal.result.aggregate-status"
+		]
+	}
+}