@terminals-tech/sdk 1.0.0-rc.2 → 1.0.0

package/README.md

@@ -11,7 +11,7 @@ npm install @terminals-tech/sdk
 ## Quickstart
 
 ```typescript
-import { SDK_VERSION, Brain, L0, calculateCoherence, createAxonBus } from "@terminals-tech/sdk";
+import { SDK_VERSION, Brain, L0, createAxonBus } from "@terminals-tech/sdk";
 
 // 1. The L0 Engine: Think of a Sematon as a "smart data envelope"
 // It holds your payload but also guarantees it can be mathematically transformed.
@@ -24,7 +24,7 @@ const mySematon = L0.createSematon({
 console.log("Is my payload constructive?", mySematon.constructive); // true!
 
 // 2. The L4 Brain: Measure how aligned things are
-const metrics = calculateCoherence({
+const metrics = Brain.calculateCoherence({
   output: "Execution is observable, coherence-aware, and locally steerable.",
   groundTruth: ["Execution is observable."],
 });
@@ -36,14 +36,17 @@ console.log("Coherence:", metrics.overall);
 
 The published package exposes a curated surface oriented around stable facades and runtime-safe primitives:
 
-| Surface    | Namespace / Export            | Coverage                                                         |
-| ---------- | ----------------------------- | ---------------------------------------------------------------- |
-| Foundation | `L0`                          | Core engine math, Sematons, and Deterministic Constructor traces |
-| Terminal   | `Terminal`                    | interaction lifecycle, surface identity, platform types          |
-| Core       | `Core`                        | result types, validation, DAG, registry, retry/event primitives  |
-| Mesh       | `Mesh`                        | signals, action bus, delegation helpers                          |
-| Brain      | `Brain`, `calculateCoherence` | coherence metrics and phase primitives                           |
-| Protocol   | `Protocol`, `createAxonBus`   | delegation helpers and the AXON protocol bridge                  |
+| Surface    | Namespace / Export | Coverage                                                                  |
+| ---------- | ------------------ | ------------------------------------------------------------------------- |
+| Foundation | `L0`               | Core engine math, Sematons, and Deterministic Constructor traces          |
+| Terminal   | `Terminal`         | interaction lifecycle, surface identity, platform types                   |
+| Core       | `Core`             | result types, validation, DAG, registry, retry/event primitives           |
+| Mesh       | `Mesh`             | signals, action bus, delegation helpers                                   |
+| Brain      | `Brain`            | coherence metrics and phase primitives (`Brain.calculateCoherence`, etc.) |
+| Protocol   | `Protocol`         | delegation helpers and the AXON protocol bridge                           |
+| Skill      | `Skill`            | skill manifest types, registry access, signal codes                       |
+| Manifold   | `Manifold`         | annihilation pipeline helpers and ordinal execution surfaces              |
+| Observer   | `Observer`         | observer kernel primitives and witness-oriented runtime inspection        |
 
 ## ELI5: The L0 Foundation (Sematons & Constructors)
 
@@ -55,17 +58,10 @@ Developers use `L0` primitives to make sure complex AI workflows behave predicta
 ## Usage
 
 ```typescript
-import {
-  Brain,
-  Core,
-  Mesh,
-  Protocol,
-  calculateCoherence,
-  createAxonBus,
-} from "@terminals-tech/sdk";
+import { Brain, Core, Mesh, Protocol, createAxonBus } from "@terminals-tech/sdk";
 
 const bus = createAxonBus();
