@rsconcept/rstool 0.1.0 → 0.2.0

package/README.md

@@ -1,10 +1,10 @@
 # @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 Cursor/Claude 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 that LLM agents and MCP clients can call directly.
 
 ## Agent skill
 
-RS language + rstool workflows for agents: `skills/rstool-helper/` (`SKILL.md`, `REFERENCE.md`, `EXAMPLES.md`). The companion language reference in `docs/` (`DOMAIN.md`, `SYNTAX.md`, `TYPIFICATION.md`, `CONSTITUENTA.md`, `DIAGNOSTICS.md`, `PORTAL-API.md`, `GRAMMAR-REF.md`) is distilled from the Portal manuals and ships with the npm package, so standalone agents never need to read the Portal frontend source.
+RS language + rstool workflows for agents: `skills/rstool-helper/` (`GUIDE.md`, `REFERENCE.md`, `EXAMPLES.md`) and `docs/` (`DOMAIN.md`, `SYNTAX.md`, …). A **thin** entry skill is installed into the project’s agent skills folder; see [Installing the agent skill](#installing-the-agent-skill) below.
 
 ## Install
 
@@ -52,16 +52,20 @@ await client.close();
 - Deterministic diagnostics and export/import for reproducible agent workflows.
 - Library API + stdio JSON wrapper as the only supported transports (MCP adapter lives in [`@rsconcept/rstool-mcp`](../rstool-mcp/)).
 
+## Publishing
+
+Maintainers: see [PUBLISHING.md](./PUBLISHING.md) for npm release steps.
+
 ## Repo scripts
 
-This package is part of the [Concept Portal](https://github.com/IRBorisov/ConceptPortal) npm workspaces. From the repo root:
+From `rsconcept/rstool` (or run `powershell -File scripts/dev/LocalDevSetup.ps1` from the repo root on Windows):
 
-- `npm install` — install all workspaces (`@rsconcept/domain`, `frontend`, `@rsconcept/rstool`)
-- `npm run typecheck -w @rsconcept/rstool`
-- `npm test -w @rsconcept/rstool`
-- `npm run build -w @rsconcept/rstool` — produce `dist/` via tsup
-- `npm run wrapper -w @rsconcept/rstool` — dev stdio wrapper via `tsx`
-- `npm run example:client -w @rsconcept/rstool`, `npm run example:build-schema -w @rsconcept/rstool`, `npm run example:build-rsmodel -w @rsconcept/rstool`
+- `npm install` / `npm ci`
+- `npm run typecheck`
+- `npm test`
+- `npm run build` — produce `dist/` via tsdown
+- `npm run wrapper` — dev stdio wrapper via `tsx`
+- `npm run example:client`, `npm run example:build-schema`, `npm run example:build-rsmodel`
 
 ## Stdio protocol
 
@@ -107,7 +111,7 @@ Example response:
 Run:
 
 ```bash
-npm run example:client -w @rsconcept/rstool
+npm run example:client
 ```
 
 File: [`examples/agent-client.ts`](examples/agent-client.ts)
@@ -122,28 +126,19 @@ The example:
 - sets a base binding and evaluates a term
 - fetches diagnostics
 
-## Installing the skill into an agent host
+## Installing the agent skill
 
-The package ships the skill files in `skills/rstool-helper/`. After install, copy or symlink them into your agent host's skill directory:
+After `npm install @rsconcept/rstool`, **you do not copy files yourself**. Ask your agent, for example:
 
-```bash
-# Cursor (per-project skills)
-mkdir -p .agents/skills
-cp -r node_modules/@rsconcept/rstool/skills/rstool-helper .agents/skills/rstool-helper
-cp -r node_modules/@rsconcept/rstool/docs .agents/skills/rstool-helper/docs
+> Install the rstool agent skill according to the package instructions.
 
-# Claude Code or other hosts: consult host-specific docs
-```
+The agent should read and follow:
 
-PowerShell:
+`node_modules/@rsconcept/rstool/skills/INSTALL.md`
 
-```powershell
-New-Item -ItemType Directory -Force .agents/skills
-Copy-Item -Recurse -Force node_modules/@rsconcept/rstool/skills/rstool-helper .agents/skills/rstool-helper
-Copy-Item -Recurse -Force node_modules/@rsconcept/rstool/docs .agents/skills/rstool-helper/docs
-```
+That copies `skills/rstool-helper/SKILL.md` from the package into your host’s project skills directory (for example `.agents/skills/rstool-helper/SKILL.md`). Full guidance stays in the package (`skills/rstool-helper/GUIDE.md`, `docs/*.md`) and is read from `node_modules` when needed.
 
-The skill defers to the bundled `docs/*.md` for language reference. Copying both the skill and docs makes the installed agent skill self-contained.
+Details: `skills/README.md`.
 
 ## License
 

package/dist/analysis-JiwOYDKx.d.ts

@@ -0,0 +1,16 @@
+import { a as RSToolErrorDescription, n as CstType, s as ValueClass } from "./common-DxLg3eXX.js";
+
+//#region src/models/analysis.d.ts
+interface AnalyzeExpressionInput {
+  expression: string;
+  cstType: CstType;
+}
+interface AnalysisResult {
+  success: boolean;
+  type: Record<string, unknown> | null;
+  valueClass: ValueClass | null;
+  diagnostics: RSToolErrorDescription[];
+}
+//#endregion
+export { AnalyzeExpressionInput as n, AnalysisResult as t };
+//# sourceMappingURL=analysis-JiwOYDKx.d.ts.map

package/dist/common-DxLg3eXX.d.ts

@@ -0,0 +1,17 @@
+import { CstType as CstType$1 } from "@rsconcept/domain/library/rsform";
+import { BasicBinding, EvalStatus as EvalStatus$1 } from "@rsconcept/domain/library/rsmodel";
+import { ValueClass as ValueClass$1 } from "@rsconcept/domain/rslang";
+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[];
+interface RSToolErrorDescription {
+  code: number;
+  from: number;
+  to: number;
+  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

package/dist/constituenta-Dnd6iToB.d.ts

@@ -0,0 +1,36 @@
+import { n as CstType } from "./common-DxLg3eXX.js";
+import { t as AnalysisResult } from "./analysis-JiwOYDKx.js";
+import { t as DiagnosticRecord } from "./diagnostic-BMYvciz8.js";
+
+//#region src/models/constituenta.d.ts
+interface ConstituentaDraft {
+  id: number;
+  /** Alias */
+  alias: string;
+  /** CST type */
+  cstType: CstType;
+  /** Formal definition */
+  definitionFormal: string;
+  /** Natural-language term */
+  term?: string;
+  /** Natural-language definition */
+  definitionText?: string;
+  /** Convention or comment */
+  convention?: string;
+}
+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[];
+}
+//#endregion
+export { ConstituentaState as i, AddOrUpdateConstituentaResult as n, ConstituentaDraft as r, AddOrUpdateConstituentaInput as t };
+//# sourceMappingURL=constituenta-Dnd6iToB.d.ts.map

package/dist/diagnostic-BMYvciz8.d.ts

@@ -0,0 +1,15 @@
+import { a as RSToolErrorDescription } from "./common-DxLg3eXX.js";
+
+//#region src/models/diagnostic.d.ts
+interface DiagnosticRecord {
+  sessionId: string;
+  constituentId?: number;
+  expression: string;
+  error: RSToolErrorDescription;
+}
+interface ListDiagnosticsFilters {
+  constituentId?: number;
+}
+//#endregion
+export { ListDiagnosticsFilters as n, DiagnosticRecord as t };
+//# sourceMappingURL=diagnostic-BMYvciz8.d.ts.map

package/dist/evaluation-CCVYH0wA.d.ts

@@ -0,0 +1,21 @@
+import { a as RSToolErrorDescription, n as CstType, o as RSToolValue, r as EvalStatus, t as BasicBinding } from "./common-DxLg3eXX.js";
+
+//#region src/models/evaluation.d.ts
+interface EvaluateExpressionInput {
+  expression: string;
+  cstType: CstType;
+}
+interface EvaluateConstituentaInput {
+  constituentId: number;
+}
+interface EvaluationResult {
+  success: boolean;
+  value: RSToolValue | BasicBinding | null;
+  status: EvalStatus;
+  iterations: number;
+  cacheHits: number;
+  diagnostics: RSToolErrorDescription[];
+}
+//#endregion
+export { EvaluateExpressionInput as n, EvaluationResult as r, EvaluateConstituentaInput as t };
+//# sourceMappingURL=evaluation-CCVYH0wA.d.ts.map

package/dist/index.d.ts

@@ -1,15 +1,12 @@
-export { DomainAnalysisLike, DomainErrorLike, toPublicAnalysis, toPublicError } from './mappers/types.js';
-export { AnalysisResult, AnalyzeExpressionInput } from './models/analysis.js';
-export { RSToolErrorDescription, RSToolValue } from './models/common.js';
-export { AddOrUpdateConstituentaInput, AddOrUpdateConstituentaResult, ConstituentaDraft, ConstituentaState } from './models/constituenta.js';
-export { DiagnosticRecord, ListDiagnosticsFilters } from './models/diagnostic.js';
-export { EvaluateConstituentaInput, EvaluateExpressionInput, EvaluationResult } from './models/evaluation.js';
-export { ClearConstituentaValuesInput, ModelValueState, RecalculateModelResult, SessionModelState, SetConstituentaValueInput, SetConstituentaValuesInput } from './models/model-value.js';
-export { RSToolAgent } from './models/rstool-agent.js';
-export { SessionHandle, SessionRevision, SessionState } from './models/session.js';
-export { CONTRACT_VERSION, RSToolAgentContract } from './models/tool-contract.js';
-export { RSToolWrapperClient, RSToolWrapperClientOptions, WrapperResponse } from './wrapper/client.js';
-export { BasicBinding, EvalStatus } from '@rsconcept/domain/library/rsmodel';
-export { CstType } from '@rsconcept/domain/library/rsform';
-export { RSErrorCode } from '@rsconcept/domain/rslang/error';
-export { ValueClass } from '@rsconcept/domain/rslang';
+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 { 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 { 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 };