@sixb/agent 0.2.2 → 0.2.4
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 +2 -2
- package/dist/artifacts/board-previews.d.ts +41 -0
- package/dist/artifacts/board-previews.d.ts.map +1 -0
- package/dist/artifacts/layout-check/layout-check.d.ts +38 -6
- package/dist/artifacts/layout-check/layout-check.d.ts.map +1 -1
- package/dist/artifacts/layout-check/overview.d.ts +17 -0
- package/dist/artifacts/layout-check/overview.d.ts.map +1 -0
- package/dist/artifacts/materialize.d.ts +56 -24
- package/dist/artifacts/materialize.d.ts.map +1 -1
- package/dist/artifacts/publish-tool.d.ts +35 -27
- package/dist/artifacts/publish-tool.d.ts.map +1 -1
- package/dist/ask-tool.d.ts +62 -0
- package/dist/ask-tool.d.ts.map +1 -0
- package/dist/attachments.d.ts +1 -1
- package/dist/attachments.d.ts.map +1 -1
- package/dist/background-commands.d.ts +3 -3
- package/dist/background-commands.d.ts.map +1 -1
- package/dist/background-notices.d.ts.map +1 -1
- package/dist/child-files.d.ts +1 -1
- package/dist/child-questions.d.ts +1 -1
- package/dist/index.d.ts +2 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +12309 -10490
- package/dist/index.js.map +41 -35
- package/dist/run-agent-turn.d.ts.map +1 -1
- package/dist/run-conversation-turn.d.ts.map +1 -1
- package/dist/run-environment.d.ts +4 -1
- package/dist/run-environment.d.ts.map +1 -1
- package/dist/run-subagent.d.ts +1 -1
- package/dist/sandbox-files.d.ts +19 -0
- package/dist/sandbox-files.d.ts.map +1 -1
- package/dist/subagent-tools.d.ts +23 -2
- package/dist/subagent-tools.d.ts.map +1 -1
- package/dist/tools/background.d.ts +50 -18
- package/dist/tools/background.d.ts.map +1 -1
- package/dist/tools/bash.d.ts +1 -0
- package/dist/tools/bash.d.ts.map +1 -1
- package/dist/tools/edit-text.d.ts +22 -0
- package/dist/tools/edit-text.d.ts.map +1 -0
- package/dist/tools/edit.d.ts +54 -0
- package/dist/tools/edit.d.ts.map +1 -0
- package/dist/tools/file-writes.d.ts +52 -0
- package/dist/tools/file-writes.d.ts.map +1 -0
- package/dist/tools/model-spec.d.ts.map +1 -1
- package/dist/tools/read.d.ts +16 -3
- package/dist/tools/read.d.ts.map +1 -1
- package/dist/tools/tool-files.d.ts.map +1 -1
- package/dist/tools/view-file.d.ts +20 -23
- package/dist/tools/view-file.d.ts.map +1 -1
- package/dist/tools/web-fetch/tool.d.ts +1 -0
- package/dist/tools/web-fetch/tool.d.ts.map +1 -1
- package/dist/tools/web-search.d.ts +1 -0
- package/dist/tools/web-search.d.ts.map +1 -1
- package/dist/tools/write.d.ts +36 -0
- package/dist/tools/write.d.ts.map +1 -0
- package/dist/types.d.ts +5 -4
- package/dist/types.d.ts.map +1 -1
- package/package.json +7 -6
- package/src/agent-prompt.ts +10 -10
- package/src/artifacts/board-previews.ts +218 -0
- package/src/artifacts/layout-check/check.cjs +304 -80
- package/src/artifacts/layout-check/layout-check.ts +119 -9
- package/src/artifacts/layout-check/overview.ts +291 -0
- package/src/artifacts/materialize.ts +181 -55
- package/src/artifacts/publish-tool.ts +475 -163
- package/src/ask-tool.ts +223 -0
- package/src/attachments.ts +7 -6
- package/src/background-commands.ts +5 -5
- package/src/background-notices.ts +5 -12
- package/src/child-files.ts +1 -1
- package/src/child-questions.ts +1 -1
- package/src/context-compaction.ts +4 -1
- package/src/index.ts +2 -1
- package/src/run-agent-turn.ts +14 -4
- package/src/run-child.ts +1 -1
- package/src/run-conversation-turn.ts +4 -1
- package/src/run-environment.ts +40 -26
- package/src/run-subagent.ts +3 -3
- package/src/sandbox-api-context.ts +1 -1
- package/src/sandbox-files.ts +86 -0
- package/src/skills/sixb-artifacts/SKILL.md +48 -25
- package/src/skills/sixb-artifacts/canvas.md +140 -18
- package/src/skills/sixb-artifacts/examples/canvas/onboarding-flow/canvas.json +1 -1
- package/src/skills/sixb-artifacts/page.md +2 -2
- package/src/skills/sixb-artifacts/references.md +15 -12
- package/src/skills/sixb-artifacts/sheet.md +1 -1
- package/src/skills/sixb-artifacts/slides.md +2 -2
- package/src/subagent-tools.ts +134 -88
- package/src/tools/background.ts +227 -67
- package/src/tools/bash.ts +2 -1
- package/src/tools/edit-text.ts +241 -0
- package/src/tools/edit.ts +166 -0
- package/src/tools/file-writes.ts +270 -0
- package/src/tools/model-spec.ts +9 -12
- package/src/tools/read.ts +75 -9
- package/src/tools/tool-files.ts +3 -1
- package/src/tools/tool-outputs.ts +2 -2
- package/src/tools/view-file.ts +78 -80
- package/src/tools/web-fetch/tool.ts +2 -1
- package/src/tools/web-search.ts +1 -0
- package/src/tools/write.ts +95 -0
- package/src/types.ts +5 -4
- package/dist/ask-parent-tool.d.ts +0 -36
- package/dist/ask-parent-tool.d.ts.map +0 -1
- package/src/ask-parent-tool.ts +0 -100
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-agent-turn.d.ts","sourceRoot":"","sources":["../src/run-agent-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtF,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,eAAe,EAOrB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAEhC,MAAM,oBAAoB,CAAA;
|
|
1
|
+
{"version":3,"file":"run-agent-turn.d.ts","sourceRoot":"","sources":["../src/run-agent-turn.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-conversation-turn.d.ts","sourceRoot":"","sources":["../src/run-conversation-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EAEjB,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;
|
|
1
|
+
{"version":3,"file":"run-conversation-turn.d.ts","sourceRoot":"","sources":["../src/run-conversation-turn.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EAErB,MAAM,4BAA4B,CAAA;AAInC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EAEjB,0BAA0B,EAC1B,eAAe,EACf,iBAAiB,EAClB,MAAM,oBAAoB,CAAA;AAK3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGrD,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMtE,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,qEAAqE;IACrE,WAAW,CAAC,IAAI,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;QAC7D,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;QACvC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAA;QACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAC1C,GAAG,cAAc,CAAA;IAClB;;;OAGG;IACH,UAAU,CACR,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,aAAa,EACrB,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,IAAI,CAAA;IACP,0FAA0F;IAC1F,kBAAkB,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjD,2EAA2E;IAC3E,aAAa,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IACnF;;;OAGG;IACH,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACnD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC,0BAA0B,CAAC,CAAA;IAC7D,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkIhB"}
|
|
@@ -12,6 +12,7 @@ import { type BeforeFinalizeOptions, type RunSandbox } from "./run-sandbox";
|
|
|
12
12
|
import { type SubagentThreadContext } from "./subagent-context";
|
|
13
13
|
import type { SubagentHistory } from "./subagent-continuation";
|
|
14
14
|
import { type LoadedAgentThreadModelContext } from "./thread-context";
|
|
15
|
+
import { type WaitableChildren } from "./tools/background";
|
|
15
16
|
import type { AgentTurnRuntime } from "./turn-runtime";
|
|
16
17
|
import type { AgentExecutionContext, AgentRunFiles, AgentTurnContext } from "./types";
|
|
17
18
|
export interface AgentExecutionEnvironment {
|
|
@@ -86,6 +87,8 @@ export interface CreateConversationAgentEnvironmentInput extends CreateAgentEnvi
|
|
|
86
87
|
readonly history: AgentTurnHistory;
|
|
87
88
|
/** Framework-owned tools of the conversational Agent: delegation. */
|
|
88
89
|
readonly frameworkTools?: readonly ModelTool[];
|
|
90
|
+
/** Its children, which `wait` and `stop` reach beside its background commands. */
|
|
91
|
+
readonly children?: WaitableChildren;
|
|
89
92
|
}
|
|
90
93
|
export interface CreateSubagentEnvironmentInput extends CreateAgentEnvironmentInput {
|
|
91
94
|
/** The child's session: its workspace goes through it. */
|
|
@@ -99,7 +102,7 @@ export interface CreateSubagentEnvironmentInput extends CreateAgentEnvironmentIn
|
|
|
99
102
|
readonly requestedBy?: Principal;
|
|
100
103
|
/** Its thread's messages, whose files are projected again, and the paused run it continues. */
|
|
101
104
|
readonly history: SubagentHistory;
|
|
102
|
-
/** Framework-owned tools of a child: `
|
|
105
|
+
/** Framework-owned tools of a child: `ask`, to its parent. */
|
|
103
106
|
readonly frameworkTools?: readonly ModelTool[];
|
|
104
107
|
/** Weigh the thread before the first call, and compact it on the child's thread when needed. */
|
|
105
108
|
readonly preflight?: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-environment.d.ts","sourceRoot":"","sources":["../src/run-environment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EAGtB,MAAM,4BAA4B,CAAA;AAEnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAChE,OAAO,KAAK,EACV,4BAA4B,EAE5B,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,0BAA0B,EAC3B,MAAM,oBAAoB,CAAA;AAwB3B,OAAO,EAGL,KAAK,mBAAmB,EAMzB,MAAM,sBAAsB,CAAA;AAI7B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAElE,OAAO,EAAE,KAAK,mBAAmB,EAAuB,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAqB,MAAM,kBAAkB,CAAA;AAClG,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EAChB,MAAM,eAAe,CAAA;AAUtB,OAAO,EAEL,KAAK,qBAAqB,EAI3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAA2B,KAAK,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;
|
|
1
|
+
{"version":3,"file":"run-environment.d.ts","sourceRoot":"","sources":["../src/run-environment.ts"],"names":[],"mappings":"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"}
|
package/dist/run-subagent.d.ts
CHANGED
|
@@ -50,7 +50,7 @@ export declare function runSubagent(input: {
|
|
|
50
50
|
readonly runFiles: AgentRunFiles;
|
|
51
51
|
/**
|
|
52
52
|
* What its parent sends it while it runs, read before its next step, and the questions it asks,
|
|
53
|
-
* through the inbox's `
|
|
53
|
+
* through the inbox's `ask` among its tools.
|
|
54
54
|
*/
|
|
55
55
|
readonly inbox: SubagentInbox;
|
|
56
56
|
}): Promise<SubagentRunRecord>;
|
package/dist/sandbox-files.d.ts
CHANGED
|
@@ -50,6 +50,25 @@ export declare function readSandboxFile(handle: AgentSandboxHandle, input: Sandb
|
|
|
50
50
|
readonly path: string;
|
|
51
51
|
readonly maxBytes: number;
|
|
52
52
|
}): Promise<Uint8Array>;
|
|
53
|
+
/** One file of {@link readSandboxFiles}: its bytes, or why it could not be read. */
|
|
54
|
+
export type SandboxFileRead = {
|
|
55
|
+
readonly path: string;
|
|
56
|
+
readonly bytes: Uint8Array;
|
|
57
|
+
} | {
|
|
58
|
+
readonly path: string;
|
|
59
|
+
readonly error: SandboxFileErrorReason;
|
|
60
|
+
};
|
|
61
|
+
/**
|
|
62
|
+
* Read many regular files in one command, with the checks {@link readSandboxFile} makes on each.
|
|
63
|
+
* A file that fails is reported in its place and the others are read: one per path, in order.
|
|
64
|
+
* Everything comes back on one stdout, so keep the files' total to what a command prints.
|
|
65
|
+
*/
|
|
66
|
+
export declare function readSandboxFiles(handle: AgentSandboxHandle, input: SandboxCommandOptions & {
|
|
67
|
+
/** Absolute paths, as `resolveSandboxPath` returns them. */
|
|
68
|
+
readonly paths: readonly string[];
|
|
69
|
+
/** The most each file may hold. */
|
|
70
|
+
readonly maxBytes: number;
|
|
71
|
+
}): Promise<SandboxFileRead[]>;
|
|
53
72
|
/** What a path names once its symbolic links are followed. */
|
|
54
73
|
export type SandboxPathEntry = {
|
|
55
74
|
readonly kind: "file" | "directory";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sandbox-files.d.ts","sourceRoot":"","sources":["../src/sandbox-files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,kBAAkB,CAAA;AAMvE,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAC9B,cAAc,GACd,cAAc,GACd,WAAW,GACX,WAAW,GACX,SAAS,GACT,QAAQ,CAAA;AAEZ,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,sBAAsB;gBAA9B,MAAM,EAAE,sBAAsB,EACvC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC3C,+FAA+F;IAC/F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAoB5F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,kBAAkB,CAAC,CAsC7B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAC7B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACA,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAA;IACnC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7B;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,gBAAgB,CAAC,CAsB3B"}
|
|
1
|
+
{"version":3,"file":"sandbox-files.d.ts","sourceRoot":"","sources":["../src/sandbox-files.ts"],"names":[],"mappings":"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"}
|
package/dist/subagent-tools.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ import { type InstalledChildFile } from "./child-files";
|
|
|
6
6
|
import { type QuestionRef } from "./child-questions";
|
|
7
7
|
import { FamilyMailbox } from "./family-mailbox";
|
|
8
8
|
import type { TurnChildren } from "./run-agent-turn";
|
|
9
|
+
import type { WaitableChildren } from "./tools/background";
|
|
9
10
|
import type { AgentRunFiles, AgentRunSettings } from "./types";
|
|
10
11
|
/**
|
|
11
12
|
* How long a wait for children goes without reading their runs when nothing woke it. A child's
|
|
@@ -108,12 +109,14 @@ export interface WaitedQuestion extends QuestionRef {
|
|
|
108
109
|
}
|
|
109
110
|
export interface WaitForSubagentsOutput {
|
|
110
111
|
readonly results: readonly WaitedSubagentResult[];
|
|
111
|
-
/** Every question a child of this turn waits on: `
|
|
112
|
+
/** Every question a child of this turn waits on: `wait` returns as soon as one comes. */
|
|
112
113
|
readonly questions?: readonly WaitedQuestion[];
|
|
113
114
|
/** The files no earlier result held, in the order of `results`. */
|
|
114
115
|
readonly files: readonly InstalledChildFile[];
|
|
115
116
|
/** Why what the children published is not all in `$SIXB_ARTIFACTS`. */
|
|
116
117
|
readonly artifactsError?: string;
|
|
118
|
+
/** The folders the Agent published from that took what the children wrote. */
|
|
119
|
+
readonly artifactsNote?: string;
|
|
117
120
|
}
|
|
118
121
|
/** What a turn offers the children it spawns. */
|
|
119
122
|
export interface TurnDelegation {
|
|
@@ -181,6 +184,15 @@ export declare class SubagentCoordinator {
|
|
|
181
184
|
*/
|
|
182
185
|
private pausedChildrenToContinue;
|
|
183
186
|
createTools(): Promise<readonly ModelTool[]>;
|
|
187
|
+
/** The turn's children as `wait` and `stop` reach them, by key or run id. */
|
|
188
|
+
waitable(): WaitableChildren;
|
|
189
|
+
/**
|
|
190
|
+
* Stop one of this turn's children, then return what `wait` returns for it once it ended: its
|
|
191
|
+
* answer so far, the files it wrote, the messages it did not read.
|
|
192
|
+
*/
|
|
193
|
+
stop(id: string, signal: AbortSignal): Promise<WaitForSubagentsOutput>;
|
|
194
|
+
/** The run a key names: this turn's child under it. A run id names itself. */
|
|
195
|
+
private childRunId;
|
|
184
196
|
/**
|
|
185
197
|
* Send a child a message, through the turn's mailbox. Its id names this turn, the model call and
|
|
186
198
|
* the tool call in it, so a replay of the call is the same message and the child reads it once,
|
|
@@ -234,6 +246,15 @@ export declare class SubagentCoordinator {
|
|
|
234
246
|
/** The open questions of the turn's children still at work, each with the child's key. */
|
|
235
247
|
private askingChildren;
|
|
236
248
|
spawn(input: SpawnSubagentInput, signal: AbortSignal): Promise<SpawnSubagentOutput>;
|
|
249
|
+
/**
|
|
250
|
+
* The runs these ids name. A run id names itself. A key names this turn's child under it, the one
|
|
251
|
+
* a spawn of this same step is admitting, or else the conversation's latest child under it, as
|
|
252
|
+
* `message_agent` finds one. Calls of one step run together, each starting once its call is
|
|
253
|
+
* published, so a wait may begin before the spawn beside it: a key that names nothing yet is
|
|
254
|
+
* looked up again a few times, a second at most. What is still missing the caller refuses.
|
|
255
|
+
*/
|
|
256
|
+
private resolveChildren;
|
|
257
|
+
private admitSpawn;
|
|
237
258
|
private admitInTurn;
|
|
238
259
|
/**
|
|
239
260
|
* What admission will answer, read before the files the child is handed: the child already
|
|
@@ -274,7 +295,7 @@ export declare class SubagentCoordinator {
|
|
|
274
295
|
private earlierTurnsOf;
|
|
275
296
|
/**
|
|
276
297
|
* Copy what each finished child wrote under `out/` into the parent's sandbox, once, and install
|
|
277
|
-
*
|
|
298
|
+
* the artifacts the children wrote in its `$SIXB_ARTIFACTS`, as the parent's own. A result holds at
|
|
278
299
|
* most the attachment limits of new files, a child's whole or not at all; a child that does not
|
|
279
300
|
* fit, or whose files cannot be copied, says so, and its files come with a later wait.
|
|
280
301
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subagent-tools.d.ts","sourceRoot":"","sources":["../src/subagent-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,cAAc,
|
|
1
|
+
{"version":3,"file":"subagent-tools.d.ts","sourceRoot":"","sources":["../src/subagent-tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,17 +1,30 @@
|
|
|
1
|
-
import type
|
|
2
|
-
import type { BackgroundCommands } from "../background-commands";
|
|
1
|
+
import { type ModelTool } from "@sixb/core/models";
|
|
2
|
+
import type { BackgroundCommandOutput, BackgroundCommands } from "../background-commands";
|
|
3
3
|
import type { AgentSandboxHandle } from "../sandbox-handle";
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
4
|
+
import type { WaitForSubagentsOutput } from "../subagent-tools";
|
|
5
|
+
/** Before `wait` and `stop`, a background command's tools: earlier threads hold calls to them. */
|
|
6
|
+
export declare const LEGACY_BACKGROUND_TOOLS: readonly ["bash_output", "bash_stop"];
|
|
7
|
+
/** Before `wait`, the Agent's wait for its children: earlier threads hold calls to it. */
|
|
8
|
+
export declare const LEGACY_WAIT_AGENT_TOOL = "wait_agent";
|
|
9
|
+
export declare const WAIT_TOOL_SPEC: {
|
|
10
|
+
readonly name: "wait";
|
|
11
|
+
readonly strict: true;
|
|
12
|
+
readonly description: string;
|
|
7
13
|
readonly inputSchema: {
|
|
8
14
|
type: string;
|
|
9
15
|
properties: {
|
|
10
|
-
|
|
16
|
+
ids: {
|
|
11
17
|
type: string;
|
|
18
|
+
minItems: number;
|
|
19
|
+
maxItems: number;
|
|
20
|
+
uniqueItems: true;
|
|
21
|
+
items: {
|
|
22
|
+
type: string;
|
|
23
|
+
minLength: number;
|
|
24
|
+
};
|
|
12
25
|
description: string;
|
|
13
26
|
};
|
|
14
|
-
|
|
27
|
+
timeoutMs: {
|
|
15
28
|
type: string;
|
|
16
29
|
description: string;
|
|
17
30
|
};
|
|
@@ -20,14 +33,16 @@ export declare const BASH_OUTPUT_TOOL_SPEC: {
|
|
|
20
33
|
additionalProperties: false;
|
|
21
34
|
};
|
|
22
35
|
};
|
|
23
|
-
export declare const
|
|
24
|
-
readonly name: "
|
|
25
|
-
readonly
|
|
36
|
+
export declare const STOP_TOOL_SPEC: {
|
|
37
|
+
readonly name: "stop";
|
|
38
|
+
readonly strict: true;
|
|
39
|
+
readonly description: "Stop work you started: a background command and all it started (SIGTERM, then SIGKILL after 3 s), or a child agent of this turn. Returns what wait would: how it ended, and its output or answer so far.";
|
|
26
40
|
readonly inputSchema: {
|
|
27
41
|
type: string;
|
|
28
42
|
properties: {
|
|
29
43
|
id: {
|
|
30
44
|
type: string;
|
|
45
|
+
minLength: number;
|
|
31
46
|
description: string;
|
|
32
47
|
};
|
|
33
48
|
};
|
|
@@ -35,16 +50,33 @@ export declare const BASH_STOP_TOOL_SPEC: {
|
|
|
35
50
|
additionalProperties: false;
|
|
36
51
|
};
|
|
37
52
|
};
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
53
|
+
/**
|
|
54
|
+
* The Agent's children, as `wait` and `stop` reach them: an id that names no background command
|
|
55
|
+
* names one of them, by its key or its run id.
|
|
56
|
+
*/
|
|
57
|
+
export interface WaitableChildren {
|
|
58
|
+
wait(ids: readonly string[], signal: AbortSignal): Promise<WaitForSubagentsOutput>;
|
|
59
|
+
stop(id: string, signal: AbortSignal): Promise<WaitForSubagentsOutput>;
|
|
60
|
+
}
|
|
61
|
+
/** What `wait` and `stop` return: the commands named, and the children's results. */
|
|
62
|
+
export interface WaitOutput extends Partial<Omit<WaitForSubagentsOutput, "files">> {
|
|
63
|
+
readonly commands?: readonly BackgroundCommandOutput[];
|
|
64
|
+
}
|
|
65
|
+
interface WaitToolInput {
|
|
66
|
+
readonly ids: readonly string[];
|
|
67
|
+
readonly timeoutMs?: number;
|
|
41
68
|
}
|
|
42
|
-
interface
|
|
69
|
+
interface StopToolInput {
|
|
43
70
|
readonly id: string;
|
|
44
71
|
}
|
|
45
|
-
/** `
|
|
46
|
-
export declare function
|
|
47
|
-
/** `
|
|
48
|
-
export declare function
|
|
72
|
+
/** `wait`: until the commands and children named end, a child asks, or the timeout passes. */
|
|
73
|
+
export declare function createWaitTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands, children?: WaitableChildren): ModelTool<WaitToolInput>;
|
|
74
|
+
/** `stop`: stop a command or a child, then report how it ended and its output or answer so far. */
|
|
75
|
+
export declare function createStopTool(resolveSandbox: () => Promise<AgentSandboxHandle>, commands: BackgroundCommands, children?: WaitableChildren): ModelTool<StopToolInput>;
|
|
76
|
+
/**
|
|
77
|
+
* The background commands a tool's result reports, as each read it: `bash` and the tools before
|
|
78
|
+
* `wait` report one, `wait` and `stop` those they name.
|
|
79
|
+
*/
|
|
80
|
+
export declare function reportedCommands(toolName: string, output: unknown): readonly unknown[];
|
|
49
81
|
export {};
|
|
50
82
|
//# sourceMappingURL=background.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/tools/background.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/tools/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACpG,OAAO,KAAK,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAQ/D,kGAAkG;AAClG,eAAO,MAAM,uBAAuB,uCAAwC,CAAA;AAE5E,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,eAAe,CAAA;AAElD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BjB,CAAA;AAEV,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CAiBjB,CAAA;AAEV;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAClF,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CACvE;AAED,qFAAqF;AACrF,MAAM,WAAW,UAAW,SAAQ,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;IAChF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAA;CACvD;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,SAAS,CAAC,aAAa,CAAC,CA6D1B;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,SAAS,CAAC,aAAa,CAAC,CAwB1B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,SAAS,OAAO,EAAE,CAOtF"}
|
package/dist/tools/bash.d.ts
CHANGED
|
@@ -4,6 +4,7 @@ import type { BackgroundCommands } from "../background-commands";
|
|
|
4
4
|
import type { AgentSandboxHandle } from "../sandbox-handle";
|
|
5
5
|
export declare const BASH_TOOL_SPEC: {
|
|
6
6
|
readonly name: "bash";
|
|
7
|
+
readonly strict: true;
|
|
7
8
|
readonly description: string;
|
|
8
9
|
readonly inputSchema: {
|
|
9
10
|
type: string;
|
package/dist/tools/bash.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAO3D,eAAO,MAAM,cAAc
|
|
1
|
+
{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACrE,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AACzE,OAAO,KAAK,EAA0B,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAExF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAO3D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjB,CAAA;AAEV,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,UAAU,EAAE,kBAAkB,GAC7B,SAAS,CAAC,aAAa,CAAC,CAoC1B;AAsED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAEvE;AAiBD,UAAU,cAAc;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAe7E"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The text half of `edit`: find `old` in a file, replace it, and describe the change as a unified
|
|
3
|
+
* diff, or say where to look when it does not match. No sandbox here, so it is tested on strings.
|
|
4
|
+
*/
|
|
5
|
+
export type EditTextResult = {
|
|
6
|
+
readonly ok: true;
|
|
7
|
+
readonly text: string;
|
|
8
|
+
readonly replaced: number;
|
|
9
|
+
readonly diff: string;
|
|
10
|
+
/** Lines the change adds and removes, all of them: the diff may be cut. */
|
|
11
|
+
readonly added: number;
|
|
12
|
+
readonly removed: number;
|
|
13
|
+
} | {
|
|
14
|
+
readonly ok: false;
|
|
15
|
+
readonly reason: string;
|
|
16
|
+
};
|
|
17
|
+
export declare function editText(text: string, input: {
|
|
18
|
+
readonly old: string;
|
|
19
|
+
readonly new: string;
|
|
20
|
+
readonly all: boolean;
|
|
21
|
+
}): EditTextResult;
|
|
22
|
+
//# sourceMappingURL=edit-text.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"edit-text.d.ts","sourceRoot":"","sources":["../../src/tools/edit-text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnD,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAC3E,cAAc,CAsChB"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import type { ModelTool } from "@sixb/core/models";
|
|
2
|
+
import type { AgentSandboxHandle } from "../sandbox-handle";
|
|
3
|
+
import { type FileReadLedger, type LoadedSandboxFile } from "./file-writes";
|
|
4
|
+
export declare const EDIT_TOOL_SPEC: {
|
|
5
|
+
readonly name: "edit";
|
|
6
|
+
readonly strict: true;
|
|
7
|
+
readonly description: "Replace text in a file. old_string must match the file exactly, once, unless replace_all is true. Read the file first: an edit refuses a file that changed since you read it. Returns the change as a diff, so there is no need to read the file again to check it.";
|
|
8
|
+
readonly inputSchema: {
|
|
9
|
+
type: string;
|
|
10
|
+
properties: {
|
|
11
|
+
path: {
|
|
12
|
+
type: string;
|
|
13
|
+
description: string;
|
|
14
|
+
};
|
|
15
|
+
old_string: {
|
|
16
|
+
type: string;
|
|
17
|
+
description: string;
|
|
18
|
+
};
|
|
19
|
+
new_string: {
|
|
20
|
+
type: string;
|
|
21
|
+
description: string;
|
|
22
|
+
};
|
|
23
|
+
replace_all: {
|
|
24
|
+
type: string;
|
|
25
|
+
description: string;
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
required: string[];
|
|
29
|
+
additionalProperties: false;
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
export interface EditToolInput {
|
|
33
|
+
readonly path: string;
|
|
34
|
+
readonly old_string: string;
|
|
35
|
+
readonly new_string: string;
|
|
36
|
+
readonly replace_all?: boolean;
|
|
37
|
+
}
|
|
38
|
+
export interface EditToolOutput {
|
|
39
|
+
readonly path: string;
|
|
40
|
+
readonly replaced: number;
|
|
41
|
+
/** Unified diff of the change, with line numbers; cut past a few thousand characters. */
|
|
42
|
+
readonly diff: string;
|
|
43
|
+
/** Lines the change adds and removes, all of them, however short the diff was cut. */
|
|
44
|
+
readonly added: number;
|
|
45
|
+
readonly removed: number;
|
|
46
|
+
}
|
|
47
|
+
export declare function createEditTool(resolveSandbox: () => Promise<AgentSandboxHandle>, ledger: FileReadLedger): ModelTool<EditToolInput>;
|
|
48
|
+
/** An existing file is changed only as the run last read or wrote it. */
|
|
49
|
+
export declare function assertReadAsIs(ledger: FileReadLedger, loaded: Extract<LoadedSandboxFile, {
|
|
50
|
+
kind: "file";
|
|
51
|
+
}>, path: string, tool: string): void;
|
|
52
|
+
export declare function objectInput(value: unknown, tool: string, keys: readonly string[]): Record<string, unknown>;
|
|
53
|
+
export declare function pathInput(value: unknown, tool: string): string;
|
|
54
|
+
//# sourceMappingURL=edit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAGvB,MAAM,eAAe,CAAA;AAEtB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAA;AAEV,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,EACjD,MAAM,EAAE,cAAc,GACrB,SAAS,CAAC,aAAa,CAAC,CA2C1B;AAED,yEAAyE;AACzE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EACpD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,IAAI,CAWN;AAyBD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9D"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { AgentToolPublicError } from "@sixb/core";
|
|
2
|
+
import { type AgentSandboxHandle } from "../sandbox-handle";
|
|
3
|
+
/** The largest file `edit` changes and `write` writes: a whole file passes through the harness. */
|
|
4
|
+
export declare const MAX_EDITED_FILE_BYTES: number;
|
|
5
|
+
/**
|
|
6
|
+
* What a run has read, by real path: the file's fingerprint (`cksum`: CRC and size) when it read
|
|
7
|
+
* it. `edit` and `write` change an existing file only when it is the file the run read, so a change
|
|
8
|
+
* made since, by the user, another process or the run's own `bash`, is never overwritten blind.
|
|
9
|
+
*/
|
|
10
|
+
export declare class FileReadLedger {
|
|
11
|
+
#private;
|
|
12
|
+
record(realPath: string, fingerprint: string): void;
|
|
13
|
+
get(realPath: string): string | undefined;
|
|
14
|
+
}
|
|
15
|
+
export type LoadedSandboxFile = {
|
|
16
|
+
readonly kind: "missing";
|
|
17
|
+
} | {
|
|
18
|
+
readonly kind: "file";
|
|
19
|
+
readonly realPath: string;
|
|
20
|
+
readonly fingerprint: string;
|
|
21
|
+
readonly bytes: Uint8Array;
|
|
22
|
+
};
|
|
23
|
+
/** Read a whole file for `edit` or `write`: where it really is, its fingerprint and its bytes. */
|
|
24
|
+
export declare function loadSandboxFile(handle: AgentSandboxHandle, input: {
|
|
25
|
+
readonly path: string;
|
|
26
|
+
readonly tool: string;
|
|
27
|
+
readonly signal: AbortSignal;
|
|
28
|
+
}): Promise<LoadedSandboxFile>;
|
|
29
|
+
/**
|
|
30
|
+
* Write `bytes` to `path` when the file there is still `expected` (a fingerprint, or `missing`
|
|
31
|
+
* for a file to create), keeping an existing file's mode. Missing parent directories are created
|
|
32
|
+
* inside the run's roots. Returns where the file is and its new fingerprint.
|
|
33
|
+
*/
|
|
34
|
+
export declare function commitSandboxFile(handle: AgentSandboxHandle, input: {
|
|
35
|
+
readonly path: string;
|
|
36
|
+
readonly expected: string;
|
|
37
|
+
readonly bytes: Uint8Array;
|
|
38
|
+
readonly tool: string;
|
|
39
|
+
readonly signal: AbortSignal;
|
|
40
|
+
}): Promise<{
|
|
41
|
+
readonly realPath: string;
|
|
42
|
+
readonly fingerprint: string;
|
|
43
|
+
}>;
|
|
44
|
+
export declare function publicError(tool: string, message: string): AgentToolPublicError;
|
|
45
|
+
export declare function isFingerprint(value: string): boolean;
|
|
46
|
+
/**
|
|
47
|
+
* Bash functions shared with `read`: a file's fingerprint as `crc:size` from `cksum`, and a real
|
|
48
|
+
* path on one line (empty when the path holds a newline, which then goes unrecorded). Neither
|
|
49
|
+
* needs `tr` or `awk`, which some sandbox images lack.
|
|
50
|
+
*/
|
|
51
|
+
export declare const FINGERPRINT_FUNCTIONS = "fingerprint() {\n local sum rest\n sum=\"$(cksum < \"$1\")\" || return 1\n rest=\"${sum#* }\"\n printf '%s:%s\\n' \"${sum%% *}\" \"${rest%% *}\"\n}\nprint_path() {\n case \"$1\" in *$'\\n'*) printf '\\n' ;; *) printf '%s\\n' \"$1\" ;; esac\n}";
|
|
52
|
+
//# sourceMappingURL=file-writes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"file-writes.d.ts","sourceRoot":"","sources":["../../src/tools/file-writes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAA;AAErE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AAExE,mGAAmG;AACnG,eAAO,MAAM,qBAAqB,QAAc,CAAA;AAShD;;;;GAIG;AACH,qBAAa,cAAc;;IAGzB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAInD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAG1C;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAC3B,CAAA;AAEL,kGAAkG;AAClG,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACpF,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B,GACA,OAAO,CAAC;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAE/E;AAqDD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,4PAQhC,CAAA"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"model-spec.d.ts","sourceRoot":"","sources":["../../src/tools/model-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;
|
|
1
|
+
{"version":3,"file":"model-spec.d.ts","sourceRoot":"","sources":["../../src/tools/model-spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAUhE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,aAAa,EAAE,EACtC,OAAO,GAAE;IACP,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACzC,GACL,SAAS,aAAa,EAAE,CAa1B;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CACxB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,aAAa,EAAE,oBAAoB,GAAG,SAAS,GAC9C,OAAO,CAET"}
|
package/dist/tools/read.d.ts
CHANGED
|
@@ -1,8 +1,11 @@
|
|
|
1
1
|
import type { ModelTool } from "@sixb/core/models";
|
|
2
2
|
import { type AgentSandboxHandle } from "../sandbox-handle";
|
|
3
|
+
import { type FileReadLedger } from "./file-writes";
|
|
4
|
+
import { type SandboxFileViewer } from "./view-file";
|
|
3
5
|
export declare const READ_TOOL_SPEC: {
|
|
4
6
|
readonly name: "read";
|
|
5
|
-
readonly
|
|
7
|
+
readonly strict: true;
|
|
8
|
+
readonly description: "Read a file, or list a directory. Text comes as at most 2,000 lines or 50 KiB, with nextOffset when more remains; an image or a PDF comes as itself; a directory as its entries, folders ending in /. Prefer this over bash for reading files.";
|
|
6
9
|
readonly inputSchema: {
|
|
7
10
|
type: string;
|
|
8
11
|
properties: {
|
|
@@ -30,6 +33,12 @@ export interface ReadToolInput {
|
|
|
30
33
|
readonly offset?: number;
|
|
31
34
|
readonly limit?: number;
|
|
32
35
|
}
|
|
36
|
+
/** A directory's entries, names only, folders ending in `/`. */
|
|
37
|
+
export interface ReadDirectoryOutput {
|
|
38
|
+
readonly path: string;
|
|
39
|
+
readonly entries: readonly string[];
|
|
40
|
+
readonly truncated?: true;
|
|
41
|
+
}
|
|
33
42
|
export interface ReadToolOutput {
|
|
34
43
|
readonly path: string;
|
|
35
44
|
readonly content: string;
|
|
@@ -38,6 +47,10 @@ export interface ReadToolOutput {
|
|
|
38
47
|
readonly truncated: boolean;
|
|
39
48
|
readonly nextOffset?: number;
|
|
40
49
|
}
|
|
41
|
-
/** Build the
|
|
42
|
-
export declare function createReadTool(resolveSandbox: () => Promise<AgentSandboxHandle
|
|
50
|
+
/** Build the reader from the run's lazy sandbox resolver. */
|
|
51
|
+
export declare function createReadTool(resolveSandbox: () => Promise<AgentSandboxHandle>,
|
|
52
|
+
/** Where each read is recorded, so `edit` and `write` change only a file the run has read. */
|
|
53
|
+
ledger?: FileReadLedger,
|
|
54
|
+
/** Shows images, PDFs and other files that are not text; without it, they are refused. */
|
|
55
|
+
viewer?: SandboxFileViewer): ModelTool<ReadToolInput>;
|
|
43
56
|
//# sourceMappingURL=read.d.ts.map
|
package/dist/tools/read.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAGzE,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAyB,KAAK,cAAc,EAAiB,MAAM,eAAe,CAAA;AACzF,OAAO,EAAsB,KAAK,iBAAiB,EAAmB,MAAM,aAAa,CAAA;AAUzF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAuBjB,CAAA;AAEV,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,CAC5B,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC;AACjD,8FAA8F;AAC9F,MAAM,CAAC,EAAE,cAAc;AACvB,0FAA0F;AAC1F,MAAM,CAAC,EAAE,iBAAiB,GACzB,SAAS,CAAC,aAAa,CAAC,CA2E1B"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-files.d.ts","sourceRoot":"","sources":["../../src/tools/tool-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAA;
|
|
1
|
+
{"version":3,"file":"tool-files.d.ts","sourceRoot":"","sources":["../../src/tools/tool-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAyB,cAAc,EAAE,MAAM,YAAY,CAAA;AAGtF,OAAO,EACL,oBAAoB,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAI/B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;IACpD,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAA;IACjC,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,0EAA0E;AAC1E,qBAAa,eAAe;;IAQd,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,SAAwB;IAMrD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,oBAAoB;IAQ9D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO1C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,+FAA+F;IAC/F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUtE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAQrC;AAED,cAAM,oBAAoB;;IAMtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,MAAM,EAAE,eAAe,EACxC,KAAK,EAAE,MAAM,EACI,QAAQ,EAAE,MAAM;IAKnC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKxB,gGAAgG;IAChG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,IAAI,IAAI;CAMhB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,cAAc,CAyBrF;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAC5C,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC1D,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;CACrD,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB"}
|
|
@@ -1,29 +1,15 @@
|
|
|
1
1
|
import type { AgentToolFiles, JsonValue } from "@sixb/core";
|
|
2
|
-
import type { ModelTool } from "@sixb/core/models";
|
|
3
2
|
import type { PreparedAgentAttachmentContext } from "../attachments";
|
|
4
3
|
import type { AgentSandboxFileRegistry } from "../sandbox-file-registry";
|
|
5
4
|
import type { AgentSandboxHandle } from "../sandbox-handle";
|
|
6
5
|
import type { AgentToolModelOutput } from "./result-output";
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
type: string;
|
|
15
|
-
minLength: number;
|
|
16
|
-
};
|
|
17
|
-
};
|
|
18
|
-
required: string[];
|
|
19
|
-
additionalProperties: false;
|
|
20
|
-
};
|
|
21
|
-
};
|
|
22
|
-
interface ViewFileInput {
|
|
23
|
-
readonly path: string;
|
|
24
|
-
}
|
|
25
|
-
export declare function createViewFileTool(input: {
|
|
26
|
-
readonly resolveSandbox: () => Promise<AgentSandboxHandle>;
|
|
6
|
+
/**
|
|
7
|
+
* What `read` took over: earlier threads hold calls to `view_file`, and their results replay as
|
|
8
|
+
* they were stored, images included.
|
|
9
|
+
*/
|
|
10
|
+
export declare const LEGACY_VIEW_FILE_TOOL = "view_file";
|
|
11
|
+
/** What `read` needs to show a file as itself, an image or a PDF, rather than as text. */
|
|
12
|
+
export interface SandboxFileViewer {
|
|
27
13
|
readonly attachments: PreparedAgentAttachmentContext;
|
|
28
14
|
readonly registry: AgentSandboxFileRegistry;
|
|
29
15
|
readonly filesForToolCall: (options: {
|
|
@@ -35,6 +21,17 @@ export declare function createViewFileTool(input: {
|
|
|
35
21
|
readonly signal: AbortSignal;
|
|
36
22
|
readonly toolCallId: string;
|
|
37
23
|
}) => AgentToolModelOutput | Promise<AgentToolModelOutput>;
|
|
38
|
-
}
|
|
39
|
-
|
|
24
|
+
}
|
|
25
|
+
/**
|
|
26
|
+
* A sandbox file as a rich result: the file itself, stored with the call, which the run's media
|
|
27
|
+
* bridge shows the model as an image or a document when it can, and as metadata otherwise. An
|
|
28
|
+
* attachment, or a file a tool stored, is the snapshot it already is.
|
|
29
|
+
*/
|
|
30
|
+
export declare function viewSandboxFile(viewer: SandboxFileViewer, handle: AgentSandboxHandle, input: {
|
|
31
|
+
readonly path: string;
|
|
32
|
+
readonly toolCallId: string;
|
|
33
|
+
readonly signal: AbortSignal;
|
|
34
|
+
}): Promise<JsonValue>;
|
|
35
|
+
/** Whether `path` names an attachment or a file a tool stored, which `read` shows as itself. */
|
|
36
|
+
export declare function isKnownSandboxFile(viewer: SandboxFileViewer, handle: AgentSandboxHandle, path: string): boolean;
|
|
40
37
|
//# sourceMappingURL=view-file.d.ts.map
|