agent-enderun 0.5.8 → 0.5.9

package/packages/shared-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-enderun/shared-types",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "Shared TypeScript types for AI-Enderun Framework. Ensures Contract-First synchronization between agents.",
   "author": "Yusuf BEKAR",
   "license": "MIT",
@@ -22,6 +22,9 @@
     "dist",
     "README.md"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "build:watch": "tsc -p tsconfig.json --watch",

package/packages/shared-types/src/api.ts

@@ -0,0 +1,20 @@
+import { TraceID } from "./brands.js";
+
+/**
+ * API Response Wrappers
+ */
+export interface ApiResponse<T> {
+  data: T;
+  meta?: {
+    requestId: TraceID;
+    timestamp: string;
+  };
+}
+
+export interface ApiError {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}

package/packages/shared-types/src/brands.ts

@@ -0,0 +1,12 @@
+/**
+ * Branded Type Utility
+ */
+export type Brand<K, T> = K & { __brand: T };
+
+/**
+ * Entity IDs (Branded)
+ */
+export type TraceID = Brand<string, "TraceID">;
+export type AgentID = Brand<string, "AgentID">;
+export type ProjectID = Brand<string, "ProjectID">;
+export type UserID = Brand<string, "UserID">;

package/packages/shared-types/src/constants.ts

@@ -0,0 +1,34 @@
+import { TraceID } from "./brands.js";
+
+/**
+ * Project Phases
+ */
+export const PROJECT_PHASES = ["PHASE_0", "PHASE_1", "PHASE_2", "PHASE_3", "PHASE_4"] as const;
+export type ProjectPhase = (typeof PROJECT_PHASES)[number];
+
+/**
+ * Execution Profiles
+ */
+export const EXECUTION_PROFILES = ["Lightweight", "Full"] as const;
+export type ExecutionProfile = (typeof EXECUTION_PROFILES)[number];
+
+/**
+ * Task Priorities
+ */
+export const TASK_PRIORITIES = ["P0", "P1", "P2", "P3"] as const;
+export type TaskPriority = (typeof TASK_PRIORITIES)[number];
+
+/**
+ * Task Statuses
+ */
+export const TASK_STATUSES = ["PENDING", "IN_PROGRESS", "BLOCKED", "COMPLETED", "FAILED"] as const;
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+
+/**
+ * Action Types & Status
+ */
+export const ACTION_TYPES = ["CREATE", "MODIFY", "DELETE", "RESEARCH", "ORCHESTRATE"] as const;
+export type ActionType = (typeof ACTION_TYPES)[number];
+
+export const ACTION_STATUSES = ["SUCCESS", "FAILURE", "WAITING"] as const;
+export type ActionStatus = (typeof ACTION_STATUSES)[number];

package/packages/shared-types/src/index.ts

@@ -1,102 +1,12 @@
 /**
- * Agent Enderun — Shared Types
+ * Agent Enderun — Shared Types (Modular)
  * 
  * This file is the Single Source of Truth for all Backend and Frontend communication.
- * All IDs use the Branded Types pattern for type safety.
+ * All modules are exported from here for central access.
  */
 
-/**
- * Branded Type Utility
- */
-export type Brand<K, T> = K & { __brand: T };
-
-/**
- * Entity IDs (Branded)
- */
-export type TraceID = Brand<string, "TraceID">;
-export type AgentID = Brand<string, "AgentID">;
-export type ProjectID = Brand<string, "ProjectID">;
-export type UserID = Brand<string, "UserID">;
-
-/**
- * Domain Models
- */
-export interface User {
-  id: UserID;
-  email: string;
-  fullName: string;
-  role: "ADMIN" | "DEVELOPER" | "VIEWER";
-  createdAt: string;
-}
-
-export interface UserProfile extends User {
-  avatarUrl?: string;
-  bio?: string;
-  preferences: Record<string, unknown>;
-}
-
-/**
- * Project Status Types
- */
-export type ProjectPhase = "PHASE_0" | "PHASE_1" | "PHASE_2" | "PHASE_3" | "PHASE_4";
-export type ExecutionProfile = "Lightweight" | "Full";
-
-export interface ProjectStatus {
-  phase: ProjectPhase;
-  profile: ExecutionProfile;
-  lastUpdate: string;
-  activeTraceId: TraceID | null;
-  blockers: string[];
-}
-
-/**
- * Task Management Types
- */
-export type TaskPriority = "P0" | "P1" | "P2" | "P3";
-export type TaskStatus = "PENDING" | "IN_PROGRESS" | "BLOCKED" | "COMPLETED" | "FAILED";
-
-export interface Task {
-  id: TraceID;
-  description: string;
-  agent: AgentID;
-  priority: TaskPriority;
-  status: TaskStatus;
-  createdAt: string;
-  updatedAt: string;
-}
-
-/**
- * Audit & Agent Logging Types
- */
-export type ActionType = "CREATE" | "MODIFY" | "DELETE" | "RESEARCH" | "ORCHESTRATE";
-export type ActionStatus = "SUCCESS" | "FAILURE" | "WAITING";
-
-export interface AgentActionLog {
-  timestamp: string;
-  agent: AgentID;
-  action: ActionType;
-  requestId: TraceID | "—";
-  status: ActionStatus;
-  summary: string;
-  files?: string[];
-  details?: Record<string, unknown>;
-}
-
-/**
- * API Response Wrappers
- */
-export interface ApiResponse<T> {
-  data: T;
-  meta?: {
-    requestId: TraceID;
-    timestamp: string;
-  };
-}
-
-export interface ApiError {
-  error: {
-    code: string;
-    message: string;
-    details?: unknown;
-  };
-}
+export * from "./brands.js";
+export * from "./constants.js";
+export * from "./models.js";
+export * from "./api.js";
+export * from "./logs.js";

