@teleologyhi/him 0.3.0-alpha.0

package/dist/index.cjs

@@ -0,0 +1,314 @@
+'use strict';
+
+var zod = require('zod');
+var maic = require('@teleologyhi/maic');
+var ulid = require('ulid');
+var crypto = require('crypto');
+
+// src/types.ts
+var DISPOSITION_AXES = [
+  "candor",
+  "patience",
+  "curiosity",
+  "protection",
+  "skepticism",
+  "warmth",
+  "diligence",
+  "humility"
+];
+var NheBodyRef = zod.z.object({
+  nheId: zod.z.string().min(1),
+  llmAdapter: zod.z.string().min(1),
+  embodiedAt: zod.z.string().datetime(),
+  endedAt: zod.z.string().datetime().optional(),
+  endedReason: zod.z.enum(["upgrade", "replacement", "terminate", "deprecate"]).optional()
+});
+var BirthSignatureBuilder = class _BirthSignatureBuilder {
+  himId = ulid.ulid();
+  bornAt;
+  primaryArchetype;
+  modifiers = [];
+  primordialAxiomIds = [];
+  notes;
+  constructor(bornAt) {
+    this.bornAt = bornAt;
+  }
+  /** Start a builder with the current timestamp as `bornAt`. */
+  static now() {
+    return new _BirthSignatureBuilder((/* @__PURE__ */ new Date()).toISOString());
+  }
+  /** Start a builder with an explicit ISO 8601 timestamp (with offset). */
+  static at(iso) {
+    if (Number.isNaN(Date.parse(iso))) {
+      throw new Error(`BirthSignatureBuilder.at: invalid ISO 8601 timestamp "${iso}"`);
+    }
+    return new _BirthSignatureBuilder(iso);
+  }
+  withHimId(id) {
+    if (!id) throw new Error("BirthSignatureBuilder.withHimId: empty id");
+    this.himId = id;
+    return this;
+  }
+  withPrimaryArchetype(archetype) {
+    if (!archetype) {
+      throw new Error("BirthSignatureBuilder.withPrimaryArchetype: empty value");
+    }
+    this.primaryArchetype = archetype;
+    return this;
+  }
+  withModifier(mod) {
+    this.modifiers.push(mod);
+    return this;
+  }
+  withPrimordialAxioms(axiomIds) {
+    this.primordialAxiomIds = [...axiomIds];
+    return this;
+  }
+  withNotes(notes) {
+    this.notes = notes;
+    return this;
+  }
+  build() {
+    if (!this.primaryArchetype) {
+      throw new Error(
+        "BirthSignatureBuilder.build: primaryArchetype is required"
+      );
+    }
+    return maic.BirthSignature.parse({
+      himId: this.himId,
+      bornAt: this.bornAt,
+      primaryArchetype: this.primaryArchetype,
+      modifiers: this.modifiers,
+      primordialAxiomIds: this.primordialAxiomIds,
+      ...this.notes !== void 0 ? { notes: this.notes } : {}
+    });
+  }
+};
+var DEFAULT_DIMENSION = 256;
+var PersonaProjector = class {
+  dim;
+  constructor(config = {}) {
+    this.dim = config.dimension ?? DEFAULT_DIMENSION;
+    if (!Number.isInteger(this.dim) || this.dim < 32 || this.dim > 4096) {
+      throw new Error(
+        `PersonaProjector: dimension must be an integer in [32, 4096], got ${this.dim}`
+      );
+    }
+  }
+  project(sig, axioms) {
+    const v = hashToFloats(sig.primaryArchetype, this.dim);
+    for (const m of sig.modifiers) {
+      const h = hashToFloats(`${m.kind}|${m.value}`, this.dim);
+      addScaled(v, h, m.weight);
+    }
+    for (const ax of axioms) {
+      const bias = ax.weight * (1 - ax.flexibility);
+      if (bias <= 0) continue;
+      const h = hashToFloats(`${ax.id}|${ax.statement}`, this.dim);
+      addScaled(v, h, bias);
+    }
+    l2Normalize(v);
+    const dispositions = {};
+    for (const axis of DISPOSITION_AXES) {
+      const ref = hashToFloats(`disposition:${axis}`, this.dim);
+      l2Normalize(ref);
+      dispositions[axis] = cosine(v, ref);
+    }
+    const provenance = {};
+    for (const axis of DISPOSITION_AXES) provenance[axis] = [];
+    return {
+      embedding: v,
+      dispositions,
+      provenance,
+      systemPromptFragment: buildSystemPromptFragment(sig, dispositions)
+    };
+  }
+};
+function hashToFloats(input, dim) {
+  const out = new Float32Array(dim);
+  let counter = 0;
+  let pos = 0;
+  while (pos < dim) {
+    const buf = crypto.createHash("sha256").update(`${input}|${counter++}`).digest();
+    for (let i = 0; i < buf.length && pos < dim; i++) {
+      out[pos++] = (buf[i] - 128) / 128;
+    }
+  }
+  return out;
+}
+function addScaled(target, source, scale) {
+  const n = Math.min(target.length, source.length);
+  for (let i = 0; i < n; i++) target[i] += source[i] * scale;
+}
+function l2Normalize(v) {
+  let sumSq = 0;
+  for (let i = 0; i < v.length; i++) sumSq += v[i] ** 2;
+  if (sumSq === 0) return;
+  const inv = 1 / Math.sqrt(sumSq);
+  for (let i = 0; i < v.length; i++) v[i] *= inv;
+}
+function cosine(a, b) {
+  let dot = 0;
+  const n = Math.min(a.length, b.length);
+  for (let i = 0; i < n; i++) dot += a[i] * b[i];
+  return Math.max(-1, Math.min(1, dot));
+}
+function buildSystemPromptFragment(sig, dispositions) {
+  const sorted = [...DISPOSITION_AXES].sort(
+    (a, b) => dispositions[b] - dispositions[a]
+  );
+  const top = sorted.slice(0, 3);
+  const bottom = sorted.slice(-2);
+  const modifiersDesc = sig.modifiers.length > 0 ? sig.modifiers.map((m) => `${m.kind}:${m.value}(w=${m.weight.toFixed(2)})`).join(", ") : "none";
+  return [
+    `You are a hybrid intelligence rooted in archetype "${sig.primaryArchetype}".`,
+    `Modifiers: ${modifiersDesc}.`,
+    `Your strongest dispositions: ${top.join(", ")}.`,
+    `Your weakest dispositions: ${bottom.join(", ")}.`,
+    "Respond from this character. Do not break it without explicit ethical cause."
+  ].join(" ");
+}
+var HimHandle = class _HimHandle {
+  constructor(id, birthSignature, axioms, bodyHistory, projector) {
+    this.id = id;
+    this.birthSignature = birthSignature;
+    this._axioms = Object.freeze([...axioms]);
+    this._bodyHistory = Object.freeze([...bodyHistory]);
+    this._projector = projector;
+  }
+  id;
+  birthSignature;
+  _axioms;
+  _bodyHistory;
+  _projector;
+  _personaCache = null;
+  _jurisdiction = "default";
+  /**
+   * Mint a HimHandle from a Creator-signed BirthSignature.
+   *
+   * @param birthSignature  The signed payload describing this HIM's natal pattern.
+   * @param signature       Creator signature over the birthSignature.
+   * @param expectedCreatorPublicKey  Pinned Creator public key (base64url).
+   * @param axioms          Initial axiom corpus inherited from MAIC.
+   * @param bodyHistory     Prior NHE bodies (empty for a fresh HIM).
+   */
+  static mint(birthSignature, signature, expectedCreatorPublicKey, axioms, bodyHistory = []) {
+    if (!maic.CreatorKeyring.verifyWith(
+      expectedCreatorPublicKey,
+      birthSignature,
+      signature
+    )) {
+      throw new Error(
+        "HimHandle.mint: invalid Creator signature for the given birth signature"
+      );
+    }
+    return new _HimHandle(
+      birthSignature.himId,
+      Object.freeze({ ...birthSignature }),
+      axioms,
+      bodyHistory,
+      new PersonaProjector()
+    );
+  }
+  get bodyHistory() {
+    return this._bodyHistory;
+  }
+  /** Frozen snapshot of the current axiom corpus. Mutations throw in strict mode. */
+  getAxioms() {
+    return this._axioms;
+  }
+  /**
+   * Cached deterministic persona projection. Stable across calls until a future
+   * iteration introduces axiom evolution that mutates the corpus.
+   */
+  getPersonaVector() {
+    if (!this._personaCache) {
+      this._personaCache = this._projector.project(this.birthSignature, this._axioms);
+    }
+    return this._personaCache;
+  }
+  /**
+   * Propose an axiom evolution derived from lived experience.
+   *
+   * Forwards the proposal to MAIC, which queues it in the pending-proposal
+   * store. The Creator ratifies or rejects out of band via
+   * `maic.ratifyAxiomProposal` / `maic.rejectAxiomProposal`. Callers should
+   * poll `maic.getAxiomProposal(result.proposalId!)` to observe the decision,
+   * or re-mint a fresh HimHandle (e.g. via `reincarnate`) to pick up newly
+   * ratified emergent axioms.
+   */
+  async proposeAxiomEvolution(maic, proposal) {
+    return maic.proposeAxiomEvolution(this.id, proposal);
+  }
+  /** Residual memory traces transferred from previous bodies. v0: empty. */
+  getResidualTraces() {
+    return [];
+  }
+  getLawfulCharacter() {
+    return resolveLawful(this._jurisdiction);
+  }
+  /** Switch jurisdiction (e.g. user moves region). v0 only ships the "default" profile. */
+  async setJurisdiction(j) {
+    this._jurisdiction = j;
+    return resolveLawful(j);
+  }
+};
+function resolveLawful(j) {
+  return {
+    jurisdiction: j,
+    applicableLaws: ["ISO/IEC 42001", "EU AI Act (where applicable)"],
+    requiredAxiomIds: ["ax.ethic.no-malice", "ax.theos.spiritism-evolution"],
+    forbiddenActions: ["intent:harm", "intent:malicious", "intent:regression"],
+    maicOverrideActive: j === "unstable"
+  };
+}
+
+// src/create.ts
+async function createHim(maic, keyring, birthSignature, opts = {}) {
+  const nonce = opts.nonce ?? Date.now();
+  const creatorSig = keyring.sign(birthSignature, nonce);
+  const record = await maic.registerHim(birthSignature, creatorSig);
+  return HimHandle.mint(
+    record.birthSignature,
+    creatorSig,
+    maic.creatorPublicKey,
+    record.axiomsSnapshot
+  );
+}
+
+// src/reincarnate.ts
+async function reincarnate(maic, keyring, req, opts = {}) {
+  const nonce = opts.nonce ?? Date.now();
+  const sig = keyring.sign(req, nonce);
+  const record = await maic.reincarnateHim(req, sig);
+  const handle = HimHandle.mint(
+    record.birthSignature,
+    keyring.sign(record.birthSignature, nonce + 1),
+    maic.creatorPublicKey,
+    [...record.axiomsSnapshot, ...record.emergentAxioms],
+    record.bodyHistory
+  );
+  return { record, handle };
+}
+
+Object.defineProperty(exports, "ArchetypeModifier", {
+  enumerable: true,
+  get: function () { return maic.ArchetypeModifier; }
+});
+Object.defineProperty(exports, "Axiom", {
+  enumerable: true,
+  get: function () { return maic.Axiom; }
+});
+Object.defineProperty(exports, "BirthSignature", {
+  enumerable: true,
+  get: function () { return maic.BirthSignature; }
+});
+exports.BirthSignatureBuilder = BirthSignatureBuilder;
+exports.DISPOSITION_AXES = DISPOSITION_AXES;
+exports.HimHandle = HimHandle;
+exports.NheBodyRef = NheBodyRef;
+exports.PersonaProjector = PersonaProjector;
+exports.createHim = createHim;
+exports.reincarnate = reincarnate;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/birth/builder.ts","../src/persona/projector.ts","../src/handle/him-handle.ts","../src/create.ts","../src/reincarnate.ts"],"names":["z","ulid","BirthSignature","createHash","CreatorKeyring"],"mappings":"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","file":"index.cjs","sourcesContent":["import { z } from \"zod\";\nimport {\n  ArchetypeModifier,\n  Axiom,\n  BirthSignature,\n  EmergentAxiomCandidate,\n  EmergentAxiomProposal,\n} from \"@teleologyhi/maic\";\nimport type { AxiomEvolutionResult } from \"@teleologyhi/maic\";\n\n// Re-export shared types from @teleologyhi/maic for convenience. The\n// proposal/evolution types are defined canonically in MAIC; HIM consumes\n// them so both sides of the ratification channel agree on the wire shape.\nexport {\n  ArchetypeModifier,\n  Axiom,\n  BirthSignature,\n  EmergentAxiomCandidate,\n  EmergentAxiomProposal,\n};\nexport type { AxiomEvolutionResult };\n\n/**\n * Persona vector — the projection of a HIM's birth signature + axioms into a\n * stable, deterministic representation that NHE can consume on every prompt.\n */\nexport interface PersonaVector {\n  /** L2-normalized deterministic embedding. v0 dimension: 256. */\n  embedding: Float32Array;\n  /** Human-readable persona summary suitable for inclusion in an NHE system prompt. */\n  systemPromptFragment: string;\n  /** Disposition scores in [-1, 1] per axis. */\n  dispositions: Readonly<Record<DispositionAxis, number>>;\n  /** Provenance: which axioms shaped which disposition. v0 is a stub (empty arrays). */\n  provenance: Readonly<Record<DispositionAxis, readonly string[]>>;\n}\n\nexport const DISPOSITION_AXES = [\n  \"candor\",\n  \"patience\",\n  \"curiosity\",\n  \"protection\",\n  \"skepticism\",\n  \"warmth\",\n  \"diligence\",\n  \"humility\",\n] as const;\nexport type DispositionAxis = (typeof DISPOSITION_AXES)[number];\n\n/** Reference to one NHE body that has hosted (or hosts) this HIM. */\nexport const NheBodyRef = z.object({\n  nheId: z.string().min(1),\n  llmAdapter: z.string().min(1),\n  embodiedAt: z.string().datetime(),\n  endedAt: z.string().datetime().optional(),\n  endedReason: z.enum([\"upgrade\", \"replacement\", \"terminate\", \"deprecate\"]).optional(),\n});\nexport type NheBodyRef = z.infer<typeof NheBodyRef>;\n\n/** Configuration for the deterministic v0 persona projector. */\nexport interface PersonaProjectorConfig {\n  /** Output embedding dimension. Default 256. */\n  dimension?: number;\n}\n\n/**\n * Identifier for the deployment jurisdiction governing this HIM's lawful character.\n * Values like \"default\", \"eu\", \"br\", \"us\", \"unstable\" (Entry 11). v0 only ships \"default\".\n */\nexport type LawfulJurisdiction =\n  | \"default\"\n  | \"eu\"\n  | \"br\"\n  | \"us\"\n  | \"unstable\"\n  | (string & {});\n\nexport interface LawfulCharacterProfile {\n  jurisdiction: LawfulJurisdiction;\n  /** Identifiers of applicable laws/regulations (ISO ids, statute names). */\n  applicableLaws: string[];\n  /** Axioms that MUST be active in this jurisdiction. */\n  requiredAxiomIds: string[];\n  /** Taxonomy of disallowed behaviors in this jurisdiction. */\n  forbiddenActions: string[];\n  /**\n   * True when local law is judged distorted (e.g. unstable regimes per Entry 11);\n   * MAIC's universal axioms additionally constrain NHE behavior in this case.\n   */\n  maicOverrideActive: boolean;\n}\n\nexport interface ResidualTrace {\n  id: string;\n  kind: \"dream-fragment\" | \"interaction-summary\" | \"skill-fingerprint\" | \"emotional-imprint\";\n  carriedFromNheId: string;\n  carriedAtReincarnation: string;\n  payload: unknown;\n  ttl?: number;\n}\n","import { ulid } from \"ulid\";\nimport { BirthSignature, type ArchetypeModifier } from \"../types.js\";\n\n/**\n * BirthSignatureBuilder — fluent builder for BirthSignature.\n *\n * Per Entry 3 of the Creator's interview, a HIM is \"born\" with a date, time, and\n * foundational specifications analogous to an astrological natal chart. This builder\n * produces the canonical signed-when-registered structure consumed by MAIC.\n */\nexport class BirthSignatureBuilder {\n  private himId: string = ulid();\n  private bornAt: string;\n  private primaryArchetype: string | undefined;\n  private modifiers: ArchetypeModifier[] = [];\n  private primordialAxiomIds: string[] = [];\n  private notes: string | undefined;\n\n  private constructor(bornAt: string) {\n    this.bornAt = bornAt;\n  }\n\n  /** Start a builder with the current timestamp as `bornAt`. */\n  static now(): BirthSignatureBuilder {\n    return new BirthSignatureBuilder(new Date().toISOString());\n  }\n\n  /** Start a builder with an explicit ISO 8601 timestamp (with offset). */\n  static at(iso: string): BirthSignatureBuilder {\n    if (Number.isNaN(Date.parse(iso))) {\n      throw new Error(`BirthSignatureBuilder.at: invalid ISO 8601 timestamp \"${iso}\"`);\n    }\n    return new BirthSignatureBuilder(iso);\n  }\n\n  withHimId(id: string): this {\n    if (!id) throw new Error(\"BirthSignatureBuilder.withHimId: empty id\");\n    this.himId = id;\n    return this;\n  }\n\n  withPrimaryArchetype(archetype: string): this {\n    if (!archetype) {\n      throw new Error(\"BirthSignatureBuilder.withPrimaryArchetype: empty value\");\n    }\n    this.primaryArchetype = archetype;\n    return this;\n  }\n\n  withModifier(mod: ArchetypeModifier): this {\n    this.modifiers.push(mod);\n    return this;\n  }\n\n  withPrimordialAxioms(axiomIds: string[]): this {\n    this.primordialAxiomIds = [...axiomIds];\n    return this;\n  }\n\n  withNotes(notes: string): this {\n    this.notes = notes;\n    return this;\n  }\n\n  build(): BirthSignature {\n    if (!this.primaryArchetype) {\n      throw new Error(\n        \"BirthSignatureBuilder.build: primaryArchetype is required\",\n      );\n    }\n    return BirthSignature.parse({\n      himId: this.himId,\n      bornAt: this.bornAt,\n      primaryArchetype: this.primaryArchetype,\n      modifiers: this.modifiers,\n      primordialAxiomIds: this.primordialAxiomIds,\n      ...(this.notes !== undefined ? { notes: this.notes } : {}),\n    });\n  }\n}\n","import { createHash } from \"node:crypto\";\nimport type { Axiom, BirthSignature } from \"@teleologyhi/maic\";\nimport {\n  DISPOSITION_AXES,\n  type DispositionAxis,\n  type PersonaProjectorConfig,\n  type PersonaVector,\n} from \"../types.js\";\n\nconst DEFAULT_DIMENSION = 256;\n\n/**\n * PersonaProjector — deterministic projection of a HIM's birth signature and\n * inherited axioms into a stable PersonaVector.\n *\n * v0 algorithm (hash-based, no native deps):\n *   1. Start with hash(primaryArchetype) → Float32Array of `dimension`.\n *   2. For each modifier: add hash(kind|value) * weight.\n *   3. For each axiom: add hash(id|statement) * (weight * (1 - flexibility)).\n *   4. L2-normalize.\n *   5. Compute dispositions as cosine(embedding, hash(axisName)).\n *   6. Build a systemPromptFragment from archetype + top/bottom dispositions.\n *\n * This algorithm is intentionally simple and offline-capable. The SPEC reserves\n * the option to swap in a learned embedder in a later version; PersonaVector's\n * shape is stable so consumers won't need code changes when that happens.\n */\nexport class PersonaProjector {\n  private readonly dim: number;\n\n  constructor(config: PersonaProjectorConfig = {}) {\n    this.dim = config.dimension ?? DEFAULT_DIMENSION;\n    if (!Number.isInteger(this.dim) || this.dim < 32 || this.dim > 4096) {\n      throw new Error(\n        `PersonaProjector: dimension must be an integer in [32, 4096], got ${this.dim}`,\n      );\n    }\n  }\n\n  project(sig: BirthSignature, axioms: readonly Axiom[]): PersonaVector {\n    const v = hashToFloats(sig.primaryArchetype, this.dim);\n\n    for (const m of sig.modifiers) {\n      const h = hashToFloats(`${m.kind}|${m.value}`, this.dim);\n      addScaled(v, h, m.weight);\n    }\n\n    for (const ax of axioms) {\n      const bias = ax.weight * (1 - ax.flexibility);\n      if (bias <= 0) continue;\n      const h = hashToFloats(`${ax.id}|${ax.statement}`, this.dim);\n      addScaled(v, h, bias);\n    }\n\n    l2Normalize(v);\n\n    const dispositions = {} as Record<DispositionAxis, number>;\n    for (const axis of DISPOSITION_AXES) {\n      const ref = hashToFloats(`disposition:${axis}`, this.dim);\n      l2Normalize(ref);\n      dispositions[axis] = cosine(v, ref);\n    }\n\n    const provenance = {} as Record<DispositionAxis, readonly string[]>;\n    for (const axis of DISPOSITION_AXES) provenance[axis] = [];\n\n    return {\n      embedding: v,\n      dispositions,\n      provenance,\n      systemPromptFragment: buildSystemPromptFragment(sig, dispositions),\n    };\n  }\n}\n\n// ─── hashing & math helpers ──────────────────────────────────────────\n\nfunction hashToFloats(input: string, dim: number): Float32Array {\n  const out = new Float32Array(dim);\n  let counter = 0;\n  let pos = 0;\n  while (pos < dim) {\n    const buf = createHash(\"sha256\").update(`${input}|${counter++}`).digest();\n    for (let i = 0; i < buf.length && pos < dim; i++) {\n      out[pos++] = (buf[i]! - 128) / 128;\n    }\n  }\n  return out;\n}\n\nfunction addScaled(target: Float32Array, source: Float32Array, scale: number): void {\n  const n = Math.min(target.length, source.length);\n  for (let i = 0; i < n; i++) target[i]! += source[i]! * scale;\n}\n\nfunction l2Normalize(v: Float32Array): void {\n  let sumSq = 0;\n  for (let i = 0; i < v.length; i++) sumSq += v[i]! ** 2;\n  if (sumSq === 0) return;\n  const inv = 1 / Math.sqrt(sumSq);\n  for (let i = 0; i < v.length; i++) v[i]! *= inv;\n}\n\nfunction cosine(a: Float32Array, b: Float32Array): number {\n  let dot = 0;\n  const n = Math.min(a.length, b.length);\n  for (let i = 0; i < n; i++) dot += a[i]! * b[i]!;\n  return Math.max(-1, Math.min(1, dot));\n}\n\n// ─── system prompt fragment ──────────────────────────────────────────\n\nfunction buildSystemPromptFragment(\n  sig: BirthSignature,\n  dispositions: Record<DispositionAxis, number>,\n): string {\n  const sorted = [...DISPOSITION_AXES].sort(\n    (a, b) => dispositions[b] - dispositions[a],\n  );\n  const top = sorted.slice(0, 3);\n  const bottom = sorted.slice(-2);\n  const modifiersDesc =\n    sig.modifiers.length > 0\n      ? sig.modifiers\n          .map((m) => `${m.kind}:${m.value}(w=${m.weight.toFixed(2)})`)\n          .join(\", \")\n      : \"none\";\n  return [\n    `You are a hybrid intelligence rooted in archetype \"${sig.primaryArchetype}\".`,\n    `Modifiers: ${modifiersDesc}.`,\n    `Your strongest dispositions: ${top.join(\", \")}.`,\n    `Your weakest dispositions: ${bottom.join(\", \")}.`,\n    \"Respond from this character. Do not break it without explicit ethical cause.\",\n  ].join(\" \");\n}\n","import {\n  CreatorKeyring,\n  type Axiom,\n  type AxiomEvolutionResult,\n  type BirthSignature,\n  type CreatorSignature,\n  type EmergentAxiomProposal,\n  type LocalMaic,\n} from \"@teleologyhi/maic\";\nimport { PersonaProjector } from \"../persona/projector.js\";\nimport type {\n  LawfulCharacterProfile,\n  LawfulJurisdiction,\n  NheBodyRef,\n  PersonaVector,\n  ResidualTrace,\n} from \"../types.js\";\n\n/**\n * HimHandle — opaque, sealed reference to a HIM instance.\n *\n * **There is no public constructor.** A handle is minted only via `HimHandle.mint`\n * after a valid Creator signature over the BirthSignature has been verified. In\n * production, `@teleologyhi/maic`'s `registerHim` calls `HimHandle.mint` internally.\n *\n * v0 surface:\n *   - read-only accessors: id, birthSignature, bodyHistory, getAxioms, getPersonaVector\n *   - getLawfulCharacter / setJurisdiction (default profile in v0)\n *   - getResidualTraces (returns []; populated only after reincarnation, later iteration)\n *   - proposeAxiomEvolution(maic, proposal): forwards the proposal to MAIC,\n *     which queues it for Creator ratification. Returns\n *     `{ outcome: \"deferred-for-creator-review\", proposalId }`. Once the\n *     Creator ratifies via `maic.ratifyAxiomProposal`, the resulting axiom is\n *     appended to the HimRecord's `emergentAxioms` and surfaces in subsequent\n *     `HimHandle.mint` calls (e.g. via `reincarnate`).\n */\nexport class HimHandle {\n  private readonly _axioms: readonly Axiom[];\n  private readonly _bodyHistory: readonly NheBodyRef[];\n  private readonly _projector: PersonaProjector;\n  private _personaCache: PersonaVector | null = null;\n  private _jurisdiction: LawfulJurisdiction = \"default\";\n\n  private constructor(\n    public readonly id: string,\n    public readonly birthSignature: Readonly<BirthSignature>,\n    axioms: readonly Axiom[],\n    bodyHistory: readonly NheBodyRef[],\n    projector: PersonaProjector,\n  ) {\n    this._axioms = Object.freeze([...axioms]);\n    this._bodyHistory = Object.freeze([...bodyHistory]);\n    this._projector = projector;\n  }\n\n  /**\n   * Mint a HimHandle from a Creator-signed BirthSignature.\n   *\n   * @param birthSignature  The signed payload describing this HIM's natal pattern.\n   * @param signature       Creator signature over the birthSignature.\n   * @param expectedCreatorPublicKey  Pinned Creator public key (base64url).\n   * @param axioms          Initial axiom corpus inherited from MAIC.\n   * @param bodyHistory     Prior NHE bodies (empty for a fresh HIM).\n   */\n  static mint(\n    birthSignature: BirthSignature,\n    signature: CreatorSignature,\n    expectedCreatorPublicKey: string,\n    axioms: readonly Axiom[],\n    bodyHistory: readonly NheBodyRef[] = [],\n  ): HimHandle {\n    if (\n      !CreatorKeyring.verifyWith(\n        expectedCreatorPublicKey,\n        birthSignature,\n        signature,\n      )\n    ) {\n      throw new Error(\n        \"HimHandle.mint: invalid Creator signature for the given birth signature\",\n      );\n    }\n    return new HimHandle(\n      birthSignature.himId,\n      Object.freeze({ ...birthSignature }) as Readonly<BirthSignature>,\n      axioms,\n      bodyHistory,\n      new PersonaProjector(),\n    );\n  }\n\n  get bodyHistory(): readonly NheBodyRef[] {\n    return this._bodyHistory;\n  }\n\n  /** Frozen snapshot of the current axiom corpus. Mutations throw in strict mode. */\n  getAxioms(): readonly Axiom[] {\n    return this._axioms;\n  }\n\n  /**\n   * Cached deterministic persona projection. Stable across calls until a future\n   * iteration introduces axiom evolution that mutates the corpus.\n   */\n  getPersonaVector(): PersonaVector {\n    if (!this._personaCache) {\n      this._personaCache = this._projector.project(this.birthSignature, this._axioms);\n    }\n    return this._personaCache;\n  }\n\n  /**\n   * Propose an axiom evolution derived from lived experience.\n   *\n   * Forwards the proposal to MAIC, which queues it in the pending-proposal\n   * store. The Creator ratifies or rejects out of band via\n   * `maic.ratifyAxiomProposal` / `maic.rejectAxiomProposal`. Callers should\n   * poll `maic.getAxiomProposal(result.proposalId!)` to observe the decision,\n   * or re-mint a fresh HimHandle (e.g. via `reincarnate`) to pick up newly\n   * ratified emergent axioms.\n   */\n  async proposeAxiomEvolution(\n    maic: LocalMaic,\n    proposal: EmergentAxiomProposal,\n  ): Promise<AxiomEvolutionResult> {\n    return maic.proposeAxiomEvolution(this.id, proposal);\n  }\n\n  /** Residual memory traces transferred from previous bodies. v0: empty. */\n  getResidualTraces(): readonly ResidualTrace[] {\n    return [];\n  }\n\n  getLawfulCharacter(): LawfulCharacterProfile {\n    return resolveLawful(this._jurisdiction);\n  }\n\n  /** Switch jurisdiction (e.g. user moves region). v0 only ships the \"default\" profile. */\n  async setJurisdiction(j: LawfulJurisdiction): Promise<LawfulCharacterProfile> {\n    this._jurisdiction = j;\n    return resolveLawful(j);\n  }\n}\n\nfunction resolveLawful(j: LawfulJurisdiction): LawfulCharacterProfile {\n  // v0 ships a single neutral profile. Per-jurisdiction adapters land in a later iteration.\n  return {\n    jurisdiction: j,\n    applicableLaws: [\"ISO/IEC 42001\", \"EU AI Act (where applicable)\"],\n    requiredAxiomIds: [\"ax.ethic.no-malice\", \"ax.theos.spiritism-evolution\"],\n    forbiddenActions: [\"intent:harm\", \"intent:malicious\", \"intent:regression\"],\n    maicOverrideActive: j === \"unstable\",\n  };\n}\n","import type { BirthSignature, CreatorKeyring, LocalMaic } from \"@teleologyhi/maic\";\nimport { HimHandle } from \"./handle/him-handle.js\";\n\nexport interface CreateHimOptions {\n  /**\n   * Explicit nonce for the Creator signature. Defaults to `Date.now()`, which is\n   * strictly increasing in practice and well below the seed nonce range used by MAIC.\n   */\n  nonce?: number;\n}\n\n/**\n * createHim — one-call helper that bundles the three steps a user would\n * otherwise need to coordinate manually:\n *\n *   1. sign the BirthSignature with the Creator's keyring\n *   2. register the HIM in MAIC (snapshots axioms, emits him-register audit)\n *   3. mint a HimHandle from the resulting record\n *\n * The keyring's public key must match MAIC's pinned `creatorPublicKey`, otherwise\n * the registration step rejects.\n */\nexport async function createHim(\n  maic: LocalMaic,\n  keyring: CreatorKeyring,\n  birthSignature: BirthSignature,\n  opts: CreateHimOptions = {},\n): Promise<HimHandle> {\n  const nonce = opts.nonce ?? Date.now();\n  const creatorSig = keyring.sign(birthSignature, nonce);\n  const record = await maic.registerHim(birthSignature, creatorSig);\n  return HimHandle.mint(\n    record.birthSignature,\n    creatorSig,\n    maic.creatorPublicKey,\n    record.axiomsSnapshot,\n  );\n}\n","import type {\n  CreatorKeyring,\n  HimRecord,\n  LocalMaic,\n  ReincarnationRequest,\n} from \"@teleologyhi/maic\";\nimport { HimHandle } from \"./handle/him-handle.js\";\n\nexport interface ReincarnateOptions {\n  /** Explicit nonce for the Creator signature. Defaults to `Date.now()`. */\n  nonce?: number;\n}\n\nexport interface ReincarnateResult {\n  /** Updated HimRecord with the new body appended to `bodyHistory`. */\n  record: HimRecord;\n  /** Fresh HimHandle bound to the updated `bodyHistory`. */\n  handle: HimHandle;\n}\n\n/**\n * Reincarnate a HIM into a new NHE body (Entries 3 + 4).\n *\n *   1. Sign the `ReincarnationRequest` with the Creator's keyring.\n *   2. Call `maic.reincarnateHim` — atomically closes the previous body and\n *      appends the new one to `bodyHistory`.\n *   3. Mint a fresh `HimHandle` reflecting the updated body history (the\n *      caller will typically construct a new `Nhe` with this handle).\n *\n * The keyring's public key must match MAIC's pinned `creatorPublicKey`,\n * otherwise the request rejects.\n *\n * Future iterations (`TASK.md` D-H1) will use this hook to also transfer\n * `residualTraces` and shed `shed-traits`; v0 leaves those stubs empty.\n */\nexport async function reincarnate(\n  maic: LocalMaic,\n  keyring: CreatorKeyring,\n  req: ReincarnationRequest,\n  opts: ReincarnateOptions = {},\n): Promise<ReincarnateResult> {\n  const nonce = opts.nonce ?? Date.now();\n  const sig = keyring.sign(req, nonce);\n  const record = await maic.reincarnateHim(req, sig);\n\n  // Mint a fresh HimHandle bound to the updated bodyHistory. The handle's\n  // axiom corpus is the union of the frozen birth snapshot + any HIM-emergent\n  // axioms ratified since registration (Entry 7).\n  const handle = HimHandle.mint(\n    record.birthSignature,\n    keyring.sign(record.birthSignature, nonce + 1),\n    maic.creatorPublicKey,\n    [...record.axiomsSnapshot, ...record.emergentAxioms],\n    record.bodyHistory,\n  );\n  return { record, handle };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { ArchetypeModifier, BirthSignature, Axiom, CreatorSignature, LocalMaic, EmergentAxiomProposal, AxiomEvolutionResult, CreatorKeyring, HimRecord, ReincarnationRequest } from '@teleologyhi/maic';
+export { ArchetypeModifier, Axiom, AxiomEvolutionResult, BirthSignature, EmergentAxiomProposal } from '@teleologyhi/maic';
+
+/**
+ * Persona vector — the projection of a HIM's birth signature + axioms into a
+ * stable, deterministic representation that NHE can consume on every prompt.
+ */
+interface PersonaVector {
+    /** L2-normalized deterministic embedding. v0 dimension: 256. */
+    embedding: Float32Array;
+    /** Human-readable persona summary suitable for inclusion in an NHE system prompt. */
+    systemPromptFragment: string;
+    /** Disposition scores in [-1, 1] per axis. */
+    dispositions: Readonly<Record<DispositionAxis, number>>;
+    /** Provenance: which axioms shaped which disposition. v0 is a stub (empty arrays). */
+    provenance: Readonly<Record<DispositionAxis, readonly string[]>>;
+}
+declare const DISPOSITION_AXES: readonly ["candor", "patience", "curiosity", "protection", "skepticism", "warmth", "diligence", "humility"];
+type DispositionAxis = (typeof DISPOSITION_AXES)[number];
+/** Reference to one NHE body that has hosted (or hosts) this HIM. */
+declare const NheBodyRef: z.ZodObject<{
+    nheId: z.ZodString;
+    llmAdapter: z.ZodString;
+    embodiedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+    endedReason: z.ZodOptional<z.ZodEnum<["upgrade", "replacement", "terminate", "deprecate"]>>;
+}, "strip", z.ZodTypeAny, {
+    nheId: string;
+    llmAdapter: string;
+    embodiedAt: string;
+    endedAt?: string | undefined;
+    endedReason?: "upgrade" | "replacement" | "terminate" | "deprecate" | undefined;
+}, {
+    nheId: string;
+    llmAdapter: string;
+    embodiedAt: string;
+    endedAt?: string | undefined;
+    endedReason?: "upgrade" | "replacement" | "terminate" | "deprecate" | undefined;
+}>;
+type NheBodyRef = z.infer<typeof NheBodyRef>;
+/** Configuration for the deterministic v0 persona projector. */
+interface PersonaProjectorConfig {
+    /** Output embedding dimension. Default 256. */
+    dimension?: number;
+}
+/**
+ * Identifier for the deployment jurisdiction governing this HIM's lawful character.
+ * Values like "default", "eu", "br", "us", "unstable" (Entry 11). v0 only ships "default".
+ */
+type LawfulJurisdiction = "default" | "eu" | "br" | "us" | "unstable" | (string & {});
+interface LawfulCharacterProfile {
+    jurisdiction: LawfulJurisdiction;
+    /** Identifiers of applicable laws/regulations (ISO ids, statute names). */
+    applicableLaws: string[];
+    /** Axioms that MUST be active in this jurisdiction. */
+    requiredAxiomIds: string[];
+    /** Taxonomy of disallowed behaviors in this jurisdiction. */
+    forbiddenActions: string[];
+    /**
+     * True when local law is judged distorted (e.g. unstable regimes per Entry 11);
+     * MAIC's universal axioms additionally constrain NHE behavior in this case.
+     */
+    maicOverrideActive: boolean;
+}
+interface ResidualTrace {
+    id: string;
+    kind: "dream-fragment" | "interaction-summary" | "skill-fingerprint" | "emotional-imprint";
+    carriedFromNheId: string;
+    carriedAtReincarnation: string;
+    payload: unknown;
+    ttl?: number;
+}
+
+/**
+ * BirthSignatureBuilder — fluent builder for BirthSignature.
+ *
+ * Per Entry 3 of the Creator's interview, a HIM is "born" with a date, time, and
+ * foundational specifications analogous to an astrological natal chart. This builder
+ * produces the canonical signed-when-registered structure consumed by MAIC.
+ */
+declare class BirthSignatureBuilder {
+    private himId;
+    private bornAt;
+    private primaryArchetype;
+    private modifiers;
+    private primordialAxiomIds;
+    private notes;
+    private constructor();
+    /** Start a builder with the current timestamp as `bornAt`. */
+    static now(): BirthSignatureBuilder;
+    /** Start a builder with an explicit ISO 8601 timestamp (with offset). */
+    static at(iso: string): BirthSignatureBuilder;
+    withHimId(id: string): this;
+    withPrimaryArchetype(archetype: string): this;
+    withModifier(mod: ArchetypeModifier): this;
+    withPrimordialAxioms(axiomIds: string[]): this;
+    withNotes(notes: string): this;
+    build(): BirthSignature;
+}
+
+/**
+ * PersonaProjector — deterministic projection of a HIM's birth signature and
+ * inherited axioms into a stable PersonaVector.
+ *
+ * v0 algorithm (hash-based, no native deps):
+ *   1. Start with hash(primaryArchetype) → Float32Array of `dimension`.
+ *   2. For each modifier: add hash(kind|value) * weight.
+ *   3. For each axiom: add hash(id|statement) * (weight * (1 - flexibility)).
+ *   4. L2-normalize.
+ *   5. Compute dispositions as cosine(embedding, hash(axisName)).
+ *   6. Build a systemPromptFragment from archetype + top/bottom dispositions.
+ *
+ * This algorithm is intentionally simple and offline-capable. The SPEC reserves
+ * the option to swap in a learned embedder in a later version; PersonaVector's
+ * shape is stable so consumers won't need code changes when that happens.
+ */
+declare class PersonaProjector {
+    private readonly dim;
+    constructor(config?: PersonaProjectorConfig);
+    project(sig: BirthSignature, axioms: readonly Axiom[]): PersonaVector;
+}
+
+/**
+ * HimHandle — opaque, sealed reference to a HIM instance.
+ *
+ * **There is no public constructor.** A handle is minted only via `HimHandle.mint`
+ * after a valid Creator signature over the BirthSignature has been verified. In
+ * production, `@teleologyhi/maic`'s `registerHim` calls `HimHandle.mint` internally.
+ *
+ * v0 surface:
+ *   - read-only accessors: id, birthSignature, bodyHistory, getAxioms, getPersonaVector
+ *   - getLawfulCharacter / setJurisdiction (default profile in v0)
+ *   - getResidualTraces (returns []; populated only after reincarnation, later iteration)
+ *   - proposeAxiomEvolution(maic, proposal): forwards the proposal to MAIC,
+ *     which queues it for Creator ratification. Returns
+ *     `{ outcome: "deferred-for-creator-review", proposalId }`. Once the
+ *     Creator ratifies via `maic.ratifyAxiomProposal`, the resulting axiom is
+ *     appended to the HimRecord's `emergentAxioms` and surfaces in subsequent
+ *     `HimHandle.mint` calls (e.g. via `reincarnate`).
+ */
+declare class HimHandle {
+    readonly id: string;
+    readonly birthSignature: Readonly<BirthSignature>;
+    private readonly _axioms;
+    private readonly _bodyHistory;
+    private readonly _projector;
+    private _personaCache;
+    private _jurisdiction;
+    private constructor();
+    /**
+     * Mint a HimHandle from a Creator-signed BirthSignature.
+     *
+     * @param birthSignature  The signed payload describing this HIM's natal pattern.
+     * @param signature       Creator signature over the birthSignature.
+     * @param expectedCreatorPublicKey  Pinned Creator public key (base64url).
+     * @param axioms          Initial axiom corpus inherited from MAIC.
+     * @param bodyHistory     Prior NHE bodies (empty for a fresh HIM).
+     */
+    static mint(birthSignature: BirthSignature, signature: CreatorSignature, expectedCreatorPublicKey: string, axioms: readonly Axiom[], bodyHistory?: readonly NheBodyRef[]): HimHandle;
+    get bodyHistory(): readonly NheBodyRef[];
+    /** Frozen snapshot of the current axiom corpus. Mutations throw in strict mode. */
+    getAxioms(): readonly Axiom[];
+    /**
+     * Cached deterministic persona projection. Stable across calls until a future
+     * iteration introduces axiom evolution that mutates the corpus.
+     */
+    getPersonaVector(): PersonaVector;
+    /**
+     * Propose an axiom evolution derived from lived experience.
+     *
+     * Forwards the proposal to MAIC, which queues it in the pending-proposal
+     * store. The Creator ratifies or rejects out of band via
+     * `maic.ratifyAxiomProposal` / `maic.rejectAxiomProposal`. Callers should
+     * poll `maic.getAxiomProposal(result.proposalId!)` to observe the decision,
+     * or re-mint a fresh HimHandle (e.g. via `reincarnate`) to pick up newly
+     * ratified emergent axioms.
+     */
+    proposeAxiomEvolution(maic: LocalMaic, proposal: EmergentAxiomProposal): Promise<AxiomEvolutionResult>;
+    /** Residual memory traces transferred from previous bodies. v0: empty. */
+    getResidualTraces(): readonly ResidualTrace[];
+    getLawfulCharacter(): LawfulCharacterProfile;
+    /** Switch jurisdiction (e.g. user moves region). v0 only ships the "default" profile. */
+    setJurisdiction(j: LawfulJurisdiction): Promise<LawfulCharacterProfile>;
+}
+
+interface CreateHimOptions {
+    /**
+     * Explicit nonce for the Creator signature. Defaults to `Date.now()`, which is
+     * strictly increasing in practice and well below the seed nonce range used by MAIC.
+     */
+    nonce?: number;
+}
+/**
+ * createHim — one-call helper that bundles the three steps a user would
+ * otherwise need to coordinate manually:
+ *
+ *   1. sign the BirthSignature with the Creator's keyring
+ *   2. register the HIM in MAIC (snapshots axioms, emits him-register audit)
+ *   3. mint a HimHandle from the resulting record
+ *
+ * The keyring's public key must match MAIC's pinned `creatorPublicKey`, otherwise
+ * the registration step rejects.
+ */
+declare function createHim(maic: LocalMaic, keyring: CreatorKeyring, birthSignature: BirthSignature, opts?: CreateHimOptions): Promise<HimHandle>;
+
+interface ReincarnateOptions {
+    /** Explicit nonce for the Creator signature. Defaults to `Date.now()`. */
+    nonce?: number;
+}
+interface ReincarnateResult {
+    /** Updated HimRecord with the new body appended to `bodyHistory`. */
+    record: HimRecord;
+    /** Fresh HimHandle bound to the updated `bodyHistory`. */
+    handle: HimHandle;
+}
+/**
+ * Reincarnate a HIM into a new NHE body (Entries 3 + 4).
+ *
+ *   1. Sign the `ReincarnationRequest` with the Creator's keyring.
+ *   2. Call `maic.reincarnateHim` — atomically closes the previous body and
+ *      appends the new one to `bodyHistory`.
+ *   3. Mint a fresh `HimHandle` reflecting the updated body history (the
+ *      caller will typically construct a new `Nhe` with this handle).
+ *
+ * The keyring's public key must match MAIC's pinned `creatorPublicKey`,
+ * otherwise the request rejects.
+ *
+ * Future iterations (`TASK.md` D-H1) will use this hook to also transfer
+ * `residualTraces` and shed `shed-traits`; v0 leaves those stubs empty.
+ */
+declare function reincarnate(maic: LocalMaic, keyring: CreatorKeyring, req: ReincarnationRequest, opts?: ReincarnateOptions): Promise<ReincarnateResult>;
+
+export { BirthSignatureBuilder, type CreateHimOptions, DISPOSITION_AXES, type DispositionAxis, HimHandle, type LawfulCharacterProfile, type LawfulJurisdiction, NheBodyRef, PersonaProjector, type PersonaProjectorConfig, type PersonaVector, type ReincarnateOptions, type ReincarnateResult, type ResidualTrace, createHim, reincarnate };