Interface: AgentTrajectoryRequest

@kortexya/reasoninglayer

---

@kortexya/reasoninglayer / AgentTrajectoryRequest

Interface: AgentTrajectoryRequest

Defined in: src/types/cognitive.ts:1521

Request a trajectory/trend summary over an agent’s episodes.

Remarks

asOfTs and the summary itself use unix seconds (not milliseconds).

Example

const trend = await client.cognitive.getMemoryTrajectory({
  agentId,
  metric: 'success_rate',
});
console.log(trend.direction); // "improving" | "declining" | "flat"

Properties

agentId

agentId: string

Defined in: src/types/cognitive.ts:1523

Agent whose episodes are summarized (UUID).

---

asOfTs?

optional asOfTs?: number | null

Defined in: src/types/cognitive.ts:1530

Optional as-of ceiling (unix seconds): only episodes recorded at or before this instant contribute (memory time-travel). Omit to consider all episodes.

---

maxResults?

optional maxResults?: number | null

Defined in: src/types/cognitive.ts:1532

Cap on episodes considered (default: 1000).

---

metric?

optional metric?: string | null

Defined in: src/types/cognitive.ts:1534

Metric to summarize: "success_rate" (default) or "reward".

---

tenantId

tenantId: string

Defined in: src/types/cognitive.ts:1525

Tenant ID (UUID).