@buildaharness/aielia 0.3.8 → 0.3.9

package/dist/turn-cost.d.ts

@@ -0,0 +1,12 @@
+import { TokenUsage } from '@buildaharness/runtime';
+/**
+ * Adds a static-table cost estimate to a turn's usage. claude-cli (total_cost_usd) and openrouter
+ * (usage.cost) report a real dollar cost, and a real `costUsd` is never overwritten; every other
+ * case (proxy, anthropic, openai: token counts only) gets an approximate estimate, see model-pricing.ts.
+ * The model is `model`, else the backend's own default, else the Anthropic default. One function for the
+ * CLI's /cost, the apps' cost line and the spend cap, so they cannot disagree.
+ */
+export declare function withCostEstimate(usage: TokenUsage, { backend, model }: {
+    backend?: string;
+    model?: string;
+}): TokenUsage;

package/dist/turn-presentation.d.ts

@@ -0,0 +1,86 @@
+import { AskQuestion } from '@buildaharness/harness';
+import { AssistantTurnResult } from './assistant-types.js';
+import { NextStepSuggestion } from './next-step-proposer.js';
+/**
+ * What to show for a finished turn, decided once for every surface. The CLI prints it and chat-ui renders it as
+ * cards; neither re-reads the status branches of AssistantTurnResult. Hints are data, not formatted strings,
+ * because the CLI prints them inline and the apps render them as elements.
+ */
+export declare const DEFAULT_APPROVAL_REASON = "This action needs approval.";
+export declare const DEFAULT_ESCALATION_REASON = "Aielia halted and needs more information.";
+export declare const DEFAULT_CLARIFICATION_REASON = "This request needs clarification.";
+export declare const MISSING_PLAN_APPROVAL_ID_REASON = "A plan is awaiting approval, but its approval id is missing.";
+type PendingActionKind = NonNullable<AssistantTurnResult['pendingActionKind']>;
+/** Label and question for a staged action's approval. No kind means a plain write (the original, default pause). */
+export declare function approvalLabels(kind: PendingActionKind | undefined): {
+    kindLabel: string;
+    promptText: string;
+};
+/** The "No harness trace" explanations for /why and /layers, one place so every surface words each case the same. */
+export declare const NO_TRACE: {
+    readonly fastPath: "No harness trace — the last turn was a simple, self-contained question answered directly without activating the harness (fast path).";
+    readonly stagedAction: (kindLabel: string, resolution?: "approved" | "declined") => string;
+    readonly messageApproval: (resolution?: "approved" | "declined") => string;
+    readonly planApproval: (resolution?: "approved" | "declined", pendingHint?: string) => string;
+    readonly clarification: (unanswerableReason?: string) => string;
+    readonly escalated: (reason: string | undefined) => string;
+    readonly stopped: "No harness trace — the last turn was stopped before it finished.";
+    readonly failed: "No harness trace — the last turn failed with an error.";
+};
+export interface TurnHints {
+    /** Number of sources the turn consulted (shown as "N sources — /sources"). */
+    sourcesCount?: number;
+    /** Plan completion, 0–100, when a plan is active. */
+    planCompletionPct?: number;
+    contradictionNotice?: string;
+    reviewNotice?: string;
+    auditNotice?: string;
+    /** Set when a turn was paused part-way; appended after the streamed reply. */
+    pausedNote?: string;
+    nextSteps?: NextStepSuggestion[];
+}
+export type TurnPresentation = {
+    kind: 'reply';
+    text: string;
+    riskLevel?: AssistantTurnResult['riskLevel'];
+    hints: TurnHints;
+    noTraceReason?: string;
+} | {
+    kind: 'approval';
+    /** 'action': a staged write/shell/email/batch/revert (resume with pendingActionId). 'message': the message-level risk gate. */
+    scope: 'action' | 'message';
+    reason: string;
+    riskLevel?: AssistantTurnResult['riskLevel'];
+    pendingActionId?: string;
+    pendingActionKind?: PendingActionKind;
+    kindLabel?: string;
+    promptText?: string;
+    noTraceReason: string;
+} | {
+    kind: 'clarification';
+    questions: AskQuestion[];
+    pendingClarificationId: string;
+    riskLevel?: AssistantTurnResult['riskLevel'];
+    noTraceReason: string;
+} | {
+    kind: 'plan_approval';
+    planApprovalId: string;
+    /** Absent when the harness staged a plan but did not hand over its tasks; a surface that needs them to render may treat that as an escalation. */
+    planApproval?: AssistantTurnResult['planApproval'];
+    reason?: string;
+    riskLevel?: AssistantTurnResult['riskLevel'];
+    noTraceReason: string;
+} | {
+    kind: 'escalation';
+    reason: string;
+    noTraceReason: string;
+} | {
+    kind: 'cancelled';
+    noTraceReason: string;
+};
+/**
+ * Maps a turn result to what every surface shows. `pendingActionId` on the *request* (a resumed staged action)
+ * is the surface's business, not this function's: a resumed turn's result is still presented as a reply.
+ */
+export declare function presentTurnResult(result: AssistantTurnResult): TurnPresentation;
+export {};

package/dist/undo-action-command.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `/undo-action [id]` for every surface: no argument lists the revertible filesystem effects, an id stages a
+ * revert of that one (which then goes through the ordinary approval card or prompt). Pure: the surface calls the
+ * assistant and renders; this only decides which of the two was asked for.
+ */
+export type UndoActionCommand = {
+    kind: 'list';
+} | {
+    kind: 'stage';
+    id: string;
+};
+export declare function parseUndoActionCommand(args: readonly string[]): UndoActionCommand;

package/dist/undo-plan.d.ts

@@ -0,0 +1,13 @@
+import { ChatMessage } from '@buildaharness/runtime';
+export type UndoPlan = {
+    nothingToUndo: true;
+} | {
+    nothingToUndo: false;
+    wasPendingApproval: boolean;
+};
+/**
+ * What /undo and the apps' Undo button must know from the transcript before calling undoLastTurn: an empty
+ * transcript has nothing to undo, and a transcript whose last message is not the assistant's is a turn still
+ * waiting for approval (no reply was appended). The notices shown to the user are each surface's own.
+ */
+export declare function planUndo(transcriptBefore: readonly ChatMessage[]): UndoPlan;

package/dist/version.d.ts

@@ -3,4 +3,4 @@
  * runtime (a bundled/SEA binary has no package.json beside it). `scripts/check-cli-version-sync.mjs`
  * fails CI if this drifts from `package.json`'s `version` — bump both together.
  */
-export declare const CLI_VERSION = "0.3.8";
+export declare const CLI_VERSION = "0.3.9";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildaharness/aielia",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "description": "An open-source AI agent you can hand real work to. Runs the full 11-layer Build A Harness every turn, controlling what it may do, believe and spend, and stages file writes, shell commands and email for your approval. CLI, browser, and desktop.",
   "license": "Apache-2.0",
   "homepage": "https://myaielia.com",