-const metrics = calculateCoherence({
+const metrics = Brain.calculateCoherence({
   output: "The mesh is synchronized and the route is clear.",
   groundTruth: ["The mesh is synchronized.", "Routing remains observable."],
 });

package/dist/{WebContainerManager-SHXC5VKI.js → WebContainerManager-4LIOGRVM.js}

@@ -2,7 +2,7 @@ import {
   ProcessPriority,
   WebContainerManager,
   WebContainerManager_default
-} from "./chunk-SHPGIVDH.js";
+} from "./chunk-LLGZTP3G.js";
 import "./chunk-DKFJIILR.js";
 import "./chunk-KHR7ZYCX.js";
 import "./chunk-QWZRZKLZ.js";

package/dist/{chunk-BKB3MD5Y.js → chunk-KASHT6C5.js}

@@ -1,3 +1,6 @@
+import {
+  getProvider
+} from "./chunk-H3POJCFA.js";
 import {
   appendMeshSinkEvent
 } from "./chunk-PWAHFID5.js";
@@ -12,7 +15,7 @@ import {
 } from "./chunk-WU4OTGJE.js";
 import {
   registerNode
-} from "./chunk-3CEM77QZ.js";
+} from "./chunk-OCLSAUCD.js";
 import {
   emitSignal
 } from "./chunk-2WTYE4SW.js";
@@ -21,6 +24,62 @@ import {
   createPAdicAddress
 } from "./chunk-EXI3LJVJ.js";
 
