@greppleai/grip 0.0.0-stage → 0.0.1

package/dist/bun/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bun/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":"","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nrestoreSandboxEnv();\n\nif (process.argv[2] !== \"--daemon\") {\n\tawait import(\"./register-bedrock.ts\");\n}\nawait import(\"../cli.ts\");\n"]}

package/dist/bun/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { APP_NAME } from "../config.js";
+import { restoreSandboxEnv } from "./restore-sandbox-env.js";
+process.title = APP_NAME;
+process.emitWarning = (() => { });
+restoreSandboxEnv();
+if (process.argv[2] !== "--daemon") {
+    await import("./register-bedrock.js");
+}
+await import("../cli.js");
+//# sourceMappingURL=cli.js.map

package/dist/bun/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bun/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;AACzB,OAAO,CAAC,WAAW,GAAG,CAAC,GAAG,EAAE,CAAC,EAAC,CAAC,CAA+B,CAAC;AAE/D,iBAAiB,EAAE,CAAC;AAEpB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;IACpC,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACvC,CAAC;AACD,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { APP_NAME } from \"../config.ts\";\nimport { restoreSandboxEnv } from \"./restore-sandbox-env.ts\";\n\nprocess.title = APP_NAME;\nprocess.emitWarning = (() => {}) as typeof process.emitWarning;\n\nrestoreSandboxEnv();\n\nif (process.argv[2] !== \"--daemon\") {\n\tawait import(\"./register-bedrock.ts\");\n}\nawait import(\"../cli.ts\");\n"]}

package/dist/bun/register-bedrock.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register-bedrock.d.ts.map

package/dist/bun/register-bedrock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.d.ts","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"","sourcesContent":["import { setBedrockProviderModule } from \"@greppleai/grip-ai\";\nimport { bedrockProviderModule } from \"@greppleai/grip-ai/bedrock-provider\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/bun/register-bedrock.js

@@ -0,0 +1,4 @@
+import { setBedrockProviderModule } from "@greppleai/grip-ai";
+import { bedrockProviderModule } from "@greppleai/grip-ai/bedrock-provider";
+setBedrockProviderModule(bedrockProviderModule);
+//# sourceMappingURL=register-bedrock.js.map

package/dist/bun/register-bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-bedrock.js","sourceRoot":"","sources":["../../src/bun/register-bedrock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAE5E,wBAAwB,CAAC,qBAAqB,CAAC,CAAC","sourcesContent":["import { setBedrockProviderModule } from \"@greppleai/grip-ai\";\nimport { bedrockProviderModule } from \"@greppleai/grip-ai/bedrock-provider\";\n\nsetBedrockProviderModule(bedrockProviderModule);\n"]}

package/dist/bun/restore-sandbox-env.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Workaround for https://github.com/oven-sh/bun/issues/27802
+ *
+ * Bun compiled binaries have an empty `process.env` when running inside
+ * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
+ * the environment from `/proc/self/environ`.
+ */
+/**
+ * Restore environment variables from `/proc/self/environ` when running
+ * inside a sandbox where Bun's `process.env` is empty.
+ */
+export declare function restoreSandboxEnv(): void;
+//# sourceMappingURL=restore-sandbox-env.d.ts.map

package/dist/bun/restore-sandbox-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-sandbox-env.d.ts","sourceRoot":"","sources":["../../src/bun/restore-sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAiBxC","sourcesContent":["/**\n * Workaround for https://github.com/oven-sh/bun/issues/27802\n *\n * Bun compiled binaries have an empty `process.env` when running inside\n * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover\n * the environment from `/proc/self/environ`.\n */\n\nimport { readFileSync } from \"node:fs\";\n\n/**\n * Restore environment variables from `/proc/self/environ` when running\n * inside a sandbox where Bun's `process.env` is empty.\n */\nexport function restoreSandboxEnv(): void {\n\tif (!process.versions?.bun) return;\n\n\t// If process.env already has entries, nothing to fix.\n\tif (Object.keys(process.env).length > 0) return;\n\n\ttry {\n\t\tconst data = readFileSync(\"/proc/self/environ\", \"utf-8\");\n\t\tfor (const entry of data.split(\"\\0\")) {\n\t\t\tconst idx = entry.indexOf(\"=\");\n\t\t\tif (idx > 0) {\n\t\t\t\tprocess.env[entry.slice(0, idx)] = entry.slice(idx + 1);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// /proc/self/environ may not be readable; ignore.\n\t}\n}\n"]}

package/dist/bun/restore-sandbox-env.js

