@agentvault/grok-bridge 0.1.0

package/dist/grok-spawn.d.ts

@@ -0,0 +1,42 @@
+export interface GrokSpawnOpts {
+    /** Defaults to "grok" — resolved from PATH at spawn time, like the launcher
+     *  script already does for node, so a version-manager switch cannot strand it. */
+    grokPath?: string;
+    /** Directory holding .claude-plugin/plugin.json + .mcp.json for room__say. */
+    pluginDir: string;
+    /** The agent's fenced HOME. GROK_HOME is derived as <fenceHome>/.grok. */
+    fenceHome: string;
+    /** cwd for the agent. MUST NOT be the AV MLS data dir. */
+    workspaceDir: string;
+    model?: string;
+    /** Preferred auth for a daemon: no login state to provision inside the fence
+     *  and no expiry to re-authenticate. */
+    apiKey?: string;
+}
+export interface GrokSpawn {
+    command: string;
+    args: string[];
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+}
+export declare function grokSpawnArgs(opts: GrokSpawnOpts): GrokSpawn;
+/**
+ * Turn a ChildProcess 'error' into a sentence an operator can act on.
+ *
+ * Separated from index.ts so it is TESTABLE: index.ts runs main() at module
+ * scope, so anything defined there cannot be imported by a test without
+ * spawning a real agent. The message text is the whole deliverable here — it
+ * must name WHICH binary was missing, WHERE the process looked, and WHAT to
+ * set — so it needs to live somewhere assertions can reach.
+ */
+export declare function describeSpawnFailure(err: NodeJS.ErrnoException, spawn: GrokSpawn): string;
+/**
+ * Child 'exit' after a successful start is fatal UNLESS we are already
+ * shutting down. GrokDriver.stop() calls child.kill("SIGTERM"), so a
+ * SIGTERM/SIGINT handler that always treats exit as a crash will
+ * process.exit(1) and the supervisor will restart us in a loop.
+ *
+ * null = ignore (intentional stop). string = fatal log body (no prefix).
+ */
+export declare function describeChildExit(shuttingDown: boolean, code: number | null, signal: NodeJS.Signals | string | null): string | null;
+//# sourceMappingURL=grok-spawn.d.ts.map

package/dist/index.d.ts

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