@steerable/agent-harness 0.2.3 → 0.2.4

package/dist/generated/ActionSegmentPayload.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Payload of an action-segment card -- a strip of tool / action invocations the agent ran inline within an assistant message. Each segment carries a kind (the action type), a status, and arbitrary args/output payload that downstream renderers pretty-print.
+ */
+export interface ActionSegmentPayload {
+    segments: {
+        id: string;
+        /**
+         * Action / tool name, e.g. 'create_task' or 'search.web'.
+         */
+        kind: string;
+        status: "pending" | "running" | "succeeded" | "failed" | "cancelled";
+        label?: string | null;
+        args?: any;
+        output?: any;
+        error?: string | null;
+        startedAt?: string | null;
+        finishedAt?: string | null;
+        [k: string]: any;
+    }[];
+    [k: string]: any;
+}

package/dist/generated/ActionSegmentPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/AnalysisDocumentPayload.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Payload of an analysis-document card. Renders as a long-form markdown document (research write-up, design memo, etc.). The body string can include GFM markdown, mermaid blocks, and inline references. The optional metadata block carries model / timestamp info shown in the document header.
+ */
+export interface AnalysisDocumentPayload {
+    /**
+     * Optional document title; defaults to a generic 'Analysis' label client-side.
+     */
+    title?: string | null;
+    /**
+     * Markdown body. May include mermaid code-fences.
+     */
+    body: string;
+    createdAt?: string | null;
+    /**
+     * Display model badge id (resolved to model option client-side).
+     */
+    modelId?: string | null;
+    [k: string]: any;
+}

package/dist/generated/AnalysisDocumentPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/AskUserQuestionsPayload.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Payload of an ask-user-questions card. The agent has paused mid-run and needs structured input from the user before continuing. Each question is one of: option buttons (select), free-form text, or password. After the user answers, the backend re-emits the same card with answers filled in to switch the UI to read-only.
+ */
+export interface AskUserQuestionsPayload {
+    intro: string;
+    outro?: string | null;
+    answers?: {
+        [k: string]: string | string[];
+    } | null;
+    questions: {
+        id: string;
+        text: string;
+        type?: "select" | "text" | "password";
+        options?: string[];
+        placeholder?: string | null;
+        multiSelect?: boolean;
+        [k: string]: any;
+    }[];
+    [k: string]: any;
+}

package/dist/generated/AskUserQuestionsPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/CoverageReportPayload.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Payload of a coverage-report card. Summarises mastery of a knowledge graph: section-level coverage / mastery and a list of weak knowledge points the learner should remediate. The actions block tells the UI whether a 'practice weak points' button should be offered.
+ */
+export interface CoverageReportPayload {
+    reportId: string;
+    title: string;
+    /**
+     * 0..1 fraction of nodes covered.
+     */
+    overallCoverage: number;
+    /**
+     * 0..1 fraction of nodes mastered.
+     */
+    overallMastery: number;
+    summary?: string | null;
+    sections: {
+        id: string;
+        name: string;
+        coverage: number;
+        mastery: number;
+        totalCount: number;
+        learnedCount: number;
+        testedCount: number;
+        masteredCount: number;
+        weakKpIds: string[];
+        [k: string]: any;
+    }[];
+    weakPoints: {
+        id: string;
+        name: string;
+        sectionName?: string | null;
+        accuracy: number;
+        recommendation: string;
+        [k: string]: any;
+    }[];
+    actions: {
+        allowRemediateQuiz: boolean;
+        remediateActionLabel: string;
+        [k: string]: any;
+    };
+    [k: string]: any;
+}

