@sigil0/looking-glass 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 (151) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +572 -0
  3. package/dist/agents/coordinator.d.ts +21 -0
  4. package/dist/agents/coordinator.d.ts.map +1 -0
  5. package/dist/agents/coordinator.js +171 -0
  6. package/dist/agents/coordinator.js.map +1 -0
  7. package/dist/app.d.ts +44 -0
  8. package/dist/app.d.ts.map +1 -0
  9. package/dist/app.js +215 -0
  10. package/dist/app.js.map +1 -0
  11. package/dist/cli.d.ts +3 -0
  12. package/dist/cli.d.ts.map +1 -0
  13. package/dist/cli.js +419 -0
  14. package/dist/cli.js.map +1 -0
  15. package/dist/config.d.ts +4 -0
  16. package/dist/config.d.ts.map +1 -0
  17. package/dist/config.js +132 -0
  18. package/dist/config.js.map +1 -0
  19. package/dist/engine/context.d.ts +6 -0
  20. package/dist/engine/context.d.ts.map +1 -0
  21. package/dist/engine/context.js +65 -0
  22. package/dist/engine/context.js.map +1 -0
  23. package/dist/engine/engine.d.ts +74 -0
  24. package/dist/engine/engine.d.ts.map +1 -0
  25. package/dist/engine/engine.js +573 -0
  26. package/dist/engine/engine.js.map +1 -0
  27. package/dist/engine/types.d.ts +35 -0
  28. package/dist/engine/types.d.ts.map +1 -0
  29. package/dist/engine/types.js +2 -0
  30. package/dist/engine/types.js.map +1 -0
  31. package/dist/instructions.d.ts +8 -0
  32. package/dist/instructions.d.ts.map +1 -0
  33. package/dist/instructions.js +60 -0
  34. package/dist/instructions.js.map +1 -0
  35. package/dist/model/codex-lb.d.ts +141 -0
  36. package/dist/model/codex-lb.d.ts.map +1 -0
  37. package/dist/model/codex-lb.js +471 -0
  38. package/dist/model/codex-lb.js.map +1 -0
  39. package/dist/paths.d.ts +7 -0
  40. package/dist/paths.d.ts.map +1 -0
  41. package/dist/paths.js +41 -0
  42. package/dist/paths.js.map +1 -0
  43. package/dist/scheduler/daemon.d.ts +40 -0
  44. package/dist/scheduler/daemon.d.ts.map +1 -0
  45. package/dist/scheduler/daemon.js +189 -0
  46. package/dist/scheduler/daemon.js.map +1 -0
  47. package/dist/scheduler/index.d.ts +8 -0
  48. package/dist/scheduler/index.d.ts.map +1 -0
  49. package/dist/scheduler/index.js +6 -0
  50. package/dist/scheduler/index.js.map +1 -0
  51. package/dist/scheduler/runner.d.ts +18 -0
  52. package/dist/scheduler/runner.d.ts.map +1 -0
  53. package/dist/scheduler/runner.js +173 -0
  54. package/dist/scheduler/runner.js.map +1 -0
  55. package/dist/scheduler/schedule.d.ts +7 -0
  56. package/dist/scheduler/schedule.d.ts.map +1 -0
  57. package/dist/scheduler/schedule.js +94 -0
  58. package/dist/scheduler/schedule.js.map +1 -0
  59. package/dist/scheduler/store.d.ts +55 -0
  60. package/dist/scheduler/store.d.ts.map +1 -0
  61. package/dist/scheduler/store.js +1203 -0
  62. package/dist/scheduler/store.js.map +1 -0
  63. package/dist/scheduler/systemd.d.ts +7 -0
  64. package/dist/scheduler/systemd.d.ts.map +1 -0
  65. package/dist/scheduler/systemd.js +97 -0
  66. package/dist/scheduler/systemd.js.map +1 -0
  67. package/dist/scheduler/types.d.ts +145 -0
  68. package/dist/scheduler/types.d.ts.map +1 -0
  69. package/dist/scheduler/types.js +7 -0
  70. package/dist/scheduler/types.js.map +1 -0
  71. package/dist/security.d.ts +6 -0
  72. package/dist/security.d.ts.map +1 -0
  73. package/dist/security.js +27 -0
  74. package/dist/security.js.map +1 -0
  75. package/dist/storage/artifact-store.d.ts +19 -0
  76. package/dist/storage/artifact-store.d.ts.map +1 -0
  77. package/dist/storage/artifact-store.js +47 -0
  78. package/dist/storage/artifact-store.js.map +1 -0
  79. package/dist/storage/database.d.ts +5 -0
  80. package/dist/storage/database.d.ts.map +1 -0
  81. package/dist/storage/database.js +395 -0
  82. package/dist/storage/database.js.map +1 -0
  83. package/dist/storage/session-store.d.ts +114 -0
  84. package/dist/storage/session-store.d.ts.map +1 -0
  85. package/dist/storage/session-store.js +731 -0
  86. package/dist/storage/session-store.js.map +1 -0
  87. package/dist/tools/agents.d.ts +14 -0
  88. package/dist/tools/agents.d.ts.map +1 -0
  89. package/dist/tools/agents.js +35 -0
  90. package/dist/tools/agents.js.map +1 -0
  91. package/dist/tools/apply-patch.d.ts +7 -0
  92. package/dist/tools/apply-patch.d.ts.map +1 -0
  93. package/dist/tools/apply-patch.js +429 -0
  94. package/dist/tools/apply-patch.js.map +1 -0
  95. package/dist/tools/ask.d.ts +8 -0
  96. package/dist/tools/ask.d.ts.map +1 -0
  97. package/dist/tools/ask.js +27 -0
  98. package/dist/tools/ask.js.map +1 -0
  99. package/dist/tools/bash.d.ts +9 -0
  100. package/dist/tools/bash.d.ts.map +1 -0
  101. package/dist/tools/bash.js +98 -0
  102. package/dist/tools/bash.js.map +1 -0
  103. package/dist/tools/index.d.ts +9 -0
  104. package/dist/tools/index.d.ts.map +1 -0
  105. package/dist/tools/index.js +34 -0
  106. package/dist/tools/index.js.map +1 -0
  107. package/dist/tools/paths.d.ts +3 -0
  108. package/dist/tools/paths.d.ts.map +1 -0
  109. package/dist/tools/paths.js +34 -0
  110. package/dist/tools/paths.js.map +1 -0
  111. package/dist/tools/process.d.ts +21 -0
  112. package/dist/tools/process.d.ts.map +1 -0
  113. package/dist/tools/process.js +104 -0
  114. package/dist/tools/process.js.map +1 -0
  115. package/dist/tools/read.d.ts +9 -0
  116. package/dist/tools/read.d.ts.map +1 -0
  117. package/dist/tools/read.js +95 -0
  118. package/dist/tools/read.js.map +1 -0
  119. package/dist/tools/registry.d.ts +19 -0
  120. package/dist/tools/registry.d.ts.map +1 -0
  121. package/dist/tools/registry.js +188 -0
  122. package/dist/tools/registry.js.map +1 -0
  123. package/dist/tools/safety.d.ts +9 -0
  124. package/dist/tools/safety.d.ts.map +1 -0
  125. package/dist/tools/safety.js +199 -0
  126. package/dist/tools/safety.js.map +1 -0
  127. package/dist/tools/schedule.d.ts +4 -0
  128. package/dist/tools/schedule.d.ts.map +1 -0
  129. package/dist/tools/schedule.js +191 -0
  130. package/dist/tools/schedule.js.map +1 -0
  131. package/dist/tools/search.d.ts +16 -0
  132. package/dist/tools/search.d.ts.map +1 -0
  133. package/dist/tools/search.js +75 -0
  134. package/dist/tools/search.js.map +1 -0
  135. package/dist/tools/types.d.ts +54 -0
  136. package/dist/tools/types.d.ts.map +1 -0
  137. package/dist/tools/types.js +10 -0
  138. package/dist/tools/types.js.map +1 -0
  139. package/dist/types.d.ts +90 -0
  140. package/dist/types.d.ts.map +1 -0
  141. package/dist/types.js +2 -0
  142. package/dist/types.js.map +1 -0
  143. package/dist/ui/stdio.d.ts +5 -0
  144. package/dist/ui/stdio.d.ts.map +1 -0
  145. package/dist/ui/stdio.js +65 -0
  146. package/dist/ui/stdio.js.map +1 -0
  147. package/dist/ui/tui.d.ts +93 -0
  148. package/dist/ui/tui.d.ts.map +1 -0
  149. package/dist/ui/tui.js +2246 -0
  150. package/dist/ui/tui.js.map +1 -0
  151. package/package.json +53 -0
