@rsconcept/rstool 0.3.0 → 0.4.0

package/README.md

@@ -85,6 +85,8 @@ Supported methods (current contract version: see [`CONTRACT_VERSION`](src/models
 - `listDiagnostics`
 - `commitStep`
 - `exportSession`
+- `exportPortalSchema`
+- `exportPortalModel`
 - `importSession`
 - `setConstituentaValue`
 - `setConstituentaValues`
@@ -103,7 +105,7 @@ Example request:
 Example response:
 
 ```json
-{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "1.2.0" } }
+{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "1.4.0" } }
 ```
 
 ## Typed client example

package/dist/index-uhkmwruf.d.ts

@@ -0,0 +1,46 @@
+import { o as RSToolValue, t as BasicBinding } from "./common-DxLg3eXX.js";
+//#region src/models/portal-json.d.ts
+/** Portal JSON import/export format version (schema and model files). */
+declare const PORTAL_JSON_CONTRACT_VERSION = "1.0.0";
+interface PortalImportMetadata {
+  contract_version: string;
+  title: string;
+  alias: string;
+  description: string;
+}
+interface PortalTermForm {
+  text: string;
+  tags: string;
+}
+interface PortalSchemaConstituenta {
+  id: number;
+  alias: string;
+  convention: string;
+  crucial: boolean;
+  cst_type: string;
+  definition_formal: string;
+  typification_manual: string;
+  value_is_property: boolean;
+  definition_raw: string;
+  definition_resolved: string;
+  term_raw: string;
+  term_resolved: string;
+  term_forms: PortalTermForm[];
+}
+interface PortalSchemaImportData extends PortalImportMetadata {
+  items: PortalSchemaConstituenta[];
+  attribution: Array<{
+    container: number;
+    attribute: number;
+  }>;
+}
+interface PortalModelImportData extends PortalImportMetadata {
+  items: Array<{
+    id: number;
+    type: string;
+    value: RSToolValue | BasicBinding;
+  }>;
+}
+//#endregion
+export { PortalSchemaImportData as a, PortalSchemaConstituenta as i, PortalImportMetadata as n, PortalTermForm as o, PortalModelImportData as r, PORTAL_JSON_CONTRACT_VERSION as t };
+//# sourceMappingURL=index-uhkmwruf.d.ts.map

package/dist/index.d.ts

@@ -4,9 +4,10 @@ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic
 import { i as ConstituentaState, n as AddOrUpdateConstituentaResult, r as ConstituentaDraft, t as AddOrUpdateConstituentaInput } from "./constituenta-Dnd6iToB.js";
 import { n as EvaluateExpressionInput, r as EvaluationResult, t as EvaluateConstituentaInput } from "./evaluation-CCVYH0wA.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, o as SetConstituentaValuesInput, r as RecalculateModelResult, t as ClearConstituentaValuesInput } from "./model-value-SFAVj0dw.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BHGCCLfQ.js";
-import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "./tool-contract-CsGqg_0P.js";
-import { t as RSToolAgent } from "./rstool-agent-DkeH5Qml.js";
+import { a as PortalSchemaImportData, i as PortalSchemaConstituenta, n as PortalImportMetadata, o as PortalTermForm, r as PortalModelImportData, t as PORTAL_JSON_CONTRACT_VERSION } from "./index-uhkmwruf.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BPgsE80c.js";
+import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "./tool-contract-n1ghUOrK.js";
+import { t as RSToolAgent } from "./rstool-agent-pRaPnZay.js";
 import { DomainAnalysisLike, DomainErrorLike, toPublicAnalysis, toPublicError } from "./mappers/types.js";
 import { RSToolWrapperClient, RSToolWrapperClientOptions, WrapperResponse } from "./wrapper/client.js";
-export { type AddOrUpdateConstituentaInput, type AddOrUpdateConstituentaResult, type AnalysisResult, type AnalyzeExpressionInput, type BasicBinding, CONTRACT_VERSION, type ClearConstituentaValuesInput, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, type DomainAnalysisLike, type DomainErrorLike, EvalStatus, type EvaluateConstituentaInput, type EvaluateExpressionInput, type EvaluationResult, type ListDiagnosticsFilters, type ModelValueState, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolErrorDescription, type RSToolValue, RSToolWrapperClient, type RSToolWrapperClientOptions, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SetConstituentaValueInput, type SetConstituentaValuesInput, ValueClass, type WrapperResponse, toPublicAnalysis, toPublicError };
+export { type AddOrUpdateConstituentaInput, type AddOrUpdateConstituentaResult, type AnalysisResult, type AnalyzeExpressionInput, type BasicBinding, CONTRACT_VERSION, type ClearConstituentaValuesInput, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, type DomainAnalysisLike, type DomainErrorLike, EvalStatus, type EvaluateConstituentaInput, type EvaluateExpressionInput, type EvaluationResult, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalImportMetadata, type PortalModelImportData, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolErrorDescription, type RSToolValue, RSToolWrapperClient, type RSToolWrapperClientOptions, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SetConstituentaValueInput, type SetConstituentaValuesInput, ValueClass, type WrapperResponse, toPublicAnalysis, toPublicError };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { toPublicAnalysis, toPublicError } from "./mappers/types.js";
 import { CstType, EvalStatus, RSErrorCode, ValueClass } from "./models/common.js";
+import { n as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "./rstool-agent-BZi5jO1y.js";
 import { CONTRACT_VERSION } from "./models/tool-contract.js";
-import { RSToolAgent } from "./models/rstool-agent.js";
 import "./models/index.js";
 import { RSToolWrapperClient } from "./wrapper/client.js";
-export { CONTRACT_VERSION, CstType, EvalStatus, RSErrorCode, RSToolAgent, RSToolWrapperClient, ValueClass, toPublicAnalysis, toPublicError };
+export { CONTRACT_VERSION, CstType, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSErrorCode, RSToolAgent, RSToolWrapperClient, ValueClass, toPublicAnalysis, toPublicError };

package/dist/mappers/model-adapter.d.ts

@@ -1,6 +1,6 @@
 import { r as EvaluationResult } from "../evaluation-CCVYH0wA.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, r as RecalculateModelResult } from "../model-value-SFAVj0dw.js";
-import { r as SessionState } from "../session-BHGCCLfQ.js";
+import { r as SessionState } from "../session-BPgsE80c.js";
 import { CstType } from "@rsconcept/domain/library/rsform";
 import { RSEngine } from "@rsconcept/domain/library/rsengine";
 

package/dist/mappers/schema-adapter.d.ts

@@ -1,7 +1,7 @@
 import { t as AnalysisResult } from "../analysis-JiwOYDKx.js";
 import { t as DiagnosticRecord } from "../diagnostic-BMYvciz8.js";
 import { i as ConstituentaState, r as ConstituentaDraft } from "../constituenta-Dnd6iToB.js";
-import { r as SessionState } from "../session-BHGCCLfQ.js";
+import { r as SessionState } from "../session-BPgsE80c.js";
 import { RSForm } from "@rsconcept/domain/library/rsform";
 import { RSLangAnalyzer } from "@rsconcept/domain/rslang";
 

package/dist/models/index.d.ts

@@ -4,7 +4,8 @@ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnosti
 import { i as ConstituentaState, n as AddOrUpdateConstituentaResult, r as ConstituentaDraft, t as AddOrUpdateConstituentaInput } from "../constituenta-Dnd6iToB.js";
 import { n as EvaluateExpressionInput, r as EvaluationResult, t as EvaluateConstituentaInput } from "../evaluation-CCVYH0wA.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, o as SetConstituentaValuesInput, r as RecalculateModelResult, t as ClearConstituentaValuesInput } from "../model-value-SFAVj0dw.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BHGCCLfQ.js";
-import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "../tool-contract-CsGqg_0P.js";
-import { t as RSToolAgent } from "../rstool-agent-DkeH5Qml.js";
-export { type AddOrUpdateConstituentaInput, type AddOrUpdateConstituentaResult, type AnalysisResult, type AnalyzeExpressionInput, type BasicBinding, CONTRACT_VERSION, type ClearConstituentaValuesInput, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, EvalStatus, type EvaluateConstituentaInput, type EvaluateExpressionInput, type EvaluationResult, type ListDiagnosticsFilters, type ModelValueState, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolErrorDescription, type RSToolValue, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SetConstituentaValueInput, type SetConstituentaValuesInput, ValueClass };
+import { a as PortalSchemaImportData, i as PortalSchemaConstituenta, n as PortalImportMetadata, o as PortalTermForm, r as PortalModelImportData, t as PORTAL_JSON_CONTRACT_VERSION } from "../index-uhkmwruf.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BPgsE80c.js";
+import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "../tool-contract-n1ghUOrK.js";
+import { t as RSToolAgent } from "../rstool-agent-pRaPnZay.js";
+export { type AddOrUpdateConstituentaInput, type AddOrUpdateConstituentaResult, type AnalysisResult, type AnalyzeExpressionInput, type BasicBinding, CONTRACT_VERSION, type ClearConstituentaValuesInput, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, EvalStatus, type EvaluateConstituentaInput, type EvaluateExpressionInput, type EvaluationResult, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalImportMetadata, type PortalModelImportData, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolErrorDescription, type RSToolValue, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SetConstituentaValueInput, type SetConstituentaValuesInput, ValueClass };

package/dist/models/index.js

@@ -1,4 +1,4 @@
 import { CstType, EvalStatus, RSErrorCode, ValueClass } from "./common.js";
+import { n as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "../rstool-agent-BZi5jO1y.js";
 import { CONTRACT_VERSION } from "./tool-contract.js";
-import { RSToolAgent } from "./rstool-agent.js";
-export { CONTRACT_VERSION, CstType, EvalStatus, RSErrorCode, RSToolAgent, ValueClass };
+export { CONTRACT_VERSION, CstType, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSErrorCode, RSToolAgent, ValueClass };

package/dist/models/rstool-agent.d.ts

@@ -1,2 +1,2 @@
-import { t as RSToolAgent } from "../rstool-agent-DkeH5Qml.js";
+import { t as RSToolAgent } from "../rstool-agent-pRaPnZay.js";
 export { RSToolAgent };

package/dist/models/rstool-agent.js

@@ -1,93 +1,2 @@
-import { ModelAdapter } from "../mappers/model-adapter.js";
-import { SchemaAdapter } from "../mappers/schema-adapter.js";
-import { SessionStore } from "../session/session-store.js";
-import { CONTRACT_VERSION } from "./tool-contract.js";
-//#region src/models/rstool-agent.ts
-var RSToolAgent = class {
-	contractVersion = CONTRACT_VERSION;
-	sessions = new SessionStore();
-	adapter = new SchemaAdapter();
-	evaluation = new ModelAdapter();
-	createSession(initial) {
-		return this.sessions.create(initial, this.contractVersion);
-	}
-	addOrUpdateConstituenta(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, input.draft);
-		const state = this.adapter.mergeStateWithDraft(envelope.state, input.draft, result);
-		this.sessions.appendDiagnostics(sessionId, diagnostics);
-		return {
-			state,
-			diagnostics
-		};
-	}
-	analyzeExpression(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, {
-			id: -1,
-			alias: "_analysis",
-			cstType: input.cstType,
-			definitionFormal: input.expression
-		});
-		this.sessions.appendDiagnostics(sessionId, diagnostics.map((item) => ({
-			...item,
-			constituentId: void 0
-		})));
-		return result;
-	}
-	getFormState(sessionId) {
-		const envelope = this.sessions.get(sessionId);
-		return structuredClone(envelope.state);
-	}
-	listDiagnostics(sessionId, filters) {
-		return this.sessions.listDiagnostics(sessionId, filters);
-	}
-	commitStep(sessionId, message) {
-		return this.sessions.addRevision(sessionId, message);
-	}
-	exportSession(sessionId) {
-		const envelope = this.sessions.get(sessionId);
-		return JSON.stringify({
-			contractVersion: this.contractVersion,
-			state: envelope.state,
-			diagnostics: envelope.diagnostics
-		}, null, 2);
-	}
-	importSession(payload) {
-		const parsed = JSON.parse(payload);
-		if (!parsed.state.model) parsed.state.model = { items: [] };
-		return this.sessions.create(parsed.state, this.contractVersion);
-	}
-	async setConstituentaValue(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.setConstituentaValue(envelope.state, input);
-	}
-	async setConstituentaValues(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.setConstituentaValues(envelope.state, input);
-	}
-	async clearConstituentaValues(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.clearConstituentaValues(envelope.state, input.items);
-	}
-	getModelState(sessionId) {
-		const envelope = this.sessions.get(sessionId);
-		return structuredClone(envelope.state.model);
-	}
-	evaluateExpression(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.evaluateExpression(envelope.state, input.expression, input.cstType);
-	}
-	evaluateConstituenta(sessionId, input) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.evaluateConstituenta(envelope.state, input.constituentId);
-	}
-	recalculateModel(sessionId) {
-		const envelope = this.sessions.get(sessionId);
-		return this.evaluation.recalculateModel(envelope.state);
-	}
-};
-//#endregion
+import { t as RSToolAgent } from "../rstool-agent-BZi5jO1y.js";
 export { RSToolAgent };
-
-//# sourceMappingURL=rstool-agent.js.map

package/dist/models/session.d.ts

@@ -1,2 +1,2 @@
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BHGCCLfQ.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BPgsE80c.js";
 export { SessionHandle, SessionRevision, SessionState };

package/dist/models/tool-contract.d.ts

@@ -1,2 +1,2 @@
-import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "../tool-contract-CsGqg_0P.js";
+import { n as RSToolAgentContract, t as CONTRACT_VERSION } from "../tool-contract-n1ghUOrK.js";
 export { CONTRACT_VERSION, RSToolAgentContract };

package/dist/models/tool-contract.js

@@ -1,5 +1,5 @@
 //#region src/models/tool-contract.ts
-const CONTRACT_VERSION = "1.2.0";
+const CONTRACT_VERSION = "1.4.0";
 //#endregion
 export { CONTRACT_VERSION };
 

package/dist/models/tool-contract.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-contract.js","names":[],"sources":["../../src/models/tool-contract.ts"],"sourcesContent":["import { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport {\n  type AddOrUpdateConstituentaInput,\n  type AddOrUpdateConstituentaResult\n} from './constituenta';\nimport {\n  type DiagnosticRecord,\n  type ListDiagnosticsFilters\n} from './diagnostic';\nimport {\n  type EvaluateConstituentaInput,\n  type EvaluateExpressionInput,\n  type EvaluationResult\n} from './evaluation';\nimport {\n  type ClearConstituentaValuesInput,\n  type RecalculateModelResult,\n  type SessionModelState,\n  type SetConstituentaValueInput,\n  type SetConstituentaValuesInput\n} from './model-value';\nimport {\n  type SessionHandle,\n  type SessionRevision,\n  type SessionState\n} from './session';\n\nexport const CONTRACT_VERSION = '1.2.0';\n\nexport interface RSToolAgentContract {\n  readonly contractVersion: string;\n  createSession(initial?: Partial<SessionState>): SessionHandle;\n  addOrUpdateConstituenta(sessionId: string, input: AddOrUpdateConstituentaInput): AddOrUpdateConstituentaResult;\n  analyzeExpression(sessionId: string, input: AnalyzeExpressionInput): AnalysisResult;\n  getFormState(sessionId: string): SessionState;\n  listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];\n  commitStep(sessionId: string, message?: string): SessionRevision;\n  exportSession(sessionId: string): string;\n  importSession(payload: string): SessionHandle;\n  setConstituentaValue(sessionId: string, input: SetConstituentaValueInput): Promise<SessionModelState>;\n  setConstituentaValues(sessionId: string, input: SetConstituentaValuesInput): Promise<SessionModelState>;\n  clearConstituentaValues(sessionId: string, input: ClearConstituentaValuesInput): Promise<SessionModelState>;\n  getModelState(sessionId: string): SessionModelState;\n  evaluateExpression(sessionId: string, input: EvaluateExpressionInput): EvaluationResult;\n  evaluateConstituenta(sessionId: string, input: EvaluateConstituentaInput): EvaluationResult;\n  recalculateModel(sessionId: string): RecalculateModelResult;\n}\n"],"mappings":";AA2BA,MAAa,mBAAmB"}
+{"version":3,"file":"tool-contract.js","names":[],"sources":["../../src/models/tool-contract.ts"],"sourcesContent":["import { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport {\n  type AddOrUpdateConstituentaInput,\n  type AddOrUpdateConstituentaResult\n} from './constituenta';\nimport {\n  type DiagnosticRecord,\n  type ListDiagnosticsFilters\n} from './diagnostic';\nimport {\n  type EvaluateConstituentaInput,\n  type EvaluateExpressionInput,\n  type EvaluationResult\n} from './evaluation';\nimport {\n  type ClearConstituentaValuesInput,\n  type RecalculateModelResult,\n  type SessionModelState,\n  type SetConstituentaValueInput,\n  type SetConstituentaValuesInput\n} from './model-value';\nimport {\n  type SessionHandle,\n  type SessionRevision,\n  type SessionState\n} from './session';\n\nexport const CONTRACT_VERSION = '1.4.0';\n\nexport interface RSToolAgentContract {\n  readonly contractVersion: string;\n  createSession(initial?: Partial<SessionState>): SessionHandle;\n  addOrUpdateConstituenta(sessionId: string, input: AddOrUpdateConstituentaInput): AddOrUpdateConstituentaResult;\n  analyzeExpression(sessionId: string, input: AnalyzeExpressionInput): AnalysisResult;\n  getFormState(sessionId: string): SessionState;\n  listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];\n  commitStep(sessionId: string, message?: string): SessionRevision;\n  exportSession(sessionId: string): string;\n  exportPortalSchema(sessionId: string): string;\n  exportPortalModel(sessionId: string): string;\n  importSession(payload: string): SessionHandle;\n  setConstituentaValue(sessionId: string, input: SetConstituentaValueInput): Promise<SessionModelState>;\n  setConstituentaValues(sessionId: string, input: SetConstituentaValuesInput): Promise<SessionModelState>;\n  clearConstituentaValues(sessionId: string, input: ClearConstituentaValuesInput): Promise<SessionModelState>;\n  getModelState(sessionId: string): SessionModelState;\n  evaluateExpression(sessionId: string, input: EvaluateExpressionInput): EvaluationResult;\n  evaluateConstituenta(sessionId: string, input: EvaluateConstituentaInput): EvaluationResult;\n  recalculateModel(sessionId: string): RecalculateModelResult;\n}\n"],"mappings":";AA2BA,MAAa,mBAAmB"}

package/dist/rstool-agent-BZi5jO1y.js

@@ -0,0 +1,158 @@
+import { ModelAdapter } from "./mappers/model-adapter.js";
+import { SchemaAdapter } from "./mappers/schema-adapter.js";
+import { SessionStore } from "./session/session-store.js";
+import { CONTRACT_VERSION } from "./models/tool-contract.js";
+//#region src/models/portal-json.ts
+/** Portal JSON import/export format version (schema and model files). */
+const PORTAL_JSON_CONTRACT_VERSION = "1.0.0";
+//#endregion
+//#region src/models/rstool-agent.ts
+function normalizeImportedState(state) {
+	return {
+		...state,
+		alias: state.alias ?? "",
+		title: state.title ?? "",
+		comment: state.comment ?? "",
+		model: state.model ?? { items: [] }
+	};
+}
+function portalImportMetadata(session, kind) {
+	const defaults = kind === "schema" ? {
+		title: "Conceptual schema",
+		alias: "SCHEMA"
+	} : {
+		title: "Conceptual model",
+		alias: "MODEL"
+	};
+	const title = session.title.trim();
+	const alias = session.alias.trim();
+	return {
+		title: title.length > 0 ? title : defaults.title,
+		alias: alias.length > 0 ? alias : defaults.alias,
+		description: session.comment.trim()
+	};
+}
+var RSToolAgent = class {
+	contractVersion = CONTRACT_VERSION;
+	sessions = new SessionStore();
+	adapter = new SchemaAdapter();
+	evaluation = new ModelAdapter();
+	createSession(initial) {
+		return this.sessions.create(initial, this.contractVersion);
+	}
+	addOrUpdateConstituenta(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, input.draft);
+		const state = this.adapter.mergeStateWithDraft(envelope.state, input.draft, result);
+		this.sessions.appendDiagnostics(sessionId, diagnostics);
+		return {
+			state,
+			diagnostics
+		};
+	}
+	analyzeExpression(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, {
+			id: -1,
+			alias: "_analysis",
+			cstType: input.cstType,
+			definitionFormal: input.expression
+		});
+		this.sessions.appendDiagnostics(sessionId, diagnostics.map((item) => ({
+			...item,
+			constituentId: void 0
+		})));
+		return result;
+	}
+	getFormState(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		return structuredClone(envelope.state);
+	}
+	listDiagnostics(sessionId, filters) {
+		return this.sessions.listDiagnostics(sessionId, filters);
+	}
+	commitStep(sessionId, message) {
+		return this.sessions.addRevision(sessionId, message);
+	}
+	exportSession(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		return JSON.stringify({
+			contractVersion: this.contractVersion,
+			state: envelope.state,
+			diagnostics: envelope.diagnostics
+		}, null, 2);
+	}
+	exportPortalSchema(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		const payload = {
+			contract_version: PORTAL_JSON_CONTRACT_VERSION,
+			...portalImportMetadata(envelope.state, "schema"),
+			items: envelope.state.items.map((item) => ({
+				id: item.id,
+				alias: item.alias,
+				convention: item.convention,
+				crucial: false,
+				cst_type: item.cstType,
+				definition_formal: item.definitionFormal,
+				typification_manual: "",
+				value_is_property: false,
+				definition_raw: item.definitionText,
+				definition_resolved: item.definitionText,
+				term_raw: item.term,
+				term_resolved: item.term,
+				term_forms: []
+			})),
+			attribution: []
+		};
+		return JSON.stringify(payload, null, 2);
+	}
+	exportPortalModel(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		const payload = {
+			contract_version: PORTAL_JSON_CONTRACT_VERSION,
+			...portalImportMetadata(envelope.state, "model"),
+			items: envelope.state.model.items.map((item) => ({
+				id: item.id,
+				type: item.type,
+				value: item.value
+			}))
+		};
+		return JSON.stringify(payload, null, 2);
+	}
+	importSession(payload) {
+		const parsed = JSON.parse(payload);
+		return this.sessions.create(normalizeImportedState(parsed.state), this.contractVersion);
+	}
+	async setConstituentaValue(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.setConstituentaValue(envelope.state, input);
+	}
+	async setConstituentaValues(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.setConstituentaValues(envelope.state, input);
+	}
+	async clearConstituentaValues(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.clearConstituentaValues(envelope.state, input.items);
+	}
+	getModelState(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		return structuredClone(envelope.state.model);
+	}
+	evaluateExpression(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.evaluateExpression(envelope.state, input.expression, input.cstType);
+	}
+	evaluateConstituenta(sessionId, input) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.evaluateConstituenta(envelope.state, input.constituentId);
+	}
+	recalculateModel(sessionId) {
+		const envelope = this.sessions.get(sessionId);
+		return this.evaluation.recalculateModel(envelope.state);
+	}
+};
+//#endregion
+export { PORTAL_JSON_CONTRACT_VERSION as n, RSToolAgent as t };
+
+//# sourceMappingURL=rstool-agent-BZi5jO1y.js.map

