All checks were successful
CI/CD / detect-changes (push) Successful in 4s
CI/CD / test-runners (push) Has been skipped
CI/CD / e2e-smoke (push) Has been skipped
CI/CD / test-frontend (push) Successful in 6s
CI/CD / test-go-pg (push) Successful in 2m49s
CI/CD / test-sqlite (push) Successful in 3m4s
CI/CD / build-and-deploy (push) Successful in 1m15s
Co-authored-by: Jeffrey Smith <jasafpro@gmail.com> Co-committed-by: Jeffrey Smith <jasafpro@gmail.com>
Packages
Installable .pkg archives for Chat Armature. Each subdirectory is a
package — either a surface (routable UI), an extension (hooks/tools/pipes),
or both (full type).
v0.28.7: Renamed from surfaces/. The .pkg format replaces .surface.
See docs/PACKAGES.md for the complete manifest schema and authoring guide. For workflow packages, see docs/WORKFLOW-PACKAGES.md.
Building
./packages/build.sh # build all → dist/*.pkg
./packages/build.sh icd-test-runner # build one
Installing
curl -X POST http://localhost:8080/api/v1/admin/packages/install \
-H "Authorization: Bearer $TOKEN" \
-F file=@dist/icd-test-runner.pkg
Or use the admin UI → System → Packages → Upload.
Archive Format
A .pkg file is a zip containing:
manifest.json — required (must have "id" and "title")
js/ — optional JavaScript assets
css/ — optional stylesheets
assets/ — optional images, icons, etc.
The manifest type field determines behavior:
surface(default) — routable page at/s/:slugextension— hooks, tools, and/or pipe filtersfull— both a surface and an extension
.surface archives are accepted as a backward-compatible alias.