@flamecast/cli 0.1.0 → 0.2.0

package/README.md

@@ -53,10 +53,30 @@ Flags on `sessions create`:
 | Flag | Default | Notes |
 |---|---|---|
 | `--input <text>` | _(required)_ | First message to the agent. |
-| `--model <id>` | `anthropic/claude-haiku-4-5` | Free tier supports this model only; BYOK keys can use any Think-supported model. |
+| `--config <file>` | _none_ | Path to a local JSON AgentConfig (runtime + mcp[] + instructions). Use this to attach MCPs. Conflicts with `--agent-id`. |
+| `--model <id>` | `anthropic/claude-haiku-4-5` | Free tier supports this model only; BYOK keys can use any Think-supported model. Ignored when `--config` is set. |
 | `--agent-id <id>` | _none_ | Launch a saved agent instead of an inline runtime. |
 | `--async` | off | Return immediately; poll `sessions get` / `sessions events` for progress. |
 
+Example `agent.json`:
+
+```json
+{
+  "runtime": {
+    "id": "think",
+    "config": { "model": "anthropic/claude-haiku-4-5", "toolMode": "mcp" }
+  },
+  "mcp": [
+    { "name": "gmail",   "server": { "url": "https://..." } },
+    { "name": "github",  "server": { "url": "https://..." } }
+  ]
+}
+```
+
+```bash
+flamecast sessions create --config agent.json --input "Triage incoming support tickets."
+```
+
 ## Configuration
 
 Credentials live at `~/.config/flamecast/config.json` (respects `$XDG_CONFIG_HOME`). Delete the file or run `flamecast logout` to clear.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@flamecast/cli",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Command-line client for Flamecast. Drives the device-auth flow and wraps the public REST API.",
 	"type": "module",
 	"license": "MIT",

package/src/sessions.ts

@@ -98,19 +98,49 @@ async function create(flags: Record<string, string | boolean>): Promise<number>
 	const input = typeof flags.input === "string" ? flags.input : undefined
 	if (!input) {
 		process.stderr.write(
-			"usage: flamecast sessions create --input <text> [--model <id>] [--agent-id <id>] [--async]\n",
+			"usage: flamecast sessions create --input <text> [--config <file>] [--model <id>] [--agent-id <id>] [--async]\n",
 		)
 		return 2
 	}
+	const configPath = typeof flags.config === "string" ? flags.config : undefined
 	const model = typeof flags.model === "string" ? flags.model : "anthropic/claude-haiku-4-5"
 	const agentId = typeof flags["agent-id"] === "string" ? flags["agent-id"] : undefined
 	const asyncFlag = flags.async === true || flags.async === "true"
 	const gatewayKey = process.env.AI_GATEWAY_API_KEY
 	const config = await authed()
 
+	if (configPath && agentId) {
+		process.stderr.write("--config and --agent-id are mutually exclusive\n")
+		return 2
+	}
+
 	const body: Record<string, unknown> = { input, async: asyncFlag }
 	if (agentId) {
 		body.agentId = agentId
+	} else if (configPath) {
+		// Load an AgentConfig from a local JSON file. Use this to attach MCPs
+		// or otherwise customize the runtime beyond the --model shorthand.
+		let parsed: unknown
+		try {
+			const raw = await Bun.file(configPath).text()
+			parsed = JSON.parse(raw)
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err)
+			process.stderr.write(`read --config ${configPath}: ${msg}\n`)
+			return 1
+		}
+		if (!parsed || typeof parsed !== "object" || !("runtime" in parsed)) {
+			process.stderr.write(
+				`--config ${configPath}: missing top-level "runtime"\n`,
+			)
+			return 2
+		}
+		const agentSpec = parsed as Record<string, unknown>
+		const runtime = agentSpec.runtime as Record<string, unknown> | undefined
+		if (runtime && gatewayKey && !("auth" in runtime)) {
+			runtime.auth = { type: "api_key", key: gatewayKey }
+		}
+		body.agent = agentSpec
 	} else {
 		// runtime.auth is optional: the server fills it from its free-tier key
 		// (subject to monthly caps) when omitted and the model is on the free
@@ -146,7 +176,8 @@ const SESSIONS_USAGE = `flamecast sessions <verb>
 
 Verbs:
   list                                List recent sessions
-  create --input <text> [--model M]   Launch a Think session
+  create --input <text>               Launch a Think session
+         [--config FILE] [--model M]
          [--agent-id ID] [--async]
   get <sessionId>                     Show one session
   events <sessionId>                  Dump the event log