@weiliang0121/capix-protocol 0.1.0 → 0.2.0

package/dist/conversation/service.d.ts

@@ -1,75 +0,0 @@
-import type { MemoryContent } from '../content/memory.js';
-import type { MessageLocator } from '../content/transcript.js';
-import type { CallableRecord, InvocationBoundaryRecord } from '../recording/types.js';
-import type { ResourceRecord } from '../recording/resource.js';
-import type { TranscriptRecord } from '../recording/transcript.js';
-import type { MemoryRecord } from '../recording/memory.js';
-import type { ConversationAdmission } from './delivery.js';
-import type { ConversationSubmissionBaseline } from './preview.js';
-export interface ConversationServiceInfo {
-    readonly conversationId: string;
-    readonly transcriptId: string;
-    readonly mode: 'demo' | 'live';
-    readonly answerMode?: 'material' | 'tools';
-    readonly model: string;
-    readonly admission: ConversationAdmission;
-    readonly active?: ConversationSubmissionBaseline;
-}
-export interface ConversationCallSummary {
-    readonly id: string;
-    readonly contextId: string;
-    readonly name?: string;
-    readonly status: 'running' | 'succeeded' | 'failed';
-    readonly startedAt?: string;
-    readonly input?: MessageLocator;
-    readonly answer?: MessageLocator;
-}
-export type ConversationRecordingState = {
-    readonly status: 'idle';
-    readonly recorderId?: never;
-} | {
-    readonly status: 'recording' | 'stopping' | 'stopped';
-    readonly recorderId: string;
-};
-export interface ConversationInspection {
-    readonly transcriptId: string;
-    readonly memories: {
-        readonly id: string;
-        readonly sequence: number;
-        readonly items: readonly (MemoryContent & {
-            readonly id: string;
-        })[];
-    };
-    readonly view: {
-        readonly revision: number;
-        readonly sources: Readonly<Record<'messages' | 'memories', {
-            readonly id: string;
-            readonly scope: string;
-        }>>;
-        readonly members: readonly ({
-            readonly source: 'messages';
-            readonly key: number;
-        } | {
-            readonly source: 'memories';
-            readonly key: string;
-        })[];
-    };
-    readonly recording: ConversationRecordingState & {
-        readonly revision: number;
-        readonly integrity: 'intact' | 'incomplete';
-        readonly calls: readonly ConversationCallSummary[];
-        readonly omitted: number;
-    };
-}
-export interface ConversationCallDetail {
-    readonly recorderId: string;
-    readonly revision: number;
-    readonly integrity: 'intact' | 'incomplete';
-    readonly root: CallableRecord;
-    readonly calls: readonly CallableRecord[];
-    readonly resources: readonly ResourceRecord[];
-    readonly transcripts: readonly TranscriptRecord[];
-    readonly memories: readonly MemoryRecord[];
-    readonly boundaries: readonly InvocationBoundaryRecord[];
-    readonly truncated: boolean;
-}

package/dist/conversation/service.js

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

package/dist/conversation/settings.d.ts

@@ -1,6 +0,0 @@
-export interface ModelSettings {
-    model: string;
-    contextBudget: number;
-    maxOutputTokens: number;
-    timeoutMs: number;
-}

package/dist/conversation/settings.js

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

package/dist/conversation/task.d.ts

@@ -1,11 +0,0 @@
-import type { FileTask } from './files.js';
-export type ConversationTask = {
-    readonly kind: 'reply';
-} | {
-    readonly kind: 'file';
-    readonly task: FileTask;
-} | {
-    readonly kind: 'clarify';
-} | {
-    readonly kind: 'unsupported';
-};

package/dist/conversation/task.js

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

package/dist/invocation/changes.d.ts

@@ -1,28 +0,0 @@
-import type { InvocationFailureFact } from './errors.js';
-import type { CallableKind, InvocationProcessStage, InvocationProcessAction, InvocationRelationIdentity, InvocationRelationPhase } from './types.js';
-export type InvocationEvent = Readonly<{
-    type: 'invocation';
-    contextId: string;
-    parentContextId?: string;
-    kind: CallableKind;
-    sequence: number;
-    occurredAt: string;
-    change: Readonly<{
-        kind: 'started';
-    }> | Readonly<{
-        kind: 'process';
-        processSequence: number;
-        round: number;
-        stage: InvocationProcessStage;
-        action: InvocationProcessAction;
-    }> | Readonly<{
-        kind: 'relation';
-        identity: InvocationRelationIdentity;
-        phase: InvocationRelationPhase;
-        status?: 'succeeded' | 'failed';
-        failure?: InvocationFailureFact;
-    }> | Readonly<{
-        kind: 'finished';
-        status: 'succeeded' | 'failed';
-    }>;
-}>;

