npm - @objectstack/spec - Versions diffs - 6.5.1 → 6.7.0 - Mend

@objectstack/spec 6.5.1 → 6.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1689) hide show

package/dist/contracts/index.d.mts CHANGED Viewed

@@ -5,7 +5,7 @@ import { u as ObjectSchema } from '../object.zod-rhReSd7V.mjs';
 import { k as FieldSchema } from '../field.zod-Bqhc6_7G.mjs';
 import { U as MetadataQuery, V as MetadataQueryResult, w as MetadataBulkResult, O as MetadataOverlay, a0 as MetadataValidationResult, H as MetadataDependency, a2 as ObjectStackManifest, i as DependencyResolutionResult, an as UpgradePlan, aj as UpgradePackageResponse, ad as RollbackPackageResponse, ap as UpgradeSnapshot, a4 as PackageArtifact, E as ExecutionContext } from '../execution-context.zod-7FfY8UW2.mjs';
 import { am as PackagePublishResult, J as MetadataHistoryQueryOptions, N as MetadataHistoryQueryResult, z as MetadataDiffResult, h as AppTranslationBundle, aG as TranslationCoverageResult, aK as TranslationDiffItem, au as TenantProvisioningRequest, aw as TenantProvisioningResult, ay as TenantProvisioningStatus, as as TenantPlan, l as DeployDiff, ae as MigrationPlan, p as DeployStatus, D as DeployBundle, t as DeployValidationResult, aA as TenantRegion, f as AppManifest, A as AppCompatibilityCheck, d as AppInstallResult } from '../app-install.zod-FLEuRBBE.mjs';
-import { h as FlowParsed } from '../flow.zod-BFCtGdYw.mjs';
+import { h as FlowParsed } from '../flow.zod-LPphSOut.mjs';
 import { i as ExecutionLog } from '../execution.zod-DGGOFfcb.mjs';
 import { ModelMessage, ToolCallPart, TextStreamPart, ToolSet, ToolResultPart } from 'ai';
 export { AssistantModelMessage, FinishReason, ModelMessage, SystemModelMessage, TextStreamPart, ToolCallPart, ToolModelMessage, ToolResultPart, ToolSet, UserModelMessage } from 'ai';