package/packages/shared-types/src/logs.ts

@@ -0,0 +1,16 @@
+import { TraceID, AgentID } from "./brands.js";
+import { ActionType, ActionStatus } from "./constants.js";
+
+/**
+ * Audit & Agent Logging Types
+ */
+export interface AgentActionLog {
+  timestamp: string;
+  agent: AgentID;
+  action: ActionType;
+  requestId: TraceID | "—";
+  status: ActionStatus;
+  summary: string;
+  files?: string[];
+  details?: Record<string, unknown>;
+}

package/packages/shared-types/src/models.ts

@@ -0,0 +1,66 @@
+import { UserID, TraceID, AgentID } from "./brands.js";
+import { ProjectPhase, ExecutionProfile, TaskPriority, TaskStatus } from "./constants.js";
+
+/**
+ * Base Entity Fields
+ * All domain entities should include these fields.
+ */
+export interface BaseEntity {
+  id: string; // Usually ULID
+  createdAt: string;
+  updatedAt: string;
+  deletedAt?: string | null;
+}
+
+/**
+ * Audit Log Model
+ */
+export interface AuditLog extends BaseEntity {
+  entityName: string;
+  entityId: string;
+  action: "CREATE" | "UPDATE" | "DELETE" | "RESTORE";
+  userId: UserID;
+  previousState?: Record<string, unknown> | null;
+  newState?: Record<string, unknown> | null;
+  traceId: TraceID;
+}
+
+/**
+ * User Model
+ */
+export interface User extends BaseEntity {
+  id: UserID;
+  email: string;
+  fullName: string;
+  role: "ADMIN" | "DEVELOPER" | "VIEWER";
+}
+
+export interface UserProfile extends User {
+  avatarUrl?: string;
+  bio?: string;
+  preferences: Record<string, unknown>;
+}
+
+/**
+ * Project Status
+ */
+export interface ProjectStatus {
+  phase: ProjectPhase;
+  profile: ExecutionProfile;
+  lastUpdate: string;
+  activeTraceId: TraceID | null;
+  blockers: string[];
+}
+
+/**
+ * Task Model
+ */
+export interface Task {
+  id: TraceID;
+  description: string;
+  agent: AgentID;
+  priority: TaskPriority;
+  status: TaskStatus;
+  createdAt: string;
+  updatedAt: string;
+}

package/panda.config.ts

@@ -1,24 +1,98 @@
-import { defineConfig } from "@pandacss/dev"
+import { defineConfig } from "@pandacss/dev";
 
 export default defineConfig({
   // Whether to use css reset
   preflight: true,
-  
+
   // Where to look for your css declarations
   include: [
     "./src/**/*.{js,jsx,ts,tsx}",
     "./pages/**/*.{js,jsx,ts,tsx}",
     "./apps/**/*.{js,jsx,ts,tsx}",
+    "./packages/ui/src/**/*.{ts,tsx}",
   ],
 
   // Files to exclude
   exclude: [],
 
-  // Useful for theme customization
+  // Conditions for Dark Mode and other states
+  conditions: {
+    extend: {
+      dark: ".dark &, [data-theme='dark'] &",
+      light: ".light &, [data-theme='light'] &",
+    },
+  },
+
+  // Theme Customization
   theme: {
-    extend: {}
+    extend: {
+      // Base Tokens (Absolute Values)
+      tokens: {
+        colors: {
+          brand: {
+            50: { value: "#eef2ff" },
+            100: { value: "#e0e7ff" },
+            200: { value: "#c7d2fe" },
+            300: { value: "#a5b4fc" },
+            400: { value: "#818cf8" },
+            500: { value: "#6366f1" },
+            600: { value: "#4f46e5" },
+            700: { value: "#4338ca" },
+            800: { value: "#3730a3" },
+            900: { value: "#312e81" },
+            950: { value: "#1e1b4b" },
+          },
+        },
+        spacing: {
+          container: { value: "1200px" },
+        },
+      },
+      // Semantic Tokens (Theme Aware)
+      semanticTokens: {
+        colors: {
+          bg: {
+            canvas: {
+              value: { base: "{colors.white}", _dark: "{colors.brand.950}" },
+            },
+            surface: {
+              value: { base: "{colors.gray.50}", _dark: "{colors.brand.900}" },
+            },
+            muted: {
+              value: { base: "{colors.gray.100}", _dark: "{colors.brand.800}" },
+            },
+          },
+          text: {
+            default: {
+              value: { base: "{colors.gray.900}", _dark: "{colors.white}" },
+            },
+            muted: {
+              value: { base: "{colors.gray.500}", _dark: "{colors.gray.400}" },
+            },
+            brand: {
+              value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+            },
+          },
+          accent: {
+            default: {
+              value: { base: "{colors.brand.500}", _dark: "{colors.brand.500}" },
+            },
+            emphasis: {
+              value: { base: "{colors.brand.600}", _dark: "{colors.brand.400}" },
+            },
+            fg: {
+              value: { base: "{colors.white}", _dark: "{colors.white}" },
+            },
+          },
+          border: {
+            default: {
+              value: { base: "{colors.gray.200}", _dark: "{colors.brand.800}" },
+            },
+          },
+        },
+      },
+    },
   },
 
   // The output directory for your css system
   outdir: "styled-system",
-})
+});