@aigne/afs-ui 1.11.0-beta.12

package/dist/aup-types.mjs

@@ -0,0 +1,157 @@
+//#region src/aup-types.ts
+/** Validate DeviceCaps has required fields. Returns error string or null. */
+function validateDeviceCaps(caps) {
+	if (!caps || typeof caps !== "object") return "caps must be an object";
+	const c = caps;
+	if (!c.platform || typeof c.platform !== "string") return "caps.platform is required and must be a string";
+	if (!c.formFactor || typeof c.formFactor !== "string") return "caps.formFactor is required and must be a string";
+	if (!c.primitives || typeof c.primitives !== "object" || Array.isArray(c.primitives)) return "caps.primitives is required and must be an object";
+	const validCaps = new Set([
+		"native",
+		"webview",
+		"partial",
+		"unsupported"
+	]);
+	for (const [key, val] of Object.entries(c.primitives)) if (typeof val !== "string" || !validCaps.has(val)) return `caps.primitives.${key} must be one of: native, webview, partial, unsupported`;
+	return null;
+}
+/** All AUP primitives */
+const AUP_PRIMITIVES = [
+	"view",
+	"text",
+	"media",
+	"input",
+	"action",
+	"overlay",
+	"table",
+	"time",
+	"chart",
+	"map",
+	"calendar",
+	"chat",
+	"terminal",
+	"rtc",
+	"explorer",
+	"editor",
+	"canvas",
+	"afs-list"
+];
+/** Build a primitives map with overrides and a fallback for unspecified primitives. */
+function fillPrimitives(overrides, fallback) {
+	const result = {};
+	for (const p of AUP_PRIMITIVES) result[p] = overrides[p] ?? fallback;
+	return result;
+}
+/** TTY: stdin/stdout, text only. Everything else unsupported → degraded to text by server. */
+const DEVICE_CAPS_TTY = {
+	platform: "cli",
+	formFactor: "terminal",
+	input: { keyboard: true },
+	primitives: fillPrimitives({ text: "native" }, "unsupported")
+};
+/** Term: xterm.js in browser, text + terminal subsystem. */
+const DEVICE_CAPS_TERM = {
+	platform: "web",
+	formFactor: "terminal",
+	display: {
+		type: "visual",
+		color: "full",
+		refresh: "realtime"
+	},
+	input: { keyboard: true },
+	primitives: fillPrimitives({
+		text: "native",
+		terminal: "native"
+	}, "unsupported")
+};
+/** Web chat: browser with chat + basic UI. No full AUP. */
+const DEVICE_CAPS_WEB_CHAT = {
+	platform: "web",
+	formFactor: "desktop",
+	display: {
+		type: "visual",
+		color: "full",
+		refresh: "realtime"
+	},
+	input: {
+		keyboard: true,
+		touch: true
+	},
+	primitives: fillPrimitives({
+		text: "webview",
+		chat: "webview",
+		overlay: "webview",
+		media: "webview",
+		action: "webview"
+	}, "unsupported")
+};
+/** Web full: browser with all primitives via WebView rendering. Default for web clients. */
+const DEVICE_CAPS_WEB_FULL = {
+	platform: "web",
+	formFactor: "desktop",
+	display: {
+		type: "visual",
+		color: "full",
+		refresh: "realtime"
+	},
+	input: {
+		keyboard: true,
+		touch: true
+	},
+	primitives: fillPrimitives({}, "webview")
+};
+/** Validate an AUPNode has required fields. Returns error string or null. */
+function validateNode(node) {
+	if (!node || typeof node !== "object") return "node must be an object";
+	const n = node;
+	if (!n.id || typeof n.id !== "string") return "node.id is required and must be a string";
+	if (!n.type || typeof n.type !== "string") return "node.type is required and must be a string";
+	if (n.src !== void 0) {
+		if (typeof n.src !== "string") return "node.src must be a string";
+		if (n.src.toLowerCase().startsWith("javascript:")) return "node.src cannot use javascript: protocol";
+	}
+	if (n.bind !== void 0) {
+		if (typeof n.bind !== "string") return "node.bind must be a string";
+		if (n.bind.toLowerCase().startsWith("javascript:")) return "node.bind cannot use javascript: protocol";
+	}
+	if (n.events && typeof n.events === "object") {
+		for (const [, evt] of Object.entries(n.events)) if (evt && typeof evt === "object") {
+			const e = evt;
+			if (typeof e.exec === "string" && e.exec.toLowerCase().startsWith("javascript:")) return "event exec path cannot use javascript: protocol";
+		}
+	}
+	if (n.children && Array.isArray(n.children)) for (const child of n.children) {
+		const err = validateNode(child);
+		if (err) return err;
+	}
+	return null;
+}
+/** Validate a patch op has required fields. Returns error string or null. */
+function validatePatchOp(op) {
+	if (!op || typeof op !== "object") return "patch op must be an object";
+	const o = op;
+	const opType = o.op;
+	switch (opType) {
+		case "create":
+			if (!o.id || typeof o.id !== "string") return "create op requires id";
+			if (!o.parentId || typeof o.parentId !== "string") return "create op requires parentId";
+			if (!o.node) return "create op requires node";
+			return validateNode(o.node);
+		case "update":
+			if (!o.id || typeof o.id !== "string") return "update op requires id";
+			return null;
+		case "remove":
+			if (!o.id || typeof o.id !== "string") return "remove op requires id";
+			return null;
+		case "reorder":
+			if (!o.id || typeof o.id !== "string") return "reorder op requires id";
+			if (!o.parentId || typeof o.parentId !== "string") return "reorder op requires parentId";
+			if (typeof o.index !== "number") return "reorder op requires numeric index";
+			return null;
+		default: return `unknown patch op type: ${String(opType)}`;
+	}
+}
+
+//#endregion
+export { AUP_PRIMITIVES, DEVICE_CAPS_TERM, DEVICE_CAPS_TTY, DEVICE_CAPS_WEB_CHAT, DEVICE_CAPS_WEB_FULL, fillPrimitives, validateDeviceCaps, validateNode, validatePatchOp };
+//# sourceMappingURL=aup-types.mjs.map

