mcp-aiven 0.1.5

package/dist/tools/applications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/applications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/applications/index.js

@@ -0,0 +1,2 @@
+export { createApplicationTools } from './handlers.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/applications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/applications/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/applications/schemas.d.ts

@@ -0,0 +1,276 @@
+import { z } from 'zod';
+/**
+ * One entry in service_integrations. The platform uses these to automatically inject
+ * credentials into the running container as environment variables — no manual copy-paste
+ * of connection strings needed, and no app code changes required.
+ *
+ * Set env var names to match what your application already reads.
+ *
+ * Supported service_type values (must be an existing service in the same project):
+ *   - "pg"          → injects a postgres:// connection URI
+ *   - "valkey"      → injects a redis:// connection URI
+ *   - "opensearch"  → injects an https:// connection URI
+ *   - "kafka"       → injects bootstrap servers + SSL certificates (raw PEM strings)
+ */
+export declare const serviceIntegrationItem: z.ZodDiscriminatedUnion<"service_type", [z.ZodObject<{
+    service_type: z.ZodLiteral<"pg">;
+    service_name: z.ZodString;
+    env_key: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    service_type: "pg";
+    service_name: string;
+    env_key: string;
+}, {
+    service_type: "pg";
+    service_name: string;
+    env_key?: string | undefined;
+}>, z.ZodObject<{
+    service_type: z.ZodLiteral<"valkey">;
+    service_name: z.ZodString;
+    env_key: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    service_type: "valkey";
+    service_name: string;
+    env_key: string;
+}, {
+    service_type: "valkey";
+    service_name: string;
+    env_key?: string | undefined;
+}>, z.ZodObject<{
+    service_type: z.ZodLiteral<"opensearch">;
+    service_name: z.ZodString;
+    env_key: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    service_type: "opensearch";
+    service_name: string;
+    env_key: string;
+}, {
+    service_type: "opensearch";
+    service_name: string;
+    env_key?: string | undefined;
+}>, z.ZodObject<{
+    service_type: z.ZodLiteral<"kafka">;
+    service_name: z.ZodString;
+    bootstrap_servers_env: z.ZodDefault<z.ZodString>;
+    security_protocol_env: z.ZodDefault<z.ZodString>;
+    access_key_env: z.ZodDefault<z.ZodString>;
+    access_cert_env: z.ZodDefault<z.ZodString>;
+    ca_cert_env: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    service_type: "kafka";
+    service_name: string;
+    bootstrap_servers_env: string;
+    security_protocol_env: string;
+    access_key_env: string;
+    access_cert_env: string;
+    ca_cert_env: string;
+}, {
+    service_type: "kafka";
+    service_name: string;
+    bootstrap_servers_env?: string | undefined;
+    security_protocol_env?: string | undefined;
+    access_key_env?: string | undefined;
+    access_cert_env?: string | undefined;
+    ca_cert_env?: string | undefined;
+}>]>;
+export type ServiceIntegrationInput = z.infer<typeof serviceIntegrationItem>;
+export declare const deployApplicationInput: z.ZodObject<{
+    project: z.ZodString;
+    service_name: z.ZodString;
+    repository_url: z.ZodString;
+    vcs_integration_id: z.ZodOptional<z.ZodString>;
+    remote_repository_id: z.ZodOptional<z.ZodString>;
+    branch: z.ZodString;
+    build_path: z.ZodDefault<z.ZodString>;
+    port: z.ZodNumber;
+    port_name: z.ZodDefault<z.ZodString>;
+    plan: z.ZodDefault<z.ZodString>;
+    cloud: z.ZodDefault<z.ZodString>;
+    environment_variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["variable", "secret"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        key: string;
+        kind: "variable" | "secret";
+    }, {
+        value: string;
+        key: string;
+        kind?: "variable" | "secret" | undefined;
+    }>, "many">>;
+    service_integrations: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"service_type", [z.ZodObject<{
+        service_type: z.ZodLiteral<"pg">;
+        service_name: z.ZodString;
+        env_key: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service_type: "pg";
+        service_name: string;
+        env_key: string;
+    }, {
+        service_type: "pg";
+        service_name: string;
+        env_key?: string | undefined;
+    }>, z.ZodObject<{
+        service_type: z.ZodLiteral<"valkey">;
+        service_name: z.ZodString;
+        env_key: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service_type: "valkey";
+        service_name: string;
+        env_key: string;
+    }, {
+        service_type: "valkey";
+        service_name: string;
+        env_key?: string | undefined;
+    }>, z.ZodObject<{
+        service_type: z.ZodLiteral<"opensearch">;
+        service_name: z.ZodString;
+        env_key: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service_type: "opensearch";
+        service_name: string;
+        env_key: string;
+    }, {
+        service_type: "opensearch";
+        service_name: string;
+        env_key?: string | undefined;
+    }>, z.ZodObject<{
+        service_type: z.ZodLiteral<"kafka">;
+        service_name: z.ZodString;
+        bootstrap_servers_env: z.ZodDefault<z.ZodString>;
+        security_protocol_env: z.ZodDefault<z.ZodString>;
+        access_key_env: z.ZodDefault<z.ZodString>;
+        access_cert_env: z.ZodDefault<z.ZodString>;
+        ca_cert_env: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        service_type: "kafka";
+        service_name: string;
+        bootstrap_servers_env: string;
+        security_protocol_env: string;
+        access_key_env: string;
+        access_cert_env: string;
+        ca_cert_env: string;
+    }, {
+        service_type: "kafka";
+        service_name: string;
+        bootstrap_servers_env?: string | undefined;
+        security_protocol_env?: string | undefined;
+        access_key_env?: string | undefined;
+        access_cert_env?: string | undefined;
+        ca_cert_env?: string | undefined;
+    }>]>, "many">>;
+    app_service_name: z.ZodOptional<z.ZodString>;
+    app_env_key: z.ZodDefault<z.ZodString>;
+    project_vpc_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    project: string;
+    cloud: string;
+    service_name: string;
+    plan: string;
+    port: number;
+    repository_url: string;
+    branch: string;
+    build_path: string;
+    port_name: string;
+    app_env_key: string;
+    project_vpc_id?: string | undefined;
+    vcs_integration_id?: string | undefined;
+    remote_repository_id?: string | undefined;
+    environment_variables?: {
+        value: string;
+        key: string;
+        kind: "variable" | "secret";
+    }[] | undefined;
+    service_integrations?: ({
+        service_type: "pg";
+        service_name: string;
+        env_key: string;
+    } | {
+        service_type: "valkey";
+        service_name: string;
+        env_key: string;
+    } | {
+        service_type: "opensearch";
+        service_name: string;
+        env_key: string;
+    } | {
+        service_type: "kafka";
+        service_name: string;
+        bootstrap_servers_env: string;
+        security_protocol_env: string;
+        access_key_env: string;
+        access_cert_env: string;
+        ca_cert_env: string;
+    })[] | undefined;
+    app_service_name?: string | undefined;
+}, {
+    project: string;
+    service_name: string;
+    port: number;
+    repository_url: string;
+    branch: string;
+    cloud?: string | undefined;
+    project_vpc_id?: string | undefined;
+    plan?: string | undefined;
+    vcs_integration_id?: string | undefined;
+    remote_repository_id?: string | undefined;
+    build_path?: string | undefined;
+    port_name?: string | undefined;
+    environment_variables?: {
+        value: string;
+        key: string;
+        kind?: "variable" | "secret" | undefined;
+    }[] | undefined;
+    service_integrations?: ({
+        service_type: "pg";
+        service_name: string;
+        env_key?: string | undefined;
+    } | {
+        service_type: "valkey";
+        service_name: string;
+        env_key?: string | undefined;
+    } | {
+        service_type: "opensearch";
+        service_name: string;
+        env_key?: string | undefined;
+    } | {
+        service_type: "kafka";
+        service_name: string;
+        bootstrap_servers_env?: string | undefined;
+        security_protocol_env?: string | undefined;
+        access_key_env?: string | undefined;
+        access_cert_env?: string | undefined;
+        ca_cert_env?: string | undefined;
+    })[] | undefined;
+    app_service_name?: string | undefined;
+    app_env_key?: string | undefined;
+}>;
+export declare const redeployApplicationInput: z.ZodObject<{
+    project: z.ZodString;
+    service_name: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    project: string;
+    service_name: string;
+}, {
+    project: string;
+    service_name: string;
+}>;
+export declare const vcsIntegrationListInput: z.ZodObject<{
+    project: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    project: string;
+}, {
+    project: string;
+}>;
+export declare const vcsIntegrationRepositoryListInput: z.ZodObject<{
+    organization_id: z.ZodString;
+    vcs_integration_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    organization_id: string;
+    vcs_integration_id: string;
+}, {
+    organization_id: string;
+    vcs_integration_id: string;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/applications/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/tools/applications/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAoFjC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE7E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsIxB,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;EAK1B,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;;EAQzB,CAAC;AAEZ,eAAO,MAAM,iCAAiC;;;;;;;;;EAanC,CAAC"}

package/dist/tools/applications/schemas.js

@@ -0,0 +1,204 @@
+import { z } from 'zod';
+const environmentVariableItem = z.object({
+    key: z.string().describe('Environment variable name (e.g. NODE_ENV, API_KEY)'),
+    value: z.string().describe('Environment variable value'),
+    kind: z
+        .enum(['variable', 'secret'])
+        .default('variable')
+        .describe('variable = visible in UI, secret = masked in UI. Use secret for tokens, passwords, URIs.'),
+});
+/**
+ * One entry in service_integrations. The platform uses these to automatically inject
+ * credentials into the running container as environment variables — no manual copy-paste
+ * of connection strings needed, and no app code changes required.
+ *
+ * Set env var names to match what your application already reads.
+ *
+ * Supported service_type values (must be an existing service in the same project):
+ *   - "pg"          → injects a postgres:// connection URI
+ *   - "valkey"      → injects a redis:// connection URI
+ *   - "opensearch"  → injects an https:// connection URI
+ *   - "kafka"       → injects bootstrap servers + SSL certificates (raw PEM strings)
+ */
+export const serviceIntegrationItem = z.discriminatedUnion('service_type', [
+    z.object({
+        service_type: z.literal('pg'),
+        service_name: z
+            .string()
+            .describe('Name of the existing Aiven PostgreSQL service in the same project (must be RUNNING).'),
+        env_key: z
+            .string()
+            .default('DATABASE_URL')
+            .describe('Env var your app reads for the PostgreSQL connection URI (full postgres:// URI with SSL params). ' +
+            'Set to match your app — do not change your app code to fit the default. Default: "DATABASE_URL".'),
+    }),
+    z.object({
+        service_type: z.literal('valkey'),
+        service_name: z
+            .string()
+            .describe('Name of the existing Aiven Valkey service in the same project (must be RUNNING).'),
+        env_key: z
+            .string()
+            .default('REDIS_URL')
+            .describe('Env var your app reads for the Valkey connection URI (redis:// URI). ' +
+            'Set to match your app — do not change your app code to fit the default. Default: "REDIS_URL".'),
+    }),
+    z.object({
+        service_type: z.literal('opensearch'),
+        service_name: z
+            .string()
+            .describe('Name of the existing Aiven OpenSearch service in the same project (must be RUNNING).'),
+        env_key: z
+            .string()
+            .default('OPENSEARCH_URL')
+            .describe('Env var your app reads for the OpenSearch connection URI (https:// URI). ' +
+            'Set to match your app — do not change your app code to fit the default. Default: "OPENSEARCH_URL".'),
+    }),
+    z.object({
+        service_type: z.literal('kafka'),
+        service_name: z
+            .string()
+            .describe('Name of the existing Aiven Kafka service in the same project (must be RUNNING).'),
+        bootstrap_servers_env: z
+            .string()
+            .default('KAFKA_BOOTSTRAP_SERVER')
+            .describe('Env var your app reads for Kafka bootstrap servers (comma-separated host:port). ' +
+            'Set to match your app. Default: "KAFKA_BOOTSTRAP_SERVER".'),
+        security_protocol_env: z
+            .string()
+            .default('KAFKA_SECURITY_PROTOCOL')
+            .describe('Env var your app reads for the security protocol (value will be "SSL"). ' +
+            'Set to match your app. Default: "KAFKA_SECURITY_PROTOCOL".'),
+        access_key_env: z
+            .string()
+            .default('KAFKA_ACCESS_KEY')
+            .describe('Env var your app reads for the SSL client private key (raw PEM string, NOT base64). ' +
+            'Set to match your app. Default: "KAFKA_ACCESS_KEY".'),
+        access_cert_env: z
+            .string()
+            .default('KAFKA_ACCESS_CERT')
+            .describe('Env var your app reads for the SSL client certificate (raw PEM string, NOT base64). ' +
+            'Set to match your app. Default: "KAFKA_ACCESS_CERT".'),
+        ca_cert_env: z
+            .string()
+            .default('KAFKA_CA_CERT')
+            .describe('Env var your app reads for the CA certificate (raw PEM string, NOT base64). ' +
+            'Set to match your app. Default: "KAFKA_CA_CERT".'),
+    }),
+]);
+export const deployApplicationInput = z
+    .object({
+    project: z.string().describe('Aiven project name — use aiven_project_list to get valid names'),
+    service_name: z
+        .string()
+        .describe('Unique name for this application service within the project. ' +
+        'Use lowercase letters, numbers, and dashes only (e.g. "my-todo-app").'),
+    repository_url: z
+        .string()
+        .describe('Git repository HTTPS URL (e.g. https://github.com/user/repo). ' +
+        'IMPORTANT: NEVER assume the repository URL — always ask the user to confirm or provide it. ' +
+        'You may push code for the user, but ALWAYS ask for confirmation before pushing.'),
+    vcs_integration_id: z
+        .string()
+        .optional()
+        .describe('VCS integration ID for private repository access. ' +
+        'Auto-resolved via aiven_vcs_integration_list + aiven_vcs_integration_repository_list — do NOT ask the user for this value.'),
+    remote_repository_id: z
+        .string()
+        .optional()
+        .describe('Repository ID within the VCS integration. ' +
+        'Auto-resolved by matching source_url in aiven_vcs_integration_repository_list — do NOT ask the user for this value.'),
+    branch: z
+        .string()
+        .describe('Git branch to deploy from (required — no default). ' +
+        'IMPORTANT: NEVER assume the branch — always ask the user to confirm which branch to deploy from.'),
+    build_path: z
+        .string()
+        .default('')
+        .describe('Path within the repository where the Dockerfile is located. ' +
+        'Default: "." (repository root). Use a subdirectory if the Dockerfile is not at the root (e.g. "./backend").'),
+    port: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(65535)
+        .describe('The port the application listens on inside the container. ' +
+        'This MUST match the port in the Dockerfile EXPOSE directive AND the port the app binds to in code. ' +
+        'The app MUST listen on 0.0.0.0 (not 127.0.0.1 or localhost). Common values: 3000, 8000, 8080.'),
+    port_name: z
+        .string()
+        .default('default')
+        .describe('Logical name for the port. Default: "default". Rarely needs changing.'),
+    plan: z
+        .string()
+        .default('startup-50-1024')
+        .describe('Service plan. Default: "startup-50-1024" (0.5 vCPU, 1024 MB RAM). ' +
+        'Use aiven_service_type_plans with service_type="application" to list available plans.'),
+    cloud: z
+        .string()
+        .default('aws-eu-west-1')
+        .describe('Cloud region for deployment. Always confirm with the user before proceeding unless they have already explicitly specified a region. If service_integrations are provided, call aiven_service_get on each integrated service first and check their cloud_name: if all share the same cloud, propose that cloud and ask the user to confirm; if they differ, list the options and ask the user to choose. If there are no integrated services, ask the user which cloud region to deploy into.'),
+    environment_variables: z
+        .array(environmentVariableItem)
+        .optional()
+        .describe('Additional environment variables to inject into the running container. ' +
+        'Do NOT include credentials for services listed in service_integrations — those are auto-injected by the platform. ' +
+        'Common additions: NODE_ENV=production, PORT (matching the port param).'),
+    service_integrations: z
+        .array(serviceIntegrationItem)
+        .optional()
+        .describe('Aiven services to connect to this application. The platform automatically injects credentials ' +
+        'as environment variables — no manual connection strings needed, and your app code does not need to change. ' +
+        'Set env var names to match what your application already reads.\n\n' +
+        'Supported service types: "pg", "valkey", "opensearch", "kafka".\n' +
+        'Each service must already exist in the same project and be in RUNNING state (verify with aiven_service_get).\n\n' +
+        'Example — connect to Postgres and Kafka:\n' +
+        '  service_integrations: [\n' +
+        '    { service_type: "pg", service_name: "my-pg", env_key: "DATABASE_URL" },\n' +
+        '    { service_type: "kafka", service_name: "my-kafka", bootstrap_servers_env: "KAFKA_BROKERS" }\n' +
+        '  ]'),
+    app_service_name: z
+        .string()
+        .optional()
+        .describe('Name of an EXISTING Aiven Application service in the same project whose public URL ' +
+        'should be injected as an environment variable. The target service must be in RUNNING state ' +
+        'with a public URL available. Use aiven_service_get to verify before deploying.'),
+    app_env_key: z
+        .string()
+        .default('API_URL')
+        .describe('Environment variable name for the connected application URL. Default: "API_URL". ' +
+        'Only relevant when app_service_name is set.'),
+    project_vpc_id: z
+        .string()
+        .optional()
+        .describe('VPC to deploy this application into. Normally omit this — the backend auto-selects the VPC ' +
+        'when the project has exactly one active VPC in the target cloud. ' +
+        'Only provide this if the API returns a CONFLICT error saying the project has multiple VPCs ' +
+        'and you must specify one. In that case, call aiven_project_vpc_list to list available VPCs ' +
+        'and ask the user which to use.'),
+})
+    .strict();
+export const redeployApplicationInput = z
+    .object({
+    project: z.string().describe('Aiven project name'),
+    service_name: z.string().describe('Name of the existing application service to redeploy'),
+})
+    .strict();
+export const vcsIntegrationListInput = z
+    .object({
+    project: z
+        .string()
+        .describe('Aiven project name. The organization_id is resolved internally from this project.'),
+})
+    .strict();
+export const vcsIntegrationRepositoryListInput = z
+    .object({
+    organization_id: z
+        .string()
+        .describe('Organization ID returned by aiven_vcs_integration_list. Use that tool first to obtain this value.'),
+    vcs_integration_id: z
+        .string()
+        .describe('VCS integration ID returned by aiven_vcs_integration_list (e.g. "vcs-abc123").'),
+})
+    .strict();
+//# sourceMappingURL=schemas.js.map

package/dist/tools/applications/schemas.js.map

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

package/dist/tools/json-schema-to-zod.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import type { JsonSchema } from '../types.js';
+export declare function jsonSchemaToZod(schema: JsonSchema, strict?: boolean): z.ZodType;
+//# sourceMappingURL=json-schema-to-zod.d.ts.map

package/dist/tools/json-schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.d.ts","sourceRoot":"","sources":["../../src/tools/json-schema-to-zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,GAAE,OAAc,GAAG,CAAC,CAAC,OAAO,CAErF"}

package/dist/tools/json-schema-to-zod.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+export function jsonSchemaToZod(schema, strict = true) {
+    return convert(schema, strict, true);
+}
+function convert(schema, strict, isRoot) {
+    if (schema.enum) {
+        if (schema.enum.length === 0)
+            return withDescription(z.string(), schema.description);
+        const enumSchema = z.enum(schema.enum);
+        return withMeta(enumSchema, schema);
+    }
+    if (schema.oneOf ?? schema.anyOf) {
+        const variants = (schema.oneOf ?? schema.anyOf ?? []).map((s) => convert(s, true, false));
+        if (variants.length === 0)
+            return z.unknown();
+        if (variants.length === 1) {
+            const first = variants[0];
+            if (first !== undefined)
+                return first;
+        }
+        return z.union(variants);
+    }
+    switch (schema.type) {
+        case 'string':
+            return buildString(schema);
+        case 'integer':
+            return buildInteger(schema);
+        case 'number':
+            return buildNumber(schema);
+        case 'boolean':
+            return buildBoolean(schema);
+        case 'array':
+            return buildArray(schema, strict);
+        case 'object':
+        default:
+            return buildObject(schema, strict, isRoot);
+    }
+}
+function buildString(schema) {
+    let s = z.string();
+    if (schema.minLength !== undefined)
+        s = s.min(schema.minLength);
+    if (schema.maxLength !== undefined)
+        s = s.max(schema.maxLength);
+    // eslint-disable-next-line security/detect-non-literal-regexp -- pattern comes from trusted OpenAPI schema
+    if (schema.pattern !== undefined)
+        s = s.regex(new RegExp(schema.pattern));
+    let result = s;
+    if (schema.default !== undefined)
+        result = s.default(schema.default);
+    if (schema.nullable)
+        result = result.nullable();
+    return withDescription(result, schema.description);
+}
+function buildInteger(schema) {
+    let n = z.number().int();
+    if (schema.minimum !== undefined)
+        n = n.min(schema.minimum);
+    if (schema.maximum !== undefined)
+        n = n.max(schema.maximum);
+    let result = n;
+    if (schema.default !== undefined)
+        result = n.default(schema.default);
+    return withDescription(result, schema.description);
+}
+function buildNumber(schema) {
+    let n = z.number();
+    if (schema.minimum !== undefined)
+        n = n.min(schema.minimum);
+    if (schema.maximum !== undefined)
+        n = n.max(schema.maximum);
+    let result = n;
+    if (schema.default !== undefined)
+        result = n.default(schema.default);
+    return withDescription(result, schema.description);
+}
+function buildBoolean(schema) {
+    let b = z.boolean();
+    if (schema.default !== undefined)
+        b = z.boolean().default(schema.default);
+    return withDescription(b, schema.description);
+}
+function buildArray(schema, strict) {
+    const items = schema.items ? convert(schema.items, strict, false) : z.unknown();
+    const result = z.array(items);
+    return withDescription(result, schema.description);
+}
+function buildObject(schema, strict, isRoot) {
+    if (!schema.properties || Object.keys(schema.properties).length === 0) {
+        return z.record(z.unknown());
+    }
+    const requiredSet = new Set(schema.required ?? []);
+    const shape = {};
+    for (const [name, prop] of Object.entries(schema.properties)) {
+        let field = convert(prop, true, false);
+        if (!requiredSet.has(name)) {
+            field = field.optional();
+        }
+        shape[name] = field;
+    }
+    const obj = z.object(shape);
+    if (isRoot) {
+        return strict ? obj.strict() : obj.passthrough();
+    }
+    return obj;
+}
+function withDescription(schema, description) {
+    if (description)
+        return schema.describe(description);
+    return schema;
+}
+function withMeta(schema, jsonSchema) {
+    let result = schema;
+    if (jsonSchema.description)
+        result = result.describe(jsonSchema.description);
+    return result;
+}
+//# sourceMappingURL=json-schema-to-zod.js.map

package/dist/tools/json-schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-to-zod.js","sourceRoot":"","sources":["../../src/tools/json-schema-to-zod.ts"],"names":[],"mappings":"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"}

package/dist/tools/kafka/descriptions.d.ts

@@ -0,0 +1,3 @@
+export declare const CREATE_CONNECTOR_DESCRIPTION = "Create a Kafka Connect connector.\n\n**Kafka Connect plan gate \u2014 call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** available and the API returns **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call Kafka Connect tools when `service.plan` is `free-*` or you know the tier lacks Connect; explain upgrade instead of invoking the API.\n\n**Plans that typically include Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`. A 403 mentioning Connect being **disabled** is typically a **plan** limitation, not token RBAC.\n\nWhen `source_service` is provided, connection credentials (hostname, port, user, password) are automatically resolved from that Aiven service \u2014 no need to look up or provide passwords manually.\n\nSupports Debezium CDC connectors (PostgreSQL, MySQL), JDBC source/sink, and any connector class. Extra configuration fields are passed through as-is.\n\n**Prerequisites:** On a **supported** plan, the Kafka service must have Kafka Connect enabled (`user_config.kafka_connect: true`). If using Schema Registry for value/key converters, enable it too (`user_config.schema_registry: true`).\n\n**IMPORTANT \u2014 Kafka Connect takes time to initialize.** After enabling via `aiven_service_update`, call `aiven_service_get` once to check if `state` is `RUNNING` and `components` includes `kafka_connect` in state `running`. If not ready, tell the user and let them decide when to re-check. Do NOT poll in a loop or retry on 503.\n\n**IMPORTANT \u2014 topics must exist before the connector starts.** Aiven Kafka does not auto-create topics. Create all required topics using `aiven_kafka_topic_create` before or immediately after creating the connector. Topic naming depends on the connector type (e.g. Debezium uses `{topic.prefix}.{schema}.{table}`).\n\n**Assistant:** If you suggest enabling public access for Kafka (e.g. `user_config.public_access`), include this line for the user:\n- \u26A0\uFE0F WARNING: This makes the Kafka service reachable from the internet.\n\n**Lists & picks:** When turning this tool\u2019s output into user choices, curate **2\u20135** options at a time unless they explicitly ask for the full catalog. In **Claude Code**, prefer `AskUserQuestion` when appropriate.\n\n**Example \u2014 Debezium PostgreSQL CDC:**\n```\naiven_kafka_connect_create_connector(\n  project=\"my-project\",\n  service_name=\"my-kafka\",\n  source_service=\"my-pg\",\n  name=\"pg-cdc\",\n  connector_class=\"io.debezium.connector.postgresql.PostgresConnector\",\n  topic.prefix=\"cdc\",\n  table.include.list=\"public.orders,public.users\",\n  plugin.name=\"pgoutput\",\n  slot.name=\"debezium_slot\",\n  database.sslmode=\"require\",\n  publication.autocreate.mode=\"filtered\"\n)\n```";
+export declare const EDIT_CONNECTOR_DESCRIPTION = "Edit an existing Kafka Connect connector configuration.\n\n**Kafka Connect plan gate \u2014 call `aiven_service_get` first.** Read `service.plan`. On **free** Kafka plans (e.g. `free-0`), Kafka Connect is usually **not** available and the API returns **403** (e.g. \"Kafka Connect API disabled\"). Do **not** call Kafka Connect tools when `service.plan` is `free-*` or you know the tier lacks Connect; explain upgrade instead of invoking the API.\n\n**Plans that typically include Kafka Connect:** `startup-*` (e.g. `startup-2`, `startup-4`), `business-*`, `premium-*`. A 403 mentioning Connect being **disabled** is typically a **plan** limitation, not token RBAC.\n\nWhen `source_service` is provided, connection credentials (hostname, port, user, password) are automatically resolved from that Aiven service \u2014 no need to look up or provide passwords manually.\n\nSupports Debezium CDC connectors (PostgreSQL, MySQL), JDBC source/sink, and any connector class. Extra configuration fields are passed through as-is.\n\n**Prerequisites:** On a **supported** plan, the Kafka service must have Kafka Connect enabled (`user_config.kafka_connect: true`). If using Schema Registry for value/key converters, enable it too (`user_config.schema_registry: true`).\n\n**IMPORTANT \u2014 Kafka Connect takes time to initialize.** After enabling via `aiven_service_update`, call `aiven_service_get` once to check if `state` is `RUNNING` and `components` includes `kafka_connect` in state `running`. If not ready, tell the user and let them decide when to re-check. Do NOT poll in a loop or retry on 503.\n\n**IMPORTANT \u2014 topics must exist before the connector starts.** Aiven Kafka does not auto-create topics. Create all required topics using `aiven_kafka_topic_create` before or immediately after creating the connector. Topic naming depends on the connector type (e.g. Debezium uses `{topic.prefix}.{schema}.{table}`).\n\n**Assistant:** If you suggest enabling public access for Kafka (e.g. `user_config.public_access`), include this line for the user:\n- \u26A0\uFE0F WARNING: This makes the Kafka service reachable from the internet.\n\n**Lists & picks:** When turning this tool\u2019s output into user choices, curate **2\u20135** options at a time unless they explicitly ask for the full catalog. In **Claude Code**, prefer `AskUserQuestion` when appropriate.";
+//# sourceMappingURL=descriptions.d.ts.map

package/dist/tools/kafka/descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptions.d.ts","sourceRoot":"","sources":["../../../src/tools/kafka/descriptions.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,4BAA4B,2xFAmBlC,CAAC;AAER,eAAO,MAAM,0BAA0B,g0EAEnB,CAAC"}