@dv.nghiem/flowdeck 0.4.2 → 0.4.3

package/dist/services/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/services/prompt-cache.ts"],"names":[],"mappings":"AAmBA,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAQ3B,CAAA;AAMF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AA+BD,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GACnB,MAAM,CASR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,aAAa,UAAQ,GACpB,MAAM,GAAG,IAAI,CAaf;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,aAAa,UAAQ,EACrB,MAAM,SAAiB,GACtB,IAAI,CAsBN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAsC9C;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA6BrD;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAQjD"}

package/dist/services/prompt-cache.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-cache.test.d.ts.map

package/dist/services/prompt-cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.test.d.ts","sourceRoot":"","sources":["../../src/services/prompt-cache.test.ts"],"names":[],"mappings":""}

package/dist/services/rtk-manager.d.ts

@@ -0,0 +1,80 @@
+/**
+ * rtk-manager — runtime integration for https://github.com/rtk-ai/rtk
+ *
+ * rtk is a CLI proxy that compresses noisy terminal output (git, npm, test
+ * runners, linters, docker, etc.) by 60-90% before it reaches the model
+ * context. It works by prefixing supported commands: `rtk git status`.
+ *
+ * This manager provides:
+ * - Detection of an installed rtk binary
+ * - Optional agent-triggered initialization (rtk init -g)
+ * - Status reporting for diagnostics
+ * - wrapCommandArgs() for explicit wrapping in FlowDeck's own spawnSync calls
+ *
+ * DESIGN NOTES:
+ * - No auto-install: downloading + executing a remote shell script is a
+ *   supply-chain risk. Users install rtk manually; this plugin detects it.
+ * - No startup mutation: init is agent-triggered via rtk-setup tool only.
+ * - Live detection: no state cache that goes stale across machines/reinstalls.
+ * - Bash hook caveat: `rtk init -g` writes to Claude Code / Copilot global
+ *   config. Whether that hook fires in OpenCode's non-interactive bash sessions
+ *   depends on the runtime. Explicit wrapping via wrapCommandArgs() is the
+ *   reliable alternative.
+ */
+export interface RtkDetection {
+    installed: boolean;
+    binPath?: string;
+    version?: string;
+    error?: string;
+}
+export interface RtkInitResult {
+    success: boolean;
+    log: string;
+    telemetryDisabled: boolean;
+    error?: string;
+}
+export interface RtkStatus {
+    installed: boolean;
+    binPath?: string;
+    version?: string;
+    initAttempted: boolean;
+    initSuccess: boolean;
+    telemetryDisabled: boolean;
+    installInstructions?: string;
+}
+/**
+ * Locate and verify the rtk binary. Checks PATH first, then known install
+ * locations. Returns the first working binary found.
+ */
+export declare function detectRtk(): RtkDetection;
+/**
+ * Run `rtk init -g` to install the bash hook for Claude Code / Copilot,
+ * then immediately run `rtk telemetry disable` to explicitly opt out.
+ *
+ * Telemetry is disabled by default per rtk docs, but we make it explicit
+ * and persistent so consent is never accidentally given in future versions.
+ * The `RTK_TELEMETRY_DISABLED=1` env var injected by shell-env-hook provides
+ * an additional belt-and-suspenders block at the session level.
+ *
+ * Note on bash hook: `rtk init -g` writes to Claude Code / Copilot global
+ * config. Whether that hook fires in OpenCode's non-interactive bash sessions
+ * depends on the runtime configuration. Use `$RTK_BIN <cmd>` explicitly as
+ * a reliable alternative when RTK_INSTALLED=true in the environment.
+ */
+export declare function initRtk(binPath: string): RtkInitResult;
+/**
+ * Return current rtk status. Always performs a live detection check.
+ */
+export declare function getRtkStatus(opts?: {
+    runInit?: boolean;
+}): RtkStatus;
+/**
+ * Wrap a command with rtk if the binary is available and policy allows it.
+ * Returns `[cmd, ...args]` unchanged when rtk is unavailable or policy says no.
+ *
+ * Usage:
+ *   const [c, ...a] = wrapCommandArgs("git", ["status"], "/home/user/.local/bin/rtk")
+ *   spawnSync(c, a, { ... })
+ */
+export declare function wrapCommandArgs(cmd: string, args: string[], binPath: string | undefined): [string, ...string[]];
+//# sourceMappingURL=rtk-manager.d.ts.map