package/dist/aup-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aup-types.mjs","names":[],"sources":["../src/aup-types.ts"],"sourcesContent":["/**\n * AUP (Agentic UI Protocol) — Type definitions.\n *\n * Semantic node graph for structured UI rendering.\n * Zero visual attributes — only semantic tokens.\n */\n\n// ── Node Graph ──\n\nexport interface AUPNode {\n  /** Stable identity */\n  id: string;\n  /** Primitive name (from registry): view, text, media, input, action, overlay, table, chat, terminal */\n  type: string;\n  /** Static attributes (label, src, placeholder, columns, etc.) */\n  props?: Record<string, unknown>;\n  /** AFS path — read-only data binding (client subscribes for updates) */\n  src?: string;\n  /** AFS path — read-write data binding (input writes back) */\n  bind?: string;\n  /** UI-local state (selected tab, expanded, open, etc.) */\n  state?: Record<string, unknown>;\n  /** Event bindings — each maps to an AFS exec call */\n  events?: Record<string, AUPEvent>;\n  /** Child nodes */\n  children?: AUPNode[];\n}\n\nexport interface AUPEvent {\n  /** AFS path to exec */\n  exec: string;\n  /** Arguments to pass to exec */\n  args?: Record<string, unknown>;\n}\n\n// ── Semantic Tokens ──\n\nexport type AUPVariant = \"primary\" | \"secondary\" | \"ghost\" | \"destructive\";\nexport type AUPSize = \"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\";\nexport type AUPIntent = \"info\" | \"success\" | \"warning\" | \"error\";\n\n// ── Patch Operations ──\n\nexport type AUPPatchOp = AUPCreateOp | AUPUpdateOp | AUPRemoveOp | AUPReorderOp;\n\nexport interface AUPCreateOp {\n  op: \"create\";\n  id: string;\n  parentId: string;\n  node: AUPNode;\n  index?: number;\n}\n\nexport interface AUPUpdateOp {\n  op: \"update\";\n  id: string;\n  props?: Record<string, unknown>;\n  state?: Record<string, unknown>;\n  events?: Record<string, AUPEvent>;\n}\n\nexport interface AUPRemoveOp {\n  op: \"remove\";\n  id: string;\n}\n\nexport interface AUPReorderOp {\n  op: \"reorder\";\n  id: string;\n  parentId: string;\n  index: number;\n}\n\n// ── WebSocket Messages ──\n\n/** Server → Client: full render */\nexport interface AUPRenderMessage {\n  type: \"aup\";\n  action: \"render\";\n  root: AUPNode;\n}\n\n/** Server → Client: incremental patch */\nexport interface AUPPatchMessage {\n  type: \"aup\";\n  action: \"patch\";\n  ops: AUPPatchOp[];\n}\n\n/** Client → Server: event fired */\nexport interface AUPEventMessage {\n  type: \"aup_event\";\n  nodeId: string;\n  event: string;\n}\n\n/** Server → Client: event result */\nexport interface AUPEventResultMessage {\n  type: \"aup_event_result\";\n  nodeId: string;\n  event: string;\n  result?: unknown;\n  error?: string;\n}\n\nexport type AUPServerMessage = AUPRenderMessage | AUPPatchMessage | AUPEventResultMessage;\nexport type AUPClientMessage = AUPEventMessage;\n\n// ── Device Capabilities (D13) ──\n\n/**\n * How a device can render a specific AUP primitive.\n *\n * - \"native\"      — native renderer, full functionality\n * - \"webview\"     — WebView renderer, full functionality\n * - \"partial\"     — renderable, but some props unsupported\n * - \"unsupported\" — cannot render; server applies degradation chain (D14)\n */\nexport type PrimitiveCap = \"native\" | \"webview\" | \"partial\" | \"unsupported\";\n\n/** Display characteristics of a device. All fields optional — informational context. */\nexport interface DeviceDisplay {\n  type?: \"visual\" | \"spatial\" | \"audio-only\" | \"tactile\";\n  color?: \"full\" | \"limited\" | \"mono\";\n  refresh?: \"realtime\" | \"slow\";\n  resolution?: { w: number; h: number };\n  depth?: \"2d\" | \"3d\";\n}\n\n/** Input modalities available on a device. */\nexport interface DeviceInput {\n  touch?: boolean;\n  keyboard?: boolean;\n  voice?: boolean;\n  gaze?: boolean;\n  gesture?: boolean;\n  controller?: boolean;\n}\n\n/**\n * Device capability declaration (D13).\n *\n * Sent by client during session handshake. Agent reads via AFS path.\n * Server uses `primitives` map + degradation chain (D14) to adapt AUP tree.\n */\nexport interface DeviceCaps {\n  /** Platform identifier: \"web\", \"ios\", \"android\", \"vr\", etc. */\n  platform: string;\n  /** Form factor: \"desktop\", \"phone\", \"tablet\", \"watch\", \"tv\", \"headset\", etc. */\n  formFactor: string;\n  /** Display characteristics (optional, informational) */\n  display?: DeviceDisplay;\n  /** Input modalities (optional, informational) */\n  input?: DeviceInput;\n  /** Per-primitive rendering capability */\n  primitives: Record<string, PrimitiveCap>;\n  /** Platform features: camera, gps, biometric, haptic, etc. */\n  features?: Record<string, boolean>;\n}\n\n/** Validate DeviceCaps has required fields. Returns error string or null. */\nexport function validateDeviceCaps(caps: unknown): string | null {\n  if (!caps || typeof caps !== \"object\") return \"caps must be an object\";\n  const c = caps as Record<string, unknown>;\n  if (!c.platform || typeof c.platform !== \"string\")\n    return \"caps.platform is required and must be a string\";\n  if (!c.formFactor || typeof c.formFactor !== \"string\")\n    return \"caps.formFactor is required and must be a string\";\n  if (!c.primitives || typeof c.primitives !== \"object\" || Array.isArray(c.primitives))\n    return \"caps.primitives is required and must be an object\";\n\n  const validCaps = new Set([\"native\", \"webview\", \"partial\", \"unsupported\"]);\n  for (const [key, val] of Object.entries(c.primitives as Record<string, unknown>)) {\n    if (typeof val !== \"string\" || !validCaps.has(val)) {\n      return `caps.primitives.${key} must be one of: native, webview, partial, unsupported`;\n    }\n  }\n  return null;\n}\n\n// ── Default Device Caps Presets (D16) ──\n\n/** All AUP primitives */\nexport const AUP_PRIMITIVES = [\n  \"view\",\n  \"text\",\n  \"media\",\n  \"input\",\n  \"action\",\n  \"overlay\",\n  \"table\",\n  \"time\",\n  \"chart\",\n  \"map\",\n  \"calendar\",\n  \"chat\",\n  \"terminal\",\n  \"rtc\",\n  \"explorer\",\n  \"editor\",\n  \"canvas\",\n  \"afs-list\",\n] as const;\n\n/** Build a primitives map with overrides and a fallback for unspecified primitives. */\nexport function fillPrimitives(\n  overrides: Partial<Record<string, PrimitiveCap>>,\n  fallback: PrimitiveCap,\n): Record<string, PrimitiveCap> {\n  const result: Record<string, PrimitiveCap> = {};\n  for (const p of AUP_PRIMITIVES) {\n    result[p] = overrides[p] ?? fallback;\n  }\n  return result;\n}\n\n/** TTY: stdin/stdout, text only. Everything else unsupported → degraded to text by server. */\nexport const DEVICE_CAPS_TTY: DeviceCaps = {\n  platform: \"cli\",\n  formFactor: \"terminal\",\n  input: { keyboard: true },\n  primitives: fillPrimitives({ text: \"native\" }, \"unsupported\"),\n};\n\n/** Term: xterm.js in browser, text + terminal subsystem. */\nexport const DEVICE_CAPS_TERM: DeviceCaps = {\n  platform: \"web\",\n  formFactor: \"terminal\",\n  display: { type: \"visual\", color: \"full\", refresh: \"realtime\" },\n  input: { keyboard: true },\n  primitives: fillPrimitives({ text: \"native\", terminal: \"native\" }, \"unsupported\"),\n};\n\n/** Web chat: browser with chat + basic UI. No full AUP. */\nexport const DEVICE_CAPS_WEB_CHAT: DeviceCaps = {\n  platform: \"web\",\n  formFactor: \"desktop\",\n  display: { type: \"visual\", color: \"full\", refresh: \"realtime\" },\n  input: { keyboard: true, touch: true },\n  primitives: fillPrimitives(\n    { text: \"webview\", chat: \"webview\", overlay: \"webview\", media: \"webview\", action: \"webview\" },\n    \"unsupported\",\n  ),\n};\n\n/** Web full: browser with all primitives via WebView rendering. Default for web clients. */\nexport const DEVICE_CAPS_WEB_FULL: DeviceCaps = {\n  platform: \"web\",\n  formFactor: \"desktop\",\n  display: { type: \"visual\", color: \"full\", refresh: \"realtime\" },\n  input: { keyboard: true, touch: true },\n  primitives: fillPrimitives({}, \"webview\"),\n};\n\n// ── Validation ──\n\n/** Validate an AUPNode has required fields. Returns error string or null. */\nexport function validateNode(node: unknown): string | null {\n  if (!node || typeof node !== \"object\") return \"node must be an object\";\n  const n = node as Record<string, unknown>;\n  if (!n.id || typeof n.id !== \"string\") return \"node.id is required and must be a string\";\n  if (!n.type || typeof n.type !== \"string\") return \"node.type is required and must be a string\";\n\n  // Validate src/bind — must be strings, no javascript:\n  if (n.src !== undefined) {\n    if (typeof n.src !== \"string\") return \"node.src must be a string\";\n    if (n.src.toLowerCase().startsWith(\"javascript:\"))\n      return \"node.src cannot use javascript: protocol\";\n  }\n  if (n.bind !== undefined) {\n    if (typeof n.bind !== \"string\") return \"node.bind must be a string\";\n    if (n.bind.toLowerCase().startsWith(\"javascript:\"))\n      return \"node.bind cannot use javascript: protocol\";\n  }\n\n  // Validate events — exec paths must not contain javascript:\n  if (n.events && typeof n.events === \"object\") {\n    for (const [, evt] of Object.entries(n.events as Record<string, unknown>)) {\n      if (evt && typeof evt === \"object\") {\n        const e = evt as Record<string, unknown>;\n        if (typeof e.exec === \"string\" && e.exec.toLowerCase().startsWith(\"javascript:\")) {\n          return \"event exec path cannot use javascript: protocol\";\n        }\n      }\n    }\n  }\n\n  // Recurse children\n  if (n.children && Array.isArray(n.children)) {\n    for (const child of n.children) {\n      const err = validateNode(child);\n      if (err) return err;\n    }\n  }\n  return null;\n}\n\n/** Validate a patch op has required fields. Returns error string or null. */\nexport function validatePatchOp(op: unknown): string | null {\n  if (!op || typeof op !== \"object\") return \"patch op must be an object\";\n  const o = op as Record<string, unknown>;\n  const opType = o.op;\n\n  switch (opType) {\n    case \"create\":\n      if (!o.id || typeof o.id !== \"string\") return \"create op requires id\";\n      if (!o.parentId || typeof o.parentId !== \"string\") return \"create op requires parentId\";\n      if (!o.node) return \"create op requires node\";\n      return validateNode(o.node);\n    case \"update\":\n      if (!o.id || typeof o.id !== \"string\") return \"update op requires id\";\n      return null;\n    case \"remove\":\n      if (!o.id || typeof o.id !== \"string\") return \"remove op requires id\";\n      return null;\n    case \"reorder\":\n      if (!o.id || typeof o.id !== \"string\") return \"reorder op requires id\";\n      if (!o.parentId || typeof o.parentId !== \"string\") return \"reorder op requires parentId\";\n      if (typeof o.index !== \"number\") return \"reorder op requires numeric index\";\n      return null;\n    default:\n      return `unknown patch op type: ${String(opType)}`;\n  }\n}\n"],"mappings":"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"}

