@elizaos/plugin-goals 2.0.3-beta.5 → 2.0.3-beta.7

package/dist/goal-semantic-evaluator.d.ts

@@ -0,0 +1,12 @@
+import type { IAgentRuntime } from "@elizaos/core";
+import type { LifeOpsGoalDefinition } from "@elizaos/shared";
+import { type GoalSemanticReviewMetadata } from "./goal-grounding.js";
+export interface GoalSemanticEvaluationResult extends GoalSemanticReviewMetadata {
+}
+export declare function evaluateGoalProgressWithLlm(args: {
+    runtime: IAgentRuntime;
+    evidence: Record<string, unknown>;
+    goal: LifeOpsGoalDefinition;
+    nowIso: string;
+}): Promise<GoalSemanticEvaluationResult | null>;
+//# sourceMappingURL=goal-semantic-evaluator.d.ts.map

package/dist/goal-semantic-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-semantic-evaluator.d.ts","sourceRoot":"","sources":["../src/goal-semantic-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAOnD,OAAO,KAAK,EACV,qBAAqB,EAGtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,0BAA0B,EAEhC,MAAM,qBAAqB,CAAC;AAgB7B,MAAM,WAAW,4BACf,SAAQ,0BAA0B;CAAG;AA+LvC,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAiD/C"}

package/dist/goal-semantic-evaluator.js

