@weiliang0121/capix-transcript 0.1.0 → 0.2.0

package/README.md

@@ -2,6 +2,8 @@
 
 Append-only conversation messages and resource contracts for CAPiX.
 
+The public root owns `Message`, `MessageLocator`, `TranscriptRangeLocator`, `TranscriptSnapshot`, and `TranscriptEvent`. Locators identify fixed positions without retaining an entity; snapshots and events describe one source revision, including segment changes. Transport framing and wire acceptance belong to the protocol adapter and are not entity recovery authority.
+
 ES modules and TypeScript declarations. Requires Node.js 22.23.2 or newer.
 
 ```sh
@@ -17,4 +19,4 @@ This package is part of CAPiX. The npm distribution contains compiled JavaScript
 
 ## License
 
-MIT. Copyright (c) 2026 wei.liang. See [LICENSE](./LICENSE).
+MIT. Copyright (c) 2026 wei.liang. See [LICENSE](LICENSE).

package/dist/append.d.ts

@@ -1,4 +1,4 @@
-import type { Message } from '@weiliang0121/capix-protocol';
+import type { Message } from './types.js';
 export interface TranscriptAppendOperation {
     readonly parentContextId: string;
     readonly childContextId: string;

package/dist/event.d.ts

@@ -1,5 +1,40 @@
-import type { TranscriptEvent } from '@weiliang0121/capix-protocol';
-export type { TranscriptEvent } from '@weiliang0121/capix-protocol';
+import { FactType } from '@weiliang0121/capix-changes';
+import type { InvocationOrigin } from '@weiliang0121/capix-contracts';
+import type { Message } from './types.js';
+export type TranscriptEvent = Readonly<{
+    type: 'transcript';
+    transcriptId: string;
+    revision: number;
+    occurredAt: string;
+    origin?: InvocationOrigin;
+    change: Readonly<{
+        kind: 'messages-appended';
+        start: number;
+        messages: readonly Readonly<Message>[];
+    }> | Readonly<{
+        kind: 'segment-started';
+        previousStart: number;
+        start: number;
+        end: number;
+    }>;
+}>;
+export declare const TranscriptFacts: FactType<Readonly<{
+    type: "transcript";
+    transcriptId: string;
+    revision: number;
+    occurredAt: string;
+    origin?: InvocationOrigin;
+    change: Readonly<{
+        kind: "messages-appended";
+        start: number;
+        messages: readonly Readonly<Message>[];
+    }> | Readonly<{
+        kind: "segment-started";
+        previousStart: number;
+        start: number;
+        end: number;
+    }>;
+}>>;
 export declare function createTranscriptEvent(transcriptId: string, revision: number, change: TranscriptEvent['change'], origin?: {
     readonly contextId: string;
 }): TranscriptEvent;

package/dist/event.js

@@ -1,2 +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});function createTranscriptEvent(transcriptId,revision,change,origin){const body=change.kind==="messages-appended"?Object.freeze({...change,messages:Object.freeze([...change.messages])}):Object.freeze({...change});return Object.freeze({type:"transcript",transcriptId,revision,occurredAt:new Date().toISOString(),...origin?{origin:Object.freeze({...origin})}:{},change:body})}__name(createTranscriptEvent,"createTranscriptEvent");export{createTranscriptEvent};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{FactType}from"@weiliang0121/capix-changes";const TranscriptFacts=new FactType("transcript");function createTranscriptEvent(transcriptId,revision,change,origin){const body=change.kind==="messages-appended"?Object.freeze({...change,messages:Object.freeze([...change.messages])}):Object.freeze({...change});return Object.freeze({type:"transcript",transcriptId,revision,occurredAt:new Date().toISOString(),...origin?{origin:Object.freeze({...origin})}:{},change:body})}__name(createTranscriptEvent,"createTranscriptEvent");export{TranscriptFacts,createTranscriptEvent};

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export { MessageRef, TranscriptRangeRef } from './ref.js';
 export type { TranscriptAppendOperation, TranscriptFixedAppend, TranscriptAppendReceipt, TranscriptAppendState } from './append.js';
 export type { TranscriptState, TranscriptCommit, TranscriptPersistence } from './persistence.js';
 export type { TranscriptAppendProgress } from './progress.js';
-export type { TranscriptEvent } from './event.js';
+export { TranscriptFacts, type TranscriptEvent } from './event.js';
 export { TranscriptResource, TranscriptRangeReader, type TranscriptAppendSource } from './resource.js';
 export { TranscriptViewSource, type TranscriptViewSummary } from './view.js';
+export type { Message, MessageLocator, TranscriptRangeLocator, TranscriptSnapshot } from './types.js';

package/dist/index.js

@@ -1,2 +1,2 @@
 /*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-import{Transcript}from"./transcript.js";import{MessageRef,TranscriptRangeRef}from"./ref.js";import{TranscriptResource,TranscriptRangeReader}from"./resource.js";import{TranscriptViewSource}from"./view.js";export{MessageRef,Transcript,TranscriptRangeReader,TranscriptRangeRef,TranscriptResource,TranscriptViewSource};
+import{Transcript}from"./transcript.js";import{MessageRef,TranscriptRangeRef}from"./ref.js";import{TranscriptFacts}from"./event.js";import{TranscriptResource,TranscriptRangeReader}from"./resource.js";import{TranscriptViewSource}from"./view.js";export{MessageRef,Transcript,TranscriptFacts,TranscriptRangeReader,TranscriptRangeRef,TranscriptResource,TranscriptViewSource};

package/dist/persistence.d.ts

@@ -1,4 +1,4 @@
-import type { Message } from '@weiliang0121/capix-protocol';
+import type { Message } from './types.js';
 import type { TranscriptAppendState } from './append.js';
 export interface TranscriptState {
     readonly id: string;

package/dist/presets.d.ts

@@ -1,4 +1,4 @@
-import type { Message } from '@weiliang0121/capix-protocol';
+import type { Message } from './types.js';
 export interface IndexedMessage {
     readonly index: number;
     readonly message: Readonly<Message>;

package/dist/progress.d.ts

@@ -1,3 +1,3 @@
-import type { TranscriptRangeLocator } from '@weiliang0121/capix-protocol';
+import type { TranscriptRangeLocator } from './types.js';
 export interface TranscriptAppendProgress extends TranscriptRangeLocator {
 }

package/dist/ref.d.ts

@@ -3,7 +3,7 @@ export declare class MessageRef {
     readonly transcript: Transcript;
     readonly index: number;
     constructor(transcript: Transcript, index: number);
-    read(): Readonly<import("@weiliang0121/capix-protocol").Message>;
+    read(): Readonly<import("./types.js").Message>;
 }
 export declare class TranscriptRangeRef {
     readonly transcript: Transcript;
@@ -12,6 +12,6 @@ export declare class TranscriptRangeRef {
     constructor(transcript: Transcript, start: number, end: number);
     get length(): number;
     ref(index: number): MessageRef;
-    read(index: number): Readonly<import("@weiliang0121/capix-protocol").Message>;
+    read(index: number): Readonly<import("./types.js").Message>;
     refs(): readonly MessageRef[];
 }

package/dist/resource.d.ts

@@ -1,5 +1,5 @@
 import { Transcript } from './transcript.js';
-import type { Message, TranscriptRangeLocator } from '@weiliang0121/capix-protocol';
+import type { Message, TranscriptRangeLocator } from './types.js';
 import { ResourceOffer } from '@weiliang0121/capix-resources';
 import type { ResourceEndpointActivity } from '@weiliang0121/capix-resources';
 import { TranscriptRangeRef } from './ref.js';
@@ -30,7 +30,7 @@ export declare const TranscriptResource: Readonly<{
         applyFixed(input: {
             readonly position: string;
             readonly messages: readonly Message[];
-        }): import("./append.js").TranscriptAppendReceipt;
+        }): unknown;
         append(messages: readonly Message[]): readonly Readonly<{
             transcriptId: string;
             index: number;

package/dist/resource.js

@@ -1,2 +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{Transcript}from"./transcript.js";import{ResourceOffer}from"@weiliang0121/capix-resources";import{TranscriptRangeRef}from"./ref.js";import{ProgressChannel}from"@weiliang0121/capix-changes";class TranscriptRangeReader{static{__name(this,"TranscriptRangeReader")}#range;#activity;start;end;transcriptId;revision;constructor(range,activity,revision=range.transcript.revision){this.#range=range,this.#activity=activity,this.start=range.start,this.end=range.end,this.transcriptId=range.transcript.id,this.revision=revision,Object.freeze(this)}get length(){return this.end-this.start}locate(){return Object.freeze({transcriptId:this.transcriptId,start:this.start,end:this.end,revision:this.revision})}read(index){const read=__name(()=>this.#range.read(index),"read");return this.#activity?this.#activity.runSync("read",{input:__name(()=>({transcriptId:this.transcriptId,index}),"input"),output:__name(()=>({transcriptId:this.transcriptId,index}),"output")},read):read()}slice(start,end=this.end){if(this.#activity?.validate(),start<this.start||end>this.end)throw new RangeError("Requested range exceeds available messages");return new TranscriptRangeReader(new TranscriptRangeRef(this.#range.transcript,start,end),this.#activity,this.revision)}entries(){const read=__name(()=>Object.freeze(Array.from({length:this.length},(_,offset)=>{const index=this.start+offset;return Object.freeze({index,message:this.#range.read(index)})})),"read");return this.#activity?this.#activity.runSync("entries",{input:__name(()=>this.locate(),"input"),output:__name(()=>this.locate(),"output")},read):read()}}const TranscriptResource=Object.freeze({append:new ResourceOffer({name:"transcript.append",expose:__name((source,activity)=>{const transcript=source instanceof Transcript?source:source.transcript,progress=source instanceof Transcript||!source.progress?void 0:new ProgressChannel(source.progress);return Object.freeze({applyFixed(input){return activity.runSync("applyFixed",{input:__name(()=>({position:input.position,count:input.messages.length}),"input"),output:__name(receipt=>receipt,"output")},()=>transcript.applyFixed({contract:{key:"transcript.append",version:1},operation:{...activity.reception(),position:input.position},transcriptId:transcript.id,messages:input.messages},{origin:activity.origin,observation:activity.transcriptObservation,progress}))},append(messages){return activity.runSync("append",{input:__name(()=>({count:messages.length}),"input"),output:__name(result=>({transcriptId:transcript.id,indexes:result.map(item=>item.index),revision:transcript.revision}),"output")},()=>{const start=transcript.length;return transcript.appendFrom(messages,{origin:activity.origin,observation:activity.transcriptObservation,progress}),Object.freeze(messages.map((_,offset)=>Object.freeze({transcriptId:transcript.id,index:start+offset,message:transcript.get(start+offset)})))})}})},"expose"),timing:"access",describe:__name(source=>({transcriptId:(source instanceof Transcript?source:source.transcript).id}),"describe")}),segmentation:new ResourceOffer({name:"transcript.segmentation",expose:__name((transcript,activity)=>Object.freeze({current:__name(()=>activity.runSync("current",{output:__name(reader=>reader.locate(),"output")},()=>new TranscriptRangeReader(new TranscriptRangeRef(transcript,transcript.activeStart,transcript.length),activity)),"current"),start:__name(index=>activity.runSync("start",{input:__name(()=>({start:index}),"input"),output:__name(()=>({transcriptId:transcript.id,start:transcript.activeStart,end:transcript.length,revision:transcript.revision}),"output")},()=>transcript.startSegment(index,{origin:activity.origin,observation:activity.transcriptObservation})),"start")}),"expose"),timing:"access",describe:__name(transcript=>({transcriptId:transcript.id}),"describe")}),fixedRange:new ResourceOffer({name:"transcript.fixedRange",expose:__name((captured,activity)=>new TranscriptRangeReader(captured.range,activity,captured.revision),"expose"),timing:"binding",capture:__name(range=>({range,revision:range.transcript.revision}),"capture"),describe:__name(({range,revision})=>({transcriptId:range.transcript.id,start:range.start,end:range.end,revision}),"describe")})});export{TranscriptRangeReader,TranscriptResource};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{TranscriptFacts}from"./event.js";import{Transcript}from"./transcript.js";import{ResourceOffer}from"@weiliang0121/capix-resources";import{TranscriptRangeRef}from"./ref.js";import{ProgressChannel}from"@weiliang0121/capix-changes";class TranscriptRangeReader{static{__name(this,"TranscriptRangeReader")}#range;#activity;start;end;transcriptId;revision;constructor(range,activity,revision=range.transcript.revision){this.#range=range,this.#activity=activity,this.start=range.start,this.end=range.end,this.transcriptId=range.transcript.id,this.revision=revision,Object.freeze(this)}get length(){return this.end-this.start}locate(){return Object.freeze({transcriptId:this.transcriptId,start:this.start,end:this.end,revision:this.revision})}read(index){const read=__name(()=>this.#range.read(index),"read");return this.#activity?this.#activity.runSync("read",{input:__name(()=>({transcriptId:this.transcriptId,index}),"input"),output:__name(()=>({transcriptId:this.transcriptId,index}),"output")},read):read()}slice(start,end=this.end){if(this.#activity?.validate(),start<this.start||end>this.end)throw new RangeError("Requested range exceeds available messages");return new TranscriptRangeReader(new TranscriptRangeRef(this.#range.transcript,start,end),this.#activity,this.revision)}entries(){const read=__name(()=>Object.freeze(Array.from({length:this.length},(_,offset)=>{const index=this.start+offset;return Object.freeze({index,message:this.#range.read(index)})})),"read");return this.#activity?this.#activity.runSync("entries",{input:__name(()=>this.locate(),"input"),output:__name(()=>this.locate(),"output")},read):read()}}const TranscriptResource=Object.freeze({append:new ResourceOffer({name:"transcript.append",expose:__name((source,activity)=>{const transcript=source instanceof Transcript?source:source.transcript,progress=source instanceof Transcript||!source.progress?void 0:new ProgressChannel(source.progress);return Object.freeze({applyFixed(input){return activity.runSync("applyFixed",{input:__name(()=>({position:input.position,count:input.messages.length}),"input"),output:__name(receipt=>receipt,"output")},operation=>transcript.applyFixed({contract:{key:"transcript.append",version:1},operation:{...activity.reception(),position:input.position},transcriptId:transcript.id,messages:input.messages},{origin:operation.origin,observation:operation.facts(TranscriptFacts),progress}))},append(messages){return activity.runSync("append",{input:__name(()=>({count:messages.length}),"input"),output:__name(result=>({transcriptId:transcript.id,indexes:result.map(item=>item.index),revision:transcript.revision}),"output")},operation=>{const start=transcript.length;return transcript.appendFrom(messages,{origin:operation.origin,observation:operation.facts(TranscriptFacts),progress}),Object.freeze(messages.map((_,offset)=>Object.freeze({transcriptId:transcript.id,index:start+offset,message:transcript.get(start+offset)})))})}})},"expose"),timing:"access",describe:__name(source=>({transcriptId:(source instanceof Transcript?source:source.transcript).id}),"describe")}),segmentation:new ResourceOffer({name:"transcript.segmentation",expose:__name((transcript,activity)=>Object.freeze({current:__name(()=>activity.runSync("current",{output:__name(reader=>reader.locate(),"output")},()=>new TranscriptRangeReader(new TranscriptRangeRef(transcript,transcript.activeStart,transcript.length),activity)),"current"),start:__name(index=>activity.runSync("start",{input:__name(()=>({start:index}),"input"),output:__name(()=>({transcriptId:transcript.id,start:transcript.activeStart,end:transcript.length,revision:transcript.revision}),"output")},operation=>transcript.startSegment(index,{origin:operation.origin,observation:operation.facts(TranscriptFacts)})),"start")}),"expose"),timing:"access",describe:__name(transcript=>({transcriptId:transcript.id}),"describe")}),fixedRange:new ResourceOffer({name:"transcript.fixedRange",expose:__name((captured,activity)=>new TranscriptRangeReader(captured.range,activity,captured.revision),"expose"),timing:"binding",capture:__name(range=>({range,revision:range.transcript.revision}),"capture"),describe:__name(({range,revision})=>({transcriptId:range.transcript.id,start:range.start,end:range.end,revision}),"describe")})});export{TranscriptRangeReader,TranscriptResource};

package/dist/transcript.d.ts

@@ -1,7 +1,7 @@
 import { type ChangeProvenance } from '@weiliang0121/capix-changes';
 import type { EventConsumer } from '@weiliang0121/capix-changes';
 import { MessageRef, TranscriptRangeRef } from './ref.js';
-import type { Message } from '@weiliang0121/capix-protocol';
+import type { Message } from './types.js';
 import type { ChangeCapture } from '@weiliang0121/capix-changes';
 import { type TranscriptEvent } from './event.js';
 import type { ProgressChannel } from '@weiliang0121/capix-changes';

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export interface Message {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface MessageLocator {
+    readonly transcriptId: string;
+    readonly index: number;
+}
+export interface TranscriptRangeLocator {
+    readonly transcriptId: string;
+    readonly start: number;
+    readonly end: number;
+    readonly revision?: number;
+}
+export interface TranscriptSnapshot {
+    readonly id: string;
+    readonly revision: number;
+    readonly start: 0;
+    readonly end: number;
+    readonly starts: readonly number[];
+    readonly messages: readonly Readonly<Message>[];
+}

package/dist/types.js

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

package/dist/view.d.ts

@@ -1,4 +1,4 @@
-import type { Message } from '@weiliang0121/capix-protocol';
+import type { Message } from './types.js';
 import type { SyncViewSource } from '@weiliang0121/capix-view';
 import type { Transcript } from './transcript.js';
 export interface TranscriptViewSummary {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weiliang0121/capix-transcript",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -15,12 +15,11 @@
   },
   "dependencies": {
     "es-toolkit": "1.52.0",
-    "@weiliang0121/capix-contracts": "0.1.0",
-    "@weiliang0121/capix-changes": "0.1.0",
-    "@weiliang0121/capix-protocol": "0.1.0",
-    "@weiliang0121/capix-resources": "0.1.0",
-    "@weiliang0121/capix-view": "0.1.0",
-    "@weiliang0121/capix-diagnostics": "0.1.0"
+    "@weiliang0121/capix-contracts": "0.2.0",
+    "@weiliang0121/capix-diagnostics": "0.2.0",
+    "@weiliang0121/capix-resources": "0.2.0",
+    "@weiliang0121/capix-changes": "0.2.0",
+    "@weiliang0121/capix-view": "0.2.0"
   },
   "description": "Append-only conversation messages and resource contracts for CAPiX.",
   "license": "MIT",
@@ -28,7 +27,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weiliang0121/capix.git",
-    "directory": "server/transcript"
+    "directory": "packages/transcript"
   },
   "engines": {
     "node": ">=22.23.2"
@@ -47,6 +46,7 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node ../../scripts/test/run.mjs --package ."
   }
 }