@@ -4494,6 +4494,59 @@ interface IKnowledgeService {
 /** Canonical service-registry id used by `IKnowledgeService` consumers. */
 declare const KNOWLEDGE_SERVICE: "knowledge";
+/**
+ * `IEmbedder` — protocol-level contract for text → vector providers.
+ *
+ * Implemented by embedder plugins (`@objectstack/embedder-openai`,
+ * `@objectstack/embedder-ollama`, `@objectstack/embedder-transformers-js`,
+ * …) and consumed by every knowledge adapter that needs to compute
+ * vectors (e.g. `@objectstack/knowledge-turso`,
+ * `@objectstack/knowledge-sqlite-vec`).
+ *
+ * The surface is deliberately minimal so the same protocol covers
+ * cloud APIs (OpenAI, 阿里通义, 智谱, 硅基流动, Doubao, …), local
+ * Ollama daemons, in-process WASM/ONNX runtimes, and any OpenAI-shape
+ * compatible endpoint. Implementations are responsible for batching,
+ * retry, and rate-limit handling against their upstream.
+ *
+ * Conventions:
+ *  - Output order MUST match input order exactly.
+ *  - Vectors SHOULD be L2-normalised so downstream cosine == dot.
+ *  - `dimensions` MUST be stable for the lifetime of the instance —
+ *    knowledge adapters size their vector columns from this value.
+ *
+ * See `content/docs/protocol/knowledge.mdx`.
+ */
+interface IEmbedder {
+    /** Stable id for logs and diagnostics (e.g. `'openai'`, `'ollama'`). */
+    readonly id: string;
+    /**
+     * Output vector dimensionality. Knowledge adapters use this to size
+     * their fixed-width vector columns / index parameters.
+     */
+    readonly dimensions: number;
+    /**
+     * Embed a batch of strings. Output order matches input order.
+     * Implementations SHOULD handle empty input by returning `[]`.
+     */
+    embed(texts: string[]): Promise<number[][]>;
+}
+/**
+ * DI service token for the kernel-registered `IEmbedder` instance.
+ *
+ * Plugins that need an embedder (e.g. `@objectstack/knowledge-turso`,
+ * `@objectstack/knowledge-sqlite-vec`) SHOULD prefer resolving this
+ * service over taking the embedder as a constructor option, so
+ * operators can configure the embedder once (in `Settings → AI &
+ * Embedder`) and have every knowledge adapter pick it up.
+ *
+ * Registered by `@objectstack/service-ai` when the operator selects a
+ * non-`none` embedder provider in settings. If absent, knowledge
+ * adapters fall back to their constructor-supplied embedder (or refuse
+ * to start).
+ */
+declare const EMBEDDER_SERVICE: "embedder";
 /**
  * ITursoPlatformService - Turso Platform API Contract
  *
@@ -5301,4 +5354,4 @@ interface IClusterService {
     close(): Promise<void>;
 }
-export { type AIConversation, type AIMessage, type AIMessageWithTools, type AIObjectResult, type AIRequestOptions, type AIRequestOptionsWithTools, type AIResult, type AIStreamEvent, type AIToolCall, type AIToolDefinition, type AIToolResult, type AdapterContext, type AdapterSearchOptions, type AnalyticsQuery, type AnalyticsResult, type AnalyticsStrategy, type ApprovalActionRow, type ApprovalDecisionInput, type ApprovalDecisionResult, type ApprovalProcessRow, type ApprovalRequestRow, type ApprovalStatus, type AuthResult, type AuthSession, type AuthUser, type AutomationContext, type AutomationResult, type CacheStats, type ChatWithToolsOptions, type CheckNamespaceInput, type CheckNamespaceResult, type ClusterCallContext, type CounterIncrOptions, type CreateExportJobInput, type CreateExportJobResult, type CreateFeedItemInput, type CreateTursoDatabaseOptions, type CryptoContext, type CryptoHandle, type CubeMeta, type DefineApprovalProcessInput, type DefineSharingRuleInput, type DeployExecutionResult, type DriverCapabilities, type DriverInterface, type EmailAddress, type EmailAttachment, type EmailDeliveryStatus, type ExecuteUpgradeInput, type ExportJobDownload, type ExportJobListResult, type FeedListResult, type GenerateObjectOptions, type GrantShareInput, type GraphQLRequest, type GraphQLResponse, type HealthStatus, type IAIConversationService, type IAIService, type IAdvancedServiceRegistry, type IAnalyticsService, type IAppLifecycleService, type IApprovalService, type IAuthService, type IAutomationService, type IBasicServiceRegistry, type ICacheService, type IClusterService, type ICounter, type ICryptoProvider, type IDataDriver, type IDataEngine, type IDepartmentGraphService, type IDeployPipelineService, type IEmailService, type IEmailTransport, type IExportService, type IFeedService, type IGraphQLService, type IHttpRequest, type IHttpResponse, type IHttpServer, type II18nService, type IJobService, type IKV, type IKnowledgeAdapter, type IKnowledgeService, type ILock, type IMetadataService, type INotificationService, type IPackageService, type IPluginLifecycleEvents, type IPluginValidator, type IProvisioningService, type IPubSub, type IQueueService, type IRealtimeService, type IReportService, type ISchemaDiffService, type ISchemaDriver, type ISearchService, type ISeedLoaderService, type IServiceRegistry, type ISharingRuleService, type ISharingService, type IStartupOrchestrator, type IStorageService, type ITeamGraphService, type ITenantRouter, type ITursoPlatformService, type ITypedEventEmitter, type IUIService, type IWorkflowService, type InstallPackageInput, type InstallPackageResult, type IntrospectedColumn, type IntrospectedIndex, type IntrospectedSchema, type IntrospectedTable, type JobExecution, type JobHandler, type JobSchedule, KNOWLEDGE_SERVICE, type KVEntry, type KVSetOptions, type KnowledgeReindexOptions, type KnowledgeReindexResult, type KnowledgeSearchOptions, type LLMAdapter, type ListExportJobsOptions, type ListFeedOptions, type LockAcquireOptions, type LockHandle, type Logger, type MetadataExportOptions, type MetadataImportOptions, type MetadataImportResult, type MetadataTypeInfo, type MetadataWatchCallback, type MetadataWatchHandle, type Middleware, type MigrationApplyResult, type NormalizedEmailMessage, type NotificationChannel, type NotificationMessage, type NotificationResult, type PendingActionRow, type PendingActionStatus, type PlanUpgradeInput, type Plugin, type PluginStartupResult, type PresignedDownloadDescriptor, type PresignedUploadDescriptor, type ProposePendingActionInput, type PubSubHandler, type PubSubMessage, type PublishOptions, type QueueBackoffPolicy, type QueueHandler, type QueueMessage, type QueueMessageRecord, type QueuePublishOptions, type RealtimeEventHandler, type RealtimeEventPayload, type RealtimeSubscriptionFilter, type RealtimeSubscriptionOptions, type RecordShare, type ReportFormat, type ReportQuery, type ReportRunResult, type ReportSchedule, type ResolveDependenciesInput, type ResolvedTenantContext, type RollbackInput, type RouteHandler, type SaveReportInput, type SavedReport, type ScheduleExportInput, type ScheduleReportInput, type SearchHit, type SearchOptions, type SearchResult, type SendEmailInput, type SendEmailResult, type SendTemplateInput, type ShareAccessLevel, type ShareRecipientType, type ShareSource, type SharingExecutionContext, type SharingRuleEvaluationResult, type SharingRuleRecipientType, type SharingRuleRow, type StartupOptions, type StorageFileInfo, type StorageUploadOptions, type StrategyContext, type SubmitApprovalInput, type SubscribeInput, type SubscribeOptions, type ToolExecutionContext, type TransportSendResult, type TursoDatabaseInfo, type TursoTokenResult, type TursoTokenScope, type Unsubscribe, type UpdateFeedItemInput, type UploadArtifactInput, type UploadArtifactResult, type ValidationResult, type WorkflowStatus, type WorkflowTransition, type WorkflowTransitionResult };
+export { type AIConversation, type AIMessage, type AIMessageWithTools, type AIObjectResult, type AIRequestOptions, type AIRequestOptionsWithTools, type AIResult, type AIStreamEvent, type AIToolCall, type AIToolDefinition, type AIToolResult, type AdapterContext, type AdapterSearchOptions, type AnalyticsQuery, type AnalyticsResult, type AnalyticsStrategy, type ApprovalActionRow, type ApprovalDecisionInput, type ApprovalDecisionResult, type ApprovalProcessRow, type ApprovalRequestRow, type ApprovalStatus, type AuthResult, type AuthSession, type AuthUser, type AutomationContext, type AutomationResult, type CacheStats, type ChatWithToolsOptions, type CheckNamespaceInput, type CheckNamespaceResult, type ClusterCallContext, type CounterIncrOptions, type CreateExportJobInput, type CreateExportJobResult, type CreateFeedItemInput, type CreateTursoDatabaseOptions, type CryptoContext, type CryptoHandle, type CubeMeta, type DefineApprovalProcessInput, type DefineSharingRuleInput, type DeployExecutionResult, type DriverCapabilities, type DriverInterface, EMBEDDER_SERVICE, type EmailAddress, type EmailAttachment, type EmailDeliveryStatus, type ExecuteUpgradeInput, type ExportJobDownload, type ExportJobListResult, type FeedListResult, type GenerateObjectOptions, type GrantShareInput, type GraphQLRequest, type GraphQLResponse, type HealthStatus, type IAIConversationService, type IAIService, type IAdvancedServiceRegistry, type IAnalyticsService, type IAppLifecycleService, type IApprovalService, type IAuthService, type IAutomationService, type IBasicServiceRegistry, type ICacheService, type IClusterService, type ICounter, type ICryptoProvider, type IDataDriver, type IDataEngine, type IDepartmentGraphService, type IDeployPipelineService, type IEmailService, type IEmailTransport, type IEmbedder, type IExportService, type IFeedService, type IGraphQLService, type IHttpRequest, type IHttpResponse, type IHttpServer, type II18nService, type IJobService, type IKV, type IKnowledgeAdapter, type IKnowledgeService, type ILock, type IMetadataService, type INotificationService, type IPackageService, type IPluginLifecycleEvents, type IPluginValidator, type IProvisioningService, type IPubSub, type IQueueService, type IRealtimeService, type IReportService, type ISchemaDiffService, type ISchemaDriver, type ISearchService, type ISeedLoaderService, type IServiceRegistry, type ISharingRuleService, type ISharingService, type IStartupOrchestrator, type IStorageService, type ITeamGraphService, type ITenantRouter, type ITursoPlatformService, type ITypedEventEmitter, type IUIService, type IWorkflowService, type InstallPackageInput, type InstallPackageResult, type IntrospectedColumn, type IntrospectedIndex, type IntrospectedSchema, type IntrospectedTable, type JobExecution, type JobHandler, type JobSchedule, KNOWLEDGE_SERVICE, type KVEntry, type KVSetOptions, type KnowledgeReindexOptions, type KnowledgeReindexResult, type KnowledgeSearchOptions, type LLMAdapter, type ListExportJobsOptions, type ListFeedOptions, type LockAcquireOptions, type LockHandle, type Logger, type MetadataExportOptions, type MetadataImportOptions, type MetadataImportResult, type MetadataTypeInfo, type MetadataWatchCallback, type MetadataWatchHandle, type Middleware, type MigrationApplyResult, type NormalizedEmailMessage, type NotificationChannel, type NotificationMessage, type NotificationResult, type PendingActionRow, type PendingActionStatus, type PlanUpgradeInput, type Plugin, type PluginStartupResult, type PresignedDownloadDescriptor, type PresignedUploadDescriptor, type ProposePendingActionInput, type PubSubHandler, type PubSubMessage, type PublishOptions, type QueueBackoffPolicy, type QueueHandler, type QueueMessage, type QueueMessageRecord, type QueuePublishOptions, type RealtimeEventHandler, type RealtimeEventPayload, type RealtimeSubscriptionFilter, type RealtimeSubscriptionOptions, type RecordShare, type ReportFormat, type ReportQuery, type ReportRunResult, type ReportSchedule, type ResolveDependenciesInput, type ResolvedTenantContext, type RollbackInput, type RouteHandler, type SaveReportInput, type SavedReport, type ScheduleExportInput, type ScheduleReportInput, type SearchHit, type SearchOptions, type SearchResult, type SendEmailInput, type SendEmailResult, type SendTemplateInput, type ShareAccessLevel, type ShareRecipientType, type ShareSource, type SharingExecutionContext, type SharingRuleEvaluationResult, type SharingRuleRecipientType, type SharingRuleRow, type StartupOptions, type StorageFileInfo, type StorageUploadOptions, type StrategyContext, type SubmitApprovalInput, type SubscribeInput, type SubscribeOptions, type ToolExecutionContext, type TransportSendResult, type TursoDatabaseInfo, type TursoTokenResult, type TursoTokenScope, type Unsubscribe, type UpdateFeedItemInput, type UploadArtifactInput, type UploadArtifactResult, type ValidationResult, type WorkflowStatus, type WorkflowTransition, type WorkflowTransitionResult };

package/dist/contracts/index.d.ts CHANGED Viewed

@@ -5,7 +5,7 @@ import { u as ObjectSchema } from '../object.zod-BntYUReb.js';
 import { k as FieldSchema } from '../field.zod-Bqhc6_7G.js';
 import { U as MetadataQuery, V as MetadataQueryResult, w as MetadataBulkResult, O as MetadataOverlay, a0 as MetadataValidationResult, H as MetadataDependency, a2 as ObjectStackManifest, i as DependencyResolutionResult, an as UpgradePlan, aj as UpgradePackageResponse, ad as RollbackPackageResponse, ap as UpgradeSnapshot, a4 as PackageArtifact, E as ExecutionContext } from '../execution-context.zod-7FfY8UW2.js';
 import { am as PackagePublishResult, J as MetadataHistoryQueryOptions, N as MetadataHistoryQueryResult, z as MetadataDiffResult, h as AppTranslationBundle, aG as TranslationCoverageResult, aK as TranslationDiffItem, au as TenantProvisioningRequest, aw as TenantProvisioningResult, ay as TenantProvisioningStatus, as as TenantPlan, l as DeployDiff, ae as MigrationPlan, p as DeployStatus, D as DeployBundle, t as DeployValidationResult, aA as TenantRegion, f as AppManifest, A as AppCompatibilityCheck, d as AppInstallResult } from '../app-install.zod-FLEuRBBE.js';
-import { h as FlowParsed } from '../flow.zod-BFCtGdYw.js';
+import { h as FlowParsed } from '../flow.zod-LPphSOut.js';
 import { i as ExecutionLog } from '../execution.zod-DGGOFfcb.js';
 import { ModelMessage, ToolCallPart, TextStreamPart, ToolSet, ToolResultPart } from 'ai';
 export { AssistantModelMessage, FinishReason, ModelMessage, SystemModelMessage, TextStreamPart, ToolCallPart, ToolModelMessage, ToolResultPart, ToolSet, UserModelMessage } from 'ai';
@@ -4494,6 +4494,59 @@ interface IKnowledgeService {
 /** Canonical service-registry id used by `IKnowledgeService` consumers. */
 declare const KNOWLEDGE_SERVICE: "knowledge";
+/**
+ * `IEmbedder` — protocol-level contract for text → vector providers.
+ *
+ * Implemented by embedder plugins (`@objectstack/embedder-openai`,
+ * `@objectstack/embedder-ollama`, `@objectstack/embedder-transformers-js`,
+ * …) and consumed by every knowledge adapter that needs to compute
+ * vectors (e.g. `@objectstack/knowledge-turso`,
+ * `@objectstack/knowledge-sqlite-vec`).
+ *
+ * The surface is deliberately minimal so the same protocol covers
+ * cloud APIs (OpenAI, 阿里通义, 智谱, 硅基流动, Doubao, …), local
+ * Ollama daemons, in-process WASM/ONNX runtimes, and any OpenAI-shape
+ * compatible endpoint. Implementations are responsible for batching,
+ * retry, and rate-limit handling against their upstream.
+ *
+ * Conventions:
+ *  - Output order MUST match input order exactly.
+ *  - Vectors SHOULD be L2-normalised so downstream cosine == dot.
+ *  - `dimensions` MUST be stable for the lifetime of the instance —
+ *    knowledge adapters size their vector columns from this value.
+ *
+ * See `content/docs/protocol/knowledge.mdx`.
+ */
+interface IEmbedder {
+    /** Stable id for logs and diagnostics (e.g. `'openai'`, `'ollama'`). */
+    readonly id: string;
+    /**
+     * Output vector dimensionality. Knowledge adapters use this to size
+     * their fixed-width vector columns / index parameters.
+     */
+    readonly dimensions: number;
+    /**
+     * Embed a batch of strings. Output order matches input order.
+     * Implementations SHOULD handle empty input by returning `[]`.
+     */
+    embed(texts: string[]): Promise<number[][]>;
+}
+/**
+ * DI service token for the kernel-registered `IEmbedder` instance.
+ *
+ * Plugins that need an embedder (e.g. `@objectstack/knowledge-turso`,
+ * `@objectstack/knowledge-sqlite-vec`) SHOULD prefer resolving this
+ * service over taking the embedder as a constructor option, so
+ * operators can configure the embedder once (in `Settings → AI &
+ * Embedder`) and have every knowledge adapter pick it up.
+ *
+ * Registered by `@objectstack/service-ai` when the operator selects a
+ * non-`none` embedder provider in settings. If absent, knowledge
+ * adapters fall back to their constructor-supplied embedder (or refuse
+ * to start).
+ */
+declare const EMBEDDER_SERVICE: "embedder";
 /**
  * ITursoPlatformService - Turso Platform API Contract
  *
@@ -5301,4 +5354,4 @@ interface IClusterService {
     close(): Promise<void>;
 }
-export { type AIConversation, type AIMessage, type AIMessageWithTools, type AIObjectResult, type AIRequestOptions, type AIRequestOptionsWithTools, type AIResult, type AIStreamEvent, type AIToolCall, type AIToolDefinition, type AIToolResult, type AdapterContext, type AdapterSearchOptions, type AnalyticsQuery, type AnalyticsResult, type AnalyticsStrategy, type ApprovalActionRow, type ApprovalDecisionInput, type ApprovalDecisionResult, type ApprovalProcessRow, type ApprovalRequestRow, type ApprovalStatus, type AuthResult, type AuthSession, type AuthUser, type AutomationContext, type AutomationResult, type CacheStats, type ChatWithToolsOptions, type CheckNamespaceInput, type CheckNamespaceResult, type ClusterCallContext, type CounterIncrOptions, type CreateExportJobInput, type CreateExportJobResult, type CreateFeedItemInput, type CreateTursoDatabaseOptions, type CryptoContext, type CryptoHandle, type CubeMeta, type DefineApprovalProcessInput, type DefineSharingRuleInput, type DeployExecutionResult, type DriverCapabilities, type DriverInterface, type EmailAddress, type EmailAttachment, type EmailDeliveryStatus, type ExecuteUpgradeInput, type ExportJobDownload, type ExportJobListResult, type FeedListResult, type GenerateObjectOptions, type GrantShareInput, type GraphQLRequest, type GraphQLResponse, type HealthStatus, type IAIConversationService, type IAIService, type IAdvancedServiceRegistry, type IAnalyticsService, type IAppLifecycleService, type IApprovalService, type IAuthService, type IAutomationService, type IBasicServiceRegistry, type ICacheService, type IClusterService, type ICounter, type ICryptoProvider, type IDataDriver, type IDataEngine, type IDepartmentGraphService, type IDeployPipelineService, type IEmailService, type IEmailTransport, type IExportService, type IFeedService, type IGraphQLService, type IHttpRequest, type IHttpResponse, type IHttpServer, type II18nService, type IJobService, type IKV, type IKnowledgeAdapter, type IKnowledgeService, type ILock, type IMetadataService, type INotificationService, type IPackageService, type IPluginLifecycleEvents, type IPluginValidator, type IProvisioningService, type IPubSub, type IQueueService, type IRealtimeService, type IReportService, type ISchemaDiffService, type ISchemaDriver, type ISearchService, type ISeedLoaderService, type IServiceRegistry, type ISharingRuleService, type ISharingService, type IStartupOrchestrator, type IStorageService, type ITeamGraphService, type ITenantRouter, type ITursoPlatformService, type ITypedEventEmitter, type IUIService, type IWorkflowService, type InstallPackageInput, type InstallPackageResult, type IntrospectedColumn, type IntrospectedIndex, type IntrospectedSchema, type IntrospectedTable, type JobExecution, type JobHandler, type JobSchedule, KNOWLEDGE_SERVICE, type KVEntry, type KVSetOptions, type KnowledgeReindexOptions, type KnowledgeReindexResult, type KnowledgeSearchOptions, type LLMAdapter, type ListExportJobsOptions, type ListFeedOptions, type LockAcquireOptions, type LockHandle, type Logger, type MetadataExportOptions, type MetadataImportOptions, type MetadataImportResult, type MetadataTypeInfo, type MetadataWatchCallback, type MetadataWatchHandle, type Middleware, type MigrationApplyResult, type NormalizedEmailMessage, type NotificationChannel, type NotificationMessage, type NotificationResult, type PendingActionRow, type PendingActionStatus, type PlanUpgradeInput, type Plugin, type PluginStartupResult, type PresignedDownloadDescriptor, type PresignedUploadDescriptor, type ProposePendingActionInput, type PubSubHandler, type PubSubMessage, type PublishOptions, type QueueBackoffPolicy, type QueueHandler, type QueueMessage, type QueueMessageRecord, type QueuePublishOptions, type RealtimeEventHandler, type RealtimeEventPayload, type RealtimeSubscriptionFilter, type RealtimeSubscriptionOptions, type RecordShare, type ReportFormat, type ReportQuery, type ReportRunResult, type ReportSchedule, type ResolveDependenciesInput, type ResolvedTenantContext, type RollbackInput, type RouteHandler, type SaveReportInput, type SavedReport, type ScheduleExportInput, type ScheduleReportInput, type SearchHit, type SearchOptions, type SearchResult, type SendEmailInput, type SendEmailResult, type SendTemplateInput, type ShareAccessLevel, type ShareRecipientType, type ShareSource, type SharingExecutionContext, type SharingRuleEvaluationResult, type SharingRuleRecipientType, type SharingRuleRow, type StartupOptions, type StorageFileInfo, type StorageUploadOptions, type StrategyContext, type SubmitApprovalInput, type SubscribeInput, type SubscribeOptions, type ToolExecutionContext, type TransportSendResult, type TursoDatabaseInfo, type TursoTokenResult, type TursoTokenScope, type Unsubscribe, type UpdateFeedItemInput, type UploadArtifactInput, type UploadArtifactResult, type ValidationResult, type WorkflowStatus, type WorkflowTransition, type WorkflowTransitionResult };
+export { type AIConversation, type AIMessage, type AIMessageWithTools, type AIObjectResult, type AIRequestOptions, type AIRequestOptionsWithTools, type AIResult, type AIStreamEvent, type AIToolCall, type AIToolDefinition, type AIToolResult, type AdapterContext, type AdapterSearchOptions, type AnalyticsQuery, type AnalyticsResult, type AnalyticsStrategy, type ApprovalActionRow, type ApprovalDecisionInput, type ApprovalDecisionResult, type ApprovalProcessRow, type ApprovalRequestRow, type ApprovalStatus, type AuthResult, type AuthSession, type AuthUser, type AutomationContext, type AutomationResult, type CacheStats, type ChatWithToolsOptions, type CheckNamespaceInput, type CheckNamespaceResult, type ClusterCallContext, type CounterIncrOptions, type CreateExportJobInput, type CreateExportJobResult, type CreateFeedItemInput, type CreateTursoDatabaseOptions, type CryptoContext, type CryptoHandle, type CubeMeta, type DefineApprovalProcessInput, type DefineSharingRuleInput, type DeployExecutionResult, type DriverCapabilities, type DriverInterface, EMBEDDER_SERVICE, type EmailAddress, type EmailAttachment, type EmailDeliveryStatus, type ExecuteUpgradeInput, type ExportJobDownload, type ExportJobListResult, type FeedListResult, type GenerateObjectOptions, type GrantShareInput, type GraphQLRequest, type GraphQLResponse, type HealthStatus, type IAIConversationService, type IAIService, type IAdvancedServiceRegistry, type IAnalyticsService, type IAppLifecycleService, type IApprovalService, type IAuthService, type IAutomationService, type IBasicServiceRegistry, type ICacheService, type IClusterService, type ICounter, type ICryptoProvider, type IDataDriver, type IDataEngine, type IDepartmentGraphService, type IDeployPipelineService, type IEmailService, type IEmailTransport, type IEmbedder, type IExportService, type IFeedService, type IGraphQLService, type IHttpRequest, type IHttpResponse, type IHttpServer, type II18nService, type IJobService, type IKV, type IKnowledgeAdapter, type IKnowledgeService, type ILock, type IMetadataService, type INotificationService, type IPackageService, type IPluginLifecycleEvents, type IPluginValidator, type IProvisioningService, type IPubSub, type IQueueService, type IRealtimeService, type IReportService, type ISchemaDiffService, type ISchemaDriver, type ISearchService, type ISeedLoaderService, type IServiceRegistry, type ISharingRuleService, type ISharingService, type IStartupOrchestrator, type IStorageService, type ITeamGraphService, type ITenantRouter, type ITursoPlatformService, type ITypedEventEmitter, type IUIService, type IWorkflowService, type InstallPackageInput, type InstallPackageResult, type IntrospectedColumn, type IntrospectedIndex, type IntrospectedSchema, type IntrospectedTable, type JobExecution, type JobHandler, type JobSchedule, KNOWLEDGE_SERVICE, type KVEntry, type KVSetOptions, type KnowledgeReindexOptions, type KnowledgeReindexResult, type KnowledgeSearchOptions, type LLMAdapter, type ListExportJobsOptions, type ListFeedOptions, type LockAcquireOptions, type LockHandle, type Logger, type MetadataExportOptions, type MetadataImportOptions, type MetadataImportResult, type MetadataTypeInfo, type MetadataWatchCallback, type MetadataWatchHandle, type Middleware, type MigrationApplyResult, type NormalizedEmailMessage, type NotificationChannel, type NotificationMessage, type NotificationResult, type PendingActionRow, type PendingActionStatus, type PlanUpgradeInput, type Plugin, type PluginStartupResult, type PresignedDownloadDescriptor, type PresignedUploadDescriptor, type ProposePendingActionInput, type PubSubHandler, type PubSubMessage, type PublishOptions, type QueueBackoffPolicy, type QueueHandler, type QueueMessage, type QueueMessageRecord, type QueuePublishOptions, type RealtimeEventHandler, type RealtimeEventPayload, type RealtimeSubscriptionFilter, type RealtimeSubscriptionOptions, type RecordShare, type ReportFormat, type ReportQuery, type ReportRunResult, type ReportSchedule, type ResolveDependenciesInput, type ResolvedTenantContext, type RollbackInput, type RouteHandler, type SaveReportInput, type SavedReport, type ScheduleExportInput, type ScheduleReportInput, type SearchHit, type SearchOptions, type SearchResult, type SendEmailInput, type SendEmailResult, type SendTemplateInput, type ShareAccessLevel, type ShareRecipientType, type ShareSource, type SharingExecutionContext, type SharingRuleEvaluationResult, type SharingRuleRecipientType, type SharingRuleRow, type StartupOptions, type StorageFileInfo, type StorageUploadOptions, type StrategyContext, type SubmitApprovalInput, type SubscribeInput, type SubscribeOptions, type ToolExecutionContext, type TransportSendResult, type TursoDatabaseInfo, type TursoTokenResult, type TursoTokenScope, type Unsubscribe, type UpdateFeedItemInput, type UploadArtifactInput, type UploadArtifactResult, type ValidationResult, type WorkflowStatus, type WorkflowTransition, type WorkflowTransitionResult };

package/dist/contracts/index.js CHANGED Viewed

@@ -3,6 +3,10 @@
 // src/contracts/knowledge-service.ts
 var KNOWLEDGE_SERVICE = "knowledge";
+// src/contracts/embedder.ts
+var EMBEDDER_SERVICE = "embedder";
+exports.EMBEDDER_SERVICE = EMBEDDER_SERVICE;
 exports.KNOWLEDGE_SERVICE = KNOWLEDGE_SERVICE;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/contracts/knowledge-service.ts"],"names":[],"mappings":";;;AAgHO,IAAM,iBAAA,GAAoB","file":"index.js","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { ExecutionContext } from '../kernel/execution-context.zod';\nimport type {\n KnowledgeDocument,\n KnowledgeHit,\n} from '../ai/knowledge-document.zod';\nimport type { KnowledgeSource } from '../ai/knowledge-source.zod';\nimport type { IKnowledgeAdapter } from './knowledge-adapter';\n\n/*\n `IKnowledgeService` — orchestrator contract consumed by REST,\n * `service-ai`, Studio, and custom plugins. Implemented by\n * `@objectstack/service-knowledge`.\n \n The service routes requests to one of many `IKnowledgeAdapter`\n * plugins (RAGFlow, LlamaIndex, Dify, …), wraps search results with a\n * permission-aware filter that uses the caller's `ExecutionContext`,\n * and drives event-based sync from ObjectQL.\n \n See `content/docs/protocol/knowledge.mdx` for the architecture\n * rationale.\n /\n\n/* Options accepted by `IKnowledgeService.search`. /\nexport interface KnowledgeSearchOptions {\n /\n Restrict the search to the given source ids. When omitted, every\n * source the caller is allowed to see is queried.\n /\n sourceIds?: string[];\n /* Max number of hits to return. Adapters may cap further. /\n topK?: number;\n /* Adapter-specific filter (passed opaquely). /\n filter?: Record<string, unknown>;\n /\n Execution context of the caller. Required for permission-aware\n * retrieval: hits whose `sourceRecordId` would be filtered out by\n * RLS are dropped before being returned. Internal callers may pass\n * an `isSystem: true` context to bypass — same convention as\n * `IDataEngine`.\n /\n executionContext?: ExecutionContext;\n}\n\n/* Options accepted by `IKnowledgeService.reindexSource`. /\nexport interface KnowledgeReindexOptions {\n /* When `true`, walk the source and count but do not call the adapter. /\n dryRun?: boolean;\n /* Cap on number of documents to reindex (mostly for tests / smoke runs). /\n limit?: number;\n}\n\n/* Result of a `reindexSource` call. /\nexport interface KnowledgeReindexResult {\n /* Number of documents pushed to the adapter (0 when dryRun). /\n indexed: number;\n /* Number of documents discovered (always populated). /\n discovered: number;\n /* When applicable, the underlying object's short name. /\n object?: string;\n /* When `false`, an adapter / source check prevented the run. /\n ok: boolean;\n /* Free-form diagnostics. /\n message?: string;\n}\n\n/\n Core service contract.\n \n Every adapter plugin calls `registerAdapter(id, this)` during its\n * `start()` hook. Sources reference adapters by id; unknown ids cause\n * `search` / `indexDocument` to throw early with a clear error.\n /\nexport interface IKnowledgeService {\n /* Register (or replace) an adapter under the given id. /\n registerAdapter(id: string, adapter: IKnowledgeAdapter): void;\n /* Resolve an adapter by id. Throws when unknown. /\n getAdapter(id: string): IKnowledgeAdapter;\n /* Enumerate registered adapter ids. /\n listAdapters(): string[];\n\n /* Register a logical knowledge source. /\n registerSource(source: KnowledgeSource): void;\n /* Remove a registered source. Does not delete underlying data. /\n unregisterSource(sourceId: string): void;\n /* Snapshot of registered sources (read-only). /\n listSources(): KnowledgeSource[];\n /* Look up a single source. Returns `undefined` when not registered. /\n getSource(sourceId: string): KnowledgeSource \| undefined;\n\n /* Index (insert or replace) a document into the source's adapter. /\n indexDocument(sourceId: string, doc: KnowledgeDocument): Promise<void>;\n /* Remove a document from the source's adapter. /\n deleteDocument(sourceId: string, documentId: string): Promise<void>;\n\n /\n Bulk reindex a source from its declared origin. Object sources\n * walk the underlying object via `IDataEngine`; file / http sources\n * delegate to the adapter's own ingestion.\n /\n reindexSource(sourceId: string, opts?: KnowledgeReindexOptions): Promise<KnowledgeReindexResult>;\n\n /\n Run a search across one or more sources. Results are\n * permission-filtered before being returned (see\n * `KnowledgeSearchOptions.executionContext`).\n /\n search(query: string, opts?: KnowledgeSearchOptions): Promise<KnowledgeHit[]>;\n}\n\n/* Canonical service-registry id used by `IKnowledgeService` consumers. */\nexport const KNOWLEDGE_SERVICE = 'knowledge' as const;\n"]}
1	+ {"version":3,"sources":["../../src/contracts/knowledge-service.ts","../../src/contracts/embedder.ts"],"names":[],"mappings":";;;AAgHO,IAAM,iBAAA,GAAoB;;;AC1D1B,IAAM,gBAAA,GAAmB","file":"index.js","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { ExecutionContext } from '../kernel/execution-context.zod';\nimport type {\n KnowledgeDocument,\n KnowledgeHit,\n} from '../ai/knowledge-document.zod';\nimport type { KnowledgeSource } from '../ai/knowledge-source.zod';\nimport type { IKnowledgeAdapter } from './knowledge-adapter';\n\n/*\n `IKnowledgeService` — orchestrator contract consumed by REST,\n * `service-ai`, Studio, and custom plugins. Implemented by\n * `@objectstack/service-knowledge`.\n \n The service routes requests to one of many `IKnowledgeAdapter`\n * plugins (RAGFlow, LlamaIndex, Dify, …), wraps search results with a\n * permission-aware filter that uses the caller's `ExecutionContext`,\n * and drives event-based sync from ObjectQL.\n \n See `content/docs/protocol/knowledge.mdx` for the architecture\n * rationale.\n /\n\n/* Options accepted by `IKnowledgeService.search`. /\nexport interface KnowledgeSearchOptions {\n /\n Restrict the search to the given source ids. When omitted, every\n * source the caller is allowed to see is queried.\n /\n sourceIds?: string[];\n /* Max number of hits to return. Adapters may cap further. /\n topK?: number;\n /* Adapter-specific filter (passed opaquely). /\n filter?: Record<string, unknown>;\n /\n Execution context of the caller. Required for permission-aware\n * retrieval: hits whose `sourceRecordId` would be filtered out by\n * RLS are dropped before being returned. Internal callers may pass\n * an `isSystem: true` context to bypass — same convention as\n * `IDataEngine`.\n /\n executionContext?: ExecutionContext;\n}\n\n/* Options accepted by `IKnowledgeService.reindexSource`. /\nexport interface KnowledgeReindexOptions {\n /* When `true`, walk the source and count but do not call the adapter. /\n dryRun?: boolean;\n /* Cap on number of documents to reindex (mostly for tests / smoke runs). /\n limit?: number;\n}\n\n/* Result of a `reindexSource` call. /\nexport interface KnowledgeReindexResult {\n /* Number of documents pushed to the adapter (0 when dryRun). /\n indexed: number;\n /* Number of documents discovered (always populated). /\n discovered: number;\n /* When applicable, the underlying object's short name. /\n object?: string;\n /* When `false`, an adapter / source check prevented the run. /\n ok: boolean;\n /* Free-form diagnostics. /\n message?: string;\n}\n\n/\n Core service contract.\n \n Every adapter plugin calls `registerAdapter(id, this)` during its\n * `start()` hook. Sources reference adapters by id; unknown ids cause\n * `search` / `indexDocument` to throw early with a clear error.\n /\nexport interface IKnowledgeService {\n /* Register (or replace) an adapter under the given id. /\n registerAdapter(id: string, adapter: IKnowledgeAdapter): void;\n /* Resolve an adapter by id. Throws when unknown. /\n getAdapter(id: string): IKnowledgeAdapter;\n /* Enumerate registered adapter ids. /\n listAdapters(): string[];\n\n /* Register a logical knowledge source. /\n registerSource(source: KnowledgeSource): void;\n /* Remove a registered source. Does not delete underlying data. /\n unregisterSource(sourceId: string): void;\n /* Snapshot of registered sources (read-only). /\n listSources(): KnowledgeSource[];\n /* Look up a single source. Returns `undefined` when not registered. /\n getSource(sourceId: string): KnowledgeSource \| undefined;\n\n /* Index (insert or replace) a document into the source's adapter. /\n indexDocument(sourceId: string, doc: KnowledgeDocument): Promise<void>;\n /* Remove a document from the source's adapter. /\n deleteDocument(sourceId: string, documentId: string): Promise<void>;\n\n /\n Bulk reindex a source from its declared origin. Object sources\n * walk the underlying object via `IDataEngine`; file / http sources\n * delegate to the adapter's own ingestion.\n /\n reindexSource(sourceId: string, opts?: KnowledgeReindexOptions): Promise<KnowledgeReindexResult>;\n\n /\n Run a search across one or more sources. Results are\n * permission-filtered before being returned (see\n * `KnowledgeSearchOptions.executionContext`).\n /\n search(query: string, opts?: KnowledgeSearchOptions): Promise<KnowledgeHit[]>;\n}\n\n/* Canonical service-registry id used by `IKnowledgeService` consumers. /\nexport const KNOWLEDGE_SERVICE = 'knowledge' as const;\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n `IEmbedder` — protocol-level contract for text → vector providers.\n \n Implemented by embedder plugins (`@objectstack/embedder-openai`,\n * `@objectstack/embedder-ollama`, `@objectstack/embedder-transformers-js`,\n * …) and consumed by every knowledge adapter that needs to compute\n * vectors (e.g. `@objectstack/knowledge-turso`,\n * `@objectstack/knowledge-sqlite-vec`).\n \n The surface is deliberately minimal so the same protocol covers\n * cloud APIs (OpenAI, 阿里通义, 智谱, 硅基流动, Doubao, …), local\n * Ollama daemons, in-process WASM/ONNX runtimes, and any OpenAI-shape\n * compatible endpoint. Implementations are responsible for batching,\n * retry, and rate-limit handling against their upstream.\n \n Conventions:\n * - Output order MUST match input order exactly.\n * - Vectors SHOULD be L2-normalised so downstream cosine == dot.\n * - `dimensions` MUST be stable for the lifetime of the instance —\n * knowledge adapters size their vector columns from this value.\n \n See `content/docs/protocol/knowledge.mdx`.\n /\nexport interface IEmbedder {\n /* Stable id for logs and diagnostics (e.g. `'openai'`, `'ollama'`). /\n readonly id: string;\n /\n Output vector dimensionality. Knowledge adapters use this to size\n * their fixed-width vector columns / index parameters.\n /\n readonly dimensions: number;\n /\n Embed a batch of strings. Output order matches input order.\n * Implementations SHOULD handle empty input by returning `[]`.\n /\n embed(texts: string[]): Promise<number[][]>;\n}\n\n/\n DI service token for the kernel-registered `IEmbedder` instance.\n \n Plugins that need an embedder (e.g. `@objectstack/knowledge-turso`,\n * `@objectstack/knowledge-sqlite-vec`) SHOULD prefer resolving this\n * service over taking the embedder as a constructor option, so\n * operators can configure the embedder once (in `Settings → AI &\n * Embedder`) and have every knowledge adapter pick it up.\n \n Registered by `@objectstack/service-ai` when the operator selects a\n * non-`none` embedder provider in settings. If absent, knowledge\n * adapters fall back to their constructor-supplied embedder (or refuse\n * to start).\n */\nexport const EMBEDDER_SERVICE = 'embedder' as const;\n"]}

