@sixb/core 0.1.4 → 0.1.5

package/dist/ontology/internal.js

@@ -15,13 +15,20 @@ import"../chunk-y64skrwp.js";
 
 // src/ontology/json-schema.ts
 function schemaRecordToJsonSchema(input) {
+  return schemaFieldsToJsonSchema({
+    fields: Object.fromEntries(Object.entries(input.shape).map(([field, schema]) => [field, { schema, required: true }])),
+    valueTypesById: input.valueTypesById
+  });
+}
+function schemaFieldsToJsonSchema(input) {
+  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)
-    ])),
-    required: Object.keys(input.shape),
+    properties: Object.fromEntries(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.length > 0 ? { required } : {},
     additionalProperties: false
   };
 }
@@ -112,8 +119,9 @@ function schemaJsonSchema(schema, valueTypesById, resolving) {
 }
 export {
   schemaRecordToJsonSchema,
+  schemaFieldsToJsonSchema,
   createPropertyTokenMap,
   createLinkTokenMap
 };
 
-//# debugId=B0497B26F71F7BE164756E2164756E21
+//# debugId=1F2F8E74CCDF230264756E2164756E21

package/dist/ontology/internal.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../src/ontology/json-schema.ts"],
   "sourcesContent": [
-    "import { OntologyValidationError } from \"./errors\"\nimport { isObjectRefSchema, type SchemaOrRef } from \"./refs\"\nimport type { Schema, ValueType } from \"./types\"\n\nexport type SchemaJsonSchema = Readonly<Record<string, unknown>>\n\n/** Convert a record of Sixb schemas into the strict JSON object schema used by model outputs. */\nexport function schemaRecordToJsonSchema(input: {\n  readonly shape: Readonly<Record<string, SchemaOrRef>>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n}): SchemaJsonSchema {\n  return {\n    type: \"object\",\n    properties: Object.fromEntries(\n      Object.entries(input.shape).map(([field, schema]) => [\n        field,\n        schemaOrRefJsonSchema(schema, input.valueTypesById, new Set()),\n      ])\n    ),\n    required: Object.keys(input.shape),\n    additionalProperties: false,\n  }\n}\n\nfunction schemaOrRefJsonSchema(\n  schema: SchemaOrRef,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  resolving: ReadonlySet<string>\n): SchemaJsonSchema {\n  if (isObjectRefSchema(schema)) {\n    return {\n      type: \"object\",\n      properties: {\n        objectTypeId: { type: \"string\", const: schema.objectTypeId },\n        primaryId: { type: \"string\" },\n      },\n      required: [\"objectTypeId\", \"primaryId\"],\n      additionalProperties: false,\n    }\n  }\n  return schemaJsonSchema(schema, valueTypesById, resolving)\n}\n\nfunction schemaJsonSchema(\n  schema: Schema,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  resolving: ReadonlySet<string>\n): SchemaJsonSchema {\n  if (typeof schema === \"string\") {\n    switch (schema) {\n      case \"string\":\n        return { type: \"string\" }\n      case \"integer\":\n        return { type: \"integer\" }\n      case \"double\":\n        return { type: \"number\" }\n      case \"decimal\":\n        return { type: \"string\", pattern: \"^[+-]?\\\\d+(?:\\\\.\\\\d+)?$\" }\n      case \"boolean\":\n        return { type: \"boolean\" }\n      case \"date\":\n        return { type: \"string\", format: \"date\" }\n      case \"timestamp\":\n        return { type: \"string\", format: \"date-time\" }\n      case \"uuid\":\n        return { type: \"string\", format: \"uuid\" }\n      case \"fileRef\":\n        return {\n          type: \"object\",\n          properties: {\n            blobId: { type: \"string\" },\n            digest: { type: \"string\", pattern: \"^sha256:[a-fA-F0-9]{64}$\" },\n            sizeBytes: { type: \"integer\", minimum: 0 },\n            fileName: { type: \"string\" },\n            mediaType: { type: \"string\" },\n            logicalPath: { type: \"string\" },\n          },\n          required: [\"blobId\", \"digest\", \"sizeBytes\"],\n          additionalProperties: false,\n        }\n    }\n  }\n\n  if (schema.type === \"enum\") return { enum: schema.values }\n  if (schema.type === \"array\") {\n    return { type: \"array\", items: schemaJsonSchema(schema.items, valueTypesById, resolving) }\n  }\n  if (schema.type === \"map\") {\n    return {\n      type: \"object\",\n      additionalProperties: schemaJsonSchema(schema.valueSchema, valueTypesById, resolving),\n    }\n  }\n  if (schema.type === \"object\") {\n    const required: string[] = []\n    const properties = Object.fromEntries(\n      Object.entries(schema.properties).map(([fieldId, field]) => {\n        if (field.required) required.push(fieldId)\n        const fieldSchema = schemaJsonSchema(field.schema, valueTypesById, resolving)\n        return [fieldId, field.nullable ? { anyOf: [fieldSchema, { type: \"null\" }] } : fieldSchema]\n      })\n    )\n    return {\n      type: \"object\",\n      properties,\n      ...(required.length > 0 ? { required } : {}),\n      additionalProperties: false,\n    }\n  }\n\n  const valueTypeId = schema.valueTypeId\n  if (resolving.has(valueTypeId)) {\n    throw new OntologyValidationError(\n      `Structured output contains a recursive value type '${valueTypeId}'.`\n    )\n  }\n  const resolved = schema._resolved ?? valueTypesById.get(valueTypeId)?.schema\n  if (!resolved) {\n    throw new OntologyValidationError(\n      `Structured output references unknown value type '${valueTypeId}'.`\n    )\n  }\n  return schemaJsonSchema(resolved, valueTypesById, new Set([...resolving, valueTypeId]))\n}\n"
+    "import { OntologyValidationError } from \"./errors\"\nimport { isObjectRefSchema, type SchemaOrRef } from \"./refs\"\nimport type { Schema, ValueType } from \"./types\"\n\nexport type SchemaJsonSchema = Readonly<Record<string, unknown>>\n\nexport interface SchemaJsonField {\n  readonly schema: SchemaOrRef\n  readonly required?: boolean\n  readonly nullable?: boolean\n}\n\n/** Convert a record of Sixb schemas into the strict JSON object schema used by model outputs. */\nexport function schemaRecordToJsonSchema(input: {\n  readonly shape: Readonly<Record<string, SchemaOrRef>>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n}): SchemaJsonSchema {\n  return schemaFieldsToJsonSchema({\n    fields: Object.fromEntries(\n      Object.entries(input.shape).map(([field, schema]) => [field, { schema, required: true }])\n    ),\n    valueTypesById: input.valueTypesById,\n  })\n}\n\n/** Convert configured fields into the strict JSON object schema accepted at runtime. */\nexport function schemaFieldsToJsonSchema(input: {\n  readonly fields: Readonly<Record<string, SchemaJsonField>>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n}): SchemaJsonSchema {\n  const required = Object.entries(input.fields)\n    .filter(([, field]) => field.required === true)\n    .map(([field]) => field)\n  return {\n    type: \"object\",\n    properties: Object.fromEntries(\n      Object.entries(input.fields).map(([fieldId, field]) => {\n        const fieldSchema = schemaOrRefJsonSchema(field.schema, input.valueTypesById, new Set())\n        return [fieldId, field.nullable ? { anyOf: [fieldSchema, { type: \"null\" }] } : fieldSchema]\n      })\n    ),\n    ...(required.length > 0 ? { required } : {}),\n    additionalProperties: false,\n  }\n}\n\nfunction schemaOrRefJsonSchema(\n  schema: SchemaOrRef,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  resolving: ReadonlySet<string>\n): SchemaJsonSchema {\n  if (isObjectRefSchema(schema)) {\n    return {\n      type: \"object\",\n      properties: {\n        objectTypeId: { type: \"string\", const: schema.objectTypeId },\n        primaryId: { type: \"string\" },\n      },\n      required: [\"objectTypeId\", \"primaryId\"],\n      additionalProperties: false,\n    }\n  }\n  return schemaJsonSchema(schema, valueTypesById, resolving)\n}\n\nfunction schemaJsonSchema(\n  schema: Schema,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  resolving: ReadonlySet<string>\n): SchemaJsonSchema {\n  if (typeof schema === \"string\") {\n    switch (schema) {\n      case \"string\":\n        return { type: \"string\" }\n      case \"integer\":\n        return { type: \"integer\" }\n      case \"double\":\n        return { type: \"number\" }\n      case \"decimal\":\n        return { type: \"string\", pattern: \"^[+-]?\\\\d+(?:\\\\.\\\\d+)?$\" }\n      case \"boolean\":\n        return { type: \"boolean\" }\n      case \"date\":\n        return { type: \"string\", format: \"date\" }\n      case \"timestamp\":\n        return { type: \"string\", format: \"date-time\" }\n      case \"uuid\":\n        return { type: \"string\", format: \"uuid\" }\n      case \"fileRef\":\n        return {\n          type: \"object\",\n          properties: {\n            blobId: { type: \"string\" },\n            digest: { type: \"string\", pattern: \"^sha256:[a-fA-F0-9]{64}$\" },\n            sizeBytes: { type: \"integer\", minimum: 0 },\n            fileName: { type: \"string\" },\n            mediaType: { type: \"string\" },\n            logicalPath: { type: \"string\" },\n          },\n          required: [\"blobId\", \"digest\", \"sizeBytes\"],\n          additionalProperties: false,\n        }\n    }\n  }\n\n  if (schema.type === \"enum\") return { enum: schema.values }\n  if (schema.type === \"array\") {\n    return { type: \"array\", items: schemaJsonSchema(schema.items, valueTypesById, resolving) }\n  }\n  if (schema.type === \"map\") {\n    return {\n      type: \"object\",\n      additionalProperties: schemaJsonSchema(schema.valueSchema, valueTypesById, resolving),\n    }\n  }\n  if (schema.type === \"object\") {\n    const required: string[] = []\n    const properties = Object.fromEntries(\n      Object.entries(schema.properties).map(([fieldId, field]) => {\n        if (field.required) required.push(fieldId)\n        const fieldSchema = schemaJsonSchema(field.schema, valueTypesById, resolving)\n        return [fieldId, field.nullable ? { anyOf: [fieldSchema, { type: \"null\" }] } : fieldSchema]\n      })\n    )\n    return {\n      type: \"object\",\n      properties,\n      ...(required.length > 0 ? { required } : {}),\n      additionalProperties: false,\n    }\n  }\n\n  const valueTypeId = schema.valueTypeId\n  if (resolving.has(valueTypeId)) {\n    throw new OntologyValidationError(\n      `Structured output contains a recursive value type '${valueTypeId}'.`\n    )\n  }\n  const resolved = schema._resolved ?? valueTypesById.get(valueTypeId)?.schema\n  if (!resolved) {\n    throw new OntologyValidationError(\n      `Structured output references unknown value type '${valueTypeId}'.`\n    )\n  }\n  return schemaJsonSchema(resolved, valueTypesById, new Set([...resolving, valueTypeId]))\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "B0497B26F71F7BE164756E2164756E21",
+  "mappings": "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",
+  "debugId": "1F2F8E74CCDF230264756E2164756E21",
   "names": []
 }

