@elizaos/agent 2.0.0-alpha.173 → 2.0.0-alpha.192

package/packages/agent/src/triggers/scheduling.js

@@ -38,22 +38,24 @@ function parseCronPart(part, range) {
         const chunk = chunkRaw.trim();
         if (!chunk)
             return null;
-        const stepParts = chunk.split("/");
-        if (stepParts.length > 2)
+        const [baseRaw, stepRaw, extraStep] = chunk.split("/");
+        if (baseRaw === undefined || extraStep !== undefined)
             return null;
-        const step = stepParts.length === 2 ? parseInteger(stepParts[1].trim()) : 1;
+        const step = stepRaw === undefined ? 1 : parseInteger(stepRaw.trim());
         if (step === null || step <= 0)
             return null;
-        const base = stepParts[0].trim();
+        const base = baseRaw.trim();
         if (base === "*") {
             for (let value = range.min; value <= range.max; value += step) {
                 output.add(value);
             }
             continue;
         }
-        const rangeParts = base.split("-");
-        if (rangeParts.length === 1) {
-            const single = parseInteger(rangeParts[0].trim());
+        const [rangeStartRaw, rangeEndRaw, extraRange] = base.split("-");
+        if (rangeStartRaw === undefined || extraRange !== undefined)
+            return null;
+        if (rangeEndRaw === undefined) {
+            const single = parseInteger(rangeStartRaw.trim());
             if (single === null)
                 return null;
             if (single < range.min || single > range.max)
@@ -61,10 +63,8 @@ function parseCronPart(part, range) {
             output.add(single);
             continue;
         }
-        if (rangeParts.length !== 2)
-            return null;
-        const start = parseInteger(rangeParts[0].trim());
-        const end = parseInteger(rangeParts[1].trim());
+        const start = parseInteger(rangeStartRaw.trim());
+        const end = parseInteger(rangeEndRaw.trim());
         if (start === null || end === null)
             return null;
         if (start > end)
@@ -84,11 +84,19 @@ export function parseCronExpression(expression) {
     const parts = trimmed.split(/\s+/);
     if (parts.length !== CRON_FIELDS)
         return null;
-    const minute = parseCronPart(parts[0], CRON_RANGES[0]);
-    const hour = parseCronPart(parts[1], CRON_RANGES[1]);
-    const dayOfMonth = parseCronPart(parts[2], CRON_RANGES[2]);
-    const month = parseCronPart(parts[3], CRON_RANGES[3]);
-    const dayOfWeek = parseCronPart(parts[4], CRON_RANGES[4]);
+    const [minuteExpr, hourExpr, dayOfMonthExpr, monthExpr, dayOfWeekExpr] = parts;
+    if (minuteExpr === undefined ||
+        hourExpr === undefined ||
+        dayOfMonthExpr === undefined ||
+        monthExpr === undefined ||
+        dayOfWeekExpr === undefined) {
+        return null;
+    }
+    const minute = parseCronPart(minuteExpr, CRON_RANGES[0]);
+    const hour = parseCronPart(hourExpr, CRON_RANGES[1]);
+    const dayOfMonth = parseCronPart(dayOfMonthExpr, CRON_RANGES[2]);
+    const month = parseCronPart(monthExpr, CRON_RANGES[3]);
+    const dayOfWeek = parseCronPart(dayOfWeekExpr, CRON_RANGES[4]);
     if (!minute || !hour || !dayOfMonth || !month || !dayOfWeek) {
         return null;
     }
@@ -218,14 +226,19 @@ export function buildTriggerMetadata(params) {
     };
 }
 export function buildTriggerDedupeKey(parts) {
-    const normalized = [
+    const effectiveKind = parts.kind ?? "text";
+    const normalizedParts = [
         parts.triggerType,
         normalizeText(parts.instructions).toLowerCase(),
         String(parts.intervalMs ?? ""),
         parts.scheduledAtIso ?? "",
         parts.cronExpression ?? "",
         parts.wakeMode,
-    ].join("|");
+    ];
+    if (effectiveKind === "workflow") {
+        normalizedParts.push(effectiveKind, parts.workflowId ?? "");
+    }
+    const normalized = normalizedParts.join("|");
     let hash = 5381;
     for (const char of normalized) {
         hash = (hash * 33) ^ char.charCodeAt(0);
@@ -262,18 +275,42 @@ export function buildTriggerConfig(params) {
             scheduledAtIso: params.draft.scheduledAtIso,
             cronExpression: params.draft.cronExpression,
             wakeMode: params.draft.wakeMode,
+            kind: params.draft.kind,
+            workflowId: params.draft.workflowId,
         }),
         nextRunAtMs: previous?.nextRunAtMs,
         lastRunAtIso: previous?.lastRunAtIso,
         lastStatus: previous?.lastStatus,
         lastError: previous?.lastError,
+        kind: params.draft.kind,
+        workflowId: params.draft.workflowId,
+        workflowName: params.draft.workflowName,
     };
 }
 export function normalizeTriggerDraft(params) {
+    const kind = params.input.kind;
+    const workflowId = params.input.workflowId?.trim();
+    const workflowName = params.input.workflowName?.trim();
     const displayName = normalizeText(params.input.displayName ?? "") ||
         normalizeText(params.fallback.displayName);
-    const instructions = normalizeText(params.input.instructions ?? "") ||
-        normalizeText(params.fallback.instructions);
+    // Workflow-kind triggers don't require user-provided instructions; we
+    // synthesize them so display/dedupe logic downstream keeps working.
+    let instructions;
+    if (kind === "workflow") {
+        if (!workflowId) {
+            return { error: "workflowId is required for workflow triggers" };
+        }
+        const synthesized = `Run workflow ${workflowName ?? workflowId}`;
+        instructions =
+            normalizeText(params.input.instructions ?? "") ||
+                normalizeText(params.fallback.instructions) ||
+                normalizeText(synthesized);
+    }
+    else {
+        instructions =
+            normalizeText(params.input.instructions ?? "") ||
+                normalizeText(params.fallback.instructions);
+    }
     if (!displayName) {
         return { error: "displayName is required" };
     }
@@ -315,6 +352,9 @@ export function normalizeTriggerDraft(params) {
                 timezone,
                 intervalMs,
                 maxRuns,
+                kind,
+                workflowId,
+                workflowName,
             },
         };
     }
@@ -333,6 +373,9 @@ export function normalizeTriggerDraft(params) {
                 timezone,
                 scheduledAtIso,
                 maxRuns,
+                kind,
+                workflowId,
+                workflowName,
             },
         };
     }
