@johannes.latzel/llm-chat-shell 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.
- package/LICENSE +7 -0
- package/README.md +43 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +9 -0
- package/dist/index.js.map +1 -0
- package/dist/lib/bash-executor.d.ts +125 -0
- package/dist/lib/bash-executor.d.ts.map +1 -0
- package/dist/lib/bash-executor.js +314 -0
- package/dist/lib/bash-executor.js.map +1 -0
- package/dist/lib/config.d.ts +79 -0
- package/dist/lib/config.d.ts.map +1 -0
- package/dist/lib/config.js +216 -0
- package/dist/lib/config.js.map +1 -0
- package/dist/lib/env.d.ts +34 -0
- package/dist/lib/env.d.ts.map +1 -0
- package/dist/lib/env.js +77 -0
- package/dist/lib/env.js.map +1 -0
- package/dist/lib/job-registry.d.ts +55 -0
- package/dist/lib/job-registry.d.ts.map +1 -0
- package/dist/lib/job-registry.js +116 -0
- package/dist/lib/job-registry.js.map +1 -0
- package/dist/lib/permission.d.ts +101 -0
- package/dist/lib/permission.d.ts.map +1 -0
- package/dist/lib/permission.js +361 -0
- package/dist/lib/permission.js.map +1 -0
- package/dist/lib/session-manager.d.ts +148 -0
- package/dist/lib/session-manager.d.ts.map +1 -0
- package/dist/lib/session-manager.js +264 -0
- package/dist/lib/session-manager.js.map +1 -0
- package/dist/lib/session-queue.d.ts +58 -0
- package/dist/lib/session-queue.d.ts.map +1 -0
- package/dist/lib/session-queue.js +123 -0
- package/dist/lib/session-queue.js.map +1 -0
- package/dist/lib/session-registry.d.ts +140 -0
- package/dist/lib/session-registry.d.ts.map +1 -0
- package/dist/lib/session-registry.js +267 -0
- package/dist/lib/session-registry.js.map +1 -0
- package/dist/lib/types.d.ts +155 -0
- package/dist/lib/types.d.ts.map +1 -0
- package/dist/lib/types.js +37 -0
- package/dist/lib/types.js.map +1 -0
- package/dist/tools/shell-command-tool.d.ts +30 -0
- package/dist/tools/shell-command-tool.d.ts.map +1 -0
- package/dist/tools/shell-command-tool.js +138 -0
- package/dist/tools/shell-command-tool.js.map +1 -0
- package/dist/tools/shell-create-tool.d.ts +12 -0
- package/dist/tools/shell-create-tool.d.ts.map +1 -0
- package/dist/tools/shell-create-tool.js +24 -0
- package/dist/tools/shell-create-tool.js.map +1 -0
- package/dist/tools/shell-job-status-tool.d.ts +13 -0
- package/dist/tools/shell-job-status-tool.d.ts.map +1 -0
- package/dist/tools/shell-job-status-tool.js +59 -0
- package/dist/tools/shell-job-status-tool.js.map +1 -0
- package/dist/tools/shell-jobs-tool.d.ts +12 -0
- package/dist/tools/shell-jobs-tool.d.ts.map +1 -0
- package/dist/tools/shell-jobs-tool.js +28 -0
- package/dist/tools/shell-jobs-tool.js.map +1 -0
- package/dist/tools/shell-package.d.ts +54 -0
- package/dist/tools/shell-package.d.ts.map +1 -0
- package/dist/tools/shell-package.js +77 -0
- package/dist/tools/shell-package.js.map +1 -0
- package/dist/tools/shell-permissions-tool.d.ts +15 -0
- package/dist/tools/shell-permissions-tool.d.ts.map +1 -0
- package/dist/tools/shell-permissions-tool.js +38 -0
- package/dist/tools/shell-permissions-tool.js.map +1 -0
- package/package.json +87 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-command-tool.js","sourceRoot":"","sources":["../../src/tools/shell-command-tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Tool, type PartialToolResult } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import type { ShellSessionManager } from '../lib/session-manager.js';
|
|
3
|
+
/**
|
|
4
|
+
* Tool that creates a new persistent shell session.
|
|
5
|
+
* Returns a session ID that can be used with the shell_command tool.
|
|
6
|
+
*/
|
|
7
|
+
export declare class ShellCreateTool extends Tool {
|
|
8
|
+
private sessionManager;
|
|
9
|
+
constructor(sessionManager: ShellSessionManager);
|
|
10
|
+
protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=shell-create-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-create-tool.d.ts","sourceRoot":"","sources":["../../src/tools/shell-create-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EAIJ,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,IAAI;IACzB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,mBAAmB;cAavC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAQvF"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { Tool, ToolParameters, ToolParameterProperty, ResultStatus } from '@johannes.latzel/llm-chat';
|
|
2
|
+
/**
|
|
3
|
+
* Tool that creates a new persistent shell session.
|
|
4
|
+
* Returns a session ID that can be used with the shell_command tool.
|
|
5
|
+
*/
|
|
6
|
+
export class ShellCreateTool extends Tool {
|
|
7
|
+
sessionManager;
|
|
8
|
+
constructor(sessionManager) {
|
|
9
|
+
super('shell_create', 'Creates a new persistent shell session. Returns a session ID for use with shell_command.', new ToolParameters({
|
|
10
|
+
cwd: ToolParameterProperty.string('Working directory for this session. Must be within the configured working directory. ' +
|
|
11
|
+
'Relative paths are resolved against the configured cwd.')
|
|
12
|
+
}));
|
|
13
|
+
this.sessionManager = sessionManager;
|
|
14
|
+
}
|
|
15
|
+
async onExecute(args) {
|
|
16
|
+
const cwd = args['cwd'];
|
|
17
|
+
const sessionId = await this.sessionManager.createSession(cwd);
|
|
18
|
+
return {
|
|
19
|
+
result: sessionId,
|
|
20
|
+
status: ResultStatus.Success
|
|
21
|
+
};
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
//# sourceMappingURL=shell-create-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-create-tool.js","sourceRoot":"","sources":["../../src/tools/shell-create-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EACJ,cAAc,EACd,qBAAqB,EACrB,YAAY,EAEf,MAAM,2BAA2B,CAAC;AAGnC;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI;IACjB;IAApB,YAAoB,cAAmC;QACnD,KAAK,CACD,cAAc,EACd,0FAA0F,EAC1F,IAAI,cAAc,CAAC;YACf,GAAG,EAAE,qBAAqB,CAAC,MAAM,CAC7B,uFAAuF;gBACnF,yDAAyD,CAChE;SACJ,CAAC,CACL,CAAC;QAVc,mBAAc,GAAd,cAAc,CAAqB;IAWvD,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAA6B;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAuB,CAAC;QAC9C,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO;YACH,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,YAAY,CAAC,OAAO;SAC/B,CAAC;IACN,CAAC;CACJ"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { Tool, type PartialToolResult } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import type { ShellSessionManager } from '../lib/session-manager.js';
|
|
3
|
+
/**
|
|
4
|
+
* Tool that returns the status and, once finished, the results of a background
|
|
5
|
+
* job submitted with `shell_command` and `background=true`.
|
|
6
|
+
*/
|
|
7
|
+
export declare class ShellJobStatusTool extends Tool {
|
|
8
|
+
private sessionManager;
|
|
9
|
+
constructor(sessionManager: ShellSessionManager);
|
|
10
|
+
protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
|
|
11
|
+
private formatJob;
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=shell-job-status-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-job-status-tool.d.ts","sourceRoot":"","sources":["../../src/tools/shell-job-status-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EAIJ,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIrE;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,IAAI;IAC5B,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,mBAAmB;cAevC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOpF,OAAO,CAAC,SAAS;CAqCpB"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { Tool, ToolParameters, ToolParameterProperty, ResultStatus } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import { ShellJobStatus } from '../lib/types.js';
|
|
3
|
+
/**
|
|
4
|
+
* Tool that returns the status and, once finished, the results of a background
|
|
5
|
+
* job submitted with `shell_command` and `background=true`.
|
|
6
|
+
*/
|
|
7
|
+
export class ShellJobStatusTool extends Tool {
|
|
8
|
+
sessionManager;
|
|
9
|
+
constructor(sessionManager) {
|
|
10
|
+
super('shell_job_status', 'Returns the status and, once finished, the results (stdout, stderr, exit code) of a background job submitted with shell_command (background=true). Requires the jobId returned at submission.', new ToolParameters({
|
|
11
|
+
jobId: ToolParameterProperty.string('The job ID returned by shell_command when background=true.')
|
|
12
|
+
}, ['jobId']));
|
|
13
|
+
this.sessionManager = sessionManager;
|
|
14
|
+
}
|
|
15
|
+
async onExecute(args) {
|
|
16
|
+
this.validateRequiredParams(args, ['jobId']);
|
|
17
|
+
const jobId = args['jobId'];
|
|
18
|
+
const job = await this.sessionManager.getJobStatus(jobId);
|
|
19
|
+
return { result: this.formatJob(job), status: ResultStatus.Success };
|
|
20
|
+
}
|
|
21
|
+
formatJob(job) {
|
|
22
|
+
const parts = [];
|
|
23
|
+
parts.push(`jobId: ${job.id}`);
|
|
24
|
+
parts.push(`session: ${job.sessionId}`);
|
|
25
|
+
parts.push(`cwd: ${job.cwd}`);
|
|
26
|
+
parts.push(`command: ${job.command}`);
|
|
27
|
+
parts.push(`status: ${job.status}`);
|
|
28
|
+
parts.push(`submitted: ${new Date(job.submittedAt).toISOString()}`);
|
|
29
|
+
if (job.startedAt !== undefined) {
|
|
30
|
+
parts.push(`started: ${new Date(job.startedAt).toISOString()}`);
|
|
31
|
+
}
|
|
32
|
+
if (job.finishedAt !== undefined) {
|
|
33
|
+
parts.push(`finished: ${new Date(job.finishedAt).toISOString()}`);
|
|
34
|
+
}
|
|
35
|
+
parts.push(`idle timeout: ${job.idleTimeoutMs}ms`);
|
|
36
|
+
if (job.status === ShellJobStatus.Queued) {
|
|
37
|
+
parts.push(`queue position: ${job.position}`);
|
|
38
|
+
}
|
|
39
|
+
if (job.status === ShellJobStatus.Failed && job.error !== undefined) {
|
|
40
|
+
parts.push(`error: ${job.error}`);
|
|
41
|
+
}
|
|
42
|
+
if (job.status === ShellJobStatus.Completed) {
|
|
43
|
+
if (job.stdout !== undefined && job.stdout.length > 0) {
|
|
44
|
+
parts.push(`stdout:\n${job.stdout}`);
|
|
45
|
+
}
|
|
46
|
+
if (job.stderr !== undefined && job.stderr.length > 0) {
|
|
47
|
+
parts.push(`[stderr] ${job.stderr}`);
|
|
48
|
+
}
|
|
49
|
+
if (job.timedOut === true) {
|
|
50
|
+
parts.push('[timed out]');
|
|
51
|
+
}
|
|
52
|
+
if (job.exitCode !== undefined && job.exitCode !== 0) {
|
|
53
|
+
parts.push(`[exit code: ${job.exitCode}]`);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
return parts.join('\n');
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=shell-job-status-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-job-status-tool.js","sourceRoot":"","sources":["../../src/tools/shell-job-status-tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { Tool, type PartialToolResult } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import type { ShellSessionManager } from '../lib/session-manager.js';
|
|
3
|
+
/**
|
|
4
|
+
* Tool that lists the background jobs submitted to a session
|
|
5
|
+
* (queued, running, completed, failed), oldest first.
|
|
6
|
+
*/
|
|
7
|
+
export declare class ShellJobsTool extends Tool {
|
|
8
|
+
private sessionManager;
|
|
9
|
+
constructor(sessionManager: ShellSessionManager);
|
|
10
|
+
protected onExecute(args: Record<string, unknown>): Promise<PartialToolResult>;
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=shell-jobs-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-jobs-tool.d.ts","sourceRoot":"","sources":["../../src/tools/shell-jobs-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EAIJ,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,IAAI;IACvB,OAAO,CAAC,cAAc;gBAAd,cAAc,EAAE,mBAAmB;cAavC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAavF"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { Tool, ToolParameters, ToolParameterProperty, ResultStatus } from '@johannes.latzel/llm-chat';
|
|
2
|
+
/**
|
|
3
|
+
* Tool that lists the background jobs submitted to a session
|
|
4
|
+
* (queued, running, completed, failed), oldest first.
|
|
5
|
+
*/
|
|
6
|
+
export class ShellJobsTool extends Tool {
|
|
7
|
+
sessionManager;
|
|
8
|
+
constructor(sessionManager) {
|
|
9
|
+
super('shell_jobs', 'Lists the background jobs submitted to a session (queued, running, completed, failed), oldest first. Requires a session ID from shell_create.', new ToolParameters({
|
|
10
|
+
sessionId: ToolParameterProperty.string('The session ID from shell_create.')
|
|
11
|
+
}, ['sessionId']));
|
|
12
|
+
this.sessionManager = sessionManager;
|
|
13
|
+
}
|
|
14
|
+
async onExecute(args) {
|
|
15
|
+
this.validateRequiredParams(args, ['sessionId']);
|
|
16
|
+
const sessionId = args['sessionId'];
|
|
17
|
+
const jobs = await this.sessionManager.listJobs(sessionId);
|
|
18
|
+
if (jobs.length === 0) {
|
|
19
|
+
return { result: `No jobs for session ${sessionId}.`, status: ResultStatus.Success };
|
|
20
|
+
}
|
|
21
|
+
const lines = jobs.map((job) => `${job.status}\t${job.id}\t${job.cwd}\t${job.command}`);
|
|
22
|
+
return {
|
|
23
|
+
result: `${jobs.length} job(s) for session ${sessionId}:\n${lines.join('\n')}`,
|
|
24
|
+
status: ResultStatus.Success
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=shell-jobs-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-jobs-tool.js","sourceRoot":"","sources":["../../src/tools/shell-jobs-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EACJ,cAAc,EACd,qBAAqB,EACrB,YAAY,EAEf,MAAM,2BAA2B,CAAC;AAGnC;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI;IACf;IAApB,YAAoB,cAAmC;QACnD,KAAK,CACD,YAAY,EACZ,+IAA+I,EAC/I,IAAI,cAAc,CACd;YACI,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,mCAAmC,CAAC;SAC/E,EACD,CAAC,WAAW,CAAC,CAChB,CACJ,CAAC;QAVc,mBAAc,GAAd,cAAc,CAAqB;IAWvD,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAA6B;QACnD,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAW,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,MAAM,EAAE,uBAAuB,SAAS,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;QACzF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,OAAO;YACH,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,uBAAuB,SAAS,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC9E,MAAM,EAAE,YAAY,CAAC,OAAO;SAC/B,CAAC;IACN,CAAC;CACJ"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { ToolPackage } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import { Workspace } from '@johannes.latzel/llm-chat-workspace';
|
|
3
|
+
import { ShellConfiguration } from '../lib/config.js';
|
|
4
|
+
import { ShellSessionManager } from '../lib/session-manager.js';
|
|
5
|
+
/**
|
|
6
|
+
* A package of shell tools for LLM chat.
|
|
7
|
+
* Provides `shell_create`, `shell_command`, `shell_permissions`, `shell_job_status`,
|
|
8
|
+
* `shell_jobs`, and `switch_workspace` tools with a per-workspace permission system.
|
|
9
|
+
* Background jobs (`shell_command` with `background=true`) run one at a time per
|
|
10
|
+
* session in FIFO order; poll `shell_job_status` / `shell_jobs` for their progress.
|
|
11
|
+
*
|
|
12
|
+
* @example
|
|
13
|
+
* ```typescript
|
|
14
|
+
* // Default config (reads from env vars)
|
|
15
|
+
* const pkg = new ShellPackage();
|
|
16
|
+
* service.tools().add(pkg);
|
|
17
|
+
*
|
|
18
|
+
* // With config overrides
|
|
19
|
+
* const config = new ShellConfiguration();
|
|
20
|
+
* config.ctrlCTimeout = 10000;
|
|
21
|
+
* config.sigtermTimeout = 3000;
|
|
22
|
+
* config.permissionRules = [
|
|
23
|
+
* { pattern: 'git *', action: PermissionAction.Allow },
|
|
24
|
+
* { pattern: 'rm *', action: PermissionAction.Deny },
|
|
25
|
+
* ];
|
|
26
|
+
* const pkg = new ShellPackage(config);
|
|
27
|
+
* service.tools().add(pkg);
|
|
28
|
+
*
|
|
29
|
+
* // With your own session manager and workspace (for lifecycle control)
|
|
30
|
+
* const factory: ShellExecutorFactory = { create: async () => new MyExecutor() };
|
|
31
|
+
* const workspace = new Workspace(new DirectoryConfiguration());
|
|
32
|
+
* const manager = new ShellSessionManager(factory, config, workspace);
|
|
33
|
+
* const pkg = new ShellPackage(config, manager, workspace);
|
|
34
|
+
* service.tools().add(pkg);
|
|
35
|
+
* // ... later:
|
|
36
|
+
* await manager.close();
|
|
37
|
+
* ```
|
|
38
|
+
*/
|
|
39
|
+
export declare class ShellPackage extends ToolPackage {
|
|
40
|
+
private readonly sessionManager;
|
|
41
|
+
/**
|
|
42
|
+
* @param config - Shell configuration. Defaults to a new {@link ShellConfiguration} (reads from env vars).
|
|
43
|
+
* @param sessionManager - Optional pre-configured session manager. When provided, its own workspace is
|
|
44
|
+
* used by the tools, so it must be constructed with the desired workspace.
|
|
45
|
+
* @param workspace - Optional shared workspace. Only used when no session manager is provided; the
|
|
46
|
+
* internally-built manager then shares this workspace instance.
|
|
47
|
+
*/
|
|
48
|
+
constructor(config?: ShellConfiguration, sessionManager?: ShellSessionManager, workspace?: Workspace);
|
|
49
|
+
/**
|
|
50
|
+
* Close all sessions and stop background timers (idle-expiry sweeper).
|
|
51
|
+
*/
|
|
52
|
+
dispose(): Promise<void>;
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=shell-package.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-package.d.ts","sourceRoot":"","sources":["../../src/tools/shell-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACH,SAAS,EAGZ,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAQhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,YAAa,SAAQ,WAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IAErD;;;;;;OAMG;gBAEC,MAAM,CAAC,EAAE,kBAAkB,EAC3B,cAAc,CAAC,EAAE,mBAAmB,EACpC,SAAS,CAAC,EAAE,SAAS;IA4BzB;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAGjC"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { ToolPackage } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import { Workspace, SwitchWorkspaceTool, DirectoryConfiguration } from '@johannes.latzel/llm-chat-workspace';
|
|
3
|
+
import { ShellConfiguration } from '../lib/config.js';
|
|
4
|
+
import { BashShellExecutorFactory } from '../lib/bash-executor.js';
|
|
5
|
+
import { ShellSessionManager } from '../lib/session-manager.js';
|
|
6
|
+
import { PermissionSystem } from '../lib/permission.js';
|
|
7
|
+
import { ShellCreateTool } from './shell-create-tool.js';
|
|
8
|
+
import { ShellCommandTool } from './shell-command-tool.js';
|
|
9
|
+
import { ShellPermissionsTool } from './shell-permissions-tool.js';
|
|
10
|
+
import { ShellJobStatusTool } from './shell-job-status-tool.js';
|
|
11
|
+
import { ShellJobsTool } from './shell-jobs-tool.js';
|
|
12
|
+
/**
|
|
13
|
+
* A package of shell tools for LLM chat.
|
|
14
|
+
* Provides `shell_create`, `shell_command`, `shell_permissions`, `shell_job_status`,
|
|
15
|
+
* `shell_jobs`, and `switch_workspace` tools with a per-workspace permission system.
|
|
16
|
+
* Background jobs (`shell_command` with `background=true`) run one at a time per
|
|
17
|
+
* session in FIFO order; poll `shell_job_status` / `shell_jobs` for their progress.
|
|
18
|
+
*
|
|
19
|
+
* @example
|
|
20
|
+
* ```typescript
|
|
21
|
+
* // Default config (reads from env vars)
|
|
22
|
+
* const pkg = new ShellPackage();
|
|
23
|
+
* service.tools().add(pkg);
|
|
24
|
+
*
|
|
25
|
+
* // With config overrides
|
|
26
|
+
* const config = new ShellConfiguration();
|
|
27
|
+
* config.ctrlCTimeout = 10000;
|
|
28
|
+
* config.sigtermTimeout = 3000;
|
|
29
|
+
* config.permissionRules = [
|
|
30
|
+
* { pattern: 'git *', action: PermissionAction.Allow },
|
|
31
|
+
* { pattern: 'rm *', action: PermissionAction.Deny },
|
|
32
|
+
* ];
|
|
33
|
+
* const pkg = new ShellPackage(config);
|
|
34
|
+
* service.tools().add(pkg);
|
|
35
|
+
*
|
|
36
|
+
* // With your own session manager and workspace (for lifecycle control)
|
|
37
|
+
* const factory: ShellExecutorFactory = { create: async () => new MyExecutor() };
|
|
38
|
+
* const workspace = new Workspace(new DirectoryConfiguration());
|
|
39
|
+
* const manager = new ShellSessionManager(factory, config, workspace);
|
|
40
|
+
* const pkg = new ShellPackage(config, manager, workspace);
|
|
41
|
+
* service.tools().add(pkg);
|
|
42
|
+
* // ... later:
|
|
43
|
+
* await manager.close();
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export class ShellPackage extends ToolPackage {
|
|
47
|
+
sessionManager;
|
|
48
|
+
/**
|
|
49
|
+
* @param config - Shell configuration. Defaults to a new {@link ShellConfiguration} (reads from env vars).
|
|
50
|
+
* @param sessionManager - Optional pre-configured session manager. When provided, its own workspace is
|
|
51
|
+
* used by the tools, so it must be constructed with the desired workspace.
|
|
52
|
+
* @param workspace - Optional shared workspace. Only used when no session manager is provided; the
|
|
53
|
+
* internally-built manager then shares this workspace instance.
|
|
54
|
+
*/
|
|
55
|
+
constructor(config, sessionManager, workspace) {
|
|
56
|
+
const cfg = config ?? new ShellConfiguration();
|
|
57
|
+
const manager = sessionManager ??
|
|
58
|
+
new ShellSessionManager(new BashShellExecutorFactory(cfg), cfg, workspace ?? new Workspace(new DirectoryConfiguration()));
|
|
59
|
+
const permissionSystem = new PermissionSystem(cfg, (root) => manager.workspace.canWrite(root));
|
|
60
|
+
super([
|
|
61
|
+
new ShellCreateTool(manager),
|
|
62
|
+
new ShellCommandTool(manager, permissionSystem, manager.workspace),
|
|
63
|
+
new ShellPermissionsTool(cfg, manager.workspace),
|
|
64
|
+
new ShellJobStatusTool(manager),
|
|
65
|
+
new ShellJobsTool(manager),
|
|
66
|
+
new SwitchWorkspaceTool(manager.workspace)
|
|
67
|
+
]);
|
|
68
|
+
this.sessionManager = manager;
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Close all sessions and stop background timers (idle-expiry sweeper).
|
|
72
|
+
*/
|
|
73
|
+
async dispose() {
|
|
74
|
+
await this.sessionManager.dispose();
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=shell-package.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-package.js","sourceRoot":"","sources":["../../src/tools/shell-package.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACH,SAAS,EACT,mBAAmB,EACnB,sBAAsB,EACzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,OAAO,YAAa,SAAQ,WAAW;IACxB,cAAc,CAAsB;IAErD;;;;;;OAMG;IACH,YACI,MAA2B,EAC3B,cAAoC,EACpC,SAAqB;QAErB,MAAM,GAAG,GAAG,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QAE/C,MAAM,OAAO,GACT,cAAc;YACd,IAAI,mBAAmB,CACnB,IAAI,wBAAwB,CAAC,GAAG,CAAC,EACjC,GAAG,EACH,SAAS,IAAI,IAAI,SAAS,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAC3D,CAAC;QAEN,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CACxD,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CACnC,CAAC;QAEF,KAAK,CAAC;YACF,IAAI,eAAe,CAAC,OAAO,CAAC;YAC5B,IAAI,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,SAAS,CAAC;YAClE,IAAI,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC;YAChD,IAAI,kBAAkB,CAAC,OAAO,CAAC;YAC/B,IAAI,aAAa,CAAC,OAAO,CAAC;YAC1B,IAAI,mBAAmB,CAAC,OAAO,CAAC,SAAS,CAAC;SAC7C,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;CACJ"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { Tool, type PartialToolResult } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import type { Workspace } from '@johannes.latzel/llm-chat-workspace';
|
|
3
|
+
import type { ShellConfiguration } from '../lib/config.js';
|
|
4
|
+
/**
|
|
5
|
+
* Tool that returns the current workspace and the permission rules / default
|
|
6
|
+
* action that apply to it. Lets the LLM understand what commands are allowed or
|
|
7
|
+
* denied in the active workspace before attempting them.
|
|
8
|
+
*/
|
|
9
|
+
export declare class ShellPermissionsTool extends Tool {
|
|
10
|
+
private config;
|
|
11
|
+
private workspace;
|
|
12
|
+
constructor(config: ShellConfiguration, workspace: Workspace);
|
|
13
|
+
protected onExecute(): Promise<PartialToolResult>;
|
|
14
|
+
}
|
|
15
|
+
//# sourceMappingURL=shell-permissions-tool.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-permissions-tool.d.ts","sourceRoot":"","sources":["../../src/tools/shell-permissions-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EAGJ,KAAK,iBAAiB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,IAAI;IAEtC,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;gBADT,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,SAAS;cAUhB,SAAS,IAAI,OAAO,CAAC,iBAAiB,CAAC;CAuB1D"}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { Tool, ToolParameters, ResultStatus } from '@johannes.latzel/llm-chat';
|
|
2
|
+
import { workspaceForPath } from '../lib/permission.js';
|
|
3
|
+
/**
|
|
4
|
+
* Tool that returns the current workspace and the permission rules / default
|
|
5
|
+
* action that apply to it. Lets the LLM understand what commands are allowed or
|
|
6
|
+
* denied in the active workspace before attempting them.
|
|
7
|
+
*/
|
|
8
|
+
export class ShellPermissionsTool extends Tool {
|
|
9
|
+
config;
|
|
10
|
+
workspace;
|
|
11
|
+
constructor(config, workspace) {
|
|
12
|
+
super('shell_permissions', 'Returns the current workspace, its effective permission rules, and the default permission action. ' +
|
|
13
|
+
'Use this to understand what shell commands are allowed or denied before executing them.', new ToolParameters({}));
|
|
14
|
+
this.config = config;
|
|
15
|
+
this.workspace = workspace;
|
|
16
|
+
}
|
|
17
|
+
async onExecute() {
|
|
18
|
+
const currentPath = this.workspace.currentPath;
|
|
19
|
+
const roots = this.workspace.getAccesses().map((a) => a.path);
|
|
20
|
+
const root = workspaceForPath(currentPath, roots) || currentPath;
|
|
21
|
+
const perms = this.config.resolvePermissions(root);
|
|
22
|
+
const parts = [`Workspace: ${currentPath}`];
|
|
23
|
+
if (root !== currentPath) {
|
|
24
|
+
parts.push(`Workspace root: ${root}`);
|
|
25
|
+
}
|
|
26
|
+
parts.push(`Default: ${perms.defaultPermission}`);
|
|
27
|
+
if (perms.permissionRules.length > 0) {
|
|
28
|
+
parts.push('Rules:');
|
|
29
|
+
for (let i = 0; i < perms.permissionRules.length; i++) {
|
|
30
|
+
const rule = perms.permissionRules[i];
|
|
31
|
+
const access = rule.access !== undefined ? ` (${rule.access})` : '';
|
|
32
|
+
parts.push(`${i + 1}. ${rule.pattern} → ${rule.action}${access}`);
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
return { result: parts.join('\n'), status: ResultStatus.Success };
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=shell-permissions-tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell-permissions-tool.js","sourceRoot":"","sources":["../../src/tools/shell-permissions-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,IAAI,EACJ,cAAc,EACd,YAAY,EAEf,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,IAAI;IAE9B;IACA;IAFZ,YACY,MAA0B,EAC1B,SAAoB;QAE5B,KAAK,CACD,mBAAmB,EACnB,oGAAoG;YAChG,yFAAyF,EAC7F,IAAI,cAAc,CAAC,EAAE,CAAC,CACzB,CAAC;QARM,WAAM,GAAN,MAAM,CAAoB;QAC1B,cAAS,GAAT,SAAS,CAAW;IAQhC,CAAC;IAES,KAAK,CAAC,SAAS;QACrB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,WAAW,CAAC;QACjE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEnD,MAAM,KAAK,GAAa,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAElD,IAAI,KAAK,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpD,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC,CAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,MAAM,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;YACtE,CAAC;QACL,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC;IACtE,CAAC;CACJ"}
|
package/package.json
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@johannes.latzel/llm-chat-shell",
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Tightly controlled shell tool for llm-chat with permission system",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"sideEffects": false,
|
|
7
|
+
"files": [
|
|
8
|
+
"dist/",
|
|
9
|
+
"README.md",
|
|
10
|
+
"LICENSE"
|
|
11
|
+
],
|
|
12
|
+
"author": "Johannes B. Latzel",
|
|
13
|
+
"repository": {
|
|
14
|
+
"type": "git",
|
|
15
|
+
"url": "git+https://github.com/johanneslatzel/llm-chat-shell.git"
|
|
16
|
+
},
|
|
17
|
+
"bugs": {
|
|
18
|
+
"url": "https://github.com/johanneslatzel/llm-chat-shell/issues"
|
|
19
|
+
},
|
|
20
|
+
"homepage": "https://github.com/johanneslatzel/llm-chat-shell#readme",
|
|
21
|
+
"keywords": [
|
|
22
|
+
"llm",
|
|
23
|
+
"chat",
|
|
24
|
+
"shell",
|
|
25
|
+
"tool",
|
|
26
|
+
"permissions"
|
|
27
|
+
],
|
|
28
|
+
"engines": {
|
|
29
|
+
"node": ">=18"
|
|
30
|
+
},
|
|
31
|
+
"publishConfig": {
|
|
32
|
+
"access": "public"
|
|
33
|
+
},
|
|
34
|
+
"type": "module",
|
|
35
|
+
"main": "./dist/index.js",
|
|
36
|
+
"types": "./dist/index.d.ts",
|
|
37
|
+
"exports": {
|
|
38
|
+
".": {
|
|
39
|
+
"types": "./dist/index.d.ts",
|
|
40
|
+
"import": "./dist/index.js"
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
"scripts": {
|
|
44
|
+
"prebuild": "rm -rf dist/",
|
|
45
|
+
"prepack": "npm run build",
|
|
46
|
+
"build": "tsc -p tsconfig.build.json",
|
|
47
|
+
"verify": "tsc --noEmit && eslint . --max-warnings 0 && vitest run --coverage",
|
|
48
|
+
"lint": "eslint . --max-warnings 0",
|
|
49
|
+
"format": "prettier --write 'docs/**/*.md' 'src/**/*.ts' 'tests/**/*.ts'",
|
|
50
|
+
"docs": "docker run --rm -it -p 8000:8000 -v $PWD:/docs squidfunk/mkdocs-material",
|
|
51
|
+
"test": "vitest",
|
|
52
|
+
"test:coverage": "vitest run --coverage",
|
|
53
|
+
"clean:pack": "rm -rf node_modules dist/ package-lock.json && npm cache clean --force && npm install && npm run verify && npm run build && npm pack",
|
|
54
|
+
"clean:install": "rm -rf node_modules dist/ package-lock.json && npm cache clean --force && npm install && npm run verify",
|
|
55
|
+
"prepare": "husky",
|
|
56
|
+
"audit": "npm audit --audit-level=high"
|
|
57
|
+
},
|
|
58
|
+
"lint-staged": {
|
|
59
|
+
"src/**/*.ts": [
|
|
60
|
+
"prettier --write",
|
|
61
|
+
"eslint --max-warnings 0 --no-warn-ignored",
|
|
62
|
+
"vitest related --run"
|
|
63
|
+
]
|
|
64
|
+
},
|
|
65
|
+
"dependencies": {
|
|
66
|
+
"@johannes.latzel/llm-chat": "^0.7.0",
|
|
67
|
+
"@johannes.latzel/llm-chat-workspace": "^0.1.1",
|
|
68
|
+
"async-mutex": "^0.5.0",
|
|
69
|
+
"picomatch": "^4.0.5"
|
|
70
|
+
},
|
|
71
|
+
"devDependencies": {
|
|
72
|
+
"@eslint/js": "^10.0.1",
|
|
73
|
+
"@types/node": "^26.2.0",
|
|
74
|
+
"@types/picomatch": "^4.0.3",
|
|
75
|
+
"@typescript-eslint/eslint-plugin": "^8.60.0",
|
|
76
|
+
"@typescript-eslint/parser": "^8.60.0",
|
|
77
|
+
"@vitest/coverage-v8": "^4.1.8",
|
|
78
|
+
"eslint": "^10.8.1",
|
|
79
|
+
"eslint-config-prettier": "^10.1.2",
|
|
80
|
+
"eslint-plugin-n": "^18.3.0",
|
|
81
|
+
"husky": "^9.1.7",
|
|
82
|
+
"lint-staged": "^17.3.0",
|
|
83
|
+
"prettier": "^3.5.3",
|
|
84
|
+
"typescript": "^6.0.3",
|
|
85
|
+
"vitest": "^4.1.8"
|
|
86
|
+
}
|
|
87
|
+
}
|