@sixb/core 0.0.1

package/dist/actions/validators.d.ts

@@ -0,0 +1,8 @@
+import type { ActionDefinition, ActionSubject, ActionTargetObject } from "./types";
+export declare function runActionValidators<TBaseContext extends object>(input: {
+    readonly action: ActionDefinition;
+    readonly subject: ActionSubject;
+    readonly baseContext: TBaseContext;
+    readonly target?: ActionTargetObject | null;
+}): Promise<void>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/actions/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/actions/validators.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAKlF,wBAAsB,mBAAmB,CAAC,YAAY,SAAS,MAAM,EAAE,KAAK,EAAE;IAC5E,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CAC5C,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/dist/actions/worker.d.ts

@@ -0,0 +1,3 @@
+export type { RecordEditsHandler, RecordEditsOptions } from "../edits/recorder";
+export { recordEdits } from "../edits/recorder";
+//# sourceMappingURL=worker.d.ts.map

package/dist/actions/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/actions/worker.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/actions/worker.js

@@ -0,0 +1,324 @@
+// @bun
+import {
+  assertKnownProperties,
+  assertRequiredProperties,
+  normalizeObjectProperties,
+  validateObjectProperties,
+  validatePropertyValue
+} from "../chunk-tsk2bxs3.js";
+import"../chunk-04b07a9q.js";
+import {
+  OntologyValidationError
+} from "../chunk-dktq02ne.js";
+import {
+  EditBatchError
+} from "../chunk-yt8wphsx.js";
+import"../chunk-4pycxcj3.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+
+// src/edits/recorder.ts
+import { createHash } from "crypto";
+
+// src/edits/properties.ts
+function normalizeObjectEditProperties(params) {
+  const { objectType, properties, valueTypesById, path } = params;
+  assertKnownProperties(objectType, properties);
+  assertNoTelemetryProperties(objectType.properties, properties, path);
+  validateObjectProperties(objectType, properties, valueTypesById);
+  return normalizeObjectProperties(objectType.properties, properties, valueTypesById, path);
+}
+function normalizeLinkEditProperties(params) {
+  const { sourceObjectTypeId, linkId, linkDefinition, properties, valueTypesById } = params;
+  const linkProperties = linkDefinition.properties ?? [];
+  if (linkProperties.length === 0 && Object.keys(properties).length > 0) {
+    throw new OntologyValidationError(`[Sixb] Link ${sourceObjectTypeId}.${linkId} does not define link properties`);
+  }
+  const knownPropertyIds = new Set(linkProperties.map((property) => property.id));
+  for (const propertyId of Object.keys(properties)) {
+    if (!knownPropertyIds.has(propertyId)) {
+      throw new OntologyValidationError(`[Sixb] Unknown link property '${propertyId}' for link '${sourceObjectTypeId}.${linkId}'`);
+    }
+  }
+  assertNoTelemetryProperties(linkProperties, properties, `${sourceObjectTypeId}.${linkId}`);
+  for (const [propertyId, value] of Object.entries(properties)) {
+    const property = linkProperties.find((candidate) => candidate.id === propertyId);
+    if (!property)
+      continue;
+    validatePropertyValue(property, value, `${sourceObjectTypeId}.${linkId}.${propertyId}`, valueTypesById);
+  }
+  return normalizeObjectProperties(linkProperties, properties, valueTypesById, `${sourceObjectTypeId}.${linkId}`);
+}
+function getPrimaryProperty(objectType) {
+  const primaryProperty = objectType.properties.find((property) => property.primary);
+  if (!primaryProperty) {
+    throw new OntologyValidationError(`[Sixb] Object type '${objectType.id}' has no primary property`);
+  }
+  return primaryProperty;
+}
+function assertPrimaryPropertyNotUpdated(objectType, properties) {
+  const primaryProperty = getPrimaryProperty(objectType);
+  if (Object.hasOwn(properties, primaryProperty.id)) {
+    throw new EditBatchError(`[Sixb] EditBatch cannot update primary property '${objectType.id}.${primaryProperty.id}'.`);
+  }
+}
+function normalizeEditablePropertyIds(params) {
+  const { objectType, propertyIds, operation } = params;
+  const primaryProperty = getPrimaryProperty(objectType);
+  const normalized = [];
+  const seen = new Set;
+  for (const propertyId of propertyIds) {
+    if (typeof propertyId !== "string" || !propertyId.trim()) {
+      throw new EditBatchError(`[Sixb] EditBatch ${objectType.id}.${operation} property id must be a non-empty string.`);
+    }
+    const property = objectType.properties.find((candidate) => candidate.id === propertyId);
+    if (!property) {
+      throw new EditBatchError(`[Sixb] EditBatch ${operation} references unknown property '${objectType.id}.${propertyId}'.`);
+    }
+    if (property.id === primaryProperty.id) {
+      throw new EditBatchError(`[Sixb] EditBatch cannot ${operation} primary property '${objectType.id}.${propertyId}'.`);
+    }
+    if (property.mode === "telemetry") {
+      throw new EditBatchError(`[Sixb] EditBatch cannot ${operation} telemetry property '${objectType.id}.${propertyId}'.`);
+    }
+    if (seen.has(propertyId))
+      continue;
+    seen.add(propertyId);
+    normalized.push(propertyId);
+  }
+  if (normalized.length === 0) {
+    throw new EditBatchError(`[Sixb] EditBatch ${objectType.id}.${operation} requires at least one property id.`);
+  }
+  return normalized;
+}
+function assertNoTelemetryProperties(definitions, properties, path) {
+  for (const propertyId of Object.keys(properties)) {
+    const property = definitions.find((candidate) => candidate.id === propertyId);
+    if (property?.mode === "telemetry") {
+      throw new EditBatchError(`[Sixb] EditBatch cannot edit telemetry property '${path}.${propertyId}' in the MVP.`);
+    }
+  }
+}
+
+// src/edits/recorder.ts
+var EMPTY_VALUE_TYPES = new Map;
+async function recordEdits(options, handler) {
+  const recorder = createEditRecorder(options);
+  await handler({ objects: recorder.objects });
+  return recorder.toEditBatch();
+}
+function createEditRecorder(options) {
+  if (!options.runId.trim()) {
+    throw new EditBatchError("[Sixb] recordEdits requires a non-empty runId.");
+  }
+  const operations = [];
+  const valueTypesById = options.valueTypesById ?? EMPTY_VALUE_TYPES;
+  function objects(objectType) {
+    return {
+      byId(primaryId) {
+        return createObjectHandle(objectType, createRef(objectType.id, primaryId));
+      },
+      create(properties) {
+        const operationPath = String(operations.length);
+        const primaryProperty = getPrimaryProperty(objectType);
+        const rawProperties = assertRecord(properties, `${objectType.id}.create.properties`);
+        const primaryValue = rawProperties[primaryProperty.id] ?? generatePrimaryId({
+          runId: options.runId,
+          operationPath,
+          objectTypeId: objectType.id
+        });
+        if (typeof primaryValue !== "string" || !primaryValue.trim()) {
+          throw new EditBatchError(`[Sixb] EditBatch create '${objectType.id}' primary property '${primaryProperty.id}' must be a non-empty string.`);
+        }
+        const normalizedProperties = normalizeObjectEditProperties({
+          objectType,
+          properties: {
+            ...rawProperties,
+            [primaryProperty.id]: primaryValue
+          },
+          valueTypesById,
+          path: `${objectType.id}.create`
+        });
+        assertRequiredProperties(objectType, normalizedProperties);
+        operations.push({
+          kind: "object.create",
+          objectTypeId: objectType.id,
+          primaryId: primaryValue,
+          properties: withoutPrimaryProperty(normalizedProperties, primaryProperty.id)
+        });
+        return createObjectHandle(objectType, {
+          objectTypeId: objectType.id,
+          primaryId: primaryValue
+        });
+      }
+    };
+  }
+  function toEditBatch() {
+    return { operations: [...operations] };
+  }
+  function createObjectHandle(objectType, ref) {
+    const handle = {
+      objectTypeId: ref.objectTypeId,
+      primaryId: ref.primaryId
+    };
+    Object.defineProperties(handle, {
+      objectType: {
+        value: objectType
+      },
+      update: {
+        value(properties) {
+          const normalizedProperties = normalizeObjectEditProperties({
+            objectType,
+            properties: assertRecord(properties, `${objectType.id}.update.properties`),
+            valueTypesById,
+            path: `${objectType.id}.update`
+          });
+          assertPrimaryPropertyNotUpdated(objectType, normalizedProperties);
+          if (Object.keys(normalizedProperties).length === 0) {
+            throw new EditBatchError(`[Sixb] EditBatch update '${objectType.id}:${ref.primaryId}' must set at least one property.`);
+          }
+          operations.push({
+            kind: "object.update",
+            objectTypeId: ref.objectTypeId,
+            primaryId: ref.primaryId,
+            properties: normalizedProperties
+          });
+        }
+      },
+      unset: {
+        value(...propertyIds) {
+          operations.push({
+            kind: "object.unset",
+            objectTypeId: ref.objectTypeId,
+            primaryId: ref.primaryId,
+            propertyIds: normalizeEditablePropertyIds({
+              objectType,
+              propertyIds,
+              operation: "unset"
+            })
+          });
+        }
+      },
+      reset: {
+        value(...propertyIds) {
+          operations.push({
+            kind: "object.reset",
+            objectTypeId: ref.objectTypeId,
+            primaryId: ref.primaryId,
+            propertyIds: normalizeEditablePropertyIds({
+              objectType,
+              propertyIds,
+              operation: "reset"
+            })
+          });
+        }
+      },
+      delete: {
+        value() {
+          operations.push({
+            kind: "object.delete",
+            objectTypeId: ref.objectTypeId,
+            primaryId: ref.primaryId
+          });
+        }
+      },
+      restore: {
+        value() {
+          operations.push({
+            kind: "object.restore",
+            objectTypeId: ref.objectTypeId,
+            primaryId: ref.primaryId
+          });
+        }
+      },
+      link: {
+        value(link, target, linkOptions) {
+          assertLinkTokenSource(ref, link);
+          const properties = linkOptions?.properties === undefined ? undefined : normalizeLinkEditProperties({
+            sourceObjectTypeId: ref.objectTypeId,
+            linkId: link.id,
+            linkDefinition: link.link,
+            properties: linkOptions.properties,
+            valueTypesById
+          });
+          operations.push({
+            kind: "link.upsert",
+            source: toPlainRef(ref),
+            linkId: link.id,
+            target: toPlainRef(target),
+            ...properties !== undefined ? { properties } : {}
+          });
+        }
+      },
+      unlink: {
+        value(link, target) {
+          assertLinkTokenSource(ref, link);
+          operations.push({
+            kind: "link.delete",
+            source: toPlainRef(ref),
+            linkId: link.id,
+            target: toPlainRef(target)
+          });
+        }
+      },
+      resetLink: {
+        value(link, target) {
+          assertLinkTokenSource(ref, link);
+          operations.push({
+            kind: "link.reset",
+            source: toPlainRef(ref),
+            linkId: link.id,
+            target: toPlainRef(target)
+          });
+        }
+      }
+    });
+    return handle;
+  }
+  return {
+    objects,
+    toEditBatch
+  };
+}
+function assertLinkTokenSource(source, link) {
+  if (source.objectTypeId !== link.objectTypeId) {
+    throw new OntologyValidationError(`[Sixb] Link token ${link.objectTypeId}.${link.id} cannot be used with ${source.objectTypeId}`);
+  }
+}
+function createRef(objectTypeId, primaryId) {
+  return {
+    objectTypeId: assertNonEmptyString(objectTypeId, "objectTypeId"),
+    primaryId: assertNonEmptyString(primaryId, `${objectTypeId}.primaryId`)
+  };
+}
+function generatePrimaryId(params) {
+  const hash = createHash("sha256").update(`${params.runId}:${params.operationPath}:${params.objectTypeId}`).digest("hex").slice(0, 24);
+  return `edit_${hash}`;
+}
+function withoutPrimaryProperty(properties, primaryPropertyId) {
+  const { [primaryPropertyId]: _primary, ...rest } = properties;
+  return rest;
+}
+function assertRecord(value, label) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    throw new EditBatchError(`[Sixb] EditBatch ${label} must be an object.`);
+  }
+  return value;
+}
+function assertNonEmptyString(value, label) {
+  if (typeof value !== "string" || !value.trim()) {
+    throw new EditBatchError(`[Sixb] EditBatch ${label} must be a non-empty string.`);
+  }
+  return value;
+}
+function toPlainRef(ref) {
+  return {
+    objectTypeId: ref.objectTypeId,
+    primaryId: ref.primaryId
+  };
+}
+export {
+  recordEdits
+};
+
+//# debugId=80751F89CEB9E0C664756E2164756E21

