@synqel/sdk 0.1.0

package/README.md

@@ -0,0 +1,72 @@
+# @synqel/sdk
+
+> Semantic runtime SDK for the Synqel Protocol — the open standard for AI-navigable web applications.
+
+## Install
+
+```bash
+bun add @synqel/sdk
+# or
+npm install @synqel/sdk
+```
+
+## Usage
+
+```typescript
+import {
+  registerEntity,
+  registerAction,
+  registerCapability,
+  registerWorkflow,
+  getSemanticRegistry,
+} from "@synqel/sdk";
+
+registerEntity({
+  id: "product_123",
+  type: "product",
+  metadata: { price: 299 },
+});
+
+registerAction({
+  id: "add_to_cart",
+  intent: "mutation",
+  deterministic: true,
+});
+
+registerCapability({ canSearch: true, canCheckout: true });
+
+registerWorkflow({
+  id: "checkout_flow",
+  steps: ["add_to_cart", "confirm_order"],
+});
+
+const snapshot = getSemanticRegistry().getSnapshot();
+```
+
+## React Integration
+
+```typescript
+import { useSemanticRuntime, useSemanticEvents } from "@synqel/sdk/react";
+
+function MyComponent() {
+  const { snapshot, executeAction } = useSemanticRuntime();
+
+  useSemanticEvents((event) => {
+    console.log("Semantic event:", event);
+  });
+
+  return (
+    <button
+      onClick={() =>
+        executeAction("add_to_cart", { actor: "human", roles: ["customer"] })
+      }
+    >
+      Add to Cart
+    </button>
+  );
+}
+```
+
+## 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,17 @@
+export type { SemanticEntity, SemanticAction, CapabilityProfile, WorkflowDefinition, PolicyContext, PolicyDecision, PolicyRule, RuntimeEvent, } 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 { 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 } from "./types.js";
+export declare function registerEntity(input: Omit<SemanticEntity, "metadata"> & {
+    metadata?: Record<string, unknown>;
+}): SemanticEntity;
+export declare function registerAction(input: Omit<SemanticAction, "deterministic"> & {
+    deterministic?: boolean;
+}): SemanticAction;
+export declare function registerCapability(input: CapabilityProfile): CapabilityProfile;
+export declare function registerWorkflow(input: WorkflowDefinition): WorkflowDefinition;
+//# 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,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,UAAU,EACV,YAAY,GACb,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,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,EACnB,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,CAC5B,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACzE,cAAc,CAEhB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB,CAE9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAE9E"}

package/dist/index.js

@@ -0,0 +1,18 @@
+export { entitySchema, actionSchema, capabilitySchema, workflowSchema, } from "./types.js";
+export { SemanticEventBus, SemanticRegistry, getSemanticRegistry, resetSemanticRegistryForTests, } from "./registry.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);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,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;AAIvB,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;AAQpD,MAAM,UAAU,cAAc,CAC5B,KAAgF;IAEhF,OAAO,mBAAmB,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,KAA0E;IAE1E,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"}

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 } from "./types.js";
+export declare function useSemanticRuntime(): {
+    registry: import("./registry.js").SemanticRegistry;
+    snapshot: RegistrySnapshot;
+    executeAction: (actionId: string, context: PolicyContext) => void;
+};
+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,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG9D,wBAAgB,kBAAkB;;;8BAiBnB,MAAM,WAAW,aAAa;EA0C5C;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,IAAI,CAMN"}

package/dist/react.js

@@ -0,0 +1,53 @@
+"use client";
+import { useCallback, useEffect, useMemo, useSyncExternalStore } from "react";
+import { getSemanticRegistry } from "./registry.js";
+import { evaluatePolicy } from "./policy.js";
+export function useSemanticRuntime() {
+    const registry = getSemanticRegistry();
+    const subscribe = useCallback((onStoreChange) => {
+        return registry.bus.subscribe(onStoreChange);
+    }, [registry]);
+    const getSnapshot = useCallback(() => {
+        return registry.getSnapshot();
+    }, [registry]);
+    const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const executeAction = useCallback((actionId, context) => {
+        const action = registry.getAction(actionId);
+        if (!action) {
+            registry.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message: `Action "${actionId}" not found in registry.`,
+            });
+            return;
+        }
+        registry.bus.emit({ type: "action:attempt", actionId, context });
+        const decision = evaluatePolicy(context, action);
+        registry.bus.emit({ type: "policy:evaluated", actionId, decision });
+        if (!decision.allowed) {
+            registry.bus.emit({
+                type: "policy:denied",
+                actionId,
+                reason: decision.reason,
+            });
+            registry.bus.emit({
+                type: "action:result",
+                actionId,
+                ok: false,
+                message: decision.reason,
+            });
+            return;
+        }
+        registry.bus.emit({ type: "action:executed", actionId });
+        registry.bus.emit({ type: "action:result", actionId, ok: true });
+    }, [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":"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"}

package/dist/registry.d.ts

@@ -0,0 +1,37 @@
+import type { SemanticEntity, SemanticAction, CapabilityProfile, WorkflowDefinition, RuntimeEvent } 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;
+    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;
+    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":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACb,MAAM,YAAY,CAAC;AAQpB,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;AAEF,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,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;IAQ9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIjD,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;CAOd;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAKpD"}

package/dist/registry.js

@@ -0,0 +1,111 @@
+import { entitySchema, actionSchema, capabilitySchema, workflowSchema, } from "./types.js";
+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);
+        }
+    }
+}
+export class SemanticRegistry {
+    bus = new SemanticEventBus();
+    entities = new Map();
+    actions = new Map();
+    capabilities = {};
+    workflows = new Map();
+    version = 0;
+    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 action = actionSchema.parse(input);
+        this.actions.set(action.id, action);
+        this.version++;
+        this.bus.emit({ type: "action:registered", action });
+        return action;
+    }
+    getAction(id) {
+        return this.actions.get(id);
+    }
+    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;
+    }
+}
+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/types.d.ts

@@ -0,0 +1,144 @@
+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>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    intent: "navigation" | "mutation" | "query" | "system";
+    deterministic: boolean;
+}, {
+    id: string;
+    intent: "navigation" | "mutation" | "query" | "system";
+    deterministic?: boolean | 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>;
+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;
+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;
+} | {
+    type: "action:result";
+    actionId: string;
+    ok: boolean;
+    message?: string;
+} | {
+    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,21 @@
+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),
+});
+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;CACzC,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

@@ -0,0 +1,58 @@
+{
+  "name": "@synqel/sdk",
+  "version": "0.1.0",
+  "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"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.1.3",
+    "@types/react": "^19.1.2",
+    "zod": "^3.24.4",
+    "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"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run test && bun run build"
+  }
+}