package/dist/services/rtk-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-manager.d.ts","sourceRoot":"","sources":["../../src/services/rtk-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAQH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,iBAAiB,EAAE,OAAO,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAC7B;AAYD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAsBxC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAsCtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CA+BpE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAI/G"}

package/dist/services/rtk-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rtk-manager.test.d.ts.map

package/dist/services/rtk-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-manager.test.d.ts","sourceRoot":"","sources":["../../src/services/rtk-manager.test.ts"],"names":[],"mappings":""}

package/dist/services/rtk-policy.d.ts

@@ -0,0 +1,26 @@
+/**
+ * rtk-policy — command wrapping policy for rtk integration.
+ *
+ * Determines which commands benefit from rtk output compression and which
+ * should be passed through unchanged. The policy is intentionally conservative:
+ * when in doubt, don't wrap.
+ *
+ * Wrapping benefits:
+ * - Commands with large, repetitive, or progress-heavy output
+ * - Commands where compressed output preserves the signal
+ *
+ * Do NOT wrap:
+ * - Commands where raw output is required for correctness
+ * - Commands with already-compact output (git rev-parse, git diff --name-only)
+ * - Commands used for installing rtk itself (curl, sh)
+ * - Structured/programmatic output (codegraph, jq, etc.)
+ * - OS notification tools (notify-send, osascript, powershell)
+ */
+/**
+ * Determine whether a command should be wrapped with rtk.
+ * Returns true only when compression is expected to improve signal quality.
+ */
+export declare function shouldWrapWithRtk(cmd: string, args: string[]): boolean;
+/** Returns the full list of supported commands for diagnostics/documentation. */
+export declare function getSupportedCommands(): string[];
+//# sourceMappingURL=rtk-policy.d.ts.map

package/dist/services/rtk-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-policy.d.ts","sourceRoot":"","sources":["../../src/services/rtk-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4DH;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAatE;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}

package/dist/services/rtk-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rtk-policy.test.d.ts.map

package/dist/services/rtk-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-policy.test.d.ts","sourceRoot":"","sources":["../../src/services/rtk-policy.test.ts"],"names":[],"mappings":""}

package/dist/services/rule-engine.d.ts

@@ -0,0 +1,29 @@
+export type CheckType = "file_exists" | "json_valid" | "detect_language" | "classify_command" | "is_nonempty" | "contains_keyword";
+export interface CheckResult<T> {
+    type: CheckType;
+    value: T;
+    /** Always true — signals this result came from deterministic code, not a model. */
+    deterministic: true;
+}
+/** Check whether a file path exists on disk. */
+export declare function checkFileExists(filePath: string): CheckResult<boolean>;
+export interface JSONValidResult {
+    valid: boolean;
+    error?: string;
+}
+/** Check whether a string is valid JSON. */
+export declare function checkJSONValid(text: string): CheckResult<JSONValidResult>;
+/** Detect programming language from file extension. Returns null for unknown extensions. */
+export declare function detectLanguage(filename: string): CheckResult<string | null>;
+export type CommandClass = "read" | "write" | "delete" | "run" | "navigate" | "unknown";
+/** Classify a tool/command name into its operational class. */
+export declare function classifyCommandType(command: string): CheckResult<CommandClass>;
+/** Check whether a string is non-empty after trimming. */
+export declare function checkIsNonEmpty(text: string): CheckResult<boolean>;
+export interface KeywordSearchResult {
+    found: boolean;
+    matched?: string;
+}
+/** Check whether a string contains any of the given keywords (case-insensitive). */
+export declare function checkContainsKeyword(text: string, keywords: string[]): CheckResult<KeywordSearchResult>;
+//# sourceMappingURL=rule-engine.d.ts.map

package/dist/services/rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.d.ts","sourceRoot":"","sources":["../../src/services/rule-engine.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,YAAY,GACZ,iBAAiB,GACjB,kBAAkB,GAClB,aAAa,GACb,kBAAkB,CAAA;AAEtB,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,CAAC,CAAA;IACR,mFAAmF;IACnF,aAAa,EAAE,IAAI,CAAA;CACpB;AAID,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAEtE;AAID,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,eAAe,CAAC,CAWzE;AA4BD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAG3E;AAID,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,OAAO,GACP,QAAQ,GACR,KAAK,GACL,UAAU,GACV,SAAS,CAAA;AAUb,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,CAQ9E;AAID,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAElE;AAID,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAAE,GACjB,WAAW,CAAC,mBAAmB,CAAC,CAQlC"}

