@sixb/core 0.1.0 → 0.1.2

package/src/index.ts

@@ -24,6 +24,7 @@ export type {
   ObjectTypeWithPropertyTokens,
   ObjectTypeWithTokens,
   Ontology,
+  OntologyDefinitionCatalog,
   OntologyRegistryOptions,
   PrimitiveSchema,
   Property,
@@ -60,6 +61,7 @@ export type {
   ActionBlobContext,
   ActionBuilder,
   ActionDefinition,
+  ActionDefinitionCatalog,
   ActionEditsContext,
   ActionEditsHandler,
   ActionEffectsContext,
@@ -140,9 +142,12 @@ export type {
   DatasetColumnTypeOf,
   DatasetColumnUnionOf,
   DatasetDefinition,
+  DatasetPrimaryKey,
   DatasetSchema,
+  MergeChange,
 } from "./datasets"
 export {
+  change,
   col,
   DatasetValidationError,
   defineDataset,
@@ -154,7 +159,7 @@ export {
 
 export type { Broker, BrokerCursor } from "./broker"
 export { InMemoryBroker } from "./broker"
-export type { JsonValue } from "./json"
+export type { JsonValue, ReadonlyJsonValue } from "./json"
 export {
   assertJsonValue,
   cloneJsonValue,
@@ -328,6 +333,7 @@ export type {
   LogFields,
   Logger,
   LoggerProvider,
+  LoggingService,
   LogLevel,
   LogRecord,
   LogRunRef,
@@ -433,6 +439,7 @@ export type {
   GrantDefinition,
   GroupDefinition,
   GroupReference,
+  ManageGrant,
   MembershipOperation,
   MembershipPolicyDefinition,
   ObserveGrant,
@@ -441,7 +448,7 @@ export type {
   RoleDefinition,
   RunGrant,
   RunGrantTarget,
-  SecurityRegistry,
+  SecurityDefinitionCatalog,
   Selection,
   ViewGrant,
   ViewGrantTarget,
@@ -461,6 +468,12 @@ export {
 // The full storage-provider contract lives at `@sixb/core/storage`.
 
 export type {
+  CreateExecutionInput,
+  DurableExecutionExecutor,
+  DurableExecutionSource,
+  ExecutionRecord,
+  ExecutionStorage,
+  InMemoryStorageOptions,
   MigrationCapableStorage,
   MigrationReport,
   // `status()` returns these, so reading a migrator from here needs them; without them
@@ -585,12 +598,30 @@ export {
 // ── Connectors ─────────────────────────────────────────────
 
 export type {
+  AnyConnectorAdapter,
+  ConnectorAccessToken,
+  ConnectorAccountCandidate,
   ConnectorAdapter,
   ConnectorClient,
+  ConnectorConnectionClientContext,
+  ConnectorConnectionMetadata,
+  ConnectorConnectionOptions,
+  ConnectorConnectionOwner,
+  ConnectorConnectionSelector,
   ConnectorContext,
   ConnectorDefinition,
+  ConnectorOAuth2Authentication,
+  ConnectorOAuthCredentials,
+  ConnectorOAuthErrorKind,
+  ConnectorTokenSource,
+  OAuthConnectorAdapter,
+  OAuthConnectorAuthorizationContext,
+  OAuthConnectorAuthorizationUrlInput,
+  OAuthConnectorCodeExchangeInput,
+  ProjectConnectorConnectionOwner,
+  StaticConnectorDefinition,
 } from "./connectors"
-export { defineConnector } from "./connectors"
+export { ConnectorOAuthError, defineConnector } from "./connectors"
 
 // ── Webhooks ───────────────────────────────────────────────
 
@@ -628,7 +659,9 @@ export type {
   DatasetSyncTarget,
   RequestSyncRunInput,
   SyncBuilder,
+  SyncConnectorConnection,
   SyncDefinition,
+  SyncMode,
   SyncReadBuilder,
   SyncReadContext,
   SyncReadHandler,
@@ -745,6 +778,7 @@ export type {
   WorkflowRunRequestOptions,
   WorkflowRunRequestResult,
   WorkflowRunSource,
+  WorkflowRuntimeFacade,
   WorkflowScheduleMapper,
   WorkflowScheduleTriggerDefinition,
   WorkflowStepMapper,
@@ -766,16 +800,49 @@ export {
   WorkflowValidationError,
 } from "./workflows"
 
+// ── Execution ───────────────────────────────────────────────
+
+export type {
+  AuthorizablePrincipal,
+  AuthorizationRef,
+  ExecutionContext,
+  ExecutionExecutor,
+  ExecutionScope,
+  ExecutionSource,
+  KernelOperation,
+  RuntimeAuthorization,
+  TrustedPrimitiveKind,
+  TrustedPrimitiveRef,
+} from "./execution"
+
 // ── Runtime ─────────────────────────────────────────────────
 
+export type { ActionRunsRuntime, ActionsRuntime } from "./actions/execution"
 export type {
+  AgentRunListResult,
+  AgentRunsRuntime,
+  AgentRunView,
+  AgentsRuntime,
+  AgentThreadsRuntime,
+  ExecutionAgentRunResult,
+} from "./agents/execution"
+export type { BlobsRuntime } from "./blob-storage/execution"
+export type { ConnectorRuntime } from "./connectors/execution"
+export type { DatasetsRuntime } from "./datasets/execution"
+export type {
+  SixbActionPhaseFailedContext,
   SixbErrorContext,
   SixbErrorHandler,
   SixbEventDeliveryFailedContext,
   SixbFailedRun,
   SixbRuleEvaluationFailedContext,
   SixbRunFailedContext,
+  SixbRunFailureByKind,
+  SixbRunIdentityByKind,
 } from "./error-reporting/types"
+export type { SixbErrorCode, SixbFailure } from "./errors/types"
+export type { EventsRuntime } from "./events/execution"
+export type { LogsRuntime } from "./logging/execution"
 export type {
   OntologyMaintenanceCleanupSnapshot,
   OntologyMaintenanceHandle,
@@ -784,9 +851,21 @@ export type {
   OntologyOperationalStatus,
   SixbReadiness,
 } from "./maintenance"
+export type {
+  ExecutionObjectByIdHandle,
+  ExecutionObjectSet,
+  ObjectsRuntime,
+} from "./objects/execution"
+export type { PipelineRunsRuntime, PipelinesRuntime } from "./pipelines/execution"
+export type {
+  ProjectionRunsRuntime,
+  ProjectionsRuntime,
+} from "./projections/execution"
+export type { RuleStatesRuntime, RulesRuntime } from "./rules/execution"
 export type {
   BatchItemResult,
   CreateSixbOptions,
+  DefinitionCatalog,
   ListResult,
   ListResultWithoutTotal,
   ObjectByIdHandle,
@@ -808,12 +887,11 @@ export type {
   OntologySource,
   RegisteredObjectType,
   RegisteredValueTypes,
-  ScopedObjectByIdHandle,
-  ScopedObjectSet,
-  ScopedSixb,
-  SixbInstance,
-  SixbOptions,
-  SixbRuntimeContext,
+  SchedulerController,
+  Sixb,
+  SixbDefinitions,
+  SixbHostOptions,
+  SixbHostView,
   TelemetryAppendInput,
   TelemetryChannel,
   TelemetryHistoryInput,
@@ -830,9 +908,34 @@ export {
   OntologyValidationError,
   ProjectionValidationError,
   RuntimeError,
-  Sixb,
+  SixbHost,
   SyncValidationError,
 } from "./runtime"
+export type { SchedulesRuntime } from "./schedules/execution"
+export type {
+  ActionRunFailure,
+  ActionRunFailureCode,
+  ActionRunPhase,
+  AgentRunFailureCode,
+  PipelineRunFailureCode,
+  ProjectionRunFailureCode,
+  SyncRunFailureCode,
+  WebhookRunFailureCode,
+  WorkflowRunFailureCode,
+} from "./storage"
+export type { SyncRunsRuntime, SyncsRuntime } from "./syncs/execution"
+export type {
+  LatestWorkflowRunListResult,
+  ListWorkflowRunNodesInput,
+  WorkflowAgentNodeRunView,
+  WorkflowInterventionsRuntime,
+  WorkflowNodeRunListResult,
+  WorkflowNodeRunView,
+  WorkflowRunListResult,
+  WorkflowRunsRuntime,
+  WorkflowRunView,
+  WorkflowsRuntime,
+} from "./workflows/execution"
 
 // ── Agents ──────────────────────────────────────────────────
 
@@ -867,10 +970,21 @@ export type {
   AgentTextPart,
   AgentToolCallPart,
   AgentToolCallState,
+  AgentToolDefinition,
+  AgentToolDescriptionBuilder,
+  AgentToolHandler,
+  AgentToolHandlerResult,
+  AgentToolInputBuilder,
+  AgentToolInputSchema,
+  AgentToolRunBuilder,
+  AgentToolRunContext,
+  AgentToolRunInfo,
   AgentUiMessage,
   AgentUiMessagePart,
   AgentUiToolPart,
   DefineAgentConfig,
+  InferAgentToolInput,
+  InferAgentToolInputSchema,
   RequestAgentRunInput,
   RequestAgentRunResult,
 } from "./agents"
@@ -878,9 +992,11 @@ export {
   AGENT_REASONING_LEVELS,
   AgentDefinitionError,
   AgentRequestError,
+  AgentToolPublicError,
   agentContext,
   agentContextIdentity,
   defineAgent,
+  defineAgentTool,
   isAgentDefinition,
   MAX_AGENT_APP_STATE_ENTRY_BYTES,
   MAX_AGENT_APP_STATE_TOTAL_BYTES,
@@ -901,6 +1017,7 @@ export type {
   ObjectProjectionDefinition,
   ObjectProjectionTarget,
   ProjectionDefinition,
+  ProjectionDefinitionCatalog,
   ProjectionTarget,
   ProjectionTargetByKind,
   TelemetryProjectionDefinition,

package/src/json.ts

@@ -3,6 +3,13 @@ export type JsonObject = { [key: string]: JsonValue }
 export type JsonArray = JsonValue[]
 export type JsonValue = JsonPrimitive | JsonObject | JsonArray
 
+/** JSON-compatible input that also accepts readonly containers from typed application code. */
+export type ReadonlyJsonObject = {
+  readonly [key: string]: ReadonlyJsonValue
+}
+export type ReadonlyJsonArray = readonly ReadonlyJsonValue[]
+export type ReadonlyJsonValue = JsonPrimitive | ReadonlyJsonObject | ReadonlyJsonArray
+
 export function isJsonValue(value: unknown): value is JsonValue {
   return getInvalidJsonValueReason(value) === undefined
 }
@@ -14,15 +21,11 @@ export function assertJsonValue(value: unknown, label = "value"): asserts value
   }
 }
 
-export function cloneJsonValue(value: JsonValue): JsonValue {
-  assertJsonValue(value)
+export function cloneJsonValue(value: ReadonlyJsonValue, label = "value"): JsonValue {
+  assertJsonValue(value, label)
   return JSON.parse(JSON.stringify(value)) as JsonValue
 }
 
-export function jsonValuesEqual(left: unknown, right: unknown): boolean {
-  return stableJsonStringify(left) === stableJsonStringify(right)
-}
-
 export function stableJsonStringify(value: unknown): string {
   if (value === undefined) return "undefined"
   if (value === null || typeof value !== "object") return JSON.stringify(value)
@@ -74,7 +77,7 @@ export function getInvalidJsonValueReason(
     return undefined
   }
 
-  if (isPlainObject(value)) {
+  if (isPlainRecord(value)) {
     if (seen.has(value)) {
       return `${label} contains a circular reference`
     }
@@ -101,7 +104,7 @@ export function getInvalidJsonValueReason(
   return `${label} is ${describeNonJsonValue(value)}`
 }
 
-function isPlainObject(value: unknown): value is Record<string, unknown> {
+export function isPlainRecord(value: unknown): value is Record<string, unknown> {
   if (typeof value !== "object" || value === null || Array.isArray(value)) {
     return false
   }

package/src/lake-storage/definition-updates.ts

@@ -36,6 +36,7 @@ export function planDatasetDefinitionUpdate(
   requested: DatasetDefinition
 ): DatasetDefinitionUpdatePlan {
   assertSameDataset(existing, requested)
+  assertPrimaryKeyUnchanged(existing, requested)
 
   const addedColumns = getAddedColumnsAfterValidatingExistingColumns(existing, requested)
   assertAddedColumnsAreNullable(requested.id, addedColumns)
@@ -98,6 +99,24 @@ function assertSameDataset(existing: DatasetDefinition, requested: DatasetDefini
   }
 }
 
+function assertPrimaryKeyUnchanged(
+  existing: DatasetDefinition,
+  requested: DatasetDefinition
+): void {
+  const existingPrimaryKey = existing.primaryKey
+  const requestedPrimaryKey = requested.primaryKey
+  const unchanged =
+    existingPrimaryKey === undefined || requestedPrimaryKey === undefined
+      ? existingPrimaryKey === requestedPrimaryKey
+      : areDefinitionValuesEqual(existingPrimaryKey, requestedPrimaryKey)
+
+  if (!unchanged) {
+    throw new LakeStorageError(
+      `[SixbLake] Dataset '${requested.id}' cannot be redefined with an incompatible primaryKey. Primary keys are immutable.`
+    )
+  }
+}
+
 function getAddedColumnsAfterValidatingExistingColumns(
   existing: DatasetDefinition,
   requested: DatasetDefinition
@@ -193,6 +212,7 @@ function mergeDatasetDefinition(
   )
 
   const columns = [...cloneColumns(existing.schema.columns), ...cloneColumns(addedColumns)]
+  const primaryKey = existing.primaryKey
   const partitionBy = requested.partitionBy ?? existing.partitionBy
   const description = requested.description ?? existing.description
 
@@ -200,6 +220,7 @@ function mergeDatasetDefinition(
     kind: "dataset",
     id: requested.id,
     schema: { columns },
+    ...(primaryKey !== undefined ? { primaryKey: structuredClone(primaryKey) } : {}),
     ...(partitionBy !== undefined ? { partitionBy: [...partitionBy] } : {}),
     ...(description !== undefined ? { description } : {}),
   }