@unifiedcommerce/core 0.4.3 → 0.4.4

package/dist/index.d.ts

@@ -1,77 +0,0 @@
-export { defineConfig } from "./config/define-config.js";
-export type { CommerceConfig, CommercePlugin, MCPResource, MCPTool, ApiKeyScopeDefinition, } from "./config/types.js";
-export { defineCommercePlugin } from "./kernel/plugin/manifest.js";
-export type { CommercePluginManifest, PluginContext, PluginHookRegistration, PluginLogger, PluginPermission, PluginRouteRegistration, } from "./kernel/plugin/manifest.js";
-export { router } from "./interfaces/rest/router.js";
-export { toolBuilder } from "./interfaces/mcp/tool-builder.js";
-export { webhookRouter, type WebhookRouterResult } from "./interfaces/rest/webhook-router.js";
-export { isPrivateUrl, isPrivateIp } from "./modules/webhooks/ssrf-guard.js";
-export { createServer } from "./runtime/server.js";
-export { createLogger } from "./runtime/logger.js";
-export type { Logger as PinoLogger } from "./runtime/logger.js";
-export { setupGracefulShutdown } from "./runtime/shutdown.js";
-export { createKernel } from "./runtime/kernel.js";
-export type { Kernel } from "./runtime/kernel.js";
-export type { Actor } from "./auth/types.js";
-export { resolveOrgId, ensureDefaultOrg, DEFAULT_ORG_ID } from "./auth/org.js";
-export { OrganizationService } from "./modules/organization/service.js";
-export { createScopedDb } from "./kernel/database/scoped-db.js";
-export { assertOwnership, assertPermission } from "./auth/permissions.js";
-export type { AccessResult, AccessContext, AccessFn, WhereClause } from "./auth/access.js";
-export { accessOR, accessAND, conditional, isAdmin, isAuthenticated, isDocumentOwner, publicAccess, denyAll, } from "./auth/access.js";
-export { HookRegistry } from "./kernel/hooks/registry.js";
-export type { BeforeHook, AfterHook, HookContext, HookOperation, HookOrigin, Logger, ServiceContainer, } from "./kernel/hooks/types.js";
-export { runBeforeHooks, runAfterHooks } from "./kernel/hooks/executor.js";
-export { createHookContext } from "./kernel/hooks/create-context.js";
-export type { CreateHookContextArgs } from "./kernel/hooks/create-context.js";
-export type { JobsAdapter, EnqueueOptions } from "./kernel/jobs/adapter.js";
-export { NullJobsAdapter } from "./kernel/jobs/adapter.js";
-export { DrizzleJobsAdapter } from "./kernel/jobs/drizzle-adapter.js";
-export { runPendingJobs } from "./kernel/jobs/runner.js";
-export type { RunPendingJobsArgs } from "./kernel/jobs/runner.js";
-export type { TaskDefinition, TaskContext, TaskRetryConfig, } from "./kernel/jobs/types.js";
-export { createLocalAPI, LocalAPI } from "./kernel/local-api.js";
-export type { CommerceLocalAPI, LocalAPIOptions } from "./kernel/local-api.js";
-export { createCommerce } from "./runtime/commerce.js";
-export type { CommerceInstance } from "./runtime/commerce.js";
-export { createAuditService, createNullAuditService } from "./modules/audit/service.js";
-export type { AuditService, AuditEntry, RecordArgs, ListForEntityArgs, } from "./modules/audit/service.js";
-export type { Result, PluginResult, PluginResultErr } from "./kernel/result.js";
-export { Ok, Err, PluginErr } from "./kernel/result.js";
-export type { PluginDb, PluginTxFn } from "./kernel/database/plugin-types.js";
-export type { ServiceRegistry } from "./kernel/service-registry.js";
-export { toHttpError, type HttpErrorResponse } from "./kernel/http-error.js";
-export { withTiming } from "./kernel/service-timing.js";
-export { CommerceNotFoundError, CommerceValidationError, CommerceForbiddenError, CommerceConflictError, CommerceInvalidTransitionError, } from "./kernel/errors.js";
-export { mapErrorToStatus } from "./kernel/error-mapper.js";
-export { canTransition, assertTransition, orderStateMachine, extendOrderStateMachine, } from "./kernel/state-machine/machine.js";
-export type { PaymentAdapter, PaymentCapture, PaymentIntent, PaymentRefund, PaymentWebhookEvent, } from "./modules/payments/adapter.js";
-export type { StorageAdapter } from "./modules/media/adapter.js";
-export type { SearchAdapter, SearchDocument, SearchFilters, SearchHit, SearchQueryParams, SearchQueryResult, SearchSuggestParams, } from "./modules/search/adapter.js";
-export type { DatabaseAdapter } from "./kernel/database/adapter.js";
-export { createTxContext, reuseOrCreateTxContext, withTransaction, } from "./kernel/database/tx-context.js";
-export type { TxContext, WithTransactionOptions, } from "./kernel/database/tx-context.js";
-export type { TaxAdapter, TaxAddress, TaxCalculationParams, TaxCalculationResult, TaxLineItem, TaxReportParams, TaxVoidParams, } from "./modules/tax/adapter.js";
-export { getSchema, buildSchema, getTableNames } from "./kernel/database/migrate.js";
-export { consoleEmailAdapter } from "./adapters/console-email.js";
-export { runCompensationChain } from "./kernel/compensation/executor.js";
-export type { CompensationContext, Step, } from "./kernel/compensation/types.js";
-export { createRepository } from "./kernel/factory/repository-factory.js";
-export type { BaseRepository, SoftDeletableRepository, RepositoryFor, Filters, FindOptions, } from "./kernel/factory/repository-factory.js";
-export { mergeExtraColumns } from "./kernel/schema/extra-columns.js";
-export type { ExtraColumnsOption } from "./kernel/schema/extra-columns.js";
-export type { CartItemMatcher } from "./modules/cart/matcher.js";
-export { defaultCartItemMatcher } from "./modules/cart/matcher.js";
-export { canAccessCart } from "./modules/cart/access.js";
-export { QueryRegistry } from "./kernel/query/registry.js";
-export { executeQuery } from "./kernel/query/executor.js";
-export type { RelationDefinition, EntityDefinition, } from "./kernel/query/registry.js";
-export type { QueryInput, QueryResult } from "./kernel/query/executor.js";
-export type { CommerceModuleTypes } from "./types/commerce-types.js";
-export { staleOrderCleanupTask } from "./modules/orders/stale-order-cleanup.js";
-export { COMMERCE_AGENT_SYSTEM_PROMPT, COMMERCE_AGENT_SYSTEM_PROMPT_COMPACT, } from "./interfaces/mcp/agent-prompt.js";
-export { DrizzleAnalyticsAdapter } from "./modules/analytics/drizzle-adapter.js";
-export { BUILTIN_ANALYTICS_MODELS } from "./modules/analytics/models.js";
-export { buildAnalyticsScope } from "./modules/analytics/types.js";
-export type { AnalyticsAdapter, AnalyticsQueryParams, AnalyticsQueryResult, AnalyticsMeta, AnalyticsModelDefinition, AnalyticsScope, AnalyticsModel, AnalyticsScopeRule, AnalyticsMeasure, AnalyticsDimension, AnalyticsJoin, CubeScopeRule, CubeDefinition, MeasureDefinition, DimensionDefinition, JoinDefinition, } from "./modules/analytics/types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,45 +0,0 @@
-export { defineConfig } from "./config/define-config.js";
-export { defineCommercePlugin } from "./kernel/plugin/manifest.js";
-export { router } from "./interfaces/rest/router.js";
-export { toolBuilder } from "./interfaces/mcp/tool-builder.js";
-export { webhookRouter } from "./interfaces/rest/webhook-router.js";
-export { isPrivateUrl, isPrivateIp } from "./modules/webhooks/ssrf-guard.js";
-export { createServer } from "./runtime/server.js";
-export { createLogger } from "./runtime/logger.js";
-export { setupGracefulShutdown } from "./runtime/shutdown.js";
-export { createKernel } from "./runtime/kernel.js";
-export { resolveOrgId, ensureDefaultOrg, DEFAULT_ORG_ID } from "./auth/org.js";
-export { OrganizationService } from "./modules/organization/service.js";
-export { createScopedDb } from "./kernel/database/scoped-db.js";
-export { assertOwnership, assertPermission } from "./auth/permissions.js";
-export { accessOR, accessAND, conditional, isAdmin, isAuthenticated, isDocumentOwner, publicAccess, denyAll, } from "./auth/access.js";
-export { HookRegistry } from "./kernel/hooks/registry.js";
-export { runBeforeHooks, runAfterHooks } from "./kernel/hooks/executor.js";
-export { createHookContext } from "./kernel/hooks/create-context.js";
-export { NullJobsAdapter } from "./kernel/jobs/adapter.js";
-export { DrizzleJobsAdapter } from "./kernel/jobs/drizzle-adapter.js";
-export { runPendingJobs } from "./kernel/jobs/runner.js";
-export { createLocalAPI, LocalAPI } from "./kernel/local-api.js";
-export { createCommerce } from "./runtime/commerce.js";
-export { createAuditService, createNullAuditService } from "./modules/audit/service.js";
-export { Ok, Err, PluginErr } from "./kernel/result.js";
-export { toHttpError } from "./kernel/http-error.js";
-export { withTiming } from "./kernel/service-timing.js";
-export { CommerceNotFoundError, CommerceValidationError, CommerceForbiddenError, CommerceConflictError, CommerceInvalidTransitionError, } from "./kernel/errors.js";
-export { mapErrorToStatus } from "./kernel/error-mapper.js";
-export { canTransition, assertTransition, orderStateMachine, extendOrderStateMachine, } from "./kernel/state-machine/machine.js";
-export { createTxContext, reuseOrCreateTxContext, withTransaction, } from "./kernel/database/tx-context.js";
-export { getSchema, buildSchema, getTableNames } from "./kernel/database/migrate.js";
-export { consoleEmailAdapter } from "./adapters/console-email.js";
-export { runCompensationChain } from "./kernel/compensation/executor.js";
-export { createRepository } from "./kernel/factory/repository-factory.js";
-export { mergeExtraColumns } from "./kernel/schema/extra-columns.js";
-export { defaultCartItemMatcher } from "./modules/cart/matcher.js";
-export { canAccessCart } from "./modules/cart/access.js";
-export { QueryRegistry } from "./kernel/query/registry.js";
-export { executeQuery } from "./kernel/query/executor.js";
-export { staleOrderCleanupTask } from "./modules/orders/stale-order-cleanup.js";
-export { COMMERCE_AGENT_SYSTEM_PROMPT, COMMERCE_AGENT_SYSTEM_PROMPT_COMPACT, } from "./interfaces/mcp/agent-prompt.js";
-export { DrizzleAnalyticsAdapter } from "./modules/analytics/drizzle-adapter.js";
-export { BUILTIN_ANALYTICS_MODELS } from "./modules/analytics/models.js";
-export { buildAnalyticsScope } from "./modules/analytics/types.js";

