@sixb/core 0.1.4 → 0.1.6

package/dist/testing/materializer-storage-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"materializer-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/materializer-storage-contract.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,OAAO,EACb,MAAM,IAAI,CAAA;AAeX,MAAM,WAAW,mCAAmC,CAAC,QAAQ,SAAS,OAAO;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAgFD,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mCAAmC,CAAC,QAAQ,CAAC,GACtD,IAAI,CAmcN"}
+{"version":3,"file":"materializer-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/materializer-storage-contract.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,OAAO,EACb,MAAM,IAAI,CAAA;AAgBX,MAAM,WAAW,mCAAmC,CAAC,QAAQ,SAAS,OAAO;IAC3E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AA6FD,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mCAAmC,CAAC,QAAQ,CAAC,GACtD,IAAI,CA6lBN"}

package/dist/webhooks/internal.js

@@ -5,7 +5,7 @@ import {
 import {
   canRetryWebhookRun,
   isStorageSerializationFailure
-} from "../chunk-1wk20wn3.js";
+} from "../chunk-t624af60.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
@@ -14,11 +14,11 @@ import"../chunk-62c7t4jc.js";
 import {
   WebhookRunError
 } from "../chunk-ezake7g1.js";
-import"../chunk-a09jx26t.js";
+import"../chunk-fe5ev6mr.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-xdf9yswn.js";
-import"../chunk-nzw7sm3b.js";
+import"../chunk-1g8negke.js";
+import"../chunk-hceck7dq.js";
 import"../chunk-t9xghkva.js";
 import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
@@ -32,7 +32,7 @@ import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
 import"../chunk-t0jjkep3.js";
-import"../chunk-tkdscva6.js";
+import"../chunk-1e8m6yn3.js";
 import"../chunk-rhrbz7d4.js";
 import"../chunk-xwnf87e1.js";
 import"../chunk-f83ka50g.js";

package/dist/workflows/index.js

@@ -7,7 +7,7 @@ import {
   defineWorkflowStep,
   interventionField,
   unwrapWorkflowNodeFailure
-} from "../chunk-hbeh8j9w.js";
+} from "../chunk-n4spznws.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-74drx9gd.js";
@@ -40,36 +40,36 @@ import {
   validateWorkflowStepInput,
   validateWorkflowStepOutput,
   validateWorkflowsAtStartup
-} from "../chunk-c43qr6s0.js";
-import"../chunk-g13869yf.js";
-import"../chunk-cbkm2vam.js";
-import"../chunk-pn8n8sba.js";
+} from "../chunk-nva1xkjz.js";
+import"../chunk-tg5mee00.js";
+import"../chunk-8gv5z0zm.js";
+import"../chunk-5sxb1168.js";
 import"../chunk-4rh2m6zg.js";
 import"../chunk-xhy826cz.js";
-import"../chunk-7gw7mepb.js";
+import"../chunk-md8k0r54.js";
 import"../chunk-rte5sm3z.js";
 import"../chunk-qewtks41.js";
 import"../chunk-8b55ygje.js";
 import"../chunk-51fjndv0.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-nf4r78r4.js";
-import"../chunk-tycbzedm.js";
-import"../chunk-tek1qwgm.js";
-import"../chunk-afjpa2hs.js";
+import"../chunk-0hc5j867.js";
+import"../chunk-a44d5zgd.js";
+import"../chunk-nkbfrt0c.js";
 import"../chunk-96swp2wd.js";
 import"../chunk-f6erf2vv.js";
-import"../chunk-1wk20wn3.js";
+import"../chunk-t624af60.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
 import"../chunk-dysw7nsm.js";
 import"../chunk-62c7t4jc.js";
 import"../chunk-ezake7g1.js";
-import"../chunk-a09jx26t.js";
+import"../chunk-fe5ev6mr.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-xdf9yswn.js";
-import"../chunk-nzw7sm3b.js";
+import"../chunk-1g8negke.js";
+import"../chunk-hceck7dq.js";
 import"../chunk-t9xghkva.js";
 import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
