happy2 0.0.12 → 0.0.13

package/packages/happy2-server/dist/modules/agent/agentTurnTraceGet.js

@@ -0,0 +1,86 @@
+import { and, asc, eq } from "drizzle-orm";
+import { chatGetAccess } from "../chat/chatGetAccess.js";
+import { CollaborationError } from "../chat/types.js";
+import { agentTurnTraceEntries, agentTurns, messages } from "../schema.js";
+import { asAgentTurnTrace } from "../chat/asAgentTurnTrace.js";
+import { messageIsPast } from "../message/messageIsPast.js";
+/**
+ * Reads the complete coalesced execution trace linked to one visible assistant message after rechecking chat access and tombstone/expiry state.
+ * Keeping trace visibility aligned with its message prevents deleted reasoning and tool details from bypassing the chat-content lifetime while avoiding inflation of every message projection.
+ */
+export async function agentTurnTraceGet(executor, actorUserId, assistantMessageId) {
+    const [turn] = await executor
+        .select({
+        userMessageId: agentTurns.userMessageId,
+        agentUserId: agentTurns.agentUserId,
+        chatId: agentTurns.chatId,
+        status: agentTurns.status,
+        startedAt: agentTurns.startedAt,
+        completedAt: agentTurns.completedAt,
+        traceLatestKind: agentTurns.traceLatestKind,
+        traceLatestTitle: agentTurns.traceLatestTitle,
+        traceLatestDetail: agentTurns.traceLatestDetail,
+        traceLatestAt: agentTurns.traceLatestAt,
+        traceEntryCount: agentTurns.traceEntryCount,
+        traceSubagentsJson: agentTurns.traceSubagentsJson,
+        traceBackgroundTerminalsJson: agentTurns.traceBackgroundTerminalsJson,
+        messageDeletedAt: messages.deletedAt,
+        messageExpiresAt: messages.expiresAt,
+    })
+        .from(agentTurns)
+        .innerJoin(messages, eq(messages.id, agentTurns.assistantMessageId))
+        .where(eq(agentTurns.assistantMessageId, assistantMessageId))
+        .limit(1);
+    if (!turn ||
+        turn.messageDeletedAt !== null ||
+        messageIsPast(turn.messageExpiresAt ?? undefined) ||
+        !(await chatGetAccess(executor, actorUserId, turn.chatId, false)))
+        throw new CollaborationError("not_found", "Agent turn trace was not found");
+    const entries = await executor
+        .select({
+        id: agentTurnTraceEntries.id,
+        kind: agentTurnTraceEntries.kind,
+        title: agentTurnTraceEntries.title,
+        detail: agentTurnTraceEntries.detail,
+        status: agentTurnTraceEntries.status,
+        occurredAt: agentTurnTraceEntries.occurredAt,
+        completedAt: agentTurnTraceEntries.completedAt,
+    })
+        .from(agentTurnTraceEntries)
+        .where(and(eq(agentTurnTraceEntries.userMessageId, turn.userMessageId), eq(agentTurnTraceEntries.agentUserId, turn.agentUserId)))
+        .orderBy(asc(agentTurnTraceEntries.occurredAt), asc(agentTurnTraceEntries.createdAt));
+    return {
+        ...asAgentTurnTrace(turn),
+        entries: entries.flatMap((entry) => {
+            const kind = traceKind(entry.kind);
+            const status = traceEntryStatus(entry.status);
+            if (!kind || !status)
+                return [];
+            return [
+                {
+                    id: entry.id,
+                    kind,
+                    title: entry.title,
+                    ...(entry.detail ? { detail: entry.detail } : {}),
+                    status,
+                    occurredAt: entry.occurredAt,
+                    ...(entry.completedAt === null ? {} : { completedAt: entry.completedAt }),
+                },
+            ];
+        }),
+    };
+}
+function traceKind(value) {
+    return value === "reasoning" ||
+        value === "response" ||
+        value === "tool" ||
+        value === "subagent" ||
+        value === "terminal" ||
+        value === "status"
+        ? value
+        : undefined;
+}
+function traceEntryStatus(value) {
+    return value === "running" || value === "complete" || value === "failed" ? value : undefined;
+}
+//# sourceMappingURL=agentTurnTraceGet.js.map

package/packages/happy2-server/dist/modules/agent/agentTurnTraceGet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTurnTraceGet.js","sourceRoot":"","sources":["../../../sources/modules/agent/agentTurnTraceGet.ts"],"names":[],"mappings":"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"}

