@agent-native/core 0.111.3 → 0.112.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Framework for agent-native apps.\n// Import everything from \"@agent-native/core\".\n\n// Agent (production mode)\nexport {\n  createProductionAgentHandler,\n  type ActionEntry,\n  type ScriptEntry,\n  type ProductionAgentOptions,\n  type ActionTool,\n  type ScriptTool,\n  type AgentMessage,\n  type AgentChatRequest,\n  type AgentChatEvent,\n  type AgentChatAttachment,\n  DEFAULT_MODEL,\n  // In-loop processors (observers/guardrails for runAgentLoop)\n  TripWire,\n  type Processor,\n  type ProcessorState,\n  type ProcessorAbort,\n} from \"./agent/index.js\";\nexport {\n  defineAction,\n  AgentActionStopError,\n  isAgentActionStopError,\n  type ActionDefinition,\n  type ActionHttpConfig,\n  type AgentActionStopOptions,\n  type PublicAgentActionConfig,\n  type ActionDeepLink,\n  type ActionLinkBuilder,\n  MCP_APP_EXTENSION_ID,\n  MCP_APP_MIME_TYPE,\n  MCP_APP_RESOURCE_URI_META_KEY,\n  type ActionMcpAppConfig,\n  type ActionMcpAppCsp,\n  type ActionMcpAppCspBuilder,\n  type ActionMcpAppHtmlBuilder,\n  type ActionMcpAppPermissions,\n  type ActionMcpAppResourceConfig,\n  type ActionMcpAppResourceMeta,\n} from \"./action.js\";\nexport {\n  embedApp,\n  MCP_APP_REQUEST_ORIGIN_CSP_SOURCE,\n  type EmbedAppOptions,\n} from \"./mcp/embed-app.js\";\nexport {\n  embedRoute,\n  type EmbedRouteContext,\n  type EmbedRouteOptions,\n  type EmbedRoutePathBuilder,\n  type EmbedRouteResult,\n} from \"./mcp/embed-route.js\";\nexport {\n  ACTION_CHAT_UI_DATA_CHART_RENDERER,\n  ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,\n  ACTION_CHAT_UI_DATA_TABLE_RENDERER,\n  ACTION_CHAT_UI_DATA_WIDGET_RENDERER,\n  ACTION_CHAT_UI_INLINE_EXTENSION_RENDERER,\n  type ActionChatUIConfig,\n} from \"./action-ui.js\";\nexport {\n  DATA_CHART_WIDGET,\n  DATA_INSIGHTS_WIDGET,\n  DATA_TABLE_WIDGET,\n  createDataChartWidgetResult,\n  createDataInsightsWidgetResult,\n  createDataTableWidgetResult,\n  dataChartWidgetResultSchema,\n  dataChartWidgetSchema,\n  dataInsightsWidgetResultSchema,\n  dataTableWidgetResultSchema,\n  dataTableWidgetSchema,\n  dataWidgetResultSchema,\n  isDataChartWidget,\n  isDataTableWidget,\n  isDataWidgetResult,\n  normalizeDataWidgetKind,\n  normalizeDataWidgetResult,\n  type DataChartSeriesDefinition,\n  type DataChartWidget,\n  type DataChartWidgetResult,\n  type DataChartWidgetResultInput,\n  type DataInsightsWidgetResult,\n  type DataInsightsWidgetResultInput,\n  type DataTableColumn,\n  type DataTableWidget,\n  type DataTableWidgetResult,\n  type DataTableWidgetResultInput,\n  type DataWidgetDisplay,\n  type DataWidgetKind,\n  type DataWidgetResult,\n  type DataWidgetResultMetadata,\n} from \"./data-widgets/index.js\";\nexport { createDevScriptRegistry } from \"./scripts/dev/index.js\";\nexport {\n  createAgentChatPlugin,\n  defaultAgentChatPlugin,\n  type AgentChatPluginOptions,\n} from \"./server/agent-chat-plugin.js\";\nexport {\n  createAgentNativeEmbeddedPlugin,\n  mountAgentNativeEmbedded,\n  type AgentNativeEmbeddedPluginOptions,\n} from \"./server/embedded.js\";\nexport {\n  BUILT_IN_INTEGRATION_CATALOG,\n  INTEGRATION_CATEGORIES,\n  getIntegrationCatalogEntry,\n  listBuiltInChannelIntegrations,\n  listIntegrationCatalog,\n  type AutomationCapabilities,\n  type BuiltInChannelId,\n  type ChannelCapabilities,\n  type IntegrationAvailability,\n  type IntegrationCatalogEntry,\n  type IntegrationCategory,\n  type IntegrationCredentialRequirement,\n  type IntegrationIconKey,\n  type IntegrationSupportMaturity,\n} from \"./integrations/catalog.js\";\nexport {\n  AutomationConnectorError,\n  createAutomationCallbackHandler,\n  createAutomationRuntime,\n  createInvokeAutomationWorkflowAction,\n  type AutomationCallbackAuthentication,\n  type AutomationCallbackInput,\n  type AutomationCallbackResult,\n  type AutomationInboundDefinition,\n  type AutomationInvocation,\n  type AutomationInvocationResult,\n  type AutomationInvocationStatus,\n  type AutomationOutboundDefinition,\n  type AutomationResponseMode,\n  type AutomationRetryPolicy,\n  type AutomationRuntime,\n  type AutomationRuntimeOptions,\n  type AutomationWorkflowCapabilities,\n  type AutomationWorkflowDefinition,\n  type JsonSchema,\n} from \"./automation/index.js\";\nexport {\n  createFeatureFlagsPlugin,\n  defineFeatureFlag,\n  defineFeatureFlags,\n  evaluateFeatureFlag,\n  getFeatureFlagDefinition,\n  getFeatureFlagRules,\n  isFeatureFlagEnabled,\n  listFeatureFlags,\n  registerFeatureFlags,\n  type FeatureFlagDefinition,\n  type FeatureFlagMode,\n  type FeatureFlagRules,\n  type FeatureFlagScope,\n} from \"./feature-flags/index.js\";\n\n// Server\nexport {\n  createServer,\n  createSSEHandler,\n  defineNitroPlugin,\n  autoMountAuth,\n  getSession,\n  type CreateServerOptions,\n  type SSEHandlerOptions,\n  type AuthSession,\n  type AuthOptions,\n} from \"./server/index.js\";\n\n// Client\n//\n// IMPORTANT: this top-level entry (the package `default`/Node condition) must\n// stay server-safe. It is what `import { defineAction } from \"@agent-native/core\"`\n// resolves to in a headless / Node / SSR context, where React, react-router, and\n// @tanstack/react-query are NOT installed. The React client surface therefore\n// lives behind the `@agent-native/core/client` subpath instead of being\n// re-exported here — re-exporting \"./client/index.js\" from this module would\n// eagerly pull route-state.ts → \"@tanstack/react-query\" into the load graph and\n// crash any headless app at module load.\n//\n// Browser bundlers resolve \"@agent-native/core\" to the `browser` condition\n// (./index.browser.ts), which re-exports the client surface, so UI code that\n// imports client helpers from the bare specifier keeps working in the browser.\n// Code that runs through the Node entry (SSR, scripts, headless) must import\n// client helpers explicitly:\n//\n//   import { useDbSync, cn } from \"@agent-native/core/client\";\n\n// Shared (isomorphic)\nexport {\n  agentChat,\n  type AgentChatCallOptions,\n  type AgentChatResponse,\n} from \"./shared/index.js\";\nexport {\n  EMBED_MODE_QUERY_PARAM,\n  EMBED_SESSION_COOKIE,\n  EMBED_START_PATH,\n  EMBED_TOKEN_QUERY_PARAM,\n} from \"./shared/embed-auth.js\";\n\n// Agent Web surfaces\nexport {\n  AGENT_WEB_CRAWLER_CATEGORIES,\n  AGENT_WEB_CRAWLER_USER_AGENTS,\n  DEFAULT_AGENT_WEB_CRAWLER_POLICY,\n  absoluteUrl,\n  agentWebConfigFromPackageJson,\n  buildAgentWebStaticFiles,\n  buildBaseJsonLd,\n  buildLlmsFullTxt,\n  buildLlmsTxt,\n  buildMarkdownResponseHeaders,\n  buildPageJsonLd,\n  buildRobotsTxt,\n  buildSitemapXml,\n  deriveAgentWebPublicRoutes,\n  estimateMarkdownTokens,\n  markdownFilePathForPage,\n  markdownUrlForPage,\n  normalizeAgentWebConfig,\n  pathPatternMatches,\n  resolveAgentWebCrawlerPolicy,\n  type AgentWebConfig,\n  type AgentWebCrawlerCategory,\n  type AgentWebCrawlerDecision,\n  type AgentWebCrawlerOverrides,\n  type AgentWebCrawlerPolicy,\n  type AgentWebInputConfig,\n  type AgentWebPage,\n  type AgentWebStaticFile,\n  type BuildAgentWebStaticFilesOptions,\n  type DeriveAgentWebPublicRoutesOptions,\n  type MarkdownResponseHeadersOptions,\n} from \"./agent-web/index.js\";\n\n// Token usage tracking\nexport {\n  recordUsage,\n  getUsageSummary,\n  getUserUsageCents,\n  calculateCost,\n  usageBillingForEngine,\n  builderCreditsFromCostCents,\n  BUILDER_AGENT_CREDIT_MARGIN_MULTIPLIER,\n  BUILDER_AGENT_CREDITS_PER_USD,\n  BUILDER_CREDIT_USAGE_BILLING,\n  USD_USAGE_BILLING,\n  type UsageRecord,\n  type UsageCostSource,\n  type UsageCostAggregate,\n  type UsageSummary,\n  type UsageBillingMode,\n  type UsageBillingUnit,\n  type UsageBucket,\n  type DailyBucket,\n  type UsageRecentEntry,\n} from \"./usage/store.js\";\n\n// Workspace-scoped third-party connection metadata\nexport {\n  deleteWorkspaceConnection,\n  getWorkspaceConnectionAppAccess,\n  getWorkspaceConnection,\n  getWorkspaceConnectionGrant,\n  listWorkspaceConnectionProviderCatalogForApp,\n  listWorkspaceConnectionGrants,\n  listWorkspaceConnections,\n  resolveWorkspaceConnectionCredentialForApp,\n  resolveWorkspaceConnectionCredentialsForApp,\n  revokeWorkspaceConnectionGrant,\n  serializeWorkspaceConnectionGrant,\n  serializeWorkspaceConnection,\n  summarizeWorkspaceConnectionProviderForApp,\n  summarizeWorkspaceConnectionProviderReadiness,\n  upsertWorkspaceConnectionGrant,\n  upsertWorkspaceConnection,\n  type ListWorkspaceConnectionProviderCatalogForAppOptions,\n  type ListWorkspaceConnectionGrantsOptions,\n  type ListWorkspaceConnectionsOptions,\n  type ResolveWorkspaceConnectionCredentialForAppOptions,\n  type ResolveWorkspaceConnectionCredentialsForAppOptions,\n  type SerializedWorkspaceConnectionGrant,\n  type SerializedWorkspaceConnection,\n  type SummarizeWorkspaceConnectionProviderForAppOptions,\n  type SummarizeWorkspaceConnectionProviderReadinessOptions,\n  type UpsertWorkspaceConnectionGrantInput,\n  type UpsertWorkspaceConnectionInput,\n  type WorkspaceConnectionAppAccess,\n  type WorkspaceConnectionAppAccessMode,\n  type WorkspaceConnection,\n  type WorkspaceConnectionCredentialBackend,\n  type WorkspaceConnectionCredentialProvenance,\n  type WorkspaceConnectionCredentialRef,\n  type WorkspaceConnectionCredentialResolution,\n  type WorkspaceConnectionCredentialResolutionCheck,\n  type WorkspaceConnectionCredentialResolutionStatus,\n  type WorkspaceConnectionCredentialsResolution,\n  type WorkspaceConnectionExplicitGrantSummary,\n  type WorkspaceConnectionForAppSummary,\n  type WorkspaceConnectionGrant,\n  type WorkspaceConnectionGrantAvailability,\n  type WorkspaceConnectionGrantState,\n  type WorkspaceConnectionProviderAppSummary,\n  type WorkspaceConnectionProviderLike,\n  type WorkspaceConnectionProviderCatalogForApp,\n  type WorkspaceConnectionProviderCatalogForAppItem,\n  type WorkspaceConnectionProviderReadiness,\n  type WorkspaceConnectionProviderReadinessStatus,\n  type WorkspaceConnectionPublicCredentialRef,\n  type WorkspaceConnectionStatus,\n  workspaceConnectionIsAvailableToApp,\n  registerWorkspaceConnectionLifecycleListener,\n  type WorkspaceConnectionLifecycleEvent,\n  type WorkspaceConnectionLifecycleListener,\n} from \"./workspace-connections/index.js\";\n\n// Reusable workspace connection provider catalog\nexport {\n  PROVIDER_READERS,\n  ProviderReaderRuntimeError,\n  WORKSPACE_CONNECTION_PROVIDERS,\n  createProviderReaderRuntime,\n  defineProviderReader,\n  defineProviderReaderImplementation,\n  defineWorkspaceConnectionProvider,\n  getProviderReader,\n  getWorkspaceConnectionProvider,\n  isWorkspaceConnectionProviderId,\n  listProviderReaders,\n  listWorkspaceConnectionProviders,\n  listWorkspaceConnectionProvidersForCapability,\n  listWorkspaceConnectionProvidersForTemplate,\n  providerReaderSupports,\n  workspaceConnectionProviderSupports,\n  type ListWorkspaceConnectionProvidersOptions,\n  type ListProviderReadersOptions,\n  type ProviderReaderCapability,\n  type ProviderReaderCredentialRequirement,\n  type ProviderReaderDefinition,\n  type ProviderReaderImplementationStatus,\n  type ProviderReaderOperation,\n  type ProviderReaderOperationDescriptor,\n  type ProviderReaderOperationParameter,\n  type ProviderReaderRequest,\n  type ProviderReaderRuntime,\n  type ProviderReaderRuntimeConnection,\n  type ProviderReaderRuntimeConnectionResolverOptions,\n  type ProviderReaderRuntimeContext,\n  type ProviderReaderRuntimeCredentialsResolverOptions,\n  type ProviderReaderRuntimeErrorCode,\n  type ProviderReaderRuntimeHandler,\n  type ProviderReaderRuntimeImplementation,\n  type ProviderReaderRuntimeItem,\n  type ProviderReaderRuntimeOptions,\n  type ProviderReaderRuntimeResponse,\n  type WorkspaceConnectionCapability,\n  type WorkspaceConnectionCredentialKey,\n  type WorkspaceConnectionProvider,\n  type WorkspaceConnectionProviderId,\n  type WorkspaceConnectionTemplateUse,\n} from \"./connections/index.js\";\n\n// Scripts\nexport {\n  runScript,\n  loadEnv,\n  parseArgs,\n  camelCaseArgs,\n  isValidPath,\n  isValidProjectPath,\n  ensureDir,\n  fail,\n} from \"./scripts/index.js\";\n\n// Secrets registry — import from \"@agent-native/core/secrets\" when possible\n// (the subpath keeps the top-level entry point lean), but re-export the\n// public API here for convenience.\nexport {\n  registerRequiredSecret,\n  listRequiredSecrets,\n  getRequiredSecret,\n  readAppSecret,\n  writeAppSecret,\n  deleteAppSecret,\n  type RegisteredSecret,\n  type SecretScope,\n  type SecretKind,\n  type SecretValidator,\n  type SecretRef,\n} from \"./secrets/index.js\";\n\nexport * from \"./history/index.js\";\nexport * from \"./review/index.js\";\nexport * from \"./org-team/index.js\";\nexport * from \"./navigation/index.js\";\nexport * from \"./command-navigation/index.js\";\nexport {\n  registerWorkspaceConnectionOnboardingStep,\n  type RegisterWorkspaceConnectionOnboardingStepOptions,\n} from \"./setup-connections/index.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// Framework for agent-native apps.\n// Import everything from \"@agent-native/core\".\n\n// Agent (production mode)\nexport {\n  createProductionAgentHandler,\n  type ActionEntry,\n  type ScriptEntry,\n  type ProductionAgentOptions,\n  type ActionTool,\n  type ScriptTool,\n  type AgentMessage,\n  type AgentChatRequest,\n  type AgentChatEvent,\n  type AgentChatAttachment,\n  DEFAULT_MODEL,\n  // In-loop processors (observers/guardrails for runAgentLoop)\n  TripWire,\n  type Processor,\n  type ProcessorState,\n  type ProcessorAbort,\n} from \"./agent/index.js\";\nexport {\n  defineAction,\n  AgentActionStopError,\n  isAgentActionStopError,\n  type ActionDefinition,\n  type ActionHttpConfig,\n  type AgentActionStopOptions,\n  type PublicAgentActionConfig,\n  type ActionDeepLink,\n  type ActionLinkBuilder,\n  MCP_APP_EXTENSION_ID,\n  MCP_APP_MIME_TYPE,\n  MCP_APP_RESOURCE_URI_META_KEY,\n  type ActionMcpAppConfig,\n  type ActionMcpAppCsp,\n  type ActionMcpAppCspBuilder,\n  type ActionMcpAppHtmlBuilder,\n  type ActionMcpAppPermissions,\n  type ActionMcpAppResourceConfig,\n  type ActionMcpAppResourceMeta,\n} from \"./action.js\";\nexport {\n  embedApp,\n  MCP_APP_REQUEST_ORIGIN_CSP_SOURCE,\n  type EmbedAppOptions,\n} from \"./mcp/embed-app.js\";\nexport {\n  embedRoute,\n  type EmbedRouteContext,\n  type EmbedRouteOptions,\n  type EmbedRoutePathBuilder,\n  type EmbedRouteResult,\n} from \"./mcp/embed-route.js\";\nexport {\n  ACTION_CHAT_UI_DATA_CHART_RENDERER,\n  ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,\n  ACTION_CHAT_UI_DATA_TABLE_RENDERER,\n  ACTION_CHAT_UI_DATA_WIDGET_RENDERER,\n  ACTION_CHAT_UI_INLINE_EXTENSION_RENDERER,\n  type ActionChatUIConfig,\n} from \"./action-ui.js\";\nexport {\n  DATA_CHART_WIDGET,\n  DATA_INSIGHTS_WIDGET,\n  DATA_TABLE_WIDGET,\n  createDataChartWidgetResult,\n  createDataInsightsWidgetResult,\n  createDataTableWidgetResult,\n  dataChartWidgetResultSchema,\n  dataChartWidgetSchema,\n  dataInsightsWidgetResultSchema,\n  dataTableWidgetResultSchema,\n  dataTableWidgetSchema,\n  dataWidgetResultSchema,\n  isDataChartWidget,\n  isDataTableWidget,\n  isDataWidgetResult,\n  normalizeDataWidgetKind,\n  normalizeDataWidgetResult,\n  type DataChartSeriesDefinition,\n  type DataChartWidget,\n  type DataChartWidgetResult,\n  type DataChartWidgetResultInput,\n  type DataInsightsWidgetResult,\n  type DataInsightsWidgetResultInput,\n  type DataTableColumn,\n  type DataTableWidget,\n  type DataTableWidgetResult,\n  type DataTableWidgetResultInput,\n  type DataWidgetDisplay,\n  type DataWidgetKind,\n  type DataWidgetResult,\n  type DataWidgetResultMetadata,\n} from \"./data-widgets/index.js\";\nexport { createDevScriptRegistry } from \"./scripts/dev/index.js\";\nexport {\n  createAgentChatPlugin,\n  defaultAgentChatPlugin,\n  type AgentChatPluginOptions,\n} from \"./server/agent-chat-plugin.js\";\nexport {\n  createAgentNativeEmbeddedPlugin,\n  mountAgentNativeEmbedded,\n  type AgentNativeEmbeddedPluginOptions,\n} from \"./server/embedded.js\";\nexport {\n  BUILT_IN_INTEGRATION_CATALOG,\n  INTEGRATION_CATEGORIES,\n  getIntegrationCatalogEntry,\n  listBuiltInChannelIntegrations,\n  listIntegrationCatalog,\n  type AutomationCapabilities,\n  type BuiltInChannelId,\n  type ChannelCapabilities,\n  type IntegrationAvailability,\n  type IntegrationCatalogEntry,\n  type IntegrationCategory,\n  type IntegrationCredentialRequirement,\n  type IntegrationIconKey,\n  type IntegrationSupportMaturity,\n} from \"./integrations/catalog.js\";\nexport {\n  AutomationConnectorError,\n  createAutomationCallbackHandler,\n  createAutomationRuntime,\n  createInvokeAutomationWorkflowAction,\n  type AutomationCallbackAuthentication,\n  type AutomationCallbackInput,\n  type AutomationCallbackResult,\n  type AutomationInboundDefinition,\n  type AutomationInvocation,\n  type AutomationInvocationResult,\n  type AutomationInvocationStatus,\n  type AutomationOutboundDefinition,\n  type AutomationResponseMode,\n  type AutomationRetryPolicy,\n  type AutomationRuntime,\n  type AutomationRuntimeOptions,\n  type AutomationWorkflowCapabilities,\n  type AutomationWorkflowDefinition,\n  type JsonSchema,\n} from \"./automation/index.js\";\nexport {\n  createFeatureFlagsPlugin,\n  defineFeatureFlag,\n  defineFeatureFlags,\n  evaluateFeatureFlag,\n  getFeatureFlagDefinition,\n  getFeatureFlagRules,\n  isFeatureFlagEnabled,\n  listFeatureFlags,\n  registerFeatureFlags,\n  type FeatureFlagDefinition,\n  type FeatureFlagMode,\n  type FeatureFlagRules,\n  type FeatureFlagScope,\n} from \"./feature-flags/index.js\";\n\n// Server\nexport {\n  createServer,\n  createSSEHandler,\n  defineNitroPlugin,\n  autoMountAuth,\n  getSession,\n  type CreateServerOptions,\n  type SSEHandlerOptions,\n  type AuthSession,\n  type AuthOptions,\n} from \"./server/index.js\";\n\n// Client\n//\n// IMPORTANT: this top-level entry (the package `default`/Node condition) must\n// stay server-safe. It is what `import { defineAction } from \"@agent-native/core\"`\n// resolves to in a headless / Node / SSR context, where React, react-router, and\n// @tanstack/react-query are NOT installed. The React client surface therefore\n// lives behind the `@agent-native/core/client` subpath instead of being\n// re-exported here — re-exporting \"./client/index.js\" from this module would\n// eagerly pull route-state.ts → \"@tanstack/react-query\" into the load graph and\n// crash any headless app at module load.\n//\n// Browser bundlers resolve \"@agent-native/core\" to the `browser` condition\n// (./index.browser.ts), which re-exports the client surface, so UI code that\n// imports client helpers from the bare specifier keeps working in the browser.\n// Code that runs through the Node entry (SSR, scripts, headless) must import\n// client helpers explicitly:\n//\n//   import { useDbSync, cn } from \"@agent-native/core/client\";\n\n// Shared (isomorphic)\nexport {\n  agentChat,\n  type AgentChatCallOptions,\n  type AgentChatResponse,\n} from \"./shared/index.js\";\nexport {\n  EMBED_MODE_QUERY_PARAM,\n  EMBED_SESSION_COOKIE,\n  EMBED_START_PATH,\n  EMBED_TOKEN_QUERY_PARAM,\n} from \"./shared/embed-auth.js\";\n\n// Agent Web surfaces\nexport {\n  AGENT_WEB_CRAWLER_CATEGORIES,\n  AGENT_WEB_CRAWLER_USER_AGENTS,\n  DEFAULT_AGENT_WEB_CRAWLER_POLICY,\n  absoluteUrl,\n  agentWebConfigFromPackageJson,\n  buildAgentWebStaticFiles,\n  buildBaseJsonLd,\n  buildLlmsFullTxt,\n  buildLlmsTxt,\n  buildMarkdownResponseHeaders,\n  buildPageJsonLd,\n  buildRobotsTxt,\n  buildSitemapXml,\n  deriveAgentWebPublicRoutes,\n  estimateMarkdownTokens,\n  markdownFilePathForPage,\n  markdownUrlForPage,\n  normalizeAgentWebConfig,\n  pathPatternMatches,\n  resolveAgentWebCrawlerPolicy,\n  type AgentWebConfig,\n  type AgentWebCrawlerCategory,\n  type AgentWebCrawlerDecision,\n  type AgentWebCrawlerOverrides,\n  type AgentWebCrawlerPolicy,\n  type AgentWebInputConfig,\n  type AgentWebPage,\n  type AgentWebStaticFile,\n  type BuildAgentWebStaticFilesOptions,\n  type DeriveAgentWebPublicRoutesOptions,\n  type MarkdownResponseHeadersOptions,\n} from \"./agent-web/index.js\";\n\n// Token usage tracking\nexport {\n  recordUsage,\n  getUsageSummary,\n  getUserUsageCents,\n  calculateCost,\n  usageBillingForEngine,\n  builderCreditsFromCostCents,\n  BUILDER_AGENT_CREDIT_MARGIN_MULTIPLIER,\n  BUILDER_AGENT_CREDITS_PER_USD,\n  BUILDER_CREDIT_USAGE_BILLING,\n  USD_USAGE_BILLING,\n  type UsageRecord,\n  type UsageCostSource,\n  type UsageCostAggregate,\n  type UsageSummary,\n  type UsageBillingMode,\n  type UsageBillingUnit,\n  type UsageBucket,\n  type DailyBucket,\n  type UsageRecentEntry,\n} from \"./usage/store.js\";\n\n// Workspace-scoped third-party connection metadata\nexport {\n  deleteWorkspaceConnection,\n  getWorkspaceConnectionAppAccess,\n  getWorkspaceConnection,\n  getWorkspaceConnectionGrant,\n  listWorkspaceConnectionProviderCatalogForApp,\n  listWorkspaceConnectionGrants,\n  listWorkspaceConnections,\n  resolveWorkspaceConnectionCredentialForApp,\n  resolveWorkspaceConnectionCredentialsForApp,\n  revokeWorkspaceConnectionGrant,\n  serializeWorkspaceConnectionGrant,\n  serializeWorkspaceConnection,\n  summarizeWorkspaceConnectionProviderForApp,\n  summarizeWorkspaceConnectionProviderReadiness,\n  upsertWorkspaceConnectionGrant,\n  upsertWorkspaceConnection,\n  type ListWorkspaceConnectionProviderCatalogForAppOptions,\n  type ListWorkspaceConnectionGrantsOptions,\n  type ListWorkspaceConnectionsOptions,\n  type ResolveWorkspaceConnectionCredentialForAppOptions,\n  type ResolveWorkspaceConnectionCredentialsForAppOptions,\n  type SerializedWorkspaceConnectionGrant,\n  type SerializedWorkspaceConnection,\n  type SummarizeWorkspaceConnectionProviderForAppOptions,\n  type SummarizeWorkspaceConnectionProviderReadinessOptions,\n  type UpsertWorkspaceConnectionGrantInput,\n  type UpsertWorkspaceConnectionInput,\n  type WorkspaceConnectionAppAccess,\n  type WorkspaceConnectionAppAccessMode,\n  type WorkspaceConnection,\n  type WorkspaceConnectionCredentialBackend,\n  type WorkspaceConnectionCredentialProvenance,\n  type WorkspaceConnectionCredentialRef,\n  type WorkspaceConnectionCredentialResolution,\n  type WorkspaceConnectionCredentialResolutionCheck,\n  type WorkspaceConnectionCredentialResolutionStatus,\n  type WorkspaceConnectionCredentialsResolution,\n  type WorkspaceConnectionExplicitGrantSummary,\n  type WorkspaceConnectionForAppSummary,\n  type WorkspaceConnectionGrant,\n  type WorkspaceConnectionGrantAvailability,\n  type WorkspaceConnectionGrantState,\n  type WorkspaceConnectionProviderAppSummary,\n  type WorkspaceConnectionProviderLike,\n  type WorkspaceConnectionProviderCatalogForApp,\n  type WorkspaceConnectionProviderCatalogForAppItem,\n  type WorkspaceConnectionProviderReadiness,\n  type WorkspaceConnectionProviderReadinessStatus,\n  type WorkspaceConnectionPublicCredentialRef,\n  type WorkspaceConnectionStatus,\n  workspaceConnectionIsAvailableToApp,\n  registerWorkspaceConnectionLifecycleListener,\n  type WorkspaceConnectionLifecycleEvent,\n  type WorkspaceConnectionLifecycleListener,\n} from \"./workspace-connections/index.js\";\n\n// Reusable workspace connection provider catalog\nexport {\n  PROVIDER_READERS,\n  ProviderReaderRuntimeError,\n  WORKSPACE_CONNECTION_PROVIDERS,\n  createProviderReaderRuntime,\n  defineProviderReader,\n  defineProviderReaderImplementation,\n  defineWorkspaceConnectionProvider,\n  getProviderReader,\n  getWorkspaceConnectionProvider,\n  isWorkspaceConnectionProviderId,\n  listProviderReaders,\n  listWorkspaceConnectionProviders,\n  listWorkspaceConnectionProvidersForCapability,\n  listWorkspaceConnectionProvidersForTemplate,\n  providerReaderSupports,\n  workspaceConnectionProviderSupports,\n  type ListWorkspaceConnectionProvidersOptions,\n  type ListProviderReadersOptions,\n  type ProviderReaderCapability,\n  type ProviderReaderCredentialRequirement,\n  type ProviderReaderDefinition,\n  type ProviderReaderImplementationStatus,\n  type ProviderReaderOperation,\n  type ProviderReaderOperationDescriptor,\n  type ProviderReaderOperationParameter,\n  type ProviderReaderRequest,\n  type ProviderReaderRuntime,\n  type ProviderReaderRuntimeConnection,\n  type ProviderReaderRuntimeConnectionResolverOptions,\n  type ProviderReaderRuntimeContext,\n  type ProviderReaderRuntimeCredentialsResolverOptions,\n  type ProviderReaderRuntimeErrorCode,\n  type ProviderReaderRuntimeHandler,\n  type ProviderReaderRuntimeImplementation,\n  type ProviderReaderRuntimeItem,\n  type ProviderReaderRuntimeOptions,\n  type ProviderReaderRuntimeResponse,\n  type WorkspaceConnectionCapability,\n  type WorkspaceConnectionCredentialKey,\n  type WorkspaceConnectionProvider,\n  type WorkspaceConnectionProviderId,\n  type WorkspaceConnectionTemplateUse,\n} from \"./connections/index.js\";\n\n// Scripts\nexport {\n  runScript,\n  loadEnv,\n  parseArgs,\n  camelCaseArgs,\n  isValidPath,\n  isValidProjectPath,\n  ensureDir,\n  fail,\n} from \"./scripts/index.js\";\n\n// Secrets registry — import from \"@agent-native/core/secrets\" when possible\n// (the subpath keeps the top-level entry point lean), but re-export the\n// public API here for convenience.\nexport {\n  registerRequiredSecret,\n  listRequiredSecrets,\n  getRequiredSecret,\n  readAppSecret,\n  writeAppSecret,\n  deleteAppSecret,\n  type RegisteredSecret,\n  type SecretScope,\n  type SecretKind,\n  type SecretValidator,\n  type SecretRef,\n} from \"./secrets/index.js\";\n\nexport * from \"./history/index.js\";\nexport * from \"./review/index.js\";\nexport * from \"./org-team/index.js\";\nexport * from \"./navigation/index.js\";\nexport * from \"./command-navigation/index.js\";\nexport * from \"./search/index.js\";\nexport * from \"./embeddings/index.js\";\nexport {\n  registerWorkspaceConnectionOnboardingStep,\n  type RegisterWorkspaceConnectionOnboardingStepOptions,\n} from \"./setup-connections/index.js\";\n"]}

