@frenchtoastman/oh-my-groundcontrol 0.0.19 → 0.0.21

package/dist/cli/index.js

@@ -13772,6 +13772,11 @@ var HashlineEditConfigSchema = exports_external.object({
 var DoubleConfirmationConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false)
 });
+var LangfuseTracingConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(false),
+  traceUserId: exports_external.string().default("opencode"),
+  customMetadata: exports_external.record(exports_external.string(), exports_external.unknown()).default({})
+});
 var PluginConfigSchema = exports_external.object({
   preset: exports_external.string().optional(),
   scoringEngineVersion: exports_external.enum(["v1", "v2-shadow", "v2"]).optional(),
@@ -13786,7 +13791,8 @@ var PluginConfigSchema = exports_external.object({
   allowedProviders: exports_external.array(exports_external.string()).optional(),
   sessionExport: SessionExportConfigSchema.optional(),
   hashline_edit: HashlineEditConfigSchema.optional(),
-  double_confirmation: DoubleConfirmationConfigSchema.optional()
+  double_confirmation: DoubleConfirmationConfigSchema.optional(),
+  langfuse_tracing: LangfuseTracingConfigSchema.optional()
 });
 // src/config/agent-mcps.ts
 var DEFAULT_AGENT_MCPS = {

package/dist/config/schema.d.ts

@@ -165,6 +165,12 @@ export declare const DoubleConfirmationConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type DoubleConfirmationConfig = z.infer<typeof DoubleConfirmationConfigSchema>;
+export declare const LangfuseTracingConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    traceUserId: z.ZodDefault<z.ZodString>;
+    customMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type LangfuseTracingConfig = z.infer<typeof LangfuseTracingConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     preset: z.ZodOptional<z.ZodString>;
     scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
@@ -298,6 +304,11 @@ export declare const PluginConfigSchema: z.ZodObject<{
     double_confirmation: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    langfuse_tracing: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        traceUserId: z.ZodDefault<z.ZodString>;
+        customMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type PluginConfig = z.infer<typeof PluginConfigSchema>;
 export type { AgentName } from './constants';

package/dist/hooks/index.d.ts

@@ -6,6 +6,7 @@ export { createDoubleConfirmationHook } from './double-confirmation';
 export { createEditErrorRecoveryHook } from './edit-error-recovery';
 export { createHashlineReadEnhancerHook } from './hashline-read-enhancer';
 export { createJsonErrorRecoveryHook } from './json-error-recovery';
+export { createLangfuseTracingHook } from './langfuse-tracing';
 export { createPhaseReminderHook } from './phase-reminder';
 export { createPostReadNudgeHook } from './post-read-nudge';
 export { createQuestionRouterHook } from './question-router';

package/dist/hooks/langfuse-body/index.d.ts

@@ -0,0 +1,39 @@
+import type { LangfuseBodyConfig } from '../../config/schema';
+interface ChatParamsInput {
+    sessionID: string;
+    agent: string;
+    model: {
+        id: string;
+        providerID: string;
+    };
+    provider: {
+        source: string;
+        info: unknown;
+        options: Record<string, unknown>;
+    };
+    message: unknown;
+}
+interface ChatParamsOutput {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    options: Record<string, unknown>;
+}
+/**
+ * Creates the Langfuse body injection hook.
+ *
+ * Injects metadata into the LLM request body via `chat.params`
+ * → `output.options.metadata`, which flows through the Vercel AI
+ * SDK's `providerOptions` into the HTTP request body.
+ *
+ * LiteLLM proxy reads body-level `metadata` and forwards recognised
+ * keys (tags, session_id, trace_user_id, trace_name,
+ * generation_name) to Langfuse for trace enrichment.
+ *
+ * Ships disabled by default — enable via
+ * config.langfuse_body.enabled.
+ */
+export declare function createLangfuseBodyHook(config?: Partial<LangfuseBodyConfig>): {
+    'chat.params': (input: ChatParamsInput, output: ChatParamsOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/langfuse-common.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared Langfuse utilities for agent-to-task mapping and tag derivation.
+ */
+export declare const AGENT_TASK_MAP: Record<string, string>;
+/**
+ * Derive the task type for an agent.
+ * Returns undefined for empty agent.
+ * Falls back to 'general' for unknown agents.
+ */
+export declare function deriveTask(agent: string): string | undefined;
+/**
+ * Derive Langfuse tags for an agent.
+ * Returns ['opencode', agentName, taskType], filtering out empty values.
+ */
+export declare function deriveTags(agent: string): string[];

package/dist/hooks/langfuse-headers/index.d.ts

@@ -0,0 +1,31 @@
+import type { LangfuseHeadersConfig } from '../../config/schema';
+interface ChatHeadersInput {
+    sessionID: string;
+    agent: string;
+    model: {
+        id: string;
+        providerID: string;
+    };
+    provider: {
+        source: string;
+        info: unknown;
+        options: Record<string, unknown>;
+    };
+    message: unknown;
+}
+interface ChatHeadersOutput {
+    headers: Record<string, string>;
+}
+/**
+ * Creates the Langfuse trace enrichment headers hook.
+ *
+ * Injects dynamic `X-OC-*` HTTP headers into every LLM API request,
+ * providing rich OpenCode context for Langfuse trace enrichment and
+ * training data tagging.
+ *
+ * Ships disabled by default — enable via config.langfuse_headers.enabled.
+ */
+export declare function createLangfuseHeadersHook(config?: Partial<LangfuseHeadersConfig>): {
+    'chat.headers': (input: ChatHeadersInput, output: ChatHeadersOutput) => Promise<void>;
+};
+export {};

package/dist/hooks/langfuse-tracing/index.d.ts

@@ -0,0 +1,39 @@
+import type { LangfuseTracingConfig } from '../../config/schema';
+interface ChatParamsInput {
+    sessionID: string;
+    agent: string;
+    model: {
+        id: string;
+        providerID: string;
+    };
+    provider: {
+        source: string;
+        info: unknown;
+        options: Record<string, unknown>;
+    };
+    message: unknown;
+}
+interface ChatParamsOutput {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    options: Record<string, unknown>;
+}
+/**
+ * Creates the Langfuse tracing hook.
+ *
+ * Injects metadata into the LLM request body via `chat.params`
+ * → `output.options.metadata`, which flows through the Vercel AI
+ * SDK's `providerOptions` into the HTTP request body.
+ *
+ * LiteLLM proxy reads body-level `metadata` and forwards recognised
+ * keys (tags, session_id, trace_user_id, trace_name,
+ * generation_name) to Langfuse for trace enrichment.
+ *
+ * Ships disabled by default — enable via
+ * config.langfuse_tracing.enabled.
+ */
+export declare function createLangfuseTracingHook(config?: Partial<LangfuseTracingConfig>): {
+    'chat.params': (input: ChatParamsInput, output: ChatParamsOutput) => Promise<void>;
+};
+export {};

package/dist/index.js

@@ -17104,6 +17104,11 @@ var HashlineEditConfigSchema = exports_external.object({
 var DoubleConfirmationConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false)
 });
+var LangfuseTracingConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(false),
+  traceUserId: exports_external.string().default("opencode"),
+  customMetadata: exports_external.record(exports_external.string(), exports_external.unknown()).default({})
+});
 var PluginConfigSchema = exports_external.object({
   preset: exports_external.string().optional(),
   scoringEngineVersion: exports_external.enum(["v1", "v2-shadow", "v2"]).optional(),
@@ -17118,7 +17123,8 @@ var PluginConfigSchema = exports_external.object({
   allowedProviders: exports_external.array(exports_external.string()).optional(),
   sessionExport: SessionExportConfigSchema.optional(),
   hashline_edit: HashlineEditConfigSchema.optional(),
-  double_confirmation: DoubleConfirmationConfigSchema.optional()
+  double_confirmation: DoubleConfirmationConfigSchema.optional(),
+  langfuse_tracing: LangfuseTracingConfigSchema.optional()
 });
 
 // src/config/loader.ts
@@ -23144,6 +23150,75 @@ ${JSON_ERROR_REMINDER}`;
     }
   };
 }
+// src/hooks/langfuse-common.ts
+var AGENT_TASK_MAP = {
+  orchestrator: "planning",
+  explorer: "research",
+  fixer: "coding",
+  designer: "design",
+  librarian: "research",
+  oracle: "analysis",
+  verification: "verification",
+  "pre-flight": "planning",
+  contractor: "planning",
+  groundcontrol: "planning"
+};
+function deriveTask(agent) {
+  if (!agent)
+    return;
+  return AGENT_TASK_MAP[agent] ?? "general";
+}
+function deriveTags(agent) {
+  const tags = ["opencode"];
+  if (agent)
+    tags.push(agent);
+  const task = deriveTask(agent);
+  if (task)
+    tags.push(task);
+  return tags;
+}
+
+// src/hooks/langfuse-tracing/index.ts
+function createLangfuseTracingHook(config2) {
+  const enabled = config2?.enabled ?? false;
+  const traceUserId = config2?.traceUserId ?? "opencode";
+  const customMetadata = config2?.customMetadata ?? {};
+  const pluginVersion = getCachedVersion() ?? "unknown";
+  return {
+    "chat.params": async (input, output) => {
+      if (!enabled)
+        return;
+      try {
+        const tags = deriveTags(input.agent);
+        const task = deriveTask(input.agent);
+        const metadata = {
+          ...output.options.metadata ?? {},
+          tags,
+          session_id: input.sessionID || undefined,
+          trace_user_id: traceUserId || undefined,
+          trace_name: input.agent || undefined,
+          generation_name: task || undefined,
+          model: input.model?.id || undefined,
+          provider: input.model?.providerID || undefined,
+          plugin_version: pluginVersion || undefined
+        };
+        for (const [key, value] of Object.entries(customMetadata)) {
+          if (value !== undefined && value !== null) {
+            metadata[key] = value;
+          }
+        }
+        for (const key of Object.keys(metadata)) {
+          if (metadata[key] === undefined) {
+            delete metadata[key];
+          }
+        }
+        output.options.metadata = metadata;
+      } catch (err) {
+        log("[langfuse-tracing] Error injecting metadata:", err);
+      }
+    }
+  };
+}
 // src/hooks/phase-reminder/index.ts
 var PHASE_REMINDER = `<reminder>Recall Workflow Rules:
 Before acting: <think> \u2014 analyze what you see, what's been accomplished, what still needs to be done.
@@ -39359,6 +39434,7 @@ var OhMyGroundControl = async (ctx) => {
   const hashlineReadEnhancerHook = createHashlineReadEnhancerHook(config3.hashline_edit);
   const editErrorRecoveryHook = createEditErrorRecoveryHook();
   const doubleConfirmationHook = createDoubleConfirmationHook(config3.double_confirmation);
+  const langfuseTracingHook = createLangfuseTracingHook(config3.langfuse_tracing);
   const hashlineEditEnabled = config3.hashline_edit?.enabled !== false;
   const hashlineEditTool = hashlineEditEnabled ? createHashlineEditTool() : undefined;
   return {
@@ -39463,6 +39539,7 @@ var OhMyGroundControl = async (ctx) => {
     "experimental.chat.messages.transform": phaseReminderHook["experimental.chat.messages.transform"],
     "chat.message": questionRouterHook["chat.message"],
     "command.execute.before": analyzeCommandHook["command.execute.before"],
+    "chat.params": langfuseTracingHook["chat.params"],
     "tool.execute.after": async (input, output) => {
       await delegateTaskRetryHook["tool.execute.after"](input, output);
       await jsonErrorRecoveryHook["tool.execute.after"](input, output);

package/package.json

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