@tangle-network/agent-integrations 0.50.0 → 0.52.0

package/dist/{chunk-RM6JJK4Q.js → chunk-XEJKVCXB.js}

@@ -1008,6 +1008,24 @@ function declarativeRestConnector(spec) {
     async executeMutation(inv) {
       const op = readOperation(spec, inv.capabilityName, "mutation");
       const response = await executeRestRequest(spec, op.request, inv, requiredArgsOf(op.parameters));
+      if (response.outcome === "conflict") {
+        return {
+          status: "conflict",
+          alternatives: [],
+          // The upstream's parsed body — the contract calls this "the current
+          // authoritative state", so it must be what the provider returned,
+          // not the transport's own wrapper.
+          currentState: response.data,
+          message: response.message || `${spec.displayName} rejected the write on a state conflict`
+        };
+      }
+      if (response.outcome === "rate-limited") {
+        return {
+          status: "rate-limited",
+          retryAfterMs: response.retryAfterMs ?? DEFAULT_RETRY_AFTER_MS,
+          message: response.message || `${spec.displayName} throttled the write`
+        };
+      }
       return {
         status: "committed",
         data: response.data,
@@ -1087,11 +1105,12 @@ async function executeRestRequest(spec, request, inv, requiredArgs) {
   const awsRegion = aws ? resolveAwsRegion(aws, inv.source.metadata, placement) : void 0;
   let baseUrl = resolveBaseUrl(spec.baseUrl, inv.source.metadata);
   if (aws) baseUrl = applyRegionTemplate(baseUrl, awsRegion, aws.endpoint);
-  const renderedPath = interpolate(request.path, inv.args).replace(/^\/+/, "");
+  const scope = renderScope(inv);
+  const renderedPath = interpolate(request.path, scope).replace(/^\/+/, "");
   const baseWithSlash = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
   const url = new URL(renderedPath, baseWithSlash);
   for (const [key, value] of Object.entries(request.query ?? {})) {
-    const rendered = renderQueryValue(value, inv.args);
+    const rendered = renderQueryValue(value, scope);
     if (rendered !== void 0 && rendered !== "") url.searchParams.set(key, String(rendered));
   }
   const requestHeaders = request.headers ?? {};
@@ -1100,7 +1119,7 @@ async function executeRestRequest(spec, request, inv, requiredArgs) {
   const headers = {
     accept: "application/json",
     ...spec.defaultHeaders,
-    ...renderHeaders(renderableHeaders, inv.args)
+    ...renderHeaders(renderableHeaders, scope)
   };
   if (hostOverride) url.host = hostOverride.replace(/\{region\}/g, awsRegion);
   if (inv.expectedEtag) headers["if-match"] = inv.expectedEtag;
@@ -1108,7 +1127,7 @@ async function executeRestRequest(spec, request, inv, requiredArgs) {
   if (sendsBody && getHeaderCI(headers, "content-type") === void 0) {
     headers["content-type"] = "application/json";
   }
-  const bodyString = sendsBody ? JSON.stringify(resolveBody(request.body, inv.args, requiredArgs)) : void 0;
+  const bodyString = sendsBody ? JSON.stringify(resolveBody(request.body, inv.args, scope, requiredArgs)) : void 0;
   if (placement.kind === "aws-sigv4") {
     signAwsRequest(headers, url, {
       method: request.method,
@@ -1130,21 +1149,21 @@ async function executeRestRequest(spec, request, inv, requiredArgs) {
     throw new CredentialsExpired(`${spec.displayName} rejected credentials (${res.status})`, inv.source.id);
   }
   if (res.status === 409 || res.status === 412) {
+    const text2 = await safeErrorText(res);
     return {
-      data: {
-        status: "conflict",
-        message: await safeErrorText(res)
-      },
+      data: parseBodyText(text2),
+      outcome: "conflict",
+      message: text2,
       etag: res.headers.get("etag") ?? void 0
     };
   }
   if (res.status === 429) {
+    const text2 = await safeErrorText(res);
     return {
-      data: {
-        status: "rate-limited",
-        retryAfter: res.headers.get("retry-after") ?? void 0,
-        message: await safeErrorText(res)
-      }
+      data: parseBodyText(text2),
+      outcome: "rate-limited",
+      message: text2,
+      retryAfterMs: retryAfterMsFromHeader(res.headers.get("retry-after"))
     };
   }
   if (request.existenceCheck && (res.status === 204 || res.status === 404)) {
@@ -1218,10 +1237,34 @@ function signAwsRequest(headers, url, opts) {
   headers["x-amz-date"] = signed.amzDate;
   headers.authorization = signed.authorization;
 }
-function resolveBody(body, args, requiredArgs) {
+function resolveBody(body, args, scope, requiredArgs) {
   if (!body || body === "args") return args;
-  if (typeof body === "string") return renderValue(body, args, requiredArgs);
-  return renderObject(body, args, requiredArgs);
+  if (typeof body === "string") return renderValue(body, scope, requiredArgs);
+  return renderObject(body, scope, requiredArgs);
+}
+var DEFAULT_RETRY_AFTER_MS = 6e4;
+var MIN_RETRY_AFTER_MS = 1e3;
+function parseBodyText(text) {
+  if (!text) return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return { raw: text };
+  }
+}
+function retryAfterMsFromHeader(raw) {
+  if (typeof raw === "string" && raw.trim()) {
+    const seconds = Number(raw);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+      return Math.max(MIN_RETRY_AFTER_MS, Math.round(seconds * 1e3));
+    }
+    const at = Date.parse(raw);
+    if (Number.isFinite(at)) return Math.max(MIN_RETRY_AFTER_MS, at - Date.now());
+  }
+  return DEFAULT_RETRY_AFTER_MS;
+}
+function renderScope(inv) {
+  return { ...inv.args, connection: inv.source.metadata };
 }
 function renderHeaders(headers, args) {
   return Object.fromEntries(Object.entries(headers).map(([key, value]) => [key, interpolate(value, args)]));
@@ -18364,8 +18407,71 @@ var quickbooksConnector = declarativeRestConnector({
   defaultHeaders: {
     accept: "application/json"
   },
-  test: { method: "GET", path: "companyinfo/{realmId}", query: { minorversion: "70" } },
+  // `realmId` is pinned at connect time, not passed per call, so the health
+  // check reads it from connection metadata. Written as `{realmId}` it resolved
+  // against the (empty) test argument map and threw before any request was
+  // made — the connection test could never pass, for any connection.
+  test: { method: "GET", path: "companyinfo/{connection.realmId}", query: { minorversion: "70" } },
   capabilities: [
+    {
+      // The reports namespace is NOT reachable through `entities.query` — QBO
+      // exposes the accountant-grade statements only under /reports/{name}.
+      // These four are the tax/bookkeeping read surface; without them a tax
+      // agent can enumerate ledger rows but cannot obtain a P&L or a balance
+      // sheet, which is what a return is actually built from.
+      name: "reports.get",
+      class: "read",
+      description: "Run a QuickBooks Online report. `reportName` is the QBO report id (ProfitAndLoss, BalanceSheet, TrialBalance, GeneralLedger, CashFlow, AgedReceivables, AgedPayables).",
+      parameters: {
+        type: "object",
+        properties: {
+          reportName: {
+            type: "string",
+            enum: [
+              "ProfitAndLoss",
+              "BalanceSheet",
+              "TrialBalance",
+              "GeneralLedger",
+              "CashFlow",
+              "AgedReceivables",
+              "AgedPayables"
+            ]
+          },
+          start_date: { type: "string", description: "YYYY-MM-DD (inclusive)." },
+          end_date: { type: "string", description: "YYYY-MM-DD (inclusive)." },
+          accounting_method: { type: "string", enum: ["Cash", "Accrual"] },
+          date_macro: { type: "string", description: 'e.g. "Last Fiscal Year" \u2014 alternative to start/end dates.' },
+          summarize_column_by: { type: "string", description: "e.g. Month, Quarter, Year, Total." },
+          minorversion: { type: "string" }
+        },
+        required: ["reportName"]
+      },
+      request: {
+        method: "GET",
+        path: "reports/{reportName}",
+        query: {
+          start_date: "{start_date}",
+          end_date: "{end_date}",
+          accounting_method: "{accounting_method}",
+          date_macro: "{date_macro}",
+          summarize_column_by: "{summarize_column_by}",
+          minorversion: "{minorversion}"
+        }
+      },
+      requiredScopes: ["com.intuit.quickbooks.accounting"]
+    },
+    {
+      name: "companyinfo.get",
+      class: "read",
+      description: "Read the connected QuickBooks company profile (legal name, EIN/company id, fiscal year start, country) for the realm this connection was authorized against.",
+      parameters: { type: "object", properties: { minorversion: { type: "string" } } },
+      request: {
+        method: "GET",
+        path: "companyinfo/{connection.realmId}",
+        query: { minorversion: "{minorversion}" }
+      },
+      requiredScopes: ["com.intuit.quickbooks.accounting"]
+    },
     {
       name: "entities.query",
       class: "read",
@@ -18722,7 +18828,15 @@ var xeroConnector = declarativeRestConnector({
     kind: "oauth2",
     authorizationUrl: "https://login.xero.com/identity/connect/authorize",
     tokenUrl: "https://identity.xero.com/connect/token",
-    scopes: ["offline_access", "accounting.contacts", "accounting.transactions", "accounting.settings.read"],
+    // `accounting.reports.read` is a distinct Xero scope — the reports
+    // namespace is not covered by settings/transactions and 403s without it.
+    scopes: [
+      "offline_access",
+      "accounting.contacts",
+      "accounting.transactions",
+      "accounting.settings.read",
+      "accounting.reports.read"
+    ],
     clientIdEnv: "XERO_OAUTH_CLIENT_ID",
     clientSecretEnv: "XERO_OAUTH_CLIENT_SECRET"
   },
@@ -18732,6 +18846,54 @@ var xeroConnector = declarativeRestConnector({
   defaultHeaders: { accept: "application/json" },
   test: { method: "GET", path: "/connections" },
   capabilities: [
+    {
+      // Every other Xero capability REQUIRES `tenantId`, and a tenant id is an
+      // opaque GUID no caller can know before asking. Without this read the
+      // connector is unusable by an agent: the only place the id appeared was
+      // the health check, which discards its body.
+      name: "tenants.list",
+      class: "read",
+      description: "List the Xero organizations (tenants) this connection is authorized for. Call this FIRST \u2014 every other Xero capability requires the `tenantId` returned here.",
+      parameters: { type: "object", properties: {} },
+      request: { method: "GET", path: "/connections" }
+    },
+    {
+      // Xero's reporting surface, like QBO's, is a separate namespace from the
+      // record endpoints. These are the statements a return or a books review
+      // is actually built from.
+      name: "reports.get",
+      class: "read",
+      description: "Run a Xero accounting report. `reportName` is the Xero report id (ProfitAndLoss, BalanceSheet, TrialBalance, BankSummary, AgedReceivablesByContact, AgedPayablesByContact).",
+      parameters: {
+        type: "object",
+        properties: {
+          tenantId: { type: "string", description: "From tenants.list." },
+          reportName: {
+            type: "string",
+            enum: [
+              "ProfitAndLoss",
+              "BalanceSheet",
+              "TrialBalance",
+              "BankSummary",
+              "AgedReceivablesByContact",
+              "AgedPayablesByContact"
+            ]
+          },
+          fromDate: { type: "string", description: "YYYY-MM-DD." },
+          toDate: { type: "string", description: "YYYY-MM-DD." },
+          date: { type: "string", description: "YYYY-MM-DD \u2014 point-in-time reports (BalanceSheet, TrialBalance)." },
+          contactId: { type: "string", description: "Required by the aged receivables/payables reports." }
+        },
+        required: ["tenantId", "reportName"]
+      },
+      request: {
+        method: "GET",
+        path: "/api.xro/2.0/Reports/{reportName}",
+        query: { fromDate: "{fromDate}", toDate: "{toDate}", date: "{date}", contactID: "{contactId}" },
+        headers: { "xero-tenant-id": "{tenantId}" }
+      },
+      requiredScopes: ["accounting.reports.read"]
+    },
     {
       name: "contacts.search",
       class: "read",
@@ -125794,4 +125956,4 @@ export {
   demandbaseConnector,
   adapters_exports
 };
-//# sourceMappingURL=chunk-RM6JJK4Q.js.map
+//# sourceMappingURL=chunk-XEJKVCXB.js.map