@baguette-studios/kernl-ui-core 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+import type { AgentAsset, AgentInFlightSubmitMode, AgentNavRef } from "@baguette-studios/kernl-core";
+export type AgentRenderable = unknown;
+export type AgentChatRole = "system" | "user" | "assistant" | "tool";
+export type AgentStatus = "idle" | "running" | "waiting" | "blocked" | "error" | "complete" | (string & {});
+export type AgentTone = "neutral" | "active" | "waiting" | "success" | "danger";
+export type AgentRisk = "low" | "medium" | "high";
+export interface AgentCommand<TContent = AgentRenderable> {
+    id: string;
+    label: string;
+    description?: TContent | undefined;
+    shortcut?: string | undefined;
+    disabled?: boolean | undefined;
+    run?: ((input?: string) => void | Promise<void>) | undefined;
+}
+export interface AgentQuickAction<TContent = AgentRenderable> {
+    id: string;
+    label: string;
+    prompt: string;
+    description?: TContent | undefined;
+    scopeId?: string | undefined;
+    disabled?: boolean | undefined;
+    run?: ((action: AgentQuickAction<TContent>) => void | Promise<void>) | undefined;
+}
+export interface AgentChatMessage<TContent = AgentRenderable> {
+    id: string;
+    role: AgentChatRole;
+    content: TContent;
+    nav?: AgentNavRef[] | undefined;
+    assets?: readonly AgentAsset[] | undefined;
+    agentId?: string | undefined;
+    agentName?: TContent | undefined;
+    createdAt?: Date | string | number | undefined;
+    status?: AgentStatus | undefined;
+}
+export interface AgentChatThread<TContent = AgentRenderable> {
+    id: string;
+    title: TContent;
+    description?: TContent | undefined;
+    updatedAt?: Date | string | number | undefined;
+    messageCount?: number | undefined;
+    status?: AgentStatus | undefined;
+    statusLabel?: TContent | undefined;
+    active?: boolean | undefined;
+    waitingForInput?: boolean | undefined;
+    hasUnseenUpdates?: boolean | undefined;
+}
+export interface AgentActionRequest<TContent = AgentRenderable> {
+    id: string;
+    title: string;
+    description?: TContent | undefined;
+    command?: string | undefined;
+    subject?: string | undefined;
+    risk?: AgentRisk | undefined;
+    status?: "pending" | "approved" | "rejected" | "running" | undefined;
+    requestedBy?: string | undefined;
+    requestedAt?: Date | string | number | undefined;
+    metadata?: Record<string, TContent> | undefined;
+    onApprove?: ((action: AgentActionRequest<TContent>) => void | Promise<void>) | undefined;
+    onReject?: ((action: AgentActionRequest<TContent>) => void | Promise<void>) | undefined;
+}
+export interface AgentActivityItem<TContent = AgentRenderable> {
+    id: string;
+    title: string;
+    detail?: TContent | undefined;
+    status?: AgentStatus | undefined;
+    actor?: string | undefined;
+    at?: Date | string | number | undefined;
+    metadata?: TContent | undefined;
+}
+export type AgentPromptSubmitResult = void | boolean | {
+    accepted?: boolean | undefined;
+};
+export type AgentPromptSubmitOptions = {
+    mode?: AgentInFlightSubmitMode | undefined;
+    submittedWhileRunning?: boolean | undefined;
+    assets?: readonly AgentAsset[] | undefined;
+};
+export interface AgentUiSnapshot<TContent = AgentRenderable> {
+    status: AgentStatus;
+    statusLabel?: TContent | undefined;
+    statusDetail?: TContent | undefined;
+    goal?: TContent | undefined;
+    currentTask?: TContent | undefined;
+    model?: TContent | undefined;
+    commands: AgentCommand<TContent>[];
+    quickActions: AgentQuickAction<TContent>[];
+    actions: AgentActionRequest<TContent>[];
+    activity: AgentActivityItem<TContent>[];
+    onCommand?: ((command: string, input?: string) => void | Promise<void>) | undefined;
+    onPrompt?: ((prompt: string, options?: AgentPromptSubmitOptions) => AgentPromptSubmitResult | Promise<AgentPromptSubmitResult>) | undefined;
+    onApproveAction?: ((action: AgentActionRequest<TContent>) => void | Promise<void>) | undefined;
+    onRejectAction?: ((action: AgentActionRequest<TContent>) => void | Promise<void>) | undefined;
+}
+export interface AgentComponentProps {
+    className?: string | undefined;
+}
+//# 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 @@
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+import type { AgentActionRequest, AgentStatus, AgentTone } from "./types";
+export declare function cx(...parts: Array<string | false | null | undefined>): string;
+export declare function statusTone(status: AgentStatus | undefined): AgentTone;
+export declare function humanizeStatus(status: AgentStatus | undefined): string;
+export declare function riskTone<TContent>(action: AgentActionRequest<TContent> | undefined): AgentTone;
+export declare function formatTimestamp(value: Date | string | number | undefined): string | undefined;
+export declare function formatRelativeAge(value: Date | string | number | undefined, now?: number): string | undefined;
+export declare function firstPendingAction<TContent>(actions: AgentActionRequest<TContent>[]): AgentActionRequest<TContent> | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE1E,wBAAgB,EAAE,CAAC,GAAG,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE7E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAcrE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAQtE;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,GAAG,SAAS,CAW9F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAc7F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS,CA+BjH;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EACzC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EAAE,GACtC,kBAAkB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAE1C"}

