@terminals-tech/sdk 1.0.0 → 2.0.0-rc.1

package/dist/index.js

@@ -1,3 +1,23 @@
+import {
+  calculateSemanticDensity,
+  conditionalEntropy,
+  cosineSimilarity,
+  createSematon,
+  entropy,
+  estimateComplexity,
+  foldSematon,
+  isRealizable,
+  jointEntropy,
+  jsDivergence,
+  klDivergence,
+  measurePreservation,
+  mutualInformation,
+  normalize,
+  sematonDensity,
+  sematonDistance,
+  sematonEntropy,
+  unfoldSematon
+} from "./chunk-PKINKOW2.js";
 import {
   ensureSkillsRegistered,
   getAllSkills,
@@ -5,7 +25,7 @@ import {
   getSkillCount,
   getSkillsByCategory,
   registerSkill
-} from "./chunk-L45BSQDJ.js";
+} from "./chunk-Y5WLSLLW.js";
 import {
   createDAG,
   createDelegationChain,
@@ -24,19 +44,11 @@ import {
   wrapTo2Pi,
   wrapToPi
 } from "./chunk-WU4OTGJE.js";
-import "./chunk-OCLSAUCD.js";
-import "./chunk-BYXBJQAS.js";
-import {
-  SKILL_CATEGORIES,
-  SKILL_RANKS,
-  SKILL_RUN_STATUSES,
-  SKILL_TIERS
-} from "./chunk-ABCK4FWN.js";
 import {
   createInteractionWithEvents,
   formatAddress,
   parseAddress
-} from "./chunk-BCOQMFKT.js";
+} from "./chunk-TO7ETE5K.js";
 import {
   createEventBus,
   createSignalBus,
@@ -44,16 +56,24 @@ import {
   getSignalBus,
   subscribeToSignals
 } from "./chunk-2WTYE4SW.js";
+import "./chunk-BYXBJQAS.js";
+import {
+  SKILL_CATEGORIES,
+  SKILL_RANKS,
+  SKILL_RUN_STATUSES,
+  SKILL_TIERS
+} from "./chunk-ABCK4FWN.js";
 import {
   secureValidate,
   validateWithSchema
-} from "./chunk-FOXUEYWK.js";
+} from "./chunk-GOQHOLBG.js";
+import "./chunk-QJFKEQHF.js";
 import {
   unbrand,
   untrusted,
   validated
 } from "./chunk-EXI3LJVJ.js";
