Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

chore: Add PostHog envs in Dockerfile, add trueforge prefix and include tenant id (#1036)

harshil-20967f2be59e6e8b
diff --git a/.changeset/analytics-events-trueforge-prefix.md b/.changeset/analytics-events-trueforge-prefix.md
new file mode 100644
index 000000000..8c7a90994
--- /dev/null
+++ b/.changeset/analytics-events-trueforge-prefix.md
@@ -0,0 +1,5 @@
+---
+'@truefoundry/trueforge-ui': patch
+---
+
+Prefix public `AnalyticsEvents` names with `trueforge.` so host sinks (e.g. PostHog) can namespace product events.
diff --git a/Dockerfile b/Dockerfile
index 10f7ae2d6..02b677173 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -78,6 +78,10 @@ RUN pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundr
# tsc needs, so this stage never compiles SDK JavaScript.
# ---------------------------------------------------------------------------
FROM workspace AS frontend-builder
+ARG VITE_POSTHOG_API_KEY=
+ARG VITE_POSTHOG_HOST=https://us.i.posthog.com
+ENV VITE_POSTHOG_API_KEY=$VITE_POSTHOG_API_KEY \
+ VITE_POSTHOG_HOST=$VITE_POSTHOG_HOST
RUN pnpm install --frozen-lockfile --offline --filter frontend...
COPY packages/trueforge-sdk packages/trueforge-sdk
COPY packages/assistant-ui-runtime packages/assistant-ui-runtime
diff --git a/packages/frontend/src/App.tsx b/packages/frontend/src/App.tsx
index 7899fe263..a71ccfd21 100644
--- a/packages/frontend/src/App.tsx
+++ b/packages/frontend/src/App.tsx
@@ -42,14 +42,6 @@ function initAnalytics(): void {
initAnalytics();
-const hostAnalytics: AnalyticsConfig | undefined = POSTHOG_API_KEY
- ? {
- track: (eventName, data) => {
- posthog.capture(eventName, data);
- },
- }
- : undefined;
-
/** Shared cookie/OIDC fetch for boot helpers and `<TrueForgeUI server />`. */
const authAwareFetch = createAuthAwareFetch();
// UI + API share the public prefix from `window.__TRUEFORGE_BASE_PATH__`.
@@ -183,6 +175,21 @@ export function App() {
[],
);
+ const hostAnalytics = useMemo((): AnalyticsConfig | undefined => {
+ if (!POSTHOG_API_KEY || session.status !== 'authenticated') {
+ return undefined;
+ }
+ const { tenantId } = session;
+ return {
+ track: (eventName, data) => {
+ posthog.capture(eventName, {
+ tenant: tenantId,
+ ...data,
+ });
+ },
+ };
+ }, [session]);
+
const authErrorReason = shouldShowAuthErrorScreen({ authError, session });
if (authErrorReason != null) {
return (
diff --git a/packages/frontend/src/authSession.ts b/packages/frontend/src/authSession.ts
index 2cb4c9b25..0380737b4 100644
--- a/packages/frontend/src/authSession.ts
+++ b/packages/frontend/src/authSession.ts
@@ -22,7 +22,8 @@ const probeClient = new TrueForgeClient({
});
/** Result of the pre-boot session probe. */
-export type SessionState = { status: 'authenticated'; displayName: string } | { status: 'unauthenticated' };
+export type SessionState =
+ { status: 'authenticated'; displayName: string; tenantId: string } | { status: 'unauthenticated' };
/** Last successful me() OIDC check — survives remounts of host chrome. */
let cachedIsOidcConnected: boolean | undefined;
@@ -63,7 +64,11 @@ export async function logout(post: typeof fetch = globalThis.fetch.bind(globalTh
export async function probeSession(client: TrueForge = probeClient): Promise<SessionState> {
try {
const { data } = await client.auth.me();
- return { status: 'authenticated', displayName: data.subject.displayName };
+ return {
+ status: 'authenticated',
+ displayName: data.subject.displayName,
+ tenantId: data.tenantId,
+ };
} catch {
return { status: 'unauthenticated' };
}
diff --git a/packages/frontend/tests/authSession.test.ts b/packages/frontend/tests/authSession.test.ts
index c1cb7574c..9823a4955 100644
--- a/packages/frontend/tests/authSession.test.ts
+++ b/packages/frontend/tests/authSession.test.ts
@@ -61,10 +61,12 @@ describe('authSession', () => {
assert.deepEqual(await probeSession(createClient({ type: 'default' })), {
status: 'authenticated',
displayName: 'user-1',
+ tenantId: 'default',
});
assert.deepEqual(await probeSession(createClient({ type: 'oidc-connected' })), {
status: 'authenticated',
displayName: 'user-1',
+ tenantId: 'default',
});
});
diff --git a/packages/trueforge-ui/src/analytics/events.ts b/packages/trueforge-ui/src/analytics/events.ts
index f3ad0e696..4ca0eda6d 100644
--- a/packages/trueforge-ui/src/analytics/events.ts
+++ b/packages/trueforge-ui/src/analytics/events.ts
@@ -3,74 +3,74 @@
*/
export const AnalyticsEvents = {
Message: {
- SENT: 'agent.message_sent',
- CANCELLED: 'agent.message_cancelled',
- COPIED: 'agent.message_copied',
- EDIT_STARTED: 'agent.message_edit_started',
- RETRIED: 'agent.message_retried',
+ SENT: 'trueforge.agent.message_sent',
+ CANCELLED: 'trueforge.agent.message_cancelled',
+ COPIED: 'trueforge.agent.message_copied',
+ EDIT_STARTED: 'trueforge.agent.message_edit_started',
+ RETRIED: 'trueforge.agent.message_retried',
},
Attachment: {
- PICKED: 'agent.attachment_picked',
+ PICKED: 'trueforge.agent.attachment_picked',
},
Session: {
- NEW: 'agent.session_new',
- SELECTED: 'agent.session_selected',
- DELETED: 'agent.session_deleted',
- RENAMED: 'agent.session_renamed',
- SHARE_OPENED: 'agent.session_share_opened',
- SHARE_LINK_COPIED: 'agent.session_share_link_copied',
+ NEW: 'trueforge.agent.session_new',
+ SELECTED: 'trueforge.agent.session_selected',
+ DELETED: 'trueforge.agent.session_deleted',
+ RENAMED: 'trueforge.agent.session_renamed',
+ SHARE_OPENED: 'trueforge.agent.session_share_opened',
+ SHARE_LINK_COPIED: 'trueforge.agent.session_share_link_copied',
},
Tool: {
- APPROVAL_RESOLVED: 'agent.tool_approval_resolved',
+ APPROVAL_RESOLVED: 'trueforge.agent.tool_approval_resolved',
},
AskUser: {
- SUBMITTED: 'agent.ask_user_submitted',
+ SUBMITTED: 'trueforge.agent.ask_user_submitted',
},
Config: {
- OPENED: 'agent.config_opened',
+ OPENED: 'trueforge.agent.config_opened',
},
Settings: {
- OPENED: 'agent.settings_opened',
- CLOSED: 'settings.closed',
- SECTION_CHANGED: 'settings.section_changed',
- MODEL_PROVIDER_SAVED: 'settings.model_provider_saved',
- MODEL_PROVIDER_DELETED: 'settings.model_provider_deleted',
- CONNECTOR_SAVED: 'settings.connector_saved',
- CONNECTOR_DISCONNECTED: 'settings.connector_disconnected',
- CONNECTOR_DELETED: 'settings.connector_deleted',
- SKILL_IMPORTED: 'settings.skill_imported',
- SKILL_DELETED: 'settings.skill_deleted',
- SANDBOX_PROVIDER_SAVED: 'settings.sandbox_provider_saved',
- SANDBOX_PROVIDER_DELETED: 'settings.sandbox_provider_deleted',
- WEB_SEARCH_PROVIDER_SAVED: 'settings.web_search_provider_saved',
+ OPENED: 'trueforge.agent.settings_opened',
+ CLOSED: 'trueforge.settings.closed',
+ SECTION_CHANGED: 'trueforge.settings.section_changed',
+ MODEL_PROVIDER_SAVED: 'trueforge.settings.model_provider_saved',
+ MODEL_PROVIDER_DELETED: 'trueforge.settings.model_provider_deleted',
+ CONNECTOR_SAVED: 'trueforge.settings.connector_saved',
+ CONNECTOR_DISCONNECTED: 'trueforge.settings.connector_disconnected',
+ CONNECTOR_DELETED: 'trueforge.settings.connector_deleted',
+ SKILL_IMPORTED: 'trueforge.settings.skill_imported',
+ SKILL_DELETED: 'trueforge.settings.skill_deleted',
+ SANDBOX_PROVIDER_SAVED: 'trueforge.settings.sandbox_provider_saved',
+ SANDBOX_PROVIDER_DELETED: 'trueforge.settings.sandbox_provider_deleted',
+ WEB_SEARCH_PROVIDER_SAVED: 'trueforge.settings.web_search_provider_saved',
},
Library: {
- OPENED: 'library.opened',
- CLOSED: 'library.closed',
- AGENT_TRIED: 'library.agent_tried',
- AGENT_EDITED: 'library.agent_edited',
- AGENT_DETAILS_OPENED: 'library.agent_details_opened',
- AGENT_SCHEDULES_OPENED: 'library.agent_schedules_opened',
+ OPENED: 'trueforge.library.opened',
+ CLOSED: 'trueforge.library.closed',
+ AGENT_TRIED: 'trueforge.library.agent_tried',
+ AGENT_EDITED: 'trueforge.library.agent_edited',
+ AGENT_DETAILS_OPENED: 'trueforge.library.agent_details_opened',
+ AGENT_SCHEDULES_OPENED: 'trueforge.library.agent_schedules_opened',
},
AgentDetails: {
- OPENED: 'agent_details.opened',
- TAB_CHANGED: 'agent_details.tab_changed',
+ OPENED: 'trueforge.agent_details.opened',
+ TAB_CHANGED: 'trueforge.agent_details.tab_changed',
},
SessionsBrowser: {
- OPENED: 'sessions_browser.opened',
+ OPENED: 'trueforge.sessions_browser.opened',
},
Schedule: {
- PAGE_OPENED: 'schedule.page_opened',
- CREATED: 'schedule.created',
- EDITED: 'schedule.edited',
- DELETED: 'schedule.deleted',
- TOGGLED: 'schedule.toggled',
- RUN_NOW: 'schedule.run_now',
+ PAGE_OPENED: 'trueforge.schedule.page_opened',
+ CREATED: 'trueforge.schedule.created',
+ EDITED: 'trueforge.schedule.edited',
+ DELETED: 'trueforge.schedule.deleted',
+ TOGGLED: 'trueforge.schedule.toggled',
+ RUN_NOW: 'trueforge.schedule.run_now',
},
Environment: {
- PAGE_OPENED: 'environment.page_opened',
- CREATED: 'environment.created',
- EDITED: 'environment.edited',
- DELETED: 'environment.deleted',
+ PAGE_OPENED: 'trueforge.environment.page_opened',
+ CREATED: 'trueforge.environment.created',
+ EDITED: 'trueforge.environment.edited',
+ DELETED: 'trueforge.environment.deleted',
},
} as const;