@@ -87,7 +87,7 @@ import"../chunk-yt8wphsx.js";
 import"../chunk-rdeagz6b.js";
 import"../chunk-dm72y8wt.js";
 import"../chunk-t0jjkep3.js";
-import"../chunk-tkdscva6.js";
+import"../chunk-1e8m6yn3.js";
 import"../chunk-rhrbz7d4.js";
 import"../chunk-xwnf87e1.js";
 import"../chunk-f83ka50g.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixb/core",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "The ontology-first runtime for Sixb — objects, links, telemetry, actions, and provider contracts",
   "keywords": [
     "sixb",

package/src/actions/index.ts

@@ -7,7 +7,11 @@ export type {
 } from "./commit-edits"
 export { commitActionEdits, findActionEditCommit } from "./commit-edits"
 export { ActionDefinitionError, ActionEditCommitError } from "./errors"
-export type { ActionReadFacadeOptions, ActionReadObjectSetSource } from "./read-facade"
+export type {
+  ActionReadFacadeOptions,
+  ActionReadObjectSetSource,
+  ActionTelemetryReadSource,
+} from "./read-facade"
 export { ActionReadRecorder, createActionReadFacade } from "./read-facade"
 export type { ActionDefinitionCatalog, ActionRegistryOptions } from "./registry"
 export { ActionRegistry } from "./registry"
@@ -40,7 +44,12 @@ export type {
   ActionRuntimeFacade,
   ActionSubject,
   ActionTargetObject,
+  ActionTelemetryHistoryBatchInput,
+  ActionTelemetryHistoryBatchResult,
+  ActionTelemetryHistorySeriesInput,
   ActionTelemetryObjectSet,
+  ActionTelemetryPropertyToken,
+  ActionTelemetryReadFacade,
   ActionValidationContext,
   ActionValidator,
   ActionWritebackContext,

package/src/actions/read-facade.ts

@@ -8,12 +8,28 @@ import type {
   OntologyObjectRef,
 } from "../materializer"
 import { createLinkScopeFingerprint } from "../materializer"
+import { OntologyValidationError } from "../ontology/errors"
 import type { ObjectTypeWithPropertyTokens } from "../ontology/tokens"
 import type { ValueType } from "../ontology/types"
+import {
+  assertPropertyTokenBelongsToObjectType,
+  assertTelemetryProperty,
+} from "../ontology/validation"
+import { RuntimeError } from "../runtime/errors"
 import type { ObjectSetListInput } from "../runtime/types"
-import type { ObjectLinkRow, ObjectRow } from "../storage"
+import type {
+  ObjectLinkRow,
+  ObjectRow,
+  TimeseriesHistoryBatchInput,
+  TimeseriesHistoryBatchResult,
+} from "../storage"
 import type { ActionReadDependencies } from "./commit-edits"
-import type { ActionReadFacade, ActionReadObjectSet } from "./types"
+import type {
+  ActionReadFacade,
+  ActionReadObjectSet,
+  ActionTelemetryHistorySeriesInput,
+  ActionTelemetryReadFacade,
+} from "./types"
 
 export type ActionReadObjectSetSource = {
   get(id: string): Promise<unknown>
@@ -25,13 +41,22 @@ export type ActionReadObjectSetSource = {
   }
 }
 
+/** Runtime leaves used by the Action telemetry read adapter. */
+export interface ActionTelemetryReadSource {
+  readonly resolveObjectType: (objectTypeId: string) => ObjectTypeWithPropertyTokens
+  readonly getHistoryBatch: (
+    input: Omit<TimeseriesHistoryBatchInput, "projectId">
+  ) => Promise<readonly TimeseriesHistoryBatchResult[]>
+}
+
 /**
  * Records the exact state an Action handler observed while reading.
  *
  * A handler that reads one dependency twice keeps the first observation: the commit must fail when
  * current state no longer matches what the decision was made against, and the later read may already
  * reflect the handler's own intent. Arbitrary query phantoms stay out of this release — `query()` and
- * `list()` results are not turned into dependencies.
+ * `list()` results are not turned into dependencies. Telemetry history is also a call-level snapshot,
+ * not an edit dependency.
  */
 export class ActionReadRecorder {
   private readonly objects = new Map<string, ExpectedObjectRevision>()
@@ -130,6 +155,8 @@ export interface ActionReadFacadeOptions {
    * recorded scopes.
    */
   readonly resolveLinkIds: (objectTypeId: string) => readonly string[]
+  /** Canonical authorized telemetry history leaf. Omitted only by isolated facade consumers. */
+  readonly telemetry?: ActionTelemetryReadSource
 }
 
 export function createActionReadFacade(
@@ -139,6 +166,7 @@ export function createActionReadFacade(
   options?: ActionReadFacadeOptions
 ): ActionReadFacade {
   const facade = {
+    telemetry: createActionTelemetryReadFacade(options?.telemetry),
     objects<const TObjectType extends ObjectTypeWithPropertyTokens>(objectType: TObjectType) {
       return createActionReadObjectSetAdapter<TObjectType>(
         objectType,
@@ -151,6 +179,100 @@ export function createActionReadFacade(
   return facade as ActionReadFacade
 }
 
+function createActionTelemetryReadFacade(
+  source: ActionTelemetryReadSource | undefined
+): ActionTelemetryReadFacade<readonly ValueType[]> {
+  const facade = {
+    async historyBatch(input: {
+      readonly series: readonly ActionTelemetryHistorySeriesInput[]
+      readonly from?: Date
+      readonly to?: Date
+      readonly limitPerSeries?: number
+      readonly order?: "asc" | "desc"
+    }) {
+      if (!source) {
+        throw new RuntimeError(
+          "[Sixb] Action telemetry history requires a configured telemetry read source."
+        )
+      }
+      if (input.series.length === 0) {
+        return []
+      }
+
+      const requestedSeries = input.series.map((entry) => {
+        const objectType = source.resolveObjectType(entry.property.objectTypeId)
+        assertPropertyTokenBelongsToObjectType(objectType, entry.property)
+        const registeredProperty = objectType.properties.find(
+          (property) => property.id === entry.property.id
+        )
+        if (!registeredProperty) {
+          throw new OntologyValidationError(
+            `[Sixb] Unknown property '${entry.property.id}' for object type '${objectType.id}'`
+          )
+        }
+        assertTelemetryProperty(registeredProperty)
+        return {
+          objectTypeId: objectType.id,
+          objectId: entry.objectId,
+          propertyId: registeredProperty.id,
+        }
+      })
+
+      const results = await source.getHistoryBatch({
+        series: requestedSeries,
+        ...(input.from !== undefined ? { from: input.from } : {}),
+        ...(input.to !== undefined ? { to: input.to } : {}),
+        ...(input.limitPerSeries !== undefined ? { limitPerSeries: input.limitPerSeries } : {}),
+        ...(input.order !== undefined ? { order: input.order } : {}),
+      })
+      assertTelemetryBatchResultMatchesRequest(requestedSeries, results)
+
+      return input.series.map((entry, index) => ({
+        objectId: entry.objectId,
+        property: entry.property,
+        points: results[index].points.map((point) => ({
+          value: point.value,
+          at: point.at,
+          ...(point.unit !== undefined ? { unit: point.unit } : {}),
+        })),
+      }))
+    },
+  }
+
+  // Cast needed at the generic token boundary: the implementation deliberately manipulates raw
+  // provider values while the public facade maps every tuple position back to its property token.
+  return facade as unknown as ActionTelemetryReadFacade<readonly ValueType[]>
+}
+
+function assertTelemetryBatchResultMatchesRequest(
+  requested: readonly {
+    readonly objectTypeId: string
+    readonly objectId: string
+    readonly propertyId: string
+  }[],
+  results: readonly TimeseriesHistoryBatchResult[]
+): void {
+  if (results.length !== requested.length) {
+    throw new RuntimeError(
+      `[Sixb] Telemetry history provider returned ${results.length} batch results for ${requested.length} requested series.`
+    )
+  }
+
+  for (let index = 0; index < requested.length; index += 1) {
+    const expected = requested[index]
+    const actual = results[index]
+    if (
+      actual.objectTypeId !== expected.objectTypeId ||
+      actual.objectId !== expected.objectId ||
+      actual.propertyId !== expected.propertyId
+    ) {
+      throw new RuntimeError(
+        `[Sixb] Telemetry history provider returned an unexpected series at batch index ${index}.`
+      )
+    }
+  }
+}
+
 function createActionReadObjectSetAdapter<TObjectType extends ObjectTypeWithPropertyTokens>(
   objectType: TObjectType,
   objectSet: ActionReadObjectSetSource,

package/src/actions/types/context.ts

@@ -7,8 +7,9 @@ import type {
   EffectiveObjectChange,
   OntologyOperationOutcome,
 } from "../../materializer"
-import type { ObjectType, ValueType } from "../../ontology"
-import type { LinkToken, ObjectTypeWithPropertyTokens } from "../../ontology/tokens"
+import type { ObjectType, Property, ValueType } from "../../ontology"
+import type { InferPropertyUnit, InferPropertyValue } from "../../ontology/inference"
+import type { LinkToken, ObjectTypeWithPropertyTokens, PropertyToken } from "../../ontology/tokens"
 import type {
   ListResult,
   ObjectQueryBuilder,
@@ -103,7 +104,73 @@ export interface ActionReadObjectSet<
   byId(id: string): ActionReadObjectByIdHandle<TObjectType, TValueTypes>
 }
 
+/** A telemetry-mode ontology property accepted by Action history reads. */
+export type ActionTelemetryPropertyToken = PropertyToken<
+  string,
+  string,
+  Property & { readonly mode: "telemetry" }
+>
+
+export type ActionTelemetryHistorySeriesInput<
+  TProperty extends ActionTelemetryPropertyToken = ActionTelemetryPropertyToken,
+> = {
+  readonly objectId: string
+  readonly property: TProperty
+}
+
+export interface ActionTelemetryHistoryBatchInput<
+  TSeries extends
+    readonly ActionTelemetryHistorySeriesInput[] = readonly ActionTelemetryHistorySeriesInput[],
+> {
+  /** Series are returned in this exact order, including duplicate entries. */
+  readonly series: TSeries
+  readonly from?: Date
+  readonly to?: Date
+  /** Optional cap applied independently to every requested series. */
+  readonly limitPerSeries?: number
+  /** Points are oldest first by default. */
+  readonly order?: "asc" | "desc"
+}
+
+/**
+ * One batch result per requested series, preserving tuple positions and property-specific types.
+ */
+export type ActionTelemetryHistoryBatchResult<
+  TSeries extends
+    readonly ActionTelemetryHistorySeriesInput[] = readonly ActionTelemetryHistorySeriesInput[],
+  TValueTypes extends readonly ValueType[] = readonly ValueType[],
+> = {
+  readonly [TIndex in keyof TSeries]: TSeries[TIndex] extends ActionTelemetryHistorySeriesInput<
+    infer TProperty
+  >
+    ? {
+        readonly objectId: TSeries[TIndex]["objectId"]
+        readonly property: TProperty
+        readonly points: readonly {
+          readonly value: InferPropertyValue<TProperty["property"], TValueTypes>
+          readonly at: Date
+          readonly unit?: InferPropertyUnit<TProperty["property"], TValueTypes>
+        }[]
+      }
+    : never
+}
+
+export type ActionTelemetryReadFacade<
+  TValueTypes extends readonly ValueType[] = readonly ValueType[],
+> = {
+  /**
+   * Read several telemetry series in one provider call.
+   *
+   * This is a snapshot read for the call. It is intentionally not added to the Action edit
+   * dependency fence; use a fixed `to` cutoff to keep the report window stable across retries.
+   */
+  historyBatch<const TSeries extends readonly ActionTelemetryHistorySeriesInput[]>(
+    input: ActionTelemetryHistoryBatchInput<TSeries>
+  ): Promise<ActionTelemetryHistoryBatchResult<TSeries, TValueTypes>>
+}
+
 export interface ActionReadFacade<TValueTypes extends readonly ValueType[] = readonly ValueType[]> {
+  readonly telemetry: ActionTelemetryReadFacade<TValueTypes>
   objects<const TObjectType extends ObjectTypeWithPropertyTokens>(
     objectType: TObjectType
   ): ActionReadObjectSet<TObjectType, TValueTypes, ObjectTypeWithPropertyTokens>

package/src/actions/types/definitions.ts

@@ -1,3 +1,4 @@
+import type { ReadonlyJsonValue } from "../../json"
 import type { ObjectTypeWithPropertyTokens } from "../../ontology/tokens"
 import type {
   ActionEditsHandler,
@@ -13,6 +14,18 @@ import type {
 } from "./handlers"
 import type { ActionParamsConfig, InferActionParams } from "./params"
 
+// Validate fields structurally so JSON-shaped interfaces do not need an index signature.
+// Builders infer the original result first, then check it without widening via NoInfer.
+type WritebackJsonValue<T> = T extends ReadonlyJsonValue
+  ? T
+  : T extends (...args: never[]) => unknown
+    ? never
+    : T extends object
+      ? { [K in keyof T]: WritebackJsonValue<T[K]> }
+      : never
+
+type WritebackResult<T> = T extends ReturnType<() => void> ? T : WritebackJsonValue<T>
+
 export interface BaseActionDefinition<
   TId extends string = string,
   TParams extends ActionParamsConfig = ActionParamsConfig,
@@ -136,7 +149,11 @@ export interface GlobalActionPhaseBuilder<TId extends string, TParams extends Ac
     validator: GlobalActionValidator<InferActionParams<TParams>>
   ): GlobalActionPhaseBuilder<TId, TParams>
   writeback<const TResult>(
-    handler: GlobalActionWritebackHandler<InferActionParams<TParams>, TResult>
+    handler: GlobalActionWritebackHandler<InferActionParams<TParams>, TResult> &
+      GlobalActionWritebackHandler<
+        InferActionParams<TParams>,
+        WritebackResult<NoInfer<Awaited<TResult>>>
+      >
   ): GlobalActionAfterWritebackBuilder<TId, TParams, TResult>
   edits<const TResult extends ActionNoResultHandlerResult>(
     handler: GlobalActionEditsHandler<InferActionParams<TParams>, undefined, TResult>
@@ -152,7 +169,12 @@ export interface ObjectActionPhaseBuilder<
     validator: ActionValidator<TObjectType, InferActionParams<TParams>>
   ): ObjectActionPhaseBuilder<TId, TObjectType, TParams>
   writeback<const TResult>(
-    handler: ActionWritebackHandler<TObjectType, InferActionParams<TParams>, TResult>
+    handler: ActionWritebackHandler<TObjectType, InferActionParams<TParams>, TResult> &
+      ActionWritebackHandler<
+        TObjectType,
+        InferActionParams<TParams>,
+        WritebackResult<NoInfer<Awaited<TResult>>>
+      >
   ): ObjectActionAfterWritebackBuilder<TId, TObjectType, TParams, TResult>
   edits<const TResult extends ActionNoResultHandlerResult>(
     handler: ActionEditsHandler<TObjectType, InferActionParams<TParams>, undefined, TResult>

package/src/agents/types.ts

@@ -45,6 +45,8 @@ export interface AgentLoopConfig {
     readonly maxSteps?: number
   }
   readonly context?: AgentContextConfig
+  /** Automatic provider prompt caching. Defaults to `auto`; use `off` to opt out. */
+  readonly caching?: "auto" | "off"
 }
 
 type Simplify<T> = { [K in keyof T]: T[K] } & {}

package/src/agents/validation.ts

@@ -171,6 +171,9 @@ export function resolveAgentLoopConfig(
       "[Sixb] Agent loop.stopWhen.maxSteps must be a positive safe integer."
     )
   }
+  if (loop.caching !== undefined && loop.caching !== "auto" && loop.caching !== "off") {
+    throw new AgentDefinitionError("[Sixb] Agent loop.caching must be 'auto' or 'off'.")
+  }
 
   const context = loop.context ? snapshotAgentContextConfig(loop.context) : undefined
   return Object.freeze({
@@ -178,6 +181,7 @@ export function resolveAgentLoopConfig(
       ? {}
       : { stopWhen: Object.freeze({ ...(maxSteps === undefined ? {} : { maxSteps }) }) }),
     ...(context === undefined ? {} : { context }),
+    ...(loop.caching === undefined ? {} : { caching: loop.caching }),
   })
 }
 

package/src/auth/index.ts

@@ -127,6 +127,7 @@ export type {
   ReactivateMemberInput,
   ReactivateMemberResult,
   ResolvedAuthConfig,
+  RevealedInvitationLink,
   RevokeAccessTokenResult,
   RevokeInvitationInput,
   RevokeInvitationResult,

package/src/auth/runtime.ts

@@ -1242,6 +1242,7 @@ export class AuthRuntime {
         audience: deliveryAudience,
         returnTo: options.delivery?.returnTo ?? sanitizeReturnTo(input.returnTo),
         requestOrigin: options.delivery?.requestOrigin ?? new URL(request.url).origin,
+        revealLink: input.revealLink,
         now,
       })
     } catch (error) {
@@ -1249,6 +1250,13 @@ export class AuthRuntime {
       throw error
     }
 
+    // The runtime owns the disclosure boundary even for third-party strategies. A strategy that
+    // accidentally returns a link must not expose it unless the caller opted in explicitly.
+    delivery = {
+      status: delivery.status,
+      ...(input.revealLink && delivery.link ? { link: delivery.link } : {}),
+    }
+
     if (delivery.status === "not_supported") {
       return { invitation, delivery }
     }

package/src/auth/strategy.ts

@@ -38,6 +38,7 @@ export type {
   OidcCallbackResult,
   OidcStartSignInInput,
   OidcStartSignInResult,
+  RevealedInvitationLink,
 } from "./types"
 export {
   isInvitationDeliveryAuthStrategy,

package/src/auth/types.ts

@@ -73,6 +73,8 @@ export interface InvitationDeliveryInput {
   readonly audience: AuthSessionAudience
   readonly returnTo: string
   readonly requestOrigin: string
+  /** Return the delivered link once so the inviter can copy it through an approved channel. */
+  readonly revealLink?: boolean
   readonly now?: Date
 }
 
@@ -80,8 +82,18 @@ export type AuthEmailDeliveryStatus = "sent" | "skipped" | "rate_limited"
 
 export type InviteDeliveryStatus = AuthEmailDeliveryStatus | "not_supported"
 
+export interface RevealedInvitationLink {
+  readonly url: string
+  readonly expiresAt?: Date
+}
+
 export interface InviteDeliveryResult {
   readonly status: InviteDeliveryStatus
+  /**
+   * Present only when the caller explicitly requests `revealLink`. Treat this as a credential:
+   * never persist it or include it in list responses, logs, or analytics.
+   */
+  readonly link?: RevealedInvitationLink
 }
 
 export interface InvitationDeliveryAuthStrategy extends AuthStrategy {
@@ -214,6 +226,8 @@ export interface InviteUserInput {
   readonly groupIds?: readonly string[]
   readonly expiresAt?: Date
   readonly returnTo?: string
+  /** Reveal the delivered link once in the result. Defaults to false. */
+  readonly revealLink?: boolean
 }
 
 export interface InviteUserResult {

package/src/index.ts

@@ -77,7 +77,12 @@ export type {
   ActionRuntimeFacade,
   ActionSubject,
   ActionTargetObject,
+  ActionTelemetryHistoryBatchInput,
+  ActionTelemetryHistoryBatchResult,
+  ActionTelemetryHistorySeriesInput,
   ActionTelemetryObjectSet,
+  ActionTelemetryPropertyToken,
+  ActionTelemetryReadFacade,
   ActionValidationContext,
   ActionValidator,
   ActionWritebackContext,

package/src/ontology/internal.ts

@@ -1,3 +1,3 @@
 export type { SchemaJsonSchema } from "./json-schema"
-export { schemaRecordToJsonSchema } from "./json-schema"
+export { schemaFieldsToJsonSchema, schemaRecordToJsonSchema } from "./json-schema"
 export { createLinkTokenMap, createPropertyTokenMap } from "./tokens"

package/src/ontology/json-schema.ts

@@ -4,20 +4,42 @@ import type { Schema, ValueType } from "./types"
 
 export type SchemaJsonSchema = Readonly<Record<string, unknown>>
 
+export interface SchemaJsonField {
+  readonly schema: SchemaOrRef
+  readonly required?: boolean
+  readonly nullable?: boolean
+}
+
 /** Convert a record of Sixb schemas into the strict JSON object schema used by model outputs. */
 export function schemaRecordToJsonSchema(input: {
   readonly shape: Readonly<Record<string, SchemaOrRef>>
   readonly valueTypesById: ReadonlyMap<string, ValueType>
 }): SchemaJsonSchema {
+  return schemaFieldsToJsonSchema({
+    fields: Object.fromEntries(
+      Object.entries(input.shape).map(([field, schema]) => [field, { schema, required: true }])
+    ),
+    valueTypesById: input.valueTypesById,
+  })
+}
+
+/** Convert configured fields into the strict JSON object schema accepted at runtime. */
+export function schemaFieldsToJsonSchema(input: {
+  readonly fields: Readonly<Record<string, SchemaJsonField>>
+  readonly valueTypesById: ReadonlyMap<string, ValueType>
+}): SchemaJsonSchema {
+  const required = Object.entries(input.fields)
+    .filter(([, field]) => field.required === true)
+    .map(([field]) => field)
   return {
     type: "object",
     properties: Object.fromEntries(
-      Object.entries(input.shape).map(([field, schema]) => [
-        field,
-        schemaOrRefJsonSchema(schema, input.valueTypesById, new Set()),
-      ])
+      Object.entries(input.fields).map(([fieldId, field]) => {
+        const fieldSchema = schemaOrRefJsonSchema(field.schema, input.valueTypesById, new Set())
+        return [fieldId, field.nullable ? { anyOf: [fieldSchema, { type: "null" }] } : fieldSchema]
+      })
     ),
-    required: Object.keys(input.shape),
+    ...(required.length > 0 ? { required } : {}),
     additionalProperties: false,
   }
 }

package/src/storage/index.ts

@@ -422,6 +422,7 @@ export type {
   MaterializationClassificationWorkRecord,
   MaterializationEventWorkRecord,
   MaterializationIncidentObjectWorkRecord,
+  MaterializationLinkScopeRevision,
   MaterializationLinkScopeState,
   MaterializationLinkState,
   MaterializationObjectExistence,