package/dist/contracts/index.mjs CHANGED Viewed

@@ -1,6 +1,9 @@
 // src/contracts/knowledge-service.ts
 var KNOWLEDGE_SERVICE = "knowledge";
-export { KNOWLEDGE_SERVICE };
+// src/contracts/embedder.ts
+var EMBEDDER_SERVICE = "embedder";
+export { EMBEDDER_SERVICE, KNOWLEDGE_SERVICE };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/contracts/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../../src/contracts/knowledge-service.ts"],"names":[],"mappings":";AAgHO,IAAM,iBAAA,GAAoB","file":"index.mjs","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { ExecutionContext } from '../kernel/execution-context.zod';\nimport type {\n KnowledgeDocument,\n KnowledgeHit,\n} from '../ai/knowledge-document.zod';\nimport type { KnowledgeSource } from '../ai/knowledge-source.zod';\nimport type { IKnowledgeAdapter } from './knowledge-adapter';\n\n/*\n `IKnowledgeService` — orchestrator contract consumed by REST,\n * `service-ai`, Studio, and custom plugins. Implemented by\n * `@objectstack/service-knowledge`.\n \n The service routes requests to one of many `IKnowledgeAdapter`\n * plugins (RAGFlow, LlamaIndex, Dify, …), wraps search results with a\n * permission-aware filter that uses the caller's `ExecutionContext`,\n * and drives event-based sync from ObjectQL.\n \n See `content/docs/protocol/knowledge.mdx` for the architecture\n * rationale.\n /\n\n/* Options accepted by `IKnowledgeService.search`. /\nexport interface KnowledgeSearchOptions {\n /\n Restrict the search to the given source ids. When omitted, every\n * source the caller is allowed to see is queried.\n /\n sourceIds?: string[];\n /* Max number of hits to return. Adapters may cap further. /\n topK?: number;\n /* Adapter-specific filter (passed opaquely). /\n filter?: Record<string, unknown>;\n /\n Execution context of the caller. Required for permission-aware\n * retrieval: hits whose `sourceRecordId` would be filtered out by\n * RLS are dropped before being returned. Internal callers may pass\n * an `isSystem: true` context to bypass — same convention as\n * `IDataEngine`.\n /\n executionContext?: ExecutionContext;\n}\n\n/* Options accepted by `IKnowledgeService.reindexSource`. /\nexport interface KnowledgeReindexOptions {\n /* When `true`, walk the source and count but do not call the adapter. /\n dryRun?: boolean;\n /* Cap on number of documents to reindex (mostly for tests / smoke runs). /\n limit?: number;\n}\n\n/* Result of a `reindexSource` call. /\nexport interface KnowledgeReindexResult {\n /* Number of documents pushed to the adapter (0 when dryRun). /\n indexed: number;\n /* Number of documents discovered (always populated). /\n discovered: number;\n /* When applicable, the underlying object's short name. /\n object?: string;\n /* When `false`, an adapter / source check prevented the run. /\n ok: boolean;\n /* Free-form diagnostics. /\n message?: string;\n}\n\n/\n Core service contract.\n \n Every adapter plugin calls `registerAdapter(id, this)` during its\n * `start()` hook. Sources reference adapters by id; unknown ids cause\n * `search` / `indexDocument` to throw early with a clear error.\n /\nexport interface IKnowledgeService {\n /* Register (or replace) an adapter under the given id. /\n registerAdapter(id: string, adapter: IKnowledgeAdapter): void;\n /* Resolve an adapter by id. Throws when unknown. /\n getAdapter(id: string): IKnowledgeAdapter;\n /* Enumerate registered adapter ids. /\n listAdapters(): string[];\n\n /* Register a logical knowledge source. /\n registerSource(source: KnowledgeSource): void;\n /* Remove a registered source. Does not delete underlying data. /\n unregisterSource(sourceId: string): void;\n /* Snapshot of registered sources (read-only). /\n listSources(): KnowledgeSource[];\n /* Look up a single source. Returns `undefined` when not registered. /\n getSource(sourceId: string): KnowledgeSource \| undefined;\n\n /* Index (insert or replace) a document into the source's adapter. /\n indexDocument(sourceId: string, doc: KnowledgeDocument): Promise<void>;\n /* Remove a document from the source's adapter. /\n deleteDocument(sourceId: string, documentId: string): Promise<void>;\n\n /\n Bulk reindex a source from its declared origin. Object sources\n * walk the underlying object via `IDataEngine`; file / http sources\n * delegate to the adapter's own ingestion.\n /\n reindexSource(sourceId: string, opts?: KnowledgeReindexOptions): Promise<KnowledgeReindexResult>;\n\n /\n Run a search across one or more sources. Results are\n * permission-filtered before being returned (see\n * `KnowledgeSearchOptions.executionContext`).\n /\n search(query: string, opts?: KnowledgeSearchOptions): Promise<KnowledgeHit[]>;\n}\n\n/* Canonical service-registry id used by `IKnowledgeService` consumers. */\nexport const KNOWLEDGE_SERVICE = 'knowledge' as const;\n"]}
1	+ {"version":3,"sources":["../../src/contracts/knowledge-service.ts","../../src/contracts/embedder.ts"],"names":[],"mappings":";AAgHO,IAAM,iBAAA,GAAoB;;;AC1D1B,IAAM,gBAAA,GAAmB","file":"index.mjs","sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { ExecutionContext } from '../kernel/execution-context.zod';\nimport type {\n KnowledgeDocument,\n KnowledgeHit,\n} from '../ai/knowledge-document.zod';\nimport type { KnowledgeSource } from '../ai/knowledge-source.zod';\nimport type { IKnowledgeAdapter } from './knowledge-adapter';\n\n/*\n `IKnowledgeService` — orchestrator contract consumed by REST,\n * `service-ai`, Studio, and custom plugins. Implemented by\n * `@objectstack/service-knowledge`.\n \n The service routes requests to one of many `IKnowledgeAdapter`\n * plugins (RAGFlow, LlamaIndex, Dify, …), wraps search results with a\n * permission-aware filter that uses the caller's `ExecutionContext`,\n * and drives event-based sync from ObjectQL.\n \n See `content/docs/protocol/knowledge.mdx` for the architecture\n * rationale.\n /\n\n/* Options accepted by `IKnowledgeService.search`. /\nexport interface KnowledgeSearchOptions {\n /\n Restrict the search to the given source ids. When omitted, every\n * source the caller is allowed to see is queried.\n /\n sourceIds?: string[];\n /* Max number of hits to return. Adapters may cap further. /\n topK?: number;\n /* Adapter-specific filter (passed opaquely). /\n filter?: Record<string, unknown>;\n /\n Execution context of the caller. Required for permission-aware\n * retrieval: hits whose `sourceRecordId` would be filtered out by\n * RLS are dropped before being returned. Internal callers may pass\n * an `isSystem: true` context to bypass — same convention as\n * `IDataEngine`.\n /\n executionContext?: ExecutionContext;\n}\n\n/* Options accepted by `IKnowledgeService.reindexSource`. /\nexport interface KnowledgeReindexOptions {\n /* When `true`, walk the source and count but do not call the adapter. /\n dryRun?: boolean;\n /* Cap on number of documents to reindex (mostly for tests / smoke runs). /\n limit?: number;\n}\n\n/* Result of a `reindexSource` call. /\nexport interface KnowledgeReindexResult {\n /* Number of documents pushed to the adapter (0 when dryRun). /\n indexed: number;\n /* Number of documents discovered (always populated). /\n discovered: number;\n /* When applicable, the underlying object's short name. /\n object?: string;\n /* When `false`, an adapter / source check prevented the run. /\n ok: boolean;\n /* Free-form diagnostics. /\n message?: string;\n}\n\n/\n Core service contract.\n \n Every adapter plugin calls `registerAdapter(id, this)` during its\n * `start()` hook. Sources reference adapters by id; unknown ids cause\n * `search` / `indexDocument` to throw early with a clear error.\n /\nexport interface IKnowledgeService {\n /* Register (or replace) an adapter under the given id. /\n registerAdapter(id: string, adapter: IKnowledgeAdapter): void;\n /* Resolve an adapter by id. Throws when unknown. /\n getAdapter(id: string): IKnowledgeAdapter;\n /* Enumerate registered adapter ids. /\n listAdapters(): string[];\n\n /* Register a logical knowledge source. /\n registerSource(source: KnowledgeSource): void;\n /* Remove a registered source. Does not delete underlying data. /\n unregisterSource(sourceId: string): void;\n /* Snapshot of registered sources (read-only). /\n listSources(): KnowledgeSource[];\n /* Look up a single source. Returns `undefined` when not registered. /\n getSource(sourceId: string): KnowledgeSource \| undefined;\n\n /* Index (insert or replace) a document into the source's adapter. /\n indexDocument(sourceId: string, doc: KnowledgeDocument): Promise<void>;\n /* Remove a document from the source's adapter. /\n deleteDocument(sourceId: string, documentId: string): Promise<void>;\n\n /\n Bulk reindex a source from its declared origin. Object sources\n * walk the underlying object via `IDataEngine`; file / http sources\n * delegate to the adapter's own ingestion.\n /\n reindexSource(sourceId: string, opts?: KnowledgeReindexOptions): Promise<KnowledgeReindexResult>;\n\n /\n Run a search across one or more sources. Results are\n * permission-filtered before being returned (see\n * `KnowledgeSearchOptions.executionContext`).\n /\n search(query: string, opts?: KnowledgeSearchOptions): Promise<KnowledgeHit[]>;\n}\n\n/* Canonical service-registry id used by `IKnowledgeService` consumers. /\nexport const KNOWLEDGE_SERVICE = 'knowledge' as const;\n","// Copyright (c) 2026 ObjectStack. Licensed under the Apache-2.0 license.\n\n/\n `IEmbedder` — protocol-level contract for text → vector providers.\n \n Implemented by embedder plugins (`@objectstack/embedder-openai`,\n * `@objectstack/embedder-ollama`, `@objectstack/embedder-transformers-js`,\n * …) and consumed by every knowledge adapter that needs to compute\n * vectors (e.g. `@objectstack/knowledge-turso`,\n * `@objectstack/knowledge-sqlite-vec`).\n \n The surface is deliberately minimal so the same protocol covers\n * cloud APIs (OpenAI, 阿里通义, 智谱, 硅基流动, Doubao, …), local\n * Ollama daemons, in-process WASM/ONNX runtimes, and any OpenAI-shape\n * compatible endpoint. Implementations are responsible for batching,\n * retry, and rate-limit handling against their upstream.\n \n Conventions:\n * - Output order MUST match input order exactly.\n * - Vectors SHOULD be L2-normalised so downstream cosine == dot.\n * - `dimensions` MUST be stable for the lifetime of the instance —\n * knowledge adapters size their vector columns from this value.\n \n See `content/docs/protocol/knowledge.mdx`.\n /\nexport interface IEmbedder {\n /* Stable id for logs and diagnostics (e.g. `'openai'`, `'ollama'`). /\n readonly id: string;\n /\n Output vector dimensionality. Knowledge adapters use this to size\n * their fixed-width vector columns / index parameters.\n /\n readonly dimensions: number;\n /\n Embed a batch of strings. Output order matches input order.\n * Implementations SHOULD handle empty input by returning `[]`.\n /\n embed(texts: string[]): Promise<number[][]>;\n}\n\n/\n DI service token for the kernel-registered `IEmbedder` instance.\n \n Plugins that need an embedder (e.g. `@objectstack/knowledge-turso`,\n * `@objectstack/knowledge-sqlite-vec`) SHOULD prefer resolving this\n * service over taking the embedder as a constructor option, so\n * operators can configure the embedder once (in `Settings → AI &\n * Embedder`) and have every knowledge adapter pick it up.\n \n Registered by `@objectstack/service-ai` when the operator selects a\n * non-`none` embedder provider in settings. If absent, knowledge\n * adapters fall back to their constructor-supplied embedder (or refuse\n * to start).\n */\nexport const EMBEDDER_SERVICE = 'embedder' as const;\n"]}

