@buildaharness/aielia 0.3.8 → 0.3.10

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/_memory-core-generated.d.ts

@@ -1762,3 +1762,9 @@ export declare const INV16: {
     readonly neverPromotable: readonly ["agent", "tool", "web"];
     readonly neverReturnedTiers: readonly ["procedural", "commitment"];
 };
+export declare const MEMORY_EVENT_STORE_KEY: "memory:events";
+export declare const MEMORY_EVENT_KEEP: 500;
+export declare const MEMORY_EVENT_KINDS: readonly ["promote", "decline", "correct", "contradict", "supersede", "retire", "forget", "expire", "restore", "recall"];
+export declare const MEMORY_REASON_CODES: readonly ["user_stated", "user_corrected", "user_confirmed", "user_rejected", "inferred_high_conf", "inferred_pending_confirmation", "inferred_low_conf_session_only", "conflicts_with_fact", "superseded_by_newer", "explicit_forget", "retention_expired", "gate_blocked_secret", "gate_blocked_instruction", "duplicate"];
+export declare const MEMORY_SOURCE_TYPES: readonly ["user_message", "assistant_message", "tool_result", "prior_fact", "user_command"];
+export declare const MEMORY_DECIDED_BY: readonly ["user", "classifier", "reviewer", "consolidation", "rule"];

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.
      *

package/dist/assistant.d.ts

@@ -6,9 +6,11 @@ import { WebToolsContext } from './web-tools.js';
 import { ShellToolsContext } from './shell-tools.js';
 import { ActionToolsContext } from './action-tools.js';
 import { SpendCapConfig, SpendState } from './spend-cap.js';
+import { WriterChatPort } from './writer/writer-chat-turn.js';
 import { TraceEvent } from './trace-events.js';
 import { AssistantToolStep } from './tool-step.js';
 import { MemoryService, MemorySummary, MemoryExport, AuditEntry, MemoryStatus, MemoryInjection, ConsolidationOutcome } from './memory-service.js';
+import { EventFilter, MemoryEvent } from './memory-events.js';
 import { MemoryWriteMode } from './memory-governance.js';
 import { ConsolidationProposal } from './memory-consolidation.js';
 import { UserFact } from './fact-extraction.js';
@@ -233,6 +235,12 @@ export interface PersonalAssistantOptions {
      * Off by default.
      */
     dangerouslySkipPermissions?: boolean;
+    /**
+     * Aielia Write (T13): when set, each writer message is read for reviewer comments, decisions and corrections to sources, the result is
+     * stored per article through this port (not per session), and the open items of the active article are added to the system prompt
+     * on every turn. Unset (every other caller) means none of this runs. See plans/aielia_write_article_model_plan.html, section 8.
+     */
+    writerChat?: WriterChatPort;
     /**
      * Opt-in session spend/turn-count ceilings — see spend-cap.ts. Undefined by default, same as
      * every other field here that changes behavior only when a caller sets it: no ceiling means
@@ -323,6 +331,7 @@ export declare class PersonalAssistant {
     private readonly onTrace?;
     private readonly onDebugLog?;
     private readonly dangerouslySkipPermissions;
+    private readonly writerChat;
     /** Whenever any of fileTools/webTools/shellTools is configured, `turn()` routes through AgentLoop instead of a single plain chat call — computed once here since it never changes for the lifetime of an instance. */
     private readonly toolLoopWillRun;
     /** R3 of the internal plan — mirrors the same flag HarnessBridge was given at construction, kept here too so runTurn can decide whether to defer the tool loop into a harness-driven proposer instead of precomputing draftReply. See PersonalAssistantOptions.oneLoopMode's doc comment. */
@@ -555,6 +564,8 @@ export declare class PersonalAssistant {
     forgetFact(selector: string, sessionId: string, erase?: boolean): Promise<MemoryPendingOutcome>;
     /** `/memory history` — the newest audit-log entries (M2). Empty unless `AUDIT_MEMORY_AUDIT_LOG` is on. */
     memoryHistory(limit?: number): Promise<AuditEntry[]>;
+    /** `/memory history events [fact]` — transition events with reason and sources (`AUDIT_MEMORY_EVENTS`, default on). */
+    memoryEvents(limit?: number, filter?: EventFilter): Promise<MemoryEvent[]>;
     /** `/memory undo <seq>` — restores the pre-image of one audit entry (M2). */
     undoMemoryChange(selector: string, sessionId: string): Promise<{
         ok: boolean;