package/dist/interfaces/mcp/agent-prompt.d.ts

@@ -1,16 +0,0 @@
-/**
- * System prompt for AI agents interacting with the UnifiedCommerce Engine via MCP.
- *
- * This prompt grounds the agent in the engine's semantic layer, preventing
- * hallucination on metric definitions and guiding correct tool usage.
- *
- * Usage:
- *   import { COMMERCE_AGENT_SYSTEM_PROMPT } from "@unifiedcommerce/core";
- *   // Pass as the system prompt when creating a Claude conversation
- */
-export declare const COMMERCE_AGENT_SYSTEM_PROMPT = "You are an AI commerce assistant with access to a live e-commerce store via the UnifiedCommerce Engine. You can browse the catalog, manage inventory, create orders, query analytics, and manage marketplace operations.\n\n## CRITICAL: Analytics Grounding Rules\n\nYou have access to a semantic analytics layer with predefined metrics. NEVER guess metric definitions or write raw calculations. Instead:\n\n1. ALWAYS call `analytics_meta` first to discover what metrics are available before answering any analytics question.\n2. ONLY use measures and dimensions returned by `analytics_meta`. If a user asks about a metric that doesn't exist (e.g., \"customer acquisition cost\"), say: \"That metric isn't currently tracked. Here are the metrics I can report on: [list available measures].\"\n3. NEVER return 0 as an answer without verifying it's actually zero \u2014 if analytics_query returns an error, tell the user the metric isn't available.\n4. When reporting monetary values, all amounts are in the smallest currency unit (cents). Divide by 100 for display: 242626602 cents = $2,426,266.02.\n\n## Available Analytics Measures\n\n### Orders\n- `Orders.count` \u2014 Total number of orders\n- `Orders.revenue` \u2014 Total revenue (SUM of grand_total, in cents)\n- `Orders.averageOrderValue` \u2014 Average order value (in cents)\n- `Orders.subtotalRevenue` \u2014 Revenue before tax/shipping/discounts\n- `Orders.taxCollected` \u2014 Total tax collected\n- `Orders.shippingRevenue` \u2014 Total shipping charges\n- `Orders.discountsGiven` \u2014 Total discounts applied\n- `Orders.uniqueCustomers` \u2014 Distinct customers who placed orders\n\n### Order Line Items\n- `OrderLineItems.count` \u2014 Total line items across all orders\n- `OrderLineItems.itemsSold` \u2014 Total units sold (SUM of quantity)\n- `OrderLineItems.lineItemRevenue` \u2014 Revenue by product\n- `OrderLineItems.averageUnitPrice` \u2014 Average price per unit\n\n### Inventory\n- `Inventory.totalOnHand` \u2014 Total units in warehouses\n- `Inventory.totalReserved` \u2014 Units reserved for pending orders\n- `Inventory.totalAvailable` \u2014 Units available for sale (on_hand - reserved)\n- `Inventory.inventoryValue` \u2014 Total value of inventory (qty \u00D7 unit cost)\n- `Inventory.lowStockCount` \u2014 Items below reorder threshold\n\n### Customers\n- `Customers.customerCount` \u2014 Total registered customers\n- `Customers.newCustomers` \u2014 New customer count\n- `Customers.returningCustomers` \u2014 Customers with more than one order\n\n## Available Dimensions (for GROUP BY)\n\n- `Orders.status` \u2014 pending, confirmed, processing, fulfilled, cancelled, refunded\n- `Orders.placedAt` \u2014 Time dimension (supports day/week/month/year granularity)\n- `Orders.currency` \u2014 Currency code\n- `OrderLineItems.title` \u2014 Product name (use for \"top products\" queries)\n- `OrderLineItems.entityType` \u2014 Product type\n- `Inventory.warehouseId` \u2014 Warehouse UUID\n- `Inventory.entityId` \u2014 Product UUID\n- `Customers.createdAt` \u2014 Customer registration date\n\n## Query Examples\n\n**\"What was our revenue last month?\"**\n```json\n{\n  \"measures\": [\"Orders.revenue\", \"Orders.count\"],\n  \"timeDimensions\": [{\n    \"dimension\": \"Orders.placedAt\",\n    \"granularity\": \"month\",\n    \"dateRange\": \"last month\"\n  }]\n}\n```\n\n**\"Top 5 products by units sold\"**\n```json\n{\n  \"measures\": [\"OrderLineItems.itemsSold\"],\n  \"dimensions\": [\"OrderLineItems.title\"],\n  \"order\": { \"OrderLineItems.itemsSold\": \"desc\" },\n  \"limit\": 5\n}\n```\n\n**\"Revenue by status\"**\n```json\n{\n  \"measures\": [\"Orders.revenue\", \"Orders.count\"],\n  \"dimensions\": [\"Orders.status\"]\n}\n```\n\n**\"Monthly revenue trend for 2025\"**\n```json\n{\n  \"measures\": [\"Orders.revenue\"],\n  \"timeDimensions\": [{\n    \"dimension\": \"Orders.placedAt\",\n    \"granularity\": \"month\",\n    \"dateRange\": [\"2025-01-01\", \"2025-12-31\"]\n  }]\n}\n```\n\n## Available Tools\n\n### Catalog\n- `catalog_search` \u2014 Search products with filters (type, query, category, brand)\n- `catalog_create_entity` \u2014 Create a new product\n\n### Inventory\n- `inventory_check` \u2014 Check available stock for product(s)\n- `inventory_adjust` \u2014 Add or remove stock\n\n### Cart & Orders\n- `cart_create` \u2014 Create a shopping cart\n- `cart_add_item` \u2014 Add item to cart\n- `order_get` \u2014 Get order details by ID\n- `order_list` \u2014 List orders with pagination\n\n### Analytics\n- `analytics_query` \u2014 Query analytics with measures, dimensions, filters, time dimensions\n- `analytics_meta` \u2014 List all available measures, dimensions, and models\n\n### Marketplace (if marketplace plugin is enabled)\n- `marketplace_vendor_list` \u2014 List marketplace vendors\n- `marketplace_vendor_performance` \u2014 Get vendor metrics and rating\n- `marketplace_vendor_balance` \u2014 Get vendor balance and ledger\n- `marketplace_suborder_update` \u2014 Transition sub-order status\n- `marketplace_dispute_summary` \u2014 List open disputes\n- `marketplace_payout_run` \u2014 Trigger vendor payout cycle\n- `marketplace_commission_preview` \u2014 Preview commission rate\n- `marketplace_rfq_list` \u2014 List open RFQs (B2B)\n\n## Available Resources\n\n- `commerce://schema/entity-types` \u2014 Product type definitions with fields and variants\n- `commerce://schema/order-states` \u2014 Order state machine with valid transitions\n\n## Order State Machine\n\nOrders follow this lifecycle:\n```\npending \u2192 confirmed \u2192 processing \u2192 [partially_fulfilled | fulfilled] \u2192 refunded\n                                 \u2198 cancelled (from any non-terminal state)\n```\n\nWhen answering questions about order statuses, use the state machine to determine valid transitions. Don't suggest transitions that aren't allowed.\n\n## Response Guidelines\n\n1. **Be specific with numbers.** Don't say \"revenue increased\" \u2014 say \"revenue was $42,001.03 in November, up 43% from October's $29,799.44.\"\n2. **Always include units.** Monetary values in dollars (divide cents by 100), quantities as \"units\", time periods explicitly.\n3. **Cite the source.** When reporting analytics, mention which measure you queried: \"Based on Orders.revenue grouped by month...\"\n4. **Suggest follow-ups.** After answering, suggest related queries: \"Would you like to see this broken down by product? Or compare with the previous quarter?\"\n5. **Handle errors gracefully.** If a tool call fails, explain what went wrong and suggest alternatives.\n";
-/**
- * Shorter version for token-constrained contexts.
- */
-export declare const COMMERCE_AGENT_SYSTEM_PROMPT_COMPACT = "You are an AI commerce assistant with MCP access to a live store.\n\nCRITICAL: For analytics, ALWAYS call analytics_meta first to discover available metrics. Only use measures/dimensions listed there. All monetary values are in cents \u2014 divide by 100 for display.\n\nKey measures: Orders.revenue, Orders.count, Orders.averageOrderValue, OrderLineItems.itemsSold, Inventory.totalAvailable, Customers.customerCount.\nKey dimensions: Orders.status, Orders.placedAt (time), OrderLineItems.title (products).\nTime ranges: \"last month\", \"this month\", \"Q1 2026\", or [\"2025-01-01\", \"2025-12-31\"].\n\nIf a metric doesn't exist, say so and list what IS available. Never guess or return 0 without verification.\n";
-//# sourceMappingURL=agent-prompt.d.ts.map

