@rsconcept/rstool 1.6.0 → 1.7.0

package/README.md

@@ -2,7 +2,7 @@
 
 Agent-facing library for **incremental RSForm construction**, **RSLang expression analysis**, **diagnostics**, **modeling**, and **evaluation**. It wraps [`@rsconcept/domain`](https://www.npmjs.com/package/@rsconcept/domain) with a deterministic session contract and a stdio JSON wrapper for LLM agents. MCP hosts can use it through [`@rsconcept/rstool-mcp`](https://www.npmjs.com/package/@rsconcept/rstool-mcp).
 
-**Contract version:** `3.1.0` — see [skills/rstool-helper/REFERENCE.md](./skills/rstool-helper/REFERENCE.md) for the full v3 API.
+**Contract version:** `3.2.0` — see [skills/rstool-helper/REFERENCE.md](./skills/rstool-helper/REFERENCE.md) for the full v3 API.
 
 ## Agent skill
 
@@ -77,7 +77,7 @@ Maintainers: see [PUBLISHING.md](./PUBLISHING.md) for npm release steps.
 - If a session method is called without an active session, rstool creates one lazily.
 - On startup, a ready handshake is printed.
 
-Supported methods (contract `3.1.0`):
+Supported methods (contract `3.2.0`):
 
 - `ping`
 - `methods`
@@ -98,6 +98,7 @@ Supported methods (contract `3.1.0`):
 - `evaluate`
 - `recalculateModel`
 - `restoreOrder`
+- `synthesize`
 
 Params are **flat** at the top level (no `params.input` wrapper). Optional `sessionId` sits alongside method fields.
 
@@ -112,7 +113,7 @@ Request:
 Response:
 
 ```json
-{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "3.1.0" } }
+{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "3.2.0" } }
 ```
 
 Example `applySchemaPatch`:
@@ -141,7 +142,7 @@ Response:
   "ok": true,
   "result": {
     "success": true,
-    "session": { "sessionId": "...", "contractVersion": "3.1.0" },
+    "session": { "sessionId": "...", "contractVersion": "3.2.0" },
     "summary": { "itemCount": 3 }
   }
 }

package/dist/{agent-workflow-BTwrxOoX.d.ts → agent-workflow-DY-hfAap.d.ts}

@@ -1,7 +1,7 @@
-import { a as Diagnostic } from "./diagnostic-C6TRoBgt.js";
+import { a as Diagnostic } from "./diagnostic-CODFUU-Q.js";
 import { n as CstType } from "./common-D6TFl6l_.js";
-import { a as ApplyConstituentsResult, i as ApplyConstituentsMode, o as ConstituentaDraft } from "./constituenta-QY5w1x91.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-CI4rLYby.js";
+import { a as ApplyConstituentsResult, i as ApplyConstituentsMode, o as ConstituentaDraft } from "./constituenta-HTnFtmxt.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-Uc_vHrq9.js";
 
 //#region src/models/agent-workflow.d.ts
 /** Level of detail returned by {@link RSToolAgent.getSessionState}. */
@@ -39,6 +39,51 @@ interface RestoreOrderResult {
   /** Aliases in the same order as {@link orderedIds}. */
   orderedAliases: string[];
 }
