@topolo/sdk 0.11.2 → 0.11.4

package/dist/index.cjs

@@ -54,6 +54,7 @@ __export(index_exports, {
   compactActionCatalogEntry: () => compactActionCatalogEntry,
   compactActionPlan: () => compactActionPlan,
   compactActionPreparation: () => compactActionPreparation,
+  compactActionResult: () => compactActionResult,
   compactActionValidation: () => compactActionValidation,
   createTopolo: () => createTopolo,
   createTopoloAgentExecutionContext: () => createTopoloAgentExecutionContext,
@@ -72,6 +73,7 @@ __export(index_exports, {
   friendlyAppId: () => friendlyAppId,
   listApplicationDirectory: () => listApplicationDirectory,
   parseTopoloActionUploadContract: () => parseTopoloActionUploadContract,
+  preferExactActionMatches: () => preferExactActionMatches,
   prepareTopoloActionBase64UploadInput: () => prepareTopoloActionBase64UploadInput,
   prepareTopoloActionUploadInput: () => prepareTopoloActionUploadInput,
   publicTopoloErrorMessage: () => publicTopoloErrorMessage,
@@ -2202,6 +2204,7 @@ function mergeSignals(a, b) {
 function compactActionCatalogEntry(action) {
   const required = Array.isArray(action.inputSchema["required"]) ? action.inputSchema["required"].filter((value) => typeof value === "string") : [];
   const examples = action.agentContract?.examples ?? [];
+  const example = compactExample(examples[0]?.input);
   return {
     actionId: action.actionId,
     title: action.title,
@@ -2213,13 +2216,83 @@ function compactActionCatalogEntry(action) {
     requiredPermission: action.requiredPermission,
     requiredInput: required,
     resourceType: action.agentContract?.resource?.kind ?? null,
-    exampleInput: examples[0]?.input ?? null,
+    exampleInput: example.value,
+    exampleInputAvailable: example.available,
     docsUrl: action.agentContract?.docsUrl ?? null
   };
 }
+function compactExample(input) {
+  if (!input) return { value: null, available: false };
+  const serialized = JSON.stringify(input);
+  if (serialized.length > 512) return { value: null, available: true };
+  return { value: input, available: true };
+}
 function compactActionValidation(actionId, validation) {
   return { actionId, valid: validation.valid, errors: validation.errors };
 }
+var ACTION_RESULT_MAX_DEPTH = 3;
+var ACTION_RESULT_MAX_KEYS = 12;
+var ACTION_RESULT_MAX_ORDINARY_KEYS = 5;
+var ACTION_RESULT_MAX_ITEMS = 3;
+var ACTION_RESULT_MAX_SCALARS = 60;
+var ACTION_RESULT_MAX_STRING = 256;
+function resultKeyPriority(key) {
+  if (/^(id|requestId|status|state|url|slug|name|title|version)$/i.test(key)) return 0;
+  if (/(Id|Ids|Url|Uri|Status|State|Count|Total|Version|CreatedAt|UpdatedAt)$/i.test(key)) return 1;
+  return 2;
+}
+function compactResultValue(value, depth, budget) {
+  if (value === null || typeof value === "boolean" || typeof value === "number") {
+    budget.scalars += 1;
+    return value;
+  }
+  if (typeof value === "string") {
+    budget.scalars += 1;
+    if (value.length <= ACTION_RESULT_MAX_STRING) return value;
+    return `${value.slice(0, ACTION_RESULT_MAX_STRING)}\u2026 (${value.length} chars)`;
+  }
+  if (depth >= ACTION_RESULT_MAX_DEPTH || budget.scalars >= ACTION_RESULT_MAX_SCALARS) {
+    return Array.isArray(value) ? { count: value.length, omitted: true } : { omitted: true };
+  }
+  if (Array.isArray(value)) {
+    const items = value.slice(0, ACTION_RESULT_MAX_ITEMS).map((item) => compactResultValue(item, depth + 1, budget));
+    return value.length > ACTION_RESULT_MAX_ITEMS ? { count: value.length, items, omittedItems: value.length - ACTION_RESULT_MAX_ITEMS } : items;
+  }
+  if (typeof value === "object") {
+    const record = value;
+    const allKeys = Object.keys(record);
+    const ranked = allKeys.sort((left, right) => resultKeyPriority(left) - resultKeyPriority(right));
+    const prioritized = ranked.filter((key) => resultKeyPriority(key) < 2);
+    const ordinary = ranked.filter((key) => resultKeyPriority(key) === 2);
+    const ordinaryLimit = depth === 0 ? ACTION_RESULT_MAX_ORDINARY_KEYS : prioritized.length ? 1 : ACTION_RESULT_MAX_ORDINARY_KEYS;
+    const keys = [
+      ...prioritized,
+      ...ordinary.slice(0, ordinaryLimit)
+    ].slice(0, ACTION_RESULT_MAX_KEYS);
+    const compact = Object.fromEntries(keys.map((key) => [key, compactResultValue(record[key], depth + 1, budget)]));
+    if (allKeys.length > keys.length) compact["_omittedKeys"] = allKeys.length - keys.length;
+    return compact;
+  }
+  budget.scalars += 1;
+  return String(value);
+}
+function compactActionResult(actionId, result) {
+  let normalized = result;
+  if (typeof result === "string") {
+    try {
+      normalized = JSON.parse(result);
+    } catch {
+      normalized = result;
+    }
+  }
+  return { actionId, result: compactResultValue(normalized, 0, { scalars: 0 }) };
+}
+function preferExactActionMatches(actions, query) {
+  const expected = query?.trim().toLowerCase();
+  if (!expected) return actions;
+  const exact = actions.filter((action) => [action.actionId, action.name, action.toolName].some((candidate) => candidate?.trim().toLowerCase() === expected));
+  return exact.length ? exact : actions;
+}
 function compactActionPlan(plan) {
   return {
     actionId: plan.action.actionId,
@@ -5470,6 +5543,7 @@ function createTopolo(options) {
   compactActionCatalogEntry,
   compactActionPlan,
   compactActionPreparation,
+  compactActionResult,
   compactActionValidation,
   createTopolo,
   createTopoloAgentExecutionContext,
@@ -5488,6 +5562,7 @@ function createTopolo(options) {
   friendlyAppId,
   listApplicationDirectory,
   parseTopoloActionUploadContract,
+  preferExactActionMatches,
   prepareTopoloActionBase64UploadInput,
   prepareTopoloActionUploadInput,
   publicTopoloErrorMessage,

package/dist/index.d.cts

@@ -508,6 +508,7 @@ declare function compactActionCatalogEntry(action: TopoloActionCatalogEntry): {
     requiredInput: string[];
     resourceType: string | null;
     exampleInput: Record<string, unknown> | null;
+    exampleInputAvailable: boolean;
     docsUrl: string | null;
 };
 declare function compactActionValidation(actionId: string, validation: TopoloActionValidationResult): {
@@ -515,6 +516,11 @@ declare function compactActionValidation(actionId: string, validation: TopoloAct
     valid: boolean;
     errors: TopoloActionValidationIssue[];
 };
+declare function compactActionResult(actionId: string, result: unknown): {
+    actionId: string;
+    result: unknown;
+};
+declare function preferExactActionMatches(actions: TopoloActionCatalogEntry[], query?: string): TopoloActionCatalogEntry[];
 declare function compactActionPlan(plan: TopoloActionPlan): {
     actionId: string;
     valid: boolean;
@@ -2724,4 +2730,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionValidation, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };
+export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionResult, compactActionValidation, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, preferExactActionMatches, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };

package/dist/index.d.ts

@@ -508,6 +508,7 @@ declare function compactActionCatalogEntry(action: TopoloActionCatalogEntry): {
     requiredInput: string[];
     resourceType: string | null;
     exampleInput: Record<string, unknown> | null;
+    exampleInputAvailable: boolean;
     docsUrl: string | null;
 };
 declare function compactActionValidation(actionId: string, validation: TopoloActionValidationResult): {
@@ -515,6 +516,11 @@ declare function compactActionValidation(actionId: string, validation: TopoloAct
     valid: boolean;
     errors: TopoloActionValidationIssue[];
 };
+declare function compactActionResult(actionId: string, result: unknown): {
+    actionId: string;
+    result: unknown;
+};
+declare function preferExactActionMatches(actions: TopoloActionCatalogEntry[], query?: string): TopoloActionCatalogEntry[];
 declare function compactActionPlan(plan: TopoloActionPlan): {
     actionId: string;
     valid: boolean;
@@ -2724,4 +2730,4 @@ declare function createTopolo(options: TopoloClientOptions): {
 };
 type Topolo = ReturnType<typeof createTopolo>;
 
-export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionValidation, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };
+export { ACTION_CATALOG_DIGEST_ALGORITHM, APPLICATIONS, APPLICATION_REQUIREMENTS, APPLICATION_REQUIREMENTS_VERSION, type ActionContractManifest, type ActionContractSource, type AgentIdentity, type AppApiId, type ApplicationCatalogEntry, type ApplicationDeployTarget, type ApplicationDirectory, type ApplicationDirectoryApplication, type ApplicationDirectoryClient, type ApplicationDirectorySource, type ApplicationId, type ApplicationRequirement, type ApplicationRequirementAudit, type ApplicationRequirementFinding, type ApplicationRequirementMigrationItem, type ApplicationRequirementScope, type ApplicationRequirementScore, type ApplicationRequirementStatus, type ApplicationRequirementsAuditReport, type CredentialIntrospection, type CrmContactSummary, CrmModule, DEFAULT_APP_URLS, type DeviceAuthorizationResponse, IdentityModule, type ListContactsOptions, type ListContactsResult, type OAuthHelperOptions, type P2PActionDetail, type P2PActionRequestInput, type P2PActionRequestResult, type P2PActionRow, type P2PActionRun, type P2PCapability, type P2PConnection, type P2PHold, type P2PLedgerEntry, P2PModule, type P2PPolicy, type P2PPricingModel, type P2PSettlementBatch, type P2PSettlementGroup, type PublishCapabilityInput, type RequestOptions, type ServiceCatalogUrlEntry, TOPOLO_ENVIRONMENT_SERVICE_URLS, TOPOLO_RUNTIME_ENVIRONMENTS, TOPOLO_WIDGET_ENDPOINT, TOPOLO_WIDGET_REFRESH_INTERVAL_MS, type TokenResponse, type Topolo, type TopoloActionAgentContract, type TopoloActionCatalogEntry, type TopoloActionCatalogSummary, type TopoloActionDigestInput, type TopoloActionPlan, type TopoloActionPreparation, type TopoloActionUploadOptions, type TopoloActionValidationIssue, type TopoloActionValidationResult, type TopoloAgentExecutionContext, type TopoloApiKeyResourceMetadata, TopoloAuthError, type TopoloBindableResource, type TopoloBindableResourceCatalog, type TopoloChartWidget, TopoloClient, type TopoloClientOptions, TopoloConfirmationRequiredError, type TopoloCredential, type TopoloDebugEvent, TopoloHttpError, type TopoloInlineBase64UploadContract, type TopoloNotificationsWidget, TopoloOAuth, TopoloPermissionError, type TopoloQuickActionsWidget, type TopoloRecentActivityWidget, type TopoloRuntimeEnvironment, TopoloSdkError, type TopoloServiceCatalogEntry, type TopoloStatsWidget, type TopoloWidget, type TopoloWidgetActionItem, type TopoloWidgetActivityItem, type TopoloWidgetApiResponse, type TopoloWidgetBase, type TopoloWidgetConfig, type TopoloWidgetDraft, type TopoloWidgetMetric, type TopoloWidgetNotificationItem, type TopoloWidgetResponseOptions, type TopoloWidgetSnapshotMetadata, type TopoloWidgetSnapshotMetric, type TopoloWidgetType, type TopoloWidgetValidationResult, type TopoloWorkspace, type TopoloWorkspaceListResult, type TopoloWorkspaceMutationResult, type TopoloWorkspacePolicy, WorkspacesModule, actionContractCompleteness, applicationEntryFromCatalog, applicationRequirementScopes, assertTopoloServiceUrlEnvironment, auditAllApplicationRequirements, auditApplicationEntries, auditApplicationRequirements, canonicalTopoloErrorCode, canonicalTopoloRequestId, canonicalTopoloRequired, canonicalTopoloRetryAfter, compactActionCatalogEntry, compactActionPlan, compactActionPreparation, compactActionResult, compactActionValidation, createTopolo, createTopoloAgentExecutionContext, createTopoloWidgetError, createTopoloWidgetResponse, defineTopoloChartWidget, defineTopoloNotificationsWidget, defineTopoloQuickActionsWidget, defineTopoloRecentActivityWidget, defineTopoloStatsWidget, digestTopoloActionCatalog, enrichActionContract, extractTopoloServiceErrorCode, extractTopoloServiceErrorDetails, formatDirectoryApplicationIds, friendlyAppId, listApplicationDirectory, parseTopoloActionUploadContract, preferExactActionMatches, prepareTopoloActionBase64UploadInput, prepareTopoloActionUploadInput, publicTopoloErrorMessage, requirementsForApplication, resolveApplicationDirectoryEntry, resolveCatalogServiceUrl, resolveServiceUrl, topoloErrorHint, topoloServiceOrigins, validateTopoloActionInput, validateTopoloWidgetResponse };

package/dist/index.js

@@ -2114,6 +2114,7 @@ function mergeSignals(a, b) {
 function compactActionCatalogEntry(action) {
   const required = Array.isArray(action.inputSchema["required"]) ? action.inputSchema["required"].filter((value) => typeof value === "string") : [];
   const examples = action.agentContract?.examples ?? [];
+  const example = compactExample(examples[0]?.input);
   return {
     actionId: action.actionId,
     title: action.title,
@@ -2125,13 +2126,83 @@ function compactActionCatalogEntry(action) {
     requiredPermission: action.requiredPermission,
     requiredInput: required,
     resourceType: action.agentContract?.resource?.kind ?? null,
-    exampleInput: examples[0]?.input ?? null,
+    exampleInput: example.value,
+    exampleInputAvailable: example.available,
     docsUrl: action.agentContract?.docsUrl ?? null
   };
 }
+function compactExample(input) {
+  if (!input) return { value: null, available: false };
+  const serialized = JSON.stringify(input);
+  if (serialized.length > 512) return { value: null, available: true };
+  return { value: input, available: true };
+}
 function compactActionValidation(actionId, validation) {
   return { actionId, valid: validation.valid, errors: validation.errors };
 }
+var ACTION_RESULT_MAX_DEPTH = 3;
+var ACTION_RESULT_MAX_KEYS = 12;
+var ACTION_RESULT_MAX_ORDINARY_KEYS = 5;
+var ACTION_RESULT_MAX_ITEMS = 3;
+var ACTION_RESULT_MAX_SCALARS = 60;
+var ACTION_RESULT_MAX_STRING = 256;
+function resultKeyPriority(key) {
+  if (/^(id|requestId|status|state|url|slug|name|title|version)$/i.test(key)) return 0;
+  if (/(Id|Ids|Url|Uri|Status|State|Count|Total|Version|CreatedAt|UpdatedAt)$/i.test(key)) return 1;
+  return 2;
+}
+function compactResultValue(value, depth, budget) {
+  if (value === null || typeof value === "boolean" || typeof value === "number") {
+    budget.scalars += 1;
+    return value;
+  }
+  if (typeof value === "string") {
+    budget.scalars += 1;
+    if (value.length <= ACTION_RESULT_MAX_STRING) return value;
+    return `${value.slice(0, ACTION_RESULT_MAX_STRING)}\u2026 (${value.length} chars)`;
+  }
+  if (depth >= ACTION_RESULT_MAX_DEPTH || budget.scalars >= ACTION_RESULT_MAX_SCALARS) {
+    return Array.isArray(value) ? { count: value.length, omitted: true } : { omitted: true };
+  }
+  if (Array.isArray(value)) {
+    const items = value.slice(0, ACTION_RESULT_MAX_ITEMS).map((item) => compactResultValue(item, depth + 1, budget));
+    return value.length > ACTION_RESULT_MAX_ITEMS ? { count: value.length, items, omittedItems: value.length - ACTION_RESULT_MAX_ITEMS } : items;
+  }
+  if (typeof value === "object") {
+    const record = value;
+    const allKeys = Object.keys(record);
+    const ranked = allKeys.sort((left, right) => resultKeyPriority(left) - resultKeyPriority(right));
+    const prioritized = ranked.filter((key) => resultKeyPriority(key) < 2);
+    const ordinary = ranked.filter((key) => resultKeyPriority(key) === 2);
+    const ordinaryLimit = depth === 0 ? ACTION_RESULT_MAX_ORDINARY_KEYS : prioritized.length ? 1 : ACTION_RESULT_MAX_ORDINARY_KEYS;
+    const keys = [
+      ...prioritized,
+      ...ordinary.slice(0, ordinaryLimit)
+    ].slice(0, ACTION_RESULT_MAX_KEYS);
+    const compact = Object.fromEntries(keys.map((key) => [key, compactResultValue(record[key], depth + 1, budget)]));
+    if (allKeys.length > keys.length) compact["_omittedKeys"] = allKeys.length - keys.length;
+    return compact;
+  }
+  budget.scalars += 1;
+  return String(value);
+}
+function compactActionResult(actionId, result) {
+  let normalized = result;
+  if (typeof result === "string") {
+    try {
+      normalized = JSON.parse(result);
+    } catch {
+      normalized = result;
+    }
+  }
+  return { actionId, result: compactResultValue(normalized, 0, { scalars: 0 }) };
+}
+function preferExactActionMatches(actions, query) {
+  const expected = query?.trim().toLowerCase();
+  if (!expected) return actions;
+  const exact = actions.filter((action) => [action.actionId, action.name, action.toolName].some((candidate) => candidate?.trim().toLowerCase() === expected));
+  return exact.length ? exact : actions;
+}
 function compactActionPlan(plan) {
   return {
     actionId: plan.action.actionId,
@@ -5381,6 +5452,7 @@ export {
   compactActionCatalogEntry,
   compactActionPlan,
   compactActionPreparation,
+  compactActionResult,
   compactActionValidation,
   createTopolo,
   createTopoloAgentExecutionContext,
@@ -5399,6 +5471,7 @@ export {
   friendlyAppId,
   listApplicationDirectory,
   parseTopoloActionUploadContract,
+  preferExactActionMatches,
   prepareTopoloActionBase64UploadInput,
   prepareTopoloActionUploadInput,
   publicTopoloErrorMessage,

package/package.json

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