package/dist/invocation/changes.js

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

package/dist/invocation/errors.d.ts

@@ -1 +0,0 @@
-export type { RuntimeErrorDetail, RuntimeErrorValue, InvocationFailureFact } from '@weiliang0121/capix-contracts';

package/dist/invocation/errors.js

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

package/dist/invocation/index.d.ts

@@ -1,3 +0,0 @@
-export * from './types.js';
-export * from './errors.js';
-export * from './changes.js';

package/dist/invocation/index.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-export*from"./types.js";export*from"./errors.js";export*from"./changes.js";

package/dist/invocation/types.d.ts

@@ -1,16 +0,0 @@
-export { callableKinds, type CallableKind } from '@weiliang0121/capix-contracts';
-export type LegacyInvocationLevel = 'runtime' | 'execution' | 'operation' | 'attempt';
-export declare const invocationProcessStages: readonly ["execute", "receive", "handling", "control"];
-export declare const invocationProcessActions: readonly ["start", "return", "throw", "continue", "unhandled", "stop"];
-export type InvocationProcessStage = (typeof invocationProcessStages)[number];
-export type InvocationProcessAction = (typeof invocationProcessActions)[number];
-export interface InvocationRelationIdentity {
-    readonly parentContextId: string;
-    readonly childContextId: string;
-    readonly parentRound: number;
-    readonly key?: string;
-}
-export type InvocationRelationPhase = 'attached' | 'returned' | 'receiving' | 'accepted' | 'handled' | 'failed';
-export interface InvocationOrigin {
-    readonly contextId: string;
-}

package/dist/invocation/types.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-import{callableKinds}from"@weiliang0121/capix-contracts";const invocationProcessStages=["execute","receive","handling","control"],invocationProcessActions=["start","return","throw","continue","unhandled","stop"];export{callableKinds,invocationProcessActions,invocationProcessStages};

package/dist/observer/archive.d.ts

@@ -1,9 +0,0 @@
-export interface RecordingArchive {
-    readonly sourceId: string;
-    readonly rootIds: readonly string[];
-    readonly revision: number;
-    readonly state: 'open' | 'sealed' | 'incomplete';
-}
-export type RecordingArchiveOrigin = Omit<RecordingArchive, 'rootIds'>;
-export declare function validateRecordingArchiveOrigin(value: unknown): asserts value is RecordingArchiveOrigin;
-export declare function validateRecordingArchives(value: unknown): asserts value is readonly RecordingArchive[];

package/dist/observer/archive.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});function validateRecordingArchiveOrigin(value){if(!value||typeof value!="object")throw new Error("\u5386\u53F2\u8BB0\u5F55\u6765\u6E90\u683C\u5F0F\u65E0\u6548\u3002");const source=value;if(typeof source.sourceId!="string"||!source.sourceId||!Number.isSafeInteger(source.revision)||source.revision<0||!["open","sealed","incomplete"].includes(source.state))throw new Error("\u5386\u53F2\u8BB0\u5F55\u6765\u6E90\u683C\u5F0F\u65E0\u6548\u3002")}__name(validateRecordingArchiveOrigin,"validateRecordingArchiveOrigin");function validateRecordingArchives(value){if(!Array.isArray(value))throw new Error("\u5386\u53F2\u8BB0\u5F55\u6765\u6E90\u683C\u5F0F\u65E0\u6548\u3002");const sources=new Set,roots=new Set;for(const archive of value){validateRecordingArchiveOrigin(archive);const source=archive;if(sources.has(source.sourceId)||!Array.isArray(source.rootIds)||source.rootIds.some(id=>typeof id!="string"||!id||roots.has(id)))throw new Error("\u5386\u53F2\u8BB0\u5F55\u6765\u6E90\u5F52\u5C5E\u65E0\u6548\u3002");sources.add(source.sourceId);for(const id of source.rootIds){if(roots.has(id))throw new Error("\u5386\u53F2\u8BB0\u5F55\u6765\u6E90\u5F52\u5C5E\u65E0\u6548\u3002");roots.add(id)}}}__name(validateRecordingArchives,"validateRecordingArchives");export{validateRecordingArchiveOrigin,validateRecordingArchives};

package/dist/observer/changes.d.ts