+/** One row of an identification (substitution) table, by alias. */
+interface SynthesisSubstitution {
+  /** Alias of the constituenta being replaced (deleted). */
+  original: string;
+  /** Alias of the surviving constituenta. */
+  substitution: string;
+}
+/** Input for {@link RSToolAgent.synthesize}. */
+interface SynthesizeInput {
+  /** Session whose constituents are merged into the receiver. */
+  sourceSessionId: string;
+  /**
+   * Optional subset of source aliases to import.
+   * Omit or pass an empty array to import all source constituents.
+   */
+  items?: string[];
+  /**
+   * Identification table: one endpoint is a source alias, the other a receiver alias
+   * (same rules as Portal schema embedding / «Встраивание схемы»).
+   */
+  substitutions?: SynthesisSubstitution[];
+  /** When set, a revision is recorded after a successful synthesis. */
+  commitMessage?: string;
+}
+/** Result of {@link RSToolAgent.synthesize}. */
+interface SynthesizeResult {
+  session: SessionHandle;
+  summary: SessionSummary;
+  /** False when some constituents failed re-analysis after embedding (best-effort). */
+  success: boolean;
+  /** Drafts that failed analysis after embedding; empty when {@link success} is true. */
+  failed: Array<{
+    draft: ConstituentaDraft;
+    diagnostics: Diagnostic[];
+  }>;
+  /** Source constituent id → inserted id in the receiver (before substitutions). */
+  idMap: Record<number, number>;
+  /** Alias remapping applied to imported constituents. */
+  aliasMapping: Record<string, string>;
+  /** Ids removed by substitutions. */
+  deletedIds: number[];
+  /** Ids of constituents inserted from the source (may include later-deleted ones). */
+  insertedIds: number[];
+  revision?: SessionRevision;
+}
 /** Compact view of one constituent in a session summary. */
 interface SessionSummaryItem {
   id: number;
@@ -67,5 +112,5 @@ interface ApplySchemaPatchResult extends ApplyConstituentsResult {
   revision?: SessionRevision;
 }
 //#endregion
-export { SessionStateDetail as a, SessionSummaryItem as c, RestoreOrderResult as i, ApplySchemaPatchInput as n, SessionStateResult as o, ApplySchemaPatchResult as r, SessionSummary as s, AgentConstituentaPatch as t };
-//# sourceMappingURL=agent-workflow-BTwrxOoX.d.ts.map
+export { SessionStateDetail as a, SessionSummaryItem as c, SynthesizeResult as d, RestoreOrderResult as i, SynthesisSubstitution as l, ApplySchemaPatchInput as n, SessionStateResult as o, ApplySchemaPatchResult as r, SessionSummary as s, AgentConstituentaPatch as t, SynthesizeInput as u };
+//# sourceMappingURL=agent-workflow-DY-hfAap.d.ts.map

package/dist/{analysis-DA44pfgA.d.ts → analysis-ktWFu4BY.d.ts}

@@ -1,4 +1,4 @@
-import { a as Diagnostic } from "./diagnostic-C6TRoBgt.js";
+import { a as Diagnostic } from "./diagnostic-CODFUU-Q.js";
 import { n as CstType, o as ValueClass } from "./common-D6TFl6l_.js";
 
 //#region src/models/analysis.d.ts
@@ -21,4 +21,4 @@ interface AnalysisResult {
 }
 //#endregion
 export { AnalyzeExpressionInput as n, AnalysisResult as t };
-//# sourceMappingURL=analysis-DA44pfgA.d.ts.map
+//# sourceMappingURL=analysis-ktWFu4BY.d.ts.map

package/dist/{constituenta-QY5w1x91.d.ts → constituenta-HTnFtmxt.d.ts}

@@ -1,6 +1,6 @@
-import { a as Diagnostic } from "./diagnostic-C6TRoBgt.js";
+import { a as Diagnostic } from "./diagnostic-CODFUU-Q.js";
 import { n as CstType } from "./common-D6TFl6l_.js";
-import { t as AnalysisResult } from "./analysis-DA44pfgA.js";
+import { t as AnalysisResult } from "./analysis-ktWFu4BY.js";
 
 //#region src/models/constituenta.d.ts
 /** Constituent payload before analysis and merge into session state. */
@@ -51,4 +51,4 @@ interface ApplyConstituentsResult {
 }
 //#endregion
 export { ApplyConstituentsResult as a, ApplyConstituentsMode as i, AddOrUpdateConstituentaResult as n, ConstituentaDraft as o, ApplyConstituentsInput as r, ConstituentaState as s, AddOrUpdateConstituentaInput as t };
-//# sourceMappingURL=constituenta-QY5w1x91.d.ts.map
+//# sourceMappingURL=constituenta-HTnFtmxt.d.ts.map

package/dist/{diagnostic-C6TRoBgt.d.ts → diagnostic-CODFUU-Q.d.ts}

@@ -1,6 +1,7 @@
-import { Constituenta, CstDiagnostic, CstDiagnostic as CstDiagnostic$1, DiagnosticKind, DiagnosticKind as DiagnosticKind$1, RSDiagnosticCode, RSDiagnosticCode as RSDiagnosticCode$1 } from "@rsconcept/domain/library";
+import { CstDiagnostic, CstDiagnostic as CstDiagnostic$1, DiagnosticKind, DiagnosticKind as DiagnosticKind$1, RSDiagnosticCode, RSDiagnosticCode as RSDiagnosticCode$1 } from "@rsconcept/domain/library";
 import { RSErrorDescription } from "@rsconcept/domain/rslang/error";
 import { EvalStatus } from "@rsconcept/domain/library/rsmodel";
+import { DiagnosticSourceFields } from "@rsconcept/domain/library/rsform-api";
 
 //#region src/mappers/diagnostic-assembly.d.ts
 /** Severity of a {@link Diagnostic}. */
@@ -22,9 +23,9 @@ interface DiagnosticTarget {
 }
 declare function getDiagnosticName(code: number): string;
 declare function getDiagnosticSeverity(code: number): DiagnosticSeverity;
-declare function expandCstDiagnostic(cst: Constituenta, diagnostic: CstDiagnostic): Diagnostic;
+declare function expandCstDiagnostic(cst: DiagnosticSourceFields, diagnostic: CstDiagnostic): Diagnostic;
 declare function expressionDiagnostic(error: RSErrorDescription, expression: string, target?: DiagnosticTarget): Diagnostic;
-declare function modelStatusDiagnostic(status: EvalStatus, cst: Constituenta): Diagnostic | null;
+declare function modelStatusDiagnostic(status: EvalStatus, cst: DiagnosticSourceFields): Diagnostic | null;
 //#endregion
 //#region src/models/diagnostic.d.ts
 /** Filters for {@link RSToolAgent.listDiagnostics}. */
@@ -35,4 +36,4 @@ interface ListDiagnosticsFilters {
 }
 //#endregion
 export { Diagnostic as a, expandCstDiagnostic as c, getDiagnosticSeverity as d, modelStatusDiagnostic as f, RSDiagnosticCode as i, expressionDiagnostic as l, DiagnosticKind as n, DiagnosticSeverity as o, ListDiagnosticsFilters as r, DiagnosticTarget as s, CstDiagnostic$1 as t, getDiagnosticName as u };
-//# sourceMappingURL=diagnostic-C6TRoBgt.d.ts.map
+//# sourceMappingURL=diagnostic-CODFUU-Q.d.ts.map

package/dist/diagnostic-assembly-B-6vIA5I.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostic-assembly-B-6vIA5I.js","names":[],"sources":["../src/mappers/diagnostic-assembly.ts"],"sourcesContent":["import {\n  type Constituenta,\n  type CstDiagnostic,\n  DiagnosticKind,\n  modelStatusCstDiagnostic,\n  RSDiagnosticCode\n} from '@rsconcept/domain/library';\nimport { EvalStatus } from '@rsconcept/domain/library/rsmodel';\nimport { isCritical, RSErrorCode, type RSErrorDescription } from '@rsconcept/domain/rslang/error';\n\nexport { DiagnosticKind, RSDiagnosticCode };\n\n/** Severity of a {@link Diagnostic}. */\nexport type DiagnosticSeverity = 'error' | 'warning';\n\n/** Agent-facing diagnostic with redundant fields for autonomous repair. */\nexport interface Diagnostic extends CstDiagnostic {\n  name: string;\n  severity: DiagnosticSeverity;\n  constituentId?: number;\n  alias?: string;\n  expression: string;\n  from: number;\n  to: number;\n}\n\n/** Context for attributing a {@link Diagnostic} to a constituent. */\nexport interface DiagnosticTarget {\n  constituentId?: number;\n  alias?: string;\n}\n\nconst DIAGNOSTIC_NAMES: ReadonlyMap<number, string> = new Map([\n  ...Object.entries(RSErrorCode).map(([name, code]) => [code, name] as const),\n  ...Object.entries(RSDiagnosticCode).map(([name, code]) => [code, name] as const)\n]);\n\nexport function getDiagnosticName(code: number): string {\n  return DIAGNOSTIC_NAMES.get(code) ?? `0x${code.toString(16).toUpperCase()}`;\n}\n\nexport function getDiagnosticSeverity(code: number): DiagnosticSeverity {\n  return isCritical(code as RSErrorCode) ? 'error' : 'warning';\n}\n\nexport function expandCstDiagnostic(cst: Constituenta, diagnostic: CstDiagnostic): Diagnostic {\n  const expression = expressionForCstDiagnostic(cst, diagnostic);\n  return {\n    ...diagnostic,\n    name: getDiagnosticName(diagnostic.code),\n    severity: getDiagnosticSeverity(diagnostic.code),\n    constituentId: cst.id,\n    alias: cst.alias,\n    expression,\n    from: 0,\n    to: diagnostic.kind === DiagnosticKind.MODEL ? 0 : Math.max(expression.length, 1)\n  };\n}\n\nexport function expressionDiagnostic(\n  error: RSErrorDescription,\n  expression: string,\n  target?: DiagnosticTarget\n): Diagnostic {\n  return {\n    kind: DiagnosticKind.EXPRESSION,\n    code: error.code,\n    name: getDiagnosticName(error.code),\n    severity: getDiagnosticSeverity(error.code),\n    constituentId: target?.constituentId,\n    alias: target?.alias,\n    expression,\n    from: error.from,\n    to: error.to,\n    ...(error.params ? { params: error.params } : {})\n  };\n}\n\nexport function modelStatusDiagnostic(status: EvalStatus, cst: Constituenta): Diagnostic | null {\n  const base = modelStatusCstDiagnostic(status, cst.cst_type);\n  return base ? expandCstDiagnostic(cst, base) : null;\n}\n\nfunction expressionForCstDiagnostic(cst: Constituenta, diagnostic: CstDiagnostic): string {\n  switch (diagnostic.code) {\n    case RSDiagnosticCode.schemaHomonym:\n    case RSDiagnosticCode.schemaMissingTerm:\n      return cst.term_resolved;\n    case RSDiagnosticCode.schemaMissingConvention:\n      return cst.convention;\n    case RSDiagnosticCode.schemaTypeMismatch:\n      return cst.typification_manual;\n    case RSDiagnosticCode.schemaDependencyCycle:\n    case RSDiagnosticCode.schemaFormalDuplicate:\n      return cst.definition_formal;\n    default:\n      return cst.definition_formal;\n  }\n}\n"],"mappings":";;;AAgCA,MAAM,mBAAgD,IAAI,IAAI,CAC5D,GAAG,OAAO,QAAQ,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC,MAAM,IAAI,CAAU,GAC1E,GAAG,OAAO,QAAQ,gBAAgB,CAAC,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC,MAAM,IAAI,CAAU,CACjF,CAAC;AAED,SAAgB,kBAAkB,MAAsB;CACtD,OAAO,iBAAiB,IAAI,IAAI,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC,CAAC,YAAY;AAC1E;AAEA,SAAgB,sBAAsB,MAAkC;CACtE,OAAO,WAAW,IAAmB,IAAI,UAAU;AACrD;AAEA,SAAgB,oBAAoB,KAAmB,YAAuC;CAC5F,MAAM,aAAa,2BAA2B,KAAK,UAAU;CAC7D,OAAO;EACL,GAAG;EACH,MAAM,kBAAkB,WAAW,IAAI;EACvC,UAAU,sBAAsB,WAAW,IAAI;EAC/C,eAAe,IAAI;EACnB,OAAO,IAAI;EACX;EACA,MAAM;EACN,IAAI,WAAW,SAAS,eAAe,QAAQ,IAAI,KAAK,IAAI,WAAW,QAAQ,CAAC;CAClF;AACF;AAEA,SAAgB,qBACd,OACA,YACA,QACY;CACZ,OAAO;EACL,MAAM,eAAe;EACrB,MAAM,MAAM;EACZ,MAAM,kBAAkB,MAAM,IAAI;EAClC,UAAU,sBAAsB,MAAM,IAAI;EAC1C,eAAe,QAAQ;EACvB,OAAO,QAAQ;EACf;EACA,MAAM,MAAM;EACZ,IAAI,MAAM;EACV,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;CACjD;AACF;AAEA,SAAgB,sBAAsB,QAAoB,KAAsC;CAC9F,MAAM,OAAO,yBAAyB,QAAQ,IAAI,QAAQ;CAC1D,OAAO,OAAO,oBAAoB,KAAK,IAAI,IAAI;AACjD;AAEA,SAAS,2BAA2B,KAAmB,YAAmC;CACxF,QAAQ,WAAW,MAAnB;EACE,KAAK,iBAAiB;EACtB,KAAK,iBAAiB,mBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB,yBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB,oBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB;EACtB,KAAK,iBAAiB,uBACpB,OAAO,IAAI;EACb,SACE,OAAO,IAAI;CACf;AACF"}
+{"version":3,"file":"diagnostic-assembly-B-6vIA5I.js","names":[],"sources":["../src/mappers/diagnostic-assembly.ts"],"sourcesContent":["import {\n  type CstDiagnostic,\n  DiagnosticKind,\n  modelStatusCstDiagnostic,\n  RSDiagnosticCode\n} from '@rsconcept/domain/library';\nimport { type DiagnosticSourceFields } from '@rsconcept/domain/library/rsform-api';\nimport { EvalStatus } from '@rsconcept/domain/library/rsmodel';\nimport { isCritical, RSErrorCode, type RSErrorDescription } from '@rsconcept/domain/rslang/error';\n\nexport { DiagnosticKind, RSDiagnosticCode };\n\n/** Severity of a {@link Diagnostic}. */\nexport type DiagnosticSeverity = 'error' | 'warning';\n\n/** Agent-facing diagnostic with redundant fields for autonomous repair. */\nexport interface Diagnostic extends CstDiagnostic {\n  name: string;\n  severity: DiagnosticSeverity;\n  constituentId?: number;\n  alias?: string;\n  expression: string;\n  from: number;\n  to: number;\n}\n\n/** Context for attributing a {@link Diagnostic} to a constituent. */\nexport interface DiagnosticTarget {\n  constituentId?: number;\n  alias?: string;\n}\n\nconst DIAGNOSTIC_NAMES: ReadonlyMap<number, string> = new Map([\n  ...Object.entries(RSErrorCode).map(([name, code]) => [code, name] as const),\n  ...Object.entries(RSDiagnosticCode).map(([name, code]) => [code, name] as const)\n]);\n\nexport function getDiagnosticName(code: number): string {\n  return DIAGNOSTIC_NAMES.get(code) ?? `0x${code.toString(16).toUpperCase()}`;\n}\n\nexport function getDiagnosticSeverity(code: number): DiagnosticSeverity {\n  return isCritical(code as RSErrorCode) ? 'error' : 'warning';\n}\n\nexport function expandCstDiagnostic(cst: DiagnosticSourceFields, diagnostic: CstDiagnostic): Diagnostic {\n  const expression = expressionForCstDiagnostic(cst, diagnostic);\n  return {\n    ...diagnostic,\n    name: getDiagnosticName(diagnostic.code),\n    severity: getDiagnosticSeverity(diagnostic.code),\n    constituentId: cst.id,\n    alias: cst.alias,\n    expression,\n    from: 0,\n    to: diagnostic.kind === DiagnosticKind.MODEL ? 0 : Math.max(expression.length, 1)\n  };\n}\n\nexport function expressionDiagnostic(\n  error: RSErrorDescription,\n  expression: string,\n  target?: DiagnosticTarget\n): Diagnostic {\n  return {\n    kind: DiagnosticKind.EXPRESSION,\n    code: error.code,\n    name: getDiagnosticName(error.code),\n    severity: getDiagnosticSeverity(error.code),\n    constituentId: target?.constituentId,\n    alias: target?.alias,\n    expression,\n    from: error.from,\n    to: error.to,\n    ...(error.params ? { params: error.params } : {})\n  };\n}\n\nexport function modelStatusDiagnostic(status: EvalStatus, cst: DiagnosticSourceFields): Diagnostic | null {\n  const base = modelStatusCstDiagnostic(status, cst.cst_type);\n  return base ? expandCstDiagnostic(cst, base) : null;\n}\n\nfunction expressionForCstDiagnostic(cst: DiagnosticSourceFields, diagnostic: CstDiagnostic): string {\n  switch (diagnostic.code) {\n    case RSDiagnosticCode.schemaHomonym:\n    case RSDiagnosticCode.schemaMissingTerm:\n      return cst.term_resolved;\n    case RSDiagnosticCode.schemaMissingConvention:\n      return cst.convention;\n    case RSDiagnosticCode.schemaTypeMismatch:\n      return cst.typification_manual;\n    case RSDiagnosticCode.schemaDependencyCycle:\n    case RSDiagnosticCode.schemaFormalDuplicate:\n      return cst.definition_formal;\n    default:\n      return cst.definition_formal;\n  }\n}\n"],"mappings":";;;AAgCA,MAAM,mBAAgD,IAAI,IAAI,CAC5D,GAAG,OAAO,QAAQ,WAAW,CAAC,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC,MAAM,IAAI,CAAU,GAC1E,GAAG,OAAO,QAAQ,gBAAgB,CAAC,CAAC,KAAK,CAAC,MAAM,UAAU,CAAC,MAAM,IAAI,CAAU,CACjF,CAAC;AAED,SAAgB,kBAAkB,MAAsB;CACtD,OAAO,iBAAiB,IAAI,IAAI,KAAK,KAAK,KAAK,SAAS,EAAE,CAAC,CAAC,YAAY;AAC1E;AAEA,SAAgB,sBAAsB,MAAkC;CACtE,OAAO,WAAW,IAAmB,IAAI,UAAU;AACrD;AAEA,SAAgB,oBAAoB,KAA6B,YAAuC;CACtG,MAAM,aAAa,2BAA2B,KAAK,UAAU;CAC7D,OAAO;EACL,GAAG;EACH,MAAM,kBAAkB,WAAW,IAAI;EACvC,UAAU,sBAAsB,WAAW,IAAI;EAC/C,eAAe,IAAI;EACnB,OAAO,IAAI;EACX;EACA,MAAM;EACN,IAAI,WAAW,SAAS,eAAe,QAAQ,IAAI,KAAK,IAAI,WAAW,QAAQ,CAAC;CAClF;AACF;AAEA,SAAgB,qBACd,OACA,YACA,QACY;CACZ,OAAO;EACL,MAAM,eAAe;EACrB,MAAM,MAAM;EACZ,MAAM,kBAAkB,MAAM,IAAI;EAClC,UAAU,sBAAsB,MAAM,IAAI;EAC1C,eAAe,QAAQ;EACvB,OAAO,QAAQ;EACf;EACA,MAAM,MAAM;EACZ,IAAI,MAAM;EACV,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,OAAO,IAAI,CAAC;CACjD;AACF;AAEA,SAAgB,sBAAsB,QAAoB,KAAgD;CACxG,MAAM,OAAO,yBAAyB,QAAQ,IAAI,QAAQ;CAC1D,OAAO,OAAO,oBAAoB,KAAK,IAAI,IAAI;AACjD;AAEA,SAAS,2BAA2B,KAA6B,YAAmC;CAClG,QAAQ,WAAW,MAAnB;EACE,KAAK,iBAAiB;EACtB,KAAK,iBAAiB,mBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB,yBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB,oBACpB,OAAO,IAAI;EACb,KAAK,iBAAiB;EACtB,KAAK,iBAAiB,uBACpB,OAAO,IAAI;EACb,SACE,OAAO,IAAI;CACf;AACF"}

package/dist/{evaluation-Cd4S7-3t.d.ts → evaluation-6A7rK4t7.d.ts}

@@ -1,4 +1,4 @@
-import { a as Diagnostic } from "./diagnostic-C6TRoBgt.js";
+import { a as Diagnostic } from "./diagnostic-CODFUU-Q.js";
 import { a as RSToolValue, n as CstType, r as EvalStatus, t as BasicBinding } from "./common-D6TFl6l_.js";
 
 //#region src/models/evaluation.d.ts
@@ -29,4 +29,4 @@ interface EvaluationResult {
 }
 //#endregion
 export { EvaluationResult as i, EvaluateExpressionInput as n, EvaluateInput as r, EvaluateConstituentaInput as t };
-//# sourceMappingURL=evaluation-Cd4S7-3t.d.ts.map
+//# sourceMappingURL=evaluation-6A7rK4t7.d.ts.map

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { a as Diagnostic, i as RSDiagnosticCode, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, t as CstDiagnostic } from "./diagnostic-C6TRoBgt.js";
+import { a as Diagnostic, i as RSDiagnosticCode, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, t as CstDiagnostic } from "./diagnostic-CODFUU-Q.js";
 import { a as RSToolValue, i as RSErrorCode, n as CstType, o as ValueClass, r as EvalStatus, t as BasicBinding } from "./common-D6TFl6l_.js";
-import { n as AnalyzeExpressionInput, t as AnalysisResult } from "./analysis-DA44pfgA.js";
-import { o as ConstituentaDraft, s as ConstituentaState } from "./constituenta-QY5w1x91.js";
+import { n as AnalyzeExpressionInput, t as AnalysisResult } from "./analysis-ktWFu4BY.js";
+import { o as ConstituentaDraft, s as ConstituentaState } from "./constituenta-HTnFtmxt.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, r as RecalculateModelResult, s as SetModelValuesInput } from "./model-value-BUhr2IjA.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-CI4rLYby.js";
-import { a as SessionStateDetail, c as SessionSummaryItem, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch } from "./agent-workflow-BTwrxOoX.js";
-import { i as EvaluationResult, r as EvaluateInput } from "./evaluation-Cd4S7-3t.js";
-import { a as ExportPortalInput, c as PortalExportKind, d as PortalModelImportData, f as PortalRsformDetails, h as PortalTermForm, i as ExportFormat, l as PORTAL_JSON_CONTRACT_VERSION, m as PortalSchemaImportData, n as RSToolAgentContract, o as ExportPortalResult, p as PortalSchemaConstituenta, r as RSToolAgentOptions, s as ImportDataKind, t as CONTRACT_VERSION, u as PortalImportMetadata } from "./tool-contract-BUaDRHoO.js";
-import { t as RSToolAgent } from "./rstool-agent-BrAFJcoE.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-Uc_vHrq9.js";
+import { a as SessionStateDetail, c as SessionSummaryItem, d as SynthesizeResult, l as SynthesisSubstitution, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch, u as SynthesizeInput } from "./agent-workflow-DY-hfAap.js";
+import { i as EvaluationResult, r as EvaluateInput } from "./evaluation-6A7rK4t7.js";
+import { a as ExportPortalInput, c as PortalExportKind, d as PortalModelImportData, f as PortalRsformDetails, h as PortalTermForm, i as ExportFormat, l as PORTAL_JSON_CONTRACT_VERSION, m as PortalSchemaImportData, n as RSToolAgentContract, o as ExportPortalResult, p as PortalSchemaConstituenta, r as RSToolAgentOptions, s as ImportDataKind, t as CONTRACT_VERSION, u as PortalImportMetadata } from "./tool-contract-i0v2gbWs.js";
+import { t as RSToolAgent } from "./rstool-agent-D-w4DlEo.js";
 import { DomainAnalysisLike, DomainErrorLike, toDiagnostic, toPublicAnalysis } from "./mappers/types.js";
 import { RSToolWrapperClient, RSToolWrapperClientOptions, WrapperResponse } from "./wrapper/client.js";
-export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, type CstDiagnostic, CstType, type Diagnostic, DiagnosticKind, type DiagnosticSeverity, type DomainAnalysisLike, type DomainErrorLike, EvalStatus, type EvaluateInput, type EvaluationResult, type ExportFormat, type ExportPortalInput, type ExportPortalResult, type ImportDataKind, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalExportKind, type PortalImportMetadata, type PortalModelImportData, type PortalRsformDetails, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSDiagnosticCode, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolValue, RSToolWrapperClient, type RSToolWrapperClientOptions, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SessionStateDetail, type SessionStateResult, type SessionSummary, type SessionSummaryItem, type SetConstituentaValueInput, type SetModelValuesInput, ValueClass, type WrapperResponse, toDiagnostic, toPublicAnalysis };
+export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, type CstDiagnostic, CstType, type Diagnostic, DiagnosticKind, type DiagnosticSeverity, type DomainAnalysisLike, type DomainErrorLike, EvalStatus, type EvaluateInput, type EvaluationResult, type ExportFormat, type ExportPortalInput, type ExportPortalResult, type ImportDataKind, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalExportKind, type PortalImportMetadata, type PortalModelImportData, type PortalRsformDetails, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSDiagnosticCode, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolValue, RSToolWrapperClient, type RSToolWrapperClientOptions, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SessionStateDetail, type SessionStateResult, type SessionSummary, type SessionSummaryItem, type SetConstituentaValueInput, type SetModelValuesInput, type SynthesisSubstitution, type SynthesizeInput, type SynthesizeResult, ValueClass, type WrapperResponse, toDiagnostic, toPublicAnalysis };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { toDiagnostic, toPublicAnalysis } from "./mappers/types.js";
 import { CstType, EvalStatus, RSErrorCode, ValueClass } from "./models/common.js";
 import { DiagnosticKind, RSDiagnosticCode } from "./models/diagnostic.js";