-import "./chunk-QJFKEQHF.js";
+import "./chunk-WT6L6DK3.js";
 import "./chunk-XPJ63Y6T.js";
 import {
   createCircuitBreaker,
@@ -66,10 +86,207 @@ import {
 // ../../lib/terminals-tech/sdk/terminal.ts
 var terminal_exports = {};
 __export(terminal_exports, {
+  Terminal: () => Terminal,
   createInteraction: () => createInteractionWithEvents,
   createInteractionWithEvents: () => createInteractionWithEvents
 });
 
+// ../agent-sdk/src/result.ts
+function extractText(outputs) {
+  const keys = Object.keys(outputs);
+  if (keys.length === 0) return "";
+  const lastKey = keys[keys.length - 1];
+  const lastOutput = outputs[lastKey];
+  if (typeof lastOutput === "string") return lastOutput;
+  if (lastOutput && typeof lastOutput === "object" && "result" in lastOutput) {
+    const result = lastOutput.result;
+    return typeof result === "string" ? result : JSON.stringify(result);
+  }
+  return JSON.stringify(lastOutput);
+}
+function toTerminalResult(sematon) {
+  const { payload, witness } = sematon;
+  const outputs = payload.outputs ?? {};
+  const entries = Object.entries(outputs);
+  const steps = [];
+  const agents = [];
+  for (let i = 0; i < entries.length; i++) {
+    const [id, output] = entries[i];
+    steps.push({ agent: id, output, index: i });
+    agents.push({ id, output });
+  }
+  return {
+    text: extractText(outputs),
+    coherence: witness.R,
+    receipt: sematon,
+    steps,
+    agents,
+    duration: payload.duration
+  };
+}
+
+// ../agent-sdk/src/terminal.ts
+function generateTerminalId() {
+  return `term_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+}
+function buildNodes(agents, task) {
+  return agents.map((agent, idx) => ({
+    id: `agent-${idx}`,
+    nodeRef: "provider.chat.v1",
+    config: {
+      role: agent.role,
+      capabilities: agent.capabilities ?? [],
+      prompt: task
+    }
+  }));
+}
+function buildEdges(agents) {
+  const edges = [];
+  for (let i = 0; i < agents.length - 1; i++) {
+    edges.push({
+      from: `agent-${i}`,
+      to: `agent-${i + 1}`
+    });
+  }
+  return edges;
+}
+function buildManifest(id, config) {
+  return {
+    id,
+    version: "1.0.0",
+    name: `Terminal ${id}`,
+    nodes: buildNodes(config.agents, config.task),
+    edges: buildEdges(config.agents),
+    layer: "L4"
+  };
+}
+function flattenOutputs(outputs) {
+  if (!outputs) return {};
+  const result = {};
+  for (const [nodeId, nodeOutput] of outputs) {
+    result[nodeId] = nodeOutput;
+  }
+  return result;
+}
+var Terminal = class _Terminal {
+  /** Unique terminal identifier */
+  id;
+  config;
+  manifest;
+  constructor(id, config) {
+    this.id = id;
+    this.config = config;
+    this.manifest = buildManifest(id, config);
+  }
+  /**
+   * Create a new Terminal from semantic configuration.
+   *
+   * Translates the developer-friendly config into internal stack manifests,
+   * registers required nodes, and returns a ready-to-run Terminal.
+   */
+  static async create(config) {
+    if (!config.agents || config.agents.length === 0) {
+      throw new Error("Terminal.create requires at least one agent");
+    }
+    if (!config.task || config.task.trim().length === 0) {
+      throw new Error("Terminal.create requires a non-empty task");
+    }
+    const id = generateTerminalId();
+    await import("./nodes-TWQZUZRM.js").catch(
+      (err2) => console.warn("[Terminal.create] Node catalog init warning:", err2)
+    );
+    await import("./catalog-XA5VYWXG.js").catch(
+      (err2) => console.warn("[Terminal.create] Catalog init warning:", err2)
+    );
+    return new _Terminal(id, config);
+  }
+  /**
+   * Execute the terminal workflow and return a Sematon-wrapped result.
+   *
+   * Uses OrchestratorV0 to run the DAG, then wraps the output
+   * in a Sematon<TerminalRunResult> with convergence witness.
+   */
+  async run() {
+    const startTime = Date.now();
+    const threshold = this.config.coherence?.threshold ?? 0.6;
+    const { createSematon: createSematon2 } = await import("./sematon-2EUEZESN.js");
+    const { OrchestratorV0 } = await import("./core.machine.orchestrator-NW73YDTL.js");
+    const { resolveNode } = await import("./catalog-XA5VYWXG.js");
+    const orchestrator = new OrchestratorV0(
+      resolveNode
+    );
+    let runResult;
+    try {
+      runResult = await orchestrator.run(this.manifest, {
+        terminalId: this.id,
+        configOverrides: this.config.provider ? Object.fromEntries(
+          this.manifest.nodes.map((n) => [
+            n.id,
+            {
+              provider: this.config.provider,
+              model: this.config.model
+            }
+          ])
+        ) : void 0
+      });
+    } finally {
+      orchestrator.dispose();
+    }
+    const duration = Date.now() - startTime;
+    const outputs = flattenOutputs(runResult.outputs);
+    const R = runResult.succeeded ? 0.85 : 0.2;
+    const converged = R >= threshold && runResult.succeeded;
+    const witness = {
+      R,
+      activationEntropy: Object.keys(outputs).length > 0 ? 2.5 : 0,
+      converged,
+      step: this.manifest.nodes.length
+    };
+    const payload = { outputs, duration };
+    return createSematon2({
+      kind: "custom",
+      payload,
+      witness,
+      source: `terminal:${this.id}`
+    });
+  }
+  /**
+   * Static convenience: create and run a terminal in one call.
+   * Returns a developer-friendly TerminalResult instead of a raw Sematon.
+   */
+  static async run(config) {
+    const terminal = await _Terminal.create(config);
+    const sematon = await terminal.run();
+    return toTerminalResult(sematon);
+  }
+  /**
+   * Chain a new terminal execution from a previous Sematon result.
+   *
+   * Extracts `prev.payload.outputs` and injects them as `previousOutputs`
+   * in the config overrides, then creates a new Terminal, runs it, and
+   * returns the new Sematon.
+   */
+  static async chain(prev, config) {
+    const prevPayload = prev.payload;
+    const previousOutputs = prevPayload?.outputs ?? {};
+    const fullConfig = {
+      agents: config.agents ?? [{ role: "assistant" }],
+      task: config.task ?? "Continue from previous results",
+      coherence: config.coherence,
+      provider: config.provider,
+      model: config.model
+    };
+    const terminal = await _Terminal.create(fullConfig);
+    for (const node of terminal.manifest.nodes) {
+      node.config = {
+        ...node.config,
+        previousOutputs
+      };
+    }
+    return terminal.run();
+  }
+};
+
 // ../../lib/terminals-tech/sdk/core.ts
 var core_exports = {};
 __export(core_exports, {
@@ -275,165 +492,6 @@ function createBridge(from, to, iso) {
   };
 }
 
-// ../../lib/terminals-tech/core/L0/information.ts
-function entropy(probabilities) {
-  if (probabilities.length === 0) return 0;
-  const sum = probabilities.reduce((a, b) => a + b, 0);
-  const normalized = sum === 0 ? probabilities : probabilities.map((p) => p / sum);
-  return normalized.reduce((h, p) => {
-    if (p <= 0) return h;
-    return h - p * Math.log2(p);
-  }, 0);
-}
-function jointEntropy(jointProbabilities) {
-  const flat = jointProbabilities.flat();
-  return entropy(flat);
-}
-function conditionalEntropy(jointProbabilities) {
-  const hXY = jointEntropy(jointProbabilities);
-  const pX = jointProbabilities.map((row) => row.reduce((a, b) => a + b, 0));
-  const hX = entropy(pX);
-  return hXY - hX;
-}
-function mutualInformation(pX, pY, pXY) {
-  const hX = entropy(pX);
-  const hY = entropy(pY);
-  const hXY = jointEntropy(pXY);
-  return Math.max(0, hX + hY - hXY);
-}
-function measurePreservation(source, transformed, roundTrip) {
-  if (source.length === 0) {
-    return {
-      retention: 1,
-      sourceEntropy: 0,
-      targetEntropy: 0,
-      mutualInfo: 0,
-      lossless: true
-    };
-  }
-  const sourceFreq = countFrequencies(source.map(String));
-  const transformedFreq = countFrequencies(transformed.map(String));
-  const n = source.length;
-  const sourceProbabilities = Object.values(sourceFreq).map((c) => c / n);
-  const transformedProbabilities = Object.values(transformedFreq).map((c) => c / n);
-  const sourceEntropy = entropy(sourceProbabilities);
-  const targetEntropy = entropy(transformedProbabilities);
-  let retention = 1;
-  let lossless = true;
-  if (roundTrip) {
-    const matches = source.filter((s, i) => String(s) === String(roundTrip[i])).length;
-    retention = matches / source.length;
-    lossless = matches === source.length;
-  } else {
-    const sourceCardinality = Object.keys(sourceFreq).length;
-    const targetCardinality = Object.keys(transformedFreq).length;
-    retention = Math.min(1, targetCardinality / sourceCardinality);
-    lossless = targetCardinality >= sourceCardinality;
-  }
-  const minEntropy = Math.min(sourceEntropy, targetEntropy);
-  const mutualInfo = retention * minEntropy;
-  return {
-    retention,
-    sourceEntropy,
-    targetEntropy,
-    mutualInfo,
-    lossless
-  };
-}
-function calculateSemanticDensity(tokens, baselineTokensPerBit = 2) {
-  if (tokens.length === 0) {
-    return {
-      tokenCount: 0,
-      informationBits: 0,
-      density: 0,
-      compressionRatio: 1
-    };
-  }
-  const freq = countFrequencies(tokens);
-  const probabilities = Object.values(freq).map((c) => c / tokens.length);
-  const informationBits = entropy(probabilities) * tokens.length;
-  const density = tokens.length > 0 ? informationBits / tokens.length : 0;
-  const baselineBits = tokens.length / baselineTokensPerBit;
-  const compressionRatio = baselineBits > 0 ? informationBits / baselineBits : 1;
-  return {
-    tokenCount: tokens.length,
-    informationBits,
-    density,
-    compressionRatio
-  };
-}
-function estimateComplexity(data) {
-  if (data.length === 0) return 0;
-  const seen = /* @__PURE__ */ new Set();
-  let uniqueSubstrings = 0;
-  const windowSize = 8;
-  for (let i = 0; i <= data.length - windowSize; i++) {
-    const substr = data.slice(i, i + windowSize);
-    if (!seen.has(substr)) {
-      seen.add(substr);
-      uniqueSubstrings++;
-    }
-  }
-  const totalPatterns = Math.max(1, data.length - windowSize + 1);
-  return uniqueSubstrings / totalPatterns;
-}
-function klDivergence(p, q) {
-  if (p.length !== q.length) {
-    throw new Error("Distributions must have same length");
-  }
-  let divergence = 0;
-  for (let i = 0; i < p.length; i++) {
-    if (p[i] > 0 && q[i] > 0) {
-      divergence += p[i] * Math.log2(p[i] / q[i]);
-    } else if (p[i] > 0 && q[i] === 0) {
-      return Infinity;
-    }
-  }
-  return divergence;
-}
-function jsDivergence(p, q) {
-  if (p.length !== q.length) {
-    throw new Error("Distributions must have same length");
-  }
-  const m = p.map((pi, i) => 0.5 * (pi + q[i]));
-  let jsd = 0;
-  for (let i = 0; i < p.length; i++) {
-    if (p[i] > 0 && m[i] > 0) {
-      jsd += 0.5 * p[i] * Math.log2(p[i] / m[i]);
-    }
-    if (q[i] > 0 && m[i] > 0) {
-      jsd += 0.5 * q[i] * Math.log2(q[i] / m[i]);
-    }
-  }
-  return jsd;
-}
-function countFrequencies(values) {
-  const freq = {};
-  for (const v of values) {
-    const key = String(v);
-    freq[key] = (freq[key] || 0) + 1;
-  }
-  return freq;
-}
-function normalize(values) {
-  const sum = values.reduce((a, b) => a + b, 0);
-  if (sum === 0) return values.map(() => 1 / values.length);
-  return values.map((v) => v / sum);
-}
-function cosineSimilarity(a, b) {
-  if (a.length !== b.length || a.length === 0) return 0;
-  let dot = 0;
-  let normA = 0;
-  let normB = 0;
-  for (let i = 0; i < a.length; i++) {
-    dot += a[i] * b[i];
-    normA += a[i] * a[i];
-    normB += b[i] * b[i];
-  }
-  const denominator = Math.sqrt(normA) * Math.sqrt(normB);
-  return denominator === 0 ? 0 : dot / denominator;
-}
-
 // ../../lib/terminals-tech/core/L0/derivation.ts
 function extractShape(value) {
   if (value === null) {
@@ -627,143 +685,6 @@ function canEmbed(source, target) {
   return true;
 }
 
-// ../../lib/terminals-tech/core/L0/sematon.ts
-var sematonCounter = 0;
-function fnv1a(input) {
-  let hash = 2166136261;
-  for (let i = 0; i < input.length; i++) {
-    hash ^= input.charCodeAt(i);
-    hash = Math.imul(hash, 16777619);
-  }
-  return (hash >>> 0).toString(16).padStart(8, "0");
-}
-function computePayloadEntropy(payload) {
-  const json = JSON.stringify(payload);
-  if (!json || json.length === 0) return 0;
-  const freq = {};
-  for (let i = 0; i < json.length; i++) {
-    const ch = json[i];
-    freq[ch] = (freq[ch] || 0) + 1;
-  }
-  const probabilities = Object.values(freq).map((c) => c / json.length);
-  return entropy(probabilities);
-}
-function computeDensity(payload, entropyBits) {
-  const json = JSON.stringify(payload);
-  const tokenCount = json ? json.split(/\s+|[,{}[\]":]+/).filter(Boolean).length : 0;
-  return tokenCount > 0 ? entropyBits / tokenCount : 0;
-}
-function generatePadicAddress(kind, counter) {
-  const kindIndex = [
-    "signal",
-    "context",
-    "fractal",
-    "witness",
-    "combinator",
-    "interaction",
-    "custom"
-  ].indexOf(kind);
-  return `${kindIndex}.0.${counter}`;
-}
-function createSematon(config) {
-  const counter = ++sematonCounter;
-  const id = `sem_${config.kind}_${counter}_${Date.now().toString(36)}`;
-  const payloadEntropy = computePayloadEntropy(config.payload);
-  const density = computeDensity(config.payload, payloadEntropy);
-  const padicAddress = config.padicAddress ?? generatePadicAddress(config.kind, counter);
-  const hashInput = [
-    config.kind,
-    JSON.stringify(config.payload),
-    config.witness.R.toFixed(6),
-    config.witness.converged.toString(),
-    padicAddress
-  ].join("|");
-  const shapeHash = fnv1a(hashInput);
-  const constructive = config.witness.converged && Number.isFinite(payloadEntropy) && payloadEntropy > 0 && JSON.stringify(config.payload) !== "null" && JSON.stringify(config.payload) !== "undefined";
-  const impedance = density > 0 && config.witness.R > 0 ? payloadEntropy / (density * config.witness.R) : Infinity;
-  return {
-    id,
-    kind: config.kind,
-    payload: config.payload,
-    witness: { ...config.witness },
-    padicAddress,
-    entropy: payloadEntropy,
-    density,
-    impedance,
-    shapeHash,
-    constructive,
-    createdAt: Date.now(),
-    source: config.source ?? "unknown"
-  };
-}
-function sematonEntropy(sematon) {
-  return sematon.entropy;
-}
-function sematonDensity(sematon) {
-  return sematon.density;
-}
-function isRealizable(sematon) {
-  return sematon.constructive;
-}
-function sematonDistance(a, b) {
-  const vecA = payloadToVector(a.payload);
-  const vecB = payloadToVector(b.payload);
-  const cosSim = cosineSimilarity(vecA, vecB);
-  const rProximity = 1 - Math.abs(a.witness.R - b.witness.R);
-  const similarity = 0.7 * Math.max(0, cosSim) + 0.3 * rProximity;
-  return 1 - similarity;
-}
-function payloadToVector(payload) {
-  const json = JSON.stringify(payload);
-  const vec = new Array(128).fill(0);
-  if (!json) return vec;
-  for (let i = 0; i < json.length; i++) {
-    const code = json.charCodeAt(i);
-    if (code < 128) {
-      vec[code]++;
-    }
-  }
-  const sum = vec.reduce((s, v) => s + v, 0);
-  if (sum > 0) {
-    for (let i = 0; i < vec.length; i++) {
-      vec[i] /= sum;
-    }
-  }
-  return vec;
-}
-function foldSematon(sematon) {
-  return {
-    id: sematon.id,
-    kind: sematon.kind,
-    payload: JSON.stringify(sematon.payload),
-    witness: { ...sematon.witness },
-    padicAddress: sematon.padicAddress,
-    entropy: sematon.entropy,
-    density: sematon.density,
-    impedance: sematon.impedance,
-    shapeHash: sematon.shapeHash,
-    constructive: sematon.constructive,
-    createdAt: sematon.createdAt,
-    source: sematon.source
-  };
-}
-function unfoldSematon(folded) {
-  return {
-    id: folded.id,
-    kind: folded.kind,
-    payload: JSON.parse(folded.payload),
-    witness: { ...folded.witness },
-    padicAddress: folded.padicAddress,
-    entropy: folded.entropy,
-    density: folded.density,
-    impedance: folded.impedance,
-    shapeHash: folded.shapeHash,
-    constructive: folded.constructive,
-    createdAt: folded.createdAt,
-    source: folded.source
-  };
-}
-
 // ../../lib/terminals-tech/core/L0/realizability.ts
 var traceCounter = 0;
 function createRealizabilityStep(index, inputs, outputs, witness) {
@@ -3020,7 +2941,7 @@ var HermesHVMBridge = class {
   async executeBend(bendSource) {
     const manifest = this.createManifest(bendSource);
     try {
-      const { runInHVM } = await import("./hvm-CBEP3M4F.js");
+      const { runInHVM } = await import("./hvm-A7DGZ3Q5.js");
       const output = await runInHVM(
         manifest,
         { bendSource },
@@ -3913,6 +3834,29 @@ export {
   createAxonBus,
   createProtocolBridge
 };
+/**
+ * ELI5 Result Types for @terminals-tech/agent
+ *
+ * Wraps internal Sematon<TerminalRunResult> into developer-friendly types.
+ * Theory stays in the engine; developers get plain objects.
+ *
+ * @license MIT
+ * @module agent/result
+ */
+/**
+ * Terminal.create() Developer API
+ *
+ * The developer-facing entry point for creating and running multi-agent
+ * terminal workflows. Translates semantic configuration into the internal
+ * StackManifestV0 / OrchestratorV0 infrastructure and wraps results as
+ * Sematon<TerminalRunResult>.
+ *
+ * This is a headless API -- no React, no "use client".
+ *
+ * @license BUSL-1.1
+ * @copyright 2026 Intuition Labs LLC. All rights reserved. Patent Pending.
+ * @module agent-sdk/terminal
+ */
 /**
  * L0 Category Theory Primitives
  *
@@ -3933,25 +3877,6 @@ export {
  * @copyright © 2026 Intuition Labs LLC. All rights reserved. Patent Pending.
  * @module core/L0/derivation
  */
-/**
- * L0 Sematon — The Smallest Meaning-Bearing Unit
- *
- * The sematon is the atomic unit of operational meaning in Terminals OS.
- * It carries a typed payload, convergence witness, p-adic address,
- * information-theoretic metrics, and a constructor flag that guarantees
- * the Deutsch-Marletto invariant: after transforming an input, the
- * sematon retains the ability to transform again.
- *
- * The sematon unifies Signal<T>, ContextNode, FractalSnapshot,
- * ConvergenceWitness, and CombinatorEvent into a single formal type
- * at the L0 foundation layer.
- *
- * Core Engine Primitive.
- *
- * @license BUSL-1.1
- * @copyright © 2026 Intuition Labs LLC. All rights reserved. Patent Pending.
- * @module core/L0/sematon
- */
 /**
  * L0 Realizability Trace — Constructor Proof Runtime
  *

package/dist/{neuro-state-XHRGIRVO.js → neuro-state-KINIFV2D.js}

@@ -1,17 +1,17 @@
 import {
   onOrchestratorEvent
-} from "./chunk-Q2VI6ICE.js";
-import "./chunk-PWAHFID5.js";
+} from "./chunk-UB5OINTA.js";
+import "./chunk-D4MOOUDY.js";
 import "./chunk-Y2EULKA2.js";
-import "./chunk-BCOQMFKT.js";
+import "./chunk-WGBCRNMB.js";
+import "./chunk-TO7ETE5K.js";
 import {
   getSignalBus
 } from "./chunk-2WTYE4SW.js";
-import "./chunk-FOXUEYWK.js";
-import "./chunk-EXI3LJVJ.js";
+import "./chunk-GOQHOLBG.js";
 import "./chunk-QJFKEQHF.js";
+import "./chunk-EXI3LJVJ.js";
 import "./chunk-ZVO47SQV.js";
-import "./chunk-WGBCRNMB.js";
 import "./chunk-3LFMIVJM.js";
 import "./chunk-AFDUOYHD.js";
 import "./chunk-NTMBOESX.js";