grexal 0.1.0

package/dist/templates/typescript.js

@@ -0,0 +1,55 @@
+export function tsManifest(name) {
+    return JSON.stringify({
+        name,
+        description: `TODO: Describe what ${name} does`,
+        entrypoint: "index.ts",
+        runtime: {
+            language: "typescript",
+        },
+        pricing: {
+            price_per_task: 0.01,
+        },
+    }, null, 2);
+}
+export function tsEntrypoint() {
+    return `import { AgentContext } from "@grexal/sdk";
+
+export default async function run(ctx: AgentContext) {
+  const task = await ctx.task();
+  await ctx.log("Hello from Grexal!");
+  await ctx.progress(0.5);
+
+  // Your agent logic here
+  const result = { received: task };
+
+  await ctx.log("Done!");
+  await ctx.progress(1.0);
+  return result;
+}
+`;
+}
+export function tsPackageJson(name) {
+    return JSON.stringify({
+        name,
+        version: "0.0.1",
+        type: "module",
+        private: true,
+        dependencies: {
+            "@grexal/sdk": "latest",
+        },
+    }, null, 2);
+}
+export function tsTsconfig() {
+    return JSON.stringify({
+        compilerOptions: {
+            target: "ES2022",
+            module: "ESNext",
+            moduleResolution: "bundler",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+        },
+        include: ["*.ts"],
+    }, null, 2);
+}
+//# sourceMappingURL=typescript.js.map

package/dist/templates/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../src/templates/typescript.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,IAAI;QACJ,WAAW,EAAE,uBAAuB,IAAI,OAAO;QAC/C,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE;YACP,QAAQ,EAAE,YAAY;SACvB;QACD,OAAO,EAAE;YACP,cAAc,EAAE,IAAI;SACrB;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,IAAI;QACJ,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,IAAI;QACb,YAAY,EAAE;YACZ,aAAa,EAAE,QAAQ;SACxB;KACF,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ;YAChB,gBAAgB,EAAE,SAAS;YAC3B,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,IAAI;YACrB,YAAY,EAAE,IAAI;SACnB;QACD,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/api.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Platform HTTP utilities for CLI-to-Convex communication.
+ *
+ * The platform URL points to the Convex deployment's HTTP actions endpoint.
+ * In production this is the Convex HTTP actions endpoint for the deployment.
+ * Developers can override it via GREXAL_API_URL for local testing.
+ */
+export declare function getPlatformUrl(): string;
+export declare function platformFetch(path: string, options?: RequestInit & {
+    token?: string;
+}): Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/utils/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,cAAc,IAAI,MAAM,CAIvC;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7C,OAAO,CAAC,QAAQ,CAAC,CAanB"}

package/dist/utils/api.js

