1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
-- LuaRocks rockspec for `libpanto-lua`: the native Lua 5.4 binding for
-- libpanto, built in pure Zig.
--
-- Distribution model (see docs/libpanto-bindings.md): this is the *source*
-- rock — universal, buildable on any OS/arch that has a Zig toolchain.
-- LuaRocks prefers a matching pre-built `.PLATFORM.rock` when one is
-- published and falls back to building this source rock otherwise (the
-- pip "wheel-or-sdist" model). Pre-built binary rocks per platform are a
-- later step; no rockspec change is needed to add them.
--
-- Build: `build.type = "command"` shells out to `zig build` (so the build
-- dependency is Zig, declared informally below since LuaRocks can't fetch
-- a compiler), then stages the emitted `panto.so` into `$(LIBDIR)` as the
-- bare module name `panto` — discovered by `require('panto')` on cpath.
rockspec_format = "3.0"
package = "libpanto-lua"
version = "0.0.0-1"
source = {
url = "git+https://code.tjp.lol/libpantograph.git",
-- The module lives in the `libpanto-lua/` subdirectory of the repo.
dir = "libpantograph/libpanto-lua",
}
description = {
summary = "Native Lua 5.4 bindings for libpanto (pure Zig).",
detailed = [[
A loadable Lua 5.4 C-module exposing libpanto's agent + pull-stream
API. require('panto') yields panto.agent{...}; an Agent runs turns
that stream Events, registers Lua tool handlers (driven by libuv via
luv), swaps provider config, manages the system prompt, and compacts.
Implemented entirely in Zig (no C translation units); the .so is
emitted by `zig build`.
]],
homepage = "https://code.tjp.lol/libpantograph",
license = "MIT",
labels = { "ai", "llm", "agent", "libpanto" },
}
-- Lua 5.4 only (Lua has no stable ABI across minor versions; a module
-- built for 5.4 will not load in 5.3 or 5.5). `luv` is required for tool
-- dispatch: tool handlers run as coroutines driven by `uv.run`.
dependencies = {
"lua >= 5.4, < 5.5",
"luv",
}
-- Zig is required at build time. LuaRocks has no notion of a Zig toolchain
-- dependency, so this is enforced by the build_command failing loudly if
-- `zig` is absent rather than by a declared dependency.
build = {
type = "command",
-- Build the shared object. `zig build` reads ./build.zig and emits
-- zig-out/lib/panto.so (see build.zig: the install step renames the
-- artifact to the bare `panto.so` a Lua C-module requires).
build_command = "zig build -Doptimize=ReleaseFast",
-- Stage the emitted module into LuaRocks' library dir under the bare
-- name `panto` so `require('panto')` resolves it on cpath. $(LIBDIR)
-- is substituted by LuaRocks at install time.
install_command = "cp zig-out/lib/panto.so $(LIBDIR)/panto.so",
}
|
