@frenchtoastman/oh-my-groundcontrol 0.0.21 → 0.0.23

package/README.md

@@ -50,6 +50,30 @@ Verify agent connectivity by running `ping all agents` within the OpenCode termi
 
 > **Note on Model Customization:** The active model matrix is fully configurable. Edit `~/.config/opencode/oh-my-groundcontrol.json` (or `.jsonc`) to override agent-to-model assignments manually.
 
+### Langfuse Observability (Optional)
+
+Langfuse tracing is available as an optional, toggleable feature for observability and debugging. When enabled, it injects metadata into LLM requests including:
+
+- **Agent tags** (e.g., `agent:explorer`, `task:research`)
+- **Session ID** for request correlation
+- **Trace user ID** (configurable, defaults to `opencode`)
+- **Model and provider information**
+- **Plugin version** for tracking
+
+To enable Langfuse tracing, add the following to your configuration:
+
+```json
+{
+  "langfuse_tracing": {
+    "enabled": true,
+    "traceUserId": "opencode",
+    "customMetadata": {}
+  }
+}
+```
+
+The feature is **disabled by default** and must be explicitly enabled in `~/.config/opencode/oh-my-groundcontrol.json`.
+
 ### For AI Agents / LLMs
 
 To instruct an external coding agent to utilize this suite, paste this block into the agent's prompt:

package/dist/cli/config-io.d.ts

@@ -16,7 +16,7 @@ export declare function parseConfig(path: string): {
  */
 export declare function writeConfig(configPath: string, config: OpenCodeConfig): void;
 export declare function addPluginToOpenCodeConfig(): Promise<ConfigMergeResult>;
-export declare function writeLiteConfig(installConfig: InstallConfig): ConfigMergeResult;
+export declare function writeGroundConfig(installConfig: InstallConfig): ConfigMergeResult;
 export declare function disableDefaultAgents(): ConfigMergeResult;
 export declare function canModifyOpenCodeConfig(): boolean;
 export declare function addAntigravityPlugin(): ConfigMergeResult;

package/dist/cli/index.js

@@ -102,7 +102,7 @@ function getConfigJson() {
 function getConfigJsonc() {
   return join(getConfigDir(), "opencode.jsonc");
 }
-function getLiteConfig() {
+function getGroundConfig() {
   return join(getConfigDir(), "oh-my-groundcontrol.json");
 }
 function getExistingConfigPath() {
@@ -14085,7 +14085,7 @@ function generateAntigravityMixedPreset(config2, existingPreset) {
   }
   return result;
 }
-function generateLiteConfig(installConfig) {
+function generateGroundConfig(installConfig) {
   const config2 = {
     preset: "zen-free",
     presets: {},
@@ -14125,6 +14125,13 @@ function generateLiteConfig(installConfig) {
         main_pane_size: 60
       };
     }
+    if (installConfig.enableLangfuseTracing) {
+      config2.langfuse_tracing = {
+        enabled: true,
+        traceUserId: "opencode",
+        customMetadata: {}
+      };
+    }
     return config2;
   }
   let activePreset = "zen-free";
@@ -14182,6 +14189,13 @@ function generateLiteConfig(installConfig) {
         main_pane_size: 60
       };
     }
+    if (installConfig.enableLangfuseTracing) {
+      config2.langfuse_tracing = {
+        enabled: true,
+        traceUserId: "opencode",
+        customMetadata: {}
+      };
+    }
     return config2;
   }
   const applyOpenCodeFreeAssignments = (presetAgents, hasExternalProviders) => {
@@ -14306,6 +14320,13 @@ function generateLiteConfig(installConfig) {
       main_pane_size: 60
     };
   }
+  if (installConfig.enableLangfuseTracing) {
+    config2.langfuse_tracing = {
+      enabled: true,
+      traceUserId: "opencode",
+      customMetadata: {}
+    };
+  }
   return config2;
 }
 
@@ -14391,11 +14412,11 @@ async function addPluginToOpenCodeConfig() {
     };
   }
 }
