@aws/agentcore 0.3.0-preview.1.0

package/dist/schema/schemas/mcp.js

@@ -0,0 +1,283 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCoreMcpSpecSchema = exports.AgentCoreMcpRuntimeToolSchema = exports.McpRuntimeBindingSchema = exports.AgentCoreGatewaySchema = exports.AgentCoreGatewayTargetSchema = exports.ToolComputeConfigSchema = exports.RuntimeConfigSchema = exports.IamPolicyDocumentSchema = exports.ToolImplementationBindingSchema = exports.ComputeHostSchema = exports.McpImplLanguageSchema = exports.GatewayAuthorizerConfigSchema = exports.CustomJwtAuthorizerConfigSchema = exports.GatewayAuthorizerTypeSchema = exports.GatewayTargetTypeSchema = void 0;
+const constants_1 = require("../constants");
+const agent_env_1 = require("./agent-env");
+const mcp_defs_1 = require("./mcp-defs");
+const zod_1 = require("zod");
+// ============================================================================
+// MCP-Specific Schemas
+// ============================================================================
+exports.GatewayTargetTypeSchema = zod_1.z.enum(['lambda', 'mcpServer', 'openApiSchema', 'smithyModel']);
+// ============================================================================
+// Gateway Authorization Schemas
+// ============================================================================
+exports.GatewayAuthorizerTypeSchema = zod_1.z.enum(['NONE', 'CUSTOM_JWT']);
+/** OIDC well-known configuration endpoint suffix (per OpenID Connect Discovery 1.0 spec) */
+const OIDC_WELL_KNOWN_SUFFIX = '/.well-known/openid-configuration';
+/**
+ * OIDC Discovery URL schema.
+ * Must be a valid URL ending with the standard OIDC well-known endpoint.
+ * @see https://openid.net/specs/openid-connect-discovery-1_0.html
+ */
+const OidcDiscoveryUrlSchema = zod_1.z
+    .string()
+    .url('Must be a valid URL')
+    .refine(url => url.endsWith(OIDC_WELL_KNOWN_SUFFIX), {
+    message: `OIDC discovery URL must end with '${OIDC_WELL_KNOWN_SUFFIX}'`,
+});
+/**
+ * Custom JWT authorizer configuration.
+ * Used when authorizerType is 'CUSTOM_JWT'.
+ */
+exports.CustomJwtAuthorizerConfigSchema = zod_1.z.object({
+    /** OIDC discovery URL (e.g., https://cognito-idp.{region}.amazonaws.com/{userPoolId}/.well-known/openid-configuration) */
+    discoveryUrl: OidcDiscoveryUrlSchema,
+    /** List of allowed audiences (typically client IDs). Empty array means no audience validation. */
+    allowedAudience: zod_1.z.array(zod_1.z.string().min(1)),
+    /** List of allowed client IDs */
+    allowedClients: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+});
+/**
+ * Gateway authorizer configuration container.
+ */
+exports.GatewayAuthorizerConfigSchema = zod_1.z.object({
+    customJwtAuthorizer: exports.CustomJwtAuthorizerConfigSchema.optional(),
+});
+exports.McpImplLanguageSchema = zod_1.z.enum(['TypeScript', 'Python']);
+exports.ComputeHostSchema = zod_1.z.enum(['Lambda', 'AgentCoreRuntime']);
+// ============================================================================
+// Branded Path Schemas
+// ============================================================================
+// Branded path schemas - cast string output to branded path types
+const DirectoryPathSchema = zod_1.z.string().min(1);
+// ============================================================================
+// Tool Implementation Binding
+// ============================================================================
+/**
+ * Code-based tool implementation (Python, TypeScript).
+ *
+ * The CLI is responsible for:
+ * - installing dependencies
+ * - building / bundling
+ * - creating a zip artifact
+ * - uploading artifacts to S3
+ */
+exports.ToolImplementationBindingSchema = zod_1.z
+    .object({
+    language: zod_1.z.enum(['TypeScript', 'Python']),
+    path: zod_1.z.string().min(1),
+    handler: zod_1.z.string().min(1),
+})
+    .strict();
+// ============================================================================
+// IAM Policy Document
+// ============================================================================
+/**
+ * Opaque IAM policy document.
+ *
+ * This is passed through verbatim to CloudFormation / IAM.
+ * AgentCore does not validate, transform, or provide compatibility guarantees.
+ */
+exports.IamPolicyDocumentSchema = zod_1.z
+    .object({
+    Version: zod_1.z.string(),
+    Statement: zod_1.z.array(zod_1.z.unknown()),
+})
+    .passthrough(); // Allow additional IAM policy fields
+// ============================================================================
+// Runtime Configuration
+// ============================================================================
+/**
+ * AgentCore Runtime name validation.
+ * Pattern: [a-zA-Z][a-zA-Z0-9_]{0,47}
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-bedrockagentcore-runtime.html#cfn-bedrockagentcore-runtime-agentruntimename
+ */
+const AgentRuntimeNameSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(48)
+    .regex(/^[a-zA-Z][a-zA-Z0-9_]{0,47}$/, 'Must begin with a letter and contain only alphanumeric characters and underscores (max 48 chars)');
+/**
+ * Python entrypoint validation for Runtime codeConfiguration.
+ * Format: "file.py" or "file.py:handler" or "path/file.py:handler"
+ */
+const PythonEntrypointSchema = zod_1.z
+    .string()
+    .min(1)
+    .regex(/^[a-zA-Z0-9_][a-zA-Z0-9_/.-]*\.py(:[a-zA-Z_][a-zA-Z0-9_]*)?$/, 'Must be a Python file path with optional handler (e.g., "main.py:agent" or "src/handler.py:app")');
+/**
+ * Instrumentation configuration for runtime observability.
+ */
+const InstrumentationSchema = zod_1.z.object({
+    /**
+     * Enable OpenTelemetry instrumentation using opentelemetry-distro.
+     * When enabled, the runtime entrypoint is wrapped with opentelemetry-instrument.
+     * Defaults to true for new runtimes.
+     */
+    enableOtel: zod_1.z.boolean().default(true),
+});
+const CodeZipRuntimeConfigSchema = zod_1.z
+    .object({
+    artifact: zod_1.z.literal('CodeZip'),
+    pythonVersion: constants_1.PythonRuntimeSchema,
+    name: AgentRuntimeNameSchema,
+    entrypoint: PythonEntrypointSchema,
+    codeLocation: DirectoryPathSchema,
+    /** Instrumentation settings for observability. Defaults to OTel enabled. */
+    instrumentation: InstrumentationSchema.optional(),
+    networkMode: constants_1.NetworkModeSchema.optional().default('PUBLIC'),
+    description: zod_1.z.string().optional(),
+})
+    .strict();
+/**
+ * Runtime configuration for AgentCore Runtime (MCP mode).
+ * Explicit CodeZip artifact configuration - no CLI-managed defaults.
+ */
+exports.RuntimeConfigSchema = CodeZipRuntimeConfigSchema;
+// ============================================================================
+// Compute Configuration
+// ============================================================================
+/**
+ * Lambda compute configuration schema.
+ * Lambda supports both Python and TypeScript.
+ */
+const LambdaComputeConfigSchema = zod_1.z
+    .object({
+    host: zod_1.z.literal('Lambda'),
+    implementation: exports.ToolImplementationBindingSchema,
+    nodeVersion: constants_1.NodeRuntimeSchema.optional(),
+    pythonVersion: constants_1.PythonRuntimeSchema.optional(),
+    timeout: zod_1.z.number().int().min(1).max(900).optional(),
+    memorySize: zod_1.z.number().int().min(128).max(10240).optional(),
+    iamPolicy: exports.IamPolicyDocumentSchema.optional(),
+})
+    .strict()
+    .refine(data => {
+    // TypeScript requires nodeVersion
+    if (data.implementation.language === 'TypeScript' && !data.nodeVersion) {
+        return false;
+    }
+    // Python requires pythonVersion
+    if (data.implementation.language === 'Python' && !data.pythonVersion) {
+        return false;
+    }
+    // Other (container) does not require runtime version - uses container image
+    return true;
+}, {
+    message: 'TypeScript Lambda must specify nodeVersion, Python Lambda must specify pythonVersion',
+});
+/**
+ * AgentCore Runtime compute configuration schema.
+ * AgentCore Runtime ONLY supports Python.
+ */
+const AgentCoreRuntimeComputeConfigSchema = zod_1.z
+    .object({
+    host: zod_1.z.literal('AgentCoreRuntime'),
+    implementation: exports.ToolImplementationBindingSchema,
+    runtime: exports.RuntimeConfigSchema.optional(),
+    iamPolicy: exports.IamPolicyDocumentSchema.optional(),
+})
+    .strict()
+    .refine(data => data.implementation.language === 'Python', {
+    message: 'AgentCore Runtime only supports Python',
+});
+/**
+ * Tool compute configuration (discriminated union).
+ */
+exports.ToolComputeConfigSchema = zod_1.z.discriminatedUnion('host', [
+    LambdaComputeConfigSchema,
+    AgentCoreRuntimeComputeConfigSchema,
+]);
+// ============================================================================
+// Gateway Target
+// ============================================================================
+/**
+ * A gateway target binds one or more ToolDefinitions to compute that services them.
+ *
+ * A single Lambda or AgentCoreRuntime can expose multiple tools. The gateway routes
+ * tool invocations to the appropriate target based on tool name.
+ *
+ * If compute is omitted, the tools are treated as external or abstract targets.
+ */
+exports.AgentCoreGatewayTargetSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1),
+    targetType: exports.GatewayTargetTypeSchema,
+    toolDefinitions: zod_1.z.array(mcp_defs_1.ToolDefinitionSchema).min(1),
+    compute: exports.ToolComputeConfigSchema.optional(),
+})
+    .strict();
+// ============================================================================
+// Gateway
+// ============================================================================
+/**
+ * Gateway abstraction with opinionated defaults.
+ * Supports NONE (default) or CUSTOM_JWT authorizer types.
+ */
+exports.AgentCoreGatewaySchema = zod_1.z
+    .object({
+    name: agent_env_1.GatewayNameSchema,
+    description: zod_1.z.string().optional(),
+    targets: zod_1.z.array(exports.AgentCoreGatewayTargetSchema),
+    /** Authorization type for the gateway. Defaults to 'NONE'. */
+    authorizerType: exports.GatewayAuthorizerTypeSchema.default('NONE'),
+    /** Authorizer configuration. Required when authorizerType is 'CUSTOM_JWT'. */
+    authorizerConfiguration: exports.GatewayAuthorizerConfigSchema.optional(),
+})
+    .strict()
+    .refine(data => {
+    // If authorizerType is CUSTOM_JWT, customJwtAuthorizer config must be provided
+    if (data.authorizerType === 'CUSTOM_JWT') {
+        return data.authorizerConfiguration?.customJwtAuthorizer !== undefined;
+    }
+    return true;
+}, {
+    message: 'customJwtAuthorizer configuration is required when authorizerType is CUSTOM_JWT',
+    path: ['authorizerConfiguration'],
+});
+// ============================================================================
+// MCP Runtime Tool
+// ============================================================================
+/**
+ * Binding from an MCP runtime tool to an agent.
+ * When present, the agent is granted InvokeAgentRuntime permission
+ * and receives the runtime ARN in the specified environment variable.
+ */
+exports.McpRuntimeBindingSchema = zod_1.z
+    .object({
+    agentName: zod_1.z.string().min(1),
+    envVarName: agent_env_1.EnvVarNameSchema,
+})
+    .strict();
+/**
+ * AgentCore MCP Runtime tool servers.
+ *
+ * These are not behind a Gateway. They are deployed as AgentCoreRuntime compute
+ * and are directly addressable by agents via the generated DNS endpoint.
+ *
+ * Use the `bindings` array to grant agents permission to invoke this tool.
+ * Each binding grants InvokeAgentRuntime permission and sets an environment variable
+ * with the runtime ARN on the bound agent.
+ */
+exports.AgentCoreMcpRuntimeToolSchema = zod_1.z
+    .object({
+    name: zod_1.z.string().min(1),
+    toolDefinition: mcp_defs_1.ToolDefinitionSchema,
+    compute: AgentCoreRuntimeComputeConfigSchema,
+    bindings: zod_1.z.array(exports.McpRuntimeBindingSchema).optional(),
+})
+    .strict();
+// ============================================================================
+// Top-Level MCP Spec
+// ============================================================================
+/**
+ * Top-level MCP schema.
+ */
+exports.AgentCoreMcpSpecSchema = zod_1.z
+    .object({
+    agentCoreGateways: zod_1.z.array(exports.AgentCoreGatewaySchema),
+    mcpRuntimeTools: zod_1.z.array(exports.AgentCoreMcpRuntimeToolSchema).optional(),
+})
+    .strict();
+//# sourceMappingURL=mcp.js.map