package/packages/happy2-server/dist/modules/agent/agentTurnTraceStart.d.ts

@@ -0,0 +1,19 @@
+import type { MessageSummary, MutationHint } from "../chat/types.js";
+import type { DrizzleExecutor } from "../drizzle.js";
+/**
+ * Materializes the empty assistant reply, links agentTurns, and inserts the first agentTurnTraceEntries span for a worker-owned running turn.
+ * This gives clients a stable message identity before response text exists; retries reuse the linked message and only publish a new chat mutation when the trace had to be initialized.
+ */
+export declare function agentTurnTraceStart(executor: DrizzleExecutor, input: {
+    agentUserId: string;
+    actorUserId: string;
+    chatId: string;
+    sessionId: string;
+    startedAt: string;
+    userMessageId: string;
+    workerId: string;
+}): Promise<{
+    message: MessageSummary;
+    hint: MutationHint;
+} | undefined>;
+//# sourceMappingURL=agentTurnTraceStart.d.ts.map

package/packages/happy2-server/dist/modules/agent/agentTurnTraceStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTurnTraceStart.d.ts","sourceRoot":"","sources":["../../../sources/modules/agent/agentTurnTraceStart.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAQrD;;;GAGG;AACH,wBAAsB,mBAAmB,CACrC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB,GACF,OAAO,CAAC;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GAAG,SAAS,CAAC,CA4FtE"}

package/packages/happy2-server/dist/modules/agent/agentTurnTraceStart.js

@@ -0,0 +1,87 @@
+import { createId } from "@paralleldrive/cuid2";
+import { and, eq, sql } from "drizzle-orm";
+import { chatAdvanceWithSequence } from "../chat/chatAdvanceWithSequence.js";
+import { chatHint } from "../chat/chatHint.js";
+import { withTransaction } from "../drizzle.js";
+import { messageGetProjection } from "../message/messageGetProjection.js";
+import { messageSendInTransaction } from "../message/messageSendInTransaction.js";
+import { agentTurnTraceEntries, agentTurns, messages } from "../schema.js";
+import { syncSequenceNext } from "../sync/syncSequenceNext.js";
+import { agentReplyMutationId } from "./impl/agentReplyMutationId.js";
+/**
+ * Materializes the empty assistant reply, links agentTurns, and inserts the first agentTurnTraceEntries span for a worker-owned running turn.
+ * This gives clients a stable message identity before response text exists; retries reuse the linked message and only publish a new chat mutation when the trace had to be initialized.
+ */
+export async function agentTurnTraceStart(executor, input) {
+    return withTransaction(executor, async (tx) => {
+        const [turn] = await tx
+            .select({
+            assistantMessageId: agentTurns.assistantMessageId,
+            traceEntryCount: agentTurns.traceEntryCount,
+        })
+            .from(agentTurns)
+            .where(and(eq(agentTurns.userMessageId, input.userMessageId), eq(agentTurns.agentUserId, input.agentUserId), eq(agentTurns.sessionId, input.sessionId), eq(agentTurns.workerId, input.workerId), eq(agentTurns.status, "running")))
+            .limit(1);
+        if (!turn || (turn.assistantMessageId && turn.traceEntryCount > 0))
+            return undefined;
+        let messageId = turn.assistantMessageId ?? undefined;
+        let hint;
+        if (!messageId) {
+            const created = await messageSendInTransaction(tx, {
+                actorUserId: input.actorUserId,
+                agentSessionId: input.sessionId,
+                chatId: input.chatId,
+                clientMutationId: agentReplyMutationId(input.sessionId, input.userMessageId),
+                deferPublication: true,
+                kind: "automated",
+                text: "",
+            });
+            messageId = created.message.id;
+            hint = created.hint;
+        }
+        else {
+            const sequence = await syncSequenceNext(tx);
+            const mutation = await chatAdvanceWithSequence(tx, sequence, input.agentUserId, input.chatId, "message.streaming", messageId);
+            await tx
+                .update(messages)
+                .set({ changePts: mutation.pts, updatedAt: sql `CURRENT_TIMESTAMP` })
+                .where(eq(messages.id, messageId));
+            hint = chatHint(sequence, input.chatId, mutation.pts);
+        }
+        const occurredAt = Date.parse(input.startedAt);
+        const linked = await tx
+            .update(agentTurns)
+            .set({
+            assistantMessageId: messageId,
+            traceLatestKind: "status",
+            traceLatestTitle: "Starting turn",
+            traceLatestDetail: null,
+            traceLatestAt: occurredAt,
+            traceEntryCount: 1,
+            updatedAt: sql `CURRENT_TIMESTAMP`,
+        })
+            .where(and(eq(agentTurns.userMessageId, input.userMessageId), eq(agentTurns.agentUserId, input.agentUserId), eq(agentTurns.sessionId, input.sessionId), eq(agentTurns.workerId, input.workerId), eq(agentTurns.status, "running")))
+            .returning({ id: agentTurns.userMessageId });
+        if (linked.length !== 1)
+            throw new Error("Agent turn trace could not be linked");
+        await tx
+            .insert(agentTurnTraceEntries)
+            .values({
+            id: createId(),
+            userMessageId: input.userMessageId,
+            agentUserId: input.agentUserId,
+            traceKey: "turn",
+            sessionEventId: `turn-start:${input.startedAt}`,
+            kind: "status",
+            title: "Starting turn",
+            status: "running",
+            occurredAt,
+        })
+            .onConflictDoNothing();
+        const message = await messageGetProjection(tx, input.actorUserId, messageId);
+        if (!message)
+            throw new Error("Agent turn trace message is not readable");
+        return { message, hint };
+    });
+}
+//# sourceMappingURL=agentTurnTraceStart.js.map