@@ -0,0 +1,98 @@
1
+ import { resolveWorkspacePath } from "./paths.js";
2
+ import { runProcess } from "./process.js";
3
+ import { bashApprovalExecutable, bashExecutionRisk, shellEnvironment } from "./safety.js";
4
+ import { configuredCredentialValues, credentialEnvironmentNames, redactSensitiveText } from "../security.js";
5
+ function exactApprovalSignature(args, context) {
6
+ const { cwd, timeoutMs } = prepareExecution(args, context);
7
+ return JSON.stringify(["bash-exec", 3, args.command, cwd, timeoutMs]);
8
+ }
9
+ function prepareExecution(args, context) {
10
+ if (args.command.includes("\0"))
11
+ throw new Error("Command contains a NUL byte");
12
+ const cwd = resolveWorkspacePath(context.workspace, args.workdir ?? ".");
13
+ const timeoutMs = Math.min(args.timeout_ms ?? context.config.tools.shellTimeoutMs, 3_600_000);
14
+ return { cwd, timeoutMs };
15
+ }
16
+ export const bashTool = {
17
+ name: "bash",
18
+ description: "Run one noninteractive Bash command in the workspace. Do not start background jobs or commands requiring a TTY.",
19
+ risk: "shell",
20
+ classifyRisk: (args) => bashExecutionRisk(args.command),
21
+ approvalSignature: (args, context) => {
22
+ prepareExecution(args, context);
23
+ const executable = bashApprovalExecutable(args.command);
24
+ return executable
25
+ ? JSON.stringify(["bash-executable", 2, executable])
26
+ : exactApprovalSignature(args, context);
27
+ },
28
+ legacyApprovalSignatures: (args, context) => {
29
+ const { cwd } = prepareExecution(args, context);
30
+ const executable = bashApprovalExecutable(args.command);
31
+ return [
32
+ exactApprovalSignature(args, context),
33
+ ...(executable ? [JSON.stringify([
34
+ "bash-executable",
35
+ 1,
36
+ bashExecutionRisk(args.command),
37
+ executable,
38
+ ...(!executable.startsWith("/") && executable.includes("/") ? [cwd] : []),
39
+ ])] : []),
40
+ ];
41
+ },
42
+ approvalDescription: (args) => {
43
+ const executable = bashApprovalExecutable(args.command);
44
+ return executable
45
+ ? `All Bash commands starting with '${executable}' in this session, regardless of arguments, risk, working directory, timeout, redirects, or compound suffix. This includes main turns, agents, and scheduled turns.`
46
+ : "Only this exact dynamic Bash command, working directory, and timeout in this session.";
47
+ },
48
+ parameters: {
49
+ type: "object",
50
+ properties: {
51
+ command: { type: "string", minLength: 1 },
52
+ workdir: { type: ["string", "null"], description: "Optional workspace-relative working directory" },
53
+ timeout_ms: { type: ["integer", "null"], minimum: 100, maximum: 3600000 },
54
+ },
55
+ required: ["command", "workdir", "timeout_ms"],
56
+ additionalProperties: false,
57
+ },
58
+ summarize: (args) => `Run: ${args.command.slice(0, 160)}`,
59
+ async execute(args, context) {
60
+ const { cwd, timeoutMs } = prepareExecution(args, context);
61
+ const captureBytes = Math.max(context.config.tools.maxOutputBytes * 8, 512 * 1024);
62
+ const secrets = configuredCredentialValues(context.config);
63
+ const result = await runProcess("/bin/bash", ["--noprofile", "--norc", "-c", args.command], {
64
+ cwd,
65
+ env: shellEnvironment(process.env, credentialEnvironmentNames(context.config)),
66
+ timeoutMs,
67
+ captureBytes,
68
+ signal: context.signal,
69
+ });
70
+ const stdout = result.stdout.toString("utf8");
71
+ const stderr = result.stderr.toString("utf8");
72
+ const full = redactSensitiveText([
73
+ stdout ? `stdout:\n${stdout}` : "",
74
+ stderr ? `stderr:\n${stderr}` : "",
75
+ `exit: ${result.exitCode === null ? result.signal ?? "unknown" : result.exitCode}${result.timedOut ? " (timed out)" : ""}`,
76
+ ].filter(Boolean).join("\n\n"), secrets);
77
+ const modelLimit = context.config.tools.maxOutputBytes;
78
+ const encoded = Buffer.from(full);
79
+ if (encoded.byteLength <= modelLimit && !result.stdoutTruncated && !result.stderrTruncated) {
80
+ return { output: full };
81
+ }
82
+ const artifact = context.artifacts.save(context.sessionId, "shell-output", encoded, {
83
+ command: redactSensitiveText(args.command, secrets),
84
+ exitCode: result.exitCode,
85
+ signal: result.signal,
86
+ stdoutBytes: result.stdoutBytes,
87
+ stderrBytes: result.stderrBytes,
88
+ captureTruncated: result.stdoutTruncated || result.stderrTruncated,
89
+ });
90
+ const visible = encoded.subarray(0, modelLimit).toString("utf8");
91
+ return {
92
+ output: `${visible}\n\n[Output truncated. Full captured output: ${artifact.uri}]`,
93
+ artifactUri: artifact.uri,
94
+ truncated: true,
95
+ };
96
+ },
97
+ };
98
+ //# sourceMappingURL=bash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import { ToolRegistry } from "./registry.js";
2
+ import { type AgentBatchRunner } from "./agents.js";
3
+ import type { SchedulerStore } from "../scheduler/store.js";
4
+ export declare function createWorkerToolRegistry(): ToolRegistry;
5
+ export declare function createCoreToolRegistry(scheduler?: SchedulerStore, agents?: AgentBatchRunner): ToolRegistry;
6
+ export { ToolRegistry, ToolDeniedError } from "./registry.js";
7
+ export type { ApprovalDecision, ApprovalRequest, QuestionRequest, ToolContext, ToolResult } from "./types.js";
8
+ export type { AgentBatchRunner, AgentTaskInput, RunAgentsArgs } from "./agents.js";
9
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,wBAAgB,wBAAwB,IAAI,YAAY,CAOvD;AAED,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,CAa1G;AAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9G,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,34 @@
1
+ import { applyPatchTool } from "./apply-patch.js";
2
+ import { askUserTool } from "./ask.js";
3
+ import { bashTool } from "./bash.js";
4
+ import { readTool } from "./read.js";
5
+ import { ToolRegistry } from "./registry.js";
6
+ import { globTool, grepTool } from "./search.js";
7
+ import { createScheduleTools } from "./schedule.js";
8
+ import { createRunAgentsTool } from "./agents.js";
9
+ export function createWorkerToolRegistry() {
10
+ return new ToolRegistry()
11
+ .register(readTool)
12
+ .register(globTool)
13
+ .register(grepTool)
14
+ .register(applyPatchTool)
15
+ .register(bashTool);
16
+ }
17
+ export function createCoreToolRegistry(scheduler, agents) {
18
+ const registry = new ToolRegistry()
19
+ .register(readTool)
20
+ .register(globTool)
21
+ .register(grepTool)
22
+ .register(applyPatchTool)
23
+ .register(bashTool)
24
+ .register(askUserTool);
25
+ if (agents)
26
+ registry.register(createRunAgentsTool(agents));
27
+ if (scheduler) {
28
+ for (const tool of createScheduleTools(scheduler))
29
+ registry.register(tool);
30
+ }
31
+ return registry;
32
+ }
33
+ export { ToolRegistry, ToolDeniedError } from "./registry.js";
34
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAyB,MAAM,aAAa,CAAC;AAGzE,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,YAAY,EAAE;SACtB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,cAAc,CAAC;SACxB,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAA0B,EAAE,MAAyB;IAC1F,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE;SAChC,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,cAAc,CAAC;SACxB,QAAQ,CAAC,QAAQ,CAAC;SAClB,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzB,IAAI,MAAM;QAAE,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,3 @@
1
+ export declare function isWithin(root: string, candidate: string): boolean;
2
+ export declare function resolveWorkspacePath(workspace: string, requested: string, allowMissing?: boolean): string;
3
+ //# sourceMappingURL=paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAGA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAGjE;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CAsBvG"}
@@ -0,0 +1,34 @@
1
+ import { existsSync, realpathSync } from "node:fs";
2
+ import { dirname, isAbsolute, relative, resolve, sep } from "node:path";
3
+ export function isWithin(root, candidate) {
4
+ const rel = relative(root, candidate);
5
+ return rel === "" || (!rel.startsWith(`..${sep}`) && rel !== ".." && !isAbsolute(rel));
6
+ }
7
+ export function resolveWorkspacePath(workspace, requested, allowMissing = false) {
8
+ if (requested.includes("\0"))
9
+ throw new Error("Path contains a NUL byte");
10
+ const root = realpathSync(workspace);
11
+ const lexical = resolve(root, requested);
12
+ if (!isWithin(root, lexical))
13
+ throw new Error(`Path is outside the workspace: ${requested}`);
14
+ if (existsSync(lexical)) {
15
+ const actual = realpathSync(lexical);
16
+ if (!isWithin(root, actual))
17
+ throw new Error(`Path resolves outside the workspace: ${requested}`);
18
+ return actual;
19
+ }
20
+ if (!allowMissing)
21
+ throw new Error(`Path does not exist: ${requested}`);
22
+ let existingParent = dirname(lexical);
23
+ while (!existsSync(existingParent)) {
24
+ const parent = dirname(existingParent);
25
+ if (parent === existingParent)
26
+ throw new Error(`No existing parent for path: ${requested}`);
27
+ existingParent = parent;
28
+ }
29
+ const actualParent = realpathSync(existingParent);
30
+ if (!isWithin(root, actualParent))
31
+ throw new Error(`Path parent resolves outside the workspace: ${requested}`);
32
+ return lexical;
33
+ }
34
+ //# sourceMappingURL=paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/tools/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAExE,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAiB;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,SAAiB,EAAE,YAAY,GAAG,KAAK;IAC7F,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,SAAS,EAAE,CAAC,CAAC;IAE7F,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,EAAE,CAAC,CAAC;QAClG,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;IAExE,IAAI,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,cAAc;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;QAC5F,cAAc,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,MAAM,YAAY,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,SAAS,EAAE,CAAC,CAAC;IAC/G,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,21 @@
1
+ export interface ProcessResult {
2
+ stdout: Buffer;
3
+ stderr: Buffer;
4
+ stdoutBytes: number;
5
+ stderrBytes: number;
6
+ stdoutTruncated: boolean;
7
+ stderrTruncated: boolean;
8
+ exitCode: number | null;
9
+ signal: NodeJS.Signals | null;
10
+ timedOut: boolean;
11
+ }
12
+ export interface ProcessOptions {
13
+ cwd: string;
14
+ env?: NodeJS.ProcessEnv;
15
+ timeoutMs: number;
16
+ captureBytes: number;
17
+ signal?: AbortSignal;
18
+ detached?: boolean;
19
+ }
20
+ export declare function runProcess(command: string, args: string[], options: ProcessOptions): Promise<ProcessResult>;
21
+ //# sourceMappingURL=process.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAQD,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAyF3G"}
@@ -0,0 +1,104 @@
1
+ import { spawn } from "node:child_process";
2
+ function appendBounded(chunks, chunk, currentBytes, limit) {
3
+ const remaining = limit - currentBytes;
4
+ if (remaining <= 0)
5
+ return;
6
+ chunks.push(chunk.subarray(0, remaining));
7
+ }
8
+ export function runProcess(command, args, options) {
9
+ if (options.signal?.aborted) {
10
+ return Promise.reject(options.signal.reason ?? new Error("Process execution was aborted before start"));
11
+ }
12
+ return new Promise((resolve, reject) => {
13
+ const child = spawn(command, args, {
14
+ cwd: options.cwd,
15
+ env: options.env ?? process.env,
16
+ detached: options.detached ?? true,
17
+ stdio: ["ignore", "pipe", "pipe"],
18
+ });
19
+ const stdout = [];
20
+ const stderr = [];
21
+ let stdoutBytes = 0;
22
+ let stderrBytes = 0;
23
+ let timedOut = false;
24
+ let settled = false;
25
+ let terminating = false;
26
+ let killTimer;
27
+ const signalGroup = (signal) => {
28
+ if (!child.pid)
29
+ return;
30
+ try {
31
+ process.kill(-(child.pid), signal);
32
+ }
33
+ catch {
34
+ try {
35
+ child.kill(signal);
36
+ }
37
+ catch {
38
+ // The process already exited.
39
+ }
40
+ }
41
+ };
42
+ const terminate = () => {
43
+ if (settled || terminating)
44
+ return;
45
+ terminating = true;
46
+ signalGroup("SIGTERM");
47
+ killTimer = setTimeout(() => {
48
+ if (!settled)
49
+ signalGroup("SIGKILL");
50
+ }, 5_000);
51
+ killTimer.unref();
52
+ };
53
+ const timeout = setTimeout(() => {
54
+ timedOut = true;
55
+ terminate();
56
+ }, options.timeoutMs);
57
+ timeout.unref();
58
+ const onAbort = () => terminate();
59
+ options.signal?.addEventListener("abort", onAbort, { once: true });
60
+ if (options.signal?.aborted)
61
+ terminate();
62
+ child.stdout.on("data", (value) => {
63
+ appendBounded(stdout, value, Math.min(stdoutBytes, options.captureBytes), options.captureBytes);
64
+ stdoutBytes += value.byteLength;
65
+ });
66
+ child.stderr.on("data", (value) => {
67
+ appendBounded(stderr, value, Math.min(stderrBytes, options.captureBytes), options.captureBytes);
68
+ stderrBytes += value.byteLength;
69
+ });
70
+ child.once("error", (error) => {
71
+ if (settled)
72
+ return;
73
+ settled = true;
74
+ clearTimeout(timeout);
75
+ if (killTimer)
76
+ clearTimeout(killTimer);
77
+ options.signal?.removeEventListener("abort", onAbort);
78
+ reject(error);
79
+ });
80
+ child.once("close", (exitCode, signal) => {
81
+ if (settled)
82
+ return;
83
+ if (options.detached ?? true)
84
+ signalGroup("SIGKILL");
85
+ settled = true;
86
+ clearTimeout(timeout);
87
+ if (killTimer)
88
+ clearTimeout(killTimer);
89
+ options.signal?.removeEventListener("abort", onAbort);
90
+ resolve({
91
+ stdout: Buffer.concat(stdout),
92
+ stderr: Buffer.concat(stderr),
93
+ stdoutBytes,
94
+ stderrBytes,
95
+ stdoutTruncated: stdoutBytes > options.captureBytes,
96
+ stderrTruncated: stderrBytes > options.captureBytes,
97
+ exitCode,
98
+ signal,
99
+ timedOut,
100
+ });
101
+ });
102
+ });
103
+ }
104
+ //# sourceMappingURL=process.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/tools/process.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ import type { GlassTool } from "./types.js";
2
+ interface ReadArgs {
3
+ path: string;
4
+ offset: number | null;
5
+ limit: number | null;
6
+ }
7
+ export declare const readTool: GlassTool<ReadArgs>;
8
+ export {};
9
+ //# sourceMappingURL=read.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAA2B,MAAM,YAAY,CAAC;AAGrE,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAkDD,eAAO,MAAM,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAsCxC,CAAC"}
@@ -0,0 +1,95 @@
1
+ import { closeSync, createReadStream, openSync, readSync, readdirSync, statSync } from "node:fs";
2
+ import { relative } from "node:path";
3
+ import { createInterface } from "node:readline";
4
+ import { resolveWorkspacePath } from "./paths.js";
5
+ async function numberedFileLines(path, offset, limit) {
6
+ const stream = createReadStream(path, { encoding: "utf8" });
7
+ const lines = createInterface({ input: stream, crlfDelay: Infinity });
8
+ const selected = [];
9
+ let lineNumber = 0;
10
+ let truncated = false;
11
+ try {
12
+ for await (const line of lines) {
13
+ lineNumber += 1;
14
+ if (lineNumber < offset)
15
+ continue;
16
+ if (selected.length >= limit) {
17
+ truncated = true;
18
+ break;
19
+ }
20
+ selected.push(`${lineNumber}: ${line}`);
21
+ }
22
+ }
23
+ finally {
24
+ lines.close();
25
+ stream.destroy();
26
+ }
27
+ return { output: selected.join("\n"), truncated };
28
+ }
29
+ function binarySample(path, byteCount) {
30
+ const fd = openSync(path, "r");
31
+ try {
32
+ const sample = Buffer.allocUnsafe(Math.min(byteCount, 8_192));
33
+ const bytesRead = readSync(fd, sample, 0, sample.byteLength, 0);
34
+ return sample.subarray(0, bytesRead).includes(0);
35
+ }
36
+ finally {
37
+ closeSync(fd);
38
+ }
39
+ }
40
+ async function readArtifact(args, context) {
41
+ const offset = Math.max(0, args.offset ?? 0);
42
+ const limit = Math.min(args.limit ?? context.config.tools.maxOutputBytes, context.config.tools.maxOutputBytes);
43
+ const artifact = context.artifacts.get(args.path);
44
+ if (!artifact)
45
+ throw new Error(`Artifact not found: ${args.path}`);
46
+ const data = context.artifacts.read(args.path, offset, limit);
47
+ const truncated = offset + data.byteLength < artifact.byteCount;
48
+ return {
49
+ output: `${data.toString("utf8")}${truncated ? `\n\n[Truncated. Continue at byte offset ${offset + data.byteLength}.]` : ""}`,
50
+ truncated,
51
+ artifactUri: artifact.uri,
52
+ };
53
+ }
54
+ export const readTool = {
55
+ name: "read",
56
+ description: "Read a text file with line numbers, list a directory, or read a bounded range from an artifact:// URI.",
57
+ risk: "read",
58
+ parameters: {
59
+ type: "object",
60
+ properties: {
61
+ path: { type: "string", minLength: 1, description: "Workspace-relative path or artifact:// URI" },
62
+ offset: { type: ["integer", "null"], minimum: 0, description: "1-based line for files; byte offset for artifacts" },
63
+ limit: { type: ["integer", "null"], minimum: 1, description: "Maximum lines or artifact bytes" },
64
+ },
65
+ required: ["path", "offset", "limit"],
66
+ additionalProperties: false,
67
+ },
68
+ summarize: (args) => `Read ${args.path}`,
69
+ async execute(args, context) {
70
+ if (args.path.startsWith("artifact://"))
71
+ return readArtifact(args, context);
72
+ const path = resolveWorkspacePath(context.workspace, args.path);
73
+ const stat = statSync(path);
74
+ if (stat.isDirectory()) {
75
+ const entries = readdirSync(path, { withFileTypes: true })
76
+ .sort((left, right) => left.name.localeCompare(right.name))
77
+ .slice(0, context.config.tools.maxReadLines)
78
+ .map((entry) => `${entry.name}${entry.isDirectory() ? "/" : ""}`);
79
+ return { output: entries.join("\n") || "[Empty directory]" };
80
+ }
81
+ if (!stat.isFile())
82
+ throw new Error(`Not a regular file: ${args.path}`);
83
+ if (binarySample(path, stat.size)) {
84
+ return { output: `[Binary file: ${relative(context.workspace, path)}, ${stat.size} bytes]` };
85
+ }
86
+ const offset = Math.max(1, args.offset ?? 1);
87
+ const limit = Math.min(args.limit ?? context.config.tools.maxReadLines, context.config.tools.maxReadLines);
88
+ const result = await numberedFileLines(path, offset, limit);
89
+ return {
90
+ output: `${result.output}${result.truncated ? `\n\n[Truncated. Continue at line ${offset + limit}.]` : ""}`,
91
+ truncated: result.truncated,
92
+ };
93
+ },
94
+ };
95
+ //# sourceMappingURL=read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { FunctionTool } from "openai/resources/responses/responses";
2
+ import type { GlassTool, ToolContext, ToolResult } from "./types.js";
3
+ export declare function toolApprovalSignature(tool: string, args: unknown): string;
4
+ export declare class ToolDeniedError extends Error {
5
+ constructor(message?: string);
6
+ }
7
+ export declare class ToolPreflightError extends Error {
8
+ constructor(message: string);
9
+ }
10
+ export declare class ToolRegistry {
11
+ private readonly tools;
12
+ private readonly ajv;
13
+ register(tool: GlassTool): this;
14
+ definitions(): FunctionTool[];
15
+ get(name: string): GlassTool | null;
16
+ parseArguments(name: string, raw: string): unknown;
17
+ execute(name: string, args: unknown, context: ToolContext): Promise<ToolResult>;
18
+ }
19
+ //# sourceMappingURL=registry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmCrE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAEzE;AAmCD,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,SAAkC;CAItD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AASD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqE;IAEzF,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAM/B,WAAW,IAAI,YAAY,EAAE;IAI7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAInC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAgB5C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAmEtF"}