F∆I orchestrator module — turns natural-language goals into structured execution plans (Phase 0.5, version 0.8.0)
Find a file
flemming-it fcf74f179f
Some checks failed
CI / Linux x86_64 (Forgejo) (push) Failing after 1s
feat: schema_version 3 with DE/EN field descriptions
Signed-off-by: flemming-it <sf@flemming.it>
2026-06-01 22:46:17 +02:00
.forgejo/workflows ci: sign release bundles with FAI_SIGNING_KEY 2026-05-28 23:14:29 +02:00
src feat: probe Ollama model digest, emit as model_digest output (v0.3.1) 2026-05-03 23:06:27 +02:00
tests feat: real LLM call via wasi-http (Ollama adapter) — v0.2.0 2026-04-29 21:27:07 +02:00
.gitignore Initial commit 2026-04-29 16:31:31 +02:00
Cargo.toml chore: SDK URL → git.flemming.ai/fai/module-sdk-rust 2026-05-26 13:16:53 +02:00
LICENSE Initial commit 2026-04-29 16:31:31 +02:00
module.yaml feat: schema_version 3 with DE/EN field descriptions 2026-06-01 22:46:17 +02:00
README.md feat: deterministic stub orchestrator (v0.1.0) 2026-04-29 17:43:46 +02:00
rust-toolchain.toml feat: deterministic stub orchestrator (v0.1.0) 2026-04-29 17:43:46 +02:00

orchestrator-llm

F∆I orchestrator module — turns natural-language goals into structured execution plans (fai_hub::plan::Plan JSON).

Status

v0.1.0deterministic stub. Always returns a structurally valid plan that creates a single debug.echo flow regardless of the goal. Useful as a smoke test for the full module → plan → fai plan apply path.

v0.2.0 (next) — replaces the stub with an actual LLM call to a configured endpoint (Ollama or OpenAI-compatible) once the F∆I platform exposes outbound HTTP to permitted modules via wasi-http.

Capability

  • orchestrator.plan@0.1.0

Inputs

Name Type Description
goal text Natural-language goal
available_capabilities text (JSON list) Optional. Capabilities currently installed in the hub.
store_capabilities text (JSON list) Optional. All capabilities the hub knows about.

Outputs

Name Type Description
plan json Plan JSON deserializable by fai_hub::plan::Plan

Permissions

None. The deterministic stub does not call out. v0.2.0 will declare net: <llm-endpoint> once the platform supports it.

Build

cargo build --release --target wasm32-wasip2

The built WASM lands at target/wasm32-wasip2/release/orchestrator_llm.wasm.

Test

Host-side unit and integration tests exercise the pure plan-building logic (no WASM build required for tests):

cargo test

Use from a flow

schema_version: 1
name: plan-from-goal
inputs:
  goal: text
steps:
  - id: orchestrate
    use: orchestrator.plan@^0
    with:
      goal: $inputs.goal
outputs:
  plan: $orchestrate.plan

The plan output is JSON — pipe it through fai plan apply - to execute it.

License

Apache-2.0. See LICENSE.