@kl-c/matrixos 0.1.6 → 0.1.7

package/dist/cli/index.js

@@ -2145,7 +2145,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.1.6",
+    version: "0.1.7",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -122361,6 +122361,7 @@ init_zod();
 var WatchdogConfigSchema = object({
   enabled: boolean2().default(true),
   doomLoopThreshold: number2().int().positive().max(20).default(3),
+  softDoomLoopThreshold: number2().int().positive().max(20).default(5),
   stuckTimeoutSec: number2().int().positive().max(600).default(90),
   auditLogPath: string2().optional(),
   recoveryStrategy: _enum2(["nudge", "fallback", "restart", "notify", "safe"]).default("nudge"),

package/dist/cli-node/index.js

@@ -2145,7 +2145,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kl-c/matrixos",
-    version: "0.1.6",
+    version: "0.1.7",
     description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
     main: "./dist/index.js",
     types: "dist/index.d.ts",
@@ -122416,6 +122416,7 @@ init_zod();
 var WatchdogConfigSchema = object({
   enabled: boolean2().default(true),
   doomLoopThreshold: number2().int().positive().max(20).default(3),
+  softDoomLoopThreshold: number2().int().positive().max(20).default(5),
   stuckTimeoutSec: number2().int().positive().max(600).default(90),
   auditLogPath: string2().optional(),
   recoveryStrategy: _enum2(["nudge", "fallback", "restart", "notify", "safe"]).default("nudge"),

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -2449,6 +2449,7 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     watchdog: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         doomLoopThreshold: z.ZodDefault<z.ZodNumber>;
+        softDoomLoopThreshold: z.ZodDefault<z.ZodNumber>;
         stuckTimeoutSec: z.ZodDefault<z.ZodNumber>;
         auditLogPath: z.ZodOptional<z.ZodString>;
         recoveryStrategy: z.ZodDefault<z.ZodEnum<{

package/dist/config/schema/watchdog.d.ts

@@ -6,6 +6,7 @@ import * as z from "zod";
 export declare const WatchdogConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     doomLoopThreshold: z.ZodDefault<z.ZodNumber>;
+    softDoomLoopThreshold: z.ZodDefault<z.ZodNumber>;
     stuckTimeoutSec: z.ZodDefault<z.ZodNumber>;
     auditLogPath: z.ZodOptional<z.ZodString>;
     recoveryStrategy: z.ZodDefault<z.ZodEnum<{

package/dist/features/anti-loop/logger.d.ts

@@ -0,0 +1,15 @@
+export type AntiLoopPattern = "doom_loop" | "soft_doom_loop" | "stuck" | "zombie_session" | "hook_recursion" | "agent_avoidance" | "context_bloat" | "runaway_task";
+export interface AntiLoopEvent {
+    timestamp: string;
+    sessionId?: string;
+    pattern: AntiLoopPattern;
+    agent?: string;
+    toolName?: string;
+    detail: string;
+    actionTaken: string;
+    outcome?: string;
+}
+export interface AntiLoopLogger {
+    log(event: Omit<AntiLoopEvent, "timestamp">): void;
+}
+export declare function createAntiLoopLogger(logsDir: string): AntiLoopLogger;

package/dist/hooks/agent-anti-loop/hook.d.ts

@@ -1,49 +1,28 @@
-/**
- * Agent-level anti-loop watchdog (§4.12).
- *
- * Attaches to `tool.execute.after` to track tool call signatures and detect
- * doom loops (same tool ≥3x identical). Also monitors a stuck timer (90s
- * default) since the last meaningful tool call.
- *
- * Recovery escalation (CDC §4.12.3):
- *   Level 1 — Nudge: inject a message telling the agent it appears stuck
- *   Level 2 — Fallback: switch model (delegates to runtime-fallback)
- *   Level 3 — Restart: kill + restart session (future phase)
- *
- * The watchdog is opt-in via `watchdog.enabled` in the config.
- */
 import type { WatchdogConfig } from "../../config/schema/watchdog";
 export interface ToolCallRecord {
-    /** Tool name, e.g. "bash", "edit", "read". */
     tool: string;
-    /** Stable signature: toolName + sorted JSON args. */
     signature: string;
-    /** Timestamp of the call. */
     timestamp: number;
-    /** Whether the tool produced meaningful output (text > 0). */
     meaningful: boolean;
 }
+export declare function signaturesSimilar(a: string, b: string): boolean;
 export interface AgentAntiLoopState {
-    /** Per-signature consecutive count. */
     consecutiveBySignature: Map<string, number>;
-    /** Last meaningful tool timestamp (epoch ms). */
+    recentSignatures: string[];
     lastMeaningfulToolAt: number;
-    /** Whether a nudge has already been sent (cooldown). */
     nudged: boolean;
-    /** Whether fallback has been triggered. */
     fallbackTriggered: boolean;
+    avoidanceCount: number;
+    avoidanceEscalated: boolean;
 }
 export interface AgentAntiLoopHooks {
-    /** Call on every tool.execute.after. */
     onToolAfter(tool: string, args: unknown, output: unknown): void;
-    /** Call periodically (e.g. on session.idle) to check stuck timer. */
+    onAgentMessage(content: string): void;
     checkStuck(): {
         stuck: boolean;
         secondsSinceLastMeaningful: number;
     };
-    /** Reset the state (e.g. on session start). */
     reset(): void;
-    /** Get the current state (for audit). */
     getState(): AgentAntiLoopState;
 }
 export declare function createAgentAntiLoopHooks(config: WatchdogConfig): AgentAntiLoopHooks;

package/dist/index.js

@@ -57285,7 +57285,7 @@ var require_dist10 = __commonJS((exports, module) => {
   var import_node_worker_threads2 = __require("worker_threads");
   var import_collection2 = require_dist3();
   var import_node_events = __require("events");
-  var import_node_path126 = __require("path");
+  var import_node_path128 = __require("path");
   var import_node_worker_threads = __require("worker_threads");
   var import_collection = require_dist3();
   var WorkerSendPayloadOp = /* @__PURE__ */ ((WorkerSendPayloadOp2) => {
@@ -57420,18 +57420,18 @@ var require_dist10 = __commonJS((exports, module) => {
     resolveWorkerPath() {
       const path28 = this.options.workerPath;
       if (!path28) {
-        return (0, import_node_path126.join)(__dirname, "defaultWorker.js");
+        return (0, import_node_path128.join)(__dirname, "defaultWorker.js");
       }
-      if ((0, import_node_path126.isAbsolute)(path28)) {
+      if ((0, import_node_path128.isAbsolute)(path28)) {
         return path28;
       }
       if (/^\.\.?[/\\]/.test(path28)) {
-        return (0, import_node_path126.resolve)(path28);
+        return (0, import_node_path128.resolve)(path28);
       }
       try {
         return __require.resolve(path28);
       } catch {
-        return (0, import_node_path126.resolve)(path28);
+        return (0, import_node_path128.resolve)(path28);
       }
     }
     async waitForWorkerReady(worker) {
@@ -233073,7 +233073,7 @@ import * as Crypto from "crypto";
 import { once } from "events";
 import { createReadStream, createWriteStream, promises as fs26, WriteStream } from "fs";
 import { tmpdir as tmpdir8 } from "os";
-import { join as join134 } from "path";
+import { join as join136 } from "path";
 import { Readable as Readable2, Transform } from "stream";
 import { URL as URL2 } from "url";
 async function getMediaKeys(buffer2, mediaType) {
@@ -233151,7 +233151,7 @@ async function generateThumbnail(file2, mediaType, options) {
       };
     }
   } else if (mediaType === "video") {
-    const imgFilename = join134(getTmpFilesDirectory(), generateMessageIDV2() + ".jpg");
+    const imgFilename = join136(getTmpFilesDirectory(), generateMessageIDV2() + ".jpg");
     try {
       await extractVideoThumb(file2, imgFilename, "00:00:00", { width: 32, height: 32 });
       const buff = await fs26.readFile(imgFilename);
@@ -233194,7 +233194,7 @@ var import_boom5, getTmpFilesDirectory = () => tmpdir8(), getImageProcessingLibr
   const { stream: stream3 } = await getStream(media);
   logger7?.debug("got stream for raw upload");
   const hasher = Crypto.createHash("sha256");
-  const filePath = join134(tmpdir8(), mediaType + generateMessageIDV2());
+  const filePath = join136(tmpdir8(), mediaType + generateMessageIDV2());
   const fileWriteStream = createWriteStream(filePath);
   let fileLength = 0;
   try {
@@ -233334,12 +233334,12 @@ var import_boom5, getTmpFilesDirectory = () => tmpdir8(), getImageProcessingLibr
   logger7?.debug("fetched media stream");
   const mediaKey = Crypto.randomBytes(32);
   const { cipherKey, iv, macKey } = await getMediaKeys(mediaKey, mediaType);
-  const encFilePath = join134(getTmpFilesDirectory(), mediaType + generateMessageIDV2() + "-enc");
+  const encFilePath = join136(getTmpFilesDirectory(), mediaType + generateMessageIDV2() + "-enc");
   const encFileWriteStream = createWriteStream(encFilePath);
   let originalFileStream;
   let originalFilePath;
   if (saveOriginalFileIfRequired) {
-    originalFilePath = join134(getTmpFilesDirectory(), mediaType + generateMessageIDV2() + "-original");
+    originalFilePath = join136(getTmpFilesDirectory(), mediaType + generateMessageIDV2() + "-original");
     originalFileStream = createWriteStream(originalFilePath);
   }
   let fileLength = 0;
@@ -242744,7 +242744,7 @@ var init_auth_utils = __esm(() => {
 
 // node_modules/.bun/@whiskeysockets+baileys@7.0.0-rc13+13d21a63c79191a3/node_modules/@whiskeysockets/baileys/lib/Utils/use-multi-file-auth-state.js
 import { mkdir as mkdir11, readFile as readFile14, stat as stat8, unlink as unlink3, writeFile as writeFile4 } from "fs/promises";
-import { join as join135 } from "path";
+import { join as join137 } from "path";
 var fileLocks, getFileLock = (path28) => {
   let mutex = fileLocks.get(path28);
   if (!mutex) {
@@ -242754,7 +242754,7 @@ var fileLocks, getFileLock = (path28) => {
   return mutex;
 }, useMultiFileAuthState = async (folder) => {
   const writeData = async (data3, file2) => {
-    const filePath = join135(folder, fixFileName(file2));
+    const filePath = join137(folder, fixFileName(file2));
     const mutex = getFileLock(filePath);
     return mutex.acquire().then(async (release2) => {
       try {
@@ -242766,7 +242766,7 @@ var fileLocks, getFileLock = (path28) => {
   };
   const readData = async (file2) => {
     try {
-      const filePath = join135(folder, fixFileName(file2));
+      const filePath = join137(folder, fixFileName(file2));
       const mutex = getFileLock(filePath);
       return await mutex.acquire().then(async (release2) => {
         try {
@@ -242782,7 +242782,7 @@ var fileLocks, getFileLock = (path28) => {
   };
   const removeData = async (file2) => {
     try {
-      const filePath = join135(folder, fixFileName(file2));
+      const filePath = join137(folder, fixFileName(file2));
       const mutex = getFileLock(filePath);
       return mutex.acquire().then(async (release2) => {
         try {
@@ -263753,7 +263753,7 @@ var require_thread_stream = __commonJS((exports, module) => {
   var { version: version2 } = require_package3();
   var { EventEmitter: EventEmitter4 } = __require("events");
   var { Worker } = __require("worker_threads");
-  var { join: join136 } = __require("path");
+  var { join: join138 } = __require("path");
   var { pathToFileURL: pathToFileURL2 } = __require("url");
   var { wait: wait2 } = require_wait2();
   var {
@@ -263796,7 +263796,7 @@ var require_thread_stream = __commonJS((exports, module) => {
   function createWorker(stream3, opts) {
     const { filename, workerData } = opts;
     const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
-    const toExecute = bundlerOverrides["thread-stream-worker"] || join136(__dirname, "lib", "worker.js");
+    const toExecute = bundlerOverrides["thread-stream-worker"] || join138(__dirname, "lib", "worker.js");
     const worker = new Worker(toExecute, {
       ...opts.workerOpts,
       trackUnmanagedFds: false,
@@ -264197,7 +264197,7 @@ var require_transport = __commonJS((exports, module) => {
   var __dirname = "/home/shiro/MaTrixOS/node_modules/.bun/pino@9.14.0/node_modules/pino/lib";
   var { createRequire: createRequire4 } = __require("module");
   var getCallers = require_caller();
-  var { join: join136, isAbsolute: isAbsolute21, sep: sep3 } = __require("path");
+  var { join: join138, isAbsolute: isAbsolute21, sep: sep3 } = __require("path");
   var sleep3 = require_atomic_sleep();
   var onExit = require_on_exit_leak_free();
   var ThreadStream = require_thread_stream();
@@ -264260,7 +264260,7 @@ var require_transport = __commonJS((exports, module) => {
       throw new Error("only one of target or targets can be specified");
     }
     if (targets) {
-      target = bundlerOverrides["pino-worker"] || join136(__dirname, "worker.js");
+      target = bundlerOverrides["pino-worker"] || join138(__dirname, "worker.js");
       options.targets = targets.filter((dest) => dest.target).map((dest) => {
         return {
           ...dest,
@@ -264277,7 +264277,7 @@ var require_transport = __commonJS((exports, module) => {
         });
       });
     } else if (pipeline3) {
-      target = bundlerOverrides["pino-worker"] || join136(__dirname, "worker.js");
+      target = bundlerOverrides["pino-worker"] || join138(__dirname, "worker.js");
       options.pipelines = [pipeline3.map((dest) => {
         return {
           ...dest,
@@ -264299,7 +264299,7 @@ var require_transport = __commonJS((exports, module) => {
         return origin;
       }
       if (origin === "pino/file") {
-        return join136(__dirname, "..", "file.js");
+        return join138(__dirname, "..", "file.js");
       }
       let fixTarget2;
       for (const filePath of callers) {
@@ -265237,7 +265237,7 @@ var require_safe_stable_stringify = __commonJS((exports, module) => {
             return circularValue;
           }
           let res = "";
-          let join136 = ",";
+          let join138 = ",";
           const originalIndentation = indentation;
           if (Array.isArray(value)) {
             if (value.length === 0) {
@@ -265251,7 +265251,7 @@ var require_safe_stable_stringify = __commonJS((exports, module) => {
               indentation += spacer;
               res += `
 ${indentation}`;
-              join136 = `,
+              join138 = `,
 ${indentation}`;
             }
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -265259,13 +265259,13 @@ ${indentation}`;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
               res += tmp2 !== undefined ? tmp2 : "null";
-              res += join136;
+              res += join138;
             }
             const tmp = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
             res += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res += `${join136}"... ${getItemCount(removedKeys)} not stringified"`;
+              res += `${join138}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             if (spacer !== "") {
               res += `
@@ -265286,7 +265286,7 @@ ${originalIndentation}`;
           let separator = "";
           if (spacer !== "") {
             indentation += spacer;
-            join136 = `,
+            join138 = `,
 ${indentation}`;
             whitespace = " ";
           }
@@ -265300,13 +265300,13 @@ ${indentation}`;
             const tmp = stringifyFnReplacer(key2, value, stack, replacer, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-              separator = join136;
+              separator = join138;
             }
           }
           if (keyLength > maximumBreadth) {
             const removedKeys = keyLength - maximumBreadth;
             res += `${separator}"...":${whitespace}"${getItemCount(removedKeys)} not stringified"`;
-            separator = join136;
+            separator = join138;
           }
           if (spacer !== "" && separator.length > 1) {
             res = `
@@ -265346,7 +265346,7 @@ ${originalIndentation}`;
           }
           const originalIndentation = indentation;
           let res = "";
-          let join136 = ",";
+          let join138 = ",";
           if (Array.isArray(value)) {
             if (value.length === 0) {
               return "[]";
@@ -265359,7 +265359,7 @@ ${originalIndentation}`;
               indentation += spacer;
               res += `
 ${indentation}`;
-              join136 = `,
+              join138 = `,
 ${indentation}`;
             }
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -265367,13 +265367,13 @@ ${indentation}`;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
               res += tmp2 !== undefined ? tmp2 : "null";
-              res += join136;
+              res += join138;
             }
             const tmp = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
             res += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res += `${join136}"... ${getItemCount(removedKeys)} not stringified"`;
+              res += `${join138}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             if (spacer !== "") {
               res += `
@@ -265386,7 +265386,7 @@ ${originalIndentation}`;
           let whitespace = "";
           if (spacer !== "") {
             indentation += spacer;
-            join136 = `,
+            join138 = `,
 ${indentation}`;
             whitespace = " ";
           }
@@ -265395,7 +265395,7 @@ ${indentation}`;
             const tmp = stringifyArrayReplacer(key2, value[key2], stack, replacer, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-              separator = join136;
+              separator = join138;
             }
           }
           if (spacer !== "" && separator.length > 1) {
@@ -265452,20 +265452,20 @@ ${originalIndentation}`;
             indentation += spacer;
             let res2 = `
 ${indentation}`;
-            const join137 = `,
+            const join139 = `,
 ${indentation}`;
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
             let i = 0;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyIndent(String(i), value[i], stack, spacer, indentation);
               res2 += tmp2 !== undefined ? tmp2 : "null";
-              res2 += join137;
+              res2 += join139;
             }
             const tmp = stringifyIndent(String(i), value[i], stack, spacer, indentation);
             res2 += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res2 += `${join137}"... ${getItemCount(removedKeys)} not stringified"`;
+              res2 += `${join139}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             res2 += `
 ${originalIndentation}`;
@@ -265481,16 +265481,16 @@ ${originalIndentation}`;
             return '"[Object]"';
           }
           indentation += spacer;
-          const join136 = `,
+          const join138 = `,
 ${indentation}`;
           let res = "";
           let separator = "";
           let maximumPropertiesToStringify = Math.min(keyLength, maximumBreadth);
           if (isTypedArrayWithEntries(value)) {
-            res += stringifyTypedArray(value, join136, maximumBreadth);
+            res += stringifyTypedArray(value, join138, maximumBreadth);
             keys = keys.slice(value.length);
             maximumPropertiesToStringify -= value.length;
-            separator = join136;
+            separator = join138;
           }
           if (deterministic) {
             keys = sort(keys, comparator);
@@ -265501,13 +265501,13 @@ ${indentation}`;
             const tmp = stringifyIndent(key2, value[key2], stack, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}: ${tmp}`;
-              separator = join136;
+              separator = join138;
             }
           }
           if (keyLength > maximumBreadth) {
             const removedKeys = keyLength - maximumBreadth;
             res += `${separator}"...": "${getItemCount(removedKeys)} not stringified"`;
-            separator = join136;
+            separator = join138;
           }
           if (separator !== "") {
             res = `
@@ -266157,7 +266157,7 @@ var init_Defaults = __esm(() => {
 import { createHash as createHash13 } from "crypto";
 import { createWriteStream as createWriteStream2, promises as fs28 } from "fs";
 import { tmpdir as tmpdir9 } from "os";
-import { join as join136 } from "path";
+import { join as join138 } from "path";
 async function uploadingNecessaryImagesOfProduct(product, waUploadToServer, timeoutMs = 30000) {
   product = {
     ...product,
@@ -266335,7 +266335,7 @@ var import_boom12, parseCatalogNode = (node) => {
     }
     const { stream: stream3 } = await getStream(img);
     const hasher = createHash13("sha256");
-    const filePath = join136(tmpdir9(), "img" + generateMessageIDV2());
+    const filePath = join138(tmpdir9(), "img" + generateMessageIDV2());
     const encFileWriteStream = createWriteStream2(filePath);
     for await (const block2 of stream3) {
       hasher.update(block2);
@@ -297183,18 +297183,18 @@ var init_merge = __esm(() => {
 });
 
 // packages/omo-config-core/src/loader/types.ts
-import { existsSync as existsSync113, lstatSync as lstatSync5, readFileSync as readFileSync77 } from "fs";
+import { existsSync as existsSync114, lstatSync as lstatSync5, readFileSync as readFileSync77 } from "fs";
 var DEFAULT_READ_FILE_SYSTEM;
 var init_types7 = __esm(() => {
   DEFAULT_READ_FILE_SYSTEM = {
-    existsSync: existsSync113,
+    existsSync: existsSync114,
     lstatSync: lstatSync5,
     readFileSync: readFileSync77
   };
 });
 
 // packages/omo-config-core/src/loader/paths.ts
-import { dirname as dirname45, isAbsolute as isAbsolute21, join as join137, relative as relative15, resolve as resolve42 } from "path";
+import { dirname as dirname45, isAbsolute as isAbsolute21, join as join139, relative as relative15, resolve as resolve42 } from "path";
 function containsPath2(parent, child) {
   const pathToChild = relative15(parent, child);
   return pathToChild === "" || !pathToChild.startsWith("..") && !isAbsolute21(pathToChild);
@@ -297203,23 +297203,23 @@ function resolveHomeDir(env2 = process.env) {
   return resolve42(env2.HOME ?? env2.USERPROFILE ?? process.cwd());
 }
 function resolveUserMatrixosConfigPath(env2 = process.env, platform4 = process.platform) {
-  return join137(resolveUserMatrixosConfigDirectory(env2, platform4), "omo.jsonc");
+  return join139(resolveUserMatrixosConfigDirectory(env2, platform4), "omo.jsonc");
 }
 function resolveUserMatrixosConfigDirectory(env2 = process.env, platform4 = process.platform) {
   if (platform4 === "win32" && env2.APPDATA !== undefined && env2.APPDATA.length > 0) {
-    return join137(env2.APPDATA, "omo");
+    return join139(env2.APPDATA, "omo");
   }
   if (env2.XDG_CONFIG_HOME !== undefined && env2.XDG_CONFIG_HOME.length > 0) {
-    return join137(env2.XDG_CONFIG_HOME, "omo");
+    return join139(env2.XDG_CONFIG_HOME, "omo");
   }
-  return join137(resolveHomeDir(env2), ".config", "omo");
+  return join139(resolveHomeDir(env2), ".config", "omo");
 }
 function detectUserOmoJsonPath(env2, platform4, fileSystem) {
   const configDir = resolveUserMatrixosConfigDirectory(env2, platform4);
-  const jsoncPath = join137(configDir, "omo.jsonc");
+  const jsoncPath = join139(configDir, "omo.jsonc");
   if (fileSystem.existsSync(jsoncPath))
     return jsoncPath;
-  const jsonPath = join137(configDir, "omo.json");
+  const jsonPath = join139(configDir, "omo.json");
   return fileSystem.existsSync(jsonPath) ? jsonPath : jsoncPath;
 }
 function isSymlinkedProjectPath(path28, fileSystem) {
@@ -297237,13 +297237,13 @@ function isLoadableProjectConfigFile(path28, fileSystem) {
   return fileSystem.existsSync(path28) && !isSymlinkedProjectPath(path28, fileSystem);
 }
 function detectOmoJsonPath(dir2, fileSystem) {
-  const omoDir = join137(dir2, ".omo");
+  const omoDir = join139(dir2, ".omo");
   if (isSymlinkedProjectPath(omoDir, fileSystem))
     return null;
-  const jsoncPath = join137(omoDir, "omo.jsonc");
+  const jsoncPath = join139(omoDir, "omo.jsonc");
   if (isLoadableProjectConfigFile(jsoncPath, fileSystem))
     return jsoncPath;
-  const jsonPath = join137(omoDir, "omo.json");
+  const jsonPath = join139(omoDir, "omo.json");
   return isLoadableProjectConfigFile(jsonPath, fileSystem) ? jsonPath : null;
 }
 function findProjectConfigPathsFarthestFirst(cwd, homeDir, fileSystem) {
@@ -297504,9 +297504,9 @@ var init_loader3 = __esm(() => {
 // packages/omo-config-core/src/writer/types.ts
 import {
   copyFileSync as copyFileSync3,
-  existsSync as existsSync114,
+  existsSync as existsSync115,
   lstatSync as lstatSync6,
-  mkdirSync as mkdirSync24,
+  mkdirSync as mkdirSync25,
   readFileSync as readFileSync78,
   readdirSync as readdirSync29,
   renameSync as renameSync10,
@@ -297517,9 +297517,9 @@ var DEFAULT_WRITE_FILE_SYSTEM, MatrixosConfigWriteError;
 var init_types8 = __esm(() => {
   DEFAULT_WRITE_FILE_SYSTEM = {
     copyFileSync: copyFileSync3,
-    existsSync: existsSync114,
+    existsSync: existsSync115,
     lstatSync: lstatSync6,
-    mkdirSync: mkdirSync24,
+    mkdirSync: mkdirSync25,
     readFileSync: readFileSync78,
     readdirSync: readdirSync29,
     renameSync: renameSync10,
@@ -297544,7 +297544,7 @@ var init_types8 = __esm(() => {
 
 // packages/omo-config-core/src/writer/writer.ts
 import { randomUUID as randomUUID13 } from "crypto";
-import { dirname as dirname46, join as join138 } from "path";
+import { dirname as dirname46, join as join140 } from "path";
 function backupSuffix() {
   return new Date().toISOString().replace(/[:.]/g, "-");
 }
@@ -297575,13 +297575,13 @@ function resolveWritePath(options) {
     const jsoncPath2 = resolveUserMatrixosConfigPath(options.env, options.platform ?? process.platform);
     if (fileSystem.existsSync(jsoncPath2))
       return jsoncPath2;
-    const jsonPath2 = join138(dirname46(jsoncPath2), "omo.json");
+    const jsonPath2 = join140(dirname46(jsoncPath2), "omo.json");
     return fileSystem.existsSync(jsonPath2) ? jsonPath2 : jsoncPath2;
   }
-  const jsoncPath = join138(options.projectDir ?? process.cwd(), ".omo", "omo.jsonc");
+  const jsoncPath = join140(options.projectDir ?? process.cwd(), ".omo", "omo.jsonc");
   if (fileSystem.existsSync(jsoncPath))
     return jsoncPath;
-  const jsonPath = join138(dirname46(jsoncPath), "omo.json");
+  const jsonPath = join140(dirname46(jsoncPath), "omo.json");
   return fileSystem.existsSync(jsonPath) ? jsonPath : jsoncPath;
 }
 function writeAtomically(path28, content, fileSystem) {
@@ -297693,8 +297693,8 @@ var init_writer2 = __esm(() => {
 });
 
 // packages/omo-config-core/src/generator/mini-os-generator.ts
-import { existsSync as existsSync115, mkdirSync as mkdirSync25, writeFileSync as writeFileSync26 } from "fs";
-import { dirname as dirname47, join as join139 } from "path";
+import { existsSync as existsSync116, mkdirSync as mkdirSync26, writeFileSync as writeFileSync26 } from "fs";
+import { dirname as dirname47, join as join141 } from "path";
 function generateMiniOS(options) {
   const fs29 = options.fs ?? defaultFS;
   const profile3 = options.profile;
@@ -297705,29 +297705,29 @@ function generateMiniOS(options) {
   if (!fs29.existsSync(targetDir)) {
     fs29.mkdirSync(targetDir, { recursive: true });
   }
-  const pkgPath = join139(targetDir, "package.json");
+  const pkgPath = join141(targetDir, "package.json");
   writeIfMissing(fs29, pkgPath, TPL_PACKAGE_JSON(packageName, displayName, profile3.version, profile3.description, profile3.extends, profile3.baseAgent));
   filesWritten.push(pkgPath);
-  const srcDir = join139(targetDir, "src");
+  const srcDir = join141(targetDir, "src");
   fs29.mkdirSync(srcDir, { recursive: true });
-  const indexPath = join139(srcDir, "index.ts");
+  const indexPath = join141(srcDir, "index.ts");
   writeIfMissing(fs29, indexPath, TPL_INDEX_TS(profile3.name, displayName, profile3.description));
   filesWritten.push(indexPath);
-  const binDir = join139(targetDir, "bin");
+  const binDir = join141(targetDir, "bin");
   fs29.mkdirSync(binDir, { recursive: true });
-  const binPath = join139(binDir, "matrixos-mini.js");
+  const binPath = join141(binDir, "matrixos-mini.js");
   writeIfMissing(fs29, binPath, TPL_BIN);
   filesWritten.push(binPath);
-  const scriptDir = join139(targetDir, "script");
+  const scriptDir = join141(targetDir, "script");
   fs29.mkdirSync(scriptDir, { recursive: true });
-  const buildPath = join139(scriptDir, "build.ts");
+  const buildPath = join141(scriptDir, "build.ts");
   writeIfMissing(fs29, buildPath, TPL_BUILD_TS);
   filesWritten.push(buildPath);
   if (Object.keys(profile3.agents).length > 0) {
-    const agentsDir = join139(targetDir, "agents");
+    const agentsDir = join141(targetDir, "agents");
     fs29.mkdirSync(agentsDir, { recursive: true });
     for (const [agentName, agentDef] of Object.entries(profile3.agents)) {
-      const agentFile = join139(agentsDir, `${agentName}.ts`);
+      const agentFile = join141(agentsDir, `${agentName}.ts`);
       const description2 = agentDef.description ?? `Custom ${displayName} agent: ${agentName}`;
       writeIfMissing(fs29, agentFile, `// ${description2}
 // Generated by MaTrixOS Mini-OS Profile Generator.
@@ -297738,10 +297738,10 @@ export const description = ${JSON.stringify(description2)}
     }
   }
   if (profile3.skills.length > 0) {
-    const skillsDir = join139(targetDir, "skills");
+    const skillsDir = join141(targetDir, "skills");
     fs29.mkdirSync(skillsDir, { recursive: true });
     for (const skill2 of profile3.skills) {
-      const skillFile = join139(skillsDir, `${skill2}.md`);
+      const skillFile = join141(skillsDir, `${skill2}.md`);
       writeIfMissing(fs29, skillFile, `# ${skill2}
 
 _Skill required by the ${displayName} profile. Implementation goes here._
@@ -297749,12 +297749,12 @@ _Skill required by the ${displayName} profile. Implementation goes here._
       filesWritten.push(skillFile);
     }
   }
-  const readmePath = join139(targetDir, "README.md");
+  const readmePath = join141(targetDir, "README.md");
   const agentsList = Object.keys(profile3.agents);
   const skillsList = profile3.skills;
   writeIfMissing(fs29, readmePath, TPL_README(packageName, displayName, profile3.description, profile3.version, profile3.baseAgent, profile3.extends, agentsList, skillsList));
   filesWritten.push(readmePath);
-  const agentsMdPath = join139(targetDir, "AGENTS.md");
+  const agentsMdPath = join141(targetDir, "AGENTS.md");
   writeIfMissing(fs29, agentsMdPath, TPL_AGENT_MD(displayName, profile3.description));
   filesWritten.push(agentsMdPath);
   return { packageName, packageDir: targetDir, filesWritten };
@@ -297906,7 +297906,7 @@ This profile is activated when the user mentions the profile name in their reque
 - Profiles can be composed: multiple profiles in \`profiles: [...]\` are merged in order.
 `;
 var init_mini_os_generator = __esm(() => {
-  defaultFS = { existsSync: existsSync115, mkdirSync: mkdirSync25, writeFileSync: writeFileSync26 };
+  defaultFS = { existsSync: existsSync116, mkdirSync: mkdirSync26, writeFileSync: writeFileSync26 };
 });
 
 // packages/omo-config-core/src/generator/index.ts
@@ -367932,7 +367932,7 @@ function getCachedVersion(options = {}) {
 // package.json
 var package_default = {
   name: "@kl-c/matrixos",
-  version: "0.1.6",
+  version: "0.1.7",
   description: "MaTrixOS \u2014 Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -441310,12 +441310,30 @@ function createPluginInterface(args) {
 }
 
 // packages/omo-opencode/src/hooks/agent-anti-loop/hook.ts
+function signaturesSimilar(a, b) {
+  if (a === b)
+    return true;
+  const aTool = a.split(":")[0] ?? "";
+  const bTool = b.split(":")[0] ?? "";
+  if (aTool !== bTool)
+    return false;
+  return true;
+}
+var AVOIDANCE_PATTERNS = [
+  /\btry\s+(again|a different|another)\b/i,
+  /\bI'?ll\s+(try|attempt|give\s+it\s+another)\b/i,
+  /\blet\s+me\s+try\s+again\b/i,
+  /\bI\s+apologize\b.*\btry\b/i
+];
 function createAgentAntiLoopHooks(config) {
   const state3 = {
     consecutiveBySignature: new Map,
+    recentSignatures: [],
     lastMeaningfulToolAt: Date.now(),
     nudged: false,
-    fallbackTriggered: false
+    fallbackTriggered: false,
+    avoidanceCount: 0,
+    avoidanceEscalated: false
   };
   function makeSignature(tool3, args) {
     try {
@@ -441341,6 +441359,7 @@ function createAgentAntiLoopHooks(config) {
       const prev = state3.consecutiveBySignature.get(sig) ?? 0;
       const count = prev + 1;
       state3.consecutiveBySignature.set(sig, count);
+      state3.recentSignatures.push(sig);
       if (isMeaningfulOutput(output)) {
         state3.lastMeaningfulToolAt = now;
         state3.nudged = false;
@@ -441349,29 +441368,68 @@ function createAgentAntiLoopHooks(config) {
       if (count >= config.doomLoopThreshold) {
         state3.consecutiveBySignature.set(sig, 0);
       }
+      const similarCount = state3.recentSignatures.filter((s) => signaturesSimilar(s, sig)).length;
+      if (similarCount >= config.softDoomLoopThreshold) {
+        state3.consecutiveBySignature.set(sig, 0);
+      }
+    },
+    onAgentMessage(content) {
+      const isAvoidance = AVOIDANCE_PATTERNS.some((p) => p.test(content));
+      if (isAvoidance) {
+        state3.avoidanceCount += 1;
+      } else {
+        state3.avoidanceCount = 0;
+      }
     },
     checkStuck() {
       const now = Date.now();
       const elapsed = now - state3.lastMeaningfulToolAt;
-      const secondsSinceLastMeaningful = Math.floor(elapsed / 1000);
-      const stuck = secondsSinceLastMeaningful >= config.stuckTimeoutSec;
-      return { stuck, secondsSinceLastMeaningful };
+      return { stuck: elapsed >= config.stuckTimeoutSec * 1000, secondsSinceLastMeaningful: Math.floor(elapsed / 1000) };
     },
     reset() {
       state3.consecutiveBySignature.clear();
+      state3.recentSignatures = [];
       state3.lastMeaningfulToolAt = Date.now();
       state3.nudged = false;
       state3.fallbackTriggered = false;
+      state3.avoidanceCount = 0;
+      state3.avoidanceEscalated = false;
     },
     getState() {
-      return { ...state3, consecutiveBySignature: new Map(state3.consecutiveBySignature) };
+      return { ...state3, consecutiveBySignature: new Map(state3.consecutiveBySignature), recentSignatures: [...state3.recentSignatures] };
+    }
+  };
+}
+
+// packages/omo-opencode/src/features/anti-loop/logger.ts
+import { existsSync as existsSync112, mkdirSync as mkdirSync24, appendFileSync as appendFileSync8 } from "fs";
+import { join as join134 } from "path";
+function createAntiLoopLogger(logsDir) {
+  const logFile = join134(logsDir, "anti-loop.jsonl");
+  const parentDir = join134(logsDir, "..");
+  if (!existsSync112(logsDir)) {
+    mkdirSync24(logsDir, { recursive: true });
+  }
+  return {
+    log(event) {
+      const entry = {
+        ...event,
+        timestamp: new Date().toISOString()
+      };
+      try {
+        appendFileSync8(logFile, JSON.stringify(entry) + `
+`, "utf-8");
+      } catch {}
     }
   };
 }
 
 // packages/omo-opencode/src/plugin/agent-anti-loop.ts
+import { join as join135 } from "path";
 function createAgentAntiLoopWiring(config, deps) {
   const hooks = createAgentAntiLoopHooks(config);
+  const logDir = deps.projectDir ? join135(deps.projectDir, ".matrixos", "logs") : process.cwd();
+  const antiLoopLog = createAntiLoopLogger(logDir);
   return {
     toolExecuteAfter(input) {
       hooks.onToolAfter(input.tool, input.args, input.output);
@@ -441379,25 +441437,38 @@ function createAgentAntiLoopWiring(config, deps) {
       const sig = `${input.tool}:${JSON.stringify(input.args)}`;
       const count = state3.consecutiveBySignature.get(sig) ?? 0;
       if (count === 0 && state3.consecutiveBySignature.has(sig)) {
-        deps.log("[agent-anti-loop] doom loop detected", {
-          tool: input.tool,
-          threshold: config.doomLoopThreshold
-        });
+        deps.log("[agent-anti-loop] doom loop detected", { tool: input.tool, threshold: config.doomLoopThreshold });
+        antiLoopLog.log({ sessionId: process.env.OMO_SESSION_ID, pattern: "doom_loop", toolName: input.tool, detail: `${input.tool} called >=${config.doomLoopThreshold}x identical`, actionTaken: "counter_reset" });
         if (deps.injectNudge) {
-          deps.injectNudge(`\u26A0\uFE0F You appear to be repeating the same tool (${input.tool}) without progress. Try a different approach.`);
+          deps.injectNudge(`Watchdog: tool ${input.tool} repeated without progress. Try a different approach.`);
         }
       }
+      const similarCount = state3.recentSignatures.filter((s) => s.startsWith(input.tool + ":")).length;
+      if (similarCount >= config.softDoomLoopThreshold) {
+        deps.log("[agent-anti-loop] soft doom loop warning", { tool: input.tool, similarCalls: similarCount });
+        antiLoopLog.log({ sessionId: process.env.OMO_SESSION_ID, pattern: "soft_doom_loop", toolName: input.tool, detail: `${input.tool} called ${similarCount}x with similar args`, actionTaken: "warning" });
+      }
+    },
+    onAgentMessage(content) {
+      hooks.onAgentMessage(content);
+      const state3 = hooks.getState();
+      if (state3.avoidanceCount >= 3 && !state3.avoidanceEscalated) {
+        deps.log("[agent-anti-loop] agent avoidance detected", { avoidanceCount: state3.avoidanceCount });
+        antiLoopLog.log({ sessionId: process.env.OMO_SESSION_ID, pattern: "agent_avoidance", detail: `"I'll try again" pattern ${state3.avoidanceCount}x`, actionTaken: "nudge" });
+        if (deps.injectNudge) {
+          deps.injectNudge("You appear stuck in a loop. Stop and analyze what went wrong before trying again.");
+        }
+        state3.avoidanceEscalated = true;
+      }
     },
     async sessionIdle() {
       const { stuck, secondsSinceLastMeaningful } = hooks.checkStuck();
       if (!stuck)
         return;
-      deps.log("[agent-anti-loop] stuck detected", {
-        secondsSinceLastMeaningful,
-        recoveryStrategy: config.recoveryStrategy
-      });
+      deps.log("[agent-anti-loop] stuck detected", { secondsSinceLastMeaningful, recoveryStrategy: config.recoveryStrategy });
+      antiLoopLog.log({ sessionId: process.env.OMO_SESSION_ID, pattern: "stuck", detail: `No progress for ${secondsSinceLastMeaningful}s`, actionTaken: config.recoveryStrategy });
       if (config.recoveryStrategy === "nudge" && deps.injectNudge) {
-        deps.injectNudge(`\u26A0\uFE0F No meaningful progress for ${secondsSinceLastMeaningful}s. Try a different approach or ask for help.`);
+        deps.injectNudge(`Watchdog: no progress for ${secondsSinceLastMeaningful}s. Try a different approach.`);
       }
     },
     sessionCreated() {
@@ -443391,6 +443462,7 @@ import * as z54 from "zod";
 var WatchdogConfigSchema = z54.object({
   enabled: z54.boolean().default(true),
   doomLoopThreshold: z54.number().int().positive().max(20).default(3),
+  softDoomLoopThreshold: z54.number().int().positive().max(20).default(5),
   stuckTimeoutSec: z54.number().int().positive().max(600).default(90),
   auditLogPath: z54.string().optional(),
   recoveryStrategy: z54.enum(["nudge", "fallback", "restart", "notify", "safe"]).default("nudge"),
@@ -444168,22 +444240,22 @@ init_plugin_identity();
 // packages/telemetry-core/src/activity-state.ts
 init_atomic_write();
 init_xdg_data_dir();
-import { existsSync as existsSync118, mkdirSync as mkdirSync26, readFileSync as readFileSync80 } from "fs";
-import { basename as basename26, join as join141 } from "path";
+import { existsSync as existsSync119, mkdirSync as mkdirSync27, readFileSync as readFileSync80 } from "fs";
+import { basename as basename26, join as join143 } from "path";
 var POSTHOG_ACTIVITY_STATE_FILE = "posthog-activity.json";
 function resolveTelemetryStateDir(product, options = {}) {
   const dataDir = resolveXdgDataDir(product.cacheDirName, {
     env: options.env,
     osProvider: options.osProvider
   });
-  const xdgStateDir = options.env?.XDG_DATA_HOME === undefined ? undefined : join141(options.env.XDG_DATA_HOME, product.cacheDirName);
+  const xdgStateDir = options.env?.XDG_DATA_HOME === undefined ? undefined : join143(options.env.XDG_DATA_HOME, product.cacheDirName);
   if (dataDir === xdgStateDir || xdgStateDir === undefined && basename26(dataDir) === product.cacheDirName) {
     return dataDir;
   }
-  return join141(dataDir, product.cacheDirName);
+  return join143(dataDir, product.cacheDirName);
 }
 function getTelemetryActivityStateFilePath(stateDir) {
-  return join141(stateDir, POSTHOG_ACTIVITY_STATE_FILE);
+  return join143(stateDir, POSTHOG_ACTIVITY_STATE_FILE);
 }
 function getDailyActiveCaptureState(input2) {
   const state3 = readPostHogActivityState(input2.stateDir, input2.diagnostics);
@@ -444208,7 +444280,7 @@ function isPostHogActivityState(value) {
 }
 function readPostHogActivityState(stateDir, diagnostics) {
   const stateFilePath = getTelemetryActivityStateFilePath(stateDir);
-  if (!existsSync118(stateFilePath)) {
+  if (!existsSync119(stateFilePath)) {
     return {};
   }
   try {
@@ -444231,7 +444303,7 @@ function readPostHogActivityState(stateDir, diagnostics) {
 function writePostHogActivityState(stateDir, nextState, diagnostics) {
   const stateFilePath = getTelemetryActivityStateFilePath(stateDir);
   try {
-    mkdirSync26(stateDir, { recursive: true });
+    mkdirSync27(stateDir, { recursive: true });
     writeFileAtomically(stateFilePath, `${JSON.stringify(nextState, null, 2)}
 `);
   } catch (error) {

package/dist/oh-my-opencode.schema.json

@@ -7091,6 +7091,12 @@
           "exclusiveMinimum": 0,
           "maximum": 20
         },
+        "softDoomLoopThreshold": {
+          "default": 5,
+          "type": "integer",
+          "exclusiveMinimum": 0,
+          "maximum": 20
+        },
         "stuckTimeoutSec": {
           "default": 90,
           "type": "integer",
@@ -7177,6 +7183,7 @@
       "required": [
         "enabled",
         "doomLoopThreshold",
+        "softDoomLoopThreshold",
         "stuckTimeoutSec",
         "recoveryStrategy",
         "heartbeatIntervalSec",

package/dist/plugin/agent-anti-loop.d.ts

@@ -1,20 +1,17 @@
 import type { WatchdogConfig } from "../config/schema/watchdog";
 export interface AgentAntiLoopDeps {
-    /** Injected logger. */
     log: (msg: string, meta?: Record<string, unknown>) => void;
-    /** Injected function to inject a nudge message into the current session. */
     injectNudge?: (text: string) => Promise<void>;
+    projectDir?: string;
 }
 export interface AgentAntiLoopWiring {
-    /** Handler for `tool.execute.after` — tracks tool signatures. */
     toolExecuteAfter: (input: {
         tool: string;
         args: unknown;
         output: unknown;
     }) => void;
-    /** Handler for `session.idle` — checks stuck timer and escalates. */
     sessionIdle: () => Promise<void>;
-    /** Reset on session start. */
     sessionCreated: () => void;
+    onAgentMessage: (content: string) => void;
 }
 export declare function createAgentAntiLoopWiring(config: WatchdogConfig, deps: AgentAntiLoopDeps): AgentAntiLoopWiring;

package/dist/tui.js

@@ -64557,6 +64557,7 @@ var init_watchdog = __esm(() => {
   WatchdogConfigSchema = object({
     enabled: boolean2().default(true),
     doomLoopThreshold: number2().int().positive().max(20).default(3),
+    softDoomLoopThreshold: number2().int().positive().max(20).default(5),
     stuckTimeoutSec: number2().int().positive().max(600).default(90),
     auditLogPath: string2().optional(),
     recoveryStrategy: _enum2(["nudge", "fallback", "restart", "notify", "safe"]).default("nudge"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kl-c/matrixos",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "MaTrixOS — Agentic OS for OpenCode. Personalizable, communicating, self-improving, resilient.",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",