package/dist/backend.cjs

@@ -0,0 +1,14 @@
+
+//#region src/backend.ts
+/** Type guard: does this backend support per-client session management? */
+function isSessionAware(b) {
+	return "setSessionFactory" in b && typeof b.setSessionFactory === "function";
+}
+/** Type guard: does this backend support AUP message push to sessions/channels? */
+function isAUPTransport(b) {
+	return "sendToSession" in b && typeof b.sendToSession === "function";
+}
+
+//#endregion
+exports.isAUPTransport = isAUPTransport;
+exports.isSessionAware = isSessionAware;

package/dist/backend.d.cts

@@ -0,0 +1,104 @@
+//#region src/backend.d.ts
+/**
+ * UIBackend — pluggable I/O backend interface.
+ *
+ * Each backend (tty, web, telegram) implements this interface
+ * to provide the actual I/O channel for the UI provider.
+ */
+interface UIBackend {
+  /** Backend type identifier */
+  readonly type: string;
+  /** Supported output formats */
+  readonly supportedFormats: string[];
+  /** Capabilities of this backend */
+  readonly capabilities: string[];
+  /** Write content to the output channel */
+  write(content: string, options?: WriteOptions): Promise<void>;
+  /** Read input from the user (blocks until input available or timeout) */
+  read(options?: ReadOptions): Promise<string>;
+  /**
+   * Prompt the user for input with specific type.
+   * Returns the user's response.
+   */
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  /** Send a non-blocking notification */
+  notify(message: string): Promise<void>;
+  /** Clear the output channel */
+  clear(): Promise<void>;
+  /** Check if there is pending input available */
+  hasPendingInput(): boolean;
+  /** Get viewport/dimension info */
+  getViewport(): ViewportInfo;
+  /** Cleanup resources */
+  dispose(): Promise<void>;
+  /** Navigate to a page (optional — for page-capable backends) */
+  navigate?(pageId: string, content: string, format?: string, layout?: Record<string, string>): Promise<void>;
+}
+interface WriteOptions {
+  format?: string;
+  component?: string;
+  componentProps?: Record<string, unknown>;
+}
+interface ReadOptions {
+  timeout?: number;
+}
+interface PromptOptions {
+  message: string;
+  type: "text" | "password" | "confirm" | "select" | "multiselect";
+  options?: string[];
+  defaultValue?: string | boolean;
+}
+type PromptResult = string | boolean | string[];
+interface ViewportInfo {
+  cols?: number;
+  rows?: number;
+  width?: number;
+  height?: number;
+}
+interface FormField {
+  name: string;
+  label: string;
+  type: "text" | "number" | "password" | "select" | "checkbox" | "textarea";
+  options?: string[];
+  defaultValue?: string | number | boolean;
+  required?: boolean;
+}
+/** Callback types for transport handler registration */
+type SessionFactory = (endpoint: string, requestedSessionId?: string, requestedSessionToken?: string, caps?: Record<string, unknown>) => {
+  sessionId: string;
+  sessionToken?: string;
+};
+type AupEventHandler = (msg: {
+  nodeId: string;
+  event: string;
+  data?: Record<string, unknown>;
+}, sessionId?: string, channelId?: string) => Promise<unknown>;
+type ChannelJoinHandler = (channelId: string, send: (msg: Record<string, unknown>) => void) => void;
+type SessionJoinHandler = (sessionId: string, clientVersion: number, send: (msg: Record<string, unknown>) => void) => void;
+type PageResolver = (pageId: string, sessionId?: string, sessionToken?: string) => Promise<{
+  content: string;
+  format: string;
+} | null>;
+/** Backend that manages per-client sessions (e.g. WebSocket-based backends). */
+interface SessionAwareBackend {
+  setSessionFactory(fn: SessionFactory): void;
+}
+/** Backend that can push AUP messages to sessions and live channels. */
+interface AUPTransportBackend extends SessionAwareBackend {
+  sendToSession(sessionId: string, msg: Record<string, unknown>): void;
+  sendToLiveChannel(channelId: string, msg: Record<string, unknown>): void;
+  broadcastRaw(msg: Record<string, unknown>): void;
+  getActiveChannelIds(): string[];
+  setAupEventHandler(fn: AupEventHandler): void;
+  setChannelJoinHandler(fn: ChannelJoinHandler): void;
+  setSessionJoinHandler(fn: SessionJoinHandler): void;
+  setPageResolver(fn: PageResolver): void;
+  setAFS(afs: unknown): void;
+}
+/** Type guard: does this backend support per-client session management? */
+declare function isSessionAware(b: UIBackend): b is UIBackend & SessionAwareBackend;
+/** Type guard: does this backend support AUP message push to sessions/channels? */
+declare function isAUPTransport(b: UIBackend): b is UIBackend & AUPTransportBackend;
+//#endregion
+export { AUPTransportBackend, AupEventHandler, ChannelJoinHandler, FormField, PageResolver, PromptOptions, PromptResult, ReadOptions, SessionAwareBackend, SessionFactory, SessionJoinHandler, UIBackend, ViewportInfo, WriteOptions, isAUPTransport, isSessionAware };
+//# sourceMappingURL=backend.d.cts.map

