@nbt-dev/devtools 0.1.1 → 0.1.3

package/dist/components/devtools/agent/agent-empty-state.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export declare const AgentEmptyState: React.FC<{
+    onPick: (prompt: string) => void;
+    disabled?: boolean;
+}>;

package/dist/components/devtools/agent/agent-markdown.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+export declare const AgentMarkdown: React.FC<{
+    source: string;
+}>;

package/dist/components/devtools/agent/agent-runtime.d.ts

@@ -0,0 +1,46 @@
+import { Agent } from "@earendil-works/pi-agent-core/base";
+import type { AgentMessage } from "@earendil-works/pi-agent-core/base";
+import type { Model } from "@earendil-works/pi-ai/base";
+import { createConsoleClient } from "./console-tools";
+import { type HttpOperationsHooks } from "./http-operations";
+export declare const NBT_DEFAULT_MODEL_ID = "gemma-4-26b-a4b";
+/** Models offered in the Agent tab picker. id is forwarded verbatim to the gateway upstream. */
+export declare const NBT_MODEL_CHOICES: ReadonlyArray<{
+    id: string;
+    name: string;
+}>;
+export type ThinkingLevel = "off" | "low" | "medium" | "high";
+export declare const TRIAGE_MODEL_ID = "gemma-4-26b-a4b";
+/** Build the triage model used by the display director (registers the provider). */
+export declare function createTriageModel(apiBaseUrl: string): Model<"openai-completions">;
+/** Absolute console origin for a (possibly empty = same-origin) apiBaseUrl. */
+export declare function resolveConsoleOrigin(apiBaseUrl: string): string;
+export declare function nbtModel(apiBaseUrl: string, modelId: string): Model<"openai-completions">;
+export interface ConsoleAgent {
+    agent: Agent;
+    /** The data-plane client backing the tools; its active branch is mutable. */
+    client: ReturnType<typeof createConsoleClient>;
+}
+export interface ConsoleAgentOptions {
+    /** Approve/deny a mutating tool call. Resolves true to proceed, false to block. */
+    confirmMutation?: (toolName: string, args: Record<string, unknown>) => Promise<boolean>;
+    /** Called when the active branch changes (via the branch tool). */
+    onBranchChange?: () => void;
+    /** Restored transcript to seed the agent with (from localStorage). */
+    initialMessages?: AgentMessage[];
+    /** Upstream model id (forwarded to the gateway). Default: NBT_DEFAULT_MODEL_ID. */
+    modelId?: string;
+    /** Reasoning level. Default: "off". */
+    thinkingLevel?: ThinkingLevel;
+    /** Run the lean orchestrator + sub-agents instead of the flat toolset. Default: false. */
+    orchestrator?: boolean;
+    /**
+     * The data-plane client backing the tools. The Studio tab injects ONE long-lived
+     * client it ALSO uses for the editor, so a human Save and an agent edit share the
+     * same branch context + cache-invalidation domain. Omitted → a fresh client is made.
+     */
+    client?: ReturnType<typeof createConsoleClient>;
+    /** Workspace hooks so the editor follows file/tree changes the agent makes. */
+    fileHooks?: HttpOperationsHooks;
+}
+export declare function createConsoleAgent(apiBaseUrl: string, opts?: ConsoleAgentOptions): ConsoleAgent;

package/dist/components/devtools/agent/agent-tab.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+declare const AgentTab: React.FC;
+export default AgentTab;

package/dist/components/devtools/agent/chat-pane.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+import type { AgentMessage } from "@earendil-works/pi-agent-core/base";
+import { type ThinkingLevel } from "./agent-runtime";
+import { type ToolResultView } from "./tool-call-card";
+export interface ChatSnapshot {
+    messages: AgentMessage[];
+    streaming?: AgentMessage;
+    isStreaming: boolean;
+}
+export interface ChatPaneProps {
+    snap: ChatSnapshot;
+    results: Map<string, ToolResultView>;
+    showWorking: boolean;
+    branch?: string;
+    modelId: string;
+    thinkingLevel: ThinkingLevel;
+    onModel: (id: string) => void;
+    onThinking: (l: ThinkingLevel) => void;
+    onClear: () => void;
+    onSubmit: (text: string) => void;
+    onStop: () => void;
+    /** Click a tool chip → focus that call's artifact in the display pane. */
+    onFocusTool: (name: string, args: Record<string, unknown>, resultText?: string) => void;
+}
+export declare const ChatPane: React.FC<ChatPaneProps>;

package/dist/components/devtools/agent/code-view.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+export declare const CodeView: React.FC<{
+    value: string;
+}>;

