@sixb/core 0.1.3 → 0.1.5

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

@@ -1 +1 @@
-{"version":3,"file":"lake-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/lake-storage-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElF,MAAM,WAAW,+BAA+B,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACzF,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,oCAAoC,CAAA;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AA2CD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,WAAW,EACtE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GACjD,IAAI,CA2nBN"}
+{"version":3,"file":"lake-storage-contract.d.ts","sourceRoot":"","sources":["../../src/testing/lake-storage-contract.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEpE,MAAM,MAAM,oCAAoC,GAAG,QAAQ,GAAG,oBAAoB,CAAA;AAElF,MAAM,WAAW,+BAA+B,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW;IACzF,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,oCAAoC,CAAA;IAC/D;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AA2CD;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,SAAS,WAAW,EACtE,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,+BAA+B,CAAC,QAAQ,CAAC,GACjD,IAAI,CAmrBN"}

package/dist/testing/object-query-contract.d.ts

@@ -13,7 +13,7 @@ export declare const objectQueryContractOntology: OntologyRegistry;
  *
  * The contract defines the portable V1 query surface: capability declarations,
  * validation/normalization handoff, provider pushdown, bounded fallback,
- * traversal, set operations, pagination, search profile defaults, and stable
+ * canonical reference sets, traversal, set operations, pagination, search profile defaults, and stable
  * structured rejections for features outside a provider's capability map.
  */
 export declare function runObjectQueryProviderContractSuite<TStorage extends Storage>(label: string, options: ObjectQueryProviderContractSuiteOptions<TStorage>): void;

package/dist/testing/object-query-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"object-query-contract.d.ts","sourceRoot":"","sources":["../../src/testing/object-query-contract.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0B,gBAAgB,EAAoB,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,uCAAuC,CAAC,QAAQ,SAAS,OAAO;IAC/E,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8GD,eAAO,MAAM,2BAA2B,kBAEtC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uCAAuC,CAAC,QAAQ,CAAC,GACzD,IAAI,CAw4BN;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EjG"}
+{"version":3,"file":"object-query-contract.d.ts","sourceRoot":"","sources":["../../src/testing/object-query-contract.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0B,gBAAgB,EAAoB,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAA;AAE/B,MAAM,WAAW,uCAAuC,CAAC,QAAQ,SAAS,OAAO;IAC/E,kFAAkF;IAClF,QAAQ,CAAC,aAAa,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1D,sDAAsD;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AA8GD,eAAO,MAAM,2BAA2B,kBAEtC,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,OAAO,EAC1E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uCAAuC,CAAC,QAAQ,CAAC,GACzD,IAAI,CAslCN;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EjG"}

package/dist/webhooks/internal.js

@@ -1,12 +1,12 @@
 // @bun
 import {
   createPrimitiveExecutionRecord
-} from "../chunk-4aw0jwk0.js";
+} from "../chunk-f6erf2vv.js";
 import {
   canRetryWebhookRun,
   isStorageSerializationFailure
-} from "../chunk-xmggaxg4.js";
-import"../chunk-fmx1sz2h.js";
+} from "../chunk-v0egge8b.js";
+import"../chunk-72q2y8hn.js";
 import"../chunk-xc7hq65b.js";
 import"../chunk-cy0n5dms.js";
 import"../chunk-dysw7nsm.js";
@@ -14,13 +14,13 @@ import"../chunk-62c7t4jc.js";
 import {
   WebhookRunError
 } from "../chunk-ezake7g1.js";
-import"../chunk-pxtrxm3p.js";
+import"../chunk-a09jx26t.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-qer6am8w.js";
-import"../chunk-n5x5y80a.js";
+import"../chunk-xdf9yswn.js";
+import"../chunk-nzw7sm3b.js";
 import"../chunk-t9xghkva.js";