package/dist/actions/worker.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/edits/recorder.ts", "../src/edits/properties.ts"],
+  "sourcesContent": [
+    "import { createHash } from \"node:crypto\"\nimport type { ObjectLink, ValueType } from \"../ontology\"\nimport { OntologyValidationError } from \"../ontology/errors\"\nimport type { ObjectTypeWithPropertyTokens } from \"../ontology/tokens\"\nimport { assertRequiredProperties } from \"../ontology/validation\"\nimport { EditBatchError } from \"./errors\"\nimport {\n  assertPrimaryPropertyNotUpdated,\n  getPrimaryProperty,\n  normalizeEditablePropertyIds,\n  normalizeLinkEditProperties,\n  normalizeObjectEditProperties,\n} from \"./properties\"\nimport type {\n  EditBatch,\n  EditObjectHandle,\n  EditObjectProperties,\n  EditObjectRef,\n  EditOperation,\n  RecordEditsContext,\n  RecordEditsHandler,\n  RecordEditsOptions,\n} from \"./types\"\n\nexport type { RecordEditsHandler, RecordEditsOptions } from \"./types\"\n\nconst EMPTY_VALUE_TYPES = new Map<string, ValueType>()\n\ntype RuntimeEditRecorder = {\n  readonly objects: (objectType: ObjectTypeWithPropertyTokens) => unknown\n  toEditBatch(): EditBatch\n}\n\nexport async function recordEdits(\n  options: RecordEditsOptions,\n  handler: RecordEditsHandler\n): Promise<EditBatch> {\n  const recorder = createEditRecorder(options)\n  await handler({ objects: recorder.objects } as RecordEditsContext)\n  return recorder.toEditBatch()\n}\n\nfunction createEditRecorder(options: RecordEditsOptions): RuntimeEditRecorder {\n  if (!options.runId.trim()) {\n    throw new EditBatchError(\"[Sixb] recordEdits requires a non-empty runId.\")\n  }\n\n  const operations: EditOperation[] = []\n  const valueTypesById = options.valueTypesById ?? EMPTY_VALUE_TYPES\n\n  function objects(objectType: ObjectTypeWithPropertyTokens) {\n    return {\n      byId(primaryId: string) {\n        return createObjectHandle(objectType, createRef(objectType.id, primaryId))\n      },\n\n      create(properties: unknown) {\n        const operationPath = String(operations.length)\n        const primaryProperty = getPrimaryProperty(objectType)\n        const rawProperties = assertRecord(properties, `${objectType.id}.create.properties`)\n        const primaryValue =\n          rawProperties[primaryProperty.id] ??\n          generatePrimaryId({\n            runId: options.runId,\n            operationPath,\n            objectTypeId: objectType.id,\n          })\n\n        if (typeof primaryValue !== \"string\" || !primaryValue.trim()) {\n          throw new EditBatchError(\n            `[Sixb] EditBatch create '${objectType.id}' primary property '${primaryProperty.id}' must be a non-empty string.`\n          )\n        }\n\n        const normalizedProperties = normalizeObjectEditProperties({\n          objectType,\n          properties: {\n            ...rawProperties,\n            [primaryProperty.id]: primaryValue,\n          },\n          valueTypesById,\n          path: `${objectType.id}.create`,\n        })\n        assertRequiredProperties(objectType, normalizedProperties)\n\n        operations.push({\n          kind: \"object.create\",\n          objectTypeId: objectType.id,\n          primaryId: primaryValue,\n          properties: withoutPrimaryProperty(normalizedProperties, primaryProperty.id),\n        })\n        return createObjectHandle(objectType, {\n          objectTypeId: objectType.id,\n          primaryId: primaryValue,\n        })\n      },\n    }\n  }\n\n  function toEditBatch(): EditBatch {\n    return { operations: [...operations] }\n  }\n\n  function createObjectHandle(\n    objectType: ObjectTypeWithPropertyTokens,\n    ref: EditObjectRef\n  ): EditObjectHandle<ObjectTypeWithPropertyTokens> {\n    const handle = {\n      objectTypeId: ref.objectTypeId,\n      primaryId: ref.primaryId,\n    }\n\n    Object.defineProperties(handle, {\n      objectType: {\n        value: objectType,\n      },\n      update: {\n        value(properties: Readonly<Record<string, unknown>>) {\n          const normalizedProperties = normalizeObjectEditProperties({\n            objectType,\n            properties: assertRecord(properties, `${objectType.id}.update.properties`),\n            valueTypesById,\n            path: `${objectType.id}.update`,\n          })\n          assertPrimaryPropertyNotUpdated(objectType, normalizedProperties)\n          // An empty patch resolves to a null override and commits as `unchanged`, so a handler\n          // that built its update conditionally would report a successful run that wrote nothing.\n          if (Object.keys(normalizedProperties).length === 0) {\n            throw new EditBatchError(\n              `[Sixb] EditBatch update '${objectType.id}:${ref.primaryId}' must set at least one property.`\n            )\n          }\n\n          operations.push({\n            kind: \"object.update\",\n            objectTypeId: ref.objectTypeId,\n            primaryId: ref.primaryId,\n            properties: normalizedProperties,\n          })\n        },\n      },\n      unset: {\n        value(...propertyIds: readonly unknown[]) {\n          operations.push({\n            kind: \"object.unset\",\n            objectTypeId: ref.objectTypeId,\n            primaryId: ref.primaryId,\n            propertyIds: normalizeEditablePropertyIds({\n              objectType,\n              propertyIds,\n              operation: \"unset\",\n            }),\n          })\n        },\n      },\n      reset: {\n        value(...propertyIds: readonly unknown[]) {\n          operations.push({\n            kind: \"object.reset\",\n            objectTypeId: ref.objectTypeId,\n            primaryId: ref.primaryId,\n            propertyIds: normalizeEditablePropertyIds({\n              objectType,\n              propertyIds,\n              operation: \"reset\",\n            }),\n          })\n        },\n      },\n      delete: {\n        value() {\n          operations.push({\n            kind: \"object.delete\",\n            objectTypeId: ref.objectTypeId,\n            primaryId: ref.primaryId,\n          })\n        },\n      },\n      restore: {\n        value() {\n          operations.push({\n            kind: \"object.restore\",\n            objectTypeId: ref.objectTypeId,\n            primaryId: ref.primaryId,\n          })\n        },\n      },\n      link: {\n        value(\n          link: { objectTypeId: string; id: string; link: ObjectLink },\n          target: EditObjectRef,\n          linkOptions?: { readonly properties?: Readonly<Record<string, unknown>> }\n        ) {\n          assertLinkTokenSource(ref, link)\n\n          const properties =\n            linkOptions?.properties === undefined\n              ? undefined\n              : normalizeLinkEditProperties({\n                  sourceObjectTypeId: ref.objectTypeId,\n                  linkId: link.id,\n                  linkDefinition: link.link,\n                  properties: linkOptions.properties,\n                  valueTypesById,\n                })\n\n          operations.push({\n            kind: \"link.upsert\",\n            source: toPlainRef(ref),\n            linkId: link.id,\n            target: toPlainRef(target),\n            ...(properties !== undefined ? { properties } : {}),\n          })\n        },\n      },\n      unlink: {\n        value(link: { objectTypeId: string; id: string; link: ObjectLink }, target: EditObjectRef) {\n          assertLinkTokenSource(ref, link)\n\n          operations.push({\n            kind: \"link.delete\",\n            source: toPlainRef(ref),\n            linkId: link.id,\n            target: toPlainRef(target),\n          })\n        },\n      },\n      resetLink: {\n        value(link: { objectTypeId: string; id: string; link: ObjectLink }, target: EditObjectRef) {\n          assertLinkTokenSource(ref, link)\n\n          operations.push({\n            kind: \"link.reset\",\n            source: toPlainRef(ref),\n            linkId: link.id,\n            target: toPlainRef(target),\n          })\n        },\n      },\n    })\n\n    return handle as EditObjectHandle<ObjectTypeWithPropertyTokens>\n  }\n\n  return {\n    objects,\n    toEditBatch,\n  }\n}\n\nfunction assertLinkTokenSource(\n  source: EditObjectRef,\n  link: { readonly objectTypeId: string; readonly id: string }\n): void {\n  if (source.objectTypeId !== link.objectTypeId) {\n    throw new OntologyValidationError(\n      `[Sixb] Link token ${link.objectTypeId}.${link.id} cannot be used with ${source.objectTypeId}`\n    )\n  }\n}\n\nfunction createRef<TObjectTypeId extends string>(\n  objectTypeId: TObjectTypeId,\n  primaryId: string\n): EditObjectRef<TObjectTypeId> {\n  return {\n    objectTypeId: assertNonEmptyString(objectTypeId, \"objectTypeId\") as TObjectTypeId,\n    primaryId: assertNonEmptyString(primaryId, `${objectTypeId}.primaryId`),\n  }\n}\n\nfunction generatePrimaryId(params: {\n  readonly runId: string\n  readonly operationPath: string\n  readonly objectTypeId: string\n}): string {\n  const hash = createHash(\"sha256\")\n    .update(`${params.runId}:${params.operationPath}:${params.objectTypeId}`)\n    .digest(\"hex\")\n    .slice(0, 24)\n  return `edit_${hash}`\n}\n\n/** Primary identity lives in the object ref; managed authority never stores it as a property. */\nfunction withoutPrimaryProperty(\n  properties: EditObjectProperties,\n  primaryPropertyId: string\n): EditObjectProperties {\n  const { [primaryPropertyId]: _primary, ...rest } = properties\n  return rest\n}\n\nfunction assertRecord(value: unknown, label: string): Record<string, unknown> {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    throw new EditBatchError(`[Sixb] EditBatch ${label} must be an object.`)\n  }\n  return value as Record<string, unknown>\n}\n\nfunction assertNonEmptyString(value: unknown, label: string): string {\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new EditBatchError(`[Sixb] EditBatch ${label} must be a non-empty string.`)\n  }\n  return value\n}\n\nfunction toPlainRef(ref: EditObjectRef): EditObjectRef {\n  return {\n    objectTypeId: ref.objectTypeId,\n    primaryId: ref.primaryId,\n  }\n}\n",
+    "import type { ObjectLink, Property, ValueType } from \"../ontology\"\nimport { OntologyValidationError } from \"../ontology/errors\"\nimport type { ObjectTypeWithPropertyTokens } from \"../ontology/tokens\"\nimport {\n  assertKnownProperties,\n  normalizeObjectProperties,\n  validateObjectProperties,\n  validatePropertyValue,\n} from \"../ontology/validation\"\nimport { EditBatchError } from \"./errors\"\nimport type { EditObjectProperties } from \"./types\"\n\nexport function normalizeObjectEditProperties(params: {\n  readonly objectType: ObjectTypeWithPropertyTokens\n  readonly properties: Record<string, unknown>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n  readonly path: string\n}): EditObjectProperties {\n  const { objectType, properties, valueTypesById, path } = params\n  assertKnownProperties(objectType, properties)\n  assertNoTelemetryProperties(objectType.properties, properties, path)\n  validateObjectProperties(objectType, properties, valueTypesById)\n  return normalizeObjectProperties(objectType.properties, properties, valueTypesById, path)\n}\n\nexport function normalizeLinkEditProperties(params: {\n  readonly sourceObjectTypeId: string\n  readonly linkId: string\n  readonly linkDefinition: ObjectLink\n  readonly properties: Readonly<Record<string, unknown>>\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n}): EditObjectProperties {\n  const { sourceObjectTypeId, linkId, linkDefinition, properties, valueTypesById } = params\n  const linkProperties = linkDefinition.properties ?? []\n\n  if (linkProperties.length === 0 && Object.keys(properties).length > 0) {\n    throw new OntologyValidationError(\n      `[Sixb] Link ${sourceObjectTypeId}.${linkId} does not define link properties`\n    )\n  }\n\n  const knownPropertyIds = new Set(linkProperties.map((property) => property.id))\n  for (const propertyId of Object.keys(properties)) {\n    if (!knownPropertyIds.has(propertyId)) {\n      throw new OntologyValidationError(\n        `[Sixb] Unknown link property '${propertyId}' for link '${sourceObjectTypeId}.${linkId}'`\n      )\n    }\n  }\n\n  assertNoTelemetryProperties(linkProperties, properties, `${sourceObjectTypeId}.${linkId}`)\n\n  for (const [propertyId, value] of Object.entries(properties)) {\n    const property = linkProperties.find((candidate) => candidate.id === propertyId)\n    if (!property) continue\n    validatePropertyValue(\n      property,\n      value,\n      `${sourceObjectTypeId}.${linkId}.${propertyId}`,\n      valueTypesById\n    )\n  }\n\n  return normalizeObjectProperties(\n    linkProperties,\n    properties,\n    valueTypesById,\n    `${sourceObjectTypeId}.${linkId}`\n  )\n}\n\nexport function getPrimaryProperty(objectType: ObjectTypeWithPropertyTokens): Property {\n  const primaryProperty = objectType.properties.find((property) => property.primary)\n  if (!primaryProperty) {\n    throw new OntologyValidationError(\n      `[Sixb] Object type '${objectType.id}' has no primary property`\n    )\n  }\n  return primaryProperty\n}\n\nexport function assertPrimaryPropertyNotUpdated(\n  objectType: ObjectTypeWithPropertyTokens,\n  properties: EditObjectProperties\n): void {\n  const primaryProperty = getPrimaryProperty(objectType)\n  if (Object.hasOwn(properties, primaryProperty.id)) {\n    throw new EditBatchError(\n      `[Sixb] EditBatch cannot update primary property '${objectType.id}.${primaryProperty.id}'.`\n    )\n  }\n}\n\n/** Validates `unset`/`reset` targets: known, non-primary, and not telemetry-backed. */\nexport function normalizeEditablePropertyIds(params: {\n  readonly objectType: ObjectTypeWithPropertyTokens\n  readonly propertyIds: readonly unknown[]\n  readonly operation: \"unset\" | \"reset\"\n}): readonly string[] {\n  const { objectType, propertyIds, operation } = params\n  const primaryProperty = getPrimaryProperty(objectType)\n  const normalized: string[] = []\n  const seen = new Set<string>()\n\n  for (const propertyId of propertyIds) {\n    if (typeof propertyId !== \"string\" || !propertyId.trim()) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch ${objectType.id}.${operation} property id must be a non-empty string.`\n      )\n    }\n    const property = objectType.properties.find((candidate) => candidate.id === propertyId)\n    if (!property) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch ${operation} references unknown property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (property.id === primaryProperty.id) {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot ${operation} primary property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (property.mode === \"telemetry\") {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot ${operation} telemetry property '${objectType.id}.${propertyId}'.`\n      )\n    }\n    if (seen.has(propertyId)) continue\n    seen.add(propertyId)\n    normalized.push(propertyId)\n  }\n\n  if (normalized.length === 0) {\n    throw new EditBatchError(\n      `[Sixb] EditBatch ${objectType.id}.${operation} requires at least one property id.`\n    )\n  }\n  return normalized\n}\n\nfunction assertNoTelemetryProperties(\n  definitions: readonly Property[],\n  properties: Readonly<Record<string, unknown>>,\n  path: string\n): void {\n  for (const propertyId of Object.keys(properties)) {\n    const property = definitions.find((candidate) => candidate.id === propertyId)\n    if (property?.mode === \"telemetry\") {\n      throw new EditBatchError(\n        `[Sixb] EditBatch cannot edit telemetry property '${path}.${propertyId}' in the MVP.`\n      )\n    }\n  }\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "80751F89CEB9E0C664756E2164756E21",
+  "names": []
+}

