@sixb/core 0.1.17 → 0.1.19

package/dist/ontology/docs.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Where each object type's Agent reference doc lives, and which hand-written docs and scripts are
+ * mounted next to it.
+ *
+ * The generated doc of a type mirrors the `ontology/` module that defines it:
+ * `billing/invoice.ts` → `billing/invoice.md`. A module that defines several types gets a folder,
+ * one doc per type: `billing.ts` → `billing/Invoice.md`, `billing/Customer.md`.
+ *
+ * Hand-written docs are notes when they sit at a type's doc path or next to a module exporting the
+ * type (`billing.md` for every type of `billing.ts`), compared without case. Notes are appended to
+ * the doc of each visible type they belong to, so a reader never receives the notes of types it
+ * cannot see. Any other hand-written doc is mounted as written, for every reader.
+ */
+import type { AgentProjectFile } from "../agents/skills";
+import type { ObjectType } from "./types";
+/** Hand-written Markdown under `ontology/`. */
+export interface OntologyDoc {
+    /** POSIX path relative to `ontology/`. */
+    readonly path: string;
+    readonly contents: string;
+}
+/** The Agent's files under `ontology/`, as createSixb() discovers them. */
+export interface OntologyDocsInput {
+    /** Each module, by POSIX path relative to `ontology/`, with the object types it exports. */
+    readonly modules: readonly {
+        readonly path: string;
+        readonly objectTypeIds: readonly string[];
+    }[];
+    readonly docs: readonly OntologyDoc[];
+    /** Every file in a `scripts/` directory under `ontology/`, mounted as written. */
+    readonly scripts: readonly AgentProjectFile[];
+}
+/** Paths are POSIX and relative to `ontology/`. */
+export interface OntologyDocsCatalog {
+    /** Path of the doc generated for this object type. */
+    docPathFor(objectTypeId: string): string;
+    /** The team's notes for this type, appended to its doc. Sorted by path. */
+    notesFor(objectTypeId: string): readonly OntologyDoc[];
+    /** Hand-written docs that belong to no object type, mounted for every reader. */
+    listDocs(): readonly OntologyDoc[];
+    listScripts(): readonly AgentProjectFile[];
+    /** Whether a link declares any type (`*`) as its target. Readers' views expand it. */
+    isWildcardLink(objectTypeId: string, linkId: string): boolean;
+}
+/** Resolve every registered object type's doc path, rejecting two files that would share one. */
+export declare function createOntologyDocsCatalog(input: {
+    readonly objectTypes: readonly ObjectType[];
+    readonly docs?: OntologyDocsInput;
+}): OntologyDocsCatalog;
+//# sourceMappingURL=docs.d.ts.map

package/dist/ontology/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/ontology/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAEzC,+CAA+C;AAC/C,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;IACjG,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAA;IACrC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAC9C;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAAA;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAA;IACtD,iFAAiF;IACjF,QAAQ,IAAI,SAAS,WAAW,EAAE,CAAA;IAClC,WAAW,IAAI,SAAS,gBAAgB,EAAE,CAAA;IAC1C,sFAAsF;IACtF,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CAC9D;AAED,iGAAiG;AACjG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAA;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAClC,GAAG,mBAAmB,CAsFtB"}

package/dist/ontology/index.js

@@ -10,12 +10,13 @@ import {
   valueTypeRef2,
   stringEnum2,
   integerEnum2
-} from "../chunk-xyvy73tj.js";
+} from "../chunk-bpgy64fw.js";
 import {
   ref2,
   objectRef2,
   isObjectRefSchema2
-} from "../chunk-rx7h5fdx.js";
+} from "../chunk-v9xd5wzd.js";
+import"../chunk-xt1zt7gv.js";
 import {
   userRef2,
   quantitativeTypes2,
@@ -25,11 +26,12 @@ import {
   getUnitSymbol2,
   isQuantitativeTypeId2,
   isUnitId2
-} from "../chunk-rpxz486p.js";
+} from "../chunk-hvsb78a1.js";
 import {
   OntologyValidationError2,
   OntologyNotFoundError2
 } from "../chunk-cqr3acm1.js";
+import"../chunk-enpsx8k5.js";
 import {
   decimal2,
   normalizeDecimalValue2,
@@ -37,6 +39,7 @@ import {
   isDecimalValue2,
   compareDecimalValues2
 } from "../chunk-3bh94gbw.js";
+import"../chunk-jhm3zsa7.js";
 import"../chunk-z3y5kg1x.js";
 export {
   OntologyNotFoundError2 as OntologyNotFoundError,
@@ -69,4 +72,4 @@ export {
   valueTypeRef2 as valueTypeRef
 };
 
-//# debugId=DE5798CEC1E1158E64756E2164756E21
+//# debugId=BFE4F26A4CD2571E64756E2164756E21

package/dist/ontology/index.js.map

@@ -4,6 +4,6 @@
   "sourcesContent": [
   ],
   "mappings": "",
-  "debugId": "DE5798CEC1E1158E64756E2164756E21",
+  "debugId": "BFE4F26A4CD2571E64756E2164756E21",
   "names": []
 }

package/dist/ontology/inference/index.d.ts

@@ -95,6 +95,25 @@ export type InferObjectProperties<TObjectType extends {
         required: true;
     } ? never : TProp["id"]]?: InferPropertyValue<TProp, TValueTypes>;
 }>;
