@elizaos/plugin-personal-assistant 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/lifeops/voice-affect.js

@@ -0,0 +1,253 @@
+const RAW_AUDIO_KEYS = /* @__PURE__ */ new Set([
+  "audio",
+  "audioBlob",
+  "audioData",
+  "base64Audio",
+  "buffer",
+  "pcm",
+  "rawAudio",
+  "samples",
+  "waveform"
+]);
+function clamp01(value) {
+  if (!Number.isFinite(value)) {
+    throw new Error("voice affect score input must be finite");
+  }
+  return Math.min(1, Math.max(0, value));
+}
+function roundScore(value) {
+  return Math.round(clamp01(value) * 1e3) / 1e3;
+}
+function normalizeIsoTimestamp(value, field) {
+  const date = new Date(value);
+  if (!value || Number.isNaN(date.getTime())) {
+    throw new Error(`${field} must be a valid ISO timestamp`);
+  }
+  return date.toISOString();
+}
+function assertNonEmpty(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`${field} is required`);
+  }
+}
+function assertNoRawAudio(features) {
+  for (const key of Object.keys(features)) {
+    if (RAW_AUDIO_KEYS.has(key)) {
+      throw new Error(
+        `voice affect features must not include raw audio key: ${key}`
+      );
+    }
+  }
+}
+function finiteNonNegative(value, field) {
+  if (value === void 0 || value === null) {
+    return null;
+  }
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    throw new Error(`${field} must be a non-negative finite number`);
+  }
+  return value;
+}
+function average(values) {
+  if (values.length === 0) {
+    return null;
+  }
+  return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function normalizeFeatures(features) {
+  assertNoRawAudio(features);
+  const pauseDurationsMs = features.pauseDurationsMs ?? [];
+  if (!Array.isArray(pauseDurationsMs)) {
+    throw new Error("pauseDurationsMs must be an array");
+  }
+  for (const [index, pause] of pauseDurationsMs.entries()) {
+    finiteNonNegative(pause, `pauseDurationsMs[${index}]`);
+  }
+  const falseStartCount = finiteNonNegative(
+    features.falseStartCount,
+    "falseStartCount"
+  );
+  const speechRateWpm = finiteNonNegative(
+    features.speechRateWpm,
+    "speechRateWpm"
+  );
+  const pitchVarianceHz = finiteNonNegative(
+    features.pitchVarianceHz,
+    "pitchVarianceHz"
+  );
+  const volumeVarianceDb = finiteNonNegative(
+    features.volumeVarianceDb,
+    "volumeVarianceDb"
+  );
+  const transcriptUncertaintyTokenCount = finiteNonNegative(
+    features.transcriptUncertaintyTokenCount,
+    "transcriptUncertaintyTokenCount"
+  );
+  const transcriptTokenCount = finiteNonNegative(
+    features.transcriptTokenCount,
+    "transcriptTokenCount"
+  );
+  const uncertaintyTokenRatio = transcriptUncertaintyTokenCount === null || transcriptTokenCount === null ? null : transcriptTokenCount === 0 ? 0 : transcriptUncertaintyTokenCount / transcriptTokenCount;
+  const present = [
+    pauseDurationsMs.length > 0,
+    falseStartCount !== null,
+    speechRateWpm !== null,
+    pitchVarianceHz !== null,
+    volumeVarianceDb !== null,
+    uncertaintyTokenRatio !== null
+  ].filter(Boolean).length;
+  return {
+    pauseMeanMs: average(pauseDurationsMs),
+    pauseMaxMs: pauseDurationsMs.length === 0 ? null : Math.max(...pauseDurationsMs),
+    falseStartCount,
+    speechRateWpm,
+    pitchVarianceHz,
+    volumeVarianceDb,
+    uncertaintyTokenRatio,
+    featureCount: present
+  };
+}
+function scoreFromFeatures(features) {
+  const pauseSignal = features.pauseMaxMs === null ? 0 : features.pauseMaxMs / 2400;
+  const falseStartSignal = features.falseStartCount === null ? 0 : features.falseStartCount / 4;
+  const slowRateSignal = features.speechRateWpm === null ? 0 : features.speechRateWpm < 115 ? (115 - features.speechRateWpm) / 70 : 0;
+  const fastRateSignal = features.speechRateWpm === null ? 0 : features.speechRateWpm > 170 ? (features.speechRateWpm - 170) / 90 : 0;
+  const uncertaintySignal = features.uncertaintyTokenRatio === null ? 0 : features.uncertaintyTokenRatio / 0.22;
+  const pitchSignal = features.pitchVarianceHz === null ? 0 : features.pitchVarianceHz / 90;
+  const volumeSignal = features.volumeVarianceDb === null ? 0 : features.volumeVarianceDb / 14;
+  const hesitance = roundScore(
+    pauseSignal * 0.34 + falseStartSignal * 0.28 + slowRateSignal * 0.18 + uncertaintySignal * 0.2
+  );
+  const uncertainty = roundScore(
+    uncertaintySignal * 0.46 + falseStartSignal * 0.2 + pauseSignal * 0.2 + slowRateSignal * 0.14
+  );
+  const urgency = roundScore(
+    fastRateSignal * 0.42 + volumeSignal * 0.34 + pitchSignal * 0.24
+  );
+  const degradedReasons = [];
+  if (features.featureCount === 0) {
+    degradedReasons.push("no_affect_features");
+  }
+  if (features.featureCount <= 2 && features.uncertaintyTokenRatio !== null && features.pauseMeanMs === null && features.pitchVarianceHz === null && features.volumeVarianceDb === null) {
+    degradedReasons.push("transcript_only");
+  }
+  let confidence = 0.22 + features.featureCount * 0.12;
+  const hesitantButNotUrgent = hesitance > 0.55 && urgency < 0.35;
+  const urgentButNotHesitant = urgency > 0.55 && hesitance < 0.35;
+  if (hesitance > 0.5 && urgency > 0.5) {
+    confidence -= 0.18;
+    degradedReasons.push("mixed_affect_signals");
+  } else if (hesitantButNotUrgent || urgentButNotHesitant) {
+    confidence += 0.08;
+  }
+  if (degradedReasons.includes("transcript_only")) {
+    confidence = Math.min(confidence, 0.55);
+  }
+  if (degradedReasons.includes("no_affect_features")) {
+    confidence = Math.min(confidence, 0.25);
+  }
+  return {
+    scores: { hesitance, uncertainty, urgency },
+    confidence: roundScore(confidence),
+    degradedReasons
+  };
+}
+function labelsForScores(scores) {
+  const labels = [];
+  if (scores.hesitance >= 0.5) {
+    labels.push("hesitant");
+  }
+  if (scores.uncertainty >= 0.5) {
+    labels.push("uncertain");
+  }
+  if (scores.urgency >= 0.5) {
+    labels.push("urgent");
+  }
+  return labels;
+}
+class VoiceAffectService {
+  analyze(input) {
+    assertNonEmpty(input.utteranceId, "utteranceId");
+    assertNonEmpty(input.messageId, "messageId");
+    const capturedAt = normalizeIsoTimestamp(input.capturedAt, "capturedAt");
+    if (!["none", "ephemeral_only", "persist_features"].includes(input.consent)) {
+      throw new Error("consent must be a known voice affect consent state");
+    }
+    const features = normalizeFeatures(input.features);
+    const scored = scoreFromFeatures(features);
+    const withheldReasons = [];
+    if (input.consent === "none") {
+      withheldReasons.push("voice_affect_consent_not_granted");
+    }
+    if (input.policyDecision?.effect === "deny") {
+      withheldReasons.push(`policy_denied:${input.policyDecision.reason}`);
+    }
+    if (input.policyDecision?.effect === "require_approval") {
+      withheldReasons.push(
+        `policy_requires_approval:${input.policyDecision.reason}`
+      );
+    }
+    return {
+      eventType: "voice_affect_event",
+      utteranceId: input.utteranceId.trim(),
+      messageId: input.messageId.trim(),
+      capturedAt,
+      scores: scored.scores,
+      confidence: scored.confidence,
+      labels: labelsForScores(scored.scores),
+      degradedReasons: scored.degradedReasons,
+      withheldReasons
+    };
+  }
+  buildDurableRecord(input) {
+    const event = this.analyze(input);
+    const reasons = [...event.withheldReasons];
+    if (input.consent !== "persist_features") {
+      reasons.push("durable_storage_requires_persist_features_consent");
+    }
+    if (input.retention.kind !== "ttl") {
+      reasons.push("durable_storage_requires_ttl_retention");
+    } else {
+      const expiresAt = normalizeIsoTimestamp(
+        input.retention.expiresAt,
+        "retention.expiresAt"
+      );
+      if (new Date(expiresAt).getTime() <= new Date(event.capturedAt).getTime()) {
+        reasons.push("retention_expired");
+      }
+    }
+    if (reasons.length > 0 || input.retention.kind !== "ttl") {
+      return { status: "withheld", reasons: [...new Set(reasons)], event };
+    }
+    return {
+      status: "persistable",
+      event: {
+        ...event,
+        retention: {
+          kind: "ttl",
+          expiresAt: normalizeIsoTimestamp(
+            input.retention.expiresAt,
+            "retention.expiresAt"
+          )
+        }
+      }
+    };
+  }
+  toPlannerSlice(analysis) {
+    return {
+      utteranceId: analysis.utteranceId,
+      messageId: analysis.messageId,
+      capturedAt: analysis.capturedAt,
+      labels: analysis.labels,
+      scores: analysis.scores,
+      confidence: analysis.confidence,
+      degradedReasons: analysis.degradedReasons
+    };
+  }
+}
+const voiceAffectService = new VoiceAffectService();
+export {
+  VoiceAffectService,
+  voiceAffectService
+};
+//# sourceMappingURL=voice-affect.js.map

package/dist/lifeops/voice-affect.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lifeops/voice-affect.ts"],"sourcesContent":["export type VoiceAffectConsentState =\n  | \"none\"\n  | \"ephemeral_only\"\n  | \"persist_features\";\n\nexport type VoiceAffectRetentionPolicy =\n  | { kind: \"ephemeral\" }\n  | { kind: \"ttl\"; expiresAt: string };\n\nexport type VoiceAffectPolicyDecision =\n  | { effect: \"allow\"; reason: string }\n  | { effect: \"deny\"; reason: string }\n  | { effect: \"require_approval\"; reason: string };\n\nexport type VoiceAffectFeatures = {\n  pauseDurationsMs?: number[];\n  falseStartCount?: number;\n  speechRateWpm?: number;\n  pitchVarianceHz?: number;\n  volumeVarianceDb?: number;\n  transcriptUncertaintyTokenCount?: number;\n  transcriptTokenCount?: number;\n};\n\nexport type VoiceAffectInput = {\n  utteranceId: string;\n  messageId: string;\n  capturedAt: string;\n  consent: VoiceAffectConsentState;\n  retention: VoiceAffectRetentionPolicy;\n  features: VoiceAffectFeatures & Record<string, unknown>;\n  policyDecision?: VoiceAffectPolicyDecision;\n};\n\nexport type VoiceAffectScores = {\n  hesitance: number;\n  uncertainty: number;\n  urgency: number;\n};\n\nexport type VoiceAffectAnalysis = {\n  eventType: \"voice_affect_event\";\n  utteranceId: string;\n  messageId: string;\n  capturedAt: string;\n  scores: VoiceAffectScores;\n  confidence: number;\n  labels: Array<\"hesitant\" | \"uncertain\" | \"urgent\">;\n  degradedReasons: string[];\n  withheldReasons: string[];\n};\n\nexport type VoiceAffectDurableRecord =\n  | {\n      status: \"persistable\";\n      event: VoiceAffectAnalysis & {\n        retention: Extract<VoiceAffectRetentionPolicy, { kind: \"ttl\" }>;\n      };\n    }\n  | {\n      status: \"withheld\";\n      reasons: string[];\n      event: VoiceAffectAnalysis;\n    };\n\nexport type VoiceAffectPlannerSlice = {\n  utteranceId: string;\n  messageId: string;\n  capturedAt: string;\n  labels: VoiceAffectAnalysis[\"labels\"];\n  scores: VoiceAffectScores;\n  confidence: number;\n  degradedReasons: string[];\n};\n\nconst RAW_AUDIO_KEYS = new Set([\n  \"audio\",\n  \"audioBlob\",\n  \"audioData\",\n  \"base64Audio\",\n  \"buffer\",\n  \"pcm\",\n  \"rawAudio\",\n  \"samples\",\n  \"waveform\",\n]);\n\nfunction clamp01(value: number): number {\n  if (!Number.isFinite(value)) {\n    throw new Error(\"voice affect score input must be finite\");\n  }\n  return Math.min(1, Math.max(0, value));\n}\n\nfunction roundScore(value: number): number {\n  return Math.round(clamp01(value) * 1000) / 1000;\n}\n\nfunction normalizeIsoTimestamp(value: string, field: string): string {\n  const date = new Date(value);\n  if (!value || Number.isNaN(date.getTime())) {\n    throw new Error(`${field} must be a valid ISO timestamp`);\n  }\n  return date.toISOString();\n}\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new Error(`${field} is required`);\n  }\n}\n\nfunction assertNoRawAudio(features: Record<string, unknown>): void {\n  for (const key of Object.keys(features)) {\n    if (RAW_AUDIO_KEYS.has(key)) {\n      throw new Error(\n        `voice affect features must not include raw audio key: ${key}`,\n      );\n    }\n  }\n}\n\nfunction finiteNonNegative(value: unknown, field: string): number | null {\n  if (value === undefined || value === null) {\n    return null;\n  }\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n    throw new Error(`${field} must be a non-negative finite number`);\n  }\n  return value;\n}\n\nfunction average(values: number[]): number | null {\n  if (values.length === 0) {\n    return null;\n  }\n  return values.reduce((sum, value) => sum + value, 0) / values.length;\n}\n\nfunction normalizeFeatures(features: VoiceAffectInput[\"features\"]): {\n  pauseMeanMs: number | null;\n  pauseMaxMs: number | null;\n  falseStartCount: number | null;\n  speechRateWpm: number | null;\n  pitchVarianceHz: number | null;\n  volumeVarianceDb: number | null;\n  uncertaintyTokenRatio: number | null;\n  featureCount: number;\n} {\n  assertNoRawAudio(features);\n\n  const pauseDurationsMs = features.pauseDurationsMs ?? [];\n  if (!Array.isArray(pauseDurationsMs)) {\n    throw new Error(\"pauseDurationsMs must be an array\");\n  }\n  for (const [index, pause] of pauseDurationsMs.entries()) {\n    finiteNonNegative(pause, `pauseDurationsMs[${index}]`);\n  }\n\n  const falseStartCount = finiteNonNegative(\n    features.falseStartCount,\n    \"falseStartCount\",\n  );\n  const speechRateWpm = finiteNonNegative(\n    features.speechRateWpm,\n    \"speechRateWpm\",\n  );\n  const pitchVarianceHz = finiteNonNegative(\n    features.pitchVarianceHz,\n    \"pitchVarianceHz\",\n  );\n  const volumeVarianceDb = finiteNonNegative(\n    features.volumeVarianceDb,\n    \"volumeVarianceDb\",\n  );\n  const transcriptUncertaintyTokenCount = finiteNonNegative(\n    features.transcriptUncertaintyTokenCount,\n    \"transcriptUncertaintyTokenCount\",\n  );\n  const transcriptTokenCount = finiteNonNegative(\n    features.transcriptTokenCount,\n    \"transcriptTokenCount\",\n  );\n\n  const uncertaintyTokenRatio =\n    transcriptUncertaintyTokenCount === null || transcriptTokenCount === null\n      ? null\n      : transcriptTokenCount === 0\n        ? 0\n        : transcriptUncertaintyTokenCount / transcriptTokenCount;\n\n  const present = [\n    pauseDurationsMs.length > 0,\n    falseStartCount !== null,\n    speechRateWpm !== null,\n    pitchVarianceHz !== null,\n    volumeVarianceDb !== null,\n    uncertaintyTokenRatio !== null,\n  ].filter(Boolean).length;\n\n  return {\n    pauseMeanMs: average(pauseDurationsMs),\n    pauseMaxMs:\n      pauseDurationsMs.length === 0 ? null : Math.max(...pauseDurationsMs),\n    falseStartCount,\n    speechRateWpm,\n    pitchVarianceHz,\n    volumeVarianceDb,\n    uncertaintyTokenRatio,\n    featureCount: present,\n  };\n}\n\nfunction scoreFromFeatures(features: ReturnType<typeof normalizeFeatures>): {\n  scores: VoiceAffectScores;\n  confidence: number;\n  degradedReasons: string[];\n} {\n  const pauseSignal =\n    features.pauseMaxMs === null ? 0 : features.pauseMaxMs / 2400;\n  const falseStartSignal =\n    features.falseStartCount === null ? 0 : features.falseStartCount / 4;\n  const slowRateSignal =\n    features.speechRateWpm === null\n      ? 0\n      : features.speechRateWpm < 115\n        ? (115 - features.speechRateWpm) / 70\n        : 0;\n  const fastRateSignal =\n    features.speechRateWpm === null\n      ? 0\n      : features.speechRateWpm > 170\n        ? (features.speechRateWpm - 170) / 90\n        : 0;\n  const uncertaintySignal =\n    features.uncertaintyTokenRatio === null\n      ? 0\n      : features.uncertaintyTokenRatio / 0.22;\n  const pitchSignal =\n    features.pitchVarianceHz === null ? 0 : features.pitchVarianceHz / 90;\n  const volumeSignal =\n    features.volumeVarianceDb === null ? 0 : features.volumeVarianceDb / 14;\n\n  const hesitance = roundScore(\n    pauseSignal * 0.34 +\n      falseStartSignal * 0.28 +\n      slowRateSignal * 0.18 +\n      uncertaintySignal * 0.2,\n  );\n  const uncertainty = roundScore(\n    uncertaintySignal * 0.46 +\n      falseStartSignal * 0.2 +\n      pauseSignal * 0.2 +\n      slowRateSignal * 0.14,\n  );\n  const urgency = roundScore(\n    fastRateSignal * 0.42 + volumeSignal * 0.34 + pitchSignal * 0.24,\n  );\n\n  const degradedReasons: string[] = [];\n  if (features.featureCount === 0) {\n    degradedReasons.push(\"no_affect_features\");\n  }\n  if (\n    features.featureCount <= 2 &&\n    features.uncertaintyTokenRatio !== null &&\n    features.pauseMeanMs === null &&\n    features.pitchVarianceHz === null &&\n    features.volumeVarianceDb === null\n  ) {\n    degradedReasons.push(\"transcript_only\");\n  }\n\n  let confidence = 0.22 + features.featureCount * 0.12;\n  const hesitantButNotUrgent = hesitance > 0.55 && urgency < 0.35;\n  const urgentButNotHesitant = urgency > 0.55 && hesitance < 0.35;\n  if (hesitance > 0.5 && urgency > 0.5) {\n    confidence -= 0.18;\n    degradedReasons.push(\"mixed_affect_signals\");\n  } else if (hesitantButNotUrgent || urgentButNotHesitant) {\n    confidence += 0.08;\n  }\n  if (degradedReasons.includes(\"transcript_only\")) {\n    confidence = Math.min(confidence, 0.55);\n  }\n  if (degradedReasons.includes(\"no_affect_features\")) {\n    confidence = Math.min(confidence, 0.25);\n  }\n\n  return {\n    scores: { hesitance, uncertainty, urgency },\n    confidence: roundScore(confidence),\n    degradedReasons,\n  };\n}\n\nfunction labelsForScores(\n  scores: VoiceAffectScores,\n): VoiceAffectAnalysis[\"labels\"] {\n  const labels: VoiceAffectAnalysis[\"labels\"] = [];\n  if (scores.hesitance >= 0.5) {\n    labels.push(\"hesitant\");\n  }\n  if (scores.uncertainty >= 0.5) {\n    labels.push(\"uncertain\");\n  }\n  if (scores.urgency >= 0.5) {\n    labels.push(\"urgent\");\n  }\n  return labels;\n}\n\nexport class VoiceAffectService {\n  analyze(input: VoiceAffectInput): VoiceAffectAnalysis {\n    assertNonEmpty(input.utteranceId, \"utteranceId\");\n    assertNonEmpty(input.messageId, \"messageId\");\n    const capturedAt = normalizeIsoTimestamp(input.capturedAt, \"capturedAt\");\n\n    if (\n      ![\"none\", \"ephemeral_only\", \"persist_features\"].includes(input.consent)\n    ) {\n      throw new Error(\"consent must be a known voice affect consent state\");\n    }\n\n    const features = normalizeFeatures(input.features);\n    const scored = scoreFromFeatures(features);\n    const withheldReasons: string[] = [];\n\n    if (input.consent === \"none\") {\n      withheldReasons.push(\"voice_affect_consent_not_granted\");\n    }\n    if (input.policyDecision?.effect === \"deny\") {\n      withheldReasons.push(`policy_denied:${input.policyDecision.reason}`);\n    }\n    if (input.policyDecision?.effect === \"require_approval\") {\n      withheldReasons.push(\n        `policy_requires_approval:${input.policyDecision.reason}`,\n      );\n    }\n\n    return {\n      eventType: \"voice_affect_event\",\n      utteranceId: input.utteranceId.trim(),\n      messageId: input.messageId.trim(),\n      capturedAt,\n      scores: scored.scores,\n      confidence: scored.confidence,\n      labels: labelsForScores(scored.scores),\n      degradedReasons: scored.degradedReasons,\n      withheldReasons,\n    };\n  }\n\n  buildDurableRecord(input: VoiceAffectInput): VoiceAffectDurableRecord {\n    const event = this.analyze(input);\n    const reasons = [...event.withheldReasons];\n\n    if (input.consent !== \"persist_features\") {\n      reasons.push(\"durable_storage_requires_persist_features_consent\");\n    }\n    if (input.retention.kind !== \"ttl\") {\n      reasons.push(\"durable_storage_requires_ttl_retention\");\n    } else {\n      const expiresAt = normalizeIsoTimestamp(\n        input.retention.expiresAt,\n        \"retention.expiresAt\",\n      );\n      if (\n        new Date(expiresAt).getTime() <= new Date(event.capturedAt).getTime()\n      ) {\n        reasons.push(\"retention_expired\");\n      }\n    }\n\n    if (reasons.length > 0 || input.retention.kind !== \"ttl\") {\n      return { status: \"withheld\", reasons: [...new Set(reasons)], event };\n    }\n\n    return {\n      status: \"persistable\",\n      event: {\n        ...event,\n        retention: {\n          kind: \"ttl\",\n          expiresAt: normalizeIsoTimestamp(\n            input.retention.expiresAt,\n            \"retention.expiresAt\",\n          ),\n        },\n      },\n    };\n  }\n\n  toPlannerSlice(analysis: VoiceAffectAnalysis): VoiceAffectPlannerSlice {\n    return {\n      utteranceId: analysis.utteranceId,\n      messageId: analysis.messageId,\n      capturedAt: analysis.capturedAt,\n      labels: analysis.labels,\n      scores: analysis.scores,\n      confidence: analysis.confidence,\n      degradedReasons: analysis.degradedReasons,\n    };\n  }\n}\n\nexport const voiceAffectService = new VoiceAffectService();\n"],"mappings":"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","names":[]}

