Skip to content

os-tack/libostk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

libostk

Userspace client library for the ostk kernel.

Same shape as libfuse / libsystemd / libudev: a Rust library that speaks the protocol of a kernel-like central process so userspace integration daemons don't have to reimplement it.

What it provides

  • KernelClient / KernelConnection — JSON-RPC over .ostk/ostk.sock with the full MCP handshake. Caller identity is injected into arguments.caller.
  • audit_tail — cursor-based tail of .ostk/audit.jsonl with inode-based rotation detection.
  • envelope — parser for kernel voice envelope lines ([ctx], [loadavg], [procs] and friends). Presentation-only — must not produce events.
  • CallerIdentity — trait each daemon implements to attach daemon-specific identity (Discord channel/author, Windmill job/module, etc.).
  • IntegrationResult{ok, status, result, effects, error, metrics} envelope returned by every internal op.

Who uses it

daemon what it bridges
fcp-discord Discord ↔ ostk
fcp-workflow Windmill ↔ ostk

Future: ostk-slack, ostk-github, ostk-jira, anything else that wraps an external system into ostk's verb/audit surface.

Not for

Document drivers (fcp-midi, fcp-drawio, fcp-pdf) — those implement the File Context Protocol and own editable documents. Different problem; use fcp-core instead.

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors

Languages