@dsh-stack/tweak-fork-undo 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# tweak-fork-undo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Fork-based session undo/redo: /undo and /redo fork a new session from an earlier logged boundary.
+
+An extension of the `tweaks` settings surface, split out of the bundled `tweaks` package.

package/lib/fork-undo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * tweak-fork-undo: fork-based undo/redo. `/undo` `/redo` fork a new session
+ * from an earlier logged boundary via `ctx.sessions.create`.
+ * @module tweak-fork-undo/fork-undo
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import type { SessionEvent } from "@deepseek-ai/dsh-session";
+/** Register the fork-based `/undo` and `/redo` commands. Returns the inject fiber. */
+export declare function installForkUndo(ctx: Context): unknown;
+/** Fork a new session from an earlier/later message boundary in the log. */
+export declare function forkSession(sessions: {
+    create(id?: string, options?: {
+        seed?: readonly SessionEvent[];
+    }): unknown;
+}, agent: {
+    session: {
+        snapshotEvents(): readonly SessionEvent[];
+    };
+}, direction: -1 | 1): {
+    kind: "success";
+    text: string;
+} | {
+    kind: "error";
+    text: string;
+};

package/lib/fork-undo.js

@@ -0,0 +1,55 @@
+/**
+ * tweak-fork-undo: fork-based undo/redo. `/undo` `/redo` fork a new session
+ * from an earlier logged boundary via `ctx.sessions.create`.
+ * @module tweak-fork-undo/fork-undo
+ */
+/** Register the fork-based `/undo` and `/redo` commands. Returns the inject fiber. */
+export function installForkUndo(ctx) {
+    return ctx.inject(["commands", "sessions"], (commandCtx) => {
+        const disposers = [];
+        /**
+         * Registers commands to fork sessions in either direction (-1 for undo, 1 for redo).
+         *
+         * @param name - The name of the command.
+         * @param description - A description of the command's purpose.
+         * @param direction - Direction to fork the session (-1 for undo, 1 for redo).
+         *
+         * @returns Nothing on success, disposes of command registration on failure.
+         */
+        const make = (name, description, direction) => {
+            disposers.push(commandCtx.commands.register({
+                name,
+                description,
+                handler: (invocation) => forkSession(commandCtx.sessions, invocation.agent, direction),
+            }));
+        };
+        make("undo", "Fork this session from the previous message boundary", -1);
+        make("redo", "Fork this session from the latest message boundary", 1);
+        return () => {
+            for (const dispose of disposers)
+                dispose();
+        };
+    });
+}
+/** Fork a new session from an earlier/later message boundary in the log. */
+export function forkSession(sessions, agent, direction) {
+    const events = agent.session.snapshotEvents();
+    if (events.length === 0)
+        return { kind: "error", text: "no events to fork from" };
+    const boundaries = [];
+    events.forEach((event, index) => {
+        if (event.type === "user/message")
+            boundaries.push(index);
+    });
+    const target = direction === -1
+        ? boundaries.length > 0
+            ? boundaries[boundaries.length - 1]
+            : 0
+        : events.length;
+    const seed = events.slice(0, target);
+    sessions.create(undefined, { seed });
+    return {
+        kind: "success",
+        text: `${direction === -1 ? "undo" : "redo"}: forked ${seed.length} events into a new session`,
+    };
+}

