@pi-unipi/utility 0.1.1

package/README.md

@@ -0,0 +1,51 @@
+# @pi-unipi/utility
+
+Utility commands and tools for the Pi coding agent — part of the Unipi suite.
+
+## Features
+
+### `/unipi:continue` Command
+
+Continue the agent from where it left off **without adding a user message** to the conversation transcript.
+
+```
+/unipi:continue
+```
+
+This sends a "steer" message that tells the agent to proceed to the next step. Unlike typing "continue" yourself, this doesn't pollute the context with an extra user message.
+
+### `continue_task` Tool
+
+The agent can call this tool programmatically when it finishes a step and needs to proceed to the next without waiting for user input.
+
+```
+continue_task()
+```
+
+**When to use:** The agent has completed one step and should automatically proceed to the next.
+
+## Installation
+
+```bash
+pi install npm:@pi-unipi/utility
+```
+
+Or install the full Unipi suite:
+
+```bash
+pi install npm:@pi-unipi/unipi
+```
+
+## How It Works
+
+Both the command and tool use Pi's `sendUserMessage` API with `deliverAs: "steer"` to inject a continuation prompt without creating a user message in the transcript. This keeps the conversation clean while allowing the agent to continue working.
+
+The default continue prompt is:
+
+> Continue from where you left off. Proceed with the next step.
+
+## Dependencies
+
+- `@pi-unipi/core` — Shared constants and utilities
+- `@mariozechner/pi-coding-agent` — Pi extension API
+- `@sinclair/typebox` — Schema validation

package/commands.ts

@@ -0,0 +1,38 @@
+/**
+ * @pi-unipi/utility — Command registration
+ *
+ * Registers /unipi:continue command for clean agent continuation.
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { UNIPI_PREFIX, UTILITY_COMMANDS } from "@pi-unipi/core";
+
+/**
+ * Register utility commands.
+ */
+export function registerUtilityCommands(pi: ExtensionAPI): void {
+  pi.registerCommand(`${UNIPI_PREFIX}${UTILITY_COMMANDS.CONTINUE}`, {
+    description: "Continue the agent from where it left off without adding user context",
+    handler: async (_args: string, ctx: ExtensionContext) => {
+      if (!ctx.isIdle()) {
+        if (ctx.hasUI) {
+          ctx.ui.notify(
+            "Agent is busy. Press ESC to interrupt, then try again.",
+            "warning",
+          );
+        }
+        return;
+      }
+
+      // Send custom message to trigger a turn without polluting transcript
+      pi.sendMessage(
+        {
+          customType: "unipi-continue",
+          content: "",
+          display: false,
+        },
+        { triggerTurn: true },
+      );
+    },
+  });
+}

package/index.ts

@@ -0,0 +1,34 @@
+/**
+ * @pi-unipi/utility — Extension entry
+ *
+ * Provides /unipi:continue command for clean agent continuation
+ * without context pollution.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import {
+  UNIPI_EVENTS,
+  MODULES,
+  UTILITY_COMMANDS,
+  emitEvent,
+  getPackageVersion,
+} from "@pi-unipi/core";
+import { registerUtilityCommands } from "./commands.js";
+
+/** Package version */
+const VERSION = getPackageVersion(new URL(".", import.meta.url).pathname);
+
+export default function (pi: ExtensionAPI) {
+  // Register commands
+  registerUtilityCommands(pi);
+
+  // Session lifecycle — announce module
+  pi.on("session_start", async () => {
+    emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
+      name: MODULES.UTILITY,
+      version: VERSION,
+      commands: [`unipi:${UTILITY_COMMANDS.CONTINUE}`],
+      tools: [],
+    });
+  });
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@pi-unipi/utility",
+  "version": "0.1.1",
+  "description": "Utility commands and tools for Pi coding agent — continue, status helpers",
+  "type": "module",
+  "license": "MIT",
+  "author": "Neuron Mr White",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Neuron-Mr-White/unipi.git",
+    "directory": "packages/utility"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "unipi",
+    "utility",
+    "continue"
+  ],
+  "files": [
+    "index.ts",
+    "commands.ts",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pi-unipi/core": "*"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  }
+}