package/dist/services/rule-engine.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule-engine.test.d.ts.map

package/dist/services/rule-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine.test.d.ts","sourceRoot":"","sources":["../../src/services/rule-engine.test.ts"],"names":[],"mappings":""}

package/dist/services/task-batcher.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Task Batcher
+ *
+ * Coalesces multiple homogeneous cheap tasks into a single agent call.
+ * Reduces N session creations + system-prompt injections to 1 for
+ * classification/validation batches.
+ *
+ * SAFETY CONSTRAINTS:
+ * - Max 5 tasks per batch (avoid context contamination in large batches)
+ * - Each task must have a unique, non-empty id
+ * - Partial salvage: successfully parsed results are returned even if
+ *   others fail — caller decides how to handle failures
+ * - The batcher builds prompts and parses responses; session creation
+ *   is the caller's responsibility (use with `delegate`)
+ */
+export declare const TASK_BATCHER_MAX_SIZE = 5;
+export interface BatchTask {
+    id: string;
+    prompt: string;
+}
+export interface BatchResult {
+    id: string;
+    result: string;
+    success: boolean;
+    error?: string;
+}
+export interface BatchResponse {
+    results: BatchResult[];
+    success_count: number;
+    failure_count: number;
+}
+/**
+ * Build a single batched prompt from multiple tasks.
+ * The expected response is a JSON array with `id` and `result` fields.
+ */
+export declare function buildBatchPrompt(tasks: BatchTask[]): string;
+/**
+ * Parse a batched model response into per-task results.
+ * Returns partial results: tasks whose ids appear in the response are
+ * marked success, missing tasks are marked failure.
+ */
+export declare function parseBatchResponse(tasks: BatchTask[], rawResponse: string): BatchResponse;
+/**
+ * Validate that a batch is safe to send.
+ * Returns null if valid, or an error message if not.
+ */
+export declare function validateBatch(tasks: BatchTask[]): string | null;
+//# sourceMappingURL=task-batcher.d.ts.map

package/dist/services/task-batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-batcher.d.ts","sourceRoot":"","sources":["../../src/services/task-batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAiB3D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CA0DzF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAY/D"}

package/dist/services/task-batcher.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-batcher.test.d.ts.map

package/dist/services/task-batcher.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-batcher.test.d.ts","sourceRoot":"","sources":["../../src/services/task-batcher.test.ts"],"names":[],"mappings":""}

package/dist/services/telemetry.d.ts

@@ -15,6 +15,12 @@ export interface TelemetryEvent {
     files?: string[];
     cost_estimate?: number;
     error_category?: string;
+    /** Estimated input tokens (chars / 4) for this event. */
+    input_tokens?: number;
+    /** Estimated output tokens (chars / 4) for this event. */
+    output_tokens?: number;
+    /** Raw input character count before prompt was sent to the model. */
+    context_size_chars?: number;
     meta?: Record<string, unknown>;
 }
 export declare function telemetryPath(dir: string): string;

package/dist/services/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,cAAc,GAEd,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GAErB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAa1G;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,SAAM,GAAG,cAAc,EAAE,CAuBxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAI/E"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../src/services/telemetry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,aAAa,GACb,WAAW,GACX,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,cAAc,GACd,UAAU,GACV,kBAAkB,GAClB,cAAc,GAEd,oBAAoB,GACpB,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GAErB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,kBAAkB,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAA;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI,CAa1G;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CAE1E;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,SAAM,GAAG,cAAc,EAAE,CAuBxE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,cAAc,EAAE,CAI/E"}