@@ -0,0 +1,32 @@
+/**
+ * Workaround for https://github.com/oven-sh/bun/issues/27802
+ *
+ * Bun compiled binaries have an empty `process.env` when running inside
+ * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover
+ * the environment from `/proc/self/environ`.
+ */
+import { readFileSync } from "node:fs";
+/**
+ * Restore environment variables from `/proc/self/environ` when running
+ * inside a sandbox where Bun's `process.env` is empty.
+ */
+export function restoreSandboxEnv() {
+    if (!process.versions?.bun)
+        return;
+    // If process.env already has entries, nothing to fix.
+    if (Object.keys(process.env).length > 0)
+        return;
+    try {
+        const data = readFileSync("/proc/self/environ", "utf-8");
+        for (const entry of data.split("\0")) {
+            const idx = entry.indexOf("=");
+            if (idx > 0) {
+                process.env[entry.slice(0, idx)] = entry.slice(idx + 1);
+            }
+        }
+    }
+    catch {
+        // /proc/self/environ may not be readable; ignore.
+    }
+}
+//# sourceMappingURL=restore-sandbox-env.js.map

package/dist/bun/restore-sandbox-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-sandbox-env.js","sourceRoot":"","sources":["../../src/bun/restore-sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,GAAS;IACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG;QAAE,OAAO;IAEnC,sDAAsD;IACtD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IAEhD,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,YAAY,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QACzD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACzD,CAAC;QACF,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;QACR,kDAAkD;IACnD,CAAC;AAAA,CACD","sourcesContent":["/**\n * Workaround for https://github.com/oven-sh/bun/issues/27802\n *\n * Bun compiled binaries have an empty `process.env` when running inside\n * sandbox environments (e.g. nono on Linux/macOS). On Linux we can recover\n * the environment from `/proc/self/environ`.\n */\n\nimport { readFileSync } from \"node:fs\";\n\n/**\n * Restore environment variables from `/proc/self/environ` when running\n * inside a sandbox where Bun's `process.env` is empty.\n */\nexport function restoreSandboxEnv(): void {\n\tif (!process.versions?.bun) return;\n\n\t// If process.env already has entries, nothing to fix.\n\tif (Object.keys(process.env).length > 0) return;\n\n\ttry {\n\t\tconst data = readFileSync(\"/proc/self/environ\", \"utf-8\");\n\t\tfor (const entry of data.split(\"\\0\")) {\n\t\t\tconst idx = entry.indexOf(\"=\");\n\t\t\tif (idx > 0) {\n\t\t\t\tprocess.env[entry.slice(0, idx)] = entry.slice(idx + 1);\n\t\t\t}\n\t\t}\n\t} catch {\n\t\t// /proc/self/environ may not be readable; ignore.\n\t}\n}\n"]}

package/dist/cli/args.d.ts

@@ -0,0 +1,70 @@
+/**
+ * CLI argument parsing and help display
+ */
+import type { ThinkingLevel } from "@greppleai/grip-agent-core";
+import type { TuiMode } from "@greppleai/grip-tui";
+import type { ExtensionFlag } from "../core/extensions/types.ts";
+export type Mode = "text" | "json" | "rpc";
+export type CliDiagnosticSeverity = "warning" | "error";
+export interface CliDiagnostic {
+    type: CliDiagnosticSeverity;
+    message: string;
+}
+export interface Args {
+    provider?: string;
+    model?: string;
+    apiKey?: string;
+    systemPrompt?: string;
+    appendSystemPrompt?: string[];
+    thinking?: ThinkingLevel;
+    continue?: boolean;
+    resume?: boolean;
+    help?: boolean;
+    version?: boolean;
+    mode?: Mode;
+    noSession?: boolean;
+    session?: string;
+    fork?: string;
+    sessionDir?: string;
+    lspConfig?: string;
+    noLsp?: boolean;
+    enableLspTools?: boolean;
+    remoteSessionBaseUrl?: string;
+    remoteSessionToken?: string;
+    remoteProjectId?: string;
+    models?: string[];
+    tools?: string[];
+    noTools?: boolean;
+    noBuiltinTools?: boolean;
+    /** Explicitly trust project grip and Claude hooks as trusted host code. */
+    trustProjectHooks?: boolean;
+    extensions?: string[];
+    noExtensions?: boolean;
+    print?: boolean;
+    export?: string;
+    noSkills?: boolean;
+    skills?: string[];
+    noRules?: boolean;
+    rules?: string[];
+    promptTemplates?: string[];
+    noPromptTemplates?: boolean;
+    themes?: string[];
+    noThemes?: boolean;
+    noContextFiles?: boolean;
+    listModels?: string | true;
+    offline?: boolean;
+    tuiMode?: TuiMode;
+    verbose?: boolean;
+    remote?: string;
+    remoteDeferred?: boolean;
+    remoteCwd?: string;
+    messages: string[];
+    fileArgs: string[];
+    /** Unknown flags (potentially extension flags) - map of flag name to value */
+    unknownFlags: Map<string, boolean | string>;
+    diagnostics: CliDiagnostic[];
+}
+export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
+export declare function parseArgs(args: string[]): Args;
+export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
+//# sourceMappingURL=args.d.ts.map