package/dist/backend.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.cts","names":[],"sources":["../src/backend.ts"],"mappings":";;AAMA;;;;;UAAiB,SAAA;EAcc;EAAA,SAZpB,IAAA;EAkB+B;EAAA,SAf/B,gBAAA;EAkBgB;EAAA,SAfhB,YAAA;EAwBM;EArBf,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,YAAA,GAAe,OAAA;EA+BrC;EA5BX,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;EA6BnB;;;;EAvBV,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EATxC;EAYA,MAAA,CAAO,OAAA,WAAkB,OAAA;EAZQ;EAejC,KAAA,IAAS,OAAA;EAfuC;EAkBhD,eAAA;EAfe;EAkBf,WAAA,IAAe,YAAA;EAlBc;EAqB7B,OAAA,IAAW,OAAA;EAfK;EAkBhB,QAAA,EACE,MAAA,UACA,OAAA,UACA,MAAA,WACA,MAAA,GAAS,MAAA,mBACR,OAAA;AAAA;AAAA,UAGY,YAAA;EACf,MAAA;EACA,SAAA;EACA,cAAA,GAAiB,MAAA;AAAA;AAAA,UAGF,WAAA;EACf,OAAA;AAAA;AAAA,UAGe,aAAA;EACf,OAAA;EACA,IAAA;EACA,OAAA;EACA,YAAA;AAAA;AAAA,KAGU,YAAA;AAAA,UAEK,YAAA;EACf,IAAA;EACA,IAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,YAAA;EACA,QAAA;AAAA;;KAMU,cAAA,IACV,QAAA,UACA,kBAAA,WACA,qBAAA,WACA,IAAA,GAAO,MAAA;EACF,SAAA;EAAmB,YAAA;AAAA;AAAA,KAEd,eAAA,IACV,GAAA;EAAO,MAAA;EAAgB,KAAA;EAAe,IAAA,GAAO,MAAA;AAAA,GAC7C,SAAA,WACA,SAAA,cACG,OAAA;AAAA,KAEO,kBAAA,IACV,SAAA,UACA,IAAA,GAAO,GAAA,EAAK,MAAA;AAAA,KAGF,kBAAA,IACV,SAAA,UACA,aAAA,UACA,IAAA,GAAO,GAAA,EAAK,MAAA;AAAA,KAGF,YAAA,IACV,MAAA,UACA,SAAA,WACA,YAAA,cACG,OAAA;EAAU,OAAA;EAAiB,MAAA;AAAA;AAjDhC;AAAA,UAoDiB,mBAAA;EACf,iBAAA,CAAkB,EAAA,EAAI,cAAA;AAAA;;UAIP,mBAAA,SAA4B,mBAAA;EAC3C,aAAA,CAAc,SAAA,UAAmB,GAAA,EAAK,MAAA;EACtC,iBAAA,CAAkB,SAAA,UAAmB,GAAA,EAAK,MAAA;EAC1C,YAAA,CAAa,GAAA,EAAK,MAAA;EAClB,mBAAA;EACA,kBAAA,CAAmB,EAAA,EAAI,eAAA;EACvB,qBAAA,CAAsB,EAAA,EAAI,kBAAA;EAC1B,qBAAA,CAAsB,EAAA,EAAI,kBAAA;EAC1B,eAAA,CAAgB,EAAA,EAAI,YAAA;EACpB,MAAA,CAAO,GAAA;AAAA;;iBAIO,cAAA,CAAe,CAAA,EAAG,SAAA,GAAY,CAAA,IAAK,SAAA,GAAY,mBAAA;;iBAQ/C,cAAA,CAAe,CAAA,EAAG,SAAA,GAAY,CAAA,IAAK,SAAA,GAAY,mBAAA"}

