Harness spec 1.1.0: one plan, prototypes and the library shared; the CLI implements it
The spec: plan_write and plan_update (new, shared, offered in every mode) and plan_submit (now shared) keep one structured plan — findings, objectives, phases of tasks — in place of the todo list, which lives on as a former name of plan_write. The shared system text is one text for both projects, with variables for what differs; the mode texts, a prototypes block and a library block are shared. acp.md: the client hands the device what only it knows (context, library, prototypes), the plan travels as a structure (plan_state), library calls carry the chat's scope, and a client may rewind a session. loop.json says its numbers as numbers. Four conformance areas: plan, prototype, library_scope, toolcall_index. The CLI: the plan is kept per session in the store and drawn above the prompt and on the approval card; the prompt is assembled from the spec's texts with their variables filled; the link reads the instance's instructions, personalization, knowledge scope and prototype offer, sends the plan as a structure and answers rewind; library calls to the instance carry the session as scope; a prototype written in the terminal is saved as a file and named in the transcript; a tool-call fragment without an index continues the last call; the default theme is Moria; dead exports and Hermes leftovers removed. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
96 files changed
+3259
-527
No files matched your search
+11
-5
@@ -20,7 +20,7 @@ export interface ToolContext {
|
||||
/** Instruction files (AGENTS.md / CLAUDE.md) the model has already been given. */
|
||||
instructionsSeen?: Set<string>
|
||||
/** Ask the user questions (the ask_user tool). Absent where nobody can answer. */
|
||||
question?: (req: import("./question.ts").QuestionRequest, callId?: string) => Promise<import("./question.ts").QuestionReply>
|
||||
question?: (req: import("./ask_user.ts").QuestionRequest, callId?: string) => Promise<import("./ask_user.ts").QuestionReply>
|
||||
/** Run a subagent (the task tool). Absent inside a subagent: no recursion. */
|
||||
spawn?: (agent: string, prompt: string, signal: AbortSignal, callId?: string, opts?: { worktree?: boolean; description?: string; model?: string }) => Promise<import("./task.ts").SubagentResult>
|
||||
/** The id of the call being run (set by the engine per call). */
|
||||
@@ -29,8 +29,13 @@ export interface ToolContext {
|
||||
projectDir?: string
|
||||
/** The plans directory (plan mode writes only there). */
|
||||
planDir?: string
|
||||
/** Present a plan for approval (plan_submit). Absent where nobody can answer. */
|
||||
plan?: (req: { path: string; text: string }, callId?: string) => Promise<import("./plan_exit.ts").PlanReply>
|
||||
/** The session's plan (plan_write, plan_update, plan_submit): read it, replace it (null clears),
|
||||
* and present it for approval — `ask` is absent where nobody can answer. */
|
||||
plan?: {
|
||||
get(): import("../plan/plan.ts").Plan | undefined
|
||||
set(plan: import("../plan/plan.ts").Plan | null): void
|
||||
ask?: (req: import("./plan_submit.ts").PlanRequest, callId?: string) => Promise<import("./plan_submit.ts").PlanReply>
|
||||
}
|
||||
/** Change the permission mode (plan_submit, on approval). */
|
||||
setMode?: (mode: import("../config/schema.ts").Mode) => void
|
||||
/** Web search and fetch settings (config `search:`). */
|
||||
@@ -50,6 +55,9 @@ export interface ToolContext {
|
||||
set(key: string, value: unknown, scope?: import("../config/settings.ts").Scope): import("../settings.ts").SetResult
|
||||
models(): string[]
|
||||
}
|
||||
/** The scope sent on every call to the instance's library (`_meta.lembas.scope`, harness/acp.md):
|
||||
* the session's id, where the client has said what the session may search. */
|
||||
libraryScope?: string
|
||||
/** The library: notes, and the knowledge bases this project searches (all, when
|
||||
* `bases` is undefined); `project` is the scope of this project's notes. */
|
||||
library?: {
|
||||
@@ -58,8 +66,6 @@ export interface ToolContext {
|
||||
bases?: string[]
|
||||
embedder?: import("../library/store.ts").Embedder
|
||||
}
|
||||
/** The session's todo list (the todo tool). */
|
||||
todos?: { items: import("./todo.ts").Todo[]; changed?: (items: import("./todo.ts").Todo[]) => void }
|
||||
}
|
||||
|
||||
export interface ToolResult {
|
||||
|
||||
Reference in new issue
Block a user