@weiliang0121/capix-resources 0.1.0 → 0.2.0

package/README.md

@@ -17,4 +17,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/access.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{ResourceActivity}from"./activity.js";import{Initializer}from"./internal/initializer.js";import{synchronous}from"./internal/synchronous.js";import{captureResourceOwner,ResourceAccessClosed}from"./ports.js";import"./supply.js";class ResourceAccess{static{__name(this,"ResourceAccess")}endpoints;supply;#owner;#hooks;#activity;#locals=new Map;#closed;#started=!1;constructor(deps,supply,owner,hooks={}){this.#owner=captureResourceOwner(owner),this.#hooks=Object.freeze({validate:hooks.validate?.bind(hooks),bound:hooks.bound?.bind(hooks),available:hooks.available?.bind(hooks)}),this.#activity=new ResourceActivity(this,this.#owner);try{this.#activity.validate(),this.supply=(typeof supply=="function"?supply():supply).select(deps),this.#activity.validate(),this.endpoints=this.view(deps)}catch(error){this.failOpening(error)}}get signal(){return this.#owner?.signal}assertOpen(){if(this.#closed)throw this.#closed;this.#owner?.validate(),synchronous(this.#hooks.validate?.(),"Resource access validation")}view(deps){const entries=Object.keys(deps).map(name=>[name,this.supply.require(deps[name].offer)]),values={};for(const[name,entry]of entries)Object.defineProperty(values,name,{enumerable:!0,get:__name(()=>(this.#activity.validate(),this.#started||this.#activity.reject(new Error("Resource access requires a started window")),this.local(entry).endpoint.get()),"get")});return Object.freeze(values)}start(){if(this.#activity.validate(),this.#started)throw new Error("Resource access has already started");this.#started=!0;try{for(const entry of this.supply.entries){const local=this.local(entry);entry.offer.timing==="binding"&&local.endpoint.get()}this.#activity.validate()}catch(error){this.failOpening(error)}}close(){this.#closed||(this.#closed=new ResourceAccessClosed,this.#activity.close(this.#closed))}failOpening(error){let failure=error;try{this.close()}catch(closing){failure=new AggregateError([error,closing],"Resource opening and cleanup both failed",{cause:error})}this.#activity.reject(failure)}local(entry){const existing=this.#locals.get(entry);if(existing)return existing;const activity=this.#activity.forResource(entry),endpoint=new Initializer(()=>{this.#activity.validate();let material,value;try{if(material=entry.readMaterial(),this.#activity.validate(),value=entry.offer.createEndpoint(material,activity),value===void 0)throw new Error(`Unfulfilled resource request: ${entry.offer.name}`);this.#activity.validate()}catch(error){this.#activity.error(error);try{activity.unavailable(error)}catch(observation){this.#activity.reject(new AggregateError([error,observation],"Resource construction and observation both failed",{cause:error}))}throw error}return this.shouldPublish(this.#hooks.available,entry)&&activity.available(()=>entry.offer.describe(material)),this.#activity.validate(),value}),local={activity,endpoint};return this.#locals.set(entry,local),this.shouldPublish(this.#hooks.bound,entry)&&activity.bound(),this.#activity.validate(),local}shouldPublish(hook,entry){if(!hook)return!0;try{const result=synchronous(hook(entry),"Resource publication hook");if(typeof result!="boolean")throw new TypeError("Resource publication hook must return a boolean");return result}catch(error){this.#activity.reject(error)}}}export{ResourceAccess};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{ResourceActivity}from"./activity.js";import{Initializer}from"./internal/initializer.js";import{synchronous}from"./internal/synchronous.js";import{captureResourceOwner,ResourceAccessClosed}from"./ports.js";import"./supply.js";class ResourceAccess{static{__name(this,"ResourceAccess")}endpoints;supply;#owner;#hooks;#activity;#locals=new Map;#closed;#started=!1;constructor(deps,supply,owner,hooks={}){this.#owner=captureResourceOwner(owner),this.#hooks=Object.freeze({validate:hooks.validate?.bind(hooks),bound:hooks.bound?.bind(hooks),available:hooks.available?.bind(hooks)}),this.#activity=new ResourceActivity(this,this.#owner);try{this.#activity.validate(),this.supply=(typeof supply=="function"?supply():supply).select(deps),this.#activity.validate(),this.endpoints=this.view(deps)}catch(error){this.failOpening(error)}}get signal(){return this.#owner?.signal}assertOpen(){if(this.#closed)throw this.#closed;if(this.#owner?.validate(),this.#closed)throw this.#closed;if(synchronous(this.#hooks.validate?.(),"Resource access validation"),this.#closed)throw this.#closed}view(deps){const entries=Object.keys(deps).map(name=>[name,this.supply.require(deps[name].offer)]),values={};for(const[name,entry]of entries)Object.defineProperty(values,name,{enumerable:!0,get:__name(()=>(this.#activity.validate(),this.#started||this.#activity.reject(new Error("Resource access requires a started window")),this.local(entry).endpoint.get()),"get")});return Object.freeze(values)}start(){if(this.#activity.validate(),this.#started)throw new Error("Resource access has already started");this.#started=!0;try{for(const entry of this.supply.entries){const local=this.local(entry);entry.offer.timing==="binding"&&local.endpoint.get()}this.#activity.validate()}catch(error){this.failOpening(error)}}close(){this.#closed||(this.#closed=new ResourceAccessClosed,this.#activity.close(this.#closed))}failOpening(error){let failure=error;try{this.close()}catch(closing){failure=new AggregateError([error,closing],"Resource opening and cleanup both failed",{cause:error})}this.#activity.reject(failure)}local(entry){const existing=this.#locals.get(entry);if(existing)return existing;const activity=this.#activity.forResource(entry),endpoint=new Initializer(()=>{this.#activity.validate();let material,value;try{if(material=entry.readMaterial(),this.#activity.validate(),value=entry.offer.createEndpoint(material,activity),value===void 0)throw new Error(`Unfulfilled resource request: ${entry.offer.name}`);this.#activity.validate()}catch(error){this.#activity.error(error);try{activity.unavailable(error)}catch(observation){this.#activity.reject(new AggregateError([error,observation],"Resource construction and observation both failed",{cause:error}))}throw error}return this.shouldPublish(this.#hooks.available,entry)&&activity.available(()=>entry.offer.describe(material)),this.#activity.validate(),value}),local={activity,endpoint};return this.#locals.set(entry,local),this.shouldPublish(this.#hooks.bound,entry)&&activity.bound(),this.#activity.validate(),local}shouldPublish(hook,entry){if(!hook)return!0;try{const result=synchronous(hook(entry),"Resource publication hook");if(typeof result!="boolean")throw new TypeError("Resource publication hook must return a boolean");return result}catch(error){this.#activity.reject(error)}}}export{ResourceAccess};

package/dist/activity.d.ts

@@ -23,7 +23,9 @@ export declare class ResourceActivity {
     describe(error: unknown): unknown;
     close(reason: unknown): void;
     operate<Output, Delta = never, const Options extends OperationOptions<Output, unknown, unknown, Delta> = {}>(source: ResourceOperationSource, action: string, detail: ResourceOperationDescription<Output>, execute: (operation: ResourceOperation<Delta>) => Output | PromiseLike<Output>, options?: Options): Promise<OperationResult<Output, Options>>;
-    runSync<Output>(source: ResourceOperationSource, action: string, detail: ResourceOperationDescription<Output>, execute: () => Output): Output;
+    runSync<Output>(source: ResourceOperationSource, action: string, detail: ResourceOperationDescription<NoInfer<Output>>, execute: (operation: ResourceOperation) => Output): Output;
+    private operation;
+    private assertOperation;
     private returned;
     private checkReception;
     private combineWindowFailure;

package/dist/activity.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{receiveOperation}from"./operation/receive.js";import{ResourcePortError}from"./ports.js";import{ResourceEndpointActivity}from"./endpoint.js";import{isResourceAccessFailure}from"./failure.js";import{ResourceOperationLifetime}from"./operation/lifetime.js";class ResourceActivity{static{__name(this,"ResourceActivity")}window;owner;#sequence=0;#operations=new Set;constructor(window,owner){this.window=window,this.owner=owner}forResource(entry){return new ResourceEndpointActivity(this,Object.freeze({offerId:entry.offer.id,access:entry.offer.name,supplyId:entry.supplyId}))}validate(){try{this.window.assertOpen()}catch(error){this.reject(error)}}error(error,allowException=!1){try{this.owner?.error?.(error,allowException)}catch(report){throw report===error?error:new AggregateError([error,report],"Resource failure and its owner notification both failed",{cause:error})}}reject(error,allowException=!1){throw this.error(error,allowException),error}rejectPort(error,message){this.isProtected(error)&&this.reject(error),this.reject(new ResourcePortError(message,{cause:error}))}publish(source,phase,describe,operationId){const owner=this.owner;if(owner?.observation)try{const fact=Object.freeze({contextId:owner.contextId,...source,sequence:owner.nextSequence?owner.nextSequence():++this.#sequence,occurredAt:new Date().toISOString(),phase,...operationId?{interactionId:operationId}:{},describe}),error=owner.observation.publish(fact);if(error!==void 0)throw error}catch(error){this.reject(error)}}describe(error){return this.owner?.failures.describe(error)??{message:"Resource operation failed"}}close(reason){const operations=[...this.#operations];this.#operations.clear();const failures=[];for(const operation of operations)operation.close(reason),operation.failure&&failures.push(operation.failure);failures.length&&this.reject(failures.length===1?failures[0]:new AggregateError(failures,"Resource operation cleanup failures"))}async operate(source,action,detail,execute,options){this.validate();let reception,consume;try{const receiver=options?.result;if(options?.delta!==void 0&&typeof options.delta!="function")throw new TypeError("Delta receiver must be a function");if(receiver?.succeeded!==void 0&&typeof receiver.succeeded!="function")throw new TypeError("Success receiver must be a function");if(receiver?.failed!==void 0&&typeof receiver.failed!="function")throw new TypeError("Failure receiver must be a function");reception=options&&{...options,result:{succeeded:receiver?.succeeded?.bind(receiver),failed:receiver?.failed?.bind(receiver)}},consume=options?.delta?.bind(options)}catch(error){this.reject(error)}const operationId=randomUUID();this.publish(source,"started",()=>({action,input:detail.input?.()??null}),operationId),this.validate();const lifetime=new ResourceOperationLifetime(this.window.signal);this.#operations.add(lifetime);const operation=Object.freeze({signal:this.window.signal,onClose:__name(cleanup=>{try{return lifetime.onClose(cleanup)}catch(error){this.reject(error)}},"onClose"),emit:__name(delta=>{try{lifetime.assertOpen()}catch(error){this.reject(error)}if(this.validate(),!!consume)try{const returned=consume(delta);Promise.resolve(returned).catch(()=>{consume=void 0})}catch{consume=void 0}},"emit")});let outcome;try{outcome={status:"succeeded",value:await execute(operation)}}catch(failure){outcome={status:"failed",failure}}finally{consume=void 0,lifetime.finish(),this.#operations.delete(lifetime)}try{this.returned(source,action,detail,operationId,outcome)}catch(error){throw lifetime.failure&&error!==lifetime.failure&&this.reject(new AggregateError([error,lifetime.failure],"Resource observation and cleanup both failed",{cause:error})),error}lifetime.failure&&(outcome={status:"failed",failure:outcome.status==="failed"&&outcome.failure!==lifetime.failure?new AggregateError([outcome.failure,lifetime.failure],"Resource operation and cleanup both failed",{cause:outcome.failure}):lifetime.failure}),this.checkReception(outcome),lifetime.interruption&&this.reject(outcome.status==="failed"&&outcome.failure!==lifetime.interruption.reason?new AggregateError([outcome.failure,lifetime.interruption.reason],"Resource operation failed after local consumption ended",{cause:outcome.failure}):lifetime.interruption.reason),outcome.status==="failed"&&(this.isProtected(outcome.failure)||!reception?.result?.failed)&&this.reject(outcome.failure,!0);let received;try{received=await receiveOperation(outcome,reception)}catch(error){this.reject(error,!0)}return this.checkReception(outcome),received}runSync(source,action,detail,execute){this.validate();const operationId=randomUUID();this.publish(source,"started",()=>({action,input:detail.input?.()??null}),operationId),this.validate();let outcome;try{outcome={status:"succeeded",value:execute()}}catch(failure){outcome={status:"failed",failure}}return this.returned(source,action,detail,operationId,outcome),this.checkReception(outcome),outcome.status==="failed"&&this.reject(outcome.failure,!0),outcome.value}returned(source,action,detail,operationId,outcome){try{outcome.status==="succeeded"?this.publish(source,"returned",()=>({action,output:detail.output?.(outcome.value)??null}),operationId):this.publish(source,"threw",()=>({action,error:this.describe(outcome.failure)}),operationId)}catch(observation){throw outcome.status==="failed"&&observation!==outcome.failure&&this.reject(new AggregateError([outcome.failure,observation],"Resource operation and failure observation both failed",{cause:outcome.failure})),observation}}checkReception(outcome){try{this.window.assertOpen()}catch(windowFailure){this.reject(outcome.status==="failed"?this.combineWindowFailure(outcome.failure,windowFailure):windowFailure)}}combineWindowFailure(failure,windowFailure){const signal=this.window.signal;return windowFailure===failure||signal&&this.classify(failure,()=>this.owner?.failures.isCancellation(failure,signal)??!1)&&this.classify(windowFailure,()=>this.owner?.failures.isCancellation(windowFailure,signal)??!1)?failure:new AggregateError([failure,windowFailure],"Resource operation failed after its access window became unavailable",{cause:failure})}isProtected(error){return isResourceAccessFailure(error)||this.classify(error,()=>this.owner?.failures.isProtected(error)??!1)}classify(error,classify){try{const result=classify();if(typeof result!="boolean")throw Promise.resolve(result).catch(()=>{}),new TypeError("Resource failure classification must return a boolean");return result}catch(failure){this.reject(new AggregateError([error,failure],"Resource operation and failure classification both failed",{cause:error}))}}}export{ResourceActivity};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{randomUUID}from"node:crypto";import{receiveOperation}from"./operation/receive.js";import{ResourcePortError}from"./ports.js";import{ResourceEndpointActivity}from"./endpoint.js";import{isResourceAccessFailure}from"./failure.js";import{ResourceOperationLifetime}from"./operation/lifetime.js";class ResourceActivity{static{__name(this,"ResourceActivity")}window;owner;#sequence=0;#operations=new Set;constructor(window,owner){this.window=window,this.owner=owner}forResource(entry){return new ResourceEndpointActivity(this,Object.freeze({offerId:entry.offer.id,access:entry.offer.name,supplyId:entry.supplyId}))}validate(){try{this.window.assertOpen()}catch(error){this.reject(error)}}error(error,allowException=!1){try{this.owner?.error?.(error,allowException)}catch(report){throw report===error?error:new AggregateError([error,report],"Resource failure and its owner notification both failed",{cause:error})}}reject(error,allowException=!1){throw this.error(error,allowException),error}rejectPort(error,message){this.isProtected(error)&&this.reject(error),this.reject(new ResourcePortError(message,{cause:error}))}publish(source,phase,describe,operationId){const owner=this.owner;if(owner?.observation)try{const fact=Object.freeze({contextId:owner.contextId,...source,sequence:owner.nextSequence?owner.nextSequence():++this.#sequence,occurredAt:new Date().toISOString(),phase,...operationId?{interactionId:operationId}:{},describe}),error=owner.observation.publish(fact);if(error!==void 0)throw error}catch(error){this.reject(error)}}describe(error){return this.owner?.failures.describe(error)??{message:"Resource operation failed"}}close(reason){const operations=[...this.#operations];this.#operations.clear();const failures=[];for(const operation of operations)operation.close(reason),operation.failure&&failures.push(operation.failure);failures.length&&this.reject(failures.length===1?failures[0]:new AggregateError(failures,"Resource operation cleanup failures"))}async operate(source,action,detail,execute,options){this.validate();let reception,consume;try{const receiver=options?.result;if(options?.delta!==void 0&&typeof options.delta!="function")throw new TypeError("Delta receiver must be a function");if(receiver?.succeeded!==void 0&&typeof receiver.succeeded!="function")throw new TypeError("Success receiver must be a function");if(receiver?.failed!==void 0&&typeof receiver.failed!="function")throw new TypeError("Failure receiver must be a function");reception=options&&{...options,result:{succeeded:receiver?.succeeded?.bind(receiver),failed:receiver?.failed?.bind(receiver)}},consume=options?.delta?.bind(options)}catch(error){this.reject(error)}const operationId=randomUUID();this.publish(source,"started",()=>({action,input:detail.input?.()??null}),operationId),this.validate();const lifetime=new ResourceOperationLifetime(this.window.signal);this.#operations.add(lifetime);const operation=this.operation(source,operationId,lifetime,delta=>{if(consume)try{const returned=consume(delta);Promise.resolve(returned).catch(()=>{consume=void 0})}catch{consume=void 0}});let outcome;try{outcome={status:"succeeded",value:await execute(operation)}}catch(failure){outcome={status:"failed",failure}}finally{consume=void 0,lifetime.finish(),this.#operations.delete(lifetime)}try{this.returned(source,action,detail,operationId,outcome)}catch(error){throw lifetime.failure&&error!==lifetime.failure&&this.reject(new AggregateError([error,lifetime.failure],"Resource observation and cleanup both failed",{cause:error})),error}lifetime.failure&&(outcome={status:"failed",failure:outcome.status==="failed"&&outcome.failure!==lifetime.failure?new AggregateError([outcome.failure,lifetime.failure],"Resource operation and cleanup both failed",{cause:outcome.failure}):lifetime.failure}),this.checkReception(outcome),lifetime.interruption&&this.reject(outcome.status==="failed"&&outcome.failure!==lifetime.interruption.reason?new AggregateError([outcome.failure,lifetime.interruption.reason],"Resource operation failed after local consumption ended",{cause:outcome.failure}):lifetime.interruption.reason),outcome.status==="failed"&&(this.isProtected(outcome.failure)||!reception?.result?.failed)&&this.reject(outcome.failure,!0);let received;try{received=await receiveOperation(outcome,reception)}catch(error){this.reject(error,!0)}return this.checkReception(outcome),received}runSync(source,action,detail,execute){this.validate();const operationId=randomUUID();this.publish(source,"started",()=>({action,input:detail.input?.()??null}),operationId),this.validate();const lifetime=new ResourceOperationLifetime(this.window.signal);this.#operations.add(lifetime);const operation=this.operation(source,operationId,lifetime,()=>{});let outcome;try{outcome={status:"succeeded",value:execute(operation)}}catch(failure){outcome={status:"failed",failure}}finally{lifetime.finish(),this.#operations.delete(lifetime)}try{this.returned(source,action,detail,operationId,outcome)}catch(error){throw lifetime.failure&&error!==lifetime.failure&&this.reject(new AggregateError([error,lifetime.failure],"Resource observation and cleanup both failed",{cause:error})),error}return lifetime.failure&&(outcome={status:"failed",failure:outcome.status==="failed"&&outcome.failure!==lifetime.failure?new AggregateError([outcome.failure,lifetime.failure],"Resource operation and cleanup both failed",{cause:outcome.failure}):lifetime.failure}),this.checkReception(outcome),lifetime.interruption&&this.reject(outcome.status==="failed"&&outcome.failure!==lifetime.interruption.reason?new AggregateError([outcome.failure,lifetime.interruption.reason],"Resource operation failed after local consumption ended",{cause:outcome.failure}):lifetime.interruption.reason),outcome.status==="failed"&&this.reject(outcome.failure,!0),outcome.value}operation(source,operationId,lifetime,emit){const owner=this.owner,origin=owner?Object.freeze({contextId:owner.contextId}):void 0;return Object.freeze({signal:this.window.signal,origin,onClose:__name(cleanup=>{try{return lifetime.onClose(cleanup)}catch(error){this.reject(error)}},"onClose"),emit:__name(delta=>{this.assertOperation(lifetime),emit(delta)},"emit"),facts:__name(type=>{if(this.assertOperation(lifetime),!!owner?.facts)return Object.freeze({publish:__name(event=>{this.assertOperation(lifetime);try{const fact=type.create(event),publication=Object.freeze({...source,contextId:owner.contextId,operationId,sequence:owner.nextSequence?owner.nextSequence():++this.#sequence,occurredAt:new Date().toISOString(),fact});this.assertOperation(lifetime);const error=owner.facts.publish(publication);if(error!==void 0)throw error}catch(error){this.rejectPort(error,"Required fact publication failed")}},"publish")})},"facts")})}assertOperation(lifetime){try{lifetime.assertOpen(),this.window.assertOpen(),lifetime.assertOpen()}catch(error){this.reject(error)}}returned(source,action,detail,operationId,outcome){try{outcome.status==="succeeded"?this.publish(source,"returned",()=>({action,output:detail.output?.(outcome.value)??null}),operationId):this.publish(source,"threw",()=>({action,error:this.describe(outcome.failure)}),operationId)}catch(observation){throw outcome.status==="failed"&&observation!==outcome.failure&&this.reject(new AggregateError([outcome.failure,observation],"Resource operation and failure observation both failed",{cause:outcome.failure})),observation}}checkReception(outcome){try{this.window.assertOpen()}catch(windowFailure){this.reject(outcome.status==="failed"?this.combineWindowFailure(outcome.failure,windowFailure):windowFailure)}}combineWindowFailure(failure,windowFailure){const signal=this.window.signal;return windowFailure===failure||signal&&this.classify(failure,()=>this.owner?.failures.isCancellation(failure,signal)??!1)&&this.classify(windowFailure,()=>this.owner?.failures.isCancellation(windowFailure,signal)??!1)?failure:new AggregateError([failure,windowFailure],"Resource operation failed after its access window became unavailable",{cause:failure})}isProtected(error){return isResourceAccessFailure(error)||this.classify(error,()=>this.owner?.failures.isProtected(error)??!1)}classify(error,classify){try{const result=classify();if(typeof result!="boolean")throw Promise.resolve(result).catch(()=>{}),new TypeError("Resource failure classification must return a boolean");return result}catch(failure){this.reject(new AggregateError([error,failure],"Resource operation and failure classification both failed",{cause:error}))}}}export{ResourceActivity};

package/dist/endpoint.d.ts

@@ -1,4 +1,3 @@
-import type { ResourceEventConsumer } from './facts.js';
 import type { ResourceActivity, ResourceOperationDescription } from './activity.js';
 import type { ResourceOperation } from './methods.js';
 import type { OperationOptions, OperationResult } from '@weiliang0121/capix-contracts';
@@ -21,44 +20,11 @@ export declare class ResourceEndpointActivity {
         parentContextId: string;
         childContextId: string;
     }>;
-    get transcriptObservation(): ResourceEventConsumer<Readonly<{
-        type: "transcript";
-        transcriptId: string;
-        revision: number;
-        occurredAt: string;
-        origin?: import("@weiliang0121/capix-protocol").InvocationOrigin;
-        change: Readonly<{
-            kind: "messages-appended";
-            start: number;
-            messages: readonly Readonly<import("@weiliang0121/capix-protocol").Message>[];
-        }> | Readonly<{
-            kind: "segment-started";
-            previousStart: number;
-            start: number;
-            end: number;
-        }>;
-    }>> | undefined;
-    get memoryObservation(): ResourceEventConsumer<Readonly<{
-        type: "memory";
-        memoriesId: string;
-        sequence: number;
-        occurredAt: string;
-        origin?: import("@weiliang0121/capix-protocol").InvocationOrigin;
-        change: Readonly<{
-            action: "create" | "update";
-            memoryId: string;
-            explanation: string;
-            sourceIndexes: readonly number[];
-            sourceResults?: readonly import("@weiliang0121/capix-protocol").MemoryResultSource[];
-            result: import("@weiliang0121/capix-protocol").MemoryContent;
-        }>;
-    }>> | undefined;
     bound(): void;
     available(describe: () => unknown): void;
     unavailable(error: unknown): void;
     operate<Output, Delta = never, const Options extends OperationOptions<Output, unknown, unknown, Delta> = {}>(action: string, detail: ResourceOperationDescription<Output>, execute: (operation: ResourceOperation<Delta>) => Output | PromiseLike<Output>, options?: Options): Promise<OperationResult<Output, Options>>;
-    runSync<Output>(action: string, detail: ResourceOperationDescription<Output>, execute: () => Output): Output;
+    runSync<Output>(action: string, detail: ResourceOperationDescription<NoInfer<Output>>, execute: (operation: ResourceOperation) => Output): Output;
     runAsync<Output>(action: string, detail: ResourceOperationDescription<Output>, execute: () => Promise<Output>): Promise<Output>;
-    private contentConsumer;
     private rejectPort;
 }

package/dist/endpoint.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{ResourcePortError}from"./errors.js";class ResourceEndpointActivity{static{__name(this,"ResourceEndpointActivity")}activity;source;constructor(activity,source){this.activity=activity,this.source=source,Object.freeze(this)}get access(){return this.source.access}get supplyId(){return this.source.supplyId}get origin(){const owner=this.activity.owner;return owner?Object.freeze({contextId:owner.contextId}):void 0}validate(){this.activity.validate()}reception(){this.validate();try{if(!this.activity.owner?.reception)throw new ResourcePortError("Fixed operations require a parent reception binding");return this.activity.owner.reception()}catch(error){this.rejectPort(error,"Resource reception provenance failed")}}get transcriptObservation(){return this.contentConsumer(this.activity.owner?.transcript)}get memoryObservation(){return this.contentConsumer(this.activity.owner?.memory)}bound(){this.activity.publish(this.source,"bound",()=>null)}available(describe){this.activity.publish(this.source,"available",describe)}unavailable(error){this.activity.publish(this.source,"unavailable",()=>({error:this.activity.describe(error)}))}operate(action,detail,execute,options){return this.activity.operate(this.source,action,detail,execute,options)}runSync(action,detail,execute){return this.activity.runSync(this.source,action,detail,execute)}runAsync(action,detail,execute){return this.activity.operate(this.source,action,detail,execute)}contentConsumer(consumer){if(consumer)return Object.freeze({publish:__name(event=>{try{const error=consumer.publish(event);if(error!==void 0)throw error}catch(error){this.rejectPort(error,"Required content publication failed")}},"publish")})}rejectPort(error,message){this.activity.rejectPort(error,message)}}export{ResourceEndpointActivity};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{ResourcePortError}from"./errors.js";class ResourceEndpointActivity{static{__name(this,"ResourceEndpointActivity")}activity;source;constructor(activity,source){this.activity=activity,this.source=source,Object.freeze(this)}get access(){return this.source.access}get supplyId(){return this.source.supplyId}get origin(){const owner=this.activity.owner;return owner?Object.freeze({contextId:owner.contextId}):void 0}validate(){this.activity.validate()}reception(){this.validate();try{if(!this.activity.owner?.reception)throw new ResourcePortError("Fixed operations require a parent reception binding");return this.activity.owner.reception()}catch(error){this.rejectPort(error,"Resource reception provenance failed")}}bound(){this.activity.publish(this.source,"bound",()=>null)}available(describe){this.activity.publish(this.source,"available",describe)}unavailable(error){this.activity.publish(this.source,"unavailable",()=>({error:this.activity.describe(error)}))}operate(action,detail,execute,options){return this.activity.operate(this.source,action,detail,execute,options)}runSync(action,detail,execute){return this.activity.runSync(this.source,action,detail,execute)}runAsync(action,detail,execute){return this.activity.operate(this.source,action,detail,execute)}rejectPort(error,message){this.activity.rejectPort(error,message)}}export{ResourceEndpointActivity};

package/dist/facts.d.ts

@@ -1,5 +1,6 @@
+import type { Fact } from '@weiliang0121/capix-changes';
 export interface ResourceEventConsumer<Event> {
-    publish(event: Event): unknown | undefined;
+    readonly publish: (event: Event) => unknown | undefined;
 }
 export interface ResourceObservation {
     readonly contextId: string;
@@ -12,3 +13,13 @@ export interface ResourceObservation {
     readonly interactionId?: string;
     readonly describe: () => unknown;
 }
+export interface ResourceFact {
+    readonly contextId: string;
+    readonly offerId: string;
+    readonly access: string;
+    readonly supplyId: string;
+    readonly operationId: string;
+    readonly sequence: number;
+    readonly occurredAt: string;
+    readonly fact: Fact;
+}

package/dist/index.d.ts

@@ -10,4 +10,4 @@ export { ResourceSupply, type ResourceSupplyEntry } from './supply.js';
 export { ResourceActivity, type ResourceOperationDescription } from './activity.js';
 export { ResourceEndpointActivity } from './endpoint.js';
 export { captureResourceOwner, ResourceAccessClosed, ResourcePortError, type ResourceOwner, type ResourceFailurePolicy, type ResourceWindow } from './ports.js';
-export type { ResourceEventConsumer, ResourceObservation } from './facts.js';
+export type { ResourceEventConsumer, ResourceObservation, ResourceFact } from './facts.js';

package/dist/methods.d.ts

@@ -1,7 +1,11 @@
-import type { OperationOptions, OperationResult } from '@weiliang0121/capix-contracts';
+import type { FactType } from '@weiliang0121/capix-changes';
+import type { ResourceEventConsumer } from './facts.js';
+import type { InvocationOrigin, OperationOptions, OperationResult } from '@weiliang0121/capix-contracts';
 import type { ResourceEndpointActivity } from './endpoint.js';
 export interface ResourceOperation<Delta = never> {
     readonly signal: AbortSignal | undefined;
+    readonly origin: InvocationOrigin | undefined;
+    facts<Event>(type: FactType<Event>): ResourceEventConsumer<Event> | undefined;
     emit(delta: Delta): void;
     onClose(cleanup: (reason: unknown) => void): () => void;
 }

package/dist/ports.d.ts

@@ -1,5 +1,4 @@
-import type { TranscriptEvent, MemoryEvent } from '@weiliang0121/capix-protocol';
-import type { ResourceEventConsumer, ResourceObservation } from './facts.js';
+import type { ResourceEventConsumer, ResourceObservation, ResourceFact } from './facts.js';
 export interface ResourceFailurePolicy {
     isProtected(error: unknown): boolean;
     isCancellation(error: unknown, signal: AbortSignal): boolean;
@@ -15,8 +14,7 @@ export interface ResourceOwner {
     }>;
     readonly nextSequence?: () => number;
     readonly observation?: ResourceEventConsumer<ResourceObservation>;
-    readonly transcript?: ResourceEventConsumer<TranscriptEvent>;
-    readonly memory?: ResourceEventConsumer<MemoryEvent>;
+    readonly facts?: ResourceEventConsumer<ResourceFact>;
     readonly validate: () => void;
     readonly error?: (error: unknown, allowException?: boolean) => void;
 }

package/dist/ports.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{synchronous}from"./internal/synchronous.js";import{ResourceAccessClosed,ResourcePortError}from"./errors.js";function captureResourceOwner(owner){if(!owner)return;const policy=owner.failures;if(!policy||typeof policy.isProtected!="function"||typeof policy.isCancellation!="function"||typeof policy.describe!="function")throw new TypeError("Resource owner requires a complete failure policy");if(typeof owner.validate!="function")throw new TypeError("Resource owner requires an access validator");const describe=policy.describe.bind(policy),validate=owner.validate.bind(owner),error=owner.error?.bind(owner),reception=owner.reception?.bind(owner),nextSequence=owner.nextSequence?.bind(owner);return Object.freeze({contextId:owner.contextId,signal:owner.signal,failures:Object.freeze({isProtected:policy.isProtected.bind(policy),isCancellation:policy.isCancellation.bind(policy),describe:__name(failure=>synchronous(describe(failure),"Resource failure description"),"describe")}),validate:__name(()=>{synchronous(validate(),"Resource owner validation")},"validate"),error:error?(failure,allowException)=>{synchronous(error(failure,allowException),"Resource failure reporting")}:void 0,reception:reception?()=>synchronous(reception(),"Resource reception provenance"):void 0,nextSequence:nextSequence?()=>synchronous(nextSequence(),"Resource observation sequence"):void 0,observation:captureConsumer(owner.observation),transcript:captureConsumer(owner.transcript),memory:captureConsumer(owner.memory)})}__name(captureResourceOwner,"captureResourceOwner");function captureConsumer(consumer){if(!consumer)return;const publish=consumer.publish.bind(consumer);return Object.freeze({publish:__name(event=>synchronous(publish(event),"Resource event publication"),"publish")})}__name(captureConsumer,"captureConsumer");export{ResourceAccessClosed,ResourcePortError,captureResourceOwner};
+var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});import{synchronous}from"./internal/synchronous.js";import{ResourceAccessClosed,ResourcePortError}from"./errors.js";function captureResourceOwner(owner){if(!owner)return;const policy=owner.failures;if(!policy||typeof policy.isProtected!="function"||typeof policy.isCancellation!="function"||typeof policy.describe!="function")throw new TypeError("Resource owner requires a complete failure policy");if(typeof owner.validate!="function")throw new TypeError("Resource owner requires an access validator");const describe=policy.describe.bind(policy),validate=owner.validate.bind(owner),error=owner.error?.bind(owner),reception=owner.reception?.bind(owner),nextSequence=owner.nextSequence?.bind(owner);return Object.freeze({contextId:owner.contextId,signal:owner.signal,failures:Object.freeze({isProtected:policy.isProtected.bind(policy),isCancellation:policy.isCancellation.bind(policy),describe:__name(failure=>synchronous(describe(failure),"Resource failure description"),"describe")}),validate:__name(()=>{synchronous(validate(),"Resource owner validation")},"validate"),error:error?(failure,allowException)=>{synchronous(error(failure,allowException),"Resource failure reporting")}:void 0,reception:reception?()=>synchronous(reception(),"Resource reception provenance"):void 0,nextSequence:nextSequence?()=>synchronous(nextSequence(),"Resource observation sequence"):void 0,observation:captureConsumer(owner.observation),facts:captureConsumer(owner.facts)})}__name(captureResourceOwner,"captureResourceOwner");function captureConsumer(consumer){if(!consumer)return;const publish=consumer.publish.bind(consumer);return Object.freeze({publish:__name(event=>synchronous(publish(event),"Resource event publication"),"publish")})}__name(captureConsumer,"captureConsumer");export{ResourceAccessClosed,ResourcePortError,captureResourceOwner};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weiliang0121/capix-resources",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {
@@ -14,8 +14,8 @@
     }
   },
   "dependencies": {
-    "@weiliang0121/capix-protocol": "0.1.0",
-    "@weiliang0121/capix-contracts": "0.1.0"
+    "@weiliang0121/capix-contracts": "0.2.0",
+    "@weiliang0121/capix-changes": "0.2.0"
   },
   "description": "Resource definitions, fixed supplies, and controlled access endpoints for CAPiX.",
   "license": "MIT",
@@ -23,7 +23,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weiliang0121/capix.git",
-    "directory": "server/resources"
+    "directory": "packages/resources"
   },
   "engines": {
     "node": ">=22.23.2"
@@ -42,6 +42,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 ."
   }
 }