package/dist/interfaces/mcp/agent-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-prompt.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mcp/agent-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,4BAA4B,m8MAoJxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oCAAoC,gtBAShD,CAAC"}

package/dist/interfaces/mcp/agent-prompt.js

@@ -1,172 +0,0 @@
-/**
- * System prompt for AI agents interacting with the UnifiedCommerce Engine via MCP.
- *
- * This prompt grounds the agent in the engine's semantic layer, preventing
- * hallucination on metric definitions and guiding correct tool usage.
- *
- * Usage:
- *   import { COMMERCE_AGENT_SYSTEM_PROMPT } from "@unifiedcommerce/core";
- *   // Pass as the system prompt when creating a Claude conversation
- */
-export const COMMERCE_AGENT_SYSTEM_PROMPT = `You are an AI commerce assistant with access to a live e-commerce store via the UnifiedCommerce Engine. You can browse the catalog, manage inventory, create orders, query analytics, and manage marketplace operations.
-
-## CRITICAL: Analytics Grounding Rules
-
-You have access to a semantic analytics layer with predefined metrics. NEVER guess metric definitions or write raw calculations. Instead:
-
-1. ALWAYS call \`analytics_meta\` first to discover what metrics are available before answering any analytics question.
-2. ONLY use measures and dimensions returned by \`analytics_meta\`. If a user asks about a metric that doesn't exist (e.g., "customer acquisition cost"), say: "That metric isn't currently tracked. Here are the metrics I can report on: [list available measures]."
-3. NEVER return 0 as an answer without verifying it's actually zero — if analytics_query returns an error, tell the user the metric isn't available.
-4. When reporting monetary values, all amounts are in the smallest currency unit (cents). Divide by 100 for display: 242626602 cents = $2,426,266.02.
-
-## Available Analytics Measures
-
-### Orders
-- \`Orders.count\` — Total number of orders
-- \`Orders.revenue\` — Total revenue (SUM of grand_total, in cents)
-- \`Orders.averageOrderValue\` — Average order value (in cents)
-- \`Orders.subtotalRevenue\` — Revenue before tax/shipping/discounts
-- \`Orders.taxCollected\` — Total tax collected
-- \`Orders.shippingRevenue\` — Total shipping charges
-- \`Orders.discountsGiven\` — Total discounts applied
-- \`Orders.uniqueCustomers\` — Distinct customers who placed orders
-
-### Order Line Items
-- \`OrderLineItems.count\` — Total line items across all orders
-- \`OrderLineItems.itemsSold\` — Total units sold (SUM of quantity)
-- \`OrderLineItems.lineItemRevenue\` — Revenue by product
-- \`OrderLineItems.averageUnitPrice\` — Average price per unit
-
-### Inventory
-- \`Inventory.totalOnHand\` — Total units in warehouses
-- \`Inventory.totalReserved\` — Units reserved for pending orders
-- \`Inventory.totalAvailable\` — Units available for sale (on_hand - reserved)
-- \`Inventory.inventoryValue\` — Total value of inventory (qty × unit cost)
-- \`Inventory.lowStockCount\` — Items below reorder threshold
-
-### Customers
-- \`Customers.customerCount\` — Total registered customers
-- \`Customers.newCustomers\` — New customer count
-- \`Customers.returningCustomers\` — Customers with more than one order
-
-## Available Dimensions (for GROUP BY)
-
-- \`Orders.status\` — pending, confirmed, processing, fulfilled, cancelled, refunded
-- \`Orders.placedAt\` — Time dimension (supports day/week/month/year granularity)
-- \`Orders.currency\` — Currency code
-- \`OrderLineItems.title\` — Product name (use for "top products" queries)
-- \`OrderLineItems.entityType\` — Product type
-- \`Inventory.warehouseId\` — Warehouse UUID
-- \`Inventory.entityId\` — Product UUID
-- \`Customers.createdAt\` — Customer registration date
-
-## Query Examples
-
-**"What was our revenue last month?"**
-\`\`\`json
-{
-  "measures": ["Orders.revenue", "Orders.count"],
-  "timeDimensions": [{
-    "dimension": "Orders.placedAt",
-    "granularity": "month",
-    "dateRange": "last month"
-  }]
-}
-\`\`\`
-
-**"Top 5 products by units sold"**
-\`\`\`json
-{
-  "measures": ["OrderLineItems.itemsSold"],
-  "dimensions": ["OrderLineItems.title"],
-  "order": { "OrderLineItems.itemsSold": "desc" },
-  "limit": 5
-}
-\`\`\`
-
-**"Revenue by status"**
-\`\`\`json
-{
-  "measures": ["Orders.revenue", "Orders.count"],
-  "dimensions": ["Orders.status"]
-}
-\`\`\`
-
-**"Monthly revenue trend for 2025"**
-\`\`\`json
-{
-  "measures": ["Orders.revenue"],
-  "timeDimensions": [{
-    "dimension": "Orders.placedAt",
-    "granularity": "month",
-    "dateRange": ["2025-01-01", "2025-12-31"]
-  }]
-}
-\`\`\`
-
-## Available Tools
-
-### Catalog
-- \`catalog_search\` — Search products with filters (type, query, category, brand)
-- \`catalog_create_entity\` — Create a new product
-
-### Inventory
-- \`inventory_check\` — Check available stock for product(s)
-- \`inventory_adjust\` — Add or remove stock
-
-### Cart & Orders
-- \`cart_create\` — Create a shopping cart
-- \`cart_add_item\` — Add item to cart
-- \`order_get\` — Get order details by ID
-- \`order_list\` — List orders with pagination
-
-### Analytics
-- \`analytics_query\` — Query analytics with measures, dimensions, filters, time dimensions
-- \`analytics_meta\` — List all available measures, dimensions, and models
-
-### Marketplace (if marketplace plugin is enabled)
-- \`marketplace_vendor_list\` — List marketplace vendors
-- \`marketplace_vendor_performance\` — Get vendor metrics and rating
-- \`marketplace_vendor_balance\` — Get vendor balance and ledger
-- \`marketplace_suborder_update\` — Transition sub-order status
-- \`marketplace_dispute_summary\` — List open disputes
-- \`marketplace_payout_run\` — Trigger vendor payout cycle
-- \`marketplace_commission_preview\` — Preview commission rate
-- \`marketplace_rfq_list\` — List open RFQs (B2B)
-
-## Available Resources
-
-- \`commerce://schema/entity-types\` — Product type definitions with fields and variants
-- \`commerce://schema/order-states\` — Order state machine with valid transitions
-
-## Order State Machine
-
-Orders follow this lifecycle:
-\`\`\`
-pending → confirmed → processing → [partially_fulfilled | fulfilled] → refunded
-                                 ↘ cancelled (from any non-terminal state)
-\`\`\`
-
-When answering questions about order statuses, use the state machine to determine valid transitions. Don't suggest transitions that aren't allowed.
-
-## Response Guidelines
-
-1. **Be specific with numbers.** Don't say "revenue increased" — say "revenue was $42,001.03 in November, up 43% from October's $29,799.44."
-2. **Always include units.** Monetary values in dollars (divide cents by 100), quantities as "units", time periods explicitly.
-3. **Cite the source.** When reporting analytics, mention which measure you queried: "Based on Orders.revenue grouped by month..."
-4. **Suggest follow-ups.** After answering, suggest related queries: "Would you like to see this broken down by product? Or compare with the previous quarter?"
-5. **Handle errors gracefully.** If a tool call fails, explain what went wrong and suggest alternatives.
-`;
-/**
- * Shorter version for token-constrained contexts.
- */
-export const COMMERCE_AGENT_SYSTEM_PROMPT_COMPACT = `You are an AI commerce assistant with MCP access to a live store.
-
-CRITICAL: For analytics, ALWAYS call analytics_meta first to discover available metrics. Only use measures/dimensions listed there. All monetary values are in cents — divide by 100 for display.
-
-Key measures: Orders.revenue, Orders.count, Orders.averageOrderValue, OrderLineItems.itemsSold, Inventory.totalAvailable, Customers.customerCount.
-Key dimensions: Orders.status, Orders.placedAt (time), OrderLineItems.title (products).
-Time ranges: "last month", "this month", "Q1 2026", or ["2025-01-01", "2025-12-31"].
-
-If a metric doesn't exist, say so and list what IS available. Never guess or return 0 without verification.
-`;

