@baguette-studios/kernl-ui-core 0.1.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2026 Jules Astier
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,11 @@
+# @baguette-studios/kernl-ui-core
+
+Framework-neutral assistant UI state, theme tokens, icons, and shared styles for Kernl framework adapters.
+
+```bash
+npm install @baguette-studios/kernl-ui-core
+```
+
+React applications should normally install `@baguette-studios/kernl-ui`. Use this package directly when building a framework adapter or applying the shared CSS variable contract.
+
+Available styles include `@baguette-studios/kernl-ui-core/styles.css`, `@baguette-studios/kernl-ui-core/theme.css`, and `@baguette-studios/kernl-ui-core/tailwind.css`.

package/dist/derive.d.ts

@@ -0,0 +1,34 @@
+import type { AgentInFlightSubmitMode, AgentSessionInput, AgentSnapshot, AuditEvent, ApprovalRequest, ToolCall, ToolResult } from "@baguette-studios/kernl-core";
+import type { AgentActionRequest, AgentActivityItem, AgentCommand, AgentQuickAction, AgentStatus, AgentUiSnapshot } from "./types";
+export type OptionalAgentUiOverride<T> = {
+    [Property in keyof T]?: T[Property] | undefined;
+};
+export type AgentUiOverrides<TContent = string> = OptionalAgentUiOverride<Omit<AgentUiSnapshot<TContent>, "commands" | "quickActions" | "actions" | "activity">> & {
+    commands?: AgentUiSnapshot<TContent>["commands"] | undefined;
+    quickActions?: AgentUiSnapshot<TContent>["quickActions"] | undefined;
+    actions?: AgentUiSnapshot<TContent>["actions"] | undefined;
+    activity?: AgentUiSnapshot<TContent>["activity"] | undefined;
+};
+export type AgentUiApprovalController = {
+    approvals: readonly ApprovalRequest[];
+    approve: (requestId: string, reason?: string) => void;
+    deny: (requestId: string, reason?: string) => void;
+};
+export interface DeriveAgentUiSnapshotOptions<TContent = string> {
+    snapshot: AgentSnapshot;
+    eventLog?: readonly AuditEvent[] | undefined;
+    approvals?: AgentUiApprovalController | undefined;
+    invokeTool: (call: ToolCall) => Promise<ToolResult>;
+    sendMessage: (input: AgentSessionInput, options?: {
+        submitMode?: AgentInFlightSubmitMode | undefined;
+    } | undefined) => Promise<unknown>;
+    overrides?: AgentUiOverrides<TContent> | undefined;
+}
+export declare function deriveAgentUiSnapshot<TContent = string>({ snapshot, eventLog, approvals, invokeTool, sendMessage, overrides, }: DeriveAgentUiSnapshotOptions<TContent>): AgentUiSnapshot<TContent>;
+export declare function deriveStatus<TContent = string>(snapshot: AgentSnapshot, events: readonly AuditEvent[], actions: readonly AgentActionRequest<TContent>[]): AgentStatus;
+export declare function deriveCommands<TContent = string>(snapshot: AgentSnapshot, invokeTool: (call: ToolCall) => Promise<ToolResult>): AgentCommand<TContent>[];
+export declare function deriveQuickActions<TContent = string>(snapshot: AgentSnapshot, onPrompt: NonNullable<AgentUiSnapshot<TContent>["onPrompt"]>): AgentQuickAction<TContent>[];
+export declare function deriveApprovalActions<TContent = string>(events: readonly AuditEvent[], approvals: AgentUiApprovalController): AgentActionRequest<TContent>[];
+export declare function deriveActivity<TContent = string>(events: readonly AuditEvent[], snapshot: AgentSnapshot): AgentActivityItem<TContent>[];
+export declare function parseCommandArgs(input: string | undefined): unknown;
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"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"}

package/dist/derive.js