package/dist/services/token-budget.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Token Budget Service
+ *
+ * Provides INPUT size budgets and soft response directives by workflow stage
+ * and task complexity. These are GUIDANCE values, not hard limits
+ * (OpenCode SDK does not expose a max_tokens parameter on session.prompt).
+ *
+ * Hard controls apply to INPUT: context_chars_limit and prompt_chars_limit
+ * cap carry-forward and total prompt size before sending.
+ *
+ * Soft controls: response_directive is a hint string appended to the prompt.
+ * It asks the model to be concise — not enforced at the API level.
+ */
+import type { WorkflowStage } from "./token-metrics";
+import type { TaskComplexity } from "./model-router";
+export interface TokenBudget {
+    /** Hard cap on context/carry-forward chars (apply before sending). */
+    context_chars_limit: number;
+    /** Hard cap on total prompt chars including system instructions. */
+    prompt_chars_limit: number;
+    /**
+     * Soft directive to append to the prompt.
+     * Empty string = no constraint injected.
+     * This is guidance only — not API-enforced.
+     */
+    response_directive: string;
+}
+/**
+ * Get the token budget for a given workflow stage and task complexity.
+ * Cheap tasks receive ~40% of the base budget; expensive tasks receive ~150%.
+ */
+export declare function getTokenBudget(stage: WorkflowStage, complexity: TaskComplexity): TokenBudget;
+/**
+ * Truncate a carry-forward context to fit within budget.
+ * Preserves the most recent content (tail) when truncating.
+ * Attempts to trim to a line boundary to avoid mid-line cuts.
+ */
+export declare function applyContextBudget(context: string, budget: TokenBudget): string;
+/**
+ * Append the response directive to a prompt, if one is set for this budget.
+ * Returns the prompt unchanged when no directive applies.
+ */
+export declare function applyResponseDirective(prompt: string, budget: TokenBudget): string;
+//# sourceMappingURL=token-budget.d.ts.map

package/dist/services/token-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.d.ts","sourceRoot":"","sources":["../../src/services/token-budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAyBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,GAAG,WAAW,CAY5F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAK/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAGlF"}

package/dist/services/token-budget.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-budget.test.d.ts.map

package/dist/services/token-budget.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-budget.test.d.ts","sourceRoot":"","sources":["../../src/services/token-budget.test.ts"],"names":[],"mappings":""}

package/dist/services/token-metrics-ext.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-metrics-ext.test.d.ts.map

package/dist/services/token-metrics-ext.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics-ext.test.d.ts","sourceRoot":"","sources":["../../src/services/token-metrics-ext.test.ts"],"names":[],"mappings":""}

package/dist/services/token-metrics.d.ts

