@neon/tools 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # `@neon/tools`
 
-Agent tools for the Neon Management API and for the `@neon/sdk` workflows that attach compute and return a connection string. Select only the operations and workflows an agent needs, then use the canonical descriptors directly or adapt them for MCP, Eve, and Mastra.
+Agent tools for the `@neon/sdk` ergonomic client. Select the methods an agent needs, then use the descriptors directly or adapt them for MCP, Eve, and Mastra.
 
 ```bash
 npm install @neon/tools
@@ -8,7 +8,7 @@ npm install @neon/tools
 
 ## Create tools
 
-`apiKey` is a Bearer credential: a Neon API key or a Neon OAuth access token. A function is called on every request, which is how short-lived OAuth tokens get refreshed. A credential is required when a tool executes — at construction, on `execute()`, or from MCP `authInfo` — and an empty value is rejected rather than ignored.
+Selectors are SDK paths. The returned record is keyed by those paths. Each tool's published `id` is the path in snake_case (`projects.list` → `projects_list`). `toolIds` lists every published selector.
 
 ```ts
 import { createNeonTools } from "@neon/tools";
@@ -16,111 +16,77 @@ import { createNeonTools } from "@neon/tools";
 const apiKey = process.env.NEON_API_KEY;
 if (!apiKey) throw new Error("NEON_API_KEY is required");
 
-const operations = ["listProjects", "createProject"] as const;
-
 const tools = createNeonTools({
 	apiKey,
-	operations,
+	tools: [
+		"projects.list",
+		"projects.createAndConnect",
+		"branches.createWithCompute",
+	],
 });
 