package/dist/schema/schemas/mcp.js.map

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

package/dist/schema/schemas/primitives/index.d.ts

@@ -0,0 +1,3 @@
+export type { MemoryStrategy, MemoryStrategyType } from './memory';
+export { DEFAULT_STRATEGY_NAMESPACES, MemoryStrategyNameSchema, MemoryStrategySchema, MemoryStrategyTypeSchema, } from './memory';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/schemas/primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,UAAU,CAAC"}

package/dist/schema/schemas/primitives/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStrategyTypeSchema = exports.MemoryStrategySchema = exports.MemoryStrategyNameSchema = exports.DEFAULT_STRATEGY_NAMESPACES = void 0;
+var memory_1 = require("./memory");
+Object.defineProperty(exports, "DEFAULT_STRATEGY_NAMESPACES", { enumerable: true, get: function () { return memory_1.DEFAULT_STRATEGY_NAMESPACES; } });
+Object.defineProperty(exports, "MemoryStrategyNameSchema", { enumerable: true, get: function () { return memory_1.MemoryStrategyNameSchema; } });
+Object.defineProperty(exports, "MemoryStrategySchema", { enumerable: true, get: function () { return memory_1.MemoryStrategySchema; } });
+Object.defineProperty(exports, "MemoryStrategyTypeSchema", { enumerable: true, get: function () { return memory_1.MemoryStrategyTypeSchema; } });
+//# sourceMappingURL=index.js.map