package/dist/index.d.mts CHANGED Viewed

@@ -6,7 +6,7 @@ import { z } from 'zod';
 import { b as MapSupportedField, c as MetadataCollectionInput } from './suggestions.zod-BTud5DPE.mjs';
 export { M as MAP_SUPPORTED_FIELDS, a as METADATA_ALIASES, f as findClosestMatches, d as formatSuggestion, e as formatZodError, g as formatZodIssue, n as normalizeMetadataCollection, h as normalizePluginMetadata, i as normalizeStackInput, o as objectStackErrorMap, s as safeParsePretty, k as suggestFieldType } from './suggestions.zod-BTud5DPE.mjs';
 export { ao as defineApp, ap as defineView } from './app.zod-D7fgbn5Z.mjs';
-export { n as defineFlow } from './flow.zod-BFCtGdYw.mjs';
+export { n as defineFlow } from './flow.zod-LPphSOut.mjs';
 export { d as Agent, S as Skill, T as Tool, r as defineAgent, s as defineSkill, t as defineTool } from './skill.zod-VSSbcYfM.mjs';
 export { P as PluginContext } from './plugin.zod-B3JTV0Ay.mjs';
 export { a as CronExpressionInputSchema, E as Expression, b as ExpressionDialect, c as ExpressionInput, d as ExpressionInputSchema, e as ExpressionMeta, f as ExpressionMetaSchema, g as ExpressionSchema, F, P, h as Predicate, i as PredicateInput, j as PredicateInputSchema, k as PredicateSchema, l as TemplateExpressionInputSchema, m as cel, n as cron, o as expression, t as tmpl } from './expression.zod-urRSkCql.mjs';