-import"../chunk-kqxgf6kv.js";
+import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
 import {
   ExecutionStorageError
@@ -28,19 +28,18 @@ import {
 import"../chunk-9dzba0f2.js";
 import"../chunk-vybf6pkp.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-6wetht33.js";
 import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
+import"../chunk-t0jjkep3.js";
+import"../chunk-tkdscva6.js";
+import"../chunk-rhrbz7d4.js";
+import"../chunk-xwnf87e1.js";
+import"../chunk-f83ka50g.js";
 import"../chunk-rnshztfq.js";
 import"../chunk-04b07a9q.js";
 import"../chunk-dktq02ne.js";
 import"../chunk-zqysyfjt.js";
-import"../chunk-t0jjkep3.js";
-import"../chunk-d2adj15j.js";
-import"../chunk-rhrbz7d4.js";
-import"../chunk-xwnf87e1.js";
-import"../chunk-4z3n1dzt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -149,4 +148,4 @@ export {
   admitWebhookRun
 };
 
-//# debugId=A21F13420826A31E64756E2164756E21
+//# debugId=1789834E3012281164756E2164756E21

package/dist/webhooks/internal.js.map

@@ -4,7 +4,7 @@
   "sourcesContent": [
     "import { randomUUID } from \"node:crypto\"\nimport { createPrimitiveExecutionRecord } from \"../execution/durable\"\nimport type { ExecutionRecord, Storage, WebhookRunRecord } from \"../storage\"\nimport {\n  canRetryWebhookRun,\n  ExecutionStorageError,\n  isStorageSerializationFailure,\n  WebhookRunError,\n} from \"../storage\"\n\nconst MAX_ADMISSION_ATTEMPTS = 3\n\nexport interface AdmitWebhookRunInput {\n  readonly projectId: string\n  readonly storage: Storage\n  readonly runId: string\n  readonly connectorId: string\n  readonly webhookId: string\n  readonly method: string\n  readonly route: string\n  readonly requestBodyBytes: number\n  readonly requestBodySha256: string\n  readonly idempotencyKey?: string\n}\n\nexport type AdmitWebhookRunResult =\n  | {\n      readonly status: \"admitted\"\n      readonly run: WebhookRunRecord\n      readonly execution: ExecutionRecord\n      readonly retried: boolean\n    }\n  | {\n      readonly status: \"duplicate\" | \"in_progress\"\n      readonly run: WebhookRunRecord\n    }\n\n/** Persist or reclaim one verified Webhook delivery before its protected handler executes. */\nexport async function admitWebhookRun(input: AdmitWebhookRunInput): Promise<AdmitWebhookRunResult> {\n  assertAdmissionInput(input)\n  let attempt = 0\n\n  // Concurrent deliveries may both observe no run before one transaction commits. Retry only\n  // serialization and uniqueness races so the loser can reload the winning run; every other error\n  // fails immediately, and repeated contention remains bounded by MAX_ADMISSION_ATTEMPTS.\n  while (true) {\n    attempt += 1\n    try {\n      return await input.storage.transaction((tx) => admitWebhookRunTransaction(tx, input), {\n        isolation: \"serializable\",\n      })\n    } catch (error) {\n      if (attempt >= MAX_ADMISSION_ATTEMPTS || !isConcurrentAdmissionConflict(error)) {\n        throw error\n      }\n    }\n  }\n}\n\nasync function admitWebhookRunTransaction(\n  storage: Storage,\n  input: AdmitWebhookRunInput\n): Promise<AdmitWebhookRunResult> {\n  const runs = requireWebhookRunStorage(storage)\n  const existing = input.idempotencyKey\n    ? await runs.getByDelivery({\n        projectId: input.projectId,\n        connectorId: input.connectorId,\n        webhookId: input.webhookId,\n        idempotencyKey: input.idempotencyKey,\n      })\n    : null\n\n  if (existing) {\n    assertSameDelivery(existing, input)\n    if (existing.status === \"running\") return { status: \"in_progress\", run: existing }\n    if (!canRetryWebhookRun(existing)) return { status: \"duplicate\", run: existing }\n\n    const execution = await requireWebhookExecution(storage, existing)\n    const run = await runs.restart({\n      projectId: input.projectId,\n      id: existing.id,\n    })\n    return { status: \"admitted\", run, execution, retried: true }\n  }\n\n  const executionInput = createPrimitiveExecutionRecord({\n    id: `exec_${randomUUID()}`,\n    primitive: { kind: \"webhook\", id: input.route, runId: input.runId },\n    origin: {\n      type: \"automatic\",\n      projectId: input.projectId,\n      source: { type: \"webhook\", deliveryId: input.runId },\n      correlationId: input.runId,\n    },\n  })\n  const execution = await storage.executions.create(executionInput)\n  const run = await runs.start({\n    id: input.runId,\n    projectId: input.projectId,\n    executionId: execution.id,\n    connectorId: input.connectorId,\n    webhookId: input.webhookId,\n    method: input.method,\n    route: input.route,\n    requestBodyBytes: input.requestBodyBytes,\n    requestBodySha256: input.requestBodySha256,\n    idempotencyKey: input.idempotencyKey,\n  })\n  return { status: \"admitted\", run, execution, retried: false }\n}\n\nfunction assertSameDelivery(existing: WebhookRunRecord, input: AdmitWebhookRunInput): void {\n  if (\n    existing.connectorId !== input.connectorId ||\n    existing.webhookId !== input.webhookId ||\n    existing.method !== input.method ||\n    existing.route !== input.route ||\n    existing.requestBodyBytes !== input.requestBodyBytes ||\n    existing.requestBodySha256 !== input.requestBodySha256\n  ) {\n    throw new WebhookRunError(\n      `[Sixb] Webhook delivery '${input.idempotencyKey}' conflicts with run '${existing.id}'.`,\n      \"delivery_conflict\"\n    )\n  }\n}\n\nasync function requireWebhookExecution(\n  storage: Storage,\n  run: WebhookRunRecord\n): Promise<ExecutionRecord> {\n  const execution = await storage.executions.getById({\n    projectId: run.projectId,\n    id: run.executionId,\n  })\n  if (!execution) {\n    throw new WebhookRunError(\n      `[Sixb] Execution '${run.executionId}' for Webhook run '${run.id}' was not found.`,\n      \"invalid_execution\"\n    )\n  }\n  return execution\n}\n\nfunction requireWebhookRunStorage(storage: Storage): NonNullable<Storage[\"webhookRuns\"]> {\n  if (!storage.webhookRuns) {\n    throw new WebhookRunError(\"[Sixb] Webhook run storage is not configured.\")\n  }\n  return storage.webhookRuns\n}\n\nfunction assertAdmissionInput(input: AdmitWebhookRunInput): void {\n  if (input.idempotencyKey !== undefined && !input.idempotencyKey.trim()) {\n    throw new WebhookRunError(\"[Sixb] Webhook idempotency key must not be empty.\")\n  }\n  if (!Number.isSafeInteger(input.requestBodyBytes) || input.requestBodyBytes < 0) {\n    throw new WebhookRunError(\"[Sixb] Webhook request body bytes must be a non-negative integer.\")\n  }\n  if (!/^[a-f0-9]{64}$/.test(input.requestBodySha256)) {\n    throw new WebhookRunError(\"[Sixb] Webhook request body SHA-256 must be lowercase hexadecimal.\")\n  }\n}\n\nfunction isConcurrentAdmissionConflict(error: unknown): boolean {\n  return (\n    isStorageSerializationFailure(error) ||\n    (error instanceof ExecutionStorageError && error.code === \"duplicate_execution\") ||\n    (error instanceof WebhookRunError &&\n      (error.code === \"duplicate_run\" || error.code === \"invalid_transition\"))\n  )\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "A21F13420826A31E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "1789834E3012281164756E2164756E21",
   "names": []
 }

package/dist/workflows/index.js

@@ -7,7 +7,7 @@ import {
   defineWorkflowStep,
   interventionField,
   unwrapWorkflowNodeFailure
-} from "../chunk-c8bw2b6c.js";
+} from "../chunk-gadsm794.js";
 import"../chunk-5sz8ta9r.js";
 import"../chunk-979ww6b3.js";
 import"../chunk-74drx9gd.js";