@@ -0,0 +1,97 @@
+export type WorkflowStage = "discuss" | "plan" | "execute" | "verify" | "design" | "fix-bug" | "write-docs" | "council" | "delegate" | "pipeline" | "exploration" | "unknown";
+export type MetricEventType = "model_call" | "cache_hit" | "duplicate_suppressed" | "rule_bypass" | "retry";
+export interface MetricEvent {
+    ts: string;
+    workflow_id: string;
+    stage: WorkflowStage;
+    event: MetricEventType;
+    agent?: string;
+    /**
+     * Model identifier used for this call (e.g. "claude-sonnet-4.6").
+     * Enables cost estimation via cost-estimator.ts.
+     */
+    model?: string;
+    /** Estimated input tokens (chars / 4) */
+    est_input_tokens: number;
+    /** Estimated output tokens (chars / 4) */
+    est_output_tokens: number;
+    /** Raw input character count */
+    input_chars: number;
+    /** Raw output character count */
+    output_chars: number;
+    duration_ms?: number;
+    /** Estimated USD cost for this event (populated when model is known). */
+    est_cost_usd?: number;
+}
+export interface StageSummary {
+    stage: WorkflowStage;
+    model_calls: number;
+    cache_hits: number;
+    duplicates_suppressed: number;
+    rule_bypasses: number;
+    retries: number;
+    total_est_input_tokens: number;
+    total_est_output_tokens: number;
+    avg_input_chars: number;
+    avg_output_chars: number;
+    /** Estimated USD cost for this stage (requires model field on events). */
+    est_cost_usd: number;
+}
+export interface MetricsReport {
+    workflow_id: string;
+    by_stage: StageSummary[];
+    totals: {
+        model_calls: number;
+        cache_hits: number;
+        duplicates_suppressed: number;
+        rule_bypasses: number;
+        retries: number;
+        est_input_tokens: number;
+        est_output_tokens: number;
+        /** Estimated total USD cost across all model calls. 0 if no model info available. */
+        est_cost_usd: number;
+        /** Estimated USD wasted on retries. */
+        retry_cost_usd: number;
+        cache_hit_rate: number;
+        duplicate_suppression_rate: number;
+        rule_bypass_rate: number;
+        retry_rate: number;
+    };
+    efficiency: {
+        most_expensive_stage: string;
+        cache_effectiveness: "good" | "moderate" | "low";
+        avg_context_chars_by_stage: Record<string, number>;
+    };
+    /** Workflow-level timing if startWorkflowTimer was called. */
+    elapsed_ms?: number;
+}
+/** Rough token estimate: ~4 chars per token. */
+export declare function estimateTokens(text: string): number;
+export declare function recordModelCall(dir: string, workflow_id: string, stage: WorkflowStage, inputText: string, outputText: string, agent?: string, duration_ms?: number, model?: string, est_cost_usd?: number): void;
+export declare function recordCacheHit(dir: string, workflow_id: string, stage: WorkflowStage, inputText: string, agent?: string, model?: string): void;
+export declare function recordDuplicateSuppressed(dir: string, workflow_id: string, stage: WorkflowStage, agent?: string): void;
+/**
+ * Record a retry model call.
+ * This is a model call that happened because the previous attempt failed transiently.
+ * Contributes to retry_cost_usd in the cost report.
+ */
+export declare function recordRetryCall(dir: string, workflow_id: string, stage: WorkflowStage, inputText: string, outputText: string, agent?: string, duration_ms?: number, model?: string, est_cost_usd?: number): void;
+/**
+ * Record a rule-based bypass — a check answered deterministically without a model call.
+ * `check_type` identifies which rule-engine check was used.
+ */
+export declare function recordRuleBypass(dir: string, workflow_id: string, stage: WorkflowStage, check_type: string, agent?: string): void;
+/**
+ * Mark the start of a workflow run for latency tracking.
+ * Call this before the first model call for a workflow.
+ */
+export declare function startWorkflowTimer(workflow_id: string): void;
+/**
+ * Get elapsed milliseconds since startWorkflowTimer was called.
+ * Returns undefined if the timer was not started.
+ */
+export declare function getWorkflowElapsed(workflow_id: string): number | undefined;
+export declare function getMetricsReport(dir: string, workflow_id: string): MetricsReport;
+/** List all workflow IDs that have metric events. */
+export declare function listTrackedWorkflows(dir: string): string[];
+//# sourceMappingURL=token-metrics.d.ts.map

package/dist/services/token-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics.d.ts","sourceRoot":"","sources":["../../src/services/token-metrics.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,SAAS,CAAA;AAEb,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,WAAW,GACX,sBAAsB,GACtB,aAAa,GACb,OAAO,CAAA;AAEX,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,eAAe,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,iBAAiB,EAAE,MAAM,CAAA;IACzB,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;IAClB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB,EAAE,MAAM,CAAA;IAC9B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAA;QACnB,UAAU,EAAE,MAAM,CAAA;QAClB,qBAAqB,EAAE,MAAM,CAAA;QAC7B,aAAa,EAAE,MAAM,CAAA;QACrB,OAAO,EAAE,MAAM,CAAA;QACf,gBAAgB,EAAE,MAAM,CAAA;QACxB,iBAAiB,EAAE,MAAM,CAAA;QACzB,qFAAqF;QACrF,YAAY,EAAE,MAAM,CAAA;QACpB,uCAAuC;QACvC,cAAc,EAAE,MAAM,CAAA;QACtB,cAAc,EAAE,MAAM,CAAA;QACtB,0BAA0B,EAAE,MAAM,CAAA;QAClC,gBAAgB,EAAE,MAAM,CAAA;QACxB,UAAU,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,UAAU,EAAE;QACV,oBAAoB,EAAE,MAAM,CAAA;QAC5B,mBAAmB,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,CAAA;QAChD,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnD,CAAA;IACD,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AA2BD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAiBN;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAaN;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAYN;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAsHhF;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAe1D"}

package/dist/services/token-metrics.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=token-metrics.test.d.ts.map

package/dist/services/token-metrics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metrics.test.d.ts","sourceRoot":"","sources":["../../src/services/token-metrics.test.ts"],"names":[],"mappings":""}

