@commercetools/tools-core 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -1,5 +1,835 @@
-export { BaseResourceHandler } from './handlers/base.handler';
-export { ToolHandler, getDecoratorRegisteredHandlers, } from './decorators/tool.decorator';
-export { CustomerHandler } from './resources/customer/customer.handler';
-export { ProjectHandler } from './resources/project/project.handler';
-export * from './shared';
+import * as _commercetools_platform_sdk from '@commercetools/platform-sdk';
+import { ApiRoot, ByProjectKeyRequestBuilder, AttributeGroup, AttributeGroupPagedQueryResponse, Category, CategoryPagedQueryResponse, Channel, ChannelPagedQueryResponse, CustomObject, CustomObjectPagedQueryResponse, Customer, CustomerPagedQueryResponse, CustomerSignInResult, DiscountCode, DiscountCodePagedQueryResponse, Extension, ExtensionPagedQueryResponse, InventoryEntry, InventoryPagedQueryResponse, Message, MessagePagedQueryResponse, ProductDiscount, ProductDiscountPagedQueryResponse, ProductProjection, ProductProjectionPagedSearchResponse, ProductPagedSearchResponse, ProductSelection, ProductSelectionPagedQueryResponse, ProductTailoring, ProductTailoringPagedQueryResponse, ProductType, ProductTypePagedQueryResponse, Product, ProductPagedQueryResponse, Project, Review, ReviewPagedQueryResponse, StandalonePrice, StandalonePricePagedQueryResponse, State, StatePagedQueryResponse, Store, StorePagedQueryResponse, Subscription, SubscriptionPagedQueryResponse, TaxCategory, TaxCategoryPagedQueryResponse, Type, TypePagedQueryResponse, Zone, ZonePagedQueryResponse } from '@commercetools/platform-sdk';
+import { Client } from '@commercetools/ts-client';
+
+/**
+ * Pure TypeScript type representing parameter schemas
+ * This type is used to provide type information without requiring Zod as a dependency
+ * for consuming applications.
+ *
+ * Each operation's schema is represented as a Record<string, unknown>,
+ * which is a pure TypeScript type that doesn't require Zod.
+ *
+ * The actual validation is performed using Zod schemas internally,
+ * but the type definition doesn't expose Zod types.
+ *
+ * @example
+ * ```typescript
+ * // In a consuming application (no Zod dependency needed):
+ * interface MyResourceSchema extends ResourceSchema {
+ *   read: { id?: string; limit?: number };
+ *   create: { name: string; email: string };
+ *   update: { id: string; name?: string };
+ *   delete: { id: string };
+ * }
+ * ```
+ */
+interface ResourceSchema {
+    read: Record<string, unknown>;
+    create: Record<string, unknown>;
+    update: Record<string, unknown>;
+    delete: Record<string, unknown>;
+}
+/**
+ * Internal type for schemas that support validation via a parse method
+ * This allows ResourceMetadata to work with Zod schemas internally
+ * without exposing Zod types to consuming applications.
+ *
+ * The parse method signature matches Zod's parse method, but the type
+ * itself doesn't require Zod as a dependency.
+ */
+interface ValidatableSchema {
+    parse: (data: unknown) => unknown;
+}
+/**
+ * Internal type for resource schemas that support validation
+ * Used internally by ResourceMetadata for validation purposes.
+ * Consuming applications only see ResourceSchema (pure TypeScript types).
+ */
+interface ValidatableResourceSchema {
+    read: ValidatableSchema;
+    create: ValidatableSchema;
+    update: ValidatableSchema;
+    delete: ValidatableSchema;
+}
+interface ResourceMetadata {
+    namespace: string;
+    description: string;
+    toolNamePrefix?: string;
+    /**
+     * Resource schemas for validation and type information.
+     *
+     * Internally, these are Zod schemas that support validation via `.parse()`.
+     * However, the type definition uses ValidatableResourceSchema which doesn't
+     * expose Zod types, allowing consuming applications to use this package
+     * without requiring Zod as a dependency.
+     *
+     * For type information, use ResourceSchema instead.
+     */
+    schemas: ValidatableResourceSchema;
+}
+interface ToolExecutionContext<TConfig = unknown> {
+    authToken: string;
+    configuration: TConfig;
+    toolName: string;
+    parameters: Record<string, unknown>;
+    sessionId?: string;
+}
+interface ToolHandler$1<TConfig> {
+    execute(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+}
+/**
+ * Factory interface for creating API clients
+ * Allows dependency injection and testing
+ */
+interface IApiClientFactory<TConfig = unknown> {
+    createApiClient(configuration: TConfig, authToken: string): ApiRoot;
+}
+/**
+ * Minimal interface required for commercetools handlers
+ * Any configuration type used with commercetools handlers must have at least projectKey
+ */
+interface CommercetoolsConfig {
+    projectKey: string;
+}
+/**
+ * Default Configuration interface for backward compatibility
+ * This can be extended or replaced in consuming packages
+ */
+interface Configuration extends CommercetoolsConfig {
+    allowedTools: string[];
+    metadata?: {
+        toolDescriptions?: Record<string, string>;
+        responseTransformations?: Record<string, unknown>;
+        rateLimits?: {
+            requestsPerMinute?: number;
+        };
+        customFields?: Record<string, unknown>;
+        apiUrl?: string;
+        authUrl?: string;
+        clientId?: string;
+        clientSecret?: string;
+    };
+}
+/**
+ * Constructor type
+ * Note: BaseResourceHandler is defined in @core package to avoid circular dependencies
+ */
+interface IConstructor<T = unknown> {
+    new (...args: IApiClientFactory<Configuration>[]): T;
+}
+interface IErrorConstructor extends ErrorConstructor {
+    captureStackTrace: (...args: unknown[]) => void;
+}
+
+type ToolOperation = 'read' | 'create' | 'update' | 'delete';
+type ApiRootFn = (client: Client, baseUri?: string) => ApiRoot;
+
+/**
+ * Structured error for tool execution failures
+ * Provides context and debugging information
+ * Generic over configuration type to support custom configs
+ */
+declare class ToolExecutionError<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends Error {
+    readonly toolName: string;
+    readonly operation: string;
+    readonly projectKey: string;
+    readonly sessionId?: string;
+    readonly parameters: Record<string, unknown>;
+    readonly originalError: unknown;
+    readonly timestamp: Date;
+    constructor(message: string, context: ToolExecutionContext<TConfig>, originalError?: unknown);
+    /**
+     * Extract operation from tool name
+     */
+    private extractOperation;
+    /**
+     * Get error details for logging/debugging
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        toolName: string;
+        operation: string;
+        projectKey: string;
+        sessionId: string;
+        parameters: Record<string, unknown>;
+        timestamp: string;
+        originalError: unknown;
+        stack: string;
+    };
+}
+
+/**
+ * Commercetools API Client
+ * Creates and manages commercetools SDK client instances
+ *
+ * Note: This class uses the full Configuration type internally for backward compatibility,
+ * but can accept any config that extends CommercetoolsConfig
+ */
+declare class CommercetoolsAPIClient {
+    private client;
+    private apiRoot;
+    private configuration;
+    private authToken?;
+    constructor(configuration: Configuration | CommercetoolsConfig, authToken?: string);
+    /**
+     * Get the API root instance
+     */
+    getApiRoot(fn?: ApiRootFn, baseUri?: string): ApiRoot;
+    /**
+     * Get the client instance
+     */
+    getClient(): Client;
+    /**
+     * Construct an apiRoot
+     */
+    contructApiRoot(client: Client, fn: (client: Client, baseUri?: string) => ApiRoot, baseUri?: string): ApiRoot;
+    /**
+     * Create commercetools client
+     */
+    private createClient;
+}
+
+/**
+ * Default implementation of API client factory
+ * Generic over configuration type to support custom configs
+ */
+declare class ApiClientFactory<TConfig extends CommercetoolsConfig = Configuration> implements IApiClientFactory<TConfig> {
+    createApiClient(configuration: TConfig, authToken: string): _commercetools_platform_sdk.ApiRoot;
+    getApiRoot(configuration: TConfig, authToken: string): CommercetoolsAPIClient;
+}
+
+/**
+ * Generic base handler - NO API client logic
+ * Only handles tool routing, validation, and naming
+ */
+declare abstract class BaseResourceHandler<TConfig = unknown> implements ToolHandler$1<TConfig> {
+    protected abstract readonly metadata: ResourceMetadata;
+    abstract read(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+    abstract create(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+    abstract update(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+    abstract delete(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+    protected getToolName(operation: ToolOperation): string;
+    protected getOperation(toolName: string): ToolOperation | null;
+    execute(context: ToolExecutionContext<TConfig>): Promise<unknown>;
+    getAllToolNames(): string[];
+    getToolDefinition(operation: ToolOperation): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    getAllToolDefinitions(): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    }[];
+}
+
+/**
+ * Decorator to automatically register a tool handler
+ *
+ * Usage:
+ * ```typescript
+ * @ToolHandler()
+ * export class CustomerHandler extends BaseResourceHandler {
+ *   // ...
+ * }
+ * ```
+ *
+ * The handler will be automatically discovered and registered
+ * when the module is loaded.
+ */
+declare function ToolHandler(): <T extends IConstructor<BaseResourceHandler<Configuration>>>(constructor: T) => T;
+/**
+ * Get all handlers registered via decorator
+ * This is called by ToolDiscovery to register all decorated handlers
+ */
+declare function getDecoratorRegisteredHandlers(): BaseResourceHandler<Configuration>[];
+
+/**
+ * Commercetools-specific resource handler
+ * Extends BaseResourceHandler with commercetools API client functionality
+ * This is an abstract class - subclasses must implement the CRUD methods
+ *
+ * @template TConfig - Configuration type that must extend CommercetoolsConfig (requires projectKey)
+ *
+ * Example usage:
+ * ```typescript
+ * // Using default Configuration
+ * export class CustomersHandler extends CommercetoolsResourceHandler { ... }
+ *
+ * // Using custom config type
+ * interface MyCustomConfig extends CommercetoolsConfig {
+ *   projectKey: string;
+ *   customField: string;
+ * }
+ * export class CustomersHandler extends CommercetoolsResourceHandler<MyCustomConfig> { ... }
+ * ```
+ */
+declare abstract class CommercetoolsResourceHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends BaseResourceHandler<TConfig> {
+    protected apiClientFactory: IApiClientFactory<TConfig>;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    /**
+     * Get the API root instance for commercetools
+     */
+    protected getApiRoot(context: ToolExecutionContext<TConfig>): ApiRoot;
+}
+
+declare class AttributeGroupsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getAttributeGroupsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyAttributeGroupsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<AttributeGroup | AttributeGroupPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<AttributeGroup>;
+    update(context: ToolExecutionContext<TConfig>): Promise<AttributeGroup>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<AttributeGroup>;
+}
+declare function readAttributeGroups<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<AttributeGroup | AttributeGroupPagedQueryResponse>;
+declare function createAttributeGroups<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<AttributeGroup>;
+declare function updateAttributeGroups<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<AttributeGroup>;
+declare function deleteAttributeGroups<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<AttributeGroup>;
+
+/**
+ * Categories Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class CategoriesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getCategoriesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyCategoriesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Category | CategoryPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Category>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Category>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Category>;
+}
+declare function readCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Category | CategoryPagedQueryResponse>;
+declare function createCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Category>;
+declare function updateCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Category>;
+declare function deleteCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Category>;
+
+declare class ChannelsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: any;
+        inputSchema: ValidatableSchema;
+    };
+    protected getChannelsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyChannelsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Channel | ChannelPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Channel>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Channel>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Channel>;
+}
+declare function readChannels<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Channel | ChannelPagedQueryResponse>;
+declare function createChannels<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Channel>;
+declare function updateChannels<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Channel>;
+declare function deleteChannels<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Channel>;
+
+declare class CustomObjectsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getCustomObjectsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyCustomObjectsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<CustomObject | CustomObjectPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<CustomObject>;
+    update(context: ToolExecutionContext<TConfig>): Promise<CustomObject>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<CustomObject>;
+}
+declare function readCustomObjects<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<CustomObject | CustomObjectPagedQueryResponse>;
+declare function createCustomObjects<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<CustomObject>;
+declare function updateCustomObjects<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<CustomObject>;
+declare function deleteCustomObjects<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<CustomObject>;
+
+/**
+ * Customers Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ *
+ * Usage with default config:
+ * ```typescript
+ * const handler = new CustomersHandler();
+ * ```
+ *
+ * Usage with custom config:
+ * ```typescript
+ * interface MyConfig extends CommercetoolsConfig {
+ *   projectKey: string;
+ *   customField: string;
+ * }
+ * const handler = new CustomersHandler<MyConfig>();
+ * ```
+ */
+declare class CustomersHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getCustomersApi(api: ByProjectKeyRequestBuilder, storeKey?: string): _commercetools_platform_sdk.ByProjectKeyInStoreKeyByStoreKeyCustomersRequestBuilder | _commercetools_platform_sdk.ByProjectKeyCustomersRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Customer | CustomerPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<CustomerSignInResult>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Customer>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Customer>;
+}
+declare function readCustomers<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Customer | CustomerPagedQueryResponse>;
+declare function createCustomers<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<CustomerSignInResult>;
+declare function updateCustomers<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Customer>;
+declare function deleteCustomers<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Customer>;
+
+/**
+ * Discount Codes Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class DiscountCodesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getDiscountCodesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyDiscountCodesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<DiscountCode | DiscountCodePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<DiscountCode>;
+    update(context: ToolExecutionContext<TConfig>): Promise<DiscountCode>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<DiscountCode>;
+}
+declare function readDiscountCodes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<DiscountCode | DiscountCodePagedQueryResponse>;
+declare function createDiscountCodes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<DiscountCode>;
+declare function updateDiscountCodes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<DiscountCode>;
+declare function deleteDiscountCodes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<DiscountCode>;
+
+/**
+ * Extensions Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ExtensionsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getExtensionsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyExtensionsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Extension | ExtensionPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Extension>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Extension>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Extension>;
+}
+declare function readExtensions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Extension | ExtensionPagedQueryResponse>;
+declare function createExtensions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Extension>;
+declare function updateExtensions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Extension>;
+declare function deleteExtensions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Extension>;
+
+/**
+ * Inventory Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class InventoryHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getInventoryApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyInventoryRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<InventoryEntry | InventoryPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<InventoryEntry>;
+    update(context: ToolExecutionContext<TConfig>): Promise<InventoryEntry>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<InventoryEntry>;
+}
+declare function readInventory<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<InventoryEntry | InventoryPagedQueryResponse>;
+declare function createInventory<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<InventoryEntry>;
+declare function updateInventory<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<InventoryEntry>;
+declare function deleteInventory<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<InventoryEntry>;
+
+declare class MessagesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getMessagesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyMessagesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Message | MessagePagedQueryResponse>;
+    create(_context: ToolExecutionContext<TConfig>): Promise<never>;
+    update(_context: ToolExecutionContext<TConfig>): Promise<never>;
+    delete(_context: ToolExecutionContext<TConfig>): Promise<never>;
+}
+declare function readMessages<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Message | MessagePagedQueryResponse>;
+declare function createMessages<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function updateMessages<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function deleteMessages<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+
+/**
+ * Product Discounts Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductDiscountsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductDiscountsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductDiscountsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductDiscount | ProductDiscountPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<ProductDiscount>;
+    update(context: ToolExecutionContext<TConfig>): Promise<ProductDiscount>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<ProductDiscount>;
+}
+declare function readProductDiscounts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductDiscount | ProductDiscountPagedQueryResponse>;
+declare function createProductDiscounts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductDiscount>;
+declare function updateProductDiscounts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductDiscount>;
+declare function deleteProductDiscounts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductDiscount>;
+
+declare class ProductProjectionsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductProjectionsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductProjectionsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductProjection | ProductProjectionPagedSearchResponse>;
+    create(_context: ToolExecutionContext<TConfig>): Promise<never>;
+    update(_context: ToolExecutionContext<TConfig>): Promise<never>;
+    delete(_context: ToolExecutionContext<TConfig>): Promise<never>;
+}
+declare function readProductProjections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductProjection | ProductProjectionPagedSearchResponse>;
+declare function createProductProjections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function updateProductProjections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function deleteProductProjections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(_context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+
+/**
+ * Product Search Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductSearchHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductSearchApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductsSearchRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductPagedSearchResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<never>;
+    update(context: ToolExecutionContext<TConfig>): Promise<never>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<never>;
+}
+declare function readProductSearch<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductPagedSearchResponse>;
+declare function createProductSearch<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function updateProductSearch<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+declare function deleteProductSearch<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<never>;
+
+/**
+ * Product Selections Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductSelectionsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductSelectionsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductSelectionsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductSelection | ProductSelectionPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<ProductSelection>;
+    update(context: ToolExecutionContext<TConfig>): Promise<ProductSelection>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<ProductSelection>;
+}
+declare function readProductSelections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductSelection | ProductSelectionPagedQueryResponse>;
+declare function createProductSelections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductSelection>;
+declare function updateProductSelections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductSelection>;
+declare function deleteProductSelections<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductSelection>;
+
+/**
+ * Product Tailoring Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductTailoringHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductTailoringApi(api: ByProjectKeyRequestBuilder, storeKey?: string): _commercetools_platform_sdk.ByProjectKeyInStoreKeyByStoreKeyProductTailoringRequestBuilder | _commercetools_platform_sdk.ByProjectKeyProductTailoringRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductTailoring | ProductTailoringPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<ProductTailoring>;
+    update(context: ToolExecutionContext<TConfig>): Promise<ProductTailoring>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<ProductTailoring>;
+}
+declare function readProductTailoring<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductTailoring | ProductTailoringPagedQueryResponse>;
+declare function createProductTailoring<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductTailoring>;
+declare function updateProductTailoring<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductTailoring>;
+declare function deleteProductTailoring<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductTailoring>;
+
+/**
+ * Product Types Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductTypesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductTypesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductTypesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<ProductType | ProductTypePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<ProductType>;
+    update(context: ToolExecutionContext<TConfig>): Promise<ProductType>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<ProductType>;
+}
+declare function readProductTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductType | ProductTypePagedQueryResponse>;
+declare function createProductTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductType>;
+declare function updateProductTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductType>;
+declare function deleteProductTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<ProductType>;
+
+/**
+ * Products Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ProductsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getProductsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyProductsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Product | ProductPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Product>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Product>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Product>;
+}
+declare function readProducts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Product | ProductPagedQueryResponse>;
+declare function createProducts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Product>;
+declare function updateProducts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Product>;
+declare function deleteProducts<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Product>;
+
+/**
+ * Project Resource Handler
+ * Handles project read and update operations
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ *
+ * Automatically discovered via @ToolHandler() decorator
+ */
+declare class ProjectHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'update'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    read(context: ToolExecutionContext<TConfig>): Promise<Project>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Project>;
+    create(_context: ToolExecutionContext<TConfig>): Promise<never>;
+    delete(_context: ToolExecutionContext<TConfig>): Promise<never>;
+}
+declare function readProject<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Project>;
+declare function updateProject<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Project>;
+
+/**
+ * Reviews Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ReviewsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getReviewsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyReviewsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Review | ReviewPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Review>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Review>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Review>;
+}
+declare function readReviews<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Review | ReviewPagedQueryResponse>;
+declare function createReviews<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Review>;
+declare function updateReviews<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Review>;
+declare function deleteReviews<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Review>;
+
+declare class StandalonePricesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getStandalonePricesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyStandalonePricesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<StandalonePrice | StandalonePricePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<StandalonePrice>;
+    update(context: ToolExecutionContext<TConfig>): Promise<StandalonePrice>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<StandalonePrice>;
+}
+declare function readStandalonePrices<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<StandalonePrice | StandalonePricePagedQueryResponse>;
+declare function createStandalonePrices<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<StandalonePrice>;
+declare function updateStandalonePrices<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<StandalonePrice>;
+declare function deleteStandalonePrices<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<StandalonePrice>;
+
+declare class StatesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getStatesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyStatesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<State | StatePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<State>;
+    update(context: ToolExecutionContext<TConfig>): Promise<State>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<State>;
+}
+declare function readStates<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<State | StatePagedQueryResponse>;
+declare function createStates<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<State>;
+declare function updateStates<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<State>;
+declare function deleteStates<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<State>;
+
+declare class StoresHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getStoresApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyStoresRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Store | StorePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Store>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Store>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Store>;
+}
+declare function readStores<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Store | StorePagedQueryResponse>;
+declare function createStores<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Store>;
+declare function updateStores<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Store>;
+declare function deleteStores<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Store>;
+
+declare class SubscriptionsHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getSubscriptionsApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeySubscriptionsRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Subscription | SubscriptionPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Subscription>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Subscription>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Subscription>;
+}
+declare function readSubscriptions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Subscription | SubscriptionPagedQueryResponse>;
+declare function createSubscriptions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Subscription>;
+declare function updateSubscriptions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Subscription>;
+declare function deleteSubscriptions<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Subscription>;
+
+/**
+ * Tax Categories Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class TaxCategoriesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getTaxCategoriesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyTaxCategoriesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<TaxCategory | TaxCategoryPagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<TaxCategory>;
+    update(context: ToolExecutionContext<TConfig>): Promise<TaxCategory>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<TaxCategory>;
+}
+declare function readTaxCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<TaxCategory | TaxCategoryPagedQueryResponse>;
+declare function createTaxCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<TaxCategory>;
+declare function updateTaxCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<TaxCategory>;
+declare function deleteTaxCategories<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<TaxCategory>;
+
+/**
+ * Types Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class TypesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getTypesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyTypesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Type | TypePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Type>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Type>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Type>;
+}
+declare function readTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Type | TypePagedQueryResponse>;
+declare function createTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Type>;
+declare function updateTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Type>;
+declare function deleteTypes<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Type>;
+
+/**
+ * Zones Resource Handler
+ * Generic over configuration type - defaults to CommercetoolsConfig
+ */
+declare class ZonesHandler<TConfig extends CommercetoolsConfig = CommercetoolsConfig> extends CommercetoolsResourceHandler<TConfig> {
+    protected readonly metadata: ResourceMetadata;
+    constructor(apiClientFactory?: IApiClientFactory<TConfig>);
+    getToolDefinition(operation: 'read' | 'create' | 'update' | 'delete'): {
+        name: string;
+        description: string;
+        inputSchema: ValidatableSchema;
+    };
+    protected getZonesApi(api: ByProjectKeyRequestBuilder): _commercetools_platform_sdk.ByProjectKeyZonesRequestBuilder;
+    read(context: ToolExecutionContext<TConfig>): Promise<Zone | ZonePagedQueryResponse>;
+    create(context: ToolExecutionContext<TConfig>): Promise<Zone>;
+    update(context: ToolExecutionContext<TConfig>): Promise<Zone>;
+    delete(context: ToolExecutionContext<TConfig>): Promise<Zone>;
+}
+declare function readZones<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Zone | ZonePagedQueryResponse>;
+declare function createZones<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Zone>;
+declare function updateZones<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Zone>;
+declare function deleteZones<TConfig extends CommercetoolsConfig = CommercetoolsConfig>(context: ToolExecutionContext<TConfig>, apiClientFactory?: IApiClientFactory<TConfig>): Promise<Zone>;
+
+declare const TOOL_NAME_PREFIX = "";
+declare const OPERATIONS: string[];
+
+export { ApiClientFactory, type ApiRootFn, AttributeGroupsHandler, BaseResourceHandler, CategoriesHandler, ChannelsHandler, CommercetoolsAPIClient, type CommercetoolsConfig, type Configuration, CustomObjectsHandler, CustomersHandler, DiscountCodesHandler, ExtensionsHandler, type IApiClientFactory, type IConstructor, type IErrorConstructor, InventoryHandler, MessagesHandler, OPERATIONS, ProductDiscountsHandler, ProductProjectionsHandler, ProductSearchHandler, ProductSelectionsHandler, ProductTailoringHandler, ProductTypesHandler, ProductsHandler, ProjectHandler, type ResourceMetadata, type ResourceSchema, ReviewsHandler, StandalonePricesHandler, StatesHandler, StoresHandler, SubscriptionsHandler, TOOL_NAME_PREFIX, TaxCategoriesHandler, type ToolExecutionContext, ToolExecutionError, ToolHandler, type ToolOperation, TypesHandler, type ValidatableResourceSchema, type ValidatableSchema, ZonesHandler, createAttributeGroups, createCategories, createChannels, createCustomObjects, createCustomers, createDiscountCodes, createExtensions, createInventory, createMessages, createProductDiscounts, createProductProjections, createProductSearch, createProductSelections, createProductTailoring, createProductTypes, createProducts, createReviews, createStandalonePrices, createStates, createStores, createSubscriptions, createTaxCategories, createTypes, createZones, deleteAttributeGroups, deleteCategories, deleteChannels, deleteCustomObjects, deleteCustomers, deleteDiscountCodes, deleteExtensions, deleteInventory, deleteMessages, deleteProductDiscounts, deleteProductProjections, deleteProductSearch, deleteProductSelections, deleteProductTailoring, deleteProductTypes, deleteProducts, deleteReviews, deleteStandalonePrices, deleteStates, deleteStores, deleteSubscriptions, deleteTaxCategories, deleteTypes, deleteZones, getDecoratorRegisteredHandlers, readAttributeGroups, readCategories, readChannels, readCustomObjects, readCustomers, readDiscountCodes, readExtensions, readInventory, readMessages, readProductDiscounts, readProductProjections, readProductSearch, readProductSelections, readProductTailoring, readProductTypes, readProducts, readProject, readReviews, readStandalonePrices, readStates, readStores, readSubscriptions, readTaxCategories, readTypes, readZones, updateAttributeGroups, updateCategories, updateChannels, updateCustomObjects, updateCustomers, updateDiscountCodes, updateExtensions, updateInventory, updateMessages, updateProductDiscounts, updateProductProjections, updateProductSearch, updateProductSelections, updateProductTailoring, updateProductTypes, updateProducts, updateProject, updateReviews, updateStandalonePrices, updateStates, updateStores, updateSubscriptions, updateTaxCategories, updateTypes, updateZones };