package/dist/agents/adapters.d.ts

@@ -0,0 +1,185 @@
+import { type FileRef } from "../blob-storage";
+import { type JsonValue } from "../json";
+import { type AgentContextInput, type AgentContextOrigin } from "./context";
+import type { AgentMessage, AgentMessagePart, AgentMessageRole } from "./message";
+export interface AgentInboundUiMessagePart {
+    readonly type: string;
+    readonly text?: string;
+    readonly state?: string;
+    readonly providerMetadata?: unknown;
+    readonly toolName?: string;
+    readonly toolCallId?: string;
+    readonly providerExecuted?: boolean;
+    readonly input?: unknown;
+    readonly rawInput?: unknown;
+    readonly output?: unknown;
+    readonly errorText?: string;
+    readonly callProviderMetadata?: unknown;
+    readonly fileRef?: unknown;
+    readonly context?: unknown;
+    readonly origin?: unknown;
+}
+export interface AgentInboundUiMessage {
+    readonly role: string;
+    readonly id?: string;
+    readonly metadata?: unknown;
+    readonly parts: readonly AgentInboundUiMessagePart[];
+}
+interface AgentUiToolPartBody {
+    readonly toolCallId: string;
+    readonly providerExecuted?: boolean;
+    readonly callProviderMetadata?: JsonValue;
+}
+export type AgentUiToolPart = ({
+    readonly type: `tool-${string}`;
+} & AgentUiToolPartBody & ({
+    readonly state: "output-available";
+    readonly input: JsonValue;
+    readonly output: JsonValue;
+} | {
+    readonly state: "output-error";
+    readonly input: JsonValue;
+    readonly errorText: string;
+})) | ({
+    readonly type: "dynamic-tool";
+    readonly toolName: string;
+} & AgentUiToolPartBody & ({
+    readonly state: "output-available";
+    readonly input: JsonValue;
+    readonly output: JsonValue;
+} | {
+    readonly state: "output-error";
+    readonly input: JsonValue;
+    readonly errorText: string;
+}));
+export type AgentUiMessagePart = {
+    readonly type: "text";
+    readonly text: string;
+    readonly providerMetadata?: JsonValue;
+} | {
+    readonly type: "reasoning";
+    readonly text: string;
+    readonly providerMetadata?: JsonValue;
+} | {
+    readonly type: "step-start";
+} | {
+    readonly type: "file";
+    readonly fileRef: FileRef;
+    readonly providerMetadata?: JsonValue;
+} | {
+    readonly type: "context";
+    readonly context: AgentContextInput;
+    readonly origin: AgentContextOrigin;
+} | AgentUiToolPart;
+export interface AgentUiMessage {
+    readonly role: AgentMessageRole;
+    readonly id?: string;
+    readonly metadata?: JsonValue;
+    readonly parts: readonly AgentUiMessagePart[];
+}
+export type AgentModelToolOutput = {
+    readonly type: "text";
+    readonly value: string;
+} | {
+    readonly type: "json";
+    readonly value: JsonValue;
+} | {
+    readonly type: "error-text";
+    readonly value: string;
+} | {
+    readonly type: "error-json";
+    readonly value: JsonValue;
+};
+export interface AgentModelTextPart {
+    readonly type: "text";
+    readonly text: string;
+    readonly providerOptions?: JsonValue;
+}
+export interface AgentModelFilePart {
+    readonly type: "file";
+    readonly data: URL;
+    readonly filename?: string;
+    readonly mediaType: string;
+    readonly providerOptions?: JsonValue;
+}
+export interface AgentModelReasoningPart {
+    readonly type: "reasoning";
+    readonly text: string;
+    readonly providerOptions?: JsonValue;
+}
+export interface AgentModelToolCallPart {
+    readonly type: "tool-call";
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly input: JsonValue;
+    readonly providerExecuted?: boolean;
+    readonly providerOptions?: JsonValue;
+}
+export interface AgentModelToolResultPart {
+    readonly type: "tool-result";
+    readonly toolCallId: string;
+    readonly toolName: string;
+    readonly output: AgentModelToolOutput;
+    readonly providerOptions?: JsonValue;
+}
+export type AgentModelAssistantPart = AgentModelTextPart | AgentModelReasoningPart | AgentModelToolCallPart | AgentModelToolResultPart;
+export type AgentModelMessage = {
+    readonly role: "system";
+    readonly content: string;
+    readonly providerOptions?: JsonValue;
+} | {
+    readonly role: "user";
+    readonly content: readonly (AgentModelTextPart | AgentModelFilePart)[];
+} | {
+    readonly role: "assistant";
+    readonly content: readonly AgentModelAssistantPart[];
+} | {
+    readonly role: "tool";
+    readonly content: readonly AgentModelToolResultPart[];
+};
+export interface AgentFileDataResolverInput<TMessage extends AgentMessage = AgentMessage> {
+    readonly message: TMessage;
+    readonly part: Extract<AgentMessagePart, {
+        type: "file";
+    }>;
+    readonly partIndex: number;
+}
+export interface AgentFileDataProjection {
+    readonly data: URL;
+    readonly mediaType?: string;
+    readonly filename?: string;
+}
+export interface ToModelMessagesOptions<TMessage extends AgentMessage = AgentMessage> {
+    /**
+     * Convert a stored file reference into model-readable data. When omitted, file parts are skipped
+     * rather than leaking blob ids or passing an unsupported Sixb-only shape to model providers.
+     */
+    readonly fileData?: ((input: AgentFileDataResolverInput<TMessage>) => URL | AgentFileDataProjection | undefined) | undefined;
+    /**
+     * Convert a stored file reference into model-readable text context. This is appended before any
+     * file data part so metadata, truncation notes, and sandbox/API access hints stay visible even for
+     * models that cannot consume inline files.
+     */
+    readonly fileText?: (input: AgentFileDataResolverInput<TMessage>) => string | undefined;
+}
+/**
+ * Convert an SDK-shaped UI message into a durable {@link AgentMessage}. Total: throws
+ * {@link AgentMessageAdapterError} on any part kind, tool state, or text/reasoning state that V1 does
+ * not model, and on a role outside `system | user | assistant`. Transient states are rejected
+ * because messages are only ever persisted once a run has finished.
+ */
+export declare function fromAiSdk(message: AgentInboundUiMessage): AgentMessage;
+/** Reconstruct an SDK-shaped UI message from a stored message. Exact inverse of {@link fromAiSdk}. */
+export declare function toUiMessage(message: AgentMessage): AgentUiMessage;
+/**
+ * Project messages into AI SDK `ModelMessage`s for replay into a model. The assistant/tool split
+ * is hand-rolled to mirror `convertToModelMessages` (no `ai` import): assistant parts are grouped
+ * into blocks at each `step-start`; each block yields one `assistant` message plus, for any
+ * non-provider-executed tool calls, one `tool` message. Provider-executed tool results stay inline
+ * in the assistant message. Without a tool registry, a string output maps to `text` and anything
+ * else to `json`; this is the documented V1 fidelity scope (a tool's custom `toModelOutput` is not
+ * reproduced).
+ */
+export declare function toModelMessages<TMessage extends AgentMessage>(messages: readonly TMessage[], options?: ToModelMessagesOptions<TMessage>): AgentModelMessage[];
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/agents/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"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"}