package/dist/rstool-agent-BZi5jO1y.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rstool-agent-BZi5jO1y.js","names":[],"sources":["../src/models/portal-json.ts","../src/models/rstool-agent.ts"],"sourcesContent":["import { type BasicBinding, type RSToolValue } from './common';\n\n/** Portal JSON import/export format version (schema and model files). */\nexport const PORTAL_JSON_CONTRACT_VERSION = '1.0.0';\n\nexport interface PortalImportMetadata {\n  contract_version: string;\n  title: string;\n  alias: string;\n  description: string;\n}\n\nexport interface PortalTermForm {\n  text: string;\n  tags: string;\n}\n\nexport interface PortalSchemaConstituenta {\n  id: number;\n  alias: string;\n  convention: string;\n  crucial: boolean;\n  cst_type: string;\n  definition_formal: string;\n  typification_manual: string;\n  value_is_property: boolean;\n  definition_raw: string;\n  definition_resolved: string;\n  term_raw: string;\n  term_resolved: string;\n  term_forms: PortalTermForm[];\n}\n\nexport interface PortalSchemaImportData extends PortalImportMetadata {\n  items: PortalSchemaConstituenta[];\n  attribution: Array<{ container: number; attribute: number }>;\n}\n\nexport interface PortalModelImportData extends PortalImportMetadata {\n  items: Array<{\n    id: number;\n    type: string;\n    value: RSToolValue | BasicBinding;\n  }>;\n}\n","import { ModelAdapter } from '../mappers/model-adapter';\nimport { SchemaAdapter } from '../mappers/schema-adapter';\nimport { SessionStore } from '../session/session-store';\nimport { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport {\n  type AddOrUpdateConstituentaInput,\n  type AddOrUpdateConstituentaResult\n} from './constituenta';\nimport { type ListDiagnosticsFilters } from './diagnostic';\nimport {\n  type EvaluateConstituentaInput,\n  type EvaluateExpressionInput,\n  type EvaluationResult\n} from './evaluation';\nimport {\n  type ClearConstituentaValuesInput,\n  type RecalculateModelResult,\n  type SessionModelState,\n  type SetConstituentaValueInput,\n  type SetConstituentaValuesInput\n} from './model-value';\nimport {\n  PORTAL_JSON_CONTRACT_VERSION,\n  type PortalModelImportData,\n  type PortalSchemaImportData\n} from './portal-json';\nimport { type SessionHandle, type SessionRevision, type SessionState } from './session';\nimport { CONTRACT_VERSION, type RSToolAgentContract } from './tool-contract';\n\nfunction normalizeImportedState(state: SessionState): SessionState {\n  return {\n    ...state,\n    alias: state.alias ?? '',\n    title: state.title ?? '',\n    comment: state.comment ?? '',\n    model: state.model ?? { items: [] }\n  };\n}\n\nfunction portalImportMetadata(\n  session: SessionState,\n  kind: 'schema' | 'model'\n): Pick<PortalSchemaImportData, 'title' | 'alias' | 'description'> {\n  const defaults =\n    kind === 'schema'\n      ? { title: 'Conceptual schema', alias: 'SCHEMA' }\n      : { title: 'Conceptual model', alias: 'MODEL' };\n  const title = session.title.trim();\n  const alias = session.alias.trim();\n  return {\n    title: title.length > 0 ? title : defaults.title,\n    alias: alias.length > 0 ? alias : defaults.alias,\n    description: session.comment.trim()\n  };\n}\n\nexport class RSToolAgent implements RSToolAgentContract {\n  public readonly contractVersion = CONTRACT_VERSION;\n  private readonly sessions = new SessionStore();\n  private readonly adapter = new SchemaAdapter();\n  private readonly evaluation = new ModelAdapter();\n\n  public createSession(initial?: Partial<SessionState>): SessionHandle {\n    return this.sessions.create(initial, this.contractVersion);\n  }\n\n  public addOrUpdateConstituenta(\n    sessionId: string,\n    input: AddOrUpdateConstituentaInput\n  ): AddOrUpdateConstituentaResult {\n    const envelope = this.sessions.get(sessionId);\n    const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, input.draft);\n    const state = this.adapter.mergeStateWithDraft(envelope.state, input.draft, result);\n    this.sessions.appendDiagnostics(sessionId, diagnostics);\n    return {\n      state,\n      diagnostics\n    };\n  }\n\n  public analyzeExpression(sessionId: string, input: AnalyzeExpressionInput): AnalysisResult {\n    const envelope = this.sessions.get(sessionId);\n    const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, {\n      id: -1,\n      alias: '_analysis',\n      cstType: input.cstType,\n      definitionFormal: input.expression\n    });\n    this.sessions.appendDiagnostics(\n      sessionId,\n      diagnostics.map(item => ({ ...item, constituentId: undefined }))\n    );\n    return result;\n  }\n\n  public getFormState(sessionId: string): SessionState {\n    const envelope = this.sessions.get(sessionId);\n    return structuredClone(envelope.state);\n  }\n\n  public listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters) {\n    return this.sessions.listDiagnostics(sessionId, filters);\n  }\n\n  public commitStep(sessionId: string, message?: string): SessionRevision {\n    return this.sessions.addRevision(sessionId, message);\n  }\n\n  public exportSession(sessionId: string): string {\n    const envelope = this.sessions.get(sessionId);\n    return JSON.stringify(\n      {\n        contractVersion: this.contractVersion,\n        state: envelope.state,\n        diagnostics: envelope.diagnostics\n      },\n      null,\n      2\n    );\n  }\n\n  public exportPortalSchema(sessionId: string): string {\n    const envelope = this.sessions.get(sessionId);\n    const payload: PortalSchemaImportData = {\n      contract_version: PORTAL_JSON_CONTRACT_VERSION,\n      ...portalImportMetadata(envelope.state, 'schema'),\n      items: envelope.state.items.map(item => ({\n        id: item.id,\n        alias: item.alias,\n        convention: item.convention,\n        crucial: false,\n        cst_type: item.cstType,\n        definition_formal: item.definitionFormal,\n        typification_manual: '',\n        value_is_property: false,\n        definition_raw: item.definitionText,\n        definition_resolved: item.definitionText,\n        term_raw: item.term,\n        term_resolved: item.term,\n        term_forms: []\n      })),\n      attribution: []\n    };\n    return JSON.stringify(payload, null, 2);\n  }\n\n  public exportPortalModel(sessionId: string): string {\n    const envelope = this.sessions.get(sessionId);\n    const payload: PortalModelImportData = {\n      contract_version: PORTAL_JSON_CONTRACT_VERSION,\n      ...portalImportMetadata(envelope.state, 'model'),\n      items: envelope.state.model.items.map(item => ({\n        id: item.id,\n        type: item.type,\n        value: item.value\n      }))\n    };\n    return JSON.stringify(payload, null, 2);\n  }\n\n  public importSession(payload: string): SessionHandle {\n    const parsed = JSON.parse(payload) as {\n      state: SessionState;\n    };\n    return this.sessions.create(normalizeImportedState(parsed.state), this.contractVersion);\n  }\n\n  public async setConstituentaValue(\n    sessionId: string,\n    input: SetConstituentaValueInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.setConstituentaValue(envelope.state, input);\n  }\n\n  public async setConstituentaValues(\n    sessionId: string,\n    input: SetConstituentaValuesInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.setConstituentaValues(envelope.state, input);\n  }\n\n  public async clearConstituentaValues(\n    sessionId: string,\n    input: ClearConstituentaValuesInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.clearConstituentaValues(envelope.state, input.items);\n  }\n\n  public getModelState(sessionId: string): SessionModelState {\n    const envelope = this.sessions.get(sessionId);\n    return structuredClone(envelope.state.model);\n  }\n\n  public evaluateExpression(sessionId: string, input: EvaluateExpressionInput): EvaluationResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.evaluateExpression(envelope.state, input.expression, input.cstType);\n  }\n\n  public evaluateConstituenta(sessionId: string, input: EvaluateConstituentaInput): EvaluationResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.evaluateConstituenta(envelope.state, input.constituentId);\n  }\n\n  public recalculateModel(sessionId: string): RecalculateModelResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.recalculateModel(envelope.state);\n  }\n}\n"],"mappings":"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"}

