@tpsdev-ai/agent 0.2.0 → 0.4.1

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 (99) hide show
  1. package/README.md +54 -0
  2. package/dist/bin.d.ts +3 -0
  3. package/dist/bin.d.ts.map +1 -0
  4. package/dist/bin.js +32 -0
  5. package/dist/bin.js.map +1 -0
  6. package/dist/config.d.ts +23 -0
  7. package/dist/config.d.ts.map +1 -0
  8. package/dist/config.js +39 -0
  9. package/dist/config.js.map +1 -0
  10. package/dist/governance/boundary.d.ts +30 -0
  11. package/dist/governance/boundary.d.ts.map +1 -0
  12. package/dist/governance/boundary.js +120 -0
  13. package/dist/governance/boundary.js.map +1 -0
  14. package/dist/governance/review-gate.d.ts +9 -0
  15. package/dist/governance/review-gate.d.ts.map +1 -0
  16. package/dist/governance/review-gate.js +28 -0
  17. package/dist/governance/review-gate.js.map +1 -0
  18. package/dist/index.d.ts +16 -0
  19. package/dist/index.d.ts.map +1 -0
  20. package/dist/index.js +19 -0
  21. package/dist/index.js.map +1 -0
  22. package/dist/io/context.d.ts +18 -0
  23. package/dist/io/context.d.ts.map +1 -0
  24. package/dist/io/context.js +76 -0
  25. package/dist/io/context.js.map +1 -0
  26. package/dist/io/mail.d.ts +22 -0
  27. package/dist/io/mail.d.ts.map +1 -0
  28. package/dist/io/mail.js +45 -0
  29. package/dist/io/mail.js.map +1 -0
  30. package/dist/io/memory.d.ts +24 -0
  31. package/dist/io/memory.d.ts.map +1 -0
  32. package/dist/io/memory.js +91 -0
  33. package/dist/io/memory.js.map +1 -0
  34. package/dist/llm/provider.d.ts +26 -0
  35. package/dist/llm/provider.d.ts.map +1 -0
  36. package/dist/llm/provider.js +254 -0
  37. package/dist/llm/provider.js.map +1 -0
  38. package/dist/runtime/agent.d.ts +14 -0
  39. package/dist/runtime/agent.d.ts.map +1 -0
  40. package/dist/runtime/agent.js +46 -0
  41. package/dist/runtime/agent.js.map +1 -0
  42. package/dist/runtime/event-loop.d.ts +32 -0
  43. package/dist/runtime/event-loop.d.ts.map +1 -0
  44. package/dist/runtime/event-loop.js +178 -0
  45. package/dist/runtime/event-loop.js.map +1 -0
  46. package/dist/runtime/types.d.ts +66 -0
  47. package/dist/runtime/types.d.ts.map +1 -0
  48. package/dist/runtime/types.js +2 -0
  49. package/dist/runtime/types.js.map +1 -0
  50. package/dist/tools/edit.d.ts +4 -0
  51. package/dist/tools/edit.d.ts.map +1 -0
  52. package/dist/tools/edit.js +46 -0
  53. package/dist/tools/edit.js.map +1 -0
  54. package/dist/tools/exec.d.ts +4 -0
  55. package/dist/tools/exec.d.ts.map +1 -0
  56. package/dist/tools/exec.js +74 -0
  57. package/dist/tools/exec.js.map +1 -0
  58. package/dist/tools/index.d.ts +17 -0
  59. package/dist/tools/index.d.ts.map +1 -0
  60. package/dist/tools/index.js +23 -0
  61. package/dist/tools/index.js.map +1 -0
  62. package/dist/tools/mail.d.ts +4 -0
  63. package/dist/tools/mail.d.ts.map +1 -0
  64. package/dist/tools/mail.js +19 -0
  65. package/dist/tools/mail.js.map +1 -0
  66. package/dist/tools/read.d.ts +4 -0
  67. package/dist/tools/read.d.ts.map +1 -0
  68. package/dist/tools/read.js +31 -0
  69. package/dist/tools/read.js.map +1 -0
  70. package/dist/tools/registry.d.ts +24 -0
  71. package/dist/tools/registry.d.ts.map +1 -0
  72. package/dist/tools/registry.js +23 -0
  73. package/dist/tools/registry.js.map +1 -0
  74. package/dist/tools/write.d.ts +4 -0
  75. package/dist/tools/write.d.ts.map +1 -0
  76. package/dist/tools/write.js +32 -0
  77. package/dist/tools/write.js.map +1 -0
  78. package/package.json +19 -4
  79. package/src/bin.ts +40 -0
  80. package/src/config.ts +64 -0
  81. package/src/governance/boundary.ts +112 -18
  82. package/src/index.ts +15 -2
  83. package/src/io/context.ts +59 -15
  84. package/src/io/memory.ts +53 -9
  85. package/src/llm/provider.ts +203 -42
  86. package/src/runtime/agent.ts +30 -3
  87. package/src/runtime/event-loop.ts +168 -26
  88. package/src/runtime/types.ts +54 -6
  89. package/src/tools/edit.ts +59 -0
  90. package/src/tools/exec.ts +92 -0
  91. package/src/tools/index.ts +30 -0
  92. package/src/tools/mail.ts +28 -0
  93. package/src/tools/read.ts +38 -0
  94. package/src/tools/registry.ts +16 -7
  95. package/src/tools/write.ts +40 -0
  96. package/src/types/js-tiktoken.d.ts +7 -0
  97. package/test/governance.test.ts +61 -32
  98. package/test/io.test.ts +15 -7
  99. package/test/runtime.test.ts +26 -5