@@ -40,62 +40,61 @@ import {
   validateWorkflowStepInput,
   validateWorkflowStepOutput,
   validateWorkflowsAtStartup
-} from "../chunk-177ed2mp.js";
-import"../chunk-km4rkj4t.js";
-import"../chunk-261ag4t4.js";
-import"../chunk-3rsf30p4.js";
-import"../chunk-gqdd7508.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-f1cyvnrk.js";
-import"../chunk-88ppkr54.js";
-import"../chunk-63te770v.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-ttba8x6z.js";
-import"../chunk-d6y2wsfg.js";
-import"../chunk-ettb0cy4.js";
+import"../chunk-78c6xvyr.js";
+import"../chunk-1q02e95s.js";
+import"../chunk-tbv03sx2.js";
 import"../chunk-96swp2wd.js";
-import"../chunk-4aw0jwk0.js";
-import"../chunk-xmggaxg4.js";
-import"../chunk-fmx1sz2h.js";
+import"../chunk-f6erf2vv.js";
+import"../chunk-v0egge8b.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-pxtrxm3p.js";
+import"../chunk-a09jx26t.js";
 import"../chunk-htq0qh7z.js";
 import"../chunk-xkthy56g.js";
-import"../chunk-qer6am8w.js";
-import"../chunk-n5x5y80a.js";
+import"../chunk-xdf9yswn.js";
+import"../chunk-nzw7sm3b.js";
 import"../chunk-t9xghkva.js";