package/dist/generated/CoverageReportPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/OrchestrationPlanPayload.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Payload of an orchestration-plan card emitted by the Coordinator agent. Lists every worker task (id + agent + prompt + dependencies). The UI renders one row per task with a live status dot driven by sibling assistant messages tagged with the same orchestrationGroupId + orchestrationTaskId.
+ */
+export interface OrchestrationPlanPayload {
+    /**
+     * Short prose explanation of why the coordinator picked this plan shape.
+     */
+    rationale?: string;
+    /**
+     * How the workers run with respect to each other.
+     */
+    mode?: "parallel" | "sequential" | "dag";
+    tasks: {
+        /**
+         * Stable id for this task within the orchestration group.
+         */
+        id: string;
+        /**
+         * Which agent runs this task.
+         */
+        agentId: string;
+        /**
+         * Per-task prompt the coordinator drafted.
+         */
+        prompt?: string;
+        /**
+         * Task ids that must finish before this one starts.
+         */
+        dependsOn?: string[];
+        /**
+         * Task ids whose outputs this task is allowed to read.
+         */
+        readOutputsFrom?: string[];
+        [k: string]: any;
+    }[];
+    coordinator?: {
+        agentId?: string;
+        name?: string;
+        avatar?: string;
+        [k: string]: any;
+    };
+    [k: string]: any;
+}

package/dist/generated/OrchestrationPlanPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/PlanSelectorPayload.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Payload of a plan-selector card. The agent has drafted multiple candidate plans and is asking the user to pick one. Each plan carries effort / risk metrics and a pros/cons list. After selection the backend re-emits with selectedPlan filled in.
+ */
+export interface PlanSelectorPayload {
+    /**
+     * Short prose summarising how the candidate plans differ.
+     */
+    comparison: string;
+    /**
+     * Id of the user-chosen plan once decided.
+     */
+    selectedPlan?: string | null;
+    goalAttribution: {
+        type: "existing" | "new";
+        existingGoalId?: string | null;
+        existingGoalTitle?: string | null;
+        newGoalTitle?: string | null;
+        [k: string]: any;
+    };
+    plans: {
+        id: string;
+        name: string;
+        summary: string;
+        approach: string;
+        bestFor: string;
+        metrics: {
+            duration: string;
+            effortLevel: "low" | "medium" | "high";
+            riskLevel: "low" | "medium" | "high";
+            [k: string]: any;
+        };
+        pros: string[];
+        cons: string[];
+        [k: string]: any;
+    }[];
+    [k: string]: any;
+}

package/dist/generated/PlanSelectorPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/PlanStepsPayload.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Payload of a plan-steps card -- a compact horizontal checklist of skill names the agent intends to execute. Rendered as 'step1 / step2 / step3 ...' inline.
+ */
+export interface PlanStepsPayload {
+    steps: string[];
+    [k: string]: any;
+}

package/dist/generated/PlanStepsPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/QuizPayload.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Payload of a quiz card. Carries one or more questions (choice / fill / judge / short_answer) and a submit button label. After the learner submits, the backend re-emits the same quizId with submittedAnswers filled in to switch the UI to read-only review mode.
+ */
+export interface QuizPayload {
+    /**
+     * Stable id, used for resubmit and review continuity.
+     */
+    quizId: string;
+    title: string;
+    description?: string | null;
+    submitActionLabel: string;
+    submittedAnswers?: {
+        [k: string]: string | string[];
+    } | null;
+    questions: {
+        id: string;
+        type: "choice" | "fill" | "judge" | "short_answer";
+        stem: string;
+        options?: string[] | null;
+        allowMultiple?: boolean | null;
+        placeholder?: string | null;
+        points?: number | null;
+        knowledgePointId?: string | null;
+        difficulty?: number | null;
+        [k: string]: any;
+    }[];
+    [k: string]: any;
+}

package/dist/generated/QuizPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/ResearchPlanPayload.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Payload of a research-plan card. Snapshots a research agent's current sub-question tree and its decision for the next round. The UI shows each sub-question with kind / evidence-strength badges.
+ */
+export interface ResearchPlanPayload {
+    topic: string;
+    round: number;
+    /**
+     * True when the research loop is complete and this snapshot is the last one.
+     */
+    final: boolean;
+    subQuestions: {
+        id: string;
+        question: string;
+        kind: "fact" | "compare" | "conclusion" | "risk";
+        status: "pending" | "searching" | "evidenced_strong" | "evidenced_medium" | "evidenced_weak" | "conflicted" | "exhausted";
+        evidenceCount: number;
+        note?: string | null;
+        [k: string]: any;
+    }[];
+    decision: {
+        next: "continue" | "expand" | "converge";
+        reason?: string | null;
+        [k: string]: any;
+    };
+    [k: string]: any;
+}

