@rsconcept/rstool 0.10.3 → 1.0.1

package/README.md

@@ -1,6 +1,8 @@
 # @rsconcept/rstool
 
-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 that LLM agents and MCP clients can call directly.
+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:** `2.0.0` — see [skills/rstool-helper/REFERENCE.md](./skills/rstool-helper/REFERENCE.md) for the full v2 API.
 
 ## Agent skill
 
@@ -12,7 +14,7 @@ RS language + rstool workflows for agents: `skills/rstool-helper/` (`GUIDE.md`,
 npm install @rsconcept/rstool
 ```
 
-`@rsconcept/domain` is a peer-of-dependency installed automatically.
+`@rsconcept/domain` is a package dependency and is installed automatically.
 
 ## Installing the agent skill
 
@@ -31,13 +33,11 @@ Details: `skills/README.md`.
 ## Quick use (library)
 
 ```ts
-import { CstType, RSToolAgent } from '@rsconcept/rstool';
+import { RSToolAgent } from '@rsconcept/rstool';
 
 const tool = new RSToolAgent();
-const session = tool.createSession();
-const result = tool.analyzeExpression(session.sessionId, {
-  expression: '1+2',
-  cstType: CstType.TERM
+const result = tool.applySchemaPatch({
+  items: [{ alias: 'X1' }, { alias: 'D1', definitionFormal: '1+2' }]
 });
 ```
 
@@ -52,7 +52,9 @@ Or run it as a child process from your own code:
 ```ts
 import { RSToolWrapperClient } from '@rsconcept/rstool/wrapper';
 
-const client = new RSToolWrapperClient(); // spawns `rstool-wrapper` by default
+// Default is for checkout/dev use: `npm run wrapper` in the current cwd.
+// For an installed package, pass { command: 'npx', args: ['rstool-wrapper'] }.
+const client = new RSToolWrapperClient();
 await client.waitUntilReady();
 const session = await client.call<{ sessionId: string }>('createSession');
 await client.close();
@@ -84,41 +86,77 @@ From `rsconcept/rstool` (or run `powershell -File scripts/dev/LocalDevSetup.ps1`
 
 - Input: one JSON request per line.
 - Output: one JSON response per line.
-- The wrapper keeps state in memory while the process is alive.
+- The wrapper keeps state in memory while the process is alive (or on disk when `RSTOOL_PERSISTENCE_DIR` is set).
+- If a session method is called without an active session, rstool creates one lazily.
 - On startup, a ready handshake is printed.
 
-Supported methods (current contract version: see [`CONTRACT_VERSION`](src/models/tool-contract.ts)):
+Supported methods (contract `2.0.0`):
 
 - `ping`
 - `methods`
+- `ensureSession`
 - `createSession`
-- `addOrUpdateConstituenta`
+- `getCurrentSession`
+- `setCurrentSession`
+- `applySchemaPatch`
+- `getSessionState`
 - `analyzeExpression`
-- `getFormState`
 - `listDiagnostics`
 - `commitStep`
 - `exportSession`
-- `exportPortalSchema`
-- `exportPortalModel`
-- `importSession`
-- `setConstituentaValue`
-- `setConstituentaValues`
-- `clearConstituentaValues`
+- `exportPortal`
+- `importData`
+- `setModelValues`
 - `getModelState`
-- `evaluateExpression`
-- `evaluateConstituenta`
+- `evaluate`
 - `recalculateModel`
 
-Example request:
+Params are **flat** at the top level (no `params.input` wrapper). Optional `sessionId` sits alongside method fields.
+
+Example `createSession`:
+
+Request:
 
 ```json
 { "id": "1", "method": "createSession", "params": {} }
 ```
 
-Example response:
+Response:
+
+```json
+{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "2.0.0" } }
+```
+
+Example `applySchemaPatch`:
+
+Request:
 
 ```json
-{ "id": "1", "ok": true, "result": { "sessionId": "...", "contractVersion": "1.4.0" } }
+{
+  "id": "2",
+  "method": "applySchemaPatch",
+  "params": {
+    "items": [
+      { "alias": "X1" },
+      { "alias": "S1", "definitionFormal": "ℬ(X1×X1)" },
+      { "alias": "D1", "definitionFormal": "Pr1(S1)" }
+    ]
+  }
+}
+```
+
+Response:
+
+```json
+{
+  "id": "2",
+  "ok": true,
+  "result": {
+    "success": true,
+    "session": { "sessionId": "...", "contractVersion": "2.0.0" },
+    "summary": { "itemCount": 3 }
+  }
+}
 ```
 
 ## Typed client example
@@ -131,16 +169,6 @@ npm run example:client
 
 File: [`examples/agent-client.ts`](examples/agent-client.ts)
 
-The example:
-
-- starts the stdio wrapper as a child process
-- waits for the ready handshake
-- creates a session
-- upserts a constituent
-- runs expression analysis
-- sets a base binding and evaluates a term
-- fetches diagnostics
-
 ## License
 
 MIT

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

@@ -0,0 +1,64 @@
+import { n as CstType } from "./common-DHJalS-Q.js";
+import { t as DiagnosticRecord } from "./diagnostic-D9yl_mEL.js";
+import { a as ApplyConstituentsResult, i as ApplyConstituentsMode, o as ConstituentaDraft } from "./constituenta-DnGR6bnM.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-ChexW8i7.js";
+
+//#region src/models/agent-workflow.d.ts
+/** Level of detail returned by {@link RSToolAgent.getSessionState}. */
+type SessionStateDetail = 'summary' | 'full';
+/** Result of `getSessionState`: compact summary or full cloned session state. */
+type SessionStateResult = SessionSummary | SessionState;
+/**
+ * Partial constituent update used in {@link ApplySchemaPatchInput}.
+ *
+ * `alias` is required; other fields are merged with any existing constituent
+ * or inferred from the alias prefix when omitted.
+ */
+interface AgentConstituentaPatch extends Omit<Partial<ConstituentaDraft>, 'alias'> {
+  alias: string;
+}
+/** Input for {@link RSToolAgent.applySchemaPatch}. */
+interface ApplySchemaPatchInput {
+  /** Metadata used only when a new session is created for this patch. */
+  initial?: {
+    alias?: string;
+    title?: string;
+    comment?: string;
+  };
+  /** Constituent patches to apply in dependency order. */
+  items: AgentConstituentaPatch[];
+  /** atomic: rollback on first failure; best_effort applies valid drafts. Default: atomic. */
+  mode?: ApplyConstituentsMode;
+  /** When set, a revision is recorded after a successful patch. */
+  commitMessage?: string;
+}
+/** Compact view of one constituent in a session summary. */
+interface SessionSummaryItem {
+  id: number;
+  alias: string;
+  cstType: CstType;
+  analysisSuccess: boolean;
+}
+/** Compact session overview returned by default from `getSessionState`. */
+interface SessionSummary {
+  sessionId: string;
+  contractVersion: string;
+  alias: string;
+  title: string;
+  comment: string;
+  itemCount: number;
+  modelItemCount: number;
+  diagnosticsCount: number;
+  items: SessionSummaryItem[];
+  diagnostics: DiagnosticRecord[];
+  lastRevision?: SessionRevision;
+}
+/** Result of {@link RSToolAgent.applySchemaPatch}. */
+interface ApplySchemaPatchResult extends ApplyConstituentsResult {
+  session: SessionHandle;
+  summary: SessionSummary;
+  revision?: SessionRevision;
+}
+//#endregion
+export { SessionStateResult as a, SessionStateDetail as i, ApplySchemaPatchInput as n, SessionSummary as o, ApplySchemaPatchResult as r, SessionSummaryItem as s, AgentConstituentaPatch as t };
+//# sourceMappingURL=agent-workflow-Gk0Vfnv1.d.ts.map

package/dist/analysis-LLnPhmGa.d.ts

@@ -0,0 +1,23 @@
+import { a as RSToolErrorDescription, n as CstType, s as ValueClass } from "./common-DHJalS-Q.js";
+
+//#region src/models/analysis.d.ts
+/** Input for {@link RSToolAgent.analyzeExpression}. */
+interface AnalyzeExpressionInput {
+  /** RSLang expression to parse and type-check. */
+  expression: string;
+  /** Expected constituent type context for the expression. */
+  cstType: CstType;
+  /** When true, append diagnostics to the session log. Default: false. */
+  recordDiagnostics?: boolean;
+}
+/** Outcome of parsing and semantic analysis for one expression. */
+interface AnalysisResult {
+  success: boolean;
+  /** Inferred RS type AST as a plain object, or `null` on failure. */
+  type: Record<string, unknown> | null;
+  valueClass: ValueClass | null;
+  diagnostics: RSToolErrorDescription[];
+}
+//#endregion
+export { AnalyzeExpressionInput as n, AnalysisResult as t };
+//# sourceMappingURL=analysis-LLnPhmGa.d.ts.map

package/dist/{common-DxLg3eXX.d.ts → common-DHJalS-Q.d.ts}

@@ -6,12 +6,17 @@ import { RSErrorCode } from "@rsconcept/domain/rslang/error";
 //#region src/models/common.d.ts
 /** Runtime evaluation value: number, nested array (set/tuple), or boolean 0/1. */
 type RSToolValue = number | RSToolValue[];
+/** Language or validation error with source span and optional format parameters. */
 interface RSToolErrorDescription {
+  /** Numeric error code (see {@link RSErrorCode}). */
   code: number;
+  /** Start offset in the analyzed expression. */
   from: number;
+  /** End offset in the analyzed expression. */
   to: number;
+  /** Interpolation values for localized error messages. */
   params?: readonly string[];
 }
 //#endregion
 export { RSToolErrorDescription as a, RSErrorCode as i, CstType$1 as n, RSToolValue as o, EvalStatus$1 as r, ValueClass$1 as s, BasicBinding as t };
-//# sourceMappingURL=common-DxLg3eXX.d.ts.map
+//# sourceMappingURL=common-DHJalS-Q.d.ts.map

package/dist/constituenta-DnGR6bnM.d.ts

@@ -0,0 +1,54 @@
+import { n as CstType } from "./common-DHJalS-Q.js";
+import { t as AnalysisResult } from "./analysis-LLnPhmGa.js";
+import { t as DiagnosticRecord } from "./diagnostic-D9yl_mEL.js";
+
+//#region src/models/constituenta.d.ts
+/** Constituent payload before analysis and merge into session state. */
+interface ConstituentaDraft {
+  id: number;
+  /** Unique alias (e.g. `X1`, `D2`). */
+  alias: string;
+  /** Constituent type. */
+  cstType: CstType;
+  /** Formal RSLang definition. */
+  definitionFormal: string;
+  /** Natural-language term. */
+  term?: string;
+  /** Natural-language definition. */
+  definitionText?: string;
+  /** Convention or comment. */
+  convention?: string;
+}
+/** Constituent stored in session state after analysis. */
+interface ConstituentaState extends Omit<ConstituentaDraft, 'term' | 'definitionText' | 'convention'> {
+  term: string;
+  definitionText: string;
+  convention: string;
+  analysis: AnalysisResult;
+}
+interface AddOrUpdateConstituentaInput {
+  draft: ConstituentaDraft;
+}
+interface AddOrUpdateConstituentaResult {
+  state: ConstituentaState;
+  diagnostics: DiagnosticRecord[];
+}
+/** How a multi-draft apply handles partial failures. */
+type ApplyConstituentsMode = 'atomic' | 'best_effort';
+interface ApplyConstituentsInput {
+  drafts: ConstituentaDraft[];
+  /** atomic: rollback on first failure; best_effort: apply valid drafts. Default: atomic. */
+  mode?: ApplyConstituentsMode;
+}
+interface ApplyConstituentsResult {
+  success: boolean;
+  applied: ConstituentaState[];
+  failed: Array<{
+    draft: ConstituentaDraft;
+    diagnostics: DiagnosticRecord[];
+  }>;
+  diagnostics: DiagnosticRecord[];
+}
+//#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-DnGR6bnM.d.ts.map

package/dist/diagnostic-D9yl_mEL.d.ts

@@ -0,0 +1,19 @@
+import { a as RSToolErrorDescription } from "./common-DHJalS-Q.js";
+
+//#region src/models/diagnostic.d.ts
+/** Persisted diagnostic for a failed or warned expression in a session. */
+interface DiagnosticRecord {
+  sessionId: string;
+  /** Constituent id when the diagnostic is tied to a stored item; omitted for scratch analysis. */
+  constituentId?: number;
+  /** Expression text that was analyzed. */
+  expression: string;
+  error: RSToolErrorDescription;
+}
+/** Filters for {@link RSToolAgent.listDiagnostics}. */
+interface ListDiagnosticsFilters {
+  constituentId?: number;
+}
+//#endregion
+export { ListDiagnosticsFilters as n, DiagnosticRecord as t };
+//# sourceMappingURL=diagnostic-D9yl_mEL.d.ts.map

package/dist/evaluation-Cns8BFm4.d.ts

@@ -0,0 +1,31 @@
+import { a as RSToolErrorDescription, n as CstType, o as RSToolValue, r as EvalStatus, t as BasicBinding } from "./common-DHJalS-Q.js";
+
+//#region src/models/evaluation.d.ts
+interface EvaluateExpressionInput {
+  expression: string;
+  cstType: CstType;
+}
+interface EvaluateConstituentaInput {
+  constituentId: number;
+}
+/** Evaluate a scratch expression or a stored constituent (provide one variant). */
+interface EvaluateInput {
+  /** Scratch expression; requires `cstType`. */
+  expression?: string;
+  /** Type context when evaluating `expression`. */
+  cstType?: CstType;
+  /** Stored constituent id to evaluate. */
+  constituentId?: number;
+}
+/** Outcome of model evaluation for one expression or constituent. */
+interface EvaluationResult {
+  success: boolean;
+  value: RSToolValue | BasicBinding | null;
+  status: EvalStatus;
+  iterations: number;
+  cacheHits: number;
+  diagnostics: RSToolErrorDescription[];
+}
+//#endregion
+export { EvaluationResult as i, EvaluateExpressionInput as n, EvaluateInput as r, EvaluateConstituentaInput as t };
+//# sourceMappingURL=evaluation-Cns8BFm4.d.ts.map

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "./common-DxLg3eXX.js";
-import { n as AnalyzeExpressionInput, t as AnalysisResult } from "./analysis-JiwOYDKx.js";
-import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic-BMYvciz8.js";
-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 { 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 { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "./common-DHJalS-Q.js";
+import { n as AnalyzeExpressionInput, t as AnalysisResult } from "./analysis-LLnPhmGa.js";
+import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic-D9yl_mEL.js";
+import { o as ConstituentaDraft, s as ConstituentaState } from "./constituenta-DnGR6bnM.js";
+import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, r as RecalculateModelResult, s as SetModelValuesInput } from "./model-value-BbonPzMz.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-ChexW8i7.js";
+import { a as SessionStateResult, i as SessionStateDetail, n as ApplySchemaPatchInput, o as SessionSummary, r as ApplySchemaPatchResult, s as SessionSummaryItem, t as AgentConstituentaPatch } from "./agent-workflow-Gk0Vfnv1.js";
+import { i as EvaluationResult, r as EvaluateInput } from "./evaluation-Cns8BFm4.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-0uRGhEfW.js";
+import { t as RSToolAgent } from "./rstool-agent-D2cQze_b.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, 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 };
+export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, 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, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolErrorDescription, 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, toPublicAnalysis, toPublicError };

package/dist/index.js

@@ -1,7 +1,6 @@
 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 { r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "./models-Bw6Uum8i.js";
 import { CONTRACT_VERSION } from "./models/tool-contract.js";
-import "./models/index.js";
 import { RSToolWrapperClient } from "./wrapper/client.js";
 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-BPgsE80c.js";
+import { a as SetConstituentaValueInput, i as SessionModelState, r as RecalculateModelResult } from "../model-value-BbonPzMz.js";
+import { r as SessionState } from "../session-ChexW8i7.js";
+import { i as EvaluationResult } from "../evaluation-Cns8BFm4.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-BPgsE80c.js";
+import { t as AnalysisResult } from "../analysis-LLnPhmGa.js";
+import { t as DiagnosticRecord } from "../diagnostic-D9yl_mEL.js";
+import { o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-DnGR6bnM.js";
+import { r as SessionState } from "../session-ChexW8i7.js";
 import { RSForm } from "@rsconcept/domain/library/rsform";
 import { RSLangAnalyzer } from "@rsconcept/domain/rslang";
 

package/dist/mappers/types.d.ts

@@ -1,21 +1,25 @@
-import { a as RSToolErrorDescription } from "../common-DxLg3eXX.js";
-import { t as AnalysisResult } from "../analysis-JiwOYDKx.js";
+import { a as RSToolErrorDescription } from "../common-DHJalS-Q.js";
+import { t as AnalysisResult } from "../analysis-LLnPhmGa.js";
 import { ValueClass } from "@rsconcept/domain/rslang";
 
 //#region src/mappers/types.d.ts
+/** Minimal domain error shape before mapping to {@link RSToolErrorDescription}. */
 interface DomainErrorLike {
   code: number;
   from: number;
   to: number;
   params?: readonly string[];
 }
+/** Minimal domain analysis shape before mapping to {@link AnalysisResult}. */
 interface DomainAnalysisLike {
   success: boolean;
   type: Record<string, unknown> | null;
   valueClass: ValueClass | null;
   errors: DomainErrorLike[];
 }
+/** Map a domain parser/semantic error to the public diagnostic shape. */
 declare function toPublicError(error: DomainErrorLike): RSToolErrorDescription;
+/** Map a domain analysis result to the public {@link AnalysisResult} shape. */
 declare function toPublicAnalysis(analysis: DomainAnalysisLike): AnalysisResult;
 //#endregion
 export { DomainAnalysisLike, DomainErrorLike, toPublicAnalysis, toPublicError };

package/dist/mappers/types.js

@@ -1,4 +1,5 @@
 //#region src/mappers/types.ts
+/** Map a domain parser/semantic error to the public diagnostic shape. */
 function toPublicError(error) {
 	return {
 		code: error.code,
@@ -7,6 +8,7 @@ function toPublicError(error) {
 		params: error.params
 	};
 }
+/** Map a domain analysis result to the public {@link AnalysisResult} shape. */
 function toPublicAnalysis(analysis) {
 	return {
 		success: analysis.success,

package/dist/mappers/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/mappers/types.ts"],"sourcesContent":["import { type ValueClass } from '@rsconcept/domain/rslang';\n\nimport { type AnalysisResult, type RSToolErrorDescription } from '../models';\n\nexport interface DomainErrorLike {\n  code: number;\n  from: number;\n  to: number;\n  params?: readonly string[];\n}\n\nexport interface DomainAnalysisLike {\n  success: boolean;\n  type: Record<string, unknown> | null;\n  valueClass: ValueClass | null;\n  errors: DomainErrorLike[];\n}\n\nexport function toPublicError(error: DomainErrorLike): RSToolErrorDescription {\n  return {\n    code: error.code,\n    from: error.from,\n    to: error.to,\n    params: error.params\n  };\n}\n\nexport function toPublicAnalysis(analysis: DomainAnalysisLike): AnalysisResult {\n  return {\n    success: analysis.success,\n    type: analysis.type,\n    valueClass: analysis.valueClass,\n    diagnostics: analysis.errors.map(toPublicError)\n  };\n}\n"],"mappings":";AAkBA,SAAgB,cAAc,OAAgD;CAC5E,OAAO;EACL,MAAM,MAAM;EACZ,MAAM,MAAM;EACZ,IAAI,MAAM;EACV,QAAQ,MAAM;CAChB;AACF;AAEA,SAAgB,iBAAiB,UAA8C;CAC7E,OAAO;EACL,SAAS,SAAS;EAClB,MAAM,SAAS;EACf,YAAY,SAAS;EACrB,aAAa,SAAS,OAAO,IAAI,aAAa;CAChD;AACF"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/mappers/types.ts"],"sourcesContent":["import { type ValueClass } from '@rsconcept/domain/rslang';\n\nimport { type AnalysisResult, type RSToolErrorDescription } from '../models';\n\n/** Minimal domain error shape before mapping to {@link RSToolErrorDescription}. */\nexport interface DomainErrorLike {\n  code: number;\n  from: number;\n  to: number;\n  params?: readonly string[];\n}\n\n/** Minimal domain analysis shape before mapping to {@link AnalysisResult}. */\nexport interface DomainAnalysisLike {\n  success: boolean;\n  type: Record<string, unknown> | null;\n  valueClass: ValueClass | null;\n  errors: DomainErrorLike[];\n}\n\n/** Map a domain parser/semantic error to the public diagnostic shape. */\nexport function toPublicError(error: DomainErrorLike): RSToolErrorDescription {\n  return {\n    code: error.code,\n    from: error.from,\n    to: error.to,\n    params: error.params\n  };\n}\n\n/** Map a domain analysis result to the public {@link AnalysisResult} shape. */\nexport function toPublicAnalysis(analysis: DomainAnalysisLike): AnalysisResult {\n  return {\n    success: analysis.success,\n    type: analysis.type,\n    valueClass: analysis.valueClass,\n    diagnostics: analysis.errors.map(toPublicError)\n  };\n}\n"],"mappings":";;AAqBA,SAAgB,cAAc,OAAgD;CAC5E,OAAO;EACL,MAAM,MAAM;EACZ,MAAM,MAAM;EACZ,IAAI,MAAM;EACV,QAAQ,MAAM;CAChB;AACF;;AAGA,SAAgB,iBAAiB,UAA8C;CAC7E,OAAO;EACL,SAAS,SAAS;EAClB,MAAM,SAAS;EACf,YAAY,SAAS;EACrB,aAAa,SAAS,OAAO,IAAI,aAAa;CAChD;AACF"}

package/dist/{model-value-SFAVj0dw.d.ts → model-value-BbonPzMz.d.ts}

@@ -1,16 +1,20 @@
-import { o as RSToolValue, r as EvalStatus, t as BasicBinding } from "./common-DxLg3eXX.js";
+import { o as RSToolValue, r as EvalStatus, t as BasicBinding } from "./common-DHJalS-Q.js";
 
 //#region src/models/model-value.d.ts
+/** Model value for one constituent. */
 interface ModelValueState {
   id: number;
   /** Frontend type string: `basic` or normalized effective typification. */
   type: string;
   value: RSToolValue | BasicBinding;
 }
+/** All model values in a session. */
 interface SessionModelState {
   items: ModelValueState[];
 }
+/** Set or replace the model value for one constituent. */
 interface SetConstituentaValueInput {
+  /** Target constituent id. */
   target: number;
   /** Optional type override; inferred from schema when omitted. */
   type?: string;
@@ -22,6 +26,13 @@ interface SetConstituentaValuesInput {
 interface ClearConstituentaValuesInput {
   items: number[];
 }
+/** Input for {@link RSToolAgent.setModelValues}. */
+interface SetModelValuesInput {
+  set?: SetConstituentaValueInput[];
+  /** Constituent ids whose model values should be cleared. */
+  clear?: number[];
+}
+/** Per-constituent outcome after {@link RSToolAgent.recalculateModel}. */
 interface RecalculateModelResult {
   items: Array<{
     id: number;
@@ -31,5 +42,5 @@ interface RecalculateModelResult {
   }>;
 }
 //#endregion
-export { SetConstituentaValueInput as a, SessionModelState as i, ModelValueState as n, SetConstituentaValuesInput as o, RecalculateModelResult as r, ClearConstituentaValuesInput as t };
-//# sourceMappingURL=model-value-SFAVj0dw.d.ts.map
+export { SetConstituentaValueInput as a, SessionModelState as i, ModelValueState as n, SetConstituentaValuesInput as o, RecalculateModelResult as r, SetModelValuesInput as s, ClearConstituentaValuesInput as t };
+//# sourceMappingURL=model-value-BbonPzMz.d.ts.map

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

@@ -0,0 +1,2 @@
+import { a as SessionStateResult, i as SessionStateDetail, n as ApplySchemaPatchInput, o as SessionSummary, r as ApplySchemaPatchResult, s as SessionSummaryItem, t as AgentConstituentaPatch } from "../agent-workflow-Gk0Vfnv1.js";
+export { AgentConstituentaPatch, ApplySchemaPatchInput, ApplySchemaPatchResult, SessionStateDetail, SessionStateResult, SessionSummary, SessionSummaryItem };

package/dist/models/agent-workflow.js

@@ -0,0 +1 @@
+export {};

package/dist/models/analysis.d.ts

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

package/dist/models/common.d.ts

@@ -1,2 +1,2 @@
-import { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "../common-DxLg3eXX.js";
+import { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "../common-DHJalS-Q.js";
 export { type BasicBinding, CstType, EvalStatus, RSErrorCode, RSToolErrorDescription, RSToolValue, ValueClass };

package/dist/models/constituenta.d.ts

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

package/dist/models/diagnostic.d.ts

@@ -1,2 +1,2 @@
-import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-BMYvciz8.js";
+import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-D9yl_mEL.js";
 export { DiagnosticRecord, ListDiagnosticsFilters };

package/dist/models/evaluation.d.ts

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

package/dist/models/index.d.ts

@@ -1,11 +1,11 @@
-import { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "../common-DxLg3eXX.js";
-import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-JiwOYDKx.js";
-import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-BMYvciz8.js";
-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 { 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 };
+import { a as RSToolErrorDescription, i as RSErrorCode, n as CstType, o as RSToolValue, r as EvalStatus, s as ValueClass, t as BasicBinding } from "../common-DHJalS-Q.js";
+import { n as AnalyzeExpressionInput, t as AnalysisResult } from "../analysis-LLnPhmGa.js";
+import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-D9yl_mEL.js";
+import { i as ApplyConstituentsMode, o as ConstituentaDraft, s as ConstituentaState } from "../constituenta-DnGR6bnM.js";
+import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, r as RecalculateModelResult, s as SetModelValuesInput } from "../model-value-BbonPzMz.js";
+import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-ChexW8i7.js";
+import { a as SessionStateResult, i as SessionStateDetail, n as ApplySchemaPatchInput, o as SessionSummary, r as ApplySchemaPatchResult, s as SessionSummaryItem, t as AgentConstituentaPatch } from "../agent-workflow-Gk0Vfnv1.js";
+import { i as EvaluationResult, r as EvaluateInput } from "../evaluation-Cns8BFm4.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-0uRGhEfW.js";
+import { t as RSToolAgent } from "../rstool-agent-D2cQze_b.js";
+export { type AgentConstituentaPatch, type AnalysisResult, type AnalyzeExpressionInput, type ApplyConstituentsMode, type ApplySchemaPatchInput, type ApplySchemaPatchResult, type BasicBinding, CONTRACT_VERSION, type ConstituentaDraft, type ConstituentaState, CstType, type DiagnosticRecord, 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, RSErrorCode, RSToolAgent, type RSToolAgentContract, type RSToolAgentOptions, type RSToolErrorDescription, type RSToolValue, type RecalculateModelResult, type SessionHandle, type SessionModelState, type SessionRevision, type SessionState, type SessionStateDetail, type SessionStateResult, type SessionSummary, type SessionSummaryItem, type SetConstituentaValueInput, type SetModelValuesInput, ValueClass, portalItemToDraft };

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 { i as portalItemToDraft, r as PORTAL_JSON_CONTRACT_VERSION, t as RSToolAgent } from "../models-Bw6Uum8i.js";
 import { CONTRACT_VERSION } from "./tool-contract.js";
-export { CONTRACT_VERSION, CstType, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSErrorCode, RSToolAgent, ValueClass };
+export { CONTRACT_VERSION, CstType, EvalStatus, PORTAL_JSON_CONTRACT_VERSION, RSErrorCode, RSToolAgent, ValueClass, portalItemToDraft };

package/dist/models/model-value.d.ts

@@ -1,2 +1,2 @@
-import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, o as SetConstituentaValuesInput, r as RecalculateModelResult, t as ClearConstituentaValuesInput } from "../model-value-SFAVj0dw.js";
-export { ClearConstituentaValuesInput, ModelValueState, RecalculateModelResult, SessionModelState, SetConstituentaValueInput, SetConstituentaValuesInput };
+import { a as SetConstituentaValueInput, i as SessionModelState, n as ModelValueState, o as SetConstituentaValuesInput, r as RecalculateModelResult, s as SetModelValuesInput, t as ClearConstituentaValuesInput } from "../model-value-BbonPzMz.js";
+export { ClearConstituentaValuesInput, ModelValueState, RecalculateModelResult, SessionModelState, SetConstituentaValueInput, SetConstituentaValuesInput, SetModelValuesInput };

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

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

package/dist/models/rstool-agent.js

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