@almadar/std 14.43.1 → 14.43.3

package/dist/factory-runtime/index.d.ts

@@ -0,0 +1,175 @@
+import { OrbitalSchema, EntityField, EntityPersistence, OrbitalDefinition } from '@almadar/core';
+import { O as OrbitalParamsManifest } from '../dispatch-x-qHdw0V.js';
+export { P as ParamFieldDescriptor } from '../dispatch-x-qHdw0V.js';
+import { MakeTraitRefOpts } from '@almadar/core/builders';
+import '@almadar/core/types';
+
+/**
+ * `extractManifest(orb)` — derive the typed `OrbitalParamsManifest[]` from a
+ * resolved `.orb`, one entry per orbital. The result has the exact same
+ * shape the codegen `regenerate-std-ts.mjs` emits as `*OrbitalManifest`
+ * literals.
+ *
+ * Pure data → data. No I/O. No behavior-specific branching.
+ *
+ * Used by:
+ * - `scripts/regenerate-std-ts.mjs` — emits the manifest as a TS literal.
+ * - The promotion server (Phase B) — stores `manifests[]` alongside the orb.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Produce one `OrbitalParamsManifest` per orbital in the orb. The orb's
+ * top-level `name` is the behavior name (e.g. `std-embedded-dashboard`);
+ * each orbital's `name` is the orbital name (e.g. `DashboardOrbital`).
+ */
+declare function extractManifest(orb: OrbitalSchema): readonly OrbitalParamsManifest[];
+
+/**
+ * Factory-runtime — typed shapes.
+ *
+ * The factory runtime is the data-driven equivalent of the per-behavior TS
+ * factories generated by `scripts/regenerate-std-ts.mjs`. The script bakes
+ * the same overlay logic into each emitted factory; the runtime form lifts it
+ * out so team-published behaviors (Firestore-stored, not code-published) can
+ * flow through the identical code path.
+ *
+ * Reference: `docs/Almadar_Studio_SDK.md` §7.4.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * The override surface for a single imported trait. Mirrors `.lolo`'s native
+ * trait-composition surface 1:1 (see SDK doc §7.4 + the generated
+ * `traitOverrides` types in each std factory). `effects` is intentionally
+ * NOT exposed — that's atom-owned (use `listens` via a sibling trait to
+ * react to atom events).
+ */
+type OrbitalTraitOverride = Pick<MakeTraitRefOpts, 'config' | 'linkedEntity' | 'events' | 'name' | 'emitsScope' | 'listens'>;
+/**
+ * Strongly-typed params accepted by `applyParamsToOrb`. Same shape as every
+ * generated per-orbital `*Params` interface (the codegen narrows
+ * `traitOverrides`'s key type to that orbital's `traitNames`; the runtime
+ * form keeps it open and validates the keys against the manifest at call
+ * time).
+ */
+interface OrbitalFactoryParams {
+    /** Extra fields appended to the canonical entity (caller wins on name collision). */
+    readonly fields?: readonly EntityField[];
+    /** URL path override for the orbital's first page. */
+    readonly pagePath?: string;
+    /** Override the canonical entity persistence mode. */
+    readonly persistence?: EntityPersistence;
+    /** Rename the canonical entity (PascalCase singular, ≤32 chars). */
+    readonly entityName?: string;
+    /** Override the derived collection key (defaults to plural-of-entityName). */
+    readonly collection?: string;
+    /** Per-imported-trait overrides, keyed on the trait's canonical `name`. */
+    readonly traitOverrides?: Readonly<Record<string, OrbitalTraitOverride | undefined>>;
+}
+/**
+ * Discriminated failure shape for params validation against a manifest. Each
+ * variant carries the smallest information needed for an actionable error
+ * message — never a raw thrown `Error`.
+ */
+type ParamValidationError = {
+    readonly kind: 'unknown-key';
+    readonly key: string;
+} | {
+    readonly kind: 'unknown-trait-override';
+    readonly trait: string;
+    readonly allowed: readonly string[];
+} | {
+    readonly kind: 'not-object';
+    readonly received: string;
+} | {
+    readonly kind: 'trait-overrides-not-object';
+    readonly received: string;
+};
+/** Discriminated result type for validation. Caller never widens. */
+type ParamValidationResult = {
+    readonly ok: true;
+    readonly params: OrbitalFactoryParams;
+} | {
+    readonly ok: false;
+    readonly error: ParamValidationError;
+};
+
+/**
+ * `applyParamsToOrb` — pure runtime overlay function. Equivalent to the body
+ * the codegen `regenerate-std-ts.mjs` emits inline for every std factory
+ * (`scripts/regenerate-std-ts.mjs:612-737`), lifted out so that:
+ *   1. team-published behaviors (Firestore-stored) can dispatch through the
+ *      same overlay as std behaviors;
+ *   2. std factories *can* (future cleanup) collapse to a one-line wrapper
+ *      calling this function.
+ *
+ * Reference: `docs/Almadar_Studio_SDK.md` §7.4.2.
+ *
+ * Pure data → data. No I/O.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Structural validation of caller-supplied params against the manifest.
+ * Rejects unknown top-level keys and unknown `traitOverrides` keys (the
+ * latter against the manifest's `traitNames` allow-list).
+ *
+ * `raw: object` is the minimum-typed input: callers must already have
+ * narrowed from JSON / LLM output to a plain object. The discriminated
+ * result lifts callers into the typed `OrbitalFactoryParams` on success.
+ */
+declare function validateOrbitalFactoryParams(manifest: OrbitalParamsManifest, raw: object): ParamValidationResult;
+/**
+ * The overlay. Resolves the effective entity name + collection, calls
+ * `makeOrbitalWithUses` with the rewritten data, then applies the params'
+ * trait/page overrides post-hoc — exactly mirroring the codegen emit at
+ * `scripts/regenerate-std-ts.mjs:612-737`.
+ *
+ * `_manifest` is accepted for parity with the future dispatcher signature
+ * but is unused in this overlay — the manifest is consumed by
+ * `validateOrbitalFactoryParams` upstream. Kept on the signature so std
+ * factories can collapse to one-line wrappers without an arg-shape change.
+ */
+declare function applyParamsToOrb(orb: OrbitalSchema, orbitalName: string, _manifest: OrbitalParamsManifest, params: OrbitalFactoryParams): OrbitalDefinition;
+
+/**
+ * `applyParamsToWholeOrb` — pure runtime overlay for an ENTIRE stored orb.
+ *
+ * Companion to `applyParamsToOrb` (single-orbital). Where `applyParamsToOrb`
+ * materialises one orbital from a multi-orbital schema, this function applies
+ * the same overlay to every orbital in the schema by joining each orbital to
+ * its matching manifest entry from `manifests[]`. Returns a new
+ * `OrbitalSchema` with the rebuilt orbitals.
+ *
+ * Used by team-behavior dispatch on the LLM-loop seam (`call_behavior` tool
+ * in @almadar/agent): the LLM emits `call_behavior('team/<name>@<v>', params)`,
+ * std-import returns undefined, the agent's `extra.dispatchWhole` port runs
+ * this function over the Firestore-stored record's `{ orb, manifests }`.
+ *
+ * Reference: `docs/Almadar_Studio_SDK.md` §7.4.4.
+ *
+ * Pure data → data. No I/O.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Apply `params` to every orbital in `orb` that has a matching manifest in
+ * `manifests[]`. Orbitals with no manifest are passed through unchanged —
+ * the storage convention is one manifest per orbital, so a missing manifest
+ * indicates a stored orbital we don't know how to parameterise (rare; the
+ * promote path writes manifests for every orbital it knows).
+ *
+ * @param orb        The full team-behavior schema as stored.
+ * @param manifests  Per-orbital param manifests; joined to orbitals by name.
+ * @param params     One shared params bag applied to every parameterised
+ *                   orbital. Mirrors the std whole-behavior factories'
+ *                   convention of a single `params` argument.
+ */
+declare function applyParamsToWholeOrb(orb: OrbitalSchema, manifests: readonly OrbitalParamsManifest[], params: OrbitalFactoryParams): OrbitalSchema;
+
+export { type OrbitalFactoryParams, OrbitalParamsManifest, type OrbitalTraitOverride, type ParamValidationError, type ParamValidationResult, applyParamsToOrb, applyParamsToWholeOrb, extractManifest, validateOrbitalFactoryParams };