package/dist/components/devtools/agent/console-tools.d.ts

@@ -0,0 +1,4 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core/base";
+import { ConsoleClient } from "@nbt-dev/agent/console-client";
+export declare function createConsoleClient(baseUrl: string, sessionToken?: string, branchId?: string): ConsoleClient;
+export declare function createConsoleTools(client: ConsoleClient, onBranchChange?: () => void): AgentTool[];

package/dist/components/devtools/agent/display-director.d.ts

@@ -0,0 +1,43 @@
+import type { AgentMessage } from "@earendil-works/pi-agent-core/base";
+export type DisplayDirective = {
+    kind: "file";
+    cart: string;
+    path: string;
+} | {
+    kind: "entity";
+    cart: string;
+    entity: string;
+} | {
+    kind: "schema";
+    cart: string;
+} | {
+    kind: "migration";
+    cart?: string;
+} | {
+    kind: "build";
+} | {
+    kind: "branch";
+} | {
+    kind: "output";
+    title: string;
+    text: string;
+} | {
+    kind: "none";
+};
+export declare function sameDirective(a: DisplayDirective | null, b: DisplayDirective | null): boolean;
+/** Map a single tool call to the artifact it concerns. null = no domain artifact. */
+export declare function directiveForCall(name: string, args: Record<string, unknown>): DisplayDirective | null;
+/** Instant, model-free directive from the latest tool action. null = nothing to show. */
+export declare function heuristicDirective(messages: AgentMessage[]): DisplayDirective | null;
+export interface TriageContext {
+    apiBaseUrl: string;
+    apiKey: string;
+    /** cart slug → entity names (from the live registry) to constrain the model. */
+    carts: Record<string, string[]>;
+    signal?: AbortSignal;
+}
+/**
+ * Refine the directive with a cheap parallel model call. Returns the refined
+ * directive, or null to keep whatever the caller already has. Never throws.
+ */
+export declare function triageDirective(messages: AgentMessage[], ctx: TriageContext): Promise<DisplayDirective | null>;

package/dist/components/devtools/agent/display-pane.d.ts

@@ -0,0 +1,30 @@
+import React from "react";
+import { type BulkRegistry } from "@nbt-dev/components";
+import type { ConsoleClient } from "@nbt-dev/agent/console-client";
+export declare const EntityView: React.FC<{
+    cart: string;
+    entity: string;
+    registry: BulkRegistry;
+    branch?: string;
+}>;
+export declare function useAsync<T>(fn: () => Promise<T>, deps: React.DependencyList): {
+    data?: T;
+    error?: string;
+    loading: boolean;
+};
+export declare const MigrationView: React.FC<{
+    client: ConsoleClient;
+    cart?: string;
+}>;
+export declare const BuildView: React.FC<{
+    text?: string;
+}>;
+export declare const BranchView: React.FC<{
+    client: ConsoleClient;
+    active?: string;
+}>;
+export declare const Loading: React.FC;
+export declare const ErrText: React.FC<{
+    msg: string;
+}>;
+export declare const EmptyView: React.FC;

package/dist/components/devtools/{sources → agent}/file-tree.d.ts

@@ -1,16 +1,12 @@
 import React from "react";
-import type { DevCart } from "./use-dev-files";
-export type FileSel = {
-    cart: string;
-    path: string;
-};
+import type { DevCart } from "@nbt-dev/agent/console-client";
+import type { FileSel } from "./use-workspace-files";
 type Props = {
     carts: DevCart[];
     selected: FileSel | null;
     dirtyKeys: Set<string>;
     onSelect: (sel: FileSel) => void;
     onNewCart: (name: string) => void;
-    onNewMigration: (cart: string) => void;
 };
 export declare const FileTree: React.FC<Props>;
 export {};

package/dist/components/devtools/agent/http-operations.d.ts

@@ -0,0 +1,20 @@
+import type { ConsoleClient } from "@nbt-dev/agent/console-client";
+import type { EditOperations, FindOperations, GrepOperations, LsOperations, ReadOperations, WriteOperations } from "@nbt-dev/agent/tools";
+export interface HttpOperations {
+    read: ReadOperations;
+    edit: EditOperations;
+    write: WriteOperations;
+    ls: LsOperations;
+    grep: GrepOperations;
+    find: FindOperations;
+    /** Drop the cached cart/file tree (call after a write/migrate/build/apply). */
+    invalidate: () => void;
+}
+/** Hooks so the workspace UI can follow file/tree changes the agent makes. */
+export interface HttpOperationsHooks {
+    /** A specific cart file was written by the agent (so an open editor can refresh it). */
+    onFileWritten?: (cart: string, rel: string) => void;
+    /** The cart/file tree changed (write/migrate/build/apply) — re-list carts. */
+    onTreeChanged?: () => void;
+}
+export declare function createHttpOperations(client: ConsoleClient, hooks?: HttpOperationsHooks): HttpOperations;