package/dist/lifeops/wave1-types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Scheduled-task types used by the `first-run` module. These predating the
+ * canonical `scheduled-task/types.ts` module and have diverged slightly;
+ * `ScheduledTaskInput` is not exported from the canonical path.
+ *
+ * Types only — no runtime behaviour.
+ */
+export type TerminalState = "completed" | "skipped" | "expired" | "failed" | "dismissed";
+export type ScheduledTaskStatus = TerminalState | "scheduled" | "fired" | "acknowledged";
+export type ScheduledTaskKind = "reminder" | "checkin" | "followup" | "approval" | "recap" | "watcher" | "output" | "custom";
+export type ScheduledTaskPriority = "low" | "medium" | "high";
+export type ScheduledTaskSource = "default_pack" | "user_chat" | "first_run" | "plugin";
+export interface ScheduledTaskState {
+    status: ScheduledTaskStatus;
+    firedAt?: string;
+    acknowledgedAt?: string;
+    completedAt?: string;
+    followupCount: number;
+    lastFollowupAt?: string;
+    pipelineParentId?: string;
+    lastDecisionLog?: string;
+}
+export type ScheduledTaskTrigger = {
+    kind: "once";
+    atIso: string;
+} | {
+    kind: "cron";
+    expression: string;
+    tz: string;
+} | {
+    kind: "interval";
+    everyMinutes: number;
+    from?: string;
+    until?: string;
+} | {
+    kind: "relative_to_anchor";
+    anchorKey: string;
+    offsetMinutes: number;
+} | {
+    kind: "during_window";
+    windowKey: string;
+} | {
+    kind: "event";
+    eventKind: string;
+    filter?: unknown;
+} | {
+    kind: "manual";
+} | {
+    kind: "after_task";
+    taskId: string;
+    outcome: TerminalState;
+};
+export interface ScheduledTaskCompletionCheck {
+    kind: string;
+    params?: unknown;
+    followupAfterMinutes?: number;
+}
+export interface ScheduledTaskSubject {
+    kind: "entity" | "relationship" | "thread" | "document" | "calendar_event" | "self";
+    id: string;
+}
+export interface ScheduledTask {
+    taskId: string;
+    kind: ScheduledTaskKind;
+    promptInstructions: string;
+    contextRequest?: {
+        includeOwnerFacts?: ReadonlyArray<"preferredName" | "timezone" | "morningWindow" | "eveningWindow" | "locale">;
+        includeEntities?: {
+            entityIds: string[];
+            fields?: ReadonlyArray<"preferredName" | "type" | "identities" | "state.lastInteractionPlatform">;
+        };
+        includeRelationships?: {
+            relationshipIds?: string[];
+            forEntityIds?: string[];
+            types?: string[];
+        };
+        includeRecentTaskStates?: {
+            kind?: ScheduledTaskKind;
+            lookbackHours?: number;
+        };
+        includeEventPayload?: boolean;
+    };
+    trigger: ScheduledTaskTrigger;
+    priority: ScheduledTaskPriority;
+    shouldFire?: {
+        compose?: "all" | "any" | "first_deny";
+        gates: Array<{
+            kind: string;
+            params?: unknown;
+        }>;
+    };
+    completionCheck?: ScheduledTaskCompletionCheck;
+    escalation?: {
+        ladderKey?: string;
+        steps?: Array<{
+            delayMinutes: number;
+            channelKey: string;
+            intensity?: "soft" | "normal" | "urgent";
+        }>;
+    };
+    output?: {
+        destination: "in_app_card" | "channel" | "apple_notes" | "gmail_draft" | "memory";
+        target?: string;
+        persistAs?: "task_metadata" | "external_only";
+    };
+    pipeline?: {
+        onComplete?: Array<string | ScheduledTask>;
+        onSkip?: Array<string | ScheduledTask>;
+        onFail?: Array<string | ScheduledTask>;
+    };
+    subject?: ScheduledTaskSubject;
+    idempotencyKey?: string;
+    respectsGlobalPause: boolean;
+    state: ScheduledTaskState;
+    source: ScheduledTaskSource;
+    createdBy: string;
+    ownerVisible: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Schedule input — `ScheduledTask` minus runner-managed fields. Mirrors the
+ * runner signature `schedule(task: Omit<ScheduledTask, "taskId" | "state">)`.
+ */
+export type ScheduledTaskInput = Omit<ScheduledTask, "taskId" | "state">;
+//# sourceMappingURL=wave1-types.d.ts.map

package/dist/lifeops/wave1-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wave1-types.d.ts","sourceRoot":"","sources":["../../src/lifeops/wave1-types.ts"],"names":[],"mappings":"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"}

package/dist/lifeops/wave1-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=wave1-types.js.map

package/dist/lifeops/wave1-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/lifeops/work-threads/field-evaluator-thread-ops.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `threadOps` — response-handler field evaluator owned by app-lifeops.
+ *
+ * Contributes a typed schema fragment to the SAME Stage-1 LLM call the
+ * response handler is already making. The LLM extracts the thread operations
+ * from context — no post-parse regex router.
+ *
+ * The abort intent ("stop", "nvm", "actually wait don't do that") lives as
+ * one operation type within threadOps. When the LLM emits
+ * `{ threadOps: [{ type: "abort", ... }] }`, this evaluator's handler:
+ *
+ *   1. Calls `runtime.abortTurn(roomId, reason)` synchronously — propagates
+ *      through the turn's AbortSignal tree.
+ *   2. Returns an `ack-and-stop` preempt — the response handler emits a
+ *      short acknowledgement reply and does NOT route to the planner.
+ *
+ * For all non-abort ops, the handler stages them as a dispatch payload that
+ * the existing `lifeops_thread_control` action handler consumes (no need to
+ * duplicate the validation / locking / atomic-merge logic).
+ */
+import type { ResponseHandlerFieldEvaluator } from "@elizaos/core";
+import type { ThreadSourceRef } from "./types.js";
+export type ThreadOpType = "create" | "steer" | "stop" | "merge" | "attach_source" | "schedule_followup" | "mark_waiting" | "mark_completed" | "abort";
+export interface ThreadOp {
+    type: ThreadOpType;
+    workThreadId?: string | null;
+    sourceWorkThreadIds?: string[];
+    sourceRef?: ThreadSourceRef;
+    instruction?: string | null;
+    reason?: string | null;
+}
+export declare const threadOpsFieldEvaluator: ResponseHandlerFieldEvaluator<ThreadOp[]>;
+//# sourceMappingURL=field-evaluator-thread-ops.d.ts.map

package/dist/lifeops/work-threads/field-evaluator-thread-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-evaluator-thread-ops.d.ts","sourceRoot":"","sources":["../../../src/lifeops/work-threads/field-evaluator-thread-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAGV,6BAA6B,EAE9B,MAAM,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,OAAO,GACP,MAAM,GACN,OAAO,GACP,eAAe,GACf,mBAAmB,GACnB,cAAc,GACd,gBAAgB,GAChB,OAAO,CAAC;AAEZ,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA+RD,eAAO,MAAM,uBAAuB,EAAE,6BAA6B,CACjE,QAAQ,EAAE,CASX,CAAC"}