package/packages/happy2-server/dist/modules/agent/agentTurnTraceStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentTurnTraceStart.js","sourceRoot":"","sources":["../../../sources/modules/agent/agentTurnTraceStart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,QAAyB,EACzB,KAQC;IAED,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC;YACJ,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,eAAe,EAAE,UAAU,CAAC,eAAe;SAC9C,CAAC;aACD,IAAI,CAAC,UAAU,CAAC;aAChB,KAAK,CACF,GAAG,CACC,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,EACjD,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC7C,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EACzC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CACnC,CACJ;aACA,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QAErF,IAAI,SAAS,GAAG,IAAI,CAAC,kBAAkB,IAAI,SAAS,CAAC;QACrD,IAAI,IAAkB,CAAC;QACvB,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,EAAE,EAAE;gBAC/C,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,cAAc,EAAE,KAAK,CAAC,SAAS;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,gBAAgB,EAAE,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;gBAC5E,gBAAgB,EAAE,IAAI;gBACtB,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,EAAE;aACX,CAAC,CAAC;YACH,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAC1C,EAAE,EACF,QAAQ,EACR,KAAK,CAAC,WAAW,EACjB,KAAK,CAAC,MAAM,EACZ,mBAAmB,EACnB,SAAS,CACZ,CAAC;YACF,MAAM,EAAE;iBACH,MAAM,CAAC,QAAQ,CAAC;iBAChB,GAAG,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAA,mBAAmB,EAAE,CAAC;iBACnE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;YACvC,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,UAAU,CAAC;aAClB,GAAG,CAAC;YACD,kBAAkB,EAAE,SAAS;YAC7B,eAAe,EAAE,QAAQ;YACzB,gBAAgB,EAAE,eAAe;YACjC,iBAAiB,EAAE,IAAI;YACvB,aAAa,EAAE,UAAU;YACzB,eAAe,EAAE,CAAC;YAClB,SAAS,EAAE,GAAG,CAAA,mBAAmB;SACpC,CAAC;aACD,KAAK,CACF,GAAG,CACC,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,EACjD,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC7C,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EACzC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CACnC,CACJ;aACA,SAAS,CAAC,EAAE,EAAE,EAAE,UAAU,CAAC,aAAa,EAAE,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACjF,MAAM,EAAE;aACH,MAAM,CAAC,qBAAqB,CAAC;aAC7B,MAAM,CAAC;YACJ,EAAE,EAAE,QAAQ,EAAE;YACd,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,QAAQ,EAAE,MAAM;YAChB,cAAc,EAAE,cAAc,KAAK,CAAC,SAAS,EAAE;YAC/C,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,SAAS;YACjB,UAAU;SACb,CAAC;aACD,mBAAmB,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/packages/happy2-server/dist/modules/agent/impl/agentChatContext.d.ts