+/**
+ * Property values as a principal reads them. A marked property may be redacted, so it is optional
+ * even when required; writes keep {@link InferObjectProperties}.
+ */
+export type InferObjectReadProperties<TObjectType extends {
+    properties: readonly Property[];
+}, TValueTypes extends readonly ValueType[] = RegisteredValueTypes> = string extends TObjectType["properties"][number]["id"] ? Record<string, unknown> : Simplify<{
+    [TProp in TObjectType["properties"][number] as TProp extends {
+        required: true;
+    } ? TProp extends {
+        markings: readonly string[];
+    } ? never : TProp["id"] : never]: InferPropertyValue<TProp, TValueTypes>;
+} & {
+    [TProp in TObjectType["properties"][number] as TProp extends {
+        required: true;
+    } ? TProp extends {
+        markings: readonly string[];
+    } ? TProp["id"] : never : TProp["id"]]?: InferPropertyValue<TProp, TValueTypes>;
+}>;
 /** Useful for APIs that should only accept telemetry-mode properties. */
 export type InferTelemetryPropertyIds<TObjectType extends {
     properties: readonly Property[];

package/dist/ontology/inference/index.d.ts.map

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

package/dist/ontology/internal.d.ts

@@ -1,3 +1,5 @@
+export type { OntologyDocsIndexEntry, RenderedOntologyDocs, RenderOntologyDocsInput, } from "./docs-markdown";
+export { renderOntologyDocs } from "./docs-markdown";
 export { schemaFieldsToJsonSchema, schemaRecordToJsonSchema } from "./json-schema";
 export { resolvePropertyQueryCapabilities } from "./query-capabilities";
 export { validateSchemaOrRefValue } from "./refs";
@@ -6,6 +8,6 @@ export { assertLinkTargetType, assertTargetTypeCompatible, normalizeLinkProperti
 export { coerceSchemaValueToTyped, normalizeObjectProperties, normalizeSchemaValue, } from "./validation/normalize";
 export { assertKnownProperties, assertLinkTokenBelongsToObjectType, assertObjectTypeRegistered, assertPropertyTokenBelongsToObjectType, assertRequiredProperties, validateObjectProperties, validatePrimaryProperties, validatePropertyDefinitions, validatePropertyValue, } from "./validation/properties";
 export { validateQueryMetadata } from "./validation/query";
-export { isRecord, resolveValueTypeRef, resolveValueTypeSchema, validateSchemaValue, } from "./validation/schema";
+export { assertValidFileRefs, isRecord, resolveValueTypeRef, resolveValueTypeSchema, validateSchemaValue, } from "./validation/schema";
 export { assertTelemetryProperty, resolveSemanticType, validateTelemetryUnit, } from "./validation/telemetry";
 //# sourceMappingURL=internal.d.ts.map

package/dist/ontology/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/ontology/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,0BAA0B,EAC1B,sCAAsC,EACtC,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/ontology/internal.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAA;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,0BAA0B,EAC1B,sCAAsC,EACtC,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EACL,mBAAmB,EACnB,QAAQ,EACR,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,wBAAwB,CAAA"}

package/dist/ontology/internal.js

@@ -1,6 +1,7 @@
 // @bun
 import {
   validateSchemaValue2,
+  assertValidFileRefs2,
   resolveValueTypeRef2,
   resolveValueTypeSchema2,
   isRecord2,
@@ -21,15 +22,17 @@ import {
   normalizeLinkProperties2,
   validateLinkProperties2,
   resolvePropertyQueryCapabilities2,
+  resolveQuerySchema,
   validateQueryMetadata2,
   assertTelemetryProperty2,
   resolveSemanticType2,
   validateTelemetryUnit2
-} from "../chunk-rpxz486p.js";
+} from "../chunk-hvsb78a1.js";
+import"../chunk-jhm3zsa7.js";
 import"../chunk-z3y5kg1x.js";
 import {
   validateSchemaOrRefValue2
-} from "../chunk-rx7h5fdx.js";
+} from "../chunk-v9xd5wzd.js";
 import {
   schemaRecordToJsonSchema2,
   schemaFieldsToJsonSchema2
@@ -38,6 +41,274 @@ import {
   createPropertyTokenMap2,
   createLinkTokenMap2
 } from "../chunk-rdghfsss.js";
+
+// src/ontology/docs-markdown.ts
+var MAX_SUMMARY_LENGTH = 120;
+var EXACT = ["eq", "neq", "in", "exists"];
+var RANGE = ["lt", "lte", "gt", "gte"];
+var ORDERED_SCHEMAS = new Set([
+  "integer",
+  "double",
+  "decimal",
+  "date",
+  "timestamp"
+]);
+var ABBREVIATION_END_RE = /\b(?:e\.g|i\.e|etc|vs|cf)\.$/i;
+function renderOntologyDocs(input) {
+  const objectTypes = input.objectTypes;
+  const objectTypesById = new Map(objectTypes.map((objectType) => [objectType.id, objectType]));
+  const docs = [
+    ...objectTypes.map((objectType) => ({
+      path: input.catalog.docPathFor(objectType.id),
+      contents: renderObjectTypeDoc({
+        ...input,
+        objectType,
+        objectTypes,
+        objectTypesById,
+        restricted: input.restrictedPropertyIds?.(objectType.id) ?? new Set
+      }),
+      summary: typeSummary(objectType)
+    })),
+    ...input.catalog.listDocs().map((doc) => ({
+      path: doc.path,
+      contents: doc.contents,
+      summary: firstHeading(doc.contents) ?? ""
+    }))
+  ];
+  const scripts = input.catalog.listScripts();
+  const scriptDirectories = [...new Set(scripts.map((script) => scriptsDirectoryOf(script.path)))];
+  return Object.freeze({
+    files: Object.freeze([...docs.map(({ path, contents }) => ({ path, contents })), ...scripts].sort(byPath)),
+    index: Object.freeze([
+      ...docs.map(({ path, summary }) => ({ path, summary })),
+      ...scriptDirectories.map((path) => ({ path, summary: "Scripts" }))
+    ].sort(byPath))
+  });
+}
+function renderObjectTypeDoc(input) {
+  const { objectType, restricted } = input;
+  const sections = [
+    objectType.name === objectType.id ? `# ${objectType.id}` : `# ${objectType.id} \u2014 ${oneLine(objectType.name)}`,
+    objectType.description?.trim(),
+    objectType.extends === undefined ? undefined : `Extends \`${objectType.extends}\`.`,
+    renderProperties(objectType, input.valueTypesById, restricted),
+    renderVectorProfiles(objectType, restricted),
+    renderLinks(objectType, input.objectTypesById, input.catalog),
+    renderIncomingLinks(objectType, input.objectTypes, input.catalog),
+    renderActions(input.actionsFor(objectType), input.valueTypesById),
+    renderNotes(input.catalog.notesFor(objectType.id))
+  ];
+  return `${sections.filter((section) => section !== undefined && section !== "").join(`
+
+`)}
+`;
+}
+function renderProperties(objectType, valueTypesById, restricted) {
+  if (objectType.properties.length === 0)
+    return;
+  const anyRestricted = objectType.properties.some((property) => restricted.has(property.id));
+  return [
+    "## Properties",
+    "",
+    ...anyRestricted ? ["Restricted properties: this user is not cleared to read or query their values.", ""] : [],
+    table(["Property", "Type", "Query", "Description"], objectType.properties.map((property) => [
+      code(property.id),
+      withFlags(schemaLabel(property.schema, valueTypesById), [
+        ...property.primary ? ["primary key"] : [],
+        ...property.required && !property.primary ? ["required"] : [],
+        ...property.nullable ? ["nullable"] : [],
+        ...property.mode === "telemetry" ? ["telemetry"] : [],
+        ...restricted.has(property.id) ? ["restricted"] : []
+      ]),
+      restricted.has(property.id) ? "\u2014" : queryLabel(property, valueTypesById),
+      property.description ?? ""
+    ]))
+  ].join(`
+`);
+}
+function queryLabel(property, valueTypesById) {
+  const capabilities = resolvePropertyQueryCapabilities2(property, valueTypesById);
+  const schema = resolveQuerySchema(property.schema, valueTypesById);
+  const meaningful = schema === undefined ? new Set : meaningfulOperators(schema);
+  const operators = capabilities.operators.filter((operator) => meaningful.has(operator));
+  const labels = [
+    ...operators.length === 0 ? [] : [`filter: ${operators.join(", ")}`],
+    ...capabilities.sortable ? ["sort"] : [],
+    ...capabilities.text ? ["text"] : [],
+    ...capabilities.facet ? ["facet"] : []
+  ];
+  return labels.length === 0 ? "\u2014" : labels.join("; ");
+}
+function meaningfulOperators(schema) {
+  if (typeof schema === "string") {
+    return new Set(ORDERED_SCHEMAS.has(schema) ? [...EXACT, ...RANGE] : EXACT);
+  }
+  if (schema.type === "enum")
+    return new Set(EXACT);
+  if (schema.type === "array" || schema.type === "map")
+    return new Set(["contains"]);
+  return new Set;
+}
+function renderVectorProfiles(objectType, restricted) {
+  const profiles = Object.entries(objectType.search?.vectors ?? {}).filter(([, profile]) => profile.source.every((propertyId) => !restricted.has(propertyId)));
+  if (profiles.length === 0)
+    return;
+  return [
+    "## Vector search profiles",
+    "",
+    table(["Profile", "Sources"], profiles.sort(([left], [right]) => left.localeCompare(right)).map(([name, profile]) => [code(name), profile.source.map(code).join(", ")]))
+  ].join(`
+`);
+}
+function renderLinks(objectType, objectTypesById, catalog) {
+  if (objectType.links.length === 0)
+    return;
+  return [
+    "## Links",
+    "",
+    table(["Link", "Target", "Cardinality", "Description", "Target description"], objectType.links.map((link) => {
+      const targets = catalog.isWildcardLink(objectType.id, link.id) ? ["*"] : linkTargets(link);
+      return [
+        code(link.id),
+        targets.map(code).join(", "),
+        link.cardinality ?? "many",
+        link.description ?? "",
+        targets.map((targetId) => firstSentence(objectTypesById.get(targetId)?.description)).filter((description) => description !== undefined).join(" ")
+      ];
+    }))
+  ].join(`
+`);
+}
+function renderIncomingLinks(objectType, objectTypes, catalog) {
+  const incoming = objectTypes.flatMap((source) => source.links.filter((link) => !catalog.isWildcardLink(source.id, link.id) && linkTargets(link).includes(objectType.id)).map((link) => [
+    code(source.id),
+    code(link.id),
+    link.cardinality ?? "many",
+    link.description ?? ""
+  ]));
+  if (incoming.length === 0)
+    return;
+  return [
+    "## Incoming links",
+    "",
+    "Declared on other types; traverse them with direction `incoming`.",
+    "",
+    table(["From", "Link", "Cardinality", "Description"], incoming)
+  ].join(`
+`);
+}
+function renderActions(actions, valueTypesById) {
+  if (actions.length === 0)
+    return;
+  return [
+    "## Actions",
+    ...[...actions].sort((left, right) => left.id.localeCompare(right.id)).map((action) => {
+      const params = Object.entries(action.params);
+      return [
+        `### ${code(action.id)}`,
+        ...action.description?.trim() ? [action.description.trim()] : [],
+        params.length === 0 ? "No parameters." : table(["Param", "Type", "Required", "Description"], params.map(([id, param]) => [
+          code(id),
+          paramTypeLabel(param, valueTypesById),
+          param.required ? "yes" : "no",
+          param.description ?? ""
+        ]))
+      ].join(`
+
+`);
+    })
+  ].join(`
+
+`);
+}
+function renderNotes(notes) {
+  const contents = notes.map((note) => note.contents.trim()).filter(Boolean);
+  return contents.length === 0 ? undefined : `## Project notes
+
+${contents.join(`
+
+`)}`;
+}
+function paramTypeLabel(param, valueTypesById) {
+  return withFlags(schemaLabel(param.schema, valueTypesById), param.nullable ? ["nullable"] : []);
+}
+function withFlags(label, flags) {
+  return flags.length === 0 ? label : `${label} (${flags.join(", ")})`;
+}
+function schemaLabel(schema, valueTypesById, seen = new Set) {
+  if (typeof schema === "string")
+    return schema;
+  switch (schema.type) {
+    case "enum":
+      return `one of ${schema.values.map((value) => code(String(value))).join(", ")}`;
+    case "array":
+      return `array of ${schemaLabel(schema.items, valueTypesById, seen)}`;
+    case "map":
+      return `map of string to ${schemaLabel(schema.valueSchema, valueTypesById, seen)}`;
+    case "object":
+      return `object { ${Object.entries(schema.properties).map(([id, field]) => `${id}${field.required ? "" : "?"}: ${schemaLabel(field.schema, valueTypesById, seen)}`).join(", ")} }`;
+    case "objectRef":
+      return `reference to ${code(schema.objectTypeId)}`;
+    case "valueTypeRef": {
+      const resolved = valueTypesById.get(schema.valueTypeId)?.schema;
+      if (resolved === undefined || seen.has(schema.valueTypeId))
+        return schema.valueTypeId;
+      const nested = new Set(seen).add(schema.valueTypeId);
+      return `${schema.valueTypeId} (${schemaLabel(resolved, valueTypesById, nested)})`;
+    }
+  }
+}
+function linkTargets(link) {
+  return (Array.isArray(link.targetObjectTypeId) ? link.targetObjectTypeId : [link.targetObjectTypeId]).filter((targetId) => targetId !== "*");
+}
+function scriptsDirectoryOf(path) {
+  const segments = path.split("/");
+  return `${segments.slice(0, segments.indexOf("scripts") + 1).join("/")}/`;
+}
+function typeSummary(objectType) {
+  const description = firstSentence(objectType.description);
+  if (description !== undefined)
+    return `${objectType.id}: ${description}`;
+  return objectType.name === objectType.id ? objectType.id : `${objectType.id}: ${objectType.name}`;
+}
+function firstSentence(text) {
+  const normalized = text?.replaceAll(/\s+/g, " ").trim();
+  if (!normalized)
+    return;
+  for (const match of normalized.matchAll(/[.!?](?=\s|$)/g)) {
+    const sentence = normalized.slice(0, match.index + 1);
+    if (!ABBREVIATION_END_RE.test(sentence))
+      return truncate(sentence);
+  }
+  return truncate(normalized);
+}
+function firstHeading(markdown) {
+  const heading = /^#{1,6}\s+(.+?)\s*#*\s*$/m.exec(markdown)?.[1];
+  return heading === undefined ? undefined : truncate(heading);
+}
+function truncate(text) {
+  return text.length <= MAX_SUMMARY_LENGTH ? text : `${text.slice(0, MAX_SUMMARY_LENGTH - 1)}\u2026`;
+}
+function table(headers, rows) {
+  return [
+    `| ${headers.join(" | ")} |`,
+    `| ${headers.map(() => "---").join(" | ")} |`,
+    ...rows.map((row) => `| ${row.map(cell).join(" | ")} |`)
+  ].join(`
+`);
+}
+function cell(text) {
+  return oneLine(text).replaceAll("|", "\\|");
+}
+function oneLine(text) {
+  return text.replaceAll(/\s+/g, " ").trim();
+}
+function code(text) {
+  return `\`${text}\``;
+}
+function byPath(left, right) {
+  return left.path < right.path ? -1 : left.path > right.path ? 1 : 0;
+}
 export {
   assertKnownProperties2 as assertKnownProperties,
   assertLinkTargetType2 as assertLinkTargetType,
@@ -47,6 +318,7 @@ export {
   assertRequiredProperties2 as assertRequiredProperties,
   assertTargetTypeCompatible2 as assertTargetTypeCompatible,
   assertTelemetryProperty2 as assertTelemetryProperty,
+  assertValidFileRefs2 as assertValidFileRefs,
   coerceSchemaValueToTyped2 as coerceSchemaValueToTyped,
   createLinkTokenMap2 as createLinkTokenMap,
   createPropertyTokenMap2 as createPropertyTokenMap,
@@ -54,6 +326,7 @@ export {
   normalizeLinkProperties2 as normalizeLinkProperties,
   normalizeObjectProperties2 as normalizeObjectProperties,
   normalizeSchemaValue2 as normalizeSchemaValue,
+  renderOntologyDocs,
   resolvePropertyQueryCapabilities2 as resolvePropertyQueryCapabilities,
   resolveSemanticType2 as resolveSemanticType,
   resolveValueTypeRef2 as resolveValueTypeRef,
@@ -71,4 +344,4 @@ export {
   validateTelemetryUnit2 as validateTelemetryUnit
 };
 
-//# debugId=58CEF65FD40BA06E64756E2164756E21
+//# debugId=EC882FAEE6773F5F64756E2164756E21

package/dist/ontology/internal.js.map

@@ -1,9 +1,10 @@
 {
   "version": 3,
-  "sources": [],
+  "sources": ["../src/ontology/docs-markdown.ts"],
   "sourcesContent": [
+    "/**\n * Markdown reference docs for the object types one reader can see, rendered from that reader's\n * authorized ontology view. Output is deterministic: the same view renders the same bytes.\n */\n\nimport type { ActionDescriptor, ActionParamDescriptor } from \"../actions/descriptor\"\nimport type { AgentProjectFile } from \"../agents/skills\"\nimport type { OntologyDoc, OntologyDocsCatalog } from \"./docs\"\nimport {\n  type PropertyQueryOperator,\n  resolvePropertyQueryCapabilities,\n  resolveQuerySchema,\n} from \"./query-capabilities\"\nimport type { ObjectLink, ObjectType, PrimitiveSchema, Property, Schema, ValueType } from \"./types\"\n\nexport interface RenderOntologyDocsInput {\n  readonly catalog: OntologyDocsCatalog\n  /** The object types the reader can see, as its authorized ontology view lists them. */\n  readonly objectTypes: readonly ObjectType[]\n  readonly valueTypesById: ReadonlyMap<string, ValueType>\n  /** The actions the reader can request on objects of this type. */\n  readonly actionsFor: (objectType: ObjectType) => readonly ActionDescriptor[]\n  /**\n   * Marked properties the reader is not cleared for. Like the ontology API, docs still list them,\n   * flagged, so the agent can say the information exists; their values cannot be read or queried.\n   */\n  readonly restrictedPropertyIds?: (objectTypeId: string) => ReadonlySet<string>\n}\n\nexport interface OntologyDocsIndexEntry {\n  /** POSIX path relative to the ontology directory; a scripts directory ends with `/`. */\n  readonly path: string\n  readonly summary: string\n}\n\nexport interface RenderedOntologyDocs {\n  /** Files to install, by POSIX path relative to the ontology directory. */\n  readonly files: readonly AgentProjectFile[]\n  /** One entry per doc and per scripts directory, sorted by path. */\n  readonly index: readonly OntologyDocsIndexEntry[]\n}\n\nconst MAX_SUMMARY_LENGTH = 120\nconst EXACT: readonly PropertyQueryOperator[] = [\"eq\", \"neq\", \"in\", \"exists\"]\nconst RANGE: readonly PropertyQueryOperator[] = [\"lt\", \"lte\", \"gt\", \"gte\"]\nconst ORDERED_SCHEMAS: ReadonlySet<PrimitiveSchema> = new Set([\n  \"integer\",\n  \"double\",\n  \"decimal\",\n  \"date\",\n  \"timestamp\",\n])\n/** A period that ends \"e.g.\" or \"i.e.\" does not end the sentence. */\nconst ABBREVIATION_END_RE = /\\b(?:e\\.g|i\\.e|etc|vs|cf)\\.$/i\n\n/** Render one doc per visible type, then the team's other docs and scripts. */\nexport function renderOntologyDocs(input: RenderOntologyDocsInput): RenderedOntologyDocs {\n  const objectTypes = input.objectTypes\n  const objectTypesById = new Map(objectTypes.map((objectType) => [objectType.id, objectType]))\n  const docs = [\n    ...objectTypes.map((objectType) => ({\n      path: input.catalog.docPathFor(objectType.id),\n      contents: renderObjectTypeDoc({\n        ...input,\n        objectType,\n        objectTypes,\n        objectTypesById,\n        restricted: input.restrictedPropertyIds?.(objectType.id) ?? new Set(),\n      }),\n      summary: typeSummary(objectType),\n    })),\n    ...input.catalog.listDocs().map((doc) => ({\n      path: doc.path,\n      contents: doc.contents,\n      summary: firstHeading(doc.contents) ?? \"\",\n    })),\n  ]\n  const scripts = input.catalog.listScripts()\n  const scriptDirectories = [...new Set(scripts.map((script) => scriptsDirectoryOf(script.path)))]\n\n  return Object.freeze({\n    files: Object.freeze(\n      [...docs.map(({ path, contents }) => ({ path, contents })), ...scripts].sort(byPath)\n    ),\n    index: Object.freeze(\n      [\n        ...docs.map(({ path, summary }) => ({ path, summary })),\n        ...scriptDirectories.map((path) => ({ path, summary: \"Scripts\" })),\n      ].sort(byPath)\n    ),\n  })\n}\n\nfunction renderObjectTypeDoc(\n  input: RenderOntologyDocsInput & {\n    readonly objectType: ObjectType\n    readonly objectTypes: readonly ObjectType[]\n    readonly objectTypesById: ReadonlyMap<string, ObjectType>\n    readonly restricted: ReadonlySet<string>\n  }\n): string {\n  const { objectType, restricted } = input\n  const sections = [\n    objectType.name === objectType.id\n      ? `# ${objectType.id}`\n      : `# ${objectType.id} — ${oneLine(objectType.name)}`,\n    objectType.description?.trim(),\n    objectType.extends === undefined ? undefined : `Extends \\`${objectType.extends}\\`.`,\n    renderProperties(objectType, input.valueTypesById, restricted),\n    renderVectorProfiles(objectType, restricted),\n    renderLinks(objectType, input.objectTypesById, input.catalog),\n    renderIncomingLinks(objectType, input.objectTypes, input.catalog),\n    renderActions(input.actionsFor(objectType), input.valueTypesById),\n    renderNotes(input.catalog.notesFor(objectType.id)),\n  ]\n  return `${sections.filter((section) => section !== undefined && section !== \"\").join(\"\\n\\n\")}\\n`\n}\n\nfunction renderProperties(\n  objectType: ObjectType,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  restricted: ReadonlySet<string>\n): string | undefined {\n  if (objectType.properties.length === 0) return undefined\n  const anyRestricted = objectType.properties.some((property) => restricted.has(property.id))\n  return [\n    \"## Properties\",\n    \"\",\n    ...(anyRestricted\n      ? [\"Restricted properties: this user is not cleared to read or query their values.\", \"\"]\n      : []),\n    table(\n      [\"Property\", \"Type\", \"Query\", \"Description\"],\n      objectType.properties.map((property) => [\n        code(property.id),\n        withFlags(schemaLabel(property.schema, valueTypesById), [\n          ...(property.primary ? [\"primary key\"] : []),\n          ...(property.required && !property.primary ? [\"required\"] : []),\n          ...(property.nullable ? [\"nullable\"] : []),\n          ...(property.mode === \"telemetry\" ? [\"telemetry\"] : []),\n          ...(restricted.has(property.id) ? [\"restricted\"] : []),\n        ]),\n        restricted.has(property.id) ? \"—\" : queryLabel(property, valueTypesById),\n        property.description ?? \"\",\n      ])\n    ),\n  ].join(\"\\n\")\n}\n\nfunction queryLabel(property: Property, valueTypesById: ReadonlyMap<string, ValueType>): string {\n  const capabilities = resolvePropertyQueryCapabilities(property, valueTypesById)\n  const schema = resolveQuerySchema(property.schema, valueTypesById)\n  const meaningful = schema === undefined ? new Set() : meaningfulOperators(schema)\n  const operators = capabilities.operators.filter((operator) => meaningful.has(operator))\n  const labels = [\n    ...(operators.length === 0 ? [] : [`filter: ${operators.join(\", \")}`]),\n    ...(capabilities.sortable ? [\"sort\"] : []),\n    ...(capabilities.text ? [\"text\"] : []),\n    ...(capabilities.facet ? [\"facet\"] : []),\n  ]\n  return labels.length === 0 ? \"—\" : labels.join(\"; \")\n}\n\n/**\n * The predicates worth suggesting for a schema: the engine also accepts ranges over strings and\n * enums, and substring matches, which rarely answer a question about this kind of value.\n */\nfunction meaningfulOperators(schema: Schema): ReadonlySet<PropertyQueryOperator> {\n  if (typeof schema === \"string\") {\n    return new Set(ORDERED_SCHEMAS.has(schema) ? [...EXACT, ...RANGE] : EXACT)\n  }\n  if (schema.type === \"enum\") return new Set(EXACT)\n  if (schema.type === \"array\" || schema.type === \"map\") return new Set([\"contains\"])\n  return new Set()\n}\n\nfunction renderVectorProfiles(\n  objectType: ObjectType,\n  restricted: ReadonlySet<string>\n): string | undefined {\n  // Searching a profile admits each of its sources like a filter would: one restricted source\n  // makes the search fail for this user, so the profile is left out.\n  const profiles = Object.entries(objectType.search?.vectors ?? {}).filter(([, profile]) =>\n    profile.source.every((propertyId) => !restricted.has(propertyId))\n  )\n  if (profiles.length === 0) return undefined\n  return [\n    \"## Vector search profiles\",\n    \"\",\n    table(\n      [\"Profile\", \"Sources\"],\n      profiles\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([name, profile]) => [code(name), profile.source.map(code).join(\", \")])\n    ),\n  ].join(\"\\n\")\n}\n\nfunction renderLinks(\n  objectType: ObjectType,\n  objectTypesById: ReadonlyMap<string, ObjectType>,\n  catalog: OntologyDocsCatalog\n): string | undefined {\n  if (objectType.links.length === 0) return undefined\n  return [\n    \"## Links\",\n    \"\",\n    table(\n      [\"Link\", \"Target\", \"Cardinality\", \"Description\", \"Target description\"],\n      objectType.links.map((link) => {\n        // A reader's view expands `*` into every type it can see; the doc keeps the declaration.\n        const targets = catalog.isWildcardLink(objectType.id, link.id) ? [\"*\"] : linkTargets(link)\n        return [\n          code(link.id),\n          targets.map(code).join(\", \"),\n          link.cardinality ?? \"many\",\n          link.description ?? \"\",\n          targets\n            .map((targetId) => firstSentence(objectTypesById.get(targetId)?.description))\n            .filter((description) => description !== undefined)\n            .join(\" \"),\n        ]\n      })\n    ),\n  ].join(\"\\n\")\n}\n\nfunction renderIncomingLinks(\n  objectType: ObjectType,\n  objectTypes: readonly ObjectType[],\n  catalog: OntologyDocsCatalog\n): string | undefined {\n  const incoming = objectTypes.flatMap((source) =>\n    source.links\n      .filter(\n        (link) =>\n          !catalog.isWildcardLink(source.id, link.id) && linkTargets(link).includes(objectType.id)\n      )\n      .map((link) => [\n        code(source.id),\n        code(link.id),\n        link.cardinality ?? \"many\",\n        link.description ?? \"\",\n      ])\n  )\n  if (incoming.length === 0) return undefined\n  return [\n    \"## Incoming links\",\n    \"\",\n    \"Declared on other types; traverse them with direction `incoming`.\",\n    \"\",\n    table([\"From\", \"Link\", \"Cardinality\", \"Description\"], incoming),\n  ].join(\"\\n\")\n}\n\nfunction renderActions(\n  actions: readonly ActionDescriptor[],\n  valueTypesById: ReadonlyMap<string, ValueType>\n): string | undefined {\n  if (actions.length === 0) return undefined\n  return [\n    \"## Actions\",\n    ...[...actions]\n      .sort((left, right) => left.id.localeCompare(right.id))\n      .map((action) => {\n        const params = Object.entries(action.params)\n        return [\n          `### ${code(action.id)}`,\n          ...(action.description?.trim() ? [action.description.trim()] : []),\n          params.length === 0\n            ? \"No parameters.\"\n            : table(\n                [\"Param\", \"Type\", \"Required\", \"Description\"],\n                params.map(([id, param]) => [\n                  code(id),\n                  paramTypeLabel(param, valueTypesById),\n                  param.required ? \"yes\" : \"no\",\n                  param.description ?? \"\",\n                ])\n              ),\n        ].join(\"\\n\\n\")\n      }),\n  ].join(\"\\n\\n\")\n}\n\nfunction renderNotes(notes: readonly OntologyDoc[]): string | undefined {\n  const contents = notes.map((note) => note.contents.trim()).filter(Boolean)\n  return contents.length === 0 ? undefined : `## Project notes\\n\\n${contents.join(\"\\n\\n\")}`\n}\n\nfunction paramTypeLabel(\n  param: ActionParamDescriptor,\n  valueTypesById: ReadonlyMap<string, ValueType>\n): string {\n  return withFlags(schemaLabel(param.schema, valueTypesById), param.nullable ? [\"nullable\"] : [])\n}\n\nfunction withFlags(label: string, flags: readonly string[]): string {\n  return flags.length === 0 ? label : `${label} (${flags.join(\", \")})`\n}\n\ntype DescribedSchema = ActionParamDescriptor[\"schema\"]\n\nfunction schemaLabel(\n  schema: DescribedSchema,\n  valueTypesById: ReadonlyMap<string, ValueType>,\n  seen: ReadonlySet<string> = new Set()\n): string {\n  if (typeof schema === \"string\") return schema\n  switch (schema.type) {\n    case \"enum\":\n      return `one of ${schema.values.map((value) => code(String(value))).join(\", \")}`\n    case \"array\":\n      return `array of ${schemaLabel(schema.items, valueTypesById, seen)}`\n    case \"map\":\n      return `map of string to ${schemaLabel(schema.valueSchema, valueTypesById, seen)}`\n    case \"object\":\n      return `object { ${Object.entries(schema.properties)\n        .map(\n          ([id, field]) =>\n            `${id}${field.required ? \"\" : \"?\"}: ${schemaLabel(field.schema, valueTypesById, seen)}`\n        )\n        .join(\", \")} }`\n    case \"objectRef\":\n      return `reference to ${code(schema.objectTypeId)}`\n    case \"valueTypeRef\": {\n      const resolved = valueTypesById.get(schema.valueTypeId)?.schema\n      if (resolved === undefined || seen.has(schema.valueTypeId)) return schema.valueTypeId\n      const nested = new Set(seen).add(schema.valueTypeId)\n      return `${schema.valueTypeId} (${schemaLabel(resolved, valueTypesById, nested)})`\n    }\n  }\n}\n\nfunction linkTargets(link: ObjectLink): readonly string[] {\n  // A link to any type (`*`) is not about this one; it has no incoming entry.\n  return (\n    Array.isArray(link.targetObjectTypeId) ? link.targetObjectTypeId : [link.targetObjectTypeId]\n  ).filter((targetId) => targetId !== \"*\")\n}\n\nfunction scriptsDirectoryOf(path: string): string {\n  const segments = path.split(\"/\")\n  return `${segments.slice(0, segments.indexOf(\"scripts\") + 1).join(\"/\")}/`\n}\n\nfunction typeSummary(objectType: ObjectType): string {\n  const description = firstSentence(objectType.description)\n  if (description !== undefined) return `${objectType.id}: ${description}`\n  return objectType.name === objectType.id ? objectType.id : `${objectType.id}: ${objectType.name}`\n}\n\nfunction firstSentence(text: string | undefined): string | undefined {\n  const normalized = text?.replaceAll(/\\s+/g, \" \").trim()\n  if (!normalized) return undefined\n  for (const match of normalized.matchAll(/[.!?](?=\\s|$)/g)) {\n    const sentence = normalized.slice(0, match.index + 1)\n    if (!ABBREVIATION_END_RE.test(sentence)) return truncate(sentence)\n  }\n  return truncate(normalized)\n}\n\nfunction firstHeading(markdown: string): string | undefined {\n  const heading = /^#{1,6}\\s+(.+?)\\s*#*\\s*$/m.exec(markdown)?.[1]\n  return heading === undefined ? undefined : truncate(heading)\n}\n\nfunction truncate(text: string): string {\n  return text.length <= MAX_SUMMARY_LENGTH ? text : `${text.slice(0, MAX_SUMMARY_LENGTH - 1)}…`\n}\n\nfunction table(headers: readonly string[], rows: readonly (readonly string[])[]): string {\n  return [\n    `| ${headers.join(\" | \")} |`,\n    `| ${headers.map(() => \"---\").join(\" | \")} |`,\n    ...rows.map((row) => `| ${row.map(cell).join(\" | \")} |`),\n  ].join(\"\\n\")\n}\n\nfunction cell(text: string): string {\n  return oneLine(text).replaceAll(\"|\", \"\\\\|\")\n}\n\nfunction oneLine(text: string): string {\n  return text.replaceAll(/\\s+/g, \" \").trim()\n}\n\nfunction code(text: string): string {\n  return `\\`${text}\\``\n}\n\nfunction byPath(left: { readonly path: string }, right: { readonly path: string }): number {\n  return left.path < right.path ? -1 : left.path > right.path ? 1 : 0\n}\n"
   ],
-  "mappings": "",
-  "debugId": "58CEF65FD40BA06E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "EC882FAEE6773F5F64756E2164756E21",
   "names": []
 }

package/dist/ontology/tokens.d.ts

@@ -1,4 +1,4 @@
-import type { InferObjectProperties } from "./inference";
+import type { InferObjectProperties, InferObjectReadProperties } from "./inference";
 import { type LinkPathSelectionBuilder } from "./link-path-selection";
 import type { ObjectLink, ObjectType, Property } from "./types";
 declare const propertyTokenBrand: unique symbol;
@@ -46,6 +46,7 @@ export type ObjectTypeWithPropertyTokens<TObjectType extends ObjectType = Object
 export type ObjectPropertiesMetadata<TObjectType extends ObjectType> = {
     readonly [objectPropertiesBrand]?: string extends TObjectType["id"] ? {
         readonly properties: Record<string, unknown>;
+        readonly readProperties: Record<string, unknown>;
     } : ObjectPropertiesCarrier<TObjectType>;
 };
 /**
@@ -60,6 +61,7 @@ export type ObjectPropertiesMetadata<TObjectType extends ObjectType> = {
  */
 interface ObjectPropertiesCarrier<in out TObjectType extends ObjectType> {
     readonly properties: InferObjectProperties<TObjectType>;
+    readonly readProperties: InferObjectReadProperties<TObjectType>;
 }
 /**
  * The property values of an object type, as its rows carry them.
@@ -68,6 +70,11 @@ interface ObjectPropertiesCarrier<in out TObjectType extends ObjectType> {
  * whose property ids are not statically known, it is `Record<string, unknown>`.
  */
 export type ObjectTypeProperties<TObjectType extends ObjectTypeWithPropertyTokens> = NonNullable<TObjectType[typeof objectPropertiesBrand]>["properties"];
+/**
+ * The property values of an object type as a read returns them: a marked property is optional,
+ * because a reader without clearance receives it redacted.
+ */
+export type ObjectTypeReadProperties<TObjectType extends ObjectTypeWithPropertyTokens> = NonNullable<TObjectType[typeof objectPropertiesBrand]>["readProperties"];
 /**
  * Object type with property tokens (`p.*`) and link tokens (`l.*`).
  *

package/dist/ontology/tokens.d.ts.map

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

package/dist/ontology/types.d.ts

@@ -266,6 +266,11 @@ export interface Property {
     semanticType?: QuantitativeTypeId;
     /** Query/indexing metadata for this property. */
     query?: PropertyQueryMetadata;
+    /**
+     * Marking ids. A principal receives this property only when its roles clear every marking;
+     * otherwise the value is omitted and listed in the object's `redactions`.
+     */
+    markings?: readonly string[];
 }
 /**
  * How a property's value behaves at runtime.