package/dist/{rstool-agent-DkeH5Qml.d.ts → rstool-agent-pRaPnZay.d.ts}

@@ -3,12 +3,12 @@ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic
 import { n as AddOrUpdateConstituentaResult, t as AddOrUpdateConstituentaInput } from "./constituenta-Dnd6iToB.js";
 import { n as EvaluateExpressionInput, r as EvaluationResult, t as EvaluateConstituentaInput } from "./evaluation-CCVYH0wA.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, o as SetConstituentaValuesInput, r as RecalculateModelResult, t as ClearConstituentaValuesInput } from "./model-value-SFAVj0dw.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BHGCCLfQ.js";
-import { n as RSToolAgentContract } from "./tool-contract-CsGqg_0P.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BPgsE80c.js";
+import { n as RSToolAgentContract } from "./tool-contract-n1ghUOrK.js";
 
 //#region src/models/rstool-agent.d.ts
 declare class RSToolAgent implements RSToolAgentContract {
-  readonly contractVersion = "1.2.0";
+  readonly contractVersion = "1.4.0";
   private readonly sessions;
   private readonly adapter;
   private readonly evaluation;
@@ -19,6 +19,8 @@ declare class RSToolAgent implements RSToolAgentContract {
   listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];
   commitStep(sessionId: string, message?: string): SessionRevision;
   exportSession(sessionId: string): string;
+  exportPortalSchema(sessionId: string): string;
+  exportPortalModel(sessionId: string): string;
   importSession(payload: string): SessionHandle;
   setConstituentaValue(sessionId: string, input: SetConstituentaValueInput): Promise<SessionModelState>;
   setConstituentaValues(sessionId: string, input: SetConstituentaValuesInput): Promise<SessionModelState>;
@@ -30,4 +32,4 @@ declare class RSToolAgent implements RSToolAgentContract {
 }
 //#endregion
 export { RSToolAgent as t };
-//# sourceMappingURL=rstool-agent-DkeH5Qml.d.ts.map
+//# sourceMappingURL=rstool-agent-pRaPnZay.d.ts.map

package/dist/session/session-store.d.ts

@@ -1,5 +1,6 @@
 import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-BMYvciz8.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BHGCCLfQ.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BPgsE80c.js";
+
 //#region src/session/session-store.d.ts
 interface SessionEnvelope {
   state: SessionState;

package/dist/session/session-store.js

@@ -7,6 +7,9 @@ var SessionStore = class {
 		const sessionId = initial?.sessionId ?? randomUUID();
 		const state = {
 			sessionId,
+			alias: initial?.alias ?? "",
+			title: initial?.title ?? "",
+			comment: initial?.comment ?? "",
 			createdAt: initial?.createdAt ?? now,
 			updatedAt: now,
 			revisions: initial?.revisions ?? [],

package/dist/session/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","names":[],"sources":["../../src/session/session-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport {\n  type DiagnosticRecord,\n  type ListDiagnosticsFilters,\n  type SessionHandle,\n  type SessionRevision,\n  type SessionState\n} from '../models';\n\ninterface SessionEnvelope {\n  state: SessionState;\n  diagnostics: DiagnosticRecord[];\n}\n\nexport class SessionStore {\n  private sessions = new Map<string, SessionEnvelope>();\n\n  public create(initial?: Partial<SessionState>, contractVersion?: string): SessionHandle {\n    const now = new Date().toISOString();\n    const sessionId = initial?.sessionId ?? randomUUID();\n    const state: SessionState = {\n      sessionId,\n      createdAt: initial?.createdAt ?? now,\n      updatedAt: now,\n      revisions: initial?.revisions ?? [],\n      items: initial?.items ?? [],\n      model: initial?.model ?? { items: [] }\n    };\n    this.sessions.set(sessionId, {\n      state,\n      diagnostics: []\n    });\n    return {\n      sessionId,\n      contractVersion: contractVersion ?? '1.0.0'\n    };\n  }\n\n  public get(sessionId: string): SessionEnvelope {\n    const found = this.sessions.get(sessionId);\n    if (!found) {\n      throw new Error(`Unknown session: ${sessionId}`);\n    }\n    return found;\n  }\n\n  public replaceState(sessionId: string, nextState: SessionState): void {\n    const found = this.get(sessionId);\n    found.state = {\n      ...nextState,\n      updatedAt: new Date().toISOString()\n    };\n  }\n\n  public addRevision(sessionId: string, message?: string): SessionRevision {\n    const found = this.get(sessionId);\n    const revision: SessionRevision = {\n      revisionId: randomUUID(),\n      at: new Date().toISOString(),\n      message\n    };\n    found.state.revisions.push(revision);\n    found.state.updatedAt = revision.at;\n    return revision;\n  }\n\n  public appendDiagnostics(sessionId: string, records: DiagnosticRecord[]): void {\n    const found = this.get(sessionId);\n    found.diagnostics.push(...records);\n    found.state.updatedAt = new Date().toISOString();\n  }\n\n  public listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[] {\n    const found = this.get(sessionId);\n    if (!filters?.constituentId) {\n      return [...found.diagnostics];\n    }\n    return found.diagnostics.filter(record => record.constituentId === filters.constituentId);\n  }\n}\n"],"mappings":";;AAeA,IAAa,eAAb,MAA0B;CACxB,2BAAmB,IAAI,IAA6B;CAEpD,OAAc,SAAiC,iBAAyC;EACtF,MAAM,uBAAM,IAAI,KAAK,GAAE,YAAY;EACnC,MAAM,YAAY,SAAS,aAAa,WAAW;EACnD,MAAM,QAAsB;GAC1B;GACA,WAAW,SAAS,aAAa;GACjC,WAAW;GACX,WAAW,SAAS,aAAa,CAAC;GAClC,OAAO,SAAS,SAAS,CAAC;GAC1B,OAAO,SAAS,SAAS,EAAE,OAAO,CAAC,EAAE;EACvC;EACA,KAAK,SAAS,IAAI,WAAW;GAC3B;GACA,aAAa,CAAC;EAChB,CAAC;EACD,OAAO;GACL;GACA,iBAAiB,mBAAmB;EACtC;CACF;CAEA,IAAW,WAAoC;EAC7C,MAAM,QAAQ,KAAK,SAAS,IAAI,SAAS;EACzC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,oBAAoB,WAAW;EAEjD,OAAO;CACT;CAEA,aAAoB,WAAmB,WAA+B;EACpE,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,QAAQ;GACZ,GAAG;GACH,4BAAW,IAAI,KAAK,GAAE,YAAY;EACpC;CACF;CAEA,YAAmB,WAAmB,SAAmC;EACvE,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,WAA4B;GAChC,YAAY,WAAW;GACvB,qBAAI,IAAI,KAAK,GAAE,YAAY;GAC3B;EACF;EACA,MAAM,MAAM,UAAU,KAAK,QAAQ;EACnC,MAAM,MAAM,YAAY,SAAS;EACjC,OAAO;CACT;CAEA,kBAAyB,WAAmB,SAAmC;EAC7E,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,YAAY,KAAK,GAAG,OAAO;EACjC,MAAM,MAAM,6BAAY,IAAI,KAAK,GAAE,YAAY;CACjD;CAEA,gBAAuB,WAAmB,SAAsD;EAC9F,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,IAAI,CAAC,SAAS,eACZ,OAAO,CAAC,GAAG,MAAM,WAAW;EAE9B,OAAO,MAAM,YAAY,QAAO,WAAU,OAAO,kBAAkB,QAAQ,aAAa;CAC1F;AACF"}
+{"version":3,"file":"session-store.js","names":[],"sources":["../../src/session/session-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport {\n  type DiagnosticRecord,\n  type ListDiagnosticsFilters,\n  type SessionHandle,\n  type SessionRevision,\n  type SessionState\n} from '../models';\n\ninterface SessionEnvelope {\n  state: SessionState;\n  diagnostics: DiagnosticRecord[];\n}\n\nexport class SessionStore {\n  private sessions = new Map<string, SessionEnvelope>();\n\n  public create(initial?: Partial<SessionState>, contractVersion?: string): SessionHandle {\n    const now = new Date().toISOString();\n    const sessionId = initial?.sessionId ?? randomUUID();\n    const state: SessionState = {\n      sessionId,\n      alias: initial?.alias ?? '',\n      title: initial?.title ?? '',\n      comment: initial?.comment ?? '',\n      createdAt: initial?.createdAt ?? now,\n      updatedAt: now,\n      revisions: initial?.revisions ?? [],\n      items: initial?.items ?? [],\n      model: initial?.model ?? { items: [] }\n    };\n    this.sessions.set(sessionId, {\n      state,\n      diagnostics: []\n    });\n    return {\n      sessionId,\n      contractVersion: contractVersion ?? '1.0.0'\n    };\n  }\n\n  public get(sessionId: string): SessionEnvelope {\n    const found = this.sessions.get(sessionId);\n    if (!found) {\n      throw new Error(`Unknown session: ${sessionId}`);\n    }\n    return found;\n  }\n\n  public replaceState(sessionId: string, nextState: SessionState): void {\n    const found = this.get(sessionId);\n    found.state = {\n      ...nextState,\n      updatedAt: new Date().toISOString()\n    };\n  }\n\n  public addRevision(sessionId: string, message?: string): SessionRevision {\n    const found = this.get(sessionId);\n    const revision: SessionRevision = {\n      revisionId: randomUUID(),\n      at: new Date().toISOString(),\n      message\n    };\n    found.state.revisions.push(revision);\n    found.state.updatedAt = revision.at;\n    return revision;\n  }\n\n  public appendDiagnostics(sessionId: string, records: DiagnosticRecord[]): void {\n    const found = this.get(sessionId);\n    found.diagnostics.push(...records);\n    found.state.updatedAt = new Date().toISOString();\n  }\n\n  public listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[] {\n    const found = this.get(sessionId);\n    if (!filters?.constituentId) {\n      return [...found.diagnostics];\n    }\n    return found.diagnostics.filter(record => record.constituentId === filters.constituentId);\n  }\n}\n"],"mappings":";;AAeA,IAAa,eAAb,MAA0B;CACxB,2BAAmB,IAAI,IAA6B;CAEpD,OAAc,SAAiC,iBAAyC;EACtF,MAAM,uBAAM,IAAI,KAAK,GAAE,YAAY;EACnC,MAAM,YAAY,SAAS,aAAa,WAAW;EACnD,MAAM,QAAsB;GAC1B;GACA,OAAO,SAAS,SAAS;GACzB,OAAO,SAAS,SAAS;GACzB,SAAS,SAAS,WAAW;GAC7B,WAAW,SAAS,aAAa;GACjC,WAAW;GACX,WAAW,SAAS,aAAa,CAAC;GAClC,OAAO,SAAS,SAAS,CAAC;GAC1B,OAAO,SAAS,SAAS,EAAE,OAAO,CAAC,EAAE;EACvC;EACA,KAAK,SAAS,IAAI,WAAW;GAC3B;GACA,aAAa,CAAC;EAChB,CAAC;EACD,OAAO;GACL;GACA,iBAAiB,mBAAmB;EACtC;CACF;CAEA,IAAW,WAAoC;EAC7C,MAAM,QAAQ,KAAK,SAAS,IAAI,SAAS;EACzC,IAAI,CAAC,OACH,MAAM,IAAI,MAAM,oBAAoB,WAAW;EAEjD,OAAO;CACT;CAEA,aAAoB,WAAmB,WAA+B;EACpE,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,QAAQ;GACZ,GAAG;GACH,4BAAW,IAAI,KAAK,GAAE,YAAY;EACpC;CACF;CAEA,YAAmB,WAAmB,SAAmC;EACvE,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,WAA4B;GAChC,YAAY,WAAW;GACvB,qBAAI,IAAI,KAAK,GAAE,YAAY;GAC3B;EACF;EACA,MAAM,MAAM,UAAU,KAAK,QAAQ;EACnC,MAAM,MAAM,YAAY,SAAS;EACjC,OAAO;CACT;CAEA,kBAAyB,WAAmB,SAAmC;EAC7E,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,MAAM,YAAY,KAAK,GAAG,OAAO;EACjC,MAAM,MAAM,6BAAY,IAAI,KAAK,GAAE,YAAY;CACjD;CAEA,gBAAuB,WAAmB,SAAsD;EAC9F,MAAM,QAAQ,KAAK,IAAI,SAAS;EAChC,IAAI,CAAC,SAAS,eACZ,OAAO,CAAC,GAAG,MAAM,WAAW;EAE9B,OAAO,MAAM,YAAY,QAAO,WAAU,OAAO,kBAAkB,QAAQ,aAAa;CAC1F;AACF"}

package/dist/{session-BHGCCLfQ.d.ts → session-BPgsE80c.d.ts}

@@ -13,12 +13,23 @@ interface SessionRevision {
 }
 interface SessionState {
   sessionId: string;
+  /** Library item alias for the conceptual schema or model. */
+  alias: string;
+  /** Human-readable title. */
+  title: string;
+  /** Developer comment (Portal JSON `description` on export). */
+  comment: string;
+  /** Date of creation. */
   createdAt: string;
+  /** Date of last update. */
   updatedAt: string;
+  /** List of revisions. */
   revisions: SessionRevision[];
+  /** List of constituents in the session. */
   items: ConstituentaState[];
+  /** Model state. */
   model: SessionModelState;
 }
 //#endregion
 export { SessionRevision as n, SessionState as r, SessionHandle as t };
-//# sourceMappingURL=session-BHGCCLfQ.d.ts.map
+//# sourceMappingURL=session-BPgsE80c.d.ts.map

package/dist/{tool-contract-CsGqg_0P.d.ts → tool-contract-n1ghUOrK.d.ts}

@@ -3,10 +3,10 @@ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic
 import { n as AddOrUpdateConstituentaResult, t as AddOrUpdateConstituentaInput } from "./constituenta-Dnd6iToB.js";
 import { n as EvaluateExpressionInput, r as EvaluationResult, t as EvaluateConstituentaInput } from "./evaluation-CCVYH0wA.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, o as SetConstituentaValuesInput, r as RecalculateModelResult, t as ClearConstituentaValuesInput } from "./model-value-SFAVj0dw.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BHGCCLfQ.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-BPgsE80c.js";
 
 //#region src/models/tool-contract.d.ts
-declare const CONTRACT_VERSION = "1.2.0";
+declare const CONTRACT_VERSION = "1.4.0";
 interface RSToolAgentContract {
   readonly contractVersion: string;
   createSession(initial?: Partial<SessionState>): SessionHandle;
@@ -16,6 +16,8 @@ interface RSToolAgentContract {
   listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];
   commitStep(sessionId: string, message?: string): SessionRevision;
   exportSession(sessionId: string): string;
+  exportPortalSchema(sessionId: string): string;
+  exportPortalModel(sessionId: string): string;
   importSession(payload: string): SessionHandle;
   setConstituentaValue(sessionId: string, input: SetConstituentaValueInput): Promise<SessionModelState>;
   setConstituentaValues(sessionId: string, input: SetConstituentaValuesInput): Promise<SessionModelState>;
@@ -27,4 +29,4 @@ interface RSToolAgentContract {
 }
 //#endregion
 export { RSToolAgentContract as n, CONTRACT_VERSION as t };
-//# sourceMappingURL=tool-contract-CsGqg_0P.d.ts.map
+//# sourceMappingURL=tool-contract-n1ghUOrK.d.ts.map

package/dist/wrapper/stdio-wrapper.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { RSToolAgent } from "../models/rstool-agent.js";
+import { t as RSToolAgent } from "../rstool-agent-BZi5jO1y.js";
 import readline from "node:readline";
 //#region src/wrapper/stdio-wrapper.ts
 const tool = new RSToolAgent();
@@ -11,6 +11,8 @@ const METHODS = [
 	"listDiagnostics",
 	"commitStep",
 	"exportSession",
+	"exportPortalSchema",
+	"exportPortalModel",
 	"importSession",
 	"setConstituentaValue",
 	"setConstituentaValues",
@@ -84,6 +86,16 @@ async function handleRequest(request) {
 				ok: true,
 				result: tool.exportSession(requiredString(params, "sessionId"))
 			};
+			case "exportPortalSchema": return {
+				id: request.id,
+				ok: true,
+				result: tool.exportPortalSchema(requiredString(params, "sessionId"))
+			};
+			case "exportPortalModel": return {
+				id: request.id,
+				ok: true,
+				result: tool.exportPortalModel(requiredString(params, "sessionId"))
+			};
 			case "importSession": return {
 				id: request.id,
 				ok: true,

package/dist/wrapper/stdio-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"stdio-wrapper.js","names":[],"sources":["../../src/wrapper/stdio-wrapper.ts"],"sourcesContent":["#!/usr/bin/env node\nimport readline from 'node:readline';\n\nimport { RSToolAgent } from '../models/rstool-agent';\n\ninterface StdioRequest {\n  id: string | number;\n  method: string;\n  params?: unknown;\n}\n\ninterface StdioResponse {\n  id: string | number | null;\n  ok: boolean;\n  result?: unknown;\n  error?: {\n    code: string;\n    message: string;\n    details?: unknown;\n  };\n}\n\nconst tool = new RSToolAgent();\n\nconst METHODS = [\n  'createSession',\n  'addOrUpdateConstituenta',\n  'analyzeExpression',\n  'getFormState',\n  'listDiagnostics',\n  'commitStep',\n  'exportSession',\n  'importSession',\n  'setConstituentaValue',\n  'setConstituentaValues',\n  'clearConstituentaValues',\n  'getModelState',\n  'evaluateExpression',\n  'evaluateConstituenta',\n  'recalculateModel'\n] as const;\n\nfunction writeResponse(response: StdioResponse): void {\n  if (!process.stdout.writable || process.stdout.destroyed || process.stdout.writableEnded) {\n    return;\n  }\n  try {\n    process.stdout.write(`${JSON.stringify(response)}\\n`);\n  } catch {\n    // The client might have already closed stdout (EPIPE). Safe to ignore.\n  }\n}\n\nfunction asObject(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return {};\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction requiredString(input: Record<string, unknown>, key: string): string {\n  const value = input[key];\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Missing or invalid \"${key}\"`);\n  }\n  return value;\n}\n\nasync function handleRequest(request: StdioRequest): Promise<StdioResponse> {\n  try {\n    const params = asObject(request.params);\n    switch (request.method) {\n      case 'ping':\n        return { id: request.id, ok: true, result: { pong: true } };\n      case 'methods':\n        return { id: request.id, ok: true, result: METHODS };\n      case 'createSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.createSession(params.initial as never)\n        };\n      case 'addOrUpdateConstituenta':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.addOrUpdateConstituenta(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'analyzeExpression':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.analyzeExpression(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'getFormState':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.getFormState(requiredString(params, 'sessionId'))\n        };\n      case 'listDiagnostics':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.listDiagnostics(requiredString(params, 'sessionId'), params.filters as never)\n        };\n      case 'commitStep':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.commitStep(requiredString(params, 'sessionId'), params.message as string | undefined)\n        };\n      case 'exportSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.exportSession(requiredString(params, 'sessionId'))\n        };\n      case 'importSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.importSession(requiredString(params, 'payload'))\n        };\n      case 'setConstituentaValue':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.setConstituentaValue(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'setConstituentaValues':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.setConstituentaValues(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'clearConstituentaValues':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.clearConstituentaValues(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'getModelState':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.getModelState(requiredString(params, 'sessionId'))\n        };\n      case 'evaluateExpression':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.evaluateExpression(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'evaluateConstituenta':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.evaluateConstituenta(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'recalculateModel':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.recalculateModel(requiredString(params, 'sessionId'))\n        };\n      default:\n        return {\n          id: request.id ?? null,\n          ok: false,\n          error: {\n            code: 'METHOD_NOT_FOUND',\n            message: `Unknown method: ${request.method}`\n          }\n        };\n    }\n  } catch (error) {\n    return {\n      id: request.id ?? null,\n      ok: false,\n      error: {\n        code: 'INTERNAL_ERROR',\n        message: error instanceof Error ? error.message : 'Unknown error',\n        details: error\n      }\n    };\n  }\n}\n\nconst input = readline.createInterface({\n  input: process.stdin,\n  crlfDelay: Infinity\n});\n\nwriteResponse({\n  id: null,\n  ok: true,\n  result: {\n    ready: true,\n    wrapper: 'rstool-stdio',\n    contractVersion: tool.contractVersion\n  }\n});\n\ninput.on('line', line => {\n  if (!line.trim()) {\n    return;\n  }\n  try {\n    const request = JSON.parse(line) as StdioRequest;\n    if (!('id' in request) || !('method' in request)) {\n      throw new Error('Request must include \"id\" and \"method\"');\n    }\n    void handleRequest(request).then(writeResponse);\n  } catch (error) {\n    writeResponse({\n      id: null,\n      ok: false,\n      error: {\n        code: 'BAD_REQUEST',\n        message: error instanceof Error ? error.message : 'Invalid JSON'\n      }\n    });\n  }\n});\n"],"mappings":"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"}
+{"version":3,"file":"stdio-wrapper.js","names":[],"sources":["../../src/wrapper/stdio-wrapper.ts"],"sourcesContent":["#!/usr/bin/env node\nimport readline from 'node:readline';\n\nimport { RSToolAgent } from '../models/rstool-agent';\n\ninterface StdioRequest {\n  id: string | number;\n  method: string;\n  params?: unknown;\n}\n\ninterface StdioResponse {\n  id: string | number | null;\n  ok: boolean;\n  result?: unknown;\n  error?: {\n    code: string;\n    message: string;\n    details?: unknown;\n  };\n}\n\nconst tool = new RSToolAgent();\n\nconst METHODS = [\n  'createSession',\n  'addOrUpdateConstituenta',\n  'analyzeExpression',\n  'getFormState',\n  'listDiagnostics',\n  'commitStep',\n  'exportSession',\n  'exportPortalSchema',\n  'exportPortalModel',\n  'importSession',\n  'setConstituentaValue',\n  'setConstituentaValues',\n  'clearConstituentaValues',\n  'getModelState',\n  'evaluateExpression',\n  'evaluateConstituenta',\n  'recalculateModel'\n] as const;\n\nfunction writeResponse(response: StdioResponse): void {\n  if (!process.stdout.writable || process.stdout.destroyed || process.stdout.writableEnded) {\n    return;\n  }\n  try {\n    process.stdout.write(`${JSON.stringify(response)}\\n`);\n  } catch {\n    // The client might have already closed stdout (EPIPE). Safe to ignore.\n  }\n}\n\nfunction asObject(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) {\n    return {};\n  }\n  return value as Record<string, unknown>;\n}\n\nfunction requiredString(input: Record<string, unknown>, key: string): string {\n  const value = input[key];\n  if (typeof value !== 'string' || value.length === 0) {\n    throw new Error(`Missing or invalid \"${key}\"`);\n  }\n  return value;\n}\n\nasync function handleRequest(request: StdioRequest): Promise<StdioResponse> {\n  try {\n    const params = asObject(request.params);\n    switch (request.method) {\n      case 'ping':\n        return { id: request.id, ok: true, result: { pong: true } };\n      case 'methods':\n        return { id: request.id, ok: true, result: METHODS };\n      case 'createSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.createSession(params.initial as never)\n        };\n      case 'addOrUpdateConstituenta':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.addOrUpdateConstituenta(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'analyzeExpression':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.analyzeExpression(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'getFormState':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.getFormState(requiredString(params, 'sessionId'))\n        };\n      case 'listDiagnostics':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.listDiagnostics(requiredString(params, 'sessionId'), params.filters as never)\n        };\n      case 'commitStep':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.commitStep(requiredString(params, 'sessionId'), params.message as string | undefined)\n        };\n      case 'exportSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.exportSession(requiredString(params, 'sessionId'))\n        };\n      case 'exportPortalSchema':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.exportPortalSchema(requiredString(params, 'sessionId'))\n        };\n      case 'exportPortalModel':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.exportPortalModel(requiredString(params, 'sessionId'))\n        };\n      case 'importSession':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.importSession(requiredString(params, 'payload'))\n        };\n      case 'setConstituentaValue':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.setConstituentaValue(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'setConstituentaValues':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.setConstituentaValues(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'clearConstituentaValues':\n        return {\n          id: request.id,\n          ok: true,\n          result: await tool.clearConstituentaValues(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'getModelState':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.getModelState(requiredString(params, 'sessionId'))\n        };\n      case 'evaluateExpression':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.evaluateExpression(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'evaluateConstituenta':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.evaluateConstituenta(requiredString(params, 'sessionId'), params.input as never)\n        };\n      case 'recalculateModel':\n        return {\n          id: request.id,\n          ok: true,\n          result: tool.recalculateModel(requiredString(params, 'sessionId'))\n        };\n      default:\n        return {\n          id: request.id ?? null,\n          ok: false,\n          error: {\n            code: 'METHOD_NOT_FOUND',\n            message: `Unknown method: ${request.method}`\n          }\n        };\n    }\n  } catch (error) {\n    return {\n      id: request.id ?? null,\n      ok: false,\n      error: {\n        code: 'INTERNAL_ERROR',\n        message: error instanceof Error ? error.message : 'Unknown error',\n        details: error\n      }\n    };\n  }\n}\n\nconst input = readline.createInterface({\n  input: process.stdin,\n  crlfDelay: Infinity\n});\n\nwriteResponse({\n  id: null,\n  ok: true,\n  result: {\n    ready: true,\n    wrapper: 'rstool-stdio',\n    contractVersion: tool.contractVersion\n  }\n});\n\ninput.on('line', line => {\n  if (!line.trim()) {\n    return;\n  }\n  try {\n    const request = JSON.parse(line) as StdioRequest;\n    if (!('id' in request) || !('method' in request)) {\n      throw new Error('Request must include \"id\" and \"method\"');\n    }\n    void handleRequest(request).then(writeResponse);\n  } catch (error) {\n    writeResponse({\n      id: null,\n      ok: false,\n      error: {\n        code: 'BAD_REQUEST',\n        message: error instanceof Error ? error.message : 'Invalid JSON'\n      }\n    });\n  }\n});\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsconcept/rstool",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Agent-facing library for incremental RSForm construction, RSLang analysis, diagnostics, modeling, and evaluation. Wraps @rsconcept/domain with a deterministic session contract and stdio wrapper.",
   "license": "MIT",
   "author": "IRBorisov",

package/skills/rstool-helper/EXAMPLES.md

@@ -92,6 +92,15 @@ const restored = tool.importSession(payload);
 
 Export includes session state and model values.
 
+To create files the user can upload to an existing Portal object:
+
+```ts
+const schemaJson = tool.exportPortalSchema(sessionId);
+const modelJson = tool.exportPortalModel(sessionId);
+```
+
+Use `schemaJson` on a schema page and `modelJson` on a model page via **Load from JSON**.
+
 ## Evaluation
 
 ```ts

package/skills/rstool-helper/GUIDE.md

@@ -39,6 +39,7 @@ Paths are relative to this file.
 8. Set base/model values with `setConstituentaValue(s)`.
 9. Evaluate with `evaluateExpression`, `evaluateConstituenta`, or `recalculateModel`.
 10. Persist with `exportSession` / `importSession`.
+11. For user-uploadable Portal files, use `exportPortalSchema` for schema JSON or `exportPortalModel` for model JSON.
 
 ## Portal REST
 

package/skills/rstool-helper/REFERENCE.md

@@ -3,7 +3,7 @@
 ## rstool contract
 
 - Package: `@rsconcept/rstool`
-- Contract version: `1.2.0` (`CONTRACT_VERSION`)
+- Contract version: `1.4.0` (`CONTRACT_VERSION`)
 - Core class: `RSToolAgent`
 - Public imports: `@rsconcept/rstool` and `@rsconcept/rstool/wrapper`
 
@@ -18,6 +18,8 @@
 | `listDiagnostics(sessionId, filters?)`                      | Accumulated diagnostics; optional `constituentId` filter           |
 | `commitStep(sessionId, message?)`                           | Record revision checkpoint                                         |
 | `exportSession(sessionId)`                                  | JSON string `{ contractVersion, state, diagnostics }`              |
+| `exportPortalSchema(sessionId)`                             | Portal schema import JSON string using versioned schema shape      |
+| `exportPortalModel(sessionId)`                              | Portal model import JSON string using versioned model values shape |
 | `importSession(payload)`                                    | New session from export                                            |
 | `setConstituentaValue(sessionId, { target, type?, value })` | Set one base binding or structured value → `SessionModelState`     |
 | `setConstituentaValues(sessionId, { items })`               | Batch set values → `SessionModelState`                             |
@@ -43,6 +45,20 @@
 
 Omitted text fields default to `''` in stored state.
 
+### `SessionState` metadata
+
+Set on `createSession(initial?)` or via `importSession`:
+
+```ts
+{
+  alias: string; // library item alias
+  title: string; // display title
+  comment: string; // developer notes
+}
+```
+
+All default to `''` when omitted.
+
 ### Model and evaluation types
 
 ```ts
@@ -69,7 +85,7 @@ Base/constant bindings use `type: "basic"` and `value: { "0": "label", … }`. S
 
 Process: `npx rstool-wrapper`
 
-1. **Ready** (no request): `{"id":null,"ok":true,"result":{"ready":true,"wrapper":"rstool-stdio","contractVersion":"1.2.0"}}`
+1. **Ready** (no request): `{"id":null,"ok":true,"result":{"ready":true,"wrapper":"rstool-stdio","contractVersion":"1.4.0"}}`
 2. **Request**: `{"id":"<unique>","method":"<name>","params":{...}}`
 3. **Response**: `{"id":"<same>","ok":true,"result":...}` or `{"id":"...","ok":false,"error":{"code":"...","message":"..."}}`
 
@@ -85,6 +101,8 @@ Example chain:
 {"id":"4","method":"listDiagnostics","params":{"sessionId":"…"}}
 {"id":"5","method":"commitStep","params":{"sessionId":"…","message":"checkpoint"}}
 {"id":"6","method":"exportSession","params":{"sessionId":"…"}}
+{"id":"6a","method":"exportPortalSchema","params":{"sessionId":"…"}}
+{"id":"6b","method":"exportPortalModel","params":{"sessionId":"…"}}
 {"id":"7","method":"setConstituentaValue","params":{"sessionId":"…","input":{"target":1,"value":{"0":"a","1":"b"}}}}
 {"id":"8","method":"evaluateExpression","params":{"sessionId":"…","input":{"expression":"1+2","cstType":"term"}}}
 {"id":"9","method":"evaluateConstituenta","params":{"sessionId":"…","input":{"constituentId":3}}}
@@ -109,7 +127,7 @@ interface AnalysisResult {
 - **Term graph**: directed dependencies between constituenta via alias references in definitions.
 - **`S#` vs `D#`**: same `×` token — in `ℬ(X1×X1)` on `S#` it forms a **grade** (pair type); in `X1×X1` on `D#` it is the **Cartesian product** (all pairs). Relations: `S#` + `convention`, then derived `D#` (`Pr1(S1)`, …).
 
-Intro (help): language is FOL-based; set vs logic expression split; parameterized templates for term/predicate functions; structural expressions reshape stages.
+Intro (help): language is FOL-based; set vs logic expression split; parameterized templates for term/predicate functions.
 
 ## Grammar tokens (selected)
 
@@ -134,15 +152,15 @@ Standalone agents should consult the bundled distilled docs (`docs/*.md` inside
 
 | Topic                                | Bundled doc                                |
 | ------------------------------------ | ------------------------------------------ |
-| Identifiers, literals                | `docs/SYNTAX.md` § *Identifier rules*      |
+| Identifiers, literals                | `docs/SYNTAX.md` § _Identifier rules_      |
 | Grades, `Logic`, parameterized types | `docs/TYPIFICATION.md`                     |
-| Logical expressions                  | `docs/SYNTAX.md` § *Logical expressions*   |
-| Set operators                        | `docs/SYNTAX.md` § *Set-theoretic*         |
-| Integer arithmetic                   | `docs/SYNTAX.md` § *Arithmetic*            |
-| Structural / typification reshaping  | `docs/TYPIFICATION.md` § *Forming/derived* |
-| Quantifiers                          | `docs/SYNTAX.md` § *Quantifiers*           |
-| Parameterized functions, templates   | `docs/SYNTAX.md` § *Parameterised*         |
-| Correctness / validation mindset     | `docs/SYNTAX.md` § *Correctness model*     |
+| Logical expressions                  | `docs/SYNTAX.md` § _Logical expressions_   |
+| Set operators                        | `docs/SYNTAX.md` § _Set-theoretic_         |
+| Integer arithmetic                   | `docs/SYNTAX.md` § _Arithmetic_            |
+| Structural / typification reshaping  | `docs/TYPIFICATION.md` § _Forming/derived_ |
+| Quantifiers                          | `docs/SYNTAX.md` § _Quantifiers_           |
+| Parameterized functions, templates   | `docs/SYNTAX.md` § _Parameterised_         |
+| Correctness / validation mindset     | `docs/SYNTAX.md` § _Correctness model_     |
 | Definition semantic tests            | `docs/MODEL-TESTING.md`                    |
 | Domain vocabulary                    | `docs/DOMAIN.md`                           |
 | Constituent fields and ordering      | `docs/CONSTITUENTA.md`                     |
@@ -167,6 +185,19 @@ Categories:
 
 `exportSession(sessionId)` returns a JSON string with `{ contractVersion, state, diagnostics }`.
 
+- `state.alias`, `state.title`, `state.comment` — library-item metadata for Portal export (`comment` → JSON `description`).
 - `state.items[]` contains each constituent with `id`, `alias`, `cstType`, `definitionFormal`, optional text fields, and nested analysis output.
 - `state.model.items[]` is present when interpretation values have been set.
 - `diagnostics[]` contains accumulated diagnostics with offsets and codes.
+
+## Portal import JSON
+
+For **Load from JSON** on an existing Portal schema or model:
+
+- `exportPortalSchema(sessionId)` — schema file
+- `exportPortalModel(sessionId)` — model file
+
+Both return `contract_version` `1.0.0` plus required `title`, `alias`, `description`, and `items`. Schema files may include `attribution`. Values come from `state.title`, `state.alias`, and `state.comment` (empty fields fall back to `Conceptual schema` / `SCHEMA` or `Conceptual model` / `MODEL` and `""`).
+
+- Schema `items[]`: versioned constituent fields (`cst_type`, `definition_formal`, `term_raw`, …).
+- Model `items[]`: `{ id, type, value }` per binding.

package/src/index.ts

@@ -25,6 +25,12 @@ export {
   type EvaluationResult,
   type ListDiagnosticsFilters,
   type ModelValueState,
+  PORTAL_JSON_CONTRACT_VERSION,
+  type PortalImportMetadata,
+  type PortalModelImportData,
+  type PortalSchemaConstituenta,
+  type PortalSchemaImportData,
+  type PortalTermForm,
   type RecalculateModelResult,
   type RSToolAgentContract,
   type RSToolErrorDescription,

package/src/models/index.ts

@@ -28,6 +28,14 @@ export {
   type SetConstituentaValueInput,
   type SetConstituentaValuesInput
 } from './model-value';
+export {
+  PORTAL_JSON_CONTRACT_VERSION,
+  type PortalImportMetadata,
+  type PortalModelImportData,
+  type PortalSchemaConstituenta,
+  type PortalSchemaImportData,
+  type PortalTermForm
+} from './portal-json';
 export { RSToolAgent } from './rstool-agent';
 export { type SessionHandle, type SessionRevision, type SessionState } from './session';
 export { CONTRACT_VERSION, type RSToolAgentContract } from './tool-contract';

package/src/models/portal-json.ts

@@ -0,0 +1,45 @@
+import { type BasicBinding, type RSToolValue } from './common';
+
+/** Portal JSON import/export format version (schema and model files). */
+export const PORTAL_JSON_CONTRACT_VERSION = '1.0.0';
+
+export interface PortalImportMetadata {
+  contract_version: string;
+  title: string;
+  alias: string;
+  description: string;
+}
+
+export interface PortalTermForm {
+  text: string;
+  tags: string;
+}
+
+export interface PortalSchemaConstituenta {
+  id: number;
+  alias: string;
+  convention: string;
+  crucial: boolean;
+  cst_type: string;
+  definition_formal: string;
+  typification_manual: string;
+  value_is_property: boolean;
+  definition_raw: string;
+  definition_resolved: string;
+  term_raw: string;
+  term_resolved: string;
+  term_forms: PortalTermForm[];
+}
+
+export interface PortalSchemaImportData extends PortalImportMetadata {
+  items: PortalSchemaConstituenta[];
+  attribution: Array<{ container: number; attribute: number }>;
+}
+
+export interface PortalModelImportData extends PortalImportMetadata {
+  items: Array<{
+    id: number;
+    type: string;
+    value: RSToolValue | BasicBinding;
+  }>;
+}

package/src/models/rstool-agent.test.ts

@@ -126,6 +126,104 @@ describe('RSToolAgent', () => {
     });
   });
 
+  it('stores and exports session metadata', () => {
+    const tool = new RSToolAgent();
+    const session = tool.createSession({
+      alias: 'KIN',
+      title: 'Kinship',
+      comment: 'Example schema'
+    });
+
+    expect(tool.getFormState(session.sessionId)).toMatchObject({
+      alias: 'KIN',
+      title: 'Kinship',
+      comment: 'Example schema'
+    });
+
+    const exported = JSON.parse(tool.exportPortalSchema(session.sessionId)) as {
+      title: string;
+      alias: string;
+      description: string;
+    };
+    expect(exported).toMatchObject({
+      title: 'Kinship',
+      alias: 'KIN',
+      description: 'Example schema'
+    });
+  });
+
+  it('exports schema data for Portal JSON import', () => {
+    const tool = new RSToolAgent();
+    const session = tool.createSession();
+    tool.addOrUpdateConstituenta(session.sessionId, {
+      draft: {
+        id: 15,
+        alias: 'D2',
+        cstType: CstType.TERM,
+        definitionFormal: '1',
+        term: 'natural number',
+        definitionText: 'A positive integer',
+        convention: 'Standard arithmetic'
+      }
+    });
+
+    const exported = JSON.parse(tool.exportPortalSchema(session.sessionId)) as {
+      contract_version: string;
+      title: string;
+      alias: string;
+      description: string;
+      items: Array<Record<string, unknown>>;
+      attribution: unknown[];
+    };
+
+    expect(exported.contract_version).toBe('1.0.0');
+    expect(exported.title).toBe('Conceptual schema');
+    expect(exported.alias).toBe('SCHEMA');
+    expect(exported.description).toBe('');
+
+    expect(exported.items[0]).toMatchObject({
+      id: 15,
+      alias: 'D2',
+      cst_type: CstType.TERM,
+      definition_formal: '1',
+      definition_raw: 'A positive integer',
+      term_raw: 'natural number',
+      convention: 'Standard arithmetic',
+      crucial: false
+    });
+    expect(exported.attribution).toEqual([]);
+  });
+
+  it('exports model data for Portal JSON import', async () => {
+    const tool = new RSToolAgent();
+    const session = tool.createSession();
+    buildSampleForm(tool, session.sessionId);
+    await tool.setConstituentaValue(session.sessionId, {
+      target: 1,
+      value: { 1: 'Alice' }
+    });
+
+    const exported = JSON.parse(tool.exportPortalModel(session.sessionId)) as {
+      contract_version: string;
+      title: string;
+      alias: string;
+      description: string;
+      items: Array<Record<string, unknown>>;
+    };
+
+    expect(exported.contract_version).toBe('1.0.0');
+    expect(exported.title).toBe('Conceptual model');
+    expect(exported.alias).toBe('MODEL');
+
+    expect(exported.items).toEqual([
+      {
+        id: 1,
+        type: 'basic',
+        value: { 1: 'Alice' }
+      }
+    ]);
+  });
+
   it('defaults missing text fields to empty strings', () => {
     const tool = new RSToolAgent();
     const session = tool.createSession();

package/src/models/rstool-agent.ts

@@ -19,9 +19,41 @@ import {
   type SetConstituentaValueInput,
   type SetConstituentaValuesInput
 } from './model-value';
+import {
+  PORTAL_JSON_CONTRACT_VERSION,
+  type PortalModelImportData,
+  type PortalSchemaImportData
+} from './portal-json';
 import { type SessionHandle, type SessionRevision, type SessionState } from './session';
 import { CONTRACT_VERSION, type RSToolAgentContract } from './tool-contract';
 
+function normalizeImportedState(state: SessionState): SessionState {
+  return {
+    ...state,
+    alias: state.alias ?? '',
+    title: state.title ?? '',
+    comment: state.comment ?? '',
+    model: state.model ?? { items: [] }
+  };
+}
+
+function portalImportMetadata(
+  session: SessionState,
+  kind: 'schema' | 'model'
+): Pick<PortalSchemaImportData, 'title' | 'alias' | 'description'> {
+  const defaults =
+    kind === 'schema'
+      ? { title: 'Conceptual schema', alias: 'SCHEMA' }
+      : { title: 'Conceptual model', alias: 'MODEL' };
+  const title = session.title.trim();
+  const alias = session.alias.trim();
+  return {
+    title: title.length > 0 ? title : defaults.title,
+    alias: alias.length > 0 ? alias : defaults.alias,
+    description: session.comment.trim()
+  };
+}
+
 export class RSToolAgent implements RSToolAgentContract {
   public readonly contractVersion = CONTRACT_VERSION;
   private readonly sessions = new SessionStore();
@@ -87,14 +119,50 @@ export class RSToolAgent implements RSToolAgentContract {
     );
   }
 
+  public exportPortalSchema(sessionId: string): string {
+    const envelope = this.sessions.get(sessionId);
+    const payload: PortalSchemaImportData = {
+      contract_version: PORTAL_JSON_CONTRACT_VERSION,
+      ...portalImportMetadata(envelope.state, 'schema'),
+      items: envelope.state.items.map(item => ({
+        id: item.id,
+        alias: item.alias,
+        convention: item.convention,
+        crucial: false,
+        cst_type: item.cstType,
+        definition_formal: item.definitionFormal,
+        typification_manual: '',
+        value_is_property: false,
+        definition_raw: item.definitionText,
+        definition_resolved: item.definitionText,
+        term_raw: item.term,
+        term_resolved: item.term,
+        term_forms: []
+      })),
+      attribution: []
+    };
+    return JSON.stringify(payload, null, 2);
+  }
+
+  public exportPortalModel(sessionId: string): string {
+    const envelope = this.sessions.get(sessionId);
+    const payload: PortalModelImportData = {
+      contract_version: PORTAL_JSON_CONTRACT_VERSION,
+      ...portalImportMetadata(envelope.state, 'model'),
+      items: envelope.state.model.items.map(item => ({
+        id: item.id,
+        type: item.type,
+        value: item.value
+      }))
+    };
+    return JSON.stringify(payload, null, 2);
+  }
+
   public importSession(payload: string): SessionHandle {
     const parsed = JSON.parse(payload) as {
       state: SessionState;
     };
-    if (!parsed.state.model) {
-      parsed.state.model = { items: [] };
-    }
-    return this.sessions.create(parsed.state, this.contractVersion);
+    return this.sessions.create(normalizeImportedState(parsed.state), this.contractVersion);
   }
 
   public async setConstituentaValue(

package/src/models/session.ts

@@ -14,9 +14,20 @@ export interface SessionRevision {
 
 export interface SessionState {
   sessionId: string;
+  /** Library item alias for the conceptual schema or model. */
+  alias: string;
+  /** Human-readable title. */
+  title: string;
+  /** Developer comment (Portal JSON `description` on export). */
+  comment: string;
+  /** Date of creation. */
   createdAt: string;
+  /** Date of last update. */
   updatedAt: string;
+  /** List of revisions. */
   revisions: SessionRevision[];
+  /** List of constituents in the session. */
   items: ConstituentaState[];
+  /** Model state. */
   model: SessionModelState;
 }

package/src/models/tool-contract.ts

@@ -25,7 +25,7 @@ import {
   type SessionState
 } from './session';
 
-export const CONTRACT_VERSION = '1.2.0';
+export const CONTRACT_VERSION = '1.4.0';
 
 export interface RSToolAgentContract {
   readonly contractVersion: string;
@@ -36,6 +36,8 @@ export interface RSToolAgentContract {
   listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];
   commitStep(sessionId: string, message?: string): SessionRevision;
   exportSession(sessionId: string): string;
+  exportPortalSchema(sessionId: string): string;
+  exportPortalModel(sessionId: string): string;
   importSession(payload: string): SessionHandle;
   setConstituentaValue(sessionId: string, input: SetConstituentaValueInput): Promise<SessionModelState>;
   setConstituentaValues(sessionId: string, input: SetConstituentaValuesInput): Promise<SessionModelState>;

package/src/session/session-store.ts

@@ -21,6 +21,9 @@ export class SessionStore {
     const sessionId = initial?.sessionId ?? randomUUID();
     const state: SessionState = {
       sessionId,
+      alias: initial?.alias ?? '',
+      title: initial?.title ?? '',
+      comment: initial?.comment ?? '',
       createdAt: initial?.createdAt ?? now,
       updatedAt: now,
       revisions: initial?.revisions ?? [],

package/src/wrapper/stdio-wrapper.ts

@@ -30,6 +30,8 @@ const METHODS = [
   'listDiagnostics',
   'commitStep',
   'exportSession',
+  'exportPortalSchema',
+  'exportPortalModel',
   'importSession',
   'setConstituentaValue',
   'setConstituentaValues',
@@ -116,6 +118,18 @@ async function handleRequest(request: StdioRequest): Promise<StdioResponse> {
           ok: true,
           result: tool.exportSession(requiredString(params, 'sessionId'))
         };
+      case 'exportPortalSchema':
+        return {
+          id: request.id,
+          ok: true,
+          result: tool.exportPortalSchema(requiredString(params, 'sessionId'))
+        };
+      case 'exportPortalModel':
+        return {
+          id: request.id,
+          ok: true,
+          result: tool.exportPortalModel(requiredString(params, 'sessionId'))
+        };
       case 'importSession':
         return {
           id: request.id,

package/dist/models/rstool-agent.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"rstool-agent.js","names":[],"sources":["../../src/models/rstool-agent.ts"],"sourcesContent":["import { ModelAdapter } from '../mappers/model-adapter';\nimport { SchemaAdapter } from '../mappers/schema-adapter';\nimport { SessionStore } from '../session/session-store';\nimport { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport {\n  type AddOrUpdateConstituentaInput,\n  type AddOrUpdateConstituentaResult\n} from './constituenta';\nimport { type ListDiagnosticsFilters } from './diagnostic';\nimport {\n  type EvaluateConstituentaInput,\n  type EvaluateExpressionInput,\n  type EvaluationResult\n} from './evaluation';\nimport {\n  type ClearConstituentaValuesInput,\n  type RecalculateModelResult,\n  type SessionModelState,\n  type SetConstituentaValueInput,\n  type SetConstituentaValuesInput\n} from './model-value';\nimport { type SessionHandle, type SessionRevision, type SessionState } from './session';\nimport { CONTRACT_VERSION, type RSToolAgentContract } from './tool-contract';\n\nexport class RSToolAgent implements RSToolAgentContract {\n  public readonly contractVersion = CONTRACT_VERSION;\n  private readonly sessions = new SessionStore();\n  private readonly adapter = new SchemaAdapter();\n  private readonly evaluation = new ModelAdapter();\n\n  public createSession(initial?: Partial<SessionState>): SessionHandle {\n    return this.sessions.create(initial, this.contractVersion);\n  }\n\n  public addOrUpdateConstituenta(\n    sessionId: string,\n    input: AddOrUpdateConstituentaInput\n  ): AddOrUpdateConstituentaResult {\n    const envelope = this.sessions.get(sessionId);\n    const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, input.draft);\n    const state = this.adapter.mergeStateWithDraft(envelope.state, input.draft, result);\n    this.sessions.appendDiagnostics(sessionId, diagnostics);\n    return {\n      state,\n      diagnostics\n    };\n  }\n\n  public analyzeExpression(sessionId: string, input: AnalyzeExpressionInput): AnalysisResult {\n    const envelope = this.sessions.get(sessionId);\n    const { result, diagnostics } = this.adapter.analyzeAgainstSession(envelope.state, {\n      id: -1,\n      alias: '_analysis',\n      cstType: input.cstType,\n      definitionFormal: input.expression\n    });\n    this.sessions.appendDiagnostics(\n      sessionId,\n      diagnostics.map(item => ({ ...item, constituentId: undefined }))\n    );\n    return result;\n  }\n\n  public getFormState(sessionId: string): SessionState {\n    const envelope = this.sessions.get(sessionId);\n    return structuredClone(envelope.state);\n  }\n\n  public listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters) {\n    return this.sessions.listDiagnostics(sessionId, filters);\n  }\n\n  public commitStep(sessionId: string, message?: string): SessionRevision {\n    return this.sessions.addRevision(sessionId, message);\n  }\n\n  public exportSession(sessionId: string): string {\n    const envelope = this.sessions.get(sessionId);\n    return JSON.stringify(\n      {\n        contractVersion: this.contractVersion,\n        state: envelope.state,\n        diagnostics: envelope.diagnostics\n      },\n      null,\n      2\n    );\n  }\n\n  public importSession(payload: string): SessionHandle {\n    const parsed = JSON.parse(payload) as {\n      state: SessionState;\n    };\n    if (!parsed.state.model) {\n      parsed.state.model = { items: [] };\n    }\n    return this.sessions.create(parsed.state, this.contractVersion);\n  }\n\n  public async setConstituentaValue(\n    sessionId: string,\n    input: SetConstituentaValueInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.setConstituentaValue(envelope.state, input);\n  }\n\n  public async setConstituentaValues(\n    sessionId: string,\n    input: SetConstituentaValuesInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.setConstituentaValues(envelope.state, input);\n  }\n\n  public async clearConstituentaValues(\n    sessionId: string,\n    input: ClearConstituentaValuesInput\n  ): Promise<SessionModelState> {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.clearConstituentaValues(envelope.state, input.items);\n  }\n\n  public getModelState(sessionId: string): SessionModelState {\n    const envelope = this.sessions.get(sessionId);\n    return structuredClone(envelope.state.model);\n  }\n\n  public evaluateExpression(sessionId: string, input: EvaluateExpressionInput): EvaluationResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.evaluateExpression(envelope.state, input.expression, input.cstType);\n  }\n\n  public evaluateConstituenta(sessionId: string, input: EvaluateConstituentaInput): EvaluationResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.evaluateConstituenta(envelope.state, input.constituentId);\n  }\n\n  public recalculateModel(sessionId: string): RecalculateModelResult {\n    const envelope = this.sessions.get(sessionId);\n    return this.evaluation.recalculateModel(envelope.state);\n  }\n}\n"],"mappings":";;;;;AAwBA,IAAa,cAAb,MAAwD;CACtD,kBAAkC;CAClC,WAA4B,IAAI,aAAa;CAC7C,UAA2B,IAAI,cAAc;CAC7C,aAA8B,IAAI,aAAa;CAE/C,cAAqB,SAAgD;EACnE,OAAO,KAAK,SAAS,OAAO,SAAS,KAAK,eAAe;CAC3D;CAEA,wBACE,WACA,OAC+B;EAC/B,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,MAAM,EAAE,QAAQ,gBAAgB,KAAK,QAAQ,sBAAsB,SAAS,OAAO,MAAM,KAAK;EAC9F,MAAM,QAAQ,KAAK,QAAQ,oBAAoB,SAAS,OAAO,MAAM,OAAO,MAAM;EAClF,KAAK,SAAS,kBAAkB,WAAW,WAAW;EACtD,OAAO;GACL;GACA;EACF;CACF;CAEA,kBAAyB,WAAmB,OAA+C;EACzF,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,MAAM,EAAE,QAAQ,gBAAgB,KAAK,QAAQ,sBAAsB,SAAS,OAAO;GACjF,IAAI;GACJ,OAAO;GACP,SAAS,MAAM;GACf,kBAAkB,MAAM;EAC1B,CAAC;EACD,KAAK,SAAS,kBACZ,WACA,YAAY,KAAI,UAAS;GAAE,GAAG;GAAM,eAAe;EAAU,EAAE,CACjE;EACA,OAAO;CACT;CAEA,aAAoB,WAAiC;EACnD,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,gBAAgB,SAAS,KAAK;CACvC;CAEA,gBAAuB,WAAmB,SAAkC;EAC1E,OAAO,KAAK,SAAS,gBAAgB,WAAW,OAAO;CACzD;CAEA,WAAkB,WAAmB,SAAmC;EACtE,OAAO,KAAK,SAAS,YAAY,WAAW,OAAO;CACrD;CAEA,cAAqB,WAA2B;EAC9C,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,UACV;GACE,iBAAiB,KAAK;GACtB,OAAO,SAAS;GAChB,aAAa,SAAS;EACxB,GACA,MACA,CACF;CACF;CAEA,cAAqB,SAAgC;EACnD,MAAM,SAAS,KAAK,MAAM,OAAO;EAGjC,IAAI,CAAC,OAAO,MAAM,OAChB,OAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,EAAE;EAEnC,OAAO,KAAK,SAAS,OAAO,OAAO,OAAO,KAAK,eAAe;CAChE;CAEA,MAAa,qBACX,WACA,OAC4B;EAC5B,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,qBAAqB,SAAS,OAAO,KAAK;CACnE;CAEA,MAAa,sBACX,WACA,OAC4B;EAC5B,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,sBAAsB,SAAS,OAAO,KAAK;CACpE;CAEA,MAAa,wBACX,WACA,OAC4B;EAC5B,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,wBAAwB,SAAS,OAAO,MAAM,KAAK;CAC5E;CAEA,cAAqB,WAAsC;EACzD,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,gBAAgB,SAAS,MAAM,KAAK;CAC7C;CAEA,mBAA0B,WAAmB,OAAkD;EAC7F,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,mBAAmB,SAAS,OAAO,MAAM,YAAY,MAAM,OAAO;CAC3F;CAEA,qBAA4B,WAAmB,OAAoD;EACjG,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,qBAAqB,SAAS,OAAO,MAAM,aAAa;CACjF;CAEA,iBAAwB,WAA2C;EACjE,MAAM,WAAW,KAAK,SAAS,IAAI,SAAS;EAC5C,OAAO,KAAK,WAAW,iBAAiB,SAAS,KAAK;CACxD;AACF"}