Skip to content
inseam mark: dash dot dashinseam mark: dash dot dashinseam

WIT world: transform-plugin

  • Imports:
    • interface inseam:plugin/host@0.1.0
  • Exports:
    • interface inseam:plugin/transform@0.1.0

Import interface inseam:plugin/host@0.1.0

Section titled “Import interface inseam:plugin/host@0.1.0”

Host capabilities, granted per the plugin’s manifest. Calling a function the manifest did not request (or whose budget is spent) returns an error string; a well-behaved transform degrades to emitting less.

Functions

Section titled “Functions”

log: func

Section titled “log: func”

Diagnostic logging into the node’s tracing output.

Params
Section titled “Params”
  • message: string

llm-complete: func

Section titled “llm-complete: func”

One metered LLM completion (requires the llm capability). Model choice and budgeting belong to the host, not the plugin.

Params
Section titled “Params”
  • system: string
  • user: string
Return values
Section titled “Return values”
  • result<string, string>

llm-describe-image: func

Section titled “llm-describe-image: func”

One metered vision call: OCR, captioning (requires llm).

Params
Section titled “Params”
  • prompt: string
  • mimetype: string
  • image: list<u8>
Return values
Section titled “Return values”
  • result<string, string>

source-bytes: func

Section titled “source-bytes: func”

The raw bytes of the claimed source (requires the source-bytes capability; granted at the root only).

Return values
Section titled “Return values”
  • result<list<u8>, string>

Export interface inseam:plugin/transform@0.1.0

Section titled “Export interface inseam:plugin/transform@0.1.0”

Types

Section titled “Types”

record envelope

Section titled “record envelope”

The envelope of the source under transformation.

Record Fields
Section titled “Record Fields”

  • source-type: string

  • content-type: string

  • hint: option<string>

  • modified: option<s64>

    Unix-epoch seconds.

  • raw-bytes: u64

record claim-spec

Section titled “record claim-spec”

What this transform claims. The bridge intersects these with the manifest’s declared claims — the effective claim set is declared AND exported, so a component cannot quietly widen its reach past what its manifest promised.

Record Fields
Section titled “Record Fields”

  • mimetypes: list<string>

    Mimetype essences (`image/png`) or `type/*` patterns.

  • roots-only: bool

    Claim source roots only, or emitted fragments too.

record fragment

Section titled “record fragment”

One emitted fragment. WIT has no recursive types, so the sprout tree is flattened: parent indexes an EARLIER fragment in the same list, and none hangs the fragment off the claimed fragment itself.

Record Fields
Section titled “Record Fields”

  • parent: option<u32>

  • mimetype: string

    Mimetype of the emitted fragment, params allowed (`text/plain;via=ocr`).

  • relation: string

    Relation to the parent: `contains`, `derived-from`, `transcribes`, `links-to`, or `mentions`.

  • text: option<string>

record output

Section titled “record output”
Record Fields
Section titled “Record Fields”

Functions

Section titled “Functions”

claims: func

Section titled “claims: func”
Return values
Section titled “Return values”

apply: func

Section titled “apply: func”

Transform one claimed fragment. Infallible by contract on the seam: an error here is logged and treated as an empty output — indexing is enrichment, and a broken transform must not gate the source.

Params
Section titled “Params”
  • env: envelope
  • mimetype: string
  • is-root: bool
  • text: option<string>
Return values
Section titled “Return values”