package/dist/cli/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * CLI argument parsing and help display\n */\n\nimport type { ThinkingLevel } from \"@greppleai/grip-agent-core\";\nimport type { TuiMode } from \"@greppleai/grip-tui\";\nimport chalk from \"chalk\";\nimport {\n\tAPP_NAME,\n\tCONFIG_DIR_NAME,\n\tENV_AGENT_DIR,\n\tENV_REMOTE_PROJECT_ID,\n\tENV_REMOTE_SESSION_BASE_URL,\n\tENV_REMOTE_SESSION_TOKEN,\n\tENV_SESSION_DIR,\n} from \"../config.ts\";\nimport type { ExtensionFlag } from \"../core/extensions/types.ts\";\n\nexport type Mode = \"text\" | \"json\" | \"rpc\";\n\nexport type CliDiagnosticSeverity = \"warning\" | \"error\";\n\nexport interface CliDiagnostic {\n\ttype: CliDiagnosticSeverity;\n\tmessage: string;\n}\n\nexport interface Args {\n\tprovider?: string;\n\tmodel?: string;\n\tapiKey?: string;\n\tsystemPrompt?: string;\n\tappendSystemPrompt?: string[];\n\tthinking?: ThinkingLevel;\n\tcontinue?: boolean;\n\tresume?: boolean;\n\thelp?: boolean;\n\tversion?: boolean;\n\tmode?: Mode;\n\tnoSession?: boolean;\n\tsession?: string;\n\tfork?: string;\n\tsessionDir?: string;\n\tlspConfig?: string;\n\tnoLsp?: boolean;\n\tenableLspTools?: boolean;\n\tremoteSessionBaseUrl?: string;\n\tremoteSessionToken?: string;\n\tremoteProjectId?: string;\n\tmodels?: string[];\n\ttools?: string[];\n\tnoTools?: boolean;\n\tnoBuiltinTools?: boolean;\n\t/** Explicitly trust project grip and Claude hooks as trusted host code. */\n\ttrustProjectHooks?: boolean;\n\textensions?: string[];\n\tnoExtensions?: boolean;\n\tprint?: boolean;\n\texport?: string;\n\tnoSkills?: boolean;\n\tskills?: string[];\n\tnoRules?: boolean;\n\trules?: string[];\n\tpromptTemplates?: string[];\n\tnoPromptTemplates?: boolean;\n\tthemes?: string[];\n\tnoThemes?: boolean;\n\tnoContextFiles?: boolean;\n\tlistModels?: string | true;\n\toffline?: boolean;\n\ttuiMode?: TuiMode;\n\tverbose?: boolean;\n\tremote?: string;\n\tremoteDeferred?: boolean;\n\tremoteCwd?: string;\n\tmessages: string[];\n\tfileArgs: string[];\n\t/** Unknown flags (potentially extension flags) - map of flag name to value */\n\tunknownFlags: Map<string, boolean | string>;\n\tdiagnostics: CliDiagnostic[];\n}\n\nconst VALID_THINKING_LEVELS = [\"off\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\"] as const;\n\nexport function isValidThinkingLevel(level: string): level is ThinkingLevel {\n\treturn VALID_THINKING_LEVELS.includes(level as ThinkingLevel);\n}\n\ntype CliBooleanFlagHandler = (result: Args) => void;\ntype CliValueFlagHandler = (result: Args, value: string) => void;\n\ninterface CliArgumentParseContext {\n\targs: string[];\n\tresult: Args;\n\tindex: number;\n\targ: string;\n}\n\ntype CliSpecialFlagHandler = (context: CliArgumentParseContext) => number;\n\nfunction appendArgumentValue(values: string[] | undefined, value: string): string[] {\n\tconst nextValues = values ?? [];\n\tnextValues.push(value);\n\treturn nextValues;\n}\n\nconst BOOLEAN_FLAG_HANDLERS = new Map<string, CliBooleanFlagHandler>([\n\t[\"--help\", (result) => (result.help = true)],\n\t[\"-h\", (result) => (result.help = true)],\n\t[\"--version\", (result) => (result.version = true)],\n\t[\"-v\", (result) => (result.version = true)],\n\t[\"--continue\", (result) => (result.continue = true)],\n\t[\"-c\", (result) => (result.continue = true)],\n\t[\"--resume\", (result) => (result.resume = true)],\n\t[\"-r\", (result) => (result.resume = true)],\n\t[\"--no-session\", (result) => (result.noSession = true)],\n\t[\"--no-lsp\", (result) => (result.noLsp = true)],\n\t[\"--enable-lsp-tools\", (result) => (result.enableLspTools = true)],\n\t[\"--no-tools\", (result) => (result.noTools = true)],\n\t[\"-nt\", (result) => (result.noTools = true)],\n\t[\"--no-builtin-tools\", (result) => (result.noBuiltinTools = true)],\n\t[\"-nbt\", (result) => (result.noBuiltinTools = true)],\n\t[\"--trust-project-hooks\", (result) => (result.trustProjectHooks = true)],\n\t[\"--no-extensions\", (result) => (result.noExtensions = true)],\n\t[\"-ne\", (result) => (result.noExtensions = true)],\n\t[\"--no-skills\", (result) => (result.noSkills = true)],\n\t[\"-ns\", (result) => (result.noSkills = true)],\n\t[\"--no-rules\", (result) => (result.noRules = true)],\n\t[\"-nr\", (result) => (result.noRules = true)],\n\t[\"--no-prompt-templates\", (result) => (result.noPromptTemplates = true)],\n\t[\"-np\", (result) => (result.noPromptTemplates = true)],\n\t[\"--no-themes\", (result) => (result.noThemes = true)],\n\t[\"--no-context-files\", (result) => (result.noContextFiles = true)],\n\t[\"-nc\", (result) => (result.noContextFiles = true)],\n\t[\"--verbose\", (result) => (result.verbose = true)],\n\t[\"--offline\", (result) => (result.offline = true)],\n\t[\"--remote-deferred\", (result) => (result.remoteDeferred = true)],\n]);\n\nconst VALUE_FLAG_HANDLERS = new Map<string, CliValueFlagHandler>([\n\t[\n\t\t\"--mode\",\n\t\t(result, value) => {\n\t\t\tif (value === \"text\" || value === \"json\" || value === \"rpc\") result.mode = value;\n\t\t},\n\t],\n\t[\"--provider\", (result, value) => (result.provider = value)],\n\t[\"--model\", (result, value) => (result.model = value)],\n\t[\"--api-key\", (result, value) => (result.apiKey = value)],\n\t[\"--system-prompt\", (result, value) => (result.systemPrompt = value)],\n\t[\n\t\t\"--append-system-prompt\",\n\t\t(result, value) => (result.appendSystemPrompt = appendArgumentValue(result.appendSystemPrompt, value)),\n\t],\n\t[\"--session\", (result, value) => (result.session = value)],\n\t[\"--fork\", (result, value) => (result.fork = value)],\n\t[\"--session-dir\", (result, value) => (result.sessionDir = value)],\n\t[\"--remote-session-base-url\", (result, value) => (result.remoteSessionBaseUrl = value)],\n\t[\"--remote-session-token\", (result, value) => (result.remoteSessionToken = value)],\n\t[\"--remote-project-id\", (result, value) => (result.remoteProjectId = value)],\n\t[\"--models\", (result, value) => (result.models = value.split(\",\").map((item) => item.trim()))],\n\t[\n\t\t\"--tools\",\n\t\t(result, value) =>\n\t\t\t(result.tools = value\n\t\t\t\t.split(\",\")\n\t\t\t\t.map((item) => item.trim())\n\t\t\t\t.filter((name) => name.length > 0)),\n\t],\n\t[\n\t\t\"-t\",\n\t\t(result, value) =>\n\t\t\t(result.tools = value\n\t\t\t\t.split(\",\")\n\t\t\t\t.map((item) => item.trim())\n\t\t\t\t.filter((name) => name.length > 0)),\n\t],\n\t[\n\t\t\"--thinking\",\n\t\t(result, value) => {\n\t\t\tif (isValidThinkingLevel(value)) {\n\t\t\t\tresult.thinking = value;\n\t\t\t} else {\n\t\t\t\tresult.diagnostics.push({\n\t\t\t\t\ttype: \"warning\",\n\t\t\t\t\tmessage: `Invalid thinking level \"${value}\". Valid values: ${VALID_THINKING_LEVELS.join(\", \")}`,\n\t\t\t\t});\n\t\t\t}\n\t\t},\n\t],\n\t[\"--export\", (result, value) => (result.export = value)],\n\t[\"--extension\", (result, value) => (result.extensions = appendArgumentValue(result.extensions, value))],\n\t[\"-e\", (result, value) => (result.extensions = appendArgumentValue(result.extensions, value))],\n\t[\"--skill\", (result, value) => (result.skills = appendArgumentValue(result.skills, value))],\n\t[\"--rule\", (result, value) => (result.rules = appendArgumentValue(result.rules, value))],\n\t[\n\t\t\"--prompt-template\",\n\t\t(result, value) => (result.promptTemplates = appendArgumentValue(result.promptTemplates, value)),\n\t],\n\t[\"--theme\", (result, value) => (result.themes = appendArgumentValue(result.themes, value))],\n\t[\"--remote\", (result, value) => (result.remote = value)],\n\t[\"--remote-cwd\", (result, value) => (result.remoteCwd = value)],\n]);\n\nfunction handleLspConfigFlag(context: CliArgumentParseContext): number {\n\tconst next = context.args[context.index + 1];\n\tif (next === undefined || next.startsWith(\"-\")) {\n\t\tcontext.result.diagnostics.push({ type: \"error\", message: \"--lsp-config requires a file path\" });\n\t\treturn context.index;\n\t}\n\tcontext.result.lspConfig = next;\n\treturn context.index + 1;\n}\n\nfunction handlePrintFlag(context: CliArgumentParseContext): number {\n\tcontext.result.print = true;\n\tconst next = context.args[context.index + 1];\n\tif (next !== undefined && !next.startsWith(\"@\") && (!next.startsWith(\"-\") || next.startsWith(\"---\"))) {\n\t\tcontext.result.messages.push(next);\n\t\treturn context.index + 1;\n\t}\n\treturn context.index;\n}\n\nfunction handleListModelsFlag(context: CliArgumentParseContext): number {\n\tconst next = context.args[context.index + 1];\n\tif (next !== undefined && !next.startsWith(\"-\") && !next.startsWith(\"@\")) {\n\t\tcontext.result.listModels = next;\n\t\treturn context.index + 1;\n\t}\n\tcontext.result.listModels = true;\n\treturn context.index;\n}\n\nfunction handleTuiModeFlag(context: CliArgumentParseContext): number {\n\tconst mode = context.args[context.index + 1];\n\tif (mode === \"regular\" || mode === \"fullscreen\") {\n\t\tcontext.result.tuiMode = mode;\n\t\treturn context.index + 1;\n\t}\n\tif (mode === undefined || mode.startsWith(\"-\")) {\n\t\tcontext.result.diagnostics.push({ type: \"error\", message: \"--tui-mode requires regular or fullscreen\" });\n\t\treturn context.index;\n\t}\n\tcontext.result.diagnostics.push({\n\t\ttype: \"error\",\n\t\tmessage: `Invalid TUI mode \"${mode}\". Valid values: regular, fullscreen`,\n\t});\n\treturn context.index + 1;\n}\n\nfunction handleRemovedSshFlag(context: CliArgumentParseContext): number {\n\tcontext.result.diagnostics.push({\n\t\ttype: \"error\",\n\t\tmessage:\n\t\t\tcontext.arg === \"--ssh\"\n\t\t\t\t? \"--ssh was removed; use --remote <ws://url>\"\n\t\t\t\t: `${context.arg} was removed; use --remote-deferred --remote-cwd <path>`,\n\t});\n\tconst value = context.args[context.index + 1];\n\tif ((context.arg === \"--ssh\" || context.arg === \"--ssh-cwd\") && value !== undefined && !value.startsWith(\"-\")) {\n\t\treturn context.index + 1;\n\t}\n\treturn context.index;\n}\n\nconst SPECIAL_FLAG_HANDLERS = new Map<string, CliSpecialFlagHandler>([\n\t[\"--lsp-config\", handleLspConfigFlag],\n\t[\"--print\", handlePrintFlag],\n\t[\"-p\", handlePrintFlag],\n\t[\"--list-models\", handleListModelsFlag],\n\t[\"--tui-mode\", handleTuiModeFlag],\n\t[\"--ssh\", handleRemovedSshFlag],\n\t[\"--ssh-deferred\", handleRemovedSshFlag],\n\t[\"--ssh-cwd\", handleRemovedSshFlag],\n]);\n\nfunction handleMappedCliFlag(context: CliArgumentParseContext): number | undefined {\n\tconst booleanHandler = BOOLEAN_FLAG_HANDLERS.get(context.arg);\n\tif (booleanHandler) {\n\t\tbooleanHandler(context.result);\n\t\treturn context.index;\n\t}\n\tconst valueHandler = VALUE_FLAG_HANDLERS.get(context.arg);\n\tconst value = context.args[context.index + 1];\n\tif (!valueHandler || value === undefined) return undefined;\n\tvalueHandler(context.result, value);\n\treturn context.index + 1;\n}\n\nfunction handleFallbackCliArgument(context: CliArgumentParseContext): number {\n\tconst { arg, args, result, index } = context;\n\tif (arg.startsWith(\"@\")) {\n\t\tresult.fileArgs.push(arg.slice(1));\n\t\treturn index;\n\t}\n\tif (arg.startsWith(\"--\")) {\n\t\tconst equalsIndex = arg.indexOf(\"=\");\n\t\tif (equalsIndex !== -1) {\n\t\t\tresult.unknownFlags.set(arg.slice(2, equalsIndex), arg.slice(equalsIndex + 1));\n\t\t\treturn index;\n\t\t}\n\t\tconst flagName = arg.slice(2);\n\t\tconst next = args[index + 1];\n\t\tif (next !== undefined && !next.startsWith(\"-\") && !next.startsWith(\"@\")) {\n\t\t\tresult.unknownFlags.set(flagName, next);\n\t\t\treturn index + 1;\n\t\t}\n\t\tresult.unknownFlags.set(flagName, true);\n\t\treturn index;\n\t}\n\tif (arg.startsWith(\"-\")) {\n\t\tresult.diagnostics.push({ type: \"error\", message: `Unknown option: ${arg}` });\n\t\treturn index;\n\t}\n\tresult.messages.push(arg);\n\treturn index;\n}\n\nexport function parseArgs(args: string[]): Args {\n\tconst result: Args = {\n\t\tmessages: [],\n\t\tfileArgs: [],\n\t\tunknownFlags: new Map(),\n\t\tdiagnostics: [],\n\t};\n\tfor (let index = 0; index < args.length; index++) {\n\t\tconst context: CliArgumentParseContext = { args, result, index, arg: args[index] };\n\t\tconst mappedIndex = handleMappedCliFlag(context);\n\t\tif (mappedIndex !== undefined) {\n\t\t\tindex = mappedIndex;\n\t\t\tcontinue;\n\t\t}\n\t\tconst specialHandler = SPECIAL_FLAG_HANDLERS.get(context.arg);\n\t\tif (specialHandler) {\n\t\t\tindex = specialHandler(context);\n\t\t\tcontinue;\n\t\t}\n\t\tindex = handleFallbackCliArgument(context);\n\t}\n\treturn result;\n}\n\nexport function printHelp(extensionFlags?: ExtensionFlag[]): void {\n\tconst extensionFlagsText =\n\t\textensionFlags && extensionFlags.length > 0\n\t\t\t? `\\n${chalk.bold(\"Extension CLI Flags:\")}\\n${extensionFlags\n\t\t\t\t\t.map((flag) => {\n\t\t\t\t\t\tconst value = flag.type === \"string\" ? \" <value>\" : \"\";\n\t\t\t\t\t\tconst description = flag.description ?? `Registered by ${flag.extensionPath}`;\n\t\t\t\t\t\treturn `  --${flag.name}${value}`.padEnd(30) + description;\n\t\t\t\t\t})\n\t\t\t\t\t.join(\"\\n\")}\\n`\n\t\t\t: \"\";\n\tconsole.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools\n\n${chalk.bold(\"Usage:\")}\n  ${APP_NAME} [options] [@files...] [messages...]\n\n${chalk.bold(\"Commands:\")}\n  ${APP_NAME} install <source> [-l]     Install extension source and add to settings\n  ${APP_NAME} remove <source> [-l]      Remove extension source from settings\n  ${APP_NAME} uninstall <source> [-l]   Alias for remove\n  ${APP_NAME} update [source|self|grip] Update grip and installed extensions\n  ${APP_NAME} list                      List installed extensions from settings\n  ${APP_NAME} config                    Open TUI to enable/disable package resources\n  ${APP_NAME} --daemon [options]        Start the remote workspace runtime\n  ${APP_NAME} <command> --help          Show help for install/remove/uninstall/update/list\n\n${chalk.bold(\"Options:\")}\n  --daemon                       Start daemon mode; use --daemon --help for daemon options\n  --provider <name>              Provider name (default: google)\n  --model <pattern>              Model pattern or ID (supports \"provider/id\" and optional \":<thinking>\")\n  --api-key <key>                API key (defaults to env vars)\n  --system-prompt <text>         System prompt (default: coding assistant prompt)\n  --append-system-prompt <text>  Append text or file contents to the system prompt (can be used multiple times)\n  --mode <mode>                  Output mode: text (default), json, or rpc\n  --print, -p                    Non-interactive mode: process prompt and exit\n  --continue, -c                 Continue previous session\n  --resume, -r                   Select a session to resume\n  --session <path|id>            Use specific session file or partial UUID\n  --fork <path|id>               Fork specific session file or partial UUID into a new session\n  --session-dir <dir>            Directory for session storage and lookup\n  --lsp-config <file>            Load an explicit LSP configuration file\n  --no-lsp                      Disable the LSP runtime regardless of tool selection\n  --enable-lsp-tools            Expose configured LSP tools by default\n  --remote-session-base-url <url> Use remote session service for persistence\n  --remote-session-token <token> Bearer token for remote session service\n  --remote-project-id <id>       Project id sent to remote session service\n  --no-session                   Don't save session (ephemeral)\n  --models <patterns>            Comma-separated model patterns for Ctrl+P cycling\n                                 Supports globs (anthropic/*, *sonnet*) and fuzzy matching\n  --no-tools, -nt                Disable all tools by default (built-in and extension)\n  --no-builtin-tools, -nbt       Disable built-in tools by default but keep extension/custom tools enabled\n  --tools, -t <tools>            Comma-separated allowlist of tool names to enable\n                                 Applies to built-in, extension, and custom tools\n  --thinking <level>             Set thinking level: off, minimal, low, medium, high, xhigh\n  --trust-project-hooks          Trust and run project ${CONFIG_DIR_NAME}/.claude hooks as host code (review them first)\n  --extension, -e <path>         Load an extension file (can be used multiple times)\n  --no-extensions, -ne           Disable extension discovery (explicit -e paths still work)\n  --skill <path>                 Load a skill file or directory (can be used multiple times)\n  --no-skills, -ns               Disable skills discovery and loading\n  --rule <path>                  Load a rule file or directory (can be used multiple times)\n  --no-rules, -nr                Disable rules discovery and loading\n  --prompt-template <path>       Load a prompt template file or directory (can be used multiple times)\n  --no-prompt-templates, -np     Disable prompt template discovery and loading\n  --theme <path>                 Load a theme file or directory (can be used multiple times)\n  --no-themes                    Disable theme discovery and loading\n  --no-context-files, -nc        Disable AGENTS.md and CLAUDE.md discovery and loading\n  --export <file>                Export session file to HTML and exit\n  --list-models [search]         List available models (with optional fuzzy search)\n  --tui-mode <mode>              TUI mode: regular (default) or fullscreen\n  --verbose                      Force verbose startup (overrides quietStartup setting)\n  --offline                      Disable startup network operations (same as GRIP_OFFLINE=1)\n  --remote <url>                 Run built-in tools through a ${APP_NAME} --daemon backend (ws:// or wss://)\n  --remote-deferred              Start without a connected daemon backend; configure later with /sandbox\n  --remote-cwd <path>            Stable backend cwd for --remote-deferred\n  --help, -h                     Show this help\n  --version, -v                  Show version number\n\nExtensions can register additional flags (e.g., --plan from plan-mode extension).${extensionFlagsText}\n\n${chalk.bold(\"Examples:\")}\n  # Interactive mode\n  ${APP_NAME}\n\n  # Interactive mode with initial prompt\n  ${APP_NAME} \"List all .ts files in src/\"\n\n  # Include files in initial message\n  ${APP_NAME} @prompt.md @image.png \"What color is the sky?\"\n\n  # Non-interactive mode (process and exit)\n  ${APP_NAME} -p \"List all .ts files in src/\"\n\n  # Multiple messages (interactive)\n  ${APP_NAME} \"Read package.json\" \"What dependencies do we have?\"\n\n  # Continue previous session\n  ${APP_NAME} --continue \"What did we discuss?\"\n\n  # Use different model\n  ${APP_NAME} --provider openai --model gpt-4o-mini \"Help me refactor this code\"\n\n  # Use model with provider prefix (no --provider needed)\n  ${APP_NAME} --model openai/gpt-4o \"Help me refactor this code\"\n\n  # Use model with thinking level shorthand\n  ${APP_NAME} --model sonnet:high \"Solve this complex problem\"\n\n  # Limit model cycling to specific models\n  ${APP_NAME} --models claude-sonnet,claude-haiku,gpt-4o\n\n  # Limit to a specific provider with glob pattern\n  ${APP_NAME} --models \"github-copilot/*\"\n\n  # Cycle models with fixed thinking levels\n  ${APP_NAME} --models sonnet:high,haiku:low\n\n  # Start with a specific thinking level\n  ${APP_NAME} --thinking high \"Solve this complex problem\"\n\n  # Read-only mode (no file modifications possible)\n  ${APP_NAME} --tools read,grep,find,ls -p \"Review the code in src/\"\n\n  # Run built-in tools through a remote workspace daemon\n  ${APP_NAME} --remote ws://localhost:8787 \"Inspect this repo\"\n\n  # Start without a connected daemon backend and attach later with /sandbox\n  ${APP_NAME} --remote-deferred --remote-cwd /workspace\n\n  # Export a session file to HTML\n  ${APP_NAME} --export ~/${CONFIG_DIR_NAME}/agent/sessions/--path--/session.jsonl\n  ${APP_NAME} --export session.jsonl output.html\n\n${chalk.bold(\"Environment Variables:\")}\n  ANTHROPIC_API_KEY                - Anthropic Claude API key\n  ANTHROPIC_OAUTH_TOKEN            - Anthropic OAuth token (alternative to API key)\n  OPENAI_API_KEY                   - OpenAI GPT API key\n  AZURE_OPENAI_API_KEY             - Azure OpenAI API key\n  AZURE_OPENAI_BASE_URL            - Azure OpenAI/Cognitive Services base URL (e.g. https://{resource}.openai.azure.com)\n  AZURE_OPENAI_RESOURCE_NAME       - Azure OpenAI resource name (alternative to base URL)\n  AZURE_OPENAI_API_VERSION         - Azure OpenAI API version (default: v1)\n  AZURE_OPENAI_DEPLOYMENT_NAME_MAP - Azure OpenAI model=deployment map (comma-separated)\n  DEEPSEEK_API_KEY                 - DeepSeek API key\n  GEMINI_API_KEY                   - Google Gemini API key\n  GROQ_API_KEY                     - Groq API key\n  CEREBRAS_API_KEY                 - Cerebras API key\n  XAI_API_KEY                      - xAI Grok API key\n  FIREWORKS_API_KEY                - Fireworks API key\n  TOGETHER_API_KEY                 - Together AI API key\n  OPENROUTER_API_KEY               - OpenRouter API key\n  AI_GATEWAY_API_KEY               - Vercel AI Gateway API key\n  ZAI_API_KEY                      - ZAI API key\n  MISTRAL_API_KEY                  - Mistral API key\n  MINIMAX_API_KEY                  - MiniMax API key\n  MOONSHOT_API_KEY                 - Moonshot AI API key\n  OPENCODE_API_KEY                 - OpenCode Zen/OpenCode Go API key\n  KIMI_API_KEY                     - Kimi For Coding API key\n  CLOUDFLARE_API_KEY               - Cloudflare API token (Workers AI and AI Gateway)\n  CLOUDFLARE_ACCOUNT_ID            - Cloudflare account id (required for both)\n  CLOUDFLARE_GATEWAY_ID            - Cloudflare AI Gateway slug (required for AI Gateway)\n  XIAOMI_API_KEY                   - Xiaomi MiMo API key (api.xiaomimimo.com billing)\n  XIAOMI_TOKEN_PLAN_CN_API_KEY     - Xiaomi MiMo Token Plan API key (China region)\n  XIAOMI_TOKEN_PLAN_AMS_API_KEY    - Xiaomi MiMo Token Plan API key (Amsterdam region)\n  XIAOMI_TOKEN_PLAN_SGP_API_KEY    - Xiaomi MiMo Token Plan API key (Singapore region)\n  AWS_PROFILE                      - AWS profile for Amazon Bedrock\n  AWS_ACCESS_KEY_ID                - AWS access key for Amazon Bedrock\n  AWS_SECRET_ACCESS_KEY            - AWS secret key for Amazon Bedrock\n  AWS_BEARER_TOKEN_BEDROCK         - Bedrock API key (bearer token)\n  AWS_REGION                       - AWS region for Amazon Bedrock (e.g., us-east-1)\n  ${ENV_AGENT_DIR.padEnd(32)} - Config directory (default: ~/${CONFIG_DIR_NAME}/agent)\n  ${ENV_SESSION_DIR.padEnd(32)} - Session storage directory (overridden by --session-dir)\n  ${ENV_REMOTE_SESSION_BASE_URL.padEnd(32)} - Remote session service URL\n  ${ENV_REMOTE_SESSION_TOKEN.padEnd(32)} - Bearer token for remote session service\n  ${ENV_REMOTE_PROJECT_ID.padEnd(32)} - Project id sent to remote session service\n  GRIP_PACKAGE_DIR                 - Override package directory (for Nix/Guix store paths)\n  GRIP_OFFLINE                     - Disable startup network operations when set to 1/true/yes\n  GRIP_TELEMETRY                   - Override install telemetry when set to 1/true/yes or 0/false/no\n  GRIP_SHARE_VIEWER_URL            - Base URL for /share command (default: https://pi.dev/session/)\n\n${chalk.bold(\"Built-in Tool Names:\")}\n  read   - Read file contents\n  bash   - Execute bash commands\n  edit   - Edit files with find/replace\n  write  - Write files (creates/overwrites)\n  grep   - Search file contents (read-only, off by default)\n  find   - Find files by glob pattern (read-only, off by default)\n  ls     - List directory contents (read-only, off by default)\n  websearch         - Search the web for relevant links\n  session_search    - Search finalized session history\n  session_entry_get - Fetch an exact session entry by ID\n  compress_context    - Replace an active session range or tail with a summary\n\n${chalk.bold(\"Conditional LSP Tool Names:\")}\n  Requires LSP configuration; opt in with --enable-lsp-tools, enableLspTools in settings, or --tools.\n  lsp_diagnostics   - Get diagnostics for a file\n  lsp_hover         - Get hover information for a symbol\n  lsp_definition    - Find a symbol definition\n  lsp_references    - Find symbol references\n  lsp_rename        - Preview a symbol rename\n  lsp_code_actions  - List code actions and refactorings\n`);\n}\n"]}