package/lib/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * `tweak-fork-undo`: fork-based session undo/redo — the `/undo` `/redo`
+ * commands plus their `tweak-fork-undo` settings section. Split out of the
+ * bundled `tweaks` package.
+ * @module tweak-fork-undo
+ */
+import type { Context } from "@deepseek-ai/cordis";
+import type z from "@deepseek-ai/schemastery";
+import { type ForkUndoConfig as ForkUndoConfigType } from "./settings.js";
+export { NS_FORK_UNDO, ForkUndoConfig } from "./settings.js";
+export type { ForkUndoConfig as ForkUndoConfigType } from "./settings.js";
+export { forkSession, installForkUndo } from "./fork-undo.js";
+export declare const name = "tweak-fork-undo";
+export declare const inject: string[];
+/** The fork-undo extension config: the fork-undo section itself. */
+export type Config = ForkUndoConfigType;
+export declare const Config: z<Config>;
+/**
+ * Declares this plugin's own settings page and installs the fork-undo commands.
+ *
+ * Since 0.2.0 no form is registered: the settings service projects the volatile
+ * Config fields of the active profile's entries, so this plugin's own
+ * `ForkUndoConfig` is its form and its namespace is this plugin's entry id. All
+ * this plugin must declare is that it ships its own page for that form. The
+ * `/undo` `/redo` commands are then registered only when `config.enabled` is
+ * true.
+ *
+ * @param ctx - The context in which to declare the settings page and install the commands.
+ * @param config - The fork-undo config; `enabled` gates the command registration.
+ */
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,33 @@
+/**
+ * `tweak-fork-undo`: fork-based session undo/redo — the `/undo` `/redo`
+ * commands plus their `tweak-fork-undo` settings section. Split out of the
+ * bundled `tweaks` package.
+ * @module tweak-fork-undo
+ */
+import { declareCustomSettingsPage } from "@dsh-stack/plugin-kit";
+import { installForkUndo } from "./fork-undo.js";
+import { ForkUndoConfig } from "./settings.js";
+export { NS_FORK_UNDO, ForkUndoConfig } from "./settings.js";
+export { forkSession, installForkUndo } from "./fork-undo.js";
+export const name = "tweak-fork-undo";
+export const inject = [];
+export const Config = ForkUndoConfig;
+/**
+ * Declares this plugin's own settings page and installs the fork-undo commands.
+ *
+ * Since 0.2.0 no form is registered: the settings service projects the volatile
+ * Config fields of the active profile's entries, so this plugin's own
+ * `ForkUndoConfig` is its form and its namespace is this plugin's entry id. All
+ * this plugin must declare is that it ships its own page for that form. The
+ * `/undo` `/redo` commands are then registered only when `config.enabled` is
+ * true.
+ *
+ * @param ctx - The context in which to declare the settings page and install the commands.
+ * @param config - The fork-undo config; `enabled` gates the command registration.
+ */
+export function apply(ctx, config) {
+    const session = { enabled: config?.enabled ?? true };
+    declareCustomSettingsPage(ctx);
+    if (session.enabled)
+        void installForkUndo(ctx);
+}

package/lib/settings.d.ts

@@ -0,0 +1,13 @@
+/**
+ * tweak-fork-undo settings: the fork-based undo/redo section schema.
+ * @module tweak-fork-undo/settings
+ */
+import z from "@deepseek-ai/schemastery";
+/** Namespace of the fork-undo section — this plugin's own Loader entry id. */
+export declare const NS_FORK_UNDO: import("@dsh-stack/plugin-kit").SettingsNamespace;
+/** Fork-undo knobs. */
+export interface ForkUndoConfig {
+    /** Whether `/undo` `/redo` fork commands are registered. */
+    enabled: boolean;
+}
+export declare const ForkUndoConfig: z<ForkUndoConfig>;

package/lib/settings.js

@@ -0,0 +1,11 @@
+/**
+ * tweak-fork-undo settings: the fork-based undo/redo section schema.
+ * @module tweak-fork-undo/settings
+ */
+import z from "@deepseek-ai/schemastery";
+import { settingsNamespace } from "@dsh-stack/plugin-kit";
+/** Namespace of the fork-undo section — this plugin's own Loader entry id. */
+export const NS_FORK_UNDO = settingsNamespace("tweak-fork-undo");
+export const ForkUndoConfig = z.object({
+    enabled: z.boolean().default(true),
+});

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@dsh-stack/tweak-fork-undo",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Fork-based session undo/redo: /undo and /redo fork a new session from an earlier logged boundary.",
+  "license": "MIT",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "README.md",
+    "package.json",
+    "stack.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "stack": {
+    "kind": "plugin",
+    "id": "stack.tweaks.fork-undo"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node check-plugin.mjs"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2"
+  },
+  "dependencies": {
+    "@dsh-stack/plugin-kit": "0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marius-patrik/dsh-stack.git",
+    "directory": "plugins/tweak-fork-undo"
+  }
+}

package/stack.json

@@ -0,0 +1,10 @@
+{
+  "id": "stack.tweaks.fork-undo",
+  "name": "@dsh-stack/tweak-fork-undo",
+  "version": "0.1.1",
+  "kind": "plugin",
+  "description": "Fork-based session undo/redo: /undo and /redo fork a new session from an earlier logged boundary.",
+  "files": ["lib", "README.md", "package.json", "stack.json"],
+  "dependencies": ["stack.library.plugin-kit"],
+  "optionalDependencies": []
+}