@@ -1,4 +0,0 @@
-import type { TranscriptEvent, MemoryEvent } from '../content/changes.js';
-import type { RecordChangeEvent } from '../recording/changes.js';
-import type { InvocationEvent } from '../invocation/changes.js';
-export type ObserverChange = TranscriptEvent | MemoryEvent | RecordChangeEvent | InvocationEvent;

package/dist/observer/changes.js

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

package/dist/observer/execution.d.ts

@@ -1,10 +0,0 @@
-import type { SelectionObservation } from './selection.js';
-import type { OperationRecord } from '../recording/types.js';
-export interface ExecutionObservation extends Omit<SelectionObservation, 'executions'> {
-    executions: (SelectionObservation['executions'][number] & {
-        response?: {
-            index?: number;
-        };
-        memoryStatus?: OperationRecord['status'];
-    })[];
-}

package/dist/observer/execution.js

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

package/dist/observer/index.d.ts

@@ -1,8 +0,0 @@
-export * from './overview.js';
-export * from './execution.js';
-export * from './memory.js';
-export * from './selection.js';
-export * from './changes.js';
-export * from './stream.js';
-export * from './archive.js';
-export * from './interaction.js';

package/dist/observer/index.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-export*from"./overview.js";export*from"./execution.js";export*from"./memory.js";export*from"./selection.js";export*from"./changes.js";export*from"./stream.js";export*from"./archive.js";export*from"./interaction.js";

package/dist/observer/interaction.d.ts

@@ -1,31 +0,0 @@
-import type { RuntimeErrorValue } from '../invocation/errors.js';
-export interface CallInteractionLinks {
-    readonly callId: string;
-    readonly interactionIds: readonly string[];
-}
-export interface InteractionObservation {
-    readonly id: string;
-    readonly contract: string;
-    readonly revision: number;
-    readonly delivery: 'prepared' | 'started';
-    readonly retained: 'persistent' | 'memory';
-    readonly model: string;
-    readonly purpose: string;
-    readonly result: {
-        readonly kind: 'pending';
-    } | {
-        readonly kind: 'received';
-        readonly feedbackId: string;
-    } | {
-        readonly kind: 'unavailable';
-        readonly error: RuntimeErrorValue;
-    };
-}
-export type InteractionUpdate = {
-    readonly type: 'snapshot';
-    readonly value: InteractionObservation;
-} | {
-    readonly type: 'error';
-    readonly error: string;
-    readonly code?: string;
-};

package/dist/observer/interaction.js

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

package/dist/observer/memory.d.ts

@@ -1,13 +0,0 @@
-import type { MessageLocator } from '../content/transcript.js';
-import type { MemoryRecord } from '../recording/memory.js';
-import type { MemoryResultSource } from '../content/memory.js';
-export interface MemoryObservation {
-    readonly items: readonly {
-        id: string;
-        topic: string;
-        content: string;
-        sources: readonly MessageLocator[];
-        sourceResults?: readonly MemoryResultSource[];
-        records: readonly MemoryRecord[];
-    }[];
-}

package/dist/observer/memory.js

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

package/dist/observer/overview.d.ts

@@ -1,45 +0,0 @@
-import type { RecordingArchive, RecordingArchiveOrigin } from './archive.js';
-import type { CallableKind } from '../invocation/types.js';
-import type { ExecutionRecord } from '../recording/types.js';
-import type { ExecutionObservation } from './execution.js';
-import type { MemoryRecord } from '../recording/memory.js';
-import type { TranscriptRangeLocator } from '../content/transcript.js';
-export interface SourceResponse {
-    path: string;
-    content: string;
-}
-export type { ObservationUpdate } from './stream.js';
-export interface InvocationSummary {
-    id: string;
-    contextId: string;
-    recordType: CallableKind;
-    parentId?: string;
-    name: string;
-    label: string;
-    source: string;
-    status: ExecutionRecord['status'];
-    offsetMs: number;
-    durationMs?: number;
-}
-type ObservedExecution = ExecutionObservation['executions'][number];
-export interface ExecutionSummary extends ObservedExecution {
-    readonly archive?: RecordingArchiveOrigin;
-    durationMs?: number;
-    observedOffsetMs: number;
-    calls: InvocationSummary[];
-    transcriptRange?: TranscriptRangeLocator;
-    availableMemoryIds: string[];
-    memoryChanges: {
-        id: string;
-        memoryId: string;
-        operationId?: string;
-        action: MemoryRecord['value']['action'];
-        change: string;
-    }[];
-}
-export interface ObserverOverview {
-    readonly archives?: readonly RecordingArchive[];
-    transcriptId: string;
-    messages: ExecutionObservation['messages'];
-    executions: ExecutionSummary[];
-}