package/dist/backend.d.mts

@@ -0,0 +1,104 @@
+//#region src/backend.d.ts
+/**
+ * UIBackend — pluggable I/O backend interface.
+ *
+ * Each backend (tty, web, telegram) implements this interface
+ * to provide the actual I/O channel for the UI provider.
+ */
+interface UIBackend {
+  /** Backend type identifier */
+  readonly type: string;
+  /** Supported output formats */
+  readonly supportedFormats: string[];
+  /** Capabilities of this backend */
+  readonly capabilities: string[];
+  /** Write content to the output channel */
+  write(content: string, options?: WriteOptions): Promise<void>;
+  /** Read input from the user (blocks until input available or timeout) */
+  read(options?: ReadOptions): Promise<string>;
+  /**
+   * Prompt the user for input with specific type.
+   * Returns the user's response.
+   */
+  prompt(options: PromptOptions): Promise<PromptResult>;
+  /** Send a non-blocking notification */
+  notify(message: string): Promise<void>;
+  /** Clear the output channel */
+  clear(): Promise<void>;
+  /** Check if there is pending input available */
+  hasPendingInput(): boolean;
+  /** Get viewport/dimension info */
+  getViewport(): ViewportInfo;
+  /** Cleanup resources */
+  dispose(): Promise<void>;
+  /** Navigate to a page (optional — for page-capable backends) */
+  navigate?(pageId: string, content: string, format?: string, layout?: Record<string, string>): Promise<void>;
+}
+interface WriteOptions {
+  format?: string;
+  component?: string;
+  componentProps?: Record<string, unknown>;
+}
+interface ReadOptions {
+  timeout?: number;
+}
+interface PromptOptions {
+  message: string;
+  type: "text" | "password" | "confirm" | "select" | "multiselect";
+  options?: string[];
+  defaultValue?: string | boolean;
+}
+type PromptResult = string | boolean | string[];
+interface ViewportInfo {
+  cols?: number;
+  rows?: number;
+  width?: number;
+  height?: number;
+}
+interface FormField {
+  name: string;
+  label: string;
+  type: "text" | "number" | "password" | "select" | "checkbox" | "textarea";
+  options?: string[];
+  defaultValue?: string | number | boolean;
+  required?: boolean;
+}
+/** Callback types for transport handler registration */
+type SessionFactory = (endpoint: string, requestedSessionId?: string, requestedSessionToken?: string, caps?: Record<string, unknown>) => {
+  sessionId: string;
+  sessionToken?: string;
+};
+type AupEventHandler = (msg: {
+  nodeId: string;
+  event: string;
+  data?: Record<string, unknown>;
+}, sessionId?: string, channelId?: string) => Promise<unknown>;
+type ChannelJoinHandler = (channelId: string, send: (msg: Record<string, unknown>) => void) => void;
+type SessionJoinHandler = (sessionId: string, clientVersion: number, send: (msg: Record<string, unknown>) => void) => void;
+type PageResolver = (pageId: string, sessionId?: string, sessionToken?: string) => Promise<{
+  content: string;
+  format: string;
+} | null>;
+/** Backend that manages per-client sessions (e.g. WebSocket-based backends). */
+interface SessionAwareBackend {
+  setSessionFactory(fn: SessionFactory): void;
+}
+/** Backend that can push AUP messages to sessions and live channels. */
+interface AUPTransportBackend extends SessionAwareBackend {
+  sendToSession(sessionId: string, msg: Record<string, unknown>): void;
+  sendToLiveChannel(channelId: string, msg: Record<string, unknown>): void;
+  broadcastRaw(msg: Record<string, unknown>): void;
+  getActiveChannelIds(): string[];
+  setAupEventHandler(fn: AupEventHandler): void;
+  setChannelJoinHandler(fn: ChannelJoinHandler): void;
+  setSessionJoinHandler(fn: SessionJoinHandler): void;
+  setPageResolver(fn: PageResolver): void;
+  setAFS(afs: unknown): void;
+}
+/** Type guard: does this backend support per-client session management? */
+declare function isSessionAware(b: UIBackend): b is UIBackend & SessionAwareBackend;
+/** Type guard: does this backend support AUP message push to sessions/channels? */
+declare function isAUPTransport(b: UIBackend): b is UIBackend & AUPTransportBackend;
+//#endregion
+export { AUPTransportBackend, AupEventHandler, ChannelJoinHandler, FormField, PageResolver, PromptOptions, PromptResult, ReadOptions, SessionAwareBackend, SessionFactory, SessionJoinHandler, UIBackend, ViewportInfo, WriteOptions, isAUPTransport, isSessionAware };
+//# sourceMappingURL=backend.d.mts.map

