@crossworks/client-types 0.232.83 → 0.232.85

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/client-types",
-  "version": "0.232.83",
+  "version": "0.232.85",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -326,6 +326,36 @@ export interface PersonaNoteDTO {
   supersededBy?: string;
 }
 
+/** Raw counters behind an agent's experience level — always shipped next to
+ *  the level so the UI can show WHY it is level N. All are lifetime counts for
+ *  THIS brain (experience is per-brain, display-only — never a trust gate). */
+export interface AgentExperienceComponentsDTO {
+  /** Completed conversation turns this agent answered on the assistant
+   *  stream (web, Telegram, mobile). Team/forum turns live in a different
+   *  store and are not counted (yet). */
+  turns: number;
+  /** Tool calls that succeeded across those turns. */
+  toolSuccesses: number;
+  /** Delegated runs this agent completed for other agents. */
+  delegations: number;
+  /** Heartbeat fires this agent completed. */
+  heartbeats: number;
+}
+
+/** An agent's experience readout — a soft-capped level derived from real
+ *  accumulated usage (see `agent-experience.ts` server-side for the weights
+ *  and curve). Computed at read time; nothing is stored. */
+export interface AgentExperienceDTO {
+  level: number;
+  /** Total XP earned. */
+  xp: number;
+  /** Cumulative XP at which the current level began. */
+  levelXp: number;
+  /** Cumulative XP needed to reach the next level. */
+  nextLevelXp: number;
+  components: AgentExperienceComponentsDTO;
+}
+
 /** An agent as returned by `GET /api/agents` (and `…/[id]`). Dates are ISO
  *  strings. The server aliases its `AgentSummary` to this so the wire shape and
  *  the consuming client can't drift. */
@@ -371,6 +401,11 @@ export interface AgentDTO {
   manifestManaged: boolean;
   lastUsedAt: string | null;
   usageCount: number;
+  /** Experience readout (level + raw counters). Optional: filled on the list
+   *  reads the agent screens use (`GET /api/agents`, the assistant thread
+   *  bundle); absent on single-row CRUD echoes where computing it would cost
+   *  extra queries for nothing. */
+  experience?: AgentExperienceDTO;
   createdAt: string;
   updatedAt: string;
 }

package/src/journey-format.ts

@@ -247,6 +247,20 @@ export type ActivityItem = ActionPresentation & {
   factCount: number;
   mentionCount: number;
   relationCount: number;
+  /** Who performed the action. Null for pipeline traces that carry no agent
+   *  (extractor/summarizer runs identify via workerSlug instead; ingest and
+   *  federation traces have neither). */
+  agentId: string | null;
+  agentName: string | null;
+  agentSlug: string | null;
+  /** Seed for GeneratedAvatar: the agent's stored avatar seed, falling back
+   *  to its slug (same convention the settings screens use). */
+  avatarSeed: string | null;
+  /** ai-worker identity for worker-driven traces (extractor, summarizer). */
+  workerSlug: string | null;
+  /** Set on delegated child runs (invoke_agent) — the parent trace's id, so
+   *  the UI can nest fan-out under the delegating turn. */
+  parentTraceId: string | null;
 };
 
 export type JourneyDetail = TraceDetail & { landed: LandedLayers | null };