@qloo/qloo-harness 0.1.19 → 0.1.20

package/README.md

@@ -358,6 +358,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.20";
 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.20";
 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",
@@ -432,6 +438,10 @@ ${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) => {
@@ -446,11 +456,22 @@ ${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";
+          context.ui.notify([
+            "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.20",
   "description": "Qloo-focused terminal agent built on the Pi SDK",
   "private": false,
   "publishConfig": {