package/dist/backend.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.mts","names":[],"sources":["../src/backend.ts"],"mappings":";;AAMA;;;;;UAAiB,SAAA;EAcc;EAAA,SAZpB,IAAA;EAkB+B;EAAA,SAf/B,gBAAA;EAkBgB;EAAA,SAfhB,YAAA;EAwBM;EArBf,KAAA,CAAM,OAAA,UAAiB,OAAA,GAAU,YAAA,GAAe,OAAA;EA+BrC;EA5BX,IAAA,CAAK,OAAA,GAAU,WAAA,GAAc,OAAA;EA6BnB;;;;EAvBV,MAAA,CAAO,OAAA,EAAS,aAAA,GAAgB,OAAA,CAAQ,YAAA;EATxC;EAYA,MAAA,CAAO,OAAA,WAAkB,OAAA;EAZQ;EAejC,KAAA,IAAS,OAAA;EAfuC;EAkBhD,eAAA;EAfe;EAkBf,WAAA,IAAe,YAAA;EAlBc;EAqB7B,OAAA,IAAW,OAAA;EAfK;EAkBhB,QAAA,EACE,MAAA,UACA,OAAA,UACA,MAAA,WACA,MAAA,GAAS,MAAA,mBACR,OAAA;AAAA;AAAA,UAGY,YAAA;EACf,MAAA;EACA,SAAA;EACA,cAAA,GAAiB,MAAA;AAAA;AAAA,UAGF,WAAA;EACf,OAAA;AAAA;AAAA,UAGe,aAAA;EACf,OAAA;EACA,IAAA;EACA,OAAA;EACA,YAAA;AAAA;AAAA,KAGU,YAAA;AAAA,UAEK,YAAA;EACf,IAAA;EACA,IAAA;EACA,KAAA;EACA,MAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,KAAA;EACA,IAAA;EACA,OAAA;EACA,YAAA;EACA,QAAA;AAAA;;KAMU,cAAA,IACV,QAAA,UACA,kBAAA,WACA,qBAAA,WACA,IAAA,GAAO,MAAA;EACF,SAAA;EAAmB,YAAA;AAAA;AAAA,KAEd,eAAA,IACV,GAAA;EAAO,MAAA;EAAgB,KAAA;EAAe,IAAA,GAAO,MAAA;AAAA,GAC7C,SAAA,WACA,SAAA,cACG,OAAA;AAAA,KAEO,kBAAA,IACV,SAAA,UACA,IAAA,GAAO,GAAA,EAAK,MAAA;AAAA,KAGF,kBAAA,IACV,SAAA,UACA,aAAA,UACA,IAAA,GAAO,GAAA,EAAK,MAAA;AAAA,KAGF,YAAA,IACV,MAAA,UACA,SAAA,WACA,YAAA,cACG,OAAA;EAAU,OAAA;EAAiB,MAAA;AAAA;AAjDhC;AAAA,UAoDiB,mBAAA;EACf,iBAAA,CAAkB,EAAA,EAAI,cAAA;AAAA;;UAIP,mBAAA,SAA4B,mBAAA;EAC3C,aAAA,CAAc,SAAA,UAAmB,GAAA,EAAK,MAAA;EACtC,iBAAA,CAAkB,SAAA,UAAmB,GAAA,EAAK,MAAA;EAC1C,YAAA,CAAa,GAAA,EAAK,MAAA;EAClB,mBAAA;EACA,kBAAA,CAAmB,EAAA,EAAI,eAAA;EACvB,qBAAA,CAAsB,EAAA,EAAI,kBAAA;EAC1B,qBAAA,CAAsB,EAAA,EAAI,kBAAA;EAC1B,eAAA,CAAgB,EAAA,EAAI,YAAA;EACpB,MAAA,CAAO,GAAA;AAAA;;iBAIO,cAAA,CAAe,CAAA,EAAG,SAAA,GAAY,CAAA,IAAK,SAAA,GAAY,mBAAA;;iBAQ/C,cAAA,CAAe,CAAA,EAAG,SAAA,GAAY,CAAA,IAAK,SAAA,GAAY,mBAAA"}

