Skip to content

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

feat: enable session linking from schedule runs (#1153)

harshil-209636f95f5fee48
diff --git a/.changeset/schedule-run-open-session.md b/.changeset/schedule-run-open-session.md
new file mode 100644
index 000000000..d4672ec1e
--- /dev/null
+++ b/.changeset/schedule-run-open-session.md
@@ -0,0 +1,6 @@
+---
+'@truefoundry/trueforge-ui': patch
+'@truefoundry/trueforge-assistant-ui-runtime': patch
+---
+
+Open the linked session in the Sessions page when clicking a schedule run on the Schedules page.
diff --git a/packages/assistant-ui-runtime/src/server/types.ts b/packages/assistant-ui-runtime/src/server/types.ts
index 333b6d4de..3fe78f4ef 100644
--- a/packages/assistant-ui-runtime/src/server/types.ts
+++ b/packages/assistant-ui-runtime/src/server/types.ts
@@ -1019,6 +1019,8 @@ export interface ScheduleRun {
reason?: string | null;
triggeredAt: string | null;
triggeredBy: string;
+ /** Session started by this run; null until one is linked. */
+ sessionId?: string | null;
}
export interface ListSchedulesParams extends Pick<PageParams, 'limit' | 'pageToken'> {
diff --git a/packages/trueforge-ui/src/analytics/events.ts b/packages/trueforge-ui/src/analytics/events.ts
index 80560f4c4..6db355795 100644
--- a/packages/trueforge-ui/src/analytics/events.ts
+++ b/packages/trueforge-ui/src/analytics/events.ts
@@ -67,6 +67,7 @@ export const AnalyticsEvents = {
DELETED: 'trueforge.schedule.deleted',
TOGGLED: 'trueforge.schedule.toggled',
RUN_NOW: 'trueforge.schedule.run_now',
+ RUN_SESSION_OPENED: 'trueforge.schedule.run_session_opened',
},
Environment: {
PAGE_OPENED: 'trueforge.environment.page_opened',
diff --git a/packages/trueforge-ui/src/atoms/schedules/ScheduleLastRunsCell.tsx b/packages/trueforge-ui/src/atoms/schedules/ScheduleLastRunsCell.tsx
index 681f20d1f..c129c4ee8 100644
--- a/packages/trueforge-ui/src/atoms/schedules/ScheduleLastRunsCell.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/ScheduleLastRunsCell.tsx
@@ -4,7 +4,13 @@ import type { ScheduleRun } from '../../server/types.js';
import { ScheduleRunChip } from './ScheduleRunChip.js';
import { lastHistoricalRuns } from './scheduleRuns.js';
-export function ScheduleLastRunsCell({ runs }: { runs: readonly ScheduleRun[] }) {
+export function ScheduleLastRunsCell({
+ runs,
+ onOpenSession,
+}: {
+ runs: readonly ScheduleRun[];
+ onOpenSession?: (run: ScheduleRun) => void;
+}) {
const history = lastHistoricalRuns(runs);
if (history.length === 0) {
return <span className="text-text-secondary text-sm">—</span>;
@@ -12,7 +18,7 @@ export function ScheduleLastRunsCell({ runs }: { runs: readonly ScheduleRun[] })
return (
<div className="flex items-center gap-1">
{history.map(run => (
- <ScheduleRunChip key={run.id} run={run} />
+ <ScheduleRunChip key={run.id} run={run} {...(onOpenSession == null ? {} : { onOpenSession })} />
))}
</div>
);
diff --git a/packages/trueforge-ui/src/atoms/schedules/ScheduleRunChip.tsx b/packages/trueforge-ui/src/atoms/schedules/ScheduleRunChip.tsx
index 28ab05152..f8484f8e6 100644
--- a/packages/trueforge-ui/src/atoms/schedules/ScheduleRunChip.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/ScheduleRunChip.tsx
@@ -13,17 +13,34 @@ const CHIP_STYLES = {
failed: 'border-red-600/30 bg-red-500/10 text-red-700 dark:border-red-400/35 dark:bg-red-500/15 dark:text-red-300',
} as const;
-export function ScheduleRunChip({ run }: { run: ScheduleRun }) {
+export function ScheduleRunChip({
+ run,
+ onOpenSession,
+}: {
+ run: ScheduleRun;
+ onOpenSession?: (run: ScheduleRun) => void;
+}) {
const kind = runChipKind(run.status);
const when = formatScheduleRunInstant(run.triggeredAt ?? run.scheduledFor);
+ const label = `${runStatusLabel(run.status)} run at ${when}`;
+ const chipClass = cn('inline-flex size-6 shrink-0 items-center justify-center rounded-md border', CHIP_STYLES[kind]);
+ const icon = <Icon name={kind === 'failed' ? 'triangle-exclamation' : 'check'} className="size-3.5" />;
return (
<Tooltip content={<ScheduleRunTooltip run={run} />} className="max-w-sm whitespace-normal" side="top">
- <span
- className={cn('inline-flex size-6 shrink-0 items-center justify-center rounded-md border', CHIP_STYLES[kind])}
- aria-label={`${runStatusLabel(run.status)} run at ${when}`}
- >
- <Icon name={kind === 'failed' ? 'triangle-exclamation' : 'check'} className="size-3.5" />
- </span>
+ {onOpenSession != null && run.sessionId != null && run.sessionId !== '' ? (
+ <button
+ type="button"
+ className={cn(chipClass, 'cursor-pointer hover:brightness-95')}
+ aria-label={`Open session for ${label}`}
+ onClick={() => onOpenSession(run)}
+ >
+ {icon}
+ </button>
+ ) : (
+ <span className={chipClass} aria-label={label}>
+ {icon}
+ </span>
+ )}
</Tooltip>
);
}
diff --git a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
index 7c20f6668..8b643ef1c 100644
--- a/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
+++ b/packages/trueforge-ui/src/atoms/schedules/SchedulesPage.tsx
@@ -7,13 +7,15 @@ import { AnalyticsEvents } from '../../analytics/events.js';
import { useToasterOptional } from '../../containers/ToasterContainer.js';
import { useResourcePermissions } from '../../hooks/useResourcePermissions.js';
import { Icon } from '../../icons/Icon.js';
-import { useScheduleServer, useServer } from '../../server/ServerContext.js';
-import { libraryAgentId } from '../../server/ShellModeContext.js';
+import { isSessionsChromeEnabled } from '../../server/serverChrome.js';
+import { useOptionalAgentSessionsServer, useScheduleServer, useServer } from '../../server/ServerContext.js';
+import { libraryAgentId, useOptionalShellMode } from '../../server/ShellModeContext.js';
import type { Schedule, ScheduleRun, ScheduleStatus } from '../../server/types.js';
import { useSlot } from '../../theme/SlotsProvider.js';
import { hasCreatedBySubject } from '../../utils/createdBySubject.js';
import { getErrorMessage } from '../../utils/getErrorMessage.js';
import { readScheduleShareSearch, replaceScheduleShareSearch } from '../../utils/scheduleShareUrl.js';
+import { replaceSessionShareSearch, sessionTimeRangeFromCreatedAt } from '../../utils/sessionShareUrl.js';
import { AgentSearchPicker } from '../AgentSearchPicker.js';
import { CreatedByCell } from '../CreatedByCell.js';
import { EmptyScreen } from '../EmptyScreen.js';
@@ -159,6 +161,9 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
const server = useServer();
const toaster = useToasterOptional();
const track = useTrackAnalytics();
+ const shell = useOptionalShellMode();
+ const sessionsServer = useOptionalAgentSessionsServer();
+ const canOpenRunSession = shell != null && isSessionsChromeEnabled({ sessions: sessionsServer });
const [schedules, setSchedules] = useState<Schedule[]>([]);
const { allows } = useResourcePermissions({
@@ -193,6 +198,17 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
const [pageToken, setPageToken] = useState<string | undefined>(undefined);
const [nextPageToken, setNextPageToken] = useState<string | undefined>(undefined);
const [previousPageToken, setPreviousPageToken] = useState<string | undefined>(undefined);
+ const handleOpenRunSession = ({ run, schedule }: { run: ScheduleRun; schedule: Schedule }) => {
+ if (!canOpenRunSession || shell == null || run.sessionId == null) return;
+ track(AnalyticsEvents.Schedule.RUN_SESSION_OPENED, { schedule_id: schedule.id, agent_id: schedule.agentId });
+ const pinned = sessionTimeRangeFromCreatedAt(run.triggeredAt ?? run.scheduledFor);
+ replaceSessionShareSearch({
+ sessionId: run.sessionId,
+ view: 'sessions',
+ ...(pinned == null ? {} : { timeRange: pinned }),
+ });
+ shell.setSessionsOpen(true);
+ };
const loadGenRef = useRef(0);
const didConsumeIsNewRef = useRef(false);
@@ -532,7 +548,12 @@ export function SchedulesPage({ agentId }: SchedulesPageProps) {
{runsLoading ? (
<span className="text-text-secondary text-sm">…</span>
) : (
- <ScheduleLastRunsCell runs={runsByScheduleId[schedule.id] ?? []} />
+ <ScheduleLastRunsCell
+ runs={runsByScheduleId[schedule.id] ?? []}
+ {...(!canOpenRunSession
+ ? {}
+ : { onOpenSession: run => handleOpenRunSession({ run, schedule }) })}
+ />
)}
</TableCell>
<TableCell className="text-right">
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
index 9d02b73ed..0d002a5f9 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/schedules/scheduleServer.ts
@@ -102,6 +102,7 @@ function toUiScheduleRun(wire: TrueForgeApi.ScheduleRun): ScheduleRun {
reason: wire.reason,
triggeredAt: wire.triggeredAt == null ? null : toIsoInstant(wire.triggeredAt),
triggeredBy: wire.createdBySubject.subjectDisplayName || wire.createdBySubject.subjectId,
+ sessionId: wire.sessionId,
};
}