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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { JSONSchema7 } from 'json-schema';
+import { Observable } from 'rxjs';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 
@@ -557,6 +558,9 @@ interface CoherenceMetrics$1 {
  * - Grounding: Connection to factual/contextual reality
  * - Internal: Self-consistency of reasoning
  * - Crystallization: Clarity and actionability of output
+ *
+ * Heuristic primitives are composed from L1 (core/primitives/coherence-heuristics).
+ * This module adds weights, configuration, explanations, and audio mapping.
  */
 
 type CoherenceMetrics = CoherenceMetrics$1;
@@ -616,7 +620,11 @@ declare function calculateCoherenceWithExplanations(input: CoherenceInput, confi
 /**
  * Validation Primitives (IO Boundary Security)
  *
- * Uses Ajv for JSON Schema validation.
+ * JSON Schema validation engine using Ajv. This is one of several validation
+ * engines behind the stable proof contract ({@link Validated}, {@link Untrusted},
+ * {@link unbrand}). The proof contract is engine-agnostic — TS-first boundaries
+ * may use Zod; data-first boundaries use this Ajv path; native boundaries use
+ * Rust serde. The branded types are the stable public API, not the engine.
  *
  * IMPORTANT: This module is NOT compatible with Vercel Edge Runtime (Middleware)
  * because Ajv uses `new Function()` for schema compilation. For Edge-compatible
@@ -923,7 +931,7 @@ declare function createDAG<N, E = void>(nodes: DAGNode<N>[], edges: DAGEdge<E>[]
  * @module sdk-types
  */
 
-interface NodePolicy$1 {
+interface NodePolicy {
     fs?: {
         mode?: "sandboxed" | "full";
         allowedPaths?: string[];
@@ -933,7 +941,7 @@ interface NodePolicy$1 {
         allowList?: string[];
     };
 }
-interface StackPolicies$1 {
+interface StackPolicies {
     fs?: {
         mode?: "sandboxed" | "full";
         allowedPaths?: string[];
@@ -1025,7 +1033,7 @@ declare function kuramotoStep(phases: ArrayLike<number>, omega: ArrayLike<number
 /**
  * Signal types for cross-layer communication
  */
-type SignalType = "health_update" | "circuit_change" | "convergence_update" | "coherence_update" | "resonance_update" | "tensor_state_update" | "task_complete" | "task_failed" | "adaptation_required" | "backpressure_warning" | "audio_metrics_update" | "mesh_update" | "mesh_query" | "session_state_change" | "skill_capture_started" | "skill_action_recorded" | "skill_capture_completed" | "skill_crystallized" | "skill_training_started" | "skill_training_completed" | "skill_artifact_activated" | "skill_suggested" | "skill_executed" | "skill_peer_review" | "skill_delegation" | "skill_agent_refine" | "skill_selection" | "skill_backpressure" | "skill_budget_exceeded" | "skill_error" | "interaction_created" | "interaction_status_changed" | "deploy_scaffold" | "deploy_push" | "deploy_build" | "deploy_status" | "deploy_preview" | "deploy_live" | "deploy_error" | "potentiation_rising" | "potentiation_peak" | "potentiation_discharge" | "potentiation_reset" | "action_dispatched" | "action_executed" | "action_failed" | "combo_completed" | "input_surface_changed" | "forge_scene_saved" | "forge_iteration_recorded" | "forge_profile_crystallized" | "forge_profile_requested" | "integration_connected" | "integration_disconnected" | "integration_heartbeat" | "integration_error" | "ui_navigation" | "ui_surface_opened" | "ui_surface_closed" | "ui_interaction" | "ui_error_shown" | "ui_search" | "artifact_preview" | "manifold_node_added" | "manifold_edge_added" | "manifold_query" | "manifold_snapshot" | "connector_status_changed" | "connector_sync_started" | "connector_sync_complete" | "connector_sync_error" | "connector_document_indexed" | "graph_entity_upserted" | "graph_relationship_added" | "graph_traversal_complete" | "intent_signal_emitted" | "oscillator_phase_updated" | "oscillator_suggestion_generated" | "journey_note_created" | "journey_note_deleted" | "journey_edge_created" | "journey_cluster_created" | "journey_replay_entered" | "journey_replay_exited" | "journey_spatial_navigate" | "journey_completed" | "boundary_crossed" | "boundary_sealed" | "convergence_declared" | "convergence_lost" | "crystallization_declared" | "crystallization_melted" | "chat_message_sent" | "chat_message_received" | "chat_error" | "coherence_gate_accepted" | "coherence_gate_rejected" | "manifold_geodesic_computed" | "manifold_distance_measured" | "sematon_created" | "sematon_witnessed" | "sematon_folded" | "sematon_realized" | "sematon_expired" | "voice_identity_encoded" | "voice_speaking_started" | "voice_speaking_completed" | "voice_chunk_scheduled" | "voice_coherence_mapped";
+type SignalType = "health_update" | "circuit_change" | "convergence_update" | "coherence_update" | "resonance_update" | "tensor_state_update" | "task_complete" | "task_failed" | "adaptation_required" | "backpressure_warning" | "audio_metrics_update" | "mesh_update" | "mesh_metrics_update" | "mesh_query" | "session_state_change" | "skill_capture_started" | "skill_action_recorded" | "skill_capture_completed" | "skill_crystallized" | "skill_training_started" | "skill_training_completed" | "skill_artifact_activated" | "skill_suggested" | "skill_executed" | "skill_peer_review" | "skill_delegation" | "skill_agent_refine" | "skill_selection" | "skill_backpressure" | "skill_budget_exceeded" | "skill_error" | "interaction_created" | "interaction_status_changed" | "deploy_scaffold" | "deploy_push" | "deploy_build" | "deploy_status" | "deploy_preview" | "deploy_live" | "deploy_error" | "potentiation_rising" | "potentiation_peak" | "potentiation_discharge" | "potentiation_reset" | "action_dispatched" | "action_executed" | "action_failed" | "combo_completed" | "input_surface_changed" | "forge_scene_saved" | "forge_iteration_recorded" | "forge_profile_crystallized" | "forge_profile_requested" | "integration_connected" | "integration_disconnected" | "integration_heartbeat" | "integration_error" | "ui_navigation" | "ui_surface_opened" | "ui_surface_closed" | "ui_interaction" | "ui_error_shown" | "ui_search" | "artifact_preview" | "manifold_node_added" | "manifold_edge_added" | "manifold_query" | "manifold_snapshot" | "connector_status_changed" | "connector_sync_started" | "connector_sync_complete" | "connector_sync_error" | "connector_document_indexed" | "graph_entity_upserted" | "graph_relationship_added" | "graph_traversal_complete" | "intent_signal_emitted" | "oscillator_phase_updated" | "oscillator_suggestion_generated" | "journey_note_created" | "journey_note_deleted" | "journey_edge_created" | "journey_cluster_created" | "journey_replay_entered" | "journey_replay_exited" | "journey_spatial_navigate" | "journey_completed" | "boundary_crossed" | "boundary_sealed" | "convergence_declared" | "convergence_lost" | "crystallization_declared" | "crystallization_melted" | "chat_message_sent" | "chat_message_received" | "chat_error" | "coherence_gate_accepted" | "coherence_gate_rejected" | "manifold_geodesic_computed" | "manifold_distance_measured" | "sematon_created" | "sematon_witnessed" | "sematon_folded" | "sematon_realized" | "sematon_expired" | "voice_identity_encoded" | "voice_speaking_started" | "voice_speaking_completed" | "voice_chunk_scheduled" | "voice_coherence_mapped";
 /**
  * Layer-aware signal for AXON cross-layer communication
  */
@@ -1340,6 +1348,326 @@ interface PlatformConfig {
     audio?: AudioSourceConfig;
 }
 
+/**
+ * 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
+ */
+/**
+ * Payload kind classification for sematons.
+ * Determines how the payload is interpreted across layers.
+ */
+type SematonKind = "signal" | "context" | "fractal" | "witness" | "combinator" | "interaction" | "custom";
+/**
+ * Convergence witness snapshot embedded in a sematon.
+ * Minimal subset of ConvergenceWitness for portability.
+ */
+interface SematonWitness {
+    /** Kuramoto order parameter R in [0, 1] */
+    R: number;
+    /** Shannon entropy of activation distribution */
+    activationEntropy: number;
+    /** Whether convergence criteria are met */
+    converged: boolean;
+    /** Step at which this witness was taken */
+    step: number;
+}
+/**
+ * The Sematon — smallest meaning-bearing unit with operational consequence.
+ *
+ * Generic over T (the payload type):
+ *   T = Signal payload at signal kind
+ *   T = ContextNode metadata at context kind
+ *   T = FractalSnapshot at fractal kind
+ *   T = arbitrary at custom kind
+ */
+interface Sematon<T = unknown> {
+    /** Unique identifier */
+    readonly id: string;
+    /** Payload kind classification */
+    readonly kind: SematonKind;
+    /** The meaning-bearing payload */
+    readonly payload: T;
+    /** Convergence witness at creation time */
+    readonly witness: SematonWitness;
+    /** p-adic address for hierarchical locality */
+    readonly padicAddress: string;
+    /** Shannon entropy of payload (bits) */
+    readonly entropy: number;
+    /** Semantic density (bits per token) */
+    readonly density: number;
+    /** The resistance to constructive transformation: H / (ρ * R) */
+    readonly impedance: number;
+    /** Deterministic content hash (FNV-1a) */
+    readonly shapeHash: string;
+    /**
+     * Constructor flag: can this sematon participate in further transformations?
+     * True iff: witness has converged AND entropy is finite AND payload is non-empty.
+     * This is the Deutsch-Marletto invariant.
+     */
+    readonly constructive: boolean;
+    /** Creation timestamp */
+    readonly createdAt: number;
+    /** Source layer or surface that produced this sematon */
+    readonly source: string;
+}
+/**
+ * Folded (serializable) representation of a Sematon.
+ * Suitable for JSON serialization, mesh relay, or persistence.
+ */
+interface FoldedSematon {
+    id: string;
+    kind: SematonKind;
+    payload: string;
+    witness: SematonWitness;
+    padicAddress: string;
+    entropy: number;
+    density: number;
+    impedance: number;
+    shapeHash: string;
+    constructive: boolean;
+    createdAt: number;
+    source: string;
+}
+interface SematonConfig<T> {
+    kind: SematonKind;
+    payload: T;
+    witness: SematonWitness;
+    padicAddress?: string;
+    source?: string;
+}
+/**
+ * Create a new Sematon from configuration.
+ */
+declare function createSematon<T>(config: SematonConfig<T>): Sematon<T>;
+/**
+ * Get the Shannon entropy of a sematon's payload.
+ */
+declare function sematonEntropy<T>(sematon: Sematon<T>): number;
+/**
+ * Get the semantic density of a sematon.
+ */
+declare function sematonDensity<T>(sematon: Sematon<T>): number;
+/**
+ * Check if a sematon can participate in further transformations.
+ * This is the Deutsch-Marletto constructor invariant.
+ */
+declare function isRealizable<T>(sematon: Sematon<T>): boolean;
+/**
+ * Compute distance between two sematons using payload cosine similarity
+ * weighted by witness R proximity.
+ *
+ * Distance in [0, 1] where 0 = identical, 1 = maximally different.
+ */
+declare function sematonDistance<T>(a: Sematon<T>, b: Sematon<T>): number;
+/**
+ * Fold a Sematon into a JSON-serializable representation.
+ * HVM γ (construct) — compress for handoff, persistence, or relay.
+ */
+declare function foldSematon<T>(sematon: Sematon<T>): FoldedSematon;
+/**
+ * Unfold a serialized representation back into a Sematon.
+ * HVM δ (duplicate) — expand from handoff, persistence, or relay.
+ */
+declare function unfoldSematon<T>(folded: FoldedSematon): Sematon<T>;
+
+/**
+ * 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
+ */
+
+/**
+ * Execution receipt — cryptographic proof that the workflow executed.
+ * This is a Sematon under the hood, but developers see "receipt".
+ */
+type ExecutionReceipt = Sematon<TerminalRunResult>;
+/**
+ * A single execution step in the workflow trace.
+ */
+interface Step {
+    /** Which agent ran this step */
+    agent: string;
+    /** Step output data */
+    output: unknown;
+    /** Step index in the execution sequence */
+    index: number;
+}
+/**
+ * Per-agent performance report.
+ */
+interface AgentReport {
+    /** Agent node ID */
+    id: string;
+    /** Agent output data */
+    output: unknown;
+}
+/**
+ * The developer-facing result from Terminal.run().
+ *
+ * Provides direct access to outputs, coherence score, and execution proof
+ * without requiring knowledge of Sematons or Kuramoto dynamics.
+ */
+interface TerminalResult {
+    /** The text output from the final agent in the workflow */
+    text: string;
+    /** Coherence score: 0-1 measure of agent alignment quality */
+    coherence: number;
+    /** Execution receipt — proof the workflow ran correctly */
+    receipt: ExecutionReceipt;
+    /** Ordered execution steps */
+    steps: Step[];
+    /** Per-agent performance reports */
+    agents: AgentReport[];
+    /** Total execution time in milliseconds */
+    duration: number;
+}
+
+/**
+ * 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
+ */
+
+/**
+ * Agent definition within a terminal workflow.
+ */
+interface TerminalAgent {
+    /** Role name for the agent (e.g. "researcher", "writer", "reviewer") */
+    role: string;
+    /** Optional capability declarations for this agent */
+    capabilities?: string[];
+}
+/**
+ * Coherence configuration for convergence-aware execution.
+ */
+interface TerminalCoherenceConfig {
+    /** Kuramoto R threshold for constructive sematon flag (default: 0.6) */
+    threshold?: number;
+    /** Ground truth strings for coherence grounding */
+    groundTruth?: string[];
+}
+/**
+ * Developer-facing configuration for Terminal.create().
+ *
+ * Named TerminalCreateConfig to avoid collision with the internal
+ * TerminalConfig from core/terminal.ts.
+ */
+interface TerminalCreateConfig {
+    /** Agent definitions -- each becomes a provider.chat.v1 node */
+    agents: TerminalAgent[];
+    /** The task prompt driving the workflow */
+    task: string;
+    /** Coherence / convergence settings */
+    coherence?: TerminalCoherenceConfig;
+    /** LLM provider identifier (e.g. "openrouter", "anthropic") */
+    provider?: string;
+    /** Model identifier (e.g. "claude-sonnet-4-20250514") */
+    model?: string;
+}
+/**
+ * Developer-facing configuration — the simplified public interface.
+ * Extends TerminalCreateConfig with orchestration and verification options.
+ */
+interface TerminalConfig extends TerminalCreateConfig {
+    /** Orchestration strategy for multi-agent execution */
+    orchestration?: "sequential" | "parallel" | "society" | "consensus";
+    /** Enable DRM execution verification (generates execution receipts) */
+    verify?: boolean;
+    /** Enable streaming mode */
+    stream?: boolean;
+}
+/**
+ * Result payload wrapped inside a Sematon after Terminal.run().
+ */
+interface TerminalRunResult {
+    /** Collected outputs from all agent nodes, keyed by node ID */
+    outputs: Record<string, unknown>;
+    /** Total execution duration in milliseconds */
+    duration: number;
+}
+/**
+ * Terminal -- the developer-facing orchestration API.
+ *
+ * Usage:
+ * ```ts
+ * const t = await Terminal.create({
+ *   agents: [
+ *     { role: "researcher" },
+ *     { role: "writer", capabilities: ["markdown"] },
+ *   ],
+ *   task: "Write a technical summary of quantum error correction",
+ *   coherence: { threshold: 0.7 },
+ *   provider: "openrouter",
+ *   model: "anthropic/claude-sonnet-4-20250514",
+ * });
+ *
+ * const result = await t.run();
+ * console.log(result.payload.outputs);
+ * ```
+ */
+declare class Terminal {
+    /** Unique terminal identifier */
+    readonly id: string;
+    private readonly config;
+    private readonly manifest;
+    private constructor();
+    /**
+     * 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 create(config: TerminalCreateConfig): Promise<Terminal>;
+    /**
+     * 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.
+     */
+    run(): Promise<Sematon<TerminalRunResult>>;
+    /**
+     * Static convenience: create and run a terminal in one call.
+     * Returns a developer-friendly TerminalResult instead of a raw Sematon.
+     */
+    static run(config: TerminalConfig): Promise<TerminalResult>;
+    /**
+     * 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 chain(prev: Sematon<unknown>, config: Partial<TerminalCreateConfig>): Promise<Sematon<TerminalRunResult>>;
+}
+
 /**
  * Terminal SDK — High-level Terminal management
  *
@@ -1359,9 +1687,13 @@ type terminal_PlatformIdentity = PlatformIdentity;
 type terminal_PlatformTheme = PlatformTheme;
 type terminal_SurfaceId = SurfaceId;
 type terminal_TaskStatus = TaskStatus;
+type terminal_Terminal = Terminal;
+declare const terminal_Terminal: typeof Terminal;
+type terminal_TerminalCreateConfig = TerminalCreateConfig;
+type terminal_TerminalRunResult = TerminalRunResult;
 declare const terminal_createInteractionWithEvents: typeof createInteractionWithEvents;
 declare namespace terminal {
-  export { type terminal_Interaction as Interaction, type terminal_InteractionStatus as InteractionStatus, type terminal_InteractionType as InteractionType, type terminal_LayerLevel as LayerLevel, type terminal_PlatformConfig as PlatformConfig, type terminal_PlatformIdentity as PlatformIdentity, type terminal_PlatformTheme as PlatformTheme, type terminal_SurfaceId as SurfaceId, type terminal_TaskStatus as TaskStatus, createInteractionWithEvents as createInteraction, terminal_createInteractionWithEvents as createInteractionWithEvents };
+  export { type terminal_Interaction as Interaction, type terminal_InteractionStatus as InteractionStatus, type terminal_InteractionType as InteractionType, type terminal_LayerLevel as LayerLevel, type terminal_PlatformConfig as PlatformConfig, type terminal_PlatformIdentity as PlatformIdentity, type terminal_PlatformTheme as PlatformTheme, type terminal_SurfaceId as SurfaceId, type terminal_TaskStatus as TaskStatus, terminal_Terminal as Terminal, type terminal_TerminalCreateConfig as TerminalCreateConfig, type terminal_TerminalRunResult as TerminalRunResult, createInteractionWithEvents as createInteraction, terminal_createInteractionWithEvents as createInteractionWithEvents };
 }
 
 /**
@@ -1958,143 +2290,6 @@ declare function checkCompatibility(shapeA: TypeShape, shapeB: TypeShape): numbe
  */
 declare function canEmbed(source: TypeShape, target: TypeShape): boolean;
 
-/**
- * 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
- */
-/**
- * Payload kind classification for sematons.
- * Determines how the payload is interpreted across layers.
- */
-type SematonKind = "signal" | "context" | "fractal" | "witness" | "combinator" | "interaction" | "custom";
-/**
- * Convergence witness snapshot embedded in a sematon.
- * Minimal subset of ConvergenceWitness for portability.
- */
-interface SematonWitness {
-    /** Kuramoto order parameter R in [0, 1] */
-    R: number;
-    /** Shannon entropy of activation distribution */
-    activationEntropy: number;
-    /** Whether convergence criteria are met */
-    converged: boolean;
-    /** Step at which this witness was taken */
-    step: number;
-}
-/**
- * The Sematon — smallest meaning-bearing unit with operational consequence.
- *
- * Generic over T (the payload type):
- *   T = Signal payload at signal kind
- *   T = ContextNode metadata at context kind
- *   T = FractalSnapshot at fractal kind
- *   T = arbitrary at custom kind
- */
-interface Sematon<T = unknown> {
-    /** Unique identifier */
-    readonly id: string;
-    /** Payload kind classification */
-    readonly kind: SematonKind;
-    /** The meaning-bearing payload */
-    readonly payload: T;
-    /** Convergence witness at creation time */
-    readonly witness: SematonWitness;
-    /** p-adic address for hierarchical locality */
-    readonly padicAddress: string;
-    /** Shannon entropy of payload (bits) */
-    readonly entropy: number;
-    /** Semantic density (bits per token) */
-    readonly density: number;
-    /** The resistance to constructive transformation: H / (ρ * R) */
-    readonly impedance: number;
-    /** Deterministic content hash (FNV-1a) */
-    readonly shapeHash: string;
-    /**
-     * Constructor flag: can this sematon participate in further transformations?
-     * True iff: witness has converged AND entropy is finite AND payload is non-empty.
-     * This is the Deutsch-Marletto invariant.
-     */
-    readonly constructive: boolean;
-    /** Creation timestamp */
-    readonly createdAt: number;
-    /** Source layer or surface that produced this sematon */
-    readonly source: string;
-}
-/**
- * Folded (serializable) representation of a Sematon.
- * Suitable for JSON serialization, mesh relay, or persistence.
- */
-interface FoldedSematon {
-    id: string;
-    kind: SematonKind;
-    payload: string;
-    witness: SematonWitness;
-    padicAddress: string;
-    entropy: number;
-    density: number;
-    impedance: number;
-    shapeHash: string;
-    constructive: boolean;
-    createdAt: number;
-    source: string;
-}
-interface SematonConfig<T> {
-    kind: SematonKind;
-    payload: T;
-    witness: SematonWitness;
-    padicAddress?: string;
-    source?: string;
-}
-/**
- * Create a new Sematon from configuration.
- */
-declare function createSematon<T>(config: SematonConfig<T>): Sematon<T>;
-/**
- * Get the Shannon entropy of a sematon's payload.
- */
-declare function sematonEntropy<T>(sematon: Sematon<T>): number;
-/**
- * Get the semantic density of a sematon.
- */
-declare function sematonDensity<T>(sematon: Sematon<T>): number;
-/**
- * Check if a sematon can participate in further transformations.
- * This is the Deutsch-Marletto constructor invariant.
- */
-declare function isRealizable<T>(sematon: Sematon<T>): boolean;
-/**
- * Compute distance between two sematons using payload cosine similarity
- * weighted by witness R proximity.
- *
- * Distance in [0, 1] where 0 = identical, 1 = maximally different.
- */
-declare function sematonDistance<T>(a: Sematon<T>, b: Sematon<T>): number;
-/**
- * Fold a Sematon into a JSON-serializable representation.
- * HVM γ (construct) — compress for handoff, persistence, or relay.
- */
-declare function foldSematon<T>(sematon: Sematon<T>): FoldedSematon;
-/**
- * Unfold a serialized representation back into a Sematon.
- * HVM δ (duplicate) — expand from handoff, persistence, or relay.
- */
-declare function unfoldSematon<T>(folded: FoldedSematon): Sematon<T>;
-
 /**
  * L0 Realizability Trace — Constructor Proof Runtime
  *
@@ -2556,8 +2751,91 @@ declare namespace protocol {
   export { type protocol_AgentBus as AgentBus, type protocol_AgentMessage as AgentMessage, type protocol_AgentMessageType as AgentMessageType, type protocol_DelegationChain as DelegationChain, type protocol_DelegationEdge as DelegationEdge, type protocol_DelegationEdgeInput as DelegationEdgeInput, type protocol_DelegationEndpoint as DelegationEndpoint, protocol_createAgentBus as createAgentBus, protocol_createDelegationChain as createDelegationChain, protocol_createDelegationEdge as createDelegationEdge, protocol_isValidSurfaceId as isValidSurfaceId };
 }
 
-type NodePolicy = NodePolicy$1;
-type StackPolicies = StackPolicies$1;
+/**
+ * Trigger Type System
+ *
+ * Canonical discriminated-union types for all stack trigger mechanisms.
+ * A trigger defines *when* and *how* a stack run is initiated.
+ *
+ * Usage:
+ *   - StackManifestV0.triggerConfig holds the declared trigger for a stack.
+ *   - TriggerContext is injected into every run so downstream nodes can inspect
+ *     how the execution was started.
+ *   - NodeSecretRef lets webhook triggers reference vault-backed HMAC keys
+ *     through the provider control plane instead of inline secrets.
+ *
+ * @module machines/core/types/trigger
+ */
+
+/** Run the stack on a fixed time interval. */
+interface IntervalTriggerConfig {
+    kind: "interval";
+    /** Seconds between runs. Minimum enforced at 1. */
+    everySeconds: number;
+}
+/**
+ * Run the stack on a standard 5-field cron schedule.
+ *
+ * The expression follows the POSIX/Vixie-cron syntax:
+ *   `minute hour day-of-month month day-of-week`
+ *
+ * @example "0 9 * * 1-5"   // weekdays at 09:00 UTC
+ * @example "* /15 * * * *" // every 15 minutes (non-standard extended form)
+ */
+interface CronTriggerConfig {
+    kind: "cron";
+    /** Standard 5-field cron expression. */
+    expression: string;
+    /** IANA timezone name (default: "UTC"). */
+    timezone?: string;
+}
+/**
+ * Run the stack when an inbound HTTP webhook is received.
+ *
+ * Secret verification:
+ *   - Use `secretRef` for production — the key stays server-side.
+ *   - Use the inline `secret` field only for dev/test environments.
+ */
+interface WebhookTriggerConfig {
+    kind: "webhook";
+    /** Relative path segment appended to the stack webhook base URL. */
+    path?: string;
+    /** Accepted HTTP method (default: "POST"). */
+    method?: "GET" | "POST" | "PUT" | "PATCH";
+    /**
+     * Inline HMAC signing secret.
+     * Production deployments should prefer `secretRef` to keep the value
+     * server-side in the Supabase vault.
+     */
+    secret?: string;
+    /** Vault-backed secret reference for the HMAC signing key. */
+    secretRef?: NodeSecretRef;
+}
+/**
+ * Run the stack when a matching AXON event is published on the given topic.
+ *
+ * AXON cross-layer events are published via `system.signal.emit.v1` nodes or
+ * directly through the AXON kernel. The filter is applied against the event
+ * payload before dispatching.
+ */
+interface EventTriggerConfig {
+    kind: "event";
+    /** AXON event topic string (e.g. "brain.index.complete", "user.action.*"). */
+    topic: string;
+    /**
+     * Optional shallow equality filter applied to the event payload.
+     * Only events whose payload contains all key-value pairs in this map
+     * will dispatch the stack run.
+     */
+    filter?: Record<string, unknown>;
+}
+/** Run the stack only when explicitly requested via the API or UI. */
+interface ManualTriggerConfig {
+    kind: "manual";
+}
+/** Discriminated union over all trigger kinds. */
+type TriggerConfig = IntervalTriggerConfig | CronTriggerConfig | WebhookTriggerConfig | EventTriggerConfig | ManualTriggerConfig;
+
 /**
  * Runtime tier for node execution.
  *
@@ -2573,6 +2851,29 @@ type StackPolicies = StackPolicies$1;
  * const tier: RuntimeTier = "worker";
  */
 type RuntimeTier = "worker" | "container-lite" | "webcontainer" | "edge" | "wasm-hvm" | "stack";
+/**
+ * Secret reference for node execution.
+ *
+ * Links a secret from the vault into node environment.
+ *
+ * @example
+ * const secret: NodeSecretRef = {
+ *   name: "api_key",
+ *   scope: "stack",
+ *   env: "OPENAI_API_KEY",
+ *   required: true
+ * };
+ */
+interface NodeSecretRef {
+    /** Secret identifier in vault */
+    name: string;
+    /** Resolution scope: node-local or stack-wide */
+    scope: "node" | "stack";
+    /** Environment variable name (defaults to name if omitted) */
+    env?: string;
+    /** Whether secret must exist (default: false) */
+    required?: boolean;
+}
 /**
  * Base manifest fields shared by nodes and stacks.
  *
@@ -2628,6 +2929,24 @@ interface StackRuntimes {
     /** Per-node runtime tier overrides (nodeId -> tiers) */
     overrides?: Record<string, RuntimeTier[]>;
 }
+/**
+ * Reference from a stack node to a brain connector instance.
+ *
+ * Binds the connector's extracted data chunks into this node's input,
+ * allowing RAG / knowledge-graph results to flow into the execution graph.
+ */
+interface ConnectorRef {
+    /** ID of the ConnectorInstance in the brain pipeline. */
+    connectorId: string;
+    /** ID of the ConnectorDefinition (catalog entry). */
+    definitionId: string;
+    /**
+     * Optional shallow filter applied to DataChunks from this connector.
+     * Only chunks whose metadata contains all key-value pairs in this map
+     * will be included.
+     */
+    dataChunkFilter?: Record<string, unknown>;
+}
 /**
  * Node configuration within a stack.
  *
@@ -2655,6 +2974,11 @@ interface StackNodeConfig {
     policies?: NodePolicy;
     /** Secret names from stack.secrets */
     secrets?: string[];
+    /**
+     * Reference to a brain connector whose data chunks feed this node.
+     * The orchestrator resolves this at run-time before invoking the node.
+     */
+    connectorRef?: ConnectorRef;
 }
 /**
  * Directed edge connecting two nodes in the stack DAG.
@@ -2715,6 +3039,14 @@ interface StackManifestV0 extends BaseManifestV0 {
     runtimes?: StackRuntimes;
     /** Provenance layer (L0 or L1) */
     layer?: ManifestLayer;
+    /**
+     * Declared trigger for this stack.
+     *
+     * Defines when and how the stack is automatically started.
+     * The orchestrator and scheduler use this at registration time.
+     * When absent, the stack is manual-only.
+     */
+    triggerConfig?: TriggerConfig;
 }
 
 /**
@@ -3024,6 +3356,171 @@ declare namespace skill {
   export { skill_SKILL_CATEGORIES as SKILL_CATEGORIES, skill_SKILL_RANKS as SKILL_RANKS, skill_SKILL_RUN_STATUSES as SKILL_RUN_STATUSES, skill_SKILL_SIGNAL_CODES as SKILL_SIGNAL_CODES, skill_SKILL_TIERS as SKILL_TIERS, type skill_SkillAgent as SkillAgent, type skill_SkillCapabilities as SkillCapabilities, type skill_SkillCategory as SkillCategory, type skill_SkillEventType as SkillEventType, type skill_SkillHealth as SkillHealth, type skill_SkillManifest as SkillManifest, type skill_SkillMeta as SkillMeta, type skill_SkillRank as SkillRank, type skill_SkillRunStatus as SkillRunStatus, type skill_SkillSignalCode as SkillSignalCode, type skill_SkillTier as SkillTier, skill_ensureSkillsRegistered as ensureSkillsRegistered, skill_getAllSkills as getAllSkills, skill_getSkill as getSkill, skill_getSkillCount as getSkillCount, skill_getSkillsByCategory as getSkillsByCategory, skill_registerSkill as registerSkill };
 }
 
+/**
+ * Manifold Annihilation API
+ *
+ * Converges an Intent Manifold and a Context Manifold via py2bend compilation
+ * and HVM reduction where available.
+ */
+
+interface AnnihilationOptions {
+    maxSteps?: number;
+    convergenceThreshold?: number;
+    gravity?: number;
+}
+interface ManifoldReductionMetrics {
+    compiled: boolean;
+    reduced: boolean;
+    strategy: string;
+    runtime: "wasm-hvm" | "compile-only";
+    durationMs: number;
+    warnings: string[];
+    errors: string[];
+    logitBias: Record<string, number>;
+}
+interface ManifoldSematonPayload {
+    result: string;
+    steps: number;
+    intent: string;
+    contextSnapshot: string;
+    bendCode?: string;
+    reduction: ManifoldReductionMetrics;
+}
+declare function annihilate(intent: string, context?: string, options?: AnnihilationOptions): Promise<Sematon<ManifoldSematonPayload>>;
+declare const manifold: {
+    annihilate: typeof annihilate;
+};
+
+type manifold$1_AnnihilationOptions = AnnihilationOptions;
+type manifold$1_ManifoldReductionMetrics = ManifoldReductionMetrics;
+type manifold$1_ManifoldSematonPayload = ManifoldSematonPayload;
+declare const manifold$1_annihilate: typeof annihilate;
+declare const manifold$1_manifold: typeof manifold;
+declare namespace manifold$1 {
+  export { type manifold$1_AnnihilationOptions as AnnihilationOptions, type manifold$1_ManifoldReductionMetrics as ManifoldReductionMetrics, type manifold$1_ManifoldSematonPayload as ManifoldSematonPayload, manifold$1_annihilate as annihilate, manifold$1_manifold as manifold };
+}
+
+/**
+ * StateMirror - Total Context Encoding
+ *
+ * Continuously encodes the entire application, UI, and cognitive state into a
+ * shared representational manifold. This provides the ObserverKernel with literal
+ * environmental awareness, preventing "blind" execution.
+ */
+
+interface SystemStateSnapshot {
+    /** The current URL or deep-link active in the browser */
+    activeUrl: string;
+    /** The specific UI component currently focused or under cursor */
+    focusedComponent: string | null;
+    /** The last N intents expressed by the user */
+    recentIntents: string[];
+    /** Latest L1 AudioKernel spectral entropy [0,1] */
+    audioEntropy: number;
+    /** Whether the NanoFold 3D surface is actively rendering */
+    nanoFoldActive: boolean;
+    /** Current System Coherence R [0,1] */
+    coherenceR: number;
+    /** Current active project or workspace ID */
+    activeProject: string | null;
+}
+declare class StateMirror {
+    private state$;
+    private bridgeOwnerId;
+    private bridgeOrder;
+    constructor();
+    private initSubscriptions;
+    /** Gets the observable stream of state changes */
+    get stream$(): Observable<SystemStateSnapshot>;
+    /** Gets a synchronous snapshot of the current state */
+    get snapshot(): SystemStateSnapshot;
+    claimBridge(bridgeId: string): void;
+    releaseBridge(bridgeId: string): void;
+    /** Partially updates the mirror state */
+    update(partial: Partial<SystemStateSnapshot>): void;
+    /**
+     * Bridge-scoped update to prevent multiple mounted app shells from racing
+     * against the same singleton mirror.
+     */
+    updateFromBridge(bridgeId: string, partial: Partial<SystemStateSnapshot>): void;
+    /**
+     * Flattens the continuous state into a dense text manifold.
+     * This is passed to the ObserverKernel to ground it in the immediate UI/UX reality.
+     */
+    encodeToManifold(): string;
+}
+
+/**
+ * ObserverField & Neurons
+ *
+ * Formalization of the Terminals abstraction:
+ * The MicroLM is not a calculator. It is a continuous ObserverKernel.
+ * Skills are not apps. They are geometric Neurons equipped by the Observer.
+ *
+ * @module sdk/observer
+ */
+
+/**
+ * A hot-swappable structural template that the Observer equips to resolve intent.
+ */
+interface Neuron {
+    id: string;
+    kind: "skill" | "isomorphism" | "prompt-sensor" | "py2bend-template";
+    payload: unknown;
+    gravity: number;
+}
+interface ObserverConfig {
+    id: string;
+    heartbeatHz?: number;
+    stateMirror?: StateMirror;
+}
+/**
+ * ObserverKernel - Continuous Local Witness
+ *
+ * An active, unbroken presence that maintains a heartbeat,
+ * observes the StateMirror, and equips Neurons (skills) dynamically.
+ */
+declare class ObserverKernel {
+    readonly id: string;
+    readonly heartbeatHz: number;
+    private mirror;
+    private activeNeurons;
+    private coherenceR$;
+    private pulseTimer;
+    constructor(config: ObserverConfig);
+    get coherence(): number;
+    get isRunning(): boolean;
+    /** Starts the continuous heartbeat */
+    start(): void;
+    /** Stops the heartbeat */
+    stop(): void;
+    /** The continuous observation loop */
+    private pulse;
+    /** Equips a new geometric constraint (Neuron) onto the observer */
+    equipNeuron(neuron: Neuron): void;
+    /** Unequips a Neuron */
+    unequipNeuron(neuronId: string): void;
+    /** Replace the active neuron field in one operation. */
+    syncNeurons(neurons: Neuron[]): void;
+    /**
+     * The core execution path:
+     * Flattens the active Neurons + StateMirror context, then drops them into the Annihilator.
+     */
+    resolve(intent: string): Promise<Sematon<any>>;
+}
+declare function disposeObserverKernel(id: string): void;
+declare function getObserverKernel(id: string, config?: Omit<ObserverConfig, "id">): ObserverKernel;
+
+type observer_Neuron = Neuron;
+type observer_ObserverConfig = ObserverConfig;
+type observer_ObserverKernel = ObserverKernel;
+declare const observer_ObserverKernel: typeof ObserverKernel;
+declare const observer_disposeObserverKernel: typeof disposeObserverKernel;
+declare const observer_getObserverKernel: typeof getObserverKernel;
+declare namespace observer {
+  export { type observer_Neuron as Neuron, type observer_ObserverConfig as ObserverConfig, observer_ObserverKernel as ObserverKernel, observer_disposeObserverKernel as disposeObserverKernel, observer_getObserverKernel as getObserverKernel };
+}
+
 /**
  * MCP Sampling Support (MCP Specification 2025-11-25)
  *
@@ -3503,6 +4000,6 @@ declare function createAxonBus(): InMemoryAxonBus;
  *
  * Curated package facade for the npm package.
  */
-declare const SDK_VERSION = "1.0.0-rc.1";
+declare const SDK_VERSION = "1.0.0";
 
-export { type AxonMessage, type AxonMessageBus, brain as Brain, core as Core, InMemoryAxonBus, index as L0, mesh as Mesh, protocol as Protocol, ProtocolBridge, SDK_VERSION, skill as Skill, terminal as Terminal, createAxonBus, createProtocolBridge };
+export { type AxonMessage, type AxonMessageBus, brain as Brain, core as Core, InMemoryAxonBus, index as L0, manifold$1 as Manifold, mesh as Mesh, observer as Observer, protocol as Protocol, ProtocolBridge, SDK_VERSION, skill as Skill, terminal as Terminal, createAxonBus, createProtocolBridge };