@qilin-agent/tmux-context 0.0.0-stage → 3.1.3

package/lib/types/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Opt-in request-preparation tmux-location context. Eligible step attempts
+ * append durable, source-attributed context naming the tmux session, window,
+ * and pane this agent process runs in, plus the window's pane-tree layout.
+ *
+ * The plugin pulls state once per turn, for the first request (`step === 1`), by
+ * running one `tmux display-message` through the `ctx.shell` executor service. It
+ * confirms this process genuinely runs inside the pane `$TMUX_PANE` names by
+ * matching the pane's `#{pane_tty}` against this process's controlling terminal,
+ * so a terminal that merely inherited `$TMUX`/`$TMUX_PANE` from a tmux ancestor
+ * (e.g. a VS Code integrated terminal) reads as "not in tmux". It re-injects
+ * only when the rendered tmux state changes since the last injection (a moved,
+ * renamed, or re-laid-out pane), with an optional `refreshIntervalMs` floor
+ * between injections. Absent tmux environment, an inherited-only environment,
+ * absent `ctx.shell`, or a failed query is a no-op, never an error: an executor
+ * rejection is contained and logged as a warning so the turn continues.
+ *
+ * @module @qilin-agent/tmux-context
+ */
+import type { Context } from '@qilin-agent/kylin';
+import z from '@qilin-agent/schemastery';
+import { z as zod } from 'zod';
+import type { ContextFormed } from '@qilin-agent/llm';
+declare module '@qilin-agent/llm' {
+    interface MessageSourceMap {
+        /** Location attribution; readers preserve the content without this producer.
+         * Its projection uses the kind to avoid repeated injection.
+         * @persistenceAttribution
+         */
+        'tmux-context': {
+            kind: 'tmux-context';
+        } & ContextFormed;
+    }
+}
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "tmux-context";
+/** The agent registry that owns pre-step processing. */
+export declare const inject: string[];
+/** Per-turn tmux-location scheduling. Invalid values fail plugin load. */
+export interface Config {
+    /** Minimum milliseconds between durable injections in one session. Omit or set to 0 to inject on every eligible change. */
+    refreshIntervalMs?: number;
+}
+/** Schemastery validation for {@link Config}. */
+export declare const Config: z<Config>;
+declare const tmuxContextStateSchema: zod.ZodNullable<zod.ZodObject<{
+    state: zod.ZodString;
+    time: zod.ZodNumber;
+}, zod.core.$strip>>;
+type TmuxContextState = zod.infer<typeof tmuxContextStateSchema>;
+/**
+ * Register a prepended pre-step listener for the lifetime of `ctx`.
+ * @param ctx - plugin context; the listener is disposed with it.
+ * @param config - durable refresh scheduling configuration.
+ * @throws when the refresh interval is invalid.
+ */
+declare module '@qilin-agent/session-projection/types' {
+    interface SessionProjectionStateMap {
+        /** The stable state block of this plugin's latest durable injection, or null. */
+        tmuxContext: TmuxContextState;
+    }
+}
+export declare function apply(ctx: Context, config: Config): void;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "@qilin-agent/tmux-context",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "description": "Opt-in durable per-step context with this agent's tmux pane and window location",
+  "version": "3.1.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kkutysllb/QiLin.git",
+    "directory": "packages/context/tmux-context"
+  },
+  "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": {
+    "zod": "^4.4.3",
+    "@qilin-agent/schemastery": "~3.18.3"
+  },
+  "peerDependencies": {
+    "@qilin-agent/agent": "3.1.3",
+    "@qilin-agent/shell": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/session-projection": "3.1.3"
+  },
+  "devDependencies": {
+    "@qilin-agent/agent": "3.1.3",
+    "@qilin-agent/agent-loop-testkit": "3.1.3",
+    "@qilin-agent/shell": "3.1.3",
+    "@qilin-agent/llm": "3.1.3",
+    "@qilin-agent/session": "3.1.3",
+    "@qilin-agent/system-prompt": "3.1.3",
+    "@qilin-agent/kylin": "~4.0.3",
+    "@qilin-agent/session-projection": "3.1.3"
+  }
 }