package/dist/backend.mjs

@@ -0,0 +1,13 @@
+//#region src/backend.ts
+/** Type guard: does this backend support per-client session management? */
+function isSessionAware(b) {
+	return "setSessionFactory" in b && typeof b.setSessionFactory === "function";
+}
+/** Type guard: does this backend support AUP message push to sessions/channels? */
+function isAUPTransport(b) {
+	return "sendToSession" in b && typeof b.sendToSession === "function";
+}
+
+//#endregion
+export { isAUPTransport, isSessionAware };
+//# sourceMappingURL=backend.mjs.map

package/dist/backend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.mjs","names":[],"sources":["../src/backend.ts"],"sourcesContent":["/**\n * UIBackend — pluggable I/O backend interface.\n *\n * Each backend (tty, web, telegram) implements this interface\n * to provide the actual I/O channel for the UI provider.\n */\nexport interface UIBackend {\n  /** Backend type identifier */\n  readonly type: string;\n\n  /** Supported output formats */\n  readonly supportedFormats: string[];\n\n  /** Capabilities of this backend */\n  readonly capabilities: string[];\n\n  /** Write content to the output channel */\n  write(content: string, options?: WriteOptions): Promise<void>;\n\n  /** Read input from the user (blocks until input available or timeout) */\n  read(options?: ReadOptions): Promise<string>;\n\n  /**\n   * Prompt the user for input with specific type.\n   * Returns the user's response.\n   */\n  prompt(options: PromptOptions): Promise<PromptResult>;\n\n  /** Send a non-blocking notification */\n  notify(message: string): Promise<void>;\n\n  /** Clear the output channel */\n  clear(): Promise<void>;\n\n  /** Check if there is pending input available */\n  hasPendingInput(): boolean;\n\n  /** Get viewport/dimension info */\n  getViewport(): ViewportInfo;\n\n  /** Cleanup resources */\n  dispose(): Promise<void>;\n\n  /** Navigate to a page (optional — for page-capable backends) */\n  navigate?(\n    pageId: string,\n    content: string,\n    format?: string,\n    layout?: Record<string, string>,\n  ): Promise<void>;\n}\n\nexport interface WriteOptions {\n  format?: string;\n  component?: string;\n  componentProps?: Record<string, unknown>;\n}\n\nexport interface ReadOptions {\n  timeout?: number;\n}\n\nexport interface PromptOptions {\n  message: string;\n  type: \"text\" | \"password\" | \"confirm\" | \"select\" | \"multiselect\";\n  options?: string[];\n  defaultValue?: string | boolean;\n}\n\nexport type PromptResult = string | boolean | string[];\n\nexport interface ViewportInfo {\n  cols?: number;\n  rows?: number;\n  width?: number;\n  height?: number;\n}\n\nexport interface FormField {\n  name: string;\n  label: string;\n  type: \"text\" | \"number\" | \"password\" | \"select\" | \"checkbox\" | \"textarea\";\n  options?: string[];\n  defaultValue?: string | number | boolean;\n  required?: boolean;\n}\n\n// ── Transport Interfaces (D16: Transport ≠ Capability) ──\n\n/** Callback types for transport handler registration */\nexport type SessionFactory = (\n  endpoint: string,\n  requestedSessionId?: string,\n  requestedSessionToken?: string,\n  caps?: Record<string, unknown>,\n) => { sessionId: string; sessionToken?: string };\n\nexport type AupEventHandler = (\n  msg: { nodeId: string; event: string; data?: Record<string, unknown> },\n  sessionId?: string,\n  channelId?: string,\n) => Promise<unknown>;\n\nexport type ChannelJoinHandler = (\n  channelId: string,\n  send: (msg: Record<string, unknown>) => void,\n) => void;\n\nexport type SessionJoinHandler = (\n  sessionId: string,\n  clientVersion: number,\n  send: (msg: Record<string, unknown>) => void,\n) => void;\n\nexport type PageResolver = (\n  pageId: string,\n  sessionId?: string,\n  sessionToken?: string,\n) => Promise<{ content: string; format: string } | null>;\n\n/** Backend that manages per-client sessions (e.g. WebSocket-based backends). */\nexport interface SessionAwareBackend {\n  setSessionFactory(fn: SessionFactory): void;\n}\n\n/** Backend that can push AUP messages to sessions and live channels. */\nexport interface AUPTransportBackend extends SessionAwareBackend {\n  sendToSession(sessionId: string, msg: Record<string, unknown>): void;\n  sendToLiveChannel(channelId: string, msg: Record<string, unknown>): void;\n  broadcastRaw(msg: Record<string, unknown>): void;\n  getActiveChannelIds(): string[];\n  setAupEventHandler(fn: AupEventHandler): void;\n  setChannelJoinHandler(fn: ChannelJoinHandler): void;\n  setSessionJoinHandler(fn: SessionJoinHandler): void;\n  setPageResolver(fn: PageResolver): void;\n  setAFS(afs: unknown): void;\n}\n\n/** Type guard: does this backend support per-client session management? */\nexport function isSessionAware(b: UIBackend): b is UIBackend & SessionAwareBackend {\n  return (\n    \"setSessionFactory\" in b &&\n    typeof (b as Record<string, unknown>).setSessionFactory === \"function\"\n  );\n}\n\n/** Type guard: does this backend support AUP message push to sessions/channels? */\nexport function isAUPTransport(b: UIBackend): b is UIBackend & AUPTransportBackend {\n  return \"sendToSession\" in b && typeof (b as Record<string, unknown>).sendToSession === \"function\";\n}\n"],"mappings":";;AA2IA,SAAgB,eAAe,GAAoD;AACjF,QACE,uBAAuB,KACvB,OAAQ,EAA8B,sBAAsB;;;AAKhE,SAAgB,eAAe,GAAoD;AACjF,QAAO,mBAAmB,KAAK,OAAQ,EAA8B,kBAAkB"}

