@llm4ts/flow 0.1.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 (198) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +41 -0
  3. package/dist/AzureDevOpsTool.d.ts +60 -0
  4. package/dist/AzureDevOpsTool.d.ts.map +1 -0
  5. package/dist/AzureDevOpsTool.js +163 -0
  6. package/dist/AzureDevOpsTool.js.map +1 -0
  7. package/dist/Bench.d.ts +133 -0
  8. package/dist/Bench.d.ts.map +1 -0
  9. package/dist/Bench.js +272 -0
  10. package/dist/Bench.js.map +1 -0
  11. package/dist/BenchReport.d.ts +9 -0
  12. package/dist/BenchReport.d.ts.map +1 -0
  13. package/dist/BenchReport.js +360 -0
  14. package/dist/BenchReport.js.map +1 -0
  15. package/dist/CapabilityGuard.d.ts +6 -0
  16. package/dist/CapabilityGuard.d.ts.map +1 -0
  17. package/dist/CapabilityGuard.js +25 -0
  18. package/dist/CapabilityGuard.js.map +1 -0
  19. package/dist/Chat.d.ts +15 -0
  20. package/dist/Chat.d.ts.map +1 -0
  21. package/dist/Chat.js +36 -0
  22. package/dist/Chat.js.map +1 -0
  23. package/dist/Classified.d.ts +14 -0
  24. package/dist/Classified.d.ts.map +1 -0
  25. package/dist/Classified.js +48 -0
  26. package/dist/Classified.js.map +1 -0
  27. package/dist/CostLedger.d.ts +55 -0
  28. package/dist/CostLedger.d.ts.map +1 -0
  29. package/dist/CostLedger.js +126 -0
  30. package/dist/CostLedger.js.map +1 -0
  31. package/dist/CostTracker.d.ts +13 -0
  32. package/dist/CostTracker.d.ts.map +1 -0
  33. package/dist/CostTracker.js +116 -0
  34. package/dist/CostTracker.js.map +1 -0
  35. package/dist/Equiv.d.ts +163 -0
  36. package/dist/Equiv.d.ts.map +1 -0
  37. package/dist/Equiv.js +256 -0
  38. package/dist/Equiv.js.map +1 -0
  39. package/dist/EquivReport.d.ts +16 -0
  40. package/dist/EquivReport.d.ts.map +1 -0
  41. package/dist/EquivReport.js +77 -0
  42. package/dist/EquivReport.js.map +1 -0
  43. package/dist/Flow.d.ts +25 -0
  44. package/dist/Flow.d.ts.map +1 -0
  45. package/dist/Flow.js +39 -0
  46. package/dist/Flow.js.map +1 -0
  47. package/dist/FlowContext.d.ts +23 -0
  48. package/dist/FlowContext.d.ts.map +1 -0
  49. package/dist/FlowContext.js +4 -0
  50. package/dist/FlowContext.js.map +1 -0
  51. package/dist/FlowError.d.ts +80 -0
  52. package/dist/FlowError.d.ts.map +1 -0
  53. package/dist/FlowError.js +92 -0
  54. package/dist/FlowError.js.map +1 -0
  55. package/dist/FlowEvents.d.ts +101 -0
  56. package/dist/FlowEvents.d.ts.map +1 -0
  57. package/dist/FlowEvents.js +103 -0
  58. package/dist/FlowEvents.js.map +1 -0
  59. package/dist/FlowRecorder.d.ts +26 -0
  60. package/dist/FlowRecorder.d.ts.map +1 -0
  61. package/dist/FlowRecorder.js +74 -0
  62. package/dist/FlowRecorder.js.map +1 -0
  63. package/dist/GitHubTool.d.ts +53 -0
  64. package/dist/GitHubTool.d.ts.map +1 -0
  65. package/dist/GitHubTool.js +191 -0
  66. package/dist/GitHubTool.js.map +1 -0
  67. package/dist/GitTool.d.ts +46 -0
  68. package/dist/GitTool.d.ts.map +1 -0
  69. package/dist/GitTool.js +97 -0
  70. package/dist/GitTool.js.map +1 -0
  71. package/dist/Interaction.d.ts +21 -0
  72. package/dist/Interaction.d.ts.map +1 -0
  73. package/dist/Interaction.js +9 -0
  74. package/dist/Interaction.js.map +1 -0
  75. package/dist/McpServer.d.ts +18 -0
  76. package/dist/McpServer.d.ts.map +1 -0
  77. package/dist/McpServer.js +122 -0
  78. package/dist/McpServer.js.map +1 -0
  79. package/dist/Mermaid.d.ts +7 -0
  80. package/dist/Mermaid.d.ts.map +1 -0
  81. package/dist/Mermaid.js +98 -0
  82. package/dist/Mermaid.js.map +1 -0
  83. package/dist/Pack.d.ts +40 -0
  84. package/dist/Pack.d.ts.map +1 -0
  85. package/dist/Pack.js +141 -0
  86. package/dist/Pack.js.map +1 -0
  87. package/dist/Package.d.ts +2 -0
  88. package/dist/Package.d.ts.map +1 -0
  89. package/dist/Package.js +2 -0
  90. package/dist/Package.js.map +1 -0
  91. package/dist/Persistence.d.ts +32 -0
  92. package/dist/Persistence.d.ts.map +1 -0
  93. package/dist/Persistence.js +85 -0
  94. package/dist/Persistence.js.map +1 -0
  95. package/dist/Plan.d.ts +26 -0
  96. package/dist/Plan.d.ts.map +1 -0
  97. package/dist/Plan.js +101 -0
  98. package/dist/Plan.js.map +1 -0
  99. package/dist/PlanExecution.d.ts +7 -0
  100. package/dist/PlanExecution.d.ts.map +1 -0
  101. package/dist/PlanExecution.js +19 -0
  102. package/dist/PlanExecution.js.map +1 -0
  103. package/dist/Planner.d.ts +32 -0
  104. package/dist/Planner.d.ts.map +1 -0
  105. package/dist/Planner.js +97 -0
  106. package/dist/Planner.js.map +1 -0
  107. package/dist/PrSummary.d.ts +15 -0
  108. package/dist/PrSummary.d.ts.map +1 -0
  109. package/dist/PrSummary.js +29 -0
  110. package/dist/PrSummary.js.map +1 -0
  111. package/dist/PriceList.d.ts +11 -0
  112. package/dist/PriceList.d.ts.map +1 -0
  113. package/dist/PriceList.js +79 -0
  114. package/dist/PriceList.js.map +1 -0
  115. package/dist/Provenance.d.ts +27 -0
  116. package/dist/Provenance.d.ts.map +1 -0
  117. package/dist/Provenance.js +38 -0
  118. package/dist/Provenance.js.map +1 -0
  119. package/dist/Replay.d.ts +29 -0
  120. package/dist/Replay.d.ts.map +1 -0
  121. package/dist/Replay.js +181 -0
  122. package/dist/Replay.js.map +1 -0
  123. package/dist/Review.d.ts +71 -0
  124. package/dist/Review.d.ts.map +1 -0
  125. package/dist/Review.js +204 -0
  126. package/dist/Review.js.map +1 -0
  127. package/dist/ReviewCache.d.ts +6 -0
  128. package/dist/ReviewCache.d.ts.map +1 -0
  129. package/dist/ReviewCache.js +28 -0
  130. package/dist/ReviewCache.js.map +1 -0
  131. package/dist/Reviewer.d.ts +12 -0
  132. package/dist/Reviewer.d.ts.map +1 -0
  133. package/dist/Reviewer.js +30 -0
  134. package/dist/Reviewer.js.map +1 -0
  135. package/dist/SpecChecks.d.ts +17 -0
  136. package/dist/SpecChecks.d.ts.map +1 -0
  137. package/dist/SpecChecks.js +107 -0
  138. package/dist/SpecChecks.js.map +1 -0
  139. package/dist/Survey.d.ts +32 -0
  140. package/dist/Survey.d.ts.map +1 -0
  141. package/dist/Survey.js +119 -0
  142. package/dist/Survey.js.map +1 -0
  143. package/dist/TransientRetry.d.ts +16 -0
  144. package/dist/TransientRetry.d.ts.map +1 -0
  145. package/dist/TransientRetry.js +102 -0
  146. package/dist/TransientRetry.js.map +1 -0
  147. package/dist/Workspace.d.ts +39 -0
  148. package/dist/Workspace.d.ts.map +1 -0
  149. package/dist/Workspace.js +192 -0
  150. package/dist/Workspace.js.map +1 -0
  151. package/dist/WorkspaceLayout.d.ts +3 -0
  152. package/dist/WorkspaceLayout.d.ts.map +1 -0
  153. package/dist/WorkspaceLayout.js +19 -0
  154. package/dist/WorkspaceLayout.js.map +1 -0
  155. package/dist/WorkspaceTools.d.ts +4 -0
  156. package/dist/WorkspaceTools.d.ts.map +1 -0
  157. package/dist/WorkspaceTools.js +130 -0
  158. package/dist/WorkspaceTools.js.map +1 -0
  159. package/package.json +91 -0
  160. package/src/AzureDevOpsTool.ts +291 -0
  161. package/src/Bench.ts +340 -0
  162. package/src/BenchReport.ts +447 -0
  163. package/src/CapabilityGuard.ts +43 -0
  164. package/src/Chat.ts +60 -0
  165. package/src/Classified.ts +67 -0
  166. package/src/CostLedger.ts +171 -0
  167. package/src/CostTracker.ts +170 -0
  168. package/src/Equiv.ts +378 -0
  169. package/src/EquivReport.ts +92 -0
  170. package/src/Flow.ts +72 -0
  171. package/src/FlowContext.ts +23 -0
  172. package/src/FlowError.ts +112 -0
  173. package/src/FlowEvents.ts +147 -0
  174. package/src/FlowRecorder.ts +116 -0
  175. package/src/GitHubTool.ts +315 -0
  176. package/src/GitTool.ts +214 -0
  177. package/src/Interaction.ts +23 -0
  178. package/src/McpServer.ts +168 -0
  179. package/src/Mermaid.ts +112 -0
  180. package/src/Pack.ts +213 -0
  181. package/src/Package.ts +1 -0
  182. package/src/Persistence.ts +198 -0
  183. package/src/Plan.ts +119 -0
  184. package/src/PlanExecution.ts +46 -0
  185. package/src/Planner.ts +134 -0
  186. package/src/PrSummary.ts +37 -0
  187. package/src/PriceList.ts +91 -0
  188. package/src/Provenance.ts +85 -0
  189. package/src/Replay.ts +265 -0
  190. package/src/Review.ts +337 -0
  191. package/src/ReviewCache.ts +45 -0
  192. package/src/Reviewer.ts +31 -0
  193. package/src/SpecChecks.ts +143 -0
  194. package/src/Survey.ts +144 -0
  195. package/src/TransientRetry.ts +238 -0
  196. package/src/Workspace.ts +255 -0
  197. package/src/WorkspaceLayout.ts +22 -0
  198. package/src/WorkspaceTools.ts +188 -0
