Four example workflow packages proving the engine end-to-end: - Bug Report Triage: public entry, branch routing, SLA timer - Employee Onboarding: Starlark automated stages, signoff gate - Content Approval: multi-party signoff, revision cycle loop - Webhook Notifier: http.post, connections fallback, delivery logging Demo surface at /s/workflow-demo with cards, stage diagrams, Starlark viewer, API examples, active/published status, and copyable public links. Engine fixes: started_by in automated context, sla_seconds in package installer, parseSnapshotStages for wrapped/legacy formats. Platform fixes: extension SDK boot in base.html (Preact globals + boot()), admin teams paginated response extraction, workflow adoption endpoint (POST /teams/:teamId/workflows/:id/adopt), team-admin copyable link. Review pass remains on roadmap for remaining UI polish. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Packages
Installable .pkg archives for Chat Switchboard. 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.