@flue/sdk 0.1.0 → 0.1.2

package/dist/index.mjs

@@ -1,5 +1,4 @@
-import { a as createTools, i as BUILTIN_TOOL_NAMES, s as parseFrontmatterFile, t as InMemorySessionStore } from "./session-BD0MEuO3.mjs";
-import { createFlueContext } from "./client.mjs";
+import { a as parseFrontmatterFile, n as createTools, t as BUILTIN_TOOL_NAMES } from "./agent-BYG0nVbQ.mjs";
 import * as esbuild from "esbuild";
 import * as fs from "node:fs";
 import * as path from "node:path";
@@ -9,56 +8,57 @@ import { packageUpSync } from "package-up";
 var CloudflarePlugin = class {
 	name = "cloudflare";
 	generateEntryPoint(ctx) {
-		const { agents, roles, options, resolveSDKImport } = ctx;
-		const modelProvider = options.model?.provider ?? "anthropic";
-		const modelId = options.model?.modelId ?? "claude-haiku-4-5";
+		const { agents, roles } = ctx;
 		const rolesJson = JSON.stringify(roles);
 		const webhookAgents = agents.filter((a) => a.triggers.webhook);
-		const agentImports = agents.map((a) => {
-			return `import ${agentVarName$1(a.name)} from '${a.filePath.replace(/\\/g, "/")}';`;
-		}).join("\n");
-		const manifest = JSON.stringify({ agents: agents.map((a) => ({
-			name: a.name,
-			triggers: a.triggers
-		})) }, null, 2);
-		const agentClasses = webhookAgents.map((a) => {
-			const className = agentClassName(a.name);
-			const handlerVar = agentVarName$1(a.name);
-			return `export class ${className} extends Agent {
-  async onRequest(request) {
-    return handleAgentRequest(request, this, ${JSON.stringify(a.name)}, ${handlerVar});
-  }
-}`;
-		}).join("\n\n");
 		return `
 // Auto-generated by @flue/sdk build (cloudflare)
 import { Agent, routeAgentRequest } from 'agents';
 import { Bash, InMemoryFs } from 'just-bash';
 import { getModel } from '@mariozechner/pi-ai';
-import { createFlueContext } from '${resolveSDKImport("client")}';
-import { InMemorySessionStore } from '${resolveSDKImport("session")}';
-import { bashToSessionEnv } from '${resolveSDKImport("sandbox")}';
+import { createFlueContext, InMemorySessionStore, bashToSessionEnv } from '@flue/sdk/internal';
 import { setCloudflareContext, clearCloudflareContext, cfSandboxToSessionEnv } from '@flue/sdk/cloudflare';
 
-${agentImports}
+${agents.map((a) => {
+			return `import ${agentVarName$1(a.name)} from '${a.filePath.replace(/\\/g, "/")}';`;
+		}).join("\n")}
 
 // ─── Config ─────────────────────────────────────────────────────────────────
 
 const roles = ${rolesJson};
 const skills = {};
 const systemPrompt = '';
-const manifest = ${manifest};
+const manifest = ${JSON.stringify({ agents: agents.map((a) => ({
+			name: a.name,
+			triggers: a.triggers
+		})) }, null, 2)};
 
 // ─── Infrastructure ─────────────────────────────────────────────────────────
 
-const model = getModel(${JSON.stringify(modelProvider)}, ${JSON.stringify(modelId)});
+// No build-time model default. The user sets model at runtime via
+// \`init({ model: "provider/model-id" })\` for a session default, or via
+// \`{ model: "provider/model-id" }\` on any individual prompt/skill/task call.
+const model = undefined;
 
 function resolveModel(modelString) {
   const slash = modelString.indexOf('/');
-  if (slash !== -1) {
-    return getModel(modelString.slice(0, slash), modelString.slice(slash + 1));
+  if (slash === -1) {
+    throw new Error(
+      '[flue] Invalid model "' + modelString + '". ' +
+      'Use the "provider/model-id" format (e.g. "anthropic/claude-haiku-4-5").'
+    );
   }
-  return getModel(${JSON.stringify(modelProvider)}, modelString);
+  const provider = modelString.slice(0, slash);
+  const modelId = modelString.slice(slash + 1);
+  const resolved = getModel(provider, modelId);
+  if (!resolved) {
+    throw new Error(
+      '[flue] Unknown model "' + modelString + '". ' +
+      'Provider "' + provider + '" / model id "' + modelId + '" ' +
+      'is not registered with @mariozechner/pi-ai.'
+    );
+  }
+  return resolved;
 }
 
 // ─── Sandbox Environments ───────────────────────────────────────────────────
@@ -265,7 +265,15 @@ async function handleAgentRequest(request, doInstance, agentName, handler) {
 
 // ─── Per-Agent Durable Object Classes ──────────────────────────────────────
 
-${agentClasses}
+${webhookAgents.map((a) => {
+			const className = agentClassName(a.name);
+			const handlerVar = agentVarName$1(a.name);
+			return `export class ${className} extends Agent {
+  async onRequest(request) {
+    return handleAgentRequest(request, this, ${JSON.stringify(a.name)}, ${handlerVar});
+  }
+}`;
+		}).join("\n\n")}
 
 // Re-export Sandbox DO class for wrangler binding
 export { Sandbox } from '@cloudflare/sandbox';
@@ -370,20 +378,9 @@ function agentClassName(name) {
 var NodePlugin = class {
 	name = "node";
 	generateEntryPoint(ctx) {
-		const { agents, roles, options, resolveSDKImport } = ctx;
-		const modelProvider = options.model?.provider ?? "anthropic";
-		const modelId = options.model?.modelId ?? "claude-haiku-4-5";
+		const { agents, roles } = ctx;
 		const rolesJson = JSON.stringify(roles);
 		const webhookAgents = agents.filter((a) => a.triggers.webhook);
-		const agentImports = agents.map((a) => {
-			return `import ${agentVarName(a.name)} from '${a.filePath.replace(/\\/g, "/")}';`;
-		}).join("\n");
-		const handlerMapEntries = agents.map((a) => `  ${JSON.stringify(a.name)}: ${agentVarName(a.name)},`).join("\n");
-		const webhookNames = JSON.stringify(webhookAgents.map((a) => a.name));
-		const manifest = JSON.stringify({ agents: agents.map((a) => ({
-			name: a.name,
-			triggers: a.triggers
-		})) }, null, 2);
 		return `
 // Auto-generated by @flue/sdk build (node)
 import { Hono } from 'hono';
@@ -391,12 +388,12 @@ import { streamSSE } from 'hono/streaming';
 import { serve } from '@hono/node-server';
 import { Bash, InMemoryFs, MountableFs, ReadWriteFs } from 'just-bash';
 import { getModel } from '@mariozechner/pi-ai';
-import { createFlueContext } from '${resolveSDKImport("client")}';
-import { InMemorySessionStore } from '${resolveSDKImport("session")}';
-import { bashToSessionEnv } from '${resolveSDKImport("sandbox")}';
+import { createFlueContext, InMemorySessionStore, bashToSessionEnv } from '@flue/sdk/internal';
 import { randomUUID } from 'node:crypto';
 
-${agentImports}
+${agents.map((a) => {
+			return `import ${agentVarName(a.name)} from '${a.filePath.replace(/\\/g, "/")}';`;
+		}).join("\n")}
 
 // ─── Config ─────────────────────────────────────────────────────────────────
 
@@ -405,23 +402,49 @@ const roles = ${rolesJson};
 const systemPrompt = '';
 
 const handlers = {
-${handlerMapEntries}
+${agents.map((a) => `  ${JSON.stringify(a.name)}: ${agentVarName(a.name)},`).join("\n")}
 };
 
-const webhookAgents = new Set(${webhookNames});
+const webhookAgents = new Set(${JSON.stringify(webhookAgents.map((a) => a.name))});
+
+// When the CLI starts this server via \`flue run\`, it sets FLUE_MODE=local.
+// In local mode the HTTP route accepts any registered agent (including
+// trigger-less CI-only agents). In any other mode the route is restricted to
+// agents with \`webhook: true\`, preventing accidental public exposure of
+// agents that the user only intended to invoke from their CI pipeline.
+const isLocalMode = process.env.FLUE_MODE === 'local';
 
-const manifest = ${manifest};
+const manifest = ${JSON.stringify({ agents: agents.map((a) => ({
+			name: a.name,
+			triggers: a.triggers
+		})) }, null, 2)};
 
 // ─── Infrastructure ─────────────────────────────────────────────────────────
 
-const model = getModel(${JSON.stringify(modelProvider)}, ${JSON.stringify(modelId)});
+// No build-time model default. The user sets model at runtime via
+// \`init({ model: "provider/model-id" })\` for a session default, or via
+// \`{ model: "provider/model-id" }\` on any individual prompt/skill/task call.
+const model = undefined;
 
 function resolveModel(modelString) {
   const slash = modelString.indexOf('/');
-  if (slash !== -1) {
-    return getModel(modelString.slice(0, slash), modelString.slice(slash + 1));
+  if (slash === -1) {
+    throw new Error(
+      '[flue] Invalid model "' + modelString + '". ' +
+      'Use the "provider/model-id" format (e.g. "anthropic/claude-haiku-4-5").'
+    );
+  }
+  const provider = modelString.slice(0, slash);
+  const modelId = modelString.slice(slash + 1);
+  const resolved = getModel(provider, modelId);
+  if (!resolved) {
+    throw new Error(
+      '[flue] Unknown model "' + modelString + '". ' +
+      'Provider "' + provider + '" / model id "' + modelId + '" ' +
+      'is not registered with @mariozechner/pi-ai.'
+    );
   }
-  return getModel(${JSON.stringify(modelProvider)}, modelString);
+  return resolved;
 }
 
 // ─── Sandbox Environments ───────────────────────────────────────────────────
@@ -493,7 +516,7 @@ app.post('/agents/:name/:sessionId', async (c) => {
   if (!handlers[name]) {
     return c.json({ error: 'Agent not found' }, 404);
   }
-  if (!webhookAgents.has(name)) {
+  if (!webhookAgents.has(name) && !isLocalMode) {
     return c.json({ error: 'Agent "' + name + '" is not web-accessible (no webhook trigger)' }, 404);
   }
 
@@ -572,7 +595,12 @@ const port = parseInt(process.env.PORT || '3000', 10);
 
 const server = serve({ fetch: app.fetch, port });
 console.log('[flue] Server listening on http://localhost:' + port);
-console.log('[flue] Available agents: ' + ${JSON.stringify(webhookAgents.map((a) => a.name).join(", "))});
+if (isLocalMode) {
+  console.log('[flue] Mode: local (all agents invokable, including trigger-less)');
+  console.log('[flue] Available agents: ' + ${JSON.stringify(agents.map((a) => a.name).join(", "))});
+} else {
+  console.log('[flue] Available agents: ' + ${JSON.stringify(webhookAgents.map((a) => a.name).join(", "))});
+}
 
 process.on('SIGINT', () => { server.close(); process.exit(0); });
 process.on('SIGTERM', () => { server.close(); process.exit(0); });
@@ -603,13 +631,14 @@ async function build(options) {
 	const roles = discoverRoles(agentDir);
 	const agents = discoverAgents(agentDir);
 	if (agents.length === 0) throw new Error(`No agents found in ${path.join(agentDir, ".flue/agents/")}`);
-	for (const agent of agents) if (!(agent.triggers.webhook || agent.triggers.cron)) throw new Error(`[flue] Agent "${agent.name}" has no triggers configured. Add a triggers export to your agent file:\n\n  export const triggers = { webhook: true };\n\nAvailable triggers: webhook (HTTP endpoint), cron (scheduled)`);
 	const webhookAgents = agents.filter((a) => a.triggers.webhook);
 	const cronAgents = agents.filter((a) => a.triggers.cron);
+	const triggerlessAgents = agents.filter((a) => !a.triggers.webhook && !a.triggers.cron);
 	console.log(`[flue] Found ${Object.keys(roles).length} role(s): ${Object.keys(roles).join(", ") || "(none)"}`);
 	console.log(`[flue] Found ${agents.length} agent(s): ${agents.map((a) => a.name).join(", ")}`);
 	if (webhookAgents.length > 0) console.log(`[flue] Webhook agents: ${webhookAgents.map((a) => a.name).join(", ")}`);
 	if (cronAgents.length > 0) console.log(`[flue] Cron agents (manifest only): ${cronAgents.map((a) => `${a.name} (${a.triggers.cron})`).join(", ")}`);
+	if (triggerlessAgents.length > 0) console.log(`[flue] CLI-only agents (no HTTP route in deployed build): ${triggerlessAgents.map((a) => a.name).join(", ")}`);
 	console.log(`[flue] AGENTS.md and .agents/skills/ will be discovered at runtime from session cwd`);
 	const distDir = path.join(agentDir, "dist");
 	fs.mkdirSync(distDir, { recursive: true });
@@ -624,8 +653,7 @@ async function build(options) {
 		agents,
 		roles,
 		agentDir,
-		options,
-		resolveSDKImport: resolveSDKImportFn
+		options
 	};
 	const serverCode = plugin.generateEntryPoint(ctx);
 	const entryPath = path.join(distDir, "_entry_server.ts");
@@ -758,18 +786,6 @@ function getSDKDir() {
 		return __dirname;
 	}
 }
-function getSDKSrcDir() {
-	const thisDir = getSDKDir();
-	if (thisDir.endsWith("/dist") || thisDir.endsWith("\\dist")) {
-		const srcDir = path.join(path.dirname(thisDir), "src");
-		if (fs.existsSync(srcDir)) return srcDir;
-	}
-	return thisDir;
-}
-function resolveSDKImportFn(module) {
-	const srcDir = getSDKSrcDir();
-	return path.join(srcDir, `${module}.ts`).replace(/\\/g, "/");
-}
 
 //#endregion
-export { BUILTIN_TOOL_NAMES, InMemorySessionStore, build, createFlueContext, createTools };
+export { BUILTIN_TOOL_NAMES, build, createTools };

package/dist/internal.d.mts

@@ -0,0 +1,15 @@
+import { S as SessionStore, y as SessionData } from "./types-C8tsaK1j.mjs";
+import { FlueContextConfig, FlueContextInternal, createFlueContext } from "./client.mjs";
+import { bashToSessionEnv } from "./sandbox.mjs";
+import "valibot";
+
+//#region src/session.d.ts
+/** In-memory session store. Sessions persist for the lifetime of the process. */
+declare class InMemorySessionStore implements SessionStore {
+  private store;
+  save(id: string, data: SessionData): Promise<void>;
+  load(id: string): Promise<SessionData | null>;
+  delete(id: string): Promise<void>;
+}
+//#endregion
+export { type FlueContextConfig, type FlueContextInternal, InMemorySessionStore, bashToSessionEnv, createFlueContext };

package/dist/internal.mjs

@@ -0,0 +1,6 @@
+import "./agent-BYG0nVbQ.mjs";
+import { t as InMemorySessionStore } from "./session-BRLCNVG1.mjs";
+import { bashToSessionEnv } from "./sandbox.mjs";
+import { createFlueContext } from "./client.mjs";
+
+export { InMemorySessionStore, bashToSessionEnv, createFlueContext };

package/dist/sandbox.d.mts

@@ -1,4 +1,4 @@
-import { b as SessionEnv, c as CommandDef, r as BashLike, u as FileStat, v as SandboxFactory, w as ShellResult } from "./types-xNvqlohs.mjs";
+import { b as SessionEnv, c as CommandDef, r as BashLike, u as FileStat, v as SandboxFactory, w as ShellResult } from "./types-C8tsaK1j.mjs";
 
 //#region src/sandbox.d.ts
 declare function bashToSessionEnv(bash: BashLike): SessionEnv;

package/dist/sandbox.mjs

@@ -1,4 +1,5 @@
-import { r as normalizePath } from "./session-BD0MEuO3.mjs";
+import "./agent-BYG0nVbQ.mjs";
+import { r as normalizePath } from "./session-BRLCNVG1.mjs";
 
 //#region src/sandbox.ts
 function bashToSessionEnv(bash) {