package/dist/components/devtools/agent/nbt-tool.d.ts

@@ -0,0 +1,12 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core/base";
+import { Type } from "@earendil-works/pi-ai/base";
+import { ConsoleClient } from "@nbt-dev/agent/console-client";
+declare const nbtSchema: Type.TObject<{
+    op: Type.TUnion<[Type.TLiteral<"status">, Type.TLiteral<"history">, Type.TLiteral<"validate">, Type.TLiteral<"scaffold">, Type.TLiteral<"migrate">, Type.TLiteral<"build">, Type.TLiteral<"apply">]>;
+    cart: Type.TOptional<Type.TString>;
+    name: Type.TOptional<Type.TString>;
+    message: Type.TOptional<Type.TString>;
+    dir: Type.TOptional<Type.TString>;
+}>;
+export declare function createNbtTool(client: ConsoleClient, onMutate?: () => void): AgentTool<typeof nbtSchema>;
+export {};

package/dist/components/devtools/agent/tool-call-card.d.ts

@@ -0,0 +1,12 @@
+import React from "react";
+export interface ToolResultView {
+    isError: boolean;
+    text: string;
+}
+export declare function friendlyToolLabel(name: string, args: Record<string, unknown> | undefined): string;
+export declare const ToolCallCard: React.FC<{
+    name: string;
+    args: Record<string, unknown>;
+    result?: ToolResultView;
+    running: boolean;
+}>;

package/dist/components/devtools/agent/use-workspace-files.d.ts

@@ -0,0 +1,42 @@
+import { NbtLspClient } from "@nbt-dev/components/editor";
+import type { ConsoleClient, DevCart, DevDiagnostic, DevStatus } from "@nbt-dev/agent/console-client";
+import type { HttpOperationsHooks } from "./http-operations";
+export type FileSel = {
+    cart: string;
+    path: string;
+};
+export type FileBuffer = {
+    saved: string;
+    current: string;
+    writable: boolean;
+};
+export declare const isGeneratedPath: (path: string) => boolean;
+export interface WorkspaceFiles {
+    devStatus: DevStatus | null;
+    carts: DevCart[];
+    refreshCarts: () => void;
+    selected: FileSel | null;
+    openFile: (sel: FileSel) => void;
+    activeBuffer: FileBuffer | undefined;
+    dirtyKeys: Set<string>;
+    conflictKeys: Set<string>;
+    onChange: (text: string) => void;
+    onSave: (text: string) => void;
+    reloadFromDisk: (sel: FileSel) => void;
+    keepMine: (sel: FileSel) => void;
+    diagnostics: DevDiagnostic[];
+    statusMsg: string;
+    setStatusMsg: (s: string) => void;
+    lsp: NbtLspClient | null;
+    /** Stable hooks the agent runtime calls so the editor follows agent edits. */
+    agentFileHooks: HttpOperationsHooks;
+    editor: {
+        theme: string;
+        fontSize: number;
+        lineWrap: boolean;
+        tabSize: number;
+    };
+    treeWidth: number;
+    setTreeWidth: (n: number) => void;
+}
+export declare function useWorkspaceFiles(client: ConsoleClient, apiBaseUrl: string): WorkspaceFiles;

package/dist/components/devtools/agent/workbench.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import type { BulkRegistry } from "@nbt-dev/components";
+import type { ConsoleClient } from "@nbt-dev/agent/console-client";
+import type { DisplayDirective } from "./display-director";
+import { type WorkspaceFiles, type FileSel } from "./use-workspace-files";
+export interface WorkbenchProps {
+    ws: WorkspaceFiles;
+    client: ConsoleClient;
+    registry: BulkRegistry;
+    directive: DisplayDirective;
+    branch?: string;
+    /** Most recent agent `nbt build` output (drives the Build panel when present). */
+    lastBuildText?: string;
+}
+export declare const Workbench: React.FC<WorkbenchProps>;
+export type { FileSel };

package/dist/components/ui/button.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type VariantProps } from "class-variance-authority";
 declare const buttonVariants: (props?: ({
-    variant?: "default" | "link" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
+    variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function Button({ className, variant, size, asChild, ...props }: React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {