@weiliang0121/capix-protocol 0.1.0 → 0.3.0

package/README.md

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

package/dist/acceptance.d.ts

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

package/dist/acceptance.js

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

package/dist/index.d.ts

@@ -1,5 +1,2 @@
-export * from './content/index.js';
-export * from './invocation/index.js';
-export * from './conversation/index.js';
-export * from './recording/index.js';
-export * from './observer/index.js';
+export type { TranscriptWireMessage, TranscriptWireSnapshot, TranscriptWireEvent, TranscriptFrame, TranscriptUpdate } from './transcript.js';
+export { acceptTranscriptUpdate } from './acceptance.js';

package/dist/index.js

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

package/dist/transcript.d.ts

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

package/package.json

@@ -1,44 +1,24 @@
 {
   "name": "@weiliang0121/capix-protocol",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "private": false,
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./content": {
-      "types": "./dist/content/index.d.ts",
-      "import": "./dist/content/index.js"
-    },
-    "./invocation": {
-      "types": "./dist/invocation/index.d.ts",
-      "import": "./dist/invocation/index.js"
-    },
-    "./conversation": {
-      "types": "./dist/conversation/index.d.ts",
-      "import": "./dist/conversation/index.js"
-    },
-    "./recording": {
-      "types": "./dist/recording/index.d.ts",
-      "import": "./dist/recording/index.js"
-    },
-    "./observer": {
-      "types": "./dist/observer/index.d.ts",
-      "import": "./dist/observer/index.js"
     }
   },
   "dependencies": {
-    "@weiliang0121/capix-contracts": "0.1.0"
+    "@weiliang0121/capix-contracts": "0.3.0"
   },
-  "description": "Serializable client/server protocol types for CAPiX.",
+  "description": "Explicit transcript baseline and delta wire contracts for CAPiX.",
   "license": "MIT",
   "author": "wei.liang (https://github.com/weiliang0121)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/weiliang0121/capix.git",
-    "directory": "protocol"
+    "directory": "packages/protocol"
   },
   "engines": {
     "node": ">=22.23.2"
@@ -55,8 +35,12 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
+  "devDependencies": {
+    "@weiliang0121/capix-transcript": "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 ."
   }
 }

package/dist/content/changes.d.ts

@@ -1,35 +0,0 @@
-import type { Message } from './message.js';
-import type { MemoryContent, MemoryResultSource } from './memory.js';
-import type { InvocationOrigin } from '../invocation/types.js';
-export type TranscriptEvent = Readonly<{
-    type: 'transcript';
-    transcriptId: string;
-    revision: number;
-    occurredAt: string;
-    origin?: InvocationOrigin;
-    change: Readonly<{
-        kind: 'messages-appended';
-        start: number;
-        messages: readonly Readonly<Message>[];
-    }> | Readonly<{
-        kind: 'segment-started';
-        previousStart: number;
-        start: number;
-        end: number;
-    }>;
-}>;
-export type MemoryEvent = Readonly<{
-    type: 'memory';
-    memoriesId: string;
-    sequence: number;
-    occurredAt: string;
-    origin?: InvocationOrigin;
-    change: Readonly<{
-        action: 'create' | 'update';
-        memoryId: string;
-        explanation: string;
-        sourceIndexes: readonly number[];
-        sourceResults?: readonly MemoryResultSource[];
-        result: MemoryContent;
-    }>;
-}>;

package/dist/content/changes.js

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

package/dist/content/index.d.ts

@@ -1,4 +0,0 @@
-export * from './message.js';
-export * from './memory.js';
-export * from './transcript.js';
-export * from './changes.js';

package/dist/content/index.js

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

package/dist/content/memory.d.ts

@@ -1,13 +0,0 @@
-import type { FileReceipt } from '../conversation/files.js';
-export interface MemoryResultSource {
-    readonly id: string;
-    readonly kind: 'file-created';
-    readonly answerIndex: number;
-    readonly receipt: FileReceipt;
-}
-export interface MemoryContent {
-    readonly topic: string;
-    readonly content: string;
-    readonly sourceIndexes: readonly number[];
-    readonly sourceResults?: readonly MemoryResultSource[];
-}

package/dist/content/memory.js

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

package/dist/content/message.d.ts

@@ -1,4 +0,0 @@
-export interface Message {
-    role: 'user' | 'assistant';
-    content: string;
-}

package/dist/content/message.js

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

package/dist/content/transcript.d.ts

@@ -1,32 +0,0 @@
-import type { Message } from './message.js';
-import type { TranscriptEvent } from './changes.js';
-export interface MessageLocator {
-    readonly transcriptId: string;
-    readonly index: number;
-}
-export interface TranscriptRangeLocator {
-    readonly transcriptId: string;
-    readonly start: number;
-    readonly end: number;
-    readonly revision?: number;
-}
-export interface TranscriptSnapshot {
-    readonly id: string;
-    readonly revision: number;
-    readonly start: 0;
-    readonly end: number;
-    readonly starts: readonly number[];
-    readonly messages: readonly Readonly<Message>[];
-}
-export type TranscriptFrame = {
-    readonly type: 'baseline';
-    readonly snapshot: TranscriptSnapshot;
-} | {
-    readonly type: 'delta';
-    readonly event: TranscriptEvent;
-};
-export type TranscriptUpdate = TranscriptFrame | {
-    readonly type: 'error';
-    readonly code: string;
-    readonly error: string;
-};

package/dist/conversation/activity.d.ts

@@ -1,36 +0,0 @@
-import type { CallableKind, InvocationProcessStage, InvocationRelationPhase } from '../invocation/types.js';
-import type { ConversationFailure } from './delivery.js';
-export interface ConversationStage {
-    readonly contextId: string;
-    readonly kind: 'model' | 'tool';
-    readonly label: string;
-    readonly status: 'running' | 'succeeded' | 'failed' | 'cancelled';
-}
-export interface ConversationActivity {
-    readonly contextId: string;
-    readonly parentContextId?: string;
-    readonly kind: CallableKind;
-    readonly label: string;
-    readonly status: 'running' | 'succeeded' | 'failed' | 'cancelled';
-    readonly phase: 'setup' | InvocationProcessStage;
-    readonly round: number;
-    readonly startedAt?: string;
-    readonly finishedAt?: string;
-    readonly relation?: {
-        readonly phase: InvocationRelationPhase;
-        readonly returned?: 'succeeded' | 'failed' | 'cancelled';
-    };
-}
-export interface ConversationActivities {
-    readonly calls: readonly ConversationActivity[];
-    readonly integrity: {
-        readonly status: 'complete';
-    } | {
-        readonly status: 'incomplete';
-        readonly error: ConversationFailure;
-    };
-}
-export interface ConversationActivityChange {
-    readonly calls?: readonly ConversationActivity[];
-    readonly integrity?: ConversationActivities['integrity'];
-}

package/dist/conversation/activity.js

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

package/dist/conversation/conversation.d.ts

@@ -1,11 +0,0 @@
-export interface ConversationDescriptor {
-    readonly id: string;
-    readonly title: string;
-    readonly transcriptId: string;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-}
-export interface ConversationListResponse {
-    readonly conversations: readonly ConversationDescriptor[];
-    readonly defaultConversationId: string;
-}

package/dist/conversation/conversation.js

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

package/dist/conversation/delivery.d.ts

@@ -1,99 +0,0 @@
-import type { Message } from '../content/message.js';
-import type { ModelSettings } from './settings.js';
-import type { MessageLocator, TranscriptRangeLocator, TranscriptSnapshot } from '../content/transcript.js';
-import type { ConversationActivities, ConversationActivityChange, ConversationStage } from './activity.js';
-import type { FileTask, FileOutput } from './files.js';
-import type { ConversationTask } from './task.js';
-export interface ConversationFailure {
-    readonly code: string;
-    readonly message: string;
-}
-export type ConversationAdmission = {
-    readonly conversationId: string;
-    readonly transcriptId: string;
-} & ({
-    readonly status: 'ready';
-} | {
-    readonly status: 'busy';
-} | {
-    readonly status: 'unavailable';
-    readonly error: ConversationFailure;
-});
-export interface ConversationSubmissionRequest {
-    readonly conversationId: string;
-    readonly submissionId: string;
-    readonly input: ConversationRequest;
-}
-export interface ConversationSubmissionSnapshot {
-    readonly conversationId: string;
-    readonly submissionId: string;
-    readonly revision: number;
-    readonly input?: TranscriptRangeLocator;
-    readonly answer?: MessageLocator;
-    readonly executions: readonly {
-        readonly contextId: string;
-    }[];
-    readonly activities?: ConversationActivities;
-    readonly stage?: ConversationStage;
-    readonly task?: ConversationTask;
-    readonly fileOutput?: FileOutput;
-    readonly cancelRequested?: true;
-    readonly admission?: ConversationAdmission;
-    readonly result?: {
-        readonly status: 'completed' | 'cancelled';
-    } | {
-        readonly status: 'failed';
-        readonly error: ConversationFailure;
-    } | {
-        readonly status: 'rejected';
-        readonly error: ConversationFailure;
-        readonly retry?: 'admission';
-    };
-    readonly integrity: {
-        readonly status: 'complete';
-    } | {
-        readonly status: 'incomplete';
-        readonly error: ConversationFailure;
-    };
-}
-export interface ConversationSubmissionChange {
-    readonly input?: TranscriptRangeLocator;
-    readonly answer?: MessageLocator;
-    readonly executions?: readonly {
-        readonly contextId: string;
-    }[];
-    readonly activities?: ConversationActivityChange;
-    readonly stage?: ConversationStage;
-    readonly task?: ConversationTask;
-    readonly fileOutput?: FileOutput;
-    readonly cancelRequested?: true;
-    readonly admission?: ConversationAdmission | null;
-    readonly result?: ConversationSubmissionSnapshot['result'];
-    readonly integrity?: ConversationSubmissionSnapshot['integrity'];
-}
-export interface ConversationSubmissionUpdate {
-    readonly type: 'submission';
-    readonly conversationId: string;
-    readonly submissionId: string;
-    readonly fromRevision: number;
-    readonly revision: number;
-    readonly change: ConversationSubmissionChange;
-}
-export interface ConversationRequest {
-    messages: Message[];
-    contextBudget?: number;
-    fileTask?: FileTask;
-}
-export interface ConfigurationResponse extends ModelSettings {
-    configured: boolean;
-    files?: {
-        readonly maxReadBytes: number;
-        readonly maxWriteBytes: number;
-    };
-}
-export interface TranscriptResponse extends TranscriptSnapshot {
-}
-export interface ErrorResponse {
-    error: string;
-    code?: string;
-}

package/dist/conversation/delivery.js

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

package/dist/conversation/files.d.ts

@@ -1,30 +0,0 @@
-export type FileTask = {
-    readonly sourcePath: string;
-    readonly output?: {
-        readonly path: string;
-    };
-} | {
-    readonly sourcePath?: never;
-    readonly output: {
-        readonly path: string;
-    };
-};
-export interface FileReceipt {
-    readonly path: string;
-    readonly bytes: number;
-    readonly digest: string;
-}
-export type FileOutput = {
-    readonly status: 'pending';
-    readonly path: string;
-} | {
-    readonly status: 'created';
-    readonly receipt: FileReceipt;
-} | {
-    readonly status: 'not-created';
-    readonly path: string;
-    readonly reason: 'not-started' | 'cancelled' | 'failed';
-} | {
-    readonly status: 'unconfirmed';
-    readonly path: string;
-};

package/dist/conversation/files.js

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

package/dist/conversation/generation.d.ts

@@ -1,4 +0,0 @@
-export interface GenerationOutput {
-    kind: 'answer' | 'unknown' | 'needs-info';
-    content: string;
-}

package/dist/conversation/generation.js

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

package/dist/conversation/index.d.ts

@@ -1,10 +0,0 @@
-export * from './delivery.js';
-export * from './conversation.js';
-export * from './settings.js';
-export * from './generation.js';
-export * from './activity.js';
-export * from './files.js';
-export * from './task.js';
-export * from './preview.js';
-export * from './service.js';
-export * from './recovery.js';

package/dist/conversation/index.js

@@ -1,2 +0,0 @@
-/*! MIT License | Copyright (c) 2026 wei.liang | See LICENSE */
-export*from"./delivery.js";export*from"./conversation.js";export*from"./settings.js";export*from"./generation.js";export*from"./activity.js";export*from"./files.js";export*from"./task.js";export*from"./preview.js";export*from"./service.js";export*from"./recovery.js";

package/dist/conversation/preview.d.ts

@@ -1,46 +0,0 @@
-import type { MessageLocator } from '../content/transcript.js';
-import type { ConversationSubmissionSnapshot, ConversationSubmissionUpdate } from './delivery.js';
-export interface AnswerPreviewSnapshot {
-    readonly generation: number;
-    readonly revision: number;
-    readonly text: string;
-    readonly state: 'streaming' | 'received' | 'committed' | 'discarded';
-    readonly message?: MessageLocator;
-    readonly consistency?: 'complete' | 'prefix' | 'mismatch';
-    readonly reason?: 'rejected' | 'failed' | 'cancelled';
-}
-export type AnswerPreviewChange = {
-    readonly generation: number;
-    readonly revision: number;
-} & ({
-    readonly kind: 'started';
-} | {
-    readonly kind: 'appended';
-    readonly offset: number;
-    readonly text: string;
-} | {
-    readonly kind: 'received';
-} | {
-    readonly kind: 'committed';
-    readonly message: MessageLocator;
-    readonly consistency: 'complete' | 'prefix' | 'mismatch';
-} | {
-    readonly kind: 'discarded';
-    readonly reason: 'rejected' | 'failed' | 'cancelled';
-});
-export interface ConversationSubmissionBaseline {
-    readonly type: 'baseline';
-    readonly submission: ConversationSubmissionSnapshot;
-    readonly preview?: AnswerPreviewSnapshot;
-}
-export interface ConversationSubmissionDiscovery {
-    readonly conversationId: string;
-    readonly transcriptId: string;
-    readonly submission?: ConversationSubmissionBaseline;
-}
-export type ConversationSubmissionFrame = ConversationSubmissionBaseline | ConversationSubmissionUpdate | {
-    readonly type: 'answer';
-    readonly conversationId: string;
-    readonly submissionId: string;
-    readonly change: AnswerPreviewChange;
-};

package/dist/conversation/preview.js

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

package/dist/conversation/recovery.d.ts

@@ -1,29 +0,0 @@
-export interface ConversationRecoverySummary {
-    readonly contextId: string;
-    readonly point: string;
-    readonly available: boolean;
-    readonly eligibility?: 'unchecked';
-    readonly reason?: string;
-}
-export interface ConversationRecoveryRequest {
-    readonly conversationId: string;
-    readonly submissionId: string;
-    readonly contextId: string;
-}
-export interface ConversationRecoveryEvent {
-    readonly entryId: string;
-    readonly activityId: string;
-    readonly contextId: string;
-    readonly parentContextId?: string;
-    readonly structureKind: 'scene' | 'group' | 'node';
-    readonly sequence: number;
-    readonly occurredAt: string;
-    readonly kind: 'captured' | 'saved' | 'checking' | 'continued' | 'installed' | 'child-restored' | 'activity' | 'resource' | 'transcript' | 'memory' | 'failed' | 'finishing' | 'finished';
-    readonly point?: string;
-    readonly stage?: string;
-    readonly status?: 'succeeded' | 'failed' | 'cancelled';
-}
-export interface ConversationRecoveryActivity {
-    readonly complete: boolean;
-    readonly events: readonly ConversationRecoveryEvent[];
-}

package/dist/conversation/recovery.js

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