@synqel/sdk 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Synqel Protocol Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# @synqel/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Semantic runtime for the **Synqel Protocol** — describe entities, actions, workflows, and policies so agents reason about your **UX**, not raw DOM.
+
+Synqel complements **[Model Context Protocol](https://modelcontextprotocol.io/)**: MCP connects hosts and tools; Synqel defines what your application **means** and **allows**. Use sibling package **`@synqel/mcp`** for stdio MCP servers.
+
+## Install
+
+```bash
+bun add @synqel/sdk zod
+```
+
+Peers: **`zod`** required; **`react`** optional for `@synqel/sdk/react`.
+
+Runtime deps bundled with the SDK: **`zod-to-json-schema`** (action inputs → portable JSON Schema for snapshots/agents).
+
+## Core usage
+
+```typescript
+import {
+  registerEntity,
+  registerAction,
+  bindAction,
+  getSemanticRegistry,
+  serializeSnapshotEnvelope,
+} from "@synqel/sdk";
+import { z } from "zod";
+
+registerEntity({
+  id: "sku_42",
+  type: "product",
+  metadata: { price: 99 },
+});
+
+registerAction({
+  id: "add_to_cart",
+  intent: "mutation",
+  inputSchema: z.object({ sku: z.string(), qty: z.number() }),
+});
+
+bindAction("add_to_cart", async (_ctx, input) => {
+  const payload = input as { sku: string; qty: number };
+  return { lineId: `${payload.sku}:${payload.qty}` };
+});
+
+await getSemanticRegistry().executeAction(
+  "add_to_cart",
+  { actor: "human", roles: ["customer"] },
+  { sku: "sku_42", qty: 1 },
+);
+
+console.log(serializeSnapshotEnvelope(getSemanticRegistry()));
+```
+
+## HTTP snapshot route
+
+```typescript
+import { synqelSnapshotJsonResponse, getSemanticRegistry } from "@synqel/sdk";
+
+export function GET() {
+  return synqelSnapshotJsonResponse(getSemanticRegistry());
+}
+```
+
+## React
+
+```typescript
+import { useSemanticRuntime } from "@synqel/sdk/react";
+
+function CartButton() {
+  const { executeAction } = useSemanticRuntime();
+
+  return (
+    <button
+      type="button"
+      onClick={() =>
+        void executeAction(
+          "add_to_cart",
+          { actor: "human", roles: ["customer"] },
+          { sku: "sku_42", qty: 1 },
+        )
+      }
+    >
+      Add
+    </button>
+  );
+}
+```
+
+## Docs
+
+Spec + guides live in the main repo under `docs/` and on [synqel-protocol.vercel.app/docs](https://synqel-protocol.vercel.app/docs).
+
+## License
+
+MIT

package/dist/event-taxonomy.d.ts

@@ -0,0 +1,7 @@
+export declare const EVENT_CATEGORIES: readonly ["semantic.entity", "semantic.action", "semantic.workflow", "semantic.session", "semantic.intent", "semantic.policy"];
+export type EventCategory = (typeof EVENT_CATEGORIES)[number];
+export declare const EVENT_KINDS: readonly ["semantic.entity.registered", "semantic.entity.queried", "semantic.entity.updated", "semantic.entity.removed", "semantic.action.attempt", "semantic.action.result", "semantic.action.executed", "semantic.workflow.started", "semantic.workflow.step", "semantic.workflow.completed", "semantic.workflow.failed", "semantic.session.started", "semantic.session.ended", "semantic.session.heartbeat", "semantic.intent.expressed", "semantic.intent.resolved", "semantic.intent.abandoned", "semantic.intent.failed", "semantic.policy.evaluated", "semantic.policy.denied"];
+export type EventKind = (typeof EVENT_KINDS)[number];
+export declare function getCategoryFromKind(kind: EventKind): EventCategory;
+export declare function isValidEventKind(kind: string): kind is EventKind;
+//# sourceMappingURL=event-taxonomy.d.ts.map

package/dist/event-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-taxonomy.d.ts","sourceRoot":"","sources":["../src/event-taxonomy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,gIAOnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,WAAW,wjBAqBd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa,CAGlE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAEhE"}

package/dist/event-taxonomy.js

@@ -0,0 +1,38 @@
+export const EVENT_CATEGORIES = [
+    "semantic.entity",
+    "semantic.action",
+    "semantic.workflow",
+    "semantic.session",
+    "semantic.intent",
+    "semantic.policy",
+];
+export const EVENT_KINDS = [
+    "semantic.entity.registered",
+    "semantic.entity.queried",
+    "semantic.entity.updated",
+    "semantic.entity.removed",
+    "semantic.action.attempt",
+    "semantic.action.result",
+    "semantic.action.executed",
+    "semantic.workflow.started",
+    "semantic.workflow.step",
+    "semantic.workflow.completed",
+    "semantic.workflow.failed",
+    "semantic.session.started",
+    "semantic.session.ended",
+    "semantic.session.heartbeat",
+    "semantic.intent.expressed",
+    "semantic.intent.resolved",
+    "semantic.intent.abandoned",
+    "semantic.intent.failed",
+    "semantic.policy.evaluated",
+    "semantic.policy.denied",
+];
+export function getCategoryFromKind(kind) {
+    const parts = kind.split(".");
+    return `${parts[0]}.${parts[1]}`;
+}
+export function isValidEventKind(kind) {
+    return EVENT_KINDS.includes(kind);
+}
+//# sourceMappingURL=event-taxonomy.js.map

package/dist/event-taxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-taxonomy.js","sourceRoot":"","sources":["../src/event-taxonomy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,iBAAiB;IACjB,iBAAiB;CACT,CAAC;AAIX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,4BAA4B;IAC5B,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,wBAAwB;IACxB,0BAA0B;IAC1B,2BAA2B;IAC3B,wBAAwB;IACxB,6BAA6B;IAC7B,0BAA0B;IAC1B,0BAA0B;IAC1B,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,0BAA0B;IAC1B,2BAA2B;IAC3B,wBAAwB;IACxB,2BAA2B;IAC3B,wBAAwB;CAChB,CAAC;AAIX,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAmB,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAQ,WAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export type { SemanticEntity, SemanticAction, RegisterActionInput, CapabilityProfile, WorkflowDefinition, PolicyContext, PolicyDecision, PolicyRule, RuntimeEvent, ActionExecutionContext, SemanticActionHandler, ExecuteActionOptions, ExecuteActionResult, } from "./types.js";
+export { entitySchema, actionSchema, capabilitySchema, workflowSchema, } from "./types.js";
+export { SemanticEventBus, SemanticRegistry, getSemanticRegistry, resetSemanticRegistryForTests, } from "./registry.js";
+export type { RegistrySnapshot } from "./registry.js";
+export type { SynqelSnapshotEnvelope } from "./snapshot.js";
+export { createSnapshotEnvelope, serializeSnapshotEnvelope, synqelSnapshotJsonResponse, } from "./snapshot.js";
+export { evaluatePolicy } from "./policy.js";
+export { EVENT_CATEGORIES, EVENT_KINDS, getCategoryFromKind, isValidEventKind, } from "./event-taxonomy.js";
+export type { EventCategory, EventKind } from "./event-taxonomy.js";
+import type { SemanticEntity, SemanticAction, CapabilityProfile, WorkflowDefinition, RegisterActionInput, PolicyContext, SemanticActionHandler, ExecuteActionOptions, ExecuteActionResult } from "./types.js";
+export declare function registerEntity(input: Omit<SemanticEntity, "metadata"> & {
+    metadata?: Record<string, unknown>;
+}): SemanticEntity;
+export declare function registerAction(input: RegisterActionInput): SemanticAction;
+export declare function registerCapability(input: CapabilityProfile): CapabilityProfile;
+export declare function registerWorkflow(input: WorkflowDefinition): WorkflowDefinition;
+export declare function bindAction(actionId: string, handler: SemanticActionHandler): void;
+export declare function unbindAction(actionId: string): boolean;
+export declare function executeAction(actionId: string, context: PolicyContext, input?: unknown, options?: ExecuteActionOptions): Promise<ExecuteActionResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGpE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC/E,cAAc,CAEhB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAE9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAE9E;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAEjF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAE9B"}

package/dist/index.js

@@ -0,0 +1,28 @@
+export { entitySchema, actionSchema, capabilitySchema, workflowSchema, } from "./types.js";
+export { SemanticEventBus, SemanticRegistry, getSemanticRegistry, resetSemanticRegistryForTests, } from "./registry.js";
+export { createSnapshotEnvelope, serializeSnapshotEnvelope, synqelSnapshotJsonResponse, } from "./snapshot.js";
+export { evaluatePolicy } from "./policy.js";
+export { EVENT_CATEGORIES, EVENT_KINDS, getCategoryFromKind, isValidEventKind, } from "./event-taxonomy.js";
+import { getSemanticRegistry } from "./registry.js";
+export function registerEntity(input) {
+    return getSemanticRegistry().registerEntity(input);
+}
+export function registerAction(input) {
+    return getSemanticRegistry().registerAction(input);
+}
+export function registerCapability(input) {
+    return getSemanticRegistry().registerCapability(input);
+}
+export function registerWorkflow(input) {
+    return getSemanticRegistry().registerWorkflow(input);
+}
+export function bindAction(actionId, handler) {
+    getSemanticRegistry().bindAction(actionId, handler);
+}
+export function unbindAction(actionId) {
+    return getSemanticRegistry().unbindAction(actionId);
+}
+export function executeAction(actionId, context, input, options) {
+    return getSemanticRegistry().executeAction(actionId, context, input, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAapD,MAAM,UAAU,cAAc,CAC5B,KAAgF;IAEhF,OAAO,mBAAmB,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,OAAO,mBAAmB,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,OAAO,mBAAmB,EAAE,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAyB;IACxD,OAAO,mBAAmB,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,OAA8B;IACzE,mBAAmB,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,mBAAmB,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,OAAsB,EACtB,KAAe,EACf,OAA8B;IAE9B,OAAO,mBAAmB,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,3 @@
+import type { PolicyContext, PolicyDecision, PolicyRule, SemanticAction } from "./types.js";
+export declare function evaluatePolicy(ctx: PolicyContext, action: SemanticAction, rules?: PolicyRule[]): PolicyDecision;
+//# sourceMappingURL=policy.d.ts.map

package/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgB5F,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,cAAc,EACtB,KAAK,GAAE,UAAU,EAAO,GACvB,cAAc,CAWhB"}

package/dist/policy.js

@@ -0,0 +1,22 @@
+const defaultRule = (ctx, action) => {
+    if (ctx.actor === "agent" &&
+        action.intent === "mutation" &&
+        !ctx.roles.includes("admin")) {
+        return {
+            allowed: false,
+            reason: "Agents cannot execute mutation actions without the admin role.",
+        };
+    }
+    return null;
+};
+export function evaluatePolicy(ctx, action, rules = []) {
+    const allRules = [...rules, defaultRule];
+    for (const rule of allRules) {
+        const decision = rule(ctx, action);
+        if (decision && !decision.allowed) {
+            return decision;
+        }
+    }
+    return { allowed: true };
+}
+//# sourceMappingURL=policy.js.map

package/dist/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;IAC9C,IACE,GAAG,CAAC,KAAK,KAAK,OAAO;QACrB,MAAM,CAAC,MAAM,KAAK,UAAU;QAC5B,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC5B,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gEAAgE;SACzE,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,GAAkB,EAClB,MAAsB,EACtB,QAAsB,EAAE;IAExB,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC"}

package/dist/react.d.ts

@@ -0,0 +1,9 @@
+import type { RegistrySnapshot } from "./registry.js";
+import type { PolicyContext, RuntimeEvent, ExecuteActionOptions, ExecuteActionResult } from "./types.js";
+export declare function useSemanticRuntime(): {
+    registry: import("./registry.js").SemanticRegistry;
+    snapshot: RegistrySnapshot;
+    executeAction: (actionId: string, context: PolicyContext, input?: unknown, options?: ExecuteActionOptions) => Promise<ExecuteActionResult>;
+};
+export declare function useSemanticEvents(onEvent: (event: RuntimeEvent) => void): void;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,kBAAkB;;;8BAkBlB,MAAM,WACP,aAAa,UACd,OAAO,YACL,oBAAoB,KAC7B,OAAO,CAAC,mBAAmB,CAAC;EAUlC;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,IAAI,CAMN"}

package/dist/react.js

@@ -0,0 +1,24 @@
+"use client";
+import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
+import { getSemanticRegistry } from "./registry.js";
+export function useSemanticRuntime() {
+    const registry = getSemanticRegistry();
+    const subscribe = useCallback((onStoreChange) => {
+        return registry.bus.subscribe(onStoreChange);
+    }, [registry]);
+    const getSnapshotData = useCallback(() => {
+        return registry.getSnapshot();
+    }, [registry]);
+    const snapshot = useSyncExternalStore(subscribe, getSnapshotData, getSnapshotData);
+    const executeAction = useCallback((actionId, context, input, options) => {
+        return registry.executeAction(actionId, context, input, options);
+    }, [registry]);
+    return useMemo(() => ({ registry, snapshot, executeAction }), [registry, snapshot, executeAction]);
+}
+export function useSemanticEvents(onEvent) {
+    const registry = getSemanticRegistry();
+    useEffect(() => {
+        return registry.bus.subscribe(onEvent);
+    }, [registry, onEvent]);
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AASpD,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,aAAyB,EAAE,EAAE;QAC5B,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,eAAe,GAAG,WAAW,CAAC,GAAqB,EAAE;QACzD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC;IAEnF,MAAM,aAAa,GAAG,WAAW,CAC/B,CACE,QAAgB,EAChB,OAAsB,EACtB,KAAe,EACf,OAA8B,EACA,EAAE;QAChC,OAAO,QAAQ,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,EAC7C,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAsC;IAEtC,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IAEvC,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1B,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,48 @@
+import type { SemanticEntity, SemanticAction, CapabilityProfile, WorkflowDefinition, RuntimeEvent, PolicyContext, SemanticActionHandler, ExecuteActionOptions, ExecuteActionResult } from "./types.js";
+type EventListener = (event: RuntimeEvent) => void;
+export declare class SemanticEventBus {
+    private listeners;
+    subscribe(listener: EventListener): () => void;
+    emit(event: RuntimeEvent): void;
+}
+export type RegistrySnapshot = {
+    entities: SemanticEntity[];
+    actions: SemanticAction[];
+    capabilities: CapabilityProfile;
+    workflows: WorkflowDefinition[];
+};
+export declare class SemanticRegistry {
+    readonly bus: SemanticEventBus;
+    private entities;
+    private actions;
+    private capabilities;
+    private workflows;
+    private version;
+    private actionHandlers;
+    private actionInputZod;
+    registerEntity(input: unknown): SemanticEntity;
+    getEntity(id: string): SemanticEntity | undefined;
+    updateEntity(input: unknown): SemanticEntity;
+    removeEntity(id: string): boolean;
+    registerAction(input: unknown): SemanticAction;
+    getAction(id: string): SemanticAction | undefined;
+    bindAction(actionId: string, handler: SemanticActionHandler): void;
+    unbindAction(actionId: string): boolean;
+    executeAction(actionId: string, context: PolicyContext, input?: unknown, options?: ExecuteActionOptions): Promise<ExecuteActionResult>;
+    /**
+     * Starts a logical agent/session span and emits `session:started`.
+     * Pair with {@link endSession} or pass the id into {@link executeAction}.
+     */
+    startSession(): string;
+    endSession(sessionId: string): void;
+    registerCapability(input: unknown): CapabilityProfile;
+    registerWorkflow(input: unknown): WorkflowDefinition;
+    getWorkflow(id: string): WorkflowDefinition | undefined;
+    getSnapshot(): RegistrySnapshot;
+    getVersion(): number;
+    reset(): void;
+}
+export declare function getSemanticRegistry(): SemanticRegistry;
+export declare function resetSemanticRegistryForTests(): void;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAiBpB,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAEnD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA4B;IAE7C,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAO9C,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;CAKhC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,iBAAiB,CAAC;IAChC,SAAS,EAAE,kBAAkB,EAAE,CAAC;CACjC,CAAC;AAQF,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,GAAG,mBAA0B;IAEtC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,cAAc,CAAmC;IAEzD,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc;IAQ9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAQjD,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc;IAQ5C,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IASjC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc;IA+B9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIjD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIlE,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIjC,aAAa,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IA6F/B;;;OAGG;IACH,YAAY,IAAI,MAAM;IAMtB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB;IAQrD,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB;IAQpD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIvD,WAAW,IAAI,gBAAgB;IAS/B,UAAU,IAAI,MAAM;IAIpB,KAAK,IAAI,IAAI;CASd;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAKpD"}

package/dist/registry.js

@@ -0,0 +1,251 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { entitySchema, actionSchema, capabilitySchema, workflowSchema, } from "./types.js";
+import { evaluatePolicy } from "./policy.js";
+function createSessionId() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === "function") {
+        return c.randomUUID();
+    }
+    return `sess_${Math.random().toString(36).slice(2)}_${Date.now().toString(36)}`;
+}
+export class SemanticEventBus {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    emit(event) {
+        for (const listener of this.listeners) {
+            listener(event);
+        }
+    }
+}
+function stripRegisterActionExtras(input) {
+    if (!input || typeof input !== "object")
+        return input;
+    const { inputSchema: _ignored, ...rest } = input;
+    return rest;
+}
+export class SemanticRegistry {
+    bus = new SemanticEventBus();
+    entities = new Map();
+    actions = new Map();
+    capabilities = {};
+    workflows = new Map();
+    version = 0;
+    actionHandlers = new Map();
+    actionInputZod = new Map();
+    registerEntity(input) {
+        const entity = entitySchema.parse(input);
+        this.entities.set(entity.id, entity);
+        this.version++;
+        this.bus.emit({ type: "entity:registered", entity });
+        return entity;
+    }
+    getEntity(id) {
+        const entity = this.entities.get(id);
+        if (entity) {
+            this.bus.emit({ type: "entity:queried", entityId: id });
+        }
+        return entity;
+    }
+    updateEntity(input) {
+        const entity = entitySchema.parse(input);
+        this.entities.set(entity.id, entity);
+        this.version++;
+        this.bus.emit({ type: "entity:updated", entity });
+        return entity;
+    }
+    removeEntity(id) {
+        const removed = this.entities.delete(id);
+        if (removed) {
+            this.version++;
+            this.bus.emit({ type: "entity:removed", entityId: id });
+        }
+        return removed;
+    }
+    registerAction(input) {
+        const raw = input && typeof input === "object"
+            ? input
+            : null;
+        const zodInput = raw && "inputSchema" in raw ? raw.inputSchema : undefined;
+        const baseParsed = actionSchema.parse(stripRegisterActionExtras(input));
+        let inputJsonSchema = baseParsed.inputJsonSchema;
+        if (zodInput !== undefined && zodInput !== null) {
+            inputJsonSchema = zodToJsonSchema(zodInput, {
+                target: "jsonSchema7",
+            });
+            this.actionInputZod.set(baseParsed.id, zodInput);
+        }
+        else {
+            this.actionInputZod.delete(baseParsed.id);
+        }
+        const action = {
+            ...baseParsed,
+            ...(inputJsonSchema !== undefined ? { inputJsonSchema } : {}),
+        };
+        this.actions.set(action.id, action);
+        this.version++;
+        this.bus.emit({ type: "action:registered", action });
+        return action;
+    }
+    getAction(id) {
+        return this.actions.get(id);
+    }
+    bindAction(actionId, handler) {
+        this.actionHandlers.set(actionId, handler);
+    }
+    unbindAction(actionId) {
+        return this.actionHandlers.delete(actionId);
+    }
+    async executeAction(actionId, context, input, options) {
+        const action = this.actions.get(actionId);
+        if (!action) {
+            const message = `Action "${actionId}" not found in registry.`;
+            this.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message,
+            });
+            return { ok: false, message };
+        }
+        const sessionId = options?.sessionId;
+        this.bus.emit({
+            type: "action:attempt",
+            actionId,
+            context,
+            ...(sessionId !== undefined ? { sessionId } : {}),
+        });
+        const decision = evaluatePolicy(context, action);
+        this.bus.emit({ type: "policy:evaluated", actionId, decision });
+        if (!decision.allowed) {
+            this.bus.emit({
+                type: "policy:denied",
+                actionId,
+                reason: decision.reason,
+            });
+            this.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message: decision.reason,
+            });
+            return { ok: false, message: decision.reason };
+        }
+        const zodSchema = this.actionInputZod.get(actionId);
+        let parsedInput = input;
+        if (zodSchema) {
+            const parsed = zodSchema.safeParse(input);
+            if (!parsed.success) {
+                const message = parsed.error.message;
+                this.bus.emit({
+                    type: "action:result",
+                    actionId,
+                    ok: false,
+                    message,
+                });
+                return { ok: false, message };
+            }
+            parsedInput = parsed.data;
+        }
+        const handler = this.actionHandlers.get(actionId);
+        if (!handler) {
+            const message = `No handler bound for action "${actionId}".`;
+            this.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message,
+            });
+            return { ok: false, message };
+        }
+        const execCtx = { ...context, ...(sessionId !== undefined ? { sessionId } : {}) };
+        try {
+            const data = await handler(execCtx, parsedInput);
+            this.bus.emit({ type: "action:executed", actionId });
+            this.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: true,
+                ...(data !== undefined ? { data } : {}),
+            });
+            return { ok: true, ...(data !== undefined ? { data } : {}) };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Action handler threw a non-Error value.";
+            this.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message,
+            });
+            return { ok: false, message };
+        }
+    }
+    /**
+     * Starts a logical agent/session span and emits `session:started`.
+     * Pair with {@link endSession} or pass the id into {@link executeAction}.
+     */
+    startSession() {
+        const sessionId = createSessionId();
+        this.bus.emit({ type: "session:started", sessionId });
+        return sessionId;
+    }
+    endSession(sessionId) {
+        this.bus.emit({ type: "session:ended", sessionId });
+    }
+    registerCapability(input) {
+        const caps = capabilitySchema.parse(input);
+        this.capabilities = { ...this.capabilities, ...caps };
+        this.version++;
+        this.bus.emit({ type: "capability:registered", capabilities: this.capabilities });
+        return this.capabilities;
+    }
+    registerWorkflow(input) {
+        const workflow = workflowSchema.parse(input);
+        this.workflows.set(workflow.id, workflow);
+        this.version++;
+        this.bus.emit({ type: "workflow:registered", workflow });
+        return workflow;
+    }
+    getWorkflow(id) {
+        return this.workflows.get(id);
+    }
+    getSnapshot() {
+        return {
+            entities: Array.from(this.entities.values()),
+            actions: Array.from(this.actions.values()),
+            capabilities: { ...this.capabilities },
+            workflows: Array.from(this.workflows.values()),
+        };
+    }
+    getVersion() {
+        return this.version;
+    }
+    reset() {
+        this.entities.clear();
+        this.actions.clear();
+        this.capabilities = {};
+        this.workflows.clear();
+        this.version = 0;
+        this.actionHandlers.clear();
+        this.actionInputZod.clear();
+    }
+}
+let globalRegistry = null;
+export function getSemanticRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = new SemanticRegistry();
+    }
+    return globalRegistry;
+}
+export function resetSemanticRegistryForTests() {
+    if (globalRegistry) {
+        globalRegistry.reset();
+    }
+    globalRegistry = null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/snapshot.d.ts

@@ -0,0 +1,12 @@
+import type { SemanticRegistry, RegistrySnapshot } from "./registry.js";
+/** Serializable envelope for HTTP, MCP, or cross-context sync. */
+export type SynqelSnapshotEnvelope = {
+    format: "synqel.snapshot.v1";
+    registryVersion: number;
+    snapshot: RegistrySnapshot;
+};
+export declare function createSnapshotEnvelope(registry: SemanticRegistry): SynqelSnapshotEnvelope;
+export declare function serializeSnapshotEnvelope(registry: SemanticRegistry): string;
+/** Ready-made JSON `Response` for e.g. `GET /.synqel/snapshot` in Next.js or other runtimes. */
+export declare function synqelSnapshotJsonResponse(registry: SemanticRegistry, init?: ResponseInit): Response;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAExE,kEAAkE;AAClE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,GACzB,sBAAsB,CAMxB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE5E;AAED,gGAAgG;AAChG,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,CAAC,EAAE,YAAY,GAClB,QAAQ,CASV"}

package/dist/snapshot.js

@@ -0,0 +1,22 @@
+export function createSnapshotEnvelope(registry) {
+    return {
+        format: "synqel.snapshot.v1",
+        registryVersion: registry.getVersion(),
+        snapshot: registry.getSnapshot(),
+    };
+}
+export function serializeSnapshotEnvelope(registry) {
+    return JSON.stringify(createSnapshotEnvelope(registry));
+}
+/** Ready-made JSON `Response` for e.g. `GET /.synqel/snapshot` in Next.js or other runtimes. */
+export function synqelSnapshotJsonResponse(registry, init) {
+    const body = serializeSnapshotEnvelope(registry);
+    return new Response(body, {
+        ...init,
+        headers: {
+            "content-type": "application/json; charset=utf-8",
+            ...(init?.headers ?? {}),
+        },
+    });
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,sBAAsB,CACpC,QAA0B;IAE1B,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,eAAe,EAAE,QAAQ,CAAC,UAAU,EAAE;QACtC,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAA0B;IAClE,OAAO,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,0BAA0B,CACxC,QAA0B,EAC1B,IAAmB;IAEnB,MAAM,IAAI,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACjD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;QACxB,GAAG,IAAI;QACP,OAAO,EAAE;YACP,cAAc,EAAE,iCAAiC;YACjD,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;SACzB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,171 @@
+import { z } from "zod";
+export declare const entitySchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    type: string;
+    metadata: Record<string, unknown>;
+}, {
+    id: string;
+    type: string;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export declare const actionSchema: z.ZodObject<{
+    id: z.ZodString;
+    intent: z.ZodEnum<["navigation", "mutation", "query", "system"]>;
+    deterministic: z.ZodDefault<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    /** JSON Schema for action inputs (agents/MCP); often derived from optional Zod `inputSchema` at registration. */
+    inputJsonSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    intent: "navigation" | "mutation" | "query" | "system";
+    deterministic: boolean;
+    description?: string | undefined;
+    inputJsonSchema?: Record<string, unknown> | undefined;
+}, {
+    id: string;
+    intent: "navigation" | "mutation" | "query" | "system";
+    deterministic?: boolean | undefined;
+    description?: string | undefined;
+    inputJsonSchema?: Record<string, unknown> | undefined;
+}>;
+export declare const capabilitySchema: z.ZodObject<{
+    canSearch: z.ZodOptional<z.ZodBoolean>;
+    canCheckout: z.ZodOptional<z.ZodBoolean>;
+    canNavigate: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    canSearch?: boolean | undefined;
+    canCheckout?: boolean | undefined;
+    canNavigate?: boolean | undefined;
+}, {
+    canSearch?: boolean | undefined;
+    canCheckout?: boolean | undefined;
+    canNavigate?: boolean | undefined;
+}>;
+export declare const workflowSchema: z.ZodObject<{
+    id: z.ZodString;
+    steps: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    steps: string[];
+}, {
+    id: string;
+    steps: string[];
+}>;
+export type SemanticEntity = z.infer<typeof entitySchema>;
+export type SemanticAction = z.infer<typeof actionSchema>;
+export type CapabilityProfile = z.infer<typeof capabilitySchema>;
+export type WorkflowDefinition = z.infer<typeof workflowSchema>;
+/** Accepted shape for `registerAction` — optional Zod input schema is stripped before validation and drives `inputJsonSchema`. */
+export type RegisterActionInput = Omit<SemanticAction, "deterministic"> & {
+    deterministic?: boolean;
+    inputSchema?: z.ZodTypeAny;
+};
+export type PolicyContext = {
+    actor: "human" | "agent" | "voice";
+    roles: string[];
+};
+export type PolicyDecision = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: string;
+};
+export type PolicyRule = (ctx: PolicyContext, action: SemanticAction) => PolicyDecision | null;
+/** Effective context passed to bound action handlers (extends policy context). */
+export type ActionExecutionContext = PolicyContext & {
+    sessionId?: string;
+};
+export type SemanticActionHandler = (ctx: ActionExecutionContext, input: unknown) => unknown | Promise<unknown>;
+export type ExecuteActionOptions = {
+    sessionId?: string;
+};
+export type ExecuteActionResult = {
+    ok: boolean;
+    message?: string;
+    data?: unknown;
+};
+export type RuntimeEvent = {
+    type: "entity:registered";
+    entity: SemanticEntity;
+} | {
+    type: "entity:queried";
+    entityId: string;
+} | {
+    type: "entity:updated";
+    entity: SemanticEntity;
+} | {
+    type: "entity:removed";
+    entityId: string;
+} | {
+    type: "action:registered";
+    action: SemanticAction;
+} | {
+    type: "action:attempt";
+    actionId: string;
+    context: PolicyContext;
+    sessionId?: string;
+} | {
+    type: "action:result";
+    actionId: string;
+    ok: boolean;
+    message?: string;
+    data?: unknown;
+} | {
+    type: "action:executed";
+    actionId: string;
+} | {
+    type: "capability:registered";
+    capabilities: CapabilityProfile;
+} | {
+    type: "workflow:registered";
+    workflow: WorkflowDefinition;
+} | {
+    type: "workflow:started";
+    workflowId: string;
+} | {
+    type: "workflow:step";
+    workflowId: string;
+    stepIndex: number;
+    stepId: string;
+} | {
+    type: "workflow:completed";
+    workflowId: string;
+} | {
+    type: "workflow:failed";
+    workflowId: string;
+    error: string;
+} | {
+    type: "session:started";
+    sessionId: string;
+} | {
+    type: "session:ended";
+    sessionId: string;
+} | {
+    type: "intent:expressed";
+    intentId: string;
+    intent: string;
+    metadata?: Record<string, unknown>;
+} | {
+    type: "intent:resolved";
+    intentId: string;
+} | {
+    type: "intent:abandoned";
+    intentId: string;
+} | {
+    type: "intent:failed";
+    intentId: string;
+    error: string;
+} | {
+    type: "policy:evaluated";
+    actionId: string;
+    decision: PolicyDecision;
+} | {
+    type: "policy:denied";
+    actionId: string;
+    reason: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export const entitySchema = z.object({
+    id: z.string().min(1),
+    type: z.string().min(1),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+export const actionSchema = z.object({
+    id: z.string().min(1),
+    intent: z.enum(["navigation", "mutation", "query", "system"]),
+    deterministic: z.boolean().default(true),
+    description: z.string().optional(),
+    /** JSON Schema for action inputs (agents/MCP); often derived from optional Zod `inputSchema` at registration. */
+    inputJsonSchema: z.record(z.string(), z.unknown()).optional(),
+});
+export const capabilitySchema = z.object({
+    canSearch: z.boolean().optional(),
+    canCheckout: z.boolean().optional(),
+    canNavigate: z.boolean().optional(),
+});
+export const workflowSchema = z.object({
+    id: z.string().min(1),
+    steps: z.array(z.string().min(1)).min(1),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC7D,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,iHAAiH;IACjH,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACzC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@synqel/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Semantic runtime SDK — the open standard for AI-navigable web applications",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.js",
+      "types": "./dist/react.d.ts"
+    }
+  },
+  "files": ["dist"],
+  "peerDependencies": {
+    "react": ">=18",
+    "zod": "^3.25.28"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.1.3",
+    "@types/react": "^19.1.2",
+    "zod": "^3.25.28",
+    "react": "^19.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vvtitov/synqel-protocol.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/vvtitov/synqel-protocol#readme",
+  "bugs": {
+    "url": "https://github.com/vvtitov/synqel-protocol/issues"
+  },
+  "keywords": [
+    "ai",
+    "semantic",
+    "protocol",
+    "agents",
+    "accessibility",
+    "registry",
+    "sdk",
+    "mcp",
+    "json-schema",
+    "zod"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run test && bun run build"
+  },
+  "dependencies": {
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}