+// ../../lib/terminals-tech/machines/core/nodes/provider.chat.ts
+var PROVIDER_CHAT_NODE_ID = "provider.chat.v1";
+var manifest = {
+  id: PROVIDER_CHAT_NODE_ID,
+  version: "0.1.0",
+  kind: "task",
+  label: "Provider Chat",
+  description: "Calls a chat model on a selected provider",
+  runtimes: ["worker"],
+  entrypoints: { worker: { module: "local" } },
+  inputsSchema: {
+    type: "object",
+    properties: {
+      provider: {
+        type: "string",
+        description: "provider id (openai, nous, prime, ...)"
+      },
+      model: { type: "string" },
+      messages: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: { role: { type: "string" }, content: { type: "string" } },
+          required: ["role", "content"]
+        }
+      },
+      temperature: { type: "number" },
+      secretRef: {
+        type: "string",
+        description: "reference key in Secrets store"
+      },
+      baseUrl: { type: "string", description: "override baseUrl for vendor" }
+    },
+    required: ["provider", "model", "messages"]
+  },
+  outputsSchema: {
+    type: "object",
+    properties: { message: { type: "string" }, usage: { type: "object" } }
+  }
+};
+registerNode(manifest);
+async function executeProviderChat(inputs, context) {
+  const adapter = getProvider(inputs.provider);
+  if (!adapter?.chat?.generate) throw new Error(`provider not found: ${inputs.provider}`);
+  const secrets = inputs.secretRef && context.getSecret ? await context.getSecret(inputs.secretRef) : {};
+  const out = await adapter.chat.generate(
+    {
+      model: inputs.model,
+      messages: inputs.messages,
+      temperature: inputs.temperature
+    },
+    secrets
+  );
+  return { message: out.message, usage: out.usage };
+}
+
 // ../../lib/terminals-tech/machines/hvm/bridge.ts
 function calculateValuation(node) {
   let valuation = 0;
@@ -100,7 +159,7 @@ function hvmToLogitBias(trace, baseMagnitude = 0.15) {
 
 // ../../lib/terminals-tech/machines/core/nodes/hvm.proof.edgeCheck.ts
 var HVM_PROOF_EDGE_CHECK_NODE_ID = "hvm.proof.edgeCheck.v1";
-var manifest = {
+var manifest2 = {
   id: HVM_PROOF_EDGE_CHECK_NODE_ID,
   version: "0.1.0",
   kind: "transform",
@@ -175,7 +234,7 @@ var manifest = {
     required: ["ok", "proofTrace"]
   }
 };
-registerNode(manifest);
+registerNode(manifest2);
 function hasPath(edges, from, to, visited = /* @__PURE__ */ new Set()) {
   if (from === to) return true;
   if (visited.has(from)) return false;
@@ -306,7 +365,7 @@ async function executeHvmProofEdgeCheck(input, ctx) {
 
 // ../../lib/terminals-tech/machines/core/nodes/compute.bend.ts
 var COMPUTE_BEND_NODE_ID = "compute.bend.v1";
-var manifest2 = {
+var manifest3 = {
   id: COMPUTE_BEND_NODE_ID,
   version: "0.1.0",
   kind: "task",
@@ -349,7 +408,7 @@ var manifest2 = {
     required: ["ok"]
   }
 };
-registerNode(manifest2);
+registerNode(manifest3);
 async function executeBendCompute(input, ctx) {
   const rawModule = String(input.hvmModule || "");
   const bendPath = String(input.bendPath || "");
@@ -365,7 +424,7 @@ async function executeBendCompute(input, ctx) {
       bendSource: bendSource ? "present" : "absent"
     };
   }
-  const { runInHVM } = await import("./hvm-DRQK2MUT.js");
+  const { runInHVM } = await import("./hvm-CBEP3M4F.js");
   const manifestOverride = {
     id: COMPUTE_BEND_NODE_ID,
     version: "0.1.0",
@@ -670,7 +729,7 @@ async function executePhaseLockingValueNode(inputs) {
 
 // ../../lib/terminals-tech/machines/core/nodes/system.schedule.ts
 var SYSTEM_SCHEDULE_NODE_ID = "system.schedule.v1";
-var manifest3 = {
+var manifest4 = {
   id: SYSTEM_SCHEDULE_NODE_ID,
   version: "0.1.0",
   kind: "task",
@@ -694,9 +753,9 @@ var manifest3 = {
     }
   }
 };
-registerNode(manifest3);
+registerNode(manifest4);
 async function executeSystemSchedule(_input, ctx) {
-  const { scheduleStack } = await import("./scheduler-H6Q53IMI.js");
+  const { scheduleStack } = await import("./scheduler-B5CEYKWT.js");
   const everySeconds = Math.max(1, Number(_input.everySeconds || 60));
   const enabled = Boolean(_input.enabled ?? true);
   if (enabled) await scheduleStack(ctx.stackId, everySeconds);
@@ -704,6 +763,8 @@ async function executeSystemSchedule(_input, ctx) {
 }
 
 export {
+  PROVIDER_CHAT_NODE_ID,
+  executeProviderChat,
   HVM_PROOF_EDGE_CHECK_NODE_ID,
   executeHvmProofEdgeCheck,
   COMPUTE_BEND_NODE_ID,

package/dist/{chunk-UKVUPKZP.js → chunk-L45BSQDJ.js}

@@ -280,7 +280,7 @@ var skillsLoadPromise = null;
 async function ensureSkillsRegistered() {
   if (SKILL_REGISTRY.size > 0) return;
   if (!skillsLoadPromise) {
-    skillsLoadPromise = import("./skills-KLTTT2RM.js").then(() => {
+    skillsLoadPromise = import("./skills-VN7IN7SJ.js").then(() => {
     });
   }
   await skillsLoadPromise;

package/dist/{chunk-3CEM77QZ.js → chunk-OCLSAUCD.js}

@@ -3,7 +3,7 @@ var inMemoryCatalog = /* @__PURE__ */ new Map();
 var nodesInitialized = false;
 async function ensureNodesLoaded() {
   if (!nodesInitialized) {
-    await import("./nodes-DXKYDTVO.js");
+    await import("./nodes-K6GKI2FM.js");
     nodesInitialized = true;
   }
 }

package/dist/{chunk-Q4B7YS7T.js → chunk-PPFTKJDB.js}

@@ -5,6 +5,7 @@ import {
   BASE_RESONANCE_METRICS_NODE_ID,
   COMPUTE_BEND_NODE_ID,
   HVM_PROOF_EDGE_CHECK_NODE_ID,
+  PROVIDER_CHAT_NODE_ID,
   SYSTEM_SCHEDULE_NODE_ID,
   SYSTEM_SIGNAL_EMIT_NODE_ID,
   executeBendCompute,
@@ -12,16 +13,11 @@ import {
   executeIqEncode,
   executeIqPhaseShift,
   executePhaseLockingValueNode,
+  executeProviderChat,
   executeResonanceMetrics,
   executeSystemSchedule,
   executeSystemSignalEmit
-} from "./chunk-BKB3MD5Y.js";
-import {
-  getProvider
-} from "./chunk-H3POJCFA.js";
-import {
-  registerNode
-} from "./chunk-3CEM77QZ.js";
+} from "./chunk-KASHT6C5.js";
 
 // ../../lib/types/safe-types.ts
 function isObject(value) {
@@ -34,62 +30,6 @@ function isString(value) {
   return typeof value === "string";
 }
 
-// ../../lib/terminals-tech/machines/core/nodes/provider.chat.ts
-var PROVIDER_CHAT_NODE_ID = "provider.chat.v1";
-var manifest = {
-  id: PROVIDER_CHAT_NODE_ID,
-  version: "0.1.0",
-  kind: "task",
-  label: "Provider Chat",
-  description: "Calls a chat model on a selected provider",
-  runtimes: ["worker"],
-  entrypoints: { worker: { module: "local" } },
-  inputsSchema: {
-    type: "object",
-    properties: {
-      provider: {
-        type: "string",
-        description: "provider id (openai, nous, prime, ...)"
-      },
-      model: { type: "string" },
-      messages: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: { role: { type: "string" }, content: { type: "string" } },
-          required: ["role", "content"]
-        }
-      },
-      temperature: { type: "number" },
-      secretRef: {
-        type: "string",
-        description: "reference key in Secrets store"
-      },
-      baseUrl: { type: "string", description: "override baseUrl for vendor" }
-    },
-    required: ["provider", "model", "messages"]
-  },
-  outputsSchema: {
-    type: "object",
-    properties: { message: { type: "string" }, usage: { type: "object" } }
-  }
-};
-registerNode(manifest);
-async function executeProviderChat(inputs, context) {
-  const adapter = getProvider(inputs.provider);
-  if (!adapter?.chat?.generate) throw new Error(`provider not found: ${inputs.provider}`);
-  const secrets = inputs.secretRef && context.getSecret ? await context.getSecret(inputs.secretRef) : {};
-  const out = await adapter.chat.generate(
-    {
-      model: inputs.model,
-      messages: inputs.messages,
-      temperature: inputs.temperature
-    },
-    secrets
-  );
-  return { message: out.message, usage: out.usage };
-}
-
 // ../../lib/terminals-tech/machines/core/runners/registry.ts
 var RunnerRegistry = class {
   workerRunners = /* @__PURE__ */ new Map();
@@ -134,8 +74,8 @@ var RunnerRegistry = class {
   }
 };
 var runners = new RunnerRegistry();
-import("./demo-VXMGMJNK.js").catch((err) => console.warn("[RunnerRegistry] demo runner import failed", err));
-import("./stack-CHDAFU2S.js").catch((err) => console.warn("[RunnerRegistry] stack runner import failed", err));
+import("./demo-T655Z5S4.js").catch((err) => console.warn("[RunnerRegistry] demo runner import failed", err));
+import("./stack-4KWCQQP7.js").catch((err) => console.warn("[RunnerRegistry] stack runner import failed", err));
 runners.registerWorker(PROVIDER_CHAT_NODE_ID, async (_m, input, ctx) => {
   const typedInput = input;
   const secrets = typedInput.__secrets || {};
@@ -446,7 +386,7 @@ runners.registerWorker("intel.llm.http.v1", async (_m, input, ctx) => {
   };
 });
 runners.registerWorker("integration.source.poll.v1", async (_m, input, ctx) => {
-  const { getProvider: getProvider2 } = await import("./registry-FW63E7FE.js");
+  const { getProvider } = await import("./registry-FW63E7FE.js");
   const providerIdVal = isObject(input) && "provider" in input ? input.provider : void 0;
   const providerId = String(providerIdVal || "");
   const resourceVal = isObject(input) && "resource" in input ? input.resource : void 0;
@@ -455,7 +395,7 @@ runners.registerWorker("integration.source.poll.v1", async (_m, input, ctx) => {
   const config = isObject(configVal) ? configVal : {};
   const cursorKeyVal = isObject(input) && "cursorKey" in input ? input.cursorKey : void 0;
   const cursorKey = String(cursorKeyVal || `${providerId}:${resource}`);
-  const prov = getProvider2(providerId);
+  const prov = getProvider(providerId);
   if (!prov?.integration) throw new Error(`provider not found: ${providerId}`);
   const secrets = {};
   try {
@@ -495,7 +435,7 @@ runners.registerWorker("integration.source.poll.v1", async (_m, input, ctx) => {
   return { items, cursor: nextCursor };
 });
 runners.registerWorker("integration.sink.post.v1", async (_m, input, ctx) => {
-  const { getProvider: getProvider2 } = await import("./registry-FW63E7FE.js");
+  const { getProvider } = await import("./registry-FW63E7FE.js");
   const providerIdVal = isObject(input) && "provider" in input ? input.provider : void 0;
   const providerId = String(providerIdVal || "");
   const resourceVal = isObject(input) && "resource" in input ? input.resource : void 0;
@@ -506,7 +446,7 @@ runners.registerWorker("integration.sink.post.v1", async (_m, input, ctx) => {
   const itemsVal = isObject(input) && "items" in input ? input.items : void 0;
   const itemsArray = isArray(itemsVal) ? itemsVal : void 0;
   const items = itemsArray || (singleItem !== void 0 ? [singleItem] : []);
-  const prov = getProvider2(providerId);
+  const prov = getProvider(providerId);
   if (!prov?.integration) throw new Error(`provider not found: ${providerId}`);
   const secrets = {};
   try {

package/dist/{chunk-PUZ2S62E.js → chunk-STMI72WH.js}

@@ -10,7 +10,7 @@ import {
 } from "./chunk-Q2VI6ICE.js";
 import {
   registerManifestProvider
-} from "./chunk-3CEM77QZ.js";
+} from "./chunk-OCLSAUCD.js";
 import {
   safeDbOperation
 } from "./chunk-WGBCRNMB.js";
@@ -20,6 +20,16 @@ import {
   withDB
 } from "./chunk-AFDUOYHD.js";
 
+// ../../lib/terminals-tech/machines/core/types/trigger.ts
+function buildScheduleTriggerContext(config, scheduleId) {
+  return {
+    triggerKind: config.kind,
+    triggeredAt: (/* @__PURE__ */ new Date()).toISOString(),
+    cronExpression: config.kind === "cron" ? config.expression : void 0,
+    scheduleId
+  };
+}
+
 // ../../lib/terminals-tech/machines/core/stacksStore.ts
 var globalStore = globalThis;
 var memStacks = globalStore.__memStacks || /* @__PURE__ */ new Map();
@@ -695,6 +705,23 @@ var OrchestratorV0 = class {
           ...baseInput,
           ...opts.configOverrides?.[node.id] || {}
         };
+        if (opts.triggerContext) {
+          input.__triggerContext = opts.triggerContext;
+        }
+        if (node.connectorRef) {
+          try {
+            const { resolveConnectorData } = await import("./resolver-ALOJSOK5.js");
+            const chunks = await resolveConnectorData(node.connectorRef);
+            if (chunks && chunks.length > 0) {
+              input.__connectorData = chunks;
+            }
+          } catch (connErr) {
+            console.warn(
+              `[OrchestratorV0] ConnectorRef resolution failed for node ${node.id}:`,
+              connErr
+            );
+          }
+        }
         const modelId = input.model || node.config?.model || "default";
         const span = this.tracer.startSpan(`node:${node.id}`, {
           stackId: stack.id,
@@ -895,10 +922,10 @@ var OrchestratorV0 = class {
     void stackId;
     void node;
     if (typeof window === "undefined") {
-      const { ensureServerRunnersRegistered } = await import("./server-7DM74VFW.js");
+      const { ensureServerRunnersRegistered } = await import("./server-VW6DYDLH.js");
       await ensureServerRunnersRegistered();
     }
-    const { runners } = await import("./registry-BL3TDQDB.js");
+    const { runners } = await import("./registry-5WTDYQVQ.js");
     const tierRunner = runners.getRunner(tier);
     if (tierRunner) {
       return await tierRunner(manifest, input, {
@@ -944,7 +971,7 @@ var OrchestratorV0 = class {
       return { ...input };
     }
     if (tier === "webcontainer") {
-      const { runInWebContainer } = await import("./webcontainer-3LDJVIIL.js");
+      const { runInWebContainer } = await import("./webcontainer-XWCE56F3.js");
       return await runInWebContainer(manifest, input, {
         stackId,
         nodeId: node.id,
@@ -952,7 +979,7 @@ var OrchestratorV0 = class {
       });
     }
     if (tier === "wasm-hvm") {
-      const { runInHVM } = await import("./hvm-DRQK2MUT.js");
+      const { runInHVM } = await import("./hvm-CBEP3M4F.js");
       return await runInHVM(manifest, input, {
         stackId,
         nodeId: node.id,
@@ -972,6 +999,7 @@ var OrchestratorV0 = class {
 };
 
 export {
+  buildScheduleTriggerContext,
   loadStack,
   OrchestratorV0
 };

package/dist/{container-lite-KQX3NMPY.js → container-lite-QD3CRLS4.js}

@@ -13,14 +13,14 @@ import {
 import "./chunk-UJDUQNE2.js";
 import {
   runners
-} from "./chunk-Q4B7YS7T.js";
-import "./chunk-BKB3MD5Y.js";
+} from "./chunk-PPFTKJDB.js";
+import "./chunk-KASHT6C5.js";
 import "./chunk-H3POJCFA.js";
 import "./chunk-KHR7ZYCX.js";
 import "./chunk-PWAHFID5.js";
 import "./chunk-Y2EULKA2.js";
 import "./chunk-WU4OTGJE.js";
-import "./chunk-3CEM77QZ.js";
+import "./chunk-OCLSAUCD.js";
 import "./chunk-BYXBJQAS.js";
 import "./chunk-BCOQMFKT.js";
 import "./chunk-2WTYE4SW.js";

package/dist/{demo-VXMGMJNK.js → demo-T655Z5S4.js}

@@ -1,7 +1,7 @@
 import {
   runners
-} from "./chunk-Q4B7YS7T.js";
-import "./chunk-BKB3MD5Y.js";
+} from "./chunk-PPFTKJDB.js";
+import "./chunk-KASHT6C5.js";
 import "./chunk-H3POJCFA.js";
 import "./chunk-KHR7ZYCX.js";
 import "./chunk-PWAHFID5.js";
@@ -9,7 +9,7 @@ import "./chunk-Y2EULKA2.js";
 import "./chunk-WU4OTGJE.js";
 import {
   registerNode
-} from "./chunk-3CEM77QZ.js";
+} from "./chunk-OCLSAUCD.js";
 import "./chunk-BYXBJQAS.js";
 import "./chunk-BCOQMFKT.js";
 import "./chunk-2WTYE4SW.js";

package/dist/{hvm-DRQK2MUT.js → hvm-CBEP3M4F.js}

@@ -81,7 +81,7 @@ async function runInHVM(manifest, input, ctx) {
 }
 async function runViaHVMCore(hvmPath, input) {
   if (typeof window !== "undefined") {
-    const { WebContainerManager } = await import("./WebContainerManager-SHXC5VKI.js");
+    const { WebContainerManager } = await import("./WebContainerManager-4LIOGRVM.js");
     const wcm = WebContainerManager.getExistingInstance();
     if (!wcm) {
       throw new Error("WebContainer not available for HVM execution");