package/dist/Survey.js ADDED
@@ -0,0 +1,119 @@
1
+ import * as Effect from "effect/Effect";
2
+ import * as Schema from "effect/Schema";
3
+ export class SurveyNode extends Schema.Class("SurveyNode")({
4
+ path: Schema.String,
5
+ name: Schema.String,
6
+ lines: Schema.Int,
7
+ units: Schema.Int
8
+ }) {
9
+ }
10
+ export class SurveyEdge extends Schema.Class("SurveyEdge")({
11
+ from: Schema.String,
12
+ to: Schema.String,
13
+ kind: Schema.String
14
+ }) {
15
+ }
16
+ export class SurveyGraph extends Schema.Class("SurveyGraph")({
17
+ nodes: Schema.Array(SurveyNode),
18
+ edges: Schema.Array(SurveyEdge)
19
+ }) {
20
+ incoming(name) {
21
+ return this.edges.filter((edge) => edge.to === name);
22
+ }
23
+ outgoing(name) {
24
+ return this.edges.filter((edge) => edge.from === name);
25
+ }
26
+ }
27
+ const unitName = (path) => {
28
+ const base = path.split("/").at(-1) ?? path;
29
+ const dot = base.lastIndexOf(".");
30
+ return dot < 0 ? base : base.slice(0, dot);
31
+ };
32
+ const matches = (regex, contents) => {
33
+ const expression = new RegExp(regex, "g");
34
+ return [...contents.matchAll(expression)].map((match) => match[1] ?? match[0]);
35
+ };
36
+ export const surveyGraph = Effect.fn("@llm4ts/flow/Survey.graph")(function* (workspace, sources, units, edgeRules) {
37
+ const sourcePattern = new RegExp(sources);
38
+ const paths = (yield* workspace.discover()).filter((path) => sourcePattern.test(path)).sort();
39
+ const nodes = [];
40
+ const contents = new Map();
41
+ for (const path of paths) {
42
+ const text = yield* workspace.read(path);
43
+ contents.set(path, text);
44
+ nodes.push(SurveyNode.make({
45
+ path,
46
+ name: unitName(path),
47
+ lines: text.split(/\r?\n/).length,
48
+ units: units
49
+ .filter((rule) => new RegExp(rule.files).test(path))
50
+ .reduce((count, rule) => count + matches(rule.unit, text).length, 0)
51
+ }));
52
+ }
53
+ const edges = [];
54
+ for (const rule of edgeRules) {
55
+ const filePattern = new RegExp(rule.files);
56
+ for (const path of paths.filter((path) => filePattern.test(path))) {
57
+ for (const target of new Set(matches(rule.unit, contents.get(path) ?? ""))) {
58
+ const edge = SurveyEdge.make({
59
+ from: unitName(path),
60
+ to: target,
61
+ kind: rule.name
62
+ });
63
+ if (!edges.some((current) => current.from === edge.from && current.to === edge.to && current.kind === edge.kind)) {
64
+ edges.push(edge);
65
+ }
66
+ }
67
+ }
68
+ }
69
+ return SurveyGraph.make({ nodes, edges });
70
+ });
71
+ export const mergeSurveyEdges = (graph, refined) => {
72
+ const known = new Set(graph.nodes.map((node) => node.name));
73
+ const existing = new Set(graph.edges.map((edge) => `${edge.from}\u0000${edge.to}`));
74
+ const seen = new Set();
75
+ const kept = refined.flatMap((edge) => {
76
+ const key = `${edge.from}\u0000${edge.to}`;
77
+ if (edge.from === edge.to ||
78
+ !known.has(edge.from) ||
79
+ !known.has(edge.to) ||
80
+ existing.has(key) ||
81
+ seen.has(key)) {
82
+ return [];
83
+ }
84
+ seen.add(key);
85
+ return [
86
+ new SurveyEdge({
87
+ ...edge,
88
+ kind: edge.kind.startsWith("llm-") ? edge.kind : `llm-${edge.kind}`
89
+ })
90
+ ];
91
+ });
92
+ return new SurveyGraph({
93
+ nodes: graph.nodes,
94
+ edges: [...graph.edges, ...kept]
95
+ });
96
+ };
97
+ export const renderSurveyInventory = (graph) => {
98
+ const rows = [...graph.nodes]
99
+ .sort((left, right) => left.name.localeCompare(right.name))
100
+ .map((node) => {
101
+ const incoming = graph.incoming(node.name).length;
102
+ const outgoing = graph.outgoing(node.name).length;
103
+ const flags = incoming === 0 && outgoing === 0 ? "unreferenced — retire candidate?" : "";
104
+ return `| ${node.name} | ${node.path} | ${node.lines} | ${node.units} | ${incoming} | ${outgoing} | ${flags} |`;
105
+ });
106
+ const refined = graph.edges.filter((edge) => edge.kind.startsWith("llm-")).length;
107
+ return [
108
+ "# Estate inventory",
109
+ "",
110
+ "| Unit | Path | Lines | Units | In | Out | Flags |",
111
+ "| ---- | ---- | ----- | ----- | -- | --- | ----- |",
112
+ ...rows,
113
+ "",
114
+ `${graph.nodes.length} unit(s), ${graph.edges.length} edge(s).`,
115
+ ...(refined === 0 ? [] : [`${refined} edge(s) came from the LLM graph-refine step.`]),
116
+ ""
117
+ ].join("\n");
118
+ };
119
+ //# sourceMappingURL=Survey.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Survey.js","sourceRoot":"","sources":["../src/Survey.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import * as Duration from "effect/Duration";
2
+ import * as Effect from "effect/Effect";
3
+ import type { LlmError } from "@llm4ts/core/Errors";
4
+ import { type LlmServiceShape } from "@llm4ts/core/LlmService";
5
+ import { FlowEvents } from "./FlowEvents.ts";
6
+ export declare const isFlakyStream: (error: LlmError) => boolean;
7
+ export declare const isTransient: (error: LlmError) => boolean;
8
+ export declare const transientDelay: (error: LlmError, backoff: Duration.Duration) => Duration.Duration;
9
+ export interface TransientRetryOptions {
10
+ readonly maxRetries?: number;
11
+ readonly baseDelay?: Duration.Input;
12
+ readonly flakyRetries?: number;
13
+ readonly flakyDelay?: Duration.Input;
14
+ }
15
+ export declare const makeTransientRetry: (underlying: LlmServiceShape, retryOptions?: TransientRetryOptions | undefined) => Effect.Effect<LlmServiceShape, never, FlowEvents>;
16
+ //# sourceMappingURL=TransientRetry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TransientRetry.d.ts","sourceRoot":"","sources":["../src/TransientRetry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAE1E,OAAO,EAAE,UAAU,EAAQ,MAAM,iBAAiB,CAAA;AAkClD,eAAO,MAAM,aAAa,GAAI,OAAO,QAAQ,KAAG,OACqC,CAAA;AAErF,eAAO,MAAM,WAAW,GAAI,OAAO,QAAQ,KAAG,OAU7C,CAAA;AAID,eAAO,MAAM,cAAc,GAAI,OAAO,QAAQ,EAAE,SAAS,QAAQ,CAAC,QAAQ,KAAG,QAAQ,CAAC,QAMrF,CAAA;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAA;CACrC;AAyID,eAAO,MAAM,kBAAkB,sIA8B7B,CAAA"}
@@ -0,0 +1,102 @@
1
+ import * as Duration from "effect/Duration";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Stream from "effect/Stream";
4
+ import { LlmService } from "@llm4ts/core/LlmService";
5
+ import { FlowEvents, Info } from "./FlowEvents.js";
6
+ const transientSignals = [
7
+ "connection reset",
8
+ "server_error",
9
+ "internal error",
10
+ "service unavailable",
11
+ "unavailable",
12
+ "overloaded",
13
+ "temporarily",
14
+ "timed out",
15
+ "api error",
16
+ "unknown error",
17
+ "code=500",
18
+ "code=502",
19
+ "code=503",
20
+ "code=504",
21
+ " 500",
22
+ " 502",
23
+ " 503",
24
+ " 504"
25
+ ];
26
+ const flakyStreamSignals = [
27
+ "empty response",
28
+ "malformed tool call",
29
+ "invalid stream"
30
+ ];
31
+ const includesSignal = (message, signals) => {
32
+ const normalized = message.toLowerCase();
33
+ return signals.some((signal) => normalized.includes(signal));
34
+ };
35
+ export const isFlakyStream = (error) => error._tag === "ProviderError" && includesSignal(error.message, flakyStreamSignals);
36
+ export const isTransient = (error) => {
37
+ switch (error._tag) {
38
+ case "TimeoutError":
39
+ case "RateLimitError":
40
+ return true;
41
+ case "ProviderError":
42
+ return !isFlakyStream(error) && includesSignal(error.message, transientSignals);
43
+ default:
44
+ return false;
45
+ }
46
+ };
47
+ const maxHonoredRetryAfter = Duration.minutes(2);
48
+ export const transientDelay = (error, backoff) => {
49
+ if (error._tag !== "RateLimitError" || error.retryAfter === undefined) {
50
+ return backoff;
51
+ }
52
+ return Duration.max(backoff, Duration.min(error.retryAfter, maxHonoredRetryAfter));
53
+ };
54
+ const resolveOptions = (options) => ({
55
+ maxRetries: options.maxRetries ?? 3,
56
+ baseDelay: Duration.fromInputUnsafe(options.baseDelay ?? "1 second"),
57
+ flakyRetries: options.flakyRetries ?? 6,
58
+ flakyDelay: Duration.fromInputUnsafe(options.flakyDelay ?? "1 second")
59
+ });
60
+ const backoff = (baseDelay, attempt) => Duration.times(baseDelay, 2 ** attempt);
61
+ const retryNotice = (events, what, attempt, maximum, error) => events.publish(Info.make({
62
+ message: `⟳ ${what} — retry ${attempt + 1}/${maximum}: ${error.message}`
63
+ }));
64
+ const waitForRetry = (events, what, attempt, maximum, error, delay) => retryNotice(events, what, attempt, maximum, error).pipe(Effect.andThen(Effect.sleep(delay)));
65
+ const retryEffect = (effect, what, options, events) => {
66
+ const loop = (transientAttempt, flakyAttempt) => Effect.catchIf(effect, () => true, (error) => {
67
+ if (isFlakyStream(error) && flakyAttempt < options.flakyRetries) {
68
+ return waitForRetry(events, `flaky ${what} (fresh retry)`, flakyAttempt, options.flakyRetries, error, options.flakyDelay).pipe(Effect.andThen(Effect.suspend(() => loop(transientAttempt, flakyAttempt + 1))));
69
+ }
70
+ if (isTransient(error) && transientAttempt < options.maxRetries) {
71
+ return waitForRetry(events, `transient error (${what})`, transientAttempt, options.maxRetries, error, transientDelay(error, backoff(options.baseDelay, transientAttempt))).pipe(Effect.andThen(Effect.suspend(() => loop(transientAttempt + 1, flakyAttempt))));
72
+ }
73
+ return Effect.fail(error);
74
+ });
75
+ return loop(0, 0);
76
+ };
77
+ const retryStream = (stream, what, options, events) => {
78
+ const waitThenRetry = (notice, next) => Stream.concat(Stream.drain(Stream.fromEffect(notice)), Stream.suspend(next));
79
+ const loop = (transientAttempt, flakyAttempt) => Stream.catchIf(stream, () => true, (error) => {
80
+ if (isFlakyStream(error) && flakyAttempt < options.flakyRetries) {
81
+ return waitThenRetry(waitForRetry(events, `flaky ${what} (fresh retry)`, flakyAttempt, options.flakyRetries, error, options.flakyDelay), () => loop(transientAttempt, flakyAttempt + 1));
82
+ }
83
+ if (isTransient(error) && transientAttempt < options.maxRetries) {
84
+ return waitThenRetry(waitForRetry(events, `transient error (${what})`, transientAttempt, options.maxRetries, error, transientDelay(error, backoff(options.baseDelay, transientAttempt))), () => loop(transientAttempt + 1, flakyAttempt));
85
+ }
86
+ return Stream.fail(error);
87
+ });
88
+ return loop(0, 0);
89
+ };
90
+ export const makeTransientRetry = Effect.fn("@llm4ts/flow/TransientRetry.make")(function* (underlying, retryOptions = {}) {
91
+ const events = yield* FlowEvents;
92
+ const options = resolveOptions(retryOptions);
93
+ return LlmService.of({
94
+ executeStream: (prompt) => retryStream(underlying.executeStream(prompt), "stream", options, events),
95
+ executeStreamWithHistory: (messages) => retryStream(underlying.executeStreamWithHistory(messages), "stream", options, events),
96
+ executeWithTools: (prompt, tools) => retryEffect(underlying.executeWithTools(prompt, tools), "tools", options, events),
97
+ executeStructured: (prompt, schema, jsonSchema) => retryEffect(underlying.executeStructured(prompt, schema, jsonSchema), "structured", options, events),
98
+ executeStructuredWithUsage: (prompt, schema, jsonSchema) => retryEffect(underlying.executeStructuredWithUsage(prompt, schema, jsonSchema), "structured", options, events),
99
+ isAvailable: underlying.isAvailable
100
+ });
101
+ });
102
+ //# sourceMappingURL=TransientRetry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"TransientRetry.js","sourceRoot":"","sources":["../src/TransientRetry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import * as Context from "effect/Context";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Schema from "effect/Schema";
4
+ import { WorkspaceIoError, WorkspaceLimitError, WorkspacePathError } from "./FlowError.ts";
5
+ export type WorkspaceError = WorkspacePathError | WorkspaceLimitError | WorkspaceIoError;
6
+ declare const SearchMatch_base: Schema.Class<SearchMatch, Schema.Struct<{
7
+ readonly path: Schema.String;
8
+ readonly line: Schema.Int;
9
+ readonly text: Schema.String;
10
+ }>, {}>;
11
+ export declare class SearchMatch extends SearchMatch_base {
12
+ }
13
+ export interface WorkspaceLimits {
14
+ readonly maxReadBytes: number;
15
+ readonly maxWriteBytes: number;
16
+ readonly maxResults: number;
17
+ readonly maxDepth: number;
18
+ }
19
+ export declare const defaultWorkspaceLimits: WorkspaceLimits;
20
+ export interface WorkspaceShape {
21
+ readonly root: string;
22
+ readonly resolve: (path: string) => Effect.Effect<string, WorkspaceError>;
23
+ readonly read: (path: string) => Effect.Effect<string, WorkspaceError>;
24
+ readonly write: (path: string, contents: string) => Effect.Effect<void, WorkspaceError>;
25
+ readonly append: (path: string, contents: string) => Effect.Effect<void, WorkspaceError>;
26
+ readonly discover: (pattern?: string) => Effect.Effect<ReadonlyArray<string>, WorkspaceError>;
27
+ readonly search: (query: string, pattern?: string) => Effect.Effect<ReadonlyArray<SearchMatch>, WorkspaceError>;
28
+ }
29
+ declare const Workspace_base: Context.ServiceClass<Workspace, "@llm4ts/flow/Workspace", WorkspaceShape>;
30
+ export declare class Workspace extends Workspace_base {
31
+ }
32
+ export interface MemoryWorkspaceOptions {
33
+ readonly root?: string;
34
+ readonly limits?: WorkspaceLimits;
35
+ readonly initial?: Readonly<Record<string, string>>;
36
+ }
37
+ export declare const makeMemoryWorkspace: (options?: MemoryWorkspaceOptions) => Effect.Effect<WorkspaceShape>;
38
+ export {};
39
+ //# sourceMappingURL=Workspace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Workspace.d.ts","sourceRoot":"","sources":["../src/Workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAE1F,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,CAAA;;;;;;AAExF,qBAAa,WAAY,SAAQ,gBAI/B;CAAG;AAEL,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,sBAAsB,EAAE,eAKnC,CAAA;AAEF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACzE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IACvF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IACxF,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAA;IAC7F,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAA;CAC/D;;AAED,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAmCJ,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACpD;AAED,eAAO,MAAM,mBAAmB,GAC9B,UAAS,sBAA2B,KACnC,MAAM,CAAC,MAAM,CAAC,cAAc,CAwK9B,CAAA"}
@@ -0,0 +1,192 @@
1
+ import * as Context from "effect/Context";
2
+ import * as Effect from "effect/Effect";
3
+ import * as Ref from "effect/Ref";
4
+ import * as Schema from "effect/Schema";
5
+ import { WorkspaceIoError, WorkspaceLimitError, WorkspacePathError } from "./FlowError.js";
6
+ export class SearchMatch extends Schema.Class("SearchMatch")({
7
+ path: Schema.String,
8
+ line: Schema.Int,
9
+ text: Schema.String
10
+ }) {
11
+ }
12
+ export const defaultWorkspaceLimits = Object.freeze({
13
+ maxReadBytes: 1_048_576,
14
+ maxWriteBytes: 1_048_576,
15
+ maxResults: 1_000,
16
+ maxDepth: 32
17
+ });
18
+ export class Workspace extends Context.Service()("@llm4ts/flow/Workspace") {
19
+ }
20
+ const globRegex = (glob) => {
21
+ let source = "";
22
+ for (let index = 0; index < glob.length; index += 1) {
23
+ const character = glob.charAt(index);
24
+ if (character === "*" && glob.charAt(index + 1) === "*") {
25
+ source += ".*";
26
+ index += 1;
27
+ }
28
+ else if (character === "*") {
29
+ source += "[^/]*";
30
+ }
31
+ else if (character === "?") {
32
+ source += "[^/]";
33
+ }
34
+ else {
35
+ source += character.replace(/[\\^$.[\]{}()+|]/g, "\\$&");
36
+ }
37
+ }
38
+ return new RegExp(`^${source}$`);
39
+ };
40
+ const comparePaths = (left, right) => {
41
+ const leftSegments = left.split("/");
42
+ const rightSegments = right.split("/");
43
+ const shared = Math.min(leftSegments.length, rightSegments.length);
44
+ for (let index = 0; index < shared; index += 1) {
45
+ const order = (leftSegments[index] ?? "").localeCompare(rightSegments[index] ?? "");
46
+ if (order !== 0) {
47
+ return order;
48
+ }
49
+ }
50
+ return leftSegments.length - rightSegments.length;
51
+ };
52
+ const byteLength = (contents) => new TextEncoder().encode(contents).length;
53
+ export const makeMemoryWorkspace = (options = {}) => {
54
+ const root = (options.root ?? "/workspace").replace(/\/+$/, "");
55
+ const limits = options.limits ?? defaultWorkspaceLimits;
56
+ const relativeKey = (input) => {
57
+ const normalized = input.replaceAll("\\", "/");
58
+ const withoutRoot = normalized === root
59
+ ? ""
60
+ : normalized.startsWith(`${root}/`)
61
+ ? normalized.slice(root.length + 1)
62
+ : normalized;
63
+ if (withoutRoot.startsWith("/")) {
64
+ return undefined;
65
+ }
66
+ const segments = [];
67
+ for (const part of withoutRoot.split("/")) {
68
+ if (part === "" || part === ".") {
69
+ continue;
70
+ }
71
+ if (part === "..") {
72
+ if (segments.length === 0) {
73
+ return undefined;
74
+ }
75
+ segments.pop();
76
+ }
77
+ else {
78
+ segments.push(part);
79
+ }
80
+ }
81
+ return segments.join("/");
82
+ };
83
+ const resolveKey = (input) => {
84
+ const key = relativeKey(input);
85
+ return key === undefined
86
+ ? Effect.fail(WorkspacePathError.make({
87
+ path: input,
88
+ message: "path escapes the configured workspace"
89
+ }))
90
+ : Effect.succeed(key);
91
+ };
92
+ return Ref.make(options.initial ?? {}).pipe(Effect.map((state) => {
93
+ const read = (input) => Effect.gen(function* () {
94
+ const key = yield* resolveKey(input);
95
+ const files = yield* Ref.get(state);
96
+ const contents = files[key];
97
+ if (contents === undefined) {
98
+ return yield* WorkspaceIoError.make({
99
+ operation: "read",
100
+ path: input,
101
+ message: "file does not exist"
102
+ });
103
+ }
104
+ const bytes = byteLength(contents);
105
+ if (bytes > limits.maxReadBytes) {
106
+ return yield* WorkspaceLimitError.make({
107
+ operation: "read bytes",
108
+ limit: limits.maxReadBytes,
109
+ actual: bytes
110
+ });
111
+ }
112
+ return contents;
113
+ });
114
+ const writeBounded = (operation, input, contents) => {
115
+ const bytes = byteLength(contents);
116
+ if (bytes > limits.maxWriteBytes) {
117
+ return Effect.fail(WorkspaceLimitError.make({
118
+ operation: `${operation} bytes`,
119
+ limit: limits.maxWriteBytes,
120
+ actual: bytes
121
+ }));
122
+ }
123
+ return resolveKey(input).pipe(Effect.flatMap((key) => Ref.update(state, (files) => ({
124
+ ...files,
125
+ [key]: operation === "write" ? contents : `${files[key] ?? ""}${contents}`
126
+ }))));
127
+ };
128
+ const discover = (pattern = "**/*") => Effect.gen(function* () {
129
+ const normalizedPattern = pattern.replaceAll("\\", "/");
130
+ const matcher = normalizedPattern === "**/*" ? /.*/ : globRegex(normalizedPattern);
131
+ const files = yield* Ref.get(state);
132
+ const results = [];
133
+ for (const path of Object.keys(files).sort(comparePaths)) {
134
+ const depth = path.split("/").length - 1;
135
+ if (depth > limits.maxDepth) {
136
+ return yield* WorkspaceLimitError.make({
137
+ operation: "discovery depth",
138
+ limit: limits.maxDepth,
139
+ actual: depth
140
+ });
141
+ }
142
+ if (matcher.test(path)) {
143
+ results.push(path);
144
+ if (results.length > limits.maxResults) {
145
+ return yield* WorkspaceLimitError.make({
146
+ operation: "discovery results",
147
+ limit: limits.maxResults,
148
+ actual: results.length
149
+ });
150
+ }
151
+ }
152
+ }
153
+ return results;
154
+ });
155
+ const search = (query, pattern = "**/*") => Effect.gen(function* () {
156
+ const paths = yield* discover(pattern);
157
+ const matches = [];
158
+ for (const path of paths) {
159
+ const text = yield* read(path);
160
+ const lines = text.split("\n");
161
+ for (let index = 0; index < lines.length; index += 1) {
162
+ const line = lines[index] ?? "";
163
+ if (line.includes(query)) {
164
+ matches.push(SearchMatch.make({
165
+ path,
166
+ line: index + 1,
167
+ text: line
168
+ }));
169
+ if (matches.length > limits.maxResults) {
170
+ return yield* WorkspaceLimitError.make({
171
+ operation: "search results",
172
+ limit: limits.maxResults,
173
+ actual: matches.length
174
+ });
175
+ }
176
+ }
177
+ }
178
+ }
179
+ return matches;
180
+ });
181
+ return {
182
+ root,
183
+ resolve: (input) => resolveKey(input).pipe(Effect.map((key) => (key === "" ? root : `${root}/${key}`))),
184
+ read,
185
+ write: (path, contents) => writeBounded("write", path, contents),
186
+ append: (path, contents) => writeBounded("append", path, contents),
187
+ discover,
188
+ search
189
+ };
190
+ }));
191
+ };
192
+ //# sourceMappingURL=Workspace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Workspace.js","sourceRoot":"","sources":["../src/Workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAA;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAA;AACjC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAI1F,MAAM,OAAO,WAAY,SAAQ,MAAM,CAAC,KAAK,CAAc,aAAa,CAAC,CAAC;IACxE,IAAI,EAAE,MAAM,CAAC,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM;CACpB,CAAC;CAAG;AASL,MAAM,CAAC,MAAM,sBAAsB,GAAoB,MAAM,CAAC,MAAM,CAAC;IACnE,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,KAAK;IACjB,QAAQ,EAAE,EAAE;CACb,CAAC,CAAA;AAeF,MAAM,OAAO,SAAU,SAAQ,OAAO,CAAC,OAAO,EAA6B,CACzE,wBAAwB,CACzB;CAAG;AAEJ,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE;IACzC,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACpC,IAAI,SAAS,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACxD,MAAM,IAAI,IAAI,CAAA;YACd,KAAK,IAAI,CAAC,CAAA;QACZ,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAA;QACnB,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,MAAM,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAa,EAAU,EAAE;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAClE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QACnF,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAA;AAQ1F,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAAkC,EAAE,EACL,EAAE;IACjC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,YAAY,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,sBAAsB,CAAA;IAEvD,MAAM,WAAW,GAAG,CAAC,KAAa,EAAsB,EAAE;QACxD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC9C,MAAM,WAAW,GACf,UAAU,KAAK,IAAI;YACjB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;gBACjC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;gBACnC,CAAC,CAAC,UAAU,CAAA;QAClB,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,MAAM,QAAQ,GAAkB,EAAE,CAAA;QAClC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBAChC,SAAQ;YACV,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,OAAO,SAAS,CAAA;gBAClB,CAAC;gBACD,QAAQ,CAAC,GAAG,EAAE,CAAA;YAChB,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3B,CAAC,CAAA;IAED,MAAM,UAAU,GAAG,CAAC,KAAa,EAAyC,EAAE;QAC1E,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QAC9B,OAAO,GAAG,KAAK,SAAS;YACtB,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,kBAAkB,CAAC,IAAI,CAAC;gBACtB,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,uCAAuC;aACjD,CAAC,CACH;YACH,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC,CAAA;IAED,OAAO,GAAG,CAAC,IAAI,CAAmC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAC3E,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAyC,EAAE,CACpE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;YAC3B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,KAAK,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBAClC,SAAS,EAAE,MAAM;oBACjB,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,qBAAqB;iBAC/B,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;YAClC,IAAI,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;gBAChC,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC;oBACrC,SAAS,EAAE,YAAY;oBACvB,KAAK,EAAE,MAAM,CAAC,YAAY;oBAC1B,MAAM,EAAE,KAAK;iBACd,CAAC,CAAA;YACJ,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC,CAAC,CAAA;QAEJ,MAAM,YAAY,GAAG,CACnB,SAA6B,EAC7B,KAAa,EACb,QAAgB,EACqB,EAAE;YACvC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;YAClC,IAAI,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;gBACjC,OAAO,MAAM,CAAC,IAAI,CAChB,mBAAmB,CAAC,IAAI,CAAC;oBACvB,SAAS,EAAE,GAAG,SAAS,QAAQ;oBAC/B,KAAK,EAAE,MAAM,CAAC,aAAa;oBAC3B,MAAM,EAAE,KAAK;iBACd,CAAC,CACH,CAAA;YACH,CAAC;YACD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAC3B,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACrB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAC5B,GAAG,KAAK;gBACR,CAAC,GAAG,CAAC,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,QAAQ,EAAE;aAC3E,CAAC,CAAC,CACJ,CACF,CAAA;QACH,CAAC,CAAA;QAED,MAAM,QAAQ,GAAG,CAAC,OAAO,GAAG,MAAM,EAAwD,EAAE,CAC1F,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACvD,MAAM,OAAO,GAAG,iBAAiB,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAA;YAClF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACnC,MAAM,OAAO,GAAkB,EAAE,CAAA;YACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;gBACxC,IAAI,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAC5B,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC;wBACrC,SAAS,EAAE,iBAAiB;wBAC5B,KAAK,EAAE,MAAM,CAAC,QAAQ;wBACtB,MAAM,EAAE,KAAK;qBACd,CAAC,CAAA;gBACJ,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBAClB,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;wBACvC,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC;4BACrC,SAAS,EAAE,mBAAmB;4BAC9B,KAAK,EAAE,MAAM,CAAC,UAAU;4BACxB,MAAM,EAAE,OAAO,CAAC,MAAM;yBACvB,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC,CAAC,CAAA;QAEJ,MAAM,MAAM,GAAG,CACb,KAAa,EACb,OAAO,GAAG,MAAM,EAC2C,EAAE,CAC7D,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;YACtC,MAAM,OAAO,GAAuB,EAAE,CAAA;YACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;oBACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;oBAC/B,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,OAAO,CAAC,IAAI,CACV,WAAW,CAAC,IAAI,CAAC;4BACf,IAAI;4BACJ,IAAI,EAAE,KAAK,GAAG,CAAC;4BACf,IAAI,EAAE,IAAI;yBACX,CAAC,CACH,CAAA;wBACD,IAAI,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;4BACvC,OAAO,KAAK,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC;gCACrC,SAAS,EAAE,gBAAgB;gCAC3B,KAAK,EAAE,MAAM,CAAC,UAAU;gCACxB,MAAM,EAAE,OAAO,CAAC,MAAM;6BACvB,CAAC,CAAA;wBACJ,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YACD,OAAO,OAAO,CAAA;QAChB,CAAC,CAAC,CAAA;QAEJ,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE,CACzB,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YACrF,IAAI;YACJ,KAAK,EAAE,CAAC,IAAY,EAAE,QAAgB,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC;YAChF,MAAM,EAAE,CAAC,IAAY,EAAE,QAAgB,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC;YAClF,QAAQ;YACR,MAAM;SACP,CAAA;IACH,CAAC,CAAC,CACH,CAAA;AACH,CAAC,CAAA"}
@@ -0,0 +1,3 @@
1
+ export declare const repoId: (workspace: string, repository: string) => string | undefined;
2
+ export declare const llm4tsDirectory: (workspace: string, repository: string) => string;
3
+ //# sourceMappingURL=WorkspaceLayout.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WorkspaceLayout.d.ts","sourceRoot":"","sources":["../src/WorkspaceLayout.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM,GAAI,WAAW,MAAM,EAAE,YAAY,MAAM,KAAG,MAAM,GAAG,SAMvE,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,EAAE,YAAY,MAAM,KAAG,MAIvE,CAAA"}
@@ -0,0 +1,19 @@
1
+ import { stableHash } from "./Plan.js";
2
+ const normalize = (path) => path.replaceAll("\\", "/").replace(/\/+$/, "");
3
+ const basename = (path) => {
4
+ const parts = normalize(path).split("/");
5
+ return parts.at(-1) || "repo";
6
+ };
7
+ export const repoId = (workspace, repository) => {
8
+ const normalizedWorkspace = normalize(workspace);
9
+ const normalizedRepository = normalize(repository);
10
+ return normalizedWorkspace === normalizedRepository
11
+ ? undefined
12
+ : `${basename(normalizedRepository)}-${stableHash(normalizedRepository)}`;
13
+ };
14
+ export const llm4tsDirectory = (workspace, repository) => {
15
+ const root = `${normalize(workspace)}/.llm4ts`;
16
+ const id = repoId(workspace, repository);
17
+ return id === undefined ? root : `${root}/${id}`;
18
+ };
19
+ //# sourceMappingURL=WorkspaceLayout.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WorkspaceLayout.js","sourceRoot":"","sources":["../src/WorkspaceLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAE1F,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE;IACxC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAiB,EAAE,UAAkB,EAAsB,EAAE;IAClF,MAAM,mBAAmB,GAAG,SAAS,CAAC,SAAS,CAAC,CAAA;IAChD,MAAM,oBAAoB,GAAG,SAAS,CAAC,UAAU,CAAC,CAAA;IAClD,OAAO,mBAAmB,KAAK,oBAAoB;QACjD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,GAAG,QAAQ,CAAC,oBAAoB,CAAC,IAAI,UAAU,CAAC,oBAAoB,CAAC,EAAE,CAAA;AAC7E,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAE,UAAkB,EAAU,EAAE;IAC/E,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,UAAU,CAAA;IAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;IACxC,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAA;AAClD,CAAC,CAAA"}
@@ -0,0 +1,4 @@
1
+ import { type Tool } from "@llm4ts/core/tools/Tool";
2
+ import type { WorkspaceShape } from "./Workspace.ts";
3
+ export declare const workspaceTools: (workspace: WorkspaceShape) => ReadonlyArray<Tool>;
4
+ //# sourceMappingURL=WorkspaceTools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"WorkspaceTools.d.ts","sourceRoot":"","sources":["../src/WorkspaceTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAGlF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAmEpD,eAAO,MAAM,cAAc,GAAI,WAAW,cAAc,KAAG,aAAa,CAAC,IAAI,CAoH5E,CAAA"}