keycode-ai 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +101 -0
- package/LICENSE +201 -0
- package/README.md +547 -2
- package/dist/app/agent.d.ts +126 -0
- package/dist/app/agent.js +613 -0
- package/dist/app/agent.js.map +1 -0
- package/dist/app/commands.d.ts +15 -0
- package/dist/app/commands.js +281 -0
- package/dist/app/commands.js.map +1 -0
- package/dist/app/compact.d.ts +23 -0
- package/dist/app/compact.js +75 -0
- package/dist/app/compact.js.map +1 -0
- package/dist/app/export.d.ts +6 -0
- package/dist/app/export.js +56 -0
- package/dist/app/export.js.map +1 -0
- package/dist/app/factory.d.ts +106 -0
- package/dist/app/factory.js +687 -0
- package/dist/app/factory.js.map +1 -0
- package/dist/app/onboarding.d.ts +6 -0
- package/dist/app/onboarding.js +33 -0
- package/dist/app/onboarding.js.map +1 -0
- package/dist/app/subagent.d.ts +16 -0
- package/dist/app/subagent.js +14 -0
- package/dist/app/subagent.js.map +1 -0
- package/dist/app/trust.d.ts +6 -0
- package/dist/app/trust.js +74 -0
- package/dist/app/trust.js.map +1 -0
- package/dist/app/trustManifest.d.ts +18 -0
- package/dist/app/trustManifest.js +171 -0
- package/dist/app/trustManifest.js.map +1 -0
- package/dist/artifacts/store.d.ts +43 -0
- package/dist/artifacts/store.js +159 -0
- package/dist/artifacts/store.js.map +1 -0
- package/dist/cli/auth.d.ts +7 -0
- package/dist/cli/auth.js +68 -0
- package/dist/cli/auth.js.map +1 -0
- package/dist/cli/doctor.d.ts +19 -0
- package/dist/cli/doctor.js +205 -0
- package/dist/cli/doctor.js.map +1 -0
- package/dist/cli/extra.d.ts +2 -0
- package/dist/cli/extra.js +990 -0
- package/dist/cli/extra.js.map +1 -0
- package/dist/cli/headless.d.ts +20 -0
- package/dist/cli/headless.js +224 -0
- package/dist/cli/headless.js.map +1 -0
- package/dist/cli/index.d.ts +4 -0
- package/dist/cli/index.js +284 -0
- package/dist/cli/index.js.map +1 -0
- package/dist/contracts/message.d.ts +34 -0
- package/dist/contracts/message.js +10 -0
- package/dist/contracts/message.js.map +1 -0
- package/dist/contracts/permissions.d.ts +16 -0
- package/dist/contracts/permissions.js +9 -0
- package/dist/contracts/permissions.js.map +1 -0
- package/dist/contracts/provider.d.ts +65 -0
- package/dist/contracts/provider.js +2 -0
- package/dist/contracts/provider.js.map +1 -0
- package/dist/contracts/session.d.ts +101 -0
- package/dist/contracts/session.js +11 -0
- package/dist/contracts/session.js.map +1 -0
- package/dist/contracts/tool.d.ts +81 -0
- package/dist/contracts/tool.js +15 -0
- package/dist/contracts/tool.js.map +1 -0
- package/dist/core/budget.d.ts +11 -0
- package/dist/core/budget.js +22 -0
- package/dist/core/budget.js.map +1 -0
- package/dist/core/context.d.ts +27 -0
- package/dist/core/context.js +92 -0
- package/dist/core/context.js.map +1 -0
- package/dist/extensions/commands.d.ts +23 -0
- package/dist/extensions/commands.js +103 -0
- package/dist/extensions/commands.js.map +1 -0
- package/dist/extensions/customAgents.d.ts +19 -0
- package/dist/extensions/customAgents.js +85 -0
- package/dist/extensions/customAgents.js.map +1 -0
- package/dist/extensions/frontmatter.d.ts +6 -0
- package/dist/extensions/frontmatter.js +73 -0
- package/dist/extensions/frontmatter.js.map +1 -0
- package/dist/extensions/hooks.d.ts +63 -0
- package/dist/extensions/hooks.js +145 -0
- package/dist/extensions/hooks.js.map +1 -0
- package/dist/extensions/loops.d.ts +27 -0
- package/dist/extensions/loops.js +119 -0
- package/dist/extensions/loops.js.map +1 -0
- package/dist/extensions/plugins.d.ts +29 -0
- package/dist/extensions/plugins.js +119 -0
- package/dist/extensions/plugins.js.map +1 -0
- package/dist/extensions/skills.d.ts +21 -0
- package/dist/extensions/skills.js +89 -0
- package/dist/extensions/skills.js.map +1 -0
- package/dist/extensions/statusline.d.ts +13 -0
- package/dist/extensions/statusline.js +30 -0
- package/dist/extensions/statusline.js.map +1 -0
- package/dist/extensions/styles.d.ts +14 -0
- package/dist/extensions/styles.js +79 -0
- package/dist/extensions/styles.js.map +1 -0
- package/dist/extensions/teams.d.ts +44 -0
- package/dist/extensions/teams.js +79 -0
- package/dist/extensions/teams.js.map +1 -0
- package/dist/extensions/themes.d.ts +25 -0
- package/dist/extensions/themes.js +109 -0
- package/dist/extensions/themes.js.map +1 -0
- package/dist/extensions/workflows.d.ts +28 -0
- package/dist/extensions/workflows.js +65 -0
- package/dist/extensions/workflows.js.map +1 -0
- package/dist/gateway/index.d.ts +25 -0
- package/dist/gateway/index.js +125 -0
- package/dist/gateway/index.js.map +1 -0
- package/dist/integrations/background.d.ts +35 -0
- package/dist/integrations/background.js +167 -0
- package/dist/integrations/background.js.map +1 -0
- package/dist/integrations/browser.d.ts +36 -0
- package/dist/integrations/browser.js +80 -0
- package/dist/integrations/browser.js.map +1 -0
- package/dist/integrations/github.d.ts +44 -0
- package/dist/integrations/github.js +72 -0
- package/dist/integrations/github.js.map +1 -0
- package/dist/integrations/ide.d.ts +29 -0
- package/dist/integrations/ide.js +69 -0
- package/dist/integrations/ide.js.map +1 -0
- package/dist/integrations/import.d.ts +14 -0
- package/dist/integrations/import.js +76 -0
- package/dist/integrations/import.js.map +1 -0
- package/dist/integrations/playwrightDriver.d.ts +8 -0
- package/dist/integrations/playwrightDriver.js +70 -0
- package/dist/integrations/playwrightDriver.js.map +1 -0
- package/dist/integrations/pr.d.ts +23 -0
- package/dist/integrations/pr.js +81 -0
- package/dist/integrations/pr.js.map +1 -0
- package/dist/integrations/remote.d.ts +107 -0
- package/dist/integrations/remote.js +636 -0
- package/dist/integrations/remote.js.map +1 -0
- package/dist/integrations/runner.d.ts +30 -0
- package/dist/integrations/runner.js +56 -0
- package/dist/integrations/runner.js.map +1 -0
- package/dist/integrations/worktrees.d.ts +17 -0
- package/dist/integrations/worktrees.js +40 -0
- package/dist/integrations/worktrees.js.map +1 -0
- package/dist/integrations/ws.d.ts +9 -0
- package/dist/integrations/ws.js +102 -0
- package/dist/integrations/ws.js.map +1 -0
- package/dist/lsp/client.d.ts +51 -0
- package/dist/lsp/client.js +251 -0
- package/dist/lsp/client.js.map +1 -0
- package/dist/mcp/client.d.ts +56 -0
- package/dist/mcp/client.js +153 -0
- package/dist/mcp/client.js.map +1 -0
- package/dist/mcp/management.d.ts +20 -0
- package/dist/mcp/management.js +97 -0
- package/dist/mcp/management.js.map +1 -0
- package/dist/mcp/tools.d.ts +3 -0
- package/dist/mcp/tools.js +26 -0
- package/dist/mcp/tools.js.map +1 -0
- package/dist/notifications/index.d.ts +25 -0
- package/dist/notifications/index.js +63 -0
- package/dist/notifications/index.js.map +1 -0
- package/dist/permissions/audit.d.ts +25 -0
- package/dist/permissions/audit.js +58 -0
- package/dist/permissions/audit.js.map +1 -0
- package/dist/permissions/broker.d.ts +20 -0
- package/dist/permissions/broker.js +51 -0
- package/dist/permissions/broker.js.map +1 -0
- package/dist/permissions/dangerous.d.ts +7 -0
- package/dist/permissions/dangerous.js +42 -0
- package/dist/permissions/dangerous.js.map +1 -0
- package/dist/permissions/pipeline.d.ts +34 -0
- package/dist/permissions/pipeline.js +217 -0
- package/dist/permissions/pipeline.js.map +1 -0
- package/dist/permissions/prompt.d.ts +2 -0
- package/dist/permissions/prompt.js +33 -0
- package/dist/permissions/prompt.js.map +1 -0
- package/dist/permissions/rules.d.ts +7 -0
- package/dist/permissions/rules.js +176 -0
- package/dist/permissions/rules.js.map +1 -0
- package/dist/platform/index.d.ts +16 -0
- package/dist/platform/index.js +55 -0
- package/dist/platform/index.js.map +1 -0
- package/dist/privacy/index.d.ts +27 -0
- package/dist/privacy/index.js +98 -0
- package/dist/privacy/index.js.map +1 -0
- package/dist/providers/anthropic.d.ts +25 -0
- package/dist/providers/anthropic.js +225 -0
- package/dist/providers/anthropic.js.map +1 -0
- package/dist/providers/budget.d.ts +24 -0
- package/dist/providers/budget.js +47 -0
- package/dist/providers/budget.js.map +1 -0
- package/dist/providers/capabilities.d.ts +9 -0
- package/dist/providers/capabilities.js +39 -0
- package/dist/providers/capabilities.js.map +1 -0
- package/dist/providers/credentials.d.ts +21 -0
- package/dist/providers/credentials.js +86 -0
- package/dist/providers/credentials.js.map +1 -0
- package/dist/providers/fake.d.ts +32 -0
- package/dist/providers/fake.js +95 -0
- package/dist/providers/fake.js.map +1 -0
- package/dist/providers/openai.d.ts +27 -0
- package/dist/providers/openai.js +243 -0
- package/dist/providers/openai.js.map +1 -0
- package/dist/providers/presets.d.ts +20 -0
- package/dist/providers/presets.js +166 -0
- package/dist/providers/presets.js.map +1 -0
- package/dist/providers/registry.d.ts +27 -0
- package/dist/providers/registry.js +127 -0
- package/dist/providers/registry.js.map +1 -0
- package/dist/providers/retry.d.ts +22 -0
- package/dist/providers/retry.js +69 -0
- package/dist/providers/retry.js.map +1 -0
- package/dist/providers/sse.d.ts +5 -0
- package/dist/providers/sse.js +74 -0
- package/dist/providers/sse.js.map +1 -0
- package/dist/providers/textProtocol.d.ts +10 -0
- package/dist/providers/textProtocol.js +45 -0
- package/dist/providers/textProtocol.js.map +1 -0
- package/dist/questions/broker.d.ts +16 -0
- package/dist/questions/broker.js +40 -0
- package/dist/questions/broker.js.map +1 -0
- package/dist/sandbox/command.d.ts +20 -0
- package/dist/sandbox/command.js +307 -0
- package/dist/sandbox/command.js.map +1 -0
- package/dist/sandbox/index.d.ts +21 -0
- package/dist/sandbox/index.js +32 -0
- package/dist/sandbox/index.js.map +1 -0
- package/dist/sdk/index.d.ts +14 -0
- package/dist/sdk/index.js +57 -0
- package/dist/sdk/index.js.map +1 -0
- package/dist/sdk/structured.d.ts +7 -0
- package/dist/sdk/structured.js +66 -0
- package/dist/sdk/structured.js.map +1 -0
- package/dist/storage/autoMemory.d.ts +22 -0
- package/dist/storage/autoMemory.js +93 -0
- package/dist/storage/autoMemory.js.map +1 -0
- package/dist/storage/checkpoints.d.ts +15 -0
- package/dist/storage/checkpoints.js +86 -0
- package/dist/storage/checkpoints.js.map +1 -0
- package/dist/storage/memory.d.ts +21 -0
- package/dist/storage/memory.js +137 -0
- package/dist/storage/memory.js.map +1 -0
- package/dist/storage/schema.d.ts +177 -0
- package/dist/storage/schema.js +120 -0
- package/dist/storage/schema.js.map +1 -0
- package/dist/storage/session.d.ts +56 -0
- package/dist/storage/session.js +305 -0
- package/dist/storage/session.js.map +1 -0
- package/dist/storage/settings.d.ts +17 -0
- package/dist/storage/settings.js +146 -0
- package/dist/storage/settings.js.map +1 -0
- package/dist/telemetry/otel.d.ts +21 -0
- package/dist/telemetry/otel.js +71 -0
- package/dist/telemetry/otel.js.map +1 -0
- package/dist/tools/agent.d.ts +13 -0
- package/dist/tools/agent.js +45 -0
- package/dist/tools/agent.js.map +1 -0
- package/dist/tools/artifact.d.ts +31 -0
- package/dist/tools/artifact.js +137 -0
- package/dist/tools/artifact.js.map +1 -0
- package/dist/tools/bash.d.ts +29 -0
- package/dist/tools/bash.js +191 -0
- package/dist/tools/bash.js.map +1 -0
- package/dist/tools/codemode.d.ts +13 -0
- package/dist/tools/codemode.js +77 -0
- package/dist/tools/codemode.js.map +1 -0
- package/dist/tools/edit.d.ts +11 -0
- package/dist/tools/edit.js +128 -0
- package/dist/tools/edit.js.map +1 -0
- package/dist/tools/glob.d.ts +10 -0
- package/dist/tools/glob.js +33 -0
- package/dist/tools/glob.js.map +1 -0
- package/dist/tools/grep.d.ts +20 -0
- package/dist/tools/grep.js +143 -0
- package/dist/tools/grep.js.map +1 -0
- package/dist/tools/index.d.ts +11 -0
- package/dist/tools/index.js +47 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/lsp.d.ts +30 -0
- package/dist/tools/lsp.js +206 -0
- package/dist/tools/lsp.js.map +1 -0
- package/dist/tools/notebook.d.ts +19 -0
- package/dist/tools/notebook.js +83 -0
- package/dist/tools/notebook.js.map +1 -0
- package/dist/tools/powershell.d.ts +10 -0
- package/dist/tools/powershell.js +83 -0
- package/dist/tools/powershell.js.map +1 -0
- package/dist/tools/question.d.ts +15 -0
- package/dist/tools/question.js +50 -0
- package/dist/tools/question.js.map +1 -0
- package/dist/tools/read.d.ts +10 -0
- package/dist/tools/read.js +188 -0
- package/dist/tools/read.js.map +1 -0
- package/dist/tools/shared.d.ts +8 -0
- package/dist/tools/shared.js +35 -0
- package/dist/tools/shared.js.map +1 -0
- package/dist/tools/skill.d.ts +9 -0
- package/dist/tools/skill.js +38 -0
- package/dist/tools/skill.js.map +1 -0
- package/dist/tools/tasks.d.ts +35 -0
- package/dist/tools/tasks.js +139 -0
- package/dist/tools/tasks.js.map +1 -0
- package/dist/tools/todo.d.ts +27 -0
- package/dist/tools/todo.js +40 -0
- package/dist/tools/todo.js.map +1 -0
- package/dist/tools/walk.d.ts +15 -0
- package/dist/tools/walk.js +144 -0
- package/dist/tools/walk.js.map +1 -0
- package/dist/tools/webfetch.d.ts +22 -0
- package/dist/tools/webfetch.js +201 -0
- package/dist/tools/webfetch.js.map +1 -0
- package/dist/tools/websearch.d.ts +33 -0
- package/dist/tools/websearch.js +129 -0
- package/dist/tools/websearch.js.map +1 -0
- package/dist/tools/write.d.ts +8 -0
- package/dist/tools/write.js +51 -0
- package/dist/tools/write.js.map +1 -0
- package/dist/tui/accessibility.d.ts +4 -0
- package/dist/tui/accessibility.js +24 -0
- package/dist/tui/accessibility.js.map +1 -0
- package/dist/tui/app.d.ts +21 -0
- package/dist/tui/app.js +280 -0
- package/dist/tui/app.js.map +1 -0
- package/dist/tui/format.d.ts +22 -0
- package/dist/tui/format.js +91 -0
- package/dist/tui/format.js.map +1 -0
- package/dist/tui/input.d.ts +9 -0
- package/dist/tui/input.js +71 -0
- package/dist/tui/input.js.map +1 -0
- package/dist/tui/permission.d.ts +2 -0
- package/dist/tui/permission.js +2 -0
- package/dist/tui/permission.js.map +1 -0
- package/dist/updates/index.d.ts +33 -0
- package/dist/updates/index.js +60 -0
- package/dist/updates/index.js.map +1 -0
- package/dist/util/clipboard.d.ts +1 -0
- package/dist/util/clipboard.js +30 -0
- package/dist/util/clipboard.js.map +1 -0
- package/dist/util/clock.d.ts +7 -0
- package/dist/util/clock.js +6 -0
- package/dist/util/clock.js.map +1 -0
- package/dist/util/errors.d.ts +19 -0
- package/dist/util/errors.js +64 -0
- package/dist/util/errors.js.map +1 -0
- package/dist/util/fsx.d.ts +4 -0
- package/dist/util/fsx.js +35 -0
- package/dist/util/fsx.js.map +1 -0
- package/dist/util/ids.d.ts +5 -0
- package/dist/util/ids.js +17 -0
- package/dist/util/ids.js.map +1 -0
- package/dist/util/logger.d.ts +13 -0
- package/dist/util/logger.js +23 -0
- package/dist/util/logger.js.map +1 -0
- package/dist/util/paths.d.ts +14 -0
- package/dist/util/paths.js +77 -0
- package/dist/util/paths.js.map +1 -0
- package/dist/util/redact.d.ts +6 -0
- package/dist/util/redact.js +44 -0
- package/dist/util/redact.js.map +1 -0
- package/dist/util/text.d.ts +4 -0
- package/dist/util/text.js +23 -0
- package/dist/util/text.js.map +1 -0
- package/dist/version.d.ts +1 -0
- package/dist/version.js +2 -0
- package/dist/version.js.map +1 -0
- package/dist/web/public/app.js +917 -0
- package/dist/web/public/favicon.svg +5 -0
- package/dist/web/public/index.html +197 -0
- package/dist/web/public/markdown.js +176 -0
- package/dist/web/public/styles.css +1245 -0
- package/package.json +55 -4
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { SandboxDecision, SandboxPolicy } from "./index.js";
|
|
2
|
+
interface SandboxCommandResult extends SandboxDecision {
|
|
3
|
+
reason?: string | undefined;
|
|
4
|
+
}
|
|
5
|
+
export declare function checkCommand(policy: SandboxPolicy, command: string, cwd: string): SandboxCommandResult;
|
|
6
|
+
export declare function seatbeltProfile(policy: SandboxPolicy): string;
|
|
7
|
+
export declare function bwrapArgs(policy: SandboxPolicy, command: string, cwd: string): string[];
|
|
8
|
+
export interface SandboxWrapper {
|
|
9
|
+
kind: "seatbelt" | "bwrap";
|
|
10
|
+
command: string;
|
|
11
|
+
args: string[];
|
|
12
|
+
}
|
|
13
|
+
export declare function detectWrapper(platform?: NodeJS.Platform, exists?: (path: string) => boolean): SandboxWrapper | null;
|
|
14
|
+
export declare function sandboxSpawn(policy: SandboxPolicy, command: string, cwd: string, platform?: NodeJS.Platform): {
|
|
15
|
+
command: string;
|
|
16
|
+
args: string[];
|
|
17
|
+
shell: boolean;
|
|
18
|
+
wrapper: SandboxWrapper | null;
|
|
19
|
+
};
|
|
20
|
+
export {};
|
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
import { existsSync, realpathSync } from "node:fs";
|
|
2
|
+
import { tmpdir } from "node:os";
|
|
3
|
+
import { isAbsolute, resolve } from "node:path";
|
|
4
|
+
import { checkNetwork, checkWrite } from "./index.js";
|
|
5
|
+
const NETWORK_PATTERNS = [
|
|
6
|
+
/^(?:sudo\s+)?(?:curl|wget|ssh|scp|sftp|ftp|telnet|nc|netcat|ping|nslookup|dig|host)\b/,
|
|
7
|
+
/^(?:Invoke-WebRequest|Invoke-RestMethod|Start-BitsTransfer)\b/i,
|
|
8
|
+
/^git\s+(?:clone|fetch|pull|push|ls-remote|submodule)\b/,
|
|
9
|
+
/^(?:npm|pnpm|yarn|bun)\s+(?:install|i|ci|add|publish|view|search|audit|update|upgrade)\b/,
|
|
10
|
+
/^(?:pip3?|uv\s+pip)\s+install\b/,
|
|
11
|
+
/^python3?\s+-m\s+pip\s+install\b/,
|
|
12
|
+
/^cargo\s+(?:install|add|update|publish|fetch)\b/,
|
|
13
|
+
/^go\s+(?:get|install)\b/,
|
|
14
|
+
/^gem\s+install\b/,
|
|
15
|
+
/^brew\s+(?:install|update|upgrade)\b/,
|
|
16
|
+
/^apt(?:-get)?\s+(?:install|update|upgrade)\b/,
|
|
17
|
+
/^docker\s+(?:pull|push|login)\b/,
|
|
18
|
+
/^gh\s+\w+/,
|
|
19
|
+
];
|
|
20
|
+
const WRITE_ALL = new Set([
|
|
21
|
+
"rm",
|
|
22
|
+
"rmdir",
|
|
23
|
+
"mkdir",
|
|
24
|
+
"touch",
|
|
25
|
+
"tee",
|
|
26
|
+
"chmod",
|
|
27
|
+
"chown",
|
|
28
|
+
"set-content",
|
|
29
|
+
"add-content",
|
|
30
|
+
"out-file",
|
|
31
|
+
"remove-item",
|
|
32
|
+
"new-item",
|
|
33
|
+
"copy-item",
|
|
34
|
+
"move-item",
|
|
35
|
+
]);
|
|
36
|
+
const WRITE_LAST = new Set(["cp", "mv", "install", "ln", "rsync"]);
|
|
37
|
+
function splitSegments(command) {
|
|
38
|
+
const segments = [];
|
|
39
|
+
let current = "";
|
|
40
|
+
let quote = null;
|
|
41
|
+
for (let index = 0; index < command.length; index += 1) {
|
|
42
|
+
const char = command[index] ?? "";
|
|
43
|
+
if (quote !== null) {
|
|
44
|
+
current += char;
|
|
45
|
+
if (char === quote)
|
|
46
|
+
quote = null;
|
|
47
|
+
continue;
|
|
48
|
+
}
|
|
49
|
+
if (char === "'" || char === '"') {
|
|
50
|
+
quote = char;
|
|
51
|
+
current += char;
|
|
52
|
+
continue;
|
|
53
|
+
}
|
|
54
|
+
if (char === ";" || char === "\n") {
|
|
55
|
+
segments.push(current);
|
|
56
|
+
current = "";
|
|
57
|
+
continue;
|
|
58
|
+
}
|
|
59
|
+
if ((char === "&" || char === "|") && command[index + 1] === char) {
|
|
60
|
+
segments.push(current);
|
|
61
|
+
current = "";
|
|
62
|
+
index += 1;
|
|
63
|
+
continue;
|
|
64
|
+
}
|
|
65
|
+
if (char === "|") {
|
|
66
|
+
segments.push(current);
|
|
67
|
+
current = "";
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
current += char;
|
|
71
|
+
}
|
|
72
|
+
segments.push(current);
|
|
73
|
+
return segments.map((segment) => segment.trim()).filter((segment) => segment.length > 0);
|
|
74
|
+
}
|
|
75
|
+
function splitArgs(segment) {
|
|
76
|
+
const args = [];
|
|
77
|
+
let current = "";
|
|
78
|
+
let quote = null;
|
|
79
|
+
const flush = () => {
|
|
80
|
+
if (current.length > 0)
|
|
81
|
+
args.push(current);
|
|
82
|
+
current = "";
|
|
83
|
+
};
|
|
84
|
+
for (let index = 0; index < segment.length; index += 1) {
|
|
85
|
+
const char = segment[index] ?? "";
|
|
86
|
+
if (quote !== null) {
|
|
87
|
+
if (char === quote)
|
|
88
|
+
quote = null;
|
|
89
|
+
else
|
|
90
|
+
current += char;
|
|
91
|
+
continue;
|
|
92
|
+
}
|
|
93
|
+
if (char === "'" || char === '"') {
|
|
94
|
+
quote = char;
|
|
95
|
+
continue;
|
|
96
|
+
}
|
|
97
|
+
if (char === ">") {
|
|
98
|
+
flush();
|
|
99
|
+
if (segment[index + 1] === ">") {
|
|
100
|
+
args.push(">>");
|
|
101
|
+
index += 1;
|
|
102
|
+
}
|
|
103
|
+
else {
|
|
104
|
+
args.push(">");
|
|
105
|
+
}
|
|
106
|
+
continue;
|
|
107
|
+
}
|
|
108
|
+
if (/\s/.test(char)) {
|
|
109
|
+
flush();
|
|
110
|
+
continue;
|
|
111
|
+
}
|
|
112
|
+
current += char;
|
|
113
|
+
}
|
|
114
|
+
flush();
|
|
115
|
+
return args;
|
|
116
|
+
}
|
|
117
|
+
function commandPosition(args) {
|
|
118
|
+
let index = 0;
|
|
119
|
+
while (index < args.length) {
|
|
120
|
+
const token = (args[index] ?? "").toLowerCase();
|
|
121
|
+
if (token === "sudo" || token === "command" || token === "time" || token === "nohup") {
|
|
122
|
+
index += 1;
|
|
123
|
+
continue;
|
|
124
|
+
}
|
|
125
|
+
if (token === "env") {
|
|
126
|
+
index += 1;
|
|
127
|
+
while (index < args.length && (args[index] ?? "").includes("="))
|
|
128
|
+
index += 1;
|
|
129
|
+
continue;
|
|
130
|
+
}
|
|
131
|
+
break;
|
|
132
|
+
}
|
|
133
|
+
return index;
|
|
134
|
+
}
|
|
135
|
+
function writeTargets(args, commandIndex) {
|
|
136
|
+
const targets = [];
|
|
137
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
138
|
+
const token = args[index] ?? "";
|
|
139
|
+
if ((token === ">" || token === ">>") && args[index + 1] !== undefined) {
|
|
140
|
+
targets.push(args[index + 1] ?? "");
|
|
141
|
+
index += 1;
|
|
142
|
+
continue;
|
|
143
|
+
}
|
|
144
|
+
if (/^\d?>>?$/.test(token) && args[index + 1] !== undefined) {
|
|
145
|
+
targets.push(args[index + 1] ?? "");
|
|
146
|
+
index += 1;
|
|
147
|
+
continue;
|
|
148
|
+
}
|
|
149
|
+
if (/^of=/.test(token))
|
|
150
|
+
targets.push(token.slice(3));
|
|
151
|
+
}
|
|
152
|
+
const command = (args[commandIndex] ?? "").toLowerCase();
|
|
153
|
+
const rest = args.slice(commandIndex + 1).filter((arg) => !arg.startsWith("-"));
|
|
154
|
+
if (WRITE_ALL.has(command)) {
|
|
155
|
+
for (let index = commandIndex + 1; index < args.length; index += 1) {
|
|
156
|
+
const token = args[index] ?? "";
|
|
157
|
+
if (token.startsWith("-"))
|
|
158
|
+
continue;
|
|
159
|
+
targets.push(token);
|
|
160
|
+
}
|
|
161
|
+
}
|
|
162
|
+
else if (WRITE_LAST.has(command)) {
|
|
163
|
+
const last = rest.at(-1);
|
|
164
|
+
if (last !== undefined)
|
|
165
|
+
targets.push(last);
|
|
166
|
+
}
|
|
167
|
+
else if (command === "git" && (args[commandIndex + 1] ?? "") === "clone") {
|
|
168
|
+
const last = rest.at(-1);
|
|
169
|
+
if (last !== undefined)
|
|
170
|
+
targets.push(last);
|
|
171
|
+
}
|
|
172
|
+
else if (command === "dd") {
|
|
173
|
+
for (const token of rest)
|
|
174
|
+
if (token.startsWith("of="))
|
|
175
|
+
targets.push(token.slice(3));
|
|
176
|
+
}
|
|
177
|
+
return targets;
|
|
178
|
+
}
|
|
179
|
+
function unverifiablePath(target) {
|
|
180
|
+
return target.startsWith("~") || target.includes("$") || target.includes("%");
|
|
181
|
+
}
|
|
182
|
+
function extractHosts(command) {
|
|
183
|
+
const hosts = [];
|
|
184
|
+
const pattern = /https?:\/\/([^\s/"'`?#]+)/gi;
|
|
185
|
+
for (const match of command.matchAll(pattern)) {
|
|
186
|
+
const host = match[1];
|
|
187
|
+
if (host !== undefined)
|
|
188
|
+
hosts.push(host.replace(/:\d+$/, ""));
|
|
189
|
+
}
|
|
190
|
+
return hosts;
|
|
191
|
+
}
|
|
192
|
+
function networkCommand(segment) {
|
|
193
|
+
const trimmed = segment.trim();
|
|
194
|
+
return NETWORK_PATTERNS.some((pattern) => pattern.test(trimmed));
|
|
195
|
+
}
|
|
196
|
+
const DEVICE_TARGETS = new Set(["/dev/null", "/dev/stdout", "/dev/stderr", "/dev/tty"]);
|
|
197
|
+
export function checkCommand(policy, command, cwd) {
|
|
198
|
+
for (const segment of splitSegments(command)) {
|
|
199
|
+
const args = splitArgs(segment);
|
|
200
|
+
const index = commandPosition(args);
|
|
201
|
+
for (const target of writeTargets(args, index)) {
|
|
202
|
+
const normalized = target.trim();
|
|
203
|
+
if (normalized.length === 0 || DEVICE_TARGETS.has(normalized))
|
|
204
|
+
continue;
|
|
205
|
+
if (unverifiablePath(normalized)) {
|
|
206
|
+
return {
|
|
207
|
+
allowed: false,
|
|
208
|
+
reason: `Write target ${normalized} cannot be verified inside the sandbox roots`,
|
|
209
|
+
};
|
|
210
|
+
}
|
|
211
|
+
const absolute = isAbsolute(normalized) ? normalized : resolve(cwd, normalized);
|
|
212
|
+
const decision = checkWrite(policy, absolute);
|
|
213
|
+
if (!decision.allowed)
|
|
214
|
+
return { allowed: false, reason: decision.reason };
|
|
215
|
+
}
|
|
216
|
+
if (!networkCommand(segment))
|
|
217
|
+
continue;
|
|
218
|
+
if (policy.allowNetwork)
|
|
219
|
+
continue;
|
|
220
|
+
const hosts = extractHosts(segment);
|
|
221
|
+
if (hosts.length > 0) {
|
|
222
|
+
const blocked = hosts.find((host) => !checkNetwork(policy, host).allowed);
|
|
223
|
+
if (blocked !== undefined) {
|
|
224
|
+
return {
|
|
225
|
+
allowed: false,
|
|
226
|
+
reason: `Network access to ${blocked} is blocked by the sandbox`,
|
|
227
|
+
};
|
|
228
|
+
}
|
|
229
|
+
continue;
|
|
230
|
+
}
|
|
231
|
+
return {
|
|
232
|
+
allowed: false,
|
|
233
|
+
reason: `Network command is blocked by the sandbox: ${segment.slice(0, 80)}`,
|
|
234
|
+
};
|
|
235
|
+
}
|
|
236
|
+
return { allowed: true };
|
|
237
|
+
}
|
|
238
|
+
function escapeProfilePath(path) {
|
|
239
|
+
return path.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
|
|
240
|
+
}
|
|
241
|
+
function canonicalPath(path) {
|
|
242
|
+
try {
|
|
243
|
+
return realpathSync(path);
|
|
244
|
+
}
|
|
245
|
+
catch {
|
|
246
|
+
return path;
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
export function seatbeltProfile(policy) {
|
|
250
|
+
// Seatbelt matches the resolved path, so on platforms where temporary roots
|
|
251
|
+
// are symlinked (for example /var -> /private/var on macOS) the original
|
|
252
|
+
// spelling alone does not grant access to files under the root.
|
|
253
|
+
const writable = [...new Set([...policy.roots.flatMap((root) => [root, canonicalPath(root)]), tmpdir(), canonicalPath(tmpdir())])];
|
|
254
|
+
const lines = [
|
|
255
|
+
"(version 1)",
|
|
256
|
+
"(allow default)",
|
|
257
|
+
"(deny file-write*)",
|
|
258
|
+
`(allow file-write* ${writable
|
|
259
|
+
.map((root) => `(subpath "${escapeProfilePath(root)}")`)
|
|
260
|
+
.join(" ")} (literal "/dev/null") (literal "/dev/stdout") (literal "/dev/stderr") (literal "/dev/tty"))`,
|
|
261
|
+
];
|
|
262
|
+
if (!policy.allowNetwork)
|
|
263
|
+
lines.push("(deny network*)");
|
|
264
|
+
return lines.join("\n");
|
|
265
|
+
}
|
|
266
|
+
export function bwrapArgs(policy, command, cwd) {
|
|
267
|
+
const args = ["--ro-bind", "/", "/", "--dev", "/dev", "--proc", "/proc", "--tmpfs", "/tmp"];
|
|
268
|
+
for (const root of policy.roots)
|
|
269
|
+
args.push("--bind", root, root);
|
|
270
|
+
if (!policy.allowNetwork)
|
|
271
|
+
args.push("--unshare-net");
|
|
272
|
+
args.push("--chdir", cwd, "--", "/bin/sh", "-c", command);
|
|
273
|
+
return args;
|
|
274
|
+
}
|
|
275
|
+
export function detectWrapper(platform = process.platform, exists = existsSync) {
|
|
276
|
+
if (platform === "darwin" && exists("/usr/bin/sandbox-exec")) {
|
|
277
|
+
return { kind: "seatbelt", command: "/usr/bin/sandbox-exec", args: [] };
|
|
278
|
+
}
|
|
279
|
+
if (platform === "linux") {
|
|
280
|
+
for (const candidate of ["/usr/bin/bwrap", "/usr/local/bin/bwrap", "/bin/bwrap"]) {
|
|
281
|
+
if (exists(candidate))
|
|
282
|
+
return { kind: "bwrap", command: candidate, args: [] };
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
return null;
|
|
286
|
+
}
|
|
287
|
+
export function sandboxSpawn(policy, command, cwd, platform = process.platform) {
|
|
288
|
+
const wrapper = detectWrapper(platform);
|
|
289
|
+
if (wrapper?.kind === "seatbelt") {
|
|
290
|
+
return {
|
|
291
|
+
command: wrapper.command,
|
|
292
|
+
args: ["-p", seatbeltProfile(policy), "/bin/sh", "-c", command],
|
|
293
|
+
shell: false,
|
|
294
|
+
wrapper,
|
|
295
|
+
};
|
|
296
|
+
}
|
|
297
|
+
if (wrapper?.kind === "bwrap") {
|
|
298
|
+
return {
|
|
299
|
+
command: wrapper.command,
|
|
300
|
+
args: bwrapArgs(policy, command, cwd),
|
|
301
|
+
shell: false,
|
|
302
|
+
wrapper,
|
|
303
|
+
};
|
|
304
|
+
}
|
|
305
|
+
return { command, args: [], shell: true, wrapper: null };
|
|
306
|
+
}
|
|
307
|
+
//# sourceMappingURL=command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/sandbox/command.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export interface SandboxPolicy {
|
|
2
|
+
roots: string[];
|
|
3
|
+
allowNetwork: boolean;
|
|
4
|
+
allowedHosts: string[];
|
|
5
|
+
platform: NodeJS.Platform;
|
|
6
|
+
}
|
|
7
|
+
export interface SandboxDecision {
|
|
8
|
+
allowed: boolean;
|
|
9
|
+
reason?: string | undefined;
|
|
10
|
+
}
|
|
11
|
+
export interface SandboxPolicyOptions {
|
|
12
|
+
roots: string[];
|
|
13
|
+
allowNetwork?: boolean | undefined;
|
|
14
|
+
allowedHosts?: string[] | undefined;
|
|
15
|
+
platform?: NodeJS.Platform | undefined;
|
|
16
|
+
}
|
|
17
|
+
export declare function createSandboxPolicy(options: SandboxPolicyOptions): SandboxPolicy;
|
|
18
|
+
export declare function checkWrite(policy: SandboxPolicy, path: string): SandboxDecision;
|
|
19
|
+
export declare function checkNetwork(policy: SandboxPolicy, host: string): SandboxDecision;
|
|
20
|
+
export declare function sandboxSupported(platform: NodeJS.Platform): boolean;
|
|
21
|
+
export declare function sandboxFallbackWarning(platform: NodeJS.Platform): string | null;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { isInside } from "../util/paths.js";
|
|
2
|
+
export function createSandboxPolicy(options) {
|
|
3
|
+
return {
|
|
4
|
+
roots: options.roots,
|
|
5
|
+
allowNetwork: options.allowNetwork ?? false,
|
|
6
|
+
allowedHosts: options.allowedHosts ?? [],
|
|
7
|
+
platform: options.platform ?? process.platform,
|
|
8
|
+
};
|
|
9
|
+
}
|
|
10
|
+
export function checkWrite(policy, path) {
|
|
11
|
+
if (policy.roots.some((root) => isInside(root, path)))
|
|
12
|
+
return { allowed: true };
|
|
13
|
+
return { allowed: false, reason: `${path} is outside the sandbox roots` };
|
|
14
|
+
}
|
|
15
|
+
export function checkNetwork(policy, host) {
|
|
16
|
+
if (policy.allowNetwork)
|
|
17
|
+
return { allowed: true };
|
|
18
|
+
const normalized = host.toLowerCase();
|
|
19
|
+
if (policy.allowedHosts.some((entry) => normalized === entry || normalized.endsWith(`.${entry}`))) {
|
|
20
|
+
return { allowed: true };
|
|
21
|
+
}
|
|
22
|
+
return { allowed: false, reason: `Network access to ${host} is blocked by the sandbox` };
|
|
23
|
+
}
|
|
24
|
+
export function sandboxSupported(platform) {
|
|
25
|
+
return platform === "darwin" || platform === "linux";
|
|
26
|
+
}
|
|
27
|
+
export function sandboxFallbackWarning(platform) {
|
|
28
|
+
if (sandboxSupported(platform))
|
|
29
|
+
return null;
|
|
30
|
+
return "Sandboxing is not fully supported on this platform; filesystem checks still apply, network and process limits use a documented fallback.";
|
|
31
|
+
}
|
|
32
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sandbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAqB5C,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,KAAK;QAC3C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,IAAY;IAC5D,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAChF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,+BAA+B,EAAE,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAqB,EAAE,IAAY;IAC9D,IAAI,MAAM,CAAC,YAAY;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,KAAK,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;QAClG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,IAAI,4BAA4B,EAAE,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAyB;IACxD,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,OAAO,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAyB;IAC9D,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,0IAA0I,CAAC;AACpJ,CAAC"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { type AgentSetupOptions } from "../app/factory.js";
|
|
2
|
+
import type { AgentEvent, TurnResult } from "../app/agent.js";
|
|
3
|
+
export interface CreateAgentOptions extends AgentSetupOptions {
|
|
4
|
+
signal?: AbortSignal | undefined;
|
|
5
|
+
}
|
|
6
|
+
export interface SdkAgent {
|
|
7
|
+
sessionId: string;
|
|
8
|
+
run(prompt: string, signal?: AbortSignal): Promise<TurnResult>;
|
|
9
|
+
stream(prompt: string, signal?: AbortSignal): AsyncIterable<AgentEvent>;
|
|
10
|
+
runStructured(prompt: string, schema: unknown, signal?: AbortSignal): Promise<unknown>;
|
|
11
|
+
abort(): void;
|
|
12
|
+
close(): void;
|
|
13
|
+
}
|
|
14
|
+
export declare function createAgent(options: CreateAgentOptions): Promise<SdkAgent>;
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { createAgentSetup } from "../app/factory.js";
|
|
2
|
+
import { parseStructuredOutput } from "./structured.js";
|
|
3
|
+
export async function createAgent(options) {
|
|
4
|
+
const setup = await createAgentSetup(options);
|
|
5
|
+
let controller = new AbortController();
|
|
6
|
+
return {
|
|
7
|
+
sessionId: setup.sessionId,
|
|
8
|
+
async run(prompt, signal) {
|
|
9
|
+
return await setup.agent.runTurn(prompt, signal ?? controller.signal);
|
|
10
|
+
},
|
|
11
|
+
async *stream(prompt, signal) {
|
|
12
|
+
const queue = [];
|
|
13
|
+
let finished = false;
|
|
14
|
+
let failure = null;
|
|
15
|
+
const unsubscribe = setup.agent.subscribe((event) => queue.push(event));
|
|
16
|
+
const running = setup.agent
|
|
17
|
+
.runTurn(prompt, signal ?? controller.signal)
|
|
18
|
+
.then((result) => {
|
|
19
|
+
queue.push({ type: "done", stopReason: result.stopReason });
|
|
20
|
+
finished = true;
|
|
21
|
+
})
|
|
22
|
+
.catch((error) => {
|
|
23
|
+
failure = error;
|
|
24
|
+
finished = true;
|
|
25
|
+
});
|
|
26
|
+
try {
|
|
27
|
+
while (!finished || queue.length > 0) {
|
|
28
|
+
const event = queue.shift();
|
|
29
|
+
if (event) {
|
|
30
|
+
yield event;
|
|
31
|
+
}
|
|
32
|
+
else {
|
|
33
|
+
await new Promise((resolvePromise) => setTimeout(resolvePromise, 5));
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
finally {
|
|
38
|
+
unsubscribe();
|
|
39
|
+
}
|
|
40
|
+
await running;
|
|
41
|
+
if (failure !== null)
|
|
42
|
+
throw failure;
|
|
43
|
+
},
|
|
44
|
+
async runStructured(prompt, schema, signal) {
|
|
45
|
+
const result = await setup.agent.runTurn(prompt, signal ?? controller.signal);
|
|
46
|
+
return parseStructuredOutput(result.text, schema);
|
|
47
|
+
},
|
|
48
|
+
abort() {
|
|
49
|
+
controller.abort();
|
|
50
|
+
controller = new AbortController();
|
|
51
|
+
},
|
|
52
|
+
close() {
|
|
53
|
+
controller.abort();
|
|
54
|
+
},
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAexD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEvC,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,CAAC,GAAG,CAAC,MAAc,EAAE,MAAoB;YAC5C,OAAO,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,KAAK,CAAC,CAAC,MAAM,CAAC,MAAc,EAAE,MAAoB;YAChD,MAAM,KAAK,GAAiB,EAAE,CAAC;YAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,IAAI,OAAO,GAAY,IAAI,CAAC;YAC5B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACxE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK;iBACxB,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC;iBAC5C,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACf,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC5D,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,OAAO,GAAG,KAAK,CAAC;gBAChB,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC,CAAC,CAAC;YACL,IAAI,CAAC;gBACH,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC5B,IAAI,KAAK,EAAE,CAAC;wBACV,MAAM,KAAK,CAAC;oBACd,CAAC;yBAAM,CAAC;wBACN,MAAM,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;oBACvE,CAAC;gBACH,CAAC;YACH,CAAC;oBAAS,CAAC;gBACT,WAAW,EAAE,CAAC;YAChB,CAAC;YACD,MAAM,OAAO,CAAC;YACd,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAAe,EAAE,MAAoB;YACvE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YAC9E,OAAO,qBAAqB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QACD,KAAK;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;YACnB,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,CAAC;QACD,KAAK;YACH,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export interface SchemaValidation {
|
|
2
|
+
valid: boolean;
|
|
3
|
+
errors: string[];
|
|
4
|
+
}
|
|
5
|
+
export declare function validateSchema(value: unknown, schema: unknown, path?: string): SchemaValidation;
|
|
6
|
+
export declare function extractJson(text: string): unknown;
|
|
7
|
+
export declare function parseStructuredOutput(text: string, schema: unknown): unknown;
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { KeycodeError } from "../util/errors.js";
|
|
2
|
+
function typeOf(value) {
|
|
3
|
+
if (value === null)
|
|
4
|
+
return "null";
|
|
5
|
+
if (Array.isArray(value))
|
|
6
|
+
return "array";
|
|
7
|
+
return typeof value;
|
|
8
|
+
}
|
|
9
|
+
export function validateSchema(value, schema, path = "$") {
|
|
10
|
+
const errors = [];
|
|
11
|
+
if (schema === null || typeof schema !== "object")
|
|
12
|
+
return { valid: true, errors };
|
|
13
|
+
const record = schema;
|
|
14
|
+
const expectedType = record.type;
|
|
15
|
+
if (typeof expectedType === "string" && typeOf(value) !== expectedType) {
|
|
16
|
+
errors.push(`${path}: expected ${expectedType}, got ${typeOf(value)}`);
|
|
17
|
+
return { valid: false, errors };
|
|
18
|
+
}
|
|
19
|
+
if (Array.isArray(record.enum) && !record.enum.includes(value)) {
|
|
20
|
+
errors.push(`${path}: value is not one of the allowed enum values`);
|
|
21
|
+
}
|
|
22
|
+
if (typeOf(value) === "object" && value !== null) {
|
|
23
|
+
const object = value;
|
|
24
|
+
const required = Array.isArray(record.required) ? record.required : [];
|
|
25
|
+
for (const key of required) {
|
|
26
|
+
if (!(key in object))
|
|
27
|
+
errors.push(`${path}.${String(key)}: required property is missing`);
|
|
28
|
+
}
|
|
29
|
+
const properties = record.properties;
|
|
30
|
+
if (properties !== null && typeof properties === "object") {
|
|
31
|
+
for (const [key, childSchema] of Object.entries(properties)) {
|
|
32
|
+
if (key in object) {
|
|
33
|
+
const result = validateSchema(object[key], childSchema, `${path}.${key}`);
|
|
34
|
+
errors.push(...result.errors);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
if (typeOf(value) === "array" && record.items !== undefined) {
|
|
40
|
+
const items = value;
|
|
41
|
+
items.forEach((item, index) => {
|
|
42
|
+
const result = validateSchema(item, record.items, `${path}[${index}]`);
|
|
43
|
+
errors.push(...result.errors);
|
|
44
|
+
});
|
|
45
|
+
}
|
|
46
|
+
return { valid: errors.length === 0, errors };
|
|
47
|
+
}
|
|
48
|
+
export function extractJson(text) {
|
|
49
|
+
const fenced = /```(?:json)?\s*([\s\S]*?)```/.exec(text);
|
|
50
|
+
const raw = (fenced?.[1] ?? text).trim();
|
|
51
|
+
try {
|
|
52
|
+
return JSON.parse(raw);
|
|
53
|
+
}
|
|
54
|
+
catch (error) {
|
|
55
|
+
throw new KeycodeError("TOOL_INPUT_INVALID", `Structured output is not valid JSON: ${error.message}`);
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
export function parseStructuredOutput(text, schema) {
|
|
59
|
+
const value = extractJson(text);
|
|
60
|
+
const validation = validateSchema(value, schema);
|
|
61
|
+
if (!validation.valid) {
|
|
62
|
+
throw new KeycodeError("TOOL_INPUT_INVALID", `Structured output did not match the schema: ${validation.errors.join("; ")}`);
|
|
63
|
+
}
|
|
64
|
+
return value;
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=structured.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"structured.js","sourceRoot":"","sources":["../../src/sdk/structured.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOjD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,MAAe,EAAE,IAAI,GAAG,GAAG;IACxE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAElF,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;IACjC,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,cAAc,YAAY,SAAS,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,+CAA+C,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1D,KAAK,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAqC,CAAC,EAAE,CAAC;gBACvF,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;oBAClB,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;oBAC1E,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,KAAkB,CAAC;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,MAAM,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,wCAAyC,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAe;IACjE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,YAAY,CACpB,oBAAoB,EACpB,+CAA+C,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { Message } from "../contracts/message.js";
|
|
2
|
+
import type { Provider } from "../contracts/provider.js";
|
|
3
|
+
export interface MemoryEntry {
|
|
4
|
+
id: string;
|
|
5
|
+
text: string;
|
|
6
|
+
createdAt: string;
|
|
7
|
+
}
|
|
8
|
+
export declare class AutoMemoryStore {
|
|
9
|
+
private readonly file;
|
|
10
|
+
constructor(file: string);
|
|
11
|
+
private read;
|
|
12
|
+
private write;
|
|
13
|
+
get paused(): boolean;
|
|
14
|
+
list(): MemoryEntry[];
|
|
15
|
+
add(text: string): MemoryEntry;
|
|
16
|
+
remove(id: string): boolean;
|
|
17
|
+
pause(): void;
|
|
18
|
+
resume(): void;
|
|
19
|
+
recall(query?: string): MemoryEntry[];
|
|
20
|
+
}
|
|
21
|
+
export declare const EXTRACT_PROMPT: string;
|
|
22
|
+
export declare function extractMemory(provider: Provider, model: string, messages: Message[], signal: AbortSignal): Promise<string | null>;
|