@nikcli-ai/plugin 1.218.0 → 1.219.0

package/dist/tui.d.ts

@@ -1,6 +1,7 @@
 import type { NikcliClient, Event, LspStatus, McpStatus, Todo, Message, Part, Provider, PermissionRequest, QuestionRequest, SessionStatus, Workspace, Config as SdkConfig } from "@nikcli-ai/sdk/v2";
 import type { CliRenderer, ParsedKey, RGBA } from "@opentui/core";
 import type { JSX, SolidPlugin } from "@opentui/solid";
+import type { Store } from "solid-js/store";
 import type { Config as PluginConfig, PluginOptions } from "./index.js";
 import type { Data as TuiV2Data } from "./v2/tui/context.js";
 export type { CliRenderer, SlotMode } from "@opentui/core";
@@ -243,6 +244,31 @@ export type TuiKV = {
     set: (key: string, value: unknown) => void;
     readonly ready: boolean;
 };
+export type TuiMemoryEntry<Value extends object> = readonly [Store<Value>, (mutation: (draft: Value) => void) => void];
+export type TuiStoreEntry<Value extends object> = readonly [
+    Store<Value>,
+    (mutation: (draft: Value) => void) => Promise<void>
+];
+export type TuiStorage = {
+    /**
+     * Durable JSON state, namespaced per plugin: persisted to disk, survives hot
+     * reloads and TUI restarts, and stays in sync across running TUI instances.
+     * Values must be JSON-serializable; updates resolve once written.
+     */
+    store: <Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }) => TuiStoreEntry<Value>;
+    /**
+     * Ephemeral in-process state, keyed per plugin. Entries live above the plugin
+     * lifecycle, so a hot reload hands the same live store to the new generation
+     * and in-memory state survives editing the plugin source. Updates are
+     * synchronous, values need not be JSON-serializable, and everything is gone
+     * when the TUI exits. Use `api.kv` for state that must outlive the process.
+     */
+    memory: <Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }) => TuiMemoryEntry<Value>;
+};
 export type TuiState = {
     readonly ready: boolean;
     readonly config: SdkConfig;
@@ -313,6 +339,9 @@ export type TuiSlotMap = {
     "app.bottom": {};
     "home.bottom": {};
     "home.footer": {};
+    "session.prompt.top": {
+        sessionID: string;
+    };
     "sidebar.content": {
         sessionID: string;
     };
@@ -414,6 +443,7 @@ export type TuiPluginApi = {
     };
     readonly tuiConfig: Frozen<TuiConfigView>;
     kv: TuiKV;
+    storage: TuiStorage;
     state: TuiState;
     /** Full reactive data contract used by v2 TUI plugins. */
     data: TuiV2Data;

package/dist/v2/tui/context.d.ts

@@ -1,5 +1,6 @@
 import type { Agent, Command, ConnectorStatus, Event, McpResource, McpStatus, Message, Model, NikcliClient, Part, PermissionRequest, PermissionRule, Provider, Pty, QuestionRequest, ReferenceConfig, Session, SessionEntryAssistantReasoning, SessionEntryAssistantRetry, SessionEntryAssistantText, SessionEntryAssistantTool, SessionEntrySynthetic, SessionEntryUser } from "@nikcli-ai/sdk/v2";
 import type { JSX } from "@opentui/solid";
+import type { Store } from "solid-js/store";
 export type LocationRef = {
     readonly directory: string;
     readonly workspaceID?: string;
@@ -133,10 +134,28 @@ export interface UI {
     };
     readonly slot: (name: string, render: Slot) => () => void;
 }
+export interface Storage {
+    /**
+     * Durable JSON state: persisted to disk, survives hot reloads and TUI
+     * restarts, and stays in sync across running TUI instances.
+     */
+    store<Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }): readonly [Store<Value>, (mutation: (draft: Value) => void) => Promise<void>];
+    /**
+     * Ephemeral in-memory state: survives plugin hot reloads (the old and the new
+     * generation share the same live store) and is gone when the TUI exits.
+     * Updates are synchronous and values need not be JSON-serializable.
+     */
+    memory<Value extends object>(key: string, options: {
+        readonly initial: Value;
+    }): readonly [Store<Value>, (mutation: (draft: Value) => void) => void];
+}
 export interface Context {
     readonly options: Readonly<Record<string, unknown>>;
     readonly client: NikcliClient;
     readonly data: Data;
+    readonly storage: Storage;
     readonly ui: UI;
 }
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@nikcli-ai/plugin",
-  "version": "1.218.0",
+  "version": "1.219.0",
   "type": "module",
   "license": "MIT",
   "scripts": {
@@ -65,10 +65,11 @@
     }
   },
   "dependencies": {
-    "@nikcli-ai/sdk": "1.218.0",
+    "@nikcli-ai/sdk": "1.219.0",
     "@opentui/core": "0.1.91",
     "@opentui/solid": "0.1.91",
     "effect": "4.0.0-beta.83",
+    "solid-js": "1.9.10",
     "zod": "4.1.8"
   },
   "devDependencies": {