@@ -0,0 +1,208 @@
+import {
+  logger,
+  ModelType,
+  parseJsonModelRecord,
+  runWithTrajectoryContext
+} from "@elizaos/core";
+import {
+  buildGoalSemanticReviewMetadata
+} from "./goal-grounding.js";
+const VALID_REVIEW_STATES = /* @__PURE__ */ new Set([
+  "idle",
+  "needs_attention",
+  "on_track",
+  "at_risk"
+]);
+const VALID_SUGGESTION_KINDS = /* @__PURE__ */ new Set([
+  "create_support",
+  "focus_now",
+  "resolve_overdue",
+  "review_progress",
+  "tighten_cadence"
+]);
+function normalizeText(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function normalizeFiniteNumber(value) {
+  const parsedValue = typeof value === "string" && value.trim().length > 0 ? Number(value) : value;
+  if (typeof parsedValue !== "number" || !Number.isFinite(parsedValue)) {
+    return null;
+  }
+  return Math.max(0, Math.min(1, parsedValue));
+}
+function normalizeStringArray(value) {
+  if (typeof value === "string") {
+    return value.split(/\n|,/).map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+  }
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+function normalizeSuggestions(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map((entry) => {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry)) {
+      return null;
+    }
+    const record = entry;
+    const title = normalizeText(record.title);
+    const detail = normalizeText(record.detail);
+    if (!title || !detail) {
+      return null;
+    }
+    const kind = normalizeText(record.kind);
+    return {
+      kind: kind && VALID_SUGGESTION_KINDS.has(kind) ? kind : null,
+      title,
+      detail
+    };
+  }).filter((entry) => entry !== null);
+}
+function formatPromptValue(value, depth = 0) {
+  const indent = "  ".repeat(depth);
+  const childIndent = "  ".repeat(depth + 1);
+  if (value === null) return "null";
+  if (value === void 0) return "";
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) return "(none)";
+    return value.map((entry) => `${childIndent}- ${formatPromptValue(entry, depth + 1)}`).join("\n");
+  }
+  if (typeof value === "object") {
+    const entries = Object.entries(value);
+    if (entries.length === 0) return "(empty)";
+    return entries.map(([key, entry]) => {
+      const formatted = formatPromptValue(entry, depth + 1);
+      return formatted.includes("\n") ? `${indent}${key}:
+${formatted}` : `${indent}${key}: ${formatted}`;
+    }).join("\n");
+  }
+  return String(value);
+}
+function buildSemanticEvaluationPrompt(args) {
+  return [
+    "Evaluate the user's goal semantically using the grounded goal contract and the evidence.",
+    "Do not rely only on linked support tasks. If the goal has direct evidence such as sleep data, use it.",
+    "Do not bluff. If the evidence is too weak, say so clearly and lower confidence.",
+    "",
+    "Return ONLY a JSON object with these fields:",
+    "reviewState: one of idle, needs_attention, on_track, at_risk",
+    "- progressScore: number from 0 to 1 or null if not enough evidence",
+    "- confidence: number from 0 to 1",
+    "- explanation: short grounded explanation",
+    "- evidenceSummary: short summary of the strongest evidence used",
+    "- missingEvidence: array of short evidence gaps",
+    "- suggestions: up to 3 objects with kind, title, and detail. kind must be one of create_support, focus_now, resolve_overdue, review_progress, tighten_cadence",
+    "",
+    'Example: {"reviewState":"needs_attention","progressScore":0.4,"confidence":0.65,"explanation":"Some supporting evidence exists, but the outcome evidence is thin.","evidenceSummary":"One recent support task was completed.","missingEvidence":["Direct outcome measurement"],"suggestions":[{"kind":"review_progress","title":"Review goal evidence","detail":"Ask for the latest measurement before changing status."}]}',
+    "",
+    "Guidance:",
+    "- Use on_track only when the available evidence supports progress.",
+    "- Use at_risk when the evidence suggests drift, missed targets, or contradictory outcomes.",
+    "- Use needs_attention when the goal is grounded but the evidence is insufficient or the support structure is weak.",
+    "- Use idle only when the goal is brand new and there is genuinely nothing to judge yet.",
+    "",
+    `Now: ${args.nowIso}`,
+    "Goal:",
+    formatPromptValue(args.goal),
+    "Evidence:",
+    formatPromptValue(args.evidence)
+  ].join("\n");
+}
+function buildSemanticRepairPrompt(args) {
+  return [
+    "Your last reply for the goal semantic evaluator was invalid.",
+    "Return ONLY JSON with exactly these fields:",
+    "reviewState, progressScore, confidence, explanation, evidenceSummary, missingEvidence, suggestions",
+    "",
+    "reviewState must be one of idle, needs_attention, on_track, at_risk.",
+    "Use a missingEvidence array for evidence gaps.",
+    "Use a suggestions array of {kind,title,detail} objects.",
+    "",
+    `Now: ${args.nowIso}`,
+    "Goal:",
+    formatPromptValue(args.goal),
+    "Evidence:",
+    formatPromptValue(args.evidence),
+    "Previous invalid output:",
+    args.rawResponse
+  ].join("\n");
+}
+function parseSemanticEvaluationOutput(raw) {
+  return parseJsonModelRecord(raw);
+}
+function buildSemanticEvaluationResult(parsed, nowIso) {
+  const reviewState = normalizeText(parsed.reviewState);
+  const explanation = normalizeText(parsed.explanation);
+  if (!reviewState || !VALID_REVIEW_STATES.has(reviewState) || !explanation) {
+    return null;
+  }
+  return buildGoalSemanticReviewMetadata({
+    confidence: normalizeFiniteNumber(parsed.confidence),
+    evidenceSummary: normalizeText(parsed.evidenceSummary),
+    explanation,
+    missingEvidence: normalizeStringArray(parsed.missingEvidence),
+    progressScore: normalizeFiniteNumber(parsed.progressScore),
+    reviewState,
+    reviewedAt: nowIso,
+    suggestions: normalizeSuggestions(parsed.suggestions)
+  });
+}
+async function evaluateGoalProgressWithLlm(args) {
+  if (typeof args.runtime.useModel !== "function") {
+    return null;
+  }
+  const prompt = buildSemanticEvaluationPrompt(args);
+  try {
+    const raw = await runWithTrajectoryContext(
+      { purpose: "lifeops-goal-evaluator-first-pass" },
+      () => args.runtime.useModel(ModelType.TEXT_LARGE, { prompt })
+    );
+    const parsed = parseSemanticEvaluationOutput(
+      typeof raw === "string" ? raw : ""
+    );
+    const evaluation = parsed ? buildSemanticEvaluationResult(parsed, args.nowIso) : null;
+    if (evaluation) {
+      return evaluation;
+    }
+    const repairedRaw = await runWithTrajectoryContext(
+      { purpose: "lifeops-goal-evaluator-repair-pass" },
+      () => args.runtime.useModel(ModelType.TEXT_LARGE, {
+        prompt: buildSemanticRepairPrompt({
+          evidence: args.evidence,
+          goal: args.goal,
+          nowIso: args.nowIso,
+          rawResponse: typeof raw === "string" ? raw : ""
+        })
+      })
+    );
+    const repairedParsed = parseSemanticEvaluationOutput(
+      typeof repairedRaw === "string" ? repairedRaw : ""
+    );
+    return repairedParsed ? buildSemanticEvaluationResult(repairedParsed, args.nowIso) : null;
+  } catch (error) {
+    logger.warn(
+      {
+        boundary: "lifeops",
+        component: "goal-semantic-evaluator",
+        goalId: args.goal.id,
+        detail: error instanceof Error ? error.message : String(error)
+      },
+      "[goal-semantic-evaluator] evaluation failed; returning null"
+    );
+    return null;
+  }
+}
+export {
+  evaluateGoalProgressWithLlm
+};
+//# sourceMappingURL=goal-semantic-evaluator.js.map

