@frenchtoastman/oh-my-groundcontrol 0.0.20 → 0.0.22

package/dist/cli/index.js

@@ -13772,9 +13772,10 @@ var HashlineEditConfigSchema = exports_external.object({
 var DoubleConfirmationConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false)
 });
-var LangfuseHeadersConfigSchema = exports_external.object({
+var LangfuseTracingConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false),
-  customHeaders: exports_external.record(exports_external.string(), exports_external.string()).default({})
+  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(),
@@ -13791,7 +13792,7 @@ var PluginConfigSchema = exports_external.object({
   sessionExport: SessionExportConfigSchema.optional(),
   hashline_edit: HashlineEditConfigSchema.optional(),
   double_confirmation: DoubleConfirmationConfigSchema.optional(),
-  langfuse_headers: LangfuseHeadersConfigSchema.optional()
+  langfuse_tracing: LangfuseTracingConfigSchema.optional()
 });
 // src/config/agent-mcps.ts
 var DEFAULT_AGENT_MCPS = {

package/dist/config/schema.d.ts

@@ -165,11 +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 LangfuseHeadersConfigSchema: z.ZodObject<{
+export declare const LangfuseTracingConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
-    customHeaders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    traceUserId: z.ZodDefault<z.ZodString>;
+    customMetadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-export type LangfuseHeadersConfig = z.infer<typeof LangfuseHeadersConfigSchema>;
+export type LangfuseTracingConfig = z.infer<typeof LangfuseTracingConfigSchema>;
 export declare const PluginConfigSchema: z.ZodObject<{
     preset: z.ZodOptional<z.ZodString>;
     scoringEngineVersion: z.ZodOptional<z.ZodEnum<{
@@ -303,9 +304,10 @@ export declare const PluginConfigSchema: z.ZodObject<{
     double_confirmation: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
-    langfuse_headers: z.ZodOptional<z.ZodObject<{
+    langfuse_tracing: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
-        customHeaders: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        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>;

package/dist/hooks/index.d.ts

@@ -6,7 +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 { createLangfuseHeadersHook } from './langfuse-headers';
+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-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,9 +17104,10 @@ var HashlineEditConfigSchema = exports_external.object({
 var DoubleConfirmationConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false)
 });
-var LangfuseHeadersConfigSchema = exports_external.object({
+var LangfuseTracingConfigSchema = exports_external.object({
   enabled: exports_external.boolean().default(false),
-  customHeaders: exports_external.record(exports_external.string(), exports_external.string()).default({})
+  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(),
@@ -17123,7 +17124,7 @@ var PluginConfigSchema = exports_external.object({
   sessionExport: SessionExportConfigSchema.optional(),
   hashline_edit: HashlineEditConfigSchema.optional(),
   double_confirmation: DoubleConfirmationConfigSchema.optional(),
-  langfuse_headers: LangfuseHeadersConfigSchema.optional()
+  langfuse_tracing: LangfuseTracingConfigSchema.optional()
 });
 
 // src/config/loader.ts
@@ -23149,7 +23150,7 @@ ${JSON_ERROR_REMINDER}`;
     }
   };
 }
-// src/hooks/langfuse-headers/index.ts
+// src/hooks/langfuse-common.ts
 var AGENT_TASK_MAP = {
   orchestrator: "planning",
   explorer: "research",
@@ -23157,46 +23158,63 @@ var AGENT_TASK_MAP = {
   designer: "design",
   librarian: "research",
   oracle: "analysis",
-  build: "coding",
   verification: "verification",
   "pre-flight": "planning",
   contractor: "planning",
-  groundcontrol: "planning",
-  "power-slap-red": "coding",
-  "power-slap-blue": "coding",
-  "power-slap-green": "coding"
+  groundcontrol: "planning"
 };
-function createLangfuseHeadersHook(config2) {
+function deriveTask(agent) {
+  if (!agent)
+    return;
+  return AGENT_TASK_MAP[agent] ?? "general";
+}
+function deriveTags(agent) {
+  const tags = [];
+  if (agent)
+    tags.push(`agent:${agent}`);
+  const task = deriveTask(agent);
+  if (task)
+    tags.push(`task:${task}`);
+  return tags;
+}
+
+// src/hooks/langfuse-tracing/index.ts
+function createLangfuseTracingHook(config2) {
   const enabled = config2?.enabled ?? false;
-  const customHeaders = config2?.customHeaders ?? {};
+  const traceUserId = config2?.traceUserId ?? "opencode";
+  const customMetadata = config2?.customMetadata ?? {};
   const pluginVersion = getCachedVersion() ?? "unknown";
   return {
-    "chat.headers": async (input, output) => {
+    "chat.params": async (input, output) => {
       if (!enabled)
         return;
       try {
-        const dynamic = {
-          "X-OC-App": "opencode",
-          "X-OC-Agent": input.agent || undefined,
-          "X-OC-Task": input.agent && AGENT_TASK_MAP[input.agent] || (input.agent ? "general" : undefined),
-          "X-OC-Session-Id": input.sessionID || undefined,
-          "X-OC-Model": input.model?.id || undefined,
-          "X-OC-Provider": input.model?.providerID || undefined,
-          "X-OC-Plugin-Version": pluginVersion || undefined,
-          "X-OC-Prompt-Version": "opencode-default"
+        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(dynamic)) {
-          if (value) {
-            output.headers[key] = value;
+        for (const [key, value] of Object.entries(customMetadata)) {
+          if (value !== undefined && value !== null) {
+            metadata[key] = value;
           }
         }
-        for (const [key, value] of Object.entries(customHeaders)) {
-          if (value) {
-            output.headers[key] = value;
+        for (const key of Object.keys(metadata)) {
+          if (metadata[key] === undefined) {
+            delete metadata[key];
           }
         }
+        output.options.metadata = metadata;
       } catch (err) {
-        log("[langfuse-headers] Error injecting headers:", err);
+        log("[langfuse-tracing] Error injecting metadata:", err);
       }
     }
   };
@@ -39416,7 +39434,7 @@ var OhMyGroundControl = async (ctx) => {
   const hashlineReadEnhancerHook = createHashlineReadEnhancerHook(config3.hashline_edit);
   const editErrorRecoveryHook = createEditErrorRecoveryHook();
   const doubleConfirmationHook = createDoubleConfirmationHook(config3.double_confirmation);
-  const langfuseHeadersHook = createLangfuseHeadersHook(config3.langfuse_headers);
+  const langfuseTracingHook = createLangfuseTracingHook(config3.langfuse_tracing);
   const hashlineEditEnabled = config3.hashline_edit?.enabled !== false;
   const hashlineEditTool = hashlineEditEnabled ? createHashlineEditTool() : undefined;
   return {
@@ -39521,7 +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.headers": langfuseHeadersHook["chat.headers"],
+    "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.20",
+  "version": "0.0.22",
   "description": "An OpenCode plugin for multi-agent orchestration for structured planning with NASA-style guardrails.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",