package/dist/ontology/json-schema.d.ts

@@ -1,9 +1,19 @@
 import { type SchemaOrRef } from "./refs";
 import type { 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 declare function schemaRecordToJsonSchema(input: {
     readonly shape: Readonly<Record<string, SchemaOrRef>>;
     readonly valueTypesById: ReadonlyMap<string, ValueType>;
 }): SchemaJsonSchema;
+/** Convert configured fields into the strict JSON object schema accepted at runtime. */
+export declare function schemaFieldsToJsonSchema(input: {
+    readonly fields: Readonly<Record<string, SchemaJsonField>>;
+    readonly valueTypesById: ReadonlyMap<string, ValueType>;
+}): SchemaJsonSchema;
 //# sourceMappingURL=json-schema.d.ts.map

package/dist/ontology/json-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/ontology/json-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhE,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACxD,GAAG,gBAAgB,CAYnB"}
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/ontology/json-schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC5D,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IACrD,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACxD,GAAG,gBAAgB,CAOnB;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAC1D,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CACxD,GAAG,gBAAgB,CAenB"}

package/dist/pipelines/index.js

@@ -4,7 +4,7 @@ import {
   definePipelineStep,
   isPipelineDefinition,
   isPipelineStepDefinition
-} from "../chunk-rs1wbvy6.js";
+} from "../chunk-ea73pzk7.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-a31h57d5.js";
@@ -14,11 +14,11 @@ import {
   PipelineError,
   PipelineRunDispatcher,
   requestPipelineRun
-} from "../chunk-cbkm2vam.js";
+} from "../chunk-r0rry8dn.js";
 import"../chunk-8b55ygje.js";
 import"../chunk-51fjndv0.js";
 import"../chunk-f6erf2vv.js";