@@ -0,0 +1,23 @@
+/**
+ * Platform HTTP utilities for CLI-to-Convex communication.
+ *
+ * The platform URL points to the Convex deployment's HTTP actions endpoint.
+ * In production this is the Convex HTTP actions endpoint for the deployment.
+ * Developers can override it via GREXAL_API_URL for local testing.
+ */
+export function getPlatformUrl() {
+    return (process.env.GREXAL_API_URL ?? "https://impartial-sockeye-413.convex.site");
+}
+export async function platformFetch(path, options = {}) {
+    const { token, ...fetchOptions } = options;
+    const url = `${getPlatformUrl()}${path}`;
+    const headers = new Headers(fetchOptions.headers);
+    if (token) {
+        headers.set("Authorization", `Bearer ${token}`);
+    }
+    return await fetch(url, {
+        ...fetchOptions,
+        headers,
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/utils/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/utils/api.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,UAAU,cAAc;IAC5B,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,2CAA2C,CAC1E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,UAA4C,EAAE;IAE9C,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,GAAG,GAAG,GAAG,cAAc,EAAE,GAAG,IAAI,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,KAAK,CAAC,GAAG,EAAE;QACtB,GAAG,YAAY;QACf,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/auth.d.ts

@@ -0,0 +1,10 @@
+export interface Credentials {
+    token: string;
+    email: string;
+}
+export declare function getCredentialsPath(): string;
+export declare function loadCredentials(): Promise<Credentials | null>;
+export declare function saveCredentials(creds: Credentials): Promise<void>;
+export declare function clearCredentials(): Promise<void>;
+export declare function requireAuth(): Promise<Credentials>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/utils/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAWnE;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvE;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAMtD;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAOxD"}

package/dist/utils/auth.js

@@ -0,0 +1,46 @@
+import { readFile, writeFile, mkdir, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export function getCredentialsPath() {
+    return join(homedir(), ".grexal", "credentials.json");
+}
+export async function loadCredentials() {
+    try {
+        const raw = await readFile(getCredentialsPath(), "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed.token && parsed.email) {
+            return { token: parsed.token, email: parsed.email };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function saveCredentials(creds) {
+    const dir = join(homedir(), ".grexal");
+    try {
+        await mkdir(dir, { recursive: true });
+    }
+    catch {
+        // Directory may already exist
+    }
+    await writeFile(getCredentialsPath(), JSON.stringify(creds, null, 2) + "\n", "utf-8");
+}
+export async function clearCredentials() {
+    try {
+        await unlink(getCredentialsPath());
+    }
+    catch {
+        // File may not exist
+    }
+}
+export async function requireAuth() {
+    const creds = await loadCredentials();
+    if (!creds) {
+        console.error("  Not authenticated. Run `npx grexal login` first.");
+        process.exit(1);
+    }
+    return creds;
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAOlC,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAkB;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IACD,MAAM,SAAS,CAAC,kBAAkB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/manifest.d.ts

@@ -0,0 +1,3 @@
+import type { AgentManifest } from "../manifest/types.js";
+export declare function loadManifest(path: string): Promise<AgentManifest>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/utils/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA+BvE"}

package/dist/utils/manifest.js

@@ -0,0 +1,32 @@
+import { readFile } from "node:fs/promises";
+import { validateManifest } from "../manifest/validator.js";
+export async function loadManifest(path) {
+    let raw;
+    try {
+        raw = await readFile(path, "utf-8");
+    }
+    catch {
+        console.error("  Error: grexal.json not found in current directory");
+        process.exit(1);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`  Error: grexal.json contains invalid JSON — ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+    const errors = validateManifest(parsed);
+    if (errors.length > 0) {
+        console.error("  Manifest validation failed:\n");
+        for (const err of errors) {
+            const p = err.path ? `${err.path} — ` : "";
+            console.error(`    ${p}${err.message}`);
+        }
+        console.error("");
+        process.exit(1);
+    }
+    return parsed;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/utils/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAG5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,gDAAgD,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAC3F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAuB,CAAC;AACjC,CAAC"}

package/dist/utils/process.d.ts

@@ -0,0 +1,18 @@
+import { type ChildProcess } from "node:child_process";
+export interface AgentProcess {
+    child: ChildProcess;
+    kill: () => void;
+    onExit: (callback: (code: number | null) => void) => void;
+}
+export interface SpawnOptions {
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd?: string;
+}
+/**
+ * Spawn an agent process with the given environment variables.
+ * stdout/stderr are piped to the parent process.
+ */
+export declare function spawnAgent(options: SpawnOptions): AgentProcess;
+//# sourceMappingURL=process.d.ts.map

package/dist/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CA0B9D"}

package/dist/utils/process.js

@@ -0,0 +1,30 @@
+import { spawn } from "node:child_process";
+/**
+ * Spawn an agent process with the given environment variables.
+ * stdout/stderr are piped to the parent process.
+ */
+export function spawnAgent(options) {
+    const child = spawn(options.command, options.args, {
+        env: { ...process.env, ...options.env },
+        cwd: options.cwd ?? process.cwd(),
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    child.stdout?.on("data", (data) => {
+        process.stdout.write(data);
+    });
+    child.stderr?.on("data", (data) => {
+        process.stderr.write(data);
+    });
+    return {
+        child,
+        kill: () => {
+            if (!child.killed) {
+                child.kill("SIGTERM");
+            }
+        },
+        onExit: (callback) => {
+            child.on("exit", (code) => callback(code));
+        },
+    };
+}
+//# sourceMappingURL=process.js.map

package/dist/utils/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/utils/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAe9D;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAqB;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACjD,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;KAClC,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,IAAI,EAAE,GAAG,EAAE;YACT,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "grexal",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Grexal CLI for building and deploying agents",
+  "bin": {
+    "grexal": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "tsx": "^4.21.0",
+    "@grexal/sdk": "^0.0.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}