@agent-native/core 0.168.13 → 0.169.1

package/dist/observability/traces.d.ts

@@ -44,6 +44,19 @@ export declare function instrumentAgentLoop(opts: {
      *  reads. */
     userId: string | null;
     config: ObservabilityConfig;
+    /**
+     * Name for this run's root span, in the local trace store and in PostHog LLM
+     * analytics. Defaults to `"agent_run"`. Without it every path emits the same
+     * name and a scheduled automation is indistinguishable from a chat turn in
+     * the one view where telling them apart is the whole question.
+     */
+    spanName?: string;
+    /**
+     * Free-form run context. Persisted onto the local store's parent span AND
+     * forwarded to PostHog as trace properties — a channel that reached only the
+     * SQL store was a channel that could not answer "which automation was this?"
+     * in LLM analytics.
+     */
     metadata?: Record<string, unknown> | null;
     experimentAssignments?: Array<{
         experimentId: string;