@@ -6608,6 +6608,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -6667,7 +6673,17 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
             actionIcon: z.ZodOptional<z.ZodString>;
             object: z.ZodOptional<z.ZodString>;
             filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+            compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                offset: z.ZodString;
+            }, z.core.$strip>]>>;
             categoryField: z.ZodOptional<z.ZodString>;
+            categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
             valueField: z.ZodOptional<z.ZodString>;
             aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 min: "min";
@@ -6987,6 +7003,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
                     left: "left";
                     right: "right";
                 }>>;
+                variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    primary: "primary";
+                    comparison: "comparison";
+                }>>>;
+                dashArray: z.ZodOptional<z.ZodString>;
+                opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             height: z.ZodOptional<z.ZodNumber>;
@@ -7987,12 +8009,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodEnum<{
                 script: "script";
-                connector_action: "connector_action";
+                loop: "loop";
                 start: "start";
                 end: "end";
+                connector_action: "connector_action";
                 decision: "decision";
                 assignment: "assignment";
-                loop: "loop";
                 create_record: "create_record";
                 update_record: "update_record";
                 delete_record: "delete_record";
@@ -16156,6 +16178,12 @@ declare const ObjectStackSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -16215,7 +16243,17 @@ declare const ObjectStackSchema: z.ZodObject<{
             actionIcon: z.ZodOptional<z.ZodString>;
             object: z.ZodOptional<z.ZodString>;
             filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+            compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                offset: z.ZodString;
+            }, z.core.$strip>]>>;
             categoryField: z.ZodOptional<z.ZodString>;