@@ -350,6 +393,9 @@ export function normalizeTriggerDraft(params) {
             timezone,
             cronExpression,
             maxRuns,
+            kind,
+            workflowId,
+            workflowName,
         },
     };
 }

package/packages/agent/src/triggers/types.d.ts

@@ -1,40 +1,5 @@
-import type { UUID } from "@elizaos/core";
-export declare const TRIGGER_SCHEMA_VERSION: 1;
-export type TriggerType = "interval" | "once" | "cron";
-export type TriggerWakeMode = "inject_now" | "next_autonomy_cycle";
-export type TriggerLastStatus = "success" | "error" | "skipped";
-export interface TriggerConfig {
-    version: typeof TRIGGER_SCHEMA_VERSION;
-    triggerId: UUID;
-    displayName: string;
-    instructions: string;
-    triggerType: TriggerType;
-    enabled: boolean;
-    wakeMode: TriggerWakeMode;
-    createdBy: string;
-    timezone?: string;
-    intervalMs?: number;
-    scheduledAtIso?: string;
-    cronExpression?: string;
-    maxRuns?: number;
-    runCount: number;
-    dedupeKey?: string;
-    nextRunAtMs?: number;
-    lastRunAtIso?: string;
-    lastStatus?: TriggerLastStatus;
-    lastError?: string;
-}
-export interface TriggerRunRecord {
-    triggerRunId: UUID;
-    triggerId: UUID;
-    taskId: UUID;
-    startedAt: number;
-    finishedAt: number;
-    status: TriggerLastStatus;
-    error?: string;
-    latencyMs: number;
-    source: "scheduler" | "manual";
-}
+import type { TriggerConfig, TriggerKind, TriggerLastStatus, TriggerRunRecord, TriggerType, TriggerWakeMode, UUID } from "@elizaos/core";
+export { TRIGGER_SCHEMA_VERSION, type TriggerConfig, type TriggerKind, type TriggerLastStatus, type TriggerRunRecord, type TriggerType, type TriggerWakeMode, } from "@elizaos/core";
 export interface TriggerTaskMetadata {
     updatedAt?: number;
     updateInterval?: number;
@@ -64,6 +29,9 @@ export interface TriggerSummary {
     lastError?: string;
     updatedAt?: number;
     updateInterval?: number;
+    kind?: TriggerKind;
+    workflowId?: string;
+    workflowName?: string;
 }
 export interface TriggerHealthSnapshot {
     triggersEnabled: boolean;
@@ -86,6 +54,9 @@ export interface CreateTriggerRequest {
     scheduledAtIso?: string;
     cronExpression?: string;
     maxRuns?: number;
+    kind?: TriggerKind;
+    workflowId?: string;
+    workflowName?: string;
 }
 export interface UpdateTriggerRequest {
     displayName?: string;
@@ -98,6 +69,9 @@ export interface UpdateTriggerRequest {
     scheduledAtIso?: string;
     cronExpression?: string;
     maxRuns?: number;
+    kind?: TriggerKind;
+    workflowId?: string;
+    workflowName?: string;
 }
 export interface NormalizedTriggerDraft {
     displayName: string;
@@ -111,5 +85,8 @@ export interface NormalizedTriggerDraft {
     scheduledAtIso?: string;
     cronExpression?: string;
     maxRuns?: number;
+    kind?: TriggerKind;
+    workflowId?: string;
+    workflowName?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/packages/agent/src/triggers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/triggers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,eAAO,MAAM,sBAAsB,EAAG,CAAU,CAAC;AAEjD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,qBAAqB,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,sBAAsB,CAAC;IACvC,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACjC,CAAC,GAAG,EAAE,MAAM,GACR,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,EAAE,GACR,MAAM,EAAE,GACR,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GACzC,SAAS,GACT,aAAa,GACb,gBAAgB,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,eAAe,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/triggers/types.ts"],"names":[],"mappings":"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"}

package/packages/agent/src/triggers/types.js

@@ -1 +1 @@
-export const TRIGGER_SCHEMA_VERSION = 1;
+export { TRIGGER_SCHEMA_VERSION, } from "@elizaos/core";

package/packages/agent/src/types/trajectory.d.ts

@@ -67,12 +67,53 @@ export interface TrajectoryProviderAccess {
     query?: Record<string, unknown>;
     timestamp?: number;
 }
+/**
+ * Discriminator for the kind of work a trajectory step represents.
+ *
+ * - `"llm"`: a model call step (the historical default — emitted whenever an
+ *   LLM call is logged against a step that has no other classification).
+ * - `"action"`: a single action handler invocation step.
+ * - `"executeCode"`: a code-execution wrapper step that may have child steps
+ *   under `childSteps` (each child action dispatched from within the script
+ *   inherits `parentStepId` via `TrajectoryContext`).
+ */
+export type TrajectoryStepKind = "llm" | "action" | "executeCode";
+export type TrajectoryStepId = string;
 export interface TrajectoryStep {
-    stepId?: string;
+    stepId?: TrajectoryStepId;
     timestamp: number;
     llmCalls?: TrajectoryLlmCall[];
     providerAccesses?: TrajectoryProviderAccess[];
+    /**
+     * Discriminator for what produced this step. Defaults to `"llm"` for legacy
+     * rows that predate the field. Persisted in `steps_json`.
+     */
+    kind?: TrajectoryStepKind;
+    /**
+     * Step IDs of child steps spawned underneath this step (used by
+     * `executeCode` steps to enumerate the action calls dispatched from the
+     * script). Order is significant — earliest dispatch first.
+     */
+    childSteps?: TrajectoryStepId[];
+    /**
+     * Source script for `executeCode` steps. Capped at 4096 characters; if the
+     * original script exceeds the cap, `script` holds the truncated prefix and
+     * `scriptHash` carries the sha256 of the full source.
+     */
+    script?: string;
+    /**
+     * sha256 hex digest of the full script source when the script exceeded the
+     * inline cap and was truncated into `script`. Optional otherwise.
+     */
+    scriptHash?: string;
+    /**
+     * Names of skills the step relied on (populated by Track C). Empty/undefined
+     * when no skill annotation is available.
+     */
+    usedSkills?: string[];
 }
+/** Maximum bytes of script source persisted inline on a trajectory step. */
+export declare const TRAJECTORY_STEP_SCRIPT_MAX_CHARS = 4096;
 export interface Trajectory {
     trajectoryId: string;
     agentId: string;

package/packages/agent/src/types/trajectory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../../../../src/types/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,wBAAwB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEpE,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../../../../src/types/trajectory.ts"],"names":[],"mappings":"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"}

package/packages/agent/src/types/trajectory.js

@@ -4,4 +4,5 @@
  * Used by both the persistence layer (runtime/trajectory-persistence.ts)
  * and the API routes (api/trajectory-routes.ts).
  */
-export {};
+/** Maximum bytes of script source persisted inline on a trajectory step. */
+export const TRAJECTORY_STEP_SCRIPT_MAX_CHARS = 4096;

package/packages/agent/src/utils/index.d.ts

@@ -1,3 +1,3 @@
+export * from "@elizaos/shared/spoken-text";
 export * from "./number-parsing.js";
-export * from "./spoken-text.js";
 //# sourceMappingURL=index.d.ts.map

package/packages/agent/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC"}

package/packages/agent/src/utils/index.js

@@ -1,2 +1,2 @@
+export * from "@elizaos/shared/spoken-text";
 export * from "./number-parsing.js";
-export * from "./spoken-text.js";