@prestyj/editor 0.7.1

package/dist/tools/write-lower-third.js

@@ -0,0 +1,53 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildLowerThirdAss } from "../core/text-overlay.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const LowerThirdSchema = z.object({
+    primaryText: z.string().min(1).describe("Big text — name / topic."),
+    secondaryText: z.string().optional().describe("Small text — title / role."),
+    startSec: z.number().min(0),
+    durationSec: z.number().positive(),
+    fontName: z.string().optional(),
+    primaryColor: z.string().optional().describe("Hex RRGGBB. Default white."),
+    accentColor: z.string().optional().describe("Outline / shadow color. Default black."),
+    position: z
+        .enum(["bottom-left", "bottom-center", "bottom-right", "top-left", "top-center", "top-right"])
+        .optional(),
+    animation: z.enum(["slide-left", "slide-right", "fade", "none"]).optional(),
+    marginPx: z.number().int().min(0).optional(),
+});
+const WriteLowerThirdParams = z.object({
+    output: z.string().describe("Output .ass file path. Pair with burn_subtitles to render."),
+    width: z
+        .number()
+        .int()
+        .positive()
+        .describe("Canvas width in pixels (1920 horizontal, 1080 vertical)."),
+    height: z.number().int().positive(),
+    items: z.array(LowerThirdSchema).min(1),
+});
+export function createWriteLowerThirdTool(cwd) {
+    return {
+        name: "write_lower_third",
+        description: "Write an .ass file containing one or more animated lower-thirds (name + title chyrons). " +
+            "Animations: slide-left/right, fade, none. Pair with burn_subtitles to bake into the " +
+            "video, or import as a subtitle track for in-NLE styling. ASS is universally supported " +
+            "by ffmpeg's subtitles filter (libass).",
+        parameters: WriteLowerThirdParams,
+        async execute({ output, width, height, items }) {
+            try {
+                const ass = buildLowerThirdAss(items, { width, height });
+                const outAbs = safeOutputPath(cwd, output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, ass, "utf8");
+                return compact({ ok: true, path: outAbs, items: items.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-lower-third.js.map

package/dist/tools/write-lower-third.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-lower-third.js","sourceRoot":"","sources":["../../src/tools/write-lower-third.ts"],"names":[],"mappings":"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"}

package/dist/tools/write-srt.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const WriteSrtParams: z.ZodObject<{
+    output: z.ZodString;
+    cues: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    words: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        text: z.ZodString;
+    }, z.core.$strip>>>;
+    groupSize: z.ZodOptional<z.ZodNumber>;
+    gapSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare function createWriteSrtTool(cwd: string): AgentTool<typeof WriteSrtParams>;
+export {};
+//# sourceMappingURL=write-srt.d.ts.map

package/dist/tools/write-srt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-srt.d.ts","sourceRoot":"","sources":["../../src/tools/write-srt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiBhD,QAAA,MAAM,cAAc;;;;;;;;;;;;;;iBA4BhB,CAAC;AAEL,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,cAAc,CAAC,CA+BhF"}

package/dist/tools/write-srt.js

@@ -0,0 +1,73 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildSrt, buildWordLevelSrt } from "../core/srt.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const CueSchema = z.object({
+    start: z.number().min(0).describe("Cue start in seconds."),
+    end: z.number().positive().describe("Cue end in seconds (must be > start)."),
+    text: z.string().describe("Caption text. Multi-line OK."),
+});
+const WordSchema = z.object({
+    start: z.number().min(0),
+    end: z.number().positive(),
+    text: z.string(),
+});
+const WriteSrtParams = z
+    .object({
+    output: z.string().describe("Output .srt path (relative resolves to cwd)."),
+    cues: z
+        .array(CueSchema)
+        .optional()
+        .describe("Sentence-level cues. Use for long-form sidecar captions."),
+    words: z
+        .array(WordSchema)
+        .optional()
+        .describe("Word-level cues. Use for burned-in vertical captions (TikTok / Reels style)."),
+    groupSize: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe("When using words[], cluster N consecutive words per cue. Default 1."),
+    gapSec: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("When using words[], extend each cue's end up to the next cue's start (closed-caption look). Max gap."),
+})
+    .refine((v) => (v.cues && v.cues.length > 0) || (v.words && v.words.length > 0), {
+    message: "either `cues` or `words` must be provided",
+});
+export function createWriteSrtTool(cwd) {
+    return {
+        name: "write_srt",
+        description: "Write a SubRip (.srt) caption file from a list of cues. Pair with transcribe → " +
+            "import_subtitles to caption a video end-to-end. Captions are non-negotiable for " +
+            "short-form (most viewers watch muted).",
+        parameters: WriteSrtParams,
+        async execute({ output, cues, words, groupSize, gapSec }) {
+            try {
+                const text = words ? buildWordLevelSrt(words, { groupSize, gapSec }) : buildSrt(cues);
+                if (!text) {
+                    return err("no usable cues (all empty / invalid)", "ensure at least one cue has non-empty text and end > start");
+                }
+                const abs = safeOutputPath(cwd, output);
+                mkdirSync(dirname(abs), { recursive: true });
+                writeFileSync(abs, text, "utf8");
+                return compact({
+                    ok: true,
+                    path: abs,
+                    cues: words ? Math.ceil(words.length / (groupSize ?? 1)) : cues.length,
+                    ...(words ? { mode: "word-level" } : {}),
+                });
+            }
+            catch (e) {
+                return err(e.message, "verify cue end > start and text not empty");
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-srt.js.map

package/dist/tools/write-srt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-srt.js","sourceRoot":"","sources":["../../src/tools/write-srt.ts"],"names":[],"mappings":"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"}

package/dist/tools/write-title-card.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import type { AgentTool } from "@prestyj/agent";
+declare const WriteTitleCardParams: z.ZodObject<{
+    output: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    items: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        startSec: z.ZodNumber;
+        durationSec: z.ZodNumber;
+        fontName: z.ZodOptional<z.ZodString>;
+        fontSize: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        alignment: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>, z.ZodLiteral<5>, z.ZodLiteral<6>, z.ZodLiteral<7>, z.ZodLiteral<8>, z.ZodLiteral<9>]>>;
+        animation: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            "zoom-in": "zoom-in";
+            "fade-in-out": "fade-in-out";
+            "type-on": "type-on";
+        }>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function createWriteTitleCardTool(cwd: string): AgentTool<typeof WriteTitleCardParams>;
+export {};
+//# sourceMappingURL=write-title-card.d.ts.map

package/dist/tools/write-title-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-title-card.d.ts","sourceRoot":"","sources":["../../src/tools/write-title-card.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA6BhD,QAAA,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAKxB,CAAC;AAEH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAqB5F"}

package/dist/tools/write-title-card.js

@@ -0,0 +1,58 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { compact, err } from "../core/format.js";
+import { buildTitleCardAss } from "../core/text-overlay.js";
+import { safeOutputPath } from "../core/safe-paths.js";
+const TitleCardSchema = z.object({
+    text: z.string().min(1),
+    startSec: z.number().min(0),
+    durationSec: z.number().positive(),
+    fontName: z.string().optional(),
+    fontSize: z.number().int().positive().optional(),
+    color: z.string().optional().describe("Hex RRGGBB."),
+    alignment: z
+        .union([
+        z.literal(1),
+        z.literal(2),
+        z.literal(3),
+        z.literal(4),
+        z.literal(5),
+        z.literal(6),
+        z.literal(7),
+        z.literal(8),
+        z.literal(9),
+    ])
+        .optional()
+        .describe("Numpad alignment. 5 = centre, 8 = top-centre, 2 = bottom-centre."),
+    animation: z.enum(["fade-in-out", "zoom-in", "type-on", "none"]).optional(),
+});
+const WriteTitleCardParams = z.object({
+    output: z.string().describe("Output .ass file path."),
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    items: z.array(TitleCardSchema).min(1),
+});
+export function createWriteTitleCardTool(cwd) {
+    return {
+        name: "write_title_card",
+        description: "Write an .ass file containing one or more big-type title cards (chapter cards, " +
+            "intro / outro slides, callouts). Animations: fade-in-out, zoom-in, type-on, none. " +
+            "Pair with burn_subtitles to render, or import as a subtitle track. Use this for " +
+            "section breaks; use write_lower_third for name/role chyrons.",
+        parameters: WriteTitleCardParams,
+        async execute({ output, width, height, items }) {
+            try {
+                const ass = buildTitleCardAss(items, { width, height });
+                const outAbs = safeOutputPath(cwd, output);
+                mkdirSync(dirname(outAbs), { recursive: true });
+                writeFileSync(outAbs, ass, "utf8");
+                return compact({ ok: true, path: outAbs, items: items.length });
+            }
+            catch (e) {
+                return err(e.message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=write-title-card.js.map

package/dist/tools/write-title-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-title-card.js","sourceRoot":"","sources":["../../src/tools/write-title-card.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export type Frame = number;
+export interface FrameRange {
+    start: Frame;
+    end: Frame;
+}
+export interface ClipInfo {
+    id: string;
+    track: number;
+    trackKind: "video" | "audio";
+    startFrame: Frame;
+    endFrame: Frame;
+    name: string;
+    sourcePath?: string;
+}
+export interface MarkerInfo {
+    frame: Frame;
+    note: string;
+    /**
+     * Color may be a name (Resolve: "Blue", "Red", ...) or a numeric index
+     * (Premiere: 0..7 mapping to green/red/purple/orange/yellow/white/blue/cyan).
+     * Tools that filter by color accept either form.
+     */
+    color?: string | number;
+    durationFrames?: number;
+}
+export interface TimelineState {
+    name: string;
+    frameRate: number;
+    durationFrames: Frame;
+    clips: ClipInfo[];
+    markers: MarkerInfo[];
+}
+/**
+ * Which scripting runtime an adapter is using to talk to the host. Useful for
+ * surfacing deprecation notices (Adobe CEP / ExtendScript end Sept 2026) and
+ * routing version-sensitive ops.
+ *
+ *   - 'uxp'        Adobe UXP plugin (Premiere 25.6+) — the only forward path.
+ *   - 'cep'        Adobe CEP / ExtendScript panel — deprecated, EOL Sept 2026.
+ *   - 'osascript'  macOS AppleScript → ExtendScript fallback. Same EOL.
+ *   - 'native'     Direct API (Resolve Python bridge) — not deprecated.
+ */
+export type HostRuntime = "uxp" | "cep" | "osascript" | "native";
+export interface HostCapabilities {
+    /** Can clips be moved on the timeline (not only appended)? */
+    canMoveClips: boolean;
+    /** Can color grades / nodes be applied via script? */
+    canScriptColor: boolean;
+    /** Can audio mixer / fades be controlled via script? */
+    canScriptAudio: boolean;
+    /** Can AI features (Magic Mask, Voice Isolation, etc.) be triggered? */
+    canTriggerAI: boolean;
+    /** Preferred timeline interchange format for bulk operations. */
+    preferredImportFormat: "edl" | "fcpxml" | "aaf" | "xml";
+    /** Whether the host is reachable right now (process running, API enabled). */
+    isAvailable: boolean;
+    /** Why a host is unavailable, if relevant. */
+    unavailableReason?: string;
+    /**
+     * Active scripting runtime. Resolved lazily — may be undefined before the
+     * first real bridge call (capabilities() probes reachability but doesn't
+     * always commit to a transport).
+     */
+    runtime?: HostRuntime;
+    /**
+     * Free-form deprecation note surfaced to the agent + UI. Set when the active
+     * runtime is on a known sunset path (currently Adobe CEP / ExtendScript,
+     * which Adobe is removing in September 2026).
+     */
+    deprecationNotice?: string;
+}
+export type HostName = "resolve" | "premiere" | "none";
+export interface EditorConfig {
+    /** Forced host, or undefined to auto-detect. */
+    host?: HostName;
+    /** Working directory for media files / EDL output / renders. */
+    cwd: string;
+    /** LLM provider. */
+    provider: "anthropic" | "openai" | "glm" | "moonshot";
+    /** LLM model. */
+    model: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,GAAG,EAAE,KAAK,CAAC;CACZ;AAID,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,KAAK,CAAC;IACtB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAID;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,sDAAsD;IACtD,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,cAAc,EAAE,OAAO,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,qBAAqB,EAAE,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;IACxD,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAID,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAC;IACtD,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Frame & timecode ────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+DAA+D"}

package/dist/ui/App.d.ts

@@ -0,0 +1,56 @@
+import type { Message, Provider } from "@prestyj/ai";
+import type { AgentTool } from "@prestyj/agent";
+import type { LazyHost } from "../core/hosts/lazy.js";
+export interface AppProps {
+    /**
+     * Provider + model + auth — passed straight to useAgentLoop. Avoids needing
+     * a fully-constructed Agent (hook manages its own loop internally).
+     */
+    provider: Provider;
+    model: string;
+    apiKey: string;
+    accountId?: string;
+    /**
+     * Resolve fresh OAuth credentials before each turn (and on 401 retry with
+     * `forceRefresh: true`). Without this, the static `apiKey` above is reused
+     * forever — sessions die when the token expires mid-conversation.
+     * Receives the *current* provider, since the user can swap via /model.
+     */
+    resolveCredentials?: (provider: Provider, opts?: {
+        forceRefresh?: boolean;
+    }) => Promise<{
+        apiKey: string;
+        accountId?: string;
+    }>;
+    tools: AgentTool[];
+    systemPrompt: string;
+    /**
+     * Cached host-independent prompt body. Contains a `{HOST_BLOCK}` sentinel
+     * that the App splices a fresh host block into whenever the live host
+     * changes. Splitting prevents reflowing tens of KB of static workflow
+     * recipes every 3s on the polling tick.
+     */
+    staticPromptBody: string;
+    /**
+     * Lazy host shared with the CLI. Re-detects on demand (cached 2s) so the
+     * polling loop and the agent's tool calls see the same live adapter,
+     * instead of each spawning their own.
+     */
+    host: LazyHost;
+    /** Prior messages for resume; empty array for fresh session. */
+    priorMessages: Message[];
+    hostName: string;
+    hostDisplayName: string;
+    hostAvailable: boolean;
+    hostReason?: string;
+    cwd: string;
+    /** Package version for the banner. */
+    version: string;
+    /** Providers the user has credentials for — used by /model selector. */
+    loggedInProviders: Provider[];
+    /** Persist session for `ezeditor continue` after each completed turn. */
+    persistSessions?: boolean;
+    onShutdown: () => void;
+}
+export declare function App(props: AppProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=App.d.ts.map

package/dist/ui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/ui/App.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAStD,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CACnB,QAAQ,EAAE,QAAQ,EAClB,IAAI,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAC9B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf,gEAAgE;IAChE,aAAa,EAAE,OAAO,EAAE,CAAC;IAEzB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IAE9B,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AA+DD,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,2CA4flC"}