opencode-landstrip 0.18.33 → 0.18.35
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/README.md +21 -70
- package/index.ts +5 -23
- package/package.json +2 -2
- package/shared.ts +48 -169
- package/tui.ts +143 -125
- package/LICENSE +0 -201
package/README.md
CHANGED
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
# opencode-landstrip
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[`landstrip`](https://github.com/landstrip/landstrip).
|
|
3
|
+
OpenCode plugin that runs AI `bash` calls through Landstrip.
|
|
5
4
|
|
|
6
5
|
## Install
|
|
7
6
|
|
|
@@ -13,85 +12,37 @@ opencode plugin install opencode-landstrip
|
|
|
13
12
|
opencode plugin install opencode-landstrip --global
|
|
14
13
|
```
|
|
15
14
|
|
|
16
|
-
|
|
17
|
-
`opencode.json`:
|
|
18
|
-
|
|
19
|
-
```json
|
|
20
|
-
{
|
|
21
|
-
"$schema": "https://opencode.ai/config.json",
|
|
22
|
-
"plugin": ["opencode-landstrip"]
|
|
23
|
-
}
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
Add the presenter to `tui.json`:
|
|
27
|
-
|
|
28
|
-
```json
|
|
29
|
-
{
|
|
30
|
-
"$schema": "https://opencode.ai/config.json",
|
|
31
|
-
"plugin": ["opencode-landstrip/tui"]
|
|
32
|
-
}
|
|
33
|
-
```
|
|
15
|
+
The installer configures both the server plugin and TUI presenter.
|
|
34
16
|
|
|
35
17
|
## Permissions
|
|
36
18
|
|
|
37
|
-
OpenCode
|
|
38
|
-
|
|
39
|
-
|
|
19
|
+
OpenCode permissions authorize tool dispatch. Landstrip permissions authorize
|
|
20
|
+
filesystem and network access. Agent approval never bypasses a sandbox hard
|
|
21
|
+
denial, and requests without a live presenter are denied.
|
|
40
22
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
root session. Without a live presenter, blocked sandbox requests are denied.
|
|
44
|
-
|
|
45
|
-
Filesystem approvals may be stored in `.opencode/sandbox.json` for the project
|
|
46
|
-
or `~/.config/opencode/sandbox.json` globally. `/sandbox` displays or toggles the
|
|
47
|
-
policy. It updates the project file when that file defines `enabled`, otherwise
|
|
48
|
-
the global file.
|
|
23
|
+
`/sandbox` displays or toggles the policy. Persistent approvals update
|
|
24
|
+
`.opencode/sandbox.json` or `~/.config/opencode/sandbox.json`.
|
|
49
25
|
|
|
50
26
|
## Configuration
|
|
51
27
|
|
|
52
28
|
Policy merges in this order:
|
|
53
29
|
|
|
54
|
-
1. bundled
|
|
30
|
+
1. bundled `sandbox.json`;
|
|
55
31
|
2. `~/.config/opencode/sandbox.json`;
|
|
56
32
|
3. `.opencode/sandbox.json`;
|
|
57
33
|
4. plugin options.
|
|
58
34
|
|
|
59
35
|
Objects merge recursively, arrays combine, and later scalar values replace
|
|
60
|
-
earlier values. The
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
| `network.allowAllUnixSockets` | `false` |
|
|
74
|
-
| `network.allowUnixSockets` | `[]` |
|
|
75
|
-
| `network.allowedDomains` | `[]` |
|
|
76
|
-
| `network.deniedDomains` | `[]` |
|
|
77
|
-
|
|
78
|
-
Filesystem and core network semantics follow the main
|
|
79
|
-
[Landstrip policy](https://github.com/landstrip/landstrip#policy). `allowedDomains`
|
|
80
|
-
and `deniedDomains` are plugin-only fields enforced by its local HTTP/HTTPS proxy.
|
|
81
|
-
|
|
82
|
-
If `enabled` is true but the Landstrip binary, version, or platform is unusable,
|
|
83
|
-
AI Bash fails closed rather than running without isolation. Set `enabled` to
|
|
84
|
-
false explicitly to allow unsandboxed AI Bash.
|
|
85
|
-
|
|
86
|
-
## Limits
|
|
87
|
-
|
|
88
|
-
Only AI `bash` calls are process-sandboxed. Shell-mode commands entered directly
|
|
89
|
-
by the user cannot be replaced through OpenCode's plugin API. They may inherit
|
|
90
|
-
proxy settings and receive policy checks, but they do not have OS isolation.
|
|
91
|
-
|
|
92
|
-
See the main [Landstrip documentation](https://github.com/landstrip/landstrip#readme) for platform limits.
|
|
93
|
-
|
|
94
|
-
## License
|
|
95
|
-
|
|
96
|
-
`opencode-landstrip` is licensed under `Apache-2.0`. The bundled Landstrip
|
|
97
|
-
package is licensed separately as `Apache-2.0 AND LGPL-2.1-or-later`.
|
|
36
|
+
earlier values. The bundled policy denies sensitive files and network access
|
|
37
|
+
while allowing project writes. See [`sandbox.json`](sandbox.json) for its exact
|
|
38
|
+
defaults.
|
|
39
|
+
|
|
40
|
+
If sandboxing is enabled but the binary or platform is unusable, AI Bash fails
|
|
41
|
+
closed. Set `enabled` to `false` explicitly to allow unsandboxed AI Bash.
|
|
42
|
+
|
|
43
|
+
Only AI `bash` calls receive OS isolation; direct user shell commands cannot be
|
|
44
|
+
replaced through OpenCode's plugin API.
|
|
45
|
+
|
|
46
|
+
## Licensing
|
|
47
|
+
|
|
48
|
+
[Apache 2.0](../../LICENSE-APACHE-2.0).
|
package/index.ts
CHANGED
|
@@ -15,7 +15,7 @@ import {
|
|
|
15
15
|
isIP,
|
|
16
16
|
type Socket,
|
|
17
17
|
} from 'node:net';
|
|
18
|
-
import {
|
|
18
|
+
import { tmpdir } from 'node:os';
|
|
19
19
|
import { basename, dirname, isAbsolute, join, parse, resolve, sep } from 'node:path';
|
|
20
20
|
import { URL } from 'node:url';
|
|
21
21
|
|
|
@@ -23,8 +23,11 @@ import {
|
|
|
23
23
|
type LandstripTrap,
|
|
24
24
|
type SandboxConfig,
|
|
25
25
|
type SandboxFilesystemConfig,
|
|
26
|
+
allowsAllDomains,
|
|
26
27
|
controlResponseLine,
|
|
27
28
|
decodeLandstripTrap,
|
|
29
|
+
domainMatchesAny,
|
|
30
|
+
expandHomePath,
|
|
28
31
|
extractDomainsFromCommand,
|
|
29
32
|
formatLandstripTraps,
|
|
30
33
|
getConfigPaths,
|
|
@@ -104,7 +107,7 @@ for (const [network, prefix] of [
|
|
|
104
107
|
}
|
|
105
108
|
|
|
106
109
|
function expandPath(filePath: string, baseDirectory: string): string {
|
|
107
|
-
const expanded = filePath
|
|
110
|
+
const expanded = expandHomePath(filePath);
|
|
108
111
|
return resolve(isAbsolute(expanded) ? expanded : join(baseDirectory, expanded));
|
|
109
112
|
}
|
|
110
113
|
|
|
@@ -242,27 +245,6 @@ function resolveFilesystemConfig(
|
|
|
242
245
|
};
|
|
243
246
|
}
|
|
244
247
|
|
|
245
|
-
function domainMatchesPattern(domain: string, pattern: string): boolean {
|
|
246
|
-
const normalizedDomain = domain.toLowerCase();
|
|
247
|
-
const normalizedPattern = pattern.toLowerCase();
|
|
248
|
-
|
|
249
|
-
if (normalizedPattern === '*') return true;
|
|
250
|
-
if (normalizedPattern.startsWith('*.')) {
|
|
251
|
-
const base = normalizedPattern.slice(2);
|
|
252
|
-
return normalizedDomain === base || normalizedDomain.endsWith(`.${base}`);
|
|
253
|
-
}
|
|
254
|
-
|
|
255
|
-
return normalizedDomain === normalizedPattern;
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
function domainMatchesAny(domain: string, patterns: string[]): boolean {
|
|
259
|
-
return patterns.some((pattern) => domainMatchesPattern(domain, pattern));
|
|
260
|
-
}
|
|
261
|
-
|
|
262
|
-
function allowsAllDomains(allowedDomains: string[]): boolean {
|
|
263
|
-
return allowedDomains.includes('*');
|
|
264
|
-
}
|
|
265
|
-
|
|
266
248
|
function isDomainAllowed(domain: string, config: SandboxConfig): boolean {
|
|
267
249
|
return (
|
|
268
250
|
config.network.allowNetwork ||
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opencode-landstrip",
|
|
3
|
-
"version": "0.18.
|
|
3
|
+
"version": "0.18.35",
|
|
4
4
|
"description": "OS-level AI command sandboxing for OpenCode with Landstrip",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"landlock",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"ci:test": "npm test"
|
|
49
49
|
},
|
|
50
50
|
"dependencies": {
|
|
51
|
-
"@landstrip/landstrip": "^0.18.
|
|
51
|
+
"@landstrip/landstrip": "^0.18.35",
|
|
52
52
|
"@opentui/solid": ">=0.3.4",
|
|
53
53
|
"solid-js": "1.9.12"
|
|
54
54
|
},
|
package/shared.ts
CHANGED
|
@@ -7,6 +7,38 @@ import {
|
|
|
7
7
|
type LandstripTrap,
|
|
8
8
|
} from '@landstrip/landstrip';
|
|
9
9
|
|
|
10
|
+
import {
|
|
11
|
+
allowsAllDomains,
|
|
12
|
+
controlResponseLine,
|
|
13
|
+
decodeLandstripTrap,
|
|
14
|
+
domainMatchesAny,
|
|
15
|
+
domainMatchesPattern,
|
|
16
|
+
expandHomePath,
|
|
17
|
+
formatLandstripTrap,
|
|
18
|
+
formatLandstripTraps,
|
|
19
|
+
isRecord,
|
|
20
|
+
parseLandstripTraps,
|
|
21
|
+
pathUnderDirectory,
|
|
22
|
+
sessionAllows,
|
|
23
|
+
sessionScopeFor,
|
|
24
|
+
} from '@landstrip/landstrip/shared';
|
|
25
|
+
|
|
26
|
+
export {
|
|
27
|
+
allowsAllDomains,
|
|
28
|
+
controlResponseLine,
|
|
29
|
+
decodeLandstripTrap,
|
|
30
|
+
domainMatchesAny,
|
|
31
|
+
domainMatchesPattern,
|
|
32
|
+
expandHomePath,
|
|
33
|
+
formatLandstripTrap,
|
|
34
|
+
formatLandstripTraps,
|
|
35
|
+
isRecord,
|
|
36
|
+
parseLandstripTraps,
|
|
37
|
+
pathUnderDirectory,
|
|
38
|
+
sessionAllows,
|
|
39
|
+
sessionScopeFor,
|
|
40
|
+
};
|
|
41
|
+
|
|
10
42
|
// Re-exported so index.ts/tui.ts can import the trap/response types from this
|
|
11
43
|
// module alongside the parsing functions that produce/consume them.
|
|
12
44
|
export type { LandstripControlResponse, LandstripTrap };
|
|
@@ -15,7 +47,7 @@ import { createHash } from 'node:crypto';
|
|
|
15
47
|
import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
|
|
16
48
|
import { homedir, tmpdir } from 'node:os';
|
|
17
49
|
import { fileURLToPath } from 'node:url';
|
|
18
|
-
import { dirname,
|
|
50
|
+
import { dirname, join } from 'node:path';
|
|
19
51
|
|
|
20
52
|
export interface SandboxFilesystemConfig {
|
|
21
53
|
denyRead: string[];
|
|
@@ -57,62 +89,6 @@ const LANDSTRIP_PACKAGE_NAMES = new Set([
|
|
|
57
89
|
'@landstrip/landstrip-win32-arm64',
|
|
58
90
|
]);
|
|
59
91
|
|
|
60
|
-
// Breadth-first filesystem approval: a held read/write under a directory tree
|
|
61
|
-
// is approved for the broadest reasonable ancestor (e.g. `~/.cargo`, not each
|
|
62
|
-
// subcrate file), so a single approval covers sibling files under the same tree.
|
|
63
|
-
export function pathUnderDirectory(filePath: string, dir: string): boolean {
|
|
64
|
-
const child = relative(dir, filePath);
|
|
65
|
-
return child === '' || (!isAbsolute(child) && child !== '..' && !child.startsWith(`..${sep}`));
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
export function sessionAllows(prefixes: Set<string>, filePath: string): boolean {
|
|
69
|
-
for (const prefix of prefixes) {
|
|
70
|
-
if (pathUnderDirectory(filePath, prefix)) return true;
|
|
71
|
-
}
|
|
72
|
-
return false;
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
// The broadest ancestor worth approving in one click: the immediate child of
|
|
76
|
-
// `$HOME` (e.g. `~/.cargo`) for paths under the user's home, the project root
|
|
77
|
-
// for paths under it, otherwise the containing directory. When the file sits
|
|
78
|
-
// directly on a boundary (so the only ancestor is `$HOME` itself, which would
|
|
79
|
-
// over-broaden), fall back to the exact file so nothing widens silently.
|
|
80
|
-
export function sessionScopeFor(filePath: string, baseDirectory: string): string {
|
|
81
|
-
const dir = dirname(filePath);
|
|
82
|
-
const home = homedir();
|
|
83
|
-
const homeBoundaries = new Set<string>([home]);
|
|
84
|
-
try {
|
|
85
|
-
homeBoundaries.add(realpathSync.native(home));
|
|
86
|
-
} catch {
|
|
87
|
-
// $HOME not resolvable — fall back to the raw value only.
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
for (const boundary of homeBoundaries) {
|
|
91
|
-
if (pathUnderDirectory(dir, boundary)) {
|
|
92
|
-
const first = relative(boundary, dir).split(sep)[0];
|
|
93
|
-
if (!first) return filePath;
|
|
94
|
-
return join(boundary, first);
|
|
95
|
-
}
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
const projectBoundaries = new Set<string>([baseDirectory]);
|
|
99
|
-
try {
|
|
100
|
-
projectBoundaries.add(realpathSync.native(baseDirectory));
|
|
101
|
-
} catch {
|
|
102
|
-
// Project directory not resolvable — fall back to the raw value only.
|
|
103
|
-
}
|
|
104
|
-
|
|
105
|
-
for (const boundary of projectBoundaries) {
|
|
106
|
-
if (pathUnderDirectory(dir, boundary)) return boundary;
|
|
107
|
-
}
|
|
108
|
-
|
|
109
|
-
return dir;
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
export function isRecord(value: unknown): value is Record<string, unknown> {
|
|
113
|
-
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
114
|
-
}
|
|
115
|
-
|
|
116
92
|
export function list(values: string[]): string {
|
|
117
93
|
return values.join(', ') || '(none)';
|
|
118
94
|
}
|
|
@@ -404,112 +380,6 @@ export function updateForPermission(
|
|
|
404
380
|
return null;
|
|
405
381
|
}
|
|
406
382
|
|
|
407
|
-
// Landstrip emits one JSON trap per line on its trap fd/file. The `state` field
|
|
408
|
-
// distinguishes a terminal `info` trap from a `query` trap that holds a syscall
|
|
409
|
-
// pending until the host answers with the trap's `query_id`. Parsing lives here
|
|
410
|
-
// so the server hook and the TUI socket handler decode identically.
|
|
411
|
-
const LANDSTRIP_OPERATIONS = new Set<'read' | 'write'>(['read', 'write']);
|
|
412
|
-
|
|
413
|
-
function isLandstripOperation(value: unknown): value is 'read' | 'write' {
|
|
414
|
-
return typeof value === 'string' && LANDSTRIP_OPERATIONS.has(value as 'read' | 'write');
|
|
415
|
-
}
|
|
416
|
-
|
|
417
|
-
// The declarations landstrip ships are compile-time only, so a runtime guard is
|
|
418
|
-
// still required — but it only has to validate the fields actually read below.
|
|
419
|
-
// Deliberately does not validate `state`: a missing or unknown state degrades to
|
|
420
|
-
// "informational", the safe direction. `query_id` must be a string on both
|
|
421
|
-
// filesystem and network traps — landstrip < 0.17 sent a number here, and a
|
|
422
|
-
// numeric id fails landstrip's own deserializer when echoed back, so treating
|
|
423
|
-
// it as undecodable (rather than coercing it) keeps a stale/mismatched trap
|
|
424
|
-
// from ever being answered with a shape the broker would reject.
|
|
425
|
-
function isLandstripTrap(value: unknown): value is LandstripTrap {
|
|
426
|
-
if (!isRecord(value)) return false;
|
|
427
|
-
|
|
428
|
-
switch (value.kind) {
|
|
429
|
-
case 'filesystem':
|
|
430
|
-
return (
|
|
431
|
-
isLandstripOperation(value.operation) &&
|
|
432
|
-
typeof value.path === 'string' &&
|
|
433
|
-
typeof value.query_id === 'string'
|
|
434
|
-
);
|
|
435
|
-
case 'network':
|
|
436
|
-
return (
|
|
437
|
-
typeof value.operation === 'string' &&
|
|
438
|
-
typeof value.target === 'string' &&
|
|
439
|
-
typeof value.query_id === 'string'
|
|
440
|
-
);
|
|
441
|
-
case 'launch':
|
|
442
|
-
return typeof value.program === 'string' && typeof value.message === 'string';
|
|
443
|
-
case 'usage':
|
|
444
|
-
return typeof value.message === 'string';
|
|
445
|
-
case 'internal':
|
|
446
|
-
return typeof value.code === 'string' && typeof value.message === 'string';
|
|
447
|
-
default:
|
|
448
|
-
return false;
|
|
449
|
-
}
|
|
450
|
-
}
|
|
451
|
-
|
|
452
|
-
export function decodeLandstripTrap(value: unknown): LandstripTrap | null {
|
|
453
|
-
return isLandstripTrap(value) ? value : null;
|
|
454
|
-
}
|
|
455
|
-
|
|
456
|
-
export function parseLandstripTraps(output: string): LandstripTrap[] {
|
|
457
|
-
const traps: LandstripTrap[] = [];
|
|
458
|
-
|
|
459
|
-
for (const line of output.split('\n')) {
|
|
460
|
-
const trimmed = line.trim();
|
|
461
|
-
if (trimmed.length === 0 || trimmed[0] !== '{') continue;
|
|
462
|
-
|
|
463
|
-
let parsed: unknown;
|
|
464
|
-
try {
|
|
465
|
-
parsed = JSON.parse(trimmed);
|
|
466
|
-
} catch {
|
|
467
|
-
continue;
|
|
468
|
-
}
|
|
469
|
-
|
|
470
|
-
const trap = decodeLandstripTrap(parsed);
|
|
471
|
-
if (trap) traps.push(trap);
|
|
472
|
-
}
|
|
473
|
-
|
|
474
|
-
return traps;
|
|
475
|
-
}
|
|
476
|
-
|
|
477
|
-
export function formatLandstripTrap(trap: LandstripTrap): string {
|
|
478
|
-
switch (trap.kind) {
|
|
479
|
-
case 'filesystem':
|
|
480
|
-
return `landstrip: filesystem ${trap.operation} denied (${trap.path})${
|
|
481
|
-
trap.mechanism ? ` [${trap.mechanism}]` : ''
|
|
482
|
-
}`;
|
|
483
|
-
case 'network':
|
|
484
|
-
return `landstrip: network ${trap.operation} denied (${trap.target})${
|
|
485
|
-
trap.mechanism ? ` [${trap.mechanism}]` : ''
|
|
486
|
-
}`;
|
|
487
|
-
case 'launch':
|
|
488
|
-
return `landstrip: launch failed (${trap.program})${trap.message ? `: ${trap.message}` : ''}`;
|
|
489
|
-
case 'usage':
|
|
490
|
-
return `landstrip: usage error: ${trap.message}`;
|
|
491
|
-
case 'internal': {
|
|
492
|
-
const mechanism = trap.mechanism ? ` [${trap.mechanism}]` : '';
|
|
493
|
-
return `landstrip: ${trap.code}${mechanism}: ${trap.message}`;
|
|
494
|
-
}
|
|
495
|
-
}
|
|
496
|
-
}
|
|
497
|
-
|
|
498
|
-
export function formatLandstripTraps(traps: LandstripTrap[]): string {
|
|
499
|
-
return traps.map(formatLandstripTrap).join('\n');
|
|
500
|
-
}
|
|
501
|
-
|
|
502
|
-
// The broker matches an answer to its query by the exact decimal `query_id`
|
|
503
|
-
// string the trap carried. A numeric id fails its deserializer, the line is
|
|
504
|
-
// dropped, and the child's syscall stays suspended.
|
|
505
|
-
export function controlResponseLine(
|
|
506
|
-
queryId: string,
|
|
507
|
-
action: LandstripControlResponse['action'],
|
|
508
|
-
): string {
|
|
509
|
-
const response: LandstripControlResponse = { query_id: queryId, action };
|
|
510
|
-
return JSON.stringify(response) + '\n';
|
|
511
|
-
}
|
|
512
|
-
|
|
513
383
|
export interface TrapSessionHello {
|
|
514
384
|
kind: 'opencode-landstrip-session';
|
|
515
385
|
sessionID: string;
|
|
@@ -615,16 +485,25 @@ export function discoveryFilePath(baseDirectory: string): string {
|
|
|
615
485
|
// /sandbox toggles the persisted `enabled` flag. Write it where the setting
|
|
616
486
|
// already lives — the project config if it sets `enabled`, otherwise the global
|
|
617
487
|
// config — and return the scope written so the UI can report it.
|
|
488
|
+
export function sandboxConfigTarget(baseDirectory: string): {
|
|
489
|
+
scope: 'project' | 'global';
|
|
490
|
+
path: string;
|
|
491
|
+
} {
|
|
492
|
+
const { globalPath, projectPath } = getConfigPaths(baseDirectory);
|
|
493
|
+
const projectConfig = readConfigFile(projectPath);
|
|
494
|
+
const useProject = projectConfig !== null && projectConfig.enabled !== undefined;
|
|
495
|
+
return useProject
|
|
496
|
+
? { scope: 'project', path: projectPath }
|
|
497
|
+
: { scope: 'global', path: globalPath };
|
|
498
|
+
}
|
|
499
|
+
|
|
618
500
|
export function setSandboxConfigEnabled(
|
|
619
501
|
baseDirectory: string,
|
|
620
502
|
enabled: boolean,
|
|
621
503
|
): 'project' | 'global' {
|
|
622
|
-
const
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
const target = useProject ? projectPath : globalPath;
|
|
626
|
-
writeConfigFile(target, { enabled });
|
|
627
|
-
return useProject ? 'project' : 'global';
|
|
504
|
+
const target = sandboxConfigTarget(baseDirectory);
|
|
505
|
+
writeConfigFile(target.path, { enabled });
|
|
506
|
+
return target.scope;
|
|
628
507
|
}
|
|
629
508
|
|
|
630
509
|
export function writeDiscoveryPort(baseDirectory: string, port: number): void {
|
package/tui.ts
CHANGED
|
@@ -12,7 +12,7 @@ import type {
|
|
|
12
12
|
TuiSlotPlugin,
|
|
13
13
|
} from '@opencode-ai/plugin/tui';
|
|
14
14
|
import { RGBA } from '@opentui/core';
|
|
15
|
-
import { useTerminalDimensions } from '@opentui/solid';
|
|
15
|
+
import { Portal, useTerminalDimensions } from '@opentui/solid';
|
|
16
16
|
import { Fragment, jsx, jsxs } from '@opentui/solid/jsx-runtime';
|
|
17
17
|
import { createSignal, onCleanup, onMount } from 'solid-js';
|
|
18
18
|
|
|
@@ -27,7 +27,7 @@ import {
|
|
|
27
27
|
removeDiscoveryFile,
|
|
28
28
|
sessionAllows,
|
|
29
29
|
sessionAllowancesFor,
|
|
30
|
-
|
|
30
|
+
sandboxConfigTarget,
|
|
31
31
|
sessionScopeFor,
|
|
32
32
|
rootSessionIDFor,
|
|
33
33
|
setSandboxConfigEnabled,
|
|
@@ -118,16 +118,9 @@ function formatPath(input: string, base: string): string {
|
|
|
118
118
|
return absolute;
|
|
119
119
|
}
|
|
120
120
|
|
|
121
|
-
function selectedForeground(
|
|
122
|
-
const
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
if (theme.background.a === 0) {
|
|
126
|
-
const { r, g, b } = theme.warning;
|
|
127
|
-
const luminance = 0.299 * r + 0.587 * g + 0.114 * b;
|
|
128
|
-
return luminance > 0.5 ? RGBA.fromInts(0, 0, 0) : RGBA.fromInts(255, 255, 255);
|
|
129
|
-
}
|
|
130
|
-
return theme.background;
|
|
121
|
+
function selectedForeground(background: RGBA): RGBA {
|
|
122
|
+
const luminance = 0.2126 * background.r + 0.7152 * background.g + 0.0722 * background.b;
|
|
123
|
+
return luminance > 0.5 ? RGBA.fromInts(0, 0, 0) : RGBA.fromInts(255, 255, 255);
|
|
131
124
|
}
|
|
132
125
|
|
|
133
126
|
const tui: TuiPlugin = async (api, options, meta) => {
|
|
@@ -138,6 +131,7 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
138
131
|
const theme = api.theme.current;
|
|
139
132
|
const dimensions = useTerminalDimensions();
|
|
140
133
|
const [selected, setSelected] = createSignal(0);
|
|
134
|
+
const [expanded, setExpanded] = createSignal(false);
|
|
141
135
|
onMount(props.onShow);
|
|
142
136
|
|
|
143
137
|
function move(direction: number): void {
|
|
@@ -152,12 +146,18 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
152
146
|
const unregister = api.keymap.registerLayer({
|
|
153
147
|
priority: 1000,
|
|
154
148
|
bindings: [
|
|
155
|
-
{ key: 'left', cmd: () => move(-1) },
|
|
156
|
-
{ key: 'h', cmd: () => move(-1) },
|
|
157
|
-
{ key: 'right', cmd: () => move(1) },
|
|
158
|
-
{ key: 'l', cmd: () => move(1) },
|
|
159
|
-
{ key: 'return', cmd: submit },
|
|
160
|
-
{ key: 'escape', cmd: props.onCancel },
|
|
149
|
+
{ key: 'left', desc: 'Previous permission option', group: 'Sandbox', cmd: () => move(-1) },
|
|
150
|
+
{ key: 'h', desc: 'Previous permission option', group: 'Sandbox', cmd: () => move(-1) },
|
|
151
|
+
{ key: 'right', desc: 'Next permission option', group: 'Sandbox', cmd: () => move(1) },
|
|
152
|
+
{ key: 'l', desc: 'Next permission option', group: 'Sandbox', cmd: () => move(1) },
|
|
153
|
+
{ key: 'return', desc: 'Select permission option', group: 'Sandbox', cmd: submit },
|
|
154
|
+
{ key: 'escape', desc: 'Reject permission', group: 'Sandbox', cmd: props.onCancel },
|
|
155
|
+
{
|
|
156
|
+
key: 'ctrl+f',
|
|
157
|
+
desc: 'Toggle permission prompt fullscreen',
|
|
158
|
+
group: 'Sandbox',
|
|
159
|
+
cmd: () => setExpanded((value) => !value),
|
|
160
|
+
},
|
|
161
161
|
],
|
|
162
162
|
});
|
|
163
163
|
onCleanup(unregister);
|
|
@@ -177,13 +177,126 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
177
177
|
},
|
|
178
178
|
children: jsx('text', {
|
|
179
179
|
get fg() {
|
|
180
|
-
return selected() === index ? selectedForeground(theme) : theme.textMuted;
|
|
180
|
+
return selected() === index ? selectedForeground(theme.warning) : theme.textMuted;
|
|
181
181
|
},
|
|
182
182
|
children: option.label,
|
|
183
183
|
}),
|
|
184
184
|
}),
|
|
185
185
|
);
|
|
186
186
|
|
|
187
|
+
const children = [
|
|
188
|
+
jsxs('box', {
|
|
189
|
+
gap: 1,
|
|
190
|
+
paddingLeft: 1,
|
|
191
|
+
paddingRight: 3,
|
|
192
|
+
paddingTop: 1,
|
|
193
|
+
paddingBottom: 1,
|
|
194
|
+
flexGrow: 1,
|
|
195
|
+
children: [
|
|
196
|
+
jsxs('box', {
|
|
197
|
+
flexDirection: 'column',
|
|
198
|
+
gap: 0,
|
|
199
|
+
paddingLeft: 1,
|
|
200
|
+
flexShrink: 0,
|
|
201
|
+
children: [
|
|
202
|
+
jsxs('box', {
|
|
203
|
+
flexDirection: 'row',
|
|
204
|
+
gap: 1,
|
|
205
|
+
flexShrink: 0,
|
|
206
|
+
children: [
|
|
207
|
+
jsx('text', { fg: theme.warning, children: '△' }),
|
|
208
|
+
jsx('text', { fg: theme.text, children: 'Permission required' }),
|
|
209
|
+
],
|
|
210
|
+
}),
|
|
211
|
+
jsxs('box', {
|
|
212
|
+
flexDirection: 'row',
|
|
213
|
+
gap: 1,
|
|
214
|
+
paddingLeft: 2,
|
|
215
|
+
flexShrink: 0,
|
|
216
|
+
children: [
|
|
217
|
+
jsx('text', { fg: theme.textMuted, flexShrink: 0, children: props.icon }),
|
|
218
|
+
jsx('text', { fg: theme.text, wrapMode: 'word', children: props.title }),
|
|
219
|
+
],
|
|
220
|
+
}),
|
|
221
|
+
],
|
|
222
|
+
}),
|
|
223
|
+
],
|
|
224
|
+
}),
|
|
225
|
+
jsxs('box', {
|
|
226
|
+
get flexDirection() {
|
|
227
|
+
return dimensions().width < 80 ? 'column' : 'row';
|
|
228
|
+
},
|
|
229
|
+
flexShrink: 0,
|
|
230
|
+
gap: 1,
|
|
231
|
+
paddingTop: 1,
|
|
232
|
+
paddingLeft: 2,
|
|
233
|
+
paddingRight: 3,
|
|
234
|
+
paddingBottom: 1,
|
|
235
|
+
backgroundColor: theme.backgroundElement,
|
|
236
|
+
get justifyContent() {
|
|
237
|
+
return dimensions().width < 80 ? 'flex-start' : 'space-between';
|
|
238
|
+
},
|
|
239
|
+
get alignItems() {
|
|
240
|
+
return dimensions().width < 80 ? 'flex-start' : 'center';
|
|
241
|
+
},
|
|
242
|
+
children: [
|
|
243
|
+
jsx('box', {
|
|
244
|
+
flexDirection: 'row',
|
|
245
|
+
gap: 1,
|
|
246
|
+
flexShrink: 0,
|
|
247
|
+
children: optionButtons,
|
|
248
|
+
}),
|
|
249
|
+
jsxs('box', {
|
|
250
|
+
flexDirection: 'row',
|
|
251
|
+
gap: 2,
|
|
252
|
+
flexShrink: 0,
|
|
253
|
+
children: [
|
|
254
|
+
jsxs('text', {
|
|
255
|
+
fg: theme.text,
|
|
256
|
+
children: [
|
|
257
|
+
'ctrl+f ',
|
|
258
|
+
jsx('span', {
|
|
259
|
+
style: { fg: theme.textMuted },
|
|
260
|
+
children: expanded() ? 'minimize' : 'fullscreen',
|
|
261
|
+
}),
|
|
262
|
+
],
|
|
263
|
+
}),
|
|
264
|
+
jsxs('text', {
|
|
265
|
+
fg: theme.text,
|
|
266
|
+
children: [
|
|
267
|
+
'⇆ ',
|
|
268
|
+
jsx('span', { style: { fg: theme.textMuted }, children: 'select' }),
|
|
269
|
+
],
|
|
270
|
+
}),
|
|
271
|
+
jsxs('text', {
|
|
272
|
+
fg: theme.text,
|
|
273
|
+
children: [
|
|
274
|
+
'enter ',
|
|
275
|
+
jsx('span', { style: { fg: theme.textMuted }, children: 'confirm' }),
|
|
276
|
+
],
|
|
277
|
+
}),
|
|
278
|
+
],
|
|
279
|
+
}),
|
|
280
|
+
],
|
|
281
|
+
}),
|
|
282
|
+
];
|
|
283
|
+
|
|
284
|
+
if (expanded()) {
|
|
285
|
+
return Portal({
|
|
286
|
+
children: jsxs('box', {
|
|
287
|
+
top: dimensions().height * -1 + 1,
|
|
288
|
+
bottom: 1,
|
|
289
|
+
left: 2,
|
|
290
|
+
right: 2,
|
|
291
|
+
position: 'absolute',
|
|
292
|
+
border: ['left'],
|
|
293
|
+
borderColor: theme.warning,
|
|
294
|
+
customBorderChars: promptBorderChars,
|
|
295
|
+
backgroundColor: theme.backgroundPanel,
|
|
296
|
+
children,
|
|
297
|
+
}),
|
|
298
|
+
});
|
|
299
|
+
}
|
|
187
300
|
return jsxs('box', {
|
|
188
301
|
top: 0,
|
|
189
302
|
maxHeight: 15,
|
|
@@ -195,92 +308,7 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
195
308
|
borderColor: theme.warning,
|
|
196
309
|
customBorderChars: promptBorderChars,
|
|
197
310
|
backgroundColor: theme.backgroundPanel,
|
|
198
|
-
children
|
|
199
|
-
jsxs('box', {
|
|
200
|
-
gap: 1,
|
|
201
|
-
paddingLeft: 1,
|
|
202
|
-
paddingRight: 3,
|
|
203
|
-
paddingTop: 1,
|
|
204
|
-
paddingBottom: 1,
|
|
205
|
-
flexGrow: 1,
|
|
206
|
-
children: [
|
|
207
|
-
jsxs('box', {
|
|
208
|
-
flexDirection: 'column',
|
|
209
|
-
gap: 0,
|
|
210
|
-
paddingLeft: 1,
|
|
211
|
-
flexShrink: 0,
|
|
212
|
-
children: [
|
|
213
|
-
jsxs('box', {
|
|
214
|
-
flexDirection: 'row',
|
|
215
|
-
gap: 1,
|
|
216
|
-
flexShrink: 0,
|
|
217
|
-
children: [
|
|
218
|
-
jsx('text', { fg: theme.warning, children: '△' }),
|
|
219
|
-
jsx('text', { fg: theme.text, children: 'Permission required' }),
|
|
220
|
-
],
|
|
221
|
-
}),
|
|
222
|
-
jsxs('box', {
|
|
223
|
-
flexDirection: 'row',
|
|
224
|
-
gap: 1,
|
|
225
|
-
paddingLeft: 2,
|
|
226
|
-
flexShrink: 0,
|
|
227
|
-
children: [
|
|
228
|
-
jsx('text', { fg: theme.textMuted, flexShrink: 0, children: props.icon }),
|
|
229
|
-
jsx('text', { fg: theme.text, wrapMode: 'word', children: props.title }),
|
|
230
|
-
],
|
|
231
|
-
}),
|
|
232
|
-
],
|
|
233
|
-
}),
|
|
234
|
-
],
|
|
235
|
-
}),
|
|
236
|
-
jsxs('box', {
|
|
237
|
-
get flexDirection() {
|
|
238
|
-
return dimensions().width < 80 ? 'column' : 'row';
|
|
239
|
-
},
|
|
240
|
-
flexShrink: 0,
|
|
241
|
-
gap: 1,
|
|
242
|
-
paddingTop: 1,
|
|
243
|
-
paddingLeft: 2,
|
|
244
|
-
paddingRight: 3,
|
|
245
|
-
paddingBottom: 1,
|
|
246
|
-
backgroundColor: theme.backgroundElement,
|
|
247
|
-
get justifyContent() {
|
|
248
|
-
return dimensions().width < 80 ? 'flex-start' : 'space-between';
|
|
249
|
-
},
|
|
250
|
-
get alignItems() {
|
|
251
|
-
return dimensions().width < 80 ? 'flex-start' : 'center';
|
|
252
|
-
},
|
|
253
|
-
children: [
|
|
254
|
-
jsx('box', {
|
|
255
|
-
flexDirection: 'row',
|
|
256
|
-
gap: 1,
|
|
257
|
-
flexShrink: 0,
|
|
258
|
-
children: optionButtons,
|
|
259
|
-
}),
|
|
260
|
-
jsxs('box', {
|
|
261
|
-
flexDirection: 'row',
|
|
262
|
-
gap: 2,
|
|
263
|
-
flexShrink: 0,
|
|
264
|
-
children: [
|
|
265
|
-
jsxs('text', {
|
|
266
|
-
fg: theme.text,
|
|
267
|
-
children: [
|
|
268
|
-
'⇆ ',
|
|
269
|
-
jsx('span', { style: { fg: theme.textMuted }, children: 'select' }),
|
|
270
|
-
],
|
|
271
|
-
}),
|
|
272
|
-
jsxs('text', {
|
|
273
|
-
fg: theme.text,
|
|
274
|
-
children: [
|
|
275
|
-
'enter ',
|
|
276
|
-
jsx('span', { style: { fg: theme.textMuted }, children: 'confirm' }),
|
|
277
|
-
],
|
|
278
|
-
}),
|
|
279
|
-
],
|
|
280
|
-
}),
|
|
281
|
-
],
|
|
282
|
-
}),
|
|
283
|
-
],
|
|
311
|
+
children,
|
|
284
312
|
});
|
|
285
313
|
}
|
|
286
314
|
|
|
@@ -662,23 +690,25 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
662
690
|
refreshPermissionPresentation,
|
|
663
691
|
);
|
|
664
692
|
|
|
665
|
-
// /sandbox
|
|
666
|
-
//
|
|
667
|
-
//
|
|
693
|
+
// /sandbox toggles the persisted `enabled` flag. The server reads
|
|
694
|
+
// sandbox.json on every tool call, so the toggle takes effect on the next
|
|
695
|
+
// command without any cross-process signalling.
|
|
668
696
|
const showSandbox = () => {
|
|
669
697
|
const directory = api.state.path.directory || process.cwd();
|
|
670
698
|
const config = loadConfig(directory, optionOverrides);
|
|
671
|
-
const { globalPath, projectPath } = getConfigPaths(directory);
|
|
672
699
|
const next = !config.enabled;
|
|
673
|
-
const
|
|
674
|
-
|
|
675
|
-
|
|
700
|
+
const target = sandboxConfigTarget(directory);
|
|
701
|
+
const message = [
|
|
702
|
+
`Sandbox is ${config.enabled ? 'enabled' : 'disabled'}.`,
|
|
703
|
+
`Network: ${config.network.allowNetwork ? 'open' : 'proxied'}`,
|
|
704
|
+
`Change: ${target.scope} config at ${formatPath(target.path, directory)}`,
|
|
705
|
+
].join('\n');
|
|
676
706
|
|
|
677
707
|
// No `clear()` in onConfirm: the host pops the dialog itself, and its
|
|
678
708
|
// `clear()` re-invokes onClose, which would recurse and freeze the TUI.
|
|
679
709
|
api.ui.dialog.replace(() =>
|
|
680
710
|
api.ui.DialogConfirm({
|
|
681
|
-
title: '
|
|
711
|
+
title: next ? 'Enable sandbox?' : 'Disable sandbox?',
|
|
682
712
|
message,
|
|
683
713
|
onConfirm: () => {
|
|
684
714
|
const scope = setSandboxConfigEnabled(directory, next);
|
|
@@ -709,18 +739,6 @@ const tui: TuiPlugin = async (api, options, meta) => {
|
|
|
709
739
|
],
|
|
710
740
|
});
|
|
711
741
|
|
|
712
|
-
api.command?.register(() => [
|
|
713
|
-
{
|
|
714
|
-
title: 'Sandbox',
|
|
715
|
-
value: 'sandbox',
|
|
716
|
-
description: 'Inspect and toggle the sandbox',
|
|
717
|
-
category: 'Sandbox',
|
|
718
|
-
suggested: true,
|
|
719
|
-
slash: { name: 'sandbox' },
|
|
720
|
-
onSelect: showSandbox,
|
|
721
|
-
},
|
|
722
|
-
]);
|
|
723
|
-
|
|
724
742
|
// Persistent status badge in the prompt area.
|
|
725
743
|
try {
|
|
726
744
|
const [sandboxRevision, setSandboxRevision] = createSignal(0);
|
package/LICENSE
DELETED
|
@@ -1,201 +0,0 @@
|
|
|
1
|
-
Apache License
|
|
2
|
-
Version 2.0, January 2004
|
|
3
|
-
http://www.apache.org/licenses/
|
|
4
|
-
|
|
5
|
-
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
6
|
-
|
|
7
|
-
1. Definitions.
|
|
8
|
-
|
|
9
|
-
"License" shall mean the terms and conditions for use, reproduction,
|
|
10
|
-
and distribution as defined by Sections 1 through 9 of this document.
|
|
11
|
-
|
|
12
|
-
"Licensor" shall mean the copyright owner or entity authorized by
|
|
13
|
-
the copyright owner that is granting the License.
|
|
14
|
-
|
|
15
|
-
"Legal Entity" shall mean the union of the acting entity and all
|
|
16
|
-
other entities that control, are controlled by, or are under common
|
|
17
|
-
control with that entity. For the purposes of this definition,
|
|
18
|
-
"control" means (i) the power, direct or indirect, to cause the
|
|
19
|
-
direction or management of such entity, whether by contract or
|
|
20
|
-
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
21
|
-
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
22
|
-
|
|
23
|
-
"You" (or "Your") shall mean an individual or Legal Entity
|
|
24
|
-
exercising permissions granted by this License.
|
|
25
|
-
|
|
26
|
-
"Source" form shall mean the preferred form for making modifications,
|
|
27
|
-
including but not limited to software source code, documentation
|
|
28
|
-
source, and configuration files.
|
|
29
|
-
|
|
30
|
-
"Object" form shall mean any form resulting from mechanical
|
|
31
|
-
transformation or translation of a Source form, including but
|
|
32
|
-
not limited to compiled object code, generated documentation,
|
|
33
|
-
and conversions to other media types.
|
|
34
|
-
|
|
35
|
-
"Work" shall mean the work of authorship, whether in Source or
|
|
36
|
-
Object form, made available under the License, as indicated by a
|
|
37
|
-
copyright notice that is included in or attached to the work
|
|
38
|
-
(an example is provided in the Appendix below).
|
|
39
|
-
|
|
40
|
-
"Derivative Works" shall mean any work, whether in Source or Object
|
|
41
|
-
form, that is based on (or derived from) the Work and for which the
|
|
42
|
-
editorial revisions, annotations, elaborations, or other modifications
|
|
43
|
-
represent, as a whole, an original work of authorship. For the purposes
|
|
44
|
-
of this License, Derivative Works shall not include works that remain
|
|
45
|
-
separable from, or merely link (or bind by name) to the interfaces of,
|
|
46
|
-
the Work and Derivative Works thereof.
|
|
47
|
-
|
|
48
|
-
"Contribution" shall mean any work of authorship, including
|
|
49
|
-
the original version of the Work and any modifications or additions
|
|
50
|
-
to that Work or Derivative Works thereof, that is intentionally
|
|
51
|
-
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
52
|
-
or by an individual or Legal Entity authorized to submit on behalf of
|
|
53
|
-
the copyright owner. For the purposes of this definition, "submitted"
|
|
54
|
-
means any form of electronic, verbal, or written communication sent
|
|
55
|
-
to the Licensor or its representatives, including but not limited to
|
|
56
|
-
communication on electronic mailing lists, source code control systems,
|
|
57
|
-
and issue tracking systems that are managed by, or on behalf of, the
|
|
58
|
-
Licensor for the purpose of discussing and improving the Work, but
|
|
59
|
-
excluding communication that is conspicuously marked or otherwise
|
|
60
|
-
designated in writing by the copyright owner as "Not a Contribution."
|
|
61
|
-
|
|
62
|
-
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
63
|
-
on behalf of whom a Contribution has been received by Licensor and
|
|
64
|
-
subsequently incorporated within the Work.
|
|
65
|
-
|
|
66
|
-
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
67
|
-
this License, each Contributor hereby grants to You a perpetual,
|
|
68
|
-
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
69
|
-
copyright license to reproduce, prepare Derivative Works of,
|
|
70
|
-
publicly display, publicly perform, sublicense, and distribute the
|
|
71
|
-
Work and such Derivative Works in Source or Object form.
|
|
72
|
-
|
|
73
|
-
3. Grant of Patent License. Subject to the terms and conditions of
|
|
74
|
-
this License, each Contributor hereby grants to You a perpetual,
|
|
75
|
-
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
76
|
-
(except as stated in this section) patent license to make, have made,
|
|
77
|
-
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
78
|
-
where such license applies only to those patent claims licensable
|
|
79
|
-
by such Contributor that are necessarily infringed by their
|
|
80
|
-
Contribution(s) alone or by combination of their Contribution(s)
|
|
81
|
-
with the Work to which such Contribution(s) was submitted. If You
|
|
82
|
-
institute patent litigation against any entity (including a
|
|
83
|
-
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
84
|
-
or a Contribution incorporated within the Work constitutes direct
|
|
85
|
-
or contributory patent infringement, then any patent licenses
|
|
86
|
-
granted to You under this License for that Work shall terminate
|
|
87
|
-
as of the date such litigation is filed.
|
|
88
|
-
|
|
89
|
-
4. Redistribution. You may reproduce and distribute copies of the
|
|
90
|
-
Work or Derivative Works thereof in any medium, with or without
|
|
91
|
-
modifications, and in Source or Object form, provided that You
|
|
92
|
-
meet the following conditions:
|
|
93
|
-
|
|
94
|
-
(a) You must give any other recipients of the Work or
|
|
95
|
-
Derivative Works a copy of this License; and
|
|
96
|
-
|
|
97
|
-
(b) You must cause any modified files to carry prominent notices
|
|
98
|
-
stating that You changed the files; and
|
|
99
|
-
|
|
100
|
-
(c) You must retain, in the Source form of any Derivative Works
|
|
101
|
-
that You distribute, all copyright, patent, trademark, and
|
|
102
|
-
attribution notices from the Source form of the Work,
|
|
103
|
-
excluding those notices that do not pertain to any part of
|
|
104
|
-
the Derivative Works; and
|
|
105
|
-
|
|
106
|
-
(d) If the Work includes a "NOTICE" text file as part of its
|
|
107
|
-
distribution, then any Derivative Works that You distribute must
|
|
108
|
-
include a readable copy of the attribution notices contained
|
|
109
|
-
within such NOTICE file, excluding those notices that do not
|
|
110
|
-
pertain to any part of the Derivative Works, in at least one
|
|
111
|
-
of the following places: within a NOTICE text file distributed
|
|
112
|
-
as part of the Derivative Works; within the Source form or
|
|
113
|
-
documentation, if provided along with the Derivative Works; or,
|
|
114
|
-
within a display generated by the Derivative Works, if and
|
|
115
|
-
wherever such third-party notices normally appear. The contents
|
|
116
|
-
of the NOTICE file are for informational purposes only and
|
|
117
|
-
do not modify the License. You may add Your own attribution
|
|
118
|
-
notices within Derivative Works that You distribute, alongside
|
|
119
|
-
or as an addendum to the NOTICE text from the Work, provided
|
|
120
|
-
that such additional attribution notices cannot be construed
|
|
121
|
-
as modifying the License.
|
|
122
|
-
|
|
123
|
-
You may add Your own copyright statement to Your modifications and
|
|
124
|
-
may provide additional or different license terms and conditions
|
|
125
|
-
for use, reproduction, or distribution of Your modifications, or
|
|
126
|
-
for any such Derivative Works as a whole, provided Your use,
|
|
127
|
-
reproduction, and distribution of the Work otherwise complies with
|
|
128
|
-
the conditions stated in this License.
|
|
129
|
-
|
|
130
|
-
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
131
|
-
any Contribution intentionally submitted for inclusion in the Work
|
|
132
|
-
by You to the Licensor shall be under the terms and conditions of
|
|
133
|
-
this License, without any additional terms or conditions.
|
|
134
|
-
Notwithstanding the above, nothing herein shall supersede or modify
|
|
135
|
-
the terms of any separate license agreement you may have executed
|
|
136
|
-
with Licensor regarding such Contributions.
|
|
137
|
-
|
|
138
|
-
6. Trademarks. This License does not grant permission to use the trade
|
|
139
|
-
names, trademarks, service marks, or product names of the Licensor,
|
|
140
|
-
except as required for reasonable and customary use in describing the
|
|
141
|
-
origin of the Work and reproducing the content of the NOTICE file.
|
|
142
|
-
|
|
143
|
-
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
144
|
-
agreed to in writing, Licensor provides the Work (and each
|
|
145
|
-
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
146
|
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
147
|
-
implied, including, without limitation, any warranties or conditions
|
|
148
|
-
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
149
|
-
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
150
|
-
appropriateness of using or redistributing the Work and assume any
|
|
151
|
-
risks associated with Your exercise of permissions under this License.
|
|
152
|
-
|
|
153
|
-
8. Limitation of Liability. In no event and under no legal theory,
|
|
154
|
-
whether in tort (including negligence), contract, or otherwise,
|
|
155
|
-
unless required by applicable law (such as deliberate and grossly
|
|
156
|
-
negligent acts) or agreed to in writing, shall any Contributor be
|
|
157
|
-
liable to You for damages, including any direct, indirect, special,
|
|
158
|
-
incidental, or consequential damages of any character arising as a
|
|
159
|
-
result of this License or out of the use or inability to use the
|
|
160
|
-
Work (including but not limited to damages for loss of goodwill,
|
|
161
|
-
work stoppage, computer failure or malfunction, or any and all
|
|
162
|
-
other commercial damages or losses), even if such Contributor
|
|
163
|
-
has been advised of the possibility of such damages.
|
|
164
|
-
|
|
165
|
-
9. Accepting Warranty or Additional Liability. While redistributing
|
|
166
|
-
the Work or Derivative Works thereof, You may choose to offer,
|
|
167
|
-
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
168
|
-
or other liability obligations and/or rights consistent with this
|
|
169
|
-
License. However, in accepting such obligations, You may act only
|
|
170
|
-
on Your own behalf and on Your sole responsibility, not on behalf
|
|
171
|
-
of any other Contributor, and only if You agree to indemnify,
|
|
172
|
-
defend, and hold each Contributor harmless for any liability
|
|
173
|
-
incurred by, or claims asserted against, such Contributor by reason
|
|
174
|
-
of your accepting any such warranty or additional liability.
|
|
175
|
-
|
|
176
|
-
END OF TERMS AND CONDITIONS
|
|
177
|
-
|
|
178
|
-
APPENDIX: How to apply the Apache License to your work.
|
|
179
|
-
|
|
180
|
-
To apply the Apache License to your work, attach the following
|
|
181
|
-
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
182
|
-
replaced with your own identifying information. (Don't include
|
|
183
|
-
the brackets!) The text should be enclosed in the appropriate
|
|
184
|
-
comment syntax for the file format. We also recommend that a
|
|
185
|
-
file or class name and description of purpose be included on the
|
|
186
|
-
same "printed page" as the copyright notice for easier
|
|
187
|
-
identification within third-party archives.
|
|
188
|
-
|
|
189
|
-
Copyright [yyyy] [name of copyright owner]
|
|
190
|
-
|
|
191
|
-
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
|
-
you may not use this file except in compliance with the License.
|
|
193
|
-
You may obtain a copy of the License at
|
|
194
|
-
|
|
195
|
-
http://www.apache.org/licenses/LICENSE-2.0
|
|
196
|
-
|
|
197
|
-
Unless required by applicable law or agreed to in writing, software
|
|
198
|
-
distributed under the License is distributed on an "AS IS" BASIS,
|
|
199
|
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
200
|
-
See the License for the specific language governing permissions and
|
|
201
|
-
limitations under the License.
|