llmist 1.2.0 → 1.3.1

package/dist/cli.js

@@ -26,7 +26,7 @@ import {
   resolveModel,
   schemaToJSONSchema,
   validateGadgetSchema
-} from "./chunk-KORMY3CD.js";
+} from "./chunk-RZTAKIDE.js";
 
 // src/cli/constants.ts
 var CLI_NAME = "llmist";
@@ -79,7 +79,7 @@ import { Command, InvalidArgumentError as InvalidArgumentError2 } from "commande
 // package.json
 var package_default = {
   name: "llmist",
-  version: "1.1.0",
+  version: "1.3.0",
   description: "Universal TypeScript LLM client with streaming-first agent framework. Works with any model - no structured outputs or native tool calling required. Implements its own flexible grammar for function calling.",
   type: "module",
   main: "dist/index.cjs",
@@ -226,26 +226,16 @@ var askUser = createGadget({
 });
 var tellUser = createGadget({
   name: "TellUser",
-  description: "Tell the user something important. Set done=true when your work is complete and you want to end the conversation.",
+  description: "Tell the user something important.",
   schema: z.object({
     message: z.string().optional().describe("The message to display to the user in Markdown"),
-    done: z.boolean().default(false).describe("Set to true to end the conversation, false to continue"),
     type: z.enum(["info", "success", "warning", "error"]).default("info").describe("Message type: info, success, warning, or error")
   }),
   examples: [
     {
-      comment: "Report successful completion and end the conversation",
-      params: {
-        message: "I've completed the refactoring. All tests pass.",
-        done: true,
-        type: "success"
-      }
-    },
-    {
-      comment: "Warn the user about something without ending",
+      comment: "Warn the user about something",
       params: {
         message: "Found 3 files with potential issues. Continuing analysis...",
-        done: false,
         type: "warning"
       }
     },
@@ -253,12 +243,11 @@ var tellUser = createGadget({
       comment: "Share detailed analysis with bullet points (use heredoc for multiline)",
       params: {
         message: "Here's what I found in the codebase:\n\n1. **Main entry point**: `src/index.ts` exports all public APIs\n2. **Core logic**: Located in `src/core/` with 5 modules\n3. **Tests**: Good coverage in `src/__tests__/`\n\nI'll continue exploring the core modules.",
-        done: false,
         type: "info"
       }
     }
   ],
-  execute: ({ message, done, type }) => {
+  execute: ({ message, type }) => {
     if (!message || message.trim() === "") {
       return "\u26A0\uFE0F  TellUser was called without a message. Please provide content in the 'message' field.";
     }
@@ -268,14 +257,24 @@ var tellUser = createGadget({
       warning: "\u26A0\uFE0F  ",
       error: "\u274C "
     };
-    const plainResult = prefixes[type] + message;
-    if (done) {
-      throw new BreakLoopException(plainResult);
+    return prefixes[type] + message;
+  }
+});
+var finish = createGadget({
+  name: "Finish",
+  description: "Signal that you have completed your task. Call this when your work is done.",
+  schema: z.object({}),
+  examples: [
+    {
+      comment: "Signal task completion",
+      params: {}
     }
-    return plainResult;
+  ],
+  execute: () => {
+    throw new BreakLoopException("Task completed");
   }
 });
-var builtinGadgets = [askUser, tellUser];
+var builtinGadgets = [askUser, tellUser, finish];
 
 // src/cli/gadgets.ts
 init_gadget();
@@ -831,6 +830,17 @@ var StreamProgress = class {
     } else {
       parts.push(iterPart);
     }
+    const usagePercent = this.getContextUsagePercent();
+    if (usagePercent !== null) {
+      const formatted = `${Math.round(usagePercent)}%`;
+      if (usagePercent >= 80) {
+        parts.push(chalk2.red(formatted));
+      } else if (usagePercent >= 50) {
+        parts.push(chalk2.yellow(formatted));
+      } else {
+        parts.push(chalk2.green(formatted));
+      }
+    }
     if (this.callInputTokens > 0) {
       const prefix = this.callInputTokensEstimated ? "~" : "";
       parts.push(chalk2.dim("\u2191") + chalk2.yellow(` ${prefix}${formatTokens(this.callInputTokens)}`));
@@ -866,6 +876,21 @@ var StreamProgress = class {
       return 0;
     }
   }
+  /**
+   * Calculates context window usage percentage.
+   * Returns null if model is unknown or context window unavailable.
+   */
+  getContextUsagePercent() {
+    if (!this.modelRegistry || !this.model || this.callInputTokens === 0) {
+      return null;
+    }
+    const modelName = this.model.includes(":") ? this.model.split(":")[1] : this.model;
+    const limits = this.modelRegistry.getModelLimits(modelName);
+    if (!limits?.contextWindow) {
+      return null;
+    }
+    return this.callInputTokens / limits.contextWindow * 100;
+  }
   renderCumulativeMode(spinner) {
     const elapsed = ((Date.now() - this.totalStartTime) / 1e3).toFixed(1);
     const parts = [];
@@ -1493,7 +1518,9 @@ function resolveTemplate(eta, template, context = {}, configPath) {
   try {
     const fullContext = {
       ...context,
-      env: process.env
+      env: process.env,
+      date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+      // "2025-12-01"
     };
     return eta.renderString(template, fullContext);
   } catch (error) {