@weiliang0121/capix-protocol 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wei.liang (https://github.com/weiliang0121)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,26 @@
-# Temporary Holding Version
+# @weiliang0121/capix-protocol
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Explicit Transcript baseline, delta and error wire values, with single-frame admission. The only public entry point is the package root.
+
+```sh
+npm install @weiliang0121/capix-protocol
+```
+
+```ts
+import { acceptTranscriptUpdate, type TranscriptUpdate } from '@weiliang0121/capix-protocol';
+
+const update: TranscriptUpdate = acceptTranscriptUpdate(JSON.parse(payload));
+if (update.type === 'baseline') console.log(update.snapshot.messages);
+```
+
+`acceptTranscriptUpdate` validates one complete value, rejects unknown fields and invalid message/range/segment/revision shapes, and returns fixed data. This does not establish delivery continuity, replace a consumer's source, authorize recovery or implement HTTP. Those responsibilities belong to the consuming application.
+
+Public types: `TranscriptWireMessage`, `TranscriptWireSnapshot`, `TranscriptWireEvent`, `TranscriptFrame`, `TranscriptUpdate`. These are explicit transport representations; entity APIs belong to `capix-transcript`. Invocation events belong to `capix-invocation/events`, record data and validation to `capix-records/data`, and shared relation identity to `capix-contracts`.
+
+Application DTOs and endpoint admission belong to each host application. This package does not reexport entity implementations or business protocols.
+
+ES modules and TypeScript declarations. The npm distribution contains compiled JavaScript, declarations, this README and the MIT license; no HTTP, Node-specific implementation or UI dependency is introduced by this entry point.
+
+## License
+
+MIT. Copyright (c) 2026 wei.liang. See [LICENSE](LICENSE).

package/dist/acceptance.d.ts

@@ -0,0 +1,3 @@
+import { type Stable } from '@weiliang0121/capix-contracts';
+import type { TranscriptUpdate } from './transcript.js';
+export declare function acceptTranscriptUpdate(value: unknown): Stable<TranscriptUpdate>;

package/dist/acceptance.js

@@ -0,0 +1,2 @@
+/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{stableValue}from"@weiliang0121/capix-contracts";function acceptTranscriptUpdate(value){const fixed=stableValue(value),update=record(fixed);if(update.type==="baseline"){keys(update,["type","snapshot"]);const snapshot=record(update.snapshot);keys(snapshot,["id","revision","start","end","starts","messages"]),text(snapshot.id),integer(snapshot.revision),integer(snapshot.end),snapshot.start!==0&&fail(),messages(snapshot.messages),(snapshot.messages.length!==snapshot.end||!Array.isArray(snapshot.starts)||snapshot.starts.length===0||snapshot.starts[0]!==0)&&fail();let previous=-1;for(const start of snapshot.starts)integer(start),(start<=previous||previous>=0&&start>=snapshot.end)&&fail(),previous=start;const minimumRevision=snapshot.messages.length?snapshot.starts.length:0,maximumRevision=snapshot.messages.length+snapshot.starts.length-1;(snapshot.revision<minimumRevision||snapshot.revision>maximumRevision)&&fail()}else if(update.type==="delta"){keys(update,["type","event"]);const event=record(update.event);if(keys(event,["type","transcriptId","revision","occurredAt","change"],["origin"]),event.type!=="transcript"&&fail(),text(event.transcriptId),integer(event.revision,1),text(event.occurredAt),Number.isFinite(Date.parse(event.occurredAt))||fail(),Object.hasOwn(event,"origin")){const origin=record(event.origin);keys(origin,["contextId"]),text(origin.contextId)}const change=record(event.change);change.kind==="messages-appended"?(keys(change,["kind","start","messages"]),integer(change.start),messages(change.messages),(change.messages.length===0||!Number.isSafeInteger(change.start+change.messages.length))&&fail()):change.kind==="segment-started"?(keys(change,["kind","previousStart","start","end"]),integer(change.previousStart),integer(change.start),integer(change.end),(change.previousStart>=change.start||change.start>=change.end)&&fail()):fail()}else update.type==="error"?(keys(update,["type","code","error"]),text(update.code),text(update.error)):fail();return fixed}__name(acceptTranscriptUpdate,"acceptTranscriptUpdate");function fail(){throw new TypeError("Invalid transcript update")}__name(fail,"fail");function record(value){return(value===null||typeof value!="object"||Array.isArray(value))&&fail(),value}__name(record,"record");function keys(value,required,optional=[]){(!required.every(key=>Object.hasOwn(value,key))||Object.keys(value).some(key=>!required.includes(key)&&!optional.includes(key)))&&fail()}__name(keys,"keys");function text(value){(typeof value!="string"||!/\S/u.test(value))&&fail()}__name(text,"text");function integer(value,minimum=0){(!Number.isSafeInteger(value)||value<minimum||Object.is(value,-0))&&fail()}__name(integer,"integer");function messages(value){Array.isArray(value)||fail();for(const raw of value){const message=record(raw);keys(message,["role","content"]),message.role!=="user"&&message.role!=="assistant"&&fail(),text(message.content)}}__name(messages,"messages");export{acceptTranscriptUpdate};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { TranscriptWireMessage, TranscriptWireSnapshot, TranscriptWireEvent, TranscriptFrame, TranscriptUpdate } from './transcript.js';
+export { acceptTranscriptUpdate } from './acceptance.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
+import{acceptTranscriptUpdate}from"./acceptance.js";export{acceptTranscriptUpdate};

package/dist/transcript.d.ts

@@ -0,0 +1,43 @@
+export interface TranscriptWireMessage {
+    readonly role: 'user' | 'assistant';
+    readonly content: string;
+}
+export interface TranscriptWireSnapshot {
+    readonly id: string;
+    readonly revision: number;
+    readonly start: 0;
+    readonly end: number;
+    readonly starts: readonly number[];
+    readonly messages: readonly TranscriptWireMessage[];
+}
+export type TranscriptWireEvent = Readonly<{
+    type: 'transcript';
+    transcriptId: string;
+    revision: number;
+    occurredAt: string;
+    origin?: Readonly<{
+        contextId: string;
+    }>;
+    change: Readonly<{
+        kind: 'messages-appended';
+        start: number;
+        messages: readonly TranscriptWireMessage[];
+    }> | Readonly<{
+        kind: 'segment-started';
+        previousStart: number;
+        start: number;
+        end: number;
+    }>;
+}>;
+export type TranscriptFrame = {
+    readonly type: 'baseline';
+    readonly snapshot: TranscriptWireSnapshot;
+} | {
+    readonly type: 'delta';
+    readonly event: TranscriptWireEvent;
+};
+export type TranscriptUpdate = TranscriptFrame | {
+    readonly type: 'error';
+    readonly code: string;
+    readonly error: string;
+};

package/dist/transcript.js

@@ -0,0 +1 @@
+/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@weiliang0121/capix-protocol",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@weiliang0121/capix-contracts": "0.2.0"
+  },
+  "description": "Explicit transcript baseline and delta wire contracts for CAPiX.",
+  "license": "MIT",
+  "author": "wei.liang (https://github.com/weiliang0121)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/weiliang0121/capix.git",
+    "directory": "packages/protocol"
+  },
+  "engines": {
+    "node": ">=22.23.2"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.d.ts",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@weiliang0121/capix-transcript": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node ../../scripts/test/run.mjs --package ."
+  }
 }