package/dist/degradation.cjs

@@ -0,0 +1,85 @@
+
+//#region src/degradation.ts
+/**
+* Each entry maps a primitive type to its ordered degradation chain.
+* The chain is tried left-to-right; the first supported type wins.
+* "unsupported" means no meaningful fallback exists.
+*/
+const DEGRADATION_CHAINS = {
+	globe: [
+		"map",
+		"media",
+		"text"
+	],
+	chart: ["table", "text"],
+	map: ["media", "text"],
+	editor: ["input", "text"],
+	terminal: ["text"],
+	canvas: ["media", "text"],
+	rtc: ["unsupported"],
+	calendar: ["table", "text"],
+	time: ["text"],
+	overlay: ["text"]
+};
+/**
+* Walk the AUP tree and degrade unsupported primitives.
+* Returns a new tree (does not mutate the original).
+*/
+function degradeTree(node, caps) {
+	return degradeNode(node, caps);
+}
+function isSupported(primitiveType, caps) {
+	const cap = caps.primitives[primitiveType];
+	return cap === "native" || cap === "webview" || cap === "partial";
+}
+function degradeNode(node, caps) {
+	let result = degradeNodeType(node, caps);
+	if (result.children && result.children.length > 0) {
+		const degradedChildren = result.children.map((child) => degradeNode(child, caps));
+		if (degradedChildren.some((c, i) => c !== result.children[i])) result = {
+			...result,
+			children: degradedChildren
+		};
+	}
+	return result;
+}
+function degradeNodeType(node, caps) {
+	const nodeType = node.type;
+	if (isSupported(nodeType, caps)) return node;
+	const chain = DEGRADATION_CHAINS[nodeType];
+	if (!chain) return node;
+	const originalType = nodeType;
+	for (const fallbackType of chain) {
+		if (fallbackType === "unsupported") return {
+			...node,
+			type: "text",
+			props: {
+				...node.props,
+				_degradedFrom: originalType,
+				_unsupported: true,
+				content: node.props?.content ?? `[${originalType}: unsupported on this device]`
+			}
+		};
+		if (isSupported(fallbackType, caps)) return {
+			...node,
+			type: fallbackType,
+			props: {
+				...node.props,
+				_degradedFrom: originalType
+			}
+		};
+	}
+	return {
+		...node,
+		type: "text",
+		props: {
+			...node.props,
+			_degradedFrom: originalType,
+			content: node.props?.content ?? `[${originalType}: degraded to text]`
+		}
+	};
+}
+
+//#endregion
+exports.DEGRADATION_CHAINS = DEGRADATION_CHAINS;
+exports.degradeTree = degradeTree;

package/dist/degradation.d.cts

@@ -0,0 +1,17 @@
+import { AUPNode, DeviceCaps } from "./aup-types.cjs";
+
+//#region src/degradation.d.ts
+/**
+ * Each entry maps a primitive type to its ordered degradation chain.
+ * The chain is tried left-to-right; the first supported type wins.
+ * "unsupported" means no meaningful fallback exists.
+ */
+declare const DEGRADATION_CHAINS: Record<string, string[]>;
+/**
+ * Walk the AUP tree and degrade unsupported primitives.
+ * Returns a new tree (does not mutate the original).
+ */
+declare function degradeTree(node: AUPNode, caps: DeviceCaps): AUPNode;
+//#endregion
+export { DEGRADATION_CHAINS, degradeTree };
+//# sourceMappingURL=degradation.d.cts.map

package/dist/degradation.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degradation.d.cts","names":[],"sources":["../src/degradation.ts"],"mappings":";;;AAqCA;;;;;AAAA,cApBa,kBAAA,EAAoB,MAAA;;;;;iBAoBjB,WAAA,CAAY,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,UAAA,GAAa,OAAA"}

package/dist/degradation.d.mts

@@ -0,0 +1,17 @@
+import { AUPNode, DeviceCaps } from "./aup-types.mjs";
+
+//#region src/degradation.d.ts
+/**
+ * Each entry maps a primitive type to its ordered degradation chain.
+ * The chain is tried left-to-right; the first supported type wins.
+ * "unsupported" means no meaningful fallback exists.
+ */
+declare const DEGRADATION_CHAINS: Record<string, string[]>;
+/**
+ * Walk the AUP tree and degrade unsupported primitives.
+ * Returns a new tree (does not mutate the original).
+ */
+declare function degradeTree(node: AUPNode, caps: DeviceCaps): AUPNode;
+//#endregion
+export { DEGRADATION_CHAINS, degradeTree };
+//# sourceMappingURL=degradation.d.mts.map

package/dist/degradation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"degradation.d.mts","names":[],"sources":["../src/degradation.ts"],"mappings":";;;AAqCA;;;;;AAAA,cApBa,kBAAA,EAAoB,MAAA;;;;;iBAoBjB,WAAA,CAAY,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,UAAA,GAAa,OAAA"}