package/dist/schema/schemas/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/index.ts"],"names":[],"mappings":";;;AACA,mCAKkB;AAJhB,qHAAA,2BAA2B,OAAA;AAC3B,kHAAA,wBAAwB,OAAA;AACxB,8GAAA,oBAAoB,OAAA;AACpB,kHAAA,wBAAwB,OAAA"}

package/dist/schema/schemas/primitives/memory.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * Memory strategy types.
+ * Maps to AWS MemoryStrategy types:
+ * - SEMANTIC → SemanticMemoryStrategy
+ * - SUMMARIZATION → SummaryMemoryStrategy (note: CloudFormation uses "Summary")
+ * - USER_PREFERENCE → UserPreferenceMemoryStrategy
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-bedrockagentcore-memory-memorystrategy.html
+ */
+export declare const MemoryStrategyTypeSchema: z.ZodEnum<{
+    SEMANTIC: "SEMANTIC";
+    SUMMARIZATION: "SUMMARIZATION";
+    USER_PREFERENCE: "USER_PREFERENCE";
+}>;
+export type MemoryStrategyType = z.infer<typeof MemoryStrategyTypeSchema>;
+/**
+ * Default namespaces for each memory strategy type.
+ * These match the patterns generated in CLI session.py templates.
+ */
+export declare const DEFAULT_STRATEGY_NAMESPACES: Partial<Record<MemoryStrategyType, string[]>>;
+/**
+ * Memory strategy name validation.
+ * Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-bedrockagentcore-memory.html#cfn-bedrockagentcore-memory-name
+ */
+export declare const MemoryStrategyNameSchema: z.ZodString;
+/**
+ * Memory strategy configuration.
+ * Each memory can have multiple strategies with optional namespace scoping.
+ */
+export declare const MemoryStrategySchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        SEMANTIC: "SEMANTIC";
+        SUMMARIZATION: "SUMMARIZATION";
+        USER_PREFERENCE: "USER_PREFERENCE";
+    }>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    namespaces: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type MemoryStrategy = z.infer<typeof MemoryStrategySchema>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/schema/schemas/primitives/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;EAA2D,CAAC;AACjG,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC,CAIrF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,aAOlC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/schema/schemas/primitives/memory.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStrategySchema = exports.MemoryStrategyNameSchema = exports.DEFAULT_STRATEGY_NAMESPACES = exports.MemoryStrategyTypeSchema = void 0;
+const zod_1 = require("zod");
+// ============================================================================
+// Memory Strategy Types
+// ============================================================================
+/**
+ * Memory strategy types.
+ * Maps to AWS MemoryStrategy types:
+ * - SEMANTIC → SemanticMemoryStrategy
+ * - SUMMARIZATION → SummaryMemoryStrategy (note: CloudFormation uses "Summary")
+ * - USER_PREFERENCE → UserPreferenceMemoryStrategy
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-bedrockagentcore-memory-memorystrategy.html
+ */
+exports.MemoryStrategyTypeSchema = zod_1.z.enum(['SEMANTIC', 'SUMMARIZATION', 'USER_PREFERENCE']);
+/**
+ * Default namespaces for each memory strategy type.
+ * These match the patterns generated in CLI session.py templates.
+ */
+exports.DEFAULT_STRATEGY_NAMESPACES = {
+    SEMANTIC: ['/users/{actorId}/facts'],
+    USER_PREFERENCE: ['/users/{actorId}/preferences'],
+    SUMMARIZATION: ['/summaries/{actorId}/{sessionId}'],
+};
+/**
+ * Memory strategy name validation.
+ * Pattern: ^[a-zA-Z][a-zA-Z0-9_]{0,47}$
+ * @see https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-bedrockagentcore-memory.html#cfn-bedrockagentcore-memory-name
+ */
+exports.MemoryStrategyNameSchema = zod_1.z
+    .string()
+    .min(1)
+    .max(48)
+    .regex(/^[a-zA-Z][a-zA-Z0-9_]{0,47}$/, 'Must begin with a letter and contain only alphanumeric characters and underscores (max 48 chars)');
+/**
+ * Memory strategy configuration.
+ * Each memory can have multiple strategies with optional namespace scoping.
+ */
+exports.MemoryStrategySchema = zod_1.z.object({
+    /** Strategy type */
+    type: exports.MemoryStrategyTypeSchema,
+    /** Optional custom name for the strategy */
+    name: exports.MemoryStrategyNameSchema.optional(),
+    /** Optional description */
+    description: zod_1.z.string().optional(),
+    /** Optional namespaces for scoping memory access */
+    namespaces: zod_1.z.array(zod_1.z.string()).optional(),
+});
+//# sourceMappingURL=memory.js.map