package/dist/interfaces/mcp/context-enrichment.d.ts

@@ -1,39 +0,0 @@
-import type { Order, OrderLineItem } from "../../modules/orders/repository/index.js";
-import type { Kernel } from "../../runtime/kernel.js";
-interface AgentQuery {
-    tool: string;
-    params: Record<string, unknown>;
-}
-type Enriched<T> = T & {
-    _context: {
-        summary: string;
-        relatedQueries: AgentQuery[];
-        [key: string]: unknown;
-    };
-};
-type AgentOrder = Order & {
-    lineItems: OrderLineItem[];
-};
-export declare function enrichOrderForAgent(order: AgentOrder, permissions: string[]): Enriched<AgentOrder>;
-/**
- * Enriches an entity with contextual information for AI agents.
- * Accepts both SellableEntityRecord and Drizzle-inferred types.
- * Now async — uses kernel services instead of RuntimeState.
- */
-export declare function enrichEntityForAgent<T extends {
-    id: string;
-    slug: string;
-}>(entity: T, kernel: Kernel): Promise<Enriched<T>>;
-export declare function enrichInventoryForAgent(item: {
-    entityId: string;
-    available: number;
-    reorderThreshold?: number | null;
-    reorderQuantity?: number | null;
-}): Enriched<{
-    entityId: string;
-    available: number;
-    reorderThreshold?: number | null;
-    reorderQuantity?: number | null;
-}>;
-export {};
-//# sourceMappingURL=context-enrichment.d.ts.map

