@ishlabs/cli 0.18.0 → 0.19.0

package/dist/commands/study-run.js

@@ -12,6 +12,7 @@ import * as readline from "node:readline/promises";
 import { withClient, getWebUrl, terminalLink, resolveWorkspace, resolveStudy, parseWaitTimeout, resolvePersonIds, addPersonFilterFlags, hasPersonFlags, readFileOrStdin, } from "../lib/command-helpers.js";
 import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
 import { output, formatSimulationPoll } from "../lib/output.js";
+import { fetchStudyParticipants } from "../lib/study-participants.js";
 import { streamStudyEvents } from "../lib/study-events.js";
 import { isMediaModality, isChatModality, iterationHasContent, describeRequiredContentFlag, readChatMode, readParticipantPairConfig, summarizeRoleCriteria, } from "../lib/modality.js";
 // NOTE: local-sim modules are loaded via dynamic import at the `--local`
@@ -107,24 +108,27 @@ const POLL_INTERVAL_MS = 5_000;
 // transparently reverts to POLL_INTERVAL_MS.
 const SSE_BACKSTOP_INTERVAL_MS = 30_000;
 const TERMINAL_STATUSES = new Set(["completed", "errored", "failed", "cancelled", "canceled"]);
-function flattenParticipantStatuses(iterations, only) {
+function flattenParticipantStatuses(participants, opts = {}) {
     const rows = [];
-    for (const iteration of iterations ?? []) {
-        for (const t of iteration.participants ?? []) {
-            if (only && !only.has(t.id))
-                continue;
-            // Pattern A (cli half): backend now reports per-participant crash detail at
-            // `error_message`. Keep `error` / `failure_reason` as legacy fallbacks
-            // until every backend deploy is on the new contract.
-            const errorMessage = t.error_message || t.error || t.failure_reason || null;
-            rows.push({
-                id: t.id,
-                status: t.status,
-                participant_name: t.person?.name || "Unknown",
-                interaction_count: Array.isArray(t.interactions) ? t.interactions.length : 0,
-                ...(errorMessage && { error_message: errorMessage }),
-            });
-        }
+    for (const t of participants ?? []) {
+        if (opts.iterationId && t.iteration_id !== opts.iterationId)
+            continue;
+        if (opts.only && !opts.only.has(t.id))
+            continue;
+        // Pattern A (cli half): backend now reports per-participant crash detail at
+        // `error_message`. Keep `error` / `failure_reason` as legacy fallbacks
+        // until every backend deploy is on the new contract.
+        const errorMessage = t.error_message ||
+            t.error ||
+            t.failure_reason ||
+            null;
+        rows.push({
+            id: t.id,
+            status: t.status,
+            participant_name: t.person?.name || "Unknown",
+            interaction_count: Array.isArray(t.interactions) ? t.interactions.length : 0,
+            ...(errorMessage && { error_message: String(errorMessage) }),
+        });
     }
     return rows;
 }
@@ -146,13 +150,15 @@ async function pollStudyUntilDone(client, opts) {
     let pendingEvent = eventIter.next();
     try {
         while (true) {
-            const study = await client.get(`/studies/${opts.studyId}`, undefined, { timeout: 60_000 });
+            const [study, participants] = await Promise.all([
+                client.get(`/studies/${opts.studyId}`, undefined, { timeout: 60_000 }),
+                fetchStudyParticipants(client, opts.studyId, { timeout: 60_000 }),
+            ]);
             const isMedia = isMediaModality(study.modality);
-            let iterations = study.iterations;
-            if (opts.iterationId) {
-                iterations = (iterations ?? []).filter((it) => it.id === opts.iterationId);
-            }
-            const rows = flattenParticipantStatuses(iterations, opts.participantIds);
+            const rows = flattenParticipantStatuses(participants, {
+                iterationId: opts.iterationId,
+                only: opts.participantIds,
+            });
             const total = rows.length;
             const done = rows.filter((r) => TERMINAL_STATUSES.has(r.status)).length;
             const errored = rows.filter((r) => r.status === "errored" || r.status === "failed").length;
@@ -366,7 +372,8 @@ Examples:
                 || parseInt(opts.dispatchTimeout, 10) < 1)) {
                 throw new Error(`--dispatch-timeout must be a positive integer (seconds), got "${opts.dispatchTimeout}".`);
             }
-            // Step 0: Fetch study (with its iterations + their existing participants)
+            // Step 0: Fetch study metadata (lite — participants live on a
+            // separate endpoint; we fetch them below only when reuse is possible).
             const study = await client.get(`/studies/${resolvedStudy}`);
             const modality = study.modality || "interactive";
             const isMedia = isMediaModality(modality);
@@ -455,8 +462,15 @@ Examples:
                 const resolved = await resolvePersonIds(client, resolvedWorkspace, opts, { requireSimulatable: false, allFlagName: "--all" });
                 personIds.push(...resolved);
             }
-            else if (iteration.participants && iteration.participants.length > 0) {
-                for (const t of iteration.participants) {
+            else if (!isPair) {
+                // Reuse-existing path: no person flags, non-pair iteration. Fetch
+                // participants from the dedicated endpoint and filter to the
+                // current iteration. (Pair iterations don't reuse participant rows
+                // — they reuse Conversation refs above.)
+                const studyParticipants = await fetchStudyParticipants(client, resolvedStudy);
+                for (const t of studyParticipants) {
+                    if (t.iteration_id !== iteration.id)
+                        continue;
                     const pid = t.person_id || t.person?.id;
                     const name = t.person?.name;
                     if (pid && !personNames.has(pid)) {
@@ -667,12 +681,22 @@ Examples:
                 //               language?: str }
                 //     reply : { conversations: [{ conversation_id, pair_index,
                 //                              participant_a_id, participant_b_id }] }
+                //
+                // On the LITE study response, the iteration's conversation refs
+                // use the storage-shape field names group_a_participant_id /
+                // group_b_participant_id. Map them back to the pair-batch reply
+                // shape (participant_a_id / participant_b_id) the rest of this
+                // function expects.
                 const existingConvs = iteration.conversations ?? [];
                 const reusable = [];
                 for (const c of existingConvs) {
                     const cid = c.conversation_id || c.id;
-                    if (cid && c.participant_a_id && c.participant_b_id) {
-                        reusable.push({ conversation_id: cid, participant_a_id: c.participant_a_id, participant_b_id: c.participant_b_id });
+                    if (cid && c.group_a_participant_id && c.group_b_participant_id) {
+                        reusable.push({
+                            conversation_id: cid,
+                            participant_a_id: c.group_a_participant_id,
+                            participant_b_id: c.group_b_participant_id,
+                        });
                     }
                 }
                 let pairRows;
@@ -1059,9 +1083,12 @@ Examples:
             // an agent that ran `study use s-...` then `study poll` would get a
             // confusing "Provide a participant_id argument or --study flag" error.
             const rid = resolveStudy(opts.study);
-            const study = await client.get(`/studies/${rid}`);
+            const [study, participants] = await Promise.all([
+                client.get(`/studies/${rid}`),
+                fetchStudyParticipants(client, rid),
+            ]);
             const isMedia = isMediaModality(study.modality);
-            const allParticipants = flattenParticipantStatuses(study.iterations);
+            const allParticipants = flattenParticipantStatuses(participants);
             formatSimulationPoll(allParticipants, globals.json, isMedia);
             if (!globals.json && study.product_id) {
                 const url = getWebUrl(globals, `/${study.product_id}/${rid}/timeline`);

package/dist/commands/study.js

@@ -8,6 +8,7 @@ import { resolveId, tagAlias, ALIAS_PREFIX } from "../lib/alias-store.js";
 import { loadConfig, saveConfig } from "../config.js";
 import { formatStudyList, formatStudyDetail, formatStudyResults, buildStudyResultsSummary, buildChatTranscript, output, ValidationError, } from "../lib/output.js";
 import { VALID_CONTENT_TYPES } from "../lib/types.js";
+import { fetchStudyParticipants } from "../lib/study-participants.js";
 import { parseAssignment, loadAssignmentsFile, validateAssignmentsArray, parseQuestion } from "../lib/study-inputs.js";
 import { loadQuestionsManifest } from "../lib/ask-questions.js";
 import { isLocalPath } from "../lib/upload.js";
@@ -616,14 +617,17 @@ list table layout in human mode.`)
                 throw new Error("Provide at least one study id.");
             if (flat.length === 1) {
                 const rid = resolveId(flat[0]);
-                const data = await client.get(`/studies/${rid}`);
+                const [data, participants] = await Promise.all([
+                    client.get(`/studies/${rid}`),
+                    fetchStudyParticipants(client, rid),
+                ]);
                 const result = data;
                 if (result.id)
                     result.alias = tagAlias(ALIAS_PREFIX.study, String(result.id));
                 if (data.product_id) {
                     result.url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);
                 }
-                formatStudyDetail(result, globals.json);
+                formatStudyDetail(result, globals.json, {}, participants);
                 if (!globals.json && data.product_id) {
                     const url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);
                     console.error(`\n  ${terminalLink(url, "Open in browser ↗")}\n`);
@@ -632,13 +636,17 @@ list table layout in human mode.`)
             }
             const results = await Promise.all(flat.map(async (raw) => {
                 const rid = resolveId(raw);
-                const data = await client.get(`/studies/${rid}`);
+                const [data, participants] = await Promise.all([
+                    client.get(`/studies/${rid}`),
+                    fetchStudyParticipants(client, rid),
+                ]);
                 const r = data;
                 if (r.id)
                     r.alias = tagAlias(ALIAS_PREFIX.study, String(r.id));
                 if (data.product_id) {
                     r.url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);
                 }
+                r.participants = participants;
                 return r;
             }));
             if (globals.json) {
@@ -751,12 +759,15 @@ When no runs have completed, the default envelope is returned with zero counts a
                 output(buildChatTranscript(participant), globals.json, { preProjected: true });
                 return;
             }
-            const data = await client.get(`/studies/${rid}`);
+            const [data, participants] = await Promise.all([
+                client.get(`/studies/${rid}`),
+                fetchStudyParticipants(client, rid),
+            ]);
             if (wantsSummary) {
-                output(buildStudyResultsSummary(data), globals.json, { preProjected: true });
+                output(buildStudyResultsSummary(data, participants), globals.json, { preProjected: true });
             }
             else {
-                formatStudyResults(data, globals.json);
+                formatStudyResults(data, participants, globals.json);
             }
             if (!globals.json && data.product_id) {
                 const url = getWebUrl(globals, `/${data.product_id}/${rid}/overview`);

package/dist/lib/docs.js

@@ -2059,6 +2059,15 @@ The CLI guarantees these contracts so agents can chain safely:
   sentiment histogram + per-participant {alias, status, sentiment, comment,
   error_message}. Drops \`interview_answers\` and per-interaction
   breakdowns. Cheapest "did this run land?" shape.
+- **\`study get --json\` carries a flat top-level \`participants[]\`**
+  (post backend-split). Each row carries \`iteration_id\` as a
+  discriminator and the per-participant graph
+  (\`person\`, \`interactions[]\`, \`participant_summary\`,
+  \`interview_answers\`, \`conversation_id\`, …). The previous nesting
+  under \`iterations[*].participants[*]\` is gone — read participants from
+  the top level. The lite iteration list under \`iterations[]\` still
+  carries each iteration's \`details\` and (for pair-mode chat) the
+  conversation refs at \`iterations[*].conversations[]\`.
 - **\`study get --json\` carries assignment step completion** when an
   assignment has a checklist (see \`concepts/assignment\`). Each
   \`assignments[].step_completion[]\` row is
@@ -3079,7 +3088,7 @@ ish study run stu-xyz --sample 5 --wait
 
 Pull raw interactions:
 \`\`\`
-ish study results stu-xyz --json | jq '.interactions'
+ish study results stu-xyz --json | jq '.participants[].interactions'
 \`\`\`
 
 Note: chat is currently excluded from the LLM-analysis route; the

package/dist/lib/output.d.ts

@@ -47,15 +47,15 @@ export declare function formatWorkspaceList(workspaces: Record<string, unknown>[
 export declare function formatWorkspaceDetail(workspace: Record<string, unknown>, json: boolean, options?: OutputOptions): void;
 export declare function formatSiteAccessStatus(summary: import("./site-access.js").SiteAccessSummary, json: boolean): void;
 export declare function formatStudyList(studies: Record<string, unknown>[], json: boolean): void;
-export declare function formatStudyDetail(study: Record<string, unknown>, json: boolean, options?: OutputOptions): void;
-export declare function formatStudyResults(study: Record<string, unknown>, json: boolean): void;
+export declare function formatStudyDetail(study: Record<string, unknown>, json: boolean, options?: OutputOptions, participants?: ReadonlyArray<Record<string, unknown>>): void;
+export declare function formatStudyResults(study: Record<string, unknown>, participants: ReadonlyArray<Record<string, unknown>>, json: boolean): void;
 /**
  * `study results --summary` projection. Drops interview_answers + per-participant
  * interaction breakdowns; keeps headline counters, sentiment histogram, and a
  * per-participant {alias, status, sentiment, comment} row. Useful for agents that
  * need to branch on outcome without paying for the full envelope.
  */
-export declare function buildStudyResultsSummary(study: Record<string, unknown>): Record<string, unknown>;
+export declare function buildStudyResultsSummary(study: Record<string, unknown>, participants: ReadonlyArray<Record<string, unknown>>): Record<string, unknown>;
 /**
  * `study results --transcript <participant_id>` projection. Mirrors the schema
  * MCP's `get_chat_transcript` returns (`src/ish_mcp/projections.py:

package/dist/lib/output.js

@@ -807,10 +807,10 @@ export function formatStudyList(studies, json) {
  *
  * Returns null when status is consistent; no warning emitted.
  */
-function detectStudyStatusInconsistency(study) {
+function detectStudyStatusInconsistency(study, participants) {
     if (study.status !== "failed")
         return null;
-    const allParticipants = collectParticipants(study);
+    const allParticipants = collectParticipants(participants, Array.isArray(study.iterations) ? study.iterations : []);
     const completedCount = allParticipants.filter((t) => t.status === "completed" || t.status === "complete").length;
     const totalInteractions = allParticipants.reduce((sum, t) => sum + t.interactionCount, 0);
     if (completedCount === 0 && totalInteractions === 0)
@@ -879,14 +879,16 @@ function renderAssignmentSteps(a) {
         }
     }
 }
-export function formatStudyDetail(study, json, options = {}) {
-    const inconsistency = detectStudyStatusInconsistency(study);
+export function formatStudyDetail(study, json, options = {}, participants) {
+    const inconsistency = detectStudyStatusInconsistency(study, participants);
     if (inconsistency)
         emitStatusInconsistencyWarning(inconsistency);
     if (json) {
-        const payload = inconsistency
-            ? { ...study, status_inferred: inconsistency.inferred }
-            : study;
+        const payload = { ...study };
+        if (participants !== undefined)
+            payload.participants = participants;
+        if (inconsistency)
+            payload.status_inferred = inconsistency.inferred;
         console.log(jsonOutput(payload, options));
         return;
     }
@@ -929,7 +931,7 @@ export function formatStudyDetail(study, json, options = {}) {
         }
     }
     // Participants summary
-    const allParticipants = collectParticipants(study);
+    const allParticipants = collectParticipants(participants, Array.isArray(study.iterations) ? study.iterations : []);
     if (allParticipants.length > 0) {
         console.log(`\nParticipants (${allParticipants.length}):`);
         printTable(["#", "NAME", "ITERATION", "STATUS", "INTERACTIONS"], allParticipants.map((t) => [
@@ -946,8 +948,8 @@ export function formatStudyDetail(study, json, options = {}) {
  * study state — fields default to `null`, `0`, or `[]` when nothing has run.
  * Agents can rely on the keys always being present (M4).
  */
-function buildStudyResultsEnvelope(study) {
-    const allParticipants = collectParticipants(study);
+function buildStudyResultsEnvelope(study, participants) {
+    const allParticipants = collectParticipants(participants, Array.isArray(study.iterations) ? study.iterations : []);
     const studyAlias = study.id
         ? deterministicAlias(ALIAS_PREFIX.study, String(study.id))
         : null;
@@ -995,7 +997,7 @@ function buildStudyResultsEnvelope(study) {
     // CLI-side sanity check (Pattern E / Issue #2). Surface a status_inferred
     // field when the backend reports failed-with-data; agents can branch on
     // either the original status or status_inferred.
-    const inconsistency = detectStudyStatusInconsistency(study);
+    const inconsistency = detectStudyStatusInconsistency(study, participants);
     // Pattern B2 (cli half): per-participant rows expose status + error_message so
     // agents can act on a failed run without re-fetching every participant.
     const failedCount = allParticipants.filter((t) => t.status.toLowerCase() === "failed").length;
@@ -1025,18 +1027,18 @@ function buildStudyResultsEnvelope(study) {
         participants: participantRows,
     };
 }
-export function formatStudyResults(study, json) {
-    const inconsistency = detectStudyStatusInconsistency(study);
+export function formatStudyResults(study, participants, json) {
+    const inconsistency = detectStudyStatusInconsistency(study, participants);
     if (inconsistency)
         emitStatusInconsistencyWarning(inconsistency);
     if (json) {
         // preProjected: bypass leanJson so the stable envelope keeps documented
         // empty defaults (sentiment: null, interview_answers[].answers: []) rather
         // than having them stripped by the lean transform.
-        console.log(jsonOutput(buildStudyResultsEnvelope(study), { preProjected: true }));
+        console.log(jsonOutput(buildStudyResultsEnvelope(study, participants), { preProjected: true }));
         return;
     }
-    const allParticipants = collectParticipants(study);
+    const allParticipants = collectParticipants(participants, Array.isArray(study.iterations) ? study.iterations : []);
     const totalInteractions = allParticipants.reduce((sum, t) => sum + t.interactionCount, 0);
     // Header
     console.log(`${study.name || "Untitled"} — Results`);
@@ -1102,8 +1104,8 @@ export function formatStudyResults(study, json) {
  * per-participant {alias, status, sentiment, comment} row. Useful for agents that
  * need to branch on outcome without paying for the full envelope.
  */
-export function buildStudyResultsSummary(study) {
-    const allParticipants = collectParticipants(study);
+export function buildStudyResultsSummary(study, participants) {
+    const allParticipants = collectParticipants(participants, Array.isArray(study.iterations) ? study.iterations : []);
     const studyAlias = study.id
         ? deterministicAlias(ALIAS_PREFIX.study, String(study.id))
         : null;
@@ -1118,7 +1120,7 @@ export function buildStudyResultsSummary(study) {
         }
     }
     const sentiment = sentimentTotal > 0 ? { counts: sentimentCounts, total: sentimentTotal } : null;
-    const participants = allParticipants.map((t) => ({
+    const participantRows = allParticipants.map((t) => ({
         alias: t.alias || null,
         name: t.name,
         status: t.status,
@@ -1136,7 +1138,7 @@ export function buildStudyResultsSummary(study) {
         completed_count: completedCount,
         failed_count: failedCount,
         sentiment,
-        participants,
+        participants: participantRows,
     };
 }
 /**
@@ -1300,49 +1302,52 @@ export function buildParticipantSummary(participant) {
         out.error_kind = String(participant.error_kind);
     return out;
 }
-function collectParticipants(study) {
-    const iterations = Array.isArray(study.iterations) ? study.iterations : [];
-    const participants = [];
-    for (const iter of iterations) {
-        const it = iter;
-        const iterLabel = String(it.label || it.name || "-");
-        const iterParticipants = Array.isArray(it.participants) ? it.participants : [];
-        for (const participant of iterParticipants) {
-            const t = participant;
-            const profile = t.person;
-            const interactions = Array.isArray(t.interactions) ? t.interactions : [];
-            const sentimentCounts = {};
-            for (const interaction of interactions) {
-                const ix = interaction;
-                const sentiment = ix.sentiment;
-                if (sentiment?.label) {
-                    const label = String(sentiment.label);
-                    sentimentCounts[label] = (sentimentCounts[label] || 0) + 1;
-                }
+function collectParticipants(participants, iterations) {
+    const iterationLabels = new Map();
+    for (const iter of iterations ?? []) {
+        const id = iter.id ? String(iter.id) : "";
+        if (id) {
+            iterationLabels.set(id, String(iter.label || iter.name || "-"));
+        }
+    }
+    const rows = [];
+    for (const participant of participants ?? []) {
+        const t = participant;
+        const profile = t.person;
+        const interactions = Array.isArray(t.interactions) ? t.interactions : [];
+        const sentimentCounts = {};
+        for (const interaction of interactions) {
+            const ix = interaction;
+            const sentiment = ix.sentiment;
+            if (sentiment?.label) {
+                const label = String(sentiment.label);
+                sentimentCounts[label] = (sentimentCounts[label] || 0) + 1;
             }
-            const answers = Array.isArray(t.interview_answers) ? t.interview_answers : [];
-            const summary = t.participant_summary;
-            const summarySentimentObj = summary?.sentiment;
-            const id = String(t.id || "");
-            participants.push({
-                id,
-                name: String(profile?.name || t.instance_name || "Unknown"),
-                alias: id ? deterministicAlias(ALIAS_PREFIX.participant, id) : "",
-                iterationLabel: iterLabel,
-                status: String(t.status || "-"),
-                errorMessage: t.error_message ? String(t.error_message) : null,
-                interactionCount: interactions.length,
-                sentimentCounts,
-                summarySentiment: summarySentimentObj?.label ? String(summarySentimentObj.label) : null,
-                summaryComment: summary?.comment ? String(summary.comment) : null,
-                interviewAnswers: answers.map((a) => ({
-                    questionId: String(a.question_id || ""),
-                    answer: a.answer,
-                })),
-            });
         }
+        const answers = Array.isArray(t.interview_answers) ? t.interview_answers : [];
+        const summary = t.participant_summary;
+        const summarySentimentObj = summary?.sentiment;
+        const id = String(t.id || "");
+        const iterationId = t.iteration_id ? String(t.iteration_id) : "";
+        const iterationLabel = (iterationId && iterationLabels.get(iterationId)) || "-";
+        rows.push({
+            id,
+            name: String(profile?.name || t.instance_name || "Unknown"),
+            alias: id ? deterministicAlias(ALIAS_PREFIX.participant, id) : "",
+            iterationLabel,
+            status: String(t.status || "-"),
+            errorMessage: t.error_message ? String(t.error_message) : null,
+            interactionCount: interactions.length,
+            sentimentCounts,
+            summarySentiment: summarySentimentObj?.label ? String(summarySentimentObj.label) : null,
+            summaryComment: summary?.comment ? String(summary.comment) : null,
+            interviewAnswers: answers.map((a) => ({
+                questionId: String(a.question_id || ""),
+                answer: a.answer,
+            })),
+        });
     }
-    return participants;
+    return rows;
 }
 function formatQuestionType(q) {
     if (!q.type)

package/dist/lib/skill-content.js

@@ -219,6 +219,7 @@ When in doubt: side-by-side comparison usually beats in-place edits. Ids are che
 - **Chatbot auth drift**: tokens/sessions baked into \`--from-curl\` expire. If transcripts come back as identical short error strings, re-run \`chat_endpoint_test\` and refresh the curl spec.
 - **401 surfaces as fake blocker**: an unauthenticated endpoint produces "participant got stuck on auth screen" — looks like a UX blocker but is config. Always confirm endpoint auth before reading transcripts as user-research data.
 - **No per-page/per-timestamp scoping for media**: there's no "evaluate just slide 14" or "react to seconds 0-30" API. State the focus explicitly in the \`assignment\` text, or pre-stitch the artifact (e.g. replace one slide locally, upload as a new iteration).
+- **\`study get --json\` participants live at the top level**, not nested under \`iterations[*].participants\`. The backend split made \`/studies/{id}\` lite (metadata + iteration shells, no participant graph) and added \`/studies/{id}/participants\`; the CLI joins them so \`study get --json\` carries a flat \`participants[]\` with \`iteration_id\` on each row. Read \`.participants[]\`, not \`.iterations[].participants[]\`.
 
 ## When in doubt
 

package/dist/lib/study-participants.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Wrapper for the post-split `GET /studies/{id}/participants` endpoint.
+ *
+ * Returns a flat list of participants for one study with an `iteration_id`
+ * discriminator on each row. Each row carries the rich per-participant graph
+ * (person, interactions[], participant_summary, interview_answers, …) that
+ * used to be embedded under `study.iterations[*].participants[*]` on the
+ * legacy `GET /studies/{id}` response.
+ */
+import type { ApiClient } from "./api-client.js";
+import type { Participant } from "./types.js";
+export interface StudyParticipant extends Participant {
+    person?: {
+        id?: string;
+        name?: string;
+    };
+    interactions?: unknown[];
+    participant_summary?: Record<string, unknown> | null;
+    interview_answers?: Array<{
+        question_id?: string;
+        answer?: unknown;
+    }>;
+    participant_files?: unknown[];
+    participant_assignments?: unknown[];
+    conversation_id?: string | null;
+    error_message?: string | null;
+    error_kind?: string | null;
+    [k: string]: unknown;
+}
+export declare function fetchStudyParticipants(client: ApiClient, studyId: string, opts?: {
+    timeout?: number;
+}): Promise<StudyParticipant[]>;

package/dist/lib/study-participants.js

@@ -0,0 +1,12 @@
+/**
+ * Wrapper for the post-split `GET /studies/{id}/participants` endpoint.
+ *
+ * Returns a flat list of participants for one study with an `iteration_id`
+ * discriminator on each row. Each row carries the rich per-participant graph
+ * (person, interactions[], participant_summary, interview_answers, …) that
+ * used to be embedded under `study.iterations[*].participants[*]` on the
+ * legacy `GET /studies/{id}` response.
+ */
+export async function fetchStudyParticipants(client, studyId, opts) {
+    return await client.get(`/studies/${studyId}/participants`, undefined, opts);
+}

package/dist/lib/types.d.ts

@@ -155,7 +155,6 @@ export interface Iteration {
     description?: string;
     label?: string;
     details?: Record<string, unknown>;
-    participants?: Participant[];
     created_at: string;
     updated_at: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ishlabs/cli",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "The command-line interface for ish",
   "type": "module",
   "bin": {