package/dist/tools/council.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"council.d.ts","sourceRoot":"","sources":["../../src/tools/council.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAKtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA2ExE"}
+{"version":3,"file":"council.d.ts","sourceRoot":"","sources":["../../src/tools/council.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAkDtD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAgHxE"}

package/dist/tools/delegate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAWtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA6HzE"}
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/tools/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAmBtD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAmPzE"}

package/dist/tools/load-rules.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Load Rules Tool
+ *
+ * On-demand rule loading for agents. Allows an agent to explicitly request
+ * the full content of rule modules that were not injected at startup (because
+ * they are stage-restricted and the stage was not known at plugin init time).
+ *
+ * Usage pattern:
+ *   1. At startup only always_on + language-matching rules are injected globally.
+ *   2. When an agent begins work (e.g. a coder starting the execute stage),
+ *      it calls this tool to load coding-style, security, and testing rules.
+ *   3. The tool returns full rule content and logs which modules were loaded.
+ *
+ * This keeps the global instruction context minimal while ensuring agents get
+ * the right guidance when they actually need it.
+ */
+import { type ToolDefinition } from "@opencode-ai/plugin";
+/** Reset the loaded-paths cache (for testing). */
+export declare function resetLoadedRulesCache(): void;
+/** Return a copy of currently loaded paths (for testing/diagnostics). */
+export declare function getLoadedRulePaths(): string[];
+export declare const loadRulesTool: ToolDefinition;
+/** Query-only tool: list all available rule modules with their metadata summaries. */
+export declare const listRulesTool: ToolDefinition;
+//# sourceMappingURL=load-rules.d.ts.map

package/dist/tools/load-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-rules.d.ts","sourceRoot":"","sources":["../../src/tools/load-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAgB/D,kDAAkD;AAClD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,eAAO,MAAM,aAAa,EAAE,cAsF1B,CAAA;AAUF,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,cAyB1B,CAAA"}

package/dist/tools/rtk-setup.d.ts

@@ -0,0 +1,22 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+/**
+ * rtk-setup tool — agent-callable tool for rtk lifecycle management.
+ *
+ * Provides:
+ * - Detection: is rtk installed and where?
+ * - Optional init: run `rtk init -g` to install the bash hook
+ * - Status report: for diagnostics in the current workflow
+ * - Supported commands list: which commands benefit from rtk wrapping
+ *
+ * Agents should call this tool when:
+ * - They want to verify rtk is available before running commands
+ * - The workflow involves heavy CLI usage (git, tests, linting, docker)
+ * - After a user has installed rtk and wants to activate it
+ *
+ * Note on bash hook: `rtk init -g` writes to Claude Code / Copilot global
+ * config. In OpenCode's non-interactive bash sessions the hook may not fire
+ * automatically. Use `$RTK_BIN <cmd>` explicitly as a reliable alternative
+ * when RTK_INSTALLED=true in the environment.
+ */
+export declare const rtkSetupTool: ToolDefinition;
+//# sourceMappingURL=rtk-setup.d.ts.map

package/dist/tools/rtk-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtk-setup.d.ts","sourceRoot":"","sources":["../../src/tools/rtk-setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAI/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,EAAE,cA0EzB,CAAA"}

package/dist/tools/run-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-pipeline.d.ts","sourceRoot":"","sources":["../../src/tools/run-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AA4BtD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAuH5E"}
+{"version":3,"file":"run-pipeline.d.ts","sourceRoot":"","sources":["../../src/tools/run-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AA8BtD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAkI5E"}

package/docs/commands/fd-map-codebase.md

@@ -86,6 +86,7 @@ Report includes: codegraph install/index status, files created per mapper, key f
 
 ## Related Commands
 
+- `/fd-new-feature` - Define a new feature, initialize feature context in the current phase directory
 - `/fd-doctor` — check environment health including codegraph status
 - `/fd-discuss` — uses codegraph for code intelligence during discussions
-- `/fd-plan` — uses codegraph for impact analysis during planning
+- `/fd-plan` — uses codegraph for impact analysis during planning

package/docs/configuration/index.md

@@ -138,6 +138,32 @@ Defines per-agent allowed/forbidden tools, required inputs, and success criteria
 }
 ```
 
+### `costBudget` — Per-Workflow Cost Enforcement
+
+Limits estimated USD spend and token consumption per workflow run. When a limit is reached, FlowDeck can warn, stop, or escalate depending on `onExhaustion`.
+
+```json
+{
+  "governance": {
+    "costBudget": {
+      "maxEstimatedCostUSD": 1.0,
+      "maxInputTokens": 500000,
+      "maxOutputTokens": 100000,
+      "onExhaustion": "warn"
+    }
+  }
+}
+```
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `maxEstimatedCostUSD` | number | (none) | Maximum estimated USD cost per workflow run |
+| `maxInputTokens` | number | (none) | Maximum input tokens per workflow run |
+| `maxOutputTokens` | number | (none) | Maximum output tokens per workflow run |
+| `onExhaustion` | `"warn"` \| `"stop"` \| `"escalate"` | `"warn"` | Action taken when a limit is reached |
+
+Budget state is persisted to `.codebase/COST_BUDGETS.json`.
+
 ---
 
 ## `model_profile` — Context Window Balance

package/docs/getting-started/installation.md

@@ -44,6 +44,26 @@ which flowdeck
 
 After installation, FlowDeck registers as an OpenCode plugin. Restart OpenCode to load the plugin and its commands.
 
+## Optional: rtk Output Compression
+
+[rtk](https://github.com/rtk-ai/rtk) is a CLI proxy that compresses noisy terminal output (git, npm, test runners, linters) by 60–90% before it reaches the model context. It is optional but recommended for token savings on command-heavy workflows.
+
+```bash
+# Linux / macOS
+curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh
+```
+
+FlowDeck detects rtk automatically. No configuration needed. Once installed:
+
+- `RTK_INSTALLED=true` and `RTK_BIN=<path>` are injected into every bash session
+- `RTK_TELEMETRY_DISABLED=1` is always set (FlowDeck disables rtk telemetry by default)
+- Agents can use `$RTK_BIN git status`, `$RTK_BIN npm test`, etc. for compressed output
+- Call `rtk-setup` (action: `"init"`) once to install the bash auto-rewrite hook
+
+See [rtk Integration reference](../reference/rtk.md) for full setup, supported commands, and telemetry details.
+
+---
+
 ## Environment Variables
 
 FlowDeck respects the following environment variables:

package/docs/reference/hooks.md

@@ -98,10 +98,25 @@ Injects the following environment variables into every bash tool execution:
 | `DETECTED_LANGUAGES` | Marker files scan | Comma-separated list (e.g., `typescript,python`) |
 | `PRIMARY_LANGUAGE` | Marker files scan | First detected language |
 | `FLOWDECK_PHASE` | `STATE.md` phase field | Current FlowDeck planning phase |
+| `RTK_INSTALLED` | Live `rtk --version` check | `"true"` if the rtk binary is found, `"false"` otherwise |
+| `RTK_BIN` | rtk binary path | Full path to the rtk binary (only set when `RTK_INSTALLED=true`) |
+| `RTK_TELEMETRY_DISABLED` | Set when rtk is installed | Always `"1"` when rtk is detected — blocks rtk telemetry regardless of consent state |
 
 Language detection uses marker files: `tsconfig.json` (TypeScript), `go.mod` (Go), `pyproject.toml`/`requirements.txt` (Python), `Cargo.toml` (Rust), `build.gradle`/`pom.xml` (Java).
 
-**State read:** `package.json`, lockfiles, marker files, `.planning/STATE.md`
+**rtk detection:** The binary is checked once at hook creation time (startup cost only) and cached for the session lifetime. Checks `PATH` first, then `~/.local/bin/rtk` and `/usr/local/bin/rtk`.
+
+**Using rtk in bash commands:** When `RTK_INSTALLED=true`, agents can compress noisy CLI output by prefixing commands with `$RTK_BIN`:
+
+```bash
+$RTK_BIN git status      # compressed git status output
+$RTK_BIN npm test        # compressed test runner output
+$RTK_BIN tsc --noEmit    # compressed TypeScript compiler output
+```
+
+See [rtk Integration](rtk.md) for the full list of supported commands and setup instructions.
+
+**State read:** `package.json`, lockfiles, marker files, `.planning/STATE.md`, `rtk` binary (PATH check)
 
 ---