+            categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
             valueField: z.ZodOptional<z.ZodString>;
             aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 min: "min";
@@ -16535,6 +16573,12 @@ declare const ObjectStackSchema: z.ZodObject<{
                     left: "left";
                     right: "right";
                 }>>;
+                variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    primary: "primary";
+                    comparison: "comparison";
+                }>>>;
+                dashArray: z.ZodOptional<z.ZodString>;
+                opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             height: z.ZodOptional<z.ZodNumber>;
@@ -17535,12 +17579,12 @@ declare const ObjectStackSchema: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodEnum<{
                 script: "script";
-                connector_action: "connector_action";
+                loop: "loop";
                 start: "start";
                 end: "end";
+                connector_action: "connector_action";
                 decision: "decision";
                 assignment: "assignment";
-                loop: "loop";
                 create_record: "create_record";
                 update_record: "update_record";
                 delete_record: "delete_record";

package/dist/index.d.ts CHANGED Viewed

@@ -6,7 +6,7 @@ import { z } from 'zod';
 import { b as MapSupportedField, c as MetadataCollectionInput } from './suggestions.zod-BTud5DPE.js';
 export { M as MAP_SUPPORTED_FIELDS, a as METADATA_ALIASES, f as findClosestMatches, d as formatSuggestion, e as formatZodError, g as formatZodIssue, n as normalizeMetadataCollection, h as normalizePluginMetadata, i as normalizeStackInput, o as objectStackErrorMap, s as safeParsePretty, k as suggestFieldType } from './suggestions.zod-BTud5DPE.js';
 export { ao as defineApp, ap as defineView } from './app.zod-nPfH1TcS.js';
-export { n as defineFlow } from './flow.zod-BFCtGdYw.js';
+export { n as defineFlow } from './flow.zod-LPphSOut.js';
 export { d as Agent, S as Skill, T as Tool, r as defineAgent, s as defineSkill, t as defineTool } from './skill.zod-C-iIBnNt.js';
 export { P as PluginContext } from './plugin.zod-B3JTV0Ay.js';
 export { a as CronExpressionInputSchema, E as Expression, b as ExpressionDialect, c as ExpressionInput, d as ExpressionInputSchema, e as ExpressionMeta, f as ExpressionMetaSchema, g as ExpressionSchema, F, P, h as Predicate, i as PredicateInput, j as PredicateInputSchema, k as PredicateSchema, l as TemplateExpressionInputSchema, m as cel, n as cron, o as expression, t as tmpl } from './expression.zod-urRSkCql.js';
@@ -6608,6 +6608,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -6667,7 +6673,17 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
             actionIcon: z.ZodOptional<z.ZodString>;
             object: z.ZodOptional<z.ZodString>;
             filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+            compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                offset: z.ZodString;
+            }, z.core.$strip>]>>;
             categoryField: z.ZodOptional<z.ZodString>;