-const result = await tools.listProjects.execute({
-	limit: 10,
+const listed = await tools["projects.list"].execute({ limit: 10 });
+const created = await tools["projects.createAndConnect"].execute({
+	name: "agent-project",
+	region_id: "aws-us-east-1",
 });
 ```
 
-OAuth access tokens use the same option. Pass a getter when the token can change:
+`limit` on a list tool caps how many items come back.
+
+MCP and Mastra publish `tool.id` (`projects_list`), not the record key.
+
+`apiKey` is a Bearer credential: a Neon API key or a Neon OAuth access token. A function is called on every request, which is how short-lived OAuth tokens get refreshed. A credential is required when a tool executes — at construction, on `execute()`, or from MCP `authInfo` — and an empty value is rejected rather than ignored.
 
 ```ts
 const tools = createNeonTools({
 	apiKey: () => oauth.getAccessToken(),
-	operations,
+	tools: ["projects.list"],
 });
-```
-
-Or supply the token per call:
-
-```ts
-const tools = createNeonTools({ operations });
 
-await tools.listProjects.execute(
+await tools["projects.list"].execute(
 	{ limit: 10 },
 	{ apiKey: oauthAccessToken },
 );
 ```
 
-The returned record is keyed by OpenAPI operation ID or workflow id. Each tool includes its Zod 4 `inputSchema`, snake-case `id`, title, description, safety annotations, stability metadata, and an `execute()` function. Inputs are flat: path, query, header, and body fields sit on one object. A body that is a single object wrapper is lifted, so `create_project` takes `{ name, region_id, org_id, ... }` rather than `{ project: { name } }`. A body with several properties keeps those properties, so `create_project_branch` takes `{ project_id, branch, endpoints, annotation_value }` and `branch` is still an object. Two email-provider updates keep a `body` field because the API request is a discriminated union.
+Each tool includes its Zod 4 `inputSchema`, published `id`, title, description, safety annotations, stability metadata, and `execute()`. Inputs are snake_case at the tool boundary. `execute()` strictly validates the input, rejects unknown fields, and returns typed, JSON-safe `{ data }`. Neon SDK errors remain typed and are thrown to the caller.
 
-`operationIds` exports every valid operation selector. `execute()` strictly validates the input, rejects unknown fields instead of dropping them, and returns typed, JSON-safe `{ data }`. Neon SDK errors remain typed and are thrown to the caller.
-
-## Workflows
-
-`workflows` selects methods from the `@neon/sdk` ergonomic client. These are not OpenAPI operations: they attach a default compute, wait until the resource is ready, and return a connection string. `operations` is the generated Management API. At least one of the two arrays is required.
-
-Both workflow tools poll until the resource is ready. The default deadline is five minutes (`wait.timeoutMs`). Pass `wait: { timeoutMs: 30_000 }` on `createNeonTools` or `createNeonTool` to bound that. Set it below the host's own tool-call timeout, otherwise the host gives up first. An abort `signal` on `execute` or a wait timeout stops the poll, not the create: the branch or project may already exist, and the error does not include its id. List before retrying. `metadata.method` and `metadata.path` name the first request; extra readiness GETs are not listed there. `inject.projectId` still works on `createBranchWithCompute` because its path is `/projects/{project_id}/branches`.
+Paginated lists call `.all()` and return the item array. Do not pass a cursor; those fields are omitted from the input schema.
 
 ```ts
-const tools = createNeonTools({
-	apiKey,
-	operations: ["listProjects"],
-	workflows: ["createBranchWithCompute", "createProjectAndConnect"],
-});
-
-const { data } = await tools.createBranchWithCompute.execute({
-	project_id: "project-id",
-	name: "feature-x",
-});
-
-await tools.createProjectAndConnect.execute({
-	name: "agent-project",
-	region_id: "aws-us-east-1",
-});
+const createBranch = createNeonTool("branches.createWithCompute", { apiKey });
 ```
 
-`createNeonTool` accepts the same workflow ids:
+## Writes and waiting
 
-```ts
-const createBranch = createNeonTool("createBranchWithCompute", { apiKey });
-```
+Tools run with `waitForReadiness: true`. When a mutation response includes an `operations` array, the call waits until those operations finish. The default deadline is five minutes (`wait.timeoutMs`). Pass `wait: { timeoutMs: 30_000 }` on `createNeonTools` or `createNeonTool` to bound that. Set it below the host's own tool-call timeout, otherwise the host gives up first.
 
-`workflowIds` lists the selectors. Record keys name the entity (`createBranchWithCompute`, `createProjectAndConnect`) and call `neon.branches.createWithCompute` and `neon.projects.createAndConnect`. Published ids are `create_branch_with_compute` and `create_project_and_connect`. Input fields are snake_case, same as generated tools. `names` can rename a workflow the same way it renames an operation:
+An abort `signal` on `execute` or a wait timeout stops the poll, not the create: the branch or project may already exist, and the error does not include its id. List before retrying.
 
-```ts
-const tools = createNeonTools({
-	apiKey,
-	workflows: ["createBranchWithCompute"],
-	names: { createBranchWithCompute: "create_branch" },
-});
+`functions.deploy` can still return `pending`. Its response has no `operations` array, so the tool does not poll.
 
-tools.createBranchWithCompute.id; // "create_branch"
-```
+`metadata.method` and `metadata.path` name the first request; extra readiness GETs are not listed there.
 
-`create_project_branch` still creates a branch with no compute when `endpoints` is omitted. It can attach compute if you pass `endpoints`; it does not wait or return a connection string. Use `createBranchWithCompute` when the next step needs to connect.
+These public client methods are not tools: `projects.create`, `branches.create`, `operations.waitFor`, `postgres.roles.password`, and `storage.objects.get`. Use `projects.createAndConnect` and `branches.createWithCompute` for creates that attach compute and return a connection string. Waiting is what the write tools already do.
 
 ## Optional host add-ons
 
-None of these change the default `createNeonTools({ apiKey, operations })` path. They exist so a host can replace hand-written Management API tools without losing descriptions, call tracking, or a grant-scoped project/branch.
-
 ### Descriptions
 
-Pass a map keyed by OpenAPI operation ID or snake-case tool `id`, or a function that can append to the generated text:
+Pass a map keyed by SDK path or published `id`, or a function that can append to the generated text:
 
 ```ts
 const tools = createNeonTools({
 	apiKey,
-	operations,
+	tools: ["projects.list", "projects.delete"],
 	descriptions: {
-		listProjects:
+		"projects.list":
 			"List Neon projects in your account. Do not use for projects shared with you.",
-		delete_project:
+		projects_delete:
 			"Delete a Neon project and all its data. NEVER run autonomously; always ask the user first.",
 	},
 });
-
-const noticed = createNeonTools({
-	apiKey,
-	operations,
-	descriptions: (tool) => `${tool.description}\nNotice: scoped to one project.`,
-});
 ```
 
 ### Tracking
@@ -130,9 +96,8 @@ const noticed = createNeonTools({
 ```ts
 const tools = createNeonTools({
 	apiKey,
-	operations,
+	tools: ["projects.list"],
 	onExecute: async ({ id, execute }) => {
-		// record `id`, wrap in a span, then:
 		return execute();
 	},
 });
@@ -142,38 +107,35 @@ This package does not send analytics. Mutating `event.input` does not change a g
 
 ### Names
 
-`name` rewrites every published tool `id`. `names` overrides one tool first, keyed by OpenAPI operation ID or the generated snake-case `id`:
+`name` rewrites every published tool `id`. `names` overrides one tool first, keyed by SDK path or the generated snake-case `id`:
 
 ```ts
 const tools = createNeonTools({
 	apiKey,
-	operations: ["createProjectBranch", "listProjects"] as const,
-	names: { createProjectBranch: "create_branch" },
+	tools: ["branches.createWithCompute", "projects.list"] as const,
+	names: { "branches.createWithCompute": "create_branch" },
 	name: (id) => `neon_${id}`,
 });
-
-tools.createProjectBranch.id; // "neon_create_branch"
-tools.listProjects.id; // "neon_list_projects"
 ```
 
-The record is still keyed by operation ID (`tools.createProjectBranch`). MCP and Mastra publish `tool.id`. Eve uses the filename as the model-facing name, so name the file after the published `id`. Duplicate or non-snake-case ids throw, and a `names` key that matches no selected tool throws.
+Those tools publish as `neon_create_branch` and `neon_projects_list`. The record is still keyed by SDK path (`tools["branches.createWithCompute"]`). MCP and Mastra publish `tool.id`. Eve uses the filename as the model-facing name, so name the file after the published `id`. Duplicate or non-snake-case ids throw, and a `names` key that matches no selected tool throws.
 
 ### Project and branch injection
 
-Tools take path parameters as `project_id` and `branch_id`. A host that already knows those values can inject them, including on `createBranchWithCompute`. Without `omitFromSchema`, the published field becomes optional and a caller-supplied value wins. With `omitFromSchema: true`, the field is removed from the published schema and the injector is the only source:
+Tools take path parameters as `project_id` and `branch_id`. A host that already knows those values can inject them, including on `branches.createWithCompute`. Without `omitFromSchema`, the published field becomes optional and a caller-supplied value wins. With `omitFromSchema: true`, the field is removed from the published schema and the injector is the only source:
 
 ```ts
 const tools = createNeonTools({
 	apiKey,
-	operations: ["getProject", "deleteProjectBranch"] as const,
+	tools: ["projects.get", "branches.delete"] as const,
 	inject: {
 		projectId: "project-id",
 		omitFromSchema: true,
 	},
 });
 
-await tools.getProject.execute({});
-await tools.deleteProjectBranch.execute({ branch_id: "br-id" });
+await tools["projects.get"].execute({});
+await tools["branches.delete"].execute({ branch_id: "br-id" });
 ```
 
 Use a getter when the value is request-scoped. The getter can read the host's own `AsyncLocalStorage` (this package does not export one):
@@ -184,21 +146,21 @@ import { AsyncLocalStorage } from "node:async_hooks";
 const grant = new AsyncLocalStorage<{ projectId: string }>();
 
 const tools = createNeonTools({
-	operations: ["getProject"] as const,
+	tools: ["projects.get"] as const,
 	inject: {
 		projectId: () => grant.getStore()?.projectId,
 		omitFromSchema: true,
 	},
 });
 
-await grant.run({ projectId: "project-id" }, () => tools.getProject.execute({}));
+await grant.run({ projectId: "project-id" }, () =>
+	tools["projects.get"].execute({}),
+);
 ```
 
-Injectors only apply to tools that have that path key. `listProjects` is unchanged. Empty inject values fail closed. Invalid ids still fail the original path schema before fetch.
-
-`onExecute` and `inject` apply to workflow tools the same way they apply to generated tools. Grant filtering, read-only filtering, and access-control notices stay in the host.
+Injectors only apply to tools that have that path key. `projects.list` is unchanged. Empty inject values fail closed. Invalid ids still fail the original path schema before fetch.
 
-Injection reads the URL template, so it fills path `project_id` and `branch_id` only. Query and body fields with those names stay caller-supplied, including `getConnectionURI.branch_id`, `createOrgApiKey.project_id`, `createNeonAuthIntegration.project_id` / `branch_id`, `createNeonAuthNewUser.project_id`, `createNeonAuthProviderSDKKeys.project_id`, `transferNeonAuthProviderProject.project_id`, `addProjectJWKS.branch_id`, `createProjectEndpoint.branch_id`, `updateProjectEndpoint.branch_id`, and `getProjectAdvisorSecurityIssues.branch_id`. `omitFromSchema: true` does not hide those fields.
+Injection reads the URL template, so it fills path `project_id` and `branch_id` only. Query and body fields with those names stay caller-supplied, including `postgres.connectionString`'s `branch_id`. `omitFromSchema: true` does not hide those fields.
 
 ## Request schemas
 
@@ -216,7 +178,7 @@ const body = zCreateProjectBody.parse({
 });
 ```
 
-These are the raw OpenAPI request shapes, not the flat tool input. `zCreateProjectBody` still wraps fields in `project`. The tool `create_project` does not.
+These are the raw OpenAPI request shapes, not the tool input. `zCreateProjectBody` still wraps fields in `project`. `projects.createAndConnect` does not.
 
 These schemas are strict. If a newly added API field is not recognized, upgrade `@neon/tools`; use `@neon/sdk` directly until a matching tools release is available.
 
@@ -235,7 +197,7 @@ if (!apiKey) throw new Error("NEON_API_KEY is required");
 const server = new McpServer({ name: "neon", version: "1.0.0" });
 const tools = createNeonTools({
 	apiKey,
-	operations: ["listProjects", "createProject"] as const,
+	tools: ["projects.list", "projects.createAndConnect"] as const,
 });
 
 registerNeonTools(server, tools);
@@ -245,7 +207,7 @@ For a remote MCP server that already authenticated the client, omit `apiKey` at
 
 ```ts
 const tools = createNeonTools({
-	operations: ["listProjects", "createProject"] as const,
+	tools: ["projects.list", "projects.createAndConnect"] as const,
 });
 registerNeonTools(server, tools);
 ```
@@ -267,7 +229,6 @@ MCP annotations are advisory; the protocol does not enforce approval. Tools expo
 Eve requires Node.js 24 or later.
 
 ```ts
-// agent/tools/create_project.ts
 import { defineTool } from "eve/tools";
 import { createNeonTool } from "@neon/tools";
 import { toEveTool } from "@neon/tools/eve";
@@ -277,7 +238,7 @@ if (!apiKey) throw new Error("NEON_API_KEY is required");
 
 export default defineTool(
 	toEveTool(
-		createNeonTool("createProject", {
+		createNeonTool("projects.createAndConnect", {
 			apiKey,
 		}),
 	),
@@ -300,19 +261,19 @@ if (!apiKey) throw new Error("NEON_API_KEY is required");
 
 const neonTools = createNeonTools({
 	apiKey,
-	operations: ["listProjects", "createProject"] as const,
+	tools: ["projects.list", "projects.createAndConnect"] as const,
 });
 const configs = toMastraTools(neonTools);
 
-const listProjects = createTool(configs.list_projects);
-const createProject = createTool(configs.create_project);
+const listProjects = createTool(configs.projects_list);
+const createProject = createTool(configs.projects_create_and_connect);
 ```
 
 The adapter maps approval requirements to Mastra's `requireApproval` field and forwards its abort signal.
 
 ## Safety and binary data
 
-Every non-read operation is conservatively marked as potentially destructive and requires approval. Reads that return connection credentials, role passwords, or Neon Auth provider secrets also require approval.
+Every non-read operation is conservatively marked as potentially destructive and requires approval. Reads that return connection credentials also require approval.
 
 Binary request fields accept base64 strings:
 
@@ -322,10 +283,7 @@ import { createNeonTool } from "@neon/tools";
 const apiKey = process.env.NEON_API_KEY;
 if (!apiKey) throw new Error("NEON_API_KEY is required");
 
-const deployFunction = createNeonTool(
-	"createProjectBranchFunctionDeployment",
-	{ apiKey },
-);
+const deployFunction = createNeonTool("functions.deploy", { apiKey });
 
 await deployFunction.execute({
 	project_id: "project-id",
@@ -335,16 +293,4 @@ await deployFunction.execute({
 });
 ```
 
-Binary responses are JSON-safe:
-
-```ts
-{
-	data: {
-		base64: "aGVsbG8=",
-		contentType: "application/octet-stream",
-		size: 5,
-	},
-}
-```
-
 `@neon/tools` supports Node.js 20.19 or later. Framework integrations also require the Node.js version supported by that framework.

package/dist/index.d.ts

@@ -1,67 +1,41 @@
-import { type NeonConfig, NeonError } from "@neon/sdk";
-import { type NeonBearerCredential } from "./lib/auth.js";
+import { NeonError } from "@neon/sdk";
 import { type InjectedNeonTool, type NeonToolCustomizeOptions, type NeonToolInjectOptions, type NeonToolNameOverrides } from "./lib/customize.js";
-import { type NeonWorkflowId, type WorkflowFactories, workflowIds } from "./lib/workflows.js";
-import { type NeonOperationId, operationFactories, operationIds } from "./operations.gen.js";
+import { type NeonToolId, type ToolClientOptions, toolFactories, toolIds } from "./lib/ergonomic/index.js";
 export type { NeonBearerCredential } from "./lib/auth.js";
 export type { InjectedNeonTool, NeonToolCustomizeOptions, NeonToolDescriptionOverrides, NeonToolDescriptionSource, NeonToolInjectOptions, NeonToolInjectValue, NeonToolNameOverrides, NeonToolNameSource, NeonToolOnExecute, NeonToolOnExecuteEvent, } from "./lib/customize.js";
 export type { JsonSafe, JsonSafeBlob, NeonTool, NeonToolAnnotations, NeonToolExecutionContext, NeonToolMetadata, NeonToolResult, } from "./lib/operation.js";
-export type { NeonOperationId, NeonWorkflowId };
-export { NeonError, operationIds, workflowIds };
-type OperationFactories = typeof operationFactories;
-export type NeonTools<Operations extends readonly NeonOperationId[] = [], Workflows extends readonly NeonWorkflowId[] = []> = {
-    [Operation in Operations[number]]: ReturnType<OperationFactories[Operation]>;
-} & {
-    [Workflow in Workflows[number]]: ReturnType<WorkflowFactories[Workflow]>;
+export type { NeonToolId };
+export { NeonError, toolIds };
+type ToolFactories = typeof toolFactories;
+export type NeonTools<Tools extends readonly NeonToolId[] = []> = {
+    [Tool in Tools[number]]: ReturnType<ToolFactories[Tool]>;
 };
-export type InjectedNeonTools<Operations extends readonly NeonOperationId[], Inject, Workflows extends readonly NeonWorkflowId[] = []> = {
-    [Operation in Operations[number]]: InjectedNeonTool<ReturnType<OperationFactories[Operation]>, Inject>;
-} & {
-    [Workflow in Workflows[number]]: InjectedNeonTool<ReturnType<WorkflowFactories[Workflow]>, Inject>;
+export type InjectedNeonTools<Tools extends readonly NeonToolId[], Inject> = {
+    [Tool in Tools[number]]: InjectedNeonTool<ReturnType<ToolFactories[Tool]>, Inject>;
 };
 type WithPublishedId<Tool> = Tool extends {
     id: string;
 } ? Omit<Tool, "id"> & {
     id: string;
 } : Tool;
-export interface NeonToolsClientOptions extends Pick<NeonConfig, "baseUrl" | "fetch" | "wait">, Omit<NeonToolCustomizeOptions, "name" | "names"> {
-    apiKey?: NeonBearerCredential;
+export interface NeonToolsClientOptions extends ToolClientOptions, Omit<NeonToolCustomizeOptions, "name" | "names"> {
 }
-interface OperationSelection {
-    operations: readonly NeonOperationId[];
-    workflows?: readonly NeonWorkflowId[];
-}
-interface WorkflowSelection {
-    workflows: readonly NeonWorkflowId[];
-    operations?: readonly NeonOperationId[];
-}
-type CreateNeonToolsInput = NeonToolsClientOptions & (OperationSelection | WorkflowSelection);
-export type CreateNeonToolsOptions<Operations extends readonly NeonOperationId[] = readonly NeonOperationId[], Workflows extends readonly NeonWorkflowId[] = readonly []> = NeonToolsClientOptions & (Workflows extends readonly [] ? {
-    operations: Operations;
-    workflows?: Workflows;
-} : Operations extends readonly [] ? {
-    workflows: Workflows;
-    operations?: Operations;
-} : {
-    operations: Operations;
-    workflows: Workflows;
-});
-type SelectedOperations<T> = T extends {
-    operations: infer O extends readonly NeonOperationId[];
-} ? O : [];
-type SelectedWorkflows<T> = T extends {
-    workflows: infer W extends readonly NeonWorkflowId[];
-} ? W : [];
-type NeonToolsFor<T, Inject> = T extends CreateNeonToolsInput ? Inject extends NeonToolInjectOptions ? InjectedNeonTools<SelectedOperations<T>, Inject, SelectedWorkflows<T>> : NeonTools<SelectedOperations<T>, SelectedWorkflows<T>> : never;
-type NeonToolId = NeonOperationId | NeonWorkflowId;
-type ToolForId<Id extends NeonToolId> = Id extends NeonWorkflowId ? ReturnType<WorkflowFactories[Id]> : Id extends NeonOperationId ? ReturnType<OperationFactories[Id]> : never;
-type NamedNeonTools<Operations extends readonly NeonOperationId[], Workflows extends readonly NeonWorkflowId[], Inject> = {
-    [Operation in Operations[number]]: WithPublishedId<Inject extends NeonToolInjectOptions ? InjectedNeonTool<ReturnType<OperationFactories[Operation]>, Inject> : ReturnType<OperationFactories[Operation]>>;
-} & {
-    [Workflow in Workflows[number]]: WithPublishedId<Inject extends NeonToolInjectOptions ? InjectedNeonTool<ReturnType<WorkflowFactories[Workflow]>, Inject> : ReturnType<WorkflowFactories[Workflow]>>;
+type CreateNeonToolsInput = NeonToolsClientOptions & {
+    tools: readonly NeonToolId[];
+};
+export type CreateNeonToolsOptions<Tools extends readonly NeonToolId[] = readonly NeonToolId[]> = NeonToolsClientOptions & {
+    tools: Tools;
+};
+type SelectedTools<T> = T extends {
+    tools: infer S extends readonly NeonToolId[];
+} ? S : [];
+type NeonToolsFor<T, Inject> = T extends CreateNeonToolsInput ? Inject extends NeonToolInjectOptions ? InjectedNeonTools<SelectedTools<T>, Inject> : NeonTools<SelectedTools<T>> : never;
+type ToolForId<Id extends NeonToolId> = ReturnType<ToolFactories[Id]>;
+type NamedNeonTools<Tools extends readonly NeonToolId[], Inject> = {
+    [Tool in Tools[number]]: WithPublishedId<Inject extends NeonToolInjectOptions ? InjectedNeonTool<ReturnType<ToolFactories[Tool]>, Inject> : ReturnType<ToolFactories[Tool]>>;
 };
 type NamedNeonTool<Id extends NeonToolId, Inject> = WithPublishedId<Inject extends NeonToolInjectOptions ? InjectedNeonTool<ToolForId<Id>, Inject> : ToolForId<Id>>;
-type NamedNeonToolsFor<T, Inject> = T extends CreateNeonToolsInput ? NamedNeonTools<SelectedOperations<T>, SelectedWorkflows<T>, Inject> : never;
+type NamedNeonToolsFor<T, Inject> = T extends CreateNeonToolsInput ? NamedNeonTools<SelectedTools<T>, Inject> : never;
 export declare function createNeonTools<const T extends CreateNeonToolsInput, const Inject extends NeonToolInjectOptions | undefined = undefined>(options: T & {
     inject?: Inject;
 } & ({

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,49 +1,33 @@
-import { missingBearerCredential, requireBearerCredential } from "./lib/auth.js";
 import { applyToolCustomization, assertToolCustomizeOptions, hasToolCustomization } from "./lib/customize.js";
-import { isNeonWorkflowId, workflowFactoryFor, workflowIds } from "./lib/workflows.js";
-import { operationFactories, operationIds } from "./operations.gen.js";
-import { NeonError, createNeonClient } from "@neon/sdk";
+import { toolFactories } from "./lib/ergonomic/catalog.js";
+import { isNeonToolId, toolIds, unpublishedToolError } from "./lib/ergonomic/ids.js";
+import { NeonError } from "@neon/sdk";
 //#region src/index.ts
-const createRawClient = (options) => createNeonClient({
-	apiKey: options.apiKey === void 0 ? missingBearerCredential : requireBearerCredential(options.apiKey),
-	...options.baseUrl === void 0 ? {} : { baseUrl: options.baseUrl },
-	...options.fetch === void 0 ? {} : { fetch: options.fetch },
-	...options.wait === void 0 ? {} : { wait: options.wait }
-}).client;
-const operationFactoryFor = (operationId) => {
-	const knownOperationId = operationIds.find((candidate) => candidate === operationId);
-	if (knownOperationId === void 0) throw new TypeError(`Unknown Neon operation "${operationId}".`);
-	return operationFactories[knownOperationId];
-};
 const assertKnownNameKeys = (names, tools) => {
 	if (names === void 0 || typeof names === "function") return;
 	const known = new Set(tools.flatMap((tool) => [tool.operationId, tool.id]));
 	const unknown = Object.keys(names).filter((key) => !known.has(key));
 	if (unknown.length > 0) throw new TypeError(`Unknown Neon tool name override: ${unknown.join(", ")}`);
 };
-function assertNeonTools(value, operations, workflows) {
-	if (typeof value !== "object" || value === null) throw new TypeError("Expected generated Neon tools to be an object.");
-	for (const operationId of operations) if (!(operationId in value)) throw new TypeError(`Missing generated Neon tool "${operationId}".`);
-	for (const workflowId of workflows) if (!(workflowId in value)) throw new TypeError(`Missing Neon workflow tool "${workflowId}".`);
+function assertNeonTools(value, tools) {
+	if (typeof value !== "object" || value === null) throw new TypeError("Expected Neon tools to be an object.");
+	for (const toolId of tools) if (!(toolId in value)) throw new TypeError(`Missing Neon tool "${toolId}".`);
 }
+const factoryFor = (id) => {
+	const known = toolIds.find((candidate) => candidate === id);
+	if (known === void 0) throw unpublishedToolError(id);
+	return toolFactories[known];
+};
 const bindTools = (options) => {
 	assertToolCustomizeOptions(options);
-	const operations = options.operations ?? [];
-	const workflows = options.workflows ?? [];
-	if (operations.length === 0 && workflows.length === 0) throw new TypeError("createNeonTools requires at least one operation or workflow");
-	const selectedOperations = /* @__PURE__ */ new Set();
-	const operationEntries = operations.map((operationId) => {
-		if (selectedOperations.has(operationId)) throw new Error(`Duplicate Neon operation "${operationId}"`);
-		selectedOperations.add(operationId);
-		return [operationId, operationFactoryFor(operationId)(createRawClient(options))];
+	const selected = options.tools;
+	if (selected === void 0 || selected.length === 0) throw new TypeError("createNeonTools requires at least one tool");
+	const seen = /* @__PURE__ */ new Set();
+	const rawEntries = selected.map((toolId) => {
+		if (seen.has(toolId)) throw new Error(`Duplicate Neon tool "${toolId}"`);
+		seen.add(toolId);
+		return [toolId, factoryFor(toolId)(options)];
 	});
-	const selectedWorkflows = /* @__PURE__ */ new Set();
-	const workflowEntries = workflows.map((workflowId) => {
-		if (selectedWorkflows.has(workflowId)) throw new Error(`Duplicate Neon workflow "${workflowId}"`);
-		selectedWorkflows.add(workflowId);
-		return [workflowId, workflowFactoryFor(workflowId)(options)];
-	});
-	const rawEntries = [...operationEntries, ...workflowEntries];
 	assertKnownNameKeys(options.names, rawEntries.map(([, tool]) => tool));
 	const entries = rawEntries.map(([id, tool]) => {
 		return [id, hasToolCustomization(options) ? applyToolCustomization(tool, options) : tool];
@@ -55,23 +39,18 @@ const bindTools = (options) => {
 		publishedIds.set(tool.id, id);
 	}
 	const tools = Object.fromEntries(entries);
-	assertNeonTools(tools, operations, workflows);
+	assertNeonTools(tools, selected);
 	return tools;
 };
 function createNeonTools(options) {
 	return bindTools(options);
 }
 function createNeonTool(id, options) {
+	if (!isNeonToolId(id)) throw unpublishedToolError(id);
 	assertToolCustomizeOptions(options);
-	let tool;
-	if (isNeonWorkflowId(id)) tool = workflowFactoryFor(id)(options);
-	else {
-		const knownOperationId = operationIds.find((candidate) => candidate === id);
-		if (knownOperationId === void 0) throw new TypeError(`Unknown Neon operation or workflow "${id}".`);
-		tool = operationFactories[knownOperationId](createRawClient(options));
-	}
+	const tool = factoryFor(id)(options);
 	assertKnownNameKeys(options.names, [tool]);
 	return hasToolCustomization(options) ? applyToolCustomization(tool, options) : tool;
 }
 //#endregion
-export { NeonError, createNeonTool, createNeonTools, operationIds, workflowIds };
+export { NeonError, createNeonTool, createNeonTools, toolIds };

package/dist/lib/ergonomic/bind.d.ts

@@ -0,0 +1,54 @@
+import { type NeonClient, type NeonConfig, type Paginated } from "@neon/sdk";
+import * as z from "zod";
+import { type NeonOperationId, operationFactories } from "../../operations.gen.js";
+import { type NeonBearerCredential } from "../auth.js";
+import type { JsonSafe, NeonTool, NeonToolAnnotations, NeonToolExecutionContext } from "../operation.js";
+import type { NeonToolId } from "./ids.js";
+export interface ToolClientOptions {
+    apiKey?: NeonBearerCredential;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    wait?: NeonConfig["wait"];
+}
+type Snake<S extends string> = S extends `${infer Head}${infer Rest}` ? Head extends Uppercase<Head> ? Head extends Lowercase<Head> ? `${Head}${Snake<Rest>}` : `_${Lowercase<Head>}${Snake<Rest>}` : `${Head}${Snake<Rest>}` : S;
+export type PublishedId<Id extends string> = Id extends `${infer Head}.${infer Rest}` ? `${Snake<Head>}_${PublishedId<Rest>}` : Snake<Id>;
+export declare const publishedId: <Id extends string>(id: Id) => PublishedId<Id>;
+export declare const toolClient: (options: ToolClientOptions, context?: NeonToolExecutionContext) => NeonClient<true>;
+export declare const collectObjectList: (neon: NeonClient<true>, input: {
+    project_id: string;
+    branch_id: string;
+    bucket_name: string;
+    prefix?: string;
+    delimiter?: string;
+    limit?: number;
+}, signal?: AbortSignal) => Promise<{
+    folders: string[];
+    objects: import("@neon/sdk").BucketObject[];
+    prefix: string;
+}>;
+export declare const collectPages: <T>(list: Paginated<T>, maxItems?: number) => Promise<T[]>;
+export declare const bindTool: <const InputSchema extends z.ZodType, const Id extends string, Output>(options: ToolClientOptions, tool: Omit<NeonTool<InputSchema, Id, JsonSafe<Awaited<Output>>>, "execute">, run: (neon: NeonClient<true>, input: z.output<InputSchema>, signal?: AbortSignal) => Promise<Output>) => NeonTool<InputSchema, Id, JsonSafe<Awaited<Output>>>;
+type GeneratedTool<G extends NeonOperationId> = ReturnType<(typeof operationFactories)[G]>;
+type GeneratedSchema<G extends NeonOperationId> = GeneratedTool<G>["inputSchema"];
+type GeneratedInput<G extends NeonOperationId> = z.output<GeneratedSchema<G>>;
+type GeneratedArg<G extends NeonOperationId> = z.input<GeneratedSchema<G>>;
+type FromGeneratedMeta = {
+    list?: boolean;
+    annotations?: NeonToolAnnotations;
+    requiresApproval?: boolean;
+};
+type OmittedInput<G extends NeonOperationId, Keys extends string> = Omit<GeneratedInput<G>, Keys>;
+type OmittedArg<G extends NeonOperationId, Keys extends string> = Omit<GeneratedArg<G>, Keys>;
+export declare function fromGenerated<const Id extends NeonToolId, const G extends NeonOperationId, Output>(options: ToolClientOptions, spec: FromGeneratedMeta & {
+    id: Id;
+    generated: G;
+    run: (neon: NeonClient<true>, input: GeneratedInput<G>, signal?: AbortSignal) => Promise<Output>;
+}): NeonTool<GeneratedSchema<G>, PublishedId<Id>, JsonSafe<Awaited<Output>>>;
+export declare function fromGenerated<const Id extends NeonToolId, const G extends NeonOperationId, const Keys extends keyof GeneratedInput<G> & string, Output>(options: ToolClientOptions, spec: FromGeneratedMeta & {
+    id: Id;
+    generated: G;
+    omit: readonly Keys[];
+    run: (neon: NeonClient<true>, input: OmittedInput<G, Keys>, signal?: AbortSignal) => Promise<Output>;
+}): NeonTool<z.ZodType<OmittedInput<G, Keys>, OmittedArg<G, Keys>>, PublishedId<Id>, JsonSafe<Awaited<Output>>>;
+export {};
+//# sourceMappingURL=bind.d.ts.map

package/dist/lib/ergonomic/bind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bind.d.ts","sourceRoot":"","sources":["../../../src/lib/ergonomic/bind.ts"],"names":[],"mappings":"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"}