-function writeLiteConfig(installConfig) {
-  const configPath = getLiteConfig();
+function writeGroundConfig(installConfig) {
+  const configPath = getGroundConfig();
   try {
     ensureConfigDir();
-    const config2 = generateLiteConfig(installConfig);
+    const config2 = generateGroundConfig(installConfig);
     const tmpPath = `${configPath}.tmp`;
     const bakPath = `${configPath}.bak`;
     const content = `${JSON.stringify(config2, null, 2)}
@@ -14410,7 +14431,7 @@ function writeLiteConfig(installConfig) {
     return {
       success: false,
       configPath,
-      error: `Failed to write lite config: ${err}`
+      error: `Failed to write ground config: ${err}`
     };
   }
 }
@@ -14607,9 +14628,9 @@ function detectCurrentConfig() {
   result.hasChutes = !!providers?.chutes;
   if (providers?.google)
     result.hasAntigravity = true;
-  const { config: liteConfig } = parseConfig(getLiteConfig());
-  if (liteConfig && typeof liteConfig === "object") {
-    const configObj = liteConfig;
+  const { config: groundConfig } = parseConfig(getGroundConfig());
+  if (groundConfig && typeof groundConfig === "object") {
+    const configObj = groundConfig;
     const presetName = configObj.preset;
     const presets = configObj.presets;
     const agents = presets?.[presetName];
@@ -16235,8 +16256,8 @@ function handleStepResult(result, successMsg) {
   return true;
 }
 function formatConfigSummary(config2) {
-  const liteConfig = generateLiteConfig(config2);
-  const preset = liteConfig.preset || "unknown";
+  const groundConfig = generateGroundConfig(config2);
+  const preset = groundConfig.preset || "unknown";
   const lines = [];
   lines.push(`${BOLD}Configuration Summary${RESET}`);
   lines.push("");
@@ -16263,13 +16284,14 @@ function formatConfigSummary(config2) {
     lines.push(`  ${SYMBOLS.check} Chutes Support: ${BLUE}${config2.selectedChutesSecondaryModel}${RESET}`);
   }
   lines.push(`  ${config2.hasTmux ? SYMBOLS.check : `${DIM}\u25CB${RESET}`} Tmux Integration`);
+  lines.push(`  ${config2.enableLangfuseTracing ? SYMBOLS.check : `${DIM}\u25CB${RESET}`} Langfuse Tracing`);
   return lines.join(`
 `);
 }
 function printAgentModels(config2) {
-  const liteConfig = generateLiteConfig(config2);
-  const presetName = liteConfig.preset || "unknown";
-  const presets = liteConfig.presets;
+  const groundConfig = generateGroundConfig(config2);
+  const presetName = groundConfig.preset || "unknown";
+  const presets = groundConfig.presets;
   const agents = presets?.[presetName];
   if (!agents || Object.keys(agents).length === 0)
     return;
@@ -16299,6 +16321,7 @@ function argsToConfig(args) {
     openRouterApiKey: args.openrouterKey,
     balanceProviderUsage: args.balancedSpend === "yes",
     hasTmux: args.tmux === "yes",
+    enableLangfuseTracing: args.langfuse === "yes",
     installSkills: args.skills === "yes",
     installCustomSkills: args.skills === "yes",
     setupMode: "quick",
@@ -16557,6 +16580,8 @@ async function runManualSetupMode(rl, detected, modelsOnly = false) {
   }
   const balancedSpend = await askYesNo(rl, "Do you have subscriptions or pay per API? If yes, we will distribute assignments evenly across selected providers so your subscriptions last longer.", "no");
   console.log();
+  const enableLangfuse = await askYesNo(rl, "Enable Langfuse tracing for observability and debugging? This sends metadata (agent tags, session ID, model info) to Langfuse.", "no");
+  console.log();
   let skills = "no";
   let customSkills = "no";
   if (!modelsOnly) {
@@ -16597,6 +16622,7 @@ async function runManualSetupMode(rl, detected, modelsOnly = false) {
     openRouterApiKey,
     balanceProviderUsage: balancedSpend === "yes",
     hasTmux: false,
+    enableLangfuseTracing: enableLangfuse === "yes",
     installSkills: skills === "yes",
     installCustomSkills: customSkills === "yes",
     setupMode: "manual",
@@ -16620,7 +16646,7 @@ async function runInteractiveMode(detected, modelsOnly = false) {
       rl.close();
       return config2;
     }
-    const totalQuestions = 11;
+    const totalQuestions = 12;
     const existingAaKey = getEnv("ARTIFICIAL_ANALYSIS_API_KEY");
     const existingOpenRouterKey = getEnv("OPENROUTER_API_KEY");
     console.log(`${BOLD}Question 1/${totalQuestions}:${RESET}`);
@@ -16711,6 +16737,9 @@ async function runInteractiveMode(detected, modelsOnly = false) {
     console.log(`${BOLD}Question 11/${totalQuestions}:${RESET}`);
     const balancedSpend = await askYesNo(rl, "Do you have subscriptions or pay per API? If yes, we will distribute assignments evenly across selected providers so your subscriptions last longer.", "no");
     console.log();
+    console.log(`${BOLD}Question 12/${totalQuestions}:${RESET}`);
+    const enableLangfuse = await askYesNo(rl, "Enable Langfuse tracing for observability and debugging? This sends metadata (agent tags, session ID, model info) to Langfuse.", "no");
+    console.log();
     let skills = "no";
     let customSkills = "no";
     if (!modelsOnly) {
@@ -16755,6 +16784,7 @@ async function runInteractiveMode(detected, modelsOnly = false) {
       openRouterApiKey,
       balanceProviderUsage: balancedSpend === "yes",
       hasTmux: false,
+      enableLangfuseTracing: enableLangfuse === "yes",
       installSkills: skills === "yes",
       installCustomSkills: customSkills === "yes",
       setupMode: "quick",
@@ -16910,14 +16940,14 @@ async function runInstall(config2) {
   }
   printStep(step++, totalSteps, "Writing oh-my-groundcontrol configuration...");
   if (resolvedConfig.dryRun) {
-    const liteConfig = generateLiteConfig(resolvedConfig);
+    const groundConfig = generateGroundConfig(resolvedConfig);
     printInfo("Dry run mode - configuration that would be written:");
     console.log(`
-${JSON.stringify(liteConfig, null, 2)}
+${JSON.stringify(groundConfig, null, 2)}
 `);
   } else {
-    const liteResult = writeLiteConfig(resolvedConfig);
-    if (!handleStepResult(liteResult, "Config written"))
+    const groundResult = writeGroundConfig(resolvedConfig);
+    if (!handleStepResult(groundResult, "Config written"))
       return 1;
   }
   if (!modelsOnly && resolvedConfig.installSkills) {

package/dist/cli/paths.d.ts

@@ -2,8 +2,8 @@ export declare function getConfigDir(): string;
 export declare function getOpenCodeConfigPaths(): string[];
 export declare function getConfigJson(): string;
 export declare function getConfigJsonc(): string;
-export declare function getLiteConfig(): string;
-export declare function getLiteConfigJsonc(): string;
-export declare function getExistingLiteConfigPath(): string;
+export declare function getGroundConfig(): string;
+export declare function getGroundConfigJsonc(): string;
+export declare function getExistingGroundConfigPath(): string;
 export declare function getExistingConfigPath(): string;
 export declare function ensureConfigDir(): void;

package/dist/cli/providers.d.ts

@@ -201,4 +201,4 @@ export declare const MODEL_MAPPINGS: {
     };
 };
 export declare function generateAntigravityMixedPreset(config: InstallConfig, existingPreset?: Record<string, unknown>): Record<string, unknown>;
-export declare function generateLiteConfig(installConfig: InstallConfig): Record<string, unknown>;
+export declare function generateGroundConfig(installConfig: InstallConfig): Record<string, unknown>;

package/dist/cli/types.d.ts

@@ -12,6 +12,7 @@ export interface InstallArgs {
     skills?: BooleanArg;
     opencodeFree?: BooleanArg;
     balancedSpend?: BooleanArg;
+    langfuse?: BooleanArg;
     opencodeFreeModel?: string;
     aaKey?: string;
     openrouterKey?: string;
@@ -112,6 +113,7 @@ export interface InstallConfig {
     openRouterApiKey?: string;
     balanceProviderUsage?: boolean;
     hasTmux: boolean;
+    enableLangfuseTracing?: boolean;
     installSkills: boolean;
     installCustomSkills: boolean;
     setupMode: 'quick' | 'manual';

package/dist/index.js

@@ -23169,12 +23169,12 @@ function deriveTask(agent) {
   return AGENT_TASK_MAP[agent] ?? "general";
 }
 function deriveTags(agent) {
-  const tags = ["opencode"];
+  const tags = [];
   if (agent)
-    tags.push(agent);
+    tags.push(`agent:${agent}`);
   const task = deriveTask(agent);
   if (task)
-    tags.push(task);
+    tags.push(`task:${task}`);
   return tags;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frenchtoastman/oh-my-groundcontrol",
-  "version": "0.0.21",
+  "version": "0.0.23",
   "description": "An OpenCode plugin for multi-agent orchestration for structured planning with NASA-style guardrails.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",