package/dist/agents/api-gateway.d.ts

@@ -0,0 +1,21 @@
+export declare const AGENT_API_GATEWAY_PREFIX = "/__sixb/agent-api";
+export interface AgentApiGatewayCapabilityInput {
+    readonly projectId: string;
+    readonly runId: string;
+    readonly executionToken: string;
+}
+export interface AgentApiRoute {
+    readonly method: string;
+    readonly path: string;
+}
+/**
+ * The routes the agent API gateway may proxy — the `agentApi` projection of the canonical
+ * {@link SIXB_API_ROUTES} table, so this list can never drift from (nor exceed) the bearer boundary.
+ */
+export declare const AGENT_API_ROUTES: readonly AgentApiRoute[];
+export declare function createAgentApiGatewayCapability(input: AgentApiGatewayCapabilityInput): string;
+export declare function isValidAgentApiGatewayCapability(input: AgentApiGatewayCapabilityInput & {
+    readonly capability: string;
+}): boolean;
+export declare function isAllowedAgentApiRequest(method: string, pathname: string): boolean;
+//# sourceMappingURL=api-gateway.d.ts.map

package/dist/agents/api-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-gateway.d.ts","sourceRoot":"","sources":["../../src/agents/api-gateway.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,wBAAwB,sBAAsB,CAAA;AAI3D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAES,CAAA;AAE9D,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,8BAA8B,GAAG,MAAM,CAE7F;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,8BAA8B,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtE,OAAO,CAST;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMlF"}

