@agent-native/dispatch 0.15.2 → 0.15.3

package/dist/actions/delete-staged-dataset.d.ts

@@ -1,4 +1,6 @@
-declare const _default: import("@agent-native/core").ActionDefinition<{
+declare const _default: import("node_modules/@agent-native/core/dist/action.js").ActionDefinition<{
+    datasetId: string;
+} | {
     datasetId: string;
 }, {
     deleted: boolean;

package/dist/actions/delete-staged-dataset.js

@@ -1,31 +1,8 @@
-import { defineAction } from "@agent-native/core";
-import { deleteStagedDataset } from "@agent-native/core/provider-api/staged-datasets-store";
-import { getCredentialContext } from "@agent-native/core/server/request-context";
-import { z } from "zod";
+import { createDeleteStagedDatasetAction } from "@agent-native/core/provider-api/actions/staged-datasets";
 import { DISPATCH_APP_ID } from "../server/lib/provider-api.js";
-export default defineAction({
+export default createDeleteStagedDatasetAction({
+    appId: DISPATCH_APP_ID,
     description: "Delete a staged dataset by id, freeing its scratch storage. Use after analysis is complete or before re-staging under the same name. Only the owner who staged the dataset can delete it.",
-    schema: z.object({
-        datasetId: z
-            .string()
-            .min(1)
-            .describe("Dataset id to delete (from list-staged-datasets or provider-api-request stageAs result)."),
-    }),
     http: false,
-    run: async (args) => {
-        const ctx = getCredentialContext();
-        if (!ctx) {
-            throw new Error("No authenticated context for delete-staged-dataset.");
-        }
-        const deleted = await deleteStagedDataset({
-            id: args.datasetId,
-            appId: DISPATCH_APP_ID,
-            ownerEmail: ctx.userEmail,
-        });
-        if (!deleted) {
-            throw new Error(`Dataset ${args.datasetId} not found (or belongs to a different owner/app).`);
-        }
-        return { deleted: true, datasetId: args.datasetId };
-    },
 });
 //# sourceMappingURL=delete-staged-dataset.js.map

package/dist/actions/delete-staged-dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"delete-staged-dataset.js","sourceRoot":"","sources":["../../src/actions/delete-staged-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uDAAuD,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,2LAA2L;IAC7L,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,0FAA0F,CAC3F;KACJ,CAAC;IACF,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC;YACxC,EAAE,EAAE,IAAI,CAAC,SAAS;YAClB,KAAK,EAAE,eAAe;YACtB,UAAU,EAAE,GAAG,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,CAAC,SAAS,mDAAmD,CAC7E,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core\";\nimport { deleteStagedDataset } from \"@agent-native/core/provider-api/staged-datasets-store\";\nimport { getCredentialContext } from \"@agent-native/core/server/request-context\";\nimport { z } from \"zod\";\n\nimport { DISPATCH_APP_ID } from \"../server/lib/provider-api.js\";\n\nexport default defineAction({\n  description:\n    \"Delete a staged dataset by id, freeing its scratch storage. Use after analysis is complete or before re-staging under the same name. Only the owner who staged the dataset can delete it.\",\n  schema: z.object({\n    datasetId: z\n      .string()\n      .min(1)\n      .describe(\n        \"Dataset id to delete (from list-staged-datasets or provider-api-request stageAs result).\",\n      ),\n  }),\n  http: false,\n  run: async (args) => {\n    const ctx = getCredentialContext();\n    if (!ctx) {\n      throw new Error(\"No authenticated context for delete-staged-dataset.\");\n    }\n\n    const deleted = await deleteStagedDataset({\n      id: args.datasetId,\n      appId: DISPATCH_APP_ID,\n      ownerEmail: ctx.userEmail,\n    });\n\n    if (!deleted) {\n      throw new Error(\n        `Dataset ${args.datasetId} not found (or belongs to a different owner/app).`,\n      );\n    }\n\n    return { deleted: true, datasetId: args.datasetId };\n  },\n});\n"]}
+{"version":3,"file":"delete-staged-dataset.js","sourceRoot":"","sources":["../../src/actions/delete-staged-dataset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAE1G,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAe,+BAA+B,CAAC;IAC7C,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,2LAA2L;IAC7L,IAAI,EAAE,KAAK;CACZ,CAAC,CAAC","sourcesContent":["import { createDeleteStagedDatasetAction } from \"@agent-native/core/provider-api/actions/staged-datasets\";\n\nimport { DISPATCH_APP_ID } from \"../server/lib/provider-api.js\";\n\nexport default createDeleteStagedDatasetAction({\n  appId: DISPATCH_APP_ID,\n  description:\n    \"Delete a staged dataset by id, freeing its scratch storage. Use after analysis is complete or before re-staging under the same name. Only the owner who staged the dataset can delete it.\",\n  http: false,\n});\n"]}

package/dist/actions/delete-workspace-resource.d.ts

@@ -1,19 +1,6 @@
 declare const _default: import("@agent-native/core").ActionDefinition<{
     id: string;
 }, {
-    id: string;
-    ownerEmail: string;
-    orgId: string | null;
-    kind: string;
-    name: string;
-    description: string | null;
-    path: string;
-    content: string;
-    scope: string;
-    createdBy: string;
-    createdAt: number;
-    updatedAt: number;
-} | {
     id: string;
     ownerEmail: string;
     orgId: string | null;
@@ -30,6 +17,19 @@ declare const _default: import("@agent-native/core").ActionDefinition<{
     reviewedAt: number | null;
     createdAt: number;
     updatedAt: number;
+} | {
+    id: string;
+    ownerEmail: string;
+    orgId: string | null;
+    kind: string;
+    name: string;
+    description: string | null;
+    path: string;
+    content: string;
+    scope: string;
+    createdBy: string;
+    createdAt: number;
+    updatedAt: number;
 }>;
 export default _default;
 //# sourceMappingURL=delete-workspace-resource.d.ts.map

package/dist/actions/list-staged-datasets.d.ts

@@ -1,4 +1,4 @@
-declare const _default: import("@agent-native/core").ActionDefinition<Record<string, never>, {
+declare const _default: import("node_modules/@agent-native/core/dist/action.js").ActionDefinition<Record<string, never>, {
     datasets: {
         id: string;
         name: string;

package/dist/actions/list-staged-datasets.js

@@ -1,33 +1,8 @@
-import { defineAction } from "@agent-native/core";
-import { listStagedDatasets } from "@agent-native/core/provider-api/staged-datasets-store";
-import { getCredentialContext } from "@agent-native/core/server/request-context";
-import { z } from "zod";
+import { createListStagedDatasetsAction } from "@agent-native/core/provider-api/actions/staged-datasets";
 import { DISPATCH_APP_ID } from "../server/lib/provider-api.js";
-export default defineAction({
+export default createListStagedDatasetsAction({
+    appId: DISPATCH_APP_ID,
     description: "List staged datasets stored by provider-api-request (stageAs) for the current user. Returns dataset ids, names, row counts, columns, and sizes. Use dataset ids with query-staged-dataset to aggregate, or with delete-staged-dataset to free scratch storage.",
-    schema: z.object({}),
     http: { method: "GET" },
-    readOnly: true,
-    run: async () => {
-        const ctx = getCredentialContext();
-        if (!ctx) {
-            throw new Error("No authenticated context for list-staged-datasets.");
-        }
-        const datasets = await listStagedDatasets({
-            appId: DISPATCH_APP_ID,
-            ownerEmail: ctx.userEmail,
-        });
-        return {
-            datasets: datasets.map((d) => ({
-                id: d.id,
-                name: d.name,
-                rowCount: d.rowCount,
-                columns: d.columns,
-                byteSize: d.byteSize,
-                updatedAt: new Date(d.updatedAt).toISOString(),
-            })),
-            total: datasets.length,
-        };
-    },
 });
 //# sourceMappingURL=list-staged-datasets.js.map

package/dist/actions/list-staged-datasets.js.map

@@ -1 +1 @@
-{"version":3,"file":"list-staged-datasets.js","sourceRoot":"","sources":["../../src/actions/list-staged-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,gQAAgQ;IAClQ,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,KAAK,IAAI,EAAE;QACd,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;YACxC,KAAK,EAAE,eAAe;YACtB,UAAU,EAAE,GAAG,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;aAC/C,CAAC,CAAC;YACH,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core\";\nimport { listStagedDatasets } from \"@agent-native/core/provider-api/staged-datasets-store\";\nimport { getCredentialContext } from \"@agent-native/core/server/request-context\";\nimport { z } from \"zod\";\n\nimport { DISPATCH_APP_ID } from \"../server/lib/provider-api.js\";\n\nexport default defineAction({\n  description:\n    \"List staged datasets stored by provider-api-request (stageAs) for the current user. Returns dataset ids, names, row counts, columns, and sizes. Use dataset ids with query-staged-dataset to aggregate, or with delete-staged-dataset to free scratch storage.\",\n  schema: z.object({}),\n  http: { method: \"GET\" },\n  readOnly: true,\n  run: async () => {\n    const ctx = getCredentialContext();\n    if (!ctx) {\n      throw new Error(\"No authenticated context for list-staged-datasets.\");\n    }\n\n    const datasets = await listStagedDatasets({\n      appId: DISPATCH_APP_ID,\n      ownerEmail: ctx.userEmail,\n    });\n\n    return {\n      datasets: datasets.map((d) => ({\n        id: d.id,\n        name: d.name,\n        rowCount: d.rowCount,\n        columns: d.columns,\n        byteSize: d.byteSize,\n        updatedAt: new Date(d.updatedAt).toISOString(),\n      })),\n      total: datasets.length,\n    };\n  },\n});\n"]}
+{"version":3,"file":"list-staged-datasets.js","sourceRoot":"","sources":["../../src/actions/list-staged-datasets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yDAAyD,CAAC;AAEzG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,eAAe,8BAA8B,CAAC;IAC5C,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,gQAAgQ;IAClQ,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;CACxB,CAAC,CAAC","sourcesContent":["import { createListStagedDatasetsAction } from \"@agent-native/core/provider-api/actions/staged-datasets\";\n\nimport { DISPATCH_APP_ID } from \"../server/lib/provider-api.js\";\n\nexport default createListStagedDatasetsAction({\n  appId: DISPATCH_APP_ID,\n  description:\n    \"List staged datasets stored by provider-api-request (stageAs) for the current user. Returns dataset ids, names, row counts, columns, and sizes. Use dataset ids with query-staged-dataset to aggregate, or with delete-staged-dataset to free scratch storage.\",\n  http: { method: \"GET\" },\n});\n"]}

package/dist/actions/provider-api-catalog.d.ts

@@ -1,11 +1,13 @@
-declare const _default: import("@agent-native/core").ActionDefinition<{
-    provider?: string | undefined;
+declare const _default: import("node_modules/@agent-native/core/dist/action.js").ActionDefinition<{
+    provider?: unknown;
+} | {
+    provider?: unknown;
 }, {
     providers: unknown[] | {
         id: "amplitude" | "apollo" | "bigquery" | "clay" | "commonroom" | "dataforseo" | "figma" | "ga4" | "gcloud" | "github" | "gmail" | "gong" | "google_calendar" | "google_drive" | "google_slides" | "grafana" | "granola" | "hubspot" | "jira" | "mixpanel" | "notion" | "posthog" | "prometheus" | "pylon" | "sentry" | "slack" | "stripe" | "twitter";
         label: string;
         defaultBaseUrl: string;
-        baseUrlCredentialKey: string;
+        baseUrlCredentialKey: string | null;
         auth: string;
         credentialKeys: readonly string[];
         docsUrls: readonly string[];
@@ -16,7 +18,7 @@ declare const _default: import("@agent-native/core").ActionDefinition<{
         examples: readonly import("node_modules/@agent-native/core/dist/provider-api/index.js").ProviderApiExample[];
         notes: readonly string[];
         corpusRecipes: readonly import("node_modules/@agent-native/core/dist/provider-api/index.js").ProviderApiCorpusRecipe[];
-        templateUses: readonly import("@agent-native/core").WorkspaceConnectionTemplateUse[];
+        templateUses: readonly import("node_modules/@agent-native/core/dist/index.js").WorkspaceConnectionTemplateUse[];
     }[];
     guidance: string;
 }>;

package/dist/actions/provider-api-catalog.js

@@ -1,22 +1,8 @@
-import { defineAction } from "@agent-native/core";
-import { z } from "zod";
+import { createProviderApiCatalogAction } from "@agent-native/core/provider-api/actions/provider-api";
 import { listProviderApiCatalog } from "../server/lib/provider-api.js";
-export default defineAction({
+export default createProviderApiCatalogAction({ listCatalog: listProviderApiCatalog }, {
     description: "List raw HTTP API capabilities for shared workspace integrations, configured providers, and custom registered providers. Use before provider-api-request when grant/setup metadata is not enough and the provider's actual API must be inspected. Returns base URLs, auth style, credential key names, docs/spec URLs, placeholders, and examples; never returns secret values. Custom providers registered via provider-api-register are included.",
-    schema: z.object({
-        provider: z
-            .string()
-            .optional()
-            .describe("Optional provider id to inspect (built-in or custom). Omit to list every available provider API."),
-    }),
+    guidance: "Workspace integrations and grants are not capability limits. When a provider can answer a question through its HTTP API, inspect docs/spec URLs here and call provider-api-request with the exact provider API method/path/query/body instead of adding a rigid one-off action. For broad searches, joins, classification, or absence claims, stage or save the full bounded corpus and reduce it with query-staged-dataset or run-code. Custom providers registered via provider-api-register also appear here.",
     http: { method: "GET" },
-    readOnly: true,
-    run: async ({ provider }) => {
-        const providers = await listProviderApiCatalog(provider);
-        return {
-            providers,
-            guidance: "Workspace integrations and grants are not capability limits. When a provider can answer a question through its HTTP API, inspect docs/spec URLs here and call provider-api-request with the exact provider API method/path/query/body instead of adding a rigid one-off action. For broad searches, joins, classification, or absence claims, stage or save the full bounded corpus and reduce it with query-staged-dataset or run-code. Custom providers registered via provider-api-register also appear here.",
-        };
-    },
 });
 //# sourceMappingURL=provider-api-catalog.js.map

package/dist/actions/provider-api-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-api-catalog.js","sourceRoot":"","sources":["../../src/actions/provider-api-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,eAAe,YAAY,CAAC;IAC1B,WAAW,EACT,qbAAqb;IACvb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,kGAAkG,CACnG;KACJ,CAAC;IACF,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;IACvB,QAAQ,EAAE,IAAI;IACd,GAAG,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO;YACL,SAAS;YACT,QAAQ,EACN,kfAAkf;SACrf,CAAC;IACJ,CAAC;CACF,CAAC,CAAC","sourcesContent":["import { defineAction } from \"@agent-native/core\";\nimport { z } from \"zod\";\n\nimport { listProviderApiCatalog } from \"../server/lib/provider-api.js\";\n\nexport default defineAction({\n  description:\n    \"List raw HTTP API capabilities for shared workspace integrations, configured providers, and custom registered providers. Use before provider-api-request when grant/setup metadata is not enough and the provider's actual API must be inspected. Returns base URLs, auth style, credential key names, docs/spec URLs, placeholders, and examples; never returns secret values. Custom providers registered via provider-api-register are included.\",\n  schema: z.object({\n    provider: z\n      .string()\n      .optional()\n      .describe(\n        \"Optional provider id to inspect (built-in or custom). Omit to list every available provider API.\",\n      ),\n  }),\n  http: { method: \"GET\" },\n  readOnly: true,\n  run: async ({ provider }) => {\n    const providers = await listProviderApiCatalog(provider);\n    return {\n      providers,\n      guidance:\n        \"Workspace integrations and grants are not capability limits. When a provider can answer a question through its HTTP API, inspect docs/spec URLs here and call provider-api-request with the exact provider API method/path/query/body instead of adding a rigid one-off action. For broad searches, joins, classification, or absence claims, stage or save the full bounded corpus and reduce it with query-staged-dataset or run-code. Custom providers registered via provider-api-register also appear here.\",\n    };\n  },\n});\n"]}
+{"version":3,"file":"provider-api-catalog.js","sourceRoot":"","sources":["../../src/actions/provider-api-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,sDAAsD,CAAC;AAEtG,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,eAAe,8BAA8B,CAC3C,EAAE,WAAW,EAAE,sBAAsB,EAAE,EACvC;IACE,WAAW,EACT,qbAAqb;IACvb,QAAQ,EACN,kfAAkf;IACpf,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;CACxB,CACF,CAAC","sourcesContent":["import { createProviderApiCatalogAction } from \"@agent-native/core/provider-api/actions/provider-api\";\n\nimport { listProviderApiCatalog } from \"../server/lib/provider-api.js\";\n\nexport default createProviderApiCatalogAction(\n  { listCatalog: listProviderApiCatalog },\n  {\n    description:\n      \"List raw HTTP API capabilities for shared workspace integrations, configured providers, and custom registered providers. Use before provider-api-request when grant/setup metadata is not enough and the provider's actual API must be inspected. Returns base URLs, auth style, credential key names, docs/spec URLs, placeholders, and examples; never returns secret values. Custom providers registered via provider-api-register are included.\",\n    guidance:\n      \"Workspace integrations and grants are not capability limits. When a provider can answer a question through its HTTP API, inspect docs/spec URLs here and call provider-api-request with the exact provider API method/path/query/body instead of adding a rigid one-off action. For broad searches, joins, classification, or absence claims, stage or save the full bounded corpus and reduce it with query-staged-dataset or run-code. Custom providers registered via provider-api-register also appear here.\",\n    http: { method: \"GET\" },\n  },\n);\n"]}

package/dist/actions/provider-api-docs.d.ts

@@ -1,5 +1,24 @@
-declare const _default: import("@agent-native/core").ActionDefinition<{
-    provider: string;
+declare const _default: import("node_modules/@agent-native/core/dist/action.js").ActionDefinition<{
+    provider: unknown;
+    url?: string | undefined;
+    maxBytes?: unknown;
+    maxChars?: unknown;
+    responseMode?: "auto" | "links" | "markdown" | "matches" | "metadata" | "raw" | "text" | undefined;
+    extract?: "all-visible" | "none" | "readability" | undefined;
+    includeLinks?: unknown;
+    search?: {
+        query?: string | string[] | undefined;
+        queries?: string[] | undefined;
+        terms?: string[] | undefined;
+        regex?: string | undefined;
+        regexFlags?: string | undefined;
+        source?: "extracted" | "raw" | undefined;
+        maxMatches?: unknown;
+        contextChars?: unknown;
+        caseSensitive?: unknown;
+    } | undefined;
+} | {
+    provider: unknown;
     url?: string | undefined;
     maxBytes?: unknown;
     maxChars?: unknown;

package/dist/actions/provider-api-docs.js

@@ -1,57 +1,12 @@
-import { defineAction } from "@agent-native/core";
+import { createProviderApiDocsAction, createProviderApiDocsSchema, } from "@agent-native/core/provider-api/actions/provider-api";
 import { z } from "zod";
 import { fetchProviderApiDocs } from "../server/lib/provider-api.js";
-const BooleanFromQuerySchema = z.preprocess((value) => (typeof value === "string" ? value === "true" : value), z.boolean());
-const WebContentSearchSchema = z.object({
-    query: z.union([z.string(), z.array(z.string())]).optional(),
-    queries: z.array(z.string()).optional(),
-    terms: z.array(z.string()).optional(),
-    regex: z.string().optional(),
-    regexFlags: z.string().optional(),
-    source: z.enum(["extracted", "raw"]).optional(),
-    maxMatches: z.coerce.number().int().min(1).max(500).optional(),
-    contextChars: z.coerce.number().int().min(0).max(1_000).optional(),
-    caseSensitive: BooleanFromQuerySchema.optional(),
-});
-export default defineAction({
+export default createProviderApiDocsAction({ fetchDocs: fetchProviderApiDocs }, {
     description: "Inspect provider API docs/spec metadata, or fetch ANY public API documentation page, OpenAPI spec, changelog, or web page. Registered docs/spec URLs from provider-api-catalog are curated starting points, but any public https/http URL is allowed. Use web-search to find documentation URLs first when uncertain, then fetch them here. SSRF guard still applies — private/internal addresses are blocked.",
-    schema: z.object({
-        provider: z
-            .string()
-            .min(1)
-            .describe("Provider whose API docs/spec to inspect. Can be a built-in provider id or a custom provider id registered via provider-api-register."),
-        url: z
-            .string()
-            .url()
-            .optional()
-            .describe("Optional URL to fetch. Can be any public https/http URL — API documentation pages, OpenAPI specs, changelogs, README files, etc. Registered docs/spec URLs from provider-api-catalog are curated starting points."),
-        maxBytes: z.coerce
-            .number()
-            .int()
-            .min(1_000)
-            .max(4 * 1024 * 1024)
-            .optional()
-            .describe("Maximum response bytes to read. Default 1MB, max 4MB."),
-        maxChars: z.coerce
-            .number()
-            .int()
-            .min(1)
-            .max(200_000)
-            .optional()
-            .describe("Maximum extracted content characters to return."),
-        responseMode: z
-            .enum(["auto", "raw", "text", "markdown", "links", "metadata", "matches"])
-            .optional()
-            .describe("How to return fetched docs. Default auto extracts HTML to markdown; use matches with search for compact snippets."),
-        extract: z
-            .enum(["readability", "all-visible", "none"])
-            .optional()
-            .describe("HTML extraction strategy. Default readability."),
-        includeLinks: BooleanFromQuerySchema.optional().describe("Include compact links from extracted HTML. Default true."),
-        search: WebContentSearchSchema.optional().describe("Optional post-fetch search over extracted content by default. Supports query, queries, terms, regex, source, maxMatches, and contextChars."),
-    }),
+    schema: createProviderApiDocsSchema(z
+        .string()
+        .min(1)
+        .describe("Provider whose API docs/spec to inspect. Can be a built-in provider id or a custom provider id registered via provider-api-register.")),
     http: { method: "GET" },
-    readOnly: true,
-    run: async (args) => fetchProviderApiDocs(args),
 });
 //# sourceMappingURL=provider-api-docs.js.map

package/dist/actions/provider-api-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-api-docs.js","sourceRoot":"","sources":["../../src/actions/provider-api-docs.ts"],"names":[],"mappings":"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","sourcesContent":["import { defineAction } from \"@agent-native/core\";\nimport { z } from \"zod\";\n\nimport { fetchProviderApiDocs } from \"../server/lib/provider-api.js\";\n\nconst BooleanFromQuerySchema = z.preprocess(\n  (value) => (typeof value === \"string\" ? value === \"true\" : value),\n  z.boolean(),\n);\nconst WebContentSearchSchema = z.object({\n  query: z.union([z.string(), z.array(z.string())]).optional(),\n  queries: z.array(z.string()).optional(),\n  terms: z.array(z.string()).optional(),\n  regex: z.string().optional(),\n  regexFlags: z.string().optional(),\n  source: z.enum([\"extracted\", \"raw\"]).optional(),\n  maxMatches: z.coerce.number().int().min(1).max(500).optional(),\n  contextChars: z.coerce.number().int().min(0).max(1_000).optional(),\n  caseSensitive: BooleanFromQuerySchema.optional(),\n});\n\nexport default defineAction({\n  description:\n    \"Inspect provider API docs/spec metadata, or fetch ANY public API documentation page, OpenAPI spec, changelog, or web page. Registered docs/spec URLs from provider-api-catalog are curated starting points, but any public https/http URL is allowed. Use web-search to find documentation URLs first when uncertain, then fetch them here. SSRF guard still applies — private/internal addresses are blocked.\",\n  schema: z.object({\n    provider: z\n      .string()\n      .min(1)\n      .describe(\n        \"Provider whose API docs/spec to inspect. Can be a built-in provider id or a custom provider id registered via provider-api-register.\",\n      ),\n    url: z\n      .string()\n      .url()\n      .optional()\n      .describe(\n        \"Optional URL to fetch. Can be any public https/http URL — API documentation pages, OpenAPI specs, changelogs, README files, etc. Registered docs/spec URLs from provider-api-catalog are curated starting points.\",\n      ),\n    maxBytes: z.coerce\n      .number()\n      .int()\n      .min(1_000)\n      .max(4 * 1024 * 1024)\n      .optional()\n      .describe(\"Maximum response bytes to read. Default 1MB, max 4MB.\"),\n    maxChars: z.coerce\n      .number()\n      .int()\n      .min(1)\n      .max(200_000)\n      .optional()\n      .describe(\"Maximum extracted content characters to return.\"),\n    responseMode: z\n      .enum([\"auto\", \"raw\", \"text\", \"markdown\", \"links\", \"metadata\", \"matches\"])\n      .optional()\n      .describe(\n        \"How to return fetched docs. Default auto extracts HTML to markdown; use matches with search for compact snippets.\",\n      ),\n    extract: z\n      .enum([\"readability\", \"all-visible\", \"none\"])\n      .optional()\n      .describe(\"HTML extraction strategy. Default readability.\"),\n    includeLinks: BooleanFromQuerySchema.optional().describe(\n      \"Include compact links from extracted HTML. Default true.\",\n    ),\n    search: WebContentSearchSchema.optional().describe(\n      \"Optional post-fetch search over extracted content by default. Supports query, queries, terms, regex, source, maxMatches, and contextChars.\",\n    ),\n  }),\n  http: { method: \"GET\" },\n  readOnly: true,\n  run: async (args) => fetchProviderApiDocs(args),\n});\n"]}
+{"version":3,"file":"provider-api-docs.js","sourceRoot":"","sources":["../../src/actions/provider-api-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,eAAe,2BAA2B,CACxC,EAAE,SAAS,EAAE,oBAAoB,EAAE,EACnC;IACE,WAAW,EACT,gZAAgZ;IAClZ,MAAM,EAAE,2BAA2B,CACjC,CAAC;SACE,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,sIAAsI,CACvI,CACJ;IACD,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;CACxB,CACF,CAAC","sourcesContent":["import {\n  createProviderApiDocsAction,\n  createProviderApiDocsSchema,\n} from \"@agent-native/core/provider-api/actions/provider-api\";\nimport { z } from \"zod\";\n\nimport { fetchProviderApiDocs } from \"../server/lib/provider-api.js\";\n\nexport default createProviderApiDocsAction(\n  { fetchDocs: fetchProviderApiDocs },\n  {\n    description:\n      \"Inspect provider API docs/spec metadata, or fetch ANY public API documentation page, OpenAPI spec, changelog, or web page. Registered docs/spec URLs from provider-api-catalog are curated starting points, but any public https/http URL is allowed. Use web-search to find documentation URLs first when uncertain, then fetch them here. SSRF guard still applies — private/internal addresses are blocked.\",\n    schema: createProviderApiDocsSchema(\n      z\n        .string()\n        .min(1)\n        .describe(\n          \"Provider whose API docs/spec to inspect. Can be a built-in provider id or a custom provider id registered via provider-api-register.\",\n        ),\n    ),\n    http: { method: \"GET\" },\n  },\n);\n"]}

package/dist/actions/provider-api-register.d.ts

@@ -1,4 +1,28 @@
-declare const _default: import("@agent-native/core").ActionDefinition<{
+declare const _default: import("node_modules/@agent-native/core/dist").ActionDefinition<{
+    operation?: "delete" | "get" | "list" | "upsert" | undefined;
+    id?: string | undefined;
+    label?: string | undefined;
+    baseUrl?: string | undefined;
+    auth?: {
+        type: "none";
+    } | {
+        type: "bearer";
+        credentialKey: string;
+    } | {
+        type: "basic";
+        usernameKey: string;
+        passwordKey: string;
+    } | {
+        type: "api-key-header";
+        credentialKey: string;
+        headerName: string;
+    } | undefined;
+    docsUrls?: string[] | undefined;
+    allowedHostSuffixes?: string[] | undefined;
+    defaultHeaders?: Record<string, string> | undefined;
+    notes?: string | undefined;
+    scope?: "org" | "user" | undefined;
+} | {
     operation?: "delete" | "get" | "list" | "upsert" | undefined;
     id?: string | undefined;
     label?: string | undefined;
@@ -23,6 +47,9 @@ declare const _default: import("@agent-native/core").ActionDefinition<{
     notes?: string | undefined;
     scope?: "org" | "user" | undefined;
 }, {
+    deleted?: undefined;
+    id?: undefined;
+    found?: undefined;
     providers: {
         id: string;
         label: string;
@@ -33,37 +60,34 @@ declare const _default: import("@agent-native/core").ActionDefinition<{
         updatedAt: number;
     }[];
     count: number;
-    found?: undefined;
     provider?: undefined;
-    deleted?: undefined;
     registered?: undefined;
-    id?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    providers?: undefined;
+    deleted?: undefined;
     count?: undefined;
+    id?: undefined;
+    providers?: undefined;
     found: boolean;
-    id: string;
-    provider?: undefined;
-    deleted?: undefined;
+    provider: import("node_modules/@agent-native/core/dist/provider-api").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    providers?: undefined;
+    deleted?: undefined;
     count?: undefined;
+    providers?: undefined;
+    provider?: undefined;
     found: boolean;
-    provider: import("@agent-native/core/provider-api").CustomProviderConfig;
-    deleted?: undefined;
+    id: string;
     registered?: undefined;
-    id?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
-    providers?: undefined;
     count?: undefined;
     found?: undefined;
+    providers?: undefined;
     provider?: undefined;
     deleted: boolean;
     id: string;
@@ -71,11 +95,11 @@ declare const _default: import("@agent-native/core").ActionDefinition<{
     label?: undefined;
     message?: undefined;
 } | {
-    providers?: undefined;
+    deleted?: undefined;
     count?: undefined;
     found?: undefined;
+    providers?: undefined;
     provider?: undefined;
-    deleted?: undefined;
     registered: boolean;
     id: string;
     label: string;