@@ -0,0 +1,234 @@
+import { humanizeStatus } from "./utils";
+export function deriveAgentUiSnapshot({ snapshot, eventLog = [], approvals = emptyApprovalController(), invokeTool, sendMessage, overrides = {}, }) {
+    const derivedActions = deriveApprovalActions(eventLog, approvals);
+    const derivedStatus = deriveStatus(snapshot, eventLog, derivedActions);
+    const commands = overrides.commands ?? deriveCommands(snapshot, invokeTool);
+    const onPrompt = overrides.onPrompt ??
+        ((prompt, options) => sendMessage(options?.assets?.length ? { role: "user", content: prompt, assets: options.assets } : prompt, options?.mode ? { submitMode: options.mode } : undefined).then(() => undefined));
+    const quickActions = overrides.quickActions ?? deriveQuickActions(snapshot, onPrompt);
+    const actions = overrides.actions ?? derivedActions;
+    const activity = overrides.activity ?? deriveActivity(eventLog, snapshot);
+    const status = overrides.status ?? derivedStatus;
+    const scopeTitle = activeScopeTitle(snapshot);
+    const statusDetail = `${snapshot.scopes.length} scopes · ${snapshot.tools.length} tools · ${snapshot.prompts.length} prompts`;
+    const onCommand = overrides.onCommand ??
+        ((command, input) => {
+            const tool = snapshot.tools.find((candidate) => candidate.name === command);
+            if (!tool) {
+                return undefined;
+            }
+            return invokeTool({
+                name: tool.name,
+                args: parseCommandArgs(input),
+            }).then(() => undefined);
+        });
+    return {
+        status,
+        statusLabel: overrides.statusLabel ?? asContent(humanizeStatus(status)),
+        statusDetail: overrides.statusDetail ??
+            overrides.currentTask ??
+            asContent(scopeTitle) ??
+            asContent(statusDetail),
+        goal: overrides.goal,
+        currentTask: overrides.currentTask ?? asContent(scopeTitle),
+        model: overrides.model,
+        commands,
+        quickActions,
+        actions,
+        activity,
+        onCommand,
+        onPrompt,
+        onApproveAction: overrides.onApproveAction ?? ((action) => approvals.approve(action.id)),
+        onRejectAction: overrides.onRejectAction ??
+            ((action) => approvals.deny(action.id, "Rejected in AgentActionReview")),
+    };
+}
+export function deriveStatus(snapshot, events, actions) {
+    if (actions.length > 0) {
+        return "waiting";
+    }
+    const lastEvent = events.at(-1);
+    if (lastEvent && (lastEvent.type.includes("failed") || lastEvent.type.includes("denied"))) {
+        return "error";
+    }
+    if (snapshot.scopes.length ||
+        snapshot.tools.length ||
+        snapshot.resources.length ||
+        snapshot.instructions.length) {
+        return "ready";
+    }
+    return "idle";
+}
+export function deriveCommands(snapshot, invokeTool) {
+    return snapshot.tools.map((tool) => ({
+        id: tool.name,
+        label: tool.name,
+        description: asContent(tool.description),
+        shortcut: tool.risk,
+        disabled: false,
+        run: (input) => invokeTool({
+            name: tool.name,
+            args: parseCommandArgs(input),
+        }).then(() => undefined),
+    }));
+}
+export function deriveQuickActions(snapshot, onPrompt) {
+    return snapshot.prompts.map((prompt) => ({
+        id: prompt.id,
+        label: prompt.label,
+        prompt: prompt.prompt,
+        description: asContent(prompt.description),
+        scopeId: prompt.scopeId,
+        disabled: false,
+        run: async () => {
+            await onPrompt(prompt.prompt);
+        },
+    }));
+}
+export function deriveApprovalActions(events, approvals) {
+    if (approvals.approvals.length > 0) {
+        return approvals.approvals.map((request) => ({
+            id: request.id,
+            title: `Run ${request.tool.name}`,
+            description: asContent(request.reason),
+            command: JSON.stringify({
+                tool: request.tool.name,
+                args: request.redactedArgs,
+            }, null, 2),
+            subject: request.tool.description,
+            risk: mapRisk(request.tool.risk),
+            status: "pending",
+            requestedAt: request.createdAt,
+            metadata: {
+                scope: asContent(request.tool.scopeId ?? "global"),
+                confirmation: asContent(request.tool.requiresConfirmation ? "required" : "not required"),
+            },
+            onApprove: () => approvals.approve(request.id),
+            onReject: () => approvals.deny(request.id, "Rejected in AgentActionReview"),
+        }));
+    }
+    const requests = new Map();
+    const resolved = new Set();
+    for (const event of events) {
+        const requestId = getAuditRequestId(event);
+        if (event.type === "tool.approval.requested" && requestId) {
+            requests.set(requestId, event);
+        }
+        if (event.type === "tool.approval.resolved" && requestId) {
+            resolved.add(requestId);
+        }
+    }
+    return [...requests.entries()]
+        .filter(([requestId]) => !resolved.has(requestId))
+        .map(([requestId, event]) => ({
+        id: requestId,
+        title: `Run ${event.toolName ?? "tool"}`,
+        description: asContent(event.message ?? "This tool requires confirmation before it can continue."),
+        command: JSON.stringify(getAuditData(event), null, 2),
+        subject: event.scopeId,
+        risk: "medium",
+        status: "pending",
+        requestedAt: event.timestamp,
+        metadata: {
+            scope: asContent(event.scopeId ?? "global"),
+            confirmation: asContent("required"),
+        },
+    }));
+}
+export function deriveActivity(events, snapshot) {
+    const activity = events.map((event) => ({
+        id: event.id,
+        title: event.message ?? humanizeStatus(event.type),
+        detail: asContent(event.toolName ?? event.type),
+        status: statusFromAudit(event.type),
+        actor: event.scopeId,
+        at: event.timestamp,
+        metadata: asContent(previewValue(event.data)),
+    }));
+    if (activity.length > 0) {
+        return activity.reverse();
+    }
+    return [
+        {
+            id: "snapshot-current",
+            title: "Context snapshot ready",
+            detail: asContent(`${snapshot.scopes.length} scopes, ${snapshot.tools.length} tools, ${snapshot.resources.length} resources`),
+            status: snapshot.scopes.length || snapshot.tools.length ? "ready" : "idle",
+            at: snapshot.generatedAt,
+        },
+    ];
+}
+export function parseCommandArgs(input) {
+    if (!input?.trim()) {
+        return {};
+    }
+    try {
+        return JSON.parse(input);
+    }
+    catch {
+        return { input };
+    }
+}
+function activeScopeTitle(snapshot) {
+    return snapshot.scopes[0]?.title;
+}
+function mapRisk(risk) {
+    switch (risk) {
+        case "destructive":
+        case "external":
+            return "high";
+        case "write":
+            return "medium";
+        case "draft":
+        case "read":
+        default:
+            return "low";
+    }
+}
+function statusFromAudit(type) {
+    if (type.includes("failed") || type.includes("denied")) {
+        return "error";
+    }
+    if (type.includes("approval")) {
+        return "waiting";
+    }
+    if (type.includes("executed") || type.includes("registered")) {
+        return "complete";
+    }
+    return "idle";
+}
+function getAuditData(event) {
+    if (!event.data || typeof event.data !== "object") {
+        return undefined;
+    }
+    return event.data;
+}
+function getAuditRequestId(event) {
+    const data = getAuditData(event);
+    const requestId = data?.requestId;
+    return typeof requestId === "string" ? requestId : undefined;
+}
+function previewValue(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function emptyApprovalController() {
+    return {
+        approvals: [],
+        approve: () => undefined,
+        deny: () => undefined,
+    };
+}
+function asContent(value) {
+    return value;
+}