@rsconcept/rstool 0.10.2 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/README.md +41 -31
  2. package/dist/agent-workflow-D-PSIb-m.d.ts +70 -0
  3. package/dist/analysis-LLnPhmGa.d.ts +23 -0
  4. package/dist/{common-DxLg3eXX.d.ts → common-DHJalS-Q.d.ts} +6 -1
  5. package/dist/constituenta-DnGR6bnM.d.ts +54 -0
  6. package/dist/diagnostic-D9yl_mEL.d.ts +19 -0
  7. package/dist/evaluation-Cns8BFm4.d.ts +31 -0
  8. package/dist/index.d.ts +11 -11
  9. package/dist/index.js +1 -1
  10. package/dist/mappers/model-adapter.d.ts +3 -3
  11. package/dist/mappers/schema-adapter.d.ts +4 -4
  12. package/dist/mappers/types.d.ts +6 -2
  13. package/dist/mappers/types.js +2 -0
  14. package/dist/mappers/types.js.map +1 -1
  15. package/dist/{model-value-SFAVj0dw.d.ts → model-value-BbonPzMz.d.ts} +14 -3
  16. package/dist/models/agent-workflow.d.ts +2 -0
  17. package/dist/models/agent-workflow.js +1 -0
  18. package/dist/models/analysis.d.ts +1 -1
  19. package/dist/models/common.d.ts +1 -1
  20. package/dist/models/constituenta.d.ts +2 -2
  21. package/dist/models/diagnostic.d.ts +1 -1
  22. package/dist/models/evaluation.d.ts +2 -2
  23. package/dist/models/index.d.ts +11 -11
  24. package/dist/models/index.js +2 -2
  25. package/dist/models/model-value.d.ts +2 -2
  26. package/dist/models/rstool-agent.d.ts +1 -1
  27. package/dist/models/rstool-agent.js +1 -1
  28. package/dist/models/session.d.ts +1 -1
  29. package/dist/models/tool-contract.d.ts +2 -2
  30. package/dist/models/tool-contract.js +2 -1
  31. package/dist/models/tool-contract.js.map +1 -1
  32. package/dist/rstool-agent-_8bplZnb.d.ts +71 -0
  33. package/dist/rstool-agent-kijHA9ML.js +476 -0
  34. package/dist/rstool-agent-kijHA9ML.js.map +1 -0
  35. package/dist/session/session-store.d.ts +18 -5
  36. package/dist/session/session-store.js +1 -64
  37. package/dist/{session-BPgsE80c.d.ts → session-ChexW8i7.d.ts} +11 -8
  38. package/dist/session-store-C3jyOSqI.js +142 -0
  39. package/dist/session-store-C3jyOSqI.js.map +1 -0
  40. package/dist/tool-contract-5_Q44DGE.d.ts +164 -0
  41. package/dist/wrapper/client.d.ts +23 -0
  42. package/dist/wrapper/client.js +17 -0
  43. package/dist/wrapper/client.js.map +1 -1
  44. package/dist/wrapper/stdio-wrapper.js +62 -52
  45. package/dist/wrapper/stdio-wrapper.js.map +1 -1
  46. package/docs/CONSTITUENTA.md +2 -2
  47. package/docs/DIAGNOSTICS.md +20 -18
  48. package/docs/MODEL-TESTING.md +3 -3
  49. package/docs/PORTAL-API.md +24 -18
  50. package/examples/README.md +1 -1
  51. package/examples/agent-client.ts +11 -41
  52. package/examples/build-chocolate-nim-rsform.ts +23 -18
  53. package/examples/chocolate-nim/build-rsform.ts +23 -18
  54. package/examples/chocolate-nim/build-rsmodel.ts +10 -12
  55. package/examples/chocolate-nim/rsform-session.json +290 -290
  56. package/examples/chocolate-nim/rsmodel-session.json +291 -291
  57. package/examples/expression-bank/bank-constituents.ts +304 -53
  58. package/examples/expression-bank/build-rsform.ts +19 -16
  59. package/examples/expression-bank/rsform-session.json +1551 -1551
  60. package/examples/kinship/build-rsform.ts +23 -18
  61. package/examples/kinship/build-rsmodel.ts +13 -15
  62. package/examples/kinship/rsform-session.json +219 -219
  63. package/examples/kinship/rsmodel-session.json +221 -221
  64. package/examples/kinship/session.ts +19 -21
  65. package/examples/movd/build-rsform.ts +23 -18
  66. package/examples/movd/build-rsmodel.ts +18 -20
  67. package/examples/movd/rsform-session.json +262 -262
  68. package/examples/movd/rsmodel-session.json +264 -264
  69. package/examples/sample/build-rsform.ts +19 -50
  70. package/examples/sample/build-rsmodel.ts +25 -44
  71. package/examples/sample/rsform-session.json +36 -33
  72. package/examples/sample/rsmodel-session.json +36 -33
  73. package/examples/template-apply/build-rsform.ts +27 -24
  74. package/examples/template-apply/rsform-session.json +48 -48
  75. package/package.json +3 -3
  76. package/skills/rstool-helper/EXAMPLES.md +44 -116
  77. package/skills/rstool-helper/GUIDE.md +40 -25
  78. package/skills/rstool-helper/REFERENCE.md +40 -177
  79. package/src/index.ts +24 -17
  80. package/src/mappers/portal-adapter.ts +43 -0
  81. package/src/mappers/types.ts +4 -0
  82. package/src/models/agent-workflow.ts +78 -0
  83. package/src/models/analysis.ts +7 -0
  84. package/src/models/common.ts +7 -0
  85. package/src/models/constituenta.ts +24 -6
  86. package/src/models/diagnostic.ts +4 -0
  87. package/src/models/evaluation.ts +11 -0
  88. package/src/models/import-detect.ts +39 -0
  89. package/src/models/import-export.ts +24 -0
  90. package/src/models/index.ts +22 -14
  91. package/src/models/model-value.ts +12 -0
  92. package/src/models/portal-json.ts +44 -0
  93. package/src/models/rstool-agent.test.ts +300 -147
  94. package/src/models/rstool-agent.ts +350 -93
  95. package/src/models/session.ts +8 -5
  96. package/src/models/tool-contract.ts +81 -42
  97. package/src/session/batch-apply.test.ts +28 -0
  98. package/src/session/batch-apply.ts +47 -0
  99. package/src/session/persistence.ts +56 -0
  100. package/src/session/session-store.ts +67 -4
  101. package/src/wrapper/client.ts +23 -0
  102. package/src/wrapper/stdio-wrapper.ts +59 -49
  103. package/dist/analysis-JiwOYDKx.d.ts +0 -16
  104. package/dist/constituenta-Dnd6iToB.d.ts +0 -36
  105. package/dist/diagnostic-BMYvciz8.d.ts +0 -15
  106. package/dist/evaluation-CCVYH0wA.d.ts +0 -21
  107. package/dist/index-uhkmwruf.d.ts +0 -46
  108. package/dist/rstool-agent-BZi5jO1y.js +0 -158
  109. package/dist/rstool-agent-BZi5jO1y.js.map +0 -1
  110. package/dist/rstool-agent-pRaPnZay.d.ts +0 -35
  111. package/dist/session/session-store.js.map +0 -1
  112. package/dist/tool-contract-n1ghUOrK.d.ts +0 -32
