@flue/sdk 0.3.7 → 0.3.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +20 -7
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,11 +14,10 @@ Flue isn't another AI SDK. It's a proper runtime-agnostic framework — think As
|
|
|
14
14
|
|
|
15
15
|
## Packages
|
|
16
16
|
|
|
17
|
-
| Package
|
|
18
|
-
|
|
|
19
|
-
| [`@flue/sdk`](packages/sdk)
|
|
20
|
-
| [`@flue/cli`](packages/cli)
|
|
21
|
-
| [`@flue/connectors`](packages/connectors) | Third-party connectors for sandboxes, etc. |
|
|
17
|
+
| Package | Description |
|
|
18
|
+
| ----------------------------- | --------------------------------------- |
|
|
19
|
+
| [`@flue/sdk`](packages/sdk) | Core SDK: build system, sessions, tools |
|
|
20
|
+
| [`@flue/cli`](packages/cli) | CLI for building and running agents |
|
|
22
21
|
|
|
23
22
|
## Examples
|
|
24
23
|
|
|
@@ -146,17 +145,19 @@ export default async function ({ init, payload }: FlueContext) {
|
|
|
146
145
|
}
|
|
147
146
|
```
|
|
148
147
|
|
|
149
|
-
### Coding Agent (
|
|
148
|
+
### Coding Agent (Remote Sandbox)
|
|
150
149
|
|
|
151
150
|
The examples above all run on a lightweight virtual sandbox — no container needed. But for a full coding agent, you want a real Linux environment with git, Node.js, a browser, and a cloned repo ready to go.
|
|
152
151
|
|
|
153
152
|
Daytona's declarative image builder lets you define the environment in code. The image is cached after the first build, so subsequent sessions start instantly.
|
|
154
153
|
|
|
154
|
+
Install the Daytona connector with `flue add daytona | <your-agent>` (e.g. `claude`, `opencode`, `codex`, `cursor-agent`). It writes a small `connectors/daytona.ts` adapter into your project that you import directly.
|
|
155
|
+
|
|
155
156
|
```ts
|
|
156
157
|
// .flue/agents/code.ts
|
|
157
158
|
import { Type, type FlueContext, type ToolDef } from '@flue/sdk/client';
|
|
158
159
|
import { Daytona } from '@daytona/sdk';
|
|
159
|
-
import { daytona } from '
|
|
160
|
+
import { daytona } from '../connectors/daytona';
|
|
160
161
|
|
|
161
162
|
export const triggers = { webhook: true };
|
|
162
163
|
|
|
@@ -333,6 +334,18 @@ const agent = await init({
|
|
|
333
334
|
const session = await agent.session();
|
|
334
335
|
```
|
|
335
336
|
|
|
337
|
+
## Connectors
|
|
338
|
+
|
|
339
|
+
Connectors adapt third-party services (sandbox providers, etc.) into Flue. They are not an npm package — they are markdown installation instructions hosted at `https://flueframework.com/cli/connectors/` and applied to your project by your AI coding agent.
|
|
340
|
+
|
|
341
|
+
```bash
|
|
342
|
+
flue add # list available connectors
|
|
343
|
+
flue add daytona | claude # pipe to your coding agent (claude, opencode, codex, cursor-agent, ...)
|
|
344
|
+
flue add https://e2b.dev --category sandbox | claude # build one from scratch — pass the provider's docs URL as the agent's starting point
|
|
345
|
+
```
|
|
346
|
+
|
|
347
|
+
The CLI fetches the markdown for the named connector and prints it to stdout when run by an agent (or with `--print`), or shows a short copyable `flue add ... | <agent>` recipe when run by a human in a terminal. Your agent reads the markdown and writes a small TypeScript adapter into `./.flue/connectors/<name>.ts` (or `./connectors/<name>.ts` for the root layout).
|
|
348
|
+
|
|
336
349
|
## Running Agents
|
|
337
350
|
|
|
338
351
|
### Local Development (`flue dev`)
|