@qloo/qloo-harness 0.1.19 → 0.1.21

package/README.md

@@ -83,6 +83,25 @@ qloo --version
 qloo
 ```
 
+### Uninstall
+
+Remove the global package with the same package manager you used to install it:
+
+```sh
+pnpm remove --global @qloo/qloo-harness
+```
+
+Or with npm:
+
+```sh
+npm uninstall --global @qloo/qloo-harness
+```
+
+Package removal intentionally leaves credentials, settings, and sessions in
+`~/.qloo` (or the directory selected by `QLOO_HOME`). A later reinstall reuses
+that state and will not ask for keys again. Delete only that dedicated state
+directory separately if you also want to erase the saved configuration.
+
 ### Run from Source
 
 Contributors can prepare the repository once instead of installing the public
@@ -358,6 +377,8 @@ and normalized outputs at the project's existing code boundary.
 
 Inside chat, `/start` offers guided goals and `/status` reports the active
 profile, actual transport, model, workspace, context use, and turn budget.
+`/usage` shows the current model's context-window use as a raw token count and
+percentage, while `/exit` closes the harness cleanly.
 `/why`, `/sources`, `/request`, and `/trace` show the latest normalized query
 intent, provenance, safe underlying GET request preview, and privacy-safe
 execution metadata respectively. `/next` offers operation-aware continuations.

package/dist/cli.js

@@ -5,7 +5,7 @@ const require = __qlooCreateRequire(import.meta.url);
 import { launchInteractiveHarness } from "./app.js";
 import { isQlooHarnessProfile, QLOO_DEFAULT_PROFILE, QLOO_HARNESS_PROFILES } from "./profiles.js";
 import { MissingModelAuthenticationError } from "./runtime/pi-adapter.js";
-var HARNESS_VERSION = "0.1.19";
+var HARNESS_VERSION = "0.1.21";
 var HARNESS_HELP = `Qloo terminal harness
 
 Usage:

package/dist/index.d.ts

@@ -674,7 +674,7 @@ interface LaunchInteractiveHarnessOptions {
 }
 declare function launchInteractiveHarness(options?: LaunchInteractiveHarnessOptions): Promise<void>;
 
-declare const HARNESS_VERSION = "0.1.19";
+declare const HARNESS_VERSION = "0.1.21";
 declare const HARNESS_HELP = "Qloo terminal harness\n\nUsage:\n  qloo              Start guided Qloo chat\n  qloo chat         Start guided Qloo chat explicitly\n  qloo explore      Ask grounded Qloo questions (read-only workspace)\n  qloo integrate    Inspect and design a Qloo integration\n  qloo plan         Open interactive read-only planning\n  qloo plan \"<goal>\" --json\n                    Create a typed, evidence-backed plan\n  qloo build        Open approval-gated build mode\n  qloo build --plan <plan-id>\n                    Build from a validated integration plan\n  qloo chat --mode <explore|integrate|plan|build>\n  qloo --help       Show this help\n  qloo --version    Show the harness version\n\nThe deterministic API CLI and additional harness commands are attached by the\ntop-level qloo command router.";
 interface HarnessCliDependencies {
     launch: (profile: QlooHarnessProfile) => Promise<void>;

package/dist/runtime/explore-policy.js

@@ -26,6 +26,12 @@ var AUTOMATIC_DIAGNOSTIC_CODES = /* @__PURE__ */ new Set([
   "RESOLVER_CONNECT",
   "RESOLVER_TIMEOUT"
 ]);
+function formatContextUsage(usage) {
+  const tokens = usage?.tokens ?? "unknown";
+  const contextWindow = usage?.contextWindow ?? "unknown";
+  const percentage = usage?.percent === null || usage?.percent === void 0 ? "percentage unavailable" : `${usage.percent.toFixed(1)}%`;
+  return `${tokens} / ${contextWindow} tokens (${percentage})`;
+}
 var reservedBuiltInTools = /* @__PURE__ */ new Set([
   ...QLOO_WORKSPACE_TOOL_NAMES,
   "grep",
@@ -184,12 +190,19 @@ function createHarnessPolicyExtension(profile, allowedToolNames, runtimeInfo, co
           return;
         }
       };
+      const notifyReadable = (context, label, body) => {
+        const message = context.mode === "tui" ? [
+          context.ui.theme.fg("accent", label),
+          context.ui.theme.fg("text", body)
+        ].join("\n") : `${label}
+${body}`;
+        context.ui.notify(message);
+      };
       const notifyJson = (context, label, value, maximumCharacters = 4e3) => {
         const serialized = JSON.stringify(redactSensitiveResult(value), null, 2);
         const bounded = serialized.length > maximumCharacters ? `${serialized.slice(0, maximumCharacters)}
 \u2026` : serialized;
-        context.ui.notify(`${label}
-${bounded}`);
+        notifyReadable(context, label, bounded);
       };
       const setNextWidget = (context) => {
         if (context?.mode !== "tui" || !context.ui?.setWidget)
@@ -432,13 +445,16 @@ ${bounded}`);
         description: "Choose a guided Qloo goal and editable starter prompt",
         handler: async (_args, context) => showGuidedStart(context)
       });
+      pi.registerCommand("exit", {
+        description: "Exit the Qloo harness cleanly",
+        handler: async (_args, context) => context.shutdown()
+      });
       pi.registerCommand("status", {
         description: "Show Qloo profile, transport, model, workspace, and context usage",
         handler: async (_args, context) => {
           const usage = context.getContextUsage();
           const model = context.model ? `${context.model.provider}/${context.model.id}` : "unavailable";
-          context.ui.notify([
-            "Qloo status",
+          notifyReadable(context, "Qloo status", [
             `Profile: ${activeProfile}`,
             `Transport: ${runtimeInfo ? `${runtimeInfo.transport} (${runtimeInfo.transportName})` : "not declared"}`,
             `Resolution: ${runtimeInfo?.resolution ? `${runtimeInfo.resolution.name} (${runtimeInfo.resolution.tag_strategy}${runtimeInfo.resolution.uses_model ? ", model-assisted" : ""})` : "not declared"}`,
@@ -446,11 +462,21 @@ ${bounded}`);
             `Model: ${model}`,
             `Workspace: ${context.cwd}`,
             `Remembered matches: ${resolutionMemory.list().length}`,
-            `Context: ${usage?.tokens ?? "unknown"}/${usage?.contextWindow ?? "unknown"} tokens${usage?.percent === null || usage?.percent === void 0 ? "" : ` (${usage.percent.toFixed(1)}%)`}`,
+            `Context: ${formatContextUsage(usage)}`,
             `Turn budget: ${activeDefinition().maxToolCallsPerTurn} calls; ${activeDefinition().maxIdenticalToolCallsPerTurn} identical calls`
           ].join("\n"));
         }
       });
+      pi.registerCommand("usage", {
+        description: "Show current model context-window usage",
+        handler: async (_args, context) => {
+          const model = context.model ? `${context.model.provider}/${context.model.id}` : "unavailable";
+          notifyReadable(context, "Qloo context usage", [
+            `Model: ${model}`,
+            `Context used: ${formatContextUsage(context.getContextUsage())}`
+          ].join("\n"));
+        }
+      });
       pi.registerCommand("why", {
         description: "Show the normalized intent for the latest Qloo workflow",
         handler: async (_args, context) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qloo/qloo-harness",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Qloo-focused terminal agent built on the Pi SDK",
   "private": false,
   "publishConfig": {