@@ -1,20 +1,33 @@
1
- import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-BMYvciz8.js";
2
- import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-BPgsE80c.js";
3
-
1
+ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "../diagnostic-D9yl_mEL.js";
2
+ import { n as SessionRevision, r as SessionState, t as SessionHandle } from "../session-ChexW8i7.js";
4
3
  //#region src/session/session-store.d.ts
4
+ interface SessionStoreOptions {
5
+ persistenceDir?: string;
6
+ }
5
7
  interface SessionEnvelope {
6
8
  state: SessionState;
7
9
  diagnostics: DiagnosticRecord[];
8
10
  }
9
11
  declare class SessionStore {
10
12
  private sessions;
13
+ private readonly persistence;
14
+ constructor(options?: SessionStoreOptions);
11
15
  create(initial?: Partial<SessionState>, contractVersion?: string): SessionHandle;
12
16
  get(sessionId: string): SessionEnvelope;
17
+ has(sessionId: string): boolean;
13
18
  replaceState(sessionId: string, nextState: SessionState): void;
14
19
  addRevision(sessionId: string, message?: string): SessionRevision;
15
- appendDiagnostics(sessionId: string, records: DiagnosticRecord[]): void;
20
+ /** Replace active diagnostics for one constituent (or scratch when constituentId is undefined). */
21
+ replaceDiagnosticsForConstituent(sessionId: string, constituentId: number | undefined, records: DiagnosticRecord[]): void;
22
+ setDiagnostics(sessionId: string, records: DiagnosticRecord[]): void;
16
23
  listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[];
24
+ snapshot(sessionId: string): SessionEnvelope;
25
+ restore(sessionId: string, snapshot: SessionEnvelope): void;
26
+ saveCurrentSessionId(sessionId: string | null): void;
27
+ loadCurrentSessionId(): string | null;
28
+ private loadFromDisk;
29
+ private persist;
17
30
  }
18
31
  //#endregion
19
- export { SessionStore };
32
+ export { SessionStore, SessionStoreOptions };
20
33
  //# sourceMappingURL=session-store.d.ts.map
@@ -1,65 +1,2 @@
1
- import { randomUUID } from "node:crypto";
2
- //#region src/session/session-store.ts
3
- var SessionStore = class {
4
- sessions = /* @__PURE__ */ new Map();
5
- create(initial, contractVersion) {
6
- const now = (/* @__PURE__ */ new Date()).toISOString();
7
- const sessionId = initial?.sessionId ?? randomUUID();
8
- const state = {
9
- sessionId,
10
- alias: initial?.alias ?? "",
11
- title: initial?.title ?? "",
12
- comment: initial?.comment ?? "",
13
- createdAt: initial?.createdAt ?? now,
14
- updatedAt: now,
15
- revisions: initial?.revisions ?? [],
16
- items: initial?.items ?? [],
17
- model: initial?.model ?? { items: [] }
18
- };
19
- this.sessions.set(sessionId, {
20
- state,
21
- diagnostics: []
22
- });
23
- return {
24
- sessionId,
25
- contractVersion: contractVersion ?? "1.0.0"
26
- };
27
- }
28
- get(sessionId) {
29
- const found = this.sessions.get(sessionId);
30
- if (!found) throw new Error(`Unknown session: ${sessionId}`);
31
- return found;
32
- }
33
- replaceState(sessionId, nextState) {
34
- const found = this.get(sessionId);
35
- found.state = {
36
- ...nextState,
37
- updatedAt: (/* @__PURE__ */ new Date()).toISOString()
38
- };
39
- }
40
- addRevision(sessionId, message) {
41
- const found = this.get(sessionId);
42
- const revision = {
43
- revisionId: randomUUID(),
44
- at: (/* @__PURE__ */ new Date()).toISOString(),
45
- message
46
- };
47
- found.state.revisions.push(revision);
48
- found.state.updatedAt = revision.at;
49
- return revision;
50
- }
51
- appendDiagnostics(sessionId, records) {
52
- const found = this.get(sessionId);
53
- found.diagnostics.push(...records);
54
- found.state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
55
- }
56
- listDiagnostics(sessionId, filters) {
57
- const found = this.get(sessionId);
58
- if (!filters?.constituentId) return [...found.diagnostics];
59
- return found.diagnostics.filter((record) => record.constituentId === filters.constituentId);
60
- }
61
- };
62
- //#endregion
1
+ import { t as SessionStore } from "../session-store-C3jyOSqI.js";
63
2
  export { SessionStore };
64
-
65
- //# sourceMappingURL=session-store.js.map
@@ -1,16 +1,19 @@
1
- import { i as ConstituentaState } from "./constituenta-Dnd6iToB.js";
2
- import { i as SessionModelState } from "./model-value-SFAVj0dw.js";
1
+ import { s as ConstituentaState } from "./constituenta-DnGR6bnM.js";
2
+ import { i as SessionModelState } from "./model-value-BbonPzMz.js";
3
3
 
4
4
  //#region src/models/session.d.ts
5
+ /** Opaque session reference returned by create/import operations. */
5
6
  interface SessionHandle {
6
7
  sessionId: string;
7
8
  contractVersion: string;
8
9
  }
10
+ /** Recorded checkpoint in session revision history. */
9
11
  interface SessionRevision {
10
12
  revisionId: string;
11
13
  at: string;
12
14
  message?: string;
13
15
  }