package/dist/goal-semantic-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/goal-semantic-evaluator.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\nimport {\n  logger,\n  ModelType,\n  parseJsonModelRecord,\n  runWithTrajectoryContext,\n} from \"@elizaos/core\";\nimport type {\n  LifeOpsGoalDefinition,\n  LifeOpsGoalReviewState,\n  LifeOpsGoalSuggestionKind,\n} from \"@elizaos/shared\";\nimport {\n  buildGoalSemanticReviewMetadata,\n  type GoalSemanticReviewMetadata,\n  type GoalSemanticSuggestionMetadata,\n} from \"./goal-grounding.js\";\n\nconst VALID_REVIEW_STATES = new Set<LifeOpsGoalReviewState>([\n  \"idle\",\n  \"needs_attention\",\n  \"on_track\",\n  \"at_risk\",\n]);\nconst VALID_SUGGESTION_KINDS = new Set<LifeOpsGoalSuggestionKind>([\n  \"create_support\",\n  \"focus_now\",\n  \"resolve_overdue\",\n  \"review_progress\",\n  \"tighten_cadence\",\n]);\n\nexport interface GoalSemanticEvaluationResult\n  extends GoalSemanticReviewMetadata {}\n\nfunction normalizeText(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction normalizeFiniteNumber(value: unknown): number | null {\n  const parsedValue =\n    typeof value === \"string\" && value.trim().length > 0\n      ? Number(value)\n      : value;\n  if (typeof parsedValue !== \"number\" || !Number.isFinite(parsedValue)) {\n    return null;\n  }\n  return Math.max(0, Math.min(1, parsedValue));\n}\n\nfunction normalizeStringArray(value: unknown): string[] {\n  if (typeof value === \"string\") {\n    return value\n      .split(/\\n|,/)\n      .map((entry) => entry.trim())\n      .filter((entry) => entry.length > 0);\n  }\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .filter((entry): entry is string => typeof entry === \"string\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n}\n\nfunction normalizeSuggestions(\n  value: unknown,\n): GoalSemanticSuggestionMetadata[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((entry) => {\n      if (!entry || typeof entry !== \"object\" || Array.isArray(entry)) {\n        return null;\n      }\n      const record = entry as Record<string, unknown>;\n      const title = normalizeText(record.title);\n      const detail = normalizeText(record.detail);\n      if (!title || !detail) {\n        return null;\n      }\n      const kind = normalizeText(record.kind);\n      return {\n        kind:\n          kind && VALID_SUGGESTION_KINDS.has(kind as LifeOpsGoalSuggestionKind)\n            ? kind\n            : null,\n        title,\n        detail,\n      };\n    })\n    .filter((entry): entry is GoalSemanticSuggestionMetadata => entry !== null);\n}\n\nfunction formatPromptValue(value: unknown, depth = 0): string {\n  const indent = \"  \".repeat(depth);\n  const childIndent = \"  \".repeat(depth + 1);\n  if (value === null) return \"null\";\n  if (value === undefined) return \"\";\n  if (\n    typeof value === \"string\" ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\"\n  ) {\n    return String(value);\n  }\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"(none)\";\n    return value\n      .map((entry) => `${childIndent}- ${formatPromptValue(entry, depth + 1)}`)\n      .join(\"\\n\");\n  }\n  if (typeof value === \"object\") {\n    const entries = Object.entries(value as Record<string, unknown>);\n    if (entries.length === 0) return \"(empty)\";\n    return entries\n      .map(([key, entry]) => {\n        const formatted = formatPromptValue(entry, depth + 1);\n        return formatted.includes(\"\\n\")\n          ? `${indent}${key}:\\n${formatted}`\n          : `${indent}${key}: ${formatted}`;\n      })\n      .join(\"\\n\");\n  }\n  return String(value);\n}\n\nfunction buildSemanticEvaluationPrompt(args: {\n  evidence: Record<string, unknown>;\n  goal: LifeOpsGoalDefinition;\n  nowIso: string;\n}): string {\n  return [\n    \"Evaluate the user's goal semantically using the grounded goal contract and the evidence.\",\n    \"Do not rely only on linked support tasks. If the goal has direct evidence such as sleep data, use it.\",\n    \"Do not bluff. If the evidence is too weak, say so clearly and lower confidence.\",\n    \"\",\n    \"Return ONLY a JSON object with these fields:\",\n    \"reviewState: one of idle, needs_attention, on_track, at_risk\",\n    \"- progressScore: number from 0 to 1 or null if not enough evidence\",\n    \"- confidence: number from 0 to 1\",\n    \"- explanation: short grounded explanation\",\n    \"- evidenceSummary: short summary of the strongest evidence used\",\n    \"- missingEvidence: array of short evidence gaps\",\n    \"- suggestions: up to 3 objects with kind, title, and detail. kind must be one of create_support, focus_now, resolve_overdue, review_progress, tighten_cadence\",\n    \"\",\n    'Example: {\"reviewState\":\"needs_attention\",\"progressScore\":0.4,\"confidence\":0.65,\"explanation\":\"Some supporting evidence exists, but the outcome evidence is thin.\",\"evidenceSummary\":\"One recent support task was completed.\",\"missingEvidence\":[\"Direct outcome measurement\"],\"suggestions\":[{\"kind\":\"review_progress\",\"title\":\"Review goal evidence\",\"detail\":\"Ask for the latest measurement before changing status.\"}]}',\n    \"\",\n    \"Guidance:\",\n    \"- Use on_track only when the available evidence supports progress.\",\n    \"- Use at_risk when the evidence suggests drift, missed targets, or contradictory outcomes.\",\n    \"- Use needs_attention when the goal is grounded but the evidence is insufficient or the support structure is weak.\",\n    \"- Use idle only when the goal is brand new and there is genuinely nothing to judge yet.\",\n    \"\",\n    `Now: ${args.nowIso}`,\n    \"Goal:\",\n    formatPromptValue(args.goal),\n    \"Evidence:\",\n    formatPromptValue(args.evidence),\n  ].join(\"\\n\");\n}\n\nfunction buildSemanticRepairPrompt(args: {\n  evidence: Record<string, unknown>;\n  goal: LifeOpsGoalDefinition;\n  nowIso: string;\n  rawResponse: string;\n}): string {\n  return [\n    \"Your last reply for the goal semantic evaluator was invalid.\",\n    \"Return ONLY JSON with exactly these fields:\",\n    \"reviewState, progressScore, confidence, explanation, evidenceSummary, missingEvidence, suggestions\",\n    \"\",\n    \"reviewState must be one of idle, needs_attention, on_track, at_risk.\",\n    \"Use a missingEvidence array for evidence gaps.\",\n    \"Use a suggestions array of {kind,title,detail} objects.\",\n    \"\",\n    `Now: ${args.nowIso}`,\n    \"Goal:\",\n    formatPromptValue(args.goal),\n    \"Evidence:\",\n    formatPromptValue(args.evidence),\n    \"Previous invalid output:\",\n    args.rawResponse,\n  ].join(\"\\n\");\n}\n\nfunction parseSemanticEvaluationOutput(\n  raw: string,\n): Record<string, unknown> | null {\n  return parseJsonModelRecord<Record<string, unknown>>(raw);\n}\n\nfunction buildSemanticEvaluationResult(\n  parsed: Record<string, unknown>,\n  nowIso: string,\n): GoalSemanticEvaluationResult | null {\n  const reviewState = normalizeText(parsed.reviewState);\n  const explanation = normalizeText(parsed.explanation);\n  if (\n    !reviewState ||\n    !VALID_REVIEW_STATES.has(reviewState as LifeOpsGoalReviewState) ||\n    !explanation\n  ) {\n    return null;\n  }\n  return buildGoalSemanticReviewMetadata({\n    confidence: normalizeFiniteNumber(parsed.confidence),\n    evidenceSummary: normalizeText(parsed.evidenceSummary),\n    explanation,\n    missingEvidence: normalizeStringArray(parsed.missingEvidence),\n    progressScore: normalizeFiniteNumber(parsed.progressScore),\n    reviewState: reviewState as LifeOpsGoalReviewState,\n    reviewedAt: nowIso,\n    suggestions: normalizeSuggestions(parsed.suggestions),\n  });\n}\n\nexport async function evaluateGoalProgressWithLlm(args: {\n  runtime: IAgentRuntime;\n  evidence: Record<string, unknown>;\n  goal: LifeOpsGoalDefinition;\n  nowIso: string;\n}): Promise<GoalSemanticEvaluationResult | null> {\n  if (typeof args.runtime.useModel !== \"function\") {\n    return null;\n  }\n  const prompt = buildSemanticEvaluationPrompt(args);\n  try {\n    const raw = await runWithTrajectoryContext(\n      { purpose: \"lifeops-goal-evaluator-first-pass\" },\n      () => args.runtime.useModel(ModelType.TEXT_LARGE, { prompt }),\n    );\n    const parsed = parseSemanticEvaluationOutput(\n      typeof raw === \"string\" ? raw : \"\",\n    );\n    const evaluation = parsed\n      ? buildSemanticEvaluationResult(parsed, args.nowIso)\n      : null;\n    if (evaluation) {\n      return evaluation;\n    }\n    const repairedRaw = await runWithTrajectoryContext(\n      { purpose: \"lifeops-goal-evaluator-repair-pass\" },\n      () =>\n        args.runtime.useModel(ModelType.TEXT_LARGE, {\n          prompt: buildSemanticRepairPrompt({\n            evidence: args.evidence,\n            goal: args.goal,\n            nowIso: args.nowIso,\n            rawResponse: typeof raw === \"string\" ? raw : \"\",\n          }),\n        }),\n    );\n    const repairedParsed = parseSemanticEvaluationOutput(\n      typeof repairedRaw === \"string\" ? repairedRaw : \"\",\n    );\n    return repairedParsed\n      ? buildSemanticEvaluationResult(repairedParsed, args.nowIso)\n      : null;\n  } catch (error) {\n    logger.warn(\n      {\n        boundary: \"lifeops\",\n        component: \"goal-semantic-evaluator\",\n        goalId: args.goal.id,\n        detail: error instanceof Error ? error.message : String(error),\n      },\n      \"[goal-semantic-evaluator] evaluation failed; returning null\",\n    );\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/goals-runtime.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Standalone {@link GoalsService} construction for the plugin-goals action and
+ * routes, with default hooks for the owner-scoped surface.
+ *
+ * The two PA-owned concerns the service needs are reproduced here for the
+ * PA-free deployment topology:
+ *   - `normalizeOwnership` — the action drives the owner surface (ADMIN role,
+ *     owner contexts), so goals are always owner-scoped. We return the fixed
+ *     owner ownership (`user_lifeops` / `owner` / `owner_only` /
+ *     `explicit_only`, subjectId = the agent's admin entity) that PA's
+ *     `normalizeOwnership` produces for the owner case.
+ *   - `recordAudit` — writes the goal audit event into PA's shared
+ *     `app_lifeops.life_audit_events` table via {@link GoalsRepository}.
+ *
+ * When PA is loaded it constructs the {@link GoalsService} with its own
+ * `recordAudit` / `normalizeOwnership` bound from the LifeOps service base, so
+ * the agent-scoped path and PA's domain invariants stay intact.
+ */
+import { type IAgentRuntime } from "@elizaos/core";
+import type { LifeOpsOwnership } from "@elizaos/shared";
+import { GoalsService } from "./goals-service.js";
+/** Owner-entity id PA derives for the admin/owner entity of an agent. */
+export declare function ownerEntityIdFor(runtime: IAgentRuntime): string;
+/**
+ * Fixed owner-scope ownership. Matches the result of PA's `normalizeOwnership`
+ * for an owner request with no explicit overrides.
+ */
+export declare function buildOwnerOwnership(runtime: IAgentRuntime): LifeOpsOwnership;
+/**
+ * Construct a {@link GoalsService} bound to the owner surface with default
+ * hooks, for use without `@elizaos/plugin-personal-assistant`.
+ */
+export declare function createOwnerGoalsService(runtime: IAgentRuntime): GoalsService;
+//# sourceMappingURL=goals-runtime.d.ts.map

package/dist/goals-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals-runtime.d.ts","sourceRoot":"","sources":["../src/goals-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD,OAAO,EAGL,YAAY,EACb,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CA6B5E"}

package/dist/goals-runtime.js

@@ -0,0 +1,44 @@
+import crypto from "node:crypto";
+import { stringToUuid } from "@elizaos/core";
+import { GoalsRepository } from "./db/goals-repository.js";
+import { requireAgentId } from "./goal-normalize.js";
+import {
+  GoalsService
+} from "./goals-service.js";
+function ownerEntityIdFor(runtime) {
+  return stringToUuid(`${requireAgentId(runtime)}-admin-entity`);
+}
+function buildOwnerOwnership(runtime) {
+  return {
+    domain: "user_lifeops",
+    subjectType: "owner",
+    subjectId: ownerEntityIdFor(runtime),
+    visibilityScope: "owner_only",
+    contextPolicy: "explicit_only"
+  };
+}
+function createOwnerGoalsService(runtime) {
+  const repository = new GoalsRepository(runtime);
+  const normalizeOwnership = () => buildOwnerOwnership(runtime);
+  const recordAudit = async (eventType, ownerType, ownerId, reason, inputs, decision) => {
+    await repository.createAuditEvent({
+      id: crypto.randomUUID(),
+      agentId: requireAgentId(runtime),
+      eventType,
+      ownerType,
+      ownerId,
+      reason,
+      inputs,
+      decision,
+      actor: "user",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  };
+  return new GoalsService(runtime, { recordAudit, normalizeOwnership });
+}
+export {
+  buildOwnerOwnership,
+  createOwnerGoalsService,
+  ownerEntityIdFor
+};
+//# sourceMappingURL=goals-runtime.js.map

package/dist/goals-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/goals-runtime.ts"],"sourcesContent":["/**\n * Standalone {@link GoalsService} construction for the plugin-goals action and\n * routes, with default hooks for the owner-scoped surface.\n *\n * The two PA-owned concerns the service needs are reproduced here for the\n * PA-free deployment topology:\n *   - `normalizeOwnership` — the action drives the owner surface (ADMIN role,\n *     owner contexts), so goals are always owner-scoped. We return the fixed\n *     owner ownership (`user_lifeops` / `owner` / `owner_only` /\n *     `explicit_only`, subjectId = the agent's admin entity) that PA's\n *     `normalizeOwnership` produces for the owner case.\n *   - `recordAudit` — writes the goal audit event into PA's shared\n *     `app_lifeops.life_audit_events` table via {@link GoalsRepository}.\n *\n * When PA is loaded it constructs the {@link GoalsService} with its own\n * `recordAudit` / `normalizeOwnership` bound from the LifeOps service base, so\n * the agent-scoped path and PA's domain invariants stay intact.\n */\n\nimport crypto from \"node:crypto\";\nimport { type IAgentRuntime, stringToUuid } from \"@elizaos/core\";\nimport type { LifeOpsOwnership } from \"@elizaos/shared\";\nimport { GoalsRepository } from \"./db/goals-repository.js\";\nimport { requireAgentId } from \"./goal-normalize.js\";\nimport {\n  type GoalsNormalizeOwnership,\n  type GoalsRecordAudit,\n  GoalsService,\n} from \"./goals-service.js\";\n\n/** Owner-entity id PA derives for the admin/owner entity of an agent. */\nexport function ownerEntityIdFor(runtime: IAgentRuntime): string {\n  return stringToUuid(`${requireAgentId(runtime)}-admin-entity`);\n}\n\n/**\n * Fixed owner-scope ownership. Matches the result of PA's `normalizeOwnership`\n * for an owner request with no explicit overrides.\n */\nexport function buildOwnerOwnership(runtime: IAgentRuntime): LifeOpsOwnership {\n  return {\n    domain: \"user_lifeops\",\n    subjectType: \"owner\",\n    subjectId: ownerEntityIdFor(runtime),\n    visibilityScope: \"owner_only\",\n    contextPolicy: \"explicit_only\",\n  };\n}\n\n/**\n * Construct a {@link GoalsService} bound to the owner surface with default\n * hooks, for use without `@elizaos/plugin-personal-assistant`.\n */\nexport function createOwnerGoalsService(runtime: IAgentRuntime): GoalsService {\n  const repository = new GoalsRepository(runtime);\n\n  const normalizeOwnership: GoalsNormalizeOwnership = () =>\n    buildOwnerOwnership(runtime);\n\n  const recordAudit: GoalsRecordAudit = async (\n    eventType,\n    ownerType,\n    ownerId,\n    reason,\n    inputs,\n    decision,\n  ) => {\n    await repository.createAuditEvent({\n      id: crypto.randomUUID(),\n      agentId: requireAgentId(runtime),\n      eventType,\n      ownerType,\n      ownerId,\n      reason,\n      inputs,\n      decision,\n      actor: \"user\",\n      createdAt: new Date().toISOString(),\n    });\n  };\n\n  return new GoalsService(runtime, { recordAudit, normalizeOwnership });\n}\n"],"mappings":"AAmBA,OAAO,YAAY;AACnB,SAA6B,oBAAoB;AAEjD,SAAS,uBAAuB;AAChC,SAAS,sBAAsB;AAC/B;AAAA,EAGE;AAAA,OACK;AAGA,SAAS,iBAAiB,SAAgC;AAC/D,SAAO,aAAa,GAAG,eAAe,OAAO,CAAC,eAAe;AAC/D;AAMO,SAAS,oBAAoB,SAA0C;AAC5E,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,WAAW,iBAAiB,OAAO;AAAA,IACnC,iBAAiB;AAAA,IACjB,eAAe;AAAA,EACjB;AACF;AAMO,SAAS,wBAAwB,SAAsC;AAC5E,QAAM,aAAa,IAAI,gBAAgB,OAAO;AAE9C,QAAM,qBAA8C,MAClD,oBAAoB,OAAO;AAE7B,QAAM,cAAgC,OACpC,WACA,WACA,SACA,QACA,QACA,aACG;AACH,UAAM,WAAW,iBAAiB;AAAA,MAChC,IAAI,OAAO,WAAW;AAAA,MACtB,SAAS,eAAe,OAAO;AAAA,MAC/B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO;AAAA,MACP,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,aAAa,SAAS,EAAE,aAAa,mBAAmB,CAAC;AACtE;","names":[]}

package/dist/goals-service.d.ts

@@ -0,0 +1,68 @@
+/**
+ * GoalsService — the goals back-end (goal CRUD + dedup + similarity scoring).
+ *
+ * Standalone successor to the goal CRUD half of PA's `withGoals` LifeOps
+ * service mixin. It holds its own runtime + {@link GoalsRepository} and the
+ * small identity helpers the methods need, so it has no dependency on
+ * `@elizaos/plugin-personal-assistant`. Behavior and the data it returns are
+ * preserved verbatim from the original mixin.
+ *
+ * Cross-domain goal logic is NOT here: goal review / overview / experience-loop
+ * (`reviewGoal`, `getOverview`, `buildGoalExperienceLoop`,
+ * `reviewGoalsForWeek`, `explainOccurrence`) aggregate PA's
+ * definition / occurrence / reminder / calendar / activity-signal graph, so
+ * they remain LifeOps mixin methods in PA.
+ *
+ * Two PA-owned concerns are taken as injected hooks rather than reimplemented:
+ *   - `recordAudit` — audit events persist into PA's shared `app_lifeops` audit
+ *     store; goal creates/updates/deletes record there exactly as before.
+ *   - `normalizeOwnership` — ownership normalization carries PA's domain /
+ *     subject rules and resolves the owner-entity / agent identity; it stays
+ *     PA-owned and is passed in.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+import { type CreateLifeOpsGoalRequest, type LifeOpsAuditEventType, type LifeOpsGoalDefinition, type LifeOpsGoalRecord, type LifeOpsOwnership, type LifeOpsOwnershipInput, type UpdateLifeOpsGoalRequest } from "@elizaos/shared";
+import { GoalsRepository } from "./db/goals-repository.js";
+/**
+ * Compute a 0..1 similarity score between a reference goal and an existing
+ * candidate. Used by {@link GoalsService.createGoal} for near-duplicate
+ * short-circuiting and (in PA) by the goal experience-loop matcher.
+ */
+export declare function scoreGoalSimilarity(args: {
+    reference: {
+        title: string;
+        description?: string | null;
+        successCriteria?: Record<string, unknown> | null;
+    };
+    candidate: LifeOpsGoalDefinition;
+}): number;
+/**
+ * Audit hook signature. Mirrors PA's `recordAudit` exactly; the goal back-end
+ * always passes `ownerType: "goal"`.
+ */
+export type GoalsRecordAudit = (eventType: LifeOpsAuditEventType, ownerType: "goal", ownerId: string, reason: string, inputs: Record<string, unknown>, decision: Record<string, unknown>) => Promise<void>;
+/**
+ * Ownership-normalization hook signature. Mirrors PA's `normalizeOwnership`.
+ * Stays PA-owned because it resolves owner-entity / agent identity and applies
+ * PA's domain / subject invariants.
+ */
+export type GoalsNormalizeOwnership = (input: LifeOpsOwnershipInput | undefined, current?: LifeOpsOwnership) => LifeOpsOwnership;
+export interface GoalsServiceDependencies {
+    recordAudit: GoalsRecordAudit;
+    normalizeOwnership: GoalsNormalizeOwnership;
+}
+export declare class GoalsService {
+    private readonly runtime;
+    readonly repository: GoalsRepository;
+    private readonly recordAudit;
+    private readonly normalizeOwnership;
+    constructor(runtime: IAgentRuntime, deps: GoalsServiceDependencies);
+    private agentId;
+    private getGoalRecord;
+    deleteGoal(goalId: string): Promise<void>;
+    listGoals(): Promise<LifeOpsGoalRecord[]>;
+    getGoal(goalId: string): Promise<LifeOpsGoalRecord>;
+    createGoal(request: CreateLifeOpsGoalRequest): Promise<LifeOpsGoalRecord>;
+    updateGoal(goalId: string, request: UpdateLifeOpsGoalRequest): Promise<LifeOpsGoalRecord>;
+}
+//# sourceMappingURL=goals-service.d.ts.map

package/dist/goals-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals-service.d.ts","sourceRoot":"","sources":["../src/goals-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAoDlC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAClD,CAAC;IACF,SAAS,EAAE,qBAAqB,CAAC;CAClC,GAAG,MAAM,CAoCT;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,qBAAqB,GAAG,SAAS,EACxC,OAAO,CAAC,EAAE,gBAAgB,KACvB,gBAAgB,CAAC;AAEtB,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,gBAAgB,CAAC;IAC9B,kBAAkB,EAAE,uBAAuB,CAAC;CAC7C;AAED,qBAAa,YAAY;IAMrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0B;gBAG1C,OAAO,EAAE,aAAa,EACvC,IAAI,EAAE,wBAAwB;IAOhC,OAAO,CAAC,OAAO;YAID,aAAa;IAYrB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBzC,SAAS,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAazC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInD,UAAU,CACd,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;IA+HvB,UAAU,CACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,iBAAiB,CAAC;CAkE9B"}