@topolo/sdk 0.12.0 → 0.13.0

package/dist/index.cjs

@@ -1229,16 +1229,29 @@ var TopoloClient = class _TopoloClient {
         clearTimeout(timeoutId);
       }
     };
+    const fetchWithReadRetry = async () => {
+      const maxAttempts = method === "GET" ? 2 : 1;
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+          return await fetchOnce();
+        } catch (error) {
+          const transportFailure = !(error instanceof TopoloSdkError) && !opts.signal?.aborted;
+          if (!transportFailure || attempt === maxAttempts) throw error;
+          await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+      }
+      throw new TopoloSdkError("network_error", "Topolo read retry loop exhausted.");
+    };
     let res;
     try {
       const attemptedCredential = this.credential;
-      res = await fetchOnce();
+      res = await fetchWithReadRetry();
       if (res.status === 401 && attemptedCredential.kind === "access_token" && this.refreshCredential) {
         await res.body?.cancel().catch(() => void 0);
         const refreshed = await this.refreshRejectedAccessToken(attemptedCredential.accessToken);
         if (refreshed) {
           applyAuthHeaders(headers, refreshed);
-          res = await fetchOnce();
+          res = await fetchWithReadRetry();
         }
       }
     } catch (err) {
@@ -1890,26 +1903,29 @@ var TopoloClient = class _TopoloClient {
 };
 function validateActionResource(entry, resource) {
   const permissionName = entry.permissionName || entry.requiredPermission.split(".").at(-1) || "";
-  if (!permissionName.startsWith("workspace:")) return null;
+  const declaredContext = entry.agentContract?.resourceContext;
+  const declaredKind = typeof declaredContext?.kind === "string" ? declaredContext.kind.trim() : "";
+  const expectedType = declaredKind || (permissionName.startsWith("workspace:") ? "workspace" : "");
+  if (!expectedType || declaredContext?.required === false && !permissionName.startsWith("workspace:")) return null;
   if (!resource) {
     return {
       path: "$.resource",
       code: "required",
-      message: "Select a workspace with the application resource catalog before planning or calling this action."
+      message: `Select resourceType "${expectedType}" with the application resource catalog before planning or calling this action.`
     };
   }
-  if (resource.resourceType !== "workspace") {
+  if (resource.resourceType !== expectedType) {
     return {
       path: "$.resource.resourceType",
       code: "const",
-      message: 'This action requires resourceType "workspace".'
+      message: `This action requires resourceType "${expectedType}".`
     };
   }
   if (!resource.resourceId.trim()) {
     return {
       path: "$.resource.resourceId",
       code: "required",
-      message: "This action requires a workspace resourceId."
+      message: `This action requires a ${expectedType} resourceId.`
     };
   }
   return null;
@@ -2283,7 +2299,8 @@ function compactActionCatalogEntry(action) {
     agentAccess: action.agentAccess ?? (action.requiresConfirmation ? "confirm" : action.readOnly ? "auto" : "confirm"),
     requiredPermission: action.requiredPermission,
     requiredInput: required,
-    resourceType: action.agentContract?.resource?.kind ?? null,
+    resourceType: action.agentContract?.resourceContext?.kind ?? (action.permissionName.startsWith("workspace:") ? "workspace" : null),
+    resultResourceType: action.agentContract?.resource?.kind ?? null,
     exampleInput: example.value,
     exampleInputAvailable: example.available,
     docsUrl: action.agentContract?.docsUrl ?? null
@@ -3494,6 +3511,8 @@ function validateLocalization(value, path, errors) {
   nonEmptyString(value.locale, `${path}.locale`, errors);
   nonEmptyString(value.titleKey, `${path}.titleKey`, errors);
   optionalNonEmptyString(value.descriptionKey, `${path}.descriptionKey`, errors);
+  optionalNonEmptyString(value.title, `${path}.title`, errors);
+  optionalNonEmptyString(value.description, `${path}.description`, errors);
 }
 function validateAccessibility(value, path, errors) {
   if (!recordValue(value, path, errors)) return;

package/dist/index.d.cts

@@ -254,6 +254,10 @@ interface TopoloActionCatalogEntry {
 }
 interface TopoloActionAgentContract {
     docsUrl?: string;
+    resourceContext?: {
+        kind?: string;
+        required?: boolean;
+    };
     resource?: {
         kind?: string;
         idPath?: string;
@@ -513,6 +517,7 @@ declare function compactActionCatalogEntry(action: TopoloActionCatalogEntry): {
     requiredPermission: string;
     requiredInput: string[];
     resourceType: string | null;
+    resultResourceType: string | null;
     exampleInput: Record<string, unknown> | null;
     exampleInputAvailable: boolean;
     docsUrl: string | null;
@@ -1325,6 +1330,16 @@ interface TopoloWidgetLocalization {
     locale: string;
     titleKey: string;
     descriptionKey?: string;
+    /**
+     * English source text for `titleKey`. Hosts already fall back to their own
+     * title when the key misses, so this changes no rendering — it exists so the
+     * key HAS a source string: the i18n extractor reads a sibling literal named
+     * after the key's field, and without one the key never reaches a catalog and
+     * cannot be translated into any locale.
+     */
+    title?: string;
+    /** English source text for `descriptionKey`. See `title`. */
+    description?: string;
 }
 interface TopoloWidgetAccessibility {
     label: string;

package/dist/index.d.ts

@@ -254,6 +254,10 @@ interface TopoloActionCatalogEntry {
 }
 interface TopoloActionAgentContract {
     docsUrl?: string;
+    resourceContext?: {
+        kind?: string;
+        required?: boolean;
+    };
     resource?: {
         kind?: string;
         idPath?: string;
@@ -513,6 +517,7 @@ declare function compactActionCatalogEntry(action: TopoloActionCatalogEntry): {
     requiredPermission: string;
     requiredInput: string[];
     resourceType: string | null;
+    resultResourceType: string | null;
     exampleInput: Record<string, unknown> | null;
     exampleInputAvailable: boolean;
     docsUrl: string | null;
@@ -1325,6 +1330,16 @@ interface TopoloWidgetLocalization {
     locale: string;
     titleKey: string;
     descriptionKey?: string;
+    /**
+     * English source text for `titleKey`. Hosts already fall back to their own
+     * title when the key misses, so this changes no rendering — it exists so the
+     * key HAS a source string: the i18n extractor reads a sibling literal named
+     * after the key's field, and without one the key never reaches a catalog and
+     * cannot be translated into any locale.
+     */
+    title?: string;
+    /** English source text for `descriptionKey`. See `title`. */
+    description?: string;
 }
 interface TopoloWidgetAccessibility {
     label: string;

package/dist/index.js

@@ -1145,16 +1145,29 @@ var TopoloClient = class _TopoloClient {
         clearTimeout(timeoutId);
       }
     };
+    const fetchWithReadRetry = async () => {
+      const maxAttempts = method === "GET" ? 2 : 1;
+      for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        try {
+          return await fetchOnce();
+        } catch (error) {
+          const transportFailure = !(error instanceof TopoloSdkError) && !opts.signal?.aborted;
+          if (!transportFailure || attempt === maxAttempts) throw error;
+          await new Promise((resolve) => setTimeout(resolve, 250));
+        }
+      }
+      throw new TopoloSdkError("network_error", "Topolo read retry loop exhausted.");
+    };
     let res;
     try {
       const attemptedCredential = this.credential;
-      res = await fetchOnce();
+      res = await fetchWithReadRetry();
       if (res.status === 401 && attemptedCredential.kind === "access_token" && this.refreshCredential) {
         await res.body?.cancel().catch(() => void 0);
         const refreshed = await this.refreshRejectedAccessToken(attemptedCredential.accessToken);
         if (refreshed) {
           applyAuthHeaders(headers, refreshed);
-          res = await fetchOnce();
+          res = await fetchWithReadRetry();
         }
       }
     } catch (err) {
@@ -1806,26 +1819,29 @@ var TopoloClient = class _TopoloClient {
 };
 function validateActionResource(entry, resource) {
   const permissionName = entry.permissionName || entry.requiredPermission.split(".").at(-1) || "";
-  if (!permissionName.startsWith("workspace:")) return null;
+  const declaredContext = entry.agentContract?.resourceContext;
+  const declaredKind = typeof declaredContext?.kind === "string" ? declaredContext.kind.trim() : "";
+  const expectedType = declaredKind || (permissionName.startsWith("workspace:") ? "workspace" : "");
+  if (!expectedType || declaredContext?.required === false && !permissionName.startsWith("workspace:")) return null;
   if (!resource) {
     return {
       path: "$.resource",
       code: "required",
-      message: "Select a workspace with the application resource catalog before planning or calling this action."
+      message: `Select resourceType "${expectedType}" with the application resource catalog before planning or calling this action.`
     };
   }
-  if (resource.resourceType !== "workspace") {
+  if (resource.resourceType !== expectedType) {
     return {
       path: "$.resource.resourceType",
       code: "const",
-      message: 'This action requires resourceType "workspace".'
+      message: `This action requires resourceType "${expectedType}".`
     };
   }
   if (!resource.resourceId.trim()) {
     return {
       path: "$.resource.resourceId",
       code: "required",
-      message: "This action requires a workspace resourceId."
+      message: `This action requires a ${expectedType} resourceId.`
     };
   }
   return null;
@@ -2199,7 +2215,8 @@ function compactActionCatalogEntry(action) {
     agentAccess: action.agentAccess ?? (action.requiresConfirmation ? "confirm" : action.readOnly ? "auto" : "confirm"),
     requiredPermission: action.requiredPermission,
     requiredInput: required,
-    resourceType: action.agentContract?.resource?.kind ?? null,
+    resourceType: action.agentContract?.resourceContext?.kind ?? (action.permissionName.startsWith("workspace:") ? "workspace" : null),
+    resultResourceType: action.agentContract?.resource?.kind ?? null,
     exampleInput: example.value,
     exampleInputAvailable: example.available,
     docsUrl: action.agentContract?.docsUrl ?? null
@@ -3410,6 +3427,8 @@ function validateLocalization(value, path, errors) {
   nonEmptyString(value.locale, `${path}.locale`, errors);
   nonEmptyString(value.titleKey, `${path}.titleKey`, errors);
   optionalNonEmptyString(value.descriptionKey, `${path}.descriptionKey`, errors);
+  optionalNonEmptyString(value.title, `${path}.title`, errors);
+  optionalNonEmptyString(value.description, `${path}.description`, errors);
 }
 function validateAccessibility(value, path, errors) {
   if (!recordValue(value, path, errors)) return;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@topolo/sdk",
-  "version": "0.12.0",
-  "topoloPublishedVersion": "0.12.0",
+  "version": "0.13.0",
+  "topoloPublishedVersion": "0.13.0",
   "description": "Typed client SDK for the Topolo platform. Used by TopoloCli, TopoloMCP, and third-party agents.",
   "license": "UNLICENSED",
   "author": "Topolo",