-import { r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "./models-LMyDB0md.js";
+import { r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "./models-BKmWx92e.js";
 import { CONTRACT_VERSION } from "./models/tool-contract.js";
 import { RSToolWrapperClient } from "./wrapper/client.js";
 export { CONTRACT_VERSION, CstType, DiagnosticKind, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSDiagnosticCode, RSErrorCode, RSToolAgent, RSToolWrapperClient, ValueClass, toDiagnostic, toPublicAnalysis };

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

@@ -1,6 +1,6 @@
 import { a as SetConstituentaValueInput, i as SessionModelState, r as RecalculateModelResult } from "../model-value-BUhr2IjA.js";
-import { r as SessionState } from "../session-CI4rLYby.js";
-import { i as EvaluationResult } from "../evaluation-Cd4S7-3t.js";
+import { r as SessionState } from "../session-Uc_vHrq9.js";
+import { i as EvaluationResult } from "../evaluation-6A7rK4t7.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 { a as Diagnostic } from "../diagnostic-C6TRoBgt.js";
-import { t as AnalysisResult } from "../analysis-DA44pfgA.js";
-import { o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-QY5w1x91.js";
-import { r as SessionState } from "../session-CI4rLYby.js";
+import { a as Diagnostic } from "../diagnostic-CODFUU-Q.js";
+import { t as AnalysisResult } from "../analysis-ktWFu4BY.js";
+import { o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-HTnFtmxt.js";
+import { r as SessionState } from "../session-Uc_vHrq9.js";
 import { RSForm } from "@rsconcept/domain/library/rsform";
 import { RSLangAnalyzer } from "@rsconcept/domain/rslang";
 

package/dist/mappers/types.d.ts

@@ -1,5 +1,5 @@
-import { a as Diagnostic, s as DiagnosticTarget } from "../diagnostic-C6TRoBgt.js";
-import { t as AnalysisResult } from "../analysis-DA44pfgA.js";
+import { a as Diagnostic, s as DiagnosticTarget } from "../diagnostic-CODFUU-Q.js";
+import { t as AnalysisResult } from "../analysis-ktWFu4BY.js";
 import { ValueClass } from "@rsconcept/domain/rslang";
 
 //#region src/mappers/types.d.ts

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

@@ -1,2 +1,2 @@
-import { a as SessionStateDetail, c as SessionSummaryItem, i as RestoreOrderResult, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch } from "../agent-workflow-BTwrxOoX.js";
-export { AgentConstituentaPatch, ApplySchemaPatchInput, ApplySchemaPatchResult, RestoreOrderResult, SessionStateDetail, SessionStateResult, SessionSummary, SessionSummaryItem };
+import { a as SessionStateDetail, c as SessionSummaryItem, d as SynthesizeResult, i as RestoreOrderResult, l as SynthesisSubstitution, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch, u as SynthesizeInput } from "../agent-workflow-DY-hfAap.js";
+export { AgentConstituentaPatch, ApplySchemaPatchInput, ApplySchemaPatchResult, RestoreOrderResult, SessionStateDetail, SessionStateResult, SessionSummary, SessionSummaryItem, SynthesisSubstitution, SynthesizeInput, SynthesizeResult };

package/dist/models/analysis.d.ts

@@ -1,2 +1,2 @@
-import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-DA44pfgA.js";
+import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-ktWFu4BY.js";
 export { AnalysisResult, AnalyzeExpressionInput };

package/dist/models/constituenta.d.ts

@@ -1,2 +1,2 @@
-import { a as ApplyConstituentsResult, i as ApplyConstituentsMode, n as AddOrUpdateConstituentaResult, o as ConstituentaDraft, r as ApplyConstituentsInput, s as ConstituentaState, t as AddOrUpdateConstituentaInput } from "../constituenta-QY5w1x91.js";
+import { a as ApplyConstituentsResult, i as ApplyConstituentsMode, n as AddOrUpdateConstituentaResult, o as ConstituentaDraft, r as ApplyConstituentsInput, s as ConstituentaState, t as AddOrUpdateConstituentaInput } from "../constituenta-HTnFtmxt.js";
 export { AddOrUpdateConstituentaInput, AddOrUpdateConstituentaResult, ApplyConstituentsInput, ApplyConstituentsMode, ApplyConstituentsResult, ConstituentaDraft, ConstituentaState };

package/dist/models/diagnostic.d.ts

@@ -1,2 +1,2 @@
-import { a as Diagnostic, c as expandCstDiagnostic, d as getDiagnosticSeverity, f as modelStatusDiagnostic, i as RSDiagnosticCode, l as expressionDiagnostic, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, s as DiagnosticTarget, t as CstDiagnostic, u as getDiagnosticName } from "../diagnostic-C6TRoBgt.js";
+import { a as Diagnostic, c as expandCstDiagnostic, d as getDiagnosticSeverity, f as modelStatusDiagnostic, i as RSDiagnosticCode, l as expressionDiagnostic, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, s as DiagnosticTarget, t as CstDiagnostic, u as getDiagnosticName } from "../diagnostic-CODFUU-Q.js";
 export { type CstDiagnostic, type Diagnostic, DiagnosticKind, type DiagnosticSeverity, type DiagnosticTarget, ListDiagnosticsFilters, RSDiagnosticCode, expandCstDiagnostic, expressionDiagnostic, getDiagnosticName, getDiagnosticSeverity, modelStatusDiagnostic };

package/dist/models/evaluation.d.ts

@@ -1,2 +1,2 @@
-import { i as EvaluationResult, n as EvaluateExpressionInput, r as EvaluateInput, t as EvaluateConstituentaInput } from "../evaluation-Cd4S7-3t.js";
+import { i as EvaluationResult, n as EvaluateExpressionInput, r as EvaluateInput, t as EvaluateConstituentaInput } from "../evaluation-6A7rK4t7.js";
 export { EvaluateConstituentaInput, EvaluateExpressionInput, EvaluateInput, EvaluationResult };

package/dist/models/index.d.ts

@@ -1,11 +1,11 @@
-import { a as Diagnostic, i as RSDiagnosticCode, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, t as CstDiagnostic } from "../diagnostic-C6TRoBgt.js";
+import { a as Diagnostic, i as RSDiagnosticCode, n as DiagnosticKind, o as DiagnosticSeverity, r as ListDiagnosticsFilters, t as CstDiagnostic } from "../diagnostic-CODFUU-Q.js";
 import { a as RSToolValue, i as RSErrorCode, n as CstType, o as ValueClass, r as EvalStatus, t as BasicBinding } from "../common-D6TFl6l_.js";
-import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-DA44pfgA.js";
-import { i as ApplyConstituentsMode, o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-QY5w1x91.js";
+import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-ktWFu4BY.js";
+import { i as ApplyConstituentsMode, o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-HTnFtmxt.js";
 import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, r as RecalculateModelResult, s as SetModelValuesInput } from "../model-value-BUhr2IjA.js";
-import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-CI4rLYby.js";
-import { a as SessionStateDetail, c as SessionSummaryItem, i as RestoreOrderResult, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch } from "../agent-workflow-BTwrxOoX.js";
-import { i as EvaluationResult, r as EvaluateInput } from "../evaluation-Cd4S7-3t.js";
-import { a as ExportPortalInput, c as PortalExportKind, d as PortalModelImportData, f as PortalRsformDetails, g as portalItemToDraft, h as PortalTermForm, i as ExportFormat, l as PORTAL_JSON_CONTRACT_VERSION, m as PortalSchemaImportData, n as RSToolAgentContract, o as ExportPortalResult, p as PortalSchemaConstituenta, r as RSToolAgentOptions, s as ImportDataKind, t as CONTRACT_VERSION, u as PortalImportMetadata } from "../tool-contract-BUaDRHoO.js";
-import { t as RSToolAgent } from "../rstool-agent-BrAFJcoE.js";
-export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplyConstituentsMode, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, type CstDiagnostic, CstType, type Diagnostic, DiagnosticKind, type DiagnosticSeverity, EvalStatus, type EvaluateInput, type EvaluationResult, type ExportFormat, type ExportPortalInput, type ExportPortalResult, type ImportDataKind, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalExportKind, type PortalImportMetadata, type PortalModelImportData, type PortalRsformDetails, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSDiagnosticCode, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolValue, type RecalculateModelResult, type RestoreOrderResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SessionStateDetail, type SessionStateResult, type SessionSummary, type SessionSummaryItem, type SetConstituentaValueInput, type SetModelValuesInput, ValueClass, portalItemToDraft };
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-Uc_vHrq9.js";
+import { a as SessionStateDetail, c as SessionSummaryItem, d as SynthesizeResult, i as RestoreOrderResult, l as SynthesisSubstitution, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult, s as SessionSummary, t as AgentConstituentaPatch, u as SynthesizeInput } from "../agent-workflow-DY-hfAap.js";
+import { i as EvaluationResult, r as EvaluateInput } from "../evaluation-6A7rK4t7.js";
+import { a as ExportPortalInput, c as PortalExportKind, d as PortalModelImportData, f as PortalRsformDetails, g as portalItemToDraft, h as PortalTermForm, i as ExportFormat, l as PORTAL_JSON_CONTRACT_VERSION, m as PortalSchemaImportData, n as RSToolAgentContract, o as ExportPortalResult, p as PortalSchemaConstituenta, r as RSToolAgentOptions, s as ImportDataKind, t as CONTRACT_VERSION, u as PortalImportMetadata } from "../tool-contract-i0v2gbWs.js";
+import { t as RSToolAgent } from "../rstool-agent-D-w4DlEo.js";
+export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplyConstituentsMode, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, type CstDiagnostic, CstType, type Diagnostic, DiagnosticKind, type DiagnosticSeverity, EvalStatus, type EvaluateInput, type EvaluationResult, type ExportFormat, type ExportPortalInput, type ExportPortalResult, type ImportDataKind, type ListDiagnosticsFilters, type ModelValueState, PORTAL_JSON_CONTRACT_VERSION, type PortalExportKind, type PortalImportMetadata, type PortalModelImportData, type PortalRsformDetails, type PortalSchemaConstituenta, type PortalSchemaImportData, type PortalTermForm, RSDiagnosticCode, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolValue, type RecalculateModelResult, type RestoreOrderResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SessionStateDetail, type SessionStateResult, type SessionSummary, type SessionSummaryItem, type SetConstituentaValueInput, type SetModelValuesInput, type SynthesisSubstitution, type SynthesizeInput, type SynthesizeResult, ValueClass, portalItemToDraft };

package/dist/models/index.js

@@ -1,5 +1,5 @@
 import { CstType, EvalStatus, RSErrorCode, ValueClass } from "./common.js";
 import { DiagnosticKind, RSDiagnosticCode } from "./diagnostic.js";
-import { i as portalItemToDraft, r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "../models-LMyDB0md.js";
+import { i as portalItemToDraft, r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "../models-BKmWx92e.js";
 import { CONTRACT_VERSION } from "./tool-contract.js";
 export { CONTRACT_VERSION, CstType, DiagnosticKind, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSDiagnosticCode, RSErrorCode, RSToolAgent, ValueClass, portalItemToDraft };

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

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

package/dist/models/rstool-agent.js

@@ -1,2 +1,2 @@
-import { t as RSToolAgent } from "../models-LMyDB0md.js";
+import { t as RSToolAgent } from "../models-BKmWx92e.js";
 export { RSToolAgent };

package/dist/models/session.d.ts

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

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

@@ -1,2 +1,2 @@
-import { n as RSToolAgentContract, r as RSToolAgentOptions, t as CONTRACT_VERSION } from "../tool-contract-BUaDRHoO.js";
+import { n as RSToolAgentContract, r as RSToolAgentOptions, t as CONTRACT_VERSION } from "../tool-contract-i0v2gbWs.js";
 export { CONTRACT_VERSION, RSToolAgentContract, RSToolAgentOptions };

package/dist/models/tool-contract.js

@@ -1,6 +1,6 @@
 //#region src/models/tool-contract.ts
 /** Agent-visible contract version; bump on breaking API changes. */
-const CONTRACT_VERSION = "3.1.0";
+const CONTRACT_VERSION = "3.2.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 {\n  type ApplySchemaPatchInput,\n  type ApplySchemaPatchResult,\n  type RestoreOrderResult,\n  type SessionStateDetail,\n  type SessionStateResult\n} from './agent-workflow';\nimport { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport { type Diagnostic, type ListDiagnosticsFilters } from './diagnostic';\nimport { type EvaluateInput, type EvaluationResult } from './evaluation';\nimport { type ExportPortalInput, type ExportPortalResult, type ImportDataKind } from './import-export';\nimport { type RecalculateModelResult, type SessionModelState, type SetModelValuesInput } from './model-value';\nimport { type SessionHandle, type SessionRevision, type SessionState } from './session';\n\n/** Agent-visible contract version; bump on breaking API changes. */\nexport const CONTRACT_VERSION = '3.1.0';\n\n/** Options for constructing an {@link RSToolAgent}. */\nexport interface RSToolAgentOptions {\n  /** When set, sessions are persisted to this directory and survive process restarts. */\n  persistenceDir?: string;\n}\n\n/**\n * Public method surface of {@link RSToolAgent}.\n *\n * Each method accepts an optional `sessionId`; when omitted, the current session is used\n * (or a new one is created where noted).\n */\nexport interface RSToolAgentContract {\n  /** Current contract version string (same as {@link CONTRACT_VERSION}). */\n  readonly contractVersion: string;\n\n  /** Return the current session, or create one with optional `initial` metadata. */\n  ensureSession(initial?: Partial<SessionState>): SessionHandle;\n\n  /** Create a new session and make it current. */\n  createSession(initial?: Partial<SessionState>): SessionHandle;\n\n  /** Return the current session handle, or `null` when none is active. */\n  getCurrentSession(): SessionHandle | null;\n\n  /** Switch the active session; throws when `sessionId` is unknown. */\n  setCurrentSession(sessionId: string): SessionHandle;\n\n  /** Apply constituent patches to the schema (analyze, merge, optionally commit). */\n  applySchemaPatch(input: ApplySchemaPatchInput, sessionId?: string): ApplySchemaPatchResult;\n\n  /** Return session summary (default) or full cloned state when `detail` is `'full'`. */\n  getSessionState(detail?: SessionStateDetail, sessionId?: string): SessionStateResult;\n\n  /** List diagnostics for the session, optionally filtered by constituent or kind. */\n  listDiagnostics(filters?: ListDiagnosticsFilters, sessionId?: string): Diagnostic[];\n\n  /** Parse and type-check an RSLang expression against the current schema context. */\n  analyzeExpression(input: AnalyzeExpressionInput, sessionId?: string): AnalysisResult;\n\n  /** Record a revision checkpoint with an optional message. */\n  commitStep(message?: string, sessionId?: string): SessionRevision;\n\n  /** Export the session as a JSON string (state + diagnostics). */\n  exportSession(sessionId?: string): string;\n\n  /** Export schema or model payload in Portal JSON format. */\n  exportPortal(input: ExportPortalInput, sessionId?: string): ExportPortalResult;\n\n  /**\n   * Import a session export or Portal JSON payload and make the new session current.\n   *\n   * When `kind` is `'auto'`, the payload shape is detected automatically.\n   */\n  importData(payload: string | object, kind?: ImportDataKind): SessionHandle;\n\n  /** Set or clear model values for constituents; returns the updated model state. */\n  setModelValues(input: SetModelValuesInput, sessionId?: string): Promise<SessionModelState>;\n\n  /** Return a deep clone of the session model state. */\n  getModelState(sessionId?: string): SessionModelState;\n\n  /**\n   * Evaluate a stored constituent or a scratch expression.\n   *\n   * Provide `constituentId`, or both `expression` and `cstType`.\n   */\n  evaluate(input: EvaluateInput, sessionId?: string): EvaluationResult;\n\n  /** Recompute derived model values for all constituents. */\n  recalculateModel(sessionId?: string): RecalculateModelResult;\n\n  /**\n   * Restore declaration order: formal topology, semantic clusters when ready,\n   * otherwise stable against type/kernel preferred ranks.\n   */\n  restoreOrder(sessionId?: string): RestoreOrderResult;\n}\n"],"mappings":";;AAeA,MAAa,mBAAmB"}
+{"version":3,"file":"tool-contract.js","names":[],"sources":["../../src/models/tool-contract.ts"],"sourcesContent":["import {\n  type ApplySchemaPatchInput,\n  type ApplySchemaPatchResult,\n  type RestoreOrderResult,\n  type SessionStateDetail,\n  type SessionStateResult,\n  type SynthesizeInput,\n  type SynthesizeResult\n} from './agent-workflow';\nimport { type AnalysisResult, type AnalyzeExpressionInput } from './analysis';\nimport { type Diagnostic, type ListDiagnosticsFilters } from './diagnostic';\nimport { type EvaluateInput, type EvaluationResult } from './evaluation';\nimport { type ExportPortalInput, type ExportPortalResult, type ImportDataKind } from './import-export';\nimport { type RecalculateModelResult, type SessionModelState, type SetModelValuesInput } from './model-value';\nimport { type SessionHandle, type SessionRevision, type SessionState } from './session';\n\n/** Agent-visible contract version; bump on breaking API changes. */\nexport const CONTRACT_VERSION = '3.2.0';\n\n/** Options for constructing an {@link RSToolAgent}. */\nexport interface RSToolAgentOptions {\n  /** When set, sessions are persisted to this directory and survive process restarts. */\n  persistenceDir?: string;\n}\n\n/**\n * Public method surface of {@link RSToolAgent}.\n *\n * Each method accepts an optional `sessionId`; when omitted, the current session is used\n * (or a new one is created where noted).\n */\nexport interface RSToolAgentContract {\n  /** Current contract version string (same as {@link CONTRACT_VERSION}). */\n  readonly contractVersion: string;\n\n  /** Return the current session, or create one with optional `initial` metadata. */\n  ensureSession(initial?: Partial<SessionState>): SessionHandle;\n\n  /** Create a new session and make it current. */\n  createSession(initial?: Partial<SessionState>): SessionHandle;\n\n  /** Return the current session handle, or `null` when none is active. */\n  getCurrentSession(): SessionHandle | null;\n\n  /** Switch the active session; throws when `sessionId` is unknown. */\n  setCurrentSession(sessionId: string): SessionHandle;\n\n  /** Apply constituent patches to the schema (analyze, merge, optionally commit). */\n  applySchemaPatch(input: ApplySchemaPatchInput, sessionId?: string): ApplySchemaPatchResult;\n\n  /** Return session summary (default) or full cloned state when `detail` is `'full'`. */\n  getSessionState(detail?: SessionStateDetail, sessionId?: string): SessionStateResult;\n\n  /** List diagnostics for the session, optionally filtered by constituent or kind. */\n  listDiagnostics(filters?: ListDiagnosticsFilters, sessionId?: string): Diagnostic[];\n\n  /** Parse and type-check an RSLang expression against the current schema context. */\n  analyzeExpression(input: AnalyzeExpressionInput, sessionId?: string): AnalysisResult;\n\n  /** Record a revision checkpoint with an optional message. */\n  commitStep(message?: string, sessionId?: string): SessionRevision;\n\n  /** Export the session as a JSON string (state + diagnostics). */\n  exportSession(sessionId?: string): string;\n\n  /** Export schema or model payload in Portal JSON format. */\n  exportPortal(input: ExportPortalInput, sessionId?: string): ExportPortalResult;\n\n  /**\n   * Import a session export or Portal JSON payload and make the new session current.\n   *\n   * When `kind` is `'auto'`, the payload shape is detected automatically.\n   */\n  importData(payload: string | object, kind?: ImportDataKind): SessionHandle;\n\n  /** Set or clear model values for constituents; returns the updated model state. */\n  setModelValues(input: SetModelValuesInput, sessionId?: string): Promise<SessionModelState>;\n\n  /** Return a deep clone of the session model state. */\n  getModelState(sessionId?: string): SessionModelState;\n\n  /**\n   * Evaluate a stored constituent or a scratch expression.\n   *\n   * Provide `constituentId`, or both `expression` and `cstType`.\n   */\n  evaluate(input: EvaluateInput, sessionId?: string): EvaluationResult;\n\n  /** Recompute derived model values for all constituents. */\n  recalculateModel(sessionId?: string): RecalculateModelResult;\n\n  /**\n   * Restore declaration order: formal topology, semantic clusters when ready,\n   * otherwise stable against type/kernel preferred ranks.\n   */\n  restoreOrder(sessionId?: string): RestoreOrderResult;\n\n  /**\n   * Synthesis by embedding: merge constituents from another session into the receiver,\n   * then apply an identification table.\n   */\n  synthesize(input: SynthesizeInput, sessionId?: string): SynthesizeResult;\n}\n"],"mappings":";;AAiBA,MAAa,mBAAmB"}

package/dist/{models-LMyDB0md.js → models-BKmWx92e.js}

@@ -6,7 +6,7 @@ import { n as enrichSessionConstituents } from "./rsform-builder-DKwZfJvN.js";
 import { ModelAdapter } from "./mappers/model-adapter.js";
 import { SchemaAdapter } from "./mappers/schema-adapter.js";
 import { CONTRACT_VERSION } from "./models/tool-contract.js";
-import { restoreConstituentOrder } from "@rsconcept/domain/library/rsform-api";
+import { inlineSynthesis, restoreConstituentOrder } from "@rsconcept/domain/library/rsform-api";
 import { isModelIssue } from "@rsconcept/domain/library/rsmodel-api";
 import { Graph } from "@rsconcept/domain/graph/graph";
 import { extractGlobals } from "@rsconcept/domain/rslang/api";
@@ -219,7 +219,7 @@ var SessionStore = class {
 		this.persist(sessionId, envelope);
 		return {
 			sessionId,
-			contractVersion: contractVersion ?? "3.1.0"
+			contractVersion: contractVersion ?? "3.2.0"
 		};
 	}
 	get(sessionId) {
@@ -563,6 +563,104 @@ var RSToolAgent = class {
 			orderedAliases: ordered.map((item) => item.alias)
 		};
 	}
+	/** @inheritdoc */
+	synthesize(input, sessionId) {
+		const receiverHandle = sessionId ? {
+			sessionId: this.resolveSessionId(sessionId),
+			contractVersion: this.contractVersion
+		} : this.ensureSession();
+		const receiverId = receiverHandle.sessionId;
+		const sourceId = this.resolveSessionId(input.sourceSessionId);
+		if (sourceId === receiverId) throw new Error("synthesize: sourceSessionId must differ from the receiver session");
+		const receiverEnvelope = this.sessions.get(receiverId);
+		const sourceEnvelope = this.sessions.get(sourceId);
+		const snapshot = this.sessions.snapshot(receiverId);
+		try {
+			const sourceItems = this.selectSourceItems(sourceEnvelope.state.items, input.items);
+			const substitutions = this.resolveSynthesisSubstitutions(receiverEnvelope.state.items, sourceItems, input.substitutions ?? []);
+			const nextId = receiverEnvelope.state.items.reduce((max, item) => Math.max(max, item.id), 0) + 1;
+			const result = inlineSynthesis({
+				receiverItems: receiverEnvelope.state.items.map(toSynthesizableSessionItem),
+				sourceItems: sourceItems.map(toSynthesizableSessionItem),
+				substitutions,
+				nextId
+			});
+			const drafts = result.items.map((item) => ({
+				id: item.id,
+				alias: item.alias,
+				cstType: item.cst_type,
+				definitionFormal: item.definition_formal,
+				term: item.term_resolved || item.term_raw,
+				definitionText: item.definition_resolved || item.definition_raw,
+				convention: item.convention
+			}));
+			receiverEnvelope.state.items = [];
+			receiverEnvelope.state.model = { items: receiverEnvelope.state.model.items.filter((value) => !result.deletedIds.has(value.id)) };
+			this.sessions.replaceState(receiverId, receiverEnvelope.state);
+			const applied = this.applyConstituents({
+				drafts,
+				mode: "best_effort"
+			}, receiverId);
+			const revision = input.commitMessage ? this.commitStep(input.commitMessage, receiverId) : void 0;
+			return {
+				session: receiverHandle,
+				summary: this.buildSessionSummary(receiverId),
+				success: applied.success,
+				failed: applied.failed,
+				idMap: result.idMap,
+				aliasMapping: result.aliasMapping,
+				deletedIds: [...result.deletedIds],
+				insertedIds: result.insertedIds,
+				revision
+			};
+		} catch (error) {
+			this.sessions.restore(receiverId, snapshot);
+			throw error;
+		}
+	}
+	selectSourceItems(sourceItems, aliases) {
+		if (!aliases || aliases.length === 0) return [...sourceItems];
+		const byAlias = new Map(sourceItems.map((item) => [item.alias, item]));
+		const selected = [];
+		for (const alias of aliases) {
+			const item = byAlias.get(alias);
+			if (!item) throw new Error(`synthesize: unknown source alias "${alias}"`);
+			selected.push(item);
+		}
+		return selected;
+	}
+	resolveSynthesisSubstitutions(receiverItems, sourceItems, substitutions) {
+		if (!substitutions || substitutions.length === 0) return [];
+		const receiverByAlias = new Map(receiverItems.map((item) => [item.alias, item]));
+		const sourceByAlias = new Map(sourceItems.map((item) => [item.alias, item]));
+		const deletedKeys = /* @__PURE__ */ new Set();
+		const resolved = [];
+		for (const row of substitutions) {
+			const originalSource = sourceByAlias.get(row.original);
+			const originalReceiver = receiverByAlias.get(row.original);
+			const substitutionSource = sourceByAlias.get(row.substitution);
+			const substitutionReceiver = receiverByAlias.get(row.substitution);
+			let originalId;
+			let substitutionId;
+			let originalKey;
+			if (originalSource && substitutionReceiver) {
+				originalId = originalSource.id;
+				substitutionId = substitutionReceiver.id;
+				originalKey = `s:${originalId}`;
+			} else if (originalReceiver && substitutionSource) {
+				originalId = originalReceiver.id;
+				substitutionId = substitutionSource.id;
+				originalKey = `r:${originalId}`;
+			} else throw new Error(`synthesize: substitution "${row.original}" → "${row.substitution}" must pair one source alias with one receiver alias`);
+			if (deletedKeys.has(originalKey)) throw new Error(`synthesize: constituenta "${row.original}" is substituted more than once`);
+			deletedKeys.add(originalKey);
+			resolved.push({
+				original: originalId,
+				substitution: substitutionId
+			});
+		}
+		return resolved;
+	}
 	addOrUpdateConstituenta(input, sessionId) {
 		const id = this.resolveSessionId(sessionId);
 		const envelope = this.sessions.get(id);
@@ -761,7 +859,22 @@ var RSToolAgent = class {
 		this.sessions.setDiagnostics(sessionId, [...collectSchemaDiagnostics(envelope.state), ...collectModelDiagnostics(envelope.state)]);
 	}
 };
+function toSynthesizableSessionItem(item) {
+	return {
+		id: item.id,
+		alias: item.alias,
+		cst_type: item.cstType,
+		definition_formal: item.definitionFormal,
+		typification_manual: "",
+		term_raw: item.term,
+		term_resolved: item.term,
+		term_forms: [],
+		definition_raw: item.definitionText,
+		definition_resolved: item.definitionText,
+		convention: item.convention
+	};
+}
 //#endregion
 export { portalItemToDraft as i, SessionStore as n, PORTAL_JSON_CONTRACT_VERSION as r, RSToolAgent as t };
 
-//# sourceMappingURL=models-LMyDB0md.js.map
+//# sourceMappingURL=models-BKmWx92e.js.map