CI / Linux x86_64 (Forgejo) (push) Successful in 1m34s

Details

feat: initial text-translate v0.1.0 (text.translate@0.1.0)

Ollama-backed translation module — third real F∆I capability,
following text.extract and llm.chat. Used for the second leg of
a regulated document workflow (extract -> translate -> review
-> summarise).

Capability:
  Inputs:
    text             : text   (source text)
    target_language  : text   (e.g. "German", "French")
    source_language  : text   (optional hint; empty = auto)
    endpoint         : text   (Ollama /api/chat URL)
    model            : text
    api_key          : text   (optional)

  Outputs:
    translation      : text
    source_language  : text   (echo for audit)
    target_language  : text   (echo for audit)
    model_endpoint   : text
    model_name       : text
    model_digest     : text   (Ollama /api/show probe; empty
                                for non-Ollama or transient
                                failures)

  Permissions: net to localhost / 127.0.0.1 / api.openai.com /
               api.anthropic.com.

The translation prompt is conservative: a fixed system prompt
demands faithful translation with structure preservation and
emits no metadata, no quoting. The user prompt names the target
language and (when supplied) the source language. The LLM
client + digest-probe pattern is reused verbatim from llm-chat;
when a third module joins, the shared client moves into a small
crate.

14 host-side tests cover prompt-building, Ollama-shaped response
parsing, URL transform, digest extraction (top-level + nested),
end-to-end success, end-to-end probe-failure swallow, and
end-to-end skip-for-non-Ollama.

Wasm artifact verified to build with v1.0 fai:platform imports
baked in. Bootstrapped via 'fai new module text.translate'.

Signed-off-by: flemming-it <sf@flemming.it>

2026-05-04 10:53:10 +02:00

1.1 KiB

Raw Blame History

text-translate

Provides the text.translate capability for F∆I Platform.

Build

cargo build --release --target wasm32-wasip2

Test

cargo test                 # host-side unit + integration tests
fai test .                 # load the wasm component in the runtime sandbox

Authoring with fai-module-sdk

The module body is one decorated function:

#[fai_module]
pub fn invoke(_ctx: Context, inputs: Inputs) -> Result<Outputs, ModuleError> {
    let message = inputs.require_text("message")?;
    Ok(Outputs::new().with_text("reply", format!("got: {message}")))
}

The macro hides the wit_bindgen call, the Guest impl, the Payload variant matching, and the wit_bindgen::export! invocation. See fai-module-sdk documentation for the full surface.

SDK source

The Cargo.toml git-deps fai-module-sdk from https://git.flemming.ws/fai/module-sdk.git. If your environment requires authentication for that host (e.g. Forgejo with REQUIRE_SIGNIN_VIEW=true), set up git config insteadOf with your PAT, or use cargo:net.git-fetch-with-cli=true plus a credential helper.

License

Apache-2.0

1.1 KiB Raw Blame History