@@ -0,0 +1,178 @@
1
+ function sleep(ms) {
2
+ return new Promise((resolve) => setTimeout(resolve, ms));
3
+ }
4
+ export class EventLoop {
5
+ deps;
6
+ pollMs;
7
+ state = "idle";
8
+ running = false;
9
+ constructor(deps, pollMs = 500) {
10
+ this.deps = deps;
11
+ this.pollMs = pollMs;
12
+ }
13
+ async run(checkInbox) {
14
+ this.running = true;
15
+ this.state = "idle";
16
+ while (this.running) {
17
+ const messages = await checkInbox();
18
+ for (const msg of messages) {
19
+ if (!this.running)
20
+ break;
21
+ this.state = "processing";
22
+ try {
23
+ await this.processMail(msg);
24
+ }
25
+ catch (err) {
26
+ await this.deps.memory.append({
27
+ type: "error",
28
+ ts: new Date().toISOString(),
29
+ data: String(err?.message ?? err),
30
+ });
31
+ }
32
+ this.state = "idle";
33
+ }
34
+ if (!this.running)
35
+ break;
36
+ if (messages.length === 0)
37
+ await sleep(this.pollMs);
38
+ }
39
+ }
40
+ async stop() {
41
+ this.running = false;
42
+ this.state = "stopped";
43
+ }
44
+ getState() {
45
+ return this.state;
46
+ }
47
+ async runOnce(prompt) {
48
+ await this.processMessage(prompt);
49
+ }
50
+ async processMail(message) {
51
+ await this.processMessage(message.body);
52
+ }
53
+ async processMessage(promptRaw) {
54
+ const prompt = String(promptRaw).trim();
55
+ const tools = this.deps.tools
56
+ .list()
57
+ .map((tool) => ({
58
+ name: tool.name,
59
+ description: tool.description,
60
+ input_schema: {
61
+ type: "object",
62
+ properties: tool.input_schema,
63
+ additionalProperties: false,
64
+ },
65
+ }));
66
+ await this.deps.memory.append({
67
+ type: "message",
68
+ ts: new Date().toISOString(),
69
+ data: { direction: "in", body: prompt },
70
+ });
71
+ const request = {
72
+ systemPrompt: await this.buildSystemPrompt(),
73
+ messages: [{ role: "user", content: prompt }],
74
+ tools,
75
+ toolChoice: "auto",
76
+ maxTokens: this.deps.config.maxTokens ?? 1024,
77
+ };
78
+ let completion = await this.deps.provider.complete(request);
79
+ let turns = 0;
80
+ while (true) {
81
+ if (completion.content) {
82
+ await this.deps.memory.append({
83
+ type: "assistant",
84
+ ts: new Date().toISOString(),
85
+ data: {
86
+ content: completion.content,
87
+ inputTokens: completion.inputTokens,
88
+ outputTokens: completion.outputTokens,
89
+ },
90
+ });
91
+ }
92
+ if (!completion.toolCalls || completion.toolCalls.length === 0) {
93
+ return;
94
+ }
95
+ if (turns++ > 8) {
96
+ await this.deps.memory.append({
97
+ type: "error",
98
+ ts: new Date().toISOString(),
99
+ data: { message: "tool loop max depth reached" },
100
+ });
101
+ return;
102
+ }
103
+ const toolMessages = [];
104
+ for (const call of completion.toolCalls ?? []) {
105
+ await this.deps.memory.append({
106
+ type: "tool_call",
107
+ ts: new Date().toISOString(),
108
+ data: { tool: call.name, args: call.input },
109
+ });
110
+ if (this.deps.reviewGate && this.deps.reviewGate.isHighRisk(call.name)) {
111
+ await this.deps.reviewGate.requestApproval(call.name, call.input);
112
+ await this.deps.memory.append({
113
+ type: "approval_request",
114
+ ts: new Date().toISOString(),
115
+ data: { tool: call.name, args: call.input },
116
+ });
117
+ continue;
118
+ }
119
+ let result;
120
+ try {
121
+ result = await this.deps.tools.execute(call.name, call.input);
122
+ }
123
+ catch (err) {
124
+ result = { content: `Tool execution error: ${err?.message ?? String(err)}`, isError: true };
125
+ }
126
+ await this.deps.memory.append({
127
+ type: "tool_result",
128
+ ts: new Date().toISOString(),
129
+ data: { tool: call.name, result },
130
+ });
131
+ toolMessages.push({
132
+ role: "tool",
133
+ tool_call_id: String(call.id ?? `${Date.now()}-${Math.random()}`),
134
+ name: call.name,
135
+ content: JSON.stringify(result),
136
+ });
137
+ }
138
+ const nextMessages = [
139
+ ...request.messages,
140
+ { role: "assistant", content: completion.content ?? "" },
141
+ ...toolMessages,
142
+ ];
143
+ completion = await this.deps.provider.complete({
144
+ systemPrompt: request.systemPrompt,
145
+ messages: nextMessages,
146
+ tools,
147
+ toolChoice: "auto",
148
+ maxTokens: this.deps.config.maxTokens ?? 1024,
149
+ });
150
+ }
151
+ }
152
+ async buildSystemPrompt() {
153
+ const fs = await import("node:fs/promises");
154
+ const docs = await Promise.all([
155
+ this.fileOrEmpty(`${this.deps.config.workspace}/SOUL.md`),
156
+ this.fileOrEmpty(`${this.deps.config.workspace}/AGENTS.md`),
157
+ this.fileOrEmpty(`${this.deps.config.workspace}/IDENTITY.md`),
158
+ Promise.resolve(this.deps.config.systemPrompt || ""),
159
+ ]);
160
+ const sections = [
161
+ `Role: ${this.deps.config.name}`,
162
+ `Tools: ${this.deps.tools.list().map((t) => t.name).join(", ") || "(none)"}`,
163
+ `Context: ${this.deps.config.agentId}`,
164
+ ];
165
+ const docBlock = docs.filter(Boolean).join("\n\n");
166
+ return `${docBlock}\n\n${sections.join("\n")}`;
167
+ }
168
+ async fileOrEmpty(path) {
169
+ try {
170
+ const fs = await import("node:fs/promises");
171
+ return await fs.readFile(path, "utf-8");
172
+ }
173
+ catch {
174
+ return "";
175
+ }
176
+ }
177
+ }
178
+ //# sourceMappingURL=event-loop.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-loop.js","sourceRoot":"","sources":["../../src/runtime/event-loop.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,66 @@
1
+ export type ProviderName = "anthropic" | "google" | "openai" | "ollama";
2
+ export interface LLMConfig {
3
+ provider: ProviderName;
4
+ model: string;
5
+ apiKey?: string;
6
+ baseUrl?: string;
7
+ }
8
+ export interface AgentConfig {
9
+ /** Agent identifier from tps.yaml */
10
+ agentId: string;
11
+ /** Human-readable name */
12
+ name: string;
13
+ /** Maildir root */
14
+ mailDir: string;
15
+ /** JSONL memory file path */
16
+ memoryPath: string;
17
+ /** Workspace root for file tools */
18
+ workspace: string;
19
+ /** LLM provider config */
20
+ llm: LLMConfig;
21
+ /** Optional override personas/system prompt */
22
+ systemPrompt?: string;
23
+ /** Target token context window */
24
+ contextWindowTokens?: number;
25
+ /** Max model output tokens */
26
+ maxTokens?: number;
27
+ /** Tools the runtime should load */
28
+ tools?: Array<"read" | "write" | "edit" | "exec" | "mail">;
29
+ /** Allow-list for exec command binary names */
30
+ execAllowlist?: string[];
31
+ }
32
+ export interface ToolResult {
33
+ content: string;
34
+ isError?: boolean;
35
+ }
36
+ export interface ToolCall {
37
+ id?: string;
38
+ name: string;
39
+ input: Record<string, unknown>;
40
+ }
41
+ export interface LLMMessage {
42
+ role: "system" | "user" | "assistant" | "tool" | "developer" | string;
43
+ content?: string;
44
+ name?: string;
45
+ tool_call_id?: string;
46
+ }
47
+ export interface CompletionRequest {
48
+ systemPrompt?: string;
49
+ messages: LLMMessage[];
50
+ tools: ToolSpec[];
51
+ toolChoice?: "auto" | "required";
52
+ maxTokens?: number;
53
+ }
54
+ export interface ToolSpec {
55
+ name: string;
56
+ description: string;
57
+ input_schema: Record<string, unknown>;
58
+ }
59
+ export interface CompletionResponse {
60
+ content?: string;
61
+ toolCalls?: ToolCall[];
62
+ inputTokens: number;
63
+ outputTokens: number;
64
+ }
65
+ export type AgentState = "idle" | "processing" | "awaiting_approval" | "stopped";
66
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,GAAG,EAAE,SAAS,CAAC;IACf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3D,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,YAAY,GACZ,mBAAmB,GACnB,SAAS,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runtime/types.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ import { BoundaryManager } from "../governance/boundary.js";
2
+ import type { Tool } from "./registry.js";
3
+ export declare function makeEditTool(boundary: BoundaryManager): Tool;
4
+ //# sourceMappingURL=edit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAS1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA+C5D"}
@@ -0,0 +1,46 @@
1
+ import { readFileSync, writeFileSync, existsSync } from "node:fs";
2
+ import { BoundaryManager } from "../governance/boundary.js";
3
+ export function makeEditTool(boundary) {
4
+ return {
5
+ name: "edit",
6
+ description: "Search-and-replace in one file. Replaces exactly one occurrence.\nInput: {\"path\": string, \"old_string\": string, \"new_string\": string}",
7
+ input_schema: {
8
+ path: { type: "string", description: "Path in workspace" },
9
+ old_string: { type: "string", description: "Text to replace" },
10
+ new_string: { type: "string", description: "Replacement text" },
11
+ },
12
+ async execute(args) {
13
+ const payload = args;
14
+ if (typeof payload.path !== "string" ||
15
+ typeof payload.old_string !== "string" ||
16
+ typeof payload.new_string !== "string") {
17
+ return { content: "edit tool requires path, old_string, new_string", isError: true };
18
+ }
19
+ const workspacePath = boundary.resolveWorkspacePath(payload.path);
20
+ if (!existsSync(workspacePath) || !BoundaryManager.canFollowSymlink(workspacePath)) {
21
+ if (existsSync(workspacePath)) {
22
+ return { content: `Refusing to follow symlink: ${payload.path}`, isError: true };
23
+ }
24
+ return { content: `edit failed: file not found ${payload.path}`, isError: true };
25
+ }
26
+ try {
27
+ const current = readFileSync(workspacePath, "utf-8");
28
+ const first = current.indexOf(payload.old_string);
29
+ const last = current.lastIndexOf(payload.old_string);
30
+ if (first === -1) {
31
+ return { content: `No occurrence of old_string found in ${payload.path}`, isError: true };
32
+ }
33
+ if (first !== last) {
34
+ return { content: `old_string matches multiple locations in ${payload.path} — provide narrower context`, isError: true };
35
+ }
36
+ const next = current.replace(payload.old_string, payload.new_string);
37
+ writeFileSync(workspacePath, next, "utf-8");
38
+ return { content: `Edited ${payload.path}`, isError: false };
39
+ }
40
+ catch (err) {
41
+ return { content: `edit failed: ${err?.message ?? String(err)}`, isError: true };
42
+ }
43
+ },
44
+ };
45
+ }
46
+ //# sourceMappingURL=edit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAU5D,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,6IAA6I;QAC1J,YAAY,EAAE;YACZ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAC1D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;YAC9D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;SAChE;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,OAAO,GAAI,IAA4B,CAAC;YAC9C,IACE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAChC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;gBACtC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,EACtC,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,iDAAiD,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACvF,CAAC;YAED,MAAM,aAAa,GAAG,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAClE,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;gBACnF,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC9B,OAAO,EAAE,OAAO,EAAE,+BAA+B,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBACnF,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,+BAA+B,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAClD,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAErD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,OAAO,EAAE,OAAO,EAAE,wCAAwC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAC5F,CAAC;gBACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,OAAO,EAAE,OAAO,EAAE,4CAA4C,OAAO,CAAC,IAAI,6BAA6B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;gBAC3H,CAAC;gBAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;gBACrE,aAAa,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC/D,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { BoundaryManager } from "../governance/boundary.js";
2
+ import type { Tool } from "./registry.js";
3
+ export declare function makeExecTool(boundary: BoundaryManager, allowlist?: string[]): Tool;
4
+ //# sourceMappingURL=exec.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/tools/exec.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAc1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,GAAE,MAAM,EAAO,GAAG,IAAI,CA2EtF"}
@@ -0,0 +1,74 @@
1
+ import { spawn } from "node:child_process";
2
+ function sanitizeOutput(data) {
3
+ if (!data)
4
+ return "";
5
+ return String(data);
6
+ }
7
+ export function makeExecTool(boundary, allowlist = []) {
8
+ const safeAllow = allowlist.map((c) => c.toLowerCase());
9
+ return {
10
+ name: "exec",
11
+ description: "Execute a command.\nInput: {\"command\": string, \"args\": string[] (optional)",
12
+ input_schema: {
13
+ command: { type: "string", description: "Executable name" },
14
+ args: { type: "array", description: "Arguments to pass" },
15
+ cwd: { type: "string", description: "Optional cwd relative to workspace" },
16
+ },
17
+ async execute(args) {
18
+ const payload = args;
19
+ if (typeof payload.command !== "string") {
20
+ return { content: "exec tool requires command string", isError: true };
21
+ }
22
+ const command = payload.command;
23
+ const cmdArgs = Array.isArray(payload.args)
24
+ ? payload.args.map((entry) => String(entry))
25
+ : [];
26
+ const normalized = command.toLowerCase();
27
+ if (safeAllow.length > 0 && !safeAllow.includes(normalized)) {
28
+ return { content: `Command not allowed: ${command}`, isError: true };
29
+ }
30
+ try {
31
+ boundary.validateCommand(normalized, cmdArgs);
32
+ }
33
+ catch (err) {
34
+ return { content: `exec blocked: ${err?.message ?? String(err)}`, isError: true };
35
+ }
36
+ const cwd = payload.cwd ? boundary.resolveWorkspacePath(payload.cwd) : undefined;
37
+ const env = boundary.scrubEnvironment(["ANTHROPIC_API_KEY", "GOOGLE_API_KEY", "OPENAI_API_KEY", "OLLAMA_HOST", "OLLAMA_API_KEY"]);
38
+ return new Promise((resolve) => {
39
+ const child = spawn(normalized, cmdArgs, {
40
+ cwd,
41
+ env,
42
+ shell: false,
43
+ stdio: ["ignore", "pipe", "pipe"],
44
+ });
45
+ let stdout = "";
46
+ let stderr = "";
47
+ child.stdout?.on("data", (chunk) => {
48
+ stdout += sanitizeOutput(chunk);
49
+ });
50
+ child.stderr?.on("data", (chunk) => {
51
+ stderr += sanitizeOutput(chunk);
52
+ });
53
+ child.on("error", (err) => {
54
+ resolve({
55
+ content: `exec failed: ${sanitizeOutput(err?.message)}`,
56
+ isError: true,
57
+ });
58
+ });
59
+ child.on("close", (code) => {
60
+ if (code === 0) {
61
+ resolve({ content: stdout || "(no output)", isError: false });
62
+ }
63
+ else {
64
+ resolve({
65
+ content: `exit=${code}\nstdout:\n${stdout}\nstderr:\n${stderr}`,
66
+ isError: true,
67
+ });
68
+ }
69
+ });
70
+ });
71
+ },
72
+ };
73
+ }
74
+ //# sourceMappingURL=exec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/tools/exec.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import { BoundaryManager } from "../governance/boundary.js";
2
+ import { MailClient } from "../io/mail.js";
3
+ import { ToolRegistry } from "./registry.js";
4
+ import { makeReadTool } from "./read.js";
5
+ import { makeWriteTool } from "./write.js";
6
+ import { makeEditTool } from "./edit.js";
7
+ import { makeExecTool } from "./exec.js";
8
+ import { makeMailTool } from "./mail.js";
9
+ export { makeReadTool, makeWriteTool, makeEditTool, makeExecTool, makeMailTool };
10
+ export interface ToolSetOptions {
11
+ boundary: BoundaryManager;
12
+ mail: MailClient;
13
+ tools?: Array<"read" | "write" | "edit" | "exec" | "mail">;
14
+ execAllowlist?: string[];
15
+ }
16
+ export declare function createDefaultToolset({ boundary, mail, tools, execAllowlist }: ToolSetOptions): ToolRegistry;
17
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,cAAc,GAAG,YAAY,CAW3G"}
@@ -0,0 +1,23 @@
1
+ import { ToolRegistry } from "./registry.js";
2
+ import { makeReadTool } from "./read.js";
3
+ import { makeWriteTool } from "./write.js";
4
+ import { makeEditTool } from "./edit.js";
5
+ import { makeExecTool } from "./exec.js";
6
+ import { makeMailTool } from "./mail.js";
7
+ export { makeReadTool, makeWriteTool, makeEditTool, makeExecTool, makeMailTool };
8
+ export function createDefaultToolset({ boundary, mail, tools, execAllowlist }) {
9
+ const registry = new ToolRegistry();
10
+ const names = tools ?? ["read", "write", "edit", "exec", "mail"];
11
+ if (names.includes("read"))
12
+ registry.register(makeReadTool(boundary));
13
+ if (names.includes("write"))
14
+ registry.register(makeWriteTool(boundary));
15
+ if (names.includes("edit"))
16
+ registry.register(makeEditTool(boundary));
17
+ if (names.includes("exec"))
18
+ registry.register(makeExecTool(boundary, execAllowlist));
19
+ if (names.includes("mail"))
20
+ registry.register(makeMailTool(mail));
21
+ return registry;
22
+ }
23
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AASjF,MAAM,UAAU,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAkB;IAC3F,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,MAAM,KAAK,GAAuD,KAAK,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAErH,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IACrF,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAElE,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,4 @@
1
+ import type { Tool } from "./registry.js";
2
+ import type { MailClient } from "../io/mail.js";
3
+ export declare function makeMailTool(mail: MailClient): Tool;
4
+ //# sourceMappingURL=mail.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/tools/mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAQhD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAkBnD"}
@@ -0,0 +1,19 @@
1
+ export function makeMailTool(mail) {
2
+ return {
3
+ name: "mail",
4
+ description: "Send mail to another agent or manager.\nInput: {\"to\": string, \"body\": string}",
5
+ input_schema: {
6
+ to: { type: "string", description: "Recipient" },
7
+ body: { type: "string", description: "Message body" },
8
+ },
9
+ async execute(args) {
10
+ const payload = args;
11
+ if (typeof payload.to !== "string" || typeof payload.body !== "string") {
12
+ return { content: "mail tool requires to and body", isError: true };
13
+ }
14
+ await mail.sendMail(payload.to, payload.body);
15
+ return { content: `Sent mail to ${payload.to}`, isError: false };
16
+ },
17
+ };
18
+ }
19
+ //# sourceMappingURL=mail.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mail.js","sourceRoot":"","sources":["../../src/tools/mail.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mFAAmF;QAChG,YAAY,EAAE;YACZ,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;YAChD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;SACtD;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,OAAO,GAAI,IAAuC,CAAC;YACzD,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvE,OAAO,EAAE,OAAO,EAAE,gCAAgC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACtE,CAAC;YAED,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,EAAE,OAAO,EAAE,gBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { BoundaryManager } from "../governance/boundary.js";
2
+ import type { Tool } from "./registry.js";
3
+ export declare function makeReadTool(boundary: BoundaryManager): Tool;
4
+ //# sourceMappingURL=read.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAO1C,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA4B5D"}
@@ -0,0 +1,31 @@
1
+ import { readFileSync, existsSync } from "node:fs";
2
+ import { BoundaryManager } from "../governance/boundary.js";
3
+ export function makeReadTool(boundary) {
4
+ return {
5
+ name: "read",
6
+ description: "Read file contents from workspace.\nInput: {\"path\": string}",
7
+ input_schema: {
8
+ path: {
9
+ type: "string",
10
+ description: "Path to read, relative to workspace",
11
+ },
12
+ },
13
+ async execute(args) {
14
+ const { path: rawPath } = args;
15
+ if (typeof rawPath !== "string") {
16
+ return { content: "read tool requires path string", isError: true };
17
+ }
18
+ const workspacePath = boundary.resolveWorkspacePath(rawPath);
19
+ if (existsSync(workspacePath) && !BoundaryManager.canFollowSymlink(workspacePath)) {
20
+ return { content: `Refusing to follow symlink: ${rawPath}`, isError: true };
21
+ }
22
+ try {
23
+ return { content: readFileSync(workspacePath, "utf-8"), isError: false };
24
+ }
25
+ catch (err) {
26
+ return { content: `read failed: ${err?.message ?? String(err)}`, isError: true };
27
+ }
28
+ },
29
+ };
30
+ }
31
+ //# sourceMappingURL=read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAQ5D,MAAM,UAAU,YAAY,CAAC,QAAyB;IACpD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,+DAA+D;QAC5E,YAAY,EAAE;YACZ,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;SACF;QACD,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAI,IAA4B,CAAC;YACxD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,gCAAgC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACtE,CAAC;YAED,MAAM,aAAa,GAAG,QAAQ,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC7D,IAAI,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,CAAC;gBAClF,OAAO,EAAE,OAAO,EAAE,+BAA+B,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC9E,CAAC;YAED,IAAI,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC3E,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAClB,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,24 @@
1
+ import type { ToolResult } from "../runtime/types.js";
2
+ export interface Tool {
3
+ name: string;
4
+ description: string;
5
+ input_schema: {
6
+ [key: string]: {
7
+ type: string;
8
+ description?: string;
9
+ };
10
+ [key: number]: never;
11
+ };
12
+ execute(args: Record<string, unknown>): Promise<ToolResult>;
13
+ }
14
+ /**
15
+ * Central registry for native TPS agent tools.
16
+ */
17
+ export declare class ToolRegistry {
18
+ private readonly tools;
19
+ register(tool: Tool): void;
20
+ get(name: string): Tool | undefined;
21
+ list(): Tool[];
22
+ execute(name: string, args: Record<string, unknown>): Promise<ToolResult>;
23
+ }
24
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG;YACb,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;KACtB,CAAC;IACF,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAEjD,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAInC,IAAI,IAAI,IAAI,EAAE;IAIR,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAQhF"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Central registry for native TPS agent tools.
3
+ */
4
+ export class ToolRegistry {
5
+ tools = new Map();
6
+ register(tool) {
7
+ this.tools.set(tool.name, tool);
8
+ }
9
+ get(name) {
10
+ return this.tools.get(name);
11
+ }
12
+ list() {
13
+ return Array.from(this.tools.values());
14
+ }
15
+ async execute(name, args) {
16
+ const tool = this.tools.get(name);
17
+ if (!tool) {
18
+ throw new Error(`Unknown tool: ${name}`);
19
+ }
20
+ return tool.execute(args);
21
+ }
22
+ }
23
+ //# sourceMappingURL=registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,OAAO,YAAY;IACN,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IAEjD,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAA6B;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF"}
@@ -0,0 +1,4 @@
1
+ import { BoundaryManager } from "../governance/boundary.js";
2
+ import type { Tool } from "./registry.js";
3
+ export declare function makeWriteTool(boundary: BoundaryManager): Tool;
4
+ //# sourceMappingURL=write.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAQ1C,wBAAgB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CA4B7D"}