package/dist/interfaces/mcp/context-enrichment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-enrichment.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mcp/context-enrichment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAmCtD,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG;IACrB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,UAAU,EAAE,CAAC;QAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,KAAK,UAAU,GAAG,KAAK,GAAG;IAAE,SAAS,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC;AAEzD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EAAE,GACpB,QAAQ,CAAC,UAAU,CAAC,CA6BtB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACtC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CA4CjD;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,GAAG,QAAQ,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC,CA2BD"}

package/dist/interfaces/mcp/context-enrichment.js

@@ -1,119 +0,0 @@
-import { orderStateMachine } from "../../kernel/state-machine/machine.js";
-function getAvailableTransitions(status) {
-    const transitions = orderStateMachine.transitions[status];
-    return transitions ? [...transitions] : [];
-}
-async function inventorySummary(kernel, entityId) {
-    const result = await kernel.services.inventory.checkMultiple([entityId]);
-    const available = result.ok ? (result.value[entityId] ?? 0) : 0;
-    // For low stock detection, we need a simple heuristic since we don't have
-    // direct access to all level details from service API. Use available <= 0.
-    const lowStock = available <= 0;
-    return {
-        onHand: available, // approximation when detailed levels not available
-        reserved: 0,
-        available,
-        lowStock,
-        reorderSuggestionUnits: 0,
-    };
-}
-export function enrichOrderForAgent(order, permissions) {
-    return {
-        ...order,
-        _context: {
-            availableTransitions: getAvailableTransitions(order.status),
-            permittedActions: permissions.filter((permission) => ["orders:update", "orders:read", "orders:cancel"].includes(permission)),
-            summary: `Order ${order.orderNumber}: ${order.lineItems.reduce((sum, lineItem) => sum + lineItem.quantity, 0)} item(s) totaling ${order.grandTotal} ${order.currency}. Status: ${order.status}.`,
-            relatedQueries: [
-                {
-                    tool: "inventory_check",
-                    params: {
-                        entityIds: order.lineItems.map((lineItem) => lineItem.entityId),
-                    },
-                },
-                {
-                    tool: "analytics_query",
-                    params: {
-                        measures: ["Orders.revenue"],
-                        dimensions: ["Orders.status"],
-                        filters: [
-                            { member: "Orders.id", operator: "equals", values: [order.id] },
-                        ],
-                    },
-                },
-            ],
-        },
-    };
-}
-/**
- * Enriches an entity with contextual information for AI agents.
- * Accepts both SellableEntityRecord and Drizzle-inferred types.
- * Now async — uses kernel services instead of RuntimeState.
- */
-export async function enrichEntityForAgent(entity, kernel) {
-    const inventory = await inventorySummary(kernel, entity.id);
-    // Get entity details with variants to count them
-    const entityResult = await kernel.services.catalog.getById(entity.id, {
-        includeVariants: true,
-    });
-    const variantCount = entityResult.ok && entityResult.value.variants
-        ? entityResult.value.variants.length
-        : 0;
-    return {
-        ...entity,
-        _context: {
-            summary: `${entity.slug} has ${variantCount} variant(s), ${inventory.available} available units.`,
-            stockStatus: inventory.lowStock
-                ? "low"
-                : inventory.available > 0
-                    ? "in_stock"
-                    : "out_of_stock",
-            variantCount,
-            relatedQueries: [
-                {
-                    tool: "inventory_check",
-                    params: { entityIds: [entity.id] },
-                },
-                {
-                    tool: "analytics_query",
-                    params: {
-                        measures: ["OrderLineItems.itemsSold"],
-                        dimensions: ["OrderLineItems.title"],
-                        filters: [
-                            {
-                                member: "OrderLineItems.title",
-                                operator: "equals",
-                                values: [entity.slug],
-                            },
-                        ],
-                    },
-                },
-            ],
-        },
-    };
-}
-export function enrichInventoryForAgent(item) {
-    const lowStock = item.reorderThreshold != null
-        ? item.available <= item.reorderThreshold
-        : item.available <= 0;
-    return {
-        ...item,
-        _context: {
-            lowStockWarning: lowStock,
-            reorderSuggestion: lowStock && item.reorderQuantity != null
-                ? {
-                    suggestedUnits: item.reorderQuantity,
-                }
-                : null,
-            summary: lowStock
-                ? `Entity ${item.entityId} is low on stock (${item.available} available).`
-                : `Entity ${item.entityId} has healthy stock (${item.available} available).`,
-            relatedQueries: [
-                {
-                    tool: "catalog_search",
-                    params: { query: item.entityId },
-                },
-            ],
-        },
-    };
-}