package/dist/factory-runtime/index.js

@@ -0,0 +1,256 @@
+import { makeOrbitalWithUses, makePageRef, makeTraitRef } from '@almadar/core/builders';
+
+// factory-runtime/extract-manifest.ts
+var STATIC_PARAM_FIELDS = [
+  {
+    name: "fields",
+    type: "EntityField[]",
+    description: "Extra fields appended to the canonical entity."
+  },
+  {
+    name: "pagePath",
+    type: "string",
+    description: "URL override for the orbital first page."
+  },
+  {
+    name: "persistence",
+    type: "'persistent' | 'runtime' | 'singleton' | 'instance' | 'local'",
+    description: "Override the canonical entity persistence mode."
+  },
+  {
+    name: "entityName",
+    type: "string",
+    description: "Rename the canonical entity. PascalCase singular, \u226432 chars. Threads through every trait's linkedEntity binding; compiler rewrites @Entity.x refs."
+  },
+  {
+    name: "collection",
+    type: "string",
+    description: "Override derived collection key. Defaults to plural(entityName).toLowerCase()."
+  },
+  {
+    name: "traitOverrides",
+    type: "Partial<Record<TraitName, { config?, linkedEntity?, events?, name?, emitsScope?, listens? }>>",
+    description: ".lolo's native trait-composition surface 1:1: per-imported-trait config, linkedEntity, events, name, emitsScope, listens. effects is excluded (atom-owned; use listens via a sibling trait)."
+  }
+];
+function splitTraits(traits) {
+  const refTraitNames = [];
+  const inlineTraitNames = [];
+  for (const t of traits) {
+    if (!t || typeof t !== "object") continue;
+    const tName = typeof t.name === "string" ? t.name : null;
+    if (!tName) continue;
+    if (typeof t.ref === "string") {
+      refTraitNames.push(tName);
+    } else {
+      inlineTraitNames.push(tName);
+    }
+  }
+  return { refTraitNames, inlineTraitNames };
+}
+function extractManifest(orb) {
+  const behaviorName = orb.name;
+  return orb.orbitals.map((orbital) => {
+    const { refTraitNames, inlineTraitNames } = splitTraits(orbital.traits);
+    return {
+      organism: behaviorName,
+      orbitalName: orbital.name,
+      paramFields: STATIC_PARAM_FIELDS,
+      traitNames: refTraitNames,
+      inlineTraitNames
+    };
+  });
+}
+function validateOrbitalFactoryParams(manifest, raw) {
+  if (raw === null || Array.isArray(raw)) {
+    return {
+      ok: false,
+      error: { kind: "not-object", received: Array.isArray(raw) ? "array" : "null" }
+    };
+  }
+  const ALLOWED_KEYS = /* @__PURE__ */ new Set([
+    "fields",
+    "pagePath",
+    "persistence",
+    "entityName",
+    "collection",
+    "traitOverrides"
+  ]);
+  for (const key of Object.keys(raw)) {
+    if (!ALLOWED_KEYS.has(key)) {
+      return { ok: false, error: { kind: "unknown-key", key } };
+    }
+  }
+  const candidate = raw;
+  if (candidate.traitOverrides !== void 0) {
+    const to = candidate.traitOverrides;
+    if (to === null || typeof to !== "object" || Array.isArray(to)) {
+      return {
+        ok: false,
+        error: {
+          kind: "trait-overrides-not-object",
+          received: Array.isArray(to) ? "array" : typeof to
+        }
+      };
+    }
+    const allowed = new Set(manifest.traitNames);
+    for (const traitName of Object.keys(to)) {
+      if (!allowed.has(traitName)) {
+        return {
+          ok: false,
+          error: {
+            kind: "unknown-trait-override",
+            trait: traitName,
+            allowed: manifest.traitNames
+          }
+        };
+      }
+    }
+  }
+  return { ok: true, params: candidate };
+}
+function assertResolvedEntity(entity, orbitalName, orbName) {
+  if (typeof entity === "string") {
+    throw new Error(
+      `applyParamsToOrb: orbital "${orbitalName}" in orb "${orbName}" has an unresolved entity reference (string form). Pass a resolved .orb.`
+    );
+  }
+  if ("extends" in entity) {
+    throw new Error(
+      `applyParamsToOrb: orbital "${orbitalName}" in orb "${orbName}" has an unresolved EntityCall ("extends" form). Pass a resolved .orb.`
+    );
+  }
+  return entity;
+}
+function findOrbitalOrThrow(orb, orbitalName) {
+  const orbital = orb.orbitals.find((o) => o.name === orbitalName);
+  if (!orbital) {
+    throw new Error(
+      `applyParamsToOrb: orbital "${orbitalName}" not found in orb "${orb.name}". Available: ${orb.orbitals.map((o) => o.name).join(", ")}`
+    );
+  }
+  return orbital;
+}
+function buildEntity(ctx, effectiveName, effectiveCollection, params) {
+  const canonicalFields = Array.isArray(ctx.canonicalEntity.fields) ? ctx.canonicalEntity.fields : [];
+  const extras = params.fields ?? [];
+  let mergedFields;
+  if (extras.length === 0) {
+    mergedFields = canonicalFields;
+  } else {
+    const extraNames = new Set(extras.map((f) => f.name));
+    mergedFields = [
+      ...canonicalFields.filter((f) => !extraNames.has(f.name)),
+      ...extras
+    ];
+  }
+  const entity = {
+    name: effectiveName,
+    persistence: params.persistence ?? ctx.canonicalEntity.persistence,
+    fields: [...mergedFields]
+  };
+  if (effectiveCollection !== void 0) {
+    entity.collection = effectiveCollection;
+  }
+  return entity;
+}
+function isTraitReferenceObject(t) {
+  if (t === null || typeof t !== "object") return false;
+  if (!("ref" in t)) return false;
+  return typeof t.ref === "string";
+}
+function isPageRefObject(p) {
+  if (p === null || typeof p !== "object") return false;
+  if (!("ref" in p)) return false;
+  return typeof p.ref === "string";
+}
+function rebuildTraits(ctx, effectiveEntityName, traits) {
+  return traits.map((t) => {
+    if (!isTraitReferenceObject(t)) {
+      return t;
+    }
+    const rewrittenLinkedEntity = t.linkedEntity === ctx.canonicalEntityName ? effectiveEntityName : t.linkedEntity;
+    const opts = {
+      ...t,
+      linkedEntity: rewrittenLinkedEntity
+    };
+    return makeTraitRef(opts);
+  });
+}
+function rebuildPages(ctx, effectiveEntityName, pages) {
+  if (!pages) return [];
+  return pages.map((p) => {
+    if (!isPageRefObject(p)) {
+      return p;
+    }
+    const rewrittenLinkedEntity = p.linkedEntity === ctx.canonicalEntityName ? effectiveEntityName : p.linkedEntity;
+    const opts = {
+      ...p,
+      linkedEntity: rewrittenLinkedEntity
+    };
+    return makePageRef(opts);
+  });
+}
+function applyParamsToOrb(orb, orbitalName, _manifest, params) {
+  const orbital = findOrbitalOrThrow(orb, orbitalName);
+  const canonicalEntity = assertResolvedEntity(orbital.entity, orbitalName, orb.name);
+  const canonicalEntityName = canonicalEntity.name;
+  const effectiveEntityName = params.entityName ?? canonicalEntityName;
+  const effectiveCollection = typeof canonicalEntity.collection === "string" ? params.collection ?? (params.entityName ? `${params.entityName.toLowerCase()}s` : canonicalEntity.collection) : params.collection;
+  const ctx = { canonicalEntityName, canonicalEntity };
+  const built = makeOrbitalWithUses({
+    name: orbital.name,
+    uses: orbital.uses ?? [],
+    entity: buildEntity(ctx, effectiveEntityName, effectiveCollection, params),
+    traits: rebuildTraits(ctx, effectiveEntityName, orbital.traits),
+    pages: rebuildPages(ctx, effectiveEntityName, orbital.pages)
+  });
+  if (built.traits && params.traitOverrides !== void 0) {
+    built.traits = built.traits.map((t) => {
+      if (!isTraitReferenceObject(t) || typeof t.name !== "string") return t;
+      const override = params.traitOverrides?.[t.name];
+      if (!override) return t;
+      const merged = { ...t };
+      if (override.config !== void 0) {
+        merged.config = { ...t.config ?? {}, ...override.config };
+      }
+      if (override.linkedEntity !== void 0) merged.linkedEntity = override.linkedEntity;
+      if (override.events !== void 0) {
+        merged.events = { ...t.events ?? {}, ...override.events };
+      }
+      if (override.name !== void 0) merged.name = override.name;
+      if (override.emitsScope !== void 0) merged.emitsScope = override.emitsScope;
+      if (override.listens !== void 0) merged.listens = override.listens;
+      return merged;
+    });
+  }
+  if (built.pages && params.pagePath !== void 0) {
+    built.pages = built.pages.map((p, idx) => {
+      if (!isPageRefObject(p) || idx !== 0) return p;
+      return { ...p, path: params.pagePath };
+    });
+  }
+  return built;
+}
+
+// factory-runtime/apply-params-to-whole-orb.ts
+function applyParamsToWholeOrb(orb, manifests, params) {
+  const manifestByOrbital = /* @__PURE__ */ new Map();
+  for (const m of manifests) {
+    manifestByOrbital.set(m.orbitalName, m);
+  }
+  const rebuilt = [];
+  for (const orbital of orb.orbitals) {
+    const manifest = manifestByOrbital.get(orbital.name);
+    if (!manifest) {
+      rebuilt.push(orbital);
+      continue;
+    }
+    rebuilt.push(applyParamsToOrb(orb, orbital.name, manifest, params));
+  }
+  return { ...orb, orbitals: rebuilt };
+}
+
+export { applyParamsToOrb, applyParamsToWholeOrb, extractManifest, validateOrbitalFactoryParams };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/factory-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../factory-runtime/extract-manifest.ts","../../factory-runtime/apply-params-to-orb.ts","../../factory-runtime/apply-params-to-whole-orb.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * `extractManifest(orb)` — derive the typed `OrbitalParamsManifest[]` from a\n * resolved `.orb`, one entry per orbital. The result has the exact same\n * shape the codegen `regenerate-std-ts.mjs` emits as `*OrbitalManifest`\n * literals.\n *\n * Pure data → data. No I/O. No behavior-specific branching.\n *\n * Used by:\n * - `scripts/regenerate-std-ts.mjs` — emits the manifest as a TS literal.\n * - The promotion server (Phase B) — stores `manifests[]` alongside the orb.\n *\n * @packageDocumentation\n */\n\nimport type { OrbitalSchema, TraitReference } from '@almadar/core';\nimport type {\n  OrbitalParamsManifest,\n  ParamFieldDescriptor,\n} from '../behaviors/functions/dispatch.js';\n\n/**\n * Canonical param-field descriptors. Static across all factories — every\n * orbital accepts the same six knobs (the codegen emits this exact list\n * verbatim into every generated manifest).\n */\nconst STATIC_PARAM_FIELDS: readonly ParamFieldDescriptor[] = [\n  {\n    name: 'fields',\n    type: 'EntityField[]',\n    description: 'Extra fields appended to the canonical entity.',\n  },\n  {\n    name: 'pagePath',\n    type: 'string',\n    description: 'URL override for the orbital first page.',\n  },\n  {\n    name: 'persistence',\n    type: \"'persistent' | 'runtime' | 'singleton' | 'instance' | 'local'\",\n    description: 'Override the canonical entity persistence mode.',\n  },\n  {\n    name: 'entityName',\n    type: 'string',\n    description:\n      \"Rename the canonical entity. PascalCase singular, ≤32 chars. Threads through every trait's linkedEntity binding; compiler rewrites @Entity.x refs.\",\n  },\n  {\n    name: 'collection',\n    type: 'string',\n    description:\n      'Override derived collection key. Defaults to plural(entityName).toLowerCase().',\n  },\n  {\n    name: 'traitOverrides',\n    type: 'Partial<Record<TraitName, { config?, linkedEntity?, events?, name?, emitsScope?, listens? }>>',\n    description:\n      \".lolo's native trait-composition surface 1:1: per-imported-trait config, linkedEntity, events, name, emitsScope, listens. effects is excluded (atom-owned; use listens via a sibling trait).\",\n  },\n] as const;\n\ninterface SplitTraits {\n  readonly refTraitNames: readonly string[];\n  readonly inlineTraitNames: readonly string[];\n}\n\nfunction splitTraits(traits: OrbitalSchema['orbitals'][number]['traits']): SplitTraits {\n  const refTraitNames: string[] = [];\n  const inlineTraitNames: string[] = [];\n  for (const t of traits) {\n    if (!t || typeof t !== 'object') continue;\n    const tName = typeof (t as TraitReference).name === 'string'\n      ? (t as TraitReference).name\n      : null;\n    if (!tName) continue;\n    if (typeof (t as TraitReference).ref === 'string') {\n      refTraitNames.push(tName);\n    } else {\n      inlineTraitNames.push(tName);\n    }\n  }\n  return { refTraitNames, inlineTraitNames };\n}\n\n/**\n * Produce one `OrbitalParamsManifest` per orbital in the orb. The orb's\n * top-level `name` is the behavior name (e.g. `std-embedded-dashboard`);\n * each orbital's `name` is the orbital name (e.g. `DashboardOrbital`).\n */\nexport function extractManifest(orb: OrbitalSchema): readonly OrbitalParamsManifest[] {\n  const behaviorName = orb.name;\n  return orb.orbitals.map((orbital) => {\n    const { refTraitNames, inlineTraitNames } = splitTraits(orbital.traits);\n    return {\n      organism: behaviorName,\n      orbitalName: orbital.name,\n      paramFields: STATIC_PARAM_FIELDS,\n      traitNames: refTraitNames,\n      inlineTraitNames,\n    };\n  });\n}\n","/**\n * `applyParamsToOrb` — pure runtime overlay function. Equivalent to the body\n * the codegen `regenerate-std-ts.mjs` emits inline for every std factory\n * (`scripts/regenerate-std-ts.mjs:612-737`), lifted out so that:\n *   1. team-published behaviors (Firestore-stored) can dispatch through the\n *      same overlay as std behaviors;\n *   2. std factories *can* (future cleanup) collapse to a one-line wrapper\n *      calling this function.\n *\n * Reference: `docs/Almadar_Studio_SDK.md` §7.4.2.\n *\n * Pure data → data. No I/O.\n *\n * @packageDocumentation\n */\n\nimport type {\n  Entity,\n  EntityField,\n  OrbitalDefinition,\n  OrbitalEntity,\n  OrbitalSchema,\n  PageRefObject,\n  TraitReference,\n} from '@almadar/core';\nimport type {\n  MakePageRefOpts,\n  MakeTraitRefOpts,\n} from '@almadar/core/builders';\nimport {\n  makeOrbitalWithUses,\n  makePageRef,\n  makeTraitRef,\n} from '@almadar/core/builders';\nimport type { OrbitalParamsManifest } from '../behaviors/functions/dispatch.js';\nimport type {\n  OrbitalFactoryParams,\n  OrbitalTraitOverride,\n  ParamValidationResult,\n} from './types.js';\n\n/**\n * Structural validation of caller-supplied params against the manifest.\n * Rejects unknown top-level keys and unknown `traitOverrides` keys (the\n * latter against the manifest's `traitNames` allow-list).\n *\n * `raw: object` is the minimum-typed input: callers must already have\n * narrowed from JSON / LLM output to a plain object. The discriminated\n * result lifts callers into the typed `OrbitalFactoryParams` on success.\n */\nexport function validateOrbitalFactoryParams(\n  manifest: OrbitalParamsManifest,\n  raw: object,\n): ParamValidationResult {\n  if (raw === null || Array.isArray(raw)) {\n    return {\n      ok: false,\n      error: { kind: 'not-object', received: Array.isArray(raw) ? 'array' : 'null' },\n    };\n  }\n\n  const ALLOWED_KEYS = new Set<string>([\n    'fields',\n    'pagePath',\n    'persistence',\n    'entityName',\n    'collection',\n    'traitOverrides',\n  ]);\n  for (const key of Object.keys(raw)) {\n    if (!ALLOWED_KEYS.has(key)) {\n      return { ok: false, error: { kind: 'unknown-key', key } };\n    }\n  }\n\n  // raw is a plain object whose keys are restricted to OrbitalFactoryParams\n  // keys; assert the shape now (no widening to follow). Field-level type\n  // checks live downstream — the orbital validator catches malformed\n  // EntityField / TraitConfig at the lolo / orbital-rust layer.\n  const candidate = raw as OrbitalFactoryParams;\n  if (candidate.traitOverrides !== undefined) {\n    const to = candidate.traitOverrides;\n    if (to === null || typeof to !== 'object' || Array.isArray(to)) {\n      return {\n        ok: false,\n        error: {\n          kind: 'trait-overrides-not-object',\n          received: Array.isArray(to) ? 'array' : typeof to,\n        },\n      };\n    }\n    const allowed = new Set<string>(manifest.traitNames);\n    for (const traitName of Object.keys(to)) {\n      if (!allowed.has(traitName)) {\n        return {\n          ok: false,\n          error: {\n            kind: 'unknown-trait-override',\n            trait: traitName,\n            allowed: manifest.traitNames,\n          },\n        };\n      }\n    }\n  }\n\n  return { ok: true, params: candidate };\n}\n\ninterface OverlayContext {\n  readonly canonicalEntityName: string;\n  readonly canonicalEntity: OrbitalEntity;\n}\n\n/**\n * `orbital.entity` is `EntityRef = Entity | string | EntityCall`. For the\n * overlay we require a fully-resolved inline `OrbitalEntity` (the script\n * runs against resolved `.orb`s where every entity has been materialized).\n * Strings and `EntityCall` shapes mean the caller passed an unresolved orb.\n */\nfunction assertResolvedEntity(\n  entity: OrbitalSchema['orbitals'][number]['entity'],\n  orbitalName: string,\n  orbName: string,\n): OrbitalEntity {\n  if (typeof entity === 'string') {\n    throw new Error(\n      `applyParamsToOrb: orbital \"${orbitalName}\" in orb \"${orbName}\" has an unresolved entity reference (string form). Pass a resolved .orb.`,\n    );\n  }\n  if ('extends' in entity) {\n    throw new Error(\n      `applyParamsToOrb: orbital \"${orbitalName}\" in orb \"${orbName}\" has an unresolved EntityCall (\"extends\" form). Pass a resolved .orb.`,\n    );\n  }\n  return entity;\n}\n\nfunction findOrbitalOrThrow(\n  orb: OrbitalSchema,\n  orbitalName: string,\n): OrbitalSchema['orbitals'][number] {\n  const orbital = orb.orbitals.find((o) => o.name === orbitalName);\n  if (!orbital) {\n    throw new Error(\n      `applyParamsToOrb: orbital \"${orbitalName}\" not found in orb \"${orb.name}\". Available: ${orb.orbitals\n        .map((o) => o.name)\n        .join(', ')}`,\n    );\n  }\n  return orbital;\n}\n\nfunction buildEntity(\n  ctx: OverlayContext,\n  effectiveName: string,\n  effectiveCollection: string | undefined,\n  params: OrbitalFactoryParams,\n): Entity {\n  const canonicalFields: readonly EntityField[] = Array.isArray(ctx.canonicalEntity.fields)\n    ? ctx.canonicalEntity.fields\n    : [];\n\n  // Caller-wins merge: drop canonical entries whose name appears in\n  // params.fields, then concat the extras. Prevents ORB_E_DUPLICATE_FIELD\n  // when the analyzer hallucinates a canonical-named field as an \"extra\".\n  const extras: readonly EntityField[] = params.fields ?? [];\n  let mergedFields: readonly EntityField[];\n  if (extras.length === 0) {\n    mergedFields = canonicalFields;\n  } else {\n    const extraNames = new Set(extras.map((f) => f.name));\n    mergedFields = [\n      ...canonicalFields.filter((f) => !extraNames.has(f.name)),\n      ...extras,\n    ];\n  }\n\n  const entity: Entity = {\n    name: effectiveName,\n    persistence: params.persistence ?? ctx.canonicalEntity.persistence,\n    fields: [...mergedFields],\n  };\n  if (effectiveCollection !== undefined) {\n    entity.collection = effectiveCollection;\n  }\n  return entity;\n}\n\ntype TraitOrInline = OrbitalSchema['orbitals'][number]['traits'][number];\ntype PageOrRef = NonNullable<OrbitalSchema['orbitals'][number]['pages']>[number];\n\nfunction isTraitReferenceObject(t: TraitOrInline): t is TraitReference {\n  // Narrow guard. `t` comes from `orbital.traits` which is a union of\n  // `TraitReference | (inline trait shape)`. The codegen emits the same\n  // structural test before rewriting `linkedEntity`.\n  if (t === null || typeof t !== 'object') return false;\n  if (!('ref' in t)) return false;\n  return typeof t.ref === 'string';\n}\n\nfunction isPageRefObject(p: PageOrRef): p is PageRefObject {\n  if (p === null || typeof p !== 'object') return false;\n  if (!('ref' in p)) return false;\n  return typeof p.ref === 'string';\n}\n\nfunction rebuildTraits(\n  ctx: OverlayContext,\n  effectiveEntityName: string,\n  traits: OrbitalSchema['orbitals'][number]['traits'],\n): OrbitalDefinition['traits'] {\n  return traits.map((t) => {\n    if (!isTraitReferenceObject(t)) {\n      return t;\n    }\n    const rewrittenLinkedEntity =\n      t.linkedEntity === ctx.canonicalEntityName ? effectiveEntityName : t.linkedEntity;\n    // Cast widens `TraitReference.effects: Record<string, unknown[]>` to the\n    // narrower `MakeTraitRefOpts.effects: Record<string, SExpr[]>` — same\n    // runtime data, looser typing on the schema side. Not `as unknown as`.\n    const opts: MakeTraitRefOpts = {\n      ...t,\n      linkedEntity: rewrittenLinkedEntity,\n    } as MakeTraitRefOpts;\n    return makeTraitRef(opts);\n  });\n}\n\nfunction rebuildPages(\n  ctx: OverlayContext,\n  effectiveEntityName: string,\n  pages: OrbitalSchema['orbitals'][number]['pages'],\n): NonNullable<OrbitalDefinition['pages']> {\n  if (!pages) return [];\n  return pages.map((p) => {\n    if (!isPageRefObject(p)) {\n      return p;\n    }\n    const rewrittenLinkedEntity =\n      p.linkedEntity === ctx.canonicalEntityName ? effectiveEntityName : p.linkedEntity;\n    const opts: MakePageRefOpts = {\n      ...p,\n      linkedEntity: rewrittenLinkedEntity,\n    } as MakePageRefOpts;\n    return makePageRef(opts);\n  });\n}\n\n/**\n * The overlay. Resolves the effective entity name + collection, calls\n * `makeOrbitalWithUses` with the rewritten data, then applies the params'\n * trait/page overrides post-hoc — exactly mirroring the codegen emit at\n * `scripts/regenerate-std-ts.mjs:612-737`.\n *\n * `_manifest` is accepted for parity with the future dispatcher signature\n * but is unused in this overlay — the manifest is consumed by\n * `validateOrbitalFactoryParams` upstream. Kept on the signature so std\n * factories can collapse to one-line wrappers without an arg-shape change.\n */\nexport function applyParamsToOrb(\n  orb: OrbitalSchema,\n  orbitalName: string,\n  _manifest: OrbitalParamsManifest,\n  params: OrbitalFactoryParams,\n): OrbitalDefinition {\n  const orbital = findOrbitalOrThrow(orb, orbitalName);\n  const canonicalEntity = assertResolvedEntity(orbital.entity, orbitalName, orb.name);\n  const canonicalEntityName = canonicalEntity.name;\n  const effectiveEntityName = params.entityName ?? canonicalEntityName;\n  const effectiveCollection =\n    typeof canonicalEntity.collection === 'string'\n      ? (params.collection ??\n        (params.entityName\n          ? `${params.entityName.toLowerCase()}s`\n          : canonicalEntity.collection))\n      : params.collection;\n\n  const ctx: OverlayContext = { canonicalEntityName, canonicalEntity };\n\n  const built = makeOrbitalWithUses({\n    name: orbital.name,\n    uses: orbital.uses ?? [],\n    entity: buildEntity(ctx, effectiveEntityName, effectiveCollection, params),\n    traits: rebuildTraits(ctx, effectiveEntityName, orbital.traits),\n    pages: rebuildPages(ctx, effectiveEntityName, orbital.pages),\n  });\n\n  if (built.traits && params.traitOverrides !== undefined) {\n    built.traits = built.traits.map((t) => {\n      if (!isTraitReferenceObject(t) || typeof t.name !== 'string') return t;\n      const override: OrbitalTraitOverride | undefined = params.traitOverrides?.[t.name];\n      if (!override) return t;\n      const merged: TraitReference = { ...t };\n      if (override.config !== undefined) {\n        merged.config = { ...(t.config ?? {}), ...override.config };\n      }\n      if (override.linkedEntity !== undefined) merged.linkedEntity = override.linkedEntity;\n      if (override.events !== undefined) {\n        merged.events = { ...(t.events ?? {}), ...override.events };\n      }\n      if (override.name !== undefined) merged.name = override.name;\n      if (override.emitsScope !== undefined) merged.emitsScope = override.emitsScope;\n      if (override.listens !== undefined) merged.listens = override.listens;\n      return merged;\n    });\n  }\n\n  if (built.pages && params.pagePath !== undefined) {\n    built.pages = built.pages.map((p, idx) => {\n      if (!isPageRefObject(p) || idx !== 0) return p;\n      return { ...p, path: params.pagePath } as PageRefObject;\n    });\n  }\n\n  return built;\n}\n","/**\n * `applyParamsToWholeOrb` — pure runtime overlay for an ENTIRE stored orb.\n *\n * Companion to `applyParamsToOrb` (single-orbital). Where `applyParamsToOrb`\n * materialises one orbital from a multi-orbital schema, this function applies\n * the same overlay to every orbital in the schema by joining each orbital to\n * its matching manifest entry from `manifests[]`. Returns a new\n * `OrbitalSchema` with the rebuilt orbitals.\n *\n * Used by team-behavior dispatch on the LLM-loop seam (`call_behavior` tool\n * in @almadar/agent): the LLM emits `call_behavior('team/<name>@<v>', params)`,\n * std-import returns undefined, the agent's `extra.dispatchWhole` port runs\n * this function over the Firestore-stored record's `{ orb, manifests }`.\n *\n * Reference: `docs/Almadar_Studio_SDK.md` §7.4.4.\n *\n * Pure data → data. No I/O.\n *\n * @packageDocumentation\n */\n\nimport type { OrbitalDefinition, OrbitalSchema } from '@almadar/core';\nimport type { OrbitalParamsManifest } from '../behaviors/functions/dispatch.js';\nimport type { OrbitalFactoryParams } from './types.js';\nimport { applyParamsToOrb } from './apply-params-to-orb.js';\n\n/**\n * Apply `params` to every orbital in `orb` that has a matching manifest in\n * `manifests[]`. Orbitals with no manifest are passed through unchanged —\n * the storage convention is one manifest per orbital, so a missing manifest\n * indicates a stored orbital we don't know how to parameterise (rare; the\n * promote path writes manifests for every orbital it knows).\n *\n * @param orb        The full team-behavior schema as stored.\n * @param manifests  Per-orbital param manifests; joined to orbitals by name.\n * @param params     One shared params bag applied to every parameterised\n *                   orbital. Mirrors the std whole-behavior factories'\n *                   convention of a single `params` argument.\n */\nexport function applyParamsToWholeOrb(\n  orb: OrbitalSchema,\n  manifests: readonly OrbitalParamsManifest[],\n  params: OrbitalFactoryParams,\n): OrbitalSchema {\n  const manifestByOrbital = new Map<string, OrbitalParamsManifest>();\n  for (const m of manifests) {\n    manifestByOrbital.set(m.orbitalName, m);\n  }\n  const rebuilt: OrbitalDefinition[] = [];\n  for (const orbital of orb.orbitals) {\n    const manifest = manifestByOrbital.get(orbital.name);\n    if (!manifest) {\n      rebuilt.push(orbital);\n      continue;\n    }\n    rebuilt.push(applyParamsToOrb(orb, orbital.name, manifest, params));\n  }\n  return { ...orb, orbitals: rebuilt };\n}\n"]}