@sigrun/shared 0.0.0-stage → 0.1.0

package/dist/views.js

@@ -0,0 +1,38 @@
+/**
+ * §5 wire types (Tasks 9a–9d) — THE channel contract.
+ *
+ * Every HTTP/SSE payload shape both clients (webui, tui) consume is
+ * declared or re-exported here, and both import it directly (the tui
+ * imports from `@sigrun/shared`, never from server source). It is the
+ * intended basis for a generated OpenAPI schema later, so the purity
+ * rules are enforced by `test/views-purity.test.ts`:
+ *
+ * - imports and re-exports are `import type`/`export type` from SIBLING
+ *   shared modules only, and type-only — they erase at compile time and
+ *   contribute no runtime (the only runtime exports here are local pure
+ *   constants);
+ * - no external package imports, no server/framework types, no route
+ *   logic (the server's `src/server/views.ts` owns the RUNTIME
+ *   serializer and re-exports this module);
+ * - no `node:` imports (the webui compiles DOM-only against this file).
+ *
+ * Spec §5: the server serves pi-durable's NATIVE views, not a bespoke
+ * endpoint list — so the conversation wire payload IS the view shape
+ * (`{ conversation, entries, docs }`; JSON-safe by construction) PLUS
+ * the sigrun-side `steer` field. The upstream view's inner shapes are
+ * re-declared STRUCTURALLY below (`ViewConversation`, `ViewEntry`,
+ * `ViewMessage`, `WireBlock`): deliberately loose where channels only
+ * read a subset, and structurally compatible with the upstream types so
+ * the server's serializer (which spreads an upstream
+ * `ConversationView`) typechecks against this declaration — the
+ * captured-schema fixture (`src/server/schema-fixture.ts`,
+ * `view-schema.json`) pins the UPSTREAM shape, and
+ * `test/schema-drift.test.ts` trips on upstream drift.
+ *
+ * `serializeConversationView` (src/server/views.ts) is the single
+ * chokepoint every §5 endpoint that returns a conversation goes through
+ * — including each SSE watch frame (T9d) — so the fixture continues to
+ * describe the wire.
+ */
+/** The `Content-Type` of the JSONL export/import wire (Task 5b/5c). */
+export const JSONL_CONTENT_TYPE = "application/x-ndjson";

package/package.json

@@ -1,6 +1,83 @@
 {
-  "name": "@sigrun/shared",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@sigrun/shared",
+	"version": "0.1.0",
+	"description": "sigrun shared leaf package — theme tokens, turn/conversation shaping, and the channel wire types (pure leaf, zero dependencies)",
+	"type": "module",
+	"exports": {
+		"./themes": {
+			"types": "./dist/themes.d.ts",
+			"default": "./dist/themes.js"
+		},
+		"./conversations": {
+			"types": "./dist/conversations.d.ts",
+			"default": "./dist/conversations.js"
+		},
+		"./turns": {
+			"types": "./dist/turns.d.ts",
+			"default": "./dist/turns.js"
+		},
+		"./session-meta": {
+			"types": "./dist/session-meta.d.ts",
+			"default": "./dist/session-meta.js"
+		},
+		"./commands": {
+			"types": "./dist/commands.d.ts",
+			"default": "./dist/commands.js"
+		},
+		"./interactions": {
+			"types": "./dist/interactions.d.ts",
+			"default": "./dist/interactions.js"
+		},
+		"./ambient": {
+			"types": "./dist/ambient.d.ts",
+			"default": "./dist/ambient.js"
+		},
+		"./access": {
+			"types": "./dist/access.d.ts",
+			"default": "./dist/access.js"
+		},
+		"./settings": {
+			"types": "./dist/settings.d.ts",
+			"default": "./dist/settings.js"
+		},
+		"./views": {
+			"types": "./dist/views.d.ts",
+			"default": "./dist/views.js"
+		},
+		"./view-delta": {
+			"types": "./dist/view-delta.d.ts",
+			"default": "./dist/view-delta.js"
+		},
+		"./jobs": {
+			"types": "./dist/jobs.d.ts",
+			"default": "./dist/jobs.js"
+		}
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json"
+	},
+	"devDependencies": {
+		"typescript": "^7.0.2"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"files": [
+		"dist",
+		"CHANGELOG.md"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "github",
+		"url": "git+https://github.com/sigrun-ai/sigrun.git",
+		"directory": "shared"
+	},
+	"bugs": {
+		"url": "https://github.com/sigrun-ai/sigrun/issues"
+	},
+	"homepage": "https://github.com/sigrun-ai/sigrun/tree/main/shared#readme",
+	"publishConfig": {
+		"access": "public",
+		"provenance": true
+	}
+}