+            categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
             valueField: z.ZodOptional<z.ZodString>;
             aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 min: "min";
@@ -6987,6 +7003,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
                     left: "left";
                     right: "right";
                 }>>;
+                variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    primary: "primary";
+                    comparison: "comparison";
+                }>>>;
+                dashArray: z.ZodOptional<z.ZodString>;
+                opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             height: z.ZodOptional<z.ZodNumber>;
@@ -7987,12 +8009,12 @@ declare const ObjectStackDefinitionSchema: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodEnum<{
                 script: "script";
-                connector_action: "connector_action";
+                loop: "loop";
                 start: "start";
                 end: "end";
+                connector_action: "connector_action";
                 decision: "decision";
                 assignment: "assignment";
-                loop: "loop";
                 create_record: "create_record";
                 update_record: "update_record";
                 delete_record: "delete_record";
@@ -16156,6 +16178,12 @@ declare const ObjectStackSchema: z.ZodObject<{
                         left: "left";
                         right: "right";
                     }>>;
+                    variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                        primary: "primary";
+                        comparison: "comparison";
+                    }>>>;
+                    dashArray: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>;
                 colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
                 height: z.ZodOptional<z.ZodNumber>;
@@ -16215,7 +16243,17 @@ declare const ObjectStackSchema: z.ZodObject<{
             actionIcon: z.ZodOptional<z.ZodString>;
             object: z.ZodOptional<z.ZodString>;
             filter: z.ZodOptional<z.ZodType<FilterCondition, unknown, z.core.$ZodTypeInternals<FilterCondition, unknown>>>;
+            compareTo: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"previousPeriod">, z.ZodLiteral<"previousYear">, z.ZodObject<{
+                offset: z.ZodString;
+            }, z.core.$strip>]>>;
             categoryField: z.ZodOptional<z.ZodString>;
+            categoryGranularity: z.ZodOptional<z.ZodEnum<{
+                day: "day";
+                week: "week";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+            }>>;
             valueField: z.ZodOptional<z.ZodString>;
             aggregate: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
                 min: "min";
@@ -16535,6 +16573,12 @@ declare const ObjectStackSchema: z.ZodObject<{
                     left: "left";
                     right: "right";
                 }>>;
+                variant: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+                    primary: "primary";
+                    comparison: "comparison";
+                }>>>;
+                dashArray: z.ZodOptional<z.ZodString>;
+                opacity: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>;
             colors: z.ZodOptional<z.ZodArray<z.ZodString>>;
             height: z.ZodOptional<z.ZodNumber>;
@@ -17535,12 +17579,12 @@ declare const ObjectStackSchema: z.ZodObject<{
             id: z.ZodString;
             type: z.ZodEnum<{
                 script: "script";
-                connector_action: "connector_action";
+                loop: "loop";
                 start: "start";
                 end: "end";
+                connector_action: "connector_action";
                 decision: "decision";
                 assignment: "assignment";
-                loop: "loop";
                 create_record: "create_record";
                 update_record: "update_record";
                 delete_record: "delete_record";