@buildaharness/aielia 0.3.8 → 0.3.9

package/README.md

@@ -670,8 +670,10 @@ Set `ASSISTANT_ENABLE_WEB=1` (plus `BRAVE_SEARCH_API_KEY`) to give the model
 real `web_search`/`fetch_url` tools (no approval needed — see "Web access via
 tools" above) and `ASSISTANT_ENABLE_SHELL=1` to give it a real, approval-gated
 `run_shell_command` tool scoped to `ASSISTANT_WORKSPACE_DIR`. Both are off by
-default; `ASSISTANT_ENABLE_SHELL` must be exactly `"1"` (a stray
-`ASSISTANT_ENABLE_SHELL=0` left in an env file does not enable it). Optional
+default. Every on/off variable (`ASSISTANT_ENABLE_WEB`, `ASSISTANT_ENABLE_SHELL`,
+`ASSISTANT_ENABLE_EMAIL`, `ASSISTANT_DANGEROUSLY_SKIP_PERMISSIONS`) takes `1` or `true` for on and `0` or
+`false` for off; any other value (`yes`, `True`) is treated as off, with a warning that names the variable
+(a stray `ASSISTANT_ENABLE_SHELL=0` left in an env file does not enable it). Optional
 `ASSISTANT_SHELL_TIMEOUT_MS` (default 30000) tunes the shell timeout:
 
 ```bash
@@ -944,9 +946,10 @@ ends the session.
 | `/model [name]` | Show the active model, or switch it — a thin alias over `/config set model <name>` (see "Configuration" above); rejected the same way if `model` is pinned by `ASSISTANT_MODEL` |
 | `/cost` | Show token usage for the last turn and the running session total |
 | `/doctor` | Check proxy reachability (proxy backend) or the `claude` binary (claude-cli backend), plus workspace root and data dir health — no dedicated check yet for the anthropic/openai/openrouter backends, only the backend-agnostic checks run for those |
-| `/why` | Explain the harness path the last turn took (verification confidence + node sequence) |
+| `/why` | Explain the last turn: confidence, whether the reply was checked against what was read, the layers that fired, and what memory the prompt held. The chat app (web and desktop) answers the same command with the same lines |
 | `/layers` | Show all 11 harness layers: fired or skipped, and why, for the last turn. `/layers settings` lists the reasoning layers with their cost/evidence; `/layers on\|off\|reset <id>` changes a layer's persisted on/off choice (an operator-set `AUDIT_*` env flag wins and shows as pinned) |
 | `/sources` | List files/URLs the last turn actually consulted |
+| `/steps` | List the tool calls the last turn made, in order |
 | `/plan` | Show the active structured plan's task status |
 | `/plan sketch <request>` | One-shot, advisory plan sketch: no plan record, nothing staged, cannot execute |
 | `/goals` | Review every known goal thread this session: status, tasks and visibility (freshly computed, carried over, done, suggested) |

package/dist/action-approval-service.d.ts

@@ -51,6 +51,8 @@ export declare class ActionApprovalService {
     }[];
     /** Sessions in which a command got the network-containment refusal. */
     private readonly networkDeniedSessions;
+    /** Per session: where in appliedActions the actions of the request now being approved begin (see resolvePendingActionOnce). */
+    private readonly chainStartBySession;
     /** Pending-action ids currently being resolved (see resolvePendingAction). */
     private readonly inFlightResolutions;
     networkDenied(sessionId: string): boolean;

package/dist/ask-draft.d.ts

@@ -0,0 +1,22 @@
+import { AskAnswer, AskQuestion, AskQuestionOption } from '@buildaharness/harness';
+/**
+ * One question's in-progress answer, shared by the CLI's text prompt and AskQuestionCard.tsx. Kept
+ * separate from AskAnswer itself so a user can flip between picking an option and typing free text
+ * without losing whichever they touched last; draftToAnswer collapses it to the wire shape.
+ */
+export interface QuestionDraft {
+    selectedLabels: string[];
+    editText: string;
+    freeText: string;
+    /**
+     * Only the card sets this: it hides the note field without clearing the text, so `false` means "ignore
+     * editText". Left unset (the CLI, which only fills editText through its explicit `e<n>` command), a
+     * non-empty editText counts.
+     */
+    showEdit?: boolean;
+}
+export declare function emptyDraft(): QuestionDraft;
+/** Recommended option(s) first, stable otherwise, so the same question lists its options in the same order on every surface. */
+export declare function orderedOptions(question: AskQuestion): AskQuestionOption[];
+/** Collapses one question's draft into the wire AskAnswer shape, or null while still unanswered (INV-28). */
+export declare function draftToAnswer(questionId: string, draft: QuestionDraft): AskAnswer | null;

package/dist/assistant-options.d.ts

@@ -0,0 +1,35 @@
+import { PersonalAssistantOptions } from './assistant.js';
+import { AssistantConfig } from './config.js';
+/** Which of the config-derived options a surface passes at all. A surface that leaves one off gets PersonalAssistant's default for it. */
+export interface AssistantFeatures {
+    spendCap: boolean;
+    ambiguityGuard: boolean;
+    /** Passes `config.activeProject`, falling back to `platform.workspaceRoot`. */
+    activeProject: boolean;
+    consolidateOnNewSession: boolean;
+}
+/** What only the surface can supply: its LLM client, storage, tools and logging, plus which optional features it enables. */
+export interface AssistantPlatform {
+    llmClient: NonNullable<PersonalAssistantOptions['llmClient']>;
+    memory?: PersonalAssistantOptions['memory'];
+    experienceStore?: PersonalAssistantOptions['experienceStore'];
+    checkpointStore?: PersonalAssistantOptions['checkpointStore'];
+    reminderStore?: PersonalAssistantOptions['reminderStore'];
+    fileTools?: PersonalAssistantOptions['fileTools'];
+    shellTools?: PersonalAssistantOptions['shellTools'];
+    webTools?: PersonalAssistantOptions['webTools'];
+    actionTools?: PersonalAssistantOptions['actionTools'];
+    onDebugLog?: PersonalAssistantOptions['onDebugLog'];
+    /** Default project when `config.activeProject` is unset (only used when `features.activeProject`). */
+    workspaceRoot?: string;
+    features: AssistantFeatures;
+}
+/** What each surface enables. The parity test snapshots the keys each preset passes. */
+export declare const CLI_FEATURES: AssistantFeatures;
+export declare const DESKTOP_FEATURES: AssistantFeatures;
+export declare const WEB_FEATURES: AssistantFeatures;
+/**
+ * The PersonalAssistant.create options derived from AssistantConfig, built once for every surface. Keys a
+ * surface leaves unset are omitted rather than passed as undefined, so PersonalAssistant's defaults apply.
+ */
+export declare function buildAssistantOptions(config: AssistantConfig, platform: AssistantPlatform): PersonalAssistantOptions;

package/dist/assistant-session.d.ts

@@ -93,7 +93,7 @@ export declare class AssistantSession {
     }>;
     /**
      * Called once per successfully completed ('ok') turn — counts turns, not raw internal LLM
-     * calls (see SpendCapConfig's doc comment for why). Estimates cost the same way cli.ts's
+     * calls (see SpendCapConfig's doc comment for why). Estimates cost the same way turn-cost.ts's
      * withCostEstimate does for a backend that doesn't report a real costUsd, so the cap enforces
      * against the same number /cost displays, not a second cost model.
      *