@flue/client 0.0.24 → 0.0.26

package/README.md

@@ -14,14 +14,15 @@ pnpm install @flue/client
 
 ```ts
 // .flue/workflows/issue-triage.ts
-import type { Flue } from '@flue/client';
+import type { FlueClient } from '@flue/client';
 
-export default async function triage(flue: Flue) {
-  const { issueNumber } = flue.args as { issueNumber: number };
-  const issue = await flue.shell(`gh issue view ${issueNumber} --json title,body`);
-  const result = await flue.skill('triage/diagnose.md', { args: { issueNumber } });
+export default async function triage(flue: FlueClient, args: { issueNumber: number }) {
+  const issue = await flue.shell(`gh issue view ${args.issueNumber} --json title,body`);
+  const result = await flue.skill('triage/diagnose.md', {
+    args: { issueNumber: args.issueNumber },
+  });
   const comment = await flue.prompt(`Summarize the triage for: ${issue.stdout}`);
-  await flue.shell(`gh issue comment ${issueNumber} --body-file -`, { stdin: comment });
+  await flue.shell(`gh issue comment ${args.issueNumber} --body-file -`, { stdin: comment });
 }
 ```
 
@@ -29,11 +30,10 @@ export default async function triage(flue: Flue) {
 
 ### `flue.shell(command, options?)`
 
-Run a shell command. Returns `{ stdout, stderr, exitCode }`.
+Run a shell command in the target environment. Returns `{ stdout, stderr, exitCode }`.
 
 ```ts
 const result = await flue.shell('pnpm test');
-const result = await flue.shell('gh issue view 123', { env: { GH_TOKEN: '...' } });
 const result = await flue.shell('cat -', { stdin: 'hello' });
 ```
 
@@ -78,14 +78,13 @@ Flue ships with built-in presets for popular services. Every proxy supports an a
 ```ts
 import { anthropic, github } from '@flue/client/proxies';
 
-export const proxies = [
-  anthropic(),
-  github({
-    token: process.env.GH_TOKEN!,
+export const proxies = {
+  anthropic: anthropic(),
+  github: github({
     policy: {
       base: 'allow-read',
       allow: [{ method: 'POST', path: '/repos/withastro/astro/issues/*/comments', limit: 1 }],
     },
   }),
-];
+};
 ```

package/dist/index.d.mts

@@ -86,22 +86,10 @@ interface FlueClientOptions {
     providerID: string;
     modelID: string;
   };
-  /**
-   * Custom fetch implementation for reaching the OpenCode server.
-   * Use this when the OpenCode server is not reachable via global fetch
-   * (e.g. from a Cloudflare Worker, route through sandbox.containerFetch).
-   *
-   * When omitted, the SDK's default fetch (globalThis.fetch) is used.
-   */
-  fetch?: (request: Request) => Promise<Response>;
-  /**
-   * Custom shell implementation for executing commands.
-   * Use this when child_process is not available (e.g. Cloudflare Workers)
-   * and commands should be routed through sandbox.exec() instead.
-   *
-   * When omitted, commands run via Node.js child_process.exec.
-   */
-  shell?: (command: string, options?: ShellOptions) => Promise<ShellResult>;
+  /** Fetch implementation for reaching the OpenCode server. */
+  fetch: (request: Request) => Promise<Response>;
+  /** Shell implementation for executing commands in the target environment. */
+  shell: (command: string, options?: ShellOptions) => Promise<ShellResult>;
 }
 interface SkillOptions<S extends v.GenericSchema | undefined = undefined> {
   /** Key-value args serialized into the prompt. */
@@ -145,7 +133,7 @@ declare class FlueClient {
   private readonly proxyInstructions;
   private readonly model?;
   private readonly client;
-  private readonly shellFn?;
+  private readonly shellFn;
   constructor(options: FlueClientOptions);
   /** Run a named skill with a result schema. */
   skill<S extends v.GenericSchema>(name: string, options: SkillOptions<S> & {

package/dist/index.mjs

@@ -1,6 +1,5 @@
 import { createOpencodeClient } from "@opencode-ai/sdk";
 import { toJsonSchema } from "@valibot/to-json-schema";
-import { exec } from "node:child_process";
 import * as v from "valibot";
 
 //#region src/errors.ts
@@ -225,43 +224,6 @@ function buildSkillPrompt(name, args, schema, proxyInstructions) {
 	return parts.join("\n");
 }
 
-//#endregion
-//#region src/shell.ts
-async function runShell(command, options) {
-	console.log("[flue] shell: running", {
-		command,
-		cwd: options?.cwd,
-		env: options?.env ? Object.keys(options.env) : void 0,
-		stdin: options?.stdin ? `${options.stdin.length} chars` : void 0,
-		timeout: options?.timeout
-	});
-	return new Promise((resolve) => {
-		const child = exec(command, {
-			cwd: options?.cwd,
-			env: options?.env ?? process.env,
-			timeout: options?.timeout
-		}, (error, stdout, stderr) => {
-			const rawCode = error && typeof error.code === "number" ? error.code : 0;
-			const result = {
-				stdout: stdout ?? "",
-				stderr: stderr ?? "",
-				exitCode: error ? rawCode || 1 : 0
-			};
-			console.log("[flue] shell: completed", {
-				command,
-				exitCode: result.exitCode,
-				stdout: result.stdout.length > 200 ? `${result.stdout.slice(0, 200)}... (${result.stdout.length} chars)` : result.stdout,
-				stderr: result.stderr.length > 200 ? `${result.stderr.slice(0, 200)}... (${result.stderr.length} chars)` : result.stderr
-			});
-			resolve(result);
-		});
-		if (options?.stdin) {
-			child.stdin?.write(options.stdin);
-			child.stdin?.end();
-		}
-	});
-}
-
 //#endregion
 //#region src/result.ts
 /**
@@ -492,7 +454,7 @@ var FlueClient = class {
 		this.client = createOpencodeClient({
 			baseUrl: options.opencodeUrl ?? "http://localhost:48765",
 			directory: this.workdir,
-			...options.fetch ? { fetch: options.fetch } : {}
+			fetch: options.fetch
 		});
 	}
 	async skill(name, options) {
@@ -520,12 +482,10 @@ var FlueClient = class {
 	}
 	/** Execute a shell command with scoped environment variables. */
 	async shell(command, options) {
-		const mergedOptions = {
+		return this.shellFn(command, {
 			...options,
 			cwd: options?.cwd ?? this.workdir
-		};
-		if (this.shellFn) return this.shellFn(command, mergedOptions);
-		return runShell(command, mergedOptions);
+		});
 	}
 	/** Close the OpenCode client connection. */
 	async close() {}

package/dist/proxies/index.mjs

@@ -79,7 +79,10 @@ function github(opts) {
 			},
 			policy: resolvedPolicy,
 			socket: true,
-			env: { GH_TOKEN: "proxy-placeholder" },
+			env: {
+				GH_TOKEN: "proxy-placeholder",
+				GH_HOST: "github.com"
+			},
 			setup: ["gh config set http_unix_socket {{socketPath}} 2>/dev/null || true"],
 			instructions: ["The `gh` CLI is pre-configured with authentication.", "For GitHub API calls, prefer `gh api` over raw `curl`."].join(" "),
 			denyResponse

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flue/client",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "type": "module",
   "license": "Apache-2.0",
   "exports": {