@@ -1,7 +1,7 @@
 import { type AgentExecutionImage } from "./agentExecutionImage.js";
 export interface AgentChatContext {
     agentUserId: string;
-    agentEffort?: string;
+    agentDefaultEffort?: string;
     chatId: string;
     image: AgentExecutionImage;
     sandboxScope: {
@@ -12,6 +12,7 @@ export interface AgentChatContext {
     binding?: {
         containerName: string;
         cwd: string;
+        effort?: string;
         sessionId: string;
     };
 }

package/packages/happy2-server/dist/modules/agent/impl/agentChatContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentChatContext.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentChatContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,YAAY,EAAE;QACV,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL"}
+{"version":3,"file":"agentChatContext.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentChatContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,YAAY,EAAE;QACV,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL"}

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContext.d.ts

@@ -1,6 +1,9 @@
 export interface AgentEffortContext {
     agentUserId: string;
+    agentUsername: string;
+    chatId: string;
+    defaultEffort?: string;
     effort?: string;
-    sessionIds: string[];
+    sessionId: string;
 }
 //# sourceMappingURL=agentEffortContext.d.ts.map

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentEffortContext.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB"}
+{"version":3,"file":"agentEffortContext.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContextDb.d.ts

@@ -1,8 +1,8 @@
 import { type AgentEffortContext } from "./agentEffortContext.js";
 import { type DrizzleExecutor } from "../../drizzle.js";
 /**
- * Loads a live agent's optional effort and chat-ordered session bindings for an active actor, with an optional creator-or-administrator management check.
- * Keeping that authorization beside the projection prevents effort reads and updates from disagreeing about who controls the agent.
+ * Loads one accessible chat's active agent membership, durable effort override, profile default, and bound Rig session.
+ * Requiring both memberships and the exact chat-agent binding keeps a chat-level selection isolated from every other conversation using the agent.
  */
-export declare function agentEffortContextDb(executor: DrizzleExecutor, actorUserId: string, agentUserId: string, requireManagement: boolean): Promise<AgentEffortContext>;
+export declare function agentEffortContextDb(executor: DrizzleExecutor, actorUserId: string, chatId: string, agentUserId: string): Promise<AgentEffortContext>;
 //# sourceMappingURL=agentEffortContextDb.d.ts.map

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContextDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentEffortContextDb.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContextDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKxD;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,OAAO,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA0C7B"}
+{"version":3,"file":"agentEffortContextDb.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContextDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD;;;GAGG;AACH,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContextDb.js

@@ -1,52 +1,38 @@
 import {} from "./agentEffortContext.js";
 import { CollaborationError } from "../../chat/types.js";
 import {} from "../../drizzle.js";
-import { agentRigBindings, users } from "../../schema.js";
+import { agentRigBindings, chatMembers, users } from "../../schema.js";
 import { and, eq, isNull } from "drizzle-orm";
-import { userRequireActive } from "../../chat/userRequireActive.js";
+import { chatGetAccess } from "../../chat/chatGetAccess.js";
 /**
- * Loads a live agent's optional effort and chat-ordered session bindings for an active actor, with an optional creator-or-administrator management check.
- * Keeping that authorization beside the projection prevents effort reads and updates from disagreeing about who controls the agent.
+ * Loads one accessible chat's active agent membership, durable effort override, profile default, and bound Rig session.
+ * Requiring both memberships and the exact chat-agent binding keeps a chat-level selection isolated from every other conversation using the agent.
  */
-export async function agentEffortContextDb(executor, actorUserId, agentUserId, requireManagement) {
-    await userRequireActive(executor, actorUserId);
-    const [[actor], [agent], bindings] = await Promise.all([
-        executor
-            .select({
-            role: users.role,
-        })
-            .from(users)
-            .where(eq(users.id, actorUserId))
-            .limit(1),
-        executor
-            .select({
-            createdByUserId: users.createdByUserId,
-            effort: users.agentEffort,
-            id: users.id,
-        })
-            .from(users)
-            .where(and(eq(users.id, agentUserId), eq(users.kind, "agent"), isNull(users.deletedAt)))
-            .limit(1),
-        executor
-            .select({
-            sessionId: agentRigBindings.sessionId,
-        })
-            .from(agentRigBindings)
-            .where(eq(agentRigBindings.userId, agentUserId))
-            .orderBy(agentRigBindings.chatId),
-    ]);
+export async function agentEffortContextDb(executor, actorUserId, chatId, agentUserId) {
+    if (!(await chatGetAccess(executor, actorUserId, chatId, true)))
+        throw new CollaborationError("not_found", "Agent conversation was not found");
+    const [agent] = await executor
+        .select({
+        defaultEffort: users.agentEffort,
+        effort: agentRigBindings.effort,
+        id: users.id,
+        sessionId: agentRigBindings.sessionId,
+        username: users.username,
+    })
+        .from(chatMembers)
+        .innerJoin(users, eq(users.id, chatMembers.userId))
+        .innerJoin(agentRigBindings, and(eq(agentRigBindings.userId, users.id), eq(agentRigBindings.chatId, chatMembers.chatId)))
+        .where(and(eq(chatMembers.chatId, chatId), eq(chatMembers.userId, agentUserId), isNull(chatMembers.leftAt), eq(users.kind, "agent"), isNull(users.deletedAt)))
+        .limit(1);
     if (!agent)
-        throw new CollaborationError("not_found", "Agent was not found");
-    if (requireManagement && actor?.role !== "admin" && agent.createdByUserId !== actorUserId)
-        throw new CollaborationError("forbidden", "Only the agent creator or a server admin can change its effort");
+        throw new CollaborationError("conflict", "Agent does not have an active Rig session in this chat");
     return {
         agentUserId: agent.id,
-        ...(agent.effort
-            ? {
-                effort: agent.effort,
-            }
-            : {}),
-        sessionIds: bindings.map((binding) => binding.sessionId),
+        agentUsername: agent.username,
+        chatId,
+        ...(agent.defaultEffort ? { defaultEffort: agent.defaultEffort } : {}),
+        ...(agent.effort ? { effort: agent.effort } : {}),
+        sessionId: agent.sessionId,
     };
 }
 //# sourceMappingURL=agentEffortContextDb.js.map

package/packages/happy2-server/dist/modules/agent/impl/agentEffortContextDb.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentEffortContextDb.js","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContextDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAwB,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,QAAyB,EACzB,WAAmB,EACnB,WAAmB,EACnB,iBAA0B;IAE1B,MAAM,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnD,QAAQ;aACH,MAAM,CAAC;YACJ,IAAI,EAAE,KAAK,CAAC,IAAI;SACnB,CAAC;aACD,IAAI,CAAC,KAAK,CAAC;aACX,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;aAChC,KAAK,CAAC,CAAC,CAAC;QACb,QAAQ;aACH,MAAM,CAAC;YACJ,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,MAAM,EAAE,KAAK,CAAC,WAAW;YACzB,EAAE,EAAE,KAAK,CAAC,EAAE;SACf,CAAC;aACD,IAAI,CAAC,KAAK,CAAC;aACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;aACvF,KAAK,CAAC,CAAC,CAAC;QACb,QAAQ;aACH,MAAM,CAAC;YACJ,SAAS,EAAE,gBAAgB,CAAC,SAAS;SACxC,CAAC;aACD,IAAI,CAAC,gBAAgB,CAAC;aACtB,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;aAC/C,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC;IACH,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAC7E,IAAI,iBAAiB,IAAI,KAAK,EAAE,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,eAAe,KAAK,WAAW;QACrF,MAAM,IAAI,kBAAkB,CACxB,WAAW,EACX,gEAAgE,CACnE,CAAC;IACN,OAAO;QACH,WAAW,EAAE,KAAK,CAAC,EAAE;QACrB,GAAG,CAAC,KAAK,CAAC,MAAM;YACZ,CAAC,CAAC;gBACI,MAAM,EAAE,KAAK,CAAC,MAAM;aACvB;YACH,CAAC,CAAC,EAAE,CAAC;QACT,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;KAC3D,CAAC;AACN,CAAC"}
+{"version":3,"file":"agentEffortContextDb.js","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/agentEffortContextDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAwB,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE5D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,QAAyB,EACzB,WAAmB,EACnB,MAAc,EACd,WAAmB;IAEnB,IAAI,CAAC,CAAC,MAAM,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3D,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAC;IAClF,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,QAAQ;SACzB,MAAM,CAAC;QACJ,aAAa,EAAE,KAAK,CAAC,WAAW;QAChC,MAAM,EAAE,gBAAgB,CAAC,MAAM;QAC/B,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,SAAS,EAAE,gBAAgB,CAAC,SAAS;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAC;SACD,IAAI,CAAC,WAAW,CAAC;SACjB,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;SAClD,SAAS,CACN,gBAAgB,EAChB,GAAG,CACC,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EACrC,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAClD,CACJ;SACA,KAAK,CACF,GAAG,CACC,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAC1B,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAC1B,CACJ;SACA,KAAK,CAAC,CAAC,CAAC,CAAC;IACd,IAAI,CAAC,KAAK;QACN,MAAM,IAAI,kBAAkB,CACxB,UAAU,EACV,wDAAwD,CAC3D,CAAC;IACN,OAAO;QACH,WAAW,EAAE,KAAK,CAAC,EAAE;QACrB,aAAa,EAAE,KAAK,CAAC,QAAQ;QAC7B,MAAM;QACN,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,SAAS,EAAE,KAAK,CAAC,SAAS;KAC7B,CAAC;AACN,CAAC"}

package/packages/happy2-server/dist/modules/agent/impl/finishAgentTurn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finishAgentTurn.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/finishAgentTurn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAgB7E;;;GAGG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB,GACF,OAAO,CACJ;IACI,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;CACtB,GACD,SAAS,CACd,CAiIA"}
+{"version":3,"file":"finishAgentTurn.d.ts","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/finishAgentTurn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAoB7E;;;GAGG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,mBAAmB,GAAG,gBAAgB,CAAC;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB,GACF,OAAO,CACJ;IACI,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;CACtB,GACD,SAAS,CACd,CAsMA"}

package/packages/happy2-server/dist/modules/agent/impl/finishAgentTurn.js

@@ -1,7 +1,8 @@
 import { withTransaction } from "../../drizzle.js";
 import {} from "../../chat/types.js";
+import { createId } from "@paralleldrive/cuid2";
 import { agentReplyMutationId } from "./agentReplyMutationId.js";
-import { agentTurns, messages } from "../../schema.js";
+import { agentTurnTraceEntries, agentTurns, messages } from "../../schema.js";
 import { and, eq, sql } from "drizzle-orm";
 import { chatHint } from "../../chat/chatHint.js";
 import { chatAdvanceWithSequence } from "../../chat/chatAdvanceWithSequence.js";
@@ -12,20 +13,37 @@ import { syncSequenceNext } from "../../sync/syncSequenceNext.js";
 import { messageRecordDelivery } from "../../message/messageRecordDelivery.js";
 import { messageReplaceMentions } from "../../message/messageReplaceMentions.js";
 import { messageSendInTransaction } from "../../message/messageSendInTransaction.js";
+const MAX_TRACE_DETAIL_CHARACTERS = 64 * 1_024;
+const MAX_TRACE_SUMMARY_CHARACTERS = 500;
 /**
  * Finalizes agentTurns and their messages output, including the terminal chat and search projections produced by the run.
  * The worker-facing transaction prevents a completed lease from being visible before its final answer is durable and searchable.
  */
 export async function finishAgentTurn(executor, input) {
     return withTransaction(executor, async (tx) => {
+        const [lastTrace] = await tx
+            .select({
+            occurredAt: sql `coalesce(max(${agentTurnTraceEntries.occurredAt}), 0)`,
+        })
+            .from(agentTurnTraceEntries)
+            .where(and(eq(agentTurnTraceEntries.userMessageId, input.userMessageId), eq(agentTurnTraceEntries.agentUserId, input.agentUserId)));
+        const occurredAt = Math.min(Number.MAX_SAFE_INTEGER, Math.max(Date.now(), Number(lastTrace?.occurredAt ?? 0) + 1));
+        const traceTitle = input.status === "complete" ? "Turn completed" : "Turn failed";
+        const errorDetail = boundedTraceDetail(input.lastError);
         const [turn] = await tx
             .update(agentTurns)
             .set({
             status: input.status,
-            lastError: input.lastError ?? null,
+            lastError: errorDetail ?? null,
             workerId: null,
             leaseExpiresAt: null,
             completedAt: sql `CURRENT_TIMESTAMP`,
+            traceLatestKind: "status",
+            traceLatestTitle: traceTitle,
+            traceLatestDetail: latestTraceLine(errorDetail) ?? null,
+            traceLatestAt: occurredAt,
+            traceSubagentsJson: "[]",
+            traceBackgroundTerminalsJson: "[]",
             updatedAt: sql `CURRENT_TIMESTAMP`,
         })
             .where(and(eq(agentTurns.userMessageId, input.userMessageId), eq(agentTurns.agentUserId, input.agentUserId), eq(agentTurns.sessionId, input.sessionId), eq(agentTurns.workerId, input.workerId), eq(agentTurns.status, "running")))
@@ -35,6 +53,35 @@ export async function finishAgentTurn(executor, input) {
         });
         if (!turn)
             return undefined;
+        await tx
+            .update(agentTurnTraceEntries)
+            .set({
+            status: input.status === "complete" ? "complete" : "failed",
+            completedAt: occurredAt,
+            updatedAt: sql `CURRENT_TIMESTAMP`,
+        })
+            .where(and(eq(agentTurnTraceEntries.userMessageId, input.userMessageId), eq(agentTurnTraceEntries.agentUserId, input.agentUserId), eq(agentTurnTraceEntries.status, "running")));
+        await tx.insert(agentTurnTraceEntries).values({
+            id: createId(),
+            userMessageId: input.userMessageId,
+            agentUserId: input.agentUserId,
+            traceKey: "turn-result",
+            sessionEventId: `turn-result:${occurredAt}`,
+            kind: "status",
+            title: traceTitle,
+            detail: errorDetail,
+            status: input.status === "complete" ? "complete" : "failed",
+            occurredAt,
+            completedAt: occurredAt,
+        });
+        const [traceCount] = await tx
+            .select({ value: sql `count(*)` })
+            .from(agentTurnTraceEntries)
+            .where(and(eq(agentTurnTraceEntries.userMessageId, input.userMessageId), eq(agentTurnTraceEntries.agentUserId, input.agentUserId)));
+        await tx
+            .update(agentTurns)
+            .set({ traceEntryCount: Number(traceCount?.value ?? 0) })
+            .where(and(eq(agentTurns.userMessageId, input.userMessageId), eq(agentTurns.agentUserId, input.agentUserId), eq(agentTurns.status, input.status)));
         let created;
         let messageId = turn.assistantMessageId ?? undefined;
         if (!messageId) {
@@ -120,4 +167,18 @@ export async function finishAgentTurn(executor, input) {
         };
     });
 }
+function boundedTraceDetail(value) {
+    const detail = value?.trim().slice(-MAX_TRACE_DETAIL_CHARACTERS);
+    return detail || undefined;
+}
+function latestTraceLine(value) {
+    if (!value)
+        return undefined;
+    const line = value
+        .split(/\r?\n/u)
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .at(-1);
+    return line?.slice(-MAX_TRACE_SUMMARY_CHARACTERS);
+}
 //# sourceMappingURL=finishAgentTurn.js.map

package/packages/happy2-server/dist/modules/agent/impl/finishAgentTurn.js.map

@@ -1 +1 @@
-{"version":3,"file":"finishAgentTurn.js","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/finishAgentTurn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAA0C,MAAM,qBAAqB,CAAC;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,QAAyB,EACzB,KAUC;IAQD,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;QAC1C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE;aAClB,MAAM,CAAC,UAAU,CAAC;aAClB,GAAG,CAAC;YACD,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI;YAClC,QAAQ,EAAE,IAAI;YACd,cAAc,EAAE,IAAI;YACpB,WAAW,EAAE,GAAG,CAAA,mBAAmB;YACnC,SAAS,EAAE,GAAG,CAAA,mBAAmB;SACpC,CAAC;aACD,KAAK,CACF,GAAG,CACC,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,EACjD,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC7C,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EACzC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,EACvC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CACnC,CACJ;aACA,SAAS,CAAC;YACP,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAC;QACP,IAAI,CAAC,IAAI;YAAE,OAAO,SAAS,CAAC;QAC5B,IAAI,OAKW,CAAC;QAChB,IAAI,SAAS,GAAG,IAAI,CAAC,kBAAkB,IAAI,SAAS,CAAC;QACrD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,GAAG,MAAM,wBAAwB,CAAC,EAAE,EAAE;gBACzC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,cAAc,EAAE,KAAK,CAAC,SAAS;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,gBAAgB,EAAE,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC;gBAC5E,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK,CAAC,IAAI;aACnB,CAAC,CAAC;YACH,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,EAAE;iBAClB,MAAM,CAAC,UAAU,CAAC;iBAClB,GAAG,CAAC;gBACD,kBAAkB,EAAE,SAAS;aAChC,CAAC;iBACD,KAAK,CACF,GAAG,CACC,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,EACjD,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,EAC7C,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,EACzC,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CACtC,CACJ;iBACA,SAAS,CAAC;gBACP,EAAE,EAAE,UAAU,CAAC,kBAAkB;aACpC,CAAC,CAAC;YACP,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACrF,CAAC;QACD,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE;aACxB,MAAM,CAAC;YACJ,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,IAAI,EAAE,QAAQ,CAAC,IAAI;SACtB,CAAC;aACD,IAAI,CAAC,QAAQ,CAAC;aACd,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;aACjC,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAChE,IAAI,OAAO,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAC7E,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAClE,OAAO;gBACH,OAAO;gBACP,IAAI,EAAE,OAAO,CAAC,IAAI;aACrB,CAAC;QACN,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAC1C,EAAE,EACF,QAAQ,EACR,KAAK,CAAC,WAAW,EACjB,IAAI,CAAC,MAAM,EACX,KAAK,CAAC,SAAS,EACf,SAAS,CACZ,CAAC;QACF,MAAM,EAAE;aACH,MAAM,CAAC,QAAQ,CAAC;aAChB,GAAG,CAAC;YACD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,SAAS,EAAE,QAAQ,CAAC,GAAG;YACvB,WAAW,EAAE,GAAG,CAAA,YAAY,QAAQ,CAAC,WAAW,sBAAsB;YACtE,SAAS,EAAE,GAAG,CAAA,mBAAmB;SACpC,CAAC;aACD,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QACvC,IAAI,QAKW,CAAC;QAChB,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YACpE,QAAQ,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,UAAU,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3E,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAC9D,MAAM,qBAAqB,CAAC,EAAE,EAAE;gBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,IAAI;gBACJ,SAAS;gBACT,eAAe,EAAE,UAAU,CAAC,QAAQ;gBACpC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,IAAI,EAAE;gBACzC,UAAU,EAAE,QAAQ,EAAE,SAAS;gBAC/B,uBAAuB,EAAE,IAAI;gBAC7B,YAAY,EAAE,KAAK,CAAC,WAAW;gBAC/B,YAAY,EAAE,QAAQ;aACzB,CAAC,CAAC;QACP,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC3E,OAAO;YACH,OAAO;YACP,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC;SACtD,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"finishAgentTurn.js","sourceRoot":"","sources":["../../../../sources/modules/agent/impl/finishAgentTurn.ts"],"names":[],"mappings":"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"}

package/packages/happy2-server/dist/modules/agent/types.d.ts

@@ -5,4 +5,57 @@ export interface RigEventCheckpoint {
     lastTrimmedAt: string;
     trimmedThrough?: number;
 }
+export type AgentTurnTraceKind = "reasoning" | "response" | "tool" | "subagent" | "terminal" | "status";
+export type AgentTurnTraceEntryStatus = "running" | "complete" | "failed";
+/** One durable, coalesced span in an agent turn's execution history. */
+export interface AgentTurnTraceUpdate {
+    traceKey: string;
+    sessionEventId: string;
+    kind: AgentTurnTraceKind;
+    title: string;
+    detail?: string;
+    status: AgentTurnTraceEntryStatus;
+    occurredAt: number;
+    completedAt?: number;
+}
+/** The live public projection of one Rig subagent belonging to a turn. */
+export interface AgentTurnSubagentSummary {
+    id: string;
+    depth: number;
+    description: string;
+    status: "idle" | "queued" | "running" | "completed" | "aborted" | "suspended" | "error";
+    latestText?: string;
+    startedAt: number;
+    totalTokens: number;
+}
+/** The live public projection of one background terminal belonging to a turn. */
+export interface AgentTurnBackgroundTerminalSummary {
+    id: string;
+    command: string;
+    cwd: string;
+    startedAt: number;
+}
+export interface AgentTurnTraceEntrySummary {
+    id: string;
+    kind: AgentTurnTraceKind;
+    title: string;
+    detail?: string;
+    status: AgentTurnTraceEntryStatus;
+    occurredAt: number;
+    completedAt?: number;
+}
+export interface AgentTurnTraceSummary {
+    turnId: string;
+    agentUserId: string;
+    status: "pending" | "running" | "complete" | "failed";
+    startedAt?: string;
+    completedAt?: string;
+    latest?: Omit<AgentTurnTraceEntrySummary, "id" | "status" | "completedAt">;
+    entryCount: number;
+    subagents: AgentTurnSubagentSummary[];
+    backgroundTerminals: AgentTurnBackgroundTerminalSummary[];
+}
+export interface AgentTurnTraceDetails extends AgentTurnTraceSummary {
+    entries: AgentTurnTraceEntrySummary[];
+}
 //# sourceMappingURL=types.d.ts.map

package/packages/happy2-server/dist/modules/agent/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sources/modules/agent/types.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sources/modules/agent/types.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GACxB,WAAW,GACX,UAAU,GACV,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEf,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1E,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,0EAA0E;AAC1E,MAAM,WAAW,wBAAwB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,iFAAiF;AACjF,MAAM,WAAW,kCAAkC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,yBAAyB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,GAAG,QAAQ,GAAG,aAAa,CAAC,CAAC;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,wBAAwB,EAAE,CAAC;IACtC,mBAAmB,EAAE,kCAAkC,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,qBAAsB,SAAQ,qBAAqB;IAChE,OAAO,EAAE,0BAA0B,EAAE,CAAC;CACzC"}