-import"../chunk-kqxgf6kv.js";
+import"../chunk-drjqm1aa.js";
 import"../chunk-5gd7tpv6.js";
 import"../chunk-h9kxd41f.js";
 import"../chunk-9dzba0f2.js";
 import"../chunk-vybf6pkp.js";
 import"../chunk-ry24jbr1.js";
-import"../chunk-6wetht33.js";
 import"../chunk-3j7573mj.js";
 import"../chunk-4gz41why.js";
 import"../chunk-zcnhxkvd.js";
 import"../chunk-1evzqhks.js";
 import"../chunk-dsrkgtnh.js";
 import"../chunk-bhxaq2nn.js";
-import"../chunk-rnshztfq.js";
-import"../chunk-04b07a9q.js";
-import"../chunk-dktq02ne.js";
-import"../chunk-zqysyfjt.js";
 import"../chunk-yt8wphsx.js";
 import"../chunk-rdeagz6b.js";
-import"../chunk-zpw39qhj.js";
+import"../chunk-dm72y8wt.js";
 import"../chunk-t0jjkep3.js";
-import"../chunk-d2adj15j.js";
+import"../chunk-tkdscva6.js";
 import"../chunk-rhrbz7d4.js";
 import"../chunk-xwnf87e1.js";
-import"../chunk-4z3n1dzt.js";
+import"../chunk-f83ka50g.js";
+import"../chunk-rnshztfq.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-zqysyfjt.js";
 import"../chunk-0172wgm9.js";
 import"../chunk-t8t39h7v.js";
 import"../chunk-y64skrwp.js";
@@ -136,4 +135,4 @@ export {
   WorkflowDefinitionError
 };
 
-//# debugId=28B83A3228FF218964756E2164756E21
+//# debugId=49C4A15FE91A2DE064756E2164756E21

package/dist/workflows/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "28B83A3228FF218964756E2164756E21",
+  "debugId": "49C4A15FE91A2DE064756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sixb/core",
-  "version": "0.1.3",
+  "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/builders.ts

@@ -16,10 +16,10 @@ import {
   assertValidAgentToolDescription,
   assertValidAgentToolInput,
   assertValidAgentToolName,
-  assertValidLoopConfig,
   assertValidProviderOptions,
   assertValidReasoningLevel,
   groupIdsFromDefinitions,
+  resolveAgentLoopConfig,
 } from "./validation"
 
 /**
@@ -76,7 +76,7 @@ export function defineAgent<const TId extends string>(
   }
   assertValidReasoningLevel(config.reasoning)
   assertValidProviderOptions(config.providerOptions)
-  assertValidLoopConfig(config.loop)
+  const loop = resolveAgentLoopConfig(config.loop)
   const groupIds = groupIdsFromDefinitions(id, config.groups)
   const tools = toolsFromDefinitions(id, config.tools)
 
@@ -91,6 +91,6 @@ export function defineAgent<const TId extends string>(
     groupIds,
     tools,
     ...(config.description !== undefined ? { description: config.description } : {}),
-    ...(config.loop !== undefined ? { loop: config.loop } : {}),
+    ...(loop !== undefined ? { loop } : {}),
   })
 }