package/dist/observer/overview.js

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

package/dist/observer/selection.d.ts

@@ -1,19 +0,0 @@
-import type { ExecutionRecord, OperationRecord } from '../recording/types.js';
-export interface SelectionObservation {
-    transcriptId: string;
-    messages: {
-        index: number;
-        count: number;
-    }[];
-    executions: {
-        id: string;
-        startedAt: string;
-        status: ExecutionRecord['status'];
-        inputIndex: number;
-        selections: {
-            operationId: string;
-            status: OperationRecord['status'];
-            indexes?: readonly number[];
-        }[];
-    }[];
-}

package/dist/observer/selection.js

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

package/dist/observer/stream.d.ts

@@ -1,56 +0,0 @@
-import type { ObserverOverview } from './overview.js';
-import type { MemoryObservation } from './memory.js';
-import type { RecordEntry } from '../recording/changes.js';
-import type { ObserverChange } from './changes.js';
-import type { InvocationEvent } from '../invocation/changes.js';
-import type { TranscriptEvent } from '../content/changes.js';
-export type TranscriptNotice = Omit<TranscriptEvent, 'change'> & {
-    readonly change: Readonly<{
-        kind: 'messages-appended';
-        start: number;
-        end: number;
-    }> | Extract<TranscriptEvent['change'], {
-        kind: 'segment-started';
-    }>;
-};
-export type ObservationChange = Exclude<ObserverChange, TranscriptEvent> | TranscriptNotice;
-export interface ObservationBaseline {
-    readonly type: 'baseline';
-    readonly scopeId: string;
-    readonly sequence: number;
-    readonly overview: ObserverOverview;
-    readonly memory: MemoryObservation;
-    readonly transcript: {
-        readonly id: string;
-        readonly revision: number;
-        readonly starts: readonly number[];
-    };
-    readonly memories: {
-        readonly id: string;
-        readonly sequence: number;
-    };
-    readonly recorder: {
-        readonly id: string;
-        readonly revision: number;
-    };
-    readonly entries: readonly RecordEntry[];
-    readonly invocations: readonly InvocationEvent[];
-}
-export interface ObservationDelta {
-    readonly type: 'delta';
-    readonly scopeId: string;
-    readonly sequence: number;
-    readonly changes: readonly ObservationChange[];
-}
-export type ObservationFrame = ObservationBaseline | ObservationDelta;
-export interface ObservationSourceIncomplete {
-    readonly type: 'error';
-    readonly code: 'SOURCE_INCOMPLETE';
-    readonly sourceId: string;
-    readonly error: string;
-}
-export type ObservationUpdate = ObservationFrame | ObservationSourceIncomplete | {
-    type: 'error';
-    error: string;
-    code?: string;
-};

package/dist/observer/stream.js

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

package/dist/recording/changes.d.ts

@@ -1,43 +0,0 @@
-import type { BaseRecord, ProcessRecord, RelationChangeRecord } from './types.js';
-import type { RuntimeErrorValue, InvocationFailureFact } from '../invocation/errors.js';
-export type RecordKind = 'invocation' | 'runtime' | 'runtime-call' | 'execution' | 'operation' | 'attempt' | 'invocation-boundary' | 'transcript' | 'memory' | 'resource' | 'custom';
-export interface RecordEntry {
-    readonly kind: RecordKind;
-    readonly data: BaseRecord;
-}
-export type RecordMutation = Readonly<{
-    kind: 'added';
-    entry: RecordEntry;
-    parent?: Readonly<{
-        id: string;
-        childId: string;
-    }>;
-}> | Readonly<{
-    kind: 'process-appended';
-    id: string;
-    process: ProcessRecord;
-}> | Readonly<{
-    kind: 'relation-appended';
-    id: string;
-    relation: RelationChangeRecord;
-}> | Readonly<{
-    kind: 'finished';
-    id: string;
-    status: 'succeeded' | 'failed';
-    result: Readonly<{
-        output?: unknown;
-        resultOf?: number;
-        error?: RuntimeErrorValue;
-        failure?: InvocationFailureFact;
-    }>;
-}> | Readonly<{
-    kind: 'replaced';
-    entry: RecordEntry;
-}>;
-export type RecordChangeEvent = Readonly<{
-    type: 'record';
-    recorderId: string;
-    revision: number;
-    occurredAt: string;
-    change: RecordMutation;
-}>;

package/dist/recording/changes.js

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

package/dist/recording/index.d.ts