package/dist/generated/ResearchPlanPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/SearchSourcesPayload.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Payload of a search-sources card. Lists the web pages that an agent consulted while answering. Rendered as a row of stacked favicons with an expandable detail list.
+ */
+export interface SearchSourcesPayload {
+    sources: {
+        url: string;
+        title?: string | null;
+        snippet?: string | null;
+        favicon?: string | null;
+        publishedAt?: string | null;
+        [k: string]: any;
+    }[];
+    [k: string]: any;
+}

package/dist/generated/SearchSourcesPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/SuggestedRepliesPayload.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Payload of a suggested-replies card. A small set of single-shot quick-reply texts shown below the composer; clicking one sends that text as the next user message.
+ */
+export interface SuggestedRepliesPayload {
+    /**
+     * Quick-reply texts. Clients typically render the first ~6; backend should keep the list short.
+     */
+    suggestions: string[];
+    [k: string]: any;
+}

package/dist/generated/SuggestedRepliesPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/SummaryMessagePayload.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Payload of a summary-message card. Used when the chat history was condensed: the card shows a markdown summary along with a count of how many original messages it replaces. Collapsed by default.
+ */
+export interface SummaryMessagePayload {
+    /**
+     * Markdown summary text.
+     */
+    body: string;
+    summarizedCount?: number | null;
+    status?: "pending" | "complete" | "failed" | null;
+    /**
+     * Free-form summary kind label (e.g. 'history_compaction').
+     */
+    type?: string | null;
+    [k: string]: any;
+}

package/dist/generated/SummaryMessagePayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/ThinkingProcessPayload.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Payload of a thinking-process card. Renders the agent's chain-of-thought (markdown) in a collapsible panel. UI clients are responsible for redacting / disabling this card if the deployment policy forbids exposing raw reasoning to end users.
+ */
+export interface ThinkingProcessPayload {
+    /**
+     * Markdown chain-of-thought text.
+     */
+    body: string;
+    defaultExpanded?: boolean;
+    [k: string]: any;
+}

package/dist/generated/ThinkingProcessPayload.js

@@ -0,0 +1 @@
+export {};

package/dist/generated/ToolExecutionPayload.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Payload of a tool-execution card. Unified representation of a single tool / MCP / local action invocation: name, status, args (input), output, and an optional human-readable summary. Both deeppath's ActionSegment and deeppath-agent's ExecutedActionsCard render off this same shape.
+ */
+export interface ToolExecutionPayload {
+    /**
+     * Stable id of this invocation.
+     */
+    id: string;
+    /**
+     * Tool name as exposed to the agent.
+     */
+    name: string;
+    status: "pending" | "running" | "succeeded" | "failed" | "cancelled";
+    /**
+     * One-line human summary for the row header.
+     */
+    summary?: string | null;
+    args?: any;
+    output?: any;
+    error?: string | null;
+    durationMs?: number | null;
+    /**
+     * Optional icon hint (lucide name or url).
+     */
+    icon?: string | null;
+    expandable?: boolean;
+    [k: string]: any;
+}

package/dist/generated/ToolExecutionPayload.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steerable/agent-harness",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Steerable framework Tier 2 — TypeScript facade over the Python harness (policy, budget, retry, completion, tracing) used for cross-language conformance tests. Production code should depend on the Python harness.",
   "license": "Apache-2.0",
   "homepage": "https://pathlyapp.github.io/steerable-framework/",
@@ -29,7 +29,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@steerable/agent-protocol": "0.2.3"
+    "@steerable/agent-protocol": "0.2.4"
   },
   "devDependencies": {
     "typescript": "^5.8.3",