16
+ /** Full in-memory session state. */
14
17
  interface SessionState {
15
18
  sessionId: string;
16
19
  /** Library item alias for the conceptual schema or model. */
@@ -19,17 +22,17 @@ interface SessionState {
19
22
  title: string;
20
23
  /** Developer comment (Portal JSON `description` on export). */
21
24
  comment: string;
22
- /** Date of creation. */
25
+ /** ISO timestamp of session creation. */
23
26
  createdAt: string;
24
- /** Date of last update. */
27
+ /** ISO timestamp of last mutation. */
25
28
  updatedAt: string;
26
- /** List of revisions. */
29
+ /** Revision checkpoints recorded via {@link RSToolAgent.commitStep}. */
27
30
  revisions: SessionRevision[];
28
- /** List of constituents in the session. */
31
+ /** Analyzed constituents in the conceptual schema. */
29
32
  items: ConstituentaState[];
30
- /** Model state. */
33
+ /** Evaluated model values. */
31
34
  model: SessionModelState;
32
35
  }
33
36
  //#endregion
34
37
  export { SessionRevision as n, SessionState as r, SessionHandle as t };
35
- //# sourceMappingURL=session-BPgsE80c.d.ts.map
38
+ //# sourceMappingURL=session-ChexW8i7.d.ts.map
@@ -0,0 +1,142 @@
1
+ import { randomUUID } from "node:crypto";
2
+ import fs from "node:fs";
3
+ import path from "node:path";
4
+ //#region src/session/persistence.ts
5
+ const CURRENT_SESSION_FILE = "_current.json";
6
+ var SessionPersistence = class {
7
+ dir;
8
+ constructor(dir) {
9
+ this.dir = dir;
10
+ fs.mkdirSync(dir, { recursive: true });
11
+ }
12
+ save(sessionId, envelope) {
13
+ fs.writeFileSync(this.filePath(sessionId), JSON.stringify(envelope, null, 2), "utf-8");
14
+ }
15
+ load(sessionId) {
16
+ const file = this.filePath(sessionId);
17
+ if (!fs.existsSync(file)) return null;
18
+ return JSON.parse(fs.readFileSync(file, "utf-8"));
19
+ }
20
+ delete(sessionId) {
21
+ const file = this.filePath(sessionId);
22
+ if (fs.existsSync(file)) fs.unlinkSync(file);
23
+ }
24
+ saveCurrentSessionId(sessionId) {
25
+ fs.writeFileSync(path.join(this.dir, CURRENT_SESSION_FILE), JSON.stringify({ sessionId }, null, 2), "utf-8");
26
+ }
27
+ loadCurrentSessionId() {
28
+ const file = path.join(this.dir, CURRENT_SESSION_FILE);
29
+ if (!fs.existsSync(file)) return null;
30
+ return JSON.parse(fs.readFileSync(file, "utf-8")).sessionId ?? null;
31
+ }
32
+ filePath(sessionId) {
33
+ return path.join(this.dir, `${sessionId}.json`);
34
+ }
35
+ };
36
+ //#endregion
37
+ //#region src/session/session-store.ts
38
+ var SessionStore = class {
39
+ sessions = /* @__PURE__ */ new Map();
40
+ persistence;
41
+ constructor(options = {}) {
42
+ this.persistence = options.persistenceDir ? new SessionPersistence(options.persistenceDir) : null;
43
+ }
44
+ create(initial, contractVersion) {
45
+ const now = (/* @__PURE__ */ new Date()).toISOString();
46
+ const sessionId = initial?.sessionId ?? randomUUID();
47
+ const envelope = {
48
+ state: {
49
+ sessionId,
50
+ alias: initial?.alias ?? "",
51
+ title: initial?.title ?? "",
52
+ comment: initial?.comment ?? "",
53
+ createdAt: initial?.createdAt ?? now,
54
+ updatedAt: now,
55
+ revisions: initial?.revisions ?? [],
56
+ items: initial?.items ?? [],
57
+ model: initial?.model ?? { items: [] }
58
+ },
59
+ diagnostics: []
60
+ };
61
+ this.sessions.set(sessionId, envelope);
62
+ this.persist(sessionId, envelope);
63
+ return {
64
+ sessionId,
65
+ contractVersion: contractVersion ?? "1.0.0"
66
+ };
67
+ }
68
+ get(sessionId) {
69
+ const found = this.sessions.get(sessionId) ?? this.loadFromDisk(sessionId);
70
+ if (!found) throw new Error(`Unknown session: ${sessionId}`);
71
+ return found;
72
+ }
73
+ has(sessionId) {
74
+ return this.sessions.has(sessionId) || this.persistence?.load(sessionId) !== null;
75
+ }
76
+ replaceState(sessionId, nextState) {
77
+ const found = this.get(sessionId);
78
+ found.state = {
79
+ ...nextState,
80
+ updatedAt: (/* @__PURE__ */ new Date()).toISOString()
81
+ };
82
+ this.persist(sessionId, found);
83
+ }
84
+ addRevision(sessionId, message) {
85
+ const found = this.get(sessionId);
86
+ const revision = {
87
+ revisionId: randomUUID(),
88
+ at: (/* @__PURE__ */ new Date()).toISOString(),
89
+ message
90
+ };
91
+ found.state.revisions.push(revision);
92
+ found.state.updatedAt = revision.at;
93
+ this.persist(sessionId, found);
94
+ return revision;
95
+ }
96
+ /** Replace active diagnostics for one constituent (or scratch when constituentId is undefined). */
97
+ replaceDiagnosticsForConstituent(sessionId, constituentId, records) {
98
+ const found = this.get(sessionId);
99
+ found.diagnostics = found.diagnostics.filter((record) => record.constituentId !== constituentId);
100
+ found.diagnostics.push(...records);
101
+ found.state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
102
+ this.persist(sessionId, found);
103
+ }
104
+ setDiagnostics(sessionId, records) {
105
+ const found = this.get(sessionId);
106
+ found.diagnostics = [...records];
107
+ found.state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
108
+ this.persist(sessionId, found);
109
+ }
110
+ listDiagnostics(sessionId, filters) {
111
+ const found = this.get(sessionId);
112
+ if (!filters?.constituentId) return [...found.diagnostics];
113
+ return found.diagnostics.filter((record) => record.constituentId === filters.constituentId);
114
+ }
115
+ snapshot(sessionId) {
116
+ const found = this.get(sessionId);
117
+ return structuredClone(found);
118
+ }
119
+ restore(sessionId, snapshot) {
120
+ this.sessions.set(sessionId, structuredClone(snapshot));
121
+ this.persist(sessionId, this.sessions.get(sessionId));
122
+ }
123
+ saveCurrentSessionId(sessionId) {
124
+ this.persistence?.saveCurrentSessionId(sessionId);
125
+ }
126
+ loadCurrentSessionId() {
127
+ return this.persistence?.loadCurrentSessionId() ?? null;
128
+ }
129
+ loadFromDisk(sessionId) {
130
+ const loaded = this.persistence?.load(sessionId);
131
+ if (!loaded) return null;
132
+ this.sessions.set(sessionId, loaded);
133
+ return loaded;
134
+ }
135
+ persist(sessionId, envelope) {
136
+ this.persistence?.save(sessionId, envelope);
137
+ }
138
+ };
139
+ //#endregion
140
+ export { SessionStore as t };
141
+
142
+ //# sourceMappingURL=session-store-C3jyOSqI.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session-store-C3jyOSqI.js","names":[],"sources":["../src/session/persistence.ts","../src/session/session-store.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { type DiagnosticRecord, type SessionState } from '../models';\n\nexport interface PersistedSessionEnvelope {\n state: SessionState;\n diagnostics: DiagnosticRecord[];\n}\n\nconst CURRENT_SESSION_FILE = '_current.json';\n\nexport class SessionPersistence {\n private readonly dir: string;\n\n public constructor(dir: string) {\n this.dir = dir;\n fs.mkdirSync(dir, { recursive: true });\n }\n\n public save(sessionId: string, envelope: PersistedSessionEnvelope): void {\n fs.writeFileSync(this.filePath(sessionId), JSON.stringify(envelope, null, 2), 'utf-8');\n }\n\n public load(sessionId: string): PersistedSessionEnvelope | null {\n const file = this.filePath(sessionId);\n if (!fs.existsSync(file)) {\n return null;\n }\n return JSON.parse(fs.readFileSync(file, 'utf-8')) as PersistedSessionEnvelope;\n }\n\n public delete(sessionId: string): void {\n const file = this.filePath(sessionId);\n if (fs.existsSync(file)) {\n fs.unlinkSync(file);\n }\n }\n\n public saveCurrentSessionId(sessionId: string | null): void {\n fs.writeFileSync(path.join(this.dir, CURRENT_SESSION_FILE), JSON.stringify({ sessionId }, null, 2), 'utf-8');\n }\n\n public loadCurrentSessionId(): string | null {\n const file = path.join(this.dir, CURRENT_SESSION_FILE);\n if (!fs.existsSync(file)) {\n return null;\n }\n const parsed = JSON.parse(fs.readFileSync(file, 'utf-8')) as { sessionId?: string | null };\n return parsed.sessionId ?? null;\n }\n\n private filePath(sessionId: string): string {\n return path.join(this.dir, `${sessionId}.json`);\n }\n}\n","import { randomUUID } from 'node:crypto';\n\nimport {\n type DiagnosticRecord,\n type ListDiagnosticsFilters,\n type SessionHandle,\n type SessionRevision,\n type SessionState\n} from '../models';\nimport { SessionPersistence, type PersistedSessionEnvelope } from './persistence';\n\nexport interface SessionStoreOptions {\n persistenceDir?: string;\n}\n\ninterface SessionEnvelope {\n state: SessionState;\n diagnostics: DiagnosticRecord[];\n}\n\nexport class SessionStore {\n private sessions = new Map<string, SessionEnvelope>();\n private readonly persistence: SessionPersistence | null;\n\n public constructor(options: SessionStoreOptions = {}) {\n this.persistence = options.persistenceDir ? new SessionPersistence(options.persistenceDir) : null;\n }\n\n public create(initial?: Partial<SessionState>, contractVersion?: string): SessionHandle {\n const now = new Date().toISOString();\n const sessionId = initial?.sessionId ?? randomUUID();\n const state: SessionState = {\n sessionId,\n alias: initial?.alias ?? '',\n title: initial?.title ?? '',\n comment: initial?.comment ?? '',\n createdAt: initial?.createdAt ?? now,\n updatedAt: now,\n revisions: initial?.revisions ?? [],\n items: initial?.items ?? [],\n model: initial?.model ?? { items: [] }\n };\n const envelope: SessionEnvelope = {\n state,\n diagnostics: []\n };\n this.sessions.set(sessionId, envelope);\n this.persist(sessionId, envelope);\n return {\n sessionId,\n contractVersion: contractVersion ?? '1.0.0'\n };\n }\n\n public get(sessionId: string): SessionEnvelope {\n const found = this.sessions.get(sessionId) ?? this.loadFromDisk(sessionId);\n if (!found) {\n throw new Error(`Unknown session: ${sessionId}`);\n }\n return found;\n }\n\n public has(sessionId: string): boolean {\n return this.sessions.has(sessionId) || this.persistence?.load(sessionId) !== null;\n }\n\n public replaceState(sessionId: string, nextState: SessionState): void {\n const found = this.get(sessionId);\n found.state = {\n ...nextState,\n updatedAt: new Date().toISOString()\n };\n this.persist(sessionId, found);\n }\n\n public addRevision(sessionId: string, message?: string): SessionRevision {\n const found = this.get(sessionId);\n const revision: SessionRevision = {\n revisionId: randomUUID(),\n at: new Date().toISOString(),\n message\n };\n found.state.revisions.push(revision);\n found.state.updatedAt = revision.at;\n this.persist(sessionId, found);\n return revision;\n }\n\n /** Replace active diagnostics for one constituent (or scratch when constituentId is undefined). */\n public replaceDiagnosticsForConstituent(\n sessionId: string,\n constituentId: number | undefined,\n records: DiagnosticRecord[]\n ): void {\n const found = this.get(sessionId);\n found.diagnostics = found.diagnostics.filter(record => record.constituentId !== constituentId);\n found.diagnostics.push(...records);\n found.state.updatedAt = new Date().toISOString();\n this.persist(sessionId, found);\n }\n\n public setDiagnostics(sessionId: string, records: DiagnosticRecord[]): void {\n const found = this.get(sessionId);\n found.diagnostics = [...records];\n found.state.updatedAt = new Date().toISOString();\n this.persist(sessionId, found);\n }\n\n public listDiagnostics(sessionId: string, filters?: ListDiagnosticsFilters): DiagnosticRecord[] {\n const found = this.get(sessionId);\n if (!filters?.constituentId) {\n return [...found.diagnostics];\n }\n return found.diagnostics.filter(record => record.constituentId === filters.constituentId);\n }\n\n public snapshot(sessionId: string): SessionEnvelope {\n const found = this.get(sessionId);\n return structuredClone(found);\n }\n\n public restore(sessionId: string, snapshot: SessionEnvelope): void {\n this.sessions.set(sessionId, structuredClone(snapshot));\n this.persist(sessionId, this.sessions.get(sessionId)!);\n }\n\n public saveCurrentSessionId(sessionId: string | null): void {\n this.persistence?.saveCurrentSessionId(sessionId);\n }\n\n public loadCurrentSessionId(): string | null {\n return this.persistence?.loadCurrentSessionId() ?? null;\n }\n\n private loadFromDisk(sessionId: string): SessionEnvelope | null {\n const loaded = this.persistence?.load(sessionId);\n if (!loaded) {\n return null;\n }\n this.sessions.set(sessionId, loaded);\n return loaded;\n }\n\n private persist(sessionId: string, envelope: SessionEnvelope): void {\n this.persistence?.save(sessionId, envelope as PersistedSessionEnvelope);\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,164 @@
1
+ import { o as RSToolValue, t as BasicBinding } from "./common-DHJalS-Q.js";
2
+ import { n as AnalyzeExpressionInput, t as AnalysisResult } from "./analysis-LLnPhmGa.js";
3
+ import { n as ListDiagnosticsFilters, t as DiagnosticRecord } from "./diagnostic-D9yl_mEL.js";
4
+ import { o as ConstituentaDraft } from "./constituenta-DnGR6bnM.js";
5
+ import { i as SessionModelState, r as RecalculateModelResult, s as SetModelValuesInput } from "./model-value-BbonPzMz.js";
6
+ import { n as SessionRevision, r as SessionState, t as SessionHandle } from "./session-ChexW8i7.js";
7
+ import { a as SessionStateDetail, n as ApplySchemaPatchInput, o as SessionStateResult, r as ApplySchemaPatchResult } from "./agent-workflow-D-PSIb-m.js";
8
+ import { i as EvaluationResult, r as EvaluateInput } from "./evaluation-Cns8BFm4.js";
9
+
10
+ //#region src/models/portal-json.d.ts
11
+ /** Portal JSON import/export format version (schema and model files). */
12
+ declare const PORTAL_JSON_CONTRACT_VERSION = "1.0.0";
13
+ /** Shared metadata block in Portal schema and model JSON files. */
14
+ interface PortalImportMetadata {
15
+ contract_version: string;
16
+ title: string;
17
+ alias: string;
18
+ description: string;
19
+ }
20
+ /** Inflected or tagged surface form of a term. */
21
+ interface PortalTermForm {
22
+ text: string;
23
+ tags: string;
24
+ }
25
+ /** One constituent in Portal schema JSON (`cst_type`, snake_case fields). */
26
+ interface PortalSchemaConstituenta {
27
+ id: number;
28
+ alias: string;
29
+ convention: string;
30
+ crucial: boolean;
31
+ cst_type: string;
32
+ definition_formal: string;
33
+ typification_manual: string;
34
+ value_is_property: boolean;
35
+ definition_raw: string;
36
+ definition_resolved: string;
37
+ term_raw: string;
38
+ term_resolved: string;
39
+ term_forms: PortalTermForm[];
40
+ }
41
+ /** Full Portal conceptual schema import/export document. */
42
+ interface PortalSchemaImportData extends PortalImportMetadata {
43
+ items: PortalSchemaConstituenta[];
44
+ attribution: Array<{
45
+ container: number;
46
+ attribute: number;
47
+ }>;
48
+ }
49
+ /** `GET /api/rsforms/:id/details` response (schema payload only). */
50
+ interface PortalRsformDetails {
51
+ id?: number;
52
+ title?: string;
53
+ alias?: string;
54
+ description?: string;
55
+ items: Array<{
56
+ id: number;
57
+ alias: string;
58
+ cst_type: string;
59
+ definition_formal?: string;
60
+ term_raw?: string;
61
+ definition_raw?: string;
62
+ convention?: string;
63
+ }>;
64
+ }
65
+ /** Full Portal conceptual model import/export document. */
66
+ interface PortalModelImportData extends PortalImportMetadata {
67
+ items: Array<{
68
+ id: number;
69
+ type: string;
70
+ value: RSToolValue | BasicBinding;
71
+ }>;
72
+ }
73
+ /** Map a Portal API or JSON schema item to an agent {@link ConstituentaDraft}. */
74
+ declare function portalItemToDraft(item: {
75
+ id: number;
76
+ alias: string;
77
+ cst_type: string;
78
+ definition_formal?: string;
79
+ term_raw?: string;
80
+ definition_raw?: string;
81
+ convention?: string;
82
+ }): ConstituentaDraft;
83
+ //#endregion
84
+ //#region src/models/import-export.d.ts
85
+ /** Portal export target: conceptual schema or model values. */
86
+ type PortalExportKind = 'schema' | 'model';
87
+ /** Serialized JSON string or parsed object for export helpers. */
88
+ type ExportFormat = 'json' | 'object';
89
+ /** Input for {@link RSToolAgent.exportPortal}. */
90
+ interface ExportPortalInput {
91
+ kind: PortalExportKind;
92
+ /** Default: `json` (string). Use `object` for structured data. */
93
+ format?: ExportFormat;
94
+ }
95
+ /**
96
+ * Import payload discriminator.
97
+ *
98
+ * Use `'auto'` to detect from JSON shape, or pass an explicit kind when ambiguous.
99
+ */
100
+ type ImportDataKind = 'auto' | 'session' | 'portal-schema' | 'portal-details';
101
+ /** JSON string or Portal import object, depending on {@link ExportFormat}. */
102
+ type ExportPortalResult = string | PortalSchemaImportData | PortalModelImportData;
103
+ //#endregion
104
+ //#region src/models/tool-contract.d.ts
105
+ /** Agent-visible contract version; bump on breaking API changes. */
106
+ declare const CONTRACT_VERSION = "2.0.0";
107
+ /** Options for constructing an {@link RSToolAgent}. */
108
+ interface RSToolAgentOptions {
109
+ /** When set, sessions are persisted to this directory and survive process restarts. */
110
+ persistenceDir?: string;
111
+ }
112
+ /**
113
+ * Public method surface of {@link RSToolAgent}.
114
+ *
115
+ * Each method accepts an optional `sessionId`; when omitted, the current session is used
116
+ * (or a new one is created where noted).
117
+ */
118
+ interface RSToolAgentContract {
119
+ /** Current contract version string (same as {@link CONTRACT_VERSION}). */
120
+ readonly contractVersion: string;
121
+ /** Return the current session, or create one with optional `initial` metadata. */
122
+ ensureSession(initial?: Partial<SessionState>): SessionHandle;
123
+ /** Create a new session and make it current. */
124
+ createSession(initial?: Partial<SessionState>): SessionHandle;
125
+ /** Return the current session handle, or `null` when none is active. */
126
+ getCurrentSession(): SessionHandle | null;
127
+ /** Switch the active session; throws when `sessionId` is unknown. */
128
+ setCurrentSession(sessionId: string): SessionHandle;
129
+ /** Apply constituent patches to the schema (analyze, merge, optionally commit). */
130
+ applySchemaPatch(input: ApplySchemaPatchInput, sessionId?: string): ApplySchemaPatchResult;
131
+ /** Return session summary (default) or full cloned state when `detail` is `'full'`. */
132
+ getSessionState(detail?: SessionStateDetail, sessionId?: string): SessionStateResult;
133
+ /** List diagnostics for the session, optionally filtered by constituent. */
134
+ listDiagnostics(filters?: ListDiagnosticsFilters, sessionId?: string): DiagnosticRecord[];
135
+ /** Parse and type-check an RSLang expression against the current schema context. */
136
+ analyzeExpression(input: AnalyzeExpressionInput, sessionId?: string): AnalysisResult;
137
+ /** Record a revision checkpoint with an optional message. */
138
+ commitStep(message?: string, sessionId?: string): SessionRevision;
139
+ /** Export the session as a JSON string (state + diagnostics). */
140
+ exportSession(sessionId?: string): string;
141
+ /** Export schema or model payload in Portal JSON format. */
142
+ exportPortal(input: ExportPortalInput, sessionId?: string): ExportPortalResult;
143
+ /**
144
+ * Import a session export or Portal JSON payload and make the new session current.
145
+ *
146
+ * When `kind` is `'auto'`, the payload shape is detected automatically.
147
+ */
148
+ importData(payload: string | object, kind?: ImportDataKind): SessionHandle;
149
+ /** Set or clear model values for constituents; returns the updated model state. */
150
+ setModelValues(input: SetModelValuesInput, sessionId?: string): Promise<SessionModelState>;
151
+ /** Return a deep clone of the session model state. */
152
+ getModelState(sessionId?: string): SessionModelState;
153
+ /**
154
+ * Evaluate a stored constituent or a scratch expression.
155
+ *
156
+ * Provide `constituentId`, or both `expression` and `cstType`.
157
+ */
158
+ evaluate(input: EvaluateInput, sessionId?: string): EvaluationResult;
159
+ /** Recompute derived model values for all constituents. */
160
+ recalculateModel(sessionId?: string): RecalculateModelResult;
161
+ }
162
+ //#endregion
163
+ export { ExportPortalInput as a, PortalExportKind as c, PortalModelImportData as d, PortalRsformDetails as f, portalItemToDraft as g, PortalTermForm as h, ExportFormat as i, PORTAL_JSON_CONTRACT_VERSION as l, PortalSchemaImportData as m, RSToolAgentContract as n, ExportPortalResult as o, PortalSchemaConstituenta as p, RSToolAgentOptions as r, ImportDataKind as s, CONTRACT_VERSION as t, PortalImportMetadata as u };
164
+ //# sourceMappingURL=tool-contract-5_Q44DGE.d.ts.map
@@ -1,4 +1,5 @@
1
1
  //#region src/wrapper/client.d.ts
2
+ /** One JSON line emitted by the stdio wrapper (request response or ready event). */
2
3
  interface WrapperResponse<T = unknown> {
3
4
  id: string | number | null;
4
5
  ok: boolean;
@@ -9,20 +10,42 @@ interface WrapperResponse<T = unknown> {
9
10
  details?: unknown;
10
11
  };
11
12
  }
13
+ /** Options for spawning the `rstool-wrapper` child process. */
12
14
  interface RSToolWrapperClientOptions {
15
+ /** Executable to spawn. Default: `npm`. */
13
16
  command?: string;
17
+ /** Arguments passed to `command`. Default: `['run', 'wrapper']`. */
14
18
  args?: string[];
19
+ /** Working directory for the child process. Default: `process.cwd()`. */
15
20
  cwd?: string;
21
+ /** Whether to run the command in a shell. Default: `true`. */
16
22
  shell?: boolean;
17
23
  }
24
+ /**
25
+ * JSON-RPC client for the `rstool-wrapper` stdio process.
26
+ *
27
+ * Sends one JSON request per line on stdin and reads one JSON response per line from stdout.
28
+ */
18
29
  declare class RSToolWrapperClient {
19
30
  private process;
20
31
  private input;
21
32
  private pending;
22
33
  private requestCounter;
34
+ /**
35
+ * @param options - Spawn configuration; defaults run `npm run wrapper` in the current directory.
36
+ */
23
37
  constructor(options?: RSToolWrapperClientOptions);
38
+ /** Block until the wrapper emits its initial `{ ready: true }` event. */
24
39
  waitUntilReady(): Promise<void>;
40
+ /**
41
+ * Invoke a wrapper method and return its `result` field.
42
+ *
43
+ * @param method - Stdio method name (matches {@link RSToolAgentContract} operations).
44
+ * @param params - Method parameters object.
45
+ * @throws When the wrapper responds with `ok: false`.
46
+ */
25
47
  call<T>(method: string, params?: unknown): Promise<T>;
48
+ /** Close stdin and terminate the wrapper process. */
26
49
  close(): Promise<void>;
27
50
  private readOneEvent;
28
51
  private handleLine;
@@ -1,11 +1,19 @@
1
1
  import { spawn } from "node:child_process";
2
2
  import readline from "node:readline";
3
3
  //#region src/wrapper/client.ts
4
+ /**
5
+ * JSON-RPC client for the `rstool-wrapper` stdio process.
6
+ *
7
+ * Sends one JSON request per line on stdin and reads one JSON response per line from stdout.
8
+ */
4
9
  var RSToolWrapperClient = class {
5
10
  process;
6
11
  input;
7
12
  pending = /* @__PURE__ */ new Map();
8
13
  requestCounter = 1;
14
+ /**
15
+ * @param options - Spawn configuration; defaults run `npm run wrapper` in the current directory.
16
+ */
9
17
  constructor(options = {}) {
10
18
  this.process = spawn(options.command ?? "npm", options.args ?? ["run", "wrapper"], {
11
19
  cwd: options.cwd ?? process.cwd(),
@@ -22,6 +30,7 @@ var RSToolWrapperClient = class {
22
30
  });
23
31
  this.input.on("line", (line) => this.handleLine(line));
24
32
  }
33
+ /** Block until the wrapper emits its initial `{ ready: true }` event. */
25
34
  async waitUntilReady() {
26
35
  for (;;) {
27
36
  const line = await this.readOneEvent();
@@ -34,6 +43,13 @@ var RSToolWrapperClient = class {
34
43
  if (response.ok && response.result?.ready) return;
35
44
  }
36
45
  }
46
+ /**
47
+ * Invoke a wrapper method and return its `result` field.
48
+ *
49
+ * @param method - Stdio method name (matches {@link RSToolAgentContract} operations).
50
+ * @param params - Method parameters object.
51
+ * @throws When the wrapper responds with `ok: false`.
52
+ */
37
53
  async call(method, params = {}) {
38
54
  const id = String(this.requestCounter++);
39
55
  const payload = JSON.stringify({
@@ -49,6 +65,7 @@ var RSToolWrapperClient = class {
49
65
  if (!response.ok) throw new Error(`${response.error?.code ?? "UNKNOWN"}: ${response.error?.message ?? "Request failed"}`);
50
66
  return response.result;
51
67
  }
68
+ /** Close stdin and terminate the wrapper process. */
52
69
  async close() {
53
70
  this.input.close();
54
71
  this.process.stdin.end();
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","names":[],"sources":["../../src/wrapper/client.ts"],"sourcesContent":["import { spawn, type ChildProcessByStdio } from 'node:child_process';\nimport readline from 'node:readline';\nimport { type Readable, type Writable } from 'node:stream';\n\nexport interface WrapperResponse<T = unknown> {\n id: string | number | null;\n ok: boolean;\n result?: T;\n error?: {\n code: string;\n message: string;\n details?: unknown;\n };\n}\n\nexport interface RSToolWrapperClientOptions {\n command?: string;\n args?: string[];\n cwd?: string;\n shell?: boolean;\n}\n\nexport class RSToolWrapperClient {\n private process: ChildProcessByStdio<Writable, Readable, null>;\n private input: readline.Interface;\n private pending = new Map<string, (value: WrapperResponse) => void>();\n private requestCounter = 1;\n\n public constructor(options: RSToolWrapperClientOptions = {}) {\n this.process = spawn(options.command ?? 'npm', options.args ?? ['run', 'wrapper'], {\n cwd: options.cwd ?? process.cwd(),\n shell: options.shell ?? true,\n stdio: ['pipe', 'pipe', 'inherit']\n });\n this.input = readline.createInterface({\n input: this.process.stdout,\n crlfDelay: Infinity\n });\n this.input.on('line', line => this.handleLine(line));\n }\n\n public async waitUntilReady(): Promise<void> {\n for (;;) {\n const line = await this.readOneEvent();\n let response: WrapperResponse<{ ready: boolean }> | null = null;\n try {\n response = JSON.parse(line) as WrapperResponse<{ ready: boolean }>;\n } catch {\n continue;\n }\n if (response.ok && response.result?.ready) {\n return;\n }\n }\n }\n\n public async call<T>(method: string, params: unknown = {}): Promise<T> {\n const id = String(this.requestCounter++);\n const payload = JSON.stringify({ id, method, params });\n const responsePromise = new Promise<WrapperResponse>(resolve => {\n this.pending.set(id, resolve);\n });\n this.process.stdin.write(`${payload}\\n`);\n const response = await responsePromise;\n if (!response.ok) {\n throw new Error(`${response.error?.code ?? 'UNKNOWN'}: ${response.error?.message ?? 'Request failed'}`);\n }\n return response.result as T;\n }\n\n public async close(): Promise<void> {\n this.input.close();\n this.process.stdin.end();\n if (!this.process.killed) {\n this.process.kill();\n }\n }\n\n private async readOneEvent(): Promise<string> {\n return new Promise((resolve, reject) => {\n const onLine = (line: string) => {\n cleanup();\n resolve(line);\n };\n const onExit = () => {\n cleanup();\n reject(new Error('Wrapper exited before ready'));\n };\n const cleanup = () => {\n this.input.off('line', onLine);\n this.process.off('exit', onExit);\n };\n this.input.on('line', onLine);\n this.process.on('exit', onExit);\n });\n }\n\n private handleLine(line: string): void {\n let parsed: WrapperResponse;\n try {\n parsed = JSON.parse(line) as WrapperResponse;\n } catch {\n return;\n }\n if (parsed.id === null || parsed.id === undefined) {\n return;\n }\n const id = String(parsed.id);\n const resolver = this.pending.get(id);\n if (!resolver) {\n return;\n }\n this.pending.delete(id);\n resolver(parsed);\n }\n}\n"],"mappings":";;;AAsBA,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA,0BAAkB,IAAI,IAA8C;CACpE,iBAAyB;CAEzB,YAAmB,UAAsC,CAAC,GAAG;EAC3D,KAAK,UAAU,MAAM,QAAQ,WAAW,OAAO,QAAQ,QAAQ,CAAC,OAAO,SAAS,GAAG;GACjF,KAAK,QAAQ,OAAO,QAAQ,IAAI;GAChC,OAAO,QAAQ,SAAS;GACxB,OAAO;IAAC;IAAQ;IAAQ;GAAS;EACnC,CAAC;EACD,KAAK,QAAQ,SAAS,gBAAgB;GACpC,OAAO,KAAK,QAAQ;GACpB,WAAW;EACb,CAAC;EACD,KAAK,MAAM,GAAG,SAAQ,SAAQ,KAAK,WAAW,IAAI,CAAC;CACrD;CAEA,MAAa,iBAAgC;EAC3C,SAAS;GACP,MAAM,OAAO,MAAM,KAAK,aAAa;GACrC,IAAI,WAAuD;GAC3D,IAAI;IACF,WAAW,KAAK,MAAM,IAAI;GAC5B,QAAQ;IACN;GACF;GACA,IAAI,SAAS,MAAM,SAAS,QAAQ,OAClC;EAEJ;CACF;CAEA,MAAa,KAAQ,QAAgB,SAAkB,CAAC,GAAe;EACrE,MAAM,KAAK,OAAO,KAAK,gBAAgB;EACvC,MAAM,UAAU,KAAK,UAAU;GAAE;GAAI;GAAQ;EAAO,CAAC;EACrD,MAAM,kBAAkB,IAAI,SAAyB,YAAW;GAC9D,KAAK,QAAQ,IAAI,IAAI,OAAO;EAC9B,CAAC;EACD,KAAK,QAAQ,MAAM,MAAM,GAAG,QAAQ,GAAG;EACvC,MAAM,WAAW,MAAM;EACvB,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,GAAG,SAAS,OAAO,QAAQ,UAAU,IAAI,SAAS,OAAO,WAAW,kBAAkB;EAExG,OAAO,SAAS;CAClB;CAEA,MAAa,QAAuB;EAClC,KAAK,MAAM,MAAM;EACjB,KAAK,QAAQ,MAAM,IAAI;EACvB,IAAI,CAAC,KAAK,QAAQ,QAChB,KAAK,QAAQ,KAAK;CAEtB;CAEA,MAAc,eAAgC;EAC5C,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,SAAiB;IAC/B,QAAQ;IACR,QAAQ,IAAI;GACd;GACA,MAAM,eAAe;IACnB,QAAQ;IACR,uBAAO,IAAI,MAAM,6BAA6B,CAAC;GACjD;GACA,MAAM,gBAAgB;IACpB,KAAK,MAAM,IAAI,QAAQ,MAAM;IAC7B,KAAK,QAAQ,IAAI,QAAQ,MAAM;GACjC;GACA,KAAK,MAAM,GAAG,QAAQ,MAAM;GAC5B,KAAK,QAAQ,GAAG,QAAQ,MAAM;EAChC,CAAC;CACH;CAEA,WAAmB,MAAoB;EACrC,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI;EAC1B,QAAQ;GACN;EACF;EACA,IAAI,OAAO,OAAO,QAAQ,OAAO,OAAO,QACtC;EAEF,MAAM,KAAK,OAAO,OAAO,EAAE;EAC3B,MAAM,WAAW,KAAK,QAAQ,IAAI,EAAE;EACpC,IAAI,CAAC,UACH;EAEF,KAAK,QAAQ,OAAO,EAAE;EACtB,SAAS,MAAM;CACjB;AACF"}
1
+ {"version":3,"file":"client.js","names":[],"sources":["../../src/wrapper/client.ts"],"sourcesContent":["import { spawn, type ChildProcessByStdio } from 'node:child_process';\nimport readline from 'node:readline';\nimport { type Readable, type Writable } from 'node:stream';\n\n/** One JSON line emitted by the stdio wrapper (request response or ready event). */\nexport interface WrapperResponse<T = unknown> {\n id: string | number | null;\n ok: boolean;\n result?: T;\n error?: {\n code: string;\n message: string;\n details?: unknown;\n };\n}\n\n/** Options for spawning the `rstool-wrapper` child process. */\nexport interface RSToolWrapperClientOptions {\n /** Executable to spawn. Default: `npm`. */\n command?: string;\n /** Arguments passed to `command`. Default: `['run', 'wrapper']`. */\n args?: string[];\n /** Working directory for the child process. Default: `process.cwd()`. */\n cwd?: string;\n /** Whether to run the command in a shell. Default: `true`. */\n shell?: boolean;\n}\n\n/**\n * JSON-RPC client for the `rstool-wrapper` stdio process.\n *\n * Sends one JSON request per line on stdin and reads one JSON response per line from stdout.\n */\nexport class RSToolWrapperClient {\n private process: ChildProcessByStdio<Writable, Readable, null>;\n private input: readline.Interface;\n private pending = new Map<string, (value: WrapperResponse) => void>();\n private requestCounter = 1;\n\n /**\n * @param options - Spawn configuration; defaults run `npm run wrapper` in the current directory.\n */\n public constructor(options: RSToolWrapperClientOptions = {}) {\n this.process = spawn(options.command ?? 'npm', options.args ?? ['run', 'wrapper'], {\n cwd: options.cwd ?? process.cwd(),\n shell: options.shell ?? true,\n stdio: ['pipe', 'pipe', 'inherit']\n });\n this.input = readline.createInterface({\n input: this.process.stdout,\n crlfDelay: Infinity\n });\n this.input.on('line', line => this.handleLine(line));\n }\n\n /** Block until the wrapper emits its initial `{ ready: true }` event. */\n public async waitUntilReady(): Promise<void> {\n for (;;) {\n const line = await this.readOneEvent();\n let response: WrapperResponse<{ ready: boolean }> | null = null;\n try {\n response = JSON.parse(line) as WrapperResponse<{ ready: boolean }>;\n } catch {\n continue;\n }\n if (response.ok && response.result?.ready) {\n return;\n }\n }\n }\n\n /**\n * Invoke a wrapper method and return its `result` field.\n *\n * @param method - Stdio method name (matches {@link RSToolAgentContract} operations).\n * @param params - Method parameters object.\n * @throws When the wrapper responds with `ok: false`.\n */\n public async call<T>(method: string, params: unknown = {}): Promise<T> {\n const id = String(this.requestCounter++);\n const payload = JSON.stringify({ id, method, params });\n const responsePromise = new Promise<WrapperResponse>(resolve => {\n this.pending.set(id, resolve);\n });\n this.process.stdin.write(`${payload}\\n`);\n const response = await responsePromise;\n if (!response.ok) {\n throw new Error(`${response.error?.code ?? 'UNKNOWN'}: ${response.error?.message ?? 'Request failed'}`);\n }\n return response.result as T;\n }\n\n /** Close stdin and terminate the wrapper process. */\n public async close(): Promise<void> {\n this.input.close();\n this.process.stdin.end();\n if (!this.process.killed) {\n this.process.kill();\n }\n }\n\n private async readOneEvent(): Promise<string> {\n return new Promise((resolve, reject) => {\n const onLine = (line: string) => {\n cleanup();\n resolve(line);\n };\n const onExit = () => {\n cleanup();\n reject(new Error('Wrapper exited before ready'));\n };\n const cleanup = () => {\n this.input.off('line', onLine);\n this.process.off('exit', onExit);\n };\n this.input.on('line', onLine);\n this.process.on('exit', onExit);\n });\n }\n\n private handleLine(line: string): void {\n let parsed: WrapperResponse;\n try {\n parsed = JSON.parse(line) as WrapperResponse;\n } catch {\n return;\n }\n if (parsed.id === null || parsed.id === undefined) {\n return;\n }\n const id = String(parsed.id);\n const resolver = this.pending.get(id);\n if (!resolver) {\n return;\n }\n this.pending.delete(id);\n resolver(parsed);\n }\n}\n"],"mappings":";;;;;;;;AAiCA,IAAa,sBAAb,MAAiC;CAC/B;CACA;CACA,0BAAkB,IAAI,IAA8C;CACpE,iBAAyB;;;;CAKzB,YAAmB,UAAsC,CAAC,GAAG;EAC3D,KAAK,UAAU,MAAM,QAAQ,WAAW,OAAO,QAAQ,QAAQ,CAAC,OAAO,SAAS,GAAG;GACjF,KAAK,QAAQ,OAAO,QAAQ,IAAI;GAChC,OAAO,QAAQ,SAAS;GACxB,OAAO;IAAC;IAAQ;IAAQ;GAAS;EACnC,CAAC;EACD,KAAK,QAAQ,SAAS,gBAAgB;GACpC,OAAO,KAAK,QAAQ;GACpB,WAAW;EACb,CAAC;EACD,KAAK,MAAM,GAAG,SAAQ,SAAQ,KAAK,WAAW,IAAI,CAAC;CACrD;;CAGA,MAAa,iBAAgC;EAC3C,SAAS;GACP,MAAM,OAAO,MAAM,KAAK,aAAa;GACrC,IAAI,WAAuD;GAC3D,IAAI;IACF,WAAW,KAAK,MAAM,IAAI;GAC5B,QAAQ;IACN;GACF;GACA,IAAI,SAAS,MAAM,SAAS,QAAQ,OAClC;EAEJ;CACF;;;;;;;;CASA,MAAa,KAAQ,QAAgB,SAAkB,CAAC,GAAe;EACrE,MAAM,KAAK,OAAO,KAAK,gBAAgB;EACvC,MAAM,UAAU,KAAK,UAAU;GAAE;GAAI;GAAQ;EAAO,CAAC;EACrD,MAAM,kBAAkB,IAAI,SAAyB,YAAW;GAC9D,KAAK,QAAQ,IAAI,IAAI,OAAO;EAC9B,CAAC;EACD,KAAK,QAAQ,MAAM,MAAM,GAAG,QAAQ,GAAG;EACvC,MAAM,WAAW,MAAM;EACvB,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,GAAG,SAAS,OAAO,QAAQ,UAAU,IAAI,SAAS,OAAO,WAAW,kBAAkB;EAExG,OAAO,SAAS;CAClB;;CAGA,MAAa,QAAuB;EAClC,KAAK,MAAM,MAAM;EACjB,KAAK,QAAQ,MAAM,IAAI;EACvB,IAAI,CAAC,KAAK,QAAQ,QAChB,KAAK,QAAQ,KAAK;CAEtB;CAEA,MAAc,eAAgC;EAC5C,OAAO,IAAI,SAAS,SAAS,WAAW;GACtC,MAAM,UAAU,SAAiB;IAC/B,QAAQ;IACR,QAAQ,IAAI;GACd;GACA,MAAM,eAAe;IACnB,QAAQ;IACR,uBAAO,IAAI,MAAM,6BAA6B,CAAC;GACjD;GACA,MAAM,gBAAgB;IACpB,KAAK,MAAM,IAAI,QAAQ,MAAM;IAC7B,KAAK,QAAQ,IAAI,QAAQ,MAAM;GACjC;GACA,KAAK,MAAM,GAAG,QAAQ,MAAM;GAC5B,KAAK,QAAQ,GAAG,QAAQ,MAAM;EAChC,CAAC;CACH;CAEA,WAAmB,MAAoB;EACrC,IAAI;EACJ,IAAI;GACF,SAAS,KAAK,MAAM,IAAI;EAC1B,QAAQ;GACN;EACF;EACA,IAAI,OAAO,OAAO,QAAQ,OAAO,OAAO,QACtC;EAEF,MAAM,KAAK,OAAO,OAAO,EAAE;EAC3B,MAAM,WAAW,KAAK,QAAQ,IAAI,EAAE;EACpC,IAAI,CAAC,UACH;EAEF,KAAK,QAAQ,OAAO,EAAE;EACtB,SAAS,MAAM;CACjB;AACF"}