@@ -1,7 +0,0 @@
-export * from './types.js';
-export * from './invocation.js';
-export * from './memory.js';
-export * from './transcript.js';
-export * from './resource.js';
-export * from './changes.js';
-export * from './validate.js';

package/dist/recording/index.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-export*from"./types.js";export*from"./invocation.js";export*from"./memory.js";export*from"./transcript.js";export*from"./resource.js";export*from"./changes.js";export*from"./validate.js";

package/dist/recording/invocation.d.ts

@@ -1,10 +0,0 @@
-import type { InvocationValue, ProcessRecord } from './types.js';
-type OutputProcess = Extract<ProcessRecord, {
-    type: 'return';
-    output: unknown;
-}>;
-export declare function outputProcess(value: Pick<InvocationValue, 'processes'>, sequence: number, before?: number): OutputProcess;
-export declare function hasOutput(value: InvocationValue): boolean;
-export declare function finalOutputProcess(value: Pick<InvocationValue, 'processes'>, sequence: number): OutputProcess;
-export declare function readOutput<Input, Output>(value: InvocationValue<Input, Output>): Output | undefined;
-export {};

package/dist/recording/invocation.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-var __defProp=Object.defineProperty;var __name=(target,value)=>__defProp(target,"name",{value,configurable:!0});function outputProcess(value,sequence,before=value.processes.length+1){const process=value.processes[sequence-1];if(!Number.isSafeInteger(sequence)||sequence<1||sequence>=before||!process||process.sequence!==sequence||process.type!=="return"||!Object.hasOwn(process,"output")||Object.hasOwn(process,"resultOf"))throw new Error("Invalid local result reference");return process}__name(outputProcess,"outputProcess");function hasOutput(value){return Object.hasOwn(value,"output")||Object.hasOwn(value,"resultOf")}__name(hasOutput,"hasOutput");function finalOutputProcess(value,sequence){const last=value.processes.at(-1);if(!last||last.type!=="return"||sequence!==("resultOf"in last?last.resultOf:last.sequence))throw new Error("Final result must reference the last returned output");return outputProcess(value,sequence)}__name(finalOutputProcess,"finalOutputProcess");function readOutput(value){if(Object.hasOwn(value,"resultOf")){if(Object.hasOwn(value,"output"))throw new Error("Output and local result reference are mutually exclusive");return finalOutputProcess(value,value.resultOf).output}return value.output}__name(readOutput,"readOutput");export{finalOutputProcess,hasOutput,outputProcess,readOutput};

package/dist/recording/memory.d.ts

@@ -1,18 +0,0 @@
-import type { MemoryContent, MemoryResultSource } from '../content/memory.js';
-import type { BaseRecord } from './types.js';
-export interface MemoryRecordValue {
-    readonly action: 'create' | 'update';
-    readonly change: string;
-    readonly sourceIndexes: readonly number[];
-    readonly sourceResults?: readonly MemoryResultSource[];
-    readonly result: MemoryContent;
-}
-export interface MemoryRecord extends BaseRecord<MemoryRecordValue> {
-    readonly memoryId: string;
-    readonly memoriesId: string;
-    readonly sequence: number;
-    readonly contextId?: string;
-    readonly callId?: string;
-    readonly executionId?: string;
-    readonly operationId?: string;
-}

package/dist/recording/memory.js

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

package/dist/recording/resource.d.ts

@@ -1,10 +0,0 @@
-import type { BaseRecord } from './types.js';
-export interface ResourceRecord<Detail = unknown> extends BaseRecord<Detail> {
-    readonly parentId: string;
-    readonly access: string;
-    readonly supplyId: string;
-    readonly sequence: number;
-    readonly occurredAt: string;
-    readonly phase: 'bound' | 'available' | 'unavailable' | 'started' | 'returned' | 'threw';
-    readonly interactionId?: string;
-}

package/dist/recording/resource.js

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

package/dist/recording/transcript.d.ts

@@ -1,19 +0,0 @@
-import type { BaseRecord } from './types.js';
-export type TranscriptChange = {
-    readonly action: 'append';
-    readonly start: number;
-    readonly end: number;
-} | {
-    readonly action: 'segment';
-    readonly previousStart: number;
-    readonly start: number;
-    readonly end: number;
-};
-export interface TranscriptRecord extends BaseRecord<TranscriptChange> {
-    readonly transcriptId: string;
-    readonly revision: number;
-    readonly occurredAt: string;
-    readonly contextId?: string;
-    readonly callId?: string;
-    readonly executionId?: string;
-}

package/dist/recording/transcript.js

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