package/dist/schema/schemas/primitives/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../../src/schema/schemas/primitives/memory.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;;;;GAOG;AACU,QAAA,wBAAwB,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAGjG;;;GAGG;AACU,QAAA,2BAA2B,GAAkD;IACxF,QAAQ,EAAE,CAAC,wBAAwB,CAAC;IACpC,eAAe,EAAE,CAAC,8BAA8B,CAAC;IACjD,aAAa,EAAE,CAAC,kCAAkC,CAAC;CACpD,CAAC;AAEF;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,OAAC;KACtC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,EAAE,CAAC;KACP,KAAK,CACJ,8BAA8B,EAC9B,kGAAkG,CACnG,CAAC;AAEJ;;;GAGG;AACU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,oBAAoB;IACpB,IAAI,EAAE,gCAAwB;IAC9B,4CAA4C;IAC5C,IAAI,EAAE,gCAAwB,CAAC,QAAQ,EAAE;IACzC,2BAA2B;IAC3B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,oDAAoD;IACpD,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3C,CAAC,CAAC"}

package/dist/schema/schemas/zod-util.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+/**
+ * Creates a superRefine function that validates array elements are unique by a given key.
+ *
+ * @param keyFn - Function to extract the key from each element
+ * @param errorMessage - Function to generate error message for duplicates
+ * @returns A superRefine callback for use with z.array().superRefine()
+ */
+export declare function uniqueBy<T>(keyFn: (item: T) => string, errorMessage: (key: string) => string): (items: T[], ctx: z.RefinementCtx) => void;
+//# sourceMappingURL=zod-util.d.ts.map

