Files
web-alterflixhub/actions/navigate.ts
T
2026-11-01 17:24:44 +07:00

41 lines
1.4 KiB
TypeScript

/**
* Navigate the UI to a view.
*
* Writes a navigate command to application state which the UI reads and auto-deletes.
*
* Usage:
* pnpm action navigate --view=home
* pnpm action navigate --path=/some/route
*
* Options:
* --view View name to navigate to
* --path URL path to navigate to
*/
import { defineAction, fail } from "@agent-native/core/action";
import { writeAppStateForCurrentTab } from "@agent-native/core/application-state";
import { z } from "zod";
export default defineAction({
description:
"Navigate the UI to a specific view or path. Writes a navigate command to application state which the UI reads and auto-deletes. The default product surface is the home canvas at /; agent chat stays in the right rail.",
schema: z.object({
view: z.string().optional().describe("View name to navigate to"),
path: z.string().optional().describe("URL path to navigate to"),
}),
http: false,
run: async (args) => {
if (!args.view && !args.path) {
fail("At least --view or --path is required.", {
errorCode: "navigate_target_required",
});
}
const nav: Record<string, string> = {};
if (args.view) nav.view = args.view;
if (args.path) nav.path = args.path;
nav._writeId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
await writeAppStateForCurrentTab("navigate", nav);
return `Navigating to ${args.view || args.path}`;
},
});