reflex-agent 0.2.1

package/.next/types/validator.ts

@@ -0,0 +1,349 @@
+// This file is generated automatically by Next.js
+// Do not edit this file manually
+// This file validates that all pages and layouts export the correct types
+
+import type { AppRoutes, LayoutRoutes, ParamMap, AppRouteHandlerRoutes } from "./routes.js"
+import type { ResolvingMetadata, ResolvingViewport } from "next/types.js"
+import type { NextRequest } from 'next/server.js'
+
+type AppPageConfig<Route extends AppRoutes = AppRoutes> = {
+  default: React.ComponentType<{ params: Promise<ParamMap[Route]> } & any> | ((props: { params: Promise<ParamMap[Route]> } & any) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type LayoutConfig<Route extends LayoutRoutes = LayoutRoutes> = {
+  default: React.ComponentType<LayoutProps<Route>> | ((props: LayoutProps<Route>) => React.ReactNode | Promise<React.ReactNode> | never | void | Promise<void>)
+  generateStaticParams?: (props: { params: ParamMap[Route] }) => Promise<any[]> | any[]
+  generateMetadata?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingMetadata
+  ) => Promise<any> | any
+  generateViewport?: (
+    props: { params: Promise<ParamMap[Route]> } & any,
+    parent: ResolvingViewport
+  ) => Promise<any> | any
+  metadata?: any
+  viewport?: any
+}
+
+type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRoutes> = {
+  GET?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  POST?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PUT?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  PATCH?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  DELETE?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  HEAD?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+  OPTIONS?: (request: NextRequest, context: { params: Promise<ParamMap[Route]> }) => Promise<Response | void> | Response | void
+}
+
+
+// Validate ../../app/agents/[agentId]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/agents/[agentId]">> = Specific
+  const handler = {} as typeof import("../../app/agents/[agentId]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/audit/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/audit">> = Specific
+  const handler = {} as typeof import("../../app/audit/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/onboarding/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/onboarding">> = Specific
+  const handler = {} as typeof import("../../app/onboarding/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/chat/[topicId]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/[id]/chat/[topicId]">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/chat/[topicId]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/kb/[...slug]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/[id]/kb/[...slug]">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/kb/[...slug]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/[id]">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/workflows/[wfId]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/[id]/workflows/[wfId]">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/workflows/[wfId]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/workflows/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/[id]/workflows">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/workflows/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/new/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/roots/new">> = Specific
+  const handler = {} as typeof import("../../app/roots/new/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/settings/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/settings">> = Specific
+  const handler = {} as typeof import("../../app/settings/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/share/[id]/file/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/share/[id]/file">> = Specific
+  const handler = {} as typeof import("../../app/share/[id]/file/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/share/[id]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/share/[id]">> = Specific
+  const handler = {} as typeof import("../../app/share/[id]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/utilities/[scope]/[id]/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/utilities/[scope]/[id]">> = Specific
+  const handler = {} as typeof import("../../app/utilities/[scope]/[id]/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/utilities/page.tsx
+{
+  type __IsExpected<Specific extends AppPageConfig<"/utilities">> = Specific
+  const handler = {} as typeof import("../../app/utilities/page.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/agents/[agentId]/respond/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agents/[agentId]/respond">> = Specific
+  const handler = {} as typeof import("../../app/api/agents/[agentId]/respond/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/images/[rootId]/[file]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/images/[rootId]/[file]">> = Specific
+  const handler = {} as typeof import("../../app/api/images/[rootId]/[file]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/oauth/callback/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/oauth/callback">> = Specific
+  const handler = {} as typeof import("../../app/api/oauth/callback/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/oauth/start/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/oauth/start">> = Specific
+  const handler = {} as typeof import("../../app/api/oauth/start/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/attachments/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/attachments">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/attachments/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/chat/[topicId]/send/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/chat/[topicId]/send">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/chat/[topicId]/send/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/chat/[topicId]/stop/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/chat/[topicId]/stop">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/chat/[topicId]/stop/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/chat/[topicId]/stream/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/chat/[topicId]/stream">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/chat/[topicId]/stream/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/dashboard/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/dashboard">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/dashboard/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/roots/[id]/suggestions/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/roots/[id]/suggestions">> = Specific
+  const handler = {} as typeof import("../../app/api/roots/[id]/suggestions/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/bundle.js/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/bundle.js">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/bundle.js/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/host-api.mjs/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/host-api.mjs">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/host-api.mjs/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/host-ui.mjs/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/host-ui.mjs">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/host-ui.mjs/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/host/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/host">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/host/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/iframe/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/iframe">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/iframe/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/api/utilities/[scope]/[id]/style.css/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/utilities/[scope]/[id]/style.css">> = Specific
+  const handler = {} as typeof import("../../app/api/utilities/[scope]/[id]/style.css/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+
+
+
+
+// Validate ../../app/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/">> = Specific
+  const handler = {} as typeof import("../../app/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../app/roots/[id]/layout.tsx
+{
+  type __IsExpected<Specific extends LayoutConfig<"/roots/[id]">> = Specific
+  const handler = {} as typeof import("../../app/roots/[id]/layout.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}

package/README.md

@@ -0,0 +1,72 @@
+# Reflex
+
+Local-first knowledge base. You point Reflex at a directory; an agent (Codex via agent-use or Claude Code in agent mode) walks it and materializes a hierarchical `.reflex/` of Markdown files describing what's there. Background watchers keep it fresh, with a debounce floor (≥ 30 min, configurable) so the agent never runs too often. Per-folder chats let you query the KB the same way you'd query ChatGPT/Codex, but scoped to that subdirectory.
+
+## Install
+
+Prerequisites:
+
+- **Node.js 20+** ([nodejs.org](https://nodejs.org/) or via `nvm`/`fnm`/`volta`)
+- **Codex CLI** authenticated — `npm i -g @openai/codex && codex login`
+
+Install Reflex globally:
+
+```sh
+npm i -g reflex-agent
+# or: pnpm add -g reflex-agent
+# or: yarn global add reflex-agent
+```
+
+Then launch the web UI:
+
+```sh
+reflex start            # opens http://localhost:3210 in your browser
+reflex start --port 4000 --no-open
+```
+
+Home page lists registered "Reflex roots". Add a directory via the built-in
+file picker, then click **Run init** on the detail page to have the agent
+build the KB. The left sidebar shows the resulting MD tree under `.reflex/`;
+clicking a file renders it.
+
+## CLI
+
+```sh
+reflex start                  # launch the web UI
+reflex init <dir>             # scaffold .reflex/ and run initial agent pass
+reflex watch <dir>            # watch dir and refresh KB on changes
+reflex chat <dir>             # open a chat scoped to dir's KB
+```
+
+## Develop from source
+
+```sh
+pnpm install
+pnpm dev     # http://localhost:3210 (Next dev server with HMR)
+pnpm build   # produce dist/ + .next/standalone for `reflex start`
+```
+
+## Layout produced
+
+```
+<your-dir>/
+├── .reflexignore            # gitignore-syntax — same rules
+└── .reflex/
+    ├── config.json          # debounce, agent backend, etc.
+    ├── INDEX.md             # description of the whole dir
+    └── <subdir>/
+        ├── INDEX.md         # description of this subdir
+        └── *.md             # topic-structured notes
+```
+
+## Config (`.reflex/config.json`)
+
+```json
+{
+  "watchDebounceMs": 1800000,
+  "agentBackend": "codex",
+  "ignoreFile": ".reflexignore"
+}
+```
+
+`watchDebounceMs` defaults to 30 minutes (`1800000`). You can lower it in `.reflex/config.json` if you want a tighter loop; the only enforced minimum is 1 second (anti-thrash).

package/dist/bin/cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runInit } from "../lib/reflex/commands/init.js";
+import { runWatch } from "../lib/reflex/commands/watch.js";
+import { runChat } from "../lib/reflex/commands/chat.js";
+import { runStart } from "../lib/reflex/commands/start.js";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..", "package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+const program = new Command();
+program
+    .name("reflex")
+    .description("Local-first knowledge base built by an agent.")
+    .version(pkg.version);
+program
+    .command("init")
+    .description("Scaffold .reflex/ and run the initial agent pass over <dir>.")
+    .argument("<dir>", "Project directory")
+    .option("--scaffold-only", "Create .reflex/ and config but skip the agent pass")
+    .action(async (dir, opts) => {
+    await runInit(dir, { scaffoldOnly: !!opts.scaffoldOnly });
+});
+program
+    .command("watch")
+    .description("Watch <dir> and refresh the KB on changes (debounced).")
+    .argument("<dir>", "Project directory")
+    .action(async (dir) => {
+    const handle = await runWatch(dir);
+    const shutdown = async (signal) => {
+        process.stdout.write(`\n[reflex] ${signal} received, stopping…\n`);
+        await handle.stop();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+});
+program
+    .command("chat")
+    .description("Open a chat scoped to <dir>'s knowledge base.")
+    .argument("<dir>", "Folder inside an initialized Reflex root")
+    .action(async (dir) => {
+    await runChat(dir);
+});
+program
+    .command("start")
+    .description("Launch the Reflex web UI on http://localhost:3210.")
+    .option("-p, --port <port>", "Port to listen on", "3210")
+    .option("-h, --host <host>", "Host to bind to", "127.0.0.1")
+    .option("--no-open", "Don't open the browser automatically")
+    .action(async (opts) => {
+    await runStart({ port: Number(opts.port), host: opts.host, open: opts.open });
+});
+program.parseAsync(process.argv).catch((err) => {
+    process.stderr.write(`reflex: ${formatError(err)}\n`);
+    process.exit(1);
+});
+function formatError(err) {
+    if (err instanceof Error) {
+        // zod errors stringify as a JSON array — extract messages.
+        try {
+            const parsed = JSON.parse(err.message);
+            if (Array.isArray(parsed)) {
+                return parsed
+                    .map((e) => {
+                    if (typeof e === "object" && e !== null && "message" in e) {
+                        return String(e.message);
+                    }
+                    return String(e);
+                })
+                    .join("; ");
+            }
+        }
+        catch {
+            // not JSON — fall through
+        }
+        return err.message;
+    }
+    return String(err);
+}
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/lib/reflex/agents/backend.js

@@ -0,0 +1,14 @@
+/**
+ * Agent backend abstraction.
+ *
+ * Keep this interface free of Codex- or Claude-specific types so backends stay
+ * swappable. Reflex calls `analyzeScope` to (re)build KB MDs for a subtree, and
+ * `chat` to open an interactive chat scoped to a folder's KB.
+ */
+export class AgentUnavailableError extends Error {
+    constructor(backendId, cause) {
+        super(`Agent backend "${backendId}" is unavailable: ${cause instanceof Error ? cause.message : String(cause)}`);
+        this.name = "AgentUnavailableError";
+    }
+}
+//# sourceMappingURL=backend.js.map

package/dist/lib/reflex/agents/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../../lib/reflex/agents/backend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmCH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,SAAiB,EAAE,KAAc;QAC3C,KAAK,CACH,kBAAkB,SAAS,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACzG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/lib/reflex/agents/claude-code.js

@@ -0,0 +1,48 @@
+import { execa } from "execa";
+import { promises as fs } from "node:fs";
+import { AgentUnavailableError, } from "./backend.js";
+import { analyzePrompt, chatSystemPrompt } from "./prompts.js";
+const CLI = "claude";
+export const claudeCodeBackend = {
+    id: "claude-code",
+    async analyzeScope(scope) {
+        await ensureCliAvailable();
+        await fs.mkdir(scope.reflexScope, { recursive: true });
+        const prompt = await analyzePrompt(scope);
+        const args = [
+            "-p",
+            prompt,
+            "--permission-mode",
+            "acceptEdits",
+            "--allowedTools",
+            "Read,Write,Edit,LS,Glob,Grep",
+            "--add-dir",
+            scope.reflexScope,
+        ];
+        if (scope.model)
+            args.push("--model", scope.model);
+        // Headless agent run: Claude is allowed to write inside reflexScope and
+        // read from the project root.
+        await execa(CLI, args, {
+            cwd: scope.root,
+            stdio: "inherit",
+        });
+    },
+    async chat(scope) {
+        await ensureCliAvailable();
+        const system = await chatSystemPrompt(scope);
+        await execa(CLI, ["--append-system-prompt", system, "--add-dir", scope.reflexScope], {
+            cwd: scope.scope,
+            stdio: "inherit",
+        });
+    },
+};
+async function ensureCliAvailable() {
+    try {
+        await execa(CLI, ["--version"], { stdio: "ignore" });
+    }
+    catch (err) {
+        throw new AgentUnavailableError("claude-code", err);
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/lib/reflex/agents/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../../lib/reflex/agents/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAIL,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,GAAG,GAAG,QAAQ,CAAC;AAErB,MAAM,CAAC,MAAM,iBAAiB,GAAiB;IAC7C,EAAE,EAAE,aAAa;IAEjB,KAAK,CAAC,YAAY,CAAC,KAAmB;QACpC,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,MAAM;YACN,mBAAmB;YACnB,aAAa;YACb,gBAAgB;YAChB,8BAA8B;YAC9B,WAAW;YACX,KAAK,CAAC,WAAW;SAClB,CAAC;QACF,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,wEAAwE;QACxE,8BAA8B;QAC9B,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE;YACrB,GAAG,EAAE,KAAK,CAAC,IAAI;YACf,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAgB;QACzB,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,CACT,GAAG,EACH,CAAC,wBAAwB,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAClE;YACE,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,KAAK,EAAE,SAAS;SACjB,CACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/lib/reflex/agents/codex.js

@@ -0,0 +1,46 @@
+import { execa } from "execa";
+import { promises as fs } from "node:fs";
+import { AgentUnavailableError, } from "./backend.js";
+import { analyzePrompt, chatSystemPrompt } from "./prompts.js";
+const CLI = "codex";
+export const codexBackend = {
+    id: "codex",
+    async analyzeScope(scope) {
+        await ensureCliAvailable();
+        await fs.mkdir(scope.reflexScope, { recursive: true });
+        const prompt = await analyzePrompt(scope);
+        const args = [
+            "exec",
+            "--cd",
+            scope.root,
+            "--sandbox",
+            "workspace-write",
+            "--add-dir",
+            scope.reflexScope,
+        ];
+        if (scope.model)
+            args.push("--model", scope.model);
+        args.push(prompt);
+        // `codex exec` runs non-interactively. We grant write access to the
+        // reflex scope only; codex defaults to read-only outside its cwd, which we
+        // set to the project root so it can read sources.
+        await execa(CLI, args, { stdio: "inherit" });
+    },
+    async chat(scope) {
+        await ensureCliAvailable();
+        const system = await chatSystemPrompt(scope);
+        await execa(CLI, ["--system", system], {
+            cwd: scope.scope,
+            stdio: "inherit",
+        });
+    },
+};
+async function ensureCliAvailable() {
+    try {
+        await execa(CLI, ["--version"], { stdio: "ignore" });
+    }
+    catch (err) {
+        throw new AgentUnavailableError("codex", err);
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/lib/reflex/agents/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../lib/reflex/agents/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAIL,qBAAqB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,EAAE,EAAE,OAAO;IAEX,KAAK,CAAC,YAAY,CAAC,KAAmB;QACpC,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG;YACX,MAAM;YACN,MAAM;YACN,KAAK,CAAC,IAAI;YACV,WAAW;YACX,iBAAiB;YACjB,WAAW;YACX,KAAK,CAAC,WAAW;SAClB,CAAC;QACF,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClB,oEAAoE;QACpE,2EAA2E;QAC3E,kDAAkD;QAClD,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAgB;QACzB,MAAM,kBAAkB,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE;YACrC,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,KAAK,UAAU,kBAAkB;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,qBAAqB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/lib/reflex/agents/index.js

@@ -0,0 +1,13 @@
+import { claudeCodeBackend } from "./claude-code.js";
+import { codexBackend } from "./codex.js";
+const BACKENDS = {
+    "claude-code": claudeCodeBackend,
+    codex: codexBackend,
+};
+export function getBackend(cfg) {
+    const b = BACKENDS[cfg.agentBackend];
+    if (!b)
+        throw new Error(`Unknown agent backend: ${cfg.agentBackend}`);
+    return b;
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/reflex/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/reflex/agents/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,QAAQ,GAAiD;IAC7D,aAAa,EAAE,iBAAiB;IAChC,KAAK,EAAE,YAAY;CACpB,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACrC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,CAAC;AACX,CAAC"}