-import"../chunk-1wk20wn3.js";
+import"../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";

package/dist/projections/internal.js

@@ -12,7 +12,7 @@ import {
   parseDatasetTimestamp
 } from "../chunk-96swp2wd.js";
 import"../chunk-f6erf2vv.js";
-import"../chunk-1wk20wn3.js";
+import"../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";

package/dist/storage/index.js

@@ -52,7 +52,7 @@ import {
   runMigrationSet,
   step,
   throwNestedStorageTransaction
-} from "../chunk-1wk20wn3.js";
+} from "../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import {

package/dist/syncs/index.js

@@ -3,7 +3,7 @@ import {
   defineSync,
   isSyncDefinition,
   resolveSyncConnectorSources
-} from "../chunk-sxwk41qa.js";
+} from "../chunk-4h947jd8.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-a31h57d5.js";
@@ -13,12 +13,12 @@ import {
   SyncRunDispatcher,
   SyncValidationError,
   requestSyncRun
-} from "../chunk-g13869yf.js";
+} from "../chunk-zp2v2rv6.js";
 import"../chunk-8b55ygje.js";
 import"../chunk-51fjndv0.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-f6erf2vv.js";
-import"../chunk-1wk20wn3.js";
+import"../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";

package/dist/testing/index.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-x2yw73hy.js";
 import {
   SixbHost
-} from "../chunk-s31d0qmq.js";
+} from "../chunk-am6eczah.js";
 import"../chunk-9t8f5xfx.js";
 import"../chunk-819wnjz8.js";
 import {
@@ -20,10 +20,10 @@ import"../chunk-ghteq96b.js";
 import"../chunk-z3zp0bj1.js";
 import"../chunk-zqqz8052.js";
 import"../chunk-f2rt4vkh.js";
-import"../chunk-1yz3x65y.js";
-import"../chunk-sxwk41qa.js";
-import"../chunk-hbeh8j9w.js";
-import"../chunk-rs1wbvy6.js";
+import"../chunk-h6h91mfy.js";
+import"../chunk-4h947jd8.js";
+import"../chunk-gadsm794.js";
+import"../chunk-ea73pzk7.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-2ab72m2h.js";
@@ -39,10 +39,10 @@ import {
 } from "../chunk-wtmzkcht.js";
 import {
   isBoundSixb
-} from "../chunk-c43qr6s0.js";
-import"../chunk-g13869yf.js";
-import"../chunk-cbkm2vam.js";
-import"../chunk-pn8n8sba.js";
+} from "../chunk-84h6qhmp.js";
+import"../chunk-zp2v2rv6.js";
+import"../chunk-r0rry8dn.js";
+import"../chunk-z3ga9q5m.js";
 import"../chunk-4rh2m6zg.js";
 import"../chunk-xhy826cz.js";
 import {
@@ -53,7 +53,7 @@ import {
   existsObjects,
   facetObjects,
   validateObjectQuery
-} from "../chunk-7gw7mepb.js";
+} from "../chunk-6d5xdj1q.js";
 import {
   ObjectQueryPlanningError,
   normalizeObjectQuery
@@ -65,12 +65,12 @@ import {
 import"../chunk-51fjndv0.js";
 import"../chunk-8m5ejdpn.js";
 import"../chunk-nf4r78r4.js";
-import"../chunk-tycbzedm.js";
-import"../chunk-tek1qwgm.js";
+import"../chunk-78c6xvyr.js";
+import"../chunk-1q02e95s.js";
 import {
   ProjectionRegistry,
   createOntologyMaterializer
-} from "../chunk-afjpa2hs.js";
+} from "../chunk-tbv03sx2.js";
 import"../chunk-96swp2wd.js";
 import {
   restoreTrustedPrimitiveExecutionScope
@@ -81,7 +81,7 @@ import {
   linkBatchKey,
   objectBatchKey,
   objectLinkCursor
-} from "../chunk-1wk20wn3.js";
+} from "../chunk-v0egge8b.js";
 import {
   createEventId
 } from "../chunk-72q2y8hn.js";

package/dist/webhooks/internal.js

@@ -5,7 +5,7 @@ import {
 import {
   canRetryWebhookRun,
   isStorageSerializationFailure
-} from "../chunk-1wk20wn3.js";
+} from "../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";

package/dist/workflows/index.js

@@ -7,7 +7,7 @@ import {
   defineWorkflowStep,
   interventionField,
   unwrapWorkflowNodeFailure
-} from "../chunk-hbeh8j9w.js";
+} from "../chunk-gadsm794.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-74drx9gd.js";
@@ -40,25 +40,25 @@ import {
   validateWorkflowStepInput,
   validateWorkflowStepOutput,
   validateWorkflowsAtStartup
-} from "../chunk-c43qr6s0.js";
-import"../chunk-g13869yf.js";
-import"../chunk-cbkm2vam.js";
-import"../chunk-pn8n8sba.js";
+} from "../chunk-84h6qhmp.js";
+import"../chunk-zp2v2rv6.js";
+import"../chunk-r0rry8dn.js";
+import"../chunk-z3ga9q5m.js";
 import"../chunk-4rh2m6zg.js";
 import"../chunk-xhy826cz.js";
-import"../chunk-7gw7mepb.js";
+import"../chunk-6d5xdj1q.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-78c6xvyr.js";
+import"../chunk-1q02e95s.js";
+import"../chunk-tbv03sx2.js";
 import"../chunk-96swp2wd.js";
 import"../chunk-f6erf2vv.js";
-import"../chunk-1wk20wn3.js";
+import"../chunk-v0egge8b.js";
 import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixb/core",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "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/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/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"