@weiliang0121/capix-runtime 0.1.0 → 0.3.0

package/README.md

@@ -16,6 +16,8 @@ npm install @weiliang0121/capix-runtime
 
 This package is part of CAPiX. The npm distribution contains compiled JavaScript, type declarations, and this package's MIT license. Reference services and client applications are not included in this package or the initial npm release.
 
+Runtime composes Invocation progress through `invocation/events` and recording through the public `records/data` contracts. It does not depend on transport or service protocols. Optional content recording uses the domain adapters owned by `records`; it adds no entity lifecycle or direct production dependency on Transcript or Memory.
+
 ## License
 
-MIT. Copyright (c) 2026 wei.liang. See [LICENSE](./LICENSE).
+MIT. Copyright (c) 2026 wei.liang. See [LICENSE](LICENSE).

package/dist/construction/capabilities.d.ts

@@ -1,5 +1,5 @@
 import type { CheckpointInstallation, Clock } from '@weiliang0121/capix-invocation';
-import type { InvocationEvent } from '@weiliang0121/capix-protocol';
+import type { InvocationEvent } from '@weiliang0121/capix-invocation/events';
 import type { ChangeCapture } from '@weiliang0121/capix-changes';
 import type { ObservationInstallation } from '../binding/observation.js';
 export interface InvocationCapabilities {

package/dist/construction/feedback.d.ts

@@ -1,9 +1,10 @@
-import type { CheckpointInstallation, CheckpointFact, InvocationFact, ResourceObservation, BusinessObservation } from '@weiliang0121/capix-invocation';
+import type { CheckpointInstallation, CheckpointFact, InvocationFact, ResourceObservation, ResourceFact, BusinessObservation } from '@weiliang0121/capix-invocation';
 import { type ProgressReceiver } from '@weiliang0121/capix-changes';
 import type { ObservationInstallation } from '../binding/observation.js';
 export interface CallableFeedback {
     readonly invocation?: ProgressReceiver<InvocationFact>;
     readonly resource?: ProgressReceiver<ResourceObservation>;
+    readonly fact?: ProgressReceiver<ResourceFact>;
     readonly business?: ProgressReceiver<BusinessObservation>;
     readonly checkpoint?: ProgressReceiver<CheckpointFact>;
 }

package/dist/construction/feedback.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{ProgressChannel}from"@weiliang0121/capix-changes";function bindCallableFeedback(feedback){const invocation=fixedReceiver(feedback.invocation),resource=fixedReceiver(feedback.resource),business=fixedReceiver(feedback.business),checkpoint=fixedReceiver(feedback.checkpoint);return Object.freeze({checkpoint,observation:Object.freeze({bindInvocation:__name(()=>{const calls=invocation?new ProgressChannel(invocation):void 0,resources=resource?new ProgressChannel(resource):void 0,annotations=business?new ProgressChannel(business):void 0;return{observe:__name(fact=>calls?.publish(fact),"observe"),resource:__name(fact=>resources?.publish(fact),"resource"),business:__name(fact=>annotations?.publish(fact),"business")}},"bindInvocation")})})}__name(bindCallableFeedback,"bindCallableFeedback");function checkpointFeedback(installation,feedback){if(!installation||!feedback)return installation;const additional=new ProgressChannel(feedback),installed=installation.feedback?new ProgressChannel(installation.feedback):void 0;return Object.freeze({...installation,feedback:Object.freeze({receive(fact){additional.publish(fact),installed?.publish(fact)}})})}__name(checkpointFeedback,"checkpointFeedback");function fixedReceiver(receiver){return receiver?Object.freeze({receive:receiver.receive.bind(receiver),failed:receiver.failed?.bind(receiver)}):void 0}__name(fixedReceiver,"fixedReceiver");export{bindCallableFeedback,checkpointFeedback};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{ProgressChannel}from"@weiliang0121/capix-changes";function bindCallableFeedback(feedback){const invocation=fixedReceiver(feedback.invocation),resource=fixedReceiver(feedback.resource),fact=fixedReceiver(feedback.fact),business=fixedReceiver(feedback.business),checkpoint=fixedReceiver(feedback.checkpoint);return Object.freeze({checkpoint,observation:Object.freeze({bindInvocation:__name(()=>{const calls=invocation?new ProgressChannel(invocation):void 0,resources=resource?new ProgressChannel(resource):void 0,facts=fact?new ProgressChannel(fact):void 0,annotations=business?new ProgressChannel(business):void 0;return{observe:__name(fact2=>calls?.publish(fact2),"observe"),resource:__name(fact2=>resources?.publish(fact2),"resource"),fact:__name(fact2=>facts?.publish(fact2),"fact"),business:__name(fact2=>annotations?.publish(fact2),"business")}},"bindInvocation")})})}__name(bindCallableFeedback,"bindCallableFeedback");function checkpointFeedback(installation,feedback){if(!installation||!feedback)return installation;const additional=new ProgressChannel(feedback),installed=installation.feedback?new ProgressChannel(installation.feedback):void 0;return Object.freeze({...installation,feedback:Object.freeze({receive(fact){additional.publish(fact),installed?.publish(fact)}})})}__name(checkpointFeedback,"checkpointFeedback");function fixedReceiver(receiver){return receiver?Object.freeze({receive:receiver.receive.bind(receiver),failed:receiver.failed?.bind(receiver)}):void 0}__name(fixedReceiver,"fixedReceiver");export{bindCallableFeedback,checkpointFeedback};

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { invocationContextView, invocationView, childInvocationView, Clock, Invo
 export type { InvocationContextView, CallableContextView, ContextViewOf, ContextViewResources, ContextFactsOf, InvocationRelationView, InvocationView, ChildInvocationView, InvocationViewSource, InvocationProgress, InvocationResult, InvocationFailure, InvocationPhase } from '@weiliang0121/capix-invocation';
 export type { InvocationIdentity } from '@weiliang0121/capix-contracts';
 export { InvocationChangeEmitter, InvocationObservation, ObservationError } from '@weiliang0121/capix-invocation';
-export type { InvocationRelationIdentity, InvocationDescription, InvocationRelationChange, InvocationChange, InvocationFact, ResourceObservation, BusinessEvent, BusinessObservation, InvocationObserver } from '@weiliang0121/capix-invocation';
+export type { InvocationRelationIdentity, InvocationDescription, InvocationRelationChange, InvocationChange, InvocationFact, ResourceObservation, ResourceFact, BusinessEvent, BusinessObservation, InvocationObserver } from '@weiliang0121/capix-invocation';
 export type { EventConsumer } from '@weiliang0121/capix-changes';
 export type { DriverFact, DriverObserver } from './observation/driver.js';
 export * from './construction.js';

package/dist/records/observation/declaration.d.ts

@@ -1,4 +1,4 @@
-import type { InvocationRelationIdentity } from '@weiliang0121/capix-protocol';
+import type { InvocationRelationIdentity } from '@weiliang0121/capix-contracts';
 import type { InvocationFact } from '@weiliang0121/capix-invocation';
 import { ResourceOffer } from '@weiliang0121/capix-resources';
 import type { InvocationRecording } from './invocation.js';

package/dist/records/observation/installation.d.ts

@@ -1,16 +1,16 @@
-import type { MemoryEvent, TranscriptEvent } from '@weiliang0121/capix-protocol';
 import type { InvocationObservationSetup, ObservationInstallation } from '../../binding/observation.js';
 import type { ObservationDeclarationScope } from '../../definition/observation.js';
 import { type InvocationObserver } from '@weiliang0121/capix-invocation';
 import type { EventConsumer } from '@weiliang0121/capix-changes';
-import type { Recorder, RecordingRootRecord } from '@weiliang0121/capix-records';
+import { memoryRecord, transcriptRecord, type Recorder, type RecordingRootRecord, type RecordChangeSource } from '@weiliang0121/capix-records';
 import { type RecordWriter } from '@weiliang0121/capix-records/construction';
-import { type ResourceBinding } from '@weiliang0121/capix-resources';
+import { type ResourceBinding, type ResourceFact } from '@weiliang0121/capix-resources';
 import { type InvocationRecordDescription } from './declaration.js';
 import type { CallableInput, CallableOutput } from '@weiliang0121/capix-contracts';
 import { InvocationRecording } from './invocation.js';
 export interface RecordingOptions {
     readonly failure?: 'isolate' | 'propagate';
+    readonly fact?: (fact: ResourceFact, source: RecordChangeSource, writer: RecordWriter) => void;
     readonly invalidate?: (error: unknown) => void;
 }
 export declare class RecordingInstallation implements ObservationInstallation {
@@ -24,13 +24,14 @@ export declare class RecordingInstallation implements ObservationInstallation {
     readonly provides: Readonly<{
         record: import("@weiliang0121/capix-resources").ResourceRequest<import("./declaration.js").InvocationRecordWriter>;
     }>;
-    readonly transcript: EventConsumer<TranscriptEvent>;
-    readonly memory: EventConsumer<MemoryEvent>;
+    readonly transcript: EventConsumer<Parameters<typeof transcriptRecord>[0]>;
+    readonly memory: EventConsumer<Parameters<typeof memoryRecord>[0]>;
     readonly failure: 'isolate' | 'propagate';
     constructor(recorder: Recorder, options?: RecordingOptions);
     describe<Structure extends ObservationDeclarationScope>(structure: Structure, description: InvocationRecordDescription<CallableInput<Structure>, CallableOutput<Structure>>): this;
     declarations(structure: ObservationDeclarationScope): import("../../definition/observation.js").ObservationDeclaration<import("@weiliang0121/capix-invocation").InvocationFact>[];
     bindInvocation(setup: InvocationObservationSetup, parent?: InvocationObserver): InvocationRecording;
+    recordFact(fact: ResourceFact, source: RecordChangeSource, writer: RecordWriter): void;
     invalidate(error: unknown): void;
     private consumer;
 }

package/dist/records/observation/installation.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{ObservationError}from"@weiliang0121/capix-invocation";import{RecordWriterResource}from"@weiliang0121/capix-records/construction";import{Resource,Resources}from"@weiliang0121/capix-resources";import{InvocationRecordAccess,invocationRecording}from"./declaration.js";import{assertStructureConfigurable}from"@weiliang0121/capix-structure/construction";import{InvocationRecording}from"./invocation.js";import{memoryRecord,transcriptRecord}from"./mapping.js";class RecordingInstallation{static{__name(this,"RecordingInstallation")}recorder;options;#descriptions=new WeakMap;root;records;provides=Object.freeze({record:InvocationRecordAccess.request()});transcript=this.consumer((event,writer)=>writer.add(transcriptRecord(event)));memory=this.consumer((event,writer)=>writer.add(memoryRecord(event)));failure;constructor(recorder,options={}){this.recorder=recorder,this.options=options,this.records=new Resources().register(new Resource(recorder),RecordWriterResource).bind({record:RecordWriterResource.request()});const access=this.records.open();try{this.root=access.endpoints.record.root()}finally{access.close()}this.failure=options.failure??"isolate"}describe(structure,description){if(assertStructureConfigurable(structure),this.#descriptions.has(structure))throw new Error("Recording description is already registered for this structure");return this.#descriptions.set(structure,description),this}declarations(structure){return[invocationRecording(this.#descriptions.get(structure))]}bindInvocation(setup,parent){if(parent&&!(parent instanceof InvocationRecording))throw new Error("Recording parent belongs to another observation capability");return new InvocationRecording(this,setup,parent)}invalidate(error){this.options.invalidate?.(error)}consumer(work){let active=!0;return{publish:__name(event=>{if(active)try{const access=this.records.open();try{work(event,access.endpoints.record)}finally{access.close()}return}catch(cause){active=!1;const error=new ObservationError(cause);return this.invalidate(error),this.failure==="propagate"?error:void 0}},"publish")}}}function bindRecording(recorder,options={}){return new RecordingInstallation(recorder,options)}__name(bindRecording,"bindRecording");export{RecordingInstallation,bindRecording};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{ObservationError}from"@weiliang0121/capix-invocation";import{memoryRecord,transcriptRecord,recordContentFact}from"@weiliang0121/capix-records";import{RecordWriterResource}from"@weiliang0121/capix-records/construction";import{Resource,Resources}from"@weiliang0121/capix-resources";import{InvocationRecordAccess,invocationRecording}from"./declaration.js";import{assertStructureConfigurable}from"@weiliang0121/capix-structure/construction";import{InvocationRecording}from"./invocation.js";class RecordingInstallation{static{__name(this,"RecordingInstallation")}recorder;options;#fact;#descriptions=new WeakMap;root;records;provides=Object.freeze({record:InvocationRecordAccess.request()});transcript=this.consumer((event,writer)=>writer.add(transcriptRecord(event)));memory=this.consumer((event,writer)=>writer.add(memoryRecord(event)));failure;constructor(recorder,options={}){this.recorder=recorder,this.options=options,this.#fact=options.fact?.bind(options)??recordContentFact,this.records=new Resources().register(new Resource(recorder),RecordWriterResource).bind({record:RecordWriterResource.request()});const access=this.records.open();try{this.root=access.endpoints.record.root()}finally{access.close()}this.failure=options.failure??"isolate"}describe(structure,description){if(assertStructureConfigurable(structure),this.#descriptions.has(structure))throw new Error("Recording description is already registered for this structure");return this.#descriptions.set(structure,description),this}declarations(structure){return[invocationRecording(this.#descriptions.get(structure))]}bindInvocation(setup,parent){if(parent&&!(parent instanceof InvocationRecording))throw new Error("Recording parent belongs to another observation capability");return new InvocationRecording(this,setup,parent)}recordFact(fact,source,writer){const returned=this.#fact(fact,source,writer);if(returned&&typeof returned.then=="function")throw Promise.resolve(returned).catch(()=>{}),new TypeError("Fact recording must complete synchronously")}invalidate(error){this.options.invalidate?.(error)}consumer(work){let active=!0;return{publish:__name(event=>{if(active)try{const access=this.records.open();try{work(event,access.endpoints.record)}finally{access.close()}return}catch(cause){active=!1;const error=new ObservationError(cause);return this.invalidate(error),this.failure==="propagate"?error:void 0}},"publish")}}}function bindRecording(recorder,options={}){return new RecordingInstallation(recorder,options)}__name(bindRecording,"bindRecording");export{RecordingInstallation,bindRecording};

package/dist/records/observation/invocation.d.ts

@@ -1,6 +1,6 @@
 import { InvocationResources, type InvocationFact, type ResourceObservation, type InvocationObserver } from '@weiliang0121/capix-invocation';
-import type { MemoryEvent, TranscriptEvent } from '@weiliang0121/capix-protocol';
 import type { InvocationObservationSetup } from '../../binding/observation.js';
+import { type ResourceFact } from '@weiliang0121/capix-resources';
 import { CallableRecord } from '@weiliang0121/capix-records';
 import { type InvocationRecordDescription, type InvocationRecordWriter } from './declaration.js';
 import type { RecordingInstallation } from './installation.js';
@@ -18,10 +18,8 @@ export declare class InvocationRecording implements InvocationObserver {
     observe(_fact: InvocationFact): undefined;
     observeDescribed(fact: InvocationFact, description?: InvocationRecordDescription): void;
     resource(fact: ResourceObservation): void;
-    transcript(event: TranscriptEvent): void;
-    memory(event: MemoryEvent): void;
+    fact(fact: ResourceFact): void;
     private requireRecord;
-    private checkOrigin;
     private source;
     private begin;
     private process;

package/dist/records/observation/invocation.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{InvocationResources,RuntimeErrorHelper,failureFact}from"@weiliang0121/capix-invocation";import{isUndefined}from"es-toolkit/predicate";import{pick}from"es-toolkit/object";import{ResourceSupply,resourceRequests}from"@weiliang0121/capix-resources";import{CallableRecord,InvocationRecordHelper,ResourceRecord}from"@weiliang0121/capix-records";import{InvocationRecordAccess}from"./declaration.js";import{memoryRecord,recordedResult,transcriptRecord}from"./mapping.js";class InvocationRecording{static{__name(this,"InvocationRecording")}installation;setup;parentRecording;resources;#childRecordings=new Map;#pendingAttachments=[];#record;#startedTick;#failed=!1;#enabled;#recordDescription={};constructor(installation,setup,parentRecording){if(this.installation=installation,this.setup=setup,this.parentRecording=parentRecording,this.#enabled=(setup.declarations??[]).some(declaration=>resourceRequests(declaration.deps).some(request=>request.offer===InvocationRecordAccess.request().offer)),parentRecording&&parentRecording.installation!==installation)throw new Error("Recording parent belongs to another installation");parentRecording&&parentRecording.#childRecordings.set(setup.identity.contextId,this),this.resources=new InvocationResources({record:InvocationRecordAccess.request()},ResourceSupply.capture([InvocationRecordAccess.provide(()=>this)],void 0).entries)}get record(){return this.#record}available(){return this.#enabled&&!this.#failed&&(this.parentRecording?.available()??!0)}observe(_fact){}observeDescribed(fact,description={}){this.protect(writer=>{if(fact.identity.contextId!==this.setup.identity.contextId||fact.identity.kind!==this.setup.identity.kind)throw new Error("Call fact belongs to another local observation");this.#recordDescription=description,fact.kind==="started"?this.begin(fact,writer):fact.kind==="process"?this.process(fact,writer):fact.kind==="relation"?!this.#record&&fact.change.kind==="attached"?this.#pendingAttachments.push({...fact,identity:{...fact.identity},relation:{...fact.relation},change:{kind:"attached"}}):this.relation(fact,writer):this.finish(fact,writer)})}resource(fact){this.protect(writer=>{const record=this.requireRecord();if(fact.contextId!==record.contextId)throw new Error("Resource fact belongs to another call");writer.add(new ResourceRecord({parentId:record.id,access:fact.access,supplyId:fact.supplyId,sequence:fact.sequence,occurredAt:fact.occurredAt,phase:fact.phase,...fact.interactionId?{interactionId:fact.interactionId}:{}},fact.describe()))})}transcript(event){this.protect(writer=>{this.checkOrigin(event.origin),writer.add(transcriptRecord(event,this.source()))})}memory(event){this.protect(writer=>{this.checkOrigin(event.origin),writer.add(memoryRecord(event,this.source()))})}requireRecord(){if(!this.#record)throw new Error("The call recording has not started");return this.#record}checkOrigin(origin){if(origin?.contextId!==this.setup.identity.contextId)throw new Error("Entity fact belongs to another call")}source(){const record=this.requireRecord();return{contextId:record.contextId,callId:record.id}}begin(fact,writer){if(this.#record)throw new Error("A call recording can only start once");const input=this.#recordDescription.input?this.#recordDescription.input(fact.input):fact.input,description=fact.description??this.setup.description??{},parentRecord=this.parentRecording?.requireRecord();if(fact.identity.parentContextId!==void 0!=!!parentRecord||parentRecord&&parentRecord.contextId!==fact.identity.parentContextId)throw new Error("Call recording parent differs from its invocation relationship");this.#record=writer.add(new CallableRecord({contextId:fact.identity.contextId,structureKind:fact.identity.kind,parentId:parentRecord?.id??this.installation.root.id,...description.id!==void 0?{structureId:description.id}:{},...pick(description,["name","label","source"]),...this.#recordDescription.role!==void 0||description.role!==void 0?{role:this.#recordDescription.role??description.role}:{}},{input,startedAt:fact.occurredAt})),this.#startedTick=fact.monotonicTime,this.boundary(fact,"call",writer);for(const attachment of this.#pendingAttachments.splice(0))this.relation(attachment,writer,Math.max(0,this.offset(attachment.monotonicTime)))}process(fact,writer){const record=this.requireRecord(),process=fact.process;let body;"error"in process?body={...process,error:RuntimeErrorHelper.format(process.error),...process.failure?{failure:failureFact(process.failure)}:{}}:"input"in process&&this.#recordDescription.input?body={...process,input:this.#recordDescription.input(process.input)}:"output"in process&&this.#recordDescription.output?body={...process,output:this.#recordDescription.output(process.output)}:body=process;const entry={...body,sequence:fact.processSequence,eventSequence:fact.eventSequence,round:fact.round,occurredAt:fact.occurredAt,offsetMs:this.offset(fact.monotonicTime)};writer.update(record,current=>current.append(entry),current=>({kind:"process-appended",id:current.id,process:current.value.processes.at(-1)}))}relation(fact,writer,offsetMs=this.offset(fact.monotonicTime)){const record=this.requireRecord(),childRecording=this.#childRecordings.get(fact.relation.childContextId);if(fact.relation.parentContextId!==record.contextId)throw new Error("Relation fact belongs to another parent");let change;fact.change.kind==="returned"?change={kind:"returned",result:recordedResult(fact.change.result,childRecording?childRecording.#recordDescription:void 0)}:fact.change.kind==="accepted"&&this.#recordDescription.relationAccepted?change={kind:"accepted",output:this.#recordDescription.relationAccepted(fact.change.output,fact.relation)}:fact.change.kind==="handled"&&this.#recordDescription.relationHandled?change={kind:"handled",output:this.#recordDescription.relationHandled(fact.change.output,fact.relation)}:fact.change.kind==="failed"?change={kind:"failed",source:fact.change.source,error:RuntimeErrorHelper.format(fact.change.error),...fact.change.failure?{failure:failureFact(fact.change.failure)}:{}}:change=fact.change;const relation={identity:fact.relation,eventSequence:fact.eventSequence,occurredAt:fact.occurredAt,offsetMs,...childRecording?.record?{childId:childRecording.record.id}:{},change};writer.update(record,current=>current.appendRelation(relation),current=>({kind:"relation-appended",id:current.id,relation:current.value.relationChanges.at(-1)}))}finish(fact,writer){const state=fact.state;if(!this.#record&&state.status==="failed")return;const record=this.requireRecord();if(state.status==="running")throw new Error("A terminal call fact requires an outcome");if(state.status==="failed")InvocationRecordHelper.finish(writer,record,current=>current.fail(RuntimeErrorHelper.format(state.error),state.failure?failureFact(state.failure):void 0));else{const last=record.value.processes.at(-1),resultOf=last?.type==="return"?"resultOf"in last?last.resultOf:last.sequence:void 0,output=isUndefined(resultOf)?this.#recordDescription.output?this.#recordDescription.output(state.output):state.output:void 0;InvocationRecordHelper.finish(writer,record,current=>current.complete(output,resultOf))}this.boundary(fact,state.status==="succeeded"?"return":"throw",writer)}timingRoot(){let recording=this;for(;recording.parentRecording;)recording=recording.parentRecording;return recording}offset(time){const timingRecording=this.timingRoot();if(isUndefined(timingRecording.#startedTick))throw new Error("Call recording has no timing origin");return time-timingRecording.#startedTick}boundary(fact,type,writer){const timingRecording=this.timingRoot();writer.boundary({start:timingRecording.#startedTick,scopeId:timingRecording.requireRecord().id,callId:this.requireRecord().id,occurredAt:fact.occurredAt,offsetMs:this.offset(fact.monotonicTime)},type)}protect(work){if(this.available())try{const access=this.installation.records.open();try{work(access.endpoints.record)}finally{access.close()}}catch(error){throw this.#failed=!0,this.installation.invalidate(error),error}}}export{InvocationRecording};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{InvocationResources,RuntimeErrorHelper,failureFact}from"@weiliang0121/capix-invocation";import{isUndefined}from"es-toolkit/predicate";import{pick}from"es-toolkit/object";import{ResourceSupply,resourceRequests}from"@weiliang0121/capix-resources";import{CallableRecord,InvocationRecordHelper,ResourceRecord}from"@weiliang0121/capix-records";import{InvocationRecordAccess}from"./declaration.js";import{recordedResult}from"./mapping.js";class InvocationRecording{static{__name(this,"InvocationRecording")}installation;setup;parentRecording;resources;#childRecordings=new Map;#pendingAttachments=[];#record;#startedTick;#failed=!1;#enabled;#recordDescription={};constructor(installation,setup,parentRecording){if(this.installation=installation,this.setup=setup,this.parentRecording=parentRecording,this.#enabled=(setup.declarations??[]).some(declaration=>resourceRequests(declaration.deps).some(request=>request.offer===InvocationRecordAccess.request().offer)),parentRecording&&parentRecording.installation!==installation)throw new Error("Recording parent belongs to another installation");parentRecording&&parentRecording.#childRecordings.set(setup.identity.contextId,this),this.resources=new InvocationResources({record:InvocationRecordAccess.request()},ResourceSupply.capture([InvocationRecordAccess.provide(()=>this)],void 0).entries)}get record(){return this.#record}available(){return this.#enabled&&!this.#failed&&(this.parentRecording?.available()??!0)}observe(_fact){}observeDescribed(fact,description={}){this.protect(writer=>{if(fact.identity.contextId!==this.setup.identity.contextId||fact.identity.kind!==this.setup.identity.kind)throw new Error("Call fact belongs to another local observation");this.#recordDescription=description,fact.kind==="started"?this.begin(fact,writer):fact.kind==="process"?this.process(fact,writer):fact.kind==="relation"?!this.#record&&fact.change.kind==="attached"?this.#pendingAttachments.push({...fact,identity:{...fact.identity},relation:{...fact.relation},change:{kind:"attached"}}):this.relation(fact,writer):this.finish(fact,writer)})}resource(fact){this.protect(writer=>{const record=this.requireRecord();if(fact.contextId!==record.contextId)throw new Error("Resource fact belongs to another call");writer.add(new ResourceRecord({parentId:record.id,access:fact.access,supplyId:fact.supplyId,sequence:fact.sequence,occurredAt:fact.occurredAt,phase:fact.phase,...fact.interactionId?{interactionId:fact.interactionId}:{}},fact.describe()))})}fact(fact){this.protect(writer=>{if(fact.contextId!==this.setup.identity.contextId)throw new Error("Entity fact belongs to another call");this.installation.recordFact(fact,this.source(),writer)})}requireRecord(){if(!this.#record)throw new Error("The call recording has not started");return this.#record}source(){const record=this.requireRecord();return{contextId:record.contextId,callId:record.id}}begin(fact,writer){if(this.#record)throw new Error("A call recording can only start once");const input=this.#recordDescription.input?this.#recordDescription.input(fact.input):fact.input,description=fact.description??this.setup.description??{},parentRecord=this.parentRecording?.requireRecord();if(fact.identity.parentContextId!==void 0!=!!parentRecord||parentRecord&&parentRecord.contextId!==fact.identity.parentContextId)throw new Error("Call recording parent differs from its invocation relationship");this.#record=writer.add(new CallableRecord({contextId:fact.identity.contextId,structureKind:fact.identity.kind,parentId:parentRecord?.id??this.installation.root.id,...description.id!==void 0?{structureId:description.id}:{},...pick(description,["name","label","source"]),...this.#recordDescription.role!==void 0||description.role!==void 0?{role:this.#recordDescription.role??description.role}:{}},{input,startedAt:fact.occurredAt})),this.#startedTick=fact.monotonicTime,this.boundary(fact,"call",writer);for(const attachment of this.#pendingAttachments.splice(0))this.relation(attachment,writer,Math.max(0,this.offset(attachment.monotonicTime)))}process(fact,writer){const record=this.requireRecord(),process=fact.process;let body;"error"in process?body={...process,error:RuntimeErrorHelper.format(process.error),...process.failure?{failure:failureFact(process.failure)}:{}}:"input"in process&&this.#recordDescription.input?body={...process,input:this.#recordDescription.input(process.input)}:"output"in process&&this.#recordDescription.output?body={...process,output:this.#recordDescription.output(process.output)}:body=process;const entry={...body,sequence:fact.processSequence,eventSequence:fact.eventSequence,round:fact.round,occurredAt:fact.occurredAt,offsetMs:this.offset(fact.monotonicTime)};writer.update(record,current=>current.append(entry),current=>({kind:"process-appended",id:current.id,process:current.value.processes.at(-1)}))}relation(fact,writer,offsetMs=this.offset(fact.monotonicTime)){const record=this.requireRecord(),childRecording=this.#childRecordings.get(fact.relation.childContextId);if(fact.relation.parentContextId!==record.contextId)throw new Error("Relation fact belongs to another parent");let change;fact.change.kind==="returned"?change={kind:"returned",result:recordedResult(fact.change.result,childRecording?childRecording.#recordDescription:void 0)}:fact.change.kind==="accepted"&&this.#recordDescription.relationAccepted?change={kind:"accepted",output:this.#recordDescription.relationAccepted(fact.change.output,fact.relation)}:fact.change.kind==="handled"&&this.#recordDescription.relationHandled?change={kind:"handled",output:this.#recordDescription.relationHandled(fact.change.output,fact.relation)}:fact.change.kind==="failed"?change={kind:"failed",source:fact.change.source,error:RuntimeErrorHelper.format(fact.change.error),...fact.change.failure?{failure:failureFact(fact.change.failure)}:{}}:change=fact.change;const relation={identity:fact.relation,eventSequence:fact.eventSequence,occurredAt:fact.occurredAt,offsetMs,...childRecording?.record?{childId:childRecording.record.id}:{},change};writer.update(record,current=>current.appendRelation(relation),current=>({kind:"relation-appended",id:current.id,relation:current.value.relationChanges.at(-1)}))}finish(fact,writer){const state=fact.state;if(!this.#record&&state.status==="failed")return;const record=this.requireRecord();if(state.status==="running")throw new Error("A terminal call fact requires an outcome");if(state.status==="failed")InvocationRecordHelper.finish(writer,record,current=>current.fail(RuntimeErrorHelper.format(state.error),state.failure?failureFact(state.failure):void 0));else{const last=record.value.processes.at(-1),resultOf=last?.type==="return"?"resultOf"in last?last.resultOf:last.sequence:void 0,output=isUndefined(resultOf)?this.#recordDescription.output?this.#recordDescription.output(state.output):state.output:void 0;InvocationRecordHelper.finish(writer,record,current=>current.complete(output,resultOf))}this.boundary(fact,state.status==="succeeded"?"return":"throw",writer)}timingRoot(){let recording=this;for(;recording.parentRecording;)recording=recording.parentRecording;return recording}offset(time){const timingRecording=this.timingRoot();if(isUndefined(timingRecording.#startedTick))throw new Error("Call recording has no timing origin");return time-timingRecording.#startedTick}boundary(fact,type,writer){const timingRecording=this.timingRoot();writer.boundary({start:timingRecording.#startedTick,scopeId:timingRecording.requireRecord().id,callId:this.requireRecord().id,occurredAt:fact.occurredAt,offsetMs:this.offset(fact.monotonicTime)},type)}protect(work){if(this.available())try{const access=this.installation.records.open();try{work(access.endpoints.record)}finally{access.close()}}catch(error){throw this.#failed=!0,this.installation.invalidate(error),error}}}export{InvocationRecording};

package/dist/records/observation/mapping.d.ts

@@ -1,7 +1,4 @@
-import type { MemoryEvent, TranscriptEvent, RecordedInvocationResult } from '@weiliang0121/capix-protocol';
+import type { RecordedInvocationResult } from '@weiliang0121/capix-records/data';
 import { type InvocationResult } from '@weiliang0121/capix-invocation';
-import { MemoryRecord, TranscriptRecord, type RecordChangeSource } from '@weiliang0121/capix-records';
 import type { InvocationRecordDescription } from './declaration.js';
 export declare function recordedResult(result: InvocationResult<unknown>, description?: InvocationRecordDescription): RecordedInvocationResult;
-export declare function transcriptRecord(event: TranscriptEvent, source?: RecordChangeSource): TranscriptRecord;
-export declare function memoryRecord(event: MemoryEvent, source?: RecordChangeSource): MemoryRecord;

package/dist/records/observation/mapping.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{RuntimeErrorHelper,failureFact}from"@weiliang0121/capix-invocation";import{MemoryRecord,TranscriptRecord}from"@weiliang0121/capix-records";function recordedResult(result,description){return result.status==="succeeded"?{status:"succeeded",output:description?.output?description.output(result.output):result.output}:{status:"failed",error:RuntimeErrorHelper.format(result.error),...result.failure?{failure:failureFact(result.failure)}:{}}}__name(recordedResult,"recordedResult");function transcriptRecord(event,source){const change=event.change;return new TranscriptRecord({transcriptId:event.transcriptId,revision:event.revision,occurredAt:event.occurredAt,...source?{source}:{}},change.kind==="messages-appended"?{action:"append",start:change.start,end:change.start+change.messages.length}:{action:"segment",previousStart:change.previousStart,start:change.start,end:change.end})}__name(transcriptRecord,"transcriptRecord");function memoryRecord(event,source){return new MemoryRecord({memoriesId:event.memoriesId,memoryId:event.change.memoryId,sequence:event.sequence,...source?{source}:{}},{action:event.change.action,change:event.change.explanation,sourceIndexes:event.change.sourceIndexes,...event.change.sourceResults?{sourceResults:event.change.sourceResults}:{},result:event.change.result})}__name(memoryRecord,"memoryRecord");export{memoryRecord,recordedResult,transcriptRecord};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{RuntimeErrorHelper,failureFact}from"@weiliang0121/capix-invocation";function recordedResult(result,description){return result.status==="succeeded"?{status:"succeeded",output:description?.output?description.output(result.output):result.output}:{status:"failed",error:RuntimeErrorHelper.format(result.error),...result.failure?{failure:failureFact(result.failure)}:{}}}__name(recordedResult,"recordedResult");export{recordedResult};

package/dist/runner/feedback.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{randomUUID}from"node:crypto";import{ProgressChannel}from"@weiliang0121/capix-changes";import"./observation.js";import{projectInvocation,projectResource,projectBusiness,projectCheckpoint,projectDiagnostic}from"./observation-projection.js";class RunnerEntryFeedback{static{__name(this,"RunnerEntryFeedback")}runnerId;subscriptions;clock;id=randomUUID();#sequence=0;#entries;created;constructor(runnerId,subscriptions,clock){this.runnerId=runnerId,this.subscriptions=subscriptions,this.clock=clock,this.#entries=new ProgressChannel({receive:__name(change=>this.publishEntry(change),"receive")}),this.created=Object.freeze({receive:__name(identity=>{this.#entries.publish({kind:"attached",identity})},"receive")})}requested(mode,requestedContextId){this.#entries.publish({kind:"requested",mode,...requestedContextId!==void 0?{requestedContextId}:{}})}entry(change){change.kind!=="established"&&this.#entries.publish(change)}settled(status,error){this.#entries.publish({kind:"settled",status,error})}receivers(signal){return Object.freeze({invocation:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"invocation",fact:projectInvocation(fact,signal)})},"receive")},resource:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"resource",fact:projectResource(fact)})},"receive")},business:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"business",fact:projectBusiness(fact)})},"receive")},checkpoint:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"checkpoint",fact:projectCheckpoint(fact,signal)})},"receive")}})}publishEntry(change){const sequence=++this.#sequence;if(!this.subscriptions.active)return;const time={sequence,occurredAt:this.clock.now()};let fact;change.kind==="requested"?fact=Object.freeze({...time,...change}):change.kind==="attached"?fact=Object.freeze({...time,kind:"attached",identity:Object.freeze({...change.identity})}):change.kind==="settled"?fact=Object.freeze({...time,kind:"settled",status:change.status,...change.status!=="succeeded"?{diagnostic:projectDiagnostic(change.error)}:{}}):change.kind==="entry-failed"?fact=Object.freeze({...time,kind:"entry-failed",diagnostic:projectDiagnostic(change.error)}):change.kind==="rejected"?fact=Object.freeze({...time,kind:"rejected",reason:change.reason,diagnostic:projectDiagnostic(change.error)}):fact=Object.freeze({...time,kind:change.kind}),this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"entry",fact})}}export{RunnerEntryFeedback};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{randomUUID}from"node:crypto";import{ProgressChannel}from"@weiliang0121/capix-changes";import"./observation.js";import{projectInvocation,projectResource,projectFact,projectBusiness,projectCheckpoint,projectDiagnostic}from"./observation-projection.js";class RunnerEntryFeedback{static{__name(this,"RunnerEntryFeedback")}runnerId;subscriptions;clock;id=randomUUID();#sequence=0;#entries;created;constructor(runnerId,subscriptions,clock){this.runnerId=runnerId,this.subscriptions=subscriptions,this.clock=clock,this.#entries=new ProgressChannel({receive:__name(change=>this.publishEntry(change),"receive")}),this.created=Object.freeze({receive:__name(identity=>{this.#entries.publish({kind:"attached",identity})},"receive")})}requested(mode,requestedContextId){this.#entries.publish({kind:"requested",mode,...requestedContextId!==void 0?{requestedContextId}:{}})}entry(change){change.kind!=="established"&&this.#entries.publish(change)}settled(status,error){this.#entries.publish({kind:"settled",status,error})}receivers(signal){return Object.freeze({invocation:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"invocation",fact:projectInvocation(fact,signal)})},"receive")},resource:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"resource",fact:projectResource(fact)})},"receive")},fact:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"fact",fact:projectFact(fact)})},"receive")},business:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"business",fact:projectBusiness(fact)})},"receive")},checkpoint:{receive:__name(fact=>{this.subscriptions.active&&this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"checkpoint",fact:projectCheckpoint(fact,signal)})},"receive")}})}publishEntry(change){const sequence=++this.#sequence;if(!this.subscriptions.active)return;const time={sequence,occurredAt:this.clock.now()};let fact;change.kind==="requested"?fact=Object.freeze({...time,...change}):change.kind==="attached"?fact=Object.freeze({...time,kind:"attached",identity:Object.freeze({...change.identity})}):change.kind==="settled"?fact=Object.freeze({...time,kind:"settled",status:change.status,...change.status!=="succeeded"?{diagnostic:projectDiagnostic(change.error)}:{}}):change.kind==="entry-failed"?fact=Object.freeze({...time,kind:"entry-failed",diagnostic:projectDiagnostic(change.error)}):change.kind==="rejected"?fact=Object.freeze({...time,kind:"rejected",reason:change.reason,diagnostic:projectDiagnostic(change.error)}):fact=Object.freeze({...time,kind:change.kind}),this.subscriptions.publish({runnerId:this.runnerId,entryId:this.id,source:"entry",fact})}}export{RunnerEntryFeedback};

package/dist/runner/observation-contract.d.ts

@@ -58,18 +58,15 @@ export type RunnerCheckpointChild = Readonly<{
     state: 'failed';
     reception?: 'handled';
 })>;
-export interface RunnerTranscriptFact {
-    readonly transcriptId: string;
-    readonly revision: number;
-    readonly change: 'messages-appended' | 'segment-started';
-    readonly start: number;
-    readonly end: number;
-}
-export interface RunnerMemoryFact {
-    readonly memoriesId: string;
+export interface RunnerFact {
+    readonly contextId: string;
+    readonly offerId: string;
+    readonly access: string;
+    readonly supplyId: string;
+    readonly operationId: string;
     readonly sequence: number;
-    readonly action: 'create' | 'update';
-    readonly memoryId: string;
+    readonly occurredAt: string;
+    readonly name?: string;
 }
 export type RunnerCheckpointFact = Readonly<{
     activityId: string;
@@ -102,11 +99,8 @@ export type RunnerCheckpointFact = Readonly<{
     kind: 'resource';
     fact: RunnerResourceFact;
 } | {
-    kind: 'transcript';
-    fact: RunnerTranscriptFact;
-} | {
-    kind: 'memory';
-    fact: RunnerMemoryFact;
+    kind: 'fact';
+    fact: RunnerFact;
 } | {
     kind: 'failed';
     stage: 'capture' | 'save' | 'restore' | 'finish';
@@ -134,4 +128,7 @@ export type RunnerObservationEvent = Readonly<{
 } | {
     source: 'business';
     fact: RunnerBusinessFact;
+} | {
+    source: 'fact';
+    fact: RunnerFact;
 })>;

package/dist/runner/observation-projection.d.ts

@@ -1,7 +1,8 @@
-import { type InvocationFact, type InvocationProgress, type ResourceObservation, type BusinessObservation, type CheckpointFact } from '@weiliang0121/capix-invocation';
-import type { RunnerDiagnostic, RunnerResourceFact, RunnerBusinessFact, RunnerCheckpointFact } from './observation-contract.js';
+import { type InvocationFact, type InvocationProgress, type ResourceObservation, type ResourceFact, type BusinessObservation, type CheckpointFact } from '@weiliang0121/capix-invocation';
+import type { RunnerDiagnostic, RunnerResourceFact, RunnerFact, RunnerBusinessFact, RunnerCheckpointFact } from './observation-contract.js';
 export declare function projectInvocation(fact: InvocationFact, signal: AbortSignal): InvocationProgress;
 export declare function projectResource(fact: ResourceObservation): RunnerResourceFact;
+export declare function projectFact(fact: ResourceFact): RunnerFact;
 export declare function projectBusiness(fact: BusinessObservation): RunnerBusinessFact;
 export declare function projectDiagnostic(error: unknown): RunnerDiagnostic;
 export declare function projectCheckpoint(fact: CheckpointFact, signal: AbortSignal): RunnerCheckpointFact;

package/dist/runner/observation-projection.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{RuntimeErrorHelper}from"@weiliang0121/capix-diagnostics";import{invocationProgress}from"@weiliang0121/capix-invocation";function projectInvocation(fact,signal){return invocationProgress(fact,signal)}__name(projectInvocation,"projectInvocation");function projectResource(fact){return Object.freeze({contextId:fact.contextId,offerId:fact.offerId,access:fact.access,supplyId:fact.supplyId,sequence:fact.sequence,occurredAt:fact.occurredAt,phase:fact.phase,...fact.interactionId!==void 0?{interactionId:fact.interactionId}:{}})}__name(projectResource,"projectResource");function projectBusiness(fact){return Object.freeze({identity:projectIdentity(fact.identity),sequence:fact.sequence,occurredAt:fact.occurredAt,event:fact.event.event})}__name(projectBusiness,"projectBusiness");function projectDiagnostic(error){try{const diagnostic=RuntimeErrorHelper.format(error);return Object.freeze({code:diagnostic.code.slice(0,128),message:diagnostic.message.slice(0,512)})}catch{return Object.freeze({code:"OBSERVATION_DIAGNOSTIC_FAILED",message:"The failure could not be described."})}}__name(projectDiagnostic,"projectDiagnostic");function projectCheckpoint(fact,signal){const base={activityId:fact.activityId,contextId:fact.contextId,owner:projectIdentity(fact.owner),recovering:fact.recovering,sequence:fact.sequence,occurredAt:fact.occurredAt};switch(fact.kind){case"captured":case"saved":case"checking":case"continued":return Object.freeze({...base,kind:fact.kind,checkpointId:fact.checkpointId,point:fact.point});case"installed":return Object.freeze({...base,kind:fact.kind,checkpointId:fact.checkpointId,point:fact.point,baseline:Object.freeze({round:fact.frame.round,nextChildOrder:fact.frame.nextChildOrder,childCount:fact.frame.children.length})});case"child-restored":return Object.freeze({...base,kind:fact.kind,child:projectChild(fact.child),mode:fact.mode});case"activity":return Object.freeze({...base,kind:fact.kind,fact:projectInvocation(fact.fact,signal)});case"resource":return Object.freeze({...base,kind:fact.kind,fact:projectResource(fact.fact)});case"transcript":{const change=fact.fact.change,content=Object.freeze({transcriptId:fact.fact.transcriptId,revision:fact.fact.revision,change:change.kind,start:change.start,end:change.kind==="messages-appended"?change.start+change.messages.length:change.end});return Object.freeze({...base,kind:fact.kind,fact:content})}case"memory":return Object.freeze({...base,kind:fact.kind,fact:Object.freeze({memoriesId:fact.fact.memoriesId,sequence:fact.fact.sequence,action:fact.fact.change.action,memoryId:fact.fact.change.memoryId})});case"failed":return Object.freeze({...base,kind:fact.kind,stage:fact.stage,diagnostic:projectDiagnostic(fact.error),...fact.childContextId!==void 0?{childContextId:fact.childContextId}:{}});case"finishing":case"finished":return Object.freeze({...base,kind:fact.kind,status:fact.status})}}__name(projectCheckpoint,"projectCheckpoint");function projectIdentity(identity){return Object.freeze({contextId:identity.contextId,kind:identity.kind,...identity.parentContextId!==void 0?{parentContextId:identity.parentContextId}:{}})}__name(projectIdentity,"projectIdentity");function projectChild(child){const base={identity:projectIdentity(child.identity),round:child.round,order:child.order,...child.key!==void 0?{key:child.key}:{}};return child.state.kind==="waiting"?Object.freeze({...base,state:child.state.kind}):child.state.kind==="returned"?Object.freeze({...base,state:child.state.kind,reception:child.state.reception.kind}):Object.freeze({...base,state:child.state.kind,...child.state.reception?{reception:child.state.reception.kind}:{}})}__name(projectChild,"projectChild");export{projectBusiness,projectCheckpoint,projectDiagnostic,projectInvocation,projectResource};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{RuntimeErrorHelper}from"@weiliang0121/capix-diagnostics";import{invocationProgress}from"@weiliang0121/capix-invocation";function projectInvocation(fact,signal){return invocationProgress(fact,signal)}__name(projectInvocation,"projectInvocation");function projectResource(fact){return Object.freeze({contextId:fact.contextId,offerId:fact.offerId,access:fact.access,supplyId:fact.supplyId,sequence:fact.sequence,occurredAt:fact.occurredAt,phase:fact.phase,...fact.interactionId!==void 0?{interactionId:fact.interactionId}:{}})}__name(projectResource,"projectResource");function projectFact(fact){return Object.freeze({contextId:fact.contextId,offerId:fact.offerId,access:fact.access,supplyId:fact.supplyId,operationId:fact.operationId,sequence:fact.sequence,occurredAt:fact.occurredAt,...fact.fact.name!==void 0?{name:fact.fact.name}:{}})}__name(projectFact,"projectFact");function projectBusiness(fact){return Object.freeze({identity:projectIdentity(fact.identity),sequence:fact.sequence,occurredAt:fact.occurredAt,event:fact.event.event})}__name(projectBusiness,"projectBusiness");function projectDiagnostic(error){try{const diagnostic=RuntimeErrorHelper.format(error);return Object.freeze({code:diagnostic.code.slice(0,128),message:diagnostic.message.slice(0,512)})}catch{return Object.freeze({code:"OBSERVATION_DIAGNOSTIC_FAILED",message:"The failure could not be described."})}}__name(projectDiagnostic,"projectDiagnostic");function projectCheckpoint(fact,signal){const base={activityId:fact.activityId,contextId:fact.contextId,owner:projectIdentity(fact.owner),recovering:fact.recovering,sequence:fact.sequence,occurredAt:fact.occurredAt};switch(fact.kind){case"captured":case"saved":case"checking":case"continued":return Object.freeze({...base,kind:fact.kind,checkpointId:fact.checkpointId,point:fact.point});case"installed":return Object.freeze({...base,kind:fact.kind,checkpointId:fact.checkpointId,point:fact.point,baseline:Object.freeze({round:fact.frame.round,nextChildOrder:fact.frame.nextChildOrder,childCount:fact.frame.children.length})});case"child-restored":return Object.freeze({...base,kind:fact.kind,child:projectChild(fact.child),mode:fact.mode});case"activity":return Object.freeze({...base,kind:fact.kind,fact:projectInvocation(fact.fact,signal)});case"resource":return Object.freeze({...base,kind:fact.kind,fact:projectResource(fact.fact)});case"fact":return Object.freeze({...base,kind:fact.kind,fact:projectFact(fact.fact)});case"failed":return Object.freeze({...base,kind:fact.kind,stage:fact.stage,diagnostic:projectDiagnostic(fact.error),...fact.childContextId!==void 0?{childContextId:fact.childContextId}:{}});case"finishing":case"finished":return Object.freeze({...base,kind:fact.kind,status:fact.status})}}__name(projectCheckpoint,"projectCheckpoint");function projectIdentity(identity){return Object.freeze({contextId:identity.contextId,kind:identity.kind,...identity.parentContextId!==void 0?{parentContextId:identity.parentContextId}:{}})}__name(projectIdentity,"projectIdentity");function projectChild(child){const base={identity:projectIdentity(child.identity),round:child.round,order:child.order,...child.key!==void 0?{key:child.key}:{}};return child.state.kind==="waiting"?Object.freeze({...base,state:child.state.kind}):child.state.kind==="returned"?Object.freeze({...base,state:child.state.kind,reception:child.state.reception.kind}):Object.freeze({...base,state:child.state.kind,...child.state.reception?{reception:child.state.reception.kind}:{}})}__name(projectChild,"projectChild");export{projectBusiness,projectCheckpoint,projectDiagnostic,projectFact,projectInvocation,projectResource};

package/dist/runner/observation.d.ts

@@ -1,6 +1,6 @@
 import { type ProgressReceiver } from '@weiliang0121/capix-changes';
 import type { RunnerObservationEvent } from './observation-contract.js';
-export type { RunnerDiagnostic, RunnerEntryFact, RunnerResourceFact, RunnerBusinessFact, RunnerCheckpointChild, RunnerCheckpointFact, RunnerObservationEvent } from './observation-contract.js';
+export type { RunnerDiagnostic, RunnerEntryFact, RunnerResourceFact, RunnerFact, RunnerBusinessFact, RunnerCheckpointChild, RunnerCheckpointFact, RunnerObservationEvent } from './observation-contract.js';
 export type RunnerObservationReceiver = ProgressReceiver<RunnerObservationEvent>;
 export interface RunnerObservation {
     subscribe(receiver: RunnerObservationReceiver): () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weiliang0121/capix-runtime",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -19,16 +19,15 @@
   },
   "dependencies": {
     "es-toolkit": "1.52.0",
-    "@weiliang0121/capix-protocol": "0.1.0",
-    "@weiliang0121/capix-structure": "0.1.0",
-    "@weiliang0121/capix-resources": "0.1.0",
-    "@weiliang0121/capix-changes": "0.1.0",
-    "@weiliang0121/capix-contracts": "0.1.0",
-    "@weiliang0121/capix-records": "0.1.0",
-    "@weiliang0121/capix-checkpoint": "0.1.0",
-    "@weiliang0121/capix-invocation": "0.1.0",
-    "@weiliang0121/capix-diagnostics": "0.1.0",
-    "@weiliang0121/capix-interaction": "0.1.0"
+    "@weiliang0121/capix-resources": "0.3.0",
+    "@weiliang0121/capix-contracts": "0.3.0",
+    "@weiliang0121/capix-changes": "0.3.0",
+    "@weiliang0121/capix-checkpoint": "0.3.0",
+    "@weiliang0121/capix-structure": "0.3.0",
+    "@weiliang0121/capix-records": "0.3.0",
+    "@weiliang0121/capix-invocation": "0.3.0",
+    "@weiliang0121/capix-interaction": "0.3.0",
+    "@weiliang0121/capix-diagnostics": "0.3.0"
   },
   "description": "Structure binding, resource assembly, and Runner for CAPiX.",
   "license": "MIT",
@@ -36,7 +35,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weiliang0121/capix.git",
-    "directory": "server/runtime"
+    "directory": "packages/runtime"
   },
   "engines": {
     "node": ">=22.23.2"
@@ -53,8 +52,17 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "devDependencies": {
+    "@weiliang0121/capix-model-exchanges": "0.3.0",
+    "@weiliang0121/capix-view": "0.3.0",
+    "@weiliang0121/capix-transcript": "0.3.0",
+    "@weiliang0121/capix-memory": "0.3.0",
+    "@weiliang0121/capix-model-provider": "0.3.0",
+    "@weiliang0121/capix-measurement": "0.3.0"
+  },
   "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 ."
   }
 }