@taui-standard/core 0.0.1

package/README.md

@@ -0,0 +1,27 @@
+# TAUI Core
+
+The core state management and event normalization logic for the **Terminal Agent UI (TAUI)** standard.
+
+**Author: Tariq Shams**
+
+## Features
+- **Stateless Runtime**: Manages the `TAUIDocument` state.
+- **Event Normalization**: Transforms raw adapter inputs into schema-compliant `TAUIEvent` objects.
+- **Validation-First**: All state changes are strictly validated against `@taui-standard/validator`.
+
+## Installation
+```bash
+npm install @taui-standard/core
+```
+
+## Usage
+```typescript
+import { TAUIRuntime } from '@taui-standard/core';
+
+const runtime = new TAUIRuntime();
+runtime.setDocument(mySpecDoc);
+
+runtime.onEvent((event) => {
+  console.log('Agent received event:', event);
+});
+```

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+import { TAUIEvent, TAUIDocument } from '@taui-standard/validator';
+
+type TAUIEventHandler = (event: TAUIEvent) => void;
+declare class TAUIRuntime {
+    private currentDocument;
+    private eventHandlers;
+    constructor(initialDocument?: TAUIDocument);
+    setDocument(doc: unknown): void;
+    getDocument(): TAUIDocument | null;
+    onEvent(handler: TAUIEventHandler): () => void;
+    dispatchRawEvent(rawEvent: unknown): void;
+}
+
+export { type TAUIEventHandler, TAUIRuntime };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { TAUIEvent, TAUIDocument } from '@taui-standard/validator';
+
+type TAUIEventHandler = (event: TAUIEvent) => void;
+declare class TAUIRuntime {
+    private currentDocument;
+    private eventHandlers;
+    constructor(initialDocument?: TAUIDocument);
+    setDocument(doc: unknown): void;
+    getDocument(): TAUIDocument | null;
+    onEvent(handler: TAUIEventHandler): () => void;
+    dispatchRawEvent(rawEvent: unknown): void;
+}
+
+export { type TAUIEventHandler, TAUIRuntime };

package/dist/index.js

@@ -0,0 +1,61 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TAUIRuntime: () => TAUIRuntime
+});
+module.exports = __toCommonJS(index_exports);
+var import_validator = require("@taui-standard/validator");
+var TAUIRuntime = class {
+  currentDocument = null;
+  eventHandlers = /* @__PURE__ */ new Set();
+  constructor(initialDocument) {
+    if (initialDocument) {
+      this.setDocument(initialDocument);
+    }
+  }
+  setDocument(doc) {
+    const result = (0, import_validator.validateDocument)(doc);
+    if (!result.success) {
+      throw new Error(`Invalid TAUIDocument: ${JSON.stringify(result.error)}`);
+    }
+    this.currentDocument = result.data;
+  }
+  getDocument() {
+    return this.currentDocument;
+  }
+  onEvent(handler) {
+    this.eventHandlers.add(handler);
+    return () => this.eventHandlers.delete(handler);
+  }
+  dispatchRawEvent(rawEvent) {
+    const result = (0, import_validator.validateEvent)(rawEvent);
+    if (result.success) {
+      this.eventHandlers.forEach((handler) => handler(result.data));
+    } else {
+      console.warn("Invalid raw event suppressed:", result.error);
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TAUIRuntime
+});

package/dist/index.mjs

@@ -0,0 +1,36 @@
+// src/index.ts
+import { validateDocument, validateEvent } from "@taui-standard/validator";
+var TAUIRuntime = class {
+  currentDocument = null;
+  eventHandlers = /* @__PURE__ */ new Set();
+  constructor(initialDocument) {
+    if (initialDocument) {
+      this.setDocument(initialDocument);
+    }
+  }
+  setDocument(doc) {
+    const result = validateDocument(doc);
+    if (!result.success) {
+      throw new Error(`Invalid TAUIDocument: ${JSON.stringify(result.error)}`);
+    }
+    this.currentDocument = result.data;
+  }
+  getDocument() {
+    return this.currentDocument;
+  }
+  onEvent(handler) {
+    this.eventHandlers.add(handler);
+    return () => this.eventHandlers.delete(handler);
+  }
+  dispatchRawEvent(rawEvent) {
+    const result = validateEvent(rawEvent);
+    if (result.success) {
+      this.eventHandlers.forEach((handler) => handler(result.data));
+    } else {
+      console.warn("Invalid raw event suppressed:", result.error);
+    }
+  }
+};
+export {
+  TAUIRuntime
+};

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@taui-standard/core",
+  "version": "0.0.1",
+  "description": "Core runtime logic for Terminal Agent UI (TAUI)",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "test": "vitest run",
+    "lint": "eslint src"
+  },
+  "author": "Tariq Shams",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@taui-standard/validator": "^0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,40 @@
+import { TAUIDocument, TAUIEvent, validateDocument, validateEvent } from '@taui-standard/validator';
+
+export type TAUIEventHandler = (event: TAUIEvent) => void;
+
+export class TAUIRuntime {
+  private currentDocument: TAUIDocument | null = null;
+  private eventHandlers: Set<TAUIEventHandler> = new Set();
+
+  constructor(initialDocument?: TAUIDocument) {
+    if (initialDocument) {
+      this.setDocument(initialDocument);
+    }
+  }
+
+  public setDocument(doc: unknown): void {
+    const result = validateDocument(doc);
+    if (!result.success) {
+      throw new Error(`Invalid TAUIDocument: ${JSON.stringify(result.error)}`);
+    }
+    this.currentDocument = result.data;
+  }
+
+  public getDocument(): TAUIDocument | null {
+    return this.currentDocument;
+  }
+
+  public onEvent(handler: TAUIEventHandler): () => void {
+    this.eventHandlers.add(handler);
+    return () => this.eventHandlers.delete(handler);
+  }
+
+  public dispatchRawEvent(rawEvent: unknown): void {
+    const result = validateEvent(rawEvent);
+    if (result.success) {
+      this.eventHandlers.forEach(handler => handler(result.data));
+    } else {
+      console.warn('Invalid raw event suppressed:', result.error);
+    }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}