@webappwiz/arbor 0.0.25 → 0.0.27

package/reply.d.ts

@@ -1,102 +0,0 @@
-import { type Logger } from "webappwiz/log";
-import type { Fs } from "webappwiz/system";
-import type { Attachment } from "./attachments.js";
-import { type Question } from "./plan.js";
-import { type Replies, type ReplyState } from "./replies.js";
-import type { Todos } from "./todo.js";
-import type { WorktreeService } from "./worktree-service.js";
-export type { Attachment } from "./attachments.js";
-/** What answering, and reading an answer, work with. */
-export interface ReplyDeps {
-    service: WorktreeService;
-    fs: Fs;
-    replies: Replies;
-}
-export interface ReplyInput {
-    /** Words, alongside the picks or instead of them. */
-    text: string;
-    /**
-     * The keys of the choices picked (`b`), for a question that offers them:
-     * at most one for a `- (a)` question, any number for a `- [a]` one.
-     */
-    choices?: string[];
-    /** Files of any kind to add. */
-    files?: Attachment[];
-    /**
-     * Which files an earlier reply attached to keep, by path. Absent keeps
-     * none: a new reply replaces the old one whole.
-     */
-    keep?: string[];
-}
-export interface Replied {
-    task: string;
-    /** The question as the plan asks it. */
-    question: Question;
-    /** The reply, waiting for its agent to claim it. */
-    reply: ReplyState;
-}
-/**
- * Answers one of a task's questions, or follows up one whose answer its agent
- * has read. The reply waits under `.git/arbor/replies/<task>/` with its files,
- * not in the plan, and replaces any earlier one there, until the task's agent
- * claims it with `arbor replies` or `arbor wait --answered`. Until then it can
- * be changed or withdrawn; after, it is the agent's, and anything more is
- * another follow-up.
- *
- * Refuses a tree whose agent is in a live session. That agent is not reading
- * its inbox, it is waiting in its chat, which is where the answer belongs.
- */
-export declare function replyTo(deps: ReplyDeps, task: string, question: string, { text, choices, files, keep }: ReplyInput): Promise<Replied>;
-/**
- * Takes back a reply its agent has not claimed yet, files and all: the
- * question waits on a person again.
- */
-export declare function withdrawReply(deps: ReplyDeps, task: string, question: string): Promise<Replied>;
-/**
- * Holds a reply for a person editing it, so its agent cannot claim it
- * half-changed. The hold lapses on its own (`EDIT_MS`) if the person walks
- * away; saving or `releaseReply` ends it sooner. Refuses one its agent has
- * already claimed: that is the moment it stops being editable.
- */
-export declare function holdReply(deps: ReplyDeps, task: string, question: string): Promise<Replied>;
-/** Lets go of a reply a person was editing, leaving it as it was. */
-export declare function releaseReply({ replies }: {
-    replies: Replies;
-}, task: string, question: string): Promise<void>;
-export interface Claimed {
-    task: string;
-    /**
-     * The questions whose replies or follow-ups were claimed, as the plan now
-     * reads them.
-     */
-    claimed: Question[];
-    /** Questions with a reply a person is still editing: not yet readable. */
-    editing: string[];
-    /** Open questions with no reply at all. */
-    unanswered: string[];
-}
-/**
- * What the task's agent does to read its replies: every one waiting and not
- * being edited is written into the plan after ` → `, where the agent reads
- * it, and from then on belongs to the agent. The files stay where they are,
- * named by path in the line, until the task goes.
- */
-export declare function claimReplies(deps: ReplyDeps, task: string): Promise<Claimed>;
-/** `arbor replies`: claims the task's replies and prints them. */
-export declare function readReplies(deps: ReplyDeps & {
-    log: Logger;
-}, task: string): Promise<Claimed>;
-/** What claiming found: the replies now in the plan, and what still waits. */
-export declare function claimedListing({ task, claimed, editing, unanswered, }: Claimed): string;
-/** What a person says to approve a review: the task may land. */
-export declare const APPROVED = "Approved: merge it.";
-/** What a person says to a question they would rather not answer here. */
-export declare const SKIP = "Skip this: go ahead without it.";
-/**
- * Answers a question by setting it aside: it becomes a todo, its images
- * carried along since the tree they sit in goes when the task does, and the
- * reply tells the agent to leave it out of this task.
- */
-export declare function defer(deps: ReplyDeps & {
-    todos: Todos;
-}, task: string, question: string): Promise<Replied>;