mirror of
https://github.com/getpaseo/paseo.git
synced 2026-11-21 07:45:38 +00:00
Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
14e8908d0a | ||
|
|
efb65d7b82 | ||
|
|
27c126d352 | ||
|
|
7e3826ad6c |
Generated
-10
@@ -6651,15 +6651,6 @@
|
||||
"url": "https://github.com/sponsors/ayuhito"
|
||||
}
|
||||
},
|
||||
"node_modules/@fontsource-variable/plus-jakarta-sans": {
|
||||
"version": "5.3.0",
|
||||
"resolved": "https://registry.npmjs.org/@fontsource-variable/plus-jakarta-sans/-/plus-jakarta-sans-5.3.0.tgz",
|
||||
"integrity": "sha512-/l/4r0yyWK9JzAlmA0LiYgGgmJe/Gswt4jTJEzr5QhJfwMbvJZDmYWyW0M4X7yCK69BajMVlV/Lx8g7WDc1+sw==",
|
||||
"license": "OFL-1.1",
|
||||
"funding": {
|
||||
"url": "https://github.com/sponsors/ayuhito"
|
||||
}
|
||||
},
|
||||
"node_modules/@getpaseo/app": {
|
||||
"resolved": "packages/app",
|
||||
"link": true
|
||||
@@ -41488,7 +41479,6 @@
|
||||
"@cloudflare/vite-plugin": "^1.29.1",
|
||||
"@cloudflare/workers-types": "^4.20260317.1",
|
||||
"@fontsource-variable/geist": "^5.3.0",
|
||||
"@fontsource-variable/plus-jakarta-sans": "^5.3.0",
|
||||
"@getpaseo/protocol": "*",
|
||||
"@tanstack/react-router": "^1.170.16",
|
||||
"@tanstack/react-start": "^1.168.26",
|
||||
|
||||
@@ -0,0 +1,149 @@
|
||||
import { test, expect, type Page } from "../support/fixtures";
|
||||
import { gotoAppShell } from "../support/helpers/app";
|
||||
import { seedWorkspace, type SeededWorkspace } from "../support/helpers/seed-client";
|
||||
import { selectSidebarStatusGrouping } from "../support/helpers/sidebar";
|
||||
import {
|
||||
createGatedTeardown,
|
||||
pressArchiveShortcut,
|
||||
workspaceRow,
|
||||
} from "../support/helpers/workspace-archive-undo";
|
||||
|
||||
// The archive shortcut used to be registered by the sidebar row itself, so it did nothing whenever
|
||||
// the row was unmounted — a collapsed project section being the common case. It now lives in a
|
||||
// single always-mounted handler keyed on the active route selection, like the pin shortcut.
|
||||
// Returns the workspace route, so the test can assert archiving redirected off it.
|
||||
async function openWorkspace(page: Page, workspaceId: string): Promise<string> {
|
||||
const row = workspaceRow(page, workspaceId);
|
||||
await expect(row).toBeVisible({ timeout: 30_000 });
|
||||
await row.click();
|
||||
await expect(page).toHaveURL((url) => url.pathname.endsWith(`/workspace/${workspaceId}`), {
|
||||
timeout: 30_000,
|
||||
});
|
||||
return page.url();
|
||||
}
|
||||
|
||||
async function collapseProjectSection(page: Page, project: SeededWorkspace): Promise<void> {
|
||||
const header = page
|
||||
.locator('[data-testid^="sidebar-project-row-"]')
|
||||
.filter({ hasText: project.projectDisplayName });
|
||||
await expect(header).toHaveCount(1, { timeout: 30_000 });
|
||||
|
||||
await header.click();
|
||||
await expect(workspaceRow(page, project.workspaceId)).toHaveCount(0, { timeout: 10_000 });
|
||||
}
|
||||
|
||||
async function collapseStatusGroupContaining(page: Page, workspaceId: string): Promise<void> {
|
||||
const rows = page
|
||||
.locator('[data-testid^="sidebar-status-group-rows-"]')
|
||||
.filter({ has: workspaceRow(page, workspaceId) });
|
||||
await expect(rows).toHaveCount(1, { timeout: 30_000 });
|
||||
|
||||
const rowsTestId = await rows.getAttribute("data-testid");
|
||||
const bucket = rowsTestId?.replace("sidebar-status-group-rows-", "");
|
||||
expect(bucket).toBeTruthy();
|
||||
|
||||
await page.getByTestId(`sidebar-status-group-${bucket}`).click();
|
||||
await expect(workspaceRow(page, workspaceId)).toHaveCount(0, { timeout: 10_000 });
|
||||
}
|
||||
|
||||
async function expectArchived(page: Page, workspace: SeededWorkspace, workspaceUrl: string) {
|
||||
await expect(page).not.toHaveURL(workspaceUrl);
|
||||
await expect
|
||||
.poll(async () => {
|
||||
const { entries } = await workspace.client.fetchWorkspaces();
|
||||
return entries.some((entry) => entry.id === workspace.workspaceId);
|
||||
})
|
||||
.toBe(false);
|
||||
}
|
||||
|
||||
test.describe("Archive workspace shortcut", () => {
|
||||
test("archives the active workspace while its row is rendered", async ({ page }) => {
|
||||
const workspace = await seedWorkspace({ repoPrefix: "archive-shortcut-expanded-" });
|
||||
|
||||
try {
|
||||
await gotoAppShell(page);
|
||||
const workspaceUrl = await openWorkspace(page, workspace.workspaceId);
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
|
||||
await expectArchived(page, workspace, workspaceUrl);
|
||||
} finally {
|
||||
await workspace.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
test("archives the active workspace while its project section is collapsed", async ({ page }) => {
|
||||
const workspace = await seedWorkspace({ repoPrefix: "archive-shortcut-collapsed-" });
|
||||
|
||||
try {
|
||||
await gotoAppShell(page);
|
||||
const workspaceUrl = await openWorkspace(page, workspace.workspaceId);
|
||||
await collapseProjectSection(page, workspace);
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
|
||||
await expectArchived(page, workspace, workspaceUrl);
|
||||
} finally {
|
||||
await workspace.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
test("archives the active workspace while its status group is collapsed", async ({ page }) => {
|
||||
const workspace = await seedWorkspace({ repoPrefix: "archive-shortcut-status-" });
|
||||
|
||||
try {
|
||||
await gotoAppShell(page);
|
||||
const workspaceUrl = await openWorkspace(page, workspace.workspaceId);
|
||||
await selectSidebarStatusGrouping(page);
|
||||
await expect(page.getByTestId("sidebar-status-list-scroll")).toBeVisible({
|
||||
timeout: 10_000,
|
||||
});
|
||||
await collapseStatusGroupContaining(page, workspace.workspaceId);
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
|
||||
await expectArchived(page, workspace, workspaceUrl);
|
||||
} finally {
|
||||
await workspace.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
test("archives a different workspace while the first worktree is still tearing down", async ({
|
||||
page,
|
||||
}) => {
|
||||
const teardown = createGatedTeardown();
|
||||
const project = await seedWorkspace({
|
||||
repoPrefix: "archive-shortcut-teardown-",
|
||||
repo: { paseoConfig: teardown.paseoConfig },
|
||||
});
|
||||
const next = await seedWorkspace({ repoPrefix: "archive-shortcut-next-" });
|
||||
|
||||
try {
|
||||
const { workspace: worktree, error } = await project.client.createWorkspace({
|
||||
source: {
|
||||
kind: "worktree",
|
||||
cwd: project.repoPath,
|
||||
worktreeSlug: "archive-shortcut-teardown",
|
||||
},
|
||||
});
|
||||
if (!worktree) throw new Error(error ?? "Could not seed the worktree");
|
||||
await gotoAppShell(page);
|
||||
|
||||
await test.step("start the first archive and wait for its teardown", async () => {
|
||||
await openWorkspace(page, worktree.id);
|
||||
await pressArchiveShortcut(page);
|
||||
await teardown.expectStarted();
|
||||
});
|
||||
|
||||
await test.step("archive the second workspace before the first archive finishes", async () => {
|
||||
const workspaceUrl = await openWorkspace(page, next.workspaceId);
|
||||
await pressArchiveShortcut(page);
|
||||
await expectArchived(page, next, workspaceUrl);
|
||||
});
|
||||
} finally {
|
||||
teardown.release();
|
||||
await project.cleanup();
|
||||
await next.cleanup();
|
||||
}
|
||||
});
|
||||
});
|
||||
@@ -503,6 +503,34 @@ test.describe("terminal history with a finger", () => {
|
||||
await expectMouseWheelScrollsHistory(page);
|
||||
});
|
||||
|
||||
test("finger scrolling leaves terminal input unfocused until a tap", async ({ page }) => {
|
||||
await openPhoneTerminalHistory(page);
|
||||
await blurTerminalInput(page);
|
||||
|
||||
await expectSingleFingerScroll(page, 24);
|
||||
await expect(input(page)).not.toBeFocused();
|
||||
await expectSingleFingerScroll(page, 1);
|
||||
await expect(input(page)).not.toBeFocused();
|
||||
|
||||
await tapTerminalScreen(page);
|
||||
await expect(input(page)).toBeFocused();
|
||||
});
|
||||
|
||||
test("finger scrolling keeps a floating keyboard's input focused", async ({ page }) => {
|
||||
await openPhoneTerminalHistory(page);
|
||||
await tapTerminalScreen(page);
|
||||
await expect(input(page)).toBeFocused();
|
||||
|
||||
// A floating keyboard leaves the visual viewport unchanged.
|
||||
await expectSingleFingerScroll(page, 24);
|
||||
await expect(input(page)).toBeFocused();
|
||||
await expect(input(page)).toHaveAttribute("virtualkeyboardpolicy", "manual");
|
||||
|
||||
// Android Back also leaves the input focused. A tap restores automatic keyboard opening.
|
||||
await tapTerminalScreen(page);
|
||||
await expect(input(page)).not.toHaveAttribute("virtualkeyboardpolicy");
|
||||
});
|
||||
|
||||
for (const mode of ["alternate", "mouse"] as const) {
|
||||
test(`preserves finger navigation in ${mode} input mode`, async ({ page }) => {
|
||||
await openPhoneInputCapture(page, mode);
|
||||
@@ -531,6 +559,26 @@ async function openPhoneTerminalHistory(page: Page) {
|
||||
});
|
||||
await openPhoneTerminal(page);
|
||||
await expect.poll(() => getTerminalBufferText(page)).toContain("HISTORY_150");
|
||||
await expect
|
||||
.poll(() => page.evaluate(() => window.__paseoTerminal!.buffer.active.baseY))
|
||||
.toBeGreaterThan(0);
|
||||
await page.evaluate(() => window.__paseoTerminal!.scrollToBottom());
|
||||
await expect.poll(() => viewport(page)).toBeGreaterThan(0);
|
||||
}
|
||||
|
||||
function terminalScreen(page: Page) {
|
||||
return page.getByTestId("terminal-surface").filter({ visible: true }).locator(".xterm-screen");
|
||||
}
|
||||
|
||||
async function tapTerminalScreen(page: Page) {
|
||||
const box = await terminalScreen(page).boundingBox();
|
||||
expect(box).not.toBeNull();
|
||||
await page.touchscreen.tap(box!.x + box!.width / 2, box!.y + box!.height / 3);
|
||||
}
|
||||
|
||||
async function blurTerminalInput(page: Page) {
|
||||
await input(page).evaluate((element) => element.blur());
|
||||
await expect(input(page)).not.toBeFocused();
|
||||
}
|
||||
|
||||
async function openPhoneInputCapture(page: Page, mode: "alternate" | "mouse") {
|
||||
@@ -570,6 +618,20 @@ async function openPhoneTerminal(page: Page) {
|
||||
await page.getByTestId(`sidebar-workspace-row-${getServerId()}:${harness.workspaceId}`).click();
|
||||
await expect(page.getByRole("textbox", { name: "Terminal input" })).toBeVisible();
|
||||
await expect(page.getByTestId("terminal-surface").filter({ visible: true })).toBeVisible();
|
||||
// The terminal stays mounted while the sidebar's closing backdrop still intercepts input.
|
||||
await expect
|
||||
.poll(() =>
|
||||
page
|
||||
.getByTestId("terminal-surface")
|
||||
.filter({ visible: true })
|
||||
.evaluate((root) => {
|
||||
const box = root.querySelector(".xterm-screen")!.getBoundingClientRect();
|
||||
return root.contains(
|
||||
document.elementFromPoint(box.x + box.width / 2, box.y + box.height / 3),
|
||||
);
|
||||
}),
|
||||
)
|
||||
.toBe(true);
|
||||
}
|
||||
|
||||
async function expectMouseWheelScrollsHistory(page: Page) {
|
||||
|
||||
@@ -2,13 +2,14 @@ import { tmpdir } from "node:os";
|
||||
import { randomUUID } from "node:crypto";
|
||||
import path from "node:path";
|
||||
import type { Page } from "@playwright/test";
|
||||
import type { UsageReportEntry } from "@getpaseo/protocol/messages";
|
||||
import type { UsageReport, UsageReportEntry } from "@getpaseo/protocol/messages";
|
||||
import { expect, test } from "../support/fixtures";
|
||||
import { gotoAppShell, openSettings } from "../support/helpers/app";
|
||||
import { addConnectedHostAndReload } from "../support/helpers/hosts";
|
||||
import { startIsolatedHostDaemon } from "../support/helpers/isolated-host-daemon";
|
||||
import { openSettingsSection } from "../support/helpers/settings";
|
||||
import { gate } from "../support/helpers/context-window";
|
||||
import { installDaemonWebSocketGate } from "../support/helpers/daemon-websocket-gate";
|
||||
import { getServerId } from "../support/helpers/server-id";
|
||||
import { seedSidebarFooterPreferences } from "../support/helpers/sidebar-nav-settings";
|
||||
import {
|
||||
@@ -45,6 +46,7 @@ import {
|
||||
refreshAllUsage,
|
||||
togglePin,
|
||||
usageItem,
|
||||
usageModal,
|
||||
} from "../support/helpers/usage-sidebar-item";
|
||||
|
||||
const emptyHome = path.join(tmpdir(), `paseo-usage-empty-${randomUUID()}`);
|
||||
@@ -865,6 +867,106 @@ test("open usage clocks advance without refreshing or reopening", async ({ page
|
||||
}
|
||||
});
|
||||
|
||||
test("Refresh all keeps quota visible and restores the forecast after a timeout", async ({
|
||||
page,
|
||||
}) => {
|
||||
const reading = new Date();
|
||||
const login = await installLoginUsage(usageReading(reading, 40));
|
||||
try {
|
||||
const transport = await installDaemonWebSocketGate(page);
|
||||
await openCompactUsageWithClock(page, reading);
|
||||
await expectQuota(page, "40% used", /runs out in /);
|
||||
|
||||
await timeOutUsageRefresh(page, transport);
|
||||
await expectQuota(page, "40% used", null);
|
||||
await expectUsageRefreshError(page).toBeVisible();
|
||||
|
||||
await login.setReport(usageReading(reading, 10));
|
||||
transport.releaseHeldClientRequest();
|
||||
await refreshAllUsage(page);
|
||||
await expectQuota(page, "10% used", "~50% left at reset");
|
||||
await expectUsageRefreshError(page).toBeHidden();
|
||||
} finally {
|
||||
await login.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
test("a card refresh timeout is visible alongside a newer quota forecast", async ({ page }) => {
|
||||
const reading = new Date();
|
||||
const login = await installLoginUsage(usageReading(reading, 40));
|
||||
try {
|
||||
const transport = await installDaemonWebSocketGate(page);
|
||||
await openCompactUsageWithClock(page, reading);
|
||||
await expectQuota(page, "40% used", /runs out in /);
|
||||
|
||||
await delayCardRefreshResponse(page, transport);
|
||||
await login.setReport(usageReading(reading, 10));
|
||||
await refreshAllUsage(page);
|
||||
await expectQuota(page, "10% used", "~50% left at reset");
|
||||
|
||||
await advanceUsageClock(page, 61_000);
|
||||
await expectUsageRefreshError(page).toBeVisible();
|
||||
await expectQuota(page, "10% used", "~50% left at reset");
|
||||
} finally {
|
||||
await login.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
function expectUsageRefreshError(page: Page) {
|
||||
return expect(usageModal(page).getByText("Unable to refresh usage", { exact: true }));
|
||||
}
|
||||
|
||||
async function delayCardRefreshResponse(
|
||||
page: Page,
|
||||
transport: Awaited<ReturnType<typeof installDaemonWebSocketGate>>,
|
||||
) {
|
||||
await expect(page.getByRole("button", { name: "Refresh all", exact: true })).toBeEnabled();
|
||||
transport.holdNextServerMessage("usage.list_reports.response");
|
||||
await refreshLoginUsage(page);
|
||||
await transport.waitForHeldServerMessage("usage.list_reports.response");
|
||||
}
|
||||
|
||||
function usageReading(observed: Date, usedPct: number): UsageReport {
|
||||
return {
|
||||
status: "available",
|
||||
observedAt: observed.toISOString(),
|
||||
windows: [
|
||||
{
|
||||
id: "session",
|
||||
label: "Session",
|
||||
usedPct,
|
||||
durationSeconds: 18_000,
|
||||
resetsAt: new Date(observed.getTime() + 4 * 3_600_000).toISOString(),
|
||||
},
|
||||
],
|
||||
};
|
||||
}
|
||||
|
||||
async function expectQuota(page: Page, amount: string, forecast: string | RegExp | null) {
|
||||
const usage = usageModal(page);
|
||||
await expect(usage.getByText(amount, { exact: true })).toBeVisible();
|
||||
await expect(usage.getByText(/^resets in /)).toBeVisible();
|
||||
if (forecast === null) {
|
||||
await expect(usage.getByText(/^runs out in /)).toBeHidden();
|
||||
return;
|
||||
}
|
||||
await expect(usage.getByText(forecast)).toBeVisible();
|
||||
}
|
||||
|
||||
async function timeOutUsageRefresh(
|
||||
page: Page,
|
||||
transport: Awaited<ReturnType<typeof installDaemonWebSocketGate>>,
|
||||
) {
|
||||
const refresh = page.getByRole("button", { name: "Refresh all", exact: true });
|
||||
await expect(refresh).toBeEnabled();
|
||||
transport.holdNextClientRequest("usage.list_reports.request");
|
||||
await refreshAllUsage(page);
|
||||
await transport.waitForHeldClientRequest();
|
||||
await expect(refresh).toBeDisabled();
|
||||
await advanceUsageClock(page, 61_000);
|
||||
await expect(refresh).toBeEnabled();
|
||||
}
|
||||
|
||||
async function openCompactUsageWithClock(page: Page, now: Date) {
|
||||
await page.setViewportSize({ width: 390, height: 844 });
|
||||
await page.clock.install({ time: now });
|
||||
|
||||
@@ -318,6 +318,37 @@ test.describe("Workspace archive undo", () => {
|
||||
}
|
||||
});
|
||||
|
||||
test("archives a restored workspace while its undo is queued", async ({ page }) => {
|
||||
const teardown = createGatedTeardown();
|
||||
const repo = await createTempGitRepo("archive-undo-archive-", {
|
||||
paseoConfig: teardown.paseoConfig,
|
||||
});
|
||||
|
||||
try {
|
||||
await openProjectViaDaemon(client, repo.path);
|
||||
const worktree = await createWorktreeViaDaemon(client, {
|
||||
cwd: repo.path,
|
||||
slug: "archive-undo-archive",
|
||||
});
|
||||
worktreeDirectories.add(worktree.workspaceDirectory);
|
||||
await gotoAppShell(page);
|
||||
await archiveFromRowButton(page, worktree.workspaceId);
|
||||
await teardown.expectStarted();
|
||||
|
||||
await undoButton(page).click();
|
||||
await workspaceRow(page, worktree.workspaceId).click();
|
||||
await expect(page).toHaveURL(new RegExp(`/workspace/${worktree.workspaceId}$`));
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
await expectWorkspaceAbsentFromSidebar(page, worktree.workspaceId);
|
||||
teardown.release();
|
||||
await expectDirectoryPresence(worktree.workspaceDirectory, false);
|
||||
} finally {
|
||||
teardown.release();
|
||||
await repo.cleanup();
|
||||
}
|
||||
});
|
||||
|
||||
test("Cmd/Ctrl+Z without an archive to undo leaves the sidebar alone", async ({ page }) => {
|
||||
const worktree = await seedWorktree(page, "archive-undo-none");
|
||||
|
||||
|
||||
@@ -20,6 +20,7 @@ import {
|
||||
} from "../support/helpers/sidebar";
|
||||
import { createTempGitRepo } from "../support/helpers/workspace";
|
||||
import {
|
||||
pressArchiveShortcut,
|
||||
rowArchiveButton,
|
||||
undoButton,
|
||||
workspaceRow,
|
||||
@@ -98,6 +99,18 @@ async function clickRowArchiveButton(page: Page, workspaceId: string): Promise<v
|
||||
await rowArchiveButton(page, workspaceId).click();
|
||||
}
|
||||
|
||||
async function cycleThemeAndWaitForSidebar(page: Page, workspaceId: string): Promise<void> {
|
||||
const rowBeforeThemeChange = await workspaceRow(page, workspaceId).elementHandle();
|
||||
if (!rowBeforeThemeChange)
|
||||
throw new Error("The workspace row must be mounted before cycling the theme");
|
||||
await page.keyboard.press("ControlOrMeta+Alt+t");
|
||||
await expect
|
||||
.poll(() => rowBeforeThemeChange.evaluate((element) => element.isConnected), {
|
||||
message: "the sidebar remounts after the theme changes",
|
||||
})
|
||||
.toBe(false);
|
||||
}
|
||||
|
||||
interface SessionEnvelope {
|
||||
type?: unknown;
|
||||
message?: {
|
||||
@@ -211,18 +224,28 @@ async function relayDaemon(
|
||||
* Holds the app's next checkout status request for `directory` once armed, so a test can act
|
||||
* while the archive waits for the host's answer.
|
||||
*/
|
||||
async function holdCheckoutStatusRequest(page: Page, directory: string) {
|
||||
async function holdCheckoutStatusRequest(
|
||||
page: Page,
|
||||
worktree: { workspaceDirectory: string; workspaceId: string },
|
||||
) {
|
||||
let armed = false;
|
||||
let held: (() => void) | null = null;
|
||||
let archiveRequests = 0;
|
||||
await page.routeWebSocket(daemonWsRoutePattern(), (browser) => {
|
||||
const server = browser.connectToServer();
|
||||
browser.onMessage((message) => {
|
||||
const request = typeof message === "string" ? parseSessionEnvelope(message)?.message : null;
|
||||
if (
|
||||
request?.type === "archive_workspace_request" &&
|
||||
request.workspaceId === worktree.workspaceId
|
||||
) {
|
||||
archiveRequests += 1;
|
||||
}
|
||||
if (
|
||||
armed &&
|
||||
!held &&
|
||||
request?.type === "checkout_status_request" &&
|
||||
request.cwd === directory
|
||||
request.cwd === worktree.workspaceDirectory
|
||||
) {
|
||||
held = () => server.send(message);
|
||||
return;
|
||||
@@ -236,6 +259,7 @@ async function holdCheckoutStatusRequest(page: Page, directory: string) {
|
||||
armed = true;
|
||||
},
|
||||
waitForHeld: () => expect.poll(() => held !== null).toBe(true),
|
||||
archiveRequests: () => archiveRequests,
|
||||
release: () => {
|
||||
if (!held) throw new Error("No checkout status request is held");
|
||||
held();
|
||||
@@ -388,7 +412,7 @@ test.describe("Workspace archive risk warning for worktree backing", () => {
|
||||
): Promise<string> {
|
||||
const serverId = getServerId();
|
||||
const worktree = await createWorktree(slug);
|
||||
const statusRequest = await holdCheckoutStatusRequest(page, worktree.workspaceDirectory);
|
||||
const statusRequest = await holdCheckoutStatusRequest(page, worktree);
|
||||
await openSidebarRow(page, worktree.workspaceId);
|
||||
await workspaceRow(page, worktree.workspaceId).click();
|
||||
await expectAppRoute(page, buildHostWorkspaceRoute(serverId, worktree.workspaceId));
|
||||
@@ -432,6 +456,82 @@ test.describe("Workspace archive risk warning for worktree backing", () => {
|
||||
await expectAppRoute(page, openedRoute);
|
||||
});
|
||||
|
||||
async function openWorktreeWithCheckoutHeld(page: Page, slug: string) {
|
||||
const worktree = await createWorktree(slug);
|
||||
const statusRequest = await holdCheckoutStatusRequest(page, worktree);
|
||||
// Opening the workspace can start a checkout read that the archive reuses.
|
||||
statusRequest.arm();
|
||||
await openSidebarRow(page, worktree.workspaceId);
|
||||
await workspaceRow(page, worktree.workspaceId).click();
|
||||
await expectAppRoute(page, buildHostWorkspaceRoute(getServerId(), worktree.workspaceId));
|
||||
return { worktree, statusRequest };
|
||||
}
|
||||
|
||||
test("the archive shortcut works in another workspace while a checkout check is pending", async ({
|
||||
page,
|
||||
}) => {
|
||||
const { worktree, statusRequest } = await openWorktreeWithCheckoutHeld(
|
||||
page,
|
||||
"archive-risk-switch-shortcut",
|
||||
);
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
await statusRequest.waitForHeld();
|
||||
try {
|
||||
const otherWorkspaceId = worktree.project.workspaceId;
|
||||
await workspaceRow(page, otherWorkspaceId).click();
|
||||
await expectAppRoute(page, buildHostWorkspaceRoute(getServerId(), otherWorkspaceId));
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
await expect.poll(() => hostListsWorkspace(otherWorkspaceId)).toBe(false);
|
||||
} finally {
|
||||
statusRequest.release();
|
||||
}
|
||||
await expect.poll(() => hostListsWorkspace(worktree.workspaceId)).toBe(false);
|
||||
});
|
||||
|
||||
test("the row button and shortcut send one archive for the same worktree", async ({ page }) => {
|
||||
const { worktree, statusRequest } = await openWorktreeWithCheckoutHeld(
|
||||
page,
|
||||
"archive-risk-repeat-shortcut",
|
||||
);
|
||||
|
||||
await clickRowArchiveButton(page, worktree.workspaceId);
|
||||
await statusRequest.waitForHeld();
|
||||
try {
|
||||
await pressArchiveShortcut(page);
|
||||
} finally {
|
||||
statusRequest.release();
|
||||
}
|
||||
|
||||
await expect.poll(() => hostListsWorkspace(worktree.workspaceId)).toBe(false);
|
||||
expect(statusRequest.archiveRequests()).toBe(1);
|
||||
});
|
||||
|
||||
test("keeps the newly opened workspace after a theme change during an archive check", async ({
|
||||
page,
|
||||
}) => {
|
||||
const { worktree, statusRequest } = await openWorktreeWithCheckoutHeld(
|
||||
page,
|
||||
"archive-risk-theme",
|
||||
);
|
||||
|
||||
await pressArchiveShortcut(page);
|
||||
await statusRequest.waitForHeld();
|
||||
const otherWorkspaceId = worktree.project.workspaceId;
|
||||
const otherRoute = buildHostWorkspaceRoute(getServerId(), otherWorkspaceId);
|
||||
try {
|
||||
await cycleThemeAndWaitForSidebar(page, otherWorkspaceId);
|
||||
await workspaceRow(page, otherWorkspaceId).click();
|
||||
await expectAppRoute(page, otherRoute);
|
||||
} finally {
|
||||
statusRequest.release();
|
||||
}
|
||||
|
||||
await expect.poll(() => hostListsWorkspace(worktree.workspaceId)).toBe(false);
|
||||
await expectAppRoute(page, otherRoute);
|
||||
});
|
||||
|
||||
test("archiving the open worktree from its git actions leaves it for a new workspace", async ({
|
||||
page,
|
||||
}) => {
|
||||
|
||||
@@ -185,13 +185,15 @@ function onLogin(report: UsageReportEntry, login: string): UsageReportEntry {
|
||||
}
|
||||
|
||||
export function expiredLogin(report: UsageReportEntry): UsageReportEntry {
|
||||
const fetchedAt = Date.now();
|
||||
return {
|
||||
...report,
|
||||
fetchedAt: new Date(fetchedAt).toISOString(),
|
||||
report: {
|
||||
status: "unavailable",
|
||||
problem: {
|
||||
kind: "expired",
|
||||
expiresAt: new Date(Date.now() - 2 * 60 * 60_000).toISOString(),
|
||||
expiresAt: new Date(fetchedAt - 2 * 60 * 60_000).toISOString(),
|
||||
refreshedBy: "claude",
|
||||
},
|
||||
},
|
||||
|
||||
@@ -40,7 +40,7 @@
|
||||
"dev:ios": "npm --prefix ../.. run build:client && cross-env APP_VARIANT=development expo run:ios",
|
||||
"build:apk": "npm --prefix ../.. run build:apk",
|
||||
"build:apk:arm64": "npm --prefix ../.. run build:apk:arm64",
|
||||
"test:android": "expo prebuild --platform android --no-install && cd android && ./gradlew :paseo-native-trace:testReleaseUnitTest :paseo-hardware-keyboard:testReleaseUnitTest :react-native-enriched-markdown:testReleaseUnitTest --tests '*InlineCodeFormattingTest' --no-daemon --max-workers=2 -Dorg.gradle.parallel=false"
|
||||
"test:android": "expo prebuild --platform android --no-install && cd android && ./gradlew :paseo-native-trace:testReleaseUnitTest :paseo-hardware-keyboard:testReleaseUnitTest :react-native-enriched-markdown:testReleaseUnitTest --tests '*InlineCodeFormattingTest' --tests '*ListBlockquoteMeasurementTest' --no-daemon --max-workers=2 -Dorg.gradle.parallel=false"
|
||||
},
|
||||
"dependencies": {
|
||||
"@codemirror/commands": "6.10.4",
|
||||
|
||||
@@ -54,6 +54,7 @@ import { WindowSidebarMenuToggle } from "@/components/headers/sidebar-menu-toggl
|
||||
import { DesktopWindowControls } from "@/components/desktop/window-controls";
|
||||
import { SidebarModelProvider } from "@/components/sidebar/sidebar-model";
|
||||
import { WorkspacePinShortcutHandler } from "@/components/workspace-pin-shortcut-handler";
|
||||
import { WorkspaceArchiveShortcutHandler } from "@/components/workspace-archive-shortcut-handler";
|
||||
import { WorkspaceRenameHost } from "@/components/workspace-rename-host";
|
||||
import { WorkspaceArchiveUndoShortcutHost } from "@/workspace/archive-undo";
|
||||
import { WorkspaceExplorerOpenGesture } from "@/mobile-panels/explorer-open-gesture";
|
||||
@@ -537,6 +538,7 @@ function AppContainer({ children, chromeEnabled: chromeEnabledOverride }: AppCon
|
||||
<View style={layoutStyles.surfaceFill}>
|
||||
{workspaceChrome}
|
||||
<AddHostFlowHost />
|
||||
<WorkspaceArchiveShortcutHandler />
|
||||
<AppearanceStyleBoundary>
|
||||
{!isCompactLayout && appChromeLayout.sidebarToggleOwner === "window" ? (
|
||||
<WindowChromeRegion corners="top-left">
|
||||
|
||||
@@ -128,7 +128,6 @@ import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip
|
||||
import { Shortcut } from "@/components/ui/shortcut";
|
||||
import type { ShortcutKey } from "@/utils/format-shortcut";
|
||||
import { useShortcutKeys } from "@/hooks/use-shortcut-keys";
|
||||
import { useKeyboardActionHandler } from "@/hooks/use-keyboard-action-handler";
|
||||
import { useWorkspaceReadState } from "@/hooks/use-workspace-read-state";
|
||||
import type { PrHint } from "@/git/use-pr-status-query";
|
||||
import {
|
||||
@@ -1298,17 +1297,6 @@ function WorkspaceRowWithMenu({
|
||||
});
|
||||
}, [markUnread, toast]);
|
||||
|
||||
useKeyboardActionHandler({
|
||||
handlerId: `workspace-archive-${workspace.workspaceKey}`,
|
||||
actions: ["workspace.archive"],
|
||||
enabled: selected && !isArchiving,
|
||||
priority: 0,
|
||||
handle: () => {
|
||||
handleArchive();
|
||||
return true;
|
||||
},
|
||||
});
|
||||
|
||||
return (
|
||||
<>
|
||||
<WorkspaceRowInner
|
||||
|
||||
@@ -42,7 +42,6 @@ import { redirectIfArchivingActiveWorkspace } from "@/utils/sidebar-workspace-ar
|
||||
import { useWorkspaceArchive } from "@/workspace/use-workspace-archive";
|
||||
import type { ShortcutKey } from "@/utils/format-shortcut";
|
||||
import { useShortcutKeys } from "@/hooks/use-shortcut-keys";
|
||||
import { useKeyboardActionHandler } from "@/hooks/use-keyboard-action-handler";
|
||||
import { useWorkspaceReadState } from "@/hooks/use-workspace-read-state";
|
||||
import {
|
||||
SidebarWorkspaceRowFrame,
|
||||
@@ -702,17 +701,6 @@ function StatusWorkspaceRowWithMenu({
|
||||
});
|
||||
}, [markUnread, toast]);
|
||||
|
||||
useKeyboardActionHandler({
|
||||
handlerId: `workspace-archive-${workspace.workspaceKey}`,
|
||||
actions: ["workspace.archive"],
|
||||
enabled: selected && !isArchiving,
|
||||
priority: 0,
|
||||
handle: () => {
|
||||
handleArchive();
|
||||
return true;
|
||||
},
|
||||
});
|
||||
|
||||
return (
|
||||
<>
|
||||
<StatusWorkspaceRowInner
|
||||
|
||||
@@ -13,6 +13,7 @@ import {
|
||||
useRef,
|
||||
type CSSProperties,
|
||||
type MouseEvent as ReactMouseEvent,
|
||||
type PointerEvent as ReactPointerEvent,
|
||||
type Ref,
|
||||
} from "react";
|
||||
import type { DOMProps } from "expo/dom";
|
||||
@@ -63,6 +64,12 @@ const HOST_DIV_STYLE: CSSProperties = {
|
||||
paddingRight: 0,
|
||||
};
|
||||
|
||||
interface TerminalTouchFocus {
|
||||
pointerId: number;
|
||||
x: number;
|
||||
y: number;
|
||||
}
|
||||
|
||||
function buildXtermThemeKey(theme: ITheme): string {
|
||||
const values: Array<string> = [
|
||||
theme.background,
|
||||
@@ -553,10 +560,46 @@ export default function TerminalEmulator({
|
||||
});
|
||||
}, []);
|
||||
|
||||
const handleRootPointerDown = useCallback(() => {
|
||||
onFocus?.();
|
||||
runtimeRef.current?.focus();
|
||||
}, [onFocus]);
|
||||
const touchFocusRef = useRef<TerminalTouchFocus | null>(null);
|
||||
|
||||
const handleRootPointerDown = useCallback(
|
||||
(event: ReactPointerEvent) => {
|
||||
onFocus?.();
|
||||
touchFocusRef.current = null;
|
||||
if (event.pointerType !== "touch") {
|
||||
runtimeRef.current?.focus();
|
||||
return;
|
||||
}
|
||||
// Focusing before a touch becomes a tap opens the keyboard during a scroll.
|
||||
if (event.isPrimary) {
|
||||
touchFocusRef.current = {
|
||||
pointerId: event.pointerId,
|
||||
x: event.clientX,
|
||||
y: event.clientY,
|
||||
};
|
||||
}
|
||||
},
|
||||
[onFocus],
|
||||
);
|
||||
|
||||
const handleRootPointerMove = useCallback((event: ReactPointerEvent) => {
|
||||
const touch = touchFocusRef.current;
|
||||
if (touch?.pointerId !== event.pointerId) return;
|
||||
if (Math.hypot(event.clientX - touch.x, event.clientY - touch.y) > 8) {
|
||||
touchFocusRef.current = null;
|
||||
runtimeRef.current?.suppressAutomaticKeyboard();
|
||||
}
|
||||
}, []);
|
||||
|
||||
const handleRootPointerUp = useCallback((event: ReactPointerEvent) => {
|
||||
const touch = touchFocusRef.current;
|
||||
touchFocusRef.current = null;
|
||||
if (touch?.pointerId === event.pointerId) runtimeRef.current?.focus();
|
||||
}, []);
|
||||
|
||||
const handleRootPointerCancel = useCallback(() => {
|
||||
touchFocusRef.current = null;
|
||||
}, []);
|
||||
|
||||
const handleRootContextMenu = useCallback(
|
||||
(event: ReactMouseEvent) => {
|
||||
@@ -588,6 +631,9 @@ export default function TerminalEmulator({
|
||||
data-terminal-scrollbar-root="true"
|
||||
style={rootDivStyle}
|
||||
onPointerDown={handleRootPointerDown}
|
||||
onPointerMove={handleRootPointerMove}
|
||||
onPointerUp={handleRootPointerUp}
|
||||
onPointerCancel={handleRootPointerCancel}
|
||||
onContextMenu={handleRootContextMenu}
|
||||
>
|
||||
<div ref={hostRef} style={HOST_DIV_STYLE} />
|
||||
|
||||
@@ -0,0 +1,8 @@
|
||||
import { useGlobalWorkspaceArchiveAction } from "@/hooks/use-global-workspace-archive-action";
|
||||
|
||||
// Headless host for the archive shortcut, kept out of the root layout for the same reason as
|
||||
// WorkspacePinShortcutHandler: the hook subscribes to the active workspace's fields.
|
||||
export function WorkspaceArchiveShortcutHandler() {
|
||||
useGlobalWorkspaceArchiveAction();
|
||||
return null;
|
||||
}
|
||||
@@ -0,0 +1,77 @@
|
||||
import { useCallback } from "react";
|
||||
import { useKeyboardActionHandler } from "@/hooks/use-keyboard-action-handler";
|
||||
import type { KeyboardActionId } from "@/keyboard/keyboard-action-dispatcher";
|
||||
import { useActiveWorkspaceSelection } from "@/stores/navigation-active-workspace-store";
|
||||
import { useWorkspaceFields } from "@/stores/session-store-hooks";
|
||||
import { redirectIfArchivingActiveWorkspace } from "@/utils/sidebar-workspace-archive-redirect";
|
||||
import { useWorkspaceArchive } from "@/workspace/use-workspace-archive";
|
||||
import { isWorkspaceListed, type WorkspaceArchiveTarget } from "@/workspace/workspace-archive";
|
||||
|
||||
const WORKSPACE_ARCHIVE_ACTIONS: readonly KeyboardActionId[] = ["workspace.archive"];
|
||||
|
||||
// The archive shortcut used to live on the sidebar row, so it did nothing whenever the row was not
|
||||
// rendered — a collapsed project or status group, a collapsed Pinned section, or focus mode. Like
|
||||
// the pin shortcut (see use-global-workspace-pin-action.ts), it is one registration keyed on the
|
||||
// active route selection.
|
||||
export function useGlobalWorkspaceArchiveAction() {
|
||||
const selection = useActiveWorkspaceSelection();
|
||||
const serverId = selection?.serverId ?? null;
|
||||
const routeWorkspaceId = selection?.workspaceId ?? null;
|
||||
// `id` is the descriptor id, not the route id; see use-global-workspace-pin-action.ts.
|
||||
const fields = useWorkspaceFields(serverId, routeWorkspaceId, (workspace) => ({
|
||||
id: workspace.id,
|
||||
workspaceKind: workspace.workspaceKind,
|
||||
workspaceDirectory: workspace.workspaceDirectory,
|
||||
name: workspace.name,
|
||||
archivingAt: workspace.archivingAt,
|
||||
diffStat: workspace.diffStat,
|
||||
}));
|
||||
|
||||
// useWorkspaceArchive calls the latest render's callback, so `activeWorkspaceId` is whatever is
|
||||
// routed when the archive starts, after any confirmation. It is the descriptor id, which is what
|
||||
// the redirect compares against.
|
||||
const activeWorkspaceId = fields?.id ?? null;
|
||||
const redirectAfterArchive = useCallback(
|
||||
(workspace: WorkspaceArchiveTarget) => {
|
||||
redirectIfArchivingActiveWorkspace({
|
||||
...workspace,
|
||||
activeWorkspaceSelection:
|
||||
serverId && activeWorkspaceId ? { serverId, workspaceId: activeWorkspaceId } : null,
|
||||
});
|
||||
},
|
||||
[activeWorkspaceId, serverId],
|
||||
);
|
||||
|
||||
const archiveController = useWorkspaceArchive({
|
||||
serverId: serverId ?? "",
|
||||
workspaceId: fields?.id ?? "",
|
||||
workspaceKind: fields?.workspaceKind ?? "directory",
|
||||
workspaceDirectory: fields?.workspaceDirectory ?? "",
|
||||
name: fields?.name ?? "",
|
||||
diffStat: fields?.diffStat,
|
||||
onArchiveStarted: redirectAfterArchive,
|
||||
});
|
||||
|
||||
const canArchive = fields !== null && fields.archivingAt === null;
|
||||
|
||||
const handle = useCallback(() => {
|
||||
if (!canArchive || !serverId) {
|
||||
return false;
|
||||
}
|
||||
// Archiving hides its target immediately. Read the store in case the shortcut
|
||||
// runs again before React renders that update.
|
||||
if (!isWorkspaceListed({ serverId, workspaceId: fields.id })) {
|
||||
return false;
|
||||
}
|
||||
archiveController.archive();
|
||||
return true;
|
||||
}, [archiveController, canArchive, fields, serverId]);
|
||||
|
||||
useKeyboardActionHandler({
|
||||
handlerId: "workspace-archive-global",
|
||||
actions: WORKSPACE_ARCHIVE_ACTIONS,
|
||||
enabled: canArchive,
|
||||
priority: 0,
|
||||
handle,
|
||||
});
|
||||
}
|
||||
@@ -2323,6 +2323,9 @@ export const ar: TranslationResources = {
|
||||
resetsIn: "تتم إعادة التعيين خلال {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}، {{time}}",
|
||||
projectedLeftAtReset: "نحو {{percentage}} متبقية عند إعادة التعيين",
|
||||
limitReached: "تم بلوغ الحد",
|
||||
mayHaveRunOut: "ربما نفدت الحصة",
|
||||
runsOutNow: "ينفد الآن",
|
||||
runsOutIn: "ينفد خلال {{duration}}",
|
||||
justNow: "الآن",
|
||||
|
||||
@@ -2333,6 +2333,9 @@ export const en = {
|
||||
resetsIn: "resets in {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}, {{time}}",
|
||||
projectedLeftAtReset: "~{{percentage}} left at reset",
|
||||
limitReached: "Limit reached",
|
||||
mayHaveRunOut: "May have run out",
|
||||
runsOutNow: "runs out now",
|
||||
runsOutIn: "runs out in {{duration}}",
|
||||
justNow: "just now",
|
||||
|
||||
@@ -2354,6 +2354,9 @@ export const es: TranslationResources = {
|
||||
resetsIn: "se restablece en {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}, {{time}}",
|
||||
projectedLeftAtReset: "~{{percentage}} restante al restablecerse",
|
||||
limitReached: "Límite alcanzado",
|
||||
mayHaveRunOut: "Puede que ya se haya agotado",
|
||||
runsOutNow: "se agota ahora",
|
||||
runsOutIn: "se agota en {{duration}}",
|
||||
justNow: "ahora mismo",
|
||||
|
||||
@@ -2355,6 +2355,9 @@ export const fr: TranslationResources = {
|
||||
resetsIn: "se réinitialise dans {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}, {{time}}",
|
||||
projectedLeftAtReset: "~{{percentage}} restant à la réinitialisation",
|
||||
limitReached: "Limite atteinte",
|
||||
mayHaveRunOut: "Le quota est peut-être épuisé",
|
||||
runsOutNow: "s’épuise maintenant",
|
||||
runsOutIn: "s’épuise dans {{duration}}",
|
||||
justNow: "à l’instant",
|
||||
|
||||
@@ -2328,6 +2328,9 @@ export const ja: TranslationResources = {
|
||||
resetsIn: "{{duration}}後にリセット",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}} {{time}}",
|
||||
projectedLeftAtReset: "リセット時に約{{percentage}}残る見込み",
|
||||
limitReached: "上限に達しました",
|
||||
mayHaveRunOut: "上限に達した可能性があります",
|
||||
runsOutNow: "まもなく上限に到達",
|
||||
runsOutIn: "{{duration}}後に上限に到達",
|
||||
justNow: "たった今",
|
||||
|
||||
@@ -2316,6 +2316,9 @@ export const ko: TranslationResources = {
|
||||
resetsIn: "{{duration}} 후 재설정",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}} {{time}}",
|
||||
projectedLeftAtReset: "초기화 시 약 {{percentage}} 남을 예정",
|
||||
limitReached: "한도에 도달함",
|
||||
mayHaveRunOut: "한도를 소진했을 수 있음",
|
||||
runsOutNow: "지금 한도에 도달",
|
||||
runsOutIn: "{{duration}} 후 한도에 도달",
|
||||
justNow: "방금",
|
||||
|
||||
@@ -2339,6 +2339,9 @@ export const ptBR: TranslationResources = {
|
||||
resetsIn: "redefine em {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}, {{time}}",
|
||||
projectedLeftAtReset: "~{{percentage}} restará na renovação",
|
||||
limitReached: "Limite atingido",
|
||||
mayHaveRunOut: "A cota pode ter se esgotado",
|
||||
runsOutNow: "esgota agora",
|
||||
runsOutIn: "esgota em {{duration}}",
|
||||
justNow: "agora mesmo",
|
||||
|
||||
@@ -2341,6 +2341,9 @@ export const ru: TranslationResources = {
|
||||
resetsIn: "сброс через {{duration}}",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}}, {{time}}",
|
||||
projectedLeftAtReset: "К сбросу останется ~{{percentage}}",
|
||||
limitReached: "Лимит исчерпан",
|
||||
mayHaveRunOut: "Лимит мог уже исчерпаться",
|
||||
runsOutNow: "закончится сейчас",
|
||||
runsOutIn: "закончится через {{duration}}",
|
||||
justNow: "только что",
|
||||
|
||||
@@ -2282,6 +2282,9 @@ export const zhCN: TranslationResources = {
|
||||
resetsIn: "将在 {{duration}}后重置",
|
||||
resetsAtWeekday: "{{weekday}} {{time}}",
|
||||
resetsAtDate: "{{date}} {{time}}",
|
||||
projectedLeftAtReset: "重置时约剩余 {{percentage}}",
|
||||
limitReached: "已达到上限",
|
||||
mayHaveRunOut: "额度可能已用完",
|
||||
runsOutNow: "即将用尽",
|
||||
runsOutIn: "将在 {{duration}}后用尽",
|
||||
justNow: "刚刚",
|
||||
|
||||
@@ -1053,12 +1053,19 @@ export class TerminalEmulatorRuntime {
|
||||
if (!terminal) {
|
||||
return;
|
||||
}
|
||||
terminal.textarea?.removeAttribute("virtualkeyboardpolicy");
|
||||
if (input?.forceRefocus) {
|
||||
terminal.blur();
|
||||
}
|
||||
terminal.focus();
|
||||
}
|
||||
|
||||
suppressAutomaticKeyboard(): void {
|
||||
// Android Chrome can reopen the keyboard during a drag after Back leaves the input
|
||||
// focused. Manual policy prevents that without closing an already open keyboard.
|
||||
this.terminal?.textarea?.setAttribute("virtualkeyboardpolicy", "manual");
|
||||
}
|
||||
|
||||
blur(): void {
|
||||
this.terminal?.blur();
|
||||
}
|
||||
|
||||
@@ -32,6 +32,7 @@ it("translates mounted usage rows when the language changes", async () => {
|
||||
<>
|
||||
<UsageWindowBar
|
||||
window={window}
|
||||
forecastAt={null}
|
||||
displayAs="used"
|
||||
pinnable={false}
|
||||
pinned={false}
|
||||
@@ -51,3 +52,44 @@ it("translates mounted usage rows when the language changes", async () => {
|
||||
expect(container.textContent).toContain("セッション70% 使用済み");
|
||||
expect(container.textContent).toContain("クレジット");
|
||||
});
|
||||
|
||||
const narrowReadingMs = Date.now();
|
||||
const narrowForecastAt = new Date(narrowReadingMs).toISOString();
|
||||
const narrowWindow: UsageWindow = {
|
||||
id: "weekly",
|
||||
label: "Weekly",
|
||||
usedPct: 0.2,
|
||||
durationSeconds: 604_800,
|
||||
resetsAt: new Date(narrowReadingMs + 165.5 * 3_600_000).toISOString(),
|
||||
};
|
||||
|
||||
it("keeps the French reset countdown and forecast apart in a narrow card", async () => {
|
||||
await i18n.changeLanguage("fr");
|
||||
container.style.width = "272px";
|
||||
act(() =>
|
||||
root.render(
|
||||
<UsageWindowBar
|
||||
window={narrowWindow}
|
||||
forecastAt={narrowForecastAt}
|
||||
displayAs="used"
|
||||
pinnable={false}
|
||||
pinned={false}
|
||||
onTogglePin={ignorePin}
|
||||
pinLabel=""
|
||||
pinTestID=""
|
||||
/>,
|
||||
),
|
||||
);
|
||||
|
||||
function textBounds(prefix: string) {
|
||||
const element = Array.from(container.querySelectorAll("*")).find(
|
||||
(node) => node.childElementCount === 0 && node.textContent.startsWith(prefix),
|
||||
);
|
||||
expect(element).toBeDefined();
|
||||
const range = document.createRange();
|
||||
range.selectNodeContents(element!);
|
||||
return range.getBoundingClientRect();
|
||||
}
|
||||
|
||||
expect(textBounds("se réinitialise").right).toBeLessThan(textBounds("~").left);
|
||||
});
|
||||
|
||||
@@ -70,7 +70,7 @@ export function UsageCard({
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
const isCompact = useIsCompactFormFactor();
|
||||
const { refresh, refreshState } = useReportRefresh(serverId, entry.id, agentId);
|
||||
const { refresh, refreshState } = useReportRefresh(serverId, entry, agentId);
|
||||
// Where there is no hover the freshness is printed on the card; elsewhere the Refresh tooltip.
|
||||
const showsFreshnessInline = isNative || isCompact || !refreshable;
|
||||
const usage = entry.report;
|
||||
@@ -176,7 +176,7 @@ function UsageCardBody({
|
||||
refreshState: UsageRefresh;
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
const { windows, balances, details, retained, successfulAt, messages } = report;
|
||||
const { windows, balances, details, retained, successfulAt, forecastAt, messages } = report;
|
||||
const footer = entry.account.label ?? null;
|
||||
return (
|
||||
<>
|
||||
@@ -194,6 +194,7 @@ function UsageCardBody({
|
||||
entry={entry}
|
||||
window={window}
|
||||
retained={retained}
|
||||
forecastAt={forecastAt}
|
||||
display={display}
|
||||
pinnable={pinnable}
|
||||
/>
|
||||
@@ -267,8 +268,10 @@ function CardWindowBar({
|
||||
display,
|
||||
pinnable,
|
||||
retained,
|
||||
forecastAt,
|
||||
}: {
|
||||
retained: boolean;
|
||||
forecastAt: string | null;
|
||||
entry: UsageReportEntry;
|
||||
window: UsageWindow;
|
||||
display: UsageDisplay;
|
||||
@@ -285,6 +288,7 @@ function CardWindowBar({
|
||||
<UsageWindowBar
|
||||
window={window}
|
||||
retained={retained}
|
||||
forecastAt={forecastAt}
|
||||
displayAs={display.displayAs}
|
||||
pinnable={pinnable}
|
||||
pinned={display.isPinned(pin)}
|
||||
|
||||
@@ -2,6 +2,7 @@ import { afterEach, describe, expect, it } from "vitest";
|
||||
import { i18n } from "@/i18n/i18next";
|
||||
import {
|
||||
resolveUsageReport,
|
||||
markUsageRefreshFailure,
|
||||
displayPercent,
|
||||
resolveAgentUsageView,
|
||||
replaceReport,
|
||||
@@ -82,7 +83,7 @@ describe("resolveUsageView", () => {
|
||||
expect(resolveUsageView({ ...base, query: undefined })).toEqual({ kind: "loading" });
|
||||
expect(
|
||||
resolveUsageView({ ...base, query: { data: [], error: null, isFetching: true } }),
|
||||
).toEqual({ kind: "ready", reports: [], isRefreshing: true });
|
||||
).toEqual({ kind: "ready", reports: [], isRefreshing: true, refreshFailed: false });
|
||||
expect(
|
||||
resolveUsageView({
|
||||
...base,
|
||||
@@ -90,6 +91,19 @@ describe("resolveUsageView", () => {
|
||||
}),
|
||||
).toEqual({ kind: "error", message: "boom" });
|
||||
});
|
||||
|
||||
it("shows a failed Refresh all alongside the reports still on screen", () => {
|
||||
const reports = [entry({})];
|
||||
expect(
|
||||
resolveUsageView({
|
||||
hostLabel: "Laptop",
|
||||
isConnected: true,
|
||||
supportsUsage: true,
|
||||
query: ready(reports),
|
||||
refreshState: "failed",
|
||||
}),
|
||||
).toEqual({ kind: "ready", reports, isRefreshing: false, refreshFailed: true });
|
||||
});
|
||||
});
|
||||
|
||||
afterEach(async () => {
|
||||
@@ -203,15 +217,12 @@ describe("displayPercent", () => {
|
||||
|
||||
describe("resolveUsageRefresh", () => {
|
||||
it("is pending while a refresh runs, even after an earlier failure", () => {
|
||||
expect(resolveUsageRefresh({ isPending: true, error: new Error("boom") })).toBe("pending");
|
||||
expect(resolveUsageRefresh({ isPending: true, isError: true })).toBe("pending");
|
||||
});
|
||||
|
||||
it("is failed after a refresh errors", () => {
|
||||
expect(resolveUsageRefresh({ isPending: false, error: new Error("boom") })).toBe("failed");
|
||||
});
|
||||
|
||||
it("is idle before and after a successful refresh", () => {
|
||||
expect(resolveUsageRefresh({ isPending: false, error: null })).toBe("idle");
|
||||
it("reports the request outcome independently of the reading", () => {
|
||||
expect(resolveUsageRefresh({ isPending: false, isError: true })).toBe("failed");
|
||||
expect(resolveUsageRefresh({ isPending: false, isError: false })).toBe("idle");
|
||||
});
|
||||
});
|
||||
|
||||
@@ -352,6 +363,7 @@ it("resolves retained usage and successful time without inventing old-daemon his
|
||||
details: [],
|
||||
planLabel: null,
|
||||
successfulAt: success.fetchedAt,
|
||||
forecastAt: null,
|
||||
retained: true,
|
||||
messages: ["Rate limited"],
|
||||
});
|
||||
@@ -361,6 +373,7 @@ it("resolves retained usage and successful time without inventing old-daemon his
|
||||
details: [],
|
||||
planLabel: null,
|
||||
successfulAt: null,
|
||||
forecastAt: null,
|
||||
retained: false,
|
||||
messages: ["Rate limited"],
|
||||
});
|
||||
@@ -370,11 +383,48 @@ it("resolves retained usage and successful time without inventing old-daemon his
|
||||
details: [],
|
||||
planLabel: null,
|
||||
successfulAt: success.fetchedAt,
|
||||
forecastAt: success.fetchedAt,
|
||||
retained: false,
|
||||
messages: [],
|
||||
});
|
||||
});
|
||||
|
||||
it("uses the quota observation time for pace and keeps the reading after a failed request", () => {
|
||||
const success = entry({ windows: [{ id: "weekly", label: "Weekly", usedPct: 42 }] });
|
||||
if (success.report.status !== "available") throw new Error("fixture must be available");
|
||||
const observedAt = success.fetchedAt;
|
||||
const successfulAt = "2026-01-01T00:15:00.000Z";
|
||||
const report = { ...success, successfulAt, report: { ...success.report, observedAt } };
|
||||
expect(resolveUsageReport(report, i18n.t)).toMatchObject({
|
||||
successfulAt,
|
||||
forecastAt: observedAt,
|
||||
});
|
||||
expect(resolveUsageReport({ ...report, forecastStale: true }, i18n.t)).toMatchObject({
|
||||
windows: success.report.windows,
|
||||
successfulAt,
|
||||
forecastAt: null,
|
||||
});
|
||||
});
|
||||
|
||||
it("keeps cached quota and hides its forecast when Refresh all fails before a new report arrives", () => {
|
||||
const before = entry({ windows: [{ id: "weekly", label: "Weekly", usedPct: 42 }] });
|
||||
const other = entry({ sourceId: "other" });
|
||||
const refreshedAt = "2026-01-01T00:06:00.000Z";
|
||||
const streamed = { ...other, fetchedAt: refreshedAt };
|
||||
const attempted = [before, other];
|
||||
const failed = markUsageRefreshFailure([before, streamed], attempted)!;
|
||||
|
||||
expect(resolveUsageReport(failed[0]!, i18n.t)).toMatchObject({
|
||||
forecastAt: null,
|
||||
windows: before.report.status === "available" ? before.report.windows : [],
|
||||
});
|
||||
expect(resolveUsageReport(failed[1]!, i18n.t).forecastAt).toBe(refreshedAt);
|
||||
expect(resolveUsageReport(upsertReport(failed, before)[0]!, i18n.t).forecastAt).toBeNull();
|
||||
|
||||
const retried = settleReports(failed, [{ ...before, fetchedAt: refreshedAt }, streamed]);
|
||||
expect(resolveUsageReport(retried[0]!, i18n.t).forecastAt).toBe(refreshedAt);
|
||||
});
|
||||
|
||||
it("orders failed polls by attempt time even when successful data is older", () => {
|
||||
const success = entry({});
|
||||
if (success.report.status !== "available") throw new Error("fixture must be available");
|
||||
|
||||
@@ -38,18 +38,31 @@ export function usageWindowRowLabel(input: {
|
||||
return `${input.pinLabel}, ${summary}`;
|
||||
}
|
||||
|
||||
/** A user-requested refresh of one report. The previous report stays on screen throughout. */
|
||||
/** The outcome of a user-requested usage refresh. */
|
||||
export type UsageRefresh = "idle" | "pending" | "failed";
|
||||
|
||||
export function resolveUsageRefresh(mutation: {
|
||||
isPending: boolean;
|
||||
error: unknown;
|
||||
isError: boolean;
|
||||
}): UsageRefresh {
|
||||
if (mutation.isPending) return "pending";
|
||||
if (mutation.error) return "failed";
|
||||
if (mutation.isError) return "failed";
|
||||
return "idle";
|
||||
}
|
||||
|
||||
/** Keep quota readings after a failed refresh and attach the outcome to the readings it targeted. */
|
||||
export function markUsageRefreshFailure(
|
||||
current: UsageReportEntry[] | undefined,
|
||||
attempted: readonly UsageReportEntry[],
|
||||
): UsageReportEntry[] | undefined {
|
||||
const attemptedAt = new Map(attempted.map((entry) => [entry.id, entry.fetchedAt]));
|
||||
return current?.map((entry) =>
|
||||
attemptedAt.get(entry.id) === entry.fetchedAt && !entry.forecastStale
|
||||
? { ...entry, forecastStale: true }
|
||||
: entry,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* A host's report list with one report swapped for its refreshed copy, in place.
|
||||
* `null` means the daemon no longer knows the ID, so the report leaves the list.
|
||||
@@ -60,7 +73,9 @@ export function replaceReport(
|
||||
refreshed: UsageReportEntry | null,
|
||||
): UsageReportEntry[] {
|
||||
if (!refreshed) return reports.filter((report) => report.id !== reportId);
|
||||
return reports.map((report) => (report.id === reportId ? refreshed : report));
|
||||
return reports.map((report) =>
|
||||
report.id === reportId ? laterFetched(report, refreshed) : report,
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -68,7 +83,9 @@ export function replaceReport(
|
||||
* started, so a Refresh that lands while it streams is newer than what the request still delivers.
|
||||
*/
|
||||
function laterFetched(shown: UsageReportEntry, arriving: UsageReportEntry): UsageReportEntry {
|
||||
return Date.parse(shown.fetchedAt) > Date.parse(arriving.fetchedAt) ? shown : arriving;
|
||||
const shownAt = Date.parse(shown.fetchedAt);
|
||||
const arrivingAt = Date.parse(arriving.fetchedAt);
|
||||
return shownAt > arrivingAt || (shownAt === arrivingAt && shown.forecastStale) ? shown : arriving;
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -117,10 +134,11 @@ export function resolveUsageView(
|
||||
isConnected: boolean;
|
||||
supportsUsage: boolean;
|
||||
query: UsageQueryState | undefined;
|
||||
refreshState?: UsageRefresh;
|
||||
},
|
||||
t: TFunction = i18n.t,
|
||||
): UsageView {
|
||||
const { hostLabel, isConnected, supportsUsage, query } = input;
|
||||
const { hostLabel, isConnected, supportsUsage, query, refreshState } = input;
|
||||
if (!isConnected)
|
||||
return {
|
||||
kind: "unavailable",
|
||||
@@ -135,7 +153,12 @@ export function resolveUsageView(
|
||||
if (input.enabled === false)
|
||||
return { kind: "off", message: t("providerUsage.off", { host: hostLabel }) };
|
||||
if (query?.data) {
|
||||
return { kind: "ready", reports: query.data, isRefreshing: query.isFetching };
|
||||
return {
|
||||
kind: "ready",
|
||||
reports: query.data,
|
||||
isRefreshing: query.isFetching || refreshState === "pending",
|
||||
refreshFailed: refreshState === "failed",
|
||||
};
|
||||
}
|
||||
if (query?.error) {
|
||||
return {
|
||||
@@ -250,7 +273,12 @@ export function resolveUsageReport(entry: UsageReportEntry, t: TFunction) {
|
||||
// COMPAT(usageLoginErrors): added in v0.11.0, remove after 2027-04-05 once daemon floor >= v0.11.0.
|
||||
else messages.push(usageProblemText(entry.report, t));
|
||||
}
|
||||
const forecastAt =
|
||||
snapshot && !snapshot.retained && !entry.forecastStale
|
||||
? (snapshot.report.observedAt ?? snapshot.successfulAt)
|
||||
: null;
|
||||
return {
|
||||
forecastAt,
|
||||
windows: snapshot?.report.windows ?? [],
|
||||
balances: snapshot?.report.balances ?? [],
|
||||
details: snapshot?.report.details ?? [],
|
||||
|
||||
@@ -0,0 +1,45 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { usagePace } from "./pace";
|
||||
import type { UsageWindow } from "./types";
|
||||
|
||||
const day = "2026-11-20T";
|
||||
const reading = (time: string) => `${day}${time}:00.000Z`;
|
||||
const window: UsageWindow = {
|
||||
id: "five_hour",
|
||||
label: "Session",
|
||||
durationSeconds: 18_000,
|
||||
usedPct: 65,
|
||||
resetsAt: reading("15:00"),
|
||||
};
|
||||
|
||||
describe("usage pace", () => {
|
||||
it("projects the limit from the sample time and keeps it fixed between readings", () => {
|
||||
const sampledAt = reading("12:00");
|
||||
const estimate = { kind: "runsOut", at: `${day}13:04:36.923Z` };
|
||||
expect(usagePace(window, sampledAt, Date.parse(sampledAt))).toEqual(estimate);
|
||||
expect(usagePace(window, sampledAt, Date.parse(reading("12:30")))).toEqual(estimate);
|
||||
});
|
||||
|
||||
it("updates after a later reading and works with a remaining percentage", () => {
|
||||
const close = reading("13:30");
|
||||
const safe = reading("14:00");
|
||||
const forecast = usagePace(window, close, Date.parse(close));
|
||||
expect(forecast.kind).toBe("remaining");
|
||||
if (forecast.kind === "remaining") expect(forecast.remainingAtResetPct).toBeCloseTo(7.14);
|
||||
expect(
|
||||
usagePace({ ...window, usedPct: undefined, remainingPct: 35 }, safe, Date.parse(safe)),
|
||||
).toEqual({ kind: "remaining", remainingAtResetPct: 18.75 });
|
||||
});
|
||||
|
||||
it("only forecasts with timing and an active, usable reading", () => {
|
||||
const sampledAt = reading("12:00");
|
||||
const now = Date.parse(sampledAt);
|
||||
expect(usagePace({ ...window, durationSeconds: undefined }, sampledAt, now)).toEqual({
|
||||
kind: "unknown",
|
||||
});
|
||||
expect(usagePace(window, null, now)).toEqual({ kind: "unknown" });
|
||||
expect(usagePace(window, reading("10:01"), now)).toEqual({ kind: "unknown" });
|
||||
expect(usagePace(window, sampledAt, Date.parse(window.resetsAt!))).toEqual({ kind: "unknown" });
|
||||
expect(usagePace({ ...window, usedPct: 100 }, sampledAt, now)).toEqual({ kind: "reached" });
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,45 @@
|
||||
import { usedPercent } from "./model";
|
||||
import type { UsageWindow } from "./types";
|
||||
|
||||
type UsagePace =
|
||||
| { kind: "unknown" }
|
||||
| { kind: "reached" }
|
||||
| { kind: "runsOut"; at: string }
|
||||
| { kind: "remaining"; remainingAtResetPct: number };
|
||||
|
||||
/** Estimate from the window's average pace as of the reading. The clock only expires the estimate. */
|
||||
export function usagePace(window: UsageWindow, observedAt: string | null, now: number): UsagePace {
|
||||
if (observedAt === null) return { kind: "unknown" };
|
||||
const reset = Date.parse(window.resetsAt ?? "");
|
||||
if (reset <= now) return { kind: "unknown" };
|
||||
|
||||
const used = usedPercent(window);
|
||||
if (used != null && used >= 100) return { kind: "reached" };
|
||||
|
||||
const supplied = window.runsOutAt;
|
||||
const suppliedAt = Date.parse(supplied ?? "");
|
||||
if (supplied && Number.isFinite(suppliedAt) && (!Number.isFinite(reset) || suppliedAt < reset)) {
|
||||
return { kind: "runsOut", at: supplied };
|
||||
}
|
||||
|
||||
const duration = (window.durationSeconds ?? 0) * 1_000;
|
||||
const sampled = Date.parse(observedAt);
|
||||
const elapsed = sampled - (reset - duration);
|
||||
if (
|
||||
used == null ||
|
||||
!Number.isFinite(used) ||
|
||||
used < 0 ||
|
||||
!Number.isFinite(elapsed) ||
|
||||
sampled >= reset ||
|
||||
elapsed < Math.max(60_000, duration * 0.01)
|
||||
) {
|
||||
return { kind: "unknown" };
|
||||
}
|
||||
|
||||
const projectedAtReset = (used / elapsed) * duration;
|
||||
if (projectedAtReset > 100) {
|
||||
const runsOut = sampled + ((100 - used) / used) * elapsed;
|
||||
return { kind: "runsOut", at: new Date(runsOut).toISOString() };
|
||||
}
|
||||
return { kind: "remaining", remainingAtResetPct: 100 - projectedAtReset };
|
||||
}
|
||||
@@ -20,6 +20,7 @@ import { useSessionStore, type SessionState } from "@/stores/session-store";
|
||||
import { useUsageSetting } from "./setting";
|
||||
import { usageCopy } from "./copy";
|
||||
import {
|
||||
markUsageRefreshFailure,
|
||||
replaceReport,
|
||||
resolveAgentUsageView,
|
||||
resolveUsageRefresh,
|
||||
@@ -97,17 +98,32 @@ async function streamReports(input: {
|
||||
return settleReports(queryClient.getQueryData<UsageReportEntry[]>(queryKey), reports);
|
||||
}
|
||||
|
||||
function listReports(
|
||||
async function listReports(
|
||||
queryClient: QueryClient,
|
||||
serverId: string,
|
||||
forceRefresh = false,
|
||||
): Promise<UsageReportEntry[]> {
|
||||
return streamReports({
|
||||
queryClient,
|
||||
queryKey: usageReportsQueryKey(serverId),
|
||||
serverId,
|
||||
forceRefresh,
|
||||
});
|
||||
const queryKey = usageReportsQueryKey(serverId);
|
||||
const attempted = queryClient.getQueryData<UsageReportEntry[]>(queryKey) ?? [];
|
||||
try {
|
||||
return await streamReports({ queryClient, queryKey, serverId, forceRefresh });
|
||||
} catch (error) {
|
||||
recordUsageRefreshFailure(queryClient, queryKey, attempted);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
function recordUsageRefreshFailure(
|
||||
queryClient: QueryClient,
|
||||
queryKey: QueryKey,
|
||||
attempted: readonly UsageReportEntry[],
|
||||
): void {
|
||||
const { dataUpdatedAt } = queryClient.getQueryState(queryKey) ?? {};
|
||||
queryClient.setQueryData<UsageReportEntry[]>(
|
||||
queryKey,
|
||||
(current) => markUsageRefreshFailure(current, attempted),
|
||||
{ updatedAt: dataUpdatedAt },
|
||||
);
|
||||
}
|
||||
|
||||
async function getReport(
|
||||
@@ -158,9 +174,12 @@ export function useHostUsage(serverId: string): { view: UsageView; refresh: () =
|
||||
dataShape: "value",
|
||||
staleTimeMs: REPORTS_STALE_TIME_MS,
|
||||
});
|
||||
const refresh = useCallback(() => {
|
||||
void refreshReports(queryClient, serverId).catch(() => undefined);
|
||||
}, [queryClient, serverId]);
|
||||
const mutation = useMutation({
|
||||
mutationKey: [...usageReportsQueryKey(serverId), "refresh"],
|
||||
mutationFn: (hostId: string) => refreshReports(queryClient, hostId),
|
||||
});
|
||||
const { mutate, variables } = mutation;
|
||||
const refresh = useCallback(() => mutate(serverId), [mutate, serverId]);
|
||||
const { t } = useTranslation();
|
||||
const hostLabel = useHosts().find((host) => host.serverId === serverId)?.label ?? serverId;
|
||||
const view = resolveUsageView(
|
||||
@@ -170,6 +189,7 @@ export function useHostUsage(serverId: string): { view: UsageView; refresh: () =
|
||||
isConnected,
|
||||
supportsUsage: isSupported,
|
||||
query: toQueryState(query),
|
||||
refreshState: variables === serverId ? resolveUsageRefresh(mutation) : "idle",
|
||||
},
|
||||
t,
|
||||
);
|
||||
@@ -265,23 +285,26 @@ export function useUsageHosts(): UsageHost[] {
|
||||
*/
|
||||
export function useReportRefresh(
|
||||
serverId: string,
|
||||
reportId: string,
|
||||
entry: UsageReportEntry,
|
||||
agentId?: string,
|
||||
): { refresh: () => void; refreshState: UsageRefresh } {
|
||||
const queryClient = useQueryClient();
|
||||
const usageScopeKey = useAgentUsageScopeKey(serverId, agentId);
|
||||
const queryKey =
|
||||
agentId === undefined
|
||||
? usageReportsQueryKey(serverId)
|
||||
: agentUsageQueryKey(serverId, agentId, usageScopeKey);
|
||||
const mutation = useMutation({
|
||||
mutationFn: () => getReport(serverId, reportId, true, agentId),
|
||||
onSuccess: (report) => {
|
||||
queryClient.setQueryData<UsageReportEntry[]>(
|
||||
agentId === undefined
|
||||
? usageReportsQueryKey(serverId)
|
||||
: agentUsageQueryKey(serverId, agentId, usageScopeKey),
|
||||
(reports) => (reports ? replaceReport(reports, reportId, report) : reports),
|
||||
mutationKey: [...queryKey, "refresh", entry.id],
|
||||
mutationFn: (attempted: UsageReportEntry) => getReport(serverId, attempted.id, true, agentId),
|
||||
onSuccess: (report, attempted) => {
|
||||
queryClient.setQueryData<UsageReportEntry[]>(queryKey, (reports) =>
|
||||
reports ? replaceReport(reports, attempted.id, report) : reports,
|
||||
);
|
||||
},
|
||||
onError: (_error, attempted) => recordUsageRefreshFailure(queryClient, queryKey, [attempted]),
|
||||
});
|
||||
const { mutate } = mutation;
|
||||
const refresh = useCallback(() => mutate(), [mutate]);
|
||||
const refresh = useCallback(() => mutate(entry), [mutate, entry]);
|
||||
return { refresh, refreshState: resolveUsageRefresh(mutation) };
|
||||
}
|
||||
|
||||
@@ -3,24 +3,21 @@ import { StyleSheet } from "react-native-unistyles";
|
||||
|
||||
/**
|
||||
* The reset data of a window or balance: the countdown first, then the exact time. When the line
|
||||
* is too narrow the exact time gives way (truncates) and the countdown stays whole.
|
||||
* is too narrow the exact time truncates and the countdown wraps within its column.
|
||||
*/
|
||||
export function UsageResetLine({
|
||||
countdown,
|
||||
exactTime,
|
||||
atRisk = false,
|
||||
testID,
|
||||
}: {
|
||||
countdown: string | null;
|
||||
exactTime: string | null;
|
||||
/** The countdown is a runs-out warning rather than a reset. */
|
||||
atRisk?: boolean;
|
||||
testID?: string;
|
||||
}) {
|
||||
if (!countdown) return null;
|
||||
return (
|
||||
<View style={styles.line} testID={testID}>
|
||||
<Text style={atRisk ? styles.atRisk : styles.text}>{countdown}</Text>
|
||||
<Text style={[styles.text, styles.countdown]}>{countdown}</Text>
|
||||
{exactTime ? (
|
||||
<Text style={[styles.text, styles.exactTime]} numberOfLines={1} ellipsizeMode="tail">
|
||||
{`\u00a0·\u00a0${exactTime}`}
|
||||
@@ -31,18 +28,13 @@ export function UsageResetLine({
|
||||
}
|
||||
|
||||
const styles = StyleSheet.create((theme) => ({
|
||||
line: { flexDirection: "row", alignItems: "center" },
|
||||
line: { flexDirection: "row", alignItems: "baseline" },
|
||||
text: {
|
||||
flexShrink: 0,
|
||||
color: theme.colors.foregroundMuted,
|
||||
fontSize: theme.fontSize.sm,
|
||||
fontWeight: theme.fontWeight.normal,
|
||||
},
|
||||
atRisk: {
|
||||
flexShrink: 0,
|
||||
color: theme.colors.statusDanger,
|
||||
fontSize: theme.fontSize.sm,
|
||||
fontWeight: theme.fontWeight.normal,
|
||||
},
|
||||
exactTime: { flexShrink: 1 },
|
||||
countdown: { maxWidth: "100%" },
|
||||
exactTime: { flexShrink: 1, minWidth: 0 },
|
||||
}));
|
||||
|
||||
@@ -1,6 +1,12 @@
|
||||
import type { ProviderUsageTone, UsageReportEntry } from "@getpaseo/protocol/messages";
|
||||
import type {
|
||||
ProviderUsageTone,
|
||||
UsageReportEntry as WireUsageReportEntry,
|
||||
} from "@getpaseo/protocol/messages";
|
||||
|
||||
export type { UsageReportEntry };
|
||||
export interface UsageReportEntry extends WireUsageReportEntry {
|
||||
/** A refresh failed while this reading was cached. */
|
||||
forecastStale?: true;
|
||||
}
|
||||
export type UsageReport = UsageReportEntry["report"];
|
||||
export type UsageTone = ProviderUsageTone;
|
||||
export type AvailableUsageReport = Extract<UsageReport, { status: "available" }>;
|
||||
@@ -14,4 +20,4 @@ export type UsageView =
|
||||
| { kind: "unavailable"; message: string }
|
||||
| { kind: "loading" }
|
||||
| { kind: "error"; message: string }
|
||||
| { kind: "ready"; reports: UsageReportEntry[]; isRefreshing: boolean };
|
||||
| { kind: "ready"; reports: UsageReportEntry[]; isRefreshing: boolean; refreshFailed: boolean };
|
||||
|
||||
@@ -84,11 +84,18 @@ export function UsageBody({
|
||||
);
|
||||
}
|
||||
|
||||
if (view.reports.length === 0) {
|
||||
return <UsageMessage text={t("providerUsage.empty")} />;
|
||||
}
|
||||
|
||||
return <UsageList serverId={serverId} reports={view.reports} display={display} />;
|
||||
return (
|
||||
<View style={styles.reports}>
|
||||
{view.refreshFailed ? (
|
||||
<Alert size="sm" variant="error" title={t("providerUsage.refreshFailed")} />
|
||||
) : null}
|
||||
{view.reports.length === 0 ? (
|
||||
<UsageMessage text={t("providerUsage.empty")} />
|
||||
) : (
|
||||
<UsageList serverId={serverId} reports={view.reports} display={display} />
|
||||
)}
|
||||
</View>
|
||||
);
|
||||
}
|
||||
|
||||
export function UsageMessage({ text }: { text: string }) {
|
||||
@@ -100,6 +107,7 @@ export function UsageMessage({ text }: { text: string }) {
|
||||
}
|
||||
|
||||
const styles = StyleSheet.create((theme) => ({
|
||||
reports: { gap: theme.spacing[3] },
|
||||
emptyCard: {
|
||||
padding: theme.spacing[4],
|
||||
alignItems: "center",
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
import type { TFunction } from "i18next";
|
||||
import { Pin } from "lucide-react-native";
|
||||
import { useMemo } from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
@@ -6,6 +7,7 @@ import { StyleSheet, withUnistyles } from "react-native-unistyles";
|
||||
import { Tooltip, TooltipContent, TooltipTrigger } from "@/components/ui/tooltip";
|
||||
import {
|
||||
formatDisplayPct,
|
||||
formatPct,
|
||||
formatProviderUsageLabel,
|
||||
formatResetLabel,
|
||||
formatResetTime,
|
||||
@@ -13,9 +15,9 @@ import {
|
||||
} from "./format";
|
||||
import { UsageMeter } from "./meter";
|
||||
import { displayPercent, usageWindowRowLabel } from "./model";
|
||||
import { usagePace } from "./pace";
|
||||
import { UsageResetLine } from "./reset-line";
|
||||
import type { UsageDisplayAs } from "./preferences";
|
||||
import { windowTone } from "./tone";
|
||||
import type { UsageTone, UsageWindow } from "./types";
|
||||
import { useRelativeTimeTick } from "./use-relative-time-tick";
|
||||
|
||||
@@ -28,8 +30,10 @@ export function UsageWindowBar({
|
||||
pinLabel,
|
||||
pinTestID,
|
||||
retained = false,
|
||||
forecastAt,
|
||||
}: {
|
||||
retained?: boolean;
|
||||
forecastAt: string | null;
|
||||
window: UsageWindow;
|
||||
displayAs: UsageDisplayAs;
|
||||
/** Whether the row pins the window to the sidebar. When false the row is a plain bar. */
|
||||
@@ -42,19 +46,11 @@ export function UsageWindowBar({
|
||||
}) {
|
||||
const { t, i18n } = useTranslation();
|
||||
const shownPct = displayPercent(window, displayAs);
|
||||
const tone = windowTone(window);
|
||||
|
||||
const now = useRelativeTimeTick({ enabled: window.runsOutAt != null || window.resetsAt != null });
|
||||
const isAtRisk =
|
||||
window.runsOutAt != null &&
|
||||
window.shortfallPct != null &&
|
||||
(!retained || Date.parse(window.runsOutAt) > now);
|
||||
const countdown = isAtRisk
|
||||
? formatRunsOutLabel(window.runsOutAt, now, t)
|
||||
: formatResetLabel(window.resetsAt, retained, now, t);
|
||||
// The exact time belongs to the reset; beside a runs-out warning it would read as the moment
|
||||
// the quota runs out.
|
||||
const exactTime = isAtRisk ? null : formatResetTime(window.resetsAt, now, t);
|
||||
const pace = usagePace(window, forecastAt, now);
|
||||
const forecast = formatPace(pace, now, t);
|
||||
const countdown = formatResetLabel(window.resetsAt, retained, now, t);
|
||||
const exactTime = formatResetTime(window.resetsAt, now, t);
|
||||
|
||||
const value =
|
||||
shownPct != null ? formatDisplayPct(shownPct, displayAs, i18n.resolvedLanguage, t) : "—";
|
||||
@@ -64,9 +60,8 @@ export function UsageWindowBar({
|
||||
value,
|
||||
countdown,
|
||||
exactTime,
|
||||
isAtRisk,
|
||||
forecast,
|
||||
percent: shownPct ?? 0,
|
||||
tone,
|
||||
pinned,
|
||||
};
|
||||
|
||||
@@ -86,7 +81,7 @@ export function UsageWindowBar({
|
||||
accessibilityLabel={usageWindowRowLabel({
|
||||
pinLabel,
|
||||
value,
|
||||
trailing: [countdown, exactTime].filter(Boolean).join(" · "),
|
||||
trailing: [countdown, exactTime, forecast?.label].filter(Boolean).join(" · "),
|
||||
})}
|
||||
accessibilityState={accessibilityState}
|
||||
aria-checked={pinned}
|
||||
@@ -103,9 +98,8 @@ function WindowRowContent({
|
||||
value,
|
||||
countdown,
|
||||
exactTime,
|
||||
isAtRisk,
|
||||
forecast,
|
||||
percent,
|
||||
tone,
|
||||
pinnable,
|
||||
pinned,
|
||||
}: {
|
||||
@@ -113,9 +107,8 @@ function WindowRowContent({
|
||||
value: string;
|
||||
countdown: string | null;
|
||||
exactTime: string | null;
|
||||
isAtRisk: boolean;
|
||||
forecast: PaceLabel | null;
|
||||
percent: number;
|
||||
tone: UsageTone;
|
||||
pinnable: boolean;
|
||||
pinned: boolean;
|
||||
}) {
|
||||
@@ -130,12 +123,51 @@ function WindowRowContent({
|
||||
</Text>
|
||||
{pinnable ? <UsagePinGlyph pinned={pinned} /> : null}
|
||||
</View>
|
||||
<UsageMeter percent={percent} tone={tone} />
|
||||
<UsageResetLine countdown={countdown} exactTime={exactTime} atRisk={isAtRisk} />
|
||||
<UsageMeter percent={percent} tone={forecast?.tone ?? "default"} />
|
||||
{countdown || forecast ? (
|
||||
<View style={styles.timingRow}>
|
||||
<View style={styles.resetTiming}>
|
||||
<UsageResetLine countdown={countdown} exactTime={exactTime} />
|
||||
</View>
|
||||
{forecast ? <Text style={styles.forecast(forecast.tone)}>{forecast.label}</Text> : null}
|
||||
</View>
|
||||
) : null}
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
interface PaceLabel {
|
||||
label: string;
|
||||
tone: UsageTone;
|
||||
}
|
||||
|
||||
function formatPace(
|
||||
pace: ReturnType<typeof usagePace>,
|
||||
now: number,
|
||||
t: TFunction,
|
||||
): PaceLabel | null {
|
||||
switch (pace.kind) {
|
||||
case "reached":
|
||||
return { label: t("providerUsage.timing.limitReached"), tone: "danger" };
|
||||
case "runsOut": {
|
||||
const label =
|
||||
Date.parse(pace.at) <= now
|
||||
? t("providerUsage.timing.mayHaveRunOut")
|
||||
: formatRunsOutLabel(pace.at, now, t);
|
||||
return label ? { label, tone: "danger" } : null;
|
||||
}
|
||||
case "remaining":
|
||||
return {
|
||||
label: t("providerUsage.timing.projectedLeftAtReset", {
|
||||
percentage: formatPct(pace.remainingAtResetPct),
|
||||
}),
|
||||
tone: pace.remainingAtResetPct <= 10 ? "warning" : "default",
|
||||
};
|
||||
case "unknown":
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
const ThemedPin = withUnistyles(Pin);
|
||||
|
||||
function UsagePinGlyph({ pinned }: { pinned: boolean }) {
|
||||
@@ -167,6 +199,23 @@ function UsagePinGlyph({ pinned }: { pinned: boolean }) {
|
||||
}
|
||||
|
||||
const styles = StyleSheet.create((theme) => ({
|
||||
timingRow: {
|
||||
flexDirection: "row",
|
||||
alignItems: "flex-start",
|
||||
gap: theme.spacing[2],
|
||||
},
|
||||
resetTiming: { flex: 1, minWidth: 0 },
|
||||
forecast: (tone: UsageTone) => ({
|
||||
color: {
|
||||
danger: theme.colors.statusDanger,
|
||||
warning: theme.colors.statusWarning,
|
||||
default: theme.colors.foregroundMuted,
|
||||
ok: theme.colors.statusSuccess,
|
||||
}[tone],
|
||||
fontSize: theme.fontSize.sm,
|
||||
maxWidth: "50%",
|
||||
textAlign: "right",
|
||||
}),
|
||||
row: { gap: 3, paddingVertical: theme.spacing[1.5] },
|
||||
pin: { width: 12, alignItems: "center" },
|
||||
tooltipText: { color: theme.colors.popoverForeground, fontSize: theme.fontSize.sm },
|
||||
|
||||
@@ -14,6 +14,7 @@ import { buildWorkspaceTabPersistenceKey } from "@/workspace-tabs/model";
|
||||
import { archiveWorkspaceWithUndo, supportsWorkspaceArchiveUndo } from "@/workspace/archive-undo";
|
||||
import {
|
||||
archiveWorkspaceOptimistically,
|
||||
runWorkspaceArchiveAttempt,
|
||||
type WorkspaceArchiveTarget,
|
||||
} from "@/workspace/workspace-archive";
|
||||
|
||||
@@ -56,7 +57,6 @@ export function useWorkspaceArchive(input: ArchiveWorkspaceInput): WorkspaceArch
|
||||
} = input;
|
||||
const { t } = useTranslation();
|
||||
const toast = useToast();
|
||||
const confirmingRef = useRef(false);
|
||||
// The archive starts after the host answers and you confirm. By then you may have opened another
|
||||
// workspace, so the redirect reads the selection from the latest render.
|
||||
const onArchiveStartedRef = useRef(onArchiveStarted);
|
||||
@@ -119,26 +119,12 @@ export function useWorkspaceArchive(input: ArchiveWorkspaceInput): WorkspaceArch
|
||||
}, [diffStat, name, serverId, t, toast, warningLabels, workspaceDirectory]);
|
||||
|
||||
const archive = useCallback(() => {
|
||||
// A second press while the host answers or the warning is open would ask twice.
|
||||
if (confirmingRef.current) {
|
||||
return;
|
||||
}
|
||||
void (async () => {
|
||||
if (workspaceKind === "worktree") {
|
||||
confirmingRef.current = true;
|
||||
let confirmed: boolean;
|
||||
try {
|
||||
confirmed = await confirmWorktreeArchive();
|
||||
} finally {
|
||||
confirmingRef.current = false;
|
||||
}
|
||||
if (!confirmed) {
|
||||
return;
|
||||
}
|
||||
}
|
||||
await archiveWorkspaceRecord();
|
||||
})();
|
||||
}, [archiveWorkspaceRecord, confirmWorktreeArchive, workspaceKind]);
|
||||
void runWorkspaceArchiveAttempt({
|
||||
workspace: { serverId, workspaceId },
|
||||
confirm: workspaceKind === "worktree" ? confirmWorktreeArchive : undefined,
|
||||
archive: archiveWorkspaceRecord,
|
||||
});
|
||||
}, [archiveWorkspaceRecord, confirmWorktreeArchive, serverId, workspaceId, workspaceKind]);
|
||||
|
||||
return {
|
||||
archive,
|
||||
|
||||
@@ -17,6 +17,30 @@ export interface WorkspaceArchiveTarget {
|
||||
workspaceId: string;
|
||||
}
|
||||
|
||||
const pendingArchiveAttempts = new Set<string>();
|
||||
|
||||
/** Checks and starts one archive at a time for a workspace. */
|
||||
export async function runWorkspaceArchiveAttempt(input: {
|
||||
workspace: WorkspaceArchiveTarget;
|
||||
confirm?: () => Promise<boolean>;
|
||||
archive: () => Promise<void>;
|
||||
}): Promise<void> {
|
||||
const { serverId, workspaceId } = input.workspace;
|
||||
const key = JSON.stringify([serverId, workspaceId]);
|
||||
if (pendingArchiveAttempts.has(key)) return;
|
||||
|
||||
pendingArchiveAttempts.add(key);
|
||||
try {
|
||||
if (input.confirm && !(await input.confirm())) return;
|
||||
if (!isWorkspaceListed(input.workspace)) return;
|
||||
// Archive hides the row synchronously. Undo can restore it and start a new
|
||||
// archive while the previous daemon request is still settling.
|
||||
return input.archive();
|
||||
} finally {
|
||||
pendingArchiveAttempts.delete(key);
|
||||
}
|
||||
}
|
||||
|
||||
interface WorkspaceArchiveClient {
|
||||
archiveWorkspace: (workspaceId: string) => Promise<{ error: string | null; canceled?: boolean }>;
|
||||
}
|
||||
|
||||
@@ -96,12 +96,12 @@ test.each([
|
||||
])(
|
||||
"duration %s owns the window's identity and both names",
|
||||
(durationSeconds, id, label, shortLabel) => {
|
||||
expect(
|
||||
windowFromReportedDuration({
|
||||
durationSeconds: durationSeconds as number | null,
|
||||
unknown: { id: "primary", label: "Primary limit", shortLabel: "" },
|
||||
utilizationPct: 11,
|
||||
}),
|
||||
).toMatchObject({ id, label, shortLabel, usedPct: 11 });
|
||||
const window = windowFromReportedDuration({
|
||||
durationSeconds: durationSeconds as number | null,
|
||||
unknown: { id: "primary", label: "Primary limit", shortLabel: "" },
|
||||
utilizationPct: 11,
|
||||
});
|
||||
expect(window).toMatchObject({ id, label, shortLabel, usedPct: 11 });
|
||||
expect(window.durationSeconds).toBe(durationSeconds ?? undefined);
|
||||
},
|
||||
);
|
||||
|
||||
@@ -16,6 +16,8 @@ export interface UsageWindow {
|
||||
usedPct?: number | null;
|
||||
remainingPct?: number | null;
|
||||
resetsAt?: string | null;
|
||||
/** Full length of the quota window when known. */
|
||||
durationSeconds?: number;
|
||||
runsOutAt?: string | null;
|
||||
shortfallPct?: number | null;
|
||||
tone?: "default" | "ok" | "warning" | "danger";
|
||||
@@ -48,6 +50,8 @@ export type UsageReport =
|
||||
| {
|
||||
status: "available";
|
||||
planLabel?: string;
|
||||
/** When the provider measured the quota, if the report returns a previous reading. */
|
||||
observedAt?: string;
|
||||
windows: UsageWindow[];
|
||||
balances?: UsageBalance[];
|
||||
details?: UsageDetail[];
|
||||
@@ -96,6 +100,7 @@ export function windowFromUsedPct(input: {
|
||||
shortLabel?: string;
|
||||
summary?: boolean;
|
||||
utilizationPct: number | null | undefined;
|
||||
durationSeconds?: number;
|
||||
resetsAt?: string | null;
|
||||
tone?: UsageWindow["tone"];
|
||||
}): UsageWindow {
|
||||
@@ -107,6 +112,7 @@ export function windowFromUsedPct(input: {
|
||||
remainingPct: usedPct === null ? null : Math.max(0, 100 - usedPct),
|
||||
resetsAt: input.resetsAt ?? null,
|
||||
};
|
||||
if (input.durationSeconds !== undefined) window.durationSeconds = input.durationSeconds;
|
||||
if (input.shortLabel !== undefined) window.shortLabel = input.shortLabel;
|
||||
if (input.summary) window.summary = true;
|
||||
if (input.tone) window.tone = input.tone;
|
||||
@@ -129,11 +135,10 @@ export function windowFromReportedDuration(input: {
|
||||
summary?: boolean;
|
||||
tone?: UsageWindow["tone"];
|
||||
}): UsageWindow {
|
||||
const duration = input.durationSeconds;
|
||||
const name =
|
||||
duration !== null && Number.isFinite(duration) && duration > 0
|
||||
? durationWindowName(duration)
|
||||
: input.unknown;
|
||||
const reported = input.durationSeconds;
|
||||
const duration =
|
||||
reported !== null && Number.isFinite(reported) && reported > 0 ? reported : undefined;
|
||||
const name = duration === undefined ? input.unknown : durationWindowName(duration);
|
||||
const scope = input.scope;
|
||||
return windowFromUsedPct({
|
||||
id: scope ? `${scope.id}:${name.id}` : name.id,
|
||||
@@ -142,6 +147,7 @@ export function windowFromReportedDuration(input: {
|
||||
? `${scope.label}${name.shortLabel ? ` ${name.shortLabel}` : ""}`
|
||||
: name.shortLabel,
|
||||
utilizationPct: input.utilizationPct,
|
||||
durationSeconds: duration,
|
||||
resetsAt: input.resetsAt,
|
||||
summary: input.summary,
|
||||
tone: input.tone,
|
||||
|
||||
@@ -6992,6 +6992,7 @@ export const ProviderUsageWindowSchema = z.object({
|
||||
usedPct: z.number().nullable().optional(),
|
||||
remainingPct: z.number().nullable().optional(),
|
||||
resetsAt: z.string().nullable().optional(),
|
||||
durationSeconds: z.number().optional(),
|
||||
runsOutAt: z.string().nullable().optional(),
|
||||
shortfallPct: z.number().nullable().optional(),
|
||||
tone: ProviderUsageToneSchema.optional(),
|
||||
@@ -7054,6 +7055,7 @@ export const UsageProblemSchema = z.discriminatedUnion("kind", [
|
||||
const AvailableUsageReportSchema = z.object({
|
||||
status: z.literal("available"),
|
||||
planLabel: z.string().optional(),
|
||||
observedAt: z.string().optional(),
|
||||
windows: z.array(ProviderUsageWindowSchema),
|
||||
balances: z.array(ProviderUsageBalanceSchema).optional(),
|
||||
details: z.array(ProviderUsageDetailSchema).optional(),
|
||||
|
||||
@@ -1,138 +0,0 @@
|
||||
import copy from "../src/i18n/resources/en.json" with { type: "json" };
|
||||
import { expect, test, waitForHydration, type Page } from "./fixtures";
|
||||
|
||||
async function openHub(page: Page, width = 1024) {
|
||||
await page.setViewportSize({ width, height: 900 });
|
||||
await page.goto("/hub");
|
||||
await expect(page.getByRole("heading", { name: "Paseo Hub", level: 1 })).toBeVisible();
|
||||
}
|
||||
|
||||
async function tabIntoNextPreview(page: Page) {
|
||||
await waitForHydration(page);
|
||||
await page.getByRole("tab", { name: /^Slack/ }).focus();
|
||||
await page.keyboard.press("ArrowRight");
|
||||
await page.keyboard.press("Tab");
|
||||
}
|
||||
|
||||
async function readPreviewOnFocus(page: Page) {
|
||||
return page.getByRole("tabpanel").evaluateHandle((panel) => {
|
||||
const atFocus = { label: "" };
|
||||
panel.addEventListener(
|
||||
"focus",
|
||||
() => {
|
||||
atFocus.label = panel.querySelector('[role="img"]')?.getAttribute("aria-label") ?? "";
|
||||
},
|
||||
{ once: true },
|
||||
);
|
||||
return atFocus;
|
||||
});
|
||||
}
|
||||
|
||||
async function useLargerText(page: Page) {
|
||||
await page.addStyleTag({ content: "html { font-size: 125%; }" });
|
||||
}
|
||||
|
||||
async function expectSourceLabelFits(page: Page, name: string, text = name) {
|
||||
const label = page.getByRole("tab", { name }).getByText(text, { exact: true });
|
||||
await expect(label).toBeVisible();
|
||||
expect(await label.evaluate((element) => element.scrollWidth <= element.clientWidth)).toBe(true);
|
||||
}
|
||||
|
||||
async function expectPreviewRowsFit(page: Page, source: string, ...rows: string[]) {
|
||||
const name = new RegExp(`^${source}`);
|
||||
await page.getByRole("tab", { name }).click();
|
||||
const preview = page.getByRole("tabpanel", { name });
|
||||
await preview.scrollIntoViewIfNeeded();
|
||||
for (const row of rows) {
|
||||
const text = preview.getByText(row, { exact: true }).filter({ visible: true });
|
||||
await expect(text).toBeInViewport({ ratio: 1 });
|
||||
expect(await text.evaluate((element) => element.scrollWidth <= element.clientWidth)).toBe(true);
|
||||
}
|
||||
}
|
||||
|
||||
async function focusProSeatHelp(page: Page) {
|
||||
const pro = page
|
||||
.getByRole("article")
|
||||
.filter({ has: page.getByRole("heading", { name: "Pro", exact: true }) });
|
||||
const help = pro.getByLabel(/^Seats are Hub members/).locator("..");
|
||||
await help.scrollIntoViewIfNeeded();
|
||||
await help.focus();
|
||||
return pro.getByRole("tooltip");
|
||||
}
|
||||
|
||||
test("Hub fits a viewport narrower than its page frame", async ({ page }) => {
|
||||
await openHub(page);
|
||||
const { contentWidth, viewportWidth } = await page.evaluate(() => ({
|
||||
contentWidth: document.documentElement.scrollWidth,
|
||||
viewportWidth: document.documentElement.clientWidth,
|
||||
}));
|
||||
expect(contentWidth).toBeLessThanOrEqual(viewportWidth);
|
||||
});
|
||||
|
||||
for (const width of [320, 768, 1024]) {
|
||||
test(`the complete Pro seat explanation is visible on keyboard focus at ${width}px`, async ({
|
||||
page,
|
||||
}) => {
|
||||
test.skip(Boolean(process.env.WEBSITE_TEST_URL), "Requires the Hub plans fixture");
|
||||
await openHub(page, width);
|
||||
const tooltip = await focusProSeatHelp(page);
|
||||
await expect(tooltip).toContainText("do not count as seats");
|
||||
await expect(tooltip).toBeInViewport({ ratio: 1 });
|
||||
});
|
||||
}
|
||||
|
||||
test("the Slack starter forwards the mention and declares a thread reply", async ({ page }) => {
|
||||
await openHub(page);
|
||||
const starter = page.locator("pre").filter({ hasText: "name: slack-help" });
|
||||
await expect(starter).toContainText("${{ paseo.prompt }}");
|
||||
await expect(starter).toContainText("hub.reply");
|
||||
await expect(starter).toContainText("slack.reply:");
|
||||
});
|
||||
|
||||
test("keyboard focus enters the selected preview with its current content", async ({ page }) => {
|
||||
await openHub(page);
|
||||
const atFocus = await readPreviewOnFocus(page);
|
||||
await tabIntoNextPreview(page);
|
||||
await expect(page.getByRole("tabpanel", { name: /^GitHub/ })).toBeFocused();
|
||||
expect((await atFocus.jsonValue()).label).toMatch(/^GitHub issue/);
|
||||
});
|
||||
|
||||
test("source names fit on a narrow phone", async ({ page }) => {
|
||||
await openHub(page, 320);
|
||||
await expectSourceLabelFits(page, "Schedules");
|
||||
await expectSourceLabelFits(page, "Webhooks");
|
||||
});
|
||||
|
||||
test("source names remain readable with larger text on a phone", async ({ page }) => {
|
||||
await openHub(page, 375);
|
||||
await useLargerText(page);
|
||||
for (const name of ["GitHub", "Discord", "Schedules", "Webhooks"]) {
|
||||
await expectSourceLabelFits(page, name);
|
||||
}
|
||||
});
|
||||
|
||||
test("desktop source descriptions fit with larger text", async ({ page }) => {
|
||||
await openHub(page, 1280);
|
||||
await useLargerText(page);
|
||||
for (const { name, description } of Object.values(copy.hub.sources)) {
|
||||
await expectSourceLabelFits(page, name, description);
|
||||
}
|
||||
});
|
||||
|
||||
test("Hub previews have room for their final rows with larger text", async ({ page }) => {
|
||||
await page.emulateMedia({ reducedMotion: "reduce" });
|
||||
await openHub(page, 1280);
|
||||
await useLargerText(page);
|
||||
await waitForHydration(page);
|
||||
await expectPreviewRowsFit(page, "GitHub", "Open in Paseo");
|
||||
await expectPreviewRowsFit(page, "Discord", "Message #engineering");
|
||||
});
|
||||
|
||||
test("preview results fit on a narrow phone with larger text", async ({ page }) => {
|
||||
await page.emulateMedia({ reducedMotion: "reduce" });
|
||||
await openHub(page, 320);
|
||||
await useLargerText(page);
|
||||
await waitForHydration(page);
|
||||
await expectPreviewRowsFit(page, "Discord", "Fix stale worktrees", "getpaseo/paseo#2825");
|
||||
await expectPreviewRowsFit(page, "Schedules", "tests passed");
|
||||
});
|
||||
@@ -9,12 +9,6 @@ async function chooseLanguage(page: Page, language: string) {
|
||||
await page.getByRole("menuitemradio", { name: language }).click();
|
||||
}
|
||||
|
||||
async function selectHubSourceTab(page: Page, name: string | RegExp) {
|
||||
const tab = page.getByRole("tab", { name });
|
||||
await tab.click();
|
||||
await expect(tab).toHaveAttribute("aria-selected", "true");
|
||||
}
|
||||
|
||||
async function withPageScriptsHeld(page: Page, run: (release: () => void) => Promise<void>) {
|
||||
let releaseScripts!: () => void;
|
||||
const scriptsReleased = new Promise<void>((resolve) => {
|
||||
@@ -115,74 +109,6 @@ test("switches language on the same page, keeping the query and then every link"
|
||||
await expect(page.locator("html")).toHaveAttribute("lang", "en");
|
||||
});
|
||||
|
||||
for (const {
|
||||
locale,
|
||||
prefix,
|
||||
linearTab,
|
||||
linearDocsLink,
|
||||
linearTriggerHeading,
|
||||
linearAppLink,
|
||||
linearAppHeading,
|
||||
webhooksTab,
|
||||
webhooksDocsLink,
|
||||
webhooksHeading,
|
||||
} of [
|
||||
{
|
||||
locale: "English",
|
||||
prefix: "",
|
||||
linearTab: /^Linear\b/,
|
||||
linearDocsLink: "Read Linear docs",
|
||||
linearTriggerHeading: "Linear triggers",
|
||||
linearAppLink: "Linear app",
|
||||
linearAppHeading: "Linear for Hub",
|
||||
webhooksTab: /^Webhooks\b/,
|
||||
webhooksDocsLink: "Read Webhooks docs",
|
||||
webhooksHeading: "Inbound webhooks",
|
||||
},
|
||||
{
|
||||
locale: "Chinese",
|
||||
prefix: "/zh-CN",
|
||||
linearTab: /^Linear\b/,
|
||||
linearDocsLink: "阅读 Linear 文档",
|
||||
linearTriggerHeading: "Linear 触发器",
|
||||
linearAppLink: "Linear 应用",
|
||||
linearAppHeading: "为 Hub 配置 Linear",
|
||||
webhooksTab: /^Webhook\b/,
|
||||
webhooksDocsLink: "阅读 Webhook 文档",
|
||||
webhooksHeading: "入站 webhook",
|
||||
},
|
||||
]) {
|
||||
test(`navigates from the ${locale} Hub showcase to Linear and Webhook docs`, async ({ page }) => {
|
||||
await page.goto(`${prefix}/hub`);
|
||||
|
||||
await test.step("opens Linear trigger docs and Linear app setup", async () => {
|
||||
await selectHubSourceTab(page, linearTab);
|
||||
const triggerLink = page.getByRole("link", { name: linearDocsLink, exact: true });
|
||||
await expect(triggerLink).toHaveAttribute("href", `${prefix}/docs/hub/triggers/linear`);
|
||||
await triggerLink.click();
|
||||
await expect(
|
||||
page.getByRole("heading", { name: linearTriggerHeading, level: 1 }),
|
||||
).toBeVisible();
|
||||
await expect(page.getByText("linear.comment_created", { exact: true }).first()).toBeVisible();
|
||||
|
||||
const appLink = page.locator("main").getByRole("link", { name: linearAppLink, exact: true });
|
||||
await expect(appLink).toHaveAttribute("href", `${prefix}/docs/hub/self-hosting/linear-app`);
|
||||
await appLink.click();
|
||||
await expect(page.getByRole("heading", { name: linearAppHeading, level: 1 })).toBeVisible();
|
||||
});
|
||||
|
||||
await test.step("opens Webhooks trigger docs from the Hub showcase", async () => {
|
||||
await page.goto(`${prefix}/hub`);
|
||||
await selectHubSourceTab(page, webhooksTab);
|
||||
const webhookLink = page.getByRole("link", { name: webhooksDocsLink, exact: true });
|
||||
await expect(webhookLink).toHaveAttribute("href", `${prefix}/docs/hub/triggers/webhooks`);
|
||||
await webhookLink.click();
|
||||
await expect(page.getByRole("heading", { name: webhooksHeading, level: 1 })).toBeVisible();
|
||||
await expect(page.getByText("webhook.received", { exact: true }).first()).toBeVisible();
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
test("shows the language as an abbreviation and lists every language by name", async ({ page }) => {
|
||||
await page.goto("/docs/cli#running-agents");
|
||||
const button = languageButton(page);
|
||||
|
||||
@@ -149,7 +149,7 @@ test("the opening scene waits until most of the mockup is on screen", async ({ p
|
||||
});
|
||||
|
||||
test("the opening scene starts in a window shorter than most of the mockup", async ({ page }) => {
|
||||
await openHomepage(page, { width: 1400, height: 320 });
|
||||
await openHomepage(page, { width: 1400, height: 400 });
|
||||
const mockup = page.getByRole("img", { name: desktopName, exact: true });
|
||||
const request = mockup.getByText("Fix the issues labeled ready, one worktree each.");
|
||||
await mockup.scrollIntoViewIfNeeded();
|
||||
|
||||
@@ -586,7 +586,6 @@ test.describe("registry fixture layout", () => {
|
||||
] as const) {
|
||||
await page.setViewportSize({ width, height: 720 });
|
||||
await page.goto("/plugins/omercnet/dracula");
|
||||
await expectPageWithinViewport(page);
|
||||
const three = page.getByRole("link", { name: /^Dracula (screenshot|video) \d$/ });
|
||||
const shares = await three.evaluateAll(visibleShares);
|
||||
expect(shares.map((share) => (share > 0.1 && share < 0.5 ? "peeks" : share))).toEqual(
|
||||
|
||||
@@ -1,6 +1,5 @@
|
||||
import { createServer } from "node:http";
|
||||
import registry from "./registry.fixture.json" with { type: "json" };
|
||||
import hubPlans from "../src/hub-plans.fixture.json" with { type: "json" };
|
||||
|
||||
import securityPlugin from "./overview.fixture.json" with { type: "json" };
|
||||
|
||||
@@ -14,10 +13,6 @@ securityPlugin.readme +=
|
||||
// Serve the published registry contract so SSR and browser navigation use the same data.
|
||||
createServer((request, response) => {
|
||||
response.setHeader("Content-Type", "application/json");
|
||||
if (request.url === "/hub-plans") {
|
||||
response.end(JSON.stringify(hubPlans));
|
||||
return;
|
||||
}
|
||||
if (request.url === "/index.json") {
|
||||
response.end(JSON.stringify(registry));
|
||||
return;
|
||||
|
||||
@@ -15,7 +15,6 @@
|
||||
"@cloudflare/vite-plugin": "^1.29.1",
|
||||
"@cloudflare/workers-types": "^4.20260317.1",
|
||||
"@fontsource-variable/geist": "^5.3.0",
|
||||
"@fontsource-variable/plus-jakarta-sans": "^5.3.0",
|
||||
"@getpaseo/protocol": "*",
|
||||
"@tanstack/react-router": "^1.170.16",
|
||||
"@tanstack/react-start": "^1.168.26",
|
||||
|
||||
@@ -31,7 +31,6 @@ export default defineConfig({
|
||||
),
|
||||
CLOUDFLARE_INCLUDE_PROCESS_ENV: "true",
|
||||
PLUGINS_REGISTRY_URL: "http://127.0.0.1:8188",
|
||||
VITE_HUB_PLANS_URL: "http://127.0.0.1:8188/hub-plans",
|
||||
},
|
||||
},
|
||||
],
|
||||
|
||||
@@ -1,10 +1,8 @@
|
||||
import { useLoaderData } from "@tanstack/react-router";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { LandingPage } from "~/components/landing-page";
|
||||
import { type AgentPageSlug, getAgentPage } from "~/data/agent-pages";
|
||||
import { getTranslator, routeLocale } from "~/i18n";
|
||||
import { pageMeta } from "~/meta";
|
||||
import { getPluginCount } from "~/plugins";
|
||||
|
||||
export function agentRouteOptions(slug: AgentPageSlug) {
|
||||
return {
|
||||
@@ -18,18 +16,10 @@ export function agentRouteOptions(slug: AgentPageSlug) {
|
||||
locale,
|
||||
});
|
||||
},
|
||||
loader: async () => ({ pluginCount: await getPluginCount() }),
|
||||
component: function AgentLandingPage() {
|
||||
const { t } = useTranslation();
|
||||
const data = useLoaderData({ strict: false }) as { pluginCount?: number | null } | undefined;
|
||||
const page = getAgentPage(slug, t);
|
||||
return (
|
||||
<LandingPage
|
||||
title={page.title}
|
||||
subtitle={page.subtitle}
|
||||
pluginCount={data?.pluginCount ?? null}
|
||||
/>
|
||||
);
|
||||
return <LandingPage title={page.title} subtitle={page.subtitle} />;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
@@ -45,20 +45,6 @@ export function SlackIcon(props: React.SVGProps<SVGSVGElement>) {
|
||||
);
|
||||
}
|
||||
|
||||
export function LinearIcon(props: React.SVGProps<SVGSVGElement>) {
|
||||
return (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
viewBox="0 0 24 24"
|
||||
fill="currentColor"
|
||||
aria-hidden="true"
|
||||
{...props}
|
||||
>
|
||||
<path d="M2.886 4.18A11.982 11.982 0 0 1 11.99 0C18.624 0 24 5.376 24 12.009c0 3.64-1.62 6.903-4.18 9.105L2.887 4.18ZM1.817 5.626l16.556 16.556c-.524.33-1.075.62-1.65.866L.951 7.277c.247-.575.537-1.126.866-1.65ZM.322 9.163l14.515 14.515c-.71.172-1.443.282-2.195.322L0 11.358a12 12 0 0 1 .322-2.195Zm-.17 4.862 9.823 9.824a12.02 12.02 0 0 1-9.824-9.824Z" />
|
||||
</svg>
|
||||
);
|
||||
}
|
||||
|
||||
export function OpenCollectiveIcon(props: React.SVGProps<SVGSVGElement>) {
|
||||
return (
|
||||
<svg
|
||||
|
||||
@@ -2,25 +2,15 @@ import type { ReactNode } from "react";
|
||||
|
||||
export function FAQItem({ question, children }: { question: string; children: ReactNode }) {
|
||||
return (
|
||||
<details className="group py-5 first:pt-4 last:pb-4">
|
||||
<summary className="flex cursor-pointer list-none items-baseline justify-between gap-6 text-[15px] font-medium text-white/90 transition-colors hover:text-white">
|
||||
<span>{question}</span>
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="shrink-0 font-mono text-base leading-none text-white/40 transition-colors group-hover:text-white/70 group-open:hidden"
|
||||
>
|
||||
+
|
||||
</span>
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="hidden shrink-0 font-mono text-base leading-none text-accent-text group-open:inline"
|
||||
>
|
||||
<details className="group">
|
||||
<summary className="font-medium text-sm cursor-pointer list-none grid grid-cols-[1.25rem_1fr] items-baseline">
|
||||
<span className="font-mono text-lg leading-none text-white/40 group-open:hidden">+</span>
|
||||
<span className="font-mono text-lg leading-none text-white/40 hidden group-open:inline">
|
||||
−
|
||||
</span>
|
||||
{question}
|
||||
</summary>
|
||||
<div className="prose mt-3 max-w-2xl space-y-2.5 text-sm leading-relaxed text-muted-foreground">
|
||||
{children}
|
||||
</div>
|
||||
<div className="text-sm text-muted-foreground space-y-2 mt-2 pl-5 prose">{children}</div>
|
||||
</details>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,254 +0,0 @@
|
||||
import { Check, CornerDownRight, GitPullRequest, Hash, PlusCircle } from "lucide-react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import { DiscordIcon } from "~/components/brand-icons";
|
||||
import {
|
||||
MoAvatar,
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
|
||||
const DISCORD_CHANNELS = ["general", "engineering", "bugs", "releases"] as const;
|
||||
|
||||
const STEP_DELAYS = {
|
||||
userMention: 0.06,
|
||||
threadStart: 0.55,
|
||||
botWorking: 1.05,
|
||||
botDone: 1.7,
|
||||
} as const;
|
||||
|
||||
const DISCORD_COMPONENTS = {
|
||||
mention: (
|
||||
<span className="rounded-[3px] bg-[#5865F2]/30 px-1 py-[0.5px] font-medium text-[#C9CDFB]">
|
||||
@paseo-bot
|
||||
</span>
|
||||
),
|
||||
host: (
|
||||
<span className="rounded-[3px] bg-[#1E1F22] px-1.5 py-[1px] font-mono text-[11px] text-[#DBDEE1]" />
|
||||
),
|
||||
issue: <span className="font-mono text-[12px] text-[#00A8FC]">#2799</span>,
|
||||
};
|
||||
|
||||
export function DiscordSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.discord.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-[#3F4147] bg-[#313338]"
|
||||
>
|
||||
<DiscordChrome />
|
||||
|
||||
<div className="grid min-h-0 flex-1 grid-cols-1 md:grid-cols-[164px_minmax(0,1fr)]">
|
||||
<DiscordSidebar />
|
||||
<div className="flex min-h-0 min-w-0 flex-col bg-[#313338]">
|
||||
<DiscordChannelHeader />
|
||||
<DiscordMessageFeed />
|
||||
<DiscordComposer />
|
||||
</div>
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordMessageFeed() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex-1 space-y-3 px-4 py-3">
|
||||
<MockupStep delay={STEP_DELAYS.userMention}>
|
||||
<DiscordMessage author="mo" time={t("hub.demo.discord.time1")}>
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.discord.userPrompt" components={DISCORD_COMPONENTS} />
|
||||
</p>
|
||||
</DiscordMessage>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.threadStart}
|
||||
className="flex items-start gap-2 pl-2 text-[11.5px] text-[#949BA4]"
|
||||
>
|
||||
<CornerDownRight className="h-3.5 w-3.5 shrink-0 text-[#949BA4]" aria-hidden="true" />
|
||||
<p>
|
||||
<span className="font-medium text-[#F2F3F5]">paseo-bot</span>{" "}
|
||||
{t("hub.demo.discord.startedThread")}{" "}
|
||||
<span className="font-semibold text-[#F2F3F5]">{t("hub.demo.discord.threadTitle")}</span>
|
||||
</p>
|
||||
</MockupStep>
|
||||
|
||||
<div className="ml-3 space-y-3 border-l-2 border-[#4E5058] pl-3.5">
|
||||
<MockupStep delay={STEP_DELAYS.botWorking}>
|
||||
<DiscordMessage author="paseo-bot" time={t("hub.demo.discord.time1")} bot>
|
||||
<p className="text-[#DBDEE1]">
|
||||
<Trans i18nKey="hub.demo.discord.botStarted" components={DISCORD_COMPONENTS} />
|
||||
</p>
|
||||
</DiscordMessage>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep delay={STEP_DELAYS.botDone}>
|
||||
<DiscordMessage author="paseo-bot" time={t("hub.demo.discord.time2")} bot>
|
||||
<p className="text-[#DBDEE1]">{t("hub.demo.discord.botFinished")}</p>
|
||||
<DiscordPrEmbed />
|
||||
</DiscordMessage>
|
||||
</MockupStep>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordPrEmbed() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="mt-2 space-y-2">
|
||||
<div className="rounded-[4px] border-l-[4px] border-[#2BAC76] bg-[#2B2D31] px-3 py-2.5">
|
||||
<div className="flex items-center gap-1.5 text-[12px] font-semibold text-[#00A8FC]">
|
||||
<GitPullRequest className="h-3.5 w-3.5 shrink-0 text-[#2BAC76]" aria-hidden="true" />
|
||||
<span>getpaseo/paseo#2825</span>
|
||||
</div>
|
||||
<p className="mt-0.5 text-[12px] text-[#DBDEE1]">
|
||||
fix(worktree): prune orphaned branches on close
|
||||
</p>
|
||||
<div className="mt-2 grid grid-cols-3 gap-2 text-[11px]">
|
||||
<div>
|
||||
<p className="font-semibold text-[#B5BAC1]">{t("hub.demo.discord.fieldHost")}</p>
|
||||
<p className="font-mono text-[#DBDEE1]">devbox</p>
|
||||
</div>
|
||||
<div>
|
||||
<p className="font-semibold text-[#B5BAC1]">{t("hub.demo.discord.fieldDiff")}</p>
|
||||
<p className="font-mono text-[#DBDEE1]">+46 -12</p>
|
||||
</div>
|
||||
<div>
|
||||
<p className="font-semibold text-[#B5BAC1]">{t("hub.demo.discord.fieldChecks")}</p>
|
||||
<p className="inline-flex items-center gap-1 text-[#57F287]">
|
||||
<Check className="h-3 w-3" aria-hidden="true" />
|
||||
{t("hub.demo.shared.testsPassed")}
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<OpenInPaseoChip variant="discord" />
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordComposer() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div
|
||||
aria-hidden="true"
|
||||
className="mx-4 mt-auto mb-3 flex items-center gap-2.5 rounded-[8px] bg-[#383A40] px-3 py-2 text-[12.5px] text-[#80848E]"
|
||||
>
|
||||
<PlusCircle className="h-4 w-4 shrink-0 text-[#B5BAC1]" />
|
||||
<span className="truncate">{t("hub.demo.discord.composerPlaceholder")}</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordChrome() {
|
||||
return (
|
||||
<div className="flex h-9 shrink-0 items-center justify-between border-b border-[#1E1F22] bg-[#1E1F22] px-3.5">
|
||||
<div className="flex items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<span className="text-[12px] font-semibold text-[#B5BAC1]">Discord</span>
|
||||
</div>
|
||||
<DiscordIcon className="h-3.5 w-3.5 text-[#5865F2]" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordSidebar() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<aside
|
||||
aria-hidden="true"
|
||||
className="hidden flex-col border-r border-[#1F2023] bg-[#2B2D31] md:flex"
|
||||
>
|
||||
<div className="border-b border-[#1F2023] px-3.5 py-2.5 text-[13.5px] font-bold text-[#F2F3F5]">
|
||||
Paseo
|
||||
</div>
|
||||
<div className="space-y-0.5 px-2 py-3 text-[12.5px]">
|
||||
<p className="px-2 pb-1 text-[10.5px] font-semibold uppercase tracking-wide text-[#949BA4]">
|
||||
{t("hub.demo.discord.textChannels")}
|
||||
</p>
|
||||
{DISCORD_CHANNELS.map((channel) => (
|
||||
<div key={channel}>
|
||||
<div
|
||||
className={`flex items-center gap-1.5 rounded-[5px] px-2 py-1 ${
|
||||
channel === "engineering"
|
||||
? "bg-[#404249] font-medium text-[#F2F3F5]"
|
||||
: "text-[#949BA4]"
|
||||
}`}
|
||||
>
|
||||
<Hash className="h-3.5 w-3.5 shrink-0 opacity-75" />
|
||||
<span className="truncate">{channel}</span>
|
||||
</div>
|
||||
{channel === "engineering" ? (
|
||||
<div className="mt-0.5 ml-3 flex items-center gap-1.5 border-l border-[#4E5058] py-1 pl-2 text-[11.5px] text-[#DBDEE1]">
|
||||
<span className="truncate">{t("hub.demo.discord.threadTitle")}</span>
|
||||
</div>
|
||||
) : null}
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</aside>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordChannelHeader() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex shrink-0 items-center justify-between gap-3 border-b border-[#26282C] px-4 py-2">
|
||||
<div className="flex min-w-0 items-center gap-2">
|
||||
<Hash className="h-4 w-4 shrink-0 text-[#80848E]" aria-hidden="true" />
|
||||
<span className="text-[14px] font-semibold text-[#F2F3F5]">engineering</span>
|
||||
<span className="hidden h-3.5 w-px bg-[#3F4147] sm:inline-block" aria-hidden="true" />
|
||||
<span className="hidden truncate text-[11.5px] text-[#949BA4] sm:inline">
|
||||
{t("hub.demo.discord.channelTopic")}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiscordMessage({
|
||||
author,
|
||||
time,
|
||||
bot,
|
||||
children,
|
||||
}: {
|
||||
author: string;
|
||||
time: string;
|
||||
bot?: boolean;
|
||||
children: React.ReactNode;
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex items-start gap-2.5">
|
||||
{bot ? (
|
||||
<PaseoBotAvatar size="md" rounded="rounded-full" className="mt-0.5" />
|
||||
) : (
|
||||
<MoAvatar size="md" rounded="rounded-full" className="mt-0.5" />
|
||||
)}
|
||||
<div className="min-w-0 flex-1 space-y-0.5">
|
||||
<div className="flex flex-wrap items-center gap-1.5">
|
||||
<span className="text-[13.5px] font-semibold text-[#F2F3F5]">{author}</span>
|
||||
{bot ? (
|
||||
<span className="inline-flex items-center gap-0.5 rounded-[3px] bg-[#5865F2] px-1.5 py-[1px] text-[9.5px] font-semibold uppercase tracking-wide text-white">
|
||||
<Check className="h-2.5 w-2.5" aria-hidden="true" />
|
||||
{t("hub.demo.shared.appBadge")}
|
||||
</span>
|
||||
) : null}
|
||||
<span className="text-[11px] text-[#949BA4]">{time}</span>
|
||||
</div>
|
||||
<div className="text-[13px] leading-[1.45] text-[#DBDEE1]">{children}</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -1,287 +0,0 @@
|
||||
import { Check, CircleDot, GitPullRequest, Tag } from "lucide-react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import { GitHubIcon } from "~/components/brand-icons";
|
||||
import {
|
||||
MoAvatar,
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
|
||||
const STEP_DELAYS = {
|
||||
issue: 0.06,
|
||||
labelEvent: 0.55,
|
||||
botReply: 1.2,
|
||||
checks: 1.85,
|
||||
} as const;
|
||||
|
||||
const GH_COMPONENTS = {
|
||||
mention: <span className="font-semibold text-[#58A6FF]">@paseo-bot</span>,
|
||||
host: (
|
||||
<span className="rounded-[4px] border border-[#30363D] bg-[#161B22] px-1.5 py-[1px] font-mono text-[11px] text-[#E6EDF3]" />
|
||||
),
|
||||
pr: <span className="font-medium text-[#58A6FF] underline decoration-[#58A6FF]/40" />,
|
||||
code: (
|
||||
<code className="rounded-[4px] bg-[#21262D] px-1.5 py-[1px] font-mono text-[11.5px] text-[#E6EDF3]" />
|
||||
),
|
||||
};
|
||||
|
||||
const CHECK_NAMES = ["typecheck", "vitest", "lint", "build"] as const;
|
||||
|
||||
export function GitHubSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.github.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-[#30363D] bg-[#0D1117]"
|
||||
>
|
||||
<GitHubChrome />
|
||||
<GitHubIssueHeader />
|
||||
<div className="grid min-h-0 flex-1 grid-cols-1 sm:grid-cols-[minmax(0,1fr)_156px]">
|
||||
<GitHubTimeline />
|
||||
<GitHubSidebar />
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubTimeline() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="relative space-y-3 px-4 py-3.5">
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="pointer-events-none absolute top-11 bottom-6 left-[27px] w-[2px] bg-[#21262D]"
|
||||
/>
|
||||
|
||||
<MockupStep delay={STEP_DELAYS.issue} className="relative">
|
||||
<GitHubComment
|
||||
author="mo"
|
||||
badge={t("hub.demo.github.authorBadge")}
|
||||
timestamp={t("hub.demo.github.openedAgo")}
|
||||
>
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.github.issueBody" components={GH_COMPONENTS} />
|
||||
</p>
|
||||
</GitHubComment>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.labelEvent}
|
||||
className="relative flex items-center gap-2.5 pl-1"
|
||||
>
|
||||
<span className="relative z-10 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-[#30363D] bg-[#161B22] text-[#8B949E]">
|
||||
<Tag className="h-3 w-3" aria-hidden="true" />
|
||||
</span>
|
||||
<div className="flex flex-wrap items-center gap-1.5 text-[11.5px] text-[#8B949E]">
|
||||
<span className="font-semibold text-[#E6EDF3]">mo</span>
|
||||
<span>{t("hub.demo.github.addedLabel")}</span>
|
||||
<span className="rounded-full border border-[#20744A]/60 bg-[#20744A]/20 px-2 py-[1px] font-mono text-[10.5px] font-medium text-[#6CB17B]">
|
||||
paseo
|
||||
</span>
|
||||
<span>·</span>
|
||||
<span>{t("hub.demo.github.startedOn")}</span>
|
||||
</div>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep delay={STEP_DELAYS.botReply} className="relative">
|
||||
<GitHubComment
|
||||
author="paseo-bot"
|
||||
badge={t("hub.demo.github.botBadge")}
|
||||
timestamp={t("hub.demo.github.repliedAgo")}
|
||||
bot
|
||||
>
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.github.botReply" components={GH_COMPONENTS} />
|
||||
</p>
|
||||
<GitHubPrSummaryCard />
|
||||
</GitHubComment>
|
||||
</MockupStep>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubPrSummaryCard() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.checks}
|
||||
className="mt-2.5 overflow-hidden rounded-md border border-[#30363D] bg-[#0D1117]"
|
||||
>
|
||||
<div className="flex flex-wrap items-center justify-between gap-2 border-b border-[#21262D] bg-[#161B22] px-3 py-2">
|
||||
<div className="flex min-w-0 items-center gap-1.5">
|
||||
<GitPullRequest className="h-3.5 w-3.5 shrink-0 text-[#3FB950]" aria-hidden="true" />
|
||||
<span className="text-[12px] font-semibold text-[#E6EDF3]">
|
||||
fix(terminal): drain PTY write queue under burst
|
||||
</span>
|
||||
<span className="font-mono text-[11px] text-[#8B949E]">#2819</span>
|
||||
</div>
|
||||
<span className="shrink-0 font-mono text-[11px]">
|
||||
<span className="text-[#3FB950]">+84</span> <span className="text-[#F85149]">-19</span>
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div className="flex flex-wrap items-center justify-between gap-2 px-3 py-2">
|
||||
<div className="flex flex-wrap items-center gap-1.5">
|
||||
<span className="inline-flex items-center gap-1 text-[11.5px] font-medium text-[#3FB950]">
|
||||
<Check className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
{t("hub.demo.github.checksPassed")}
|
||||
</span>
|
||||
<span className="hidden items-center gap-1 sm:inline-flex">
|
||||
{CHECK_NAMES.map((name) => (
|
||||
<span
|
||||
key={name}
|
||||
className="rounded border border-[#30363D] bg-[#161B22] px-1.5 py-[1px] font-mono text-[10px] text-[#8B949E]"
|
||||
>
|
||||
{name}
|
||||
</span>
|
||||
))}
|
||||
</span>
|
||||
</div>
|
||||
<OpenInPaseoChip variant="brand" />
|
||||
</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubChrome() {
|
||||
return (
|
||||
<div className="flex h-9 shrink-0 items-center justify-between border-b border-[#21262D] bg-[#010409] px-3.5">
|
||||
<div className="flex items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<div className="flex items-center gap-1.5 text-[12px] text-[#8B949E]">
|
||||
<GitHubIcon className="h-3.5 w-3.5 text-[#E6EDF3]" />
|
||||
<span>getpaseo</span>
|
||||
<span className="text-[#484F58]">/</span>
|
||||
<span className="font-semibold text-[#E6EDF3]">paseo</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div
|
||||
className="hidden items-center gap-4 text-[11.5px] text-[#8B949E] sm:flex"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<span className="relative py-2 font-medium text-[#E6EDF3]">
|
||||
Issues
|
||||
<span className="absolute right-0 -bottom-[3px] left-0 h-[2px] rounded-full bg-[#F78166]" />
|
||||
</span>
|
||||
<span>Pull requests</span>
|
||||
<span>Actions</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubIssueHeader() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="shrink-0 border-b border-[#21262D] px-4 py-3">
|
||||
<div className="flex flex-wrap items-baseline gap-x-2 gap-y-1">
|
||||
<h4 className="text-[15px] font-semibold text-[#E6EDF3]">
|
||||
{t("hub.demo.github.issueTitle")}
|
||||
</h4>
|
||||
<span className="font-mono text-[14px] text-[#8B949E]">#2811</span>
|
||||
</div>
|
||||
<div className="mt-1.5 flex flex-wrap items-center gap-2 text-[11.5px] text-[#8B949E]">
|
||||
<span className="inline-flex items-center gap-1 rounded-full bg-[#238636] px-2.5 py-0.5 text-[11px] font-semibold text-white">
|
||||
<CircleDot className="h-3 w-3" aria-hidden="true" />
|
||||
Open
|
||||
</span>
|
||||
<span>
|
||||
<strong className="font-semibold text-[#E6EDF3]">mo</strong>{" "}
|
||||
{t("hub.demo.github.issueMeta")}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubComment({
|
||||
author,
|
||||
badge,
|
||||
timestamp,
|
||||
bot,
|
||||
children,
|
||||
}: {
|
||||
author: string;
|
||||
badge: string;
|
||||
timestamp: string;
|
||||
bot?: boolean;
|
||||
children: React.ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<div className="flex items-start gap-2.5">
|
||||
{bot ? (
|
||||
<PaseoBotAvatar size="sm" rounded="rounded-full" className="relative z-10 mt-0.5 h-7 w-7" />
|
||||
) : (
|
||||
<MoAvatar size="sm" rounded="rounded-full" className="relative z-10 mt-0.5 h-7 w-7" />
|
||||
)}
|
||||
<div className="min-w-0 flex-1 overflow-hidden rounded-md border border-[#30363D] bg-[#0D1117]">
|
||||
<div className="flex flex-wrap items-center justify-between gap-2 border-b border-[#21262D] bg-[#161B22] px-3 py-1.5 text-[11.5px]">
|
||||
<div className="flex items-center gap-1.5">
|
||||
<span className="font-semibold text-[#E6EDF3]">{author}</span>
|
||||
<span className="rounded-full border border-[#30363D] px-1.5 py-[0.5px] text-[10px] font-medium text-[#8B949E]">
|
||||
{badge}
|
||||
</span>
|
||||
</div>
|
||||
<span className="text-[11px] text-[#8B949E]">{timestamp}</span>
|
||||
</div>
|
||||
<div className="px-3 py-2.5 text-[12.5px] leading-[1.5] text-[#C9D1D9]">{children}</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function GitHubSidebar() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<aside
|
||||
aria-hidden="true"
|
||||
className="hidden flex-col gap-3.5 border-l border-[#21262D] px-3.5 py-3.5 text-[11.5px] sm:flex"
|
||||
>
|
||||
<div className="space-y-1.5 border-b border-[#21262D] pb-3">
|
||||
<p className="font-medium text-[#8B949E]">{t("hub.demo.github.assignees")}</p>
|
||||
<div className="flex items-center gap-1.5 text-[#E6EDF3]">
|
||||
<PaseoBotAvatar size="xs" rounded="rounded-full" />
|
||||
<span className="font-medium">paseo-bot</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="space-y-1.5 border-b border-[#21262D] pb-3">
|
||||
<p className="font-medium text-[#8B949E]">{t("hub.demo.github.labels")}</p>
|
||||
<div className="flex flex-wrap gap-1">
|
||||
<span className="rounded-full border border-[#F85149]/40 bg-[#F85149]/15 px-2 py-[1px] text-[10.5px] font-medium text-[#FF7B72]">
|
||||
bug
|
||||
</span>
|
||||
<span className="rounded-full border border-[#D29922]/40 bg-[#D29922]/15 px-2 py-[1px] text-[10.5px] font-medium text-[#E3B341]">
|
||||
p0
|
||||
</span>
|
||||
<span className="rounded-full border border-[#20744A]/60 bg-[#20744A]/20 px-2 py-[1px] text-[10.5px] font-medium text-[#6CB17B]">
|
||||
paseo
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="space-y-1.5 border-b border-[#21262D] pb-3">
|
||||
<p className="font-medium text-[#8B949E]">{t("hub.demo.github.development")}</p>
|
||||
<div className="flex items-center gap-1.5 text-[#58A6FF]">
|
||||
<GitPullRequest className="h-3.5 w-3.5 shrink-0 text-[#3FB950]" />
|
||||
<span className="font-mono text-[11.5px]">#2819</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="space-y-1">
|
||||
<p className="font-medium text-[#8B949E]">{t("hub.demo.github.daemon")}</p>
|
||||
<span className="inline-block rounded border border-[#30363D] bg-[#161B22] px-1.5 py-0.5 font-mono text-[11px] text-[#E6EDF3]">
|
||||
macbook-pro
|
||||
</span>
|
||||
</div>
|
||||
</aside>
|
||||
);
|
||||
}
|
||||
@@ -1,231 +0,0 @@
|
||||
import { useInView, useReducedMotion } from "framer-motion";
|
||||
import { ArrowRight } from "lucide-react";
|
||||
import * as React from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import {
|
||||
HUB_TRIGGER_SOURCES,
|
||||
type HubTriggerSource,
|
||||
type HubTriggerSourceId,
|
||||
} from "~/components/hub-flow";
|
||||
import { useLocalizePath } from "~/i18n";
|
||||
import { DiscordSourceMockup } from "./discord-mockup";
|
||||
import { GitHubSourceMockup } from "./github-mockup";
|
||||
import { LinearSourceMockup } from "./linear-mockup";
|
||||
import { SchedulesSourceMockup } from "./schedules-mockup";
|
||||
import type { SourceMockupProps } from "./shared";
|
||||
import { SlackSourceMockup } from "./slack-mockup";
|
||||
import { WebhooksSourceMockup } from "./webhooks-mockup";
|
||||
|
||||
const SHOWCASE_ORDER: readonly HubTriggerSourceId[] = [
|
||||
"slack",
|
||||
"github",
|
||||
"linear",
|
||||
"discord",
|
||||
"schedules",
|
||||
"webhooks",
|
||||
];
|
||||
|
||||
const SOURCE_DOC_PATHS: Record<HubTriggerSourceId, string> = {
|
||||
slack: "/docs/hub/triggers/slack",
|
||||
github: "/docs/hub/triggers/github",
|
||||
linear: "/docs/hub/triggers/linear",
|
||||
discord: "/docs/hub/triggers/discord",
|
||||
schedules: "/docs/hub/triggers/schedules",
|
||||
webhooks: "/docs/hub/triggers/webhooks",
|
||||
};
|
||||
|
||||
const SHOWCASE_SOURCES: readonly HubTriggerSource[] = SHOWCASE_ORDER.map((id) => {
|
||||
const source = HUB_TRIGGER_SOURCES.find((item) => item.id === id);
|
||||
if (!source) {
|
||||
throw new Error(`Missing Hub trigger source metadata for "${id}"`);
|
||||
}
|
||||
return source;
|
||||
});
|
||||
|
||||
const SOURCE_MOCKUPS: Record<HubTriggerSourceId, React.ComponentType<SourceMockupProps>> = {
|
||||
slack: SlackSourceMockup,
|
||||
github: GitHubSourceMockup,
|
||||
linear: LinearSourceMockup,
|
||||
discord: DiscordSourceMockup,
|
||||
schedules: SchedulesSourceMockup,
|
||||
webhooks: WebhooksSourceMockup,
|
||||
};
|
||||
|
||||
const STAGE_IN_VIEW_OPTIONS = { once: true, margin: "-60px" } as const;
|
||||
const PANEL_ID = "hub-source-panel";
|
||||
|
||||
/**
|
||||
* Interactive split showcase for Paseo Hub automation sources:
|
||||
* left clickable pills on desktop (compact pill grid on mobile) paired with a fixed-height
|
||||
* right stage that swaps between authentic, animated dark-mode mockups with zero layout shift.
|
||||
*/
|
||||
export function HubAutomationsShowcase() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
const reduceMotion = useReducedMotion() === true;
|
||||
const [selected, setSelected] = React.useState<HubTriggerSourceId>("slack");
|
||||
const stageRef = React.useRef<HTMLDivElement | null>(null);
|
||||
const tabRefs = React.useRef<Partial<Record<HubTriggerSourceId, HTMLButtonElement | null>>>({});
|
||||
const isInView = useInView(stageRef, STAGE_IN_VIEW_OPTIONS);
|
||||
|
||||
const ActiveMockup = SOURCE_MOCKUPS[selected];
|
||||
|
||||
const registerTabRef = React.useCallback(
|
||||
(id: HubTriggerSourceId, node: HTMLButtonElement | null) => {
|
||||
tabRefs.current[id] = node;
|
||||
},
|
||||
[],
|
||||
);
|
||||
|
||||
const handleNavigate = React.useCallback((index: number, key: string): boolean => {
|
||||
let nextIndex: number | null = null;
|
||||
if (key === "ArrowDown" || key === "ArrowRight") {
|
||||
nextIndex = (index + 1) % SHOWCASE_SOURCES.length;
|
||||
} else if (key === "ArrowUp" || key === "ArrowLeft") {
|
||||
nextIndex = (index - 1 + SHOWCASE_SOURCES.length) % SHOWCASE_SOURCES.length;
|
||||
} else if (key === "Home") {
|
||||
nextIndex = 0;
|
||||
} else if (key === "End") {
|
||||
nextIndex = SHOWCASE_SOURCES.length - 1;
|
||||
}
|
||||
if (nextIndex === null) return false;
|
||||
const nextId = SHOWCASE_SOURCES[nextIndex].id;
|
||||
setSelected(nextId);
|
||||
tabRefs.current[nextId]?.focus();
|
||||
return true;
|
||||
}, []);
|
||||
|
||||
return (
|
||||
<div className="grid items-start gap-6 lg:grid-cols-[292px_minmax(0,1fr)] lg:gap-6">
|
||||
<div className="space-y-2.5">
|
||||
<div
|
||||
role="tablist"
|
||||
aria-label={t("hub.demo.shared.tablistLabel")}
|
||||
className="grid grid-cols-2 gap-1.5 min-[375px]:grid-cols-3 sm:gap-2 lg:flex lg:flex-col lg:gap-1.5"
|
||||
>
|
||||
{SHOWCASE_SOURCES.map((source, index) => (
|
||||
<SourceTabButton
|
||||
key={source.id}
|
||||
source={source}
|
||||
index={index}
|
||||
isSelected={source.id === selected}
|
||||
onSelect={setSelected}
|
||||
onNavigate={handleNavigate}
|
||||
registerRef={registerTabRef}
|
||||
/>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<p className="text-xs text-muted-foreground lg:hidden">
|
||||
{t(`hub.sources.${selected}.description`)}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<figure ref={stageRef} className="min-w-0 space-y-3">
|
||||
<div
|
||||
role="tabpanel"
|
||||
id={PANEL_ID}
|
||||
aria-labelledby={`hub-source-tab-${selected}`}
|
||||
tabIndex={0}
|
||||
className="relative focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent-text lg:h-[33rem]"
|
||||
>
|
||||
<ActiveMockup active={isInView} reduceMotion={reduceMotion} />
|
||||
</div>
|
||||
|
||||
<figcaption className="flex flex-wrap items-baseline justify-between gap-x-4 gap-y-1.5 min-h-[1.25rem] text-sm text-muted-foreground">
|
||||
<span>{t(`hub.demo.${selected}.caption`)}</span>
|
||||
<a
|
||||
href={localize(SOURCE_DOC_PATHS[selected])}
|
||||
className="inline-flex shrink-0 items-center gap-1.5 text-sm text-white/75 transition-colors hover:text-accent-text"
|
||||
>
|
||||
{t("hub.demo.shared.docsLink", { source: t(`hub.sources.${selected}.name`) })}
|
||||
<ArrowRight className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
</a>
|
||||
</figcaption>
|
||||
</figure>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SourceTabButton({
|
||||
source,
|
||||
index,
|
||||
isSelected,
|
||||
onSelect,
|
||||
onNavigate,
|
||||
registerRef,
|
||||
}: {
|
||||
source: HubTriggerSource;
|
||||
index: number;
|
||||
isSelected: boolean;
|
||||
onSelect: (id: HubTriggerSourceId) => void;
|
||||
onNavigate: (index: number, key: string) => boolean;
|
||||
registerRef: (id: HubTriggerSourceId, node: HTMLButtonElement | null) => void;
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
const { id, Icon } = source;
|
||||
|
||||
const setRef = React.useCallback(
|
||||
(node: HTMLButtonElement | null) => {
|
||||
registerRef(id, node);
|
||||
},
|
||||
[id, registerRef],
|
||||
);
|
||||
|
||||
const handleClick = React.useCallback(() => {
|
||||
onSelect(id);
|
||||
}, [id, onSelect]);
|
||||
|
||||
const handleKeyDown = React.useCallback(
|
||||
(event: React.KeyboardEvent<HTMLButtonElement>) => {
|
||||
if (onNavigate(index, event.key)) {
|
||||
event.preventDefault();
|
||||
}
|
||||
},
|
||||
[index, onNavigate],
|
||||
);
|
||||
|
||||
return (
|
||||
<button
|
||||
ref={setRef}
|
||||
type="button"
|
||||
role="tab"
|
||||
id={`hub-source-tab-${id}`}
|
||||
aria-selected={isSelected}
|
||||
aria-controls={PANEL_ID}
|
||||
tabIndex={isSelected ? 0 : -1}
|
||||
onClick={handleClick}
|
||||
onKeyDown={handleKeyDown}
|
||||
className={`group flex min-h-[42px] cursor-pointer items-center justify-center gap-2 rounded-xl border px-2.5 py-2 text-left transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-accent-text lg:min-h-0 lg:items-start lg:justify-start lg:gap-3 lg:px-3.5 lg:py-3 ${
|
||||
isSelected
|
||||
? "border-brand-green/55 bg-brand-green/[0.13] text-white"
|
||||
: "border-white/[0.07] bg-white/[0.015] text-white/70 hover:border-white/[0.14] hover:bg-white/[0.035] hover:text-white/90 lg:border-transparent lg:bg-transparent"
|
||||
}`}
|
||||
>
|
||||
<span
|
||||
className={`shrink-0 transition-colors lg:mt-0.5 ${
|
||||
isSelected ? "text-accent-text" : "text-white/55 group-hover:text-white/80"
|
||||
}`}
|
||||
>
|
||||
<Icon className="h-4 w-4 lg:h-[18px] lg:w-[18px]" />
|
||||
</span>
|
||||
|
||||
<span className="min-w-0 flex-1">
|
||||
<span
|
||||
className={`block text-xs leading-5 font-medium wrap-anywhere lg:text-sm ${
|
||||
isSelected ? "text-white" : "text-white/80 group-hover:text-white"
|
||||
}`}
|
||||
>
|
||||
{t(`hub.sources.${id}.name`)}
|
||||
</span>
|
||||
<span
|
||||
className={`mt-0.5 hidden text-xs leading-4 wrap-anywhere lg:block ${
|
||||
isSelected ? "text-white/65" : "text-muted-foreground"
|
||||
}`}
|
||||
>
|
||||
{t(`hub.sources.${id}.description`)}
|
||||
</span>
|
||||
</span>
|
||||
</button>
|
||||
);
|
||||
}
|
||||
@@ -1 +0,0 @@
|
||||
export { HubAutomationsShowcase } from "./hub-automations-showcase";
|
||||
@@ -1,242 +0,0 @@
|
||||
import { Check, ChevronRight, GitPullRequest, SignalHigh } from "lucide-react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import { LinearIcon } from "~/components/brand-icons";
|
||||
import {
|
||||
MoAvatar,
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
|
||||
const STEP_DELAYS = {
|
||||
assigned: 0.08,
|
||||
running: 0.65,
|
||||
comment: 1.35,
|
||||
} as const;
|
||||
|
||||
const LINEAR_COMPONENTS = {
|
||||
host: (
|
||||
<span className="rounded bg-[#22252E] px-1.5 py-[1px] font-mono text-[11px] text-[#E3E6F0]" />
|
||||
),
|
||||
code: (
|
||||
<code className="rounded bg-[#22252E] px-1.5 py-[1px] font-mono text-[11px] text-[#C5CCDF]" />
|
||||
),
|
||||
};
|
||||
|
||||
export function LinearSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.linear.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-[#262932] bg-[#111318]"
|
||||
>
|
||||
<LinearChrome />
|
||||
|
||||
<div className="grid min-h-0 flex-1 grid-cols-1 sm:grid-cols-[minmax(0,1fr)_172px]">
|
||||
<LinearIssuePane />
|
||||
<LinearPropertiesSidebar />
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearIssuePane() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex min-h-0 flex-col px-5 py-4">
|
||||
<div className="space-y-1.5 border-b border-[#22252E] pb-3.5">
|
||||
<p className="font-mono text-[11.5px] text-[#8A8F9E]">PAS-418</p>
|
||||
<h4 className="text-[16px] font-semibold tracking-[-0.01em] text-[#F1F3F8]">
|
||||
{t("hub.demo.linear.issueTitle")}
|
||||
</h4>
|
||||
<p className="text-[12.5px] leading-relaxed text-[#9DA3B4]">
|
||||
{t("hub.demo.linear.issueDescription")}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<LinearActivityFeed />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearActivityFeed() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="mt-3.5 flex-1 space-y-3">
|
||||
<p className="text-[11px] font-medium uppercase tracking-wider text-[#6D7385]">
|
||||
{t("hub.demo.linear.activity")}
|
||||
</p>
|
||||
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.assigned}
|
||||
className="flex items-center gap-2 text-[12px] text-[#9DA3B4]"
|
||||
>
|
||||
<MoAvatar size="xs" rounded="rounded-full" />
|
||||
<span className="min-w-0">
|
||||
<strong className="font-medium text-[#ECEEF4]">mo</strong>{" "}
|
||||
{t("hub.demo.linear.assignedEvent")}{" "}
|
||||
<strong className="font-medium text-[#ECEEF4]">paseo-bot</strong>
|
||||
</span>
|
||||
<span className="ml-auto shrink-0 text-[11px] text-[#6D7385]">11m</span>
|
||||
</MockupStep>
|
||||
|
||||
<LinearRunStatusRow />
|
||||
<LinearBotCommentCard />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearRunStatusRow() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.running}
|
||||
className="flex items-center gap-2.5 rounded-lg border border-[#242834] bg-[#171A21] px-3 py-2 text-[12px]"
|
||||
>
|
||||
<PaseoBotAvatar size="sm" rounded="rounded-full" />
|
||||
<div className="min-w-0 flex-1">
|
||||
<div className="flex flex-wrap items-center gap-1.5">
|
||||
<span className="font-medium text-[#ECEEF4]">paseo-bot</span>
|
||||
<span className="text-[#6D7385]">·</span>
|
||||
<span className="text-[#9DA3B4]">
|
||||
<Trans i18nKey="hub.demo.linear.runningOn" components={LINEAR_COMPONENTS} />
|
||||
</span>
|
||||
</div>
|
||||
<p className="mt-0.5 font-mono text-[11px] wrap-anywhere text-[#7D8599]">
|
||||
{t("hub.demo.linear.traceLine")}
|
||||
</p>
|
||||
</div>
|
||||
<Check className="h-3.5 w-3.5 shrink-0 text-[#6CB17B]" aria-hidden="true" />
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearBotCommentCard() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.comment}
|
||||
className="rounded-lg border border-[#262A36] bg-[#161820] p-3.5"
|
||||
>
|
||||
<div className="flex items-center justify-between gap-2">
|
||||
<div className="flex items-center gap-2">
|
||||
<PaseoBotAvatar size="sm" rounded="rounded-full" />
|
||||
<span className="text-[12.5px] font-semibold text-[#F1F3F8]">paseo-bot</span>
|
||||
<span className="rounded bg-[#252936] px-1.5 py-[1px] text-[10px] font-medium uppercase tracking-wide text-[#9DA3B4]">
|
||||
{t("hub.demo.shared.appBadge")}
|
||||
</span>
|
||||
</div>
|
||||
<span className="text-[11px] text-[#6D7385]">6m</span>
|
||||
</div>
|
||||
|
||||
<p className="mt-2 text-[12.5px] leading-[1.5] text-[#C5CCDF]">
|
||||
<Trans i18nKey="hub.demo.linear.botSummary" components={LINEAR_COMPONENTS} />
|
||||
</p>
|
||||
|
||||
<div className="mt-3 flex flex-wrap items-center justify-between gap-2 border-t border-[#242834] pt-2.5">
|
||||
<span className="inline-flex items-center gap-1.5 rounded-md border border-[#2A2F3D] bg-[#1C1F2A] px-2 py-1 font-mono text-[11px] text-[#C5CCDF]">
|
||||
<GitPullRequest className="h-3 w-3 text-[#6CB17B]" aria-hidden="true" />
|
||||
<span>#2822</span>
|
||||
<span className="text-[#6CB17B]">· {t("hub.demo.shared.testsPassed")}</span>
|
||||
</span>
|
||||
<OpenInPaseoChip variant="brand" />
|
||||
</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearChrome() {
|
||||
return (
|
||||
<div className="flex h-9 shrink-0 items-center justify-between border-b border-[#22252E] bg-[#15171E] px-3.5">
|
||||
<div className="flex items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<div className="flex items-center gap-1 text-[11.5px] text-[#8A8F9E]">
|
||||
<LinearIcon className="h-3.5 w-3.5 text-[#5E6AD2]" />
|
||||
<span>Paseo</span>
|
||||
<ChevronRight className="h-3 w-3 text-[#555B6E]" aria-hidden="true" />
|
||||
<span>Core</span>
|
||||
<ChevronRight className="h-3 w-3 text-[#555B6E]" aria-hidden="true" />
|
||||
<span className="font-mono text-[#E3E6F0]">PAS-418</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<span className="hidden rounded-full border border-[#5E6AD2]/35 bg-[#5E6AD2]/15 px-2 py-0.5 text-[10.5px] font-medium text-[#A4ACEE] sm:inline-block">
|
||||
Cycle 14
|
||||
</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearPropertiesSidebar() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<aside
|
||||
aria-hidden="true"
|
||||
className="hidden flex-col gap-3.5 border-l border-[#22252E] bg-[#13151B] px-3.5 py-4 text-[11.5px] sm:flex"
|
||||
>
|
||||
<p className="text-[11px] font-medium text-[#6D7385]">{t("hub.demo.linear.properties")}</p>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.status")}>
|
||||
<span className="inline-flex items-center gap-1.5 text-[#ECEEF4]">
|
||||
<span className="h-2.5 w-2.5 rounded-full border-2 border-[#6CB17B] bg-[#6CB17B]/35" />
|
||||
<span>In Review</span>
|
||||
</span>
|
||||
</LinearPropRow>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.priority")}>
|
||||
<span className="inline-flex items-center gap-1.5 text-[#ECEEF4]">
|
||||
<SignalHigh className="h-3.5 w-3.5 text-[#F2994A]" />
|
||||
<span>High</span>
|
||||
</span>
|
||||
</LinearPropRow>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.assignee")}>
|
||||
<span className="inline-flex items-center gap-1.5 text-[#ECEEF4]">
|
||||
<PaseoBotAvatar size="xs" rounded="rounded-full" />
|
||||
<span>paseo-bot</span>
|
||||
</span>
|
||||
</LinearPropRow>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.creator")}>
|
||||
<span className="inline-flex items-center gap-1.5 text-[#ECEEF4]">
|
||||
<MoAvatar size="xs" rounded="rounded-full" />
|
||||
<span>mo</span>
|
||||
</span>
|
||||
</LinearPropRow>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.labels")}>
|
||||
<div className="flex flex-wrap gap-1">
|
||||
<span className="inline-flex items-center gap-1 rounded-full border border-[#2A2F3D] bg-[#1A1D26] px-2 py-[1px] text-[10.5px] text-[#C5CCDF]">
|
||||
<span className="h-1.5 w-1.5 rounded-full bg-[#5E6AD2]" />
|
||||
mobile
|
||||
</span>
|
||||
<span className="inline-flex items-center gap-1 rounded-full border border-[#2A2F3D] bg-[#1A1D26] px-2 py-[1px] text-[10.5px] text-[#C5CCDF]">
|
||||
<span className="h-1.5 w-1.5 rounded-full bg-[#6CB17B]" />
|
||||
relay
|
||||
</span>
|
||||
</div>
|
||||
</LinearPropRow>
|
||||
|
||||
<LinearPropRow label={t("hub.demo.linear.daemon")}>
|
||||
<span className="rounded border border-[#2A2F3D] bg-[#1A1D26] px-1.5 py-0.5 font-mono text-[10.5px] text-[#C5CCDF]">
|
||||
devbox
|
||||
</span>
|
||||
</LinearPropRow>
|
||||
</aside>
|
||||
);
|
||||
}
|
||||
|
||||
function LinearPropRow({ label, children }: { label: string; children: React.ReactNode }) {
|
||||
return (
|
||||
<div className="space-y-1">
|
||||
<p className="text-[10.5px] text-[#6D7385]">{label}</p>
|
||||
<div>{children}</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -1,208 +0,0 @@
|
||||
import { Check, Clock, GitPullRequest, Hash, TrendingDown } from "lucide-react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import {
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
import { SlackColorMark } from "./slack-mockup";
|
||||
|
||||
const STEP_DELAYS = {
|
||||
triggered: 0.06,
|
||||
prOpened: 0.7,
|
||||
slackDigest: 1.4,
|
||||
} as const;
|
||||
|
||||
const SCHEDULE_COMPONENTS = {
|
||||
code: (
|
||||
<code className="rounded bg-white/[0.07] px-1.5 py-[1px] font-mono text-[11px] text-white/90" />
|
||||
),
|
||||
pr: <span className="font-medium text-[#1D9BD1] underline decoration-[#1D9BD1]/40" />,
|
||||
strong: <strong className="font-semibold text-white" />,
|
||||
};
|
||||
|
||||
export function SchedulesSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.schedules.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-white/[0.1] bg-[#121716]"
|
||||
>
|
||||
<ScheduleChrome />
|
||||
<ScheduleHeaderBar />
|
||||
<div className="flex flex-1 flex-col justify-between gap-3 px-4 py-3.5">
|
||||
<ScheduleStepsList />
|
||||
<ScheduleImpactMetrics />
|
||||
<ScheduleSlackDigestCard />
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function ScheduleChrome() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex min-h-9 shrink-0 items-center justify-between gap-2 border-b border-white/[0.07] bg-[#0D1211] px-3.5 py-1">
|
||||
<div className="flex min-w-0 items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<div className="flex min-w-0 items-center gap-1.5 font-mono text-[11.5px] text-white/65">
|
||||
<Clock className="h-3.5 w-3.5 shrink-0 text-accent-text" aria-hidden="true" />
|
||||
<span className="wrap-anywhere">.paseo/triggers/daily-ci-optimizer.yml</span>
|
||||
</div>
|
||||
</div>
|
||||
<span className="inline-flex shrink-0 items-center gap-1.5 rounded-full border border-brand-green/50 bg-brand-green/20 px-2 py-0.5 text-[10.5px] font-medium text-accent-text">
|
||||
<span className="h-1.5 w-1.5 rounded-full bg-[#35C264]" />
|
||||
{t("hub.demo.schedules.active")}
|
||||
</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function ScheduleHeaderBar() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex shrink-0 flex-wrap items-center justify-between gap-2 border-b border-white/[0.07] bg-white/[0.02] px-4 py-2.5">
|
||||
<div>
|
||||
<h4 className="text-[14px] font-semibold text-white/95">
|
||||
{t("hub.demo.schedules.jobTitle")}
|
||||
</h4>
|
||||
<p className="text-[11.5px] text-white/55">{t("hub.demo.schedules.cadence")}</p>
|
||||
</div>
|
||||
<div className="flex flex-wrap items-center gap-1.5 font-mono text-[11px]">
|
||||
<span className="rounded border border-white/10 bg-[#0D1211] px-2 py-0.5 text-accent-text">
|
||||
0 7 * * 1-5
|
||||
</span>
|
||||
<span className="rounded border border-white/10 bg-[#0D1211] px-2 py-0.5 text-white/70">
|
||||
devbox · Claude Code
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function ScheduleStepsList() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="space-y-3">
|
||||
<MockupStep delay={STEP_DELAYS.triggered} className="flex items-start gap-2.5">
|
||||
<span className="mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-brand-green/45 bg-brand-green/15 text-accent-text">
|
||||
<Check className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
</span>
|
||||
<div className="min-w-0 flex-1">
|
||||
<div className="flex items-center justify-between gap-2 text-[12px]">
|
||||
<span className="font-medium text-white/90">{t("hub.demo.schedules.step1Title")}</span>
|
||||
<span className="font-mono text-[11px] text-white/40">7:00 AM</span>
|
||||
</div>
|
||||
<p className="mt-0.5 text-[12px] leading-relaxed text-white/65">
|
||||
<Trans i18nKey="hub.demo.schedules.step1Detail" components={SCHEDULE_COMPONENTS} />
|
||||
</p>
|
||||
</div>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep delay={STEP_DELAYS.prOpened} className="flex items-start gap-2.5">
|
||||
<span className="mt-0.5 flex h-6 w-6 shrink-0 items-center justify-center rounded-full border border-brand-green/45 bg-brand-green/15 text-accent-text">
|
||||
<GitPullRequest className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
</span>
|
||||
<div className="min-w-0 flex-1">
|
||||
<div className="flex items-center justify-between gap-2 text-[12px]">
|
||||
<span className="font-medium text-white/90">{t("hub.demo.schedules.step2Title")}</span>
|
||||
<span className="font-mono text-[11px] text-white/40">7:04 AM</span>
|
||||
</div>
|
||||
<SchedulePrPill />
|
||||
</div>
|
||||
</MockupStep>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SchedulePrPill() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="mt-1.5 flex flex-wrap items-center justify-between gap-2 rounded-lg border border-white/[0.08] bg-[#171E1D] px-3 py-2">
|
||||
<div className="flex min-w-0 items-center gap-1.5 text-[12px]">
|
||||
<span className="font-medium text-white/90">
|
||||
perf(ci): cache cargo target & stabilize e2e wait
|
||||
</span>
|
||||
<span className="font-mono text-[11px] text-white/45">#2831</span>
|
||||
</div>
|
||||
<div className="flex min-w-0 flex-wrap items-center gap-1.5 font-mono text-[10.5px]">
|
||||
<span className="inline-flex items-center gap-1 rounded bg-[#2BAC76]/15 px-1.5 py-0.5 text-[#6CB17B]">
|
||||
<TrendingDown className="h-3 w-3" aria-hidden="true" />
|
||||
CI -38%
|
||||
</span>
|
||||
<span className="inline-flex items-center gap-1 rounded border border-white/10 bg-white/[0.04] px-1.5 py-0.5 text-white/70">
|
||||
<Check className="h-3 w-3 text-[#6CB17B]" aria-hidden="true" />
|
||||
{t("hub.demo.shared.testsPassed")}
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function ScheduleImpactMetrics() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={1.05}
|
||||
className="grid grid-cols-3 divide-x divide-white/[0.07] overflow-hidden rounded-lg border border-white/[0.07] bg-white/[0.02]"
|
||||
>
|
||||
<div className="px-3 py-2">
|
||||
<p className="text-[10.5px] text-white/45">{t("hub.demo.schedules.metricRuntime")}</p>
|
||||
<p className="mt-0.5 font-mono text-[12px] font-medium text-accent-text">7m 12s → 4m 28s</p>
|
||||
</div>
|
||||
<div className="px-3 py-2">
|
||||
<p className="text-[10.5px] text-white/45">{t("hub.demo.schedules.metricFlake")}</p>
|
||||
<p className="mt-0.5 font-mono text-[12px] font-medium text-accent-text">18% → 0%</p>
|
||||
</div>
|
||||
<div className="px-3 py-2">
|
||||
<p className="text-[10.5px] text-white/45">{t("hub.demo.schedules.metricCache")}</p>
|
||||
<p className="mt-0.5 font-mono text-[12px] font-medium text-white/85">94% hit</p>
|
||||
</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function ScheduleSlackDigestCard() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.slackDigest}
|
||||
className="overflow-hidden rounded-lg border border-[#35373B] bg-[#1A1D21]"
|
||||
>
|
||||
<div className="flex items-center justify-between border-b border-[#2C2D30] bg-[#14161A] px-3 py-1.5 text-[11px] text-[#ABABAD]">
|
||||
<span className="inline-flex items-center gap-1.5 font-medium text-[#E5E7EB]">
|
||||
<SlackColorMark className="h-3 w-3" />
|
||||
<Hash className="h-3 w-3 text-[#ABABAD]" aria-hidden="true" />
|
||||
engineering
|
||||
</span>
|
||||
<span>{t("hub.demo.schedules.slackPosted")}</span>
|
||||
</div>
|
||||
|
||||
<div className="flex items-start gap-2.5 px-3.5 py-3">
|
||||
<PaseoBotAvatar size="sm" className="mt-0.5 h-8 w-8" />
|
||||
<div className="min-w-0 flex-1 space-y-1.5">
|
||||
<div className="flex items-center gap-1.5">
|
||||
<span className="text-[13px] font-bold text-[#F8F8F8]">paseo-bot</span>
|
||||
<span className="rounded-[3px] bg-[#2C2D30] px-1.5 py-[1px] text-[9.5px] font-semibold uppercase tracking-wide text-[#ABABAD]">
|
||||
{t("hub.demo.shared.appBadge")}
|
||||
</span>
|
||||
<span className="text-[11px] text-[#ABABAD]">7:05 AM</span>
|
||||
</div>
|
||||
<p className="text-[12.5px] leading-[1.45] text-[#D1D2D3]">
|
||||
<Trans i18nKey="hub.demo.schedules.slackSummary" components={SCHEDULE_COMPONENTS} />
|
||||
</p>
|
||||
<div className="flex flex-wrap items-center gap-2 pt-0.5">
|
||||
<OpenInPaseoChip variant="slack" />
|
||||
<span className="text-[11px] text-[#ABABAD]">{t("hub.demo.schedules.notifiedMo")}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
@@ -1,165 +0,0 @@
|
||||
import { motion, type Variants } from "framer-motion";
|
||||
import type * as React from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { PaseoMark } from "~/components/paseo-brand";
|
||||
|
||||
export interface SourceMockupProps {
|
||||
/** Whether the section is visible or reduced motion is requested. */
|
||||
active: boolean;
|
||||
reduceMotion: boolean;
|
||||
}
|
||||
|
||||
export const STEP_VARIANTS: Variants = {
|
||||
hidden: { opacity: 0, y: 6 },
|
||||
shown: (delay: number) => ({
|
||||
opacity: 1,
|
||||
y: 0,
|
||||
transition: { delay, duration: 0.32, ease: "easeOut" },
|
||||
}),
|
||||
};
|
||||
|
||||
type AvatarSize = "xs" | "sm" | "md";
|
||||
|
||||
const AVATAR_DIM: Record<AvatarSize, string> = {
|
||||
xs: "h-4 w-4",
|
||||
sm: "h-6 w-6",
|
||||
md: "h-8 w-8 sm:h-9 sm:w-9",
|
||||
};
|
||||
|
||||
const AVATAR_PX: Record<AvatarSize, number> = {
|
||||
xs: 16,
|
||||
sm: 24,
|
||||
md: 36,
|
||||
};
|
||||
|
||||
const BOT_ICON_DIM: Record<AvatarSize, string> = {
|
||||
xs: "h-2.5 w-2.5",
|
||||
sm: "h-3.5 w-3.5",
|
||||
md: "h-4 w-4 sm:h-5 sm:w-5",
|
||||
};
|
||||
|
||||
type OpenChipVariant = "brand" | "slack" | "discord" | "subtle";
|
||||
|
||||
const OPEN_CHIP_STYLES: Record<OpenChipVariant, string> = {
|
||||
brand: "bg-[#20744A] text-white",
|
||||
slack: "bg-[#007A5A] text-white",
|
||||
discord: "bg-[#248046] text-white",
|
||||
subtle: "border border-brand-green/50 bg-brand-green/20 text-[#9FE0B0]",
|
||||
};
|
||||
|
||||
export function MockupStep({
|
||||
delay,
|
||||
className,
|
||||
children,
|
||||
}: {
|
||||
delay: number;
|
||||
className?: string;
|
||||
children: React.ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<motion.div variants={STEP_VARIANTS} custom={delay} className={className}>
|
||||
{children}
|
||||
</motion.div>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Animated root container for a single source mockup. Keeps outer dimensions locked to the stage
|
||||
* so switching tabs or stepping through animations never shifts page layout.
|
||||
*/
|
||||
export function MockupStageWindow({
|
||||
ariaLabel,
|
||||
active,
|
||||
reduceMotion,
|
||||
className = "",
|
||||
children,
|
||||
}: {
|
||||
ariaLabel: string;
|
||||
active: boolean;
|
||||
reduceMotion: boolean;
|
||||
className?: string;
|
||||
children: React.ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<motion.div
|
||||
role="img"
|
||||
aria-label={ariaLabel}
|
||||
initial={reduceMotion ? "shown" : "hidden"}
|
||||
animate={reduceMotion || active ? "shown" : "hidden"}
|
||||
className={`flex h-full flex-col overflow-hidden rounded-xl border wrap-anywhere shadow-[0_24px_64px_-24px_rgba(0,0,0,0.75)] ${className}`}
|
||||
>
|
||||
{children}
|
||||
</motion.div>
|
||||
);
|
||||
}
|
||||
|
||||
/** Mo's photo avatar used consistently across all source mockups. */
|
||||
export function MoAvatar({
|
||||
size = "md",
|
||||
rounded = "rounded-[6px]",
|
||||
className = "",
|
||||
}: {
|
||||
size?: AvatarSize;
|
||||
rounded?: string;
|
||||
className?: string;
|
||||
}) {
|
||||
const px = AVATAR_PX[size];
|
||||
return (
|
||||
<img
|
||||
src="/9viSwGkz_400x400.jpg"
|
||||
alt=""
|
||||
width={px}
|
||||
height={px}
|
||||
loading="lazy"
|
||||
decoding="async"
|
||||
className={`shrink-0 object-cover ${AVATAR_DIM[size]} ${rounded} ${className}`}
|
||||
/>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Paseo bot avatar using the canonical Paseo butterfly mark (`PaseoMark`).
|
||||
* Used consistently for `paseo-bot` across Slack, GitHub, Linear, Discord, Schedules, and Webhooks.
|
||||
*/
|
||||
export function PaseoBotAvatar({
|
||||
size = "md",
|
||||
rounded = "rounded-[6px]",
|
||||
className = "",
|
||||
}: {
|
||||
size?: AvatarSize;
|
||||
rounded?: string;
|
||||
className?: string;
|
||||
}) {
|
||||
return (
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className={`inline-flex shrink-0 items-center justify-center border border-white/14 bg-[#101615] ${AVATAR_DIM[size]} ${rounded} ${className}`}
|
||||
>
|
||||
<PaseoMark className={`${BOT_ICON_DIM[size]} text-white`} />
|
||||
</span>
|
||||
);
|
||||
}
|
||||
|
||||
/** Consistent "Open in Paseo" action chip rendered inside source mockups. */
|
||||
export function OpenInPaseoChip({ variant = "brand" }: { variant?: OpenChipVariant }) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<span
|
||||
className={`inline-flex items-center gap-1.5 rounded-[5px] px-2.5 py-1 text-[11.5px] font-medium ${OPEN_CHIP_STYLES[variant]}`}
|
||||
>
|
||||
<PaseoMark className="h-3.5 w-3.5 shrink-0 text-current" />
|
||||
<span>{t("hub.demo.shared.openInPaseo")}</span>
|
||||
</span>
|
||||
);
|
||||
}
|
||||
|
||||
/** macOS-style window traffic lights for desktop-style mockup headers. */
|
||||
export function WindowTrafficLights() {
|
||||
return (
|
||||
<div className="flex items-center gap-1.5" aria-hidden="true">
|
||||
<span className="h-2.5 w-2.5 rounded-full bg-[#FF5F57]/85" />
|
||||
<span className="h-2.5 w-2.5 rounded-full bg-[#FEBC2E]/85" />
|
||||
<span className="h-2.5 w-2.5 rounded-full bg-[#28C840]/85" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -1,380 +0,0 @@
|
||||
import { motion, type Variants } from "framer-motion";
|
||||
import {
|
||||
AtSign,
|
||||
Check,
|
||||
ChevronDown,
|
||||
ChevronLeft,
|
||||
ChevronRight,
|
||||
Code,
|
||||
GitPullRequest,
|
||||
Hash,
|
||||
Plus,
|
||||
Search,
|
||||
SendHorizontal,
|
||||
SquarePen,
|
||||
} from "lucide-react";
|
||||
import type { ReactNode } from "react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import { PaseoMark } from "~/components/paseo-brand";
|
||||
import {
|
||||
MoAvatar,
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
|
||||
const DEMO_ISSUES = [
|
||||
{ id: "#2811", title: "Terminal output drops under load" },
|
||||
{ id: "#2804", title: "Relay reconnect loop on Android after sleep" },
|
||||
{ id: "#2799", title: "Worktree cleanup leaves stale branches" },
|
||||
] as const;
|
||||
|
||||
const SIDEBAR_CHANNELS = ["general", "engineering", "incidents", "releases"] as const;
|
||||
|
||||
const STEP_DELAYS = {
|
||||
firstPrompt: 0.06,
|
||||
firstReply: 0.65,
|
||||
followUp: 1.35,
|
||||
finalReply: 2.05,
|
||||
} as const;
|
||||
|
||||
const TYPING_VARIANTS: Variants = {
|
||||
hidden: { opacity: 0 },
|
||||
shown: {
|
||||
opacity: [0, 1, 1, 0, 0, 1, 1, 0],
|
||||
transition: {
|
||||
duration: 2.4,
|
||||
times: [0, 0.08, 0.24, 0.28, 0.56, 0.62, 0.84, 0.9],
|
||||
ease: "linear",
|
||||
},
|
||||
},
|
||||
};
|
||||
|
||||
const SLACK_COMPONENTS = {
|
||||
mention: <SlackMention />,
|
||||
host: (
|
||||
<span className="rounded-[3px] border border-white/10 bg-[#222529] px-1.5 py-[1px] font-mono text-[11.5px] text-[#E8912D]" />
|
||||
),
|
||||
pr: <span className="font-medium text-[#1D9BD1] underline decoration-[#1D9BD1]/40" />,
|
||||
};
|
||||
|
||||
export function SlackSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.slack.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-[#35373B] bg-[#1A1D21]"
|
||||
>
|
||||
<SlackWindowChrome />
|
||||
<div className="grid min-h-0 flex-1 grid-cols-1 md:grid-cols-[164px_minmax(0,1fr)]">
|
||||
<SlackSidebar />
|
||||
<div className="flex min-h-0 min-w-0 flex-col bg-[#1A1D21]">
|
||||
<SlackChannelHeader />
|
||||
<SlackMessageFeed />
|
||||
<SlackComposer />
|
||||
<SlackTypingStatus reduced={reduceMotion} />
|
||||
</div>
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackWindowChrome() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex h-9 shrink-0 items-center justify-between border-b border-[#2C2D30] bg-[#121016] px-3.5">
|
||||
<div className="flex items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<div className="hidden items-center gap-1 text-[#ABABAD]/60 sm:flex" aria-hidden="true">
|
||||
<ChevronLeft className="h-3.5 w-3.5" />
|
||||
<ChevronRight className="h-3.5 w-3.5" />
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div className="flex h-6 w-44 items-center gap-1.5 rounded-[5px] bg-white/[0.08] px-2.5 text-[11px] text-[#ABABAD] sm:w-56">
|
||||
<Search className="h-3 w-3 shrink-0 text-[#ABABAD]/75" aria-hidden="true" />
|
||||
<span className="truncate">{t("hub.demo.slack.searchPlaceholder")}</span>
|
||||
</div>
|
||||
|
||||
<SlackColorMark className="h-3.5 w-3.5 shrink-0" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackSidebar() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<aside
|
||||
aria-hidden="true"
|
||||
className="hidden flex-col border-r border-[#2C2D30] bg-[#19171D] md:flex"
|
||||
>
|
||||
<div className="flex items-center justify-between border-b border-white/[0.07] px-3 py-2.5">
|
||||
<div className="flex items-center gap-1 text-[13.5px] font-bold text-[#F8F8F8]">
|
||||
<span>Paseo</span>
|
||||
<ChevronDown className="h-3.5 w-3.5 text-[#ABABAD]" />
|
||||
</div>
|
||||
<SquarePen className="h-3.5 w-3.5 text-[#ABABAD]" />
|
||||
</div>
|
||||
|
||||
<div className="space-y-4 px-2 py-3 text-[12.5px]">
|
||||
<div className="space-y-0.5">
|
||||
<p className="px-2 pb-1 text-[11px] font-medium text-[#ABABAD]/75">
|
||||
{t("hub.demo.slack.channels")}
|
||||
</p>
|
||||
{SIDEBAR_CHANNELS.map((channel) => (
|
||||
<div
|
||||
key={channel}
|
||||
className={`flex items-center gap-1.5 rounded-[6px] px-2 py-1 ${
|
||||
channel === "engineering" ? "bg-[#1164A3] font-medium text-white" : "text-[#ABABAD]"
|
||||
}`}
|
||||
>
|
||||
<Hash className="h-3.5 w-3.5 shrink-0 opacity-80" />
|
||||
<span className="truncate">{channel}</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
|
||||
<div className="space-y-0.5">
|
||||
<p className="px-2 pb-1 text-[11px] font-medium text-[#ABABAD]/75">
|
||||
{t("hub.demo.slack.apps")}
|
||||
</p>
|
||||
<div className="flex items-center gap-2 rounded-[6px] px-2 py-1 text-[#D1D2D3]">
|
||||
<span className="relative flex h-4 w-4 shrink-0 items-center justify-center rounded-[4px] bg-[#101615] ring-1 ring-white/15">
|
||||
<PaseoMark className="h-2.5 w-2.5 text-white" />
|
||||
<span className="absolute -right-0.5 -bottom-0.5 h-1.5 w-1.5 rounded-full bg-[#2BAC76] ring-1 ring-[#19171D]" />
|
||||
</span>
|
||||
<span className="truncate">paseo-bot</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</aside>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackChannelHeader() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex shrink-0 items-center justify-between gap-3 border-b border-[#2C2D30] px-4 py-2">
|
||||
<div className="flex min-w-0 items-center gap-2">
|
||||
<div className="flex items-center gap-1 text-[14px] font-bold text-[#F8F8F8]">
|
||||
<Hash className="h-3.5 w-3.5 shrink-0 text-[#D1D2D3]" aria-hidden="true" />
|
||||
<span>engineering</span>
|
||||
</div>
|
||||
<span className="hidden truncate text-[11.5px] text-[#ABABAD] sm:inline">
|
||||
{t("hub.demo.slack.channelTopic")}
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div
|
||||
aria-hidden="true"
|
||||
className="flex shrink-0 items-center gap-1.5 rounded-[5px] border border-[#35373B] px-2 py-0.5 text-[11px] text-[#ABABAD]"
|
||||
>
|
||||
<div className="flex -space-x-1">
|
||||
<MoAvatar size="xs" rounded="rounded-[3px]" className="ring-1 ring-[#1A1D21]" />
|
||||
<span className="flex h-4 w-4 items-center justify-center rounded-[3px] bg-[#101615] ring-1 ring-[#1A1D21]">
|
||||
<PaseoMark className="h-2.5 w-2.5 text-white" />
|
||||
</span>
|
||||
</div>
|
||||
<span className="tabular-nums">4</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackMessageFeed() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex-1 space-y-2.5 px-4 py-2.5">
|
||||
<MockupStep delay={STEP_DELAYS.firstPrompt}>
|
||||
<SlackMessage author="mo" time="9:41 AM">
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.slack.showIssues" components={SLACK_COMPONENTS} />
|
||||
</p>
|
||||
</SlackMessage>
|
||||
</MockupStep>
|
||||
|
||||
<div className="ml-2.5 sm:ml-3.5">
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.firstReply}
|
||||
className="space-y-1.5 border-l-2 border-[#2C2D30] pb-2.5 pl-3 sm:pl-3.5"
|
||||
>
|
||||
<div className="flex items-center gap-2 text-[11px]">
|
||||
<span className="font-medium text-[#1D9BD1]">{t("hub.demo.slack.threadReplies")}</span>
|
||||
<span className="h-px flex-1 bg-[#2C2D30]" aria-hidden="true" />
|
||||
</div>
|
||||
|
||||
<SlackMessage author="paseo-bot" time="9:41 AM" bot>
|
||||
<p>{t("hub.demo.slack.issuesOpen")}</p>
|
||||
<ul className="mt-1 space-y-0.5 border-l-[3px] border-[#36C5F0] pl-2.5 text-[12px]">
|
||||
{DEMO_ISSUES.map((issue) => (
|
||||
<li key={issue.id} className="flex flex-wrap items-baseline gap-x-1.5">
|
||||
<span className="font-mono text-[11.5px] font-medium text-[#1D9BD1]">
|
||||
{issue.id}
|
||||
</span>
|
||||
<span className="text-[#D1D2D3]">{issue.title}</span>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</SlackMessage>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.followUp}
|
||||
className="border-l-2 border-[#2C2D30] pb-2.5 pl-3 sm:pl-3.5"
|
||||
>
|
||||
<SlackMessage author="mo" time="9:43 AM">
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.slack.createPr" components={SLACK_COMPONENTS} />
|
||||
</p>
|
||||
</SlackMessage>
|
||||
</MockupStep>
|
||||
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.finalReply}
|
||||
className="border-l-2 border-[#2C2D30] pl-3 sm:pl-3.5"
|
||||
>
|
||||
<SlackMessage author="paseo-bot" time="9:48 AM" bot>
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.slack.ranOn" components={SLACK_COMPONENTS} />
|
||||
</p>
|
||||
<SlackPrAttachment />
|
||||
</SlackMessage>
|
||||
</MockupStep>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackPrAttachment() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="mt-1.5 space-y-1.5 border-l-[3px] border-[#2BAC76] pl-2.5">
|
||||
<div className="flex flex-wrap items-center gap-1.5">
|
||||
<span className="inline-flex items-center gap-1 rounded-[4px] bg-[#2BAC76]/15 px-2 py-0.5 font-mono text-[11px] text-[#4CD99B]">
|
||||
<GitPullRequest className="h-3 w-3" aria-hidden="true" />
|
||||
{t("hub.demo.slack.filesChanged")}
|
||||
</span>
|
||||
<span className="inline-flex items-center gap-1 rounded-[4px] border border-[#35373B] bg-[#222529] px-2 py-0.5 font-mono text-[11px] text-[#ABABAD]">
|
||||
<Check className="h-3 w-3 text-[#2BAC76]" aria-hidden="true" />
|
||||
{t("hub.demo.shared.testsPassed")}
|
||||
</span>
|
||||
</div>
|
||||
<div>
|
||||
<OpenInPaseoChip variant="slack" />
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackMessage({
|
||||
author,
|
||||
time,
|
||||
bot,
|
||||
children,
|
||||
}: {
|
||||
author: string;
|
||||
time: string;
|
||||
bot?: boolean;
|
||||
children: ReactNode;
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex items-start gap-2.5">
|
||||
{bot ? (
|
||||
<PaseoBotAvatar size="sm" className="mt-0.5 h-8 w-8" />
|
||||
) : (
|
||||
<MoAvatar size="sm" className="mt-0.5 h-8 w-8" />
|
||||
)}
|
||||
<div className="min-w-0 flex-1 space-y-0.5">
|
||||
<div className="flex flex-wrap items-center gap-1.5">
|
||||
<span className="text-[13px] font-bold text-[#F8F8F8]">{author}</span>
|
||||
{bot ? (
|
||||
<span className="rounded-[3px] bg-[#2C2D30] px-1.5 py-[1px] text-[9.5px] font-semibold uppercase tracking-wide text-[#ABABAD]">
|
||||
{t("hub.demo.shared.appBadge")}
|
||||
</span>
|
||||
) : null}
|
||||
<span className="text-[10.5px] text-[#ABABAD]">{time}</span>
|
||||
</div>
|
||||
<div className="text-[12.5px] leading-[1.42] text-[#D1D2D3]">{children}</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackMention() {
|
||||
return (
|
||||
<span className="rounded-[3px] bg-[#1D9BD1]/20 px-1 py-[1px] font-medium text-[#1D9BD1]">
|
||||
@paseo-bot
|
||||
</span>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackComposer() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div
|
||||
aria-hidden="true"
|
||||
className="mx-4 mt-auto rounded-[8px] border border-[#35373B] bg-[#222529]"
|
||||
>
|
||||
<div className="px-3 py-1.5 text-[12.5px] text-[#ABABAD]/70">
|
||||
{t("hub.demo.slack.composerPlaceholder")}
|
||||
</div>
|
||||
<div className="flex items-center justify-between border-t border-white/[0.06] px-2.5 py-1">
|
||||
<div className="flex items-center gap-2.5 text-[#ABABAD]/60">
|
||||
<Plus className="h-3.5 w-3.5" />
|
||||
<AtSign className="h-3.5 w-3.5" />
|
||||
<Code className="h-3.5 w-3.5" />
|
||||
</div>
|
||||
<span className="inline-flex h-5 w-6 items-center justify-center rounded-[4px] bg-[#007A5A]/80 text-white">
|
||||
<SendHorizontal className="h-3 w-3" />
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SlackTypingStatus({ reduced }: { reduced: boolean }) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div aria-hidden="true" className="flex h-6 shrink-0 items-center px-4 pb-1">
|
||||
{reduced ? null : (
|
||||
<motion.span
|
||||
variants={TYPING_VARIANTS}
|
||||
className="inline-flex items-center gap-1.5 text-[11px] text-[#ABABAD]"
|
||||
>
|
||||
<span className="h-1.5 w-1.5 animate-pulse rounded-full bg-[#2BAC76]" />
|
||||
{t("hub.demo.slack.typing")}
|
||||
</motion.span>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export function SlackColorMark(props: React.SVGProps<SVGSVGElement>) {
|
||||
return (
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true" {...props}>
|
||||
<path
|
||||
fill="#E01E5A"
|
||||
d="M5.042 15.165a2.528 2.528 0 0 1-2.52 2.523A2.528 2.528 0 0 1 0 15.165a2.527 2.527 0 0 1 2.522-2.52h2.52v2.52zM6.313 15.165a2.527 2.527 0 0 1 2.521-2.52 2.527 2.527 0 0 1 2.521 2.52v6.313A2.528 2.528 0 0 1 8.834 24a2.528 2.528 0 0 1-2.521-2.522v-6.313z"
|
||||
/>
|
||||
<path
|
||||
fill="#36C5F0"
|
||||
d="M8.834 5.042a2.528 2.528 0 0 1-2.521-2.52A2.528 2.528 0 0 1 8.834 0a2.528 2.528 0 0 1 2.521 2.522v2.52H8.834zM8.834 6.313a2.528 2.528 0 0 1 2.521 2.521 2.528 2.528 0 0 1-2.521 2.521H2.522A2.528 2.528 0 0 1 0 8.834a2.528 2.528 0 0 1 2.522-2.521h6.312z"
|
||||
/>
|
||||
<path
|
||||
fill="#2EB67D"
|
||||
d="M18.956 8.834a2.528 2.528 0 0 1 2.522-2.521A2.528 2.528 0 0 1 24 8.834a2.528 2.528 0 0 1-2.522 2.521h-2.522V8.834zM17.688 8.834a2.528 2.528 0 0 1-2.523 2.521 2.527 2.527 0 0 1-2.52-2.521V2.522A2.527 2.527 0 0 1 15.165 0a2.528 2.528 0 0 1 2.523 2.522v6.312z"
|
||||
/>
|
||||
<path
|
||||
fill="#ECB22E"
|
||||
d="M15.165 18.956a2.528 2.528 0 0 1 2.523 2.522A2.528 2.528 0 0 1 15.165 24a2.527 2.527 0 0 1-2.52-2.522v-2.522h2.52zM15.165 17.688a2.527 2.527 0 0 1-2.52-2.523 2.526 2.526 0 0 1 2.52-2.52h6.313A2.527 2.527 0 0 1 24 15.165a2.528 2.528 0 0 1-2.522 2.523h-6.313z"
|
||||
/>
|
||||
</svg>
|
||||
);
|
||||
}
|
||||
@@ -1,189 +0,0 @@
|
||||
import { ArrowDown, Check, Terminal, Webhook } from "lucide-react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import {
|
||||
MockupStageWindow,
|
||||
MockupStep,
|
||||
OpenInPaseoChip,
|
||||
PaseoBotAvatar,
|
||||
type SourceMockupProps,
|
||||
WindowTrafficLights,
|
||||
} from "./shared";
|
||||
|
||||
const STEP_DELAYS = {
|
||||
curl: 0.06,
|
||||
response: 0.65,
|
||||
runCard: 1.25,
|
||||
} as const;
|
||||
|
||||
const WEBHOOK_ID = "wh_4PCfLx4q46HniZpIeiThI4BmNC4zHGFY";
|
||||
const RUN_ID = "0197e5d2-a70c-4ad0-b7aa-a29154a6bc72";
|
||||
const ACCEPTED_RESPONSE = JSON.stringify({ status: "accepted", runId: RUN_ID });
|
||||
|
||||
const WEBHOOK_COMPONENTS = {
|
||||
code: <code className="font-mono text-[11px] text-white/90" />,
|
||||
pr: <span className="font-mono text-[#6CB17B]">#2834</span>,
|
||||
};
|
||||
|
||||
export function WebhooksSourceMockup({ active, reduceMotion }: SourceMockupProps) {
|
||||
const { t } = useTranslation();
|
||||
|
||||
return (
|
||||
<MockupStageWindow
|
||||
ariaLabel={t("hub.demo.webhooks.alt")}
|
||||
active={active}
|
||||
reduceMotion={reduceMotion}
|
||||
className="border-white/[0.1] bg-[#0C1110]"
|
||||
>
|
||||
<WebhookTerminalChrome />
|
||||
|
||||
<div className="flex flex-1 flex-col justify-between gap-2.5 p-4">
|
||||
<div className="space-y-3">
|
||||
<WebhookCurlBlock />
|
||||
<WebhookResponseBlock />
|
||||
</div>
|
||||
<WebhookRouteConnector />
|
||||
<WebhookRunCard />
|
||||
</div>
|
||||
</MockupStageWindow>
|
||||
);
|
||||
}
|
||||
|
||||
function WebhookTerminalChrome() {
|
||||
return (
|
||||
<div className="flex h-9 shrink-0 items-center justify-between gap-2 border-b border-white/[0.08] bg-[#131918] px-3.5">
|
||||
<div className="flex min-w-0 items-center gap-3">
|
||||
<WindowTrafficLights />
|
||||
<span className="inline-flex min-w-0 items-center gap-1.5 truncate font-mono text-[11.5px] text-white/65">
|
||||
<Terminal className="h-3.5 w-3.5 shrink-0 text-white/45" aria-hidden="true" />
|
||||
<span className="truncate">mo@devbox — zsh</span>
|
||||
</span>
|
||||
</div>
|
||||
<span className="hidden shrink-0 items-center gap-1.5 rounded border border-white/10 bg-white/[0.04] px-2 py-0.5 font-mono text-[10.5px] text-accent-text sm:inline-flex">
|
||||
<Webhook className="h-3 w-3" aria-hidden="true" />
|
||||
POST /webhooks/{WEBHOOK_ID}
|
||||
</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function WebhookRouteConnector() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep delay={0.95} className="flex items-center gap-2.5 px-1 text-[11px] text-white/45">
|
||||
<span className="h-px flex-1 bg-white/[0.07]" aria-hidden="true" />
|
||||
<span className="inline-flex items-center gap-1.5 font-mono text-accent-text/90">
|
||||
<ArrowDown className="h-3 w-3" aria-hidden="true" />
|
||||
{t("hub.demo.webhooks.routedLine")}
|
||||
</span>
|
||||
<span className="h-px flex-1 bg-white/[0.07]" aria-hidden="true" />
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function WebhookCurlBlock() {
|
||||
return (
|
||||
<MockupStep delay={STEP_DELAYS.curl}>
|
||||
<pre className="font-mono text-[11.5px] leading-[1.6] wrap-anywhere whitespace-pre-wrap text-white/80">
|
||||
<code>
|
||||
<span className="select-none text-accent-text">$ </span>
|
||||
<span className="text-white">curl</span> <span className="text-sky-300/90">-X POST</span>{" "}
|
||||
<span className="text-emerald-300/90">
|
||||
https://hub.paseo.sh/webhooks/
|
||||
<wbr />
|
||||
{WEBHOOK_ID}
|
||||
</span>{" "}
|
||||
<span className="text-white/35">\</span>
|
||||
{"\n"}
|
||||
{" "}
|
||||
<span className="text-sky-300/90">-H</span>{" "}
|
||||
<span className="text-amber-200/85">
|
||||
"Authorization: Bearer $WEBHOOK_TOKEN"
|
||||
</span>{" "}
|
||||
<span className="text-white/35">\</span>
|
||||
{"\n"}
|
||||
{" "}
|
||||
<span className="text-sky-300/90">-H</span>{" "}
|
||||
<span className="text-amber-200/85">"Content-Type: application/json"</span>{" "}
|
||||
<span className="text-white/35">\</span>
|
||||
{"\n"}
|
||||
{" "}
|
||||
<span className="text-sky-300/90">-d</span>{" "}
|
||||
<span className="text-white/75">
|
||||
'{"error":"ECONNRESET"}'
|
||||
</span>
|
||||
</code>
|
||||
</pre>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function WebhookResponseBlock() {
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.response}
|
||||
className="rounded-lg border border-brand-green/35 bg-brand-green/[0.08] px-3 py-2 font-mono text-[11.5px] leading-[1.55]"
|
||||
>
|
||||
<div className="flex items-center gap-2 text-[#6CB17B]">
|
||||
<span className="font-semibold">HTTP/2 202 Accepted</span>
|
||||
<span className="text-white/35">·</span>
|
||||
<span className="text-white/55">42ms</span>
|
||||
</div>
|
||||
<div className="mt-0.5 wrap-anywhere text-white/80">{ACCEPTED_RESPONSE}</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
|
||||
function WebhookRunCard() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<MockupStep
|
||||
delay={STEP_DELAYS.runCard}
|
||||
className="rounded-lg border border-white/[0.09] bg-[#141B19] p-3.5"
|
||||
>
|
||||
<div className="flex flex-wrap items-center justify-between gap-2 border-b border-white/[0.07] pb-2.5">
|
||||
<div className="flex items-center gap-2">
|
||||
<PaseoBotAvatar size="sm" />
|
||||
<div>
|
||||
<div className="flex items-center gap-1.5 text-[12.5px]">
|
||||
<span className="font-semibold text-white/95">paseo-bot</span>
|
||||
<span className="font-mono text-[11px] text-white/45">{RUN_ID.slice(0, 8)}…</span>
|
||||
</div>
|
||||
<p className="text-[11px] text-white/55">{t("hub.demo.webhooks.runMeta")}</p>
|
||||
</div>
|
||||
</div>
|
||||
<span className="inline-flex items-center gap-1.5 rounded-full border border-brand-green/50 bg-brand-green/20 px-2 py-0.5 text-[10.5px] font-medium text-accent-text">
|
||||
<span className="h-1.5 w-1.5 rounded-full bg-[#35C264]" />
|
||||
{t("hub.demo.webhooks.statusDone")}
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<ul className="mt-2.5 space-y-1.5 text-[12px] text-white/75">
|
||||
<li className="flex items-start gap-2">
|
||||
<Check className="mt-0.5 h-3.5 w-3.5 shrink-0 text-accent-text" aria-hidden="true" />
|
||||
<span>
|
||||
<Trans i18nKey="hub.demo.webhooks.trace1" components={WEBHOOK_COMPONENTS} />
|
||||
</span>
|
||||
</li>
|
||||
<li className="flex items-start gap-2">
|
||||
<Check className="mt-0.5 h-3.5 w-3.5 shrink-0 text-accent-text" aria-hidden="true" />
|
||||
<span>
|
||||
<Trans i18nKey="hub.demo.webhooks.trace2" components={WEBHOOK_COMPONENTS} />
|
||||
</span>
|
||||
</li>
|
||||
<li className="flex items-start gap-2">
|
||||
<Check className="mt-0.5 h-3.5 w-3.5 shrink-0 text-accent-text" aria-hidden="true" />
|
||||
<span>
|
||||
<Trans i18nKey="hub.demo.webhooks.trace3" components={WEBHOOK_COMPONENTS} />
|
||||
</span>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<div className="mt-3 flex flex-wrap items-center justify-between gap-2 border-t border-white/[0.07] pt-2.5">
|
||||
<OpenInPaseoChip variant="brand" />
|
||||
<span className="font-mono text-[11px] text-white/45">
|
||||
{t("hub.demo.webhooks.triggeredBy")}
|
||||
</span>
|
||||
</div>
|
||||
</MockupStep>
|
||||
);
|
||||
}
|
||||
@@ -1,245 +0,0 @@
|
||||
import { ArrowDown, ArrowRight, Clock, Webhook } from "lucide-react";
|
||||
import type * as React from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { ClaudeCodeIcon, CodexIcon, OpenCodeIcon } from "~/components/agent-icons";
|
||||
import { DiscordIcon, GitHubIcon, LinearIcon, SlackIcon } from "~/components/brand-icons";
|
||||
import { HubLockup, PaseoMark } from "~/components/paseo-brand";
|
||||
|
||||
export type HubTriggerSourceId =
|
||||
| "github"
|
||||
| "linear"
|
||||
| "slack"
|
||||
| "discord"
|
||||
| "schedules"
|
||||
| "webhooks";
|
||||
|
||||
export interface HubTriggerSource {
|
||||
id: HubTriggerSourceId;
|
||||
Icon: React.ComponentType<{ className?: string }>;
|
||||
}
|
||||
|
||||
/** The six automation sources Hub accepts, shared by the homepage and /hub. */
|
||||
export const HUB_TRIGGER_SOURCES: readonly HubTriggerSource[] = [
|
||||
{ id: "github", Icon: GitHubIcon },
|
||||
{ id: "linear", Icon: LinearIcon },
|
||||
{ id: "slack", Icon: SlackIcon },
|
||||
{ id: "discord", Icon: DiscordIcon },
|
||||
{ id: "schedules", Icon: Clock },
|
||||
{ id: "webhooks", Icon: Webhook },
|
||||
] as const;
|
||||
|
||||
/** Examples of agent harnesses on connected daemons. */
|
||||
export const HUB_AGENT_HARNESSES = [
|
||||
{ name: "Claude Code", Icon: ClaudeCodeIcon },
|
||||
{ name: "Codex", Icon: CodexIcon },
|
||||
{ name: "OpenCode", Icon: OpenCodeIcon },
|
||||
] as const;
|
||||
|
||||
const DIAGRAM_DAEMONS = [
|
||||
{ name: "MacBook Pro", agents: HUB_AGENT_HARNESSES },
|
||||
{ name: "Hetzner VM", agents: HUB_AGENT_HARNESSES },
|
||||
] as const;
|
||||
|
||||
const DIAGRAM_CLIENTS = ["desktop", "web", "mobile", "cli"] as const;
|
||||
|
||||
/** Compact flow diagram for the homepage Paseo Hub section, sitting directly on the page background. */
|
||||
export function HubLandingFlow() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="grid items-center gap-5 lg:grid-cols-[minmax(0,1fr)_auto_minmax(0,12rem)_auto_minmax(0,1fr)]">
|
||||
<div className="space-y-2.5">
|
||||
<p className="text-[11px] uppercase tracking-wide text-white/35">
|
||||
{t("landing.hubSection.flowTriggers")}
|
||||
</p>
|
||||
<div className="grid grid-cols-2 gap-2">
|
||||
{HUB_TRIGGER_SOURCES.map(({ id, Icon }) => (
|
||||
<div
|
||||
key={id}
|
||||
className="flex items-center gap-2 rounded-lg border border-white/10 bg-white/[0.03] px-3 py-2"
|
||||
>
|
||||
<Icon className="h-3.5 w-3.5 shrink-0 text-white/70" />
|
||||
<span className="truncate text-xs font-medium text-white/85">
|
||||
{t(`hub.sources.${id}.name`)}
|
||||
</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<FlowArrow />
|
||||
|
||||
<div className="rounded-xl border border-brand-green/50 bg-brand-green/[0.12] px-5 py-5 text-center">
|
||||
<p className="flex justify-center">
|
||||
<HubLockup className="h-5 w-auto text-foreground" />
|
||||
<span className="sr-only">{t("hub.shape.hub")}</span>
|
||||
</p>
|
||||
<p className="mt-2 text-xs text-white/70">{t("hub.shape.hubHosting")}</p>
|
||||
</div>
|
||||
|
||||
<FlowArrow />
|
||||
|
||||
<div className="space-y-2.5">
|
||||
<p className="text-[11px] uppercase tracking-wide text-white/35">
|
||||
{t("landing.hubSection.flowDaemons")}
|
||||
</p>
|
||||
<div className="space-y-2">
|
||||
{DIAGRAM_DAEMONS.map((daemon) => (
|
||||
<CompactDaemonRow key={daemon.name} name={daemon.name} agents={daemon.agents} />
|
||||
))}
|
||||
<div className="flex items-center gap-2 rounded-lg border border-dashed border-white/10 bg-white/[0.015] px-3 py-2 text-xs text-white/60">
|
||||
<PaseoMark className="h-3.5 w-3.5 shrink-0 text-white/75" />
|
||||
<span className="truncate">{t("landing.hubSection.flowOpenSession")}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function CompactDaemonRow({
|
||||
name,
|
||||
agents,
|
||||
}: {
|
||||
name: string;
|
||||
agents: readonly { name: string; Icon: React.ComponentType<{ className?: string }> }[];
|
||||
}) {
|
||||
return (
|
||||
<div className="flex items-center justify-between gap-2 rounded-lg border border-white/10 bg-white/[0.03] px-3 py-2">
|
||||
<span className="flex min-w-0 items-center gap-2">
|
||||
<MachineIcon className="h-4 w-4 shrink-0 text-white/60" />
|
||||
<span className="truncate text-xs font-medium text-white/85">{name}</span>
|
||||
</span>
|
||||
<span className="flex shrink-0 items-center gap-1.5 text-white/45">
|
||||
{agents.map(({ name: agentName, Icon }) => (
|
||||
<span key={agentName} title={agentName}>
|
||||
<Icon className="h-3.5 w-3.5" />
|
||||
</span>
|
||||
))}
|
||||
</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
/** Full vertical infrastructure diagram for the /hub page. */
|
||||
export function HubArchitectureDiagram() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="rounded-xl border border-white/[0.08] bg-white/[0.015] p-6 md:p-8">
|
||||
<div className="flex flex-col items-center">
|
||||
<DiagramRow label={t("hub.shape.triggersRow")}>
|
||||
{HUB_TRIGGER_SOURCES.map(({ id, Icon }) => (
|
||||
<DiagramCard key={id} Icon={Icon} name={t(`hub.sources.${id}.name`)} />
|
||||
))}
|
||||
</DiagramRow>
|
||||
|
||||
<Connector label={t("hub.shape.webhooks")} />
|
||||
|
||||
<div className="w-full max-w-xs rounded-xl border border-brand-green/50 bg-brand-green/[0.12] px-6 py-5 text-center">
|
||||
<p className="flex justify-center">
|
||||
<HubLockup className="h-[22px] w-auto text-foreground" />
|
||||
<span className="sr-only">{t("hub.shape.hub")}</span>
|
||||
</p>
|
||||
<p className="mt-1.5 text-xs text-white/70">{t("hub.shape.hubHosting")}</p>
|
||||
</div>
|
||||
|
||||
<Connector label={t("hub.shape.sameRpcs")} />
|
||||
|
||||
<DiagramRow label={t("hub.shape.daemonsRow")}>
|
||||
{DIAGRAM_DAEMONS.map((daemon) => (
|
||||
<div
|
||||
key={daemon.name}
|
||||
className="flex items-center gap-3 rounded-xl border border-white/10 bg-white/[0.03] px-4 py-3"
|
||||
>
|
||||
<span className="text-white/70">
|
||||
<MachineIcon className="h-5 w-5" />
|
||||
</span>
|
||||
<span className="text-sm font-medium">{daemon.name}</span>
|
||||
<span className="flex items-center gap-2 border-l border-white/10 pl-3 text-white/45">
|
||||
{daemon.agents.map(({ name, Icon }) => (
|
||||
<span key={name} title={name}>
|
||||
<Icon className="h-4 w-4" />
|
||||
</span>
|
||||
))}
|
||||
</span>
|
||||
</div>
|
||||
))}
|
||||
</DiagramRow>
|
||||
|
||||
<Connector label={t("hub.shape.directOrRelay")} />
|
||||
|
||||
<DiagramRow label={t("hub.shape.appsRow")}>
|
||||
{DIAGRAM_CLIENTS.map((client) => (
|
||||
<DiagramCard key={client} name={t(`hub.shape.${client}`)} />
|
||||
))}
|
||||
</DiagramRow>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function FlowArrow() {
|
||||
return (
|
||||
<div className="flex items-center justify-center text-white/30" aria-hidden="true">
|
||||
<ArrowRight className="hidden h-4 w-4 lg:block" />
|
||||
<ArrowDown className="h-4 w-4 lg:hidden" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiagramRow({ label, children }: { label: string; children: React.ReactNode }) {
|
||||
return (
|
||||
<div className="w-full space-y-2.5">
|
||||
<p className="text-center text-xs uppercase tracking-wide text-white/30">{label}</p>
|
||||
<div className="flex flex-wrap justify-center gap-2.5">{children}</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiagramCard({
|
||||
name,
|
||||
Icon,
|
||||
}: {
|
||||
name: string;
|
||||
Icon?: React.ComponentType<{ className?: string }>;
|
||||
}) {
|
||||
return (
|
||||
<div className="flex items-center gap-2 rounded-xl border border-white/10 bg-white/[0.03] px-3.5 py-2.5">
|
||||
{Icon ? (
|
||||
<span className="text-white/70">
|
||||
<Icon className="h-4 w-4" />
|
||||
</span>
|
||||
) : null}
|
||||
<span className="text-sm font-medium">{name}</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function Connector({ label }: { label: string }) {
|
||||
return (
|
||||
<div className="flex flex-col items-center gap-2 py-4">
|
||||
<div className="h-5 w-px border-l border-dashed border-white/25" />
|
||||
<p className="text-center text-[11px] text-white/35">{label}</p>
|
||||
<div className="h-5 w-px border-l border-dashed border-white/25" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function MachineIcon({ className }: { className?: string }) {
|
||||
return (
|
||||
<svg
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="1.5"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
aria-hidden="true"
|
||||
className={className}
|
||||
>
|
||||
<rect x="2" y="2" width="20" height="8" rx="2" />
|
||||
<rect x="2" y="14" width="20" height="8" rx="2" />
|
||||
<circle cx="6" cy="6" r="1" />
|
||||
<circle cx="6" cy="18" r="1" />
|
||||
</svg>
|
||||
);
|
||||
}
|
||||
@@ -88,15 +88,8 @@ import {
|
||||
OpenCodeIcon,
|
||||
PiIcon,
|
||||
} from "~/components/agent-icons";
|
||||
import { HubLandingFlow } from "~/components/hub-flow";
|
||||
import {
|
||||
ChapterBand,
|
||||
ChapterDivider,
|
||||
HairlineGrid,
|
||||
PageHeaderBand,
|
||||
SectionOpener,
|
||||
} from "~/components/page-frame";
|
||||
import { PaseoHubLockup, PaseoHubMark, PaseoMark } from "~/components/paseo-brand";
|
||||
import { DiscordIcon, GitHubIcon, SlackIcon } from "~/components/brand-icons";
|
||||
import { PaseoHubMark } from "~/components/paseo-brand";
|
||||
import {
|
||||
MobileChat,
|
||||
MobileDiff,
|
||||
@@ -107,146 +100,78 @@ import {
|
||||
} from "~/components/mockup";
|
||||
import { FAQItem } from "~/components/faq-item";
|
||||
import { SiteFooter } from "~/components/site-footer";
|
||||
import { HomepageSponsorsSection } from "~/components/sponsorship";
|
||||
import { SponsorSection, SponsorsSection } from "~/components/sponsorship";
|
||||
import { SiteHeader } from "~/components/site-header";
|
||||
import "~/styles.css";
|
||||
|
||||
interface LandingPageProps {
|
||||
title: React.ReactNode;
|
||||
subtitle: React.ReactNode;
|
||||
pluginCount?: number | null;
|
||||
showHubEyebrow?: boolean;
|
||||
}
|
||||
|
||||
export function LandingPage({
|
||||
title,
|
||||
subtitle,
|
||||
pluginCount = null,
|
||||
showHubEyebrow = false,
|
||||
}: LandingPageProps) {
|
||||
export function LandingPage({ title, subtitle }: LandingPageProps) {
|
||||
return (
|
||||
<CursorFieldProvider>
|
||||
<div className="min-h-screen bg-background">
|
||||
<PageHeaderBand />
|
||||
{/* Hero section with background image */}
|
||||
<div className="relative bg-cover bg-center bg-no-repeat">
|
||||
<div className="relative px-6 pt-4 pb-10 md:px-32 md:pt-6 md:pb-12 max-w-7xl mx-auto">
|
||||
<Nav />
|
||||
<Hero title={title} subtitle={subtitle} />
|
||||
<GetStarted />
|
||||
</div>
|
||||
|
||||
<main>
|
||||
{/* Opening bookend: centered hero, interactive desktop mockup, and phone trio */}
|
||||
<ChapterBand spacing="none" ruled={false} ticks={false} framed={false}>
|
||||
<div className="pt-12 pb-8 md:pt-16 md:pb-10">
|
||||
<Hero title={title} subtitle={subtitle} showHubEyebrow={showHubEyebrow} />
|
||||
<GetStarted />
|
||||
</div>
|
||||
{/* Mockup - inside hero so it's above the gradient, positioned to overflow into black section */}
|
||||
<motion.div
|
||||
initial={FADE_IN_UP_40}
|
||||
animate={FADE_IN}
|
||||
transition={EASE_OUT_08_DELAY_05}
|
||||
className="relative px-6 md:px-8 pt-4 md:pt-8 pb-8 md:pb-16"
|
||||
>
|
||||
<div className="max-w-7xl mx-auto">
|
||||
<HeroMockup />
|
||||
</div>
|
||||
</motion.div>
|
||||
</div>
|
||||
|
||||
<motion.div
|
||||
initial={FADE_IN_UP_40}
|
||||
animate={FADE_IN}
|
||||
transition={EASE_OUT_08_DELAY_05}
|
||||
className="relative pt-4 pb-10 md:pt-6 md:pb-14"
|
||||
>
|
||||
<div>
|
||||
<HeroMockup />
|
||||
</div>
|
||||
</motion.div>
|
||||
{/* Phone showcase */}
|
||||
<PhoneShowcase />
|
||||
|
||||
<PhoneShowcase />
|
||||
</ChapterBand>
|
||||
|
||||
{/* Chapter 1: Community proof */}
|
||||
<ChapterBand spacing="compact">
|
||||
{/* Content section */}
|
||||
<div className="landing-content bg-background">
|
||||
<main className="p-6 md:p-20 md:pt-40 max-w-5xl mx-auto">
|
||||
<div className="space-y-24">
|
||||
<SocialProofWall />
|
||||
</ChapterBand>
|
||||
|
||||
{/* Chapter 2: The product (Providers, Deployment, Extensibility, Automation) */}
|
||||
<ChapterBand spacing="none">
|
||||
<div className="py-16 md:py-20">
|
||||
<MultiProviderSection />
|
||||
</div>
|
||||
<ChapterDivider />
|
||||
<div className="py-16 md:py-20">
|
||||
<TurnkeySection />
|
||||
</div>
|
||||
<ChapterDivider />
|
||||
<div className="py-16 md:py-20">
|
||||
<ExtensibleSection pluginCount={pluginCount} />
|
||||
</div>
|
||||
<ChapterDivider />
|
||||
<div className="py-16 md:py-20">
|
||||
<AutomationSection />
|
||||
</div>
|
||||
</ChapterBand>
|
||||
|
||||
{/* Chapter 3: Paseo Hub */}
|
||||
<ChapterBand spacing="chapter" tint="subtle">
|
||||
<HubSection />
|
||||
</ChapterBand>
|
||||
|
||||
{/* Chapter 4: Open source philosophy and consolidated sponsorship */}
|
||||
<ChapterBand spacing="none">
|
||||
<div className="py-16 md:py-20">
|
||||
<PhilosophySection />
|
||||
</div>
|
||||
<ChapterDivider />
|
||||
<div className="py-16 md:py-20">
|
||||
<HomepageSponsorsSection />
|
||||
</div>
|
||||
</ChapterBand>
|
||||
|
||||
{/* Chapter 5: FAQ */}
|
||||
<ChapterBand spacing="section">
|
||||
<MultiProviderSection />
|
||||
<TurnkeySection />
|
||||
<ExtensibleSection />
|
||||
<AutomationSection />
|
||||
<SponsorsSection placement="page" />
|
||||
<SponsorSection />
|
||||
<PhilosophySection />
|
||||
<FAQ />
|
||||
</ChapterBand>
|
||||
|
||||
{/* Closing bookend: centered download CTA */}
|
||||
<ChapterBand spacing="chapter" tint="subtle">
|
||||
<ClosingCtaSection />
|
||||
</ChapterBand>
|
||||
</div>
|
||||
</main>
|
||||
|
||||
<SiteFooter width="default" sponsors={false} />
|
||||
<SiteFooter sponsors={false} />
|
||||
</div>
|
||||
</CursorFieldProvider>
|
||||
);
|
||||
}
|
||||
|
||||
function Hero({
|
||||
title,
|
||||
subtitle,
|
||||
showHubEyebrow = false,
|
||||
}: {
|
||||
title: React.ReactNode;
|
||||
subtitle: React.ReactNode;
|
||||
showHubEyebrow?: boolean;
|
||||
}) {
|
||||
function Nav() {
|
||||
return (
|
||||
<div className="space-y-6 text-center">
|
||||
{showHubEyebrow ? <HubHeroEyebrow /> : null}
|
||||
<h1 className="font-display text-4xl font-semibold tracking-[-0.025em] leading-[1.02] md:text-6xl">
|
||||
{title}
|
||||
</h1>
|
||||
<p className="mx-auto max-w-lg text-base leading-relaxed text-white/70 md:text-lg">
|
||||
{subtitle}
|
||||
</p>
|
||||
</div>
|
||||
<nav className="mb-20 md:mb-24">
|
||||
<SiteHeader />
|
||||
</nav>
|
||||
);
|
||||
}
|
||||
|
||||
function HubHeroEyebrow() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
function Hero({ title, subtitle }: { title: React.ReactNode; subtitle: React.ReactNode }) {
|
||||
return (
|
||||
<div className="flex justify-center">
|
||||
<a
|
||||
href={localize("/hub")}
|
||||
className="group inline-flex max-w-full items-center gap-2 whitespace-nowrap rounded-full border border-white/10 bg-white/[0.04] px-3 py-1 text-xs text-white/75 transition-colors hover:border-white/20 hover:bg-white/[0.08] hover:text-white"
|
||||
>
|
||||
<PaseoHubMark className="h-3.5 w-3.5 shrink-0 text-white/90" />
|
||||
<span className="font-medium text-white/90">{t("landing.hubEyebrow.product")}</span>
|
||||
<span aria-hidden="true" className="h-3 w-px shrink-0 bg-white/15" />
|
||||
<span className="truncate text-white/65">{t("landing.hubEyebrow.label")}</span>
|
||||
<ArrowRight
|
||||
aria-hidden="true"
|
||||
className="h-3.5 w-3.5 shrink-0 text-white/45 transition-transform group-hover:translate-x-0.5 group-hover:text-white/80"
|
||||
/>
|
||||
</a>
|
||||
<div className="space-y-6 text-center">
|
||||
<h1 className="text-4xl md:text-6xl font-medium tracking-tight leading-[0.95]">{title}</h1>
|
||||
<p className="text-base leading-relaxed text-white/70 md:text-lg max-w-lg mx-auto">
|
||||
{subtitle}
|
||||
</p>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -376,14 +301,12 @@ function AgentBadge({ name, Icon }: (typeof FEATURED_AGENTS)[number]) {
|
||||
}
|
||||
|
||||
function FeatureSection({
|
||||
eyebrow,
|
||||
title,
|
||||
description,
|
||||
badge,
|
||||
links,
|
||||
children,
|
||||
}: {
|
||||
eyebrow?: string;
|
||||
title: string;
|
||||
description: string;
|
||||
badge?: string;
|
||||
@@ -397,18 +320,54 @@ function FeatureSection({
|
||||
viewport={VIEWPORT_60}
|
||||
transition={EASE_OUT_05}
|
||||
>
|
||||
<SectionOpener
|
||||
eyebrow={eyebrow}
|
||||
title={title}
|
||||
description={description}
|
||||
badge={badge}
|
||||
links={links}
|
||||
/>
|
||||
<SectionTitle title={title} description={description} badge={badge} links={links} />
|
||||
{children}
|
||||
</motion.section>
|
||||
);
|
||||
}
|
||||
|
||||
function SectionTitle({
|
||||
title,
|
||||
description,
|
||||
badge,
|
||||
links,
|
||||
}: {
|
||||
title: string;
|
||||
description: string;
|
||||
badge?: string;
|
||||
links?: ReadonlyArray<{ href: string; label: string }>;
|
||||
}) {
|
||||
return (
|
||||
<div className="mb-12 space-y-2">
|
||||
<div className="flex items-center gap-3">
|
||||
<h2 className="text-3xl font-medium">{title}</h2>
|
||||
{badge && (
|
||||
<span className="rounded-full bg-emerald-400/10 px-2 py-1 text-xs text-emerald-300">
|
||||
{badge}
|
||||
</span>
|
||||
)}
|
||||
</div>
|
||||
<p className="text-base text-pretty text-muted-foreground max-w-lg">{description}</p>
|
||||
{links ? (
|
||||
<div className="flex flex-wrap gap-x-4 gap-y-1 pt-1 text-xs">
|
||||
{links.map((link) => (
|
||||
<a
|
||||
key={link.href}
|
||||
href={link.href}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-1 text-extra-muted-foreground transition-colors hover:text-muted-foreground"
|
||||
>
|
||||
{link.label}
|
||||
<ExternalLink className="h-3 w-3" />
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
) : null}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function SocialProofWall() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
@@ -418,7 +377,7 @@ function SocialProofWall() {
|
||||
viewport={VIEWPORT_60}
|
||||
transition={EASE_OUT_05}
|
||||
>
|
||||
<SectionOpener
|
||||
<SectionTitle
|
||||
title={t("landing.socialProof.title")}
|
||||
description={t("landing.socialProof.description")}
|
||||
/>
|
||||
@@ -465,7 +424,7 @@ function SocialProofCard({ tweet, inert }: { tweet: SocialProofTweet; inert?: bo
|
||||
target="_blank"
|
||||
rel="noreferrer"
|
||||
tabIndex={inert ? -1 : undefined}
|
||||
className="group flex h-[154px] w-[300px] shrink-0 flex-col justify-between overflow-hidden rounded-xl border border-white/[0.08] bg-white/[0.02] p-4 transition-colors hover:border-white/20 hover:bg-white/[0.04] md:w-[380px]"
|
||||
className="group flex h-[154px] w-[320px] shrink-0 flex-col justify-between overflow-hidden rounded-2xl border border-white/10 bg-white/[0.03] p-4 transition-colors hover:border-white/20 hover:bg-white/[0.05] md:w-[420px]"
|
||||
aria-label={t("landing.socialProof.readPost", { name: tweet.name })}
|
||||
>
|
||||
<div>
|
||||
@@ -494,34 +453,30 @@ function MultiProviderSection() {
|
||||
const localize = useLocalizePath();
|
||||
return (
|
||||
<FeatureSection
|
||||
eyebrow={t("landing.eyebrows.providers")}
|
||||
title={t("landing.providers.title")}
|
||||
description={t("landing.providers.description")}
|
||||
>
|
||||
<HairlineGrid columns="2-3">
|
||||
<div className="grid grid-cols-2 gap-2 sm:grid-cols-3 sm:gap-4">
|
||||
{FEATURED_AGENTS.map((agent) => (
|
||||
<div
|
||||
key={agent.name}
|
||||
className="flex items-center gap-3 bg-background px-5 py-4 transition-colors hover:bg-white/[0.025] sm:px-6 sm:py-5"
|
||||
className="flex items-center justify-center gap-2 rounded-xl border border-white/10 bg-white/[0.03] px-3 py-3 sm:gap-3 sm:px-5 sm:py-4"
|
||||
>
|
||||
<span className="shrink-0 text-white/80">
|
||||
<agent.Icon className="h-5 w-5 sm:h-6 sm:w-6" />
|
||||
</span>
|
||||
<span className="truncate text-sm font-medium text-white/90 sm:text-base">
|
||||
{agent.name}
|
||||
<agent.Icon className="h-5 w-5 sm:h-7 sm:w-7" />
|
||||
</span>
|
||||
<span className="truncate text-sm font-medium sm:text-base">{agent.name}</span>
|
||||
</div>
|
||||
))}
|
||||
<a
|
||||
href={localize("/agents")}
|
||||
className="flex items-center justify-between gap-2 bg-background px-5 py-4 text-white/55 transition-colors hover:bg-white/[0.025] hover:text-accent-text sm:px-6 sm:py-5"
|
||||
className="flex items-center justify-center gap-2 rounded-xl border border-dashed border-white/10 bg-white/[0.01] px-3 py-3 text-white/50 hover:text-white/80 hover:border-white/20 hover:bg-white/[0.03] transition-colors sm:gap-3 sm:px-5 sm:py-4"
|
||||
>
|
||||
<span className="text-sm font-medium sm:text-base">
|
||||
{t("common.more", { count: ADDITIONAL_AGENT_COUNT })}
|
||||
</span>
|
||||
<ArrowRight className="h-4 w-4 shrink-0" aria-hidden="true" />
|
||||
</a>
|
||||
</HairlineGrid>
|
||||
</div>
|
||||
</FeatureSection>
|
||||
);
|
||||
}
|
||||
@@ -534,15 +489,13 @@ function TurnkeySection() {
|
||||
title={t("landing.runAnywhere.title")}
|
||||
description={t("landing.runAnywhere.description")}
|
||||
>
|
||||
<div className="overflow-hidden rounded-xl border border-white/[0.08] bg-white/[0.08]">
|
||||
<div className="bg-background p-6 md:p-7">
|
||||
<ProductLead
|
||||
icon={Monitor}
|
||||
title={t("landing.runAnywhere.desktopTitle")}
|
||||
description={t("landing.runAnywhere.desktopDescription")}
|
||||
/>
|
||||
</div>
|
||||
<div className="grid gap-px border-t border-white/[0.08] md:grid-cols-3">
|
||||
<div className="space-y-8">
|
||||
<ProductLead
|
||||
icon={Monitor}
|
||||
title={t("landing.runAnywhere.desktopTitle")}
|
||||
description={t("landing.runAnywhere.desktopDescription")}
|
||||
/>
|
||||
<div className="grid gap-4 md:grid-cols-3">
|
||||
<TurnkeyExtensionCard
|
||||
icon={Smartphone}
|
||||
title={t("landing.runAnywhere.mobileTitle")}
|
||||
@@ -564,6 +517,7 @@ function TurnkeySection() {
|
||||
ctaHref={localize("/hub")}
|
||||
ctaLabel={t("landing.runAnywhere.teamsCta")}
|
||||
ctaIcon={PASEO_HUB_CTA_ICON}
|
||||
showIntegrationIcons
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
@@ -580,6 +534,7 @@ function TurnkeyExtensionCard({
|
||||
ctaHref,
|
||||
ctaLabel,
|
||||
ctaIcon,
|
||||
showIntegrationIcons = false,
|
||||
}: {
|
||||
icon: LucideIcon;
|
||||
title: string;
|
||||
@@ -587,22 +542,34 @@ function TurnkeyExtensionCard({
|
||||
ctaHref: string;
|
||||
ctaLabel: string;
|
||||
ctaIcon?: React.ReactNode;
|
||||
showIntegrationIcons?: boolean;
|
||||
}) {
|
||||
return (
|
||||
<FeatureCell icon={Icon} title={title} description={description}>
|
||||
<a
|
||||
href={ctaHref}
|
||||
className="inline-flex items-center gap-1.5 rounded-full bg-foreground px-3 py-1.5 text-xs font-medium text-background transition-colors hover:bg-foreground/90"
|
||||
>
|
||||
{ctaIcon}
|
||||
{ctaLabel}
|
||||
<ArrowRight className="h-3.5 w-3.5" />
|
||||
</a>
|
||||
</FeatureCell>
|
||||
<FeatureCard icon={Icon} title={title} description={description}>
|
||||
<div className="flex items-center justify-between">
|
||||
<a
|
||||
href={ctaHref}
|
||||
className="inline-flex items-center gap-1.5 rounded-full bg-foreground px-2.5 py-1.5 text-xs text-background transition-colors hover:bg-foreground/90"
|
||||
>
|
||||
{ctaIcon}
|
||||
{ctaLabel}
|
||||
<ArrowRight className="h-3.5 w-3.5" />
|
||||
</a>
|
||||
{showIntegrationIcons ? INTEGRATION_ICONS : null}
|
||||
</div>
|
||||
</FeatureCard>
|
||||
);
|
||||
}
|
||||
|
||||
/** The lead product of a section: an icon tile and title. */
|
||||
const INTEGRATION_ICONS = (
|
||||
<span className="flex items-center gap-2 text-extra-muted-foreground">
|
||||
<GitHubIcon className="h-4 w-4" />
|
||||
<SlackIcon className="h-4 w-4" />
|
||||
<DiscordIcon className="h-4 w-4" />
|
||||
</span>
|
||||
);
|
||||
|
||||
/** The lead product of a section: an icon tile and title on the page background. */
|
||||
function ProductLead({
|
||||
icon: Icon,
|
||||
title,
|
||||
@@ -617,13 +584,13 @@ function ProductLead({
|
||||
return (
|
||||
<div className="flex flex-col gap-6 sm:flex-row sm:items-center sm:justify-between">
|
||||
<div className="flex items-center gap-4">
|
||||
<div className="rounded-lg border border-white/[0.08] bg-white/[0.04] p-3 text-accent-text">
|
||||
<Icon className="h-5 w-5" strokeWidth={1.5} />
|
||||
<div className="rounded-xl border border-white/10 bg-white/[0.06] p-3 text-muted-foreground">
|
||||
<Icon className="h-6 w-6" strokeWidth={1.5} />
|
||||
</div>
|
||||
<div className="space-y-0.5">
|
||||
<h3 className="text-lg font-medium text-white/95">{title}</h3>
|
||||
<h3 className="text-xl font-medium text-white/90">{title}</h3>
|
||||
{description ? (
|
||||
<p className="text-sm leading-relaxed text-white/55">{description}</p>
|
||||
<p className="text-sm leading-relaxed text-white/50">{description}</p>
|
||||
) : null}
|
||||
</div>
|
||||
</div>
|
||||
@@ -632,8 +599,8 @@ function ProductLead({
|
||||
);
|
||||
}
|
||||
|
||||
/** A hairline grid cell: icon and title on one line, the blurb below, an optional action last. */
|
||||
function FeatureCell({
|
||||
/** A small card: icon and title on one line, the blurb below, an optional action last. */
|
||||
function FeatureCard({
|
||||
icon: Icon,
|
||||
title,
|
||||
description,
|
||||
@@ -645,12 +612,12 @@ function FeatureCell({
|
||||
children?: React.ReactNode;
|
||||
}) {
|
||||
return (
|
||||
<div className="flex flex-col bg-background p-6">
|
||||
<div className="flex items-center gap-2.5">
|
||||
<Icon className="h-4 w-4 shrink-0 text-accent-text" strokeWidth={1.5} />
|
||||
<h3 className="text-sm font-medium text-white/90">{title}</h3>
|
||||
<div className="flex flex-col rounded-xl border border-white/10 bg-white/[0.025] p-5">
|
||||
<div className="flex items-center gap-3">
|
||||
<Icon className="h-5 w-5 shrink-0 text-extra-muted-foreground" strokeWidth={1.5} />
|
||||
<h3 className="font-medium text-white/85">{title}</h3>
|
||||
</div>
|
||||
<p className="mt-2.5 text-sm leading-relaxed text-white/55">{description}</p>
|
||||
<p className="mt-3 text-sm leading-relaxed text-white/45">{description}</p>
|
||||
{children ? <div className="mt-auto pt-5">{children}</div> : null}
|
||||
</div>
|
||||
);
|
||||
@@ -687,11 +654,8 @@ function AutomationSection() {
|
||||
description={t("landing.automation.description")}
|
||||
links={links}
|
||||
>
|
||||
<div className="grid gap-px overflow-hidden rounded-xl border border-white/[0.08] bg-white/[0.08] md:grid-cols-[15rem_minmax(0,1fr)]">
|
||||
<div
|
||||
className="grid grid-cols-3 gap-px bg-white/[0.08] md:grid-cols-1 md:content-start md:bg-background"
|
||||
role="tablist"
|
||||
>
|
||||
<div className="grid gap-4 md:grid-cols-[14rem_minmax(0,1fr)]">
|
||||
<div className="grid self-start gap-2" role="tablist">
|
||||
{AUTOMATION_OPTIONS.map((option) => (
|
||||
<AutomationSelector
|
||||
key={option.kind}
|
||||
@@ -726,22 +690,17 @@ function AutomationSelector({
|
||||
role="tab"
|
||||
aria-selected={active}
|
||||
onClick={handleClick}
|
||||
className={`cursor-pointer border-b-2 p-3.5 text-left transition-colors md:border-b md:border-b-white/[0.07] md:border-l-2 md:p-5 ${
|
||||
className={`flex items-center gap-3 rounded-xl border p-3 text-left transition-colors md:block md:p-4 ${
|
||||
active
|
||||
? "border-b-brand-green bg-white/[0.045] md:border-l-brand-green"
|
||||
: "border-b-transparent bg-background hover:bg-white/[0.025] md:border-l-transparent"
|
||||
? "border-white/20 bg-white/[0.07]"
|
||||
: "border-white/10 bg-white/[0.025] hover:border-white/15 hover:bg-white/[0.04]"
|
||||
}`}
|
||||
>
|
||||
<div className="flex shrink-0 items-center gap-2 font-mono md:mb-1.5">
|
||||
<Icon
|
||||
className={`h-3.5 w-3.5 ${active ? "text-accent-text" : "text-muted-foreground"}`}
|
||||
strokeWidth={1.5}
|
||||
/>
|
||||
<span className={`text-[11px] ${active ? "text-accent-text" : "text-muted-foreground"}`}>
|
||||
{option.label}
|
||||
</span>
|
||||
<div className="flex shrink-0 items-center gap-2 text-muted-foreground md:mb-1">
|
||||
<Icon className="h-3 w-3" strokeWidth={1.5} />
|
||||
<span className="text-[10px]">{option.label}</span>
|
||||
</div>
|
||||
<p className="mt-1 text-xs leading-snug text-white/85 md:mt-0 md:text-sm">
|
||||
<p className="text-xs leading-snug text-white/85 md:text-sm">
|
||||
{t(`landing.automation.${option.kind}Caption`)}
|
||||
</p>
|
||||
</button>
|
||||
@@ -752,7 +711,7 @@ function AutomationDetail({ kind }: { kind: AutomationKind }) {
|
||||
return (
|
||||
<div
|
||||
role="tabpanel"
|
||||
className="min-h-80 min-w-0 overflow-hidden bg-[#0c1110] p-5 md:h-[26rem] md:p-6"
|
||||
className="min-h-80 min-w-0 overflow-hidden rounded-xl border border-white/10 bg-black/20 p-5 md:h-[26rem] md:p-6"
|
||||
>
|
||||
{kind === "mcp" ? <McpAutomationTranscript /> : null}
|
||||
{kind === "cli" ? <CliAutomationExample /> : null}
|
||||
@@ -901,82 +860,37 @@ function SdkAutomationExample() {
|
||||
);
|
||||
}
|
||||
|
||||
function HubSection() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
return (
|
||||
<motion.section
|
||||
initial={FADE_IN_UP}
|
||||
whileInView={FADE_IN}
|
||||
viewport={VIEWPORT_60}
|
||||
transition={EASE_OUT_05}
|
||||
aria-labelledby="hub-section-heading"
|
||||
>
|
||||
<div className="mb-10 space-y-3 md:mb-12">
|
||||
<h2 id="hub-section-heading">
|
||||
<PaseoHubLockup size="display" className="h-9 w-auto text-foreground md:h-11" />
|
||||
<span className="sr-only">{t("hub.title")}</span>
|
||||
</h2>
|
||||
<p className="max-w-xl text-base text-pretty text-muted-foreground">
|
||||
{t("landing.hubSection.description")}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div className="space-y-8">
|
||||
<HubLandingFlow />
|
||||
|
||||
<div className="flex flex-wrap items-center gap-3">
|
||||
<a href={localize("/hub")} className={PRIMARY_CTA_CLASS}>
|
||||
{t("landing.hubSection.exploreCta")}
|
||||
<ArrowRight className="h-4 w-4" aria-hidden="true" />
|
||||
</a>
|
||||
<a href={localize("/docs/hub")} className={SECONDARY_CTA_CLASS}>
|
||||
{t("landing.hubSection.docsCta")}
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</motion.section>
|
||||
);
|
||||
}
|
||||
|
||||
function ExtensibleSection({ pluginCount }: { pluginCount?: number | null }) {
|
||||
function ExtensibleSection() {
|
||||
const { t } = useTranslation();
|
||||
const pluginActions = React.useMemo(() => <PluginActions />, []);
|
||||
const libraryTitle =
|
||||
pluginCount && pluginCount > 0
|
||||
? t("landing.plugins.libraryTitleCount", { count: pluginCount })
|
||||
: t("landing.plugins.libraryTitle");
|
||||
return (
|
||||
<FeatureSection
|
||||
eyebrow={t("landing.eyebrows.plugins")}
|
||||
title={t("landing.plugins.title")}
|
||||
description={t("landing.plugins.description")}
|
||||
>
|
||||
<div className="space-y-6">
|
||||
<div className="space-y-12">
|
||||
<SelfModifyDemo />
|
||||
<div className="overflow-hidden rounded-xl border border-white/[0.08] bg-white/[0.08]">
|
||||
<div className="space-y-5 bg-background p-6">
|
||||
<ProductLead
|
||||
icon={Puzzle}
|
||||
title={libraryTitle}
|
||||
description={t("landing.plugins.libraryDescription")}
|
||||
actions={pluginActions}
|
||||
/>
|
||||
<PluginCategoryLinks />
|
||||
</div>
|
||||
<div className="flex flex-col gap-3 border-t border-white/[0.08] bg-background px-6 py-4 sm:flex-row sm:items-center sm:justify-between">
|
||||
<p className="text-sm text-white/50">{t("landing.plugins.license")}</p>
|
||||
<a
|
||||
href="https://github.com/getpaseo/paseo"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex shrink-0 items-center gap-2 text-sm text-muted-foreground transition-colors hover:text-accent-text"
|
||||
>
|
||||
<GitFork className="h-4 w-4" strokeWidth={1.5} />
|
||||
{t("landing.plugins.fork")}
|
||||
<ExternalLink className="h-3.5 w-3.5 opacity-70" />
|
||||
</a>
|
||||
</div>
|
||||
<div className="space-y-6">
|
||||
<ProductLead
|
||||
icon={Puzzle}
|
||||
title={t("landing.plugins.libraryTitle")}
|
||||
description={t("landing.plugins.libraryDescription")}
|
||||
actions={pluginActions}
|
||||
/>
|
||||
<PluginCategoryLinks />
|
||||
</div>
|
||||
<div className="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
|
||||
<p className="text-sm text-white/45">{t("landing.plugins.license")}</p>
|
||||
<a
|
||||
href="https://github.com/getpaseo/paseo"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex shrink-0 items-center gap-2 text-sm text-muted-foreground transition-colors hover:text-foreground"
|
||||
>
|
||||
<GitFork className="h-4 w-4" strokeWidth={1.5} />
|
||||
{t("landing.plugins.fork")}
|
||||
<ExternalLink className="h-3.5 w-3.5 opacity-70" />
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</FeatureSection>
|
||||
@@ -1042,7 +956,7 @@ function SelfModifyDemo() {
|
||||
initial={reduceMotion ? "shown" : "hidden"}
|
||||
whileInView="shown"
|
||||
viewport={VIEWPORT_60}
|
||||
className="grid min-h-[22rem] grid-cols-[minmax(0,1fr)] overflow-hidden rounded-xl border border-white/[0.08] bg-[#0c1110] md:grid-cols-[minmax(0,1fr)_17rem]"
|
||||
className="grid min-h-[22rem] grid-cols-[minmax(0,1fr)] overflow-hidden rounded-xl border border-white/10 bg-black/20 md:grid-cols-[minmax(0,1fr)_17rem]"
|
||||
>
|
||||
<div className="space-y-5 p-5 md:p-6">
|
||||
<DemoItem step={DEMO_STEPS.prompt}>
|
||||
@@ -1173,50 +1087,43 @@ function PhilosophySection() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<FeatureSection
|
||||
eyebrow={t("landing.eyebrows.openSource")}
|
||||
title={t("landing.philosophy.title")}
|
||||
description={t("landing.philosophy.description")}
|
||||
>
|
||||
<HairlineGrid columns="3">
|
||||
<div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">
|
||||
{PRINCIPLES.map((principle) => (
|
||||
<FeatureCell
|
||||
<FeatureCard
|
||||
key={principle.key}
|
||||
icon={principle.icon}
|
||||
title={t(`landing.philosophy.${principle.key}Title`)}
|
||||
description={t(`landing.philosophy.${principle.key}Description`)}
|
||||
/>
|
||||
))}
|
||||
</HairlineGrid>
|
||||
</FeatureSection>
|
||||
);
|
||||
}
|
||||
|
||||
function DownloadActions() {
|
||||
const platform = useVisitorPlatform();
|
||||
return (
|
||||
<div className="mx-auto flex flex-col items-center gap-3 sm:flex-row sm:justify-center">
|
||||
{isMobilePlatform(platform) ? (
|
||||
<StoreButton platform={platform} />
|
||||
) : (
|
||||
<DesktopDownloadButton platform={platform} />
|
||||
)}
|
||||
<div className="flex items-center justify-center gap-3">
|
||||
{isMobilePlatform(platform) ? <DesktopAppLink /> : <StoreIconLinks />}
|
||||
<ServerInstallButton />
|
||||
</div>
|
||||
</div>
|
||||
</FeatureSection>
|
||||
);
|
||||
}
|
||||
|
||||
function GetStarted() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
const platform = useVisitorPlatform();
|
||||
return (
|
||||
<div className="pt-8">
|
||||
<div className="pt-10">
|
||||
{/* The primary call to action owns its own row on phones so the small icon
|
||||
buttons never wrap and orphan one of themselves onto a line alone. It
|
||||
still hugs its label rather than stretching across the row. */}
|
||||
<DownloadActions />
|
||||
<div className="mx-auto flex flex-col items-center gap-3 sm:flex-row sm:justify-center">
|
||||
{isMobilePlatform(platform) ? (
|
||||
<StoreButton platform={platform} />
|
||||
) : (
|
||||
<DesktopDownloadButton platform={platform} />
|
||||
)}
|
||||
<div className="flex items-center justify-center gap-3">
|
||||
{isMobilePlatform(platform) ? <DesktopAppLink /> : <StoreIconLinks />}
|
||||
<ServerInstallButton />
|
||||
</div>
|
||||
</div>
|
||||
<div className="flex flex-wrap items-center justify-center gap-x-2 gap-y-1 pt-6">
|
||||
<span className="text-xs text-muted-foreground">{t("landing.getStarted.supports")}</span>
|
||||
<div className="flex items-center gap-1">
|
||||
@@ -1226,7 +1133,7 @@ function GetStarted() {
|
||||
</div>
|
||||
<a
|
||||
href={localize("/agents")}
|
||||
className="whitespace-nowrap text-xs text-muted-foreground transition-colors hover:text-foreground"
|
||||
className="whitespace-nowrap text-xs text-muted-foreground hover:text-foreground transition-colors"
|
||||
>
|
||||
{t("common.more", { count: ADDITIONAL_AGENT_COUNT })}
|
||||
</a>
|
||||
@@ -1235,28 +1142,6 @@ function GetStarted() {
|
||||
);
|
||||
}
|
||||
|
||||
function ClosingCtaSection() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section aria-labelledby="closing-cta-heading" className="text-center">
|
||||
<div className="mb-6 flex justify-center">
|
||||
<span className="inline-flex h-12 w-12 items-center justify-center rounded-xl border border-brand-green/40 bg-brand-green/15 text-accent-text">
|
||||
<PaseoMark className="h-6 w-6" />
|
||||
</span>
|
||||
</div>
|
||||
<SectionOpener
|
||||
align="center"
|
||||
eyebrow={t("landing.closingCta.eyebrow")}
|
||||
headingId="closing-cta-heading"
|
||||
title={t("landing.closingCta.title")}
|
||||
description={t("landing.closingCta.description")}
|
||||
className="mb-8"
|
||||
/>
|
||||
<DownloadActions />
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
const PRIMARY_CTA_CLASS =
|
||||
"inline-flex items-center justify-center gap-2 rounded-lg bg-foreground px-4 py-2.5 text-sm font-medium text-background hover:bg-foreground/90 transition-colors";
|
||||
const SECONDARY_CTA_CLASS =
|
||||
@@ -1400,7 +1285,7 @@ function PhoneShowcase() {
|
||||
const textAnimate = React.useMemo(() => (textInView ? FADE_IN : {}), [textInView]);
|
||||
|
||||
return (
|
||||
<div ref={containerRef} className="flex flex-col items-center gap-14 pt-2 pb-12 md:pb-16">
|
||||
<div ref={containerRef} className="flex flex-col items-center pt-4 pb-16 gap-20">
|
||||
{/* Arrow + text */}
|
||||
<motion.div
|
||||
initial={FADE_IN_UP_TINY}
|
||||
@@ -1512,26 +1397,21 @@ function FAQ() {
|
||||
[localize],
|
||||
);
|
||||
return (
|
||||
<motion.section
|
||||
<motion.div
|
||||
initial={FADE_IN_UP}
|
||||
whileInView={FADE_IN}
|
||||
viewport={VIEWPORT_60}
|
||||
transition={EASE_OUT_05}
|
||||
aria-labelledby="home-faq-heading"
|
||||
className="grid items-start gap-10 lg:grid-cols-[minmax(0,17rem)_minmax(0,1fr)] lg:gap-16"
|
||||
className="space-y-6"
|
||||
>
|
||||
<SectionOpener
|
||||
headingId="home-faq-heading"
|
||||
title={t("landing.faq.title")}
|
||||
className="mb-0 self-start"
|
||||
/>
|
||||
<div className="divide-y divide-white/[0.08] border-y border-white/[0.08]">
|
||||
<h2 className="text-3xl font-medium">{t("landing.faq.title")}</h2>
|
||||
<div className="space-y-6">
|
||||
{FAQ_ENTRIES.map((entry) => (
|
||||
<FAQItem key={entry} question={t(`landing.faq.${entry}Question`)}>
|
||||
<Trans i18nKey={`landing.faq.${entry}Answer`} components={links} />
|
||||
</FAQItem>
|
||||
))}
|
||||
</div>
|
||||
</motion.section>
|
||||
</motion.div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,230 +0,0 @@
|
||||
import { ExternalLink } from "lucide-react";
|
||||
import type * as React from "react";
|
||||
import { SiteHeader } from "~/components/site-header";
|
||||
|
||||
/** Shared outer container width. Uses a transparent md:border-x when unframed to avoid a 1px shift. */
|
||||
export const PAGE_CONTAINER_CLASS =
|
||||
"mx-auto w-full max-w-[1160px] md:border-x md:border-transparent";
|
||||
|
||||
/** Shared outer rail width and vertical hairlines across marketing pages. */
|
||||
export const PAGE_RAIL_CLASS = "mx-auto w-full max-w-[1160px] md:border-x md:border-white/[0.07]";
|
||||
|
||||
/** Shared inner horizontal padding so every page element shares one left/right rail. */
|
||||
export const PAGE_INSET_CLASS = "px-5 sm:px-8 md:px-14";
|
||||
|
||||
/** Extend scrollable content from the mobile inset to the viewport edges. */
|
||||
export const MOBILE_PAGE_BLEED_CLASS = "-mx-5 px-5";
|
||||
|
||||
/** Full-width header band locking logo and navigation to the same (x, y) across pages. */
|
||||
export function PageHeaderBand({ framed = false }: { framed?: boolean }) {
|
||||
return (
|
||||
<div className={framed ? "border-b border-white/[0.07]" : ""}>
|
||||
<div
|
||||
className={`${framed ? PAGE_RAIL_CLASS : PAGE_CONTAINER_CLASS} ${PAGE_INSET_CLASS} py-4 md:py-5`}
|
||||
>
|
||||
<SiteHeader />
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const BAND_PADDING = {
|
||||
chapter: "py-16 md:py-24",
|
||||
section: "py-14 md:py-20",
|
||||
compact: "py-12 md:py-16",
|
||||
hero: "pt-12 pb-14 md:pt-16 md:pb-20",
|
||||
none: "",
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* A full-width architectural band separated by a 1px horizontal hairline with quiet crosshair
|
||||
* ticks where the horizontal rule meets the vertical frame rails.
|
||||
*/
|
||||
export function ChapterBand({
|
||||
children,
|
||||
spacing = "chapter",
|
||||
ruled = true,
|
||||
ticks = true,
|
||||
framed = true,
|
||||
tint = "none",
|
||||
className = "",
|
||||
id,
|
||||
}: {
|
||||
children: React.ReactNode;
|
||||
spacing?: keyof typeof BAND_PADDING;
|
||||
ruled?: boolean;
|
||||
ticks?: boolean;
|
||||
framed?: boolean;
|
||||
tint?: "none" | "subtle";
|
||||
className?: string;
|
||||
id?: string;
|
||||
}) {
|
||||
return (
|
||||
<div
|
||||
id={id}
|
||||
className={`overflow-x-clip ${ruled ? "border-t border-white/[0.07]" : ""} ${
|
||||
tint === "subtle" ? "bg-white/[0.014]" : ""
|
||||
} ${className}`}
|
||||
>
|
||||
<div
|
||||
className={`relative ${framed ? PAGE_RAIL_CLASS : PAGE_CONTAINER_CLASS} ${PAGE_INSET_CLASS} ${BAND_PADDING[spacing]}`}
|
||||
>
|
||||
{ruled && ticks && framed ? <RailIntersectionTicks /> : null}
|
||||
{children}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
/** Quiet 9px hairlines centered on the left and right vertical rail intersections. */
|
||||
function RailIntersectionTicks() {
|
||||
return (
|
||||
<>
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="pointer-events-none absolute -top-[4.5px] -left-[4.5px] hidden h-[9px] w-[9px] md:block"
|
||||
>
|
||||
<span className="absolute top-1/2 left-0 h-px w-full -translate-y-1/2 bg-white/25" />
|
||||
<span className="absolute top-0 left-1/2 h-full w-px -translate-x-1/2 bg-white/25" />
|
||||
</span>
|
||||
<span
|
||||
aria-hidden="true"
|
||||
className="pointer-events-none absolute -top-[4.5px] -right-[4.5px] hidden h-[9px] w-[9px] md:block"
|
||||
>
|
||||
<span className="absolute top-1/2 left-0 h-px w-full -translate-y-1/2 bg-white/25" />
|
||||
<span className="absolute top-0 left-1/2 h-full w-px -translate-x-1/2 bg-white/25" />
|
||||
</span>
|
||||
</>
|
||||
);
|
||||
}
|
||||
|
||||
/** Internal sub-section divider inside a multi-part chapter, staying inside the frame rails. */
|
||||
export function ChapterDivider({ className = "" }: { className?: string }) {
|
||||
return (
|
||||
<div
|
||||
aria-hidden="true"
|
||||
className={`-mx-5 border-t border-white/[0.07] sm:-mx-8 md:-mx-14 ${className}`}
|
||||
/>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Unified section opener used across `/` and `/hub`:
|
||||
* mono uppercase green eyebrow -> commanding 44px H2 -> concise lede + optional external links.
|
||||
*/
|
||||
export function SectionOpener({
|
||||
eyebrow,
|
||||
title,
|
||||
mutedLead,
|
||||
description,
|
||||
headingId,
|
||||
badge,
|
||||
links,
|
||||
actions,
|
||||
align = "left",
|
||||
className = "mb-10 md:mb-12",
|
||||
}: {
|
||||
eyebrow?: string;
|
||||
title: React.ReactNode;
|
||||
mutedLead?: string;
|
||||
description?: React.ReactNode;
|
||||
headingId?: string;
|
||||
badge?: string;
|
||||
links?: ReadonlyArray<{ href: string; label: string }>;
|
||||
actions?: React.ReactNode;
|
||||
align?: "left" | "center";
|
||||
className?: string;
|
||||
}) {
|
||||
const centered = align === "center";
|
||||
return (
|
||||
<div
|
||||
className={`${className} ${
|
||||
centered
|
||||
? "mx-auto max-w-2xl text-center"
|
||||
: "flex flex-col gap-5 md:flex-row md:items-end md:justify-between"
|
||||
}`}
|
||||
>
|
||||
<div className={`space-y-3 ${centered ? "" : "max-w-2xl"}`}>
|
||||
{eyebrow ? (
|
||||
<p className="font-mono text-[11px] font-medium uppercase tracking-[0.14em] text-accent-text">
|
||||
{eyebrow}
|
||||
</p>
|
||||
) : null}
|
||||
<div className={`flex flex-wrap items-center gap-3 ${centered ? "justify-center" : ""}`}>
|
||||
<h2
|
||||
id={headingId}
|
||||
className="font-display text-3xl font-semibold tracking-[-0.025em] leading-[1.1] text-foreground sm:text-4xl md:text-[42px]"
|
||||
>
|
||||
{mutedLead ? (
|
||||
<>
|
||||
<span className="text-white/45">{mutedLead}</span>{" "}
|
||||
</>
|
||||
) : null}
|
||||
{title}
|
||||
</h2>
|
||||
{badge ? (
|
||||
<span className="rounded-full border border-brand-green/40 bg-brand-green/20 px-2.5 py-0.5 text-xs text-accent-text">
|
||||
{badge}
|
||||
</span>
|
||||
) : null}
|
||||
</div>
|
||||
{description ? (
|
||||
<p
|
||||
className={`text-base leading-relaxed text-pretty text-muted-foreground ${
|
||||
centered ? "mx-auto max-w-lg" : "max-w-xl"
|
||||
}`}
|
||||
>
|
||||
{description}
|
||||
</p>
|
||||
) : null}
|
||||
{links && links.length > 0 ? (
|
||||
<div className="flex flex-wrap gap-x-5 gap-y-1.5 pt-1 text-xs">
|
||||
{links.map((link) => (
|
||||
<a
|
||||
key={link.href}
|
||||
href={link.href}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-1 font-mono text-white/55 transition-colors hover:text-accent-text"
|
||||
>
|
||||
{link.label}
|
||||
<ExternalLink className="h-3 w-3" />
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
) : null}
|
||||
</div>
|
||||
{actions ? <div className="flex shrink-0 flex-wrap items-center gap-3">{actions}</div> : null}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const GRID_COLUMNS = {
|
||||
"2": "grid-cols-1 lg:grid-cols-2",
|
||||
"3": "grid-cols-1 md:grid-cols-3",
|
||||
"2-3": "grid-cols-2 sm:grid-cols-3",
|
||||
} as const;
|
||||
|
||||
/**
|
||||
* Hairline-divided shared-border cell grid. Uses 1px background gap so interior hairlines never
|
||||
* double up across responsive column counts.
|
||||
*/
|
||||
export function HairlineGrid({
|
||||
children,
|
||||
columns = "3",
|
||||
className = "",
|
||||
clipContents = true,
|
||||
}: {
|
||||
children: React.ReactNode;
|
||||
columns?: keyof typeof GRID_COLUMNS;
|
||||
className?: string;
|
||||
clipContents?: boolean;
|
||||
}) {
|
||||
return (
|
||||
<div
|
||||
className={`grid gap-px rounded-xl border border-white/[0.08] bg-white/[0.08] ${clipContents ? "overflow-hidden" : ""} ${GRID_COLUMNS[columns]} ${className}`}
|
||||
>
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -50,16 +50,6 @@ describe("paseo brand assets", () => {
|
||||
}
|
||||
});
|
||||
|
||||
it("tightens symbol-to-wordmark spacing for display-scale lockups while keeping canonical paths", () => {
|
||||
const html = renderToStaticMarkup(<PaseoHubLockup size="display" className="h-12 w-auto" />);
|
||||
const canonical = readFileSync(path.join(BRAND_ROOT, "lockups/paseo-hub-white.svg"), "utf8");
|
||||
|
||||
expect(html).toContain('viewBox="0 0 798 144"');
|
||||
expect(html).toContain('width="798"');
|
||||
expect(html).toContain('transform="translate(-44 0)"');
|
||||
expect(extractPathData(html)).toEqual(extractPathData(canonical));
|
||||
});
|
||||
|
||||
it("keeps public/logo.svg and public/favicon.svg aligned with assets/brand", () => {
|
||||
const canonicalPaseo = readFileSync(path.join(BRAND_ROOT, "marks/paseo-white.svg"), "utf8");
|
||||
const publicLogo = readFileSync(path.join(WEBSITE_PUBLIC, "logo.svg"), "utf8");
|
||||
|
||||
@@ -99,34 +99,22 @@ function BrandMark({ asset, props }: { asset: ParsedMark; props: React.SVGProps<
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Optical horizontal tightening (in 144-unit lockup coordinates) for display-scale lockups.
|
||||
* Canonical lockups have a ~91-unit ink-to-ink gap calibrated for ~18–22px header sizes; at
|
||||
* 36–48px display sizes that gap reads ~25–30px wide, so `size="display"` pulls the wordmark
|
||||
* 44 units closer (~14–16px visual gap, ~1/3 of the mark width) and trims the viewBox to match.
|
||||
*/
|
||||
const DISPLAY_GAP_TIGHTEN_UNITS = 44;
|
||||
|
||||
export interface BrandLockupProps extends React.SVGProps<SVGSVGElement> {
|
||||
/** Optical spacing scale: `"default"` for small UI/header lockups, `"display"` for large headings. */
|
||||
size?: "default" | "display";
|
||||
}
|
||||
|
||||
function BrandLockup({ asset, props }: { asset: ParsedLockup; props: BrandLockupProps }) {
|
||||
const { size = "default", ...svgProps } = props;
|
||||
const tighten = size === "display" ? DISPLAY_GAP_TIGHTEN_UNITS : 0;
|
||||
const width = asset.width - tighten;
|
||||
const viewBox = tighten > 0 ? `0 0 ${width} ${asset.height}` : asset.viewBox;
|
||||
|
||||
function BrandLockup({
|
||||
asset,
|
||||
props,
|
||||
}: {
|
||||
asset: ParsedLockup;
|
||||
props: React.SVGProps<SVGSVGElement>;
|
||||
}) {
|
||||
return (
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
width={width}
|
||||
width={asset.width}
|
||||
height={asset.height}
|
||||
viewBox={viewBox}
|
||||
viewBox={asset.viewBox}
|
||||
fill="none"
|
||||
aria-hidden="true"
|
||||
{...svgProps}
|
||||
{...props}
|
||||
>
|
||||
<path
|
||||
d={asset.path}
|
||||
@@ -135,11 +123,7 @@ function BrandLockup({ asset, props }: { asset: ParsedLockup; props: BrandLockup
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
/>
|
||||
<path
|
||||
d={asset.wordmarkPath}
|
||||
fill="currentColor"
|
||||
transform={tighten > 0 ? `translate(-${tighten} 0)` : undefined}
|
||||
/>
|
||||
<path d={asset.wordmarkPath} fill="currentColor" />
|
||||
</svg>
|
||||
);
|
||||
}
|
||||
@@ -155,16 +139,16 @@ export function PaseoHubMark(props: React.SVGProps<SVGSVGElement>) {
|
||||
}
|
||||
|
||||
/** Canonical Paseo lockup (butterfly mark at 94% optical scale + Plus Jakarta Sans SemiBold). */
|
||||
export function PaseoLockup(props: BrandLockupProps) {
|
||||
export function PaseoLockup(props: React.SVGProps<SVGSVGElement>) {
|
||||
return <BrandLockup asset={PASEO_LOCKUP} props={props} />;
|
||||
}
|
||||
|
||||
/** Canonical Paseo Hub lockup (flower mark + Plus Jakarta Sans SemiBold). */
|
||||
export function PaseoHubLockup(props: BrandLockupProps) {
|
||||
export function PaseoHubLockup(props: React.SVGProps<SVGSVGElement>) {
|
||||
return <BrandLockup asset={PASEO_HUB_LOCKUP} props={props} />;
|
||||
}
|
||||
|
||||
/** Canonical Hub lockup (flower mark + "Hub"), used where Paseo is already on screen. */
|
||||
export function HubLockup(props: BrandLockupProps) {
|
||||
export function HubLockup(props: React.SVGProps<SVGSVGElement>) {
|
||||
return <BrandLockup asset={HUB_LOCKUP} props={props} />;
|
||||
}
|
||||
|
||||
@@ -1,10 +1,9 @@
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { PAGE_INSET_CLASS, PAGE_RAIL_CLASS } from "~/components/page-frame";
|
||||
import { SponsorsSection } from "~/components/sponsorship";
|
||||
import { PLUGINS_LINKED } from "~/plugins/launch";
|
||||
import { getAlternativePages } from "~/data/alternative-pages";
|
||||
import { appStoreUrl, playStoreUrl, webAppUrl } from "~/downloads";
|
||||
import { SponsorsSection } from "~/components/sponsorship";
|
||||
import { useLocale, useLocalizePath } from "~/i18n";
|
||||
import { PLUGINS_LINKED } from "~/plugins/launch";
|
||||
|
||||
interface SiteFooterProps {
|
||||
width?: "default" | "prose" | "wide";
|
||||
@@ -12,17 +11,13 @@ interface SiteFooterProps {
|
||||
sponsors?: boolean;
|
||||
}
|
||||
|
||||
const NON_DEFAULT_WIDTH_CLASSES: Record<
|
||||
Exclude<NonNullable<SiteFooterProps["width"]>, "default">,
|
||||
string
|
||||
> = {
|
||||
const WIDTH_CLASSES: Record<NonNullable<SiteFooterProps["width"]>, string> = {
|
||||
prose: "max-w-prose p-6 md:p-12 md:pt-0",
|
||||
default: "max-w-5xl p-6 md:p-20 md:pt-0",
|
||||
wide: "max-w-7xl p-6 md:p-20 md:pt-0",
|
||||
};
|
||||
|
||||
const LINK_CLASS = "block text-muted-foreground transition-colors hover:text-foreground";
|
||||
const COLUMN_HEADING_CLASS =
|
||||
"font-mono text-[11px] uppercase tracking-[0.12em] text-extra-muted-foreground";
|
||||
const LINK_CLASS = "block text-muted-foreground hover:text-foreground transition-colors";
|
||||
|
||||
function ExternalLink({ href, children }: { href: string; children: React.ReactNode }) {
|
||||
return (
|
||||
@@ -36,91 +31,72 @@ export function SiteFooter({ width = "default", sponsors = true }: SiteFooterPro
|
||||
const { t } = useTranslation();
|
||||
const locale = useLocale();
|
||||
const localize = useLocalizePath();
|
||||
const widthClasses = WIDTH_CLASSES[width];
|
||||
const alternatives = getAlternativePages(locale);
|
||||
const page = (path: string, label: string) => (
|
||||
<a href={localize(path)} className={LINK_CLASS}>
|
||||
{label}
|
||||
</a>
|
||||
);
|
||||
|
||||
const columns = (
|
||||
<div className="grid grid-cols-2 gap-8 text-sm sm:grid-cols-5">
|
||||
<div className="space-y-3">
|
||||
<p className={COLUMN_HEADING_CLASS}>{t("footer.product")}</p>
|
||||
<div className="space-y-2">
|
||||
{page("/blog", t("footer.blog"))}
|
||||
{page("/docs", t("footer.docs"))}
|
||||
{PLUGINS_LINKED && page("/plugins", t("footer.plugins"))}
|
||||
{page("/changelog", t("footer.changelog"))}
|
||||
{page("/hub", t("footer.hub"))}
|
||||
{page("/docs/cli", t("footer.cli"))}
|
||||
{page("/privacy", t("footer.privacy"))}
|
||||
{page("/terms", t("footer.terms"))}
|
||||
{page("/sponsor", t("footer.sponsor"))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className={COLUMN_HEADING_CLASS}>{t("footer.agents")}</p>
|
||||
<div className="space-y-2">
|
||||
{page("/claude-code", "Claude Code")}
|
||||
{page("/codex", "Codex")}
|
||||
{page("/opencode", "OpenCode")}
|
||||
{page("/antigravity", "Antigravity")}
|
||||
{page("/muse-code", "Muse Code")}
|
||||
{page("/agents", t("footer.allProviders"))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className={COLUMN_HEADING_CLASS}>{t("footer.alternatives")}</p>
|
||||
<div className="space-y-2">
|
||||
{alternatives.map((alternative) => (
|
||||
<a key={alternative.slug} href={localize(alternative.href)} className={LINK_CLASS}>
|
||||
{alternative.name}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className={COLUMN_HEADING_CLASS}>{t("footer.community")}</p>
|
||||
<div className="space-y-2">
|
||||
<ExternalLink href="https://discord.gg/jz8T2uahpH">Discord</ExternalLink>
|
||||
<ExternalLink href="https://www.reddit.com/r/PaseoAI/">Reddit</ExternalLink>
|
||||
<ExternalLink href="https://github.com/getpaseo/paseo">GitHub</ExternalLink>
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className={COLUMN_HEADING_CLASS}>{t("footer.download")}</p>
|
||||
<div className="space-y-2">
|
||||
<ExternalLink href={appStoreUrl}>App Store</ExternalLink>
|
||||
<ExternalLink href={playStoreUrl}>Google Play</ExternalLink>
|
||||
<ExternalLink href="https://github.com/getpaseo/paseo/releases">
|
||||
{t("footer.desktop")}
|
||||
</ExternalLink>
|
||||
<ExternalLink href={webAppUrl}>{t("footer.webApp")}</ExternalLink>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
|
||||
if (width === "default") {
|
||||
return (
|
||||
<footer className="border-t border-white/[0.07]">
|
||||
{sponsors ? (
|
||||
<div className="border-b border-white/[0.07]">
|
||||
<div className={`${PAGE_RAIL_CLASS} ${PAGE_INSET_CLASS}`}>
|
||||
<SponsorsSection placement="footer" />
|
||||
</div>
|
||||
</div>
|
||||
) : null}
|
||||
<div className={`${PAGE_RAIL_CLASS} ${PAGE_INSET_CLASS} py-12 md:py-14`}>{columns}</div>
|
||||
</footer>
|
||||
);
|
||||
}
|
||||
|
||||
return (
|
||||
<footer className={`${NON_DEFAULT_WIDTH_CLASSES[width]} mx-auto mt-12 md:mt-16`}>
|
||||
<footer className={`${widthClasses} mx-auto mt-12 md:mt-16`}>
|
||||
{sponsors ? <SponsorsSection placement="footer" /> : null}
|
||||
<div className="border-t border-white/10 pt-8 pb-4">{columns}</div>
|
||||
<div className="border-t border-white/10 pt-8 pb-4 grid grid-cols-2 sm:grid-cols-5 gap-8 text-sm">
|
||||
<div className="space-y-3">
|
||||
<p className="text-extra-muted-foreground">{t("footer.product")}</p>
|
||||
<div className="space-y-2">
|
||||
{page("/blog", t("footer.blog"))}
|
||||
{page("/docs", t("footer.docs"))}
|
||||
{PLUGINS_LINKED && page("/plugins", t("footer.plugins"))}
|
||||
{page("/changelog", t("footer.changelog"))}
|
||||
{page("/hub", t("footer.hub"))}
|
||||
{page("/docs/cli", t("footer.cli"))}
|
||||
{page("/privacy", t("footer.privacy"))}
|
||||
{page("/terms", t("footer.terms"))}
|
||||
{page("/sponsor", t("footer.sponsor"))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className="text-extra-muted-foreground">{t("footer.agents")}</p>
|
||||
<div className="space-y-2">
|
||||
{page("/claude-code", "Claude Code")}
|
||||
{page("/codex", "Codex")}
|
||||
{page("/opencode", "OpenCode")}
|
||||
{page("/antigravity", "Antigravity")}
|
||||
{page("/muse-code", "Muse Code")}
|
||||
{page("/agents", t("footer.allProviders"))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className="text-extra-muted-foreground">{t("footer.alternatives")}</p>
|
||||
<div className="space-y-2">
|
||||
{alternatives.map((alternative) => (
|
||||
<a key={alternative.slug} href={localize(alternative.href)} className={LINK_CLASS}>
|
||||
{alternative.name}
|
||||
</a>
|
||||
))}
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className="text-extra-muted-foreground">{t("footer.community")}</p>
|
||||
<div className="space-y-2">
|
||||
<ExternalLink href="https://discord.gg/jz8T2uahpH">Discord</ExternalLink>
|
||||
<ExternalLink href="https://www.reddit.com/r/PaseoAI/">Reddit</ExternalLink>
|
||||
<ExternalLink href="https://github.com/getpaseo/paseo">GitHub</ExternalLink>
|
||||
</div>
|
||||
</div>
|
||||
<div className="space-y-3">
|
||||
<p className="text-extra-muted-foreground">{t("footer.download")}</p>
|
||||
<div className="space-y-2">
|
||||
<ExternalLink href={appStoreUrl}>App Store</ExternalLink>
|
||||
<ExternalLink href={playStoreUrl}>Google Play</ExternalLink>
|
||||
<ExternalLink href="https://github.com/getpaseo/paseo/releases">
|
||||
{t("footer.desktop")}
|
||||
</ExternalLink>
|
||||
<ExternalLink href={webAppUrl}>{t("footer.webApp")}</ExternalLink>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -22,7 +22,7 @@ export function SiteHeader() {
|
||||
>
|
||||
<PaseoLockup className="h-[22px] w-auto" />
|
||||
</a>
|
||||
<nav className="flex flex-wrap items-center justify-center gap-4">
|
||||
<div className="flex flex-wrap items-center justify-center gap-4">
|
||||
{PLUGINS_LINKED && (
|
||||
<a href={localize("/plugins")} className={NAV_LINK_CLASS}>
|
||||
{t("nav.plugins")}
|
||||
@@ -63,7 +63,7 @@ export function SiteHeader() {
|
||||
<GitHubIcon width="18" height="18" />
|
||||
{stars && <span className="text-sm">{stars}</span>}
|
||||
</a>
|
||||
</nav>
|
||||
</div>
|
||||
</header>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -1,5 +1,4 @@
|
||||
import type { ReactNode } from "react";
|
||||
import { PAGE_INSET_CLASS, PAGE_RAIL_CLASS, PageHeaderBand } from "~/components/page-frame";
|
||||
import { SiteFooter } from "~/components/site-footer";
|
||||
import { SiteHeader } from "~/components/site-header";
|
||||
|
||||
@@ -8,26 +7,18 @@ interface SiteShellProps {
|
||||
width: "default" | "prose" | "wide";
|
||||
}
|
||||
|
||||
const MAIN_CLASSES: Record<Exclude<SiteShellProps["width"], "default">, string> = {
|
||||
const MAIN_CLASSES: Record<SiteShellProps["width"], string> = {
|
||||
prose: "max-w-prose p-6 md:p-12 mx-auto",
|
||||
default: "max-w-5xl p-6 md:p-20 mx-auto",
|
||||
wide: "max-w-7xl p-6 md:p-20 mx-auto",
|
||||
};
|
||||
|
||||
export function SiteShell({ children, width }: SiteShellProps) {
|
||||
if (width === "default") {
|
||||
return (
|
||||
<div className="min-h-screen bg-background">
|
||||
<PageHeaderBand framed />
|
||||
<main className={`${PAGE_RAIL_CLASS} ${PAGE_INSET_CLASS} py-14 md:py-20`}>{children}</main>
|
||||
<SiteFooter width="default" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const mainClasses = MAIN_CLASSES[width];
|
||||
return (
|
||||
<div className="min-h-screen bg-background">
|
||||
<main className={MAIN_CLASSES[width]}>
|
||||
<div className="mb-16">
|
||||
<main className={mainClasses}>
|
||||
<div className="mb-20">
|
||||
<SiteHeader />
|
||||
</div>
|
||||
{children}
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
import { ArrowRight, Check, ExternalLink, Heart } from "lucide-react";
|
||||
import * as React from "react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import { useLocalizePath } from "~/i18n";
|
||||
import { BuyMeACoffeeIcon, GitHubIcon, OpenCollectiveIcon } from "~/components/brand-icons";
|
||||
import { HairlineGrid, SectionOpener } from "~/components/page-frame";
|
||||
import {
|
||||
BUY_ME_A_COFFEE_URL,
|
||||
GITHUB_SPONSORS_URL,
|
||||
@@ -14,7 +14,6 @@ import {
|
||||
openSpotCount,
|
||||
sponsorHref,
|
||||
} from "~/data/sponsors";
|
||||
import { useLocalizePath } from "~/i18n";
|
||||
|
||||
function SectionHeading({
|
||||
as: Heading,
|
||||
@@ -28,13 +27,11 @@ function SectionHeading({
|
||||
badge?: string;
|
||||
}) {
|
||||
return (
|
||||
<div className="mb-10 space-y-2.5">
|
||||
<div className="mb-12 space-y-2">
|
||||
<div className="flex items-center gap-3">
|
||||
<Heading className="font-display text-3xl font-semibold tracking-[-0.025em] md:text-[42px]">
|
||||
{title}
|
||||
</Heading>
|
||||
<Heading className="text-3xl font-medium tracking-tight">{title}</Heading>
|
||||
{badge ? (
|
||||
<span className="rounded-full border border-brand-green/40 bg-brand-green/20 px-2.5 py-0.5 text-xs text-accent-text">
|
||||
<span className="rounded-full bg-emerald-400/10 px-2 py-1 text-xs text-emerald-300">
|
||||
{badge}
|
||||
</span>
|
||||
) : null}
|
||||
@@ -58,7 +55,7 @@ const MAINTAINER_COMPONENTS = {
|
||||
};
|
||||
|
||||
const MAINTAINER_SIGNATURE = (
|
||||
<p className="text-sm text-white/50">
|
||||
<p className="text-white/50">
|
||||
<Trans i18nKey="sponsor.maintainer" components={MAINTAINER_COMPONENTS} />
|
||||
</p>
|
||||
);
|
||||
@@ -144,28 +141,26 @@ export function BackingOptions() {
|
||||
[localize, t],
|
||||
);
|
||||
return (
|
||||
<HairlineGrid columns="2">
|
||||
<div className="grid gap-3 md:grid-cols-2">
|
||||
{options.map((option) => (
|
||||
<a
|
||||
key={option.href}
|
||||
href={option.href}
|
||||
{...(option.external ? { target: "_blank", rel: "noopener noreferrer" } : {})}
|
||||
className="group flex items-center justify-between gap-4 bg-background px-5 py-4 transition-colors hover:bg-white/[0.03]"
|
||||
className="flex items-center gap-4 rounded-xl border border-white/10 bg-white/[0.02] p-4 transition-colors hover:border-white/20 hover:bg-white/[0.05]"
|
||||
>
|
||||
<span className="flex items-center gap-3.5">
|
||||
<option.icon className="h-5 w-5 shrink-0 text-white/60 transition-colors group-hover:text-white/90" />
|
||||
<span className="text-sm font-medium text-white/90 group-hover:text-white">
|
||||
{option.name}
|
||||
</span>
|
||||
</span>
|
||||
{option.external ? (
|
||||
<ExternalLink className="h-3.5 w-3.5 shrink-0 text-white/35 transition-colors group-hover:text-accent-text" />
|
||||
) : (
|
||||
<ArrowRight className="h-3.5 w-3.5 shrink-0 text-white/35 transition-colors group-hover:text-accent-text" />
|
||||
)}
|
||||
<option.icon className="h-6 w-6 shrink-0 text-white/60" />
|
||||
<p className="flex items-center gap-1.5 font-medium text-white">
|
||||
{option.name}
|
||||
{option.external ? (
|
||||
<ExternalLink className="h-3.5 w-3.5 text-white/40" />
|
||||
) : (
|
||||
<ArrowRight className="h-3.5 w-3.5 text-white/40" />
|
||||
)}
|
||||
</p>
|
||||
</a>
|
||||
))}
|
||||
</HairlineGrid>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
@@ -189,7 +184,7 @@ export function SponsorSpotSection() {
|
||||
<ul className="grid max-w-2xl gap-3 text-white/70">
|
||||
{SPOT_FEATURES.map((feature) => (
|
||||
<li key={feature} className="flex items-start gap-2.5">
|
||||
<Check aria-hidden="true" className="mt-1 size-4 shrink-0 text-accent-text" />
|
||||
<Check aria-hidden="true" className="mt-1 size-4 shrink-0 text-emerald-300" />
|
||||
<span>{t(`sponsor.company.${feature}`)}</span>
|
||||
</li>
|
||||
))}
|
||||
@@ -198,7 +193,7 @@ export function SponsorSpotSection() {
|
||||
{open > 0 ? (
|
||||
<a
|
||||
href={SPONSOR_SPOT_CHECKOUT_URL}
|
||||
className="inline-flex items-center rounded-lg bg-foreground px-5 py-2.5 text-sm font-medium text-background transition-colors hover:bg-foreground/90"
|
||||
className="inline-flex items-center rounded-md bg-white px-5 py-2.5 text-sm font-medium text-black transition-colors hover:bg-white/90"
|
||||
>
|
||||
{t("sponsor.becomeSponsor")}
|
||||
</a>
|
||||
@@ -229,72 +224,15 @@ export function SponsorPaseoSection() {
|
||||
);
|
||||
}
|
||||
|
||||
/** Standalone short sponsor note + backing options (used on /download/thanks). */
|
||||
/** Homepage: a short version of the note with the same links as /sponsor. */
|
||||
export function SponsorSection() {
|
||||
const { t } = useTranslation();
|
||||
const hubLink = useHubLinkComponents();
|
||||
return (
|
||||
<section>
|
||||
<SectionHeading as="h2" title={t("sponsor.title")} />
|
||||
<div className="space-y-8">
|
||||
<div className="max-w-2xl space-y-4 text-sm leading-relaxed text-white/70">
|
||||
<p>{t("sponsor.note.independent")}</p>
|
||||
<p>{t("sponsor.shortNote.maintained")}</p>
|
||||
<p>
|
||||
<Trans i18nKey="sponsor.shortNote.selfFunded" components={hubLink} />
|
||||
</p>
|
||||
{MAINTAINER_SIGNATURE}
|
||||
</div>
|
||||
<BackingOptions />
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Consolidated homepage Sponsors + Sponsor Paseo section.
|
||||
* Keeps `aria-labelledby="sponsors-heading"` with heading text "Sponsors" so the Sponsors region
|
||||
* contract stays intact while unifying the logo row, founder note, and backing options into one
|
||||
* coherent chapter.
|
||||
*/
|
||||
export function HomepageSponsorsSection() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
const hubLink = useHubLinkComponents();
|
||||
const open = openSpotCount();
|
||||
|
||||
return (
|
||||
<section aria-labelledby="sponsors-heading">
|
||||
<SectionOpener headingId="sponsors-heading" title={t("sponsor.sponsors")} className="mb-10" />
|
||||
|
||||
<ul className="flex flex-wrap items-center gap-x-14 gap-y-8">
|
||||
{SPONSORS.map((sponsor) => (
|
||||
<li key={sponsor.url}>
|
||||
<a
|
||||
href={sponsorHref(sponsor, "website")}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="block"
|
||||
>
|
||||
<img src={sponsor.logo.onDark} alt={sponsor.name} className="h-12 w-auto" />
|
||||
</a>
|
||||
<p className="mt-2 text-sm text-white/55">{sponsor.description}</p>
|
||||
</li>
|
||||
))}
|
||||
{open > 0 ? (
|
||||
<li>
|
||||
<a
|
||||
href={localize("/sponsor#spot")}
|
||||
className="inline-flex h-11 items-center rounded-lg border border-dashed border-white/15 px-4 text-sm text-white/50 transition-colors hover:border-white/30 hover:text-white/80"
|
||||
>
|
||||
{t("sponsor.becomeSponsor")}
|
||||
</a>
|
||||
</li>
|
||||
) : null}
|
||||
</ul>
|
||||
|
||||
<div className="mt-10 grid gap-10 border-t border-white/[0.07] pt-10 lg:grid-cols-[minmax(0,1fr)_minmax(0,1fr)] lg:items-start">
|
||||
<div className="space-y-4 text-sm leading-relaxed text-white/70">
|
||||
<div className="space-y-10">
|
||||
<div className="max-w-2xl space-y-5 leading-relaxed text-white/70">
|
||||
<p>{t("sponsor.note.independent")}</p>
|
||||
<p>{t("sponsor.shortNote.maintained")}</p>
|
||||
<p>
|
||||
@@ -319,19 +257,18 @@ const SPONSORS_PLACEMENTS = {
|
||||
button: "h-12 px-5 text-sm",
|
||||
},
|
||||
footer: {
|
||||
section: "space-y-5 py-8",
|
||||
heading:
|
||||
"gap-1.5 font-mono text-[11px] uppercase tracking-[0.12em] text-extra-muted-foreground",
|
||||
section: "space-y-5 border-t border-white/10 py-8",
|
||||
heading: "gap-1.5 text-sm text-extra-muted-foreground",
|
||||
heart: "size-3",
|
||||
link: "opacity-85 transition-opacity hover:opacity-100",
|
||||
logo: "h-9",
|
||||
logo: "h-10",
|
||||
description: "mt-1.5 text-xs text-white/45",
|
||||
button: "h-9 px-3.5 text-xs",
|
||||
button: "h-9 px-3.5 text-sm",
|
||||
},
|
||||
} as const;
|
||||
|
||||
interface SponsorsSectionProps {
|
||||
/** `page` is a standalone section; `footer` is the band above other pages' footers. */
|
||||
/** `page` is a homepage section; `footer` is the band above other pages' footers. */
|
||||
placement: keyof typeof SPONSORS_PLACEMENTS;
|
||||
}
|
||||
|
||||
@@ -376,7 +313,7 @@ export function SponsorsSection({ placement }: SponsorsSectionProps) {
|
||||
<li>
|
||||
<a
|
||||
href={localize("/sponsor#spot")}
|
||||
className={`inline-flex items-center rounded-lg border border-dashed border-white/15 text-white/45 transition-colors hover:border-white/30 hover:text-white/75 ${style.button}`}
|
||||
className={`inline-flex items-center rounded-md border border-dashed border-white/15 text-white/45 transition-colors hover:border-white/30 hover:text-white/75 ${style.button}`}
|
||||
>
|
||||
{t("sponsor.becomeSponsor")}
|
||||
</a>
|
||||
|
||||
@@ -166,14 +166,6 @@ export function getLegacyDocsRedirect(pathname: string): string | undefined {
|
||||
const provider = /^\/docs\/(claude-code|codex|muse-code)(\.md)?\/?$/.exec(pathname);
|
||||
if (provider) return `/docs/supported-providers/${provider[1]}${provider[2] ?? ""}`;
|
||||
|
||||
// Legacy Hub stepped-workflow docs moved to self-contained trigger docs and YAML reference.
|
||||
const hubLegacy = /^\/docs\/hub\/(workflows|configuration\/hub-yml)(\.md)?\/?$/.exec(pathname);
|
||||
if (hubLegacy) {
|
||||
const target =
|
||||
hubLegacy[1] === "workflows" ? "/docs/hub/triggers" : "/docs/hub/configuration/reference";
|
||||
return `${target}${hubLegacy[2] ?? ""}`;
|
||||
}
|
||||
|
||||
const match =
|
||||
/^\/docs\/plugins\/v0\.[78](?:(\.md)|\/(index|reference|providers|migration)(\.md)?)?\/?$/.exec(
|
||||
pathname,
|
||||
|
||||
@@ -43,38 +43,25 @@ async function writeCachedValue<T>(
|
||||
);
|
||||
}
|
||||
|
||||
interface CacheOptions<T> {
|
||||
export async function getBlockingColdCache<T>({
|
||||
context,
|
||||
key,
|
||||
isValue,
|
||||
fetchFresh,
|
||||
}: {
|
||||
context: WebsiteCacheContext;
|
||||
key: string;
|
||||
isValue: Validator<T>;
|
||||
fetchFresh: () => Promise<T>;
|
||||
}
|
||||
|
||||
function refreshInBackground<T>({ context, key, fetchFresh }: CacheOptions<T>): void {
|
||||
context.waitUntil(
|
||||
fetchFresh()
|
||||
.then((fresh) => writeCachedValue(context.cache, key, fresh))
|
||||
.catch(() => undefined),
|
||||
);
|
||||
}
|
||||
|
||||
/** Return the cached value, warming the cache in the background when it is empty or stale. */
|
||||
export async function getNonBlockingColdCache<T>(options: CacheOptions<T>): Promise<T | null> {
|
||||
const { context, key, isValue } = options;
|
||||
if (!context.cache) return null;
|
||||
const cached = await readCachedValue(context.cache, key, isValue);
|
||||
if (!cached || Date.now() - cached.fetchedAt > GITHUB_CACHE_TTL_MS) {
|
||||
refreshInBackground(options);
|
||||
}
|
||||
return cached?.value ?? null;
|
||||
}
|
||||
|
||||
export async function getBlockingColdCache<T>(options: CacheOptions<T>): Promise<T> {
|
||||
const { context, key, isValue, fetchFresh } = options;
|
||||
}): Promise<T> {
|
||||
const cached = await readCachedValue(context.cache, key, isValue);
|
||||
if (cached) {
|
||||
if (Date.now() - cached.fetchedAt > GITHUB_CACHE_TTL_MS) {
|
||||
refreshInBackground(options);
|
||||
context.waitUntil(
|
||||
fetchFresh()
|
||||
.then((fresh) => writeCachedValue(context.cache, key, fresh))
|
||||
.catch(() => undefined),
|
||||
);
|
||||
}
|
||||
return cached.value;
|
||||
}
|
||||
|
||||
@@ -2,13 +2,12 @@ import { readFile, readdir } from "node:fs/promises";
|
||||
import path from "node:path";
|
||||
import YAML from "yaml";
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { getDoc, getDocs, getLegacyDocsRedirect, parseHeadings } from "./docs";
|
||||
|
||||
const repositoryRoot = path.resolve(import.meta.dirname, "../../..");
|
||||
const hubDocs = path.join(repositoryRoot, "public-docs", "hub");
|
||||
|
||||
describe("Hub public documentation examples", () => {
|
||||
it("parses every Hub YAML example and keeps trigger documents canonical", async () => {
|
||||
it("parses every Hub YAML example and keeps resource maps canonical", async () => {
|
||||
const files = [
|
||||
...(await markdownFiles(hubDocs)),
|
||||
path.join(repositoryRoot, "public-docs", "cli.md"),
|
||||
@@ -25,9 +24,6 @@ describe("Hub public documentation examples", () => {
|
||||
expect(parsed, `${label} must not teach monolithic triggers`).not.toHaveProperty(
|
||||
"triggers",
|
||||
);
|
||||
expect(parsed, `${label} must not teach legacy stepped workflows`).not.toHaveProperty(
|
||||
"steps",
|
||||
);
|
||||
if (Object.hasOwn(parsed, "environments")) {
|
||||
expect(isRecord(parsed["environments"]), `${label} environments`).toBe(true);
|
||||
}
|
||||
@@ -39,75 +35,18 @@ describe("Hub public documentation examples", () => {
|
||||
expect(exampleCount).toBeGreaterThan(20);
|
||||
});
|
||||
|
||||
it("does not teach removed Hub authoring paths or legacy stepped workflows", async () => {
|
||||
it("does not teach removed Hub authoring paths or composition fields", async () => {
|
||||
const markdown = (
|
||||
await Promise.all((await markdownFiles(hubDocs)).map((file) => readFile(file, "utf8")))
|
||||
).join("\n");
|
||||
|
||||
expect(markdown).not.toContain(".paseo/partials/");
|
||||
expect(markdown).not.toContain(".paseo/workflows/");
|
||||
expect(markdown).not.toContain(".paseo/hub.yml");
|
||||
expect(markdown).not.toMatch(/^triggers:/mu);
|
||||
expect(markdown).not.toMatch(/^steps:/mu);
|
||||
expect(markdown).not.toMatch(/^\s+allow_outputs:/mu);
|
||||
expect(markdown).not.toMatch(/^\s+uses:/mu);
|
||||
expect(markdown).not.toContain("paseo hub deploy [file]");
|
||||
});
|
||||
|
||||
it.each(["en", "zh-CN"] as const)(
|
||||
"resolves every internal /docs/hub link and heading anchor in %s",
|
||||
(locale) => {
|
||||
const docs = getDocs(locale);
|
||||
const headingsByHref = new Map(docs.map((doc) => [doc.href, headingIds(doc.content)]));
|
||||
const hubPages = docs.filter(
|
||||
(doc) => doc.href === "/docs/hub" || doc.href.startsWith("/docs/hub/"),
|
||||
);
|
||||
expect(hubPages.length).toBeGreaterThanOrEqual(25);
|
||||
|
||||
const broken: string[] = [];
|
||||
for (const doc of hubPages) {
|
||||
for (const match of doc.content.matchAll(/\]\((\/docs\/hub[^)\s]*)\)/gu)) {
|
||||
const target = match[1] ?? "";
|
||||
const [rawPath, hash] = target.split("#");
|
||||
const cleanPath = (rawPath ?? "").replace(/\/$/u, "");
|
||||
const headings = headingsByHref.get(cleanPath);
|
||||
if (!headings) {
|
||||
broken.push(`${doc.sourcePath} -> missing page ${target}`);
|
||||
} else if (hash && !headings.has(hash)) {
|
||||
broken.push(`${doc.sourcePath} -> missing anchor ${target}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
expect(broken).toEqual([]);
|
||||
},
|
||||
);
|
||||
|
||||
it("redirects removed legacy Hub workflow and hub-yml paths to current pages", () => {
|
||||
const redirects = [
|
||||
["/docs/hub/workflows", "/docs/hub/triggers"],
|
||||
["/docs/hub/configuration/hub-yml", "/docs/hub/configuration/reference"],
|
||||
] as const;
|
||||
|
||||
for (const [legacyPath, targetPath] of redirects) {
|
||||
expect(getDoc(targetPath.slice("/docs/".length), "en")).toBeDefined();
|
||||
expect(getDoc(targetPath.slice("/docs/".length), "zh-CN")).toBeDefined();
|
||||
for (const extension of ["", ".md"]) {
|
||||
expect(getLegacyDocsRedirect(`${legacyPath}${extension}`)).toBe(
|
||||
`${targetPath}${extension}`,
|
||||
);
|
||||
expect(getLegacyDocsRedirect(`${legacyPath}${extension}/`)).toBe(
|
||||
`${targetPath}${extension}`,
|
||||
);
|
||||
expect(getLegacyDocsRedirect(`${targetPath}${extension}`)).toBeUndefined();
|
||||
}
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
function headingIds(content: string): Set<string> {
|
||||
return new Set(parseHeadings(content).map((heading) => heading.id));
|
||||
}
|
||||
|
||||
function yamlFences(markdown: string): readonly string[] {
|
||||
return [...markdown.matchAll(/```yaml\s*\n([\s\S]*?)```/gu)].map((match) => match[1] ?? "");
|
||||
}
|
||||
|
||||
@@ -348,20 +348,6 @@
|
||||
"intro": "Paseo supports many agents natively. It also runs any <acp>ACP agent</acp>, and you can add new providers with <plugins>plugins</plugins>."
|
||||
},
|
||||
"landing": {
|
||||
"hubEyebrow": {
|
||||
"product": "Paseo Hub",
|
||||
"label": "Automations on your machines"
|
||||
},
|
||||
"eyebrows": {
|
||||
"providers": "Providers",
|
||||
"plugins": "Plugins",
|
||||
"openSource": "Open source"
|
||||
},
|
||||
"closingCta": {
|
||||
"eyebrow": "Get started",
|
||||
"title": "Your agents, on every screen.",
|
||||
"description": "Download the desktop app or run the daemon on any machine. Open source under Apache 2.0."
|
||||
},
|
||||
"socialProof": {
|
||||
"title": "Loved by developers",
|
||||
"description": "See what developers are saying about Paseo",
|
||||
@@ -383,17 +369,9 @@
|
||||
"remoteDescription": "Run Paseo on a home lab, or a cloud machine",
|
||||
"remoteCta": "Docs",
|
||||
"teamsTitle": "Teams and triggers",
|
||||
"teamsDescription": "Share daemons with your team and automate runs with Paseo Hub",
|
||||
"teamsDescription": "Share access or start work from GitHub, Slack, and Discord",
|
||||
"teamsCta": "Paseo Hub"
|
||||
},
|
||||
"hubSection": {
|
||||
"description": "Run agents on your machines from GitHub, Linear, Slack, Discord, schedules, or webhooks.",
|
||||
"flowTriggers": "Trigger sources",
|
||||
"flowDaemons": "Your connected daemons",
|
||||
"flowOpenSession": "Open live session in Paseo",
|
||||
"exploreCta": "Explore Paseo Hub",
|
||||
"docsCta": "Self-host docs"
|
||||
},
|
||||
"automation": {
|
||||
"title": "Built for automation",
|
||||
"description": "Use MCP, the CLI, or the TypeScript SDK to automate Paseo",
|
||||
@@ -415,9 +393,7 @@
|
||||
"plan": "I'll build it as a local plugin and install it.",
|
||||
"done": "Review queue is in your sidebar.",
|
||||
"panelTitle": "Review queue",
|
||||
"libraryTitle": "Community plugins",
|
||||
"libraryTitleCount_one": "{{count}} community plugin",
|
||||
"libraryTitleCount_other": "{{count}} community plugins",
|
||||
"libraryTitle": "400+ community plugins",
|
||||
"libraryDescription": "Built by developers on the same plugin API your agents use",
|
||||
"browse": "Browse plugins",
|
||||
"docs": "Plugin docs",
|
||||
@@ -604,213 +580,25 @@
|
||||
"reddit": "Workflows and questions."
|
||||
},
|
||||
"hub": {
|
||||
"metaTitle": "Paseo Hub - Agent automations on your machines",
|
||||
"metaDescription": "Automate the agents on your Paseo daemons from GitHub, Linear, Slack, Discord, schedules, and webhooks. Self-host Hub or use the hosted service.",
|
||||
"metaTitle": "Paseo Hub - GitHub, Slack, and Discord triggers",
|
||||
"metaDescription": "Run Paseo Hub yourself and start agents on your own machines from GitHub, Slack, and Discord.",
|
||||
"title": "Paseo Hub",
|
||||
"intro": "Automate coding agents and share daemons across your team. Every run executes on your own machines.",
|
||||
"runIt": "Run it yourself under Apache 2.0 or use the hosted service.",
|
||||
"hero": {
|
||||
"getStarted": "Get started",
|
||||
"selfHost": "Self-host"
|
||||
},
|
||||
"eyebrows": {
|
||||
"architecture": "Architecture",
|
||||
"pricing": "Pricing"
|
||||
},
|
||||
"automations": {
|
||||
"title": "Automations from every source",
|
||||
"description": "Triggers watch for events across your tools and start agents on your connected daemons."
|
||||
},
|
||||
"sources": {
|
||||
"github": {
|
||||
"name": "GitHub",
|
||||
"description": "Issues, pull requests, and comments."
|
||||
},
|
||||
"linear": {
|
||||
"name": "Linear",
|
||||
"description": "Issues, assignments, and comments."
|
||||
},
|
||||
"slack": {
|
||||
"name": "Slack",
|
||||
"description": "Mentions in channels and threads."
|
||||
},
|
||||
"discord": {
|
||||
"name": "Discord",
|
||||
"description": "Mentions in channels and threads."
|
||||
},
|
||||
"schedules": {
|
||||
"name": "Schedules",
|
||||
"description": "Recurring runs in your timezone."
|
||||
},
|
||||
"webhooks": {
|
||||
"name": "Webhooks",
|
||||
"description": "Events from any service or script."
|
||||
}
|
||||
},
|
||||
"demo": {
|
||||
"shared": {
|
||||
"tablistLabel": "Automation source previews",
|
||||
"openInPaseo": "Open in Paseo",
|
||||
"testsPassed": "tests passed",
|
||||
"appBadge": "APP",
|
||||
"docsLink": "Read {{source}} docs"
|
||||
},
|
||||
"slack": {
|
||||
"alt": "Slack thread in #engineering showing mo mentioning @paseo-bot to list P0 issues and open a pull request",
|
||||
"searchPlaceholder": "Search Paseo",
|
||||
"channels": "Channels",
|
||||
"apps": "Apps",
|
||||
"channelTopic": "Core daemon, mobile & Hub",
|
||||
"threadReplies": "3 replies",
|
||||
"typing": "paseo-bot is typing...",
|
||||
"composerPlaceholder": "Reply...",
|
||||
"showIssues": "<mention/> show me the latest P0 issues",
|
||||
"issuesOpen": "Three P0 issues are open:",
|
||||
"createPr": "<mention/> create a pull request for the first one",
|
||||
"ranOn": "Continued on <host>macbook-pro</host>. Opened <pr>getpaseo/paseo#1234</pr> with a fix for the terminal writes.",
|
||||
"filesChanged": "3 files changed",
|
||||
"caption": "Reply in the same thread to steer the running agent, or open the session in Paseo."
|
||||
},
|
||||
"github": {
|
||||
"alt": "GitHub issue #2811 showing mo labeling an issue and paseo-bot opening pull request #2819 with passing checks",
|
||||
"issueTitle": "Terminal output drops under sustained load",
|
||||
"issueMeta": "opened this issue 14 minutes ago · 2 comments",
|
||||
"authorBadge": "Owner",
|
||||
"botBadge": "bot",
|
||||
"openedAgo": "14 minutes ago",
|
||||
"repliedAgo": "9 minutes ago",
|
||||
"issueBody": "Fast output bursts drop frames when the PTY buffer fills up. <mention/> reproduce this and open a fix.",
|
||||
"addedLabel": "added the",
|
||||
"startedOn": "paseo-bot started on macbook-pro",
|
||||
"botReply": "Reproduced with a 64 KB burst test on <host>macbook-pro</host> and opened <pr>#2819</pr> to bound and drain the write queue.",
|
||||
"checksPassed": "All 4 checks passed",
|
||||
"assignees": "Assignees",
|
||||
"labels": "Labels",
|
||||
"development": "Development",
|
||||
"daemon": "Daemon",
|
||||
"caption": "Label an issue or comment to start an agent on your daemon and open a pull request."
|
||||
},
|
||||
"linear": {
|
||||
"alt": "Linear issue PAS-418 assigned to paseo-bot, running on devbox and linking pull request #2822",
|
||||
"issueTitle": "Relay reconnect loop on Android after sleep",
|
||||
"issueDescription": "After the phone wakes from Doze mode, the relay socket retries every 200ms without backoff.",
|
||||
"activity": "Activity",
|
||||
"assignedEvent": "assigned this issue to",
|
||||
"runningOn": "Ran on <host>devbox</host> · Codex",
|
||||
"traceLine": "Read relay/reconnect.ts, added jittered backoff and wake reset",
|
||||
"botSummary": "Added exponential backoff with a wake-state reset in <code>relay/reconnect.ts</code> and regression tests. Pull request is ready for review.",
|
||||
"properties": "Properties",
|
||||
"status": "Status",
|
||||
"priority": "Priority",
|
||||
"assignee": "Assignee",
|
||||
"creator": "Creator",
|
||||
"labels": "Labels",
|
||||
"daemon": "Daemon",
|
||||
"caption": "Assign an issue to start an agent on your daemon and link the pull request back."
|
||||
},
|
||||
"discord": {
|
||||
"alt": "Discord channel #engineering showing mo mentioning @paseo-bot and receiving a thread reply with pull request #2825",
|
||||
"textChannels": "Text channels",
|
||||
"channelTopic": "Daemon & CLI engineering",
|
||||
"threadTitle": "Fix stale worktrees",
|
||||
"time1": "Today at 10:12 AM",
|
||||
"time2": "Today at 10:16 AM",
|
||||
"userPrompt": "<mention/> fix the stale worktree branch cleanup bug from <issue/>",
|
||||
"startedThread": "started a thread:",
|
||||
"botStarted": "Running on <host>devbox</host> with OpenCode. Checking worktree close hooks.",
|
||||
"botFinished": "Pruned orphaned branches when an agent workspace closes and added a test.",
|
||||
"fieldHost": "Host",
|
||||
"fieldDiff": "Changes",
|
||||
"fieldChecks": "Checks",
|
||||
"composerPlaceholder": "Message #engineering",
|
||||
"caption": "Mention @paseo-bot in a channel to run an agent in a thread and report back."
|
||||
},
|
||||
"schedules": {
|
||||
"alt": "Daily CI optimizer schedule running at 7:00 AM on devbox, opening pull request #2831 and posting a summary to Slack",
|
||||
"active": "Active",
|
||||
"jobTitle": "Daily CI optimizer",
|
||||
"cadence": "Weekdays at 7:00 AM America/New_York",
|
||||
"step1Title": "Scheduled run #42 analyzed the last 24h of CI",
|
||||
"step1Detail": "Found <code>website-e2e</code> flaking in 18% of runs and cold Rust builds adding 2m 40s.",
|
||||
"step2Title": "Opened pull request on devbox",
|
||||
"metricRuntime": "Avg workflow",
|
||||
"metricFlake": "e2e flake rate",
|
||||
"metricCache": "Cargo cache",
|
||||
"slackPosted": "Posted to Slack",
|
||||
"slackSummary": "Morning CI report: cut average workflow time from <strong>7m 12s</strong> to <strong>4m 28s</strong> and fixed the e2e flake in <pr>#2831</pr>.",
|
||||
"notifiedMo": "cc @mo",
|
||||
"caption": "Run agents on a schedule in your timezone, open pull requests, and post to Slack."
|
||||
},
|
||||
"webhooks": {
|
||||
"alt": "A terminal shows a webhook POST. Hub returns 202 Accepted and starts a Codex run on devbox.",
|
||||
"runMeta": "devbox · Codex · getpaseo/paseo",
|
||||
"statusDone": "PR opened",
|
||||
"trace1": "Checked out <code>v0.19.4</code> in an isolated worktree",
|
||||
"trace2": "Traced <code>ECONNRESET</code> to idle keepalive timeout in <code>relay/server.ts</code>",
|
||||
"trace3": "Opened <pr/> with fix and regression test, all checks passed",
|
||||
"triggeredBy": "webhook · sentry-alert",
|
||||
"routedLine": "Hub routed to devbox · 118ms",
|
||||
"caption": "Send a POST request from any script or service to start an agent on your daemon."
|
||||
}
|
||||
},
|
||||
"authoring": {
|
||||
"title": "Configure in the dashboard or ship as code",
|
||||
"description": "Set up triggers in the browser or commit YAML files to your repository and deploy from the CLI.",
|
||||
"dashboardTitle": "Dashboard and run activity",
|
||||
"dashboardDescription": "Pick a daemon and working directory in the browser. Hub checks which providers, models, and modes the daemon offers as you configure a trigger.",
|
||||
"triggersLabel": "Triggers:",
|
||||
"triggersText": "Create, edit, or pause automations in form or YAML view.",
|
||||
"validationLabel": "Live checks:",
|
||||
"validationText": "See which providers, models, and modes the connected daemon offers.",
|
||||
"activityLabel": "Run activity:",
|
||||
"activityText": "Inspect deliveries, routing outcomes, outputs, and errors.",
|
||||
"docsLink": "Read configuration docs"
|
||||
},
|
||||
"shape": {
|
||||
"title": "Shared with your team, locked to your machines",
|
||||
"description": "Hub connects to the daemons you already run. Your team shares triggers and history while your code stays on your machines.",
|
||||
"triggersRow": "Automation sources",
|
||||
"webhooks": "webhooks, mentions, and schedules",
|
||||
"hub": "Hub",
|
||||
"hubHosting": "Self-hosted or hosted",
|
||||
"sameRpcs": "the same RPCs the app and CLI use",
|
||||
"daemonsRow": "Your connected daemons",
|
||||
"directOrRelay": "direct connection or encrypted relay",
|
||||
"appsRow": "Paseo clients",
|
||||
"desktop": "Desktop",
|
||||
"web": "Web",
|
||||
"mobile": "Mobile",
|
||||
"cli": "CLI"
|
||||
},
|
||||
"guardrails": {
|
||||
"optInTitle": "Opt-in execution",
|
||||
"optInDescription": "The <code>hub.execute</code> permission is off by default on every daemon and granted per machine.",
|
||||
"scopedTitle": "Scoped triggers",
|
||||
"scopedDescription": "Event triggers support sender allowlists and resource filters. You can set GitHub permissions for each step and scope the Slack and Discord tools.",
|
||||
"visibilityTitle": "Team visibility",
|
||||
"visibilityDescription": "Owners, admins, and members share daemons, triggers, run history, and routing outcomes."
|
||||
},
|
||||
"agents": {
|
||||
"title": "Runs the agents you already have",
|
||||
"description": "Hub discovers the providers on each connected Paseo daemon. You can run Claude Code, Codex, OpenCode, Pi, and custom providers, including those from plugins."
|
||||
},
|
||||
"intro": "An optional service that sits above your daemons and gives them extra capabilities.",
|
||||
"runIt": "Run it yourself or use the hosted service.",
|
||||
"pricing": {
|
||||
"title": "Self-host or hosted",
|
||||
"seatNote": "Run the open-source Hub yourself under Apache 2.0 or use the hosted service. Hub dashboard members and pending invitations count as seats.",
|
||||
"unavailable": "The hosted plan comparison is temporarily unavailable.",
|
||||
"selfHost": "Self-host docs",
|
||||
"title": "Choose how to run Hub",
|
||||
"unavailable": "The plan comparison is temporarily unavailable.",
|
||||
"selfHost": "Self-host Hub",
|
||||
"selfHosted": "Self-hosted",
|
||||
"free": "Free",
|
||||
"openSource": "/ Apache 2.0",
|
||||
"openSource": "/ open source",
|
||||
"getStarted": "Get started",
|
||||
"operateHub": "Run with <code>npx @getpaseo/hub</code> or Docker Compose",
|
||||
"allSources": "GitHub, Linear, Slack, Discord, schedules, and webhooks",
|
||||
"managedSources": "GitHub, Linear, Slack, Discord, schedules, and webhooks",
|
||||
"operateHub": "You operate Hub",
|
||||
"ownApps": "Provider apps you create and control",
|
||||
"openSourceFeature": "Apache 2.0 open source",
|
||||
"openSourceFeature": "Open source",
|
||||
"unlimitedRuns": "Unlimited agent runs",
|
||||
"runsPerMonth": "{{value}} agent runs a month",
|
||||
"noSeatCap": "No seat cap",
|
||||
"unlimitedUnits": "Unlimited {{unit}}s",
|
||||
"units_one": "{{value}} {{unit}}",
|
||||
"units_other": "{{value}} {{unit}}s",
|
||||
"perMonth": "/ month",
|
||||
@@ -819,32 +607,71 @@
|
||||
"perUnitMonths": "per {{unit}} / {{count}} months",
|
||||
"seat": "seat"
|
||||
},
|
||||
"triggers": {
|
||||
"title": "Triggers, running on your machines",
|
||||
"description": "Mention the bot in GitHub, Slack, or Discord and an agent starts on your daemon.",
|
||||
"github": "Issues, PRs, and reviews.",
|
||||
"slack": "Channels and threads.",
|
||||
"discord": "Channels and threads."
|
||||
},
|
||||
"demo": {
|
||||
"showIssues": "<mention/> show me the latest P0 issues",
|
||||
"issuesOpen": "Three P0 issues are open:",
|
||||
"createPr": "<mention/> create a pull request for the first one",
|
||||
"ranOn": "Ran on <host>macbook-pro</host>. Opened <pr>getpaseo/paseo#1234</pr> with a fix for the terminal writes.",
|
||||
"filesChanged": "3 files changed",
|
||||
"testsPassed": "tests passed",
|
||||
"bot": "Bot",
|
||||
"caption": "The agent ran on your daemon, with your keys."
|
||||
},
|
||||
"agents": {
|
||||
"title": "Runs the agents you already have",
|
||||
"description": "The Hub ships no agent of its own, so your team works with the providers, subscriptions, and skills already configured on your daemons."
|
||||
},
|
||||
"shape": {
|
||||
"title": "Works with your existing infrastructure",
|
||||
"description": "The Hub connects to the daemons you already run, and your apps keep connecting to those same daemons.",
|
||||
"triggersRow": "Triggers and teammates",
|
||||
"yourTeam": "Your team",
|
||||
"futureIntegrations": "Future integrations",
|
||||
"webhooks": "webhooks and mentions",
|
||||
"hub": "Hub",
|
||||
"hubHosting": "Self-hosted or managed",
|
||||
"sameRpcs": "the same RPCs the app and CLI use",
|
||||
"daemonsRow": "Your daemons",
|
||||
"directOrRelay": "direct connection or relay",
|
||||
"appsRow": "Paseo apps",
|
||||
"desktop": "Desktop",
|
||||
"web": "Web",
|
||||
"mobile": "Mobile",
|
||||
"cli": "CLI"
|
||||
},
|
||||
"faq": {
|
||||
"title": "FAQ",
|
||||
"whatQuestion": "What is Paseo Hub?",
|
||||
"whatAnswer": "Paseo Hub is a separate service that sits above your Paseo daemons. Connect one or more daemons to automate agent runs from GitHub, Linear, Slack, Discord, schedules, and webhooks, and share them with your team. Paseo works on its own without Hub.",
|
||||
"separateQuestion": "Why is Hub a separate service instead of part of the daemon?",
|
||||
"separateAnswer1": "The daemon stays a single process on one machine. Hub talks to daemons over the same RPCs that the app and CLI use, so anyone can build another service on top of Paseo.",
|
||||
"separateAnswer2": "Hub also has a different job. It receives public webhooks, handles team access, and runs multi-tenant. None of that belongs inside a single-machine daemon.",
|
||||
"whatQuestion": "What is the Hub?",
|
||||
"whatAnswer": "A separate service that sits above your Paseo daemons. You connect one or more daemons to it and it gives them GitHub, Slack, and Discord triggers, with collaboration features planned. Paseo works fully without it.",
|
||||
"separateQuestion": "Why is it a separate service instead of part of the daemon?",
|
||||
"separateAnswer1": "The daemon stays one lean executable on one machine. The Hub talks to daemons over the same RPCs the app and the CLI use, so anyone can build their own hub on top of Paseo.",
|
||||
"separateAnswer2": "It also has a different job. The Hub is meant to be exposed to the internet, shared with a team, and run multi-tenant. None of that belongs in a single machine daemon.",
|
||||
"selfHostQuestion": "Can I run it myself?",
|
||||
"selfHostAnswer": "Yes. Run <code>npx @getpaseo/hub</code> or start it with Docker Compose and finish setup in your browser. The Apache 2.0 source is on <github>GitHub</github>, and the <guide>self-hosting guide</guide> covers production deployments.",
|
||||
"selfHostAnswer": "Yes. Run <code>npx @getpaseo/hub</code> and complete setup in the browser. The source is available on <github>GitHub</github>, and the <guide>self-hosting guide</guide> covers more involved deployments.",
|
||||
"needQuestion": "What do I need to run it?",
|
||||
"needAnswer": "You need Node.js or Docker and a running Paseo daemon. Hub walks you through connecting your daemons and provider apps.",
|
||||
"needAnswer": "Node.js and a running Paseo daemon. Hub guides you through connecting the provider apps you want.",
|
||||
"hostedQuestion": "Is there a hosted version?",
|
||||
"hostedAnswer": "Yes. The <hosted>hosted service</hosted> runs the same open-source Hub software that you can self-host. Hub dashboard members and pending invitations count as seats.",
|
||||
"codeQuestion": "Can Hub run code on my machines?",
|
||||
"codeAnswer": "Only on daemons where you grant the <code>hub.execute</code> permission. Enrolling a daemon does not enable execution by default, and you can revoke the permission from the machine at any time.",
|
||||
"moveQuestion": "Do I have to move my team to a new tool?",
|
||||
"moveAnswer": "No. Hub runs from GitHub, Linear, Slack, Discord, schedules, and webhooks on the daemons you already use. When you want to inspect or steer a run directly, open the live session in Paseo on desktop or mobile.",
|
||||
"agentsQuestion": "Which agents does it run?",
|
||||
"agentsAnswer": "Hub runs the providers configured on your connected Paseo daemons, including custom providers from plugins. Agents use the subscriptions, models, and skills on those machines.",
|
||||
"hostedAnswer": "Yes. The hosted service runs the same Hub software you can self-host.",
|
||||
"plannedQuestion": "What else is planned?",
|
||||
"plannedIntro": "These capabilities are not built yet, and are listed so you know where Hub is heading.",
|
||||
"plannedProvisioning": "Provisioning remote daemons for your team",
|
||||
"plannedIntro": "Not built yet, listed so you know where this is going.",
|
||||
"plannedProvisioning": "Provisioning daemons for your team",
|
||||
"plannedSharing": "Sharing settings and skills across a team",
|
||||
"plannedIntegrations": "Additional provider integrations",
|
||||
"accessQuestion": "How do I get started?",
|
||||
"accessAnswer": "Self-host Hub with <code>npx @getpaseo/hub</code> or <hosted>sign in to hosted Hub</hosted> with a free account. Upgrade from Billing inside Hub when you need more runs or seats."
|
||||
"plannedIntegrations": "More integrations",
|
||||
"moveQuestion": "Do I have to move my team to a new tool?",
|
||||
"moveAnswer": "No. The Hub works in the Slack or Discord your team already uses, and on the daemons you already run. When the work gets serious you switch to the Paseo app on those same daemons.",
|
||||
"agentsQuestion": "Which agents does it run?",
|
||||
"agentsAnswer": "Whichever ones your daemons have configured, with your own subscriptions and skills. The Hub ships no agent of its own.",
|
||||
"codeQuestion": "Can the Hub run code on my machines?",
|
||||
"codeAnswer": "Yes, on the daemons you connect to it and nowhere else. That is the whole point of triggers, and it's why access to the beta stays small and trusted.",
|
||||
"accessQuestion": "How do I get access?",
|
||||
"accessAnswer": "You can self-host today or <hosted>sign in to Hosted Hub</hosted> for a free account. When you want more agent runs or more seats, upgrade from Billing inside Hub."
|
||||
}
|
||||
},
|
||||
"changelog": {
|
||||
|
||||
@@ -348,20 +348,6 @@
|
||||
"intro": "Paseo 原生支持许多 Agent,还可以运行任何 <acp>ACP Agent</acp>,你也可以通过<plugins>插件</plugins>添加新的 Provider。"
|
||||
},
|
||||
"landing": {
|
||||
"hubEyebrow": {
|
||||
"product": "Paseo Hub",
|
||||
"label": "在你自己的机器上自动化运行"
|
||||
},
|
||||
"eyebrows": {
|
||||
"providers": "Provider",
|
||||
"plugins": "插件",
|
||||
"openSource": "开源理念"
|
||||
},
|
||||
"closingCta": {
|
||||
"eyebrow": "开始使用",
|
||||
"title": "你的 Agent,在每块屏幕上。",
|
||||
"description": "下载桌面应用,或在任意机器上运行 daemon。基于 Apache 2.0 开源。"
|
||||
},
|
||||
"socialProof": {
|
||||
"title": "深受开发者喜爱",
|
||||
"description": "看看开发者们怎么评价 Paseo",
|
||||
@@ -383,17 +369,9 @@
|
||||
"remoteDescription": "在家庭实验室或云主机上运行 Paseo",
|
||||
"remoteCta": "文档",
|
||||
"teamsTitle": "团队与触发器",
|
||||
"teamsDescription": "通过 Paseo Hub 与团队共享 daemon 并自动化运行 Agent",
|
||||
"teamsDescription": "共享访问权限,或从 GitHub、Slack 和 Discord 发起工作",
|
||||
"teamsCta": "Paseo Hub"
|
||||
},
|
||||
"hubSection": {
|
||||
"description": "通过 GitHub、Linear、Slack、Discord、定时任务或 webhook 在你的机器上运行 Agent。",
|
||||
"flowTriggers": "触发来源",
|
||||
"flowDaemons": "已连接的 daemon",
|
||||
"flowOpenSession": "在 Paseo 中打开实时会话",
|
||||
"exploreCta": "了解 Paseo Hub",
|
||||
"docsCta": "自托管文档"
|
||||
},
|
||||
"automation": {
|
||||
"title": "为自动化而生",
|
||||
"description": "使用 MCP、CLI 或 TypeScript SDK 自动化 Paseo",
|
||||
@@ -415,9 +393,7 @@
|
||||
"plan": "我会把它做成本地插件并安装。",
|
||||
"done": "审查队列已出现在你的侧边栏。",
|
||||
"panelTitle": "审查队列",
|
||||
"libraryTitle": "社区插件",
|
||||
"libraryTitleCount_one": "{{count}} 个社区插件",
|
||||
"libraryTitleCount_other": "{{count}} 个社区插件",
|
||||
"libraryTitle": "400 多个社区插件",
|
||||
"libraryDescription": "开发者用的是和你的 Agent 相同的插件 API",
|
||||
"browse": "浏览插件",
|
||||
"docs": "插件文档",
|
||||
@@ -604,213 +580,25 @@
|
||||
"reddit": "工作流与问答。"
|
||||
},
|
||||
"hub": {
|
||||
"metaTitle": "Paseo Hub - 在你的机器上自动化运行 Agent",
|
||||
"metaDescription": "通过 GitHub、Linear、Slack、Discord、定时任务和 webhook,在你的 Paseo daemon 上自动运行 Agent。你可以自托管 Hub 或使用托管服务。",
|
||||
"metaTitle": "Paseo Hub - GitHub、Slack 和 Discord 触发器",
|
||||
"metaDescription": "自行运行 Paseo Hub,从 GitHub、Slack 和 Discord 在你自己的机器上启动 Agent。",
|
||||
"title": "Paseo Hub",
|
||||
"intro": "自动化运行编程 Agent,并与团队共享 daemon。每次运行都在你自己的机器上执行。",
|
||||
"runIt": "可基于 Apache 2.0 自托管运行,也可以使用托管服务。",
|
||||
"hero": {
|
||||
"getStarted": "开始使用",
|
||||
"selfHost": "自托管"
|
||||
},
|
||||
"eyebrows": {
|
||||
"architecture": "架构",
|
||||
"pricing": "定价"
|
||||
},
|
||||
"automations": {
|
||||
"title": "来自各类来源的自动化",
|
||||
"description": "触发器监听你各类工具中的事件,并在已连接的 daemon 上启动 Agent。"
|
||||
},
|
||||
"sources": {
|
||||
"github": {
|
||||
"name": "GitHub",
|
||||
"description": "Issue、PR 和评论。"
|
||||
},
|
||||
"linear": {
|
||||
"name": "Linear",
|
||||
"description": "Issue、分配和评论。"
|
||||
},
|
||||
"slack": {
|
||||
"name": "Slack",
|
||||
"description": "频道和讨论串中的提及。"
|
||||
},
|
||||
"discord": {
|
||||
"name": "Discord",
|
||||
"description": "频道和讨论串中的提及。"
|
||||
},
|
||||
"schedules": {
|
||||
"name": "定时任务",
|
||||
"description": "按你的时区定时运行。"
|
||||
},
|
||||
"webhooks": {
|
||||
"name": "Webhook",
|
||||
"description": "来自任意服务或脚本的事件。"
|
||||
}
|
||||
},
|
||||
"demo": {
|
||||
"shared": {
|
||||
"tablistLabel": "自动化来源预览",
|
||||
"openInPaseo": "在 Paseo 中打开",
|
||||
"testsPassed": "测试通过",
|
||||
"appBadge": "APP",
|
||||
"docsLink": "阅读 {{source}} 文档"
|
||||
},
|
||||
"slack": {
|
||||
"alt": "#engineering 中的 Slack 讨论串,展示 mo 提及 @paseo-bot 查看 P0 issue 并创建 PR",
|
||||
"searchPlaceholder": "搜索 Paseo",
|
||||
"channels": "频道",
|
||||
"apps": "应用",
|
||||
"channelTopic": "核心 daemon、移动端与 Hub",
|
||||
"threadReplies": "3 条回复",
|
||||
"typing": "paseo-bot 正在输入...",
|
||||
"composerPlaceholder": "回复...",
|
||||
"showIssues": "<mention/> 给我看看最新的 P0 issue",
|
||||
"issuesOpen": "目前有 3 个未关闭的 P0 issue:",
|
||||
"createPr": "<mention/> 为第一个创建一个 PR",
|
||||
"ranOn": "已在 <host>macbook-pro</host> 上继续运行。已创建 <pr>getpaseo/paseo#1234</pr>,修复了终端写入问题。",
|
||||
"filesChanged": "3 个文件已更改",
|
||||
"caption": "在同一讨论串中回复即可继续引导 Agent,或随时在 Paseo 中打开会话。"
|
||||
},
|
||||
"github": {
|
||||
"alt": "GitHub issue #2811,展示 mo 添加标签后 paseo-bot 创建 PR #2819 并通过全部检查",
|
||||
"issueTitle": "高负载下终端输出丢帧",
|
||||
"issueMeta": "于 14 分钟前创建此 issue · 2 条评论",
|
||||
"authorBadge": "Owner",
|
||||
"botBadge": "bot",
|
||||
"openedAgo": "14 分钟前",
|
||||
"repliedAgo": "9 分钟前",
|
||||
"issueBody": "PTY 缓冲区写满时,突发输出会丢失帧。<mention/> 复现这个问题并提交修复。",
|
||||
"addedLabel": "添加了标签",
|
||||
"startedOn": "paseo-bot 已在 macbook-pro 上启动",
|
||||
"botReply": "已在 <host>macbook-pro</host> 上通过 64 KB 突发测试复现,并创建 <pr>#2819</pr> 限制并排空写入队列。",
|
||||
"checksPassed": "全部 4 项检查已通过",
|
||||
"assignees": "负责人",
|
||||
"labels": "标签",
|
||||
"development": "开发关联",
|
||||
"daemon": "daemon",
|
||||
"caption": "添加 issue 标签或发表评论,即可在你的 daemon 上启动 Agent 并创建 PR。"
|
||||
},
|
||||
"linear": {
|
||||
"alt": "Linear issue PAS-418 分配给 paseo-bot 后在 devbox 上运行并关联 PR #2822",
|
||||
"issueTitle": "Android 休眠唤醒后中继陷入重连循环",
|
||||
"issueDescription": "手机从 Doze 模式唤醒后,中继套接字每 200ms 重试一次且没有退避。",
|
||||
"activity": "动态",
|
||||
"assignedEvent": "将此 issue 分配给了",
|
||||
"runningOn": "已在 <host>devbox</host> 上运行 · Codex",
|
||||
"traceLine": "已读取 relay/reconnect.ts,添加带抖动的退避和唤醒重置",
|
||||
"botSummary": "已在 <code>relay/reconnect.ts</code> 中添加指数退避与唤醒状态重置,并补充了回归测试。PR 已准备好等待审查。",
|
||||
"properties": "属性",
|
||||
"status": "状态",
|
||||
"priority": "优先级",
|
||||
"assignee": "负责人",
|
||||
"creator": "创建者",
|
||||
"labels": "标签",
|
||||
"daemon": "daemon",
|
||||
"caption": "将 issue 分配给 Agent,即可在你的 daemon 上运行修复并把 PR 关联回来。"
|
||||
},
|
||||
"discord": {
|
||||
"alt": "Discord 频道 #engineering,展示 mo 提及 @paseo-bot 后在讨论串中收到 PR #2825",
|
||||
"textChannels": "文字频道",
|
||||
"channelTopic": "daemon 与 CLI 工程",
|
||||
"threadTitle": "修复残留 worktree",
|
||||
"time1": "今天 10:12",
|
||||
"time2": "今天 10:16",
|
||||
"userPrompt": "<mention/> 修复 <issue/> 里残留 worktree 分支未清理的问题",
|
||||
"startedThread": "发起了讨论串:",
|
||||
"botStarted": "正在 <host>devbox</host> 上使用 OpenCode 运行,正在检查 worktree 关闭钩子。",
|
||||
"botFinished": "已在 Agent 工作区关闭时自动清理孤立分支,并添加了测试。",
|
||||
"fieldHost": "主机",
|
||||
"fieldDiff": "改动",
|
||||
"fieldChecks": "检查",
|
||||
"composerPlaceholder": "发送消息到 #engineering",
|
||||
"caption": "在频道中提及 @paseo-bot,即可在讨论串里启动 Agent 并回传结果。"
|
||||
},
|
||||
"schedules": {
|
||||
"alt": "每日 CI 优化定时任务在上午 7:00 于 devbox 上运行,创建 PR #2831 并在 Slack 发布摘要",
|
||||
"active": "运行中",
|
||||
"jobTitle": "每日 CI 优化",
|
||||
"cadence": "工作日 7:00 America/New_York",
|
||||
"step1Title": "定时运行 #42 分析了过去 24 小时的 CI",
|
||||
"step1Detail": "发现 <code>website-e2e</code> 有 18% 的概率不稳定,且冷启动 Rust 构建增加了 2m 40s。",
|
||||
"step2Title": "已在 devbox 上创建 PR",
|
||||
"metricRuntime": "平均耗时",
|
||||
"metricFlake": "e2e 不稳定率",
|
||||
"metricCache": "Cargo 缓存",
|
||||
"slackPosted": "已发送到 Slack",
|
||||
"slackSummary": "早间 CI 报告:将平均 workflow 耗时从 <strong>7m 12s</strong> 降至 <strong>4m 28s</strong>,并在 <pr>#2831</pr> 中修复了 e2e 不稳定问题。",
|
||||
"notifiedMo": "抄送 @mo",
|
||||
"caption": "按你的时区定时运行 Agent,自动创建 PR 并将摘要发送到 Slack。"
|
||||
},
|
||||
"webhooks": {
|
||||
"alt": "终端发送 webhook POST 请求。Hub 返回 202 Accepted 并在 devbox 上启动 Codex 运行。",
|
||||
"runMeta": "devbox · Codex · getpaseo/paseo",
|
||||
"statusDone": "已创建 PR",
|
||||
"trace1": "已在独立 worktree 中检出 <code>v0.19.4</code>",
|
||||
"trace2": "定位到 <code>ECONNRESET</code> 来自 <code>relay/server.ts</code> 的空闲 keepalive 超时",
|
||||
"trace3": "已创建 <pr/> 并附带修复与回归测试,全部检查已通过",
|
||||
"triggeredBy": "webhook · sentry-alert",
|
||||
"routedLine": "Hub 已路由到 devbox · 118ms",
|
||||
"caption": "从任意脚本或服务发送 POST 请求,即可立即在你的 daemon 上启动 Agent。"
|
||||
}
|
||||
},
|
||||
"authoring": {
|
||||
"title": "在仪表盘配置,或以代码方式部署",
|
||||
"description": "在浏览器中设置触发器,或将 YAML 文件提交到仓库并通过 CLI 部署。",
|
||||
"dashboardTitle": "仪表盘与运行活动",
|
||||
"dashboardDescription": "在浏览器中选择 daemon 和工作目录。配置触发器时,Hub 会检查该 daemon 提供哪些 Provider、模型和模式。",
|
||||
"triggersLabel": "触发器:",
|
||||
"triggersText": "在表单或 YAML 视图中创建、编辑或暂停自动化。",
|
||||
"validationLabel": "实时校验:",
|
||||
"validationText": "查看已连接的 daemon 提供的 Provider、模型和模式。",
|
||||
"activityLabel": "运行活动:",
|
||||
"activityText": "查看事件投递、路由结果、输出和错误。",
|
||||
"docsLink": "阅读配置文档"
|
||||
},
|
||||
"shape": {
|
||||
"title": "与团队共享,锁定在你的机器上",
|
||||
"description": "Hub 连接到你已在运行的 daemon。团队共享触发器与运行历史,你的代码留在你自己的机器上。",
|
||||
"triggersRow": "自动化来源",
|
||||
"webhooks": "webhook、提及与定时任务",
|
||||
"hub": "Hub",
|
||||
"hubHosting": "自托管或托管",
|
||||
"sameRpcs": "与应用和 CLI 相同的 RPC",
|
||||
"daemonsRow": "已连接的 daemon",
|
||||
"directOrRelay": "直连或端到端加密中继",
|
||||
"appsRow": "Paseo 客户端",
|
||||
"desktop": "桌面端",
|
||||
"web": "网页端",
|
||||
"mobile": "移动端",
|
||||
"cli": "CLI"
|
||||
},
|
||||
"guardrails": {
|
||||
"optInTitle": "主动授权执行",
|
||||
"optInDescription": "每个 daemon 的 <code>hub.execute</code> 权限默认关闭,按机器单独授予。",
|
||||
"scopedTitle": "受控触发范围",
|
||||
"scopedDescription": "事件触发器支持发送者白名单和资源过滤。你可以为每个步骤设置 GitHub 权限,也可以限制 Slack 和 Discord 工具的使用范围。",
|
||||
"visibilityTitle": "团队可见性",
|
||||
"visibilityDescription": "所有者、管理员和成员共享 daemon、触发器、运行历史和路由结果。"
|
||||
},
|
||||
"agents": {
|
||||
"title": "运行你已有的 Agent",
|
||||
"description": "Hub 会发现每个已连接的 Paseo daemon 上的 Provider。你可以运行 Claude Code、Codex、OpenCode、Pi 和自定义 Provider,包括插件提供的 Provider。"
|
||||
},
|
||||
"intro": "一个可选服务,位于你的 daemon 之上,为它们提供额外能力。",
|
||||
"runIt": "可以自行运行,也可以使用托管服务。",
|
||||
"pricing": {
|
||||
"title": "自托管或托管",
|
||||
"seatNote": "你可以按 Apache 2.0 许可自行运行开源 Hub,或使用托管服务。Hub 仪表盘成员和待接受的邀请都计入席位。",
|
||||
"unavailable": "托管方案对比暂时不可用。",
|
||||
"selfHost": "自托管文档",
|
||||
"title": "选择 Hub 的运行方式",
|
||||
"unavailable": "方案对比暂时不可用。",
|
||||
"selfHost": "自托管 Hub",
|
||||
"selfHosted": "自托管",
|
||||
"free": "免费",
|
||||
"openSource": "/ Apache 2.0",
|
||||
"openSource": "/ 开源",
|
||||
"getStarted": "开始使用",
|
||||
"operateHub": "通过 <code>npx @getpaseo/hub</code> 或 Docker Compose 运行",
|
||||
"allSources": "GitHub、Linear、Slack、Discord、定时任务与 webhook",
|
||||
"managedSources": "GitHub、Linear、Slack、Discord、定时任务与 webhook",
|
||||
"operateHub": "由你运营 Hub",
|
||||
"ownApps": "由你创建和控制的 Provider 应用",
|
||||
"openSourceFeature": "Apache 2.0 开源",
|
||||
"openSourceFeature": "开源",
|
||||
"unlimitedRuns": "无限次 Agent 运行",
|
||||
"runsPerMonth": "每月 {{value}} 次 Agent 运行",
|
||||
"noSeatCap": "无席位上限",
|
||||
"unlimitedUnits": "无限{{unit}}",
|
||||
"units_one": "{{value}} 个{{unit}}",
|
||||
"units_other": "{{value}} 个{{unit}}",
|
||||
"perMonth": "/ 月",
|
||||
@@ -819,32 +607,71 @@
|
||||
"perUnitMonths": "每{{unit}} / {{count}} 个月",
|
||||
"seat": "席位"
|
||||
},
|
||||
"triggers": {
|
||||
"title": "触发器,运行在你的机器上",
|
||||
"description": "在 GitHub、Slack 或 Discord 中提及机器人,就会在你的 daemon 上启动一个 Agent。",
|
||||
"github": "Issue、PR 和代码审查。",
|
||||
"slack": "频道和讨论串。",
|
||||
"discord": "频道和讨论串。"
|
||||
},
|
||||
"demo": {
|
||||
"showIssues": "<mention/> 给我看看最新的 P0 issue",
|
||||
"issuesOpen": "目前有三个未关闭的 P0 issue:",
|
||||
"createPr": "<mention/> 为第一个创建一个拉取请求",
|
||||
"ranOn": "已在 <host>macbook-pro</host> 上运行。已创建 <pr>getpaseo/paseo#1234</pr>,修复了终端写入问题。",
|
||||
"filesChanged": "3 个文件已更改",
|
||||
"testsPassed": "测试通过",
|
||||
"bot": "机器人",
|
||||
"caption": "Agent 在你的 daemon 上运行,使用你的密钥。"
|
||||
},
|
||||
"agents": {
|
||||
"title": "运行你已有的 Agent",
|
||||
"description": "Hub 本身不附带任何 Agent,因此你的团队使用的是 daemon 上已配置好的 Provider、订阅和技能。"
|
||||
},
|
||||
"shape": {
|
||||
"title": "适配你现有的基础设施",
|
||||
"description": "Hub 连接到你已在运行的 daemon,你的应用也继续连接这些 daemon。",
|
||||
"triggersRow": "触发器和团队成员",
|
||||
"yourTeam": "你的团队",
|
||||
"futureIntegrations": "未来的集成",
|
||||
"webhooks": "webhook 和提及",
|
||||
"hub": "Hub",
|
||||
"hubHosting": "自托管或托管",
|
||||
"sameRpcs": "与应用和 CLI 相同的 RPC",
|
||||
"daemonsRow": "你的 daemon",
|
||||
"directOrRelay": "直连或中继",
|
||||
"appsRow": "Paseo 应用",
|
||||
"desktop": "桌面端",
|
||||
"web": "网页端",
|
||||
"mobile": "移动端",
|
||||
"cli": "CLI"
|
||||
},
|
||||
"faq": {
|
||||
"title": "常见问题",
|
||||
"whatQuestion": "Paseo Hub 是什么?",
|
||||
"whatAnswer": "Paseo Hub 是位于你的 Paseo daemon 之上的独立服务。连接一个或多个 daemon 后,可以通过 GitHub、Linear、Slack、Discord、定时任务和 webhook 自动化运行 Agent,并与团队共享。没有 Hub,Paseo 也能独立工作。",
|
||||
"separateQuestion": "为什么 Hub 是独立服务,而不是 daemon 的一部分?",
|
||||
"separateAnswer1": "daemon 保持为单台机器上的单一进程。Hub 通过与应用和 CLI 相同的 RPC 与 daemon 通信,所以任何人都可以基于 Paseo 构建自己的服务。",
|
||||
"separateAnswer2": "Hub 的职责也不同。它接收公网 webhook、管理团队访问并以多租户方式运行,这些都不属于单机 daemon。",
|
||||
"whatQuestion": "Hub 是什么?",
|
||||
"whatAnswer": "一个独立的服务,位于你的 Paseo daemon 之上。你把一个或多个 daemon 连接到它,它就为这些 daemon 提供 GitHub、Slack 和 Discord 触发器,协作功能也在计划中。没有它,Paseo 也能完整工作。",
|
||||
"separateQuestion": "为什么它是独立服务,而不是 daemon 的一部分?",
|
||||
"separateAnswer1": "daemon 保持为单台机器上的一个精简可执行程序。Hub 通过与应用和 CLI 相同的 RPC 与 daemon 通信,所以任何人都可以基于 Paseo 构建自己的 hub。",
|
||||
"separateAnswer2": "它的职责也不同。Hub 需要暴露在互联网上、与团队共享,并以多租户方式运行。这些都不属于单机 daemon 的职责。",
|
||||
"selfHostQuestion": "我可以自己运行吗?",
|
||||
"selfHostAnswer": "可以。运行 <code>npx @getpaseo/hub</code> 或使用 Docker Compose 启动,然后在浏览器中完成设置。Apache 2.0 源代码在 <github>GitHub</github> 上,生产部署请参阅<guide>自托管指南</guide>。",
|
||||
"selfHostAnswer": "可以。运行 <code>npx @getpaseo/hub</code>,然后在浏览器中完成设置。源代码在 <github>GitHub</github> 上,更复杂的部署请参阅<guide>自托管指南</guide>。",
|
||||
"needQuestion": "运行它需要什么?",
|
||||
"needAnswer": "需要 Node.js 或 Docker,以及一个正在运行的 Paseo daemon。Hub 会引导你连接 daemon 和 Provider 应用。",
|
||||
"needAnswer": "Node.js 和一个正在运行的 Paseo daemon。Hub 会引导你连接需要的 Provider 应用。",
|
||||
"hostedQuestion": "有托管版本吗?",
|
||||
"hostedAnswer": "有。<hosted>托管服务</hosted>运行的就是你可以自托管的同一套开源 Hub 软件。Hub 仪表盘成员和待接受的邀请都计入席位。",
|
||||
"codeQuestion": "Hub 能在我的机器上运行代码吗?",
|
||||
"codeAnswer": "只能在授予了 <code>hub.execute</code> 权限的 daemon 上运行。注册 daemon 默认不会开启执行权限,你可以随时在本机撤销该权限。",
|
||||
"moveQuestion": "我需要把团队迁移到新工具吗?",
|
||||
"moveAnswer": "不需要。Hub 通过 GitHub、Linear、Slack、Discord、定时任务和 webhook 在你已有的 daemon 上运行。需要直接查看或引导运行时,在桌面端或移动端的 Paseo 中打开实时会话即可。",
|
||||
"agentsQuestion": "它运行哪些 Agent?",
|
||||
"agentsAnswer": "Hub 运行已连接的 Paseo daemon 上配置的 Provider,包括插件提供的自定义 Provider。Agent 使用这些机器上的订阅、模型和技能。",
|
||||
"hostedAnswer": "有。托管服务运行的就是你可以自托管的同一套 Hub 软件。",
|
||||
"plannedQuestion": "还计划了什么?",
|
||||
"plannedIntro": "以下能力尚未实现,列出来是为了让你了解 Hub 的方向。",
|
||||
"plannedProvisioning": "为团队预配远程 daemon",
|
||||
"plannedIntro": "以下尚未实现,列出来是为了让你了解方向。",
|
||||
"plannedProvisioning": "为团队预配 daemon",
|
||||
"plannedSharing": "在团队内共享设置和技能",
|
||||
"plannedIntegrations": "更多 Provider 集成",
|
||||
"accessQuestion": "如何开始使用?",
|
||||
"accessAnswer": "运行 <code>npx @getpaseo/hub</code> 自托管 Hub,或<hosted>登录托管版 Hub</hosted> 获取免费账户。需要更多运行次数或席位时,可在 Hub 内的账单页面升级。"
|
||||
"plannedIntegrations": "更多集成",
|
||||
"moveQuestion": "我需要把团队迁移到新工具吗?",
|
||||
"moveAnswer": "不需要。Hub 在你团队已在使用的 Slack 或 Discord 中工作,运行在你已有的 daemon 上。工作变得复杂时,你可以在同样的 daemon 上切换到 Paseo 应用。",
|
||||
"agentsQuestion": "它运行哪些 Agent?",
|
||||
"agentsAnswer": "你的 daemon 上配置了哪些就运行哪些,使用你自己的订阅和技能。Hub 本身不附带任何 Agent。",
|
||||
"codeQuestion": "Hub 能在我的机器上运行代码吗?",
|
||||
"codeAnswer": "能,但仅限于你连接到它的 daemon,其他地方都不行。这正是触发器的意义,也是测试版访问范围保持小而可信的原因。",
|
||||
"accessQuestion": "如何获得访问权限?",
|
||||
"accessAnswer": "你现在就可以自托管,或<hosted>登录托管版 Hub</hosted> 获取免费账户。需要更多 Agent 运行次数或更多席位时,可在 Hub 内的账单页面升级。"
|
||||
}
|
||||
},
|
||||
"changelog": {
|
||||
|
||||
@@ -50,7 +50,7 @@ Distribution: native apps for Mac, Windows, Linux, iOS, and Android; web app; Ho
|
||||
path: "/hub",
|
||||
title: "Paseo Hub",
|
||||
description:
|
||||
"Connect daemons and automate agents from GitHub, Linear, Slack, Discord, schedules, and webhooks through the hosted service or your own deployment.",
|
||||
"Connect daemons and run GitHub, Slack, Discord, and Linear workflows through the hosted service or your own deployment.",
|
||||
},
|
||||
{
|
||||
path: "/blog",
|
||||
@@ -104,7 +104,7 @@ Paseo 支持 Claude Code、Codex、GitHub Copilot、OpenCode、Pi、Antigravity
|
||||
path: "/hub",
|
||||
title: "Paseo Hub",
|
||||
description:
|
||||
"连接 daemon,通过托管服务或你自己的部署,使用 GitHub、Linear、Slack、Discord、定时任务和 webhook 自动化运行 Agent。",
|
||||
"连接 daemon,通过托管服务或你自己的部署运行 GitHub、Slack、Discord 和 Linear 工作流。",
|
||||
},
|
||||
{ path: "/blog", title: "博客", description: "Paseo 团队的动态和技术文章。" },
|
||||
{ path: "/privacy", title: "隐私", description: "隐私政策。" },
|
||||
|
||||
@@ -1,2 +1,2 @@
|
||||
export * from "./registry";
|
||||
export { getPluginCount, getRegistry, getRegistryPlugin } from "./loader";
|
||||
export { getRegistry, getRegistryPlugin } from "./loader";
|
||||
|
||||
@@ -3,7 +3,6 @@ import { env } from "cloudflare:workers";
|
||||
import { getWebsiteCacheContext } from "~/cloudflare-cache";
|
||||
import {
|
||||
loadInstallCounts,
|
||||
loadPluginCount,
|
||||
loadRegistryIndex,
|
||||
loadRegistryPlugin,
|
||||
type RegistryEnvironment,
|
||||
@@ -29,8 +28,3 @@ export const getRegistry = createServerFn({ method: "GET" }).handler(async () =>
|
||||
export const getRegistryPlugin = createServerFn({ method: "GET" })
|
||||
.validator((id: string) => id)
|
||||
.handler(({ data }) => loadRegistryPlugin(registryBase(), data, getWebsiteCacheContext()));
|
||||
|
||||
/** Listed plugin count from the cached registry index. */
|
||||
export const getPluginCount = createServerFn({ method: "GET" }).handler(() =>
|
||||
loadPluginCount(registryBase(), getWebsiteCacheContext()),
|
||||
);
|
||||
|
||||
@@ -13,7 +13,6 @@ import {
|
||||
useState,
|
||||
} from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { MOBILE_PAGE_BLEED_CLASS } from "~/components/page-frame";
|
||||
|
||||
const TILE_CLASS =
|
||||
"relative block aspect-video w-[85%] flex-shrink-0 overflow-hidden rounded-xl border border-white/10 bg-white/[0.03] sm:w-[60%]";
|
||||
@@ -81,9 +80,7 @@ export function MediaGallery({ name, media }: { name: string; media: string[] })
|
||||
const tileClass = items.length > 2 ? PEEKING_TILE_CLASS : FILLING_TILE_CLASS;
|
||||
return (
|
||||
<>
|
||||
<div
|
||||
className={`${MOBILE_PAGE_BLEED_CLASS} mt-10 flex gap-3 overflow-x-auto sm:-mx-8 sm:px-8 md:mx-0 md:px-0`}
|
||||
>
|
||||
<div className="-mx-6 mt-10 flex gap-3 overflow-x-auto px-6 md:mx-0 md:px-0">
|
||||
{entries.map((entry) =>
|
||||
typeof entry === "string" ? (
|
||||
<p key={entry}>{entry}</p>
|
||||
|
||||
@@ -5,11 +5,7 @@ import {
|
||||
} from "@getpaseo/protocol/plugin-registry";
|
||||
import { languageAlternates, LOCALES, localizePath } from "~/i18n";
|
||||
import { SITE_ORIGIN } from "~/meta";
|
||||
import {
|
||||
getBlockingColdCache,
|
||||
getNonBlockingColdCache,
|
||||
type WebsiteCacheContext,
|
||||
} from "../github-cache";
|
||||
import { getBlockingColdCache, type WebsiteCacheContext } from "../github-cache";
|
||||
import { handlePluginThumbnailRequest } from "./thumbnails";
|
||||
import { CATEGORIES } from "./categories";
|
||||
import { type InstallCounts, readInstallCounts, recordClientInstall } from "./installs";
|
||||
@@ -23,29 +19,14 @@ async function documentAt(base: string, path: string): Promise<unknown> {
|
||||
if (!response.ok) throw new Error(`Plugin registry returned ${response.status}`);
|
||||
return response.json();
|
||||
}
|
||||
function registryIndexCache(base: string, context: WebsiteCacheContext) {
|
||||
return {
|
||||
export function loadRegistryIndex(base: string, context: WebsiteCacheContext) {
|
||||
return getBlockingColdCache({
|
||||
context,
|
||||
key: `plugins:index:v1:${base}`,
|
||||
isValue: (value: unknown): value is ReturnType<typeof PluginRegistryIndexSchema.parse> =>
|
||||
isValue: (value): value is ReturnType<typeof PluginRegistryIndexSchema.parse> =>
|
||||
PluginRegistryIndexSchema.safeParse(value).success,
|
||||
fetchFresh: async () => PluginRegistryIndexSchema.parse(await documentAt(base, "index.json")),
|
||||
};
|
||||
}
|
||||
export function loadRegistryIndex(base: string, context: WebsiteCacheContext) {
|
||||
return getBlockingColdCache(registryIndexCache(base, context));
|
||||
}
|
||||
/** Count of listed plugins from the cached registry index. */
|
||||
export async function loadPluginCount(
|
||||
base: string,
|
||||
context: WebsiteCacheContext,
|
||||
): Promise<number | null> {
|
||||
try {
|
||||
const index = await getNonBlockingColdCache(registryIndexCache(base, context));
|
||||
return index?.plugins.length ?? null;
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
});
|
||||
}
|
||||
/** Install counts per window for every listed plugin, refreshed with the index cache. */
|
||||
export async function loadInstallCounts(base: string, context: WebsiteCacheContext) {
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
import { createHash } from "node:crypto";
|
||||
import { createServer, type ServerResponse } from "node:http";
|
||||
import { createServer } from "node:http";
|
||||
import { describe, expect, it } from "vitest";
|
||||
import { getTranslator } from "~/i18n";
|
||||
import {
|
||||
@@ -19,12 +19,7 @@ import {
|
||||
updatedAgo,
|
||||
} from "./registry";
|
||||
import { readInstallCounts, recordInstall } from "./installs";
|
||||
import {
|
||||
handlePluginRegistryRequest,
|
||||
loadPluginCount,
|
||||
loadRegistryIndex,
|
||||
loadRegistryPlugin,
|
||||
} from "./published";
|
||||
import { handlePluginRegistryRequest, loadRegistryIndex, loadRegistryPlugin } from "./published";
|
||||
const plugin: Plugin = {
|
||||
id: "acme/example",
|
||||
name: "Example",
|
||||
@@ -377,63 +372,6 @@ describe("plugin registry", () => {
|
||||
expect(at("https://gitlab.com/acme/example")).toBeUndefined();
|
||||
expect(at("javascript:alert(1)")).toBeUndefined();
|
||||
});
|
||||
|
||||
it("reads the listed plugin count from the registry index and falls back to null on errors", async () => {
|
||||
const context = { cache: seededIndex(), waitUntil: () => undefined };
|
||||
expect(await loadPluginCount("https://registry.example.test", context)).toBe(1);
|
||||
|
||||
const server = createServer((_request, response) => {
|
||||
response.statusCode = 503;
|
||||
response.end("unavailable");
|
||||
});
|
||||
await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
|
||||
const address = server.address();
|
||||
if (!address || typeof address === "string") throw new Error("Expected numeric port");
|
||||
try {
|
||||
const count = await loadPluginCount(`http://127.0.0.1:${address.port}`, {
|
||||
cache: memoryKv(),
|
||||
waitUntil: () => undefined,
|
||||
});
|
||||
expect(count).toBeNull();
|
||||
} finally {
|
||||
server.close();
|
||||
}
|
||||
});
|
||||
|
||||
it("returns a cold landing-page count before the registry responds and warms the shared index", async () => {
|
||||
const index = {
|
||||
schemaVersion: 1,
|
||||
registry: { name: "Test", url: "https://registry.example.test" },
|
||||
categories: [],
|
||||
plugins: [plugin],
|
||||
featured: [],
|
||||
generatedAt: "2026-10-03",
|
||||
};
|
||||
const server = createServer();
|
||||
const requested = new Promise<ServerResponse>((resolve) => {
|
||||
server.once("request", (_request, response) => resolve(response));
|
||||
});
|
||||
await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
|
||||
const address = server.address();
|
||||
if (!address || typeof address === "string") throw new Error("Expected numeric port");
|
||||
const base = `http://127.0.0.1:${address.port}`;
|
||||
const pending: Promise<unknown>[] = [];
|
||||
const context = {
|
||||
cache: memoryKv(),
|
||||
waitUntil: (promise: Promise<unknown>) => pending.push(promise),
|
||||
};
|
||||
const count = loadPluginCount(base, context);
|
||||
try {
|
||||
expect(await Promise.race([count, requested.then(() => "waiting on registry")])).toBeNull();
|
||||
const response = await requested;
|
||||
response.end(JSON.stringify(index));
|
||||
await Promise.all(pending);
|
||||
expect(await loadPluginCount(base, context)).toBe(1);
|
||||
} finally {
|
||||
server.closeAllConnections();
|
||||
await new Promise<void>((resolve) => server.close(() => resolve()));
|
||||
}
|
||||
});
|
||||
});
|
||||
|
||||
/** A cache holding a fresh registry index with `plugin`, so no request reaches the registry. */
|
||||
|
||||
@@ -1,23 +1,21 @@
|
||||
import { createFileRoute } from "@tanstack/react-router";
|
||||
import {
|
||||
ArrowRight,
|
||||
Check,
|
||||
CircleHelp,
|
||||
Filter,
|
||||
ShieldCheck,
|
||||
SlidersHorizontal,
|
||||
Users,
|
||||
} from "lucide-react";
|
||||
import { Check, CircleHelp } from "lucide-react";
|
||||
import * as React from "react";
|
||||
import type { ReactNode } from "react";
|
||||
import { Trans, useTranslation } from "react-i18next";
|
||||
import type { TFunction } from "i18next";
|
||||
import {
|
||||
ClaudeCodeIcon,
|
||||
CodexIcon,
|
||||
CursorIcon,
|
||||
OpenCodeIcon,
|
||||
PiIcon,
|
||||
} from "~/components/agent-icons";
|
||||
import { DiscordIcon, GitHubIcon, SlackIcon } from "~/components/brand-icons";
|
||||
import { HubLockup, PaseoHubLockup, PaseoHubMark } from "~/components/paseo-brand";
|
||||
import { AGENT_PAGES } from "~/data/agent-pages";
|
||||
import { FAQItem } from "~/components/faq-item";
|
||||
import { HubAutomationsShowcase } from "~/components/hub-automations";
|
||||
import { HUB_AGENT_HARNESSES, HubArchitectureDiagram } from "~/components/hub-flow";
|
||||
import { ChapterBand, HairlineGrid, PageHeaderBand, SectionOpener } from "~/components/page-frame";
|
||||
import { PaseoHubLockup } from "~/components/paseo-brand";
|
||||
import { SiteFooter } from "~/components/site-footer";
|
||||
import { SiteShell } from "~/components/site-shell";
|
||||
import {
|
||||
billingUnitLabel,
|
||||
formatPlanPrice,
|
||||
@@ -60,340 +58,68 @@ export const Route = createFileRoute("/{-$locale}/hub")({
|
||||
const HOSTED_HUB_URL = "https://hub.paseo.sh";
|
||||
|
||||
const LINK_CLASS = "underline hover:text-white/80";
|
||||
const PRIMARY_CTA_CLASS =
|
||||
"inline-flex items-center justify-center gap-2 rounded-lg bg-foreground px-4 py-2.5 text-sm font-medium text-background transition-colors hover:bg-foreground/90";
|
||||
const SECONDARY_CTA_CLASS =
|
||||
"inline-flex items-center justify-center gap-2 rounded-lg border border-white/12 px-4 py-2.5 text-sm text-white/85 transition-colors hover:bg-white/10 hover:text-white";
|
||||
|
||||
function Hub() {
|
||||
const { t } = useTranslation();
|
||||
const { plans } = Route.useLoaderData();
|
||||
return (
|
||||
<div className="min-h-screen bg-background">
|
||||
<PageHeaderBand />
|
||||
<main>
|
||||
<ChapterBand spacing="hero" ruled={false} ticks={false} framed={false}>
|
||||
<HubHero />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="section">
|
||||
<AutomationsSection />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="section">
|
||||
<AuthoringSection />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="section">
|
||||
<InfrastructureSection />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="compact">
|
||||
<AgentsSection />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="section" tint="subtle">
|
||||
<PricingSection plans={plans} />
|
||||
</ChapterBand>
|
||||
|
||||
<ChapterBand spacing="section">
|
||||
<FaqSection />
|
||||
</ChapterBand>
|
||||
</main>
|
||||
<SiteFooter width="default" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function HubHero() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
return (
|
||||
<header className="space-y-6">
|
||||
<h1>
|
||||
<PaseoHubLockup size="display" className="h-10 w-auto text-foreground md:h-12" />
|
||||
<SiteShell width="default">
|
||||
<h1 className="mb-5">
|
||||
<PaseoHubLockup className="h-9 md:h-10 w-auto text-foreground" />
|
||||
<span className="sr-only">{t("hub.title")}</span>
|
||||
</h1>
|
||||
<p className="max-w-2xl text-lg leading-relaxed text-white/70">{t("hub.intro")}</p>
|
||||
<div className="flex flex-wrap items-center gap-3 pt-1">
|
||||
<a href={HOSTED_HUB_URL} className={PRIMARY_CTA_CLASS}>
|
||||
{t("hub.hero.getStarted")}
|
||||
<ArrowRight className="h-4 w-4" aria-hidden="true" />
|
||||
</a>
|
||||
<a href={localize("/docs/hub")} className={SECONDARY_CTA_CLASS}>
|
||||
{t("hub.hero.selfHost")}
|
||||
</a>
|
||||
<p className="text-lg text-white/70 leading-relaxed max-w-2xl">{t("hub.intro")}</p>
|
||||
<p className="text-white/40 text-sm mt-3">{t("hub.runIt")}</p>
|
||||
|
||||
<div className="space-y-20 mt-16">
|
||||
<Triggers />
|
||||
<Agents />
|
||||
<Shape />
|
||||
<Pricing plans={plans} />
|
||||
<FaqSection />
|
||||
</div>
|
||||
<p className="text-sm text-white/45">{t("hub.runIt")}</p>
|
||||
</header>
|
||||
);
|
||||
}
|
||||
|
||||
function AutomationsSection() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section aria-labelledby="automations-heading">
|
||||
<SectionOpener
|
||||
headingId="automations-heading"
|
||||
title={t("hub.automations.title")}
|
||||
description={t("hub.automations.description")}
|
||||
/>
|
||||
<HubAutomationsShowcase />
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
const DASHBOARD_ITEMS = ["triggers", "validation", "activity"] as const;
|
||||
|
||||
function AuthoringSection() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
return (
|
||||
<section aria-labelledby="authoring-heading">
|
||||
<SectionOpener
|
||||
headingId="authoring-heading"
|
||||
title={t("hub.authoring.title")}
|
||||
description={t("hub.authoring.description")}
|
||||
/>
|
||||
|
||||
<HairlineGrid columns="2">
|
||||
<AuthoringDashboardCard docsHref={localize("/docs/hub/configuration")} />
|
||||
<AuthoringYamlCard />
|
||||
</HairlineGrid>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
function AuthoringDashboardCard({ docsHref }: { docsHref: string }) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex flex-col justify-between gap-6 bg-background p-6">
|
||||
<div className="space-y-5">
|
||||
<div className="flex items-center gap-2.5">
|
||||
<SlidersHorizontal className="h-4 w-4 text-accent-text" strokeWidth={1.5} />
|
||||
<h3 className="text-base font-medium text-white/90">
|
||||
{t("hub.authoring.dashboardTitle")}
|
||||
</h3>
|
||||
</div>
|
||||
<p className="text-sm leading-relaxed text-white/65">
|
||||
{t("hub.authoring.dashboardDescription")}
|
||||
</p>
|
||||
<ul className="space-y-3 border-t border-white/[0.08] pt-4">
|
||||
{DASHBOARD_ITEMS.map((item) => (
|
||||
<li key={item} className="flex items-start gap-2.5 text-sm">
|
||||
<Check aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-accent-text" />
|
||||
<span className="text-white/75">
|
||||
<span className="font-medium text-white/90">{t(`hub.authoring.${item}Label`)}</span>{" "}
|
||||
<span className="text-white/55">{t(`hub.authoring.${item}Text`)}</span>
|
||||
</span>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</div>
|
||||
<div>
|
||||
<a
|
||||
href={docsHref}
|
||||
className="inline-flex items-center gap-1.5 text-sm text-white/75 transition-colors hover:text-accent-text"
|
||||
>
|
||||
{t("hub.authoring.docsLink")}
|
||||
<ArrowRight className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function AuthoringYamlCard() {
|
||||
return (
|
||||
<div className="flex flex-col bg-[#0c1110]">
|
||||
<div className="flex items-center justify-between border-b border-white/[0.08] bg-white/[0.02] px-5 py-3">
|
||||
<span className="font-mono text-xs text-white/70">.paseo/triggers/slack-help.yml</span>
|
||||
<span className="rounded border border-white/10 px-1.5 py-0.5 font-mono text-[10px] text-white/40">
|
||||
YAML
|
||||
</span>
|
||||
</div>
|
||||
<pre className="flex-1 overflow-x-auto p-5 font-mono text-[12px] leading-6 text-white/75">
|
||||
<YamlLine k="name" v="slack-help" />
|
||||
<YamlKey k="on" />
|
||||
<YamlKey k="slack.mention" indent={2} />
|
||||
<YamlLine k="connection" v="acme-slack" indent={4} />
|
||||
<YamlKey k="filters" indent={4} />
|
||||
<YamlLine k="from_users" v="[U01234567]" indent={6} />
|
||||
<YamlKey k="run" />
|
||||
<YamlKey k="target" indent={2} />
|
||||
<YamlLine k="daemon" v="devbox" indent={4} />
|
||||
<YamlLine k="cwd" v="/workspace/app" indent={4} />
|
||||
<YamlKey k="agent" indent={2} />
|
||||
<YamlLine k="provider" v="codex" indent={4} />
|
||||
<YamlLine k="mode" v="full-access" indent={4} />
|
||||
<YamlLine k="continuation" v="{ mode: conversation }" indent={2} />
|
||||
<YamlLine k="prompt" v="|" indent={2} />
|
||||
<span className="block text-emerald-300/80">
|
||||
{" Answer with hub.reply, then call hub.finish_execution."}
|
||||
</span>
|
||||
<span className="block text-emerald-300/80">{" <user-prompt>"}</span>
|
||||
<span className="block text-emerald-300/80">{" ${{ paseo.prompt }}"}</span>
|
||||
<span className="block text-emerald-300/80">{" </user-prompt>"}</span>
|
||||
<YamlKey k="outputs" indent={2} />
|
||||
<YamlKey k="slack.reply" indent={4} />
|
||||
<YamlLine k="max" v="1" indent={6} />
|
||||
<YamlLine k="required" v="true" indent={6} />
|
||||
</pre>
|
||||
<div className="space-y-1 border-t border-white/[0.08] bg-white/[0.02] px-5 py-3.5 font-mono text-xs text-white/65">
|
||||
<div>
|
||||
<span className="select-none text-white/30">$ </span>
|
||||
<span className="text-white/90">paseo hub deploy</span>{" "}
|
||||
<span className="text-sky-300/80">--dry-run</span>
|
||||
</div>
|
||||
<div>
|
||||
<span className="select-none text-white/30">$ </span>
|
||||
<span className="text-white/90">paseo hub deploy</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function YamlKey({ k, indent = 0 }: { k: string; indent?: number }) {
|
||||
return (
|
||||
<span className="block">
|
||||
{" ".repeat(indent)}
|
||||
<span className="text-sky-300/80">{k}</span>
|
||||
<span className="text-white/35">:</span>
|
||||
</span>
|
||||
);
|
||||
}
|
||||
|
||||
function YamlLine({ k, v, indent = 0 }: { k: string; v: string; indent?: number }) {
|
||||
return (
|
||||
<span className="block">
|
||||
{" ".repeat(indent)}
|
||||
<span className="text-sky-300/80">{k}</span>
|
||||
<span className="text-white/35">: </span>
|
||||
<span className="text-emerald-300/80">{v}</span>
|
||||
</span>
|
||||
);
|
||||
}
|
||||
|
||||
const GUARDRAILS = [
|
||||
{ key: "optIn", Icon: ShieldCheck },
|
||||
{ key: "scoped", Icon: Filter },
|
||||
{ key: "visibility", Icon: Users },
|
||||
] as const;
|
||||
|
||||
const GUARDRAIL_CODE_COMPONENTS = {
|
||||
code: <code className="font-mono text-xs text-white/80" />,
|
||||
};
|
||||
|
||||
function InfrastructureSection() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section aria-labelledby="infrastructure-heading">
|
||||
<SectionOpener
|
||||
eyebrow={t("hub.eyebrows.architecture")}
|
||||
headingId="infrastructure-heading"
|
||||
title={t("hub.shape.title")}
|
||||
description={t("hub.shape.description")}
|
||||
/>
|
||||
|
||||
<div className="space-y-6">
|
||||
<HubArchitectureDiagram />
|
||||
|
||||
<HairlineGrid columns="3">
|
||||
{GUARDRAILS.map(({ key, Icon }) => (
|
||||
<div key={key} className="space-y-2.5 bg-background p-6">
|
||||
<div className="flex items-center gap-2.5">
|
||||
<Icon className="h-4 w-4 shrink-0 text-accent-text" strokeWidth={1.5} />
|
||||
<h3 className="text-sm font-medium text-white/90">
|
||||
{t(`hub.guardrails.${key}Title`)}
|
||||
</h3>
|
||||
</div>
|
||||
<p className="text-sm leading-relaxed text-white/60">
|
||||
<Trans
|
||||
i18nKey={`hub.guardrails.${key}Description`}
|
||||
components={GUARDRAIL_CODE_COMPONENTS}
|
||||
/>
|
||||
</p>
|
||||
</div>
|
||||
))}
|
||||
</HairlineGrid>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
function AgentsSection() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section aria-labelledby="agents-heading">
|
||||
<SectionOpener
|
||||
headingId="agents-heading"
|
||||
title={t("hub.agents.title")}
|
||||
description={t("hub.agents.description")}
|
||||
/>
|
||||
<HairlineGrid columns="3">
|
||||
{HUB_AGENT_HARNESSES.map(({ name, Icon }) => (
|
||||
<div key={name} className="flex items-center gap-3 bg-background px-5 py-4">
|
||||
<span className="text-white/80">
|
||||
<Icon className="h-5 w-5" />
|
||||
</span>
|
||||
<span className="text-sm font-medium text-white/90">{name}</span>
|
||||
</div>
|
||||
))}
|
||||
</HairlineGrid>
|
||||
</section>
|
||||
</SiteShell>
|
||||
);
|
||||
}
|
||||
|
||||
interface PlanFeature {
|
||||
key: string;
|
||||
label: ReactNode;
|
||||
label: string;
|
||||
tooltip: string | null;
|
||||
}
|
||||
|
||||
const PRICING_CODE_COMPONENTS = {
|
||||
code: <code className="font-mono text-xs text-white/85" />,
|
||||
};
|
||||
const SELF_HOSTED_FEATURES = [
|
||||
{ key: "operate-hub", labelKey: "operateHub" },
|
||||
{ key: "own-apps", labelKey: "ownApps" },
|
||||
{ key: "open-source", labelKey: "openSourceFeature" },
|
||||
] as const;
|
||||
|
||||
function PricingSection({ plans }: { plans: HubPlans | null }) {
|
||||
function Pricing({ plans }: { plans: HubPlans | null }) {
|
||||
const { t } = useTranslation();
|
||||
const locale = useLocale();
|
||||
const localize = useLocalizePath();
|
||||
const selfHostedFeatures = React.useMemo<readonly PlanFeature[]>(
|
||||
() => [
|
||||
{
|
||||
key: "operate-hub",
|
||||
label: <Trans i18nKey="hub.pricing.operateHub" components={PRICING_CODE_COMPONENTS} />,
|
||||
const selfHostedFeatures = React.useMemo(
|
||||
() =>
|
||||
SELF_HOSTED_FEATURES.map((feature) => ({
|
||||
key: feature.key,
|
||||
label: t(`hub.pricing.${feature.labelKey}`),
|
||||
tooltip: null,
|
||||
},
|
||||
{
|
||||
key: "all-sources",
|
||||
label: t("hub.pricing.allSources"),
|
||||
tooltip: null,
|
||||
},
|
||||
{
|
||||
key: "own-apps",
|
||||
label: t("hub.pricing.ownApps"),
|
||||
tooltip: null,
|
||||
},
|
||||
{
|
||||
key: "open-source",
|
||||
label: t("hub.pricing.openSourceFeature"),
|
||||
tooltip: null,
|
||||
},
|
||||
],
|
||||
})),
|
||||
[t],
|
||||
);
|
||||
|
||||
if (plans === null) {
|
||||
return (
|
||||
<section aria-labelledby="pricing-heading">
|
||||
<SectionOpener
|
||||
eyebrow={t("hub.eyebrows.pricing")}
|
||||
headingId="pricing-heading"
|
||||
title={t("hub.pricing.title")}
|
||||
description={t("hub.pricing.unavailable")}
|
||||
/>
|
||||
<a href={localize("/docs/hub/self-hosting")} className={SECONDARY_CTA_CLASS}>
|
||||
<section className="space-y-6" aria-labelledby="pricing-heading">
|
||||
<div className="space-y-2">
|
||||
<h2 id="pricing-heading" className="text-xl font-medium">
|
||||
{t("hub.pricing.title")}
|
||||
</h2>
|
||||
<p className="max-w-2xl leading-relaxed text-white/70">{t("hub.pricing.unavailable")}</p>
|
||||
</div>
|
||||
<a
|
||||
href={localize("/docs/hub/quickstart")}
|
||||
className="inline-block rounded-md border border-white/15 px-4 py-2 text-sm font-medium text-white/80 transition-colors hover:border-white/25 hover:text-white"
|
||||
>
|
||||
{t("hub.pricing.selfHost")}
|
||||
</a>
|
||||
</section>
|
||||
@@ -401,21 +127,18 @@ function PricingSection({ plans }: { plans: HubPlans | null }) {
|
||||
}
|
||||
|
||||
return (
|
||||
<section aria-labelledby="pricing-heading">
|
||||
<SectionOpener
|
||||
eyebrow={t("hub.eyebrows.pricing")}
|
||||
headingId="pricing-heading"
|
||||
title={t("hub.pricing.title")}
|
||||
description={t("hub.pricing.seatNote")}
|
||||
/>
|
||||
<HairlineGrid columns="3" clipContents={false}>
|
||||
<section className="space-y-6" aria-labelledby="pricing-heading">
|
||||
<h2 id="pricing-heading" className="text-xl font-medium">
|
||||
{t("hub.pricing.title")}
|
||||
</h2>
|
||||
<div className="grid gap-4 md:grid-cols-3">
|
||||
<PlanCard
|
||||
name={t("hub.pricing.selfHosted")}
|
||||
price={t("hub.pricing.free")}
|
||||
priceQualifier={t("hub.pricing.openSource")}
|
||||
priceTooltip={null}
|
||||
features={selfHostedFeatures}
|
||||
actionHref={localize("/docs/hub/self-hosting")}
|
||||
actionHref={localize("/docs/hub/quickstart")}
|
||||
actionLabel={t("hub.pricing.selfHost")}
|
||||
/>
|
||||
<PlanCard
|
||||
@@ -437,15 +160,14 @@ function PricingSection({ plans }: { plans: HubPlans | null }) {
|
||||
actionLabel={t("hub.pricing.getStarted")}
|
||||
featured
|
||||
/>
|
||||
</HairlineGrid>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* The figures the plan includes, ahead of the prose the catalog wrote for it. Hub serves plan
|
||||
* names, feature labels and tooltips in English, so those show as the catalog wrote them, except
|
||||
* the trigger summary key which maps to the current source list on this site.
|
||||
* names, feature labels and tooltips in English, so those show as the catalog wrote them.
|
||||
*/
|
||||
function planFeatures(plan: HubPlanOffer, t: TFunction, locale: Locale): readonly PlanFeature[] {
|
||||
return [
|
||||
@@ -459,10 +181,7 @@ function planFeatures(plan: HubPlanOffer, t: TFunction, locale: Locale): readonl
|
||||
label: formatSeats(plan.included.seats, billingUnitLabel(plan, t), t, locale),
|
||||
tooltip: null,
|
||||
},
|
||||
...plan.features.map((feature) => ({
|
||||
...feature,
|
||||
label: feature.key === "managed-triggers" ? t("hub.pricing.managedSources") : feature.label,
|
||||
})),
|
||||
...plan.features,
|
||||
];
|
||||
}
|
||||
|
||||
@@ -475,7 +194,7 @@ function formatAllowance(executionsPerMonth: number | null, t: TFunction, locale
|
||||
}
|
||||
|
||||
function formatSeats(seats: number | null, unit: string, t: TFunction, locale: Locale): string {
|
||||
if (seats === null) return t("hub.pricing.noSeatCap");
|
||||
if (seats === null) return t("hub.pricing.unlimitedUnits", { unit });
|
||||
return t("hub.pricing.units", { count: seats, value: formatNumber(seats, locale), unit });
|
||||
}
|
||||
|
||||
@@ -500,34 +219,30 @@ function PlanCard({
|
||||
}) {
|
||||
return (
|
||||
<article
|
||||
className={`flex flex-col p-6 first:rounded-t-[inherit] last:rounded-b-[inherit] md:p-7 md:first:rounded-tr-none md:first:rounded-bl-[inherit] md:last:rounded-tr-[inherit] md:last:rounded-bl-none ${featured ? "bg-brand-green/[0.08]" : "bg-background"}`}
|
||||
className={`flex flex-col rounded-2xl border p-6 ${featured ? "border-white/25 bg-white/[0.06]" : "border-white/10 bg-white/[0.02]"}`}
|
||||
>
|
||||
<h3 className="text-lg font-medium text-white/90">{name}</h3>
|
||||
<div className="relative mt-5 flex items-end gap-2">
|
||||
<h3 className="text-xl font-medium">{name}</h3>
|
||||
<div className="mt-6 flex items-end gap-2">
|
||||
<span className="text-4xl font-medium tracking-tight">{price}</span>
|
||||
<span className="mb-1 inline-flex items-center gap-1 text-sm text-white/45">
|
||||
{priceQualifier}
|
||||
{priceTooltip !== null ? <InfoTip text={priceTooltip} /> : null}
|
||||
{priceTooltip !== null && <InfoTip text={priceTooltip} />}
|
||||
</span>
|
||||
</div>
|
||||
{features.length > 0 ? (
|
||||
{features.length > 0 && (
|
||||
<ul className="mt-6 grid flex-1 content-start gap-3 text-sm text-white/70">
|
||||
{features.map((feature) => (
|
||||
<li key={feature.key} className="relative flex items-start gap-2.5">
|
||||
<Check aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-accent-text" />
|
||||
<li key={feature.key} className="flex items-start gap-2.5">
|
||||
<Check aria-hidden="true" className="mt-0.5 size-4 shrink-0 text-emerald-300" />
|
||||
<span>{feature.label}</span>
|
||||
{feature.tooltip !== null ? <InfoTip text={feature.tooltip} /> : null}
|
||||
{feature.tooltip !== null && <InfoTip text={feature.tooltip} />}
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
) : null}
|
||||
)}
|
||||
<a
|
||||
href={actionHref}
|
||||
className={`mt-8 rounded-lg px-4 py-2.5 text-center text-sm font-medium transition-colors ${
|
||||
featured
|
||||
? "bg-foreground text-background hover:bg-foreground/90"
|
||||
: "border border-white/15 text-white/85 hover:border-white/25 hover:bg-white/[0.04] hover:text-white"
|
||||
}`}
|
||||
className={`rounded-md px-4 py-2 text-center text-sm font-medium transition-colors mt-8 ${featured ? "bg-white text-black hover:bg-white/90" : "border border-white/15 text-white/80 hover:border-white/25 hover:text-white"}`}
|
||||
>
|
||||
{actionLabel}
|
||||
</a>
|
||||
@@ -537,11 +252,11 @@ function PlanCard({
|
||||
|
||||
function InfoTip({ text }: { text: string }) {
|
||||
return (
|
||||
<span className="group inline-flex shrink-0" tabIndex={0}>
|
||||
<span className="group relative inline-flex shrink-0" tabIndex={0}>
|
||||
<CircleHelp aria-label={text} className="size-3.5 text-white/35" />
|
||||
<span
|
||||
role="tooltip"
|
||||
className="pointer-events-none absolute bottom-full left-0 z-10 mb-2 hidden w-full max-w-56 rounded-md border border-white/10 bg-[#17201f] px-3 py-2 text-xs leading-relaxed text-white/75 shadow-xl group-hover:block group-focus:block"
|
||||
className="pointer-events-none absolute bottom-full left-1/2 z-10 mb-2 hidden w-56 -translate-x-1/2 rounded-md border border-white/10 bg-[#17201f] px-3 py-2 text-xs leading-relaxed text-white/75 shadow-xl group-hover:block group-focus:block"
|
||||
>
|
||||
{text}
|
||||
</span>
|
||||
@@ -549,15 +264,325 @@ function InfoTip({ text }: { text: string }) {
|
||||
);
|
||||
}
|
||||
|
||||
const SIMPLE_FAQ_ENTRIES = ["need"] as const;
|
||||
const LATER_FAQ_ENTRIES = ["move", "agents"] as const;
|
||||
const TRIGGER_SURFACES = [
|
||||
{ name: "GitHub", icon: <GitHubIcon className="h-6 w-6" />, body: "github" },
|
||||
{ name: "Slack", icon: <SlackIcon className="h-6 w-6" />, body: "slack" },
|
||||
{ name: "Discord", icon: <DiscordIcon className="h-6 w-6" />, body: "discord" },
|
||||
] as const;
|
||||
|
||||
function Triggers() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section className="space-y-6">
|
||||
<h2 className="text-xl font-medium">{t("hub.triggers.title")}</h2>
|
||||
<p className="text-white/70 leading-relaxed max-w-2xl">{t("hub.triggers.description")}</p>
|
||||
<div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
|
||||
{TRIGGER_SURFACES.map((surface) => (
|
||||
<div
|
||||
key={surface.name}
|
||||
className="flex items-center gap-3 rounded-xl border border-white/10 bg-white/[0.03] px-5 py-4"
|
||||
>
|
||||
<span className="text-white/80">{surface.icon}</span>
|
||||
<span className="min-w-0">
|
||||
<span className="block font-medium">{surface.name}</span>
|
||||
<span className="block text-xs text-muted-foreground">
|
||||
{t(`hub.triggers.${surface.body}`)}
|
||||
</span>
|
||||
</span>
|
||||
</div>
|
||||
))}
|
||||
</div>
|
||||
<DiscordDemo />
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
const DEMO_ISSUES = [
|
||||
{ id: "#2811", title: "Terminal output drops under load" },
|
||||
{ id: "#2804", title: "Relay reconnect loop on Android after sleep" },
|
||||
{ id: "#2799", title: "Worktree cleanup leaves stale branches" },
|
||||
];
|
||||
|
||||
const DEMO_COMPONENTS = {
|
||||
mention: <Mention />,
|
||||
host: <span className="font-mono text-white/50" />,
|
||||
pr: <span className="text-white/80 underline decoration-white/20" />,
|
||||
};
|
||||
|
||||
function DiscordDemo() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<figure className="space-y-3">
|
||||
<div className="overflow-hidden rounded-2xl border border-white/10 bg-white/[0.02]">
|
||||
<div className="flex items-center gap-2 border-b border-white/10 bg-white/[0.03] px-5 py-3">
|
||||
<DiscordIcon className="h-4 w-4 text-white/40" />
|
||||
<span className="font-mono text-xs text-white/50">#engineering</span>
|
||||
</div>
|
||||
<div className="space-y-5 p-5">
|
||||
<DemoMessage author="moboudra" time="09:41">
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.showIssues" components={DEMO_COMPONENTS} />
|
||||
</p>
|
||||
</DemoMessage>
|
||||
|
||||
<DemoMessage author="paseo-bot" time="09:41" bot>
|
||||
<p>{t("hub.demo.issuesOpen")}</p>
|
||||
<ul className="space-y-1">
|
||||
{DEMO_ISSUES.map((issue) => (
|
||||
<li key={issue.id} className="flex gap-2">
|
||||
<span className="font-mono text-white/40">{issue.id}</span>
|
||||
<span>{issue.title}</span>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</DemoMessage>
|
||||
|
||||
<DemoMessage author="moboudra" time="09:43">
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.createPr" components={DEMO_COMPONENTS} />
|
||||
</p>
|
||||
</DemoMessage>
|
||||
|
||||
<DemoMessage author="paseo-bot" time="09:48" bot>
|
||||
<p>
|
||||
<Trans i18nKey="hub.demo.ranOn" components={DEMO_COMPONENTS} />
|
||||
</p>
|
||||
<div className="flex flex-wrap items-center gap-2 pt-1">
|
||||
<span className="rounded-full bg-emerald-400/10 px-2 py-1 text-xs text-emerald-300">
|
||||
{t("hub.demo.filesChanged")}
|
||||
</span>
|
||||
<span className="rounded-full border border-white/10 px-2 py-1 text-xs text-white/40">
|
||||
{t("hub.demo.testsPassed")}
|
||||
</span>
|
||||
</div>
|
||||
</DemoMessage>
|
||||
</div>
|
||||
</div>
|
||||
<figcaption className="text-sm text-muted-foreground">{t("hub.demo.caption")}</figcaption>
|
||||
</figure>
|
||||
);
|
||||
}
|
||||
|
||||
function Mention() {
|
||||
return <span className="rounded bg-indigo-400/15 px-1 py-0.5 text-indigo-200">@paseo-bot</span>;
|
||||
}
|
||||
|
||||
function DemoMessage({
|
||||
author,
|
||||
time,
|
||||
bot,
|
||||
children,
|
||||
}: {
|
||||
author: string;
|
||||
time: string;
|
||||
bot?: boolean;
|
||||
children: ReactNode;
|
||||
}) {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<div className="flex gap-3">
|
||||
<div className="flex h-8 w-8 flex-shrink-0 items-center justify-center rounded-full border border-white/10 bg-white/[0.06]">
|
||||
{bot ? (
|
||||
<PaseoHubMark className="h-5 w-5 text-white" />
|
||||
) : (
|
||||
<span className="text-xs font-medium text-white/60">M</span>
|
||||
)}
|
||||
</div>
|
||||
<div className="min-w-0 space-y-1">
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-sm font-medium text-white/90">{author}</span>
|
||||
{bot && (
|
||||
<span className="rounded bg-indigo-400/15 px-1.5 py-0.5 text-[10px] font-medium uppercase tracking-wide text-indigo-200">
|
||||
{t("hub.demo.bot")}
|
||||
</span>
|
||||
)}
|
||||
<span className="text-xs text-white/25">{time}</span>
|
||||
</div>
|
||||
<div className="space-y-2 text-sm text-white/70 leading-relaxed">{children}</div>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
const AGENT_LOGOS = [
|
||||
{ name: "Claude Code", icon: <ClaudeCodeIcon className="h-6 w-6" /> },
|
||||
{ name: "Codex", icon: <CodexIcon className="h-6 w-6" /> },
|
||||
{ name: "OpenCode", icon: <OpenCodeIcon className="h-6 w-6" /> },
|
||||
{ name: "Cursor", icon: <CursorIcon className="h-6 w-6" /> },
|
||||
{ name: "Pi", icon: <PiIcon className="h-6 w-6" /> },
|
||||
];
|
||||
|
||||
const MORE_AGENT_COUNT = AGENT_PAGES.length - AGENT_LOGOS.length;
|
||||
|
||||
function Agents() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
return (
|
||||
<section className="space-y-6">
|
||||
<h2 className="text-xl font-medium">{t("hub.agents.title")}</h2>
|
||||
<p className="text-white/70 leading-relaxed max-w-2xl">{t("hub.agents.description")}</p>
|
||||
<div className="flex flex-wrap items-center gap-3">
|
||||
{AGENT_LOGOS.map((agent) => (
|
||||
<div
|
||||
key={agent.name}
|
||||
className="flex items-center gap-2.5 rounded-xl border border-white/10 bg-white/[0.03] px-4 py-3"
|
||||
>
|
||||
<span className="text-white/80">{agent.icon}</span>
|
||||
<span className="text-sm font-medium">{agent.name}</span>
|
||||
</div>
|
||||
))}
|
||||
<a
|
||||
href={localize("/agents")}
|
||||
className="rounded-xl border border-dashed border-white/10 bg-white/[0.01] px-4 py-3 text-sm font-medium text-white/50 hover:text-white/80 hover:border-white/20 transition-colors"
|
||||
>
|
||||
{t("common.more", { count: MORE_AGENT_COUNT })}
|
||||
</a>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
const DIAGRAM_SURFACES = [
|
||||
{ name: "GitHub", icon: <GitHubIcon className="h-5 w-5" /> },
|
||||
{ name: "Slack", icon: <SlackIcon className="h-5 w-5" /> },
|
||||
{ name: "Discord", icon: <DiscordIcon className="h-5 w-5" /> },
|
||||
];
|
||||
|
||||
const CLAUDE_MARK = { name: "Claude Code", icon: <ClaudeCodeIcon className="h-4 w-4" /> };
|
||||
const CODEX_MARK = { name: "Codex", icon: <CodexIcon className="h-4 w-4" /> };
|
||||
const OPENCODE_MARK = { name: "OpenCode", icon: <OpenCodeIcon className="h-4 w-4" /> };
|
||||
const PI_MARK = { name: "Pi", icon: <PiIcon className="h-4 w-4" /> };
|
||||
|
||||
const DIAGRAM_DAEMONS = [
|
||||
{ name: "MacBook Pro", agents: [CLAUDE_MARK, CODEX_MARK, OPENCODE_MARK] },
|
||||
{ name: "Hetzner VM", agents: [CLAUDE_MARK, PI_MARK] },
|
||||
];
|
||||
|
||||
const DIAGRAM_CLIENTS = ["desktop", "web", "mobile", "cli"] as const;
|
||||
|
||||
function Shape() {
|
||||
const { t } = useTranslation();
|
||||
return (
|
||||
<section className="space-y-6">
|
||||
<h2 className="text-xl font-medium">{t("hub.shape.title")}</h2>
|
||||
<p className="text-white/70 leading-relaxed max-w-2xl">{t("hub.shape.description")}</p>
|
||||
|
||||
<div className="rounded-2xl border border-white/10 bg-white/[0.02] p-6 md:p-8">
|
||||
<div className="flex flex-col items-center">
|
||||
<DiagramRow label={t("hub.shape.triggersRow")}>
|
||||
{DIAGRAM_SURFACES.map((surface) => (
|
||||
<DiagramCard key={surface.name} icon={surface.icon} name={surface.name} />
|
||||
))}
|
||||
<DiagramCard name={t("hub.shape.yourTeam")} />
|
||||
<div className="flex items-center justify-center rounded-xl border border-dashed border-white/10 bg-white/[0.01] px-4 py-3 text-sm text-white/30">
|
||||
{t("hub.shape.futureIntegrations")}
|
||||
</div>
|
||||
</DiagramRow>
|
||||
|
||||
<Connector label={t("hub.shape.webhooks")} />
|
||||
|
||||
<div className="w-full max-w-xs rounded-xl border border-white/20 bg-white/[0.06] px-6 py-5 text-center">
|
||||
<p className="flex justify-center">
|
||||
<HubLockup className="h-[22px] w-auto text-foreground" />
|
||||
<span className="sr-only">{t("hub.shape.hub")}</span>
|
||||
</p>
|
||||
<p className="text-xs text-muted-foreground mt-1.5">{t("hub.shape.hubHosting")}</p>
|
||||
</div>
|
||||
|
||||
<Connector label={t("hub.shape.sameRpcs")} />
|
||||
|
||||
<DiagramRow label={t("hub.shape.daemonsRow")}>
|
||||
{DIAGRAM_DAEMONS.map((daemon) => (
|
||||
<div
|
||||
key={daemon.name}
|
||||
className="flex items-center gap-3 rounded-xl border border-white/10 bg-white/[0.03] px-4 py-3"
|
||||
>
|
||||
<span className="text-white/70">
|
||||
<MachineIcon />
|
||||
</span>
|
||||
<span className="text-sm font-medium">{daemon.name}</span>
|
||||
<span className="flex items-center gap-2 border-l border-white/10 pl-3 text-white/40">
|
||||
{daemon.agents.map((agent) => (
|
||||
<span key={agent.name} title={agent.name}>
|
||||
{agent.icon}
|
||||
</span>
|
||||
))}
|
||||
</span>
|
||||
</div>
|
||||
))}
|
||||
</DiagramRow>
|
||||
|
||||
<Connector label={t("hub.shape.directOrRelay")} />
|
||||
|
||||
<DiagramRow label={t("hub.shape.appsRow")}>
|
||||
{DIAGRAM_CLIENTS.map((client) => (
|
||||
<DiagramCard key={client} name={t(`hub.shape.${client}`)} />
|
||||
))}
|
||||
</DiagramRow>
|
||||
</div>
|
||||
</div>
|
||||
</section>
|
||||
);
|
||||
}
|
||||
|
||||
function DiagramRow({ label, children }: { label: string; children: ReactNode }) {
|
||||
return (
|
||||
<div className="w-full space-y-2">
|
||||
<p className="text-center text-xs uppercase tracking-wide text-white/25">{label}</p>
|
||||
<div className="flex flex-wrap justify-center gap-3">{children}</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function DiagramCard({ name, icon }: { name: string; icon?: ReactNode }) {
|
||||
return (
|
||||
<div className="flex items-center gap-2.5 rounded-xl border border-white/10 bg-white/[0.03] px-4 py-3">
|
||||
{icon && <span className="text-white/70">{icon}</span>}
|
||||
<span className="text-sm font-medium">{name}</span>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function Connector({ label }: { label: string }) {
|
||||
return (
|
||||
<div className="flex flex-col items-center gap-2 py-4">
|
||||
<div className="h-5 w-px border-l border-dashed border-white/25" />
|
||||
<p className="text-center text-[11px] text-white/30">{label}</p>
|
||||
<div className="h-5 w-px border-l border-dashed border-white/25" />
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function MachineIcon() {
|
||||
return (
|
||||
<svg
|
||||
width="20"
|
||||
height="20"
|
||||
viewBox="0 0 24 24"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
strokeWidth="1.5"
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
aria-hidden="true"
|
||||
>
|
||||
<rect x="2" y="2" width="20" height="8" rx="2" />
|
||||
<rect x="2" y="14" width="20" height="8" rx="2" />
|
||||
<circle cx="6" cy="6" r="1" />
|
||||
<circle cx="6" cy="18" r="1" />
|
||||
</svg>
|
||||
);
|
||||
}
|
||||
|
||||
const SIMPLE_FAQ_ENTRIES = ["need", "hosted"] as const;
|
||||
const LATER_FAQ_ENTRIES = ["move", "agents", "code"] as const;
|
||||
|
||||
function FaqSection() {
|
||||
const { t } = useTranslation();
|
||||
const localize = useLocalizePath();
|
||||
const links = React.useMemo(
|
||||
() => ({
|
||||
code: <code className="font-mono text-xs text-white/80" />,
|
||||
code: <code />,
|
||||
github: <a href="https://github.com/getpaseo/hub" className={LINK_CLASS} />,
|
||||
guide: <a href={localize("/docs/hub/self-hosting")} className={LINK_CLASS} />,
|
||||
hosted: <a href={HOSTED_HUB_URL} className={LINK_CLASS} />,
|
||||
@@ -565,16 +590,9 @@ function FaqSection() {
|
||||
[localize],
|
||||
);
|
||||
return (
|
||||
<section
|
||||
aria-labelledby="faq-heading"
|
||||
className="grid items-start gap-10 lg:grid-cols-[minmax(0,17rem)_minmax(0,1fr)] lg:gap-16"
|
||||
>
|
||||
<SectionOpener
|
||||
headingId="faq-heading"
|
||||
title={t("hub.faq.title")}
|
||||
className="mb-0 self-start"
|
||||
/>
|
||||
<div className="divide-y divide-white/[0.08] border-y border-white/[0.08]">
|
||||
<section className="space-y-6">
|
||||
<h2 className="text-3xl font-medium">{t("hub.faq.title")}</h2>
|
||||
<div className="space-y-6">
|
||||
<FAQItem question={t("hub.faq.whatQuestion")}>{t("hub.faq.whatAnswer")}</FAQItem>
|
||||
<FAQItem question={t("hub.faq.separateQuestion")}>
|
||||
<p>{t("hub.faq.separateAnswer1")}</p>
|
||||
@@ -588,17 +606,6 @@ function FaqSection() {
|
||||
{t(`hub.faq.${entry}Answer`)}
|
||||
</FAQItem>
|
||||
))}
|
||||
<FAQItem question={t("hub.faq.hostedQuestion")}>
|
||||
<Trans i18nKey="hub.faq.hostedAnswer" components={links} />
|
||||
</FAQItem>
|
||||
<FAQItem question={t("hub.faq.codeQuestion")}>
|
||||
<Trans i18nKey="hub.faq.codeAnswer" components={links} />
|
||||
</FAQItem>
|
||||
{LATER_FAQ_ENTRIES.map((entry) => (
|
||||
<FAQItem key={entry} question={t(`hub.faq.${entry}Question`)}>
|
||||
{t(`hub.faq.${entry}Answer`)}
|
||||
</FAQItem>
|
||||
))}
|
||||
<FAQItem question={t("hub.faq.plannedQuestion")}>
|
||||
<p>{t("hub.faq.plannedIntro")}</p>
|
||||
<ul className="list-disc space-y-1 pl-5">
|
||||
@@ -607,6 +614,11 @@ function FaqSection() {
|
||||
<li>{t("hub.faq.plannedIntegrations")}</li>
|
||||
</ul>
|
||||
</FAQItem>
|
||||
{LATER_FAQ_ENTRIES.map((entry) => (
|
||||
<FAQItem key={entry} question={t(`hub.faq.${entry}Question`)}>
|
||||
{t(`hub.faq.${entry}Answer`)}
|
||||
</FAQItem>
|
||||
))}
|
||||
<FAQItem question={t("hub.faq.accessQuestion")}>
|
||||
<Trans i18nKey="hub.faq.accessAnswer" components={links} />
|
||||
</FAQItem>
|
||||
|
||||
@@ -3,7 +3,6 @@ import { Trans } from "react-i18next";
|
||||
import { LandingPage } from "~/components/landing-page";
|
||||
import { getTranslator, routeLocale } from "~/i18n";
|
||||
import { pageMeta } from "~/meta";
|
||||
import { getPluginCount } from "~/plugins";
|
||||
|
||||
export const Route = createFileRoute("/{-$locale}/")({
|
||||
head: ({ params }) => {
|
||||
@@ -16,7 +15,6 @@ export const Route = createFileRoute("/{-$locale}/")({
|
||||
locale,
|
||||
});
|
||||
},
|
||||
loader: async () => ({ pluginCount: await getPluginCount() }),
|
||||
component: Home,
|
||||
});
|
||||
|
||||
@@ -34,6 +32,5 @@ const SUBTITLE = (
|
||||
);
|
||||
|
||||
function Home() {
|
||||
const { pluginCount } = Route.useLoaderData();
|
||||
return <LandingPage title={TITLE} subtitle={SUBTITLE} pluginCount={pluginCount} showHubEyebrow />;
|
||||
return <LandingPage title={TITLE} subtitle={SUBTITLE} />;
|
||||
}
|
||||
|
||||
@@ -14,7 +14,6 @@ import {
|
||||
} from "lucide-react";
|
||||
import { useMemo } from "react";
|
||||
import { useTranslation } from "react-i18next";
|
||||
import { MOBILE_PAGE_BLEED_CLASS } from "~/components/page-frame";
|
||||
import { SiteShell } from "~/components/site-shell";
|
||||
import { getTranslator, localizePath, routeLocale, useLocalizePath } from "~/i18n";
|
||||
import { pageMeta } from "~/meta";
|
||||
@@ -67,7 +66,8 @@ const CATEGORY_ICONS: Record<CategorySlug, LucideIcon> = {
|
||||
};
|
||||
|
||||
// Card sections: a swipeable row on phones, a grid from `sm` up.
|
||||
const CARD_ROW_CLASS = `${MOBILE_PAGE_BLEED_CLASS} flex gap-4 overflow-x-auto pb-1 *:w-[70%] *:flex-shrink-0 sm:mx-0 sm:grid sm:grid-cols-2 sm:px-0 sm:*:w-auto lg:grid-cols-4`;
|
||||
const CARD_ROW_CLASS =
|
||||
"-mx-6 flex gap-4 overflow-x-auto px-6 pb-1 *:w-[70%] *:flex-shrink-0 sm:mx-0 sm:grid sm:grid-cols-2 sm:px-0 sm:*:w-auto lg:grid-cols-4";
|
||||
const SEE_ALL_CLASS =
|
||||
"inline-flex items-center gap-0.5 text-sm text-muted-foreground transition-colors hover:text-foreground";
|
||||
|
||||
|
||||
@@ -1,6 +1,5 @@
|
||||
@import "tailwindcss";
|
||||
@import "@fontsource-variable/geist";
|
||||
@import "@fontsource-variable/plus-jakarta-sans";
|
||||
|
||||
* {
|
||||
scrollbar-color: var(--color-scrollbar-handle) transparent;
|
||||
@@ -47,17 +46,22 @@
|
||||
}
|
||||
|
||||
.social-proof-marquee {
|
||||
margin-inline: calc(50% - 50cqw);
|
||||
overflow-x: clip;
|
||||
position: relative;
|
||||
}
|
||||
|
||||
.landing-content {
|
||||
container-type: inline-size;
|
||||
}
|
||||
|
||||
.social-proof-marquee::before,
|
||||
.social-proof-marquee::after {
|
||||
content: "";
|
||||
position: absolute;
|
||||
top: 0;
|
||||
bottom: 0;
|
||||
width: 4.5rem;
|
||||
width: max(4rem, 8vw);
|
||||
z-index: 1;
|
||||
pointer-events: none;
|
||||
}
|
||||
@@ -108,7 +112,7 @@
|
||||
|
||||
/* Title font - centralized for easy changes */
|
||||
.font-title {
|
||||
font-family: var(--font-display);
|
||||
font-family: inherit;
|
||||
}
|
||||
|
||||
/* Inline code styling - scoped to prose content */
|
||||
@@ -713,8 +717,6 @@
|
||||
|
||||
@theme {
|
||||
--font-sans: "Geist Variable", ui-sans-serif, system-ui, sans-serif;
|
||||
--font-display:
|
||||
"Plus Jakarta Sans Variable", "Geist Variable", ui-sans-serif, system-ui, sans-serif;
|
||||
|
||||
--color-background: #101615;
|
||||
--color-foreground: #fafafa;
|
||||
@@ -726,8 +728,6 @@
|
||||
--color-scrollbar-handle: #717574;
|
||||
--color-primary: #239956;
|
||||
--color-primary-foreground: #ffffff;
|
||||
--color-accent-text: #6cb17b;
|
||||
--color-brand-green: #20744a;
|
||||
--color-secondary: #252b2a;
|
||||
--color-secondary-foreground: #fafafa;
|
||||
|
||||
|
||||
@@ -350,10 +350,18 @@ index b849f78..24c06f3 100644
|
||||
factory: RendererFactory,
|
||||
) {
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/ListRenderer.kt b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/ListRenderer.kt
|
||||
index 2bac5b1..ff2d2c2 100644
|
||||
index 2bac5b1..021debd 100644
|
||||
--- a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/ListRenderer.kt
|
||||
+++ b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/ListRenderer.kt
|
||||
@@ -16,7 +16,7 @@ class ListRenderer(
|
||||
@@ -6,6 +6,7 @@ import com.swmansion.enriched.markdown.spans.ListItemSpacingSpan
|
||||
import com.swmansion.enriched.markdown.spans.MarginBottomSpan
|
||||
import com.swmansion.enriched.markdown.styles.ListStyle
|
||||
import com.swmansion.enriched.markdown.utils.text.span.SPAN_FLAGS_EXCLUSIVE_EXCLUSIVE
|
||||
+import com.swmansion.enriched.markdown.utils.text.span.SPAN_FLAGS_LINE_HEIGHT_PRIORITY
|
||||
import com.swmansion.enriched.markdown.utils.text.span.applyLineHeightSkippingImages
|
||||
import com.swmansion.enriched.markdown.utils.text.span.applyMarginTop
|
||||
|
||||
@@ -16,7 +17,7 @@ class ListRenderer(
|
||||
override fun render(
|
||||
node: MarkdownASTNode,
|
||||
builder: SpannableStringBuilder,
|
||||
@@ -362,6 +370,23 @@ index 2bac5b1..ff2d2c2 100644
|
||||
onLinkLongPress: ((String) -> Unit)?,
|
||||
factory: RendererFactory,
|
||||
) {
|
||||
@@ -68,7 +69,15 @@ class ListRenderer(
|
||||
// TODO: LineHeightSpan may also clip superscript/subscript glyphs that extend
|
||||
// outside the normal line bounds. A similar "skip" strategy as for images may
|
||||
// be needed here once super/subscript usage in practice is better understood.
|
||||
- applyLineHeightSkippingImages(builder, start, builder.length, style.lineHeight)
|
||||
+ // Priority flag so the list-wide line height iterates before inner block spacer
|
||||
+ // spans (blockquote padding/margin, heading margin) instead of inflating them.
|
||||
+ applyLineHeightSkippingImages(
|
||||
+ builder,
|
||||
+ start,
|
||||
+ builder.length,
|
||||
+ style.lineHeight,
|
||||
+ SPAN_FLAGS_LINE_HEIGHT_PRIORITY,
|
||||
+ )
|
||||
|
||||
// Item spacing and external bottom margin are only handled by the root-level list
|
||||
if (depth == 0) {
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/NodeRenderer.kt b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/NodeRenderer.kt
|
||||
index 354b31a..77b1e14 100644
|
||||
--- a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/renderer/NodeRenderer.kt
|
||||
@@ -3006,10 +3031,18 @@ index 0000000..11911c8
|
||||
+ }
|
||||
+}
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/MeasurementStore.kt b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/MeasurementStore.kt
|
||||
index f4840e4..e36b444 100644
|
||||
index f4840e4..6b7e61f 100644
|
||||
--- a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/MeasurementStore.kt
|
||||
+++ b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/MeasurementStore.kt
|
||||
@@ -66,9 +66,11 @@ object MeasurementStore {
|
||||
@@ -45,6 +45,7 @@ import com.swmansion.enriched.markdown.utils.common.parseLinkPillContent
|
||||
import com.swmansion.enriched.markdown.utils.common.parseLinkRecognition
|
||||
import com.swmansion.enriched.markdown.utils.text.extensions.replaceMathSpansWithPlaceholders
|
||||
import com.swmansion.enriched.markdown.utils.text.span.prepareWidthAwareSpans
|
||||
+import com.swmansion.enriched.markdown.utils.text.view.wrapForInsertionOrderedLayout
|
||||
import java.util.concurrent.ConcurrentHashMap
|
||||
import kotlin.math.ceil
|
||||
|
||||
@@ -66,9 +67,11 @@ object MeasurementStore {
|
||||
val spannable: CharSequence?,
|
||||
val paintParams: PaintParams,
|
||||
val markdownHash: Int,
|
||||
@@ -3021,7 +3054,7 @@ index f4840e4..e36b444 100644
|
||||
|
||||
// Store font scaling settings per view ID
|
||||
private data class FontScalingSettings(
|
||||
@@ -133,7 +135,10 @@ object MeasurementStore {
|
||||
@@ -133,7 +136,10 @@ object MeasurementStore {
|
||||
YogaMeasureOutput.getHeight(newSize) + PixelUtil.toDIPFromPixel(trailingMarginBottomPx),
|
||||
)
|
||||
}
|
||||
@@ -3033,7 +3066,7 @@ index f4840e4..e36b444 100644
|
||||
return oldSize != newSize
|
||||
}
|
||||
|
||||
@@ -144,7 +149,7 @@ object MeasurementStore {
|
||||
@@ -144,7 +150,7 @@ object MeasurementStore {
|
||||
}
|
||||
|
||||
fun invalidate(id: Int) {
|
||||
@@ -3042,7 +3075,7 @@ index f4840e4..e36b444 100644
|
||||
}
|
||||
|
||||
// Content-box width (px) the measure pass last wrapped at; the display view insets to match (#805).
|
||||
@@ -212,7 +217,7 @@ object MeasurementStore {
|
||||
@@ -212,7 +218,7 @@ object MeasurementStore {
|
||||
val previous = fontScalingSettings[viewId]
|
||||
fontScalingSettings[viewId] = FontScalingSettings(allowFontScaling, maxFontSizeMultiplier)
|
||||
if (previous != null && (previous.allowFontScaling != allowFontScaling || previous.maxFontSizeMultiplier != maxFontSizeMultiplier)) {
|
||||
@@ -3051,7 +3084,7 @@ index f4840e4..e36b444 100644
|
||||
}
|
||||
}
|
||||
|
||||
@@ -285,7 +290,43 @@ object MeasurementStore {
|
||||
@@ -285,7 +291,43 @@ object MeasurementStore {
|
||||
|
||||
val fontScale = checkAndUpdateFontScale(context, allowFontScaling, maxFontSizeMultiplier)
|
||||
|
||||
@@ -3096,7 +3129,7 @@ index f4840e4..e36b444 100644
|
||||
if (splitTableSegments) {
|
||||
return measureAndCacheSplit(context, id, width, props, allowFontScaling, fontScale, maxFontSizeMultiplier)
|
||||
}
|
||||
@@ -295,7 +336,7 @@ object MeasurementStore {
|
||||
@@ -295,7 +337,7 @@ object MeasurementStore {
|
||||
|
||||
val currentHash = computePropsHash(props, allowFontScaling, fontScale, maxFontSizeMultiplier)
|
||||
|
||||
@@ -3105,7 +3138,7 @@ index f4840e4..e36b444 100644
|
||||
return measureAndCache(context, safeId, width, props, allowFontScaling, fontScale, maxFontSizeMultiplier)
|
||||
}
|
||||
|
||||
@@ -332,8 +373,11 @@ object MeasurementStore {
|
||||
@@ -332,8 +374,11 @@ object MeasurementStore {
|
||||
val imageRequestHeaders = parseImageRequestHeaders(props.getArrayOrNull("imageRequestHeaders"))
|
||||
val linkPillContent = parseLinkPillContent(props.getArrayOrNull("linkPillContent"))
|
||||
var result = markdown.hashCode()
|
||||
@@ -3119,7 +3152,7 @@ index f4840e4..e36b444 100644
|
||||
result = 31 * result + parseLinkRecognition(props.getMapOrNull("linkRecognition")).hashCode()
|
||||
result = 31 * result + fontScale.toBits()
|
||||
result = 31 * result + allowFontScaling.hashCode()
|
||||
@@ -356,6 +400,7 @@ object MeasurementStore {
|
||||
@@ -356,6 +401,7 @@ object MeasurementStore {
|
||||
if (lastKnownFontScale != 1.0f) {
|
||||
lastKnownFontScale = 1.0f
|
||||
data.clear()
|
||||
@@ -3127,7 +3160,7 @@ index f4840e4..e36b444 100644
|
||||
}
|
||||
return 1.0f
|
||||
}
|
||||
@@ -368,6 +413,7 @@ object MeasurementStore {
|
||||
@@ -368,6 +414,7 @@ object MeasurementStore {
|
||||
if (currentFontScale != lastKnownFontScale) {
|
||||
lastKnownFontScale = currentFontScale
|
||||
data.clear()
|
||||
@@ -3135,6 +3168,52 @@ index f4840e4..e36b444 100644
|
||||
}
|
||||
return currentFontScale
|
||||
}
|
||||
@@ -635,7 +682,7 @@ object MeasurementStore {
|
||||
}
|
||||
}
|
||||
|
||||
- private fun createStaticLayout(
|
||||
+ internal fun createStaticLayout(
|
||||
text: CharSequence,
|
||||
fontSize: Float,
|
||||
widthPx: Int,
|
||||
@@ -643,8 +690,9 @@ object MeasurementStore {
|
||||
): StaticLayout {
|
||||
measurePaint.textSize = fontSize
|
||||
prepareWidthAwareSpans(text, widthPx)
|
||||
+ val measuredText = wrapForInsertionOrderedLayout(text)
|
||||
return StaticLayout.Builder
|
||||
- .obtain(text, 0, text.length, measurePaint, widthPx)
|
||||
+ .obtain(measuredText, 0, measuredText.length, measurePaint, widthPx)
|
||||
.setIncludePad(false)
|
||||
.setLineSpacing(0f, 1f)
|
||||
.apply {
|
||||
@@ -730,10 +778,11 @@ object MeasurementStore {
|
||||
val content = text ?: ""
|
||||
val safeWidth = ceil(maxWidth).toInt().coerceAtLeast(1)
|
||||
prepareWidthAwareSpans(content, safeWidth)
|
||||
+ val measuredText = wrapForInsertionOrderedLayout(content)
|
||||
|
||||
val builder =
|
||||
StaticLayout.Builder
|
||||
- .obtain(content, 0, content.length, paint, safeWidth)
|
||||
+ .obtain(measuredText, 0, measuredText.length, paint, safeWidth)
|
||||
.setIncludePad(false)
|
||||
.setLineSpacing(0f, 1f)
|
||||
|
||||
@@ -836,10 +885,11 @@ object MeasurementStore {
|
||||
val content = text ?: ""
|
||||
val widthPx = ceil(maxWidth).toInt().coerceAtLeast(1)
|
||||
prepareWidthAwareSpans(content, widthPx)
|
||||
+ val measuredText = wrapForInsertionOrderedLayout(content)
|
||||
|
||||
val layout =
|
||||
StaticLayout.Builder
|
||||
- .obtain(content, 0, content.length, paint, widthPx)
|
||||
+ .obtain(measuredText, 0, measuredText.length, paint, widthPx)
|
||||
.setIncludePad(false)
|
||||
.setLineSpacing(0f, 1f)
|
||||
.apply {
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/test/java/com/swmansion/enriched/markdown/MeasurementSizeCacheTest.kt b/node_modules/react-native-enriched-markdown/android/src/test/java/com/swmansion/enriched/markdown/MeasurementSizeCacheTest.kt
|
||||
new file mode 100644
|
||||
index 0000000..b3394c4
|
||||
@@ -3996,3 +4075,290 @@ diff --git a/node_modules/react-native-enriched-markdown/lib/module/web/utils.js
|
||||
+}
|
||||
//# sourceMappingURL=utils.js.map
|
||||
\ No newline at end of file
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/utils/text/view/TextViewSetup.kt b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/utils/text/view/TextViewSetup.kt
|
||||
index 4b2ad01..8742c0c 100644
|
||||
--- a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/utils/text/view/TextViewSetup.kt
|
||||
+++ b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/utils/text/view/TextViewSetup.kt
|
||||
@@ -11,6 +11,9 @@ import androidx.appcompat.widget.AppCompatTextView
|
||||
import androidx.core.view.ViewCompat
|
||||
import com.swmansion.enriched.markdown.accessibility.AccessibleMarkdownTextView
|
||||
|
||||
+internal fun wrapForInsertionOrderedLayout(source: CharSequence): CharSequence =
|
||||
+ if (source is SpannableStringBuilder) InsertionOrderedSpannable(source) else source
|
||||
+
|
||||
/**
|
||||
* Adopts the renderer's buffer instead of copying it: the default factory's copy is
|
||||
* quadratic in span count. Safe because each segment's buffer is owned by one view.
|
||||
diff --git a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/segments/SegmentHeightMeasurer.kt b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/segments/SegmentHeightMeasurer.kt
|
||||
index 162ebfb..6e40bd8 100644
|
||||
--- a/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/segments/SegmentHeightMeasurer.kt
|
||||
+++ b/node_modules/react-native-enriched-markdown/android/src/main/java/com/swmansion/enriched/markdown/segments/SegmentHeightMeasurer.kt
|
||||
@@ -9,6 +9,7 @@ import android.text.TextPaint
|
||||
import com.swmansion.enriched.markdown.styles.StyleConfig
|
||||
import com.swmansion.enriched.markdown.utils.text.extensions.replaceMathSpansWithPlaceholders
|
||||
import com.swmansion.enriched.markdown.utils.text.span.prepareWidthAwareSpans
|
||||
+import com.swmansion.enriched.markdown.utils.text.view.wrapForInsertionOrderedLayout
|
||||
import kotlin.math.ceil
|
||||
|
||||
/**
|
||||
@@ -105,8 +106,9 @@ object SegmentHeightMeasurer {
|
||||
textSize = fontSizePx
|
||||
}
|
||||
prepareWidthAwareSpans(text, widthPx)
|
||||
+ val measuredText = wrapForInsertionOrderedLayout(text)
|
||||
return StaticLayout.Builder
|
||||
- .obtain(text, 0, text.length, paint, widthPx)
|
||||
+ .obtain(measuredText, 0, measuredText.length, paint, widthPx)
|
||||
.setIncludePad(false)
|
||||
.setLineSpacing(0f, 1f)
|
||||
.apply {
|
||||
diff --git a/b/node_modules/react-native-enriched-markdown/android/src/test/java/com/swmansion/enriched/markdown/ListBlockquoteMeasurementTest.kt b/node_modules/react-native-enriched-markdown/android/src/test/java/com/swmansion/enriched/markdown/ListBlockquoteMeasurementTest.kt
|
||||
new file mode 100644
|
||||
index 0000000..6115a30
|
||||
--- /dev/null
|
||||
+++ b/node_modules/react-native-enriched-markdown/android/src/test/java/com/swmansion/enriched/markdown/ListBlockquoteMeasurementTest.kt
|
||||
@@ -0,0 +1,244 @@
|
||||
+package com.swmansion.enriched.markdown
|
||||
+
|
||||
+import android.graphics.Paint
|
||||
+import android.text.Layout
|
||||
+import android.text.SpannableStringBuilder
|
||||
+import android.text.style.LineHeightSpan as AndroidLineHeightSpan
|
||||
+import android.util.TypedValue
|
||||
+import android.view.View.MeasureSpec
|
||||
+import com.facebook.react.bridge.JavaOnlyArray
|
||||
+import com.facebook.react.bridge.JavaOnlyMap
|
||||
+import com.facebook.react.uimanager.DisplayMetricsHolder
|
||||
+import com.swmansion.enriched.markdown.parser.MarkdownASTNode
|
||||
+import com.swmansion.enriched.markdown.parser.MarkdownASTNode.NodeType
|
||||
+import com.swmansion.enriched.markdown.renderer.Renderer
|
||||
+import com.swmansion.enriched.markdown.segments.SegmentHeightMeasurer
|
||||
+import com.swmansion.enriched.markdown.spans.LineHeightSpan
|
||||
+import com.swmansion.enriched.markdown.styles.StyleConfig
|
||||
+import com.swmansion.enriched.markdown.utils.text.span.SPAN_FLAGS_EXCLUSIVE_EXCLUSIVE
|
||||
+import org.junit.Assert.assertEquals
|
||||
+import org.junit.Test
|
||||
+import org.junit.runner.RunWith
|
||||
+import org.robolectric.RobolectricTestRunner
|
||||
+import org.robolectric.RuntimeEnvironment
|
||||
+import org.robolectric.annotation.Config
|
||||
+import org.robolectric.annotation.GraphicsMode
|
||||
+
|
||||
+@RunWith(RobolectricTestRunner::class)
|
||||
+@GraphicsMode(GraphicsMode.Mode.NATIVE)
|
||||
+@Config(manifest = Config.NONE, sdk = [34])
|
||||
+class ListBlockquoteMeasurementTest {
|
||||
+ private fun styleConfig(): StyleConfig {
|
||||
+ val context = RuntimeEnvironment.getApplication()
|
||||
+ DisplayMetricsHolder.initDisplayMetricsIfNotInitialized(context)
|
||||
+ val base =
|
||||
+ JavaOnlyMap.of(
|
||||
+ "fontFamily", "",
|
||||
+ "fontWeight", "normal",
|
||||
+ "fontStyle", "normal",
|
||||
+ "fontSize", 16.0,
|
||||
+ "lineHeight", 22.0,
|
||||
+ "color", -16777216.0,
|
||||
+ "backgroundColor", 0.0,
|
||||
+ "borderColor", 0.0,
|
||||
+ "borderWidth", 3.0,
|
||||
+ "borderRadius", 0.0,
|
||||
+ "padding", 12.0,
|
||||
+ "gapWidth", 8.0,
|
||||
+ "marginTop", 0.0,
|
||||
+ "marginBottom", 12.0,
|
||||
+ "marginLeft", 20.0,
|
||||
+ "itemSpacing", 4.0,
|
||||
+ "bulletColor", -16777216.0,
|
||||
+ "bulletSize", 6.0,
|
||||
+ "markerMinWidth", 0.0,
|
||||
+ "markerColor", -16777216.0,
|
||||
+ "markerFontWeight", "normal",
|
||||
+ "textAlign", "left",
|
||||
+ "underline", false,
|
||||
+ "checkedColor", 0.0,
|
||||
+ "checkmarkColor", 0.0,
|
||||
+ "checkedTextColor", 0.0,
|
||||
+ "checkboxSize", 18.0,
|
||||
+ "checkboxBorderRadius", 2.0,
|
||||
+ "checkedStrikethrough", false,
|
||||
+ "particles", JavaOnlyMap.of("density", 1.0, "speed", 1.0),
|
||||
+ "solid", JavaOnlyMap.of("borderRadius", 0.0),
|
||||
+ "fontScale", 0.7,
|
||||
+ "baselineOffsetScale", 0.3,
|
||||
+ )
|
||||
+ val styles = JavaOnlyMap()
|
||||
+ listOf(
|
||||
+ "paragraph",
|
||||
+ "h1",
|
||||
+ "h2",
|
||||
+ "h3",
|
||||
+ "h4",
|
||||
+ "h5",
|
||||
+ "h6",
|
||||
+ "strong",
|
||||
+ "em",
|
||||
+ "strikethrough",
|
||||
+ "underline",
|
||||
+ "link",
|
||||
+ "code",
|
||||
+ "blockquote",
|
||||
+ "list",
|
||||
+ "codeBlock",
|
||||
+ "thematicBreak",
|
||||
+ "image",
|
||||
+ "inlineImage",
|
||||
+ "video",
|
||||
+ "table",
|
||||
+ "taskList",
|
||||
+ "math",
|
||||
+ "inlineMath",
|
||||
+ "spoiler",
|
||||
+ "superscript",
|
||||
+ "subscript",
|
||||
+ "highlight",
|
||||
+ ).forEach { styles.putMap(it, base) }
|
||||
+ styles.putArray("linkVariants", JavaOnlyArray())
|
||||
+ return StyleConfig(styles, context, allowFontScaling = false, maxFontSizeMultiplier = 1f)
|
||||
+ }
|
||||
+
|
||||
+ private fun measureTextView(
|
||||
+ text: CharSequence,
|
||||
+ fontSizePx: Float,
|
||||
+ widthPx: Int,
|
||||
+ ): EnrichedMarkdownInternalText {
|
||||
+ val context = RuntimeEnvironment.getApplication()
|
||||
+ return EnrichedMarkdownInternalText(context).apply {
|
||||
+ setTextSize(TypedValue.COMPLEX_UNIT_PX, fontSizePx)
|
||||
+ breakStrategy = Layout.BREAK_STRATEGY_HIGH_QUALITY
|
||||
+ applyStyledText(text)
|
||||
+ measure(
|
||||
+ MeasureSpec.makeMeasureSpec(widthPx, MeasureSpec.EXACTLY),
|
||||
+ MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED),
|
||||
+ )
|
||||
+ }
|
||||
+ }
|
||||
+
|
||||
+ @Test
|
||||
+ fun listNestedBlockquotesMatchMeasurementAndKeepSpacerHeights() {
|
||||
+ val context = RuntimeEnvironment.getApplication()
|
||||
+ val style = styleConfig()
|
||||
+ val widthPx = 640
|
||||
+ val fontSizePx = style.paragraphStyle.fontSize
|
||||
+
|
||||
+ val ast =
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.Document,
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.OrderedList,
|
||||
+ attributes = mapOf("start" to "1"),
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.ListItem,
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(NodeType.Paragraph, children = listOf(MarkdownASTNode(NodeType.Text, "First item"))),
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.Blockquote,
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(NodeType.Paragraph, children = listOf(MarkdownASTNode(NodeType.Text, "First quote"))),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.ListItem,
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(NodeType.Paragraph, children = listOf(MarkdownASTNode(NodeType.Text, "Second item"))),
|
||||
+ MarkdownASTNode(
|
||||
+ NodeType.Blockquote,
|
||||
+ children =
|
||||
+ listOf(
|
||||
+ MarkdownASTNode(NodeType.Paragraph, children = listOf(MarkdownASTNode(NodeType.Text, "Second quote"))),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ ),
|
||||
+ MarkdownASTNode(NodeType.Paragraph, children = listOf(MarkdownASTNode(NodeType.Text, "Trailing paragraph"))),
|
||||
+ ),
|
||||
+ )
|
||||
+
|
||||
+ val renderer = Renderer().apply { configure(style, context) }
|
||||
+ val rendered = renderer.renderDocument(ast)
|
||||
+
|
||||
+ val storeLayout = MeasurementStore.createStaticLayout(rendered, fontSizePx, widthPx, null)
|
||||
+ val segmentLayout =
|
||||
+ SegmentHeightMeasurer.createStaticLayout(rendered, fontSizePx, widthPx, Layout.BREAK_STRATEGY_HIGH_QUALITY)
|
||||
+ val textView = measureTextView(rendered, fontSizePx, widthPx)
|
||||
+
|
||||
+ assertEquals("MeasurementStore and TextView must agree on height", textView.measuredHeight, storeLayout.height)
|
||||
+ assertEquals("SegmentHeightMeasurer and TextView must agree on height", textView.measuredHeight, segmentLayout.height)
|
||||
+
|
||||
+ // Verify blockquote top-padding and bottom-margin spacer lines keep their configured
|
||||
+ // heights instead of being inflated to list.lineHeight (22dp).
|
||||
+ val paddingPx = style.blockquoteStyle.padding.toInt()
|
||||
+ val marginBottomPx = style.blockquoteStyle.marginBottom.toInt()
|
||||
+ val itemSpacingPx = style.listStyle.itemSpacing.toInt()
|
||||
+ val spacerLineHeights =
|
||||
+ (0 until storeLayout.lineCount)
|
||||
+ .filter { line ->
|
||||
+ val start = storeLayout.getLineStart(line)
|
||||
+ val end = storeLayout.getLineEnd(line)
|
||||
+ end - start == 1 && rendered[start] == '\n'
|
||||
+ }.map { line -> storeLayout.getLineBottom(line) - storeLayout.getLineTop(line) }
|
||||
+
|
||||
+ assertEquals(
|
||||
+ listOf(paddingPx, marginBottomPx + itemSpacingPx, paddingPx, marginBottomPx, marginBottomPx),
|
||||
+ spacerLineHeights,
|
||||
+ )
|
||||
+ }
|
||||
+
|
||||
+ @Test
|
||||
+ fun measurementStaticLayoutUsesInsertionOrderLikeTextView() {
|
||||
+ val context = RuntimeEnvironment.getApplication()
|
||||
+ DisplayMetricsHolder.initDisplayMetricsIfNotInitialized(context)
|
||||
+ val widthPx = 400
|
||||
+ val fontSizePx = 16f
|
||||
+
|
||||
+ // Inner priority-0 spacer inserted before outer priority-0 LineHeightSpan:
|
||||
+ // SpannableStringBuilder's unsorted fast path orders by start offset (outer first),
|
||||
+ // while InsertionOrderedSpannable orders by insertion order (inner first, so outer inflates it).
|
||||
+ val builder = SpannableStringBuilder("first\n\nsecond")
|
||||
+ builder.setSpan(
|
||||
+ object : AndroidLineHeightSpan {
|
||||
+ override fun chooseHeight(
|
||||
+ text: CharSequence,
|
||||
+ start: Int,
|
||||
+ end: Int,
|
||||
+ spanstartv: Int,
|
||||
+ v: Int,
|
||||
+ fm: Paint.FontMetricsInt,
|
||||
+ ) {
|
||||
+ fm.top = 0
|
||||
+ fm.ascent = 0
|
||||
+ fm.descent = 12
|
||||
+ fm.bottom = 12
|
||||
+ }
|
||||
+ },
|
||||
+ 6,
|
||||
+ 7,
|
||||
+ SPAN_FLAGS_EXCLUSIVE_EXCLUSIVE,
|
||||
+ )
|
||||
+ builder.setSpan(LineHeightSpan(40f), 0, builder.length, SPAN_FLAGS_EXCLUSIVE_EXCLUSIVE)
|
||||
+
|
||||
+ val storeLayout = MeasurementStore.createStaticLayout(builder, fontSizePx, widthPx, null)
|
||||
+ val segmentLayout =
|
||||
+ SegmentHeightMeasurer.createStaticLayout(builder, fontSizePx, widthPx, Layout.BREAK_STRATEGY_HIGH_QUALITY)
|
||||
+ val textView = measureTextView(builder, fontSizePx, widthPx)
|
||||
+
|
||||
+ assertEquals(textView.measuredHeight, storeLayout.height)
|
||||
+ assertEquals(textView.measuredHeight, segmentLayout.height)
|
||||
+ }
|
||||
+}
|
||||
|
||||
@@ -56,6 +56,17 @@ function shortWindow(window: string): string {
|
||||
return trimmed;
|
||||
}
|
||||
|
||||
function windowDurationSeconds(window: string): number | undefined {
|
||||
switch (window.trim().toLowerCase()) {
|
||||
case "5h":
|
||||
return 5 * 3600;
|
||||
case "weekly":
|
||||
return 7 * 86400;
|
||||
default:
|
||||
return undefined;
|
||||
}
|
||||
}
|
||||
|
||||
function shortGroupName(name: string): string {
|
||||
return name
|
||||
.trim()
|
||||
@@ -129,6 +140,7 @@ export class Usage {
|
||||
shortLabel: formatShortLabel(group.name, bucket.window, includeGroup),
|
||||
summary: !bucket.disabled && bucket.window === "weekly",
|
||||
utilizationPct: used,
|
||||
durationSeconds: windowDurationSeconds(bucket.window),
|
||||
resetsAt: bucket.disabled ? null : bucket.reset_time,
|
||||
tone: used === null ? "default" : toneFromUsedPct(used),
|
||||
}),
|
||||
|
||||
@@ -263,6 +263,7 @@ function unscopedWindows(resp: ClaudeUsageResponse): UsageWindow[] {
|
||||
shortLabel: spec.shortLabel,
|
||||
summary: spec.summary,
|
||||
utilizationPct: window.utilization,
|
||||
durationSeconds: spec.field === "five_hour" ? 5 * 3600 : 7 * 86400,
|
||||
resetsAt: window.resets_at ?? null,
|
||||
tone: toneFromUsedPct(window.utilization),
|
||||
}),
|
||||
@@ -283,6 +284,7 @@ function scopedWindows(limits: ScopedLimit[]): UsageWindow[] {
|
||||
label: `Weekly \u00b7 ${limit.name}`,
|
||||
shortLabel: `wk ${limit.name}`,
|
||||
utilizationPct: limit.usedPct,
|
||||
durationSeconds: 7 * 86400,
|
||||
resetsAt: limit.resetsAt,
|
||||
tone: toneFromUsedPct(limit.usedPct),
|
||||
});
|
||||
|
||||
@@ -86,8 +86,10 @@ export class Usage {
|
||||
try {
|
||||
const { usage } = await this.read(account, launch);
|
||||
if (!usage) return unavailable({ kind: "no_quota", detail: "No usage quota reported" });
|
||||
const observedAt = new Date(usage.observedAtMs).toISOString();
|
||||
return {
|
||||
status: "available",
|
||||
observedAt,
|
||||
planLabel: usage.tier,
|
||||
windows: [
|
||||
windowFromReportedDuration({
|
||||
@@ -112,7 +114,7 @@ export class Usage {
|
||||
{
|
||||
id: "observed",
|
||||
label: "Observed",
|
||||
value: new Date(usage.observedAtMs).toISOString(),
|
||||
value: observedAt,
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
@@ -1505,6 +1505,7 @@ for (const usage of [
|
||||
expect(report).toMatchObject({
|
||||
status: "available",
|
||||
planLabel: "Pro",
|
||||
observedAt: new Date(usage.usage.observedAtMs).toISOString(),
|
||||
windows: [
|
||||
{
|
||||
id: "five_hour",
|
||||
@@ -1800,7 +1801,10 @@ test("Muse reports belong only to the session's account and remain available glo
|
||||
for (const [index, agentId] of ["muse-home", "muse-work"].entries()) {
|
||||
const reports = await registry.listReports({ agentId });
|
||||
expect(reports.map((report) => report.id)).toEqual([accountIds[index]]);
|
||||
expect(reports[0]!.report.status).toBe("available");
|
||||
expect(reports[0]!.report).toMatchObject({
|
||||
status: "available",
|
||||
observedAt: "2023-11-14T22:13:20.000Z",
|
||||
});
|
||||
}
|
||||
expect(await registry.listReports({ agentId: "muse-unknown" })).toEqual([]);
|
||||
expect((await registry.listReports()).map((report) => report.id)).toEqual(accountIds);
|
||||
|
||||
+8
-16
@@ -447,29 +447,21 @@ paseo hub deploy -p <project> # Deploy an existing legacy project bundle
|
||||
paseo hub logout # Remove the active stored CLI login
|
||||
```
|
||||
|
||||
Run `paseo hub deploy` from the repository root. By default, it reads every direct `.paseo/triggers/*.yml` file in deterministic path order and validates all triggers before installing them one at a time.
|
||||
Run deploy from the repository root. By default it reads every direct `.paseo/triggers/*.yml` file in deterministic path order. It validates all triggers before installing them one at a time. If an installation fails after earlier ones succeeded, the error lists the installed files. `--dry-run` only validates; it does not create or activate revisions.
|
||||
|
||||
If an installation fails after earlier ones succeeded, the error lists the installed files. `--dry-run` validates without creating or activating revisions. Pass `-p, --project <slug>` for an existing legacy project bundle, as described in [Deploy from the CLI](/docs/hub/configuration#deploy-from-the-cli).
|
||||
Pass `-p, --project <slug>` for an existing legacy bundle: `.paseo/hub.yml`, direct `.paseo/workflows/*.yml` files, and referenced workflow partials. See [Deploy from the CLI](/docs/hub/configuration#deploy-from-the-cli).
|
||||
|
||||
`paseo hub login` opens the Hub approval page and stores an organization-scoped CLI credential under `PASEO_HOME`. In an interactive terminal, it offers to connect this daemon (default yes) and separately asks whether to grant `hub.execute` (default no).
|
||||
`login` opens the Hub approval page and stores a durable organization-scoped CLI credential under `PASEO_HOME`. In an interactive terminal it offers to connect this daemon, then separately asks whether to allow Hub automations to run agents. Connection defaults to yes; execution permission defaults to no. It then links to Hub's **Triggers** page and prints `paseo hub init` for setup as code. `--json` and non-TTY login remain login-only and never prompt. The stored login is separate from the daemon relationship created by `connect`.
|
||||
|
||||
`--json` and non-TTY logins never prompt. The stored CLI login stays separate from the daemon relationship created by `connect`.
|
||||
`init` requires a TTY. It signs in and connects the daemon as needed, then lists the organization's app connections that can back a starter trigger. One usable connection is selected automatically; with several, you choose a **Trigger connection**. If none is ready, setup sends you to **Hub → Apps** and stops before selecting an agent or writing files.
|
||||
|
||||
`paseo hub init` requires a TTY, signs in and connects the daemon as needed, and selects a ready integration (or sends you to **Hub → Apps** if none is ready). It then prompts for an enabled provider on your daemon that exposes both a selectable model and at least one execution mode.
|
||||
Setup asks which agent provider, model, and mode to run. Providers must be enabled and expose both a selectable model and an execution mode. Suggested model and mode entries are the daemon's defaults; a mode is still selected explicitly when there is no default. Hub validates the choice against the daemon before deploying, and accepts only Claude, Codex, and OpenCode for its unattended runs. `deploy` applies the same checks, so it needs the named daemon connected. Setup then asks for the identity allowed to trigger the bot: a GitHub username, Slack member ID, or Discord user ID. It validates the trigger, writes `.paseo/triggers/<provider>-help.yml`, and asks whether to deploy. Replacing that file requires confirmation; existing legacy bundles and other trigger files are preserved. See the [generated starter trigger](/docs/hub/configuration#generated-starter-trigger).
|
||||
|
||||
Providers that report zero execution modes (such as Pi) are filtered out by `paseo hub init`, but can still be configured in the Hub dashboard or in `.paseo/triggers/*.yml` and deployed with `paseo hub deploy`.
|
||||
Interactive logout checks the same-origin daemon relationship and asks whether to disconnect before deleting the login. Declining removes only the login. JSON and noninteractive logout never prompt or disconnect implicitly; `--disconnect-daemon` is the explicit automation path, and `--force` applies to that daemon disconnection. If a requested disconnection fails, the login is preserved.
|
||||
|
||||
Setup next asks for the allowed sender identity (GitHub username, Slack member ID, or Discord user ID), validates the trigger against the connected daemon, writes `.paseo/triggers/<provider>-help.yml`, and asks whether to deploy. Replacing an existing starter file requires confirmation while preserving other trigger files. See the [generated starter trigger](/docs/hub/configuration#generated-starter-trigger).
|
||||
Every command resolves and normalizes its destination before Hub or daemon work. Origin precedence is an explicit command origin or `--hub`, then `PASEO_HUB_URL`, then the active stored login origin, then the hosted default `https://hub.paseo.sh`. The hosted default never overrides an active login. Credential precedence is `--api-key <secret>`, then `PASEO_HUB_API_KEY`, then a stored login for the exact resolved origin. A stored credential is never sent to a different origin. API keys passed through flags or the environment are not stored.
|
||||
|
||||
Interactive `paseo hub logout` checks for a daemon connected to the same Hub and asks whether to disconnect it before deleting the login. JSON and non-interactive logouts never prompt or disconnect unless you pass `--disconnect-daemon` (with optional `--force`). If disconnection fails, the login stays intact.
|
||||
|
||||
Every Hub command resolves its destination and credentials in order:
|
||||
|
||||
- Origin precedence: explicit `[url]` or `--hub`, then `PASEO_HUB_URL`, then the active stored login, then `https://hub.paseo.sh`.
|
||||
- Credential precedence: `--api-key <secret>`, then `PASEO_HUB_API_KEY`, then a stored login matching the exact resolved origin.
|
||||
- API keys passed via flags or environment variables are never written to disk, and stored credentials are never sent to another origin.
|
||||
|
||||
Human output prints the resolved destination before each action, while `--json` writes machine-readable output including the normalized Hub origin. Diagnostics name file paths without printing contents or credentials.
|
||||
Human output reports the resolved destination before each action. JSON output keeps stdout machine-readable and includes the normalized Hub origin. Bundle diagnostics identify paths without printing configuration contents or credentials.
|
||||
|
||||
See [Daemons in Hub](/docs/hub/daemons), [Hub configuration](/docs/hub/configuration), and the [Hub public API](/docs/hub/api).
|
||||
|
||||
|
||||
@@ -426,29 +426,21 @@ paseo hub deploy -p <project> # Deploy an existing legacy project bundle
|
||||
paseo hub logout # Remove the active stored CLI login
|
||||
```
|
||||
|
||||
请在仓库根目录运行 `paseo hub deploy`。它默认按确定的路径顺序读取所有直接位于 `.paseo/triggers/*.yml` 下的文件,并在逐个安装前先校验全部触发器。
|
||||
请在仓库根目录运行 deploy。它默认按确定的路径顺序读取所有直接位于 `.paseo/triggers/` 下的 `*.yml` 文件。它会先校验所有触发器,再逐个安装。如果在前面的安装成功之后某个安装失败,错误信息会列出已安装的文件。`--dry-run` 只做校验;它不会创建或激活修订。
|
||||
|
||||
如果在前面的安装成功之后某个安装失败,错误信息会列出已安装的文件。`--dry-run` 只做校验,不会创建或激活版本。对于已有的旧版项目文件包,请传入 `-p, --project <slug>`,参见[从 CLI 部署](/docs/hub/configuration#deploy-from-the-cli)。
|
||||
对于已有的旧版文件包,传入 `-p, --project <slug>`:包括 `.paseo/hub.yml`、直接位于 `.paseo/workflows/` 下的 `*.yml` 文件,以及被引用的 workflow 片段。见[从 CLI 部署](/docs/hub/configuration#deploy-from-the-cli)。
|
||||
|
||||
`paseo hub login` 会打开 Hub 批准页面,并在 `PASEO_HOME` 下保存组织级 CLI 凭据。在交互式终端中,它会询问是否连接此 daemon(默认为是),并单独询问是否授予 `hub.execute`(默认为否)。
|
||||
`login` 会打开 Hub 的批准页面,并在 `PASEO_HOME` 下保存一个持久的、组织范围的 CLI 凭据。在交互式终端中,它会提议连接这个 daemon,然后单独询问是否允许 Hub 自动化在这里运行 Agent。连接默认为是;执行权限默认为否。随后它会链接到 Hub 的 **Triggers** 页面,并输出 `paseo hub init`,以便用代码完成设置。`--json` 和非 TTY 的登录只执行登录,从不提示。保存的登录与 `connect` 创建的 daemon 关系是分开的。
|
||||
|
||||
`--json` 和非 TTY 登录不会提示。保存的 CLI 登录与 `connect` 创建的 daemon 关系相互独立。
|
||||
`init` 需要 TTY。它会根据需要登录并连接 daemon,然后列出组织中可以支撑入门触发器的应用连接。只有一个可用连接时会自动选中;有多个时,由你选择一个 **Trigger connection**。如果没有任何连接就绪,设置会引导你前往 **Hub → Apps**,并在选择 Agent 或写入文件之前停止。
|
||||
|
||||
`paseo hub init` 需要 TTY,按需登录并连接 daemon,并选择就绪的集成(若无可用集成则引导至 **Hub → Apps**)。随后它会提示你选择 daemon 上已启用、且同时提供可选模型和至少一个执行模式的 Provider。
|
||||
设置会询问要运行哪个 Agent Provider、模型和模式。Provider 必须已启用,并且同时提供可选择的模型和执行模式。建议的模型和模式条目是 daemon 的默认值;没有默认值时仍需显式选择模式。Hub 在部署前会对照 daemon 校验这项选择,并且其无人值守的运行只接受 Claude、Codex 和 OpenCode。`deploy` 会执行相同的检查,因此需要指定的 daemon 已连接。随后设置会询问允许触发机器人的身份:GitHub 用户名、Slack 成员 ID 或 Discord 用户 ID。它会校验触发器,写入 `.paseo/triggers/<provider>-help.yml`,并询问是否部署。替换该文件需要确认;已有的旧版文件包和其他触发器文件会被保留。见[生成的入门触发器](/docs/hub/configuration#generated-starter-trigger)。
|
||||
|
||||
不提供执行模式的 Provider(例如 Pi)会被 `paseo hub init` 过滤掉,但仍可在 Hub 控制台或 `.paseo/triggers/*.yml` 中配置并通过 `paseo hub deploy` 部署。
|
||||
交互式退出会检查同一地址的 daemon 关系,并在删除登录之前询问是否断开。选择否时只删除登录。JSON 和非交互式的退出从不提示,也不会隐式断开;`--disconnect-daemon` 是供自动化使用的显式方式,`--force` 作用于该 daemon 断开操作。如果请求的断开失败,登录会被保留。
|
||||
|
||||
接着设置会询问允许的发送者身份(GitHub 用户名、Slack 成员 ID 或 Discord 用户 ID),对照已连接的 daemon 校验触发器,写入 `.paseo/triggers/<provider>-help.yml` 并询问是否部署。替换已有入门文件需要确认,同时保留其他触发器文件。见[生成的入门触发器](/docs/hub/configuration#generated-starter-trigger)。
|
||||
每个命令在执行 Hub 或 daemon 工作之前,都会解析并规范化它的目标。地址的优先级依次为:显式的命令地址或 `--hub`、`PASEO_HUB_URL`、当前保存的登录地址,最后是托管版默认地址 `https://hub.paseo.sh`。托管版默认地址从不会覆盖当前的登录。凭据的优先级依次为:`--api-key <secret>`、`PASEO_HUB_API_KEY`,然后是与解析出的地址完全匹配的已保存登录。保存的凭据从不会发送到其他地址。通过参数或环境变量传入的 API 密钥不会被保存。
|
||||
|
||||
交互式 `paseo hub logout` 会检查连接到同一 Hub 的 daemon,并在删除登录前询问是否断开。JSON 和非交互式退出不会提示或断开,除非传入 `--disconnect-daemon`(可配合 `--force`)。如果断开失败,登录凭据会保留。
|
||||
|
||||
每个 Hub 命令都按顺序解析目标和凭据:
|
||||
|
||||
- 地址优先级:显式 `[url]` 或 `--hub`、`PASEO_HUB_URL`、当前已保存的登录,最后是 `https://hub.paseo.sh`。
|
||||
- 凭据优先级:`--api-key <secret>`、`PASEO_HUB_API_KEY`,然后是与精确解析地址匹配的已保存登录。
|
||||
- 通过参数或环境变量传入的 API 密钥永远不会写入磁盘,已保存的凭据也不会发送到其他地址。
|
||||
|
||||
人类可读输出会在每个操作前打印解析出的目标,而 `--json` 会输出包含规范化 Hub 地址的机器可读结果。诊断信息仅指出文件路径,不输出文件内容或凭据。
|
||||
人类可读的输出会在每个操作之前报告解析出的目标。JSON 输出让 stdout 保持机器可读,并包含规范化后的 Hub 地址。文件包诊断会指出路径,但不会输出配置内容或凭据。
|
||||
|
||||
见 [Hub 中的 daemon](/docs/hub/daemons)、[Hub 配置](/docs/hub/configuration)和 [Hub 公开 API](/docs/hub/api)。
|
||||
|
||||
|
||||
+32
-22
@@ -1,43 +1,53 @@
|
||||
---
|
||||
title: Hub activity
|
||||
description: Inspect trigger runs, distinguish filtered events from unrouted ones, and debug a trigger that did not run.
|
||||
description: Read what Hub did with an event, tell a filtered event from an unrouted one, and debug a trigger that did nothing.
|
||||
nav: Activity
|
||||
order: 75
|
||||
order: 72
|
||||
category: Hub
|
||||
---
|
||||
|
||||
# Hub activity
|
||||
|
||||
Hub records every accepted event, whether or not it started a run. Use **Activity** and **Integrations** to inspect deliveries and debug triggers.
|
||||
Every event Hub accepts is recorded, whether or not it ran anything. That record is how you debug a trigger.
|
||||
|
||||
## Where to look
|
||||
|
||||
**Activity** lists organization trigger runs, including the triggering source, daemon, execution status, replies, and errors.
|
||||
**Project → Activity** lists routed trigger runs and their execution state.
|
||||
|
||||
**Integrations → Known unrouted events** lists accepted provider events that did not start a trigger. Hub records one of four reasons:
|
||||
**Connections → Known unrouted events** is the organization-level view of accepted provider events that did not start a configured trigger. Hub records one of four bounded reasons:
|
||||
|
||||
| Reason | Meaning |
|
||||
| --------------------------- | ------------------------------------------------------------ |
|
||||
| `no_project_route` | No enabled route matched the event's integration or resource |
|
||||
| `no_trigger_for_source` | No enabled trigger handles that event source |
|
||||
| `trigger_filters_rejected` | A trigger matched the source, but its filters rejected it |
|
||||
| `configuration_unavailable` | A referenced trigger or integration could not be resolved |
|
||||
| `no_project_route` | No project route is configured for the event |
|
||||
| `no_trigger_for_source` | No configured trigger handles that event source |
|
||||
| `trigger_filters_rejected` | A trigger handles the source, but its filters rejected it |
|
||||
| `configuration_unavailable` | A relevant configuration or connection could not be resolved |
|
||||
|
||||
## Nothing happened when an event arrived
|
||||
## Nothing happened when I mentioned the bot
|
||||
|
||||
Check these items in order:
|
||||
Work down this list.
|
||||
|
||||
1. Open **Activity**. If the event is missing there, check **Integrations → Known unrouted events** and read the recorded reason.
|
||||
2. If the event does not appear in either view, the provider never reached Hub. Check the provider delivery log (GitHub **App → Advanced → Recent Deliveries**, Linear webhook logs, or Slack **Event Subscriptions**) and make sure that the app subscribes to that event type.
|
||||
3. Verify `from_users`. GitHub uses login names, while Linear, Slack, and Discord use user IDs ([Linear](/docs/hub/triggers/linear#filters-and-linear-uuids), [Slack](/docs/hub/triggers/slack#find-your-slack-ids), [Discord](/docs/hub/triggers/discord#find-your-discord-ids)).
|
||||
4. Verify text filters (`contains`, `pattern`, and GitHub `exclude_contains`). On Slack and Discord, the message must mention the bot and any `pattern` must follow the mention.
|
||||
5. Verify that the trigger is enabled under **Triggers**.
|
||||
6. Verify that the target daemon is connected under **Daemons** and holds the `hub.execute` permission.
|
||||
7. If the run started and stopped early, compare its duration against `max_runtime`, `idle_timeout`, and `startup_timeout`.
|
||||
8. If the run finished without posting back, check `run.prompt`. The prompt must tell the agent to call `reply` (or `slack_post` / `discord_post`) and `finish_execution`.
|
||||
1. **Is the event in the project's Activity?** If not, check **Connections → Known unrouted events** and use its reason to distinguish routing, source, filter, and configuration failures.
|
||||
2. **Is the event anywhere at all?** If not, the event never reached Hub. Check the provider's own delivery log: GitHub's App → Advanced → Recent Deliveries, or Slack's Event Subscriptions page. Then check that the app is subscribed to that event type.
|
||||
3. **Is your user in `from_users`?** This is the most common cause. GitHub uses your login; Slack and Discord use the user ID, not the display name. See [find your Slack IDs](/docs/hub/triggers/slack#find-your-slack-ids) and [find your Discord IDs](/docs/hub/triggers/discord#find-your-discord-ids).
|
||||
4. **Did the invocation match?** On GitHub, `contains` must appear in the comment body. On Slack and Discord the bot must be mentioned, and `pattern` or its legacy `contains` alias must prefix the text after the mention.
|
||||
5. **Is the configuration you think is active actually active?** The Configuration tab shows the active revision and the last sync attempt. A failed push leaves the old revision serving.
|
||||
6. **Is the daemon connected?** An offline daemon fails dispatch with `daemon_not_connected`.
|
||||
7. **Did it run and stop early?** Compare the execution with the step's authored `idle_timeout` and `max_runtime`, and the workflow's `max_runtime`. All three limits are explicit in the workflow.
|
||||
8. **Did it run, but deliver nothing?** Check the step's prompt. An agent that is not told to call `hub.reply` and `hub.finish_execution` can answer in its own transcript and never report back. See [Tell the agent which tool to call](/docs/hub/workflows#tell-the-agent-which-tool-to-call).
|
||||
|
||||
## Webhook and schedule runs
|
||||
## Sync failures
|
||||
|
||||
Inbound webhook deliveries appear in **Activity** under `webhook.received`. If an HTTP `POST` returns an error status (`400`, `401`, `403`, `409`, `413`, or `429`), see [Inbound webhooks](/docs/hub/triggers/webhooks#request-limits-and-responses).
|
||||
The Configuration tab shows the latest sync state:
|
||||
|
||||
Scheduled runs appear in **Activity** under `schedule.tick`. While a scheduled run is still active, Hub skips newly due occurrences for that trigger until the active run completes or fails.
|
||||
| State | What to do |
|
||||
| ----------------------- | ------------------------------------------------------------------------ |
|
||||
| Fetch failed | The file is missing at that commit, or the App can't read the repository |
|
||||
| Invalid | Validation failed, or the config names something unreachable |
|
||||
| Superseded push ignored | A newer commit already moved the branch head; nothing is wrong |
|
||||
|
||||
"Names something unreachable" is usually a repository the installation doesn't cover, a daemon that was renamed, or a connection slug that no longer exists. See [How Hub works](/docs/hub/concepts).
|
||||
|
||||
## Nothing is retried
|
||||
|
||||
Hub does not queue events. A dispatch that fails because the daemon was offline stays failed, so trigger it again once the daemon is back.
|
||||
|
||||
@@ -1,41 +1,51 @@
|
||||
---
|
||||
title: Hub 活动
|
||||
description: 查看触发器运行记录、区分被过滤事件与未路由事件,以及排查未触发的问题。
|
||||
description: 查看 Hub 如何处理一个事件,区分被过滤和未路由的事件,并排查没有任何反应的触发器。
|
||||
nav: 活动
|
||||
---
|
||||
|
||||
# Hub 活动 {#hub-activity}
|
||||
|
||||
Hub 会记录每一次已接受的事件,无论它是否启动了运行。使用 **Activity** 和 **Integrations** 查看投递并排查触发器。
|
||||
Hub 接受的每个事件都会被记录,无论它是否运行了任何内容。这份记录就是你排查触发器的依据。
|
||||
|
||||
## 在哪里查看 {#where-to-look}
|
||||
|
||||
**Activity** 列出组织的触发器运行记录,包括触发来源、daemon、执行状态、回复和错误。
|
||||
**Project → Activity** 列出已路由的触发器运行及其执行状态。
|
||||
|
||||
**Integrations → Known unrouted events** 列出已接受但未启动触发器的 Provider 事件。Hub 记录以下四种原因之一:
|
||||
**Connections → Known unrouted events** 是组织级视图,列出已接受但没有启动任何已配置触发器的 Provider 事件。Hub 会记录以下四种原因之一:
|
||||
|
||||
| 原因 | 含义 |
|
||||
| --------------------------- | -------------------------------------- |
|
||||
| `no_project_route` | 没有已启用的路由匹配该事件的集成或资源 |
|
||||
| `no_trigger_for_source` | 没有已启用的触发器处理该事件来源 |
|
||||
| `trigger_filters_rejected` | 有触发器处理该来源,但被过滤条件拒绝 |
|
||||
| `configuration_unavailable` | 无法解析引用的触发器或集成 |
|
||||
| 原因 | 含义 |
|
||||
| --------------------------- | -------------------------------------------- |
|
||||
| `no_project_route` | 没有为该事件配置项目路由 |
|
||||
| `no_trigger_for_source` | 没有已配置的触发器处理该事件来源 |
|
||||
| `trigger_filters_rejected` | 有触发器处理该来源,但它的过滤器拒绝了该事件 |
|
||||
| `configuration_unavailable` | 无法解析相关的配置或连接 |
|
||||
|
||||
## 事件到达后没有任何反应 {#nothing-happened-when-an-event-arrived}
|
||||
## 我提及了机器人,但什么都没发生 {#nothing-happened-when-i-mentioned-the-bot}
|
||||
|
||||
按以下顺序排查:
|
||||
按这个列表逐项排查。
|
||||
|
||||
1. 打开 **Activity**。如果事件未出现在那里,请检查 **Integrations → Known unrouted events** 并查看记录的原因。
|
||||
2. 如果两处都没有,说明事件从未到达 Hub。检查 Provider 自己的投递日志(GitHub **App → Advanced → Recent Deliveries**、Linear webhook 日志或 Slack **Event Subscriptions**),并确认应用已订阅对应事件类型。
|
||||
3. 检查 `from_users`。GitHub 使用登录名,Linear、Slack 和 Discord 使用用户 ID(参见 [Linear](/docs/hub/triggers/linear#filters-and-linear-uuids)、[Slack](/docs/hub/triggers/slack#find-your-slack-ids)、[Discord](/docs/hub/triggers/discord#find-your-discord-ids))。
|
||||
4. 检查文本过滤条件(`contains`、`pattern` 以及 GitHub 的 `exclude_contains`)。在 Slack 和 Discord 上,消息必须提及机器人,且任何 `pattern` 都必须紧跟在提及之后。
|
||||
5. 在 **Triggers** 下确认触发器已启用。
|
||||
6. 在 **Daemons** 下确认目标 daemon 已连接并拥有 `hub.execute` 权限。
|
||||
7. 如果运行已启动但提前停止,请将其持续时间与 `max_runtime`、`idle_timeout` 和 `startup_timeout` 进行对比。
|
||||
8. 如果运行已完成但没有回复,请检查 `run.prompt`。提示词必须明确告诉 Agent 调用 `reply`(或 `slack_post` / `discord_post`)和 `finish_execution`。
|
||||
1. **事件是否出现在项目的 Activity 中?** 如果没有,请查看 **Connections → Known unrouted events**,根据其中的原因区分路由、来源、过滤器和配置方面的失败。
|
||||
2. **事件是否出现在任何地方?** 如果没有,说明事件从未到达 Hub。请查看 Provider 自己的投递日志:GitHub 的 App → Advanced → Recent Deliveries,或 Slack 的 Event Subscriptions 页面。然后确认应用订阅了该事件类型。
|
||||
3. **你的用户是否在 `from_users` 中?** 这是最常见的原因。GitHub 使用你的登录名;Slack 和 Discord 使用用户 ID,而不是显示名称。参见[查找 Slack ID](/docs/hub/triggers/slack#find-your-slack-ids) 和[查找 Discord ID](/docs/hub/triggers/discord#find-your-discord-ids)。
|
||||
4. **调用是否匹配?** 在 GitHub 上,评论正文中必须出现 `contains`。在 Slack 和 Discord 上,必须提及机器人,并且提及之后的文本必须以 `pattern`(或其旧别名 `contains`)开头。
|
||||
5. **你以为生效的配置是否真的生效?** Configuration 标签页显示当前生效的版本和上一次同步尝试。推送失败时,旧版本会继续生效。
|
||||
6. **daemon 是否已连接?** daemon 离线时派发会失败,并报告 `daemon_not_connected`。
|
||||
7. **是否运行了但提前停止?** 把这次执行与 step 中编写的 `idle_timeout`、`max_runtime` 以及 workflow 的 `max_runtime` 进行比较。这三个限制都在 workflow 中显式声明。
|
||||
8. **是否运行了但什么都没投递?** 检查 step 的提示词。没有被告知调用 `hub.reply` 和 `hub.finish_execution` 的 Agent,可能只在自己的对话记录中回答,而从不回报。参见[告诉 Agent 调用哪个工具](/docs/hub/workflows#tell-the-agent-which-tool-to-call)。
|
||||
|
||||
## Webhook 与定时运行 {#webhook-and-schedule-runs}
|
||||
## 同步失败 {#sync-failures}
|
||||
|
||||
入站 webhook 投递会以 `webhook.received` 出现在 **Activity** 中。如果 HTTP `POST` 返回错误状态码(`400`、`401`、`403`、`409`、`413` 或 `429`),参见[入站 webhook](/docs/hub/triggers/webhooks#request-limits-and-responses)。
|
||||
Configuration 标签页显示最近的同步状态:
|
||||
|
||||
定时运行会以 `schedule.tick` 出现在 **Activity** 中。当某次定时运行仍在进行时,Hub 会跳过该触发器新到期的计划,直到当前运行完成或失败。
|
||||
| 状态 | 处理方式 |
|
||||
| ----------------------- | ---------------------------------------- |
|
||||
| Fetch failed | 该提交中缺少文件,或者 App 无法读取仓库 |
|
||||
| Invalid | 校验失败,或者配置引用了无法访问的内容 |
|
||||
| Superseded push ignored | 更新的提交已经移动了分支头;没有任何问题 |
|
||||
|
||||
“引用了无法访问的内容”通常是指安装未覆盖的仓库、已被重命名的 daemon,或已不存在的连接 slug。参见 [Hub 工作原理](/docs/hub/concepts)。
|
||||
|
||||
## 不会重试 {#nothing-is-retried}
|
||||
|
||||
Hub 不会让事件排队。因 daemon 离线而失败的派发会一直保持失败,所以请在 daemon 恢复后重新触发。
|
||||
|
||||
+192
-77
@@ -1,46 +1,56 @@
|
||||
---
|
||||
title: Hub public API
|
||||
description: Authenticate with organization credentials to validate and install triggers, rotate webhook secrets, dispatch manual runs, and enroll daemons.
|
||||
description: Use organization credentials to install triggers, manage legacy configuration, dispatch runs, and enroll daemons.
|
||||
nav: Public API
|
||||
order: 83
|
||||
order: 79
|
||||
category: Hub
|
||||
---
|
||||
|
||||
# Hub public API
|
||||
|
||||
The Hub public API lets scripts and CI pipelines manage triggers, webhook secrets, manual runs, and daemon enrollment for one organization. Set `PASEO_HUB_URL` to your Hub origin, such as `https://hub.example.com`.
|
||||
The Hub public API lets automation operate on triggers, projects, and daemons in one
|
||||
organization. Set the Hub origin in `PASEO_HUB_URL` below, for example
|
||||
`https://hub.example.com`.
|
||||
|
||||
## API reference
|
||||
|
||||
- [Interactive API reference](https://hub.paseo.sh/api/reference)
|
||||
- [OpenAPI 3.1 document](https://hub.paseo.sh/api/openapi.json)
|
||||
|
||||
A self-hosted Hub serves the same `/api/reference` and `/api/openapi.json` endpoints on its own origin.
|
||||
These are the canonical reference endpoints for the hosted Paseo Hub. A self-hosted Hub exposes the same `/api/reference` and `/api/openapi.json` paths on its own origin.
|
||||
|
||||
## Authentication
|
||||
|
||||
For interactive CLI access, run `paseo hub login [origin]`. Paseo stores a revocable organization credential under `PASEO_HOME` for that exact origin.
|
||||
Run `paseo hub login [origin]` for interactive CLI access. After browser approval, Paseo stores a durable, revocable organization credential under `PASEO_HOME` for that exact origin. Without an explicit origin, the CLI uses `PASEO_HUB_URL`, then the active stored login, then `https://hub.paseo.sh`.
|
||||
|
||||
For automation, create an organization API key in Hub under **Settings → API keys**. Send either credential as a Bearer token:
|
||||
For automation, create an organization API key from the Hub dashboard under **API keys**. Both credential types are bearer tokens:
|
||||
|
||||
```http
|
||||
Authorization: Bearer paseo_pk_...
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
API keys are scoped to one organization and one or more selected scopes:
|
||||
API keys are organization-scoped. The organization that owns the key determines
|
||||
which projects and daemon enrollment tokens it can reach; there is no
|
||||
organization ID to add to these requests. A project slug from another
|
||||
organization is not accessible through the key.
|
||||
|
||||
| Scope | Operations permitted |
|
||||
| ------------------------ | ---------------------------------------------------------------- |
|
||||
| `configuration:validate` | List triggers, list resolvable resources, and validate triggers. |
|
||||
| `configuration:install` | Install triggers and create or rotate trigger webhook secrets. |
|
||||
| `runs:dispatch` | Dispatch a configured `manual.run` trigger. |
|
||||
| `daemons:enroll` | Issue a short-lived daemon enrollment token. |
|
||||
| `projects:read` | List projects in the organization. |
|
||||
Each key has one or more selectable scopes:
|
||||
|
||||
API keys do not grant dashboard sign-in and cannot manage integrations or organization members.
|
||||
| Scope | Operation |
|
||||
| ------------------------ | --------------------------------------------------------------------- |
|
||||
| `projects:read` | List active projects in the organization. |
|
||||
| `configuration:validate` | Validate triggers or legacy configuration without changing Hub state. |
|
||||
| `configuration:install` | Install triggers or replace a legacy project's configuration. |
|
||||
| `runs:dispatch` | Dispatch a configured manual trigger for a project. |
|
||||
| `daemons:enroll` | Issue a short-lived daemon enrollment token. |
|
||||
|
||||
API errors return RFC 9457 `application/problem+json` with an `X-Request-ID` header. Missing, invalid, or revoked credentials return `401` with `WWW-Authenticate: Bearer`:
|
||||
API keys do not grant dashboard access. They cannot manage connections,
|
||||
projects, or organization members.
|
||||
|
||||
CLI credentials have the current CLI operation scopes and remain revocable independently of daemon relationships. `paseo hub logout` deletes the active local CLI credential; it does not revoke or disconnect the daemon identity.
|
||||
|
||||
API failures use RFC 9457 problem details. Missing, invalid, or revoked credentials return `401` with `application/problem+json`:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -53,23 +63,23 @@ API errors return RFC 9457 `application/problem+json` with an `X-Request-ID` hea
|
||||
}
|
||||
```
|
||||
|
||||
A valid credential missing the required scope returns `403` in the same format.
|
||||
A valid key without the scope required by an endpoint returns `403` in the same format.
|
||||
|
||||
## Trigger list, validation, and installation
|
||||
## Trigger validation and installation
|
||||
|
||||
- `GET /api/v1/triggers` (`configuration:validate`) lists active organization triggers and their deployable YAML documents.
|
||||
- `POST /api/v1/triggers/validate` (`configuration:validate`) validates one self-contained trigger YAML document without changing Hub state.
|
||||
- `POST /api/v1/triggers/install` (`configuration:install`) validates and installs one trigger, creating or updating it by its YAML `name`.
|
||||
`paseo hub deploy --dry-run` validates each `.paseo/triggers/*.yml` file through `POST /api/v1/triggers/validate`. `paseo hub deploy` validates all files first, then installs each through `POST /api/v1/triggers/install`.
|
||||
|
||||
`POST /api/v1/triggers/validate` and `POST /api/v1/triggers/install` accept the same JSON request body:
|
||||
Both endpoints accept one self-contained document:
|
||||
|
||||
```json
|
||||
{
|
||||
"yaml": "name: manual-task\nenabled: true\non:\n manual.run: {}\nrun:\n target: { daemon: my-macbook, cwd: /workspace }\n agent: { provider: codex, mode: full-access }\n prompt: |\n Complete the task and call finish_execution.\n ${{ paseo.prompt }}\n max_runtime: 1h\n idle_timeout: 5m\n"
|
||||
"yaml": "name: manual-task\nenabled: true\non:\n manual.run: {}\nrun:\n target: { daemon: my-macbook, cwd: /workspace }\n agent: { provider: codex, model: gpt-5, mode: full-access }\n prompt: Complete the task and call hub.finish_execution.\n max_runtime: 1h\n idle_timeout: 5m\n"
|
||||
}
|
||||
```
|
||||
|
||||
Both endpoints ask the target daemon to validate `run.agent`, so that daemon must be connected and hold `hub.execute`. Validation returns `200` with `{ "name": "manual-task", "valid": true }`. Installation returns `201`:
|
||||
Use a daemon slug and agent runtime available in your organization. Both operations ask the named daemon to check the agent, so it has to be connected and hold `hub.execute`; an agent it cannot run is a field issue rather than a failed first run. See [Saving checks the agent against the daemon](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon). Validation requires `configuration:validate` and returns `200` with `{ "name": "manual-task", "valid": true }`.
|
||||
|
||||
Installation requires `configuration:install`. It creates or updates the organization's trigger by the YAML `name` and returns `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -81,64 +91,143 @@ Both endpoints ask the target daemon to validate `run.agent`, so that daemon mus
|
||||
}
|
||||
```
|
||||
|
||||
Invalid YAML, unknown integrations, or rejected agent settings return `422` with field issues. `paseo hub deploy --dry-run` and `paseo hub deploy` call these endpoints for `.paseo/triggers/*.yml`.
|
||||
Invalid YAML or an unknown organization resource returns `422` with field issues. Each installation is a separate request; a later failure does not undo earlier successful installs. See [Deploy from the CLI](/docs/hub/configuration#deploy-from-the-cli).
|
||||
|
||||
## Webhook secrets
|
||||
## Project list
|
||||
|
||||
`POST /api/v1/triggers/webhook-secret` (`configuration:install`) creates or rotates the Bearer secret for a saved `webhook.received` trigger.
|
||||
|
||||
Request body:
|
||||
`GET /api/v1/projects` returns active projects in the bearer credential's organization. `paseo hub projects` renders the projects as a table. With `--json`, it returns `{ "origin": "...", "projects": [...] }` so even an empty result records the resolved Hub.
|
||||
|
||||
```json
|
||||
{
|
||||
"triggerId": "00000000-0000-4000-8000-000000000001"
|
||||
"projects": [
|
||||
{
|
||||
"id": "00000000-0000-4000-8000-000000000000",
|
||||
"slug": "my-project",
|
||||
"name": "My project"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
On success, Hub returns `200` with `Cache-Control: no-store`:
|
||||
## Legacy configuration validation
|
||||
|
||||
```json
|
||||
{
|
||||
"path": "/webhooks/wh_0123456789abcdef0123456789abcdef",
|
||||
"secret": "whsec_..."
|
||||
}
|
||||
```
|
||||
|
||||
Each call replaces any previous secret immediately and shows the new secret only once. See [Inbound webhooks](/docs/hub/triggers/webhooks) for sending deliveries to `/webhooks/wh_...`.
|
||||
|
||||
## Manual run dispatch
|
||||
|
||||
`POST /api/v1/manual-runs` (`runs:dispatch`) starts a configured `manual.run` trigger. `actor` must match that trigger's `filters.from_users` allowlist (or `*` when omitted).
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "default",
|
||||
"trigger": "manual-task",
|
||||
"actor": "automation",
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"input": "repo=project investigate the failed sync"
|
||||
}
|
||||
```
|
||||
|
||||
- `deliveryKey` provides durable deduplication scoped to your organization and project.
|
||||
- `input` accepts leading `key=value` tokens for declared `inputs` followed by prompt text.
|
||||
|
||||
Omit `expectedVersionId` for standalone triggers. Passing the `revisionId` from trigger installation returns HTTP `409` (`configuration_changed`), even when the trigger is unchanged.
|
||||
|
||||
For legacy project bundles, `expectedVersionId` is optional. Set it to the active project configuration revision ID to reject dispatch if the configuration changes.
|
||||
`POST /api/v1/configurations/validate` accepts the same `projectSlug` and complete `files` bundle as configuration install. It performs the same compilation and resource resolution without recording a revision or changing the active configuration.
|
||||
|
||||
On success, Hub returns `200`:
|
||||
|
||||
```json
|
||||
{
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"projectSlug": "my-project",
|
||||
"valid": true
|
||||
}
|
||||
```
|
||||
|
||||
`paseo hub deploy --project <slug> --dry-run` calls this endpoint with the identical locally resolved payload that a deployment would send.
|
||||
|
||||
## Legacy configuration install
|
||||
|
||||
`configuration:install` validates the supplied canonical bundle, stores the exact authored files, and activates a new revision.
|
||||
|
||||
```http
|
||||
POST /api/v1/configurations/install
|
||||
```
|
||||
|
||||
Request body:
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "my-project",
|
||||
"files": [
|
||||
{
|
||||
"path": ".paseo/hub.yml",
|
||||
"content": "environments:\n production:\n kind: daemon\n daemon: build-server\n cwd: /workspace\nagents:\n codex:\n provider: codex\n"
|
||||
},
|
||||
{
|
||||
"path": ".paseo/workflows/deploy.yml",
|
||||
"content": "name: deploy\non: manual.run\nmax_runtime: 2h\nfilters:\n from_users: [automation]\nsteps:\n - id: deploy\n environment: production\n max_runtime: 90m\n idle_timeout: 10m\n agent: codex\n prompt:\n - include: partials/safety.md\n"
|
||||
},
|
||||
{
|
||||
"path": ".paseo/workflows/partials/safety.md",
|
||||
"content": "Follow the safety checklist."
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
`projectSlug` picks the target project; the bearer credential fixes the organization. `files` contains `.paseo/hub.yml`, every direct workflow `.yml`, and each referenced workflow partial. Hub rejects missing, extra, duplicate, unsafe, or noncanonical paths.
|
||||
|
||||
Limits:
|
||||
|
||||
- Bundle: at most 100 files.
|
||||
- File path: at most 512 characters.
|
||||
- File content: at most 1,000,000 characters.
|
||||
- Prompt partials: at most 1,000,000 bytes each and 5,000,000 bytes in total.
|
||||
|
||||
On success, Hub returns `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "my-project",
|
||||
"versionId": "00000000-0000-4000-8000-000000000000",
|
||||
"version": 3,
|
||||
"active": true
|
||||
}
|
||||
```
|
||||
|
||||
Common responses are `400` for a missing or malformed body, `404` for an inactive or unknown project in the key's organization, and `422` for invalid YAML or an invalid configuration. Validation problem details include field issues. A failed install does not replace the active revision.
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
curl --fail-with-body -sS -X POST "$PASEO_HUB_URL/api/v1/configurations/install" \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
--data @configuration-install.json
|
||||
```
|
||||
|
||||
`paseo hub deploy -p <project>` selects this legacy endpoint with the discovered local bundle. The command uses an exact-origin stored login when flags and environment credentials are absent. See [Deploy from the CLI](/docs/hub/configuration#deploy-from-the-cli).
|
||||
|
||||
## Manual run dispatch
|
||||
|
||||
`runs:dispatch` dispatches a configured `manual.run` trigger for a project.
|
||||
The trigger must exist in the active configuration, and `actor` must be listed
|
||||
in that trigger's `filters.from_users` allowlist.
|
||||
|
||||
```http
|
||||
POST /api/v1/manual-runs
|
||||
```
|
||||
|
||||
Request body:
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "my-project",
|
||||
"expectedVersionId": "00000000-0000-4000-8000-000000000000",
|
||||
"trigger": "deploy",
|
||||
"actor": "automation",
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"input": "repo=project investigate the failed sync"
|
||||
}
|
||||
```
|
||||
|
||||
- `expectedVersionId` is optional. When supplied, Hub rejects the dispatch if that revision is no longer active.
|
||||
- `input` is the same string a provider message uses: leading `key=value` tokens are parsed as declared inputs, and the remainder becomes `${{ paseo.prompt }}`.
|
||||
- `deliveryKey` should be unique and stable per dispatch. Hub uses it for durable deduplication, but does not promise exactly-once dispatch or replay of an earlier response.
|
||||
|
||||
On success, Hub returns `200`:
|
||||
|
||||
```json
|
||||
{
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"providerEventReceiptId": "00000000-0000-4000-8000-000000000000",
|
||||
"triggerRunId": "00000000-0000-4000-8000-000000000000",
|
||||
"configuredTriggerName": "manual-task",
|
||||
"configuredTriggerName": "deploy",
|
||||
"workflowStatus": "running"
|
||||
}
|
||||
```
|
||||
|
||||
Common responses are `400` for an invalid request, `403` when the actor is not allowed by the trigger, `404` for an unknown project, configuration, or trigger, and `409` when the daemon is offline, the expected configuration is no longer current, or dispatch conflicts. Each uses the problem-details shape above.
|
||||
|
||||
Example:
|
||||
|
||||
```bash
|
||||
@@ -146,17 +235,39 @@ curl --fail-with-body -sS -X POST "$PASEO_HUB_URL/api/v1/manual-runs" \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
--data '{
|
||||
"projectSlug": "default",
|
||||
"trigger": "manual-task",
|
||||
"projectSlug": "my-project",
|
||||
"trigger": "deploy",
|
||||
"actor": "automation",
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"input": "investigate the failed sync"
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"input": "repo=project investigate the failed sync"
|
||||
}'
|
||||
```
|
||||
|
||||
See [Hub workflows](/docs/hub/workflows) for input types, defaults, choices,
|
||||
rejected input, and manual invocation examples.
|
||||
|
||||
## Daemon enrollment
|
||||
|
||||
`POST /api/v1/daemons/enrollment-tokens` (`daemons:enroll`) issues a single-use enrollment token that expires in 10 minutes. No request body is required.
|
||||
`daemons:enroll` issues a short-lived enrollment token for a daemon. The API
|
||||
key mints this token; it is not the daemon's long-lived credential and must not
|
||||
be used as one.
|
||||
|
||||
```http
|
||||
POST /api/v1/daemons/enrollment-tokens
|
||||
```
|
||||
|
||||
No request body is required. On success, Hub returns `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "short-lived-enrollment-token",
|
||||
"expiresAt": "2026-08-04T12:10:00.000Z"
|
||||
}
|
||||
```
|
||||
|
||||
The token expires after 10 minutes and is consumed when the daemon enrolls.
|
||||
|
||||
`paseo hub connect [origin]` performs this request with `--api-key`, `PASEO_HUB_API_KEY`, or the matching stored login, then passes the one-time token to the daemon's enrollment operation. The daemon generates and keeps its own relationship credential.
|
||||
|
||||
```bash
|
||||
curl --fail-with-body -sS -X POST \
|
||||
@@ -164,17 +275,21 @@ curl --fail-with-body -sS -X POST \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY"
|
||||
```
|
||||
|
||||
Response (`201`):
|
||||
Direct API consumers can pass the returned token to the daemon enrollment protocol. The Paseo CLI intentionally does not accept raw enrollment tokens; `connect` owns the authenticated single-flow exchange.
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "short-lived-enrollment-token",
|
||||
"expiresAt": "2026-09-09T12:10:00.000Z"
|
||||
}
|
||||
```
|
||||
An enrollment token cannot be reused. Revoking the API key immediately rejects
|
||||
future API requests and expires any unconsumed enrollment tokens that key
|
||||
issued. A race between revocation and issuance is resolved by Hub before a new
|
||||
token is stored.
|
||||
|
||||
`paseo hub connect [origin]` calls this endpoint automatically and exchanges the token for the daemon's own long-lived relationship credential. Revoking the API key immediately blocks new API calls and expires any unconsumed enrollment tokens it issued.
|
||||
## Keys, scopes, and audit information
|
||||
|
||||
## Keys and audit trails
|
||||
The complete API-key secret is shown once, immediately after creation. Store it
|
||||
in your deployment's secret manager; Hub does not show it again. The dashboard
|
||||
retains only the key's prefix and shows its selected scopes, creation time,
|
||||
last-used time, and status.
|
||||
|
||||
Hub displays an API key secret once at creation time. The dashboard keeps only the key prefix, scopes, creation time, last-used timestamp, and revocation status. Hub records key attribution on trigger installations, webhook rotations, manual dispatches, and daemon enrollment tokens.
|
||||
Hub updates `last used` after a key successfully authenticates for a scoped API
|
||||
operation. API operations retain the key attribution in Hub's audit evidence,
|
||||
so configuration revisions, manual dispatches, and daemon enrollment tokens
|
||||
can be traced to the organization key that created them.
|
||||
|
||||
+157
-62
@@ -1,44 +1,48 @@
|
||||
---
|
||||
title: Hub 公开 API
|
||||
description: 使用组织凭据校验和安装触发器、轮换 webhook 密钥、派发手动运行并注册 daemon。
|
||||
description: 使用组织凭据安装触发器、管理旧版配置、发起运行和注册 daemon。
|
||||
nav: 公开 API
|
||||
---
|
||||
|
||||
# Hub 公开 API {#hub-public-api}
|
||||
|
||||
Hub 公开 API 让脚本和 CI 流水线能够管理一个组织的触发器、webhook 密钥、手动运行和 daemon 注册。请将 `PASEO_HUB_URL` 设为你的 Hub 地址,例如 `https://hub.example.com`。
|
||||
Hub 公开 API 让自动化可以操作一个组织中的触发器、项目和 daemon。下文用 `PASEO_HUB_URL` 表示 Hub 的地址,例如 `https://hub.example.com`。
|
||||
|
||||
## API 参考 {#api-reference}
|
||||
|
||||
- [交互式 API 参考](https://hub.paseo.sh/api/reference)
|
||||
- [OpenAPI 3.1 文档](https://hub.paseo.sh/api/openapi.json)
|
||||
|
||||
自托管 Hub 在自己的地址下提供相同的 `/api/reference` 和 `/api/openapi.json` 端点。
|
||||
这些是托管版 Paseo Hub 的标准参考端点。自托管的 Hub 在它自己的地址上提供相同的 `/api/reference` 和 `/api/openapi.json` 路径。
|
||||
|
||||
## 认证 {#authentication}
|
||||
## 身份验证 {#authentication}
|
||||
|
||||
交互式 CLI 访问请运行 `paseo hub login [origin]`。Paseo 会在 `PASEO_HOME` 下为该精确地址保存一个可撤销的组织凭据。
|
||||
运行 `paseo hub login [origin]` 获得交互式的 CLI 访问权限。在浏览器中批准后,Paseo 会在 `PASEO_HOME` 下为这个确切的地址保存一个持久、可撤销的组织凭据。未显式指定地址时,CLI 依次使用 `PASEO_HUB_URL`、当前保存的登录,然后是 `https://hub.paseo.sh`。
|
||||
|
||||
自动化场景请在 Hub 的 **Settings → API keys** 下创建组织 API 密钥。两种凭据都作为 Bearer 令牌发送:
|
||||
用于自动化时,请在 Hub 控制台的 **API keys** 下创建组织 API 密钥。两种凭据都是 bearer token:
|
||||
|
||||
```http
|
||||
Authorization: Bearer paseo_pk_...
|
||||
Content-Type: application/json
|
||||
```
|
||||
|
||||
API 密钥限定在单个组织内,并绑定所选的一个或多个权限范围:
|
||||
API 密钥的作用域是组织。拥有该密钥的组织决定了它能访问哪些项目和 daemon 注册令牌;这些请求中不需要添加组织 ID。通过该密钥无法访问其他组织的项目 slug。
|
||||
|
||||
| 权限范围 | 允许的操作 |
|
||||
| ------------------------ | ----------------------------------------------- |
|
||||
| `configuration:validate` | 列出触发器、列出可解析资源并校验触发器。 |
|
||||
| `configuration:install` | 安装触发器,以及创建或轮换触发器 webhook 密钥。 |
|
||||
| `runs:dispatch` | 派发已配置的 `manual.run` 触发器。 |
|
||||
| `daemons:enroll` | 签发短期 daemon 注册令牌。 |
|
||||
| `projects:read` | 列出组织中的项目。 |
|
||||
每个密钥有一个或多个可选的权限范围:
|
||||
|
||||
API 密钥不能用于登录控制台,也不能管理集成或组织成员。
|
||||
| 权限范围 | 操作 |
|
||||
| ------------------------ | --------------------------------------- |
|
||||
| `projects:read` | 列出组织中的活动项目。 |
|
||||
| `configuration:validate` | 校验触发器或旧版配置,不改变 Hub 状态。 |
|
||||
| `configuration:install` | 安装触发器,或替换旧版项目的配置。 |
|
||||
| `runs:dispatch` | 为项目发起一个已配置的手动触发器。 |
|
||||
| `daemons:enroll` | 签发一个短期有效的 daemon 注册令牌。 |
|
||||
|
||||
API 错误返回 RFC 9457 `application/problem+json` 格式并带有 `X-Request-ID` 响应头。缺少、无效或已撤销的凭据返回 `401` 和 `WWW-Authenticate: Bearer`:
|
||||
API 密钥不授予控制台访问权限。它们不能管理连接、项目或组织成员。
|
||||
|
||||
CLI 凭据拥有当前 CLI 操作所需的权限范围,并且可以独立于 daemon 关系单独撤销。`paseo hub logout` 会删除当前的本地 CLI 凭据;它不会撤销或断开 daemon 身份。
|
||||
|
||||
API 失败时使用 RFC 9457 问题详情格式。缺失、无效或已撤销的凭据返回 `401`,类型为 `application/problem+json`:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -51,23 +55,23 @@ API 错误返回 RFC 9457 `application/problem+json` 格式并带有 `X-Request-
|
||||
}
|
||||
```
|
||||
|
||||
有效凭据但缺少所需权限范围时,以相同格式返回 `403`。
|
||||
有效但缺少端点所需权限范围的密钥会以相同格式返回 `403`。
|
||||
|
||||
## 触发器列表、校验与安装 {#trigger-list-validation-and-installation}
|
||||
## 触发器校验和安装 {#trigger-validation-and-installation}
|
||||
|
||||
- `GET /api/v1/triggers`(`configuration:validate`)列出组织的活动触发器及其可部署的 YAML 文档。
|
||||
- `POST /api/v1/triggers/validate`(`configuration:validate`)校验单个自包含触发器 YAML 文档,不修改 Hub 状态。
|
||||
- `POST /api/v1/triggers/install`(`configuration:install`)校验并安装单个触发器,按其 YAML `name` 创建或更新。
|
||||
`paseo hub deploy --dry-run` 通过 `POST /api/v1/triggers/validate` 校验每个 `.paseo/triggers/*.yml` 文件。`paseo hub deploy` 先校验所有文件,再通过 `POST /api/v1/triggers/install` 逐个安装。
|
||||
|
||||
`POST /api/v1/triggers/validate` 和 `POST /api/v1/triggers/install` 接受相同的 JSON 请求体:
|
||||
两个端点都接受一份自包含的文档:
|
||||
|
||||
```json
|
||||
{
|
||||
"yaml": "name: manual-task\nenabled: true\non:\n manual.run: {}\nrun:\n target: { daemon: my-macbook, cwd: /workspace }\n agent: { provider: codex, mode: full-access }\n prompt: |\n Complete the task and call finish_execution.\n ${{ paseo.prompt }}\n max_runtime: 1h\n idle_timeout: 5m\n"
|
||||
"yaml": "name: manual-task\nenabled: true\non:\n manual.run: {}\nrun:\n target: { daemon: my-macbook, cwd: /workspace }\n agent: { provider: codex, model: gpt-5, mode: full-access }\n prompt: Complete the task and call hub.finish_execution.\n max_runtime: 1h\n idle_timeout: 5m\n"
|
||||
}
|
||||
```
|
||||
|
||||
两个端点都会请目标 daemon 校验 `run.agent`,因此该 daemon 必须在线且持有 `hub.execute`。校验成功返回 `200` 和 `{ "name": "manual-task", "valid": true }`。安装成功返回 `201`:
|
||||
请使用你的组织中可用的 daemon slug 和 Agent 运行时。两个操作都会请指定的 daemon 检查 Agent,因此它必须已连接并持有 `hub.execute`;它无法运行的 Agent 会作为字段问题报告,而不是在第一次运行时失败。见[保存时会对照 daemon 检查 Agent](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon)。校验需要 `configuration:validate`,并返回 `200` 和 `{ "name": "manual-task", "valid": true }`。
|
||||
|
||||
安装需要 `configuration:install`。它按 YAML 中的 `name` 创建或更新组织的触发器,并返回 `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
@@ -79,64 +83,141 @@ API 错误返回 RFC 9457 `application/problem+json` 格式并带有 `X-Request-
|
||||
}
|
||||
```
|
||||
|
||||
无效 YAML、未知集成或被拒绝的 Agent 设置会返回 `422` 及字段级错误详情。`paseo hub deploy --dry-run` 和 `paseo hub deploy` 会针对 `.paseo/triggers/*.yml` 调用这两个端点。
|
||||
无效的 YAML 或未知的组织资源会返回 `422` 及字段问题。每次安装都是独立的请求;后面的失败不会撤销前面已成功的安装。见[从 CLI 部署](/docs/hub/configuration#deploy-from-the-cli)。
|
||||
|
||||
## Webhook 密钥 {#webhook-secrets}
|
||||
## 项目列表 {#project-list}
|
||||
|
||||
`POST /api/v1/triggers/webhook-secret`(`configuration:install`)为已保存的 `webhook.received` 触发器创建或轮换 Bearer 密钥。
|
||||
`GET /api/v1/projects` 返回 bearer 凭据所属组织中的活动项目。`paseo hub projects` 以表格形式显示项目。使用 `--json` 时,它返回 `{ "origin": "...", "projects": [...] }`,因此即使结果为空,也会记录解析出的 Hub。
|
||||
|
||||
```json
|
||||
{
|
||||
"projects": [
|
||||
{
|
||||
"id": "00000000-0000-4000-8000-000000000000",
|
||||
"slug": "my-project",
|
||||
"name": "My project"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 旧版配置校验 {#legacy-configuration-validation}
|
||||
|
||||
`POST /api/v1/configurations/validate` 接受与配置安装相同的 `projectSlug` 和完整的 `files` 文件包。它执行相同的编译和资源解析,但不会记录修订,也不会改变当前生效的配置。
|
||||
|
||||
成功时,Hub 返回 `200`:
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "my-project",
|
||||
"valid": true
|
||||
}
|
||||
```
|
||||
|
||||
`paseo hub deploy --project <slug> --dry-run` 会用与实际部署完全相同的、在本地解析出的请求体调用此端点。
|
||||
|
||||
## 旧版配置安装 {#legacy-configuration-install}
|
||||
|
||||
`configuration:install` 会校验提供的标准文件包,原样保存编写的文件,并激活一个新的修订。
|
||||
|
||||
```http
|
||||
POST /api/v1/configurations/install
|
||||
```
|
||||
|
||||
请求体:
|
||||
|
||||
```json
|
||||
{
|
||||
"triggerId": "00000000-0000-4000-8000-000000000001"
|
||||
"projectSlug": "my-project",
|
||||
"files": [
|
||||
{
|
||||
"path": ".paseo/hub.yml",
|
||||
"content": "environments:\n production:\n kind: daemon\n daemon: build-server\n cwd: /workspace\nagents:\n codex:\n provider: codex\n"
|
||||
},
|
||||
{
|
||||
"path": ".paseo/workflows/deploy.yml",
|
||||
"content": "name: deploy\non: manual.run\nmax_runtime: 2h\nfilters:\n from_users: [automation]\nsteps:\n - id: deploy\n environment: production\n max_runtime: 90m\n idle_timeout: 10m\n agent: codex\n prompt:\n - include: partials/safety.md\n"
|
||||
},
|
||||
{
|
||||
"path": ".paseo/workflows/partials/safety.md",
|
||||
"content": "Follow the safety checklist."
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
成功后 Hub 返回 `200` 及 `Cache-Control: no-store`:
|
||||
`projectSlug` 选择目标项目;bearer 凭据确定组织。`files` 包含 `.paseo/hub.yml`、每个直接位于目录下的 workflow `.yml`,以及每个被引用的 workflow 片段。Hub 会拒绝缺失、多余、重复、不安全或非标准的路径。
|
||||
|
||||
限制:
|
||||
|
||||
- 文件包:最多 100 个文件。
|
||||
- 文件路径:最多 512 个字符。
|
||||
- 文件内容:最多 1,000,000 个字符。
|
||||
- 提示词片段:每个最多 1,000,000 字节,总计最多 5,000,000 字节。
|
||||
|
||||
成功时,Hub 返回 `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
"path": "/webhooks/wh_0123456789abcdef0123456789abcdef",
|
||||
"secret": "whsec_..."
|
||||
"projectSlug": "my-project",
|
||||
"versionId": "00000000-0000-4000-8000-000000000000",
|
||||
"version": 3,
|
||||
"active": true
|
||||
}
|
||||
```
|
||||
|
||||
每次调用都会立即替换旧密钥,并且新密钥仅显示一次。向 `/webhooks/wh_...` 发送投递的方式见[入站 webhook](/docs/hub/triggers/webhooks)。
|
||||
常见的响应有:请求体缺失或格式错误时返回 `400`,密钥所属组织中的项目不活动或未知时返回 `404`,YAML 无效或配置无效时返回 `422`。校验的问题详情包含字段问题。安装失败不会替换当前生效的修订。
|
||||
|
||||
## 手动运行派发 {#manual-run-dispatch}
|
||||
示例:
|
||||
|
||||
`POST /api/v1/manual-runs`(`runs:dispatch`)启动一个已配置的 `manual.run` 触发器。`actor` 必须匹配该触发器的 `filters.from_users` 白名单(省略时为 `*`)。
|
||||
```bash
|
||||
curl --fail-with-body -sS -X POST "$PASEO_HUB_URL/api/v1/configurations/install" \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
--data @configuration-install.json
|
||||
```
|
||||
|
||||
`paseo hub deploy -p <project>` 会用在本地发现的文件包调用这个旧版端点。在没有参数和环境变量凭据时,该命令使用与地址完全匹配的已保存登录。见[从 CLI 部署](/docs/hub/configuration#deploy-from-the-cli)。
|
||||
|
||||
## 发起手动运行 {#manual-run-dispatch}
|
||||
|
||||
`runs:dispatch` 为项目发起一个已配置的 `manual.run` 触发器。该触发器必须存在于当前生效的配置中,并且 `actor` 必须列在该触发器的 `filters.from_users` 白名单中。
|
||||
|
||||
```http
|
||||
POST /api/v1/manual-runs
|
||||
```
|
||||
|
||||
请求体:
|
||||
|
||||
```json
|
||||
{
|
||||
"projectSlug": "default",
|
||||
"trigger": "manual-task",
|
||||
"projectSlug": "my-project",
|
||||
"expectedVersionId": "00000000-0000-4000-8000-000000000000",
|
||||
"trigger": "deploy",
|
||||
"actor": "automation",
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"input": "repo=project investigate the failed sync"
|
||||
}
|
||||
```
|
||||
|
||||
- `deliveryKey` 提供限定在组织和项目内的持久去重。
|
||||
- `input` 接受以声明的 `inputs` 对应的 `key=value` 头部开头,后接提示词文本。
|
||||
- `expectedVersionId` 是可选的。提供时,如果该修订已不再生效,Hub 会拒绝这次发起。
|
||||
- `input` 与 Provider 消息使用的字符串相同:开头的 `key=value` 标记会被解析为声明的输入,其余部分成为 `${{ paseo.prompt }}`。
|
||||
- `deliveryKey` 对每次发起都应唯一且稳定。Hub 用它进行持久化去重,但不保证恰好发起一次,也不保证重放之前的响应。
|
||||
|
||||
派发独立触发器时,请省略 `expectedVersionId`。如果传入安装触发器时返回的 `revisionId`,即使触发器没有变化,Hub 也会返回 HTTP `409`(`configuration_changed`)。
|
||||
|
||||
对于旧版项目配置包,`expectedVersionId` 为可选项。将它设为当前生效的项目配置修订 ID,配置变更后 Hub 就会拒绝派发。
|
||||
|
||||
成功后 Hub 返回 `200`:
|
||||
成功时,Hub 返回 `200`:
|
||||
|
||||
```json
|
||||
{
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"providerEventReceiptId": "00000000-0000-4000-8000-000000000000",
|
||||
"triggerRunId": "00000000-0000-4000-8000-000000000000",
|
||||
"configuredTriggerName": "manual-task",
|
||||
"configuredTriggerName": "deploy",
|
||||
"workflowStatus": "running"
|
||||
}
|
||||
```
|
||||
|
||||
常见的响应有:请求无效时返回 `400`,触发器不允许该 actor 时返回 `403`,项目、配置或触发器未知时返回 `404`,daemon 离线、预期的配置已不是当前配置或发起冲突时返回 `409`。它们都使用上面的问题详情格式。
|
||||
|
||||
示例:
|
||||
|
||||
```bash
|
||||
@@ -144,17 +225,36 @@ curl --fail-with-body -sS -X POST "$PASEO_HUB_URL/api/v1/manual-runs" \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY" \
|
||||
-H "Content-Type: application/json" \
|
||||
--data '{
|
||||
"projectSlug": "default",
|
||||
"trigger": "manual-task",
|
||||
"projectSlug": "my-project",
|
||||
"trigger": "deploy",
|
||||
"actor": "automation",
|
||||
"deliveryKey": "manual-task-2026-09-09-001",
|
||||
"input": "investigate the failed sync"
|
||||
"deliveryKey": "deploy-2026-08-04-001",
|
||||
"input": "repo=project investigate the failed sync"
|
||||
}'
|
||||
```
|
||||
|
||||
## Daemon 注册 {#daemon-enrollment}
|
||||
输入类型、默认值、可选值、被拒绝的输入以及手动调用示例,见 [Hub workflow](/docs/hub/workflows)。
|
||||
|
||||
`POST /api/v1/daemons/enrollment-tokens`(`daemons:enroll`)签发一个 10 分钟后过期的一次性注册令牌。不需要请求体。
|
||||
## 注册 daemon {#daemon-enrollment}
|
||||
|
||||
`daemons:enroll` 为 daemon 签发一个短期有效的注册令牌。这个令牌由 API 密钥签发;它不是 daemon 的长期凭据,也不得当作长期凭据使用。
|
||||
|
||||
```http
|
||||
POST /api/v1/daemons/enrollment-tokens
|
||||
```
|
||||
|
||||
不需要请求体。成功时,Hub 返回 `201`:
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "short-lived-enrollment-token",
|
||||
"expiresAt": "2026-08-04T12:10:00.000Z"
|
||||
}
|
||||
```
|
||||
|
||||
令牌在 10 分钟后过期,并在 daemon 注册时被消耗。
|
||||
|
||||
`paseo hub connect [origin]` 会使用 `--api-key`、`PASEO_HUB_API_KEY` 或匹配的已保存登录执行此请求,然后把这个一次性令牌传给 daemon 的注册操作。daemon 会生成并保存它自己的关系凭据。
|
||||
|
||||
```bash
|
||||
curl --fail-with-body -sS -X POST \
|
||||
@@ -162,17 +262,12 @@ curl --fail-with-body -sS -X POST \
|
||||
-H "Authorization: Bearer $PASEO_HUB_API_KEY"
|
||||
```
|
||||
|
||||
响应(`201`):
|
||||
直接使用 API 的调用方可以把返回的令牌传给 daemon 注册协议。Paseo CLI 有意不接受原始注册令牌;`connect` 负责完整的、经过身份验证的单一交换流程。
|
||||
|
||||
```json
|
||||
{
|
||||
"token": "short-lived-enrollment-token",
|
||||
"expiresAt": "2026-09-09T12:10:00.000Z"
|
||||
}
|
||||
```
|
||||
注册令牌不能重复使用。撤销 API 密钥会立即拒绝之后的 API 请求,并使该密钥签发的所有未消耗的注册令牌过期。撤销与签发之间的竞争会在新令牌被保存之前由 Hub 解决。
|
||||
|
||||
`paseo hub connect [origin]` 会自动调用此端点,并用令牌换取 daemon 自己的长期关系凭据。撤销 API 密钥会立即阻止新的 API 调用,并使该密钥签发的未消耗注册令牌失效。
|
||||
## 密钥、权限范围和审计信息 {#keys-scopes-and-audit-information}
|
||||
|
||||
## 密钥与审计记录 {#keys-and-audit-trails}
|
||||
完整的 API 密钥只在创建后立即显示一次。请把它保存到你的部署所用的密钥管理器中;Hub 不会再次显示它。控制台只保留密钥的前缀,并显示它所选的权限范围、创建时间、最后使用时间和状态。
|
||||
|
||||
Hub 仅在创建时显示一次 API 密钥内容。控制台只保留密钥前缀、权限范围、创建时间、最近使用时间和撤销状态。Hub 会在触发器安装、webhook 轮换、手动派发和 daemon 注册令牌中保留密钥归属记录。
|
||||
密钥在一次有权限范围的 API 操作中成功通过身份验证后,Hub 会更新 `last used`。API 操作会在 Hub 的审计记录中保留密钥归属,因此配置修订、手动发起和 daemon 注册令牌都可以追溯到创建它们的组织密钥。
|
||||
|
||||
+42
-41
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: How Hub works
|
||||
description: How events, schedules, and webhooks match a trigger and start an agent on your Paseo daemon.
|
||||
description: How a provider event reaches a workflow and a Paseo daemon.
|
||||
nav: How it works
|
||||
order: 62
|
||||
category: Hub
|
||||
@@ -8,60 +8,61 @@ category: Hub
|
||||
|
||||
# How Hub works
|
||||
|
||||
Hub connects external events, schedules, and webhooks to coding agents running on your Paseo daemons.
|
||||
Hub connects the places where requests arrive to the machines where your agents run.
|
||||
|
||||
```text
|
||||
GitHub / Linear / Slack / Discord / Schedule / Webhook
|
||||
│
|
||||
▼
|
||||
Hub
|
||||
verifies input and matches triggers
|
||||
│
|
||||
▼
|
||||
Paseo daemon
|
||||
starts or continues an agent
|
||||
GitHub / Slack / Discord / manual request
|
||||
↓
|
||||
Hub
|
||||
matches a project trigger
|
||||
↓
|
||||
workflow
|
||||
runs ordered agent steps
|
||||
↓
|
||||
Paseo daemon
|
||||
starts the agent
|
||||
```
|
||||
|
||||
## Core concepts
|
||||
## The pieces
|
||||
|
||||
- An **app** is the provider application configured for a self-hosted Hub under **Apps** (GitHub App, Linear OAuth app, Slack app, or Discord app). Hosted Hub operates its own apps.
|
||||
- An **integration** is a workspace, account, or server connected to your Hub organization under **Integrations**. Each connected account has a unique connection slug, such as `acme-github` or `acme-slack`, that triggers reference.
|
||||
- A **daemon** is a machine running the Paseo daemon and enrolled in your Hub organization under **Daemons**. Daemons accept agent launches only after you grant `hub.execute` from that machine.
|
||||
- A **trigger** is one self-contained rule that maps an event, schedule, or webhook to a target daemon, working directory, agent configuration, prompt, and optional tools or outputs.
|
||||
- **Activity** records every accepted delivery, routing decision, execution status, reply, and error across the organization.
|
||||
- A **connection** lets Hub receive events from GitHub, Slack, or Discord.
|
||||
- A **daemon** is a registered machine running the Paseo daemon.
|
||||
- A **project** groups one configuration with the connections and daemons it uses.
|
||||
- An **environment** names where a workflow step runs: a daemon, its working directory, and an optional worktree.
|
||||
- A **trigger** says which provider event can start a workflow and which events are allowed through.
|
||||
- A **workflow** is the ordered set of steps that runs after a trigger matches.
|
||||
- A **step** starts one agent execution, with its own prompt, agent selection, credentials, reply capabilities, and limits.
|
||||
|
||||
The configuration lives in `.paseo/hub.yml` plus convention-discovered `.paseo/workflows/*.yml` files when the project uses a GitHub source. A project has one active configuration revision at a time.
|
||||
|
||||
## From event to agent
|
||||
|
||||
1. An event arrives via HTTPS webhooks (GitHub, Linear, Slack Webhooks, or inbound webhooks), an outbound connection (Slack Socket Mode or Discord gateway), or Hub's schedule clock.
|
||||
2. Hub verifies the sender or signature and looks up matching enabled triggers.
|
||||
3. For external provider events, Hub evaluates the trigger's connection, resource filters, and sender allowlist (`from_users`).
|
||||
4. For each matching trigger, Hub creates a run and sends the launch intent to the target daemon over the same RPC protocol used by the Paseo app and CLI.
|
||||
5. By default, events on the same Slack thread, Discord thread, GitHub issue or pull request, or Linear issue continue the existing agent session rather than starting a new one.
|
||||
6. The agent runs on your machine with the Hub MCP server attached. It calls `reply` to answer the conversation, calls any granted integration tools, and calls `finish_execution` when complete.
|
||||
1. A provider sends an event to Hub. GitHub and Slack use webhooks; Discord uses its gateway connection; manual runs use the Hub API.
|
||||
2. Hub verifies the provider event and identifies its project resource, such as a repository, workspace, or guild.
|
||||
3. Hub evaluates triggers and their filters, including the required `from_users` allowlist.
|
||||
4. A matching trigger creates a workflow run from the active configuration revision.
|
||||
5. The workflow evaluates its next step. A false `if` condition skips that step; a true condition starts it on the configured daemon.
|
||||
6. The daemon starts the agent and Hub records its replies, structured output, status, and completion.
|
||||
7. The next step sees the completed step's output. When no steps remain, the workflow run is complete.
|
||||
|
||||
## Authoring and validation
|
||||
Complete configurations are in [Workflows](/docs/hub/workflows).
|
||||
|
||||
You can create and edit triggers in two ways:
|
||||
## Activation
|
||||
|
||||
- In the Hub dashboard under **Triggers**, using the visual form or the YAML editor.
|
||||
- As `.paseo/triggers/*.yml` files in your repository, deployed with `paseo hub deploy`.
|
||||
When Hub syncs the bundle, it validates every source file and resolves its references:
|
||||
|
||||
Both paths use the same YAML schema. When you save or deploy, Hub validates the YAML and looks up the connections for event routing and the target daemon.
|
||||
- `filters.repo`, `filters.workspace`, and `filters.guild` must name resources available through the organization's connections.
|
||||
- `environment.daemon` must match a registered daemon's friendly slug.
|
||||
- Step ids, expressions, input filters, output schemas, and durations must be valid.
|
||||
- Every finite environment or named-agent result must exist and validate.
|
||||
- Prompt partials must resolve below `.paseo/workflows/partials/` at the exact commit.
|
||||
|
||||
You can save dashboard edits while the daemon is offline if the target and agent settings stay the same. CLI deploys and direct API installs always require a connected target daemon. See [trigger validation](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon).
|
||||
|
||||
Hub resolves `run.github.connection` when it launches the run. If the connection is unavailable or GitHub rejects the token request, the launch fails. See [GitHub access for agents](/docs/hub/github).
|
||||
|
||||
## Open in Paseo links
|
||||
|
||||
When Hub has a public HTTPS origin and a run has a recorded daemon agent, Hub appends an **Open in Paseo** link to conversation replies on GitHub, Linear, Slack, and Discord.
|
||||
|
||||
Clicking the link checks that the visitor is a signed-in member of that Hub organization before offering to open the exact agent in Paseo, view the execution in Hub, or install Paseo. Signed-out visitors and users outside the organization receive no run details.
|
||||
|
||||
Agents with scoped posting tools (`run.tools.slack` or `run.tools.discord`) also receive the same URL in their request context so digests and reports can link back to the run.
|
||||
If activation fails, Hub keeps the previous active revision. The Configuration tab shows the failed sync and its validation error; Activity continues to reflect the last active revision.
|
||||
|
||||
## Security boundaries
|
||||
|
||||
Hub verifies inbound requests, enforces sender allowlists, mints scoped GitHub tokens, and authorizes every Hub MCP tool call on the server. It does not sandbox the coding agent process on your machine.
|
||||
Triggers require a non-empty `from_users` allowlist for externally sourced events. Protect the configuration repository because anyone who can change the active configuration can choose which connections, daemons, and agent capabilities a project uses.
|
||||
|
||||
Protect access to your Hub organization and any repository that deploys `.paseo/triggers/*.yml`. Read [Hub security](/docs/hub/security) before widening allowlists or granting repository write permissions.
|
||||
These controls do not sandbox the agent or make input safe. See [Hub security](/docs/hub/security) for the host boundary, provider-native policy, and defense-in-depth guidance.
|
||||
|
||||
GitHub credentials are never implied by the trigger. A step holds GitHub authority only when it declares a [`github` block](/docs/hub/github), whatever started the run.
|
||||
|
||||
@@ -1,65 +1,66 @@
|
||||
---
|
||||
title: Hub 的工作原理
|
||||
description: 事件、定时任务和 webhook 如何匹配触发器,并在你的 Paseo daemon 上启动 Agent。
|
||||
title: Hub 工作原理
|
||||
description: Provider 事件如何到达 workflow 和 Paseo daemon。
|
||||
nav: 工作原理
|
||||
---
|
||||
|
||||
# Hub 的工作原理 {#how-hub-works}
|
||||
# Hub 工作原理 {#how-hub-works}
|
||||
|
||||
Hub 将外部事件、定时任务和 webhook 连接到在你 Paseo daemon 上运行的编程 Agent。
|
||||
Hub 把请求到达的地方与运行 Agent 的机器连接起来。
|
||||
|
||||
```text
|
||||
GitHub / Linear / Slack / Discord / Schedule / Webhook
|
||||
│
|
||||
▼
|
||||
Hub
|
||||
verifies input and matches triggers
|
||||
│
|
||||
▼
|
||||
Paseo daemon
|
||||
starts or continues an agent
|
||||
GitHub / Slack / Discord / manual request
|
||||
↓
|
||||
Hub
|
||||
matches a project trigger
|
||||
↓
|
||||
workflow
|
||||
runs ordered agent steps
|
||||
↓
|
||||
Paseo daemon
|
||||
starts the agent
|
||||
```
|
||||
|
||||
## 核心概念 {#core-concepts}
|
||||
## 组成部分 {#the-pieces}
|
||||
|
||||
- **App** 是在自托管 Hub 的 **Apps** 下配置的 Provider 应用(GitHub App、Linear OAuth 应用、Slack 应用或 Discord 应用)。托管 Hub 运行自己的应用。
|
||||
- **Integration** 是在 **Integrations** 下连接到你 Hub 组织的工作区、账号或服务器。每个已连接的账号都有唯一的连接 slug(例如 `acme-github` 或 `acme-slack`),供触发器引用。
|
||||
- **Daemon** 是运行 Paseo daemon 并注册到你 Hub 组织 **Daemons** 下的机器。只有在机器上授予 `hub.execute` 后,daemon 才会接受 Agent 启动请求。
|
||||
- **Trigger** 是一条自包含规则,将事件、定时任务或 webhook 映射到目标 daemon、工作目录、Agent 配置、提示词,以及可选的工具或输出。
|
||||
- **Activity** 记录组织内每一次已接受的投递、路由决策、执行状态、回复和错误。
|
||||
- **连接**让 Hub 接收来自 GitHub、Slack 或 Discord 的事件。
|
||||
- **daemon** 是一台运行 Paseo daemon 的已注册机器。
|
||||
- **项目**把一份配置与它使用的连接和 daemon 组织在一起。
|
||||
- **环境**指定 workflow step 在哪里运行:一个 daemon、它的工作目录,以及可选的 worktree。
|
||||
- **触发器**说明哪个 Provider 事件可以启动 workflow,以及允许哪些事件通过。
|
||||
- **workflow** 是触发器匹配后运行的一组有序 step。
|
||||
- **step** 启动一次 Agent 执行,有自己的提示词、Agent 选择、凭据、回复能力和限制。
|
||||
|
||||
当项目使用 GitHub 来源时,配置位于 `.paseo/hub.yml` 以及按约定发现的 `.paseo/workflows/*.yml` 文件中。一个项目同一时间只有一个生效的配置版本。
|
||||
|
||||
## 从事件到 Agent {#from-event-to-agent}
|
||||
|
||||
1. 事件通过 HTTPS webhook(GitHub、Linear、Slack Webhooks 或入站 webhook)、出站连接(Slack Socket Mode 或 Discord gateway)或 Hub 定时时钟到达。
|
||||
2. Hub 验证发送者或签名,并查找匹配的已启用触发器。
|
||||
3. 对于外部 Provider 事件,Hub 会评估触发器的连接、资源过滤条件和发送者白名单(`from_users`)。
|
||||
4. 对每个匹配的触发器,Hub 创建一次运行,并通过 Paseo 应用和 CLI 使用的同一套 RPC 协议向目标 daemon 发送启动意图。
|
||||
5. 默认情况下,同一个 Slack 讨论串、Discord 讨论串、GitHub issue 或 Pull Request,以及同一个 Linear issue 上的事件会继续现有 Agent 会话,而不是启动新的 Agent。
|
||||
6. Agent 在你的机器上运行并挂载 Hub MCP 服务器。它调用 `reply` 回复对话,调用已授予的集成工具,并在完成后调用 `finish_execution`。
|
||||
1. Provider 向 Hub 发送事件。GitHub 和 Slack 使用 webhook;Discord 使用它的 gateway 连接;手动运行使用 Hub API。
|
||||
2. Hub 验证 Provider 事件,并识别它对应的项目资源,例如仓库、工作区或服务器。
|
||||
3. Hub 评估触发器及其过滤器,包括必填的 `from_users` 允许列表。
|
||||
4. 匹配的触发器根据当前生效的配置版本创建一次 workflow 运行。
|
||||
5. workflow 评估下一个 step。`if` 条件为假时跳过该 step;为真时在配置的 daemon 上启动它。
|
||||
6. daemon 启动 Agent,Hub 记录它的回复、结构化输出、状态和完成情况。
|
||||
7. 下一个 step 可以看到已完成 step 的输出。没有剩余 step 时,workflow 运行完成。
|
||||
|
||||
## 编写与校验 {#authoring-and-validation}
|
||||
完整的配置示例见 [Workflow](/docs/hub/workflows)。
|
||||
|
||||
你可以通过两种方式创建和编辑触发器:
|
||||
## 激活 {#activation}
|
||||
|
||||
- 在 Hub 控制台的 **Triggers** 页面使用可视化表单或 YAML 编辑器。
|
||||
- 在仓库中保存 `.paseo/triggers/*.yml` 文件,并通过 `paseo hub deploy` 部署。
|
||||
Hub 同步配置包时,会校验每个源文件并解析其中的引用:
|
||||
|
||||
两种方式使用相同的 YAML 结构。保存或部署触发器时,Hub 会校验 YAML,并查找用于事件路由的连接和目标 daemon。
|
||||
- `filters.repo`、`filters.workspace` 和 `filters.guild` 必须指向通过组织的连接可以访问的资源。
|
||||
- `environment.daemon` 必须匹配一个已注册 daemon 的友好 slug。
|
||||
- step id、表达式、输入过滤器、输出 schema 和时长必须有效。
|
||||
- 每个有限的环境或命名 Agent 结果都必须存在并通过校验。
|
||||
- 提示词片段必须能在该提交中 `.paseo/workflows/partials/` 下解析到。
|
||||
|
||||
只要目标和 Agent 设置不变,daemon 离线时也能在控制台保存修改。通过 CLI 部署或直接通过 API 安装时,目标 daemon 必须连接到 Hub。请参阅[触发器校验](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon)。
|
||||
|
||||
Hub 在启动运行时解析 `run.github.connection`。如果连接不可用或 GitHub 拒绝签发令牌,运行就会启动失败。请参阅 [Agent 的 GitHub 访问权限](/docs/hub/github)。
|
||||
|
||||
## Open in Paseo 链接 {#open-in-paseo-links}
|
||||
|
||||
当 Hub 配置了公开 HTTPS 地址且运行记录了 daemon Agent 时,Hub 会在 GitHub、Linear、Slack 和 Discord 的对话回复中附带 **Open in Paseo** 链接。
|
||||
|
||||
点击链接时,Hub 会先验证访问者是否为该 Hub 组织的已登录成员,然后提供在 Paseo 中打开对应 Agent、在 Hub 中查看运行记录或安装 Paseo 的入口。未登录的访客和非组织成员不会看到任何运行数据。
|
||||
|
||||
拥有受控发送工具(`run.tools.slack` 或 `run.tools.discord`)的 Agent 也会在请求上下文中收到同一个 URL,方便摘要和报告主动链接回此次运行。
|
||||
如果激活失败,Hub 会保留之前生效的版本。Configuration 标签页会显示失败的同步及其校验错误;Activity 继续反映上一个生效的版本。
|
||||
|
||||
## 安全边界 {#security-boundaries}
|
||||
|
||||
Hub 负责验证入站请求、执行发送者白名单、签发受控 GitHub 令牌,并在服务端对每次 Hub MCP 工具调用做鉴权。它不会在你机器上为编程 Agent 进程提供沙箱隔离。
|
||||
对于来自外部的事件,触发器要求 `from_users` 允许列表不能为空。请保护好配置仓库,因为任何能够修改生效配置的人,都可以决定项目使用哪些连接、daemon 和 Agent 能力。
|
||||
|
||||
请保护你的 Hub 组织访问权限,以及任何用于部署 `.paseo/triggers/*.yml` 的仓库。在扩大白名单或授予仓库写入权限之前,请先阅读 [Hub 安全](/docs/hub/security)。
|
||||
这些控制措施不会把 Agent 放进沙箱,也不会让输入变得安全。主机边界、Provider 原生策略和纵深防御方面的指导见 [Hub 安全](/docs/hub/security)。
|
||||
|
||||
触发器从不隐含 GitHub 凭据。无论运行由什么启动,只有当 step 声明了 [`github` 块](/docs/hub/github)时,它才拥有 GitHub 权限。
|
||||
|
||||
@@ -0,0 +1,283 @@
|
||||
---
|
||||
title: Hub configuration reference
|
||||
description: Canonical Hub resource, workflow, agent, expression, and prompt fields.
|
||||
nav: Configuration reference
|
||||
order: 71
|
||||
category: Hub
|
||||
---
|
||||
|
||||
# Hub configuration reference
|
||||
|
||||
Hub accepts YAML in this layout:
|
||||
|
||||
```text
|
||||
.paseo/
|
||||
├── hub.yml
|
||||
└── workflows/
|
||||
├── <workflow>.yml
|
||||
└── partials/
|
||||
└── <partial>.md
|
||||
```
|
||||
|
||||
Only direct `.yml` children of `.paseo/workflows/` are workflows. Each file contains one trigger and its ordered steps. There is no manifest, `includes`, `uses`, reusable step, workflow call, or inheritance.
|
||||
|
||||
## `hub.yml`
|
||||
|
||||
`.paseo/hub.yml` contains named project resources. Names are map keys and are not repeated inside each object.
|
||||
|
||||
```yaml
|
||||
environments:
|
||||
paseo:
|
||||
kind: daemon
|
||||
daemon: laptop
|
||||
cwd: /Users/you/code/paseo
|
||||
hub:
|
||||
kind: daemon
|
||||
daemon: devbox
|
||||
cwd: /workspace/hub
|
||||
|
||||
agents:
|
||||
codex-safe:
|
||||
provider: codex
|
||||
model: gpt-5.5
|
||||
thinkingOptionId: xhigh
|
||||
options:
|
||||
sandbox_workspace_write:
|
||||
writable_roots: [/var/cache/npm]
|
||||
network_access: false
|
||||
claude:
|
||||
provider: claude
|
||||
mode: bypassPermissions
|
||||
```
|
||||
|
||||
The only top-level keys are `environments` and `agents`. A `triggers` key is rejected with a migration error.
|
||||
|
||||
### Environments
|
||||
|
||||
| Field | Required | Notes |
|
||||
| ---------- | ----------- | ------------------------------------------------------------------------------ |
|
||||
| `kind` | yes | `daemon`, `fly`, or `docker`; workflow steps must select a daemon environment. |
|
||||
| `daemon` | daemon only | Registered daemon slug, resolved when the revision activates. |
|
||||
| `cwd` | daemon only | Absolute working directory on the daemon. |
|
||||
| `image` | fly/docker | Image name. |
|
||||
| `worktree` | no | `branch-off`, `checkout-branch`, or `checkout-pr` target. |
|
||||
|
||||
For `worktree`, use `newBranch` and optional `base` with `branch-off`, `branch` with `checkout-branch`, or positive `prNumber` with `checkout-pr`.
|
||||
|
||||
```yaml
|
||||
environments:
|
||||
review:
|
||||
kind: daemon
|
||||
daemon: build-server
|
||||
cwd: /workspace/project
|
||||
worktree:
|
||||
mode: branch-off
|
||||
newBranch: trigger-${{ paseo.execution.id }}
|
||||
base: origin/main
|
||||
```
|
||||
|
||||
`newBranch` is a branch-name string. Embed `${{ paseo.execution.id }}`, which renders the execution's UUID, so every execution branches off `base` on its own branch and keeps it when Hub retries or recovers that execution.
|
||||
|
||||
One execution is one step run, so two steps selecting the same environment get separate branches.
|
||||
|
||||
`${{ paseo.execution.id }}` is the only expression `newBranch` accepts. `paseo.prompt`, `paseo.context`, `paseo.inputs.*`, `values.*`, `steps.<id>.outputs.*`, and provider event fields are unavailable here, and each one fails bundle activation at the authored field, such as `.paseo/hub.yml.environments.review.worktree.newBranch`.
|
||||
|
||||
`${{ paseo.execution.id }}` fails activation the same way anywhere else in a bundle. `branch` and `prNumber` take literal values.
|
||||
|
||||
An environment is a complete named object. A step selects its name; objects are not inherited, merged, or partially overridden.
|
||||
|
||||
### Named agents
|
||||
|
||||
Each agent is one complete provider configuration:
|
||||
|
||||
| Field | Required | Notes |
|
||||
| ------------------ | -------- | ---------------------------------------------------------------------- |
|
||||
| `provider` | yes | Provider ID. Hub runs unattended, so `claude`, `codex`, or `opencode`. |
|
||||
| `model` | no | Provider model ID. |
|
||||
| `mode` | no | Paseo mode ID. |
|
||||
| `thinkingOptionId` | no | Provider thinking option. |
|
||||
| `options` | no | JSON-safe provider-native options, preserving names and nesting. |
|
||||
|
||||
A named selection preserves the complete object, including structured options. Named agents have no parent, patch, or per-step override.
|
||||
|
||||
Hub passes `model`, `mode`, `thinkingOptionId`, and `options` to the Paseo daemon without renaming or flattening provider fields. The selected daemon validates them against its current provider schema when the trigger is saved or deployed, so a value it does not offer is refused then rather than at the first run; Hub does not translate provider-native options. See [Saving checks the agent against the daemon](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon).
|
||||
|
||||
## Workflow files
|
||||
|
||||
`.paseo/workflows/review.yml`:
|
||||
|
||||
```yaml
|
||||
name: review
|
||||
on: manual.run
|
||||
max_runtime: 2h
|
||||
filters:
|
||||
from_users: [automation]
|
||||
inputs:
|
||||
repo:
|
||||
type: string
|
||||
required: true
|
||||
choices: [paseo, hub]
|
||||
steps:
|
||||
- id: inspect
|
||||
environment: ${{ paseo.inputs.repo }}
|
||||
max_runtime: 30m
|
||||
idle_timeout: 5m
|
||||
agent: codex-safe
|
||||
prompt:
|
||||
- text: ${{ paseo.prompt }}
|
||||
```
|
||||
|
||||
| Field | Required | Notes |
|
||||
| ------------- | -------- | --------------------------------------------------------- |
|
||||
| `name` | yes | Workflow name, unique across the bundle. |
|
||||
| `on` | yes | Provider event such as `manual.run` or `discord.mention`. |
|
||||
| `max_runtime` | yes | Hard limit for the complete run, up to 24h. |
|
||||
| `filters` | yes | Provider resource filters and the sender allowlist. |
|
||||
| `inputs` | no | Typed invocation headers. |
|
||||
| `values` | no | Named expressions. |
|
||||
| `steps` | yes | One or more ordered inline steps. |
|
||||
|
||||
### GitHub events and filters
|
||||
|
||||
Use one of these semantic event names for new GitHub workflows:
|
||||
|
||||
| `on` | Matches |
|
||||
| -------------------------------------- | ------------------------------------------------------------------------- |
|
||||
| `github.issue_created` | An `issues` delivery whose action is `opened`. |
|
||||
| `github.pull_request_created` | A `pull_request` delivery whose action is `opened`. |
|
||||
| `github.pull_request_ready_for_review` | A draft pull request is marked ready for review. |
|
||||
| `github.issue_comment_created` | An `issue_comment` delivery whose action is `created`, on an issue. |
|
||||
| `github.pull_request_comment_created` | An `issue_comment` delivery whose action is `created`, on a pull request. |
|
||||
| `github.issue_label_added` | An `issues` delivery whose action is `labeled`. |
|
||||
| `github.pull_request_label_added` | A `pull_request` delivery whose action is `labeled`. |
|
||||
|
||||
Existing configurations may continue to use `github.issues`, `github.issue_comment`, `github.pull_request_review`, `github.pull_request_review_comment`, and `github.push`. These legacy events retain their existing behavior.
|
||||
|
||||
`filters` supports these GitHub fields. `from_users` must be non-empty for every externally sourced workflow. All supplied filters compose with AND.
|
||||
|
||||
| Field | Type | Applies to | Meaning |
|
||||
| ------------ | ----------------------------------- | ------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|
||||
| `from_users` | non-empty list of strings | all GitHub events | GitHub logins allowed to start the workflow. |
|
||||
| `repo` | non-empty string | all GitHub events | Repository in `owner/name` form. |
|
||||
| `connection` | string | all GitHub events | GitHub connection slug. |
|
||||
| `contains` | string | issue, pull-request, and comment events | Substring in the issue or pull-request title plus body, or in the comment body. |
|
||||
| `pattern` | string | issue, pull-request, and comment events | Start of that same text. |
|
||||
| `label` | non-empty string | `github.issue_label_added`, `github.pull_request_label_added` | The label added by the delivery. |
|
||||
| `labels` | non-empty list of non-empty strings | issue, pull-request, and comment events | Every listed label must be currently present on the issue or pull request. |
|
||||
|
||||
`label` and `labels` match GitHub labels case-insensitively. `label` checks the one changed label; `labels` checks the full current label set and requires every entry. For example, `labels: [bug, backend]` requires both `bug` and `backend`.
|
||||
|
||||
Use `label` only with a label-added event. It has no match on other events. Use `labels` to require the item state, including when a comment starts the workflow.
|
||||
|
||||
See [GitHub triggers](/docs/hub/triggers/github) for complete triage, pull-request review, and ready-for-agent workflows.
|
||||
|
||||
### Inputs and values
|
||||
|
||||
Inputs have `type: string | number | boolean`, plus optional `required`, `default`, and `choices`. `required` and `default` cannot be combined. Finite `choices` are required when an input can choose authority such as an environment or named agent.
|
||||
|
||||
Values bind expressions:
|
||||
|
||||
```yaml
|
||||
values:
|
||||
selected_environment: ${{ steps.classify.outputs.environment }}
|
||||
selected_agent: ${{ steps.classify.outputs.agent }}
|
||||
```
|
||||
|
||||
Expressions may read declared `paseo.inputs`, earlier `steps.<id>.outputs`, and `values`. The grammar supports paths, JSON literals, parentheses, `!`, `==`, `!=`, `&&`, `||`, and `??`.
|
||||
|
||||
An environment or dynamic named-agent expression must have a finite set of possible string results at activation. Every result must name a configured resource. Runtime selection never falls back to another environment or agent.
|
||||
|
||||
### Steps
|
||||
|
||||
| Field | Required | Notes |
|
||||
| ----------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
|
||||
| `id` | yes | Unique within the workflow. |
|
||||
| `environment` | yes | Literal environment name or finite expression resolving to one. |
|
||||
| `max_runtime` | yes | Step hard limit. |
|
||||
| `idle_timeout` | yes | Idle limit no longer than `max_runtime`. |
|
||||
| `startup_timeout` | no | Step startup waiting budget. See [startup timeout](/docs/hub/configuration#startup-timeout) for defaults and limits. |
|
||||
| `agent` | yes | Named agent, finite expression selecting a named agent, or complete static inline agent. |
|
||||
| `prompt` | yes | Ordered `text` and `include` blocks. |
|
||||
| `if` | no | Expression deciding whether the step runs. |
|
||||
| `env` | no | Environment variables from connection values. |
|
||||
| `output.schema` | no | JSON Schema for structured step output. |
|
||||
| `allow_outputs` | no | Provider output capabilities with optional `max` and `required`. |
|
||||
| `auto_archive` | no | Archive the agent after the step ends. |
|
||||
| `github` | no | Explicit GitHub authority for this step. |
|
||||
|
||||
An inline agent is static and complete:
|
||||
|
||||
```yaml
|
||||
agent:
|
||||
provider: codex
|
||||
model: gpt-5.5
|
||||
options:
|
||||
approval_policy: never
|
||||
sandbox_mode: read-only
|
||||
```
|
||||
|
||||
An expression-valued `agent` selects a named agent. Dynamic provider fields inside an inline object are rejected.
|
||||
|
||||
### Prompt semantics
|
||||
|
||||
```yaml
|
||||
prompt:
|
||||
- include: partials/review.md
|
||||
- text: |
|
||||
<user-prompt>
|
||||
${{ paseo.prompt }}
|
||||
</user-prompt>
|
||||
```
|
||||
|
||||
`${{ paseo.prompt }}` is the normalized request after the provider marker and declared leading `key=value` inputs are removed. It is not rewritten or augmented with event context.
|
||||
|
||||
`${{ paseo.context }}` opts that step into provider context materialization and renders the result as JSON in the prompt. It is available only in prompt text. Hub does not inject it unless the workflow authors that expression.
|
||||
|
||||
Includes resolve relative to `.paseo/workflows/`, so shared partials use `partials/<name>.md`. Missing files, absolute or traversing paths, symlinks, content mismatches, and files outside the partial tree are rejected.
|
||||
|
||||
### Output capabilities
|
||||
|
||||
Authority stays on the step that uses it:
|
||||
|
||||
```yaml
|
||||
allow_outputs:
|
||||
- type: discord.reply
|
||||
max: 1
|
||||
required: true
|
||||
```
|
||||
|
||||
Slack workflows use `slack.reply`; Discord workflows use `discord.reply`. The declaration grants `hub.reply`, and the prompt must tell the agent to call it. GitHub has no reply output; use an explicit [`github` block](/docs/hub/github).
|
||||
|
||||
Every step receives `hub.finish_execution`. The prompt must tell the agent when to call it; Hub does not append completion or reply instructions. If `output.schema` is present, `hub.finish_execution` requires an `output` value that matches the schema. If an `allow_outputs` entry is `required: true`, the agent must emit that output before finishing. `max` defaults to `1`.
|
||||
|
||||
## Migrating a monolithic file
|
||||
|
||||
Keep `environments` in `hub.yml`, convert the environment list to a named map, and move each former trigger into its own `.paseo/workflows/<name>.yml` file. Move shared prompt files to `.paseo/workflows/partials/`. Define complete named agent configurations under `agents` and replace dynamic provider fields with finite named-agent selection.
|
||||
|
||||
Hub does not read TOML or a monolithic `triggers` section, and the CLI does not rewrite either format.
|
||||
|
||||
See [Workflows](/docs/hub/workflows) for complete routing examples.
|
||||
|
||||
## Agent continuation
|
||||
|
||||
Self-contained dashboard trigger documents accept `run.continuation`:
|
||||
|
||||
| Value | Behavior |
|
||||
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| `{mode: conversation}` | Default. Reuse the project's agent for the event's conversation; create a new agent when the event has no conversation. |
|
||||
| `{mode: key, key: "support-${{ paseo.inputs.ticket }}"}` | Reuse the project's agent for the evaluated custom key. |
|
||||
| `{mode: new}` | Create a new agent for each arrival. |
|
||||
|
||||
Keys use the existing expression syntax and must resolve to a non-empty string of at most 512 characters. Custom keys and provider conversation identities occupy separate namespaces. The same key in different projects does not share an agent.
|
||||
|
||||
An existing session keeps its daemon, agent configuration, target, environment, and tool contracts. Changing those settings for the same key fails with an explanation; choose a different key or **New agent**. Prompts and output destinations belong to each arrival and may change. A worktree branch is chosen when the session is first created and reused on later arrivals.
|
||||
|
||||
A follow-up steers the active agent without extending its runtime deadline or credential expiry. With a `run.github` grant or connection token in `run.env`, follow-ups share the active agent’s credentials. Once all requests finish, Hub revokes leased tokens; the next arrival starts a new agent with fresh credentials. Agents without temporary credentials can be reused after completion.
|
||||
|
||||
### Upgrading
|
||||
|
||||
Upgrade the connected Paseo daemons before enabling the new Hub version. Hub requires the daemon's ordinary agent RPC and request receipt capabilities; an older host produces an actionable dispatch error.
|
||||
|
||||
Hub's database migration adds sessions and nullable execution associations. Existing executions retain their saved launch contract and execution-specific MCP endpoint until they finish. New arrivals for existing self-contained trigger documents use the conversation default. Historical agents are not backfilled into sessions.
|
||||
|
||||
Legacy multi-step workflow bundles keep their existing behavior. Converting one to a self-contained trigger writes `mode: new` explicitly; change it in the editor when ready to reuse agents.
|
||||
@@ -0,0 +1,281 @@
|
||||
---
|
||||
title: Hub 配置参考
|
||||
description: Hub 资源、workflow、Agent、表达式和提示词字段的标准参考。
|
||||
nav: 配置参考
|
||||
---
|
||||
|
||||
# Hub 配置参考 {#hub-configuration-reference}
|
||||
|
||||
Hub 接受以下结构的 YAML:
|
||||
|
||||
```text
|
||||
.paseo/
|
||||
├── hub.yml
|
||||
└── workflows/
|
||||
├── <workflow>.yml
|
||||
└── partials/
|
||||
└── <partial>.md
|
||||
```
|
||||
|
||||
只有 `.paseo/workflows/` 下直接的 `.yml` 子文件才是 workflow。每个文件包含一个触发器及其有序的 step。没有 manifest、`includes`、`uses`、可复用的 step、workflow 调用或继承。
|
||||
|
||||
## `hub.yml` {#hubyml}
|
||||
|
||||
`.paseo/hub.yml` 包含具名的项目资源。名称是映射的键,不会在每个对象内部重复。
|
||||
|
||||
```yaml
|
||||
environments:
|
||||
paseo:
|
||||
kind: daemon
|
||||
daemon: laptop
|
||||
cwd: /Users/you/code/paseo
|
||||
hub:
|
||||
kind: daemon
|
||||
daemon: devbox
|
||||
cwd: /workspace/hub
|
||||
|
||||
agents:
|
||||
codex-safe:
|
||||
provider: codex
|
||||
model: gpt-5.5
|
||||
thinkingOptionId: xhigh
|
||||
options:
|
||||
sandbox_workspace_write:
|
||||
writable_roots: [/var/cache/npm]
|
||||
network_access: false
|
||||
claude:
|
||||
provider: claude
|
||||
mode: bypassPermissions
|
||||
```
|
||||
|
||||
顶层只有 `environments` 和 `agents` 两个键。`triggers` 键会被拒绝,并给出迁移错误。
|
||||
|
||||
### 环境 {#environments}
|
||||
|
||||
| 字段 | 是否必填 | 说明 |
|
||||
| ---------- | ---------- | -------------------------------------------------------------------- |
|
||||
| `kind` | 是 | `daemon`、`fly` 或 `docker`;workflow 的 step 必须选择 daemon 环境。 |
|
||||
| `daemon` | 仅 daemon | 已注册的 daemon slug,在修订激活时解析。 |
|
||||
| `cwd` | 仅 daemon | daemon 上的绝对工作目录。 |
|
||||
| `image` | fly/docker | 镜像名称。 |
|
||||
| `worktree` | 否 | `branch-off`、`checkout-branch` 或 `checkout-pr` 目标。 |
|
||||
|
||||
对于 `worktree`,`branch-off` 使用 `newBranch` 和可选的 `base`,`checkout-branch` 使用 `branch`,`checkout-pr` 使用正整数 `prNumber`。
|
||||
|
||||
```yaml
|
||||
environments:
|
||||
review:
|
||||
kind: daemon
|
||||
daemon: build-server
|
||||
cwd: /workspace/project
|
||||
worktree:
|
||||
mode: branch-off
|
||||
newBranch: trigger-${{ paseo.execution.id }}
|
||||
base: origin/main
|
||||
```
|
||||
|
||||
`newBranch` 是一个分支名字符串。在其中嵌入 `${{ paseo.execution.id }}`,它会渲染为该次执行的 UUID,这样每次执行都会从 `base` 分出自己的分支,并在 Hub 重试或恢复该执行时保留这个分支。
|
||||
|
||||
一次执行就是一次 step 运行,因此选择同一环境的两个 step 会得到各自独立的分支。
|
||||
|
||||
`${{ paseo.execution.id }}` 是 `newBranch` 唯一接受的表达式。`paseo.prompt`、`paseo.context`、`paseo.inputs.*`、`values.*`、`steps.<id>.outputs.*` 以及 Provider 事件字段在这里都不可用,任何一个都会在编写它的字段处导致文件包激活失败,例如 `.paseo/hub.yml.environments.review.worktree.newBranch`。
|
||||
|
||||
`${{ paseo.execution.id }}` 出现在文件包中其他任何位置时,同样会导致激活失败。`branch` 和 `prNumber` 只接受字面值。
|
||||
|
||||
环境是一个完整的具名对象。step 选择它的名称;对象不会被继承、合并或部分覆盖。
|
||||
|
||||
### 具名 Agent {#named-agents}
|
||||
|
||||
每个 Agent 是一份完整的 Provider 配置:
|
||||
|
||||
| 字段 | 是否必填 | 说明 |
|
||||
| ------------------ | -------- | --------------------------------------------------------------------------------- |
|
||||
| `provider` | 是 | Provider ID。Hub 在无人值守的情况下运行,因此为 `claude`、`codex` 或 `opencode`。 |
|
||||
| `model` | 否 | Provider 的模型 ID。 |
|
||||
| `mode` | 否 | Paseo 模式 ID。 |
|
||||
| `thinkingOptionId` | 否 | Provider 的思考选项。 |
|
||||
| `options` | 否 | 可安全序列化为 JSON 的 Provider 原生选项,保留名称和嵌套结构。 |
|
||||
|
||||
具名选择会保留完整的对象,包括结构化的选项。具名 Agent 没有父级、补丁或按 step 的覆盖。
|
||||
|
||||
Hub 把 `model`、`mode`、`thinkingOptionId` 和 `options` 传给 Paseo daemon,不会重命名或展平 Provider 字段。保存或部署触发器时,所选的 daemon 会按它当前的 Provider schema 校验这些值,因此它不提供的值会在那时被拒绝,而不是等到第一次运行;Hub 不会转换 Provider 原生选项。见[保存时会对照 daemon 检查 Agent](/docs/hub/triggers#saving-checks-the-agent-against-the-daemon)。
|
||||
|
||||
## workflow 文件 {#workflow-files}
|
||||
|
||||
`.paseo/workflows/review.yml`:
|
||||
|
||||
```yaml
|
||||
name: review
|
||||
on: manual.run
|
||||
max_runtime: 2h
|
||||
filters:
|
||||
from_users: [automation]
|
||||
inputs:
|
||||
repo:
|
||||
type: string
|
||||
required: true
|
||||
choices: [paseo, hub]
|
||||
steps:
|
||||
- id: inspect
|
||||
environment: ${{ paseo.inputs.repo }}
|
||||
max_runtime: 30m
|
||||
idle_timeout: 5m
|
||||
agent: codex-safe
|
||||
prompt:
|
||||
- text: ${{ paseo.prompt }}
|
||||
```
|
||||
|
||||
| 字段 | 是否必填 | 说明 |
|
||||
| ------------- | -------- | ------------------------------------------------------- |
|
||||
| `name` | 是 | workflow 名称,在整个文件包中唯一。 |
|
||||
| `on` | 是 | Provider 事件,例如 `manual.run` 或 `discord.mention`。 |
|
||||
| `max_runtime` | 是 | 整次运行的硬性时间上限,最多 24h。 |
|
||||
| `filters` | 是 | Provider 资源过滤条件和发送者白名单。 |
|
||||
| `inputs` | 否 | 带类型的调用头部参数。 |
|
||||
| `values` | 否 | 具名表达式。 |
|
||||
| `steps` | 是 | 一个或多个有序的内联 step。 |
|
||||
|
||||
### GitHub 事件和过滤条件 {#github-events-and-filters}
|
||||
|
||||
新的 GitHub workflow 请使用以下语义化事件名之一:
|
||||
|
||||
| `on` | 匹配 |
|
||||
| -------------------------------------- | ----------------------------------------------------------------- |
|
||||
| `github.issue_created` | action 为 `opened` 的 `issues` 投递。 |
|
||||
| `github.pull_request_created` | action 为 `opened` 的 `pull_request` 投递。 |
|
||||
| `github.pull_request_ready_for_review` | 草稿 PR 被标记为可审查。 |
|
||||
| `github.issue_comment_created` | 在 issue 上、action 为 `created` 的 `issue_comment` 投递。 |
|
||||
| `github.pull_request_comment_created` | 在 Pull Request 上、action 为 `created` 的 `issue_comment` 投递。 |
|
||||
| `github.issue_label_added` | action 为 `labeled` 的 `issues` 投递。 |
|
||||
| `github.pull_request_label_added` | action 为 `labeled` 的 `pull_request` 投递。 |
|
||||
|
||||
已有的配置可以继续使用 `github.issues`、`github.issue_comment`、`github.pull_request_review`、`github.pull_request_review_comment` 和 `github.push`。这些旧版事件保持原有的行为。
|
||||
|
||||
`filters` 支持以下 GitHub 字段。对于每个由外部来源触发的 workflow,`from_users` 都必须非空。所有提供的过滤条件以 AND 组合。
|
||||
|
||||
| 字段 | 类型 | 适用于 | 含义 |
|
||||
| ------------ | -------------------------- | ------------------------------------------------------------- | ---------------------------------------------------------- |
|
||||
| `from_users` | 非空字符串列表 | 所有 GitHub 事件 | 允许启动该 workflow 的 GitHub 登录名。 |
|
||||
| `repo` | 非空字符串 | 所有 GitHub 事件 | `owner/name` 形式的仓库。 |
|
||||
| `connection` | 字符串 | 所有 GitHub 事件 | GitHub 连接的 slug。 |
|
||||
| `contains` | 字符串 | issue、Pull Request 和评论事件 | issue 或 Pull Request 的标题加正文中,或评论正文中的子串。 |
|
||||
| `pattern` | 字符串 | issue、Pull Request 和评论事件 | 同一段文本的开头。 |
|
||||
| `label` | 非空字符串 | `github.issue_label_added`、`github.pull_request_label_added` | 本次投递添加的标签。 |
|
||||
| `labels` | 由非空字符串组成的非空列表 | issue、Pull Request 和评论事件 | 每个所列标签都必须当前存在于该 issue 或 Pull Request 上。 |
|
||||
|
||||
`label` 和 `labels` 匹配 GitHub 标签时不区分大小写。`label` 检查发生变化的那一个标签;`labels` 检查当前完整的标签集合,并要求每一项都存在。例如,`labels: [bug, backend]` 要求同时存在 `bug` 和 `backend`。
|
||||
|
||||
`label` 只能与添加标签的事件一起使用,在其他事件上永远不会匹配。使用 `labels` 来要求条目所处的状态,包括由评论启动 workflow 的情况。
|
||||
|
||||
完整的分拣、Pull Request 审查和 ready-for-agent workflow,见 [GitHub 触发器](/docs/hub/triggers/github)。
|
||||
|
||||
### 输入和值 {#inputs-and-values}
|
||||
|
||||
输入的类型为 `type: string | number | boolean`,另有可选的 `required`、`default` 和 `choices`。`required` 和 `default` 不能同时使用。当某个输入可以选择权限相关的对象(例如环境或具名 Agent)时,必须提供有限的 `choices`。
|
||||
|
||||
值用于绑定表达式:
|
||||
|
||||
```yaml
|
||||
values:
|
||||
selected_environment: ${{ steps.classify.outputs.environment }}
|
||||
selected_agent: ${{ steps.classify.outputs.agent }}
|
||||
```
|
||||
|
||||
表达式可以读取已声明的 `paseo.inputs`、之前的 `steps.<id>.outputs` 以及 `values`。语法支持路径、JSON 字面量、括号、`!`、`==`、`!=`、`&&`、`||` 和 `??`。
|
||||
|
||||
用于选择环境或动态具名 Agent 的表达式,在激活时必须具有一个有限的、可能的字符串结果集合。每个结果都必须是一个已配置资源的名称。运行时的选择从不会退回到其他环境或 Agent。
|
||||
|
||||
### step {#steps}
|
||||
|
||||
| 字段 | 是否必填 | 说明 |
|
||||
| ----------------- | -------- | ---------------------------------------------------------------------------------------- |
|
||||
| `id` | 是 | 在 workflow 内唯一。 |
|
||||
| `environment` | 是 | 字面的环境名称,或解析为某个环境名称的有限表达式。 |
|
||||
| `max_runtime` | 是 | step 的硬性时间上限。 |
|
||||
| `idle_timeout` | 是 | 空闲时间上限,不得超过 `max_runtime`。 |
|
||||
| `startup_timeout` | 否 | step 启动的等待预算。默认值和限制见[启动超时](/docs/hub/configuration#startup-timeout)。 |
|
||||
| `agent` | 是 | 具名 Agent、选择具名 Agent 的有限表达式,或一份完整的静态内联 Agent。 |
|
||||
| `prompt` | 是 | 有序的 `text` 和 `include` 块。 |
|
||||
| `if` | 否 | 决定该 step 是否运行的表达式。 |
|
||||
| `env` | 否 | 来自连接值的环境变量。 |
|
||||
| `output.schema` | 否 | 结构化 step 输出的 JSON Schema。 |
|
||||
| `allow_outputs` | 否 | Provider 输出能力,可带 `max` 和 `required`。 |
|
||||
| `auto_archive` | 否 | step 结束后归档该 Agent。 |
|
||||
| `github` | 否 | 该 step 的显式 GitHub 权限。 |
|
||||
|
||||
内联 Agent 是静态且完整的:
|
||||
|
||||
```yaml
|
||||
agent:
|
||||
provider: codex
|
||||
model: gpt-5.5
|
||||
options:
|
||||
approval_policy: never
|
||||
sandbox_mode: read-only
|
||||
```
|
||||
|
||||
表达式形式的 `agent` 用于选择具名 Agent。内联对象中的动态 Provider 字段会被拒绝。
|
||||
|
||||
### 提示词语义 {#prompt-semantics}
|
||||
|
||||
```yaml
|
||||
prompt:
|
||||
- include: partials/review.md
|
||||
- text: |
|
||||
<user-prompt>
|
||||
${{ paseo.prompt }}
|
||||
</user-prompt>
|
||||
```
|
||||
|
||||
`${{ paseo.prompt }}` 是去掉 Provider 标记和已声明的开头 `key=value` 输入之后的规范化请求。它不会被改写,也不会附加事件上下文。
|
||||
|
||||
`${{ paseo.context }}` 让该 step 选择加入 Provider 上下文的具体化,并在提示词中把结果渲染为 JSON。它只能用在提示词文本中。除非 workflow 编写了这个表达式,否则 Hub 不会注入它。
|
||||
|
||||
include 相对于 `.paseo/workflows/` 解析,因此共享片段使用 `partials/<name>.md`。缺失的文件、绝对路径或越界路径、符号链接、内容不一致以及位于片段目录树之外的文件都会被拒绝。
|
||||
|
||||
### 输出能力 {#output-capabilities}
|
||||
|
||||
权限保留在使用它的 step 上:
|
||||
|
||||
```yaml
|
||||
allow_outputs:
|
||||
- type: discord.reply
|
||||
max: 1
|
||||
required: true
|
||||
```
|
||||
|
||||
Slack workflow 使用 `slack.reply`;Discord workflow 使用 `discord.reply`。这项声明授予 `hub.reply`,提示词必须告诉 Agent 调用它。GitHub 没有回复输出;请使用显式的 [`github` 块](/docs/hub/github)。
|
||||
|
||||
每个 step 都会获得 `hub.finish_execution`。提示词必须告诉 Agent 何时调用它;Hub 不会追加完成或回复的指示。如果存在 `output.schema`,`hub.finish_execution` 需要一个与该 schema 匹配的 `output` 值。如果某个 `allow_outputs` 条目为 `required: true`,Agent 必须在完成之前发出该输出。`max` 默认为 `1`。
|
||||
|
||||
## 迁移单体文件 {#migrating-a-monolithic-file}
|
||||
|
||||
把 `environments` 保留在 `hub.yml` 中,把环境列表转换为具名映射,并把原先的每个触发器移到它自己的 `.paseo/workflows/<name>.yml` 文件中。把共享的提示词文件移到 `.paseo/workflows/partials/`。在 `agents` 下定义完整的具名 Agent 配置,并用有限的具名 Agent 选择替换动态的 Provider 字段。
|
||||
|
||||
Hub 不读取 TOML 或单体的 `triggers` 部分,CLI 也不会改写这两种格式。
|
||||
|
||||
完整的路由示例见 [workflow](/docs/hub/workflows)。
|
||||
|
||||
## Agent 延续 {#agent-continuation}
|
||||
|
||||
自包含的控制台触发器文档接受 `run.continuation`:
|
||||
|
||||
| 值 | 行为 |
|
||||
| -------------------------------------------------------- | -------------------------------------------------------------------------- |
|
||||
| `{mode: conversation}` | 默认值。为事件所属的对话复用项目中的 Agent;事件没有对话时创建新的 Agent。 |
|
||||
| `{mode: key, key: "support-${{ paseo.inputs.ticket }}"}` | 为求值得到的自定义键复用项目中的 Agent。 |
|
||||
| `{mode: new}` | 每次到达都创建新的 Agent。 |
|
||||
|
||||
键使用现有的表达式语法,必须解析为长度不超过 512 个字符的非空字符串。自定义键和 Provider 的对话标识位于不同的命名空间。不同项目中的相同键不会共享 Agent。
|
||||
|
||||
已有的会话会保留它的 daemon、Agent 配置、目标、环境和工具契约。为同一个键修改这些设置会失败并给出说明;请选择另一个键或 **New agent**。提示词和输出目标属于每次到达,可以变化。worktree 分支在会话首次创建时选定,并在之后的到达中复用。
|
||||
|
||||
后续消息会引导正在运行的 Agent,但不会延长它的运行截止时间或凭据有效期。当 `run.env` 中有 `run.github` 授权或连接令牌时,后续消息共享正在运行的 Agent 的凭据。所有请求都完成后,Hub 会撤销租用的令牌;下一次到达会用新的凭据启动新的 Agent。没有临时凭据的 Agent 在完成后可以被复用。
|
||||
|
||||
### 升级 {#upgrading}
|
||||
|
||||
在启用新版 Hub 之前,请先升级已连接的 Paseo daemon。Hub 需要 daemon 的常规 Agent RPC 和请求回执能力;较旧的主机会产生一个可操作的发起错误。
|
||||
|
||||
Hub 的数据库迁移会添加会话以及可为空的执行关联。已有的执行会保留它们已保存的启动契约和执行专属的 MCP 端点,直到完成。已有自包含触发器文档的新到达使用对话默认值。历史上的 Agent 不会被回填到会话中。
|
||||
|
||||
旧版的多 step workflow 文件包保持原有行为。把它转换为自包含触发器时,会显式写入 `mode: new`;准备好复用 Agent 时,在编辑器中修改它。
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
title: Hub configuration
|
||||
description: Author, validate, and deploy self-contained triggers from your repository with the Paseo CLI.
|
||||
description: Generate, edit, and deploy organization triggers from your repository.
|
||||
nav: Configuration
|
||||
order: 73
|
||||
order: 70
|
||||
category: Hub
|
||||
---
|
||||
|
||||
# Hub configuration
|
||||
|
||||
Each Hub trigger is one self-contained YAML file. Edit triggers in the Hub dashboard under **Triggers**, or keep them in your repository and deploy them with `paseo hub deploy`:
|
||||
Each organization trigger is one self-contained YAML file. Keep triggers in your repository and deploy them with `paseo hub deploy`:
|
||||
|
||||
```text
|
||||
.paseo/
|
||||
@@ -16,13 +16,11 @@ Each Hub trigger is one self-contained YAML file. Edit triggers in the Hub dashb
|
||||
└── <trigger>.yml
|
||||
```
|
||||
|
||||
See the [Trigger YAML reference](/docs/hub/configuration/reference) for every supported field.
|
||||
|
||||
## Generated starter trigger
|
||||
|
||||
Run `paseo hub init` from the repository where the agent will work. Setup connects your daemon if needed, lets you choose a ready integration and an available agent runtime from that daemon, asks which user can trigger the bot, validates the result, and writes one starter file. It then asks whether to deploy.
|
||||
Run `paseo hub init` from the repository the agent should work in. Setup selects an app connection and an available agent runtime, asks which user may trigger it, validates the result, and writes one file. It then asks whether to deploy. Interactive `paseo hub login` connects the daemon and points to this command; it does not write trigger files.
|
||||
|
||||
For a Slack integration named `my-team`, setup generates:
|
||||
For a Slack connection named `my-team`, the generated document looks like this:
|
||||
|
||||
```yaml
|
||||
# .paseo/triggers/slack-help.yml
|
||||
@@ -58,34 +56,30 @@ run:
|
||||
required: true
|
||||
```
|
||||
|
||||
`connection` is the integration slug in your organization. `target.daemon` is your connected daemon's slug and `target.cwd` is the absolute repository path. `agent` carries the provider, model, and mode selected from that daemon.
|
||||
`connection` is the app connection's slug in your organization. `target.daemon` is the connected daemon's slug and `target.cwd` is the absolute directory where you ran setup. `agent` contains the provider, model, and execution mode you selected from the daemon. The mode is required.
|
||||
|
||||
`continuation.mode: conversation` keeps follow-up mentions in the same thread on the same agent. The prompt instructs the agent to reply and call `finish_execution` because replying alone does not end the run.
|
||||
`continuation.mode: conversation` keeps follow-ups in the same provider conversation on the same agent. The prompt asks the agent to reply and then call `hub.finish_execution`; replying alone does not finish the execution.
|
||||
|
||||
A Discord starter uses `discord.mention`, your Discord user ID, and `discord.reply`. A GitHub starter uses `github.issue_comment`, scopes `repo` to the current GitHub remote, and requires both `@paseo` and your GitHub username.
|
||||
A Discord starter uses `discord.mention`, your Discord user ID, and `discord.reply`. A GitHub starter uses `github.issue_comment`, restricts the repository to the current GitHub remote, and requires both `@paseo` and your GitHub username. GitHub's starter has no explicit reply output declaration.
|
||||
|
||||
Setup asks before replacing an existing starter file and leaves other trigger files untouched. Read [Hub security](/docs/hub/security) before widening `from_users` or agent authority.
|
||||
Setup asks before replacing the selected trigger file. It preserves other triggers and any existing legacy bundle. Read [Hub security](/docs/hub/security) before widening `from_users` or the agent's authority.
|
||||
|
||||
## Startup timeout
|
||||
|
||||
Hub waits up to 2 minutes by default for an agent to start, including worktree creation, provider startup, and initial prompt acceptance. On a slower machine or large repository, set `run.startup_timeout`:
|
||||
Hub waits up to **two minutes** for agent startup, including worktree creation, provider startup, and initial prompt acceptance. For a slower machine, set `run.startup_timeout` in the trigger YAML:
|
||||
|
||||
```yaml
|
||||
name: inspect
|
||||
on:
|
||||
manual.run: {}
|
||||
run:
|
||||
target:
|
||||
daemon: devbox
|
||||
cwd: /workspace/project
|
||||
agent:
|
||||
provider: codex
|
||||
mode: full-access
|
||||
target: { daemon: devbox, cwd: /workspace/project }
|
||||
agent: { provider: codex, mode: full-access }
|
||||
startup_timeout: 5m
|
||||
prompt: Inspect this repository and summarize its current state. Call finish_execution when done.
|
||||
prompt: Inspect this repository and summarize its current state.
|
||||
```
|
||||
|
||||
Use a positive duration in `ms`, `s`, `m`, or `h`, up to `24h`. `max_runtime` and `idle_timeout` still apply during startup and can expire sooner.
|
||||
Use a positive duration in `ms`, `s`, `m`, or `h`, up to `24h`. Omitting the field uses `2m`. The existing `max_runtime` and `idle_timeout` limits still apply during startup and can expire sooner. This setting changes Hub's waiting budget; provider-specific timeouts remain in effect.
|
||||
|
||||
## Deploy from the CLI
|
||||
|
||||
@@ -97,25 +91,57 @@ paseo hub deploy --dry-run
|
||||
paseo hub deploy
|
||||
```
|
||||
|
||||
Both commands read every direct `.paseo/triggers/*.yml` file in deterministic path order. The CLI rejects nested directories, `.yaml` extensions, symlinks, and unreadable files, and does not search parent directories.
|
||||
Both deploy commands discover direct `.paseo/triggers/*.yml` files in deterministic path order. The CLI rejects nested files, `.yaml` extensions, symlinked trigger paths, and unreadable files. It does not search parent directories.
|
||||
|
||||
`--dry-run` validates every file against Hub and your connected daemons without writing revisions. `paseo hub deploy` validates all files first, then installs each trigger by its YAML `name`.
|
||||
|
||||
If a later trigger fails to install, the error lists the files already installed. Redeploying an existing webhook trigger name preserves its webhook URL and secret.
|
||||
Dry-run validates each document against Hub without storing a revision. Deployment validates all documents first, then installs them one at a time through the organization trigger API. Installation creates or updates a trigger by its YAML `name`. If a later install fails, the error lists the files already installed; those revisions remain active. Errors name paths without printing file contents or credentials.
|
||||
|
||||
Origin precedence:
|
||||
|
||||
1. Explicit command origin or `--hub`
|
||||
1. `--hub`
|
||||
2. `PASEO_HUB_URL`
|
||||
3. Active stored CLI login
|
||||
3. Active stored login
|
||||
4. `https://hub.paseo.sh`
|
||||
|
||||
Credential precedence:
|
||||
|
||||
1. `--api-key`
|
||||
2. `PASEO_HUB_API_KEY`
|
||||
3. Stored CLI login for the exact resolved origin
|
||||
3. Stored login for the exact resolved origin
|
||||
|
||||
Flags and environment API keys are never written to disk.
|
||||
Flags and environment keys are not stored. Endpoint and credential behavior is unchanged between deploy and dry-run.
|
||||
|
||||
Next: [Trigger YAML reference](/docs/hub/configuration/reference).
|
||||
## Legacy project bundles
|
||||
|
||||
Existing project bundles use `.paseo/hub.yml`, direct `.paseo/workflows/*.yml` files, and referenced files below `.paseo/workflows/partials/`. `hub.yml` owns named environments and agents; each workflow owns its trigger and ordered steps.
|
||||
|
||||
Select the legacy deployment path explicitly:
|
||||
|
||||
```sh
|
||||
paseo hub deploy --project my-project --dry-run
|
||||
paseo hub deploy --project my-project
|
||||
```
|
||||
|
||||
These commands send the complete bundle through the project configuration API. Dry-run validates without recording or activating a revision. `paseo hub init` does not create or migrate these bundles.
|
||||
|
||||
The following source and revision behavior applies to legacy project bundles.
|
||||
|
||||
## GitHub sync
|
||||
|
||||
A push to the configuration repository's default branch starts a sync:
|
||||
|
||||
1. Hub discovers the canonical bundle at that exact commit.
|
||||
2. It parses every source file and resolves prompt partials.
|
||||
3. It validates named resources, expressions, connections, and daemon availability.
|
||||
4. On success, the new immutable revision becomes active.
|
||||
|
||||
**Sync now** performs the same operation on demand. Failures retain their source path and authored field. A failed sync never replaces the active revision.
|
||||
|
||||
## Revisions and source changes
|
||||
|
||||
Revisions retain the exact authored files needed to inspect or redeploy them. Rolling back activates an earlier revision. The next valid GitHub push activates a new revision again.
|
||||
|
||||
GitHub-backed configuration is read-only in the dashboard. Switching to manual preserves source documents; it does not collapse the bundle into one generated file.
|
||||
|
||||
The configuration repository may differ from repositories named by `filters.repo`. Protect it because changing the bundle can select connections, daemons, working directories, agents, and outputs. See [Hub security](/docs/hub/security).
|
||||
|
||||
Next: the [configuration reference](/docs/hub/configuration/hub-yml) and [workflow examples](/docs/hub/workflows).
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
---
|
||||
title: Hub 配置
|
||||
description: 使用 Paseo CLI 从仓库编写、校验和部署自包含触发器。
|
||||
description: 从你的仓库生成、编辑和部署组织触发器。
|
||||
nav: 配置
|
||||
---
|
||||
|
||||
# Hub 配置 {#hub-configuration}
|
||||
|
||||
每个 Hub 触发器都是一个自包含的 YAML 文件。你可以在 Hub 控制台的 **Triggers** 中编辑触发器,也可以将它们保存在仓库中并用 `paseo hub deploy` 部署:
|
||||
每个组织触发器都是一个自包含的 YAML 文件。把触发器保存在你的仓库中,并用 `paseo hub deploy` 部署:
|
||||
|
||||
```text
|
||||
.paseo/
|
||||
@@ -14,13 +14,11 @@ nav: 配置
|
||||
└── <trigger>.yml
|
||||
```
|
||||
|
||||
所有支持的字段见[触发器 YAML 参考](/docs/hub/configuration/reference)。
|
||||
## 生成的起步触发器 {#generated-starter-trigger}
|
||||
|
||||
## 生成的入门触发器 {#generated-starter-trigger}
|
||||
在 Agent 要工作的仓库中运行 `paseo hub init`。设置流程会选择一个应用连接和一个可用的 Agent 运行时,询问哪个用户可以触发它,校验结果并写入一个文件,然后询问是否部署。交互式的 `paseo hub login` 会连接 daemon 并提示你运行这条命令;它不会写入触发器文件。
|
||||
|
||||
在 Agent 要工作的仓库中运行 `paseo hub init`。设置流程会按需连接 daemon,让你选择就绪的集成和该 daemon 上可用的 Agent 运行时,询问允许触发机器人的用户,校验结果并写入一个入门文件,然后询问是否立即部署。
|
||||
|
||||
对于名为 `my-team` 的 Slack 集成,生成的文档如下:
|
||||
对于名为 `my-team` 的 Slack 连接,生成的文档如下:
|
||||
|
||||
```yaml
|
||||
# .paseo/triggers/slack-help.yml
|
||||
@@ -56,36 +54,32 @@ run:
|
||||
required: true
|
||||
```
|
||||
|
||||
`connection` 是你组织中的集成 slug。`target.daemon` 是已连接 daemon 的 slug,`target.cwd` 是仓库的绝对路径。`agent` 记录从该 daemon 选择的 Provider、模型和模式。
|
||||
`connection` 是应用连接在你组织中的 slug。`target.daemon` 是已连接 daemon 的 slug,`target.cwd` 是你运行设置流程时所在的绝对目录。`agent` 包含你从 daemon 中选择的 Provider、模型和执行模式。模式是必填的。
|
||||
|
||||
`continuation.mode: conversation` 会将同一讨论串中的后续提及保留在同一个 Agent 上。提示词要求 Agent 回复并调用 `finish_execution`,因为仅回复不会结束运行。
|
||||
`continuation.mode: conversation` 让后续请求在同一个 Agent 的同一段 Provider 对话中进行。提示词要求 Agent 先回复,再调用 `hub.finish_execution`;只回复并不会结束执行。
|
||||
|
||||
Discord 入门触发器使用 `discord.mention`、你的 Discord 用户 ID 和 `discord.reply`。GitHub 入门触发器使用 `github.issue_comment`,将 `repo` 限定为当前 GitHub 远程仓库,并同时要求 `@paseo` 和你的 GitHub 用户名。
|
||||
Discord 起步配置使用 `discord.mention`、你的 Discord 用户 ID 和 `discord.reply`。GitHub 起步配置使用 `github.issue_comment`,把仓库限制为当前的 GitHub 远程仓库,并同时要求 `@paseo` 和你的 GitHub 用户名。GitHub 起步配置没有显式的回复输出声明。
|
||||
|
||||
如果入门文件已存在,设置流程会在替换前询问,并保留其他触发器文件。扩大 `from_users` 或 Agent 权限前,请先阅读 [Hub 安全](/docs/hub/security)。
|
||||
设置流程在替换所选的触发器文件之前会先询问。它会保留其他触发器以及任何已有的旧配置包。在扩大 `from_users` 或 Agent 的权限之前,请阅读 [Hub 安全](/docs/hub/security)。
|
||||
|
||||
## 启动超时 {#startup-timeout}
|
||||
|
||||
Hub 默认最多等待 2 分钟供 Agent 启动,包括创建 worktree、启动 Provider 和接受初始提示词。对于较慢的机器或大型仓库,可以设置 `run.startup_timeout`:
|
||||
Hub 最多等待 **两分钟**让 Agent 启动,包括创建 worktree、启动 Provider 以及接受初始提示词。对于较慢的机器,请在触发器 YAML 中设置 `run.startup_timeout`:
|
||||
|
||||
```yaml
|
||||
name: inspect
|
||||
on:
|
||||
manual.run: {}
|
||||
run:
|
||||
target:
|
||||
daemon: devbox
|
||||
cwd: /workspace/project
|
||||
agent:
|
||||
provider: codex
|
||||
mode: full-access
|
||||
target: { daemon: devbox, cwd: /workspace/project }
|
||||
agent: { provider: codex, mode: full-access }
|
||||
startup_timeout: 5m
|
||||
prompt: Inspect this repository and summarize its current state. Call finish_execution when done.
|
||||
prompt: Inspect this repository and summarize its current state.
|
||||
```
|
||||
|
||||
使用带单位的正时长(`ms`、`s`、`m` 或 `h`),最长 `24h`。`max_runtime` 和 `idle_timeout` 在启动阶段同样生效,可能更早到期。
|
||||
使用以 `ms`、`s`、`m` 或 `h` 为单位的正数时长,最长 `24h`。省略该字段时使用 `2m`。已有的 `max_runtime` 和 `idle_timeout` 限制在启动期间仍然适用,并且可能更早到期。这个设置改变的是 Hub 的等待预算;Provider 自己的超时设置仍然有效。
|
||||
|
||||
## 从 CLI 部署 {#deploy-from-the-cli}
|
||||
## 通过 CLI 部署 {#deploy-from-the-cli}
|
||||
|
||||
在仓库根目录运行:
|
||||
|
||||
@@ -95,25 +89,57 @@ paseo hub deploy --dry-run
|
||||
paseo hub deploy
|
||||
```
|
||||
|
||||
两个命令都会按确定的路径顺序读取直接位于 `.paseo/triggers/*.yml` 下的文件。CLI 会拒绝嵌套目录、`.yaml` 扩展名、符号链接和不可读文件,并且不会向上搜索父目录。
|
||||
两条部署命令都会按确定的路径顺序发现直接位于 `.paseo/triggers/*.yml` 的文件。CLI 会拒绝嵌套的文件、`.yaml` 扩展名、符号链接的触发器路径以及无法读取的文件。它不会搜索上级目录。
|
||||
|
||||
`--dry-run` 会对照 Hub 和已连接的 daemon 校验所有文件,但不写入版本。`paseo hub deploy` 会先校验全部文件,再按 YAML 中的 `name` 逐个安装。
|
||||
dry-run 会让 Hub 校验每个文档,但不保存版本。部署会先校验所有文档,然后通过组织触发器 API 逐个安装。安装会按 YAML 中的 `name` 创建或更新触发器。如果之后的某次安装失败,错误信息会列出已经安装的文件;这些版本仍然生效。错误信息只给出路径,不会打印文件内容或凭据。
|
||||
|
||||
如果后面的触发器安装失败,错误信息会列出已成功安装的文件。重新部署同名的 webhook 触发器会保留它的 webhook URL 和密钥。
|
||||
地址的优先级:
|
||||
|
||||
地址优先级:
|
||||
|
||||
1. 显式命令地址或 `--hub`
|
||||
1. `--hub`
|
||||
2. `PASEO_HUB_URL`
|
||||
3. 当前已保存的 CLI 登录
|
||||
3. 当前保存的登录
|
||||
4. `https://hub.paseo.sh`
|
||||
|
||||
凭据优先级:
|
||||
凭据的优先级:
|
||||
|
||||
1. `--api-key`
|
||||
2. `PASEO_HUB_API_KEY`
|
||||
3. 与精确解析地址匹配的已保存 CLI 登录
|
||||
3. 与最终解析出的地址完全一致的已保存登录
|
||||
|
||||
命令行标志和环境变量传入的 API 密钥永远不会写入磁盘。
|
||||
参数和环境变量中的密钥不会被保存。端点和凭据的行为在 deploy 和 dry-run 之间完全一致。
|
||||
|
||||
下一步:[触发器 YAML 参考](/docs/hub/configuration/reference)。
|
||||
## 旧版项目配置包 {#legacy-project-bundles}
|
||||
|
||||
现有的项目配置包使用 `.paseo/hub.yml`、直接位于 `.paseo/workflows/*.yml` 的文件,以及 `.paseo/workflows/partials/` 下被引用的文件。`hub.yml` 负责命名环境和 Agent;每个 workflow 负责自己的触发器和有序的 step。
|
||||
|
||||
显式选择旧版部署方式:
|
||||
|
||||
```sh
|
||||
paseo hub deploy --project my-project --dry-run
|
||||
paseo hub deploy --project my-project
|
||||
```
|
||||
|
||||
这些命令会通过项目配置 API 发送完整的配置包。dry-run 只做校验,不会记录或激活版本。`paseo hub init` 不会创建或迁移这些配置包。
|
||||
|
||||
以下关于来源和版本的行为适用于旧版项目配置包。
|
||||
|
||||
## GitHub 同步 {#github-sync}
|
||||
|
||||
向配置仓库的默认分支推送会启动一次同步:
|
||||
|
||||
1. Hub 在该提交中发现标准的配置包。
|
||||
2. 它解析每个源文件并解析提示词片段。
|
||||
3. 它校验命名资源、表达式、连接以及 daemon 的可用性。
|
||||
4. 成功后,新的不可变版本成为生效版本。
|
||||
|
||||
**Sync now** 会按需执行同样的操作。失败信息会保留源路径和编写的字段。同步失败永远不会替换生效版本。
|
||||
|
||||
## 版本与来源变更 {#revisions-and-source-changes}
|
||||
|
||||
版本会保留查看或重新部署所需的完整原始文件。回滚会激活一个更早的版本。下一次有效的 GitHub 推送会再次激活一个新版本。
|
||||
|
||||
基于 GitHub 的配置在控制台中是只读的。切换到手动会保留源文档;它不会把配置包合并成一个生成的文件。
|
||||
|
||||
配置仓库可以不同于 `filters.repo` 中指定的仓库。请保护好它,因为修改配置包可以选择连接、daemon、工作目录、Agent 和输出。参见 [Hub 安全](/docs/hub/security)。
|
||||
|
||||
下一步:[配置参考](/docs/hub/configuration/hub-yml)和 [workflow 示例](/docs/hub/workflows)。
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user