@flue/sdk 0.3.11 → 0.4.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as ShellResult, C as Role, D as SessionOptions, E as SessionEnv, F as ToolParameters, M as SkillOptions, N as TaskOptions, O as SessionStore, P as ToolDef, T as SessionData, _ as FlueSessions, a as BashLike, b as PromptResponse, c as BuildPlugin, d as FileStat, f as FlueAgent, g as FlueSession, h as FlueEventCallback, i as BashFactory, j as Skill, k as ShellOptions, l as Command, m as FlueEvent, n as AgentInfo, o as BuildContext, p as FlueContext, r as AgentInit, s as BuildOptions, t as AgentConfig, u as CommandDef, v as ModelConfig, w as SandboxFactory, y as PromptOptions } from "./types-DGpyKMFm.mjs";
+import { A as SessionStore, C as PromptUsage, D as SessionData, E as SandboxFactory, F as TaskOptions, I as ThinkingLevel, L as ToolDef, M as ShellResult, N as Skill, O as SessionEnv, P as SkillOptions, R as ToolParameters, S as PromptResultResponse, T as Role, _ as FlueSessions, a as BashLike, b as PromptOptions, c as BuildPlugin, d as FlueAgent, f as FlueContext, g as FlueSession, h as FlueFs, i as BashFactory, j as ShellOptions, k as SessionOptions, l as CallHandle, m as FlueEventCallback, n as AgentInfo, o as BuildContext, p as FlueEvent, r as AgentInit, s as BuildOptions, t as AgentConfig, u as FileStat, v as ModelConfig, x as PromptResponse, y as PromptModel } from "./types-BAmV4f3Q.mjs";
 import { AgentTool, AgentToolResult } from "@mariozechner/pi-agent-core";
 
 //#region src/build.d.ts
@@ -11,35 +11,45 @@ interface BuildResult {
   changed: boolean;
 }
 /**
- * Build a workspace into a deployable artifact.
+ * Build a project into a deployable artifact.
  *
- * `options.workspaceDir` is treated as an explicit workspace root — the directory
- * directly containing agents/ and roles/. No .flue/ waterfall is performed here;
- * callers that want waterfall behavior (e.g. the CLI when --workspace is omitted)
- * should use `resolveWorkspaceFromCwd` first.
+ * `options.root` is the project root — typically the user's cwd. Source files
+ * (agents, roles) are discovered from one of two locations inside the root,
+ * with the same precedence rule the CLI uses:
+ *
+ *   - If `<root>/.flue/` exists, it is the source root. Look for
+ *     `.flue/agents/` and `.flue/roles/`. The bare `<root>/agents/` and
+ *     `<root>/roles/` are ignored entirely (no mixing).
+ *   - Otherwise, look at `<root>/agents/` and `<root>/roles/`.
+ *
+ * Build output lands in `options.output` (defaults to `<root>/dist`).
  *
  * AGENTS.md and .agents/skills/ are NOT bundled — discovered at runtime from session cwd.
  */
 declare function build(options: BuildOptions): Promise<BuildResult>;
 /**
- * Resolve a Flue workspace directory from the current working directory,
- * using the two-layout convention. Intended for the CLI when `--workspace` is
- * not provided — callers that pass an explicit workspace path should skip this
- * and pass the path straight to `build()`.
+ * Resolve the source root for a project, using the `.flue/`-as-src
+ * convention (analogous to Next.js's `src/` folder).
  *
- * Two supported layouts, checked in order:
- *   1. `<cwd>/.flue/` — use this when Flue is embedded in an existing project.
- *   2. `<cwd>/` — use this when the project itself is the Flue workspace.
+ * If `<root>/.flue/` exists, it is the source root. Otherwise the source root
+ * is the project root itself. The two layouts never mix — if `.flue/` exists,
+ * the bare layout is ignored entirely (even if a `<root>/agents/` directory
+ * also happens to be present).
  *
- * If `.flue/` exists, it wins unconditionally — no mixing with the bare layout.
- * Returns null if neither is present so the caller can produce a helpful error.
+ * The project root (cwd) stays the same in both cases — `.flue/` only shifts
+ * where source files are discovered from. The build output directory is
+ * independent (defaults to `<root>/dist`, override with `output`).
  */
-declare function resolveWorkspaceFromCwd(cwd: string): string | null;
+declare function resolveSourceRoot(root: string): string;
 //#endregion
 //#region src/dev.d.ts
 interface DevOptions {
-  workspaceDir: string;
-  outputDir: string;
+  root: string;
+  /**
+   * Where the build artifacts are written. Defaults to `<root>/dist`.
+   * See {@link BuildOptions.output} for details.
+   */
+  output?: string;
   target: 'node' | 'cloudflare';
   /** Defaults to 3583 ("FLUE" on a phone keypad). */
   port?: number;
@@ -113,4 +123,16 @@ interface CreateToolsOptions {
 }
 declare function createTools(env: SessionEnv, options?: CreateToolsOptions): AgentTool<any>[];
 //#endregion
-export { type AgentConfig, type AgentInfo, type AgentInit, BUILTIN_TOOL_NAMES, type BashFactory, type BashLike, type BuildContext, type BuildOptions, type BuildPlugin, type Command, type CommandDef, DEFAULT_DEV_PORT, type DevOptions, type FileStat, type FlueAgent, type FlueContext, type FlueEvent, type FlueEventCallback, type FlueSession, type FlueSessions, type ModelConfig, type PromptOptions, type PromptResponse, type Role, type SandboxFactory, type SessionData, type SessionEnv, type SessionOptions, type SessionStore, type ShellOptions, type ShellResult, type Skill, type SkillOptions, type TaskOptions, type ToolDef, type ToolParameters, build, createTools, dev, parseEnvFiles, resolveEnvFiles, resolveWorkspaceFromCwd };
+//#region src/result.d.ts
+/**
+ * Thrown when the LLM calls the `give_up` tool, indicating it cannot produce a
+ * result that conforms to the required schema. Carries the LLM-supplied
+ * `reason` and the assistant transcript leading up to the give-up.
+ */
+declare class ResultUnavailableError extends Error {
+  readonly reason: string;
+  readonly assistantText: string;
+  constructor(reason: string, assistantText: string);
+}
+//#endregion
+export { type AgentConfig, type AgentInfo, type AgentInit, BUILTIN_TOOL_NAMES, type BashFactory, type BashLike, type BuildContext, type BuildOptions, type BuildPlugin, type CallHandle, DEFAULT_DEV_PORT, type DevOptions, type FileStat, type FlueAgent, type FlueContext, type FlueEvent, type FlueEventCallback, type FlueFs, type FlueSession, type FlueSessions, type ModelConfig, type PromptModel, type PromptOptions, type PromptResponse, type PromptResultResponse, type PromptUsage, ResultUnavailableError, type Role, type SandboxFactory, type SessionData, type SessionEnv, type SessionOptions, type SessionStore, type ShellOptions, type ShellResult, type Skill, type SkillOptions, type TaskOptions, type ThinkingLevel, type ToolDef, type ToolParameters, build, createTools, dev, parseEnvFiles, resolveEnvFiles, resolveSourceRoot };