@qilin-agent/repeat-tool-reminder 0.0.0-stage → 3.1.3

package/lib/types/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Advisory per-agent repeat-call detector. It enriches post-execute decisions
+ * with logged model context without vetoing or rewriting calls. Configuration
+ * and chain semantics live in the package README; rationale lives in the
+ * repeat-tool-reminder Agent Note.
+ * @module @qilin-agent/repeat-tool-reminder
+ */
+import type { Context } from '@qilin-agent/kylin';
+import z from '@qilin-agent/schemastery';
+import type { ContextFormed } from '@qilin-agent/llm';
+declare module '@qilin-agent/llm' {
+    interface MessageSourceMap {
+        'repeat-tool-reminder': {
+            kind: 'repeat-tool-reminder';
+        } & ContextFormed;
+    }
+}
+export declare const name = "repeat-tool-reminder";
+/**
+ * Plugin config, validated by the same-named schemastery schema plus the
+ * load-time checks in `apply` (misconfiguration fails loud: an empty
+ * `thresholds` list, a non-integer, a value below 2, or a duplicate throws at
+ * plugin load, never a silent fall-back). `include`/`exclude` entries are
+ * `*`-wildcard predicates over tool names at call time, not references to
+ * registry entries — a pattern matching no currently registered tool is valid
+ * (`exclude: [mcp_*]` must stay legal in a deployment that loads no MCP tools).
+ */
+export interface Config {
+    /** Consecutive-repeat counts that trigger a reminder (default `[3, 5, 8]`). */
+    thresholds?: number[];
+    /** Tool-name patterns to track; empty means every tool is tracked. */
+    include?: string[];
+    /** Tool-name patterns transparent to the chain (neither count nor reset). */
+    exclude?: string[];
+    /**
+     * Maximum characters of canonical arguments quoted in the DETAILED reminder
+     * (default 500). Large payloads (a `write` body, a long command) would
+     * otherwise ride into the next request unbounded — precisely in a loop
+     * scenario; the cap bounds the reminder, never the detection (the chain key
+     * always compares the FULL canonical string).
+     */
+    argumentsPreviewChars?: number;
+}
+export declare const Config: z<Config>;
+/**
+ * Install the guard's listeners.
+ * @param ctx - plugin context; listeners are scoped to it and disposed with it.
+ * @param config - validated {@link Config}; `thresholds` is re-checked fail-loud here.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@qilin-agent/repeat-tool-reminder",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Repeat-tool-call guard plugin: advisory reminders when an agent loops on identical tool calls",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/guard/repeat-tool-reminder"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@qilin-agent/schemastery": "~3.18.3"
+  },
+  "peerDependencies": {
+    "@qilin-agent/tools": "3.1.3",
+    "@qilin-agent/agent": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3"
+  },
+  "devDependencies": {
+    "@qilin-agent/agent": "3.1.3",
+    "@qilin-agent/agent-loop-testkit": "3.1.3",
+    "@qilin-agent/llm": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/agent-loop": "3.1.3",
+    "@qilin-agent/tools": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/session-projection": "3.1.3"
+  }
 }