package/dist/schema/schemas/zod-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-util.d.ts","sourceRoot":"","sources":["../../../src/schema/schemas/zod-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC1B,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GACpC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,aAAa,KAAK,IAAI,CAW5C"}

package/dist/schema/schemas/zod-util.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uniqueBy = uniqueBy;
+/**
+ * Creates a superRefine function that validates array elements are unique by a given key.
+ *
+ * @param keyFn - Function to extract the key from each element
+ * @param errorMessage - Function to generate error message for duplicates
+ * @returns A superRefine callback for use with z.array().superRefine()
+ */
+function uniqueBy(keyFn, errorMessage) {
+    return (items, ctx) => {
+        const seen = new Set();
+        for (const [idx, item] of items.entries()) {
+            const key = keyFn(item);
+            if (seen.has(key)) {
+                ctx.addIssue({ code: 'custom', message: errorMessage(key), path: [idx] });
+            }
+            seen.add(key);
+        }
+    };
+}
+//# sourceMappingURL=zod-util.js.map

package/dist/schema/schemas/zod-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-util.js","sourceRoot":"","sources":["../../../src/schema/schemas/zod-util.ts"],"names":[],"mappings":";;AASA,4BAcC;AArBD;;;;;;GAMG;AACH,SAAgB,QAAQ,CACtB,KAA0B,EAC1B,YAAqC;IAErC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5E,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/schema/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './path';
+//# sourceMappingURL=index.d.ts.map