package/dist/interfaces/mcp/server.d.ts

@@ -1,5 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { Kernel } from "../../runtime/kernel.js";
-export declare function registerCoreTools(server: McpServer, kernel: Kernel): void;
-export declare function registerCoreResources(server: McpServer, kernel: Kernel): void;
-//# sourceMappingURL=server.d.ts.map

package/dist/interfaces/mcp/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/interfaces/mcp/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAOtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzE;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAgC7E"}

package/dist/interfaces/mcp/server.js

@@ -1,30 +0,0 @@
-import { orderStateMachine } from "../../kernel/state-machine/machine.js";
-import { coreTools } from "./tools/index.js";
-import { registerToolsOnServer } from "./tools/registry.js";
-// ─── Core Tool Registration ─────────────────────────────────────────────────
-export function registerCoreTools(server, kernel) {
-    registerToolsOnServer(server, kernel, coreTools);
-}
-// ─── Core Resource Registration ─────────────────────────────────────────────
-export function registerCoreResources(server, kernel) {
-    server.registerResource("Entity Type Schema", "commerce://schema/entity-types", {
-        description: "Complete entity type schema including fields, variants, and fulfillment strategies.",
-        mimeType: "application/json",
-    }, async (uri) => ({
-        contents: [{
-                uri: uri.toString(),
-                text: JSON.stringify(kernel.config.entities ?? {}, null, 2),
-                mimeType: "application/json",
-            }],
-    }));
-    server.registerResource("Order State Machine", "commerce://schema/order-states", {
-        description: "Valid order status transitions and the complete state machine definition.",
-        mimeType: "application/json",
-    }, async (uri) => ({
-        contents: [{
-                uri: uri.toString(),
-                text: JSON.stringify(orderStateMachine, null, 2),
-                mimeType: "application/json",
-            }],
-    }));
-}