package/dist/notifications/routes.d.ts

@@ -11,24 +11,24 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
+    error?: undefined;
     count: number;
     updated?: undefined;
     ok?: undefined;
-    error?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated: number;
     ok?: undefined;
-    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
     error: string;
     ok?: undefined;
 } | {
+    error?: undefined;
     count?: undefined;
     updated?: undefined;
     ok: boolean;
-    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/progress/routes.d.ts

@@ -15,7 +15,7 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;
 //# sourceMappingURL=routes.d.ts.map

package/dist/resources/handlers.d.ts

@@ -49,8 +49,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/search/index.d.ts

@@ -0,0 +1,88 @@
+import type { DbExec } from "../db/index.js";
+export declare const DEFAULT_SEARCH_NAMESPACE = "creative_context";
+export declare const PGVECTOR_REQUIRED_MESSAGE = "Vector search requires Postgres with the pgvector extension in the configured DATABASE_URL database.";
+export interface SearchNamespaceIdentifiers {
+    namespace: string;
+    ftsTable: string;
+    ftsIndex: string;
+    ftsAudienceIndex: string;
+    vectorTable: string;
+    vectorIndex: string;
+    vectorAudienceIndex: string;
+}
+export interface PgVectorHit {
+    vectorKey: string;
+    embeddingSetId: string;
+    score: number;
+}
+export interface PostgresFtsHit {
+    chunkId: string;
+    itemVersionId: string;
+    score: number;
+}
+export interface RankedCandidate<T> {
+    key: string;
+    value: T;
+    score: number;
+    reason?: string;
+}
+export interface FusedCandidate<T> extends RankedCandidate<T> {
+    laneRanks: Record<string, number>;
+    reasons: string[];
+}
+type PgVectorOptions = boolean | {
+    namespace?: string;
+    postgres?: boolean;
+    /** The caller has already provisioned this namespace and dimension. */
+    indexInitialized?: boolean;
+};
+export declare function searchNamespaceIdentifiers(namespace?: string, dimensions?: number): SearchNamespaceIdentifiers;
+export declare function assertPgVectorAvailable(postgres?: boolean): void;
+export declare function ensurePgVectorIndex(db: DbExec, dimensions: number, options?: PgVectorOptions): Promise<void>;
+export declare function upsertPgVector(db: DbExec, input: {
+    vectorKey: string;
+    embeddingSetId: string;
+    dimensions: number;
+    vector: readonly number[];
+    audienceIds?: readonly string[];
+    updatedAt?: string;
+}, options?: PgVectorOptions): Promise<void>;
+export declare function deletePgVectors(db: DbExec, input: {
+    dimensions: number;
+    vectorKeys: readonly string[];
+    namespace?: string;
+}, postgres?: boolean): Promise<number>;
+export declare function queryPgVectorIndex(db: DbExec, input: {
+    embeddingSetId: string;
+    dimensions: number;
+    vector: readonly number[];
+    limit?: number;
+    allowedVectorKeys?: readonly string[];
+    allowedAudienceIds?: readonly string[];
+    namespace?: string;
+}, postgres?: boolean): Promise<PgVectorHit[]>;
+export declare function ensurePostgresFts(db: DbExec, namespace?: string): Promise<boolean>;
+export declare function upsertPostgresFtsDocument(db: DbExec, input: {
+    chunkId: string;
+    itemVersionId: string;
+    title: string;
+    summary?: string | null;
+    body: string;
+    audienceIds?: readonly string[];
+    updatedAt?: string;
+    namespace?: string;
+}): Promise<boolean>;
+export declare function queryPostgresFts(db: DbExec, input: {
+    query: string;
+    allowedChunkIds?: readonly string[];
+    allowedAudienceIds?: readonly string[];
+    limit?: number;
+    namespace?: string;
+}): Promise<PostgresFtsHit[]>;
+export declare function deletePostgresFtsDocuments(db: DbExec, chunkIds: readonly string[], namespace?: string): Promise<number>;
+export declare function reciprocalRankFusion<T>(lanes: Readonly<Record<string, readonly RankedCandidate<T>[]>>, options?: {
+    rankConstant?: number;
+    limit?: number;
+}): FusedCandidate<T>[];
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

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

package/dist/search/index.js

@@ -0,0 +1,267 @@
+import { isPostgres } from "../db/index.js";
+export const DEFAULT_SEARCH_NAMESPACE = "creative_context";
+export const PGVECTOR_REQUIRED_MESSAGE = "Vector search requires Postgres with the pgvector extension in the configured DATABASE_URL database.";
+function pgVectorOptions(options) {
+    return typeof options === "boolean" ? { postgres: options } : (options ?? {});
+}
+export function searchNamespaceIdentifiers(namespace = DEFAULT_SEARCH_NAMESPACE, dimensions) {
+    if (!/^[a-z][a-z0-9_]{0,62}$/.test(namespace)) {
+        throw new Error("Search namespace must start with a lowercase letter and contain only lowercase letters, numbers, and underscores.");
+    }
+    const suffix = dimensions === undefined ? "" : `_${checkedDimensions(dimensions)}`;
+    return {
+        namespace,
+        ftsTable: `${namespace}_search_documents`,
+        ftsIndex: `${namespace}_search_documents_gin`,
+        ftsAudienceIndex: `${namespace}_search_documents_audience_gin`,
+        vectorTable: `${namespace}_vectors${suffix}`,
+        vectorIndex: `${namespace}_vectors${suffix}_hnsw`,
+        vectorAudienceIndex: `${namespace}_vectors${suffix}_audience_gin`,
+    };
+}
+function checkedDimensions(value) {
+    if (!Number.isInteger(value) || value < 1 || value > 16_000) {
+        throw new Error("Embedding dimensions must be an integer from 1 to 16000.");
+    }
+    return value;
+}
+function vectorLiteral(vector, dimensions) {
+    if (vector.length !== dimensions) {
+        throw new Error(`Embedding has ${vector.length} values; expected ${dimensions}.`);
+    }
+    for (const value of vector) {
+        if (!Number.isFinite(value)) {
+            throw new Error("Embedding vectors may contain only finite numbers.");
+        }
+    }
+    return `[${vector.join(",")}]`;
+}
+function audienceClause(audienceIds, column = "audience_ids") {
+    if (!audienceIds?.length)
+        return { sql: "", args: [] };
+    return {
+        sql: ` AND ${column} && ARRAY[${audienceIds.map(() => "?").join(", ")}]::TEXT[]`,
+        args: [...audienceIds],
+    };
+}
+export function assertPgVectorAvailable(postgres = isPostgres()) {
+    if (!postgres)
+        throw new Error(PGVECTOR_REQUIRED_MESSAGE);
+}
+export async function ensurePgVectorIndex(db, dimensions, options) {
+    const resolved = pgVectorOptions(options);
+    const names = searchNamespaceIdentifiers(resolved.namespace, dimensions);
+    assertPgVectorAvailable(resolved.postgres);
+    try {
+        await db.execute("CREATE EXTENSION IF NOT EXISTS vector");
+        await db.execute(`
+      CREATE TABLE IF NOT EXISTS ${names.vectorTable} (
+        vector_key TEXT PRIMARY KEY,
+        embedding_set_id TEXT NOT NULL,
+        audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],
+        embedding vector(${checkedDimensions(dimensions)}) NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    `);
+        await db.execute(`ALTER TABLE ${names.vectorTable} ADD COLUMN IF NOT EXISTS audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[]`);
+        await db.execute(`CREATE INDEX IF NOT EXISTS ${names.vectorIndex} ON ${names.vectorTable} USING hnsw (embedding vector_cosine_ops)`);
+        await db.execute(`CREATE INDEX IF NOT EXISTS ${names.vectorAudienceIndex} ON ${names.vectorTable} USING GIN (audience_ids)`);
+    }
+    catch (error) {
+        throw new Error(PGVECTOR_REQUIRED_MESSAGE, { cause: error });
+    }
+}
+export async function upsertPgVector(db, input, options) {
+    const resolved = pgVectorOptions(options);
+    const names = searchNamespaceIdentifiers(resolved.namespace, input.dimensions);
+    assertPgVectorAvailable(resolved.postgres);
+    if (!resolved.indexInitialized) {
+        await ensurePgVectorIndex(db, input.dimensions, resolved);
+    }
+    await db.execute({
+        sql: `
+      INSERT INTO ${names.vectorTable} (vector_key, embedding_set_id, audience_ids, embedding, updated_at)
+      VALUES (?, ?, ARRAY[${(input.audienceIds ?? []).map(() => "?").join(", ")}]::TEXT[], ?::vector, ?)
+      ON CONFLICT (vector_key) DO UPDATE SET
+        embedding_set_id = EXCLUDED.embedding_set_id,
+        audience_ids = EXCLUDED.audience_ids,
+        embedding = EXCLUDED.embedding,
+        updated_at = EXCLUDED.updated_at
+    `,
+        args: [
+            input.vectorKey,
+            input.embeddingSetId,
+            ...(input.audienceIds ?? []),
+            vectorLiteral(input.vector, input.dimensions),
+            input.updatedAt ?? new Date().toISOString(),
+        ],
+    });
+}
+export async function deletePgVectors(db, input, postgres = isPostgres()) {
+    const names = searchNamespaceIdentifiers(input.namespace, input.dimensions);
+    assertPgVectorAvailable(postgres);
+    if (!input.vectorKeys.length)
+        return 0;
+    const result = await db.execute({
+        sql: `DELETE FROM ${names.vectorTable} WHERE vector_key IN (${input.vectorKeys.map(() => "?").join(", ")})`,
+        args: [...input.vectorKeys],
+    });
+    return result.rowsAffected;
+}
+export async function queryPgVectorIndex(db, input, postgres = isPostgres()) {
+    const names = searchNamespaceIdentifiers(input.namespace, input.dimensions);
+    assertPgVectorAvailable(postgres);
+    if (input.allowedVectorKeys?.length === 0 ||
+        input.allowedAudienceIds?.length === 0)
+        return [];
+    const limit = Math.max(1, Math.min(200, Math.floor(input.limit ?? 40)));
+    const literal = vectorLiteral(input.vector, input.dimensions);
+    const keySql = input.allowedVectorKeys?.length
+        ? ` AND vector_key IN (${input.allowedVectorKeys.map(() => "?").join(", ")})`
+        : "";
+    const audiences = audienceClause(input.allowedAudienceIds);
+    try {
+        await db.execute("SET hnsw.iterative_scan = strict_order");
+    }
+    catch { }
+    const result = await db.execute({
+        sql: `
+      SELECT vector_key, embedding_set_id, 1 - (embedding <=> ?::vector) AS score
+      FROM ${names.vectorTable}
+      WHERE embedding_set_id = ?${keySql}${audiences.sql}
+      ORDER BY embedding <=> ?::vector
+      LIMIT ?
+    `,
+        args: [
+            literal,
+            input.embeddingSetId,
+            ...(input.allowedVectorKeys ?? []),
+            ...audiences.args,
+            literal,
+            limit,
+        ],
+    });
+    return result.rows.map((row) => ({
+        vectorKey: String(row.vector_key),
+        embeddingSetId: String(row.embedding_set_id),
+        score: Number(row.score),
+    }));
+}
+export async function ensurePostgresFts(db, namespace = DEFAULT_SEARCH_NAMESPACE) {
+    const names = searchNamespaceIdentifiers(namespace);
+    if (!isPostgres())
+        return false;
+    await db.execute(`
+    CREATE TABLE IF NOT EXISTS ${names.ftsTable} (
+      chunk_id TEXT PRIMARY KEY,
+      item_version_id TEXT NOT NULL,
+      audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],
+      document TSVECTOR NOT NULL,
+      updated_at TEXT NOT NULL
+    )
+  `);
+    await db.execute(`ALTER TABLE ${names.ftsTable} ADD COLUMN IF NOT EXISTS audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[]`);
+    await db.execute(`CREATE INDEX IF NOT EXISTS ${names.ftsIndex} ON ${names.ftsTable} USING GIN (document)`);
+    await db.execute(`CREATE INDEX IF NOT EXISTS ${names.ftsAudienceIndex} ON ${names.ftsTable} USING GIN (audience_ids)`);
+    return true;
+}
+export async function upsertPostgresFtsDocument(db, input) {
+    const namespace = input.namespace ?? DEFAULT_SEARCH_NAMESPACE;
+    if (!(await ensurePostgresFts(db, namespace)))
+        return false;
+    const names = searchNamespaceIdentifiers(namespace);
+    await db.execute({
+        sql: `
+      INSERT INTO ${names.ftsTable} (chunk_id, item_version_id, audience_ids, document, updated_at)
+      VALUES (?, ?, ARRAY[${(input.audienceIds ?? []).map(() => "?").join(", ")}]::TEXT[], setweight(to_tsvector('simple', ?), 'A') || setweight(to_tsvector('simple', ?), 'B') || setweight(to_tsvector('simple', ?), 'C'), ?)
+      ON CONFLICT (chunk_id) DO UPDATE SET item_version_id = EXCLUDED.item_version_id, audience_ids = EXCLUDED.audience_ids, document = EXCLUDED.document, updated_at = EXCLUDED.updated_at
+    `,
+        args: [
+            input.chunkId,
+            input.itemVersionId,
+            ...(input.audienceIds ?? []),
+            input.title,
+            input.summary ?? "",
+            input.body,
+            input.updatedAt ?? new Date().toISOString(),
+        ],
+    });
+    return true;
+}
+export async function queryPostgresFts(db, input) {
+    const namespace = input.namespace ?? DEFAULT_SEARCH_NAMESPACE;
+    const names = searchNamespaceIdentifiers(namespace);
+    if (!isPostgres() ||
+        input.allowedChunkIds?.length === 0 ||
+        input.allowedAudienceIds?.length === 0)
+        return [];
+    const keys = input.allowedChunkIds?.length
+        ? `chunk_id IN (${input.allowedChunkIds.map(() => "?").join(", ")}) AND`
+        : "";
+    const audiences = audienceClause(input.allowedAudienceIds);
+    const limit = Math.max(1, Math.min(200, Math.floor(input.limit ?? 40)));
+    try {
+        const result = await db.execute({
+            sql: `SELECT chunk_id, item_version_id, ts_rank_cd(document, websearch_to_tsquery('simple', ?)) AS score FROM ${names.ftsTable} WHERE ${keys} document @@ websearch_to_tsquery('simple', ?)${audiences.sql} ORDER BY score DESC, chunk_id ASC LIMIT ?`,
+            args: [
+                input.query,
+                ...(input.allowedChunkIds ?? []),
+                input.query,
+                ...audiences.args,
+                limit,
+            ],
+        });
+        return result.rows.map((row) => ({
+            chunkId: String(row.chunk_id),
+            itemVersionId: String(row.item_version_id),
+            score: Number(row.score),
+        }));
+    }
+    catch (error) {
+        // A read can race the first write for a tenant-specific namespace. Writers
+        // provision it; an absent lane simply contributes no candidates.
+        if (isMissingPostgresRelation(error))
+            return [];
+        throw error;
+    }
+}
+function isMissingPostgresRelation(error) {
+    if (!error || typeof error !== "object")
+        return false;
+    return error.code === "42P01";
+}
+export async function deletePostgresFtsDocuments(db, chunkIds, namespace = DEFAULT_SEARCH_NAMESPACE) {
+    const names = searchNamespaceIdentifiers(namespace);
+    if (!isPostgres() || !chunkIds.length)
+        return 0;
+    await ensurePostgresFts(db, namespace);
+    const result = await db.execute({
+        sql: `DELETE FROM ${names.ftsTable} WHERE chunk_id IN (${chunkIds.map(() => "?").join(", ")})`,
+        args: [...chunkIds],
+    });
+    return result.rowsAffected;
+}
+export function reciprocalRankFusion(lanes, options = {}) {
+    const rankConstant = Math.max(1, options.rankConstant ?? 60);
+    const fused = new Map();
+    for (const [lane, candidates] of Object.entries(lanes)) {
+        candidates.forEach((candidate, index) => {
+            const rank = index + 1;
+            const current = fused.get(candidate.key) ?? {
+                ...candidate,
+                score: 0,
+                laneRanks: {},
+                reasons: [],
+            };
+            current.score += 1 / (rankConstant + rank);
+            current.laneRanks[lane] = rank;
+            if (candidate.reason && !current.reasons.includes(candidate.reason))
+                current.reasons.push(candidate.reason);
+            fused.set(candidate.key, current);
+        });
+    }
+    return [...fused.values()]
+        .sort((a, b) => b.score - a.score || a.key.localeCompare(b.key))
+        .slice(0, Math.max(1, options.limit ?? 40));
+}
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DbExec } from \"../db/index.js\";\nimport { isPostgres } from \"../db/index.js\";\n\nexport const DEFAULT_SEARCH_NAMESPACE = \"creative_context\";\nexport const PGVECTOR_REQUIRED_MESSAGE =\n  \"Vector search requires Postgres with the pgvector extension in the configured DATABASE_URL database.\";\n\nexport interface SearchNamespaceIdentifiers {\n  namespace: string;\n  ftsTable: string;\n  ftsIndex: string;\n  ftsAudienceIndex: string;\n  vectorTable: string;\n  vectorIndex: string;\n  vectorAudienceIndex: string;\n}\n\nexport interface PgVectorHit {\n  vectorKey: string;\n  embeddingSetId: string;\n  score: number;\n}\n\nexport interface PostgresFtsHit {\n  chunkId: string;\n  itemVersionId: string;\n  score: number;\n}\n\nexport interface RankedCandidate<T> {\n  key: string;\n  value: T;\n  score: number;\n  reason?: string;\n}\n\nexport interface FusedCandidate<T> extends RankedCandidate<T> {\n  laneRanks: Record<string, number>;\n  reasons: string[];\n}\n\ntype PgVectorOptions =\n  | boolean\n  | {\n      namespace?: string;\n      postgres?: boolean;\n      /** The caller has already provisioned this namespace and dimension. */\n      indexInitialized?: boolean;\n    };\n\nfunction pgVectorOptions(options: PgVectorOptions | undefined) {\n  return typeof options === \"boolean\" ? { postgres: options } : (options ?? {});\n}\n\nexport function searchNamespaceIdentifiers(\n  namespace = DEFAULT_SEARCH_NAMESPACE,\n  dimensions?: number,\n): SearchNamespaceIdentifiers {\n  if (!/^[a-z][a-z0-9_]{0,62}$/.test(namespace)) {\n    throw new Error(\n      \"Search namespace must start with a lowercase letter and contain only lowercase letters, numbers, and underscores.\",\n    );\n  }\n  const suffix =\n    dimensions === undefined ? \"\" : `_${checkedDimensions(dimensions)}`;\n  return {\n    namespace,\n    ftsTable: `${namespace}_search_documents`,\n    ftsIndex: `${namespace}_search_documents_gin`,\n    ftsAudienceIndex: `${namespace}_search_documents_audience_gin`,\n    vectorTable: `${namespace}_vectors${suffix}`,\n    vectorIndex: `${namespace}_vectors${suffix}_hnsw`,\n    vectorAudienceIndex: `${namespace}_vectors${suffix}_audience_gin`,\n  };\n}\n\nfunction checkedDimensions(value: number): number {\n  if (!Number.isInteger(value) || value < 1 || value > 16_000) {\n    throw new Error(\"Embedding dimensions must be an integer from 1 to 16000.\");\n  }\n  return value;\n}\n\nfunction vectorLiteral(vector: readonly number[], dimensions: number): string {\n  if (vector.length !== dimensions) {\n    throw new Error(\n      `Embedding has ${vector.length} values; expected ${dimensions}.`,\n    );\n  }\n  for (const value of vector) {\n    if (!Number.isFinite(value)) {\n      throw new Error(\"Embedding vectors may contain only finite numbers.\");\n    }\n  }\n  return `[${vector.join(\",\")}]`;\n}\n\nfunction audienceClause(\n  audienceIds: readonly string[] | undefined,\n  column = \"audience_ids\",\n): { sql: string; args: string[] } {\n  if (!audienceIds?.length) return { sql: \"\", args: [] };\n  return {\n    sql: ` AND ${column} && ARRAY[${audienceIds.map(() => \"?\").join(\", \")}]::TEXT[]`,\n    args: [...audienceIds],\n  };\n}\n\nexport function assertPgVectorAvailable(postgres = isPostgres()): void {\n  if (!postgres) throw new Error(PGVECTOR_REQUIRED_MESSAGE);\n}\n\nexport async function ensurePgVectorIndex(\n  db: DbExec,\n  dimensions: number,\n  options?: PgVectorOptions,\n): Promise<void> {\n  const resolved = pgVectorOptions(options);\n  const names = searchNamespaceIdentifiers(resolved.namespace, dimensions);\n  assertPgVectorAvailable(resolved.postgres);\n  try {\n    await db.execute(\"CREATE EXTENSION IF NOT EXISTS vector\");\n    await db.execute(`\n      CREATE TABLE IF NOT EXISTS ${names.vectorTable} (\n        vector_key TEXT PRIMARY KEY,\n        embedding_set_id TEXT NOT NULL,\n        audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],\n        embedding vector(${checkedDimensions(dimensions)}) NOT NULL,\n        updated_at TEXT NOT NULL\n      )\n    `);\n    await db.execute(\n      `ALTER TABLE ${names.vectorTable} ADD COLUMN IF NOT EXISTS audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[]`,\n    );\n    await db.execute(\n      `CREATE INDEX IF NOT EXISTS ${names.vectorIndex} ON ${names.vectorTable} USING hnsw (embedding vector_cosine_ops)`,\n    );\n    await db.execute(\n      `CREATE INDEX IF NOT EXISTS ${names.vectorAudienceIndex} ON ${names.vectorTable} USING GIN (audience_ids)`,\n    );\n  } catch (error) {\n    throw new Error(PGVECTOR_REQUIRED_MESSAGE, { cause: error });\n  }\n}\n\nexport async function upsertPgVector(\n  db: DbExec,\n  input: {\n    vectorKey: string;\n    embeddingSetId: string;\n    dimensions: number;\n    vector: readonly number[];\n    audienceIds?: readonly string[];\n    updatedAt?: string;\n  },\n  options?: PgVectorOptions,\n): Promise<void> {\n  const resolved = pgVectorOptions(options);\n  const names = searchNamespaceIdentifiers(\n    resolved.namespace,\n    input.dimensions,\n  );\n  assertPgVectorAvailable(resolved.postgres);\n  if (!resolved.indexInitialized) {\n    await ensurePgVectorIndex(db, input.dimensions, resolved);\n  }\n  await db.execute({\n    sql: `\n      INSERT INTO ${names.vectorTable} (vector_key, embedding_set_id, audience_ids, embedding, updated_at)\n      VALUES (?, ?, ARRAY[${(input.audienceIds ?? []).map(() => \"?\").join(\", \")}]::TEXT[], ?::vector, ?)\n      ON CONFLICT (vector_key) DO UPDATE SET\n        embedding_set_id = EXCLUDED.embedding_set_id,\n        audience_ids = EXCLUDED.audience_ids,\n        embedding = EXCLUDED.embedding,\n        updated_at = EXCLUDED.updated_at\n    `,\n    args: [\n      input.vectorKey,\n      input.embeddingSetId,\n      ...(input.audienceIds ?? []),\n      vectorLiteral(input.vector, input.dimensions),\n      input.updatedAt ?? new Date().toISOString(),\n    ],\n  });\n}\n\nexport async function deletePgVectors(\n  db: DbExec,\n  input: {\n    dimensions: number;\n    vectorKeys: readonly string[];\n    namespace?: string;\n  },\n  postgres = isPostgres(),\n): Promise<number> {\n  const names = searchNamespaceIdentifiers(input.namespace, input.dimensions);\n  assertPgVectorAvailable(postgres);\n  if (!input.vectorKeys.length) return 0;\n  const result = await db.execute({\n    sql: `DELETE FROM ${names.vectorTable} WHERE vector_key IN (${input.vectorKeys.map(() => \"?\").join(\", \")})`,\n    args: [...input.vectorKeys],\n  });\n  return result.rowsAffected;\n}\n\nexport async function queryPgVectorIndex(\n  db: DbExec,\n  input: {\n    embeddingSetId: string;\n    dimensions: number;\n    vector: readonly number[];\n    limit?: number;\n    allowedVectorKeys?: readonly string[];\n    allowedAudienceIds?: readonly string[];\n    namespace?: string;\n  },\n  postgres = isPostgres(),\n): Promise<PgVectorHit[]> {\n  const names = searchNamespaceIdentifiers(input.namespace, input.dimensions);\n  assertPgVectorAvailable(postgres);\n  if (\n    input.allowedVectorKeys?.length === 0 ||\n    input.allowedAudienceIds?.length === 0\n  )\n    return [];\n  const limit = Math.max(1, Math.min(200, Math.floor(input.limit ?? 40)));\n  const literal = vectorLiteral(input.vector, input.dimensions);\n  const keySql = input.allowedVectorKeys?.length\n    ? ` AND vector_key IN (${input.allowedVectorKeys.map(() => \"?\").join(\", \")})`\n    : \"\";\n  const audiences = audienceClause(input.allowedAudienceIds);\n  try {\n    await db.execute(\"SET hnsw.iterative_scan = strict_order\");\n  } catch {}\n  const result = await db.execute({\n    sql: `\n      SELECT vector_key, embedding_set_id, 1 - (embedding <=> ?::vector) AS score\n      FROM ${names.vectorTable}\n      WHERE embedding_set_id = ?${keySql}${audiences.sql}\n      ORDER BY embedding <=> ?::vector\n      LIMIT ?\n    `,\n    args: [\n      literal,\n      input.embeddingSetId,\n      ...(input.allowedVectorKeys ?? []),\n      ...audiences.args,\n      literal,\n      limit,\n    ],\n  });\n  return result.rows.map((row) => ({\n    vectorKey: String(row.vector_key),\n    embeddingSetId: String(row.embedding_set_id),\n    score: Number(row.score),\n  }));\n}\n\nexport async function ensurePostgresFts(\n  db: DbExec,\n  namespace = DEFAULT_SEARCH_NAMESPACE,\n): Promise<boolean> {\n  const names = searchNamespaceIdentifiers(namespace);\n  if (!isPostgres()) return false;\n  await db.execute(`\n    CREATE TABLE IF NOT EXISTS ${names.ftsTable} (\n      chunk_id TEXT PRIMARY KEY,\n      item_version_id TEXT NOT NULL,\n      audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[],\n      document TSVECTOR NOT NULL,\n      updated_at TEXT NOT NULL\n    )\n  `);\n  await db.execute(\n    `ALTER TABLE ${names.ftsTable} ADD COLUMN IF NOT EXISTS audience_ids TEXT[] NOT NULL DEFAULT ARRAY[]::TEXT[]`,\n  );\n  await db.execute(\n    `CREATE INDEX IF NOT EXISTS ${names.ftsIndex} ON ${names.ftsTable} USING GIN (document)`,\n  );\n  await db.execute(\n    `CREATE INDEX IF NOT EXISTS ${names.ftsAudienceIndex} ON ${names.ftsTable} USING GIN (audience_ids)`,\n  );\n  return true;\n}\n\nexport async function upsertPostgresFtsDocument(\n  db: DbExec,\n  input: {\n    chunkId: string;\n    itemVersionId: string;\n    title: string;\n    summary?: string | null;\n    body: string;\n    audienceIds?: readonly string[];\n    updatedAt?: string;\n    namespace?: string;\n  },\n): Promise<boolean> {\n  const namespace = input.namespace ?? DEFAULT_SEARCH_NAMESPACE;\n  if (!(await ensurePostgresFts(db, namespace))) return false;\n  const names = searchNamespaceIdentifiers(namespace);\n  await db.execute({\n    sql: `\n      INSERT INTO ${names.ftsTable} (chunk_id, item_version_id, audience_ids, document, updated_at)\n      VALUES (?, ?, ARRAY[${(input.audienceIds ?? []).map(() => \"?\").join(\", \")}]::TEXT[], setweight(to_tsvector('simple', ?), 'A') || setweight(to_tsvector('simple', ?), 'B') || setweight(to_tsvector('simple', ?), 'C'), ?)\n      ON CONFLICT (chunk_id) DO UPDATE SET item_version_id = EXCLUDED.item_version_id, audience_ids = EXCLUDED.audience_ids, document = EXCLUDED.document, updated_at = EXCLUDED.updated_at\n    `,\n    args: [\n      input.chunkId,\n      input.itemVersionId,\n      ...(input.audienceIds ?? []),\n      input.title,\n      input.summary ?? \"\",\n      input.body,\n      input.updatedAt ?? new Date().toISOString(),\n    ],\n  });\n  return true;\n}\n\nexport async function queryPostgresFts(\n  db: DbExec,\n  input: {\n    query: string;\n    allowedChunkIds?: readonly string[];\n    allowedAudienceIds?: readonly string[];\n    limit?: number;\n    namespace?: string;\n  },\n): Promise<PostgresFtsHit[]> {\n  const namespace = input.namespace ?? DEFAULT_SEARCH_NAMESPACE;\n  const names = searchNamespaceIdentifiers(namespace);\n  if (\n    !isPostgres() ||\n    input.allowedChunkIds?.length === 0 ||\n    input.allowedAudienceIds?.length === 0\n  )\n    return [];\n  const keys = input.allowedChunkIds?.length\n    ? `chunk_id IN (${input.allowedChunkIds.map(() => \"?\").join(\", \")}) AND`\n    : \"\";\n  const audiences = audienceClause(input.allowedAudienceIds);\n  const limit = Math.max(1, Math.min(200, Math.floor(input.limit ?? 40)));\n  try {\n    const result = await db.execute({\n      sql: `SELECT chunk_id, item_version_id, ts_rank_cd(document, websearch_to_tsquery('simple', ?)) AS score FROM ${names.ftsTable} WHERE ${keys} document @@ websearch_to_tsquery('simple', ?)${audiences.sql} ORDER BY score DESC, chunk_id ASC LIMIT ?`,\n      args: [\n        input.query,\n        ...(input.allowedChunkIds ?? []),\n        input.query,\n        ...audiences.args,\n        limit,\n      ],\n    });\n    return result.rows.map((row) => ({\n      chunkId: String(row.chunk_id),\n      itemVersionId: String(row.item_version_id),\n      score: Number(row.score),\n    }));\n  } catch (error) {\n    // A read can race the first write for a tenant-specific namespace. Writers\n    // provision it; an absent lane simply contributes no candidates.\n    if (isMissingPostgresRelation(error)) return [];\n    throw error;\n  }\n}\n\nfunction isMissingPostgresRelation(error: unknown): boolean {\n  if (!error || typeof error !== \"object\") return false;\n  return (error as { code?: unknown }).code === \"42P01\";\n}\n\nexport async function deletePostgresFtsDocuments(\n  db: DbExec,\n  chunkIds: readonly string[],\n  namespace = DEFAULT_SEARCH_NAMESPACE,\n): Promise<number> {\n  const names = searchNamespaceIdentifiers(namespace);\n  if (!isPostgres() || !chunkIds.length) return 0;\n  await ensurePostgresFts(db, namespace);\n  const result = await db.execute({\n    sql: `DELETE FROM ${names.ftsTable} WHERE chunk_id IN (${chunkIds.map(() => \"?\").join(\", \")})`,\n    args: [...chunkIds],\n  });\n  return result.rowsAffected;\n}\n\nexport function reciprocalRankFusion<T>(\n  lanes: Readonly<Record<string, readonly RankedCandidate<T>[]>>,\n  options: { rankConstant?: number; limit?: number } = {},\n): FusedCandidate<T>[] {\n  const rankConstant = Math.max(1, options.rankConstant ?? 60);\n  const fused = new Map<string, FusedCandidate<T>>();\n  for (const [lane, candidates] of Object.entries(lanes)) {\n    candidates.forEach((candidate, index) => {\n      const rank = index + 1;\n      const current = fused.get(candidate.key) ?? {\n        ...candidate,\n        score: 0,\n        laneRanks: {},\n        reasons: [],\n      };\n      current.score += 1 / (rankConstant + rank);\n      current.laneRanks[lane] = rank;\n      if (candidate.reason && !current.reasons.includes(candidate.reason))\n        current.reasons.push(candidate.reason);\n      fused.set(candidate.key, current);\n    });\n  }\n  return [...fused.values()]\n    .sort((a, b) => b.score - a.score || a.key.localeCompare(b.key))\n    .slice(0, Math.max(1, options.limit ?? 40));\n}\n"]}

package/dist/server/agent-engine-api-key-route.d.ts

@@ -27,11 +27,11 @@ export declare function resolveAgentEngineApiKeyWriteTarget(event: H3Event, scop
 export declare function createAgentEngineApiKeyHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: any;
 } | {
+    error?: undefined;
     ok: boolean;
     key: string;
     baseUrlKey?: string;
     scope: AgentEngineApiKeyScope;
-    error?: undefined;
 }>>;
 export {};
 //# sourceMappingURL=agent-engine-api-key-route.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.111.3",
+  "version": "0.112.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -65,6 +65,8 @@
     "./integrations": "./dist/integrations/index.js",
     "./ingestion": "./dist/ingestion/index.js",
     "./search-utils": "./dist/search-utils/index.js",
+    "./search": "./dist/search/index.js",
+    "./embeddings": "./dist/embeddings/index.js",
     "./automation": "./dist/automation/index.js",
     "./brand-kit": "./dist/brand-kit/index.js",
     "./brand-kit/fig": "./dist/brand-kit/fig/index.js",