package/dist/schema/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/schema/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/schema/types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./path"), exports);
+//# sourceMappingURL=index.js.map

package/dist/schema/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schema/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB"}

package/dist/schema/types/path.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Path type definitions for schema fields.
+ *
+ * These types indicate whether a string field represents a file path or directory path,
+ * enabling the UI to render appropriate path completion (files vs directories only).
+ */
+import { z } from 'zod';
+export declare const PathTypeSchema: z.ZodEnum<{
+    file: "file";
+    directory: "directory";
+}>;
+export type PathType = z.infer<typeof PathTypeSchema>;
+/**
+ * Branded type for file path strings.
+ * Used to indicate a schema field expects a path to a file.
+ */
+export type FilePath = string & {
+    readonly __brand: 'FilePath';
+};
+/**
+ * Branded type for directory path strings.
+ * Used to indicate a schema field expects a path to a directory.
+ */
+export type DirectoryPath = string & {
+    readonly __brand: 'DirectoryPath';
+};
+//# sourceMappingURL=path.d.ts.map

package/dist/schema/types/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/schema/types/path.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,cAAc;;;EAAgC,CAAC;AAC5D,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC"}

package/dist/schema/types/path.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PathTypeSchema = void 0;
+/**
+ * Path type definitions for schema fields.
+ *
+ * These types indicate whether a string field represents a file path or directory path,
+ * enabling the UI to render appropriate path completion (files vs directories only).
+ */
+const zod_1 = require("zod");
+// Path type markers for schema fields
+exports.PathTypeSchema = zod_1.z.enum(['file', 'directory']);
+//# sourceMappingURL=path.js.map

package/dist/schema/types/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/schema/types/path.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,6BAAwB;AAExB,sCAAsC;AACzB,QAAA,cAAc,GAAG,OAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC"}