package/dist/agents/builders.d.ts

@@ -0,0 +1,10 @@
+import type { AgentDefinition, DefineAgentConfig } from "./types";
+/**
+ * Define an agent: a conversational, looping actor auto-discovered from `agents/`.
+ *
+ * The returned definition is declarative and can be exported from a project-level
+ * `agents/` module. The runtime loads and registers it (`sixb.agents`); the agent
+ * worker executes it as a running, streaming agent.
+ */
+export declare function defineAgent<const TId extends string>(id: TId, config: DefineAgentConfig): AgentDefinition<TId>;
+//# sourceMappingURL=builders.d.ts.map

package/dist/agents/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/agents/builders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AASjE;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAClD,EAAE,EAAE,GAAG,EACP,MAAM,EAAE,iBAAiB,GACxB,eAAe,CAAC,GAAG,CAAC,CAyBtB"}

package/dist/agents/context-model.d.ts

@@ -0,0 +1,4 @@
+import type { AgentContextPart } from "./context";
+/** Project persisted context into one deterministic, escaped data block for the model. */
+export declare function serializeAgentContextForModel(parts: readonly AgentContextPart[]): string | undefined;
+//# sourceMappingURL=context-model.d.ts.map

package/dist/agents/context-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-model.d.ts","sourceRoot":"","sources":["../../src/agents/context-model.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAEjD,0FAA0F;AAC1F,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,SAAS,gBAAgB,EAAE,GACjC,MAAM,GAAG,SAAS,CAyBpB"}

package/dist/agents/context-resolution.d.ts

@@ -0,0 +1,5 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import { type AgentContextEntryInput, type AgentContextPart } from "./context";
+/** Resolve the exact context parts that will be persisted with the triggering user message. */
+export declare function resolveAgentContextParts(runtime: SixbRuntimeContext, input: readonly AgentContextEntryInput[] | undefined): Promise<readonly AgentContextPart[]>;
+//# sourceMappingURL=context-resolution.d.ts.map