package/dist/utils.js

@@ -0,0 +1,80 @@
+export function cx(...parts) {
+    return parts.filter(Boolean).join(" ");
+}
+export function statusTone(status) {
+    switch (status) {
+        case "running":
+            return "active";
+        case "waiting":
+        case "blocked":
+            return "waiting";
+        case "complete":
+            return "success";
+        case "error":
+            return "danger";
+        default:
+            return "neutral";
+    }
+}
+export function humanizeStatus(status) {
+    if (!status) {
+        return "Idle";
+    }
+    return status
+        .replace(/[-_]+/g, " ")
+        .replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+export function riskTone(action) {
+    switch (action?.risk) {
+        case "high":
+            return "danger";
+        case "medium":
+            return "waiting";
+        case "low":
+            return "success";
+        default:
+            return "neutral";
+    }
+}
+export function formatTimestamp(value) {
+    if (!value) {
+        return undefined;
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return String(value);
+    }
+    return new Intl.DateTimeFormat(undefined, {
+        hour: "2-digit",
+        minute: "2-digit"
+    }).format(date);
+}
+export function formatRelativeAge(value, now = Date.now()) {
+    if (!value) {
+        return undefined;
+    }
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return String(value);
+    }
+    const seconds = Math.max(0, Math.floor((now - date.getTime()) / 1000));
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) {
+        return `${minutes}m`;
+    }
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24) {
+        return `${hours}h`;
+    }
+    const days = Math.floor(hours / 24);
+    if (days < 30) {
+        return `${days}d`;
+    }
+    return `${Math.max(1, Math.floor(days / 30))}mo`;
+}
+export function firstPendingAction(actions) {
+    return actions.find((action) => !action.status || action.status === "pending") ?? actions[0];
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@baguette-studios/kernl-ui-core",
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "description": "Framework-neutral UI model, theme tokens, and shared styles for kernl.",
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jules-Astier/agent-context.git",
+    "directory": "packages/ui-core"
+  },
+  "homepage": "https://github.com/Jules-Astier/agent-context#readme",
+  "bugs": { "url": "https://github.com/Jules-Astier/agent-context/issues" },
+  "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
+  "sideEffects": ["*.css", "**/*.css"],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./theme": {
+      "types": "./dist/theme.d.ts",
+      "import": "./dist/theme.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./derive": {
+      "types": "./dist/derive.d.ts",
+      "import": "./dist/derive.js"
+    },
+    "./icons": {
+      "types": "./dist/icons.d.ts",
+      "import": "./dist/icons.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js"
+    },
+    "./styles.css": "./dist/styles.css",
+    "./theme.css": "./dist/theme.css",
+    "./tailwind.css": "./dist/tailwind.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && cp src/styles.css src/theme.css src/tailwind.css dist/",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "cd ../.. && vitest run packages/ui-core/src"
+  },
+  "dependencies": {
+    "@baguette-studios/kernl-core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3",
+    "vitest": "^4.1.9"
+  }
+}