@terminals-tech/sdk 1.0.0-rc.1

package/LICENSE

@@ -0,0 +1,92 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Intuition Labs LLC
+Licensed Work:        Terminals Platform
+                      The Licensed Work is (c) 2024-2026 Intuition Labs LLC
+Additional Use Grant: You may make use of the Licensed Work, provided that
+                      you may not use the Licensed Work for a Competing Use.
+                      A "Competing Use" means making the Licensed Work available
+                      to third parties as a commercial hosted or managed service
+                      that substitutes for the Licensed Work.
+Change Date:          Four years from the date the Licensed Work is published.
+Change License:       Apache License, Version 2.0
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact: legal@terminals.tech
+
+Notice
+
+The Business Source License (this document, or the "License") is not an Open
+Source license. However, the Licensed Work will eventually be made available
+under an Open Source License, as stated in this License.
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under the
+terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently
+in effect as described in this License, you must purchase a commercial license
+from the Licensor, its affiliated entities, or authorized resellers, or you must
+refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of
+the Licensed Work. If you receive the Licensed Work in original or modified form
+from a third party, the terms and conditions set forth in this License apply to
+your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates (provided that you may use a trademark or logo of Licensor as
+expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
+
+MariaDB hereby grants you permission to use this License's text to license your
+works, and to refer to it using the trademark "Business Source License", as long
+as you comply with the Covenants of Licensor below.
+
+Covenants of Licensor
+
+In consideration of the right to use this License's text and the "Business
+Source License" name and trademark, Licensor covenants to MariaDB, and to all
+other recipients of the licensed work to be provided by Licensor:
+
+1. To specify as the Change License the GPL Version 2.0 or any later version,
+   or a license that is compatible with GPL Version 2.0 or a later version,
+   where "compatible" means that software provided under the Change License can
+   be included in a program with software provided under GPL Version 2.0 or a
+   later version. Licensor may specify additional Change Licenses without
+   limitation.
+
+2. To either: (a) specify an additional grant of rights to use that does not
+   impose any additional restriction on the right granted in this License, as
+   the Additional Use Grant; or (b) insert the text "None".
+
+3. To specify a Change Date.
+
+4. Not to modify this License in any other way.

package/README.md

@@ -0,0 +1,109 @@
+# @terminals-tech/sdk
+
+Terminals OS SDK — publish-safe facades and primitives for building observable, coherence-aware software.
+
+## Install
+
+```bash
+npm install @terminals-tech/sdk
+```
+
+## Quickstart
+
+```typescript
+import { SDK_VERSION, Brain, L0, calculateCoherence, 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.
+const mySematon = L0.createSematon({
+  kind: "custom",
+  payload: { message: "Hello Terminals!" },
+  witness: { R: 1.0, activationEntropy: 0, converged: true, step: 1 },
+});
+
+console.log("Is my payload constructive?", mySematon.constructive); // true!
+
+// 2. The L4 Brain: Measure how aligned things are
+const metrics = calculateCoherence({
+  output: "Execution is observable, coherence-aware, and locally steerable.",
+  groundTruth: ["Execution is observable."],
+});
+
+console.log("Coherence:", metrics.overall);
+```
+
+## Architecture
+
+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                  |
+
+## ELI5: The L0 Foundation (Sematons & Constructors)
+
+**What is a Sematon?**
+Imagine you're baking a cake. You have the ingredients (your `payload`). A Sematon is an unbreakable box that holds your ingredients, along with a "stamp of approval" (`witness`) saying these ingredients are perfectly mixed. The engine looks at this box and says: "Yes, this is a **Constructor**—I can guarantee that if I bake this, it will turn out exactly the same every single time, anywhere in the universe."
+
+Developers use `L0` primitives to make sure complex AI workflows behave predictably, shielding you from the heavy math (like p-adic addresses or Kuramoto order parameters) while giving you the structural power of deterministic execution.
+
+## Usage
+
+```typescript
+import {
+  Brain,
+  Core,
+  Mesh,
+  Protocol,
+  calculateCoherence,
+  createAxonBus,
+} from "@terminals-tech/sdk";
+
+const bus = createAxonBus();
+const metrics = calculateCoherence({
+  output: "The mesh is synchronized and the route is clear.",
+  groundTruth: ["The mesh is synchronized.", "Routing remains observable."],
+});
+const phases = Brain.kuramotoStep([0, Math.PI / 4], 0, 0.8, undefined, 0.1);
+
+await bus.publishSDK({
+  type: "sdk.demo.pulse",
+  source: { protocol: "axon", address: "demo:source" },
+  target: { protocol: "axon", address: "demo:target" },
+  payload: { coherence: metrics.overall, nextPhase: phases[0] },
+});
+
+console.log({ Core, Mesh, Protocol });
+```
+
+## Local verification
+
+From the monorepo root:
+
+```bash
+npm run sdk:publish:check
+```
+
+This builds the package, validates the packed artifact list, and smoke-tests both ESM and CJS installs from the generated tarball.
+
+Package-only dry run:
+
+```bash
+npm run -w @terminals-tech/sdk pack:dry-run
+```
+
+## Release workflow
+
+1. Confirm the IP gate is open for SDK publication
+2. Run `npm run sdk:publish:check`
+3. Inspect the dry-run tarball summary
+4. Publish when ready with `npm publish --workspace @terminals-tech/sdk`
+
+## License
+
+BUSL-1.1 — Patent Pending. (c) 2026 Intuition Labs LLC.