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

package/dist/actions/goals.d.ts

@@ -0,0 +1,16 @@
+/**
+ * OWNER_GOALS — owner-set long-horizon life goals.
+ *
+ * Self-contained goal CRUD surface backed by {@link GoalsService} (the goals
+ * back-end this plugin owns). Used in the PA-free deployment topology; when
+ * `@elizaos/plugin-personal-assistant` is loaded it registers its own richer
+ * `OWNER_GOALS` natural-language flow, which delegates to the same
+ * {@link GoalsService} CRUD methods.
+ *
+ * Dispatch: create | update | delete | review. The handler resolves the
+ * subaction + params (planner-trust path first, LLM extraction fallback) via
+ * `resolveActionArgs`, then calls the goals back-end.
+ */
+import { type Action } from "@elizaos/core";
+export declare const ownerGoalsAction: Action;
+//# sourceMappingURL=goals.d.ts.map

package/dist/actions/goals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goals.d.ts","sourceRoot":"","sources":["../../src/actions/goals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,MAAM,EASZ,MAAM,eAAe,CAAC;AA2CvB,eAAO,MAAM,gBAAgB,EAAE,MA4H9B,CAAC"}

package/dist/actions/goals.js

@@ -0,0 +1,150 @@
+import {
+  resolveActionArgs
+} from "@elizaos/core";
+import { GoalsServiceError } from "../goal-normalize.js";
+import { createOwnerGoalsService } from "../goals-runtime.js";
+import { GOAL_ACTIONS, GOALS_CONTEXTS, GOALS_LOG_PREFIX } from "../types.js";
+const SUBACTIONS = {
+  create: {
+    description: "Create a new owner long-horizon life goal.",
+    descriptionCompressed: "create owner long-horizon goal",
+    required: ["title"],
+    optional: ["description"]
+  },
+  update: {
+    description: "Update an existing owner goal by id.",
+    descriptionCompressed: "update owner goal by id",
+    required: ["id"],
+    optional: ["title", "description"]
+  },
+  delete: {
+    description: "Delete an owner goal by id.",
+    descriptionCompressed: "delete owner goal by id",
+    required: ["id"]
+  },
+  review: {
+    description: "Review the current state of an owner goal by id.",
+    descriptionCompressed: "review owner goal state by id",
+    required: ["id"]
+  }
+};
+function describeGoal(record) {
+  return record.goal.title;
+}
+const ownerGoalsAction = {
+  name: "OWNER_GOALS",
+  description: "Manage the owner's long-horizon life goals. Actions: create, update, delete, review. Goals carry a horizon (e.g. quarter, year, life) and feed routine + reminder generation.",
+  descriptionCompressed: "owner goals: create|update|delete|review; long-horizon, drives routines",
+  contexts: [...GOALS_CONTEXTS],
+  contextGate: { anyOf: [...GOALS_CONTEXTS] },
+  roleGate: { minRole: "ADMIN" },
+  tags: [
+    "domain:goals",
+    "capability:write",
+    "capability:update",
+    "capability:delete",
+    "surface:owner"
+  ],
+  similes: ["GOALS", "LIFE_GOALS", "SET_GOAL", "UPDATE_GOAL", "REVIEW_GOALS"],
+  parameters: [
+    {
+      name: "action",
+      description: "Action: create | update | delete | review.",
+      required: true,
+      schema: { type: "string", enum: [...GOAL_ACTIONS] }
+    },
+    {
+      name: "id",
+      description: "Goal id (update/delete/review).",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "title",
+      description: "Goal title (create/update).",
+      required: false,
+      schema: { type: "string" }
+    },
+    {
+      name: "description",
+      description: "Longer goal description (create/update).",
+      required: false,
+      schema: { type: "string" }
+    }
+  ],
+  validate: async (_runtime) => true,
+  handler: async (runtime, message, state, options, callback) => {
+    const resolved = await resolveActionArgs({
+      runtime,
+      message,
+      state,
+      options,
+      actionName: "OWNER_GOALS",
+      subactions: SUBACTIONS
+    });
+    if (!resolved.ok) {
+      await callback?.({ text: resolved.clarification });
+      return {
+        success: false,
+        text: resolved.clarification,
+        data: { action: "clarify", missing: resolved.missing }
+      };
+    }
+    const service = createOwnerGoalsService(runtime);
+    const { subaction, params } = resolved;
+    try {
+      switch (subaction) {
+        case "create": {
+          const record = await service.createGoal({
+            title: params.title ?? "",
+            description: params.description
+          });
+          const text = `Added goal "${describeGoal(record)}".`;
+          await callback?.({ text });
+          return { success: true, text, data: { action: "create", record } };
+        }
+        case "update": {
+          const record = await service.updateGoal(params.id ?? "", {
+            ...params.title !== void 0 ? { title: params.title } : {},
+            ...params.description !== void 0 ? { description: params.description } : {}
+          });
+          const text = `Updated goal "${describeGoal(record)}".`;
+          await callback?.({ text });
+          return { success: true, text, data: { action: "update", record } };
+        }
+        case "delete": {
+          const record = await service.getGoal(params.id ?? "");
+          await service.deleteGoal(params.id ?? "");
+          const text = `${describeGoal(record)} is off your goals list.`;
+          await callback?.({ text });
+          return {
+            success: true,
+            text,
+            data: { action: "delete", id: params.id }
+          };
+        }
+        case "review": {
+          const record = await service.getGoal(params.id ?? "");
+          const text = `Goal "${describeGoal(record)}" is ${record.goal.reviewState.replace(/_/g, " ")} (status: ${record.goal.status}).`;
+          await callback?.({ text });
+          return { success: true, text, data: { action: "review", record } };
+        }
+      }
+    } catch (error) {
+      if (error instanceof GoalsServiceError) {
+        const text = `${GOALS_LOG_PREFIX} ${error.message}`;
+        await callback?.({ text });
+        return {
+          success: false,
+          text,
+          data: { action: subaction, error: error.message }
+        };
+      }
+      throw error;
+    }
+  }
+};
+export {
+  ownerGoalsAction
+};
+//# sourceMappingURL=goals.js.map

package/dist/actions/goals.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/actions/goals.ts"],"sourcesContent":["/**\n * OWNER_GOALS — owner-set long-horizon life goals.\n *\n * Self-contained goal CRUD surface backed by {@link GoalsService} (the goals\n * back-end this plugin owns). Used in the PA-free deployment topology; when\n * `@elizaos/plugin-personal-assistant` is loaded it registers its own richer\n * `OWNER_GOALS` natural-language flow, which delegates to the same\n * {@link GoalsService} CRUD methods.\n *\n * Dispatch: create | update | delete | review. The handler resolves the\n * subaction + params (planner-trust path first, LLM extraction fallback) via\n * `resolveActionArgs`, then calls the goals back-end.\n */\n\nimport {\n  type Action,\n  type ActionResult,\n  type HandlerCallback,\n  type HandlerOptions,\n  type IAgentRuntime,\n  type Memory,\n  resolveActionArgs,\n  type State,\n  type SubactionsMap,\n} from \"@elizaos/core\";\nimport type { LifeOpsGoalRecord } from \"@elizaos/shared\";\nimport { GoalsServiceError } from \"../goal-normalize.js\";\nimport { createOwnerGoalsService } from \"../goals-runtime.js\";\nimport { GOAL_ACTIONS, GOALS_CONTEXTS, GOALS_LOG_PREFIX } from \"../types.js\";\n\ntype GoalSubaction = (typeof GOAL_ACTIONS)[number];\n\ninterface GoalActionParams {\n  id?: string;\n  title?: string;\n  description?: string;\n}\n\nconst SUBACTIONS: SubactionsMap<GoalSubaction> = {\n  create: {\n    description: \"Create a new owner long-horizon life goal.\",\n    descriptionCompressed: \"create owner long-horizon goal\",\n    required: [\"title\"],\n    optional: [\"description\"],\n  },\n  update: {\n    description: \"Update an existing owner goal by id.\",\n    descriptionCompressed: \"update owner goal by id\",\n    required: [\"id\"],\n    optional: [\"title\", \"description\"],\n  },\n  delete: {\n    description: \"Delete an owner goal by id.\",\n    descriptionCompressed: \"delete owner goal by id\",\n    required: [\"id\"],\n  },\n  review: {\n    description: \"Review the current state of an owner goal by id.\",\n    descriptionCompressed: \"review owner goal state by id\",\n    required: [\"id\"],\n  },\n};\n\nfunction describeGoal(record: LifeOpsGoalRecord): string {\n  return record.goal.title;\n}\n\nexport const ownerGoalsAction: Action = {\n  name: \"OWNER_GOALS\",\n  description:\n    \"Manage the owner's long-horizon life goals. Actions: create, update, delete, review. Goals carry a horizon (e.g. quarter, year, life) and feed routine + reminder generation.\",\n  descriptionCompressed:\n    \"owner goals: create|update|delete|review; long-horizon, drives routines\",\n  contexts: [...GOALS_CONTEXTS],\n  contextGate: { anyOf: [...GOALS_CONTEXTS] },\n  roleGate: { minRole: \"ADMIN\" },\n  tags: [\n    \"domain:goals\",\n    \"capability:write\",\n    \"capability:update\",\n    \"capability:delete\",\n    \"surface:owner\",\n  ],\n  similes: [\"GOALS\", \"LIFE_GOALS\", \"SET_GOAL\", \"UPDATE_GOAL\", \"REVIEW_GOALS\"],\n  parameters: [\n    {\n      name: \"action\",\n      description: \"Action: create | update | delete | review.\",\n      required: true,\n      schema: { type: \"string\" as const, enum: [...GOAL_ACTIONS] },\n    },\n    {\n      name: \"id\",\n      description: \"Goal id (update/delete/review).\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"title\",\n      description: \"Goal title (create/update).\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n    {\n      name: \"description\",\n      description: \"Longer goal description (create/update).\",\n      required: false,\n      schema: { type: \"string\" as const },\n    },\n  ],\n  validate: async (_runtime: IAgentRuntime): Promise<boolean> => true,\n  handler: async (\n    runtime: IAgentRuntime,\n    message: Memory,\n    state?: State,\n    options?: HandlerOptions,\n    callback?: HandlerCallback,\n  ): Promise<ActionResult> => {\n    const resolved = await resolveActionArgs<GoalSubaction, GoalActionParams>({\n      runtime,\n      message,\n      state,\n      options,\n      actionName: \"OWNER_GOALS\",\n      subactions: SUBACTIONS,\n    });\n    if (!resolved.ok) {\n      await callback?.({ text: resolved.clarification });\n      return {\n        success: false,\n        text: resolved.clarification,\n        data: { action: \"clarify\", missing: resolved.missing },\n      };\n    }\n\n    const service = createOwnerGoalsService(runtime);\n    const { subaction, params } = resolved;\n\n    try {\n      switch (subaction) {\n        case \"create\": {\n          const record = await service.createGoal({\n            title: params.title ?? \"\",\n            description: params.description,\n          });\n          const text = `Added goal \"${describeGoal(record)}\".`;\n          await callback?.({ text });\n          return { success: true, text, data: { action: \"create\", record } };\n        }\n        case \"update\": {\n          const record = await service.updateGoal(params.id ?? \"\", {\n            ...(params.title !== undefined ? { title: params.title } : {}),\n            ...(params.description !== undefined\n              ? { description: params.description }\n              : {}),\n          });\n          const text = `Updated goal \"${describeGoal(record)}\".`;\n          await callback?.({ text });\n          return { success: true, text, data: { action: \"update\", record } };\n        }\n        case \"delete\": {\n          const record = await service.getGoal(params.id ?? \"\");\n          await service.deleteGoal(params.id ?? \"\");\n          const text = `${describeGoal(record)} is off your goals list.`;\n          await callback?.({ text });\n          return {\n            success: true,\n            text,\n            data: { action: \"delete\", id: params.id },\n          };\n        }\n        case \"review\": {\n          const record = await service.getGoal(params.id ?? \"\");\n          const text = `Goal \"${describeGoal(record)}\" is ${record.goal.reviewState.replace(/_/g, \" \")} (status: ${record.goal.status}).`;\n          await callback?.({ text });\n          return { success: true, text, data: { action: \"review\", record } };\n        }\n      }\n    } catch (error) {\n      if (error instanceof GoalsServiceError) {\n        const text = `${GOALS_LOG_PREFIX} ${error.message}`;\n        await callback?.({ text });\n        return {\n          success: false,\n          text,\n          data: { action: subaction, error: error.message },\n        };\n      }\n      throw error;\n    }\n  },\n};\n"],"mappings":"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","names":[]}

package/dist/components/goals/GoalsSpatialView.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GoalsSpatialView — the owner life-direction surface authored once with the
+ * spatial vocabulary, so it renders correctly wherever it is displayed:
+ *
+ *   - GUI / XR — mounted in `<SpatialSurface>` (DOM; XR scales up).
+ *   - TUI      — rendered to real terminal lines by the agent terminal, via
+ *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).
+ *
+ * It is purely presentational (a snapshot + an action callback in, primitives
+ * out) and imports only the cross-modality primitives plus this plugin's own
+ * display DTOs, so it is safe to render in the Node agent process where the
+ * terminal lives (no browser/data-fetch import).
+ *
+ * The view is read-only: goals are owned by the personal-assistant routes and
+ * created through the assistant chat, not mutated here. The only interactions
+ * are the status-filter toggles, a Retry on the error state, and the "Set a
+ * goal" chat affordance on the empty state.
+ */
+import { type GoalItem, type GoalStatus } from "../../types.js";
+/** Coarse load state of the goals surface. */
+export type GoalsLoadStatus = "loading" | "error" | "ready";
+export interface GoalsSnapshot {
+    /** Coarse load state. */
+    status: GoalsLoadStatus;
+    /** Goal records (empty until ready). */
+    goals: GoalItem[];
+    /** Active status filters; empty = show every status. */
+    activeStatuses: GoalStatus[];
+    /** Error text when status is "error". */
+    error?: string | null;
+}
+export interface GoalsSpatialViewProps {
+    snapshot: GoalsSnapshot;
+    /**
+     * Dispatch by agent id: `retry` (re-fetch on the error state), `new` (ask the
+     * assistant to set a goal), and `filter:<status>` (toggle one status chip,
+     * status ∈ active|paused|archived|satisfied).
+     */
+    onAction?: (action: string) => void;
+}
+export declare function GoalsSpatialView({ snapshot, onAction, }: GoalsSpatialViewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=GoalsSpatialView.d.ts.map

package/dist/components/goals/GoalsSpatialView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalsSpatialView.d.ts","sourceRoot":"","sources":["../../../src/components/goals/GoalsSpatialView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAEL,KAAK,QAAQ,EAEb,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAC;AAExB,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,eAAe,CAAC;IACxB,wCAAwC;IACxC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wDAAwD;IACxD,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AA0DD,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,QAAQ,GACT,EAAE,qBAAqB,2CAqBvB"}

package/dist/components/goals/GoalsSpatialView.js

@@ -0,0 +1,149 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Button, Card, HStack, List, Text, VStack } from "@elizaos/ui/spatial";
+import {
+  GOAL_STATUSES
+} from "../../types.js";
+const STATUS_LABELS = {
+  active: "Active",
+  paused: "Paused",
+  archived: "Archived",
+  satisfied: "Achieved"
+};
+const REVIEW_LABELS = {
+  idle: "not reviewed",
+  on_track: "on track",
+  at_risk: "at risk",
+  needs_attention: "needs attention"
+};
+const REVIEW_GLYPH = {
+  idle: "\u25CB",
+  on_track: "\u25CF",
+  at_risk: "x",
+  needs_attention: "x"
+};
+const REVIEW_TONE = {
+  idle: "muted",
+  on_track: "success",
+  at_risk: "danger",
+  needs_attention: "danger"
+};
+function formatDate(value) {
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return value;
+  return date.toLocaleDateString(void 0, {
+    month: "short",
+    day: "numeric",
+    year: "numeric"
+  });
+}
+function reviewNudge(goals) {
+  const flagged = goals.filter(
+    (goal) => goal.reviewState === "at_risk" || goal.reviewState === "needs_attention"
+  ).length;
+  if (flagged === 0) return null;
+  return flagged === 1 ? "1 goal needs a review." : `${flagged} goals need a review.`;
+}
+function GoalsSpatialView({
+  snapshot,
+  onAction
+}) {
+  const dispatch = (action) => () => onAction?.(action);
+  const active = new Set(snapshot.activeStatuses);
+  return /* @__PURE__ */ jsx(Card, { gap: 1, padding: 1, children: snapshot.status === "loading" ? /* @__PURE__ */ jsx(Text, { tone: "muted", style: "caption", children: "Loading goals" }) : snapshot.status === "error" ? /* @__PURE__ */ jsx(GoalsErrorBody, { error: snapshot.error, dispatch }) : /* @__PURE__ */ jsx(
+    GoalsReadyBody,
+    {
+      snapshot,
+      active,
+      dispatch
+    }
+  ) });
+}
+function GoalsErrorBody({
+  error,
+  dispatch
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(Text, { bold: true, children: "Could not load goals" }),
+    error ? /* @__PURE__ */ jsx(Text, { tone: "muted", style: "caption", children: error }) : null,
+    /* @__PURE__ */ jsx(HStack, { gap: 1, children: /* @__PURE__ */ jsx(Button, { agent: "retry", onPress: dispatch("retry"), children: "Retry" }) })
+  ] });
+}
+function GoalsReadyBody({
+  snapshot,
+  active,
+  dispatch
+}) {
+  const nudge = reviewNudge(snapshot.goals);
+  if (snapshot.goals.length === 0) {
+    return /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: "None" }),
+      /* @__PURE__ */ jsx(HStack, { gap: 1, children: /* @__PURE__ */ jsx(Button, { agent: "new", onPress: dispatch("new"), children: "Set a goal" }) })
+    ] });
+  }
+  const groups = GOAL_STATUSES.map((status) => ({
+    status,
+    goals: snapshot.goals.filter((goal) => goal.status === status)
+  })).filter((group) => {
+    if (group.goals.length === 0) return false;
+    if (active.size === 0) return true;
+    return active.has(group.status);
+  });
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    nudge ? /* @__PURE__ */ jsx(Text, { tone: "muted", style: "caption", children: nudge }) : null,
+    /* @__PURE__ */ jsx(HStack, { gap: 1, wrap: true, children: GOAL_STATUSES.map((status) => /* @__PURE__ */ jsx(
+      Button,
+      {
+        variant: active.has(status) ? "solid" : "outline",
+        tone: active.has(status) ? "primary" : "default",
+        agent: `filter:${status}`,
+        onPress: dispatch(`filter:${status}`),
+        children: STATUS_LABELS[status]
+      },
+      status
+    )) }),
+    groups.length === 0 ? /* @__PURE__ */ jsx(Text, { tone: "muted", align: "center", style: "caption", children: "None" }) : groups.map((group) => /* @__PURE__ */ jsx(GoalsStatusGroup, { group }, group.status))
+  ] });
+}
+function GoalsStatusGroup({
+  group
+}) {
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsxs(Text, { style: "caption", tone: "muted", children: [
+      STATUS_LABELS[group.status],
+      " (",
+      group.goals.length,
+      ")"
+    ] }),
+    /* @__PURE__ */ jsx(List, { gap: 0, children: group.goals.map((goal) => /* @__PURE__ */ jsx(GoalRow, { goal }, goal.id)) })
+  ] });
+}
+function GoalRow({ goal }) {
+  const meta = [];
+  if (goal.cadenceKind) meta.push(goal.cadenceKind);
+  if (goal.target) meta.push(goal.target);
+  if (goal.linkedCount > 0) meta.push(`${goal.linkedCount} linked`);
+  return /* @__PURE__ */ jsxs(HStack, { gap: 1, align: "center", children: [
+    /* @__PURE__ */ jsx(Text, { tone: REVIEW_TONE[goal.reviewState], wrap: false, children: REVIEW_GLYPH[goal.reviewState] }),
+    /* @__PURE__ */ jsxs(VStack, { gap: 0, grow: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, wrap: false, children: goal.title }),
+      meta.length > 0 ? /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", wrap: false, children: meta.join(" \xB7 ") }) : null
+    ] }),
+    /* @__PURE__ */ jsxs(VStack, { gap: 0, children: [
+      /* @__PURE__ */ jsx(
+        Text,
+        {
+          style: "caption",
+          tone: REVIEW_TONE[goal.reviewState],
+          wrap: false,
+          align: "end",
+          children: REVIEW_LABELS[goal.reviewState]
+        }
+      ),
+      /* @__PURE__ */ jsx(Text, { style: "caption", tone: "muted", wrap: false, align: "end", children: formatDate(goal.updatedAt) })
+    ] })
+  ] });
+}
+export {
+  GoalsSpatialView
+};
+//# sourceMappingURL=GoalsSpatialView.js.map

package/dist/components/goals/GoalsSpatialView.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/goals/GoalsSpatialView.tsx"],"sourcesContent":["/**\n * GoalsSpatialView — the owner life-direction surface authored once with the\n * spatial vocabulary, so it renders correctly wherever it is displayed:\n *\n *   - GUI / XR — mounted in `<SpatialSurface>` (DOM; XR scales up).\n *   - TUI      — rendered to real terminal lines by the agent terminal, via\n *                `registerSpatialTerminalView` (see `register-terminal-view.tsx`).\n *\n * It is purely presentational (a snapshot + an action callback in, primitives\n * out) and imports only the cross-modality primitives plus this plugin's own\n * display DTOs, so it is safe to render in the Node agent process where the\n * terminal lives (no browser/data-fetch import).\n *\n * The view is read-only: goals are owned by the personal-assistant routes and\n * created through the assistant chat, not mutated here. The only interactions\n * are the status-filter toggles, a Retry on the error state, and the \"Set a\n * goal\" chat affordance on the empty state.\n */\n\nimport { Button, Card, HStack, List, Text, VStack } from \"@elizaos/ui/spatial\";\nimport {\n  GOAL_STATUSES,\n  type GoalItem,\n  type GoalReviewState,\n  type GoalStatus,\n} from \"../../types.js\";\n\n/** Coarse load state of the goals surface. */\nexport type GoalsLoadStatus = \"loading\" | \"error\" | \"ready\";\n\nexport interface GoalsSnapshot {\n  /** Coarse load state. */\n  status: GoalsLoadStatus;\n  /** Goal records (empty until ready). */\n  goals: GoalItem[];\n  /** Active status filters; empty = show every status. */\n  activeStatuses: GoalStatus[];\n  /** Error text when status is \"error\". */\n  error?: string | null;\n}\n\nexport interface GoalsSpatialViewProps {\n  snapshot: GoalsSnapshot;\n  /**\n   * Dispatch by agent id: `retry` (re-fetch on the error state), `new` (ask the\n   * assistant to set a goal), and `filter:<status>` (toggle one status chip,\n   * status ∈ active|paused|archived|satisfied).\n   */\n  onAction?: (action: string) => void;\n}\n\nconst STATUS_LABELS: Record<GoalStatus, string> = {\n  active: \"Active\",\n  paused: \"Paused\",\n  archived: \"Archived\",\n  satisfied: \"Achieved\",\n};\n\nconst REVIEW_LABELS: Record<GoalReviewState, string> = {\n  idle: \"not reviewed\",\n  on_track: \"on track\",\n  at_risk: \"at risk\",\n  needs_attention: \"needs attention\",\n};\n\n// Width-1 review marker — filled vs hollow vs cross, never emoji or a checkmark.\n//   on_track       → ● (settled)\n//   at_risk / needs_attention → x (flagged)\n//   idle           → ○ (not yet reviewed)\nconst REVIEW_GLYPH: Record<GoalReviewState, string> = {\n  idle: \"○\",\n  on_track: \"●\",\n  at_risk: \"x\",\n  needs_attention: \"x\",\n};\n\nconst REVIEW_TONE: Record<GoalReviewState, \"muted\" | \"success\" | \"danger\"> = {\n  idle: \"muted\",\n  on_track: \"success\",\n  at_risk: \"danger\",\n  needs_attention: \"danger\",\n};\n\nfunction formatDate(value: string): string {\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) return value;\n  return date.toLocaleDateString(undefined, {\n    month: \"short\",\n    day: \"numeric\",\n    year: \"numeric\",\n  });\n}\n\n// One quiet proactive line: count the goals whose last review flagged them\n// (at_risk / needs_attention). Returns null when nothing is flagged so the line\n// renders only on a real signal (never \"0 goals\").\nfunction reviewNudge(goals: GoalItem[]): string | null {\n  const flagged = goals.filter(\n    (goal) =>\n      goal.reviewState === \"at_risk\" || goal.reviewState === \"needs_attention\",\n  ).length;\n  if (flagged === 0) return null;\n  return flagged === 1\n    ? \"1 goal needs a review.\"\n    : `${flagged} goals need a review.`;\n}\n\nexport function GoalsSpatialView({\n  snapshot,\n  onAction,\n}: GoalsSpatialViewProps) {\n  const dispatch = (action: string) => () => onAction?.(action);\n  const active = new Set(snapshot.activeStatuses);\n\n  return (\n    <Card gap={1} padding={1}>\n      {snapshot.status === \"loading\" ? (\n        <Text tone=\"muted\" style=\"caption\">\n          Loading goals\n        </Text>\n      ) : snapshot.status === \"error\" ? (\n        <GoalsErrorBody error={snapshot.error} dispatch={dispatch} />\n      ) : (\n        <GoalsReadyBody\n          snapshot={snapshot}\n          active={active}\n          dispatch={dispatch}\n        />\n      )}\n    </Card>\n  );\n}\n\nfunction GoalsErrorBody({\n  error,\n  dispatch,\n}: {\n  error?: string | null;\n  dispatch: (action: string) => () => void;\n}) {\n  return (\n    <>\n      <Text bold>Could not load goals</Text>\n      {error ? (\n        <Text tone=\"muted\" style=\"caption\">\n          {error}\n        </Text>\n      ) : null}\n      <HStack gap={1}>\n        <Button agent=\"retry\" onPress={dispatch(\"retry\")}>\n          Retry\n        </Button>\n      </HStack>\n    </>\n  );\n}\n\nfunction GoalsReadyBody({\n  snapshot,\n  active,\n  dispatch,\n}: {\n  snapshot: GoalsSnapshot;\n  active: Set<GoalStatus>;\n  dispatch: (action: string) => () => void;\n}) {\n  const nudge = reviewNudge(snapshot.goals);\n\n  if (snapshot.goals.length === 0) {\n    return (\n      <>\n        <Text bold>None</Text>\n        <HStack gap={1}>\n          <Button agent=\"new\" onPress={dispatch(\"new\")}>\n            Set a goal\n          </Button>\n        </HStack>\n      </>\n    );\n  }\n\n  // Group by status, dropping empty groups, then apply the active filter.\n  const groups = GOAL_STATUSES.map((status) => ({\n    status,\n    goals: snapshot.goals.filter((goal) => goal.status === status),\n  })).filter((group) => {\n    if (group.goals.length === 0) return false;\n    if (active.size === 0) return true;\n    return active.has(group.status);\n  });\n\n  return (\n    <>\n      {nudge ? (\n        <Text tone=\"muted\" style=\"caption\">\n          {nudge}\n        </Text>\n      ) : null}\n\n      <HStack gap={1} wrap>\n        {GOAL_STATUSES.map((status) => (\n          <Button\n            key={status}\n            variant={active.has(status) ? \"solid\" : \"outline\"}\n            tone={active.has(status) ? \"primary\" : \"default\"}\n            agent={`filter:${status}`}\n            onPress={dispatch(`filter:${status}`)}\n          >\n            {STATUS_LABELS[status]}\n          </Button>\n        ))}\n      </HStack>\n\n      {groups.length === 0 ? (\n        <Text tone=\"muted\" align=\"center\" style=\"caption\">\n          None\n        </Text>\n      ) : (\n        groups.map((group) => (\n          <GoalsStatusGroup key={group.status} group={group} />\n        ))\n      )}\n    </>\n  );\n}\n\nfunction GoalsStatusGroup({\n  group,\n}: {\n  group: { status: GoalStatus; goals: GoalItem[] };\n}) {\n  return (\n    <>\n      <Text style=\"caption\" tone=\"muted\">\n        {STATUS_LABELS[group.status]} ({group.goals.length})\n      </Text>\n      <List gap={0}>\n        {group.goals.map((goal) => (\n          <GoalRow key={goal.id} goal={goal} />\n        ))}\n      </List>\n    </>\n  );\n}\n\nfunction GoalRow({ goal }: { goal: GoalItem }) {\n  const meta: string[] = [];\n  if (goal.cadenceKind) meta.push(goal.cadenceKind);\n  if (goal.target) meta.push(goal.target);\n  if (goal.linkedCount > 0) meta.push(`${goal.linkedCount} linked`);\n\n  return (\n    <HStack gap={1} align=\"center\">\n      <Text tone={REVIEW_TONE[goal.reviewState]} wrap={false}>\n        {REVIEW_GLYPH[goal.reviewState]}\n      </Text>\n      <VStack gap={0} grow={1}>\n        <Text bold wrap={false}>\n          {goal.title}\n        </Text>\n        {meta.length > 0 ? (\n          <Text style=\"caption\" tone=\"muted\" wrap={false}>\n            {meta.join(\" · \")}\n          </Text>\n        ) : null}\n      </VStack>\n      <VStack gap={0}>\n        <Text\n          style=\"caption\"\n          tone={REVIEW_TONE[goal.reviewState]}\n          wrap={false}\n          align=\"end\"\n        >\n          {REVIEW_LABELS[goal.reviewState]}\n        </Text>\n        <Text style=\"caption\" tone=\"muted\" wrap={false} align=\"end\">\n          {formatDate(goal.updatedAt)}\n        </Text>\n      </VStack>\n    </HStack>\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/components/goals/GoalsView.d.ts

@@ -0,0 +1,60 @@
+/**
+ * GoalsView — the single GUI/XR data wrapper for the Goals surface.
+ *
+ * Data-fetching view over the single read-only goals endpoint served by the
+ * personal-assistant routes (PA owns the persistence; this plugin only renders):
+ *   GET {base}/api/lifeops/goals
+ *
+ * The wire payload is `{ goals: LifeOpsGoalRecord[] }`, where each record is
+ * `{ goal: LifeOpsGoalDefinition; links: LifeOpsGoalLink[] }`. We flatten each
+ * record to a `GoalItem` at the fetch boundary so the rest of the view renders
+ * display-only.
+ *
+ * It owns the fetch state machine (loading / error / ready), the status-filter
+ * selection, and the quiet 20s background poll, then renders the one
+ * presentational {@link GoalsSpatialView} inside a {@link SpatialSurface}.
+ * Omitting the `modality` prop lets `SpatialSurface` auto-detect GUI vs XR via
+ * `window.__elizaXRContext`, so the SAME component serves both surfaces. The
+ * TUI surface renders the same `GoalsSpatialView` through the terminal registry
+ * (see `register-terminal-view.tsx`).
+ *
+ * This plugin MUST NOT import from @elizaos/plugin-personal-assistant. The wire
+ * DTOs below are declared locally to match the JSON shape PA emits
+ * (LifeOpsGoalDefinition / LifeOpsGoalLink in @elizaos/shared).
+ */
+import type { ReactNode } from "react";
+interface GoalDefinitionWire {
+    id: string;
+    title: string;
+    description: string;
+    cadence: Record<string, unknown> | null;
+    successCriteria: Record<string, unknown>;
+    status: string;
+    reviewState: string;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+interface GoalLinkWire {
+    id: string;
+    goalId: string;
+    linkedType: string;
+    linkedId: string;
+}
+interface GoalRecordWire {
+    goal: GoalDefinitionWire;
+    links: GoalLinkWire[];
+}
+interface GoalsWire {
+    goals: GoalRecordWire[];
+}
+export interface GoalsFetchers {
+    fetchGoals: () => Promise<GoalsWire>;
+}
+export interface GoalsViewProps {
+    /** Test/host injection seam. Defaults to the real `/api/lifeops/goals` GET. */
+    fetchers?: GoalsFetchers;
+}
+export declare function GoalsView(props?: GoalsViewProps): ReactNode;
+export default GoalsView;
+//# sourceMappingURL=GoalsView.d.ts.map

package/dist/components/goals/GoalsView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalsView.d.ts","sourceRoot":"","sources":["../../../src/components/goals/GoalsView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAgBvC,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,UAAU,SAAS;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAMD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;CACtC;AAcD,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AA+ED,wBAAgB,SAAS,CAAC,KAAK,GAAE,cAAmB,GAAG,SAAS,CA0G/D;AAED,eAAe,SAAS,CAAC"}

package/dist/components/goals/GoalsView.js

@@ -0,0 +1,150 @@
+import { jsx } from "react/jsx-runtime";
+import { client } from "@elizaos/ui";
+import { SpatialSurface } from "@elizaos/ui/spatial";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import {
+  GOAL_STATUSES
+} from "../../types.js";
+import { GoalsSpatialView } from "./GoalsSpatialView.js";
+async function getGoals() {
+  const response = await fetch(`${client.getBaseUrl()}/api/lifeops/goals`);
+  if (!response.ok) {
+    throw new Error(`Goals request failed (${response.status})`);
+  }
+  return await response.json();
+}
+const defaultFetchers = {
+  fetchGoals: getGoals
+};
+const KNOWN_STATUSES = new Set(GOAL_STATUSES);
+const KNOWN_REVIEW_STATES = /* @__PURE__ */ new Set([
+  "idle",
+  "needs_attention",
+  "on_track",
+  "at_risk"
+]);
+function toStatus(value) {
+  return KNOWN_STATUSES.has(value) ? value : "active";
+}
+function toReviewState(value) {
+  return KNOWN_REVIEW_STATES.has(value) ? value : "idle";
+}
+function readCadenceKind(cadence) {
+  if (cadence && typeof cadence.kind === "string" && cadence.kind.length > 0) {
+    return cadence.kind;
+  }
+  return null;
+}
+function readTarget(criteria) {
+  const candidate = criteria.targetText ?? criteria.target ?? criteria.summary ?? criteria.deadline ?? criteria.dueAt;
+  if (typeof candidate === "string" && candidate.length > 0) return candidate;
+  if (typeof candidate === "number") return String(candidate);
+  return null;
+}
+function mapGoal(record) {
+  const { goal, links } = record;
+  return {
+    id: goal.id,
+    title: goal.title,
+    description: goal.description ?? "",
+    status: toStatus(goal.status),
+    reviewState: toReviewState(goal.reviewState),
+    cadenceKind: readCadenceKind(goal.cadence),
+    target: readTarget(goal.successCriteria ?? {}),
+    linkedCount: links.length,
+    updatedAt: goal.updatedAt
+  };
+}
+function requestNewGoal() {
+  client.sendChatMessage?.("Help me set a goal to head toward this quarter.");
+}
+function GoalsView(props = {}) {
+  const fetchers = props.fetchers ?? defaultFetchers;
+  const [state, setState] = useState({ kind: "loading" });
+  const [activeStatuses, setActiveStatuses] = useState(
+    () => /* @__PURE__ */ new Set()
+  );
+  const fetchersRef = useRef(fetchers);
+  fetchersRef.current = fetchers;
+  const load = useCallback(() => {
+    let cancelled = false;
+    setState({ kind: "loading" });
+    fetchersRef.current.fetchGoals().then((wire) => {
+      if (cancelled) return;
+      setState({ kind: "ready", goals: wire.goals.map(mapGoal) });
+    }).catch((error) => {
+      if (cancelled) return;
+      setState({
+        kind: "error",
+        message: error instanceof Error ? error.message : "Could not load goals."
+      });
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, []);
+  useEffect(() => {
+    const cancelInitial = load();
+    let active = true;
+    const interval = setInterval(() => {
+      fetchersRef.current.fetchGoals().then((wire) => {
+        if (active)
+          setState({ kind: "ready", goals: wire.goals.map(mapGoal) });
+      }).catch(() => {
+      });
+    }, 2e4);
+    return () => {
+      active = false;
+      clearInterval(interval);
+      cancelInitial();
+    };
+  }, [load]);
+  const toggleStatus = useCallback((status) => {
+    setActiveStatuses((prev) => {
+      const next = new Set(prev);
+      if (next.has(status)) next.delete(status);
+      else next.add(status);
+      return next;
+    });
+  }, []);
+  const onAction = useCallback(
+    (action) => {
+      if (action.startsWith("filter:")) {
+        const raw = action.slice("filter:".length);
+        if (KNOWN_STATUSES.has(raw)) toggleStatus(raw);
+        return;
+      }
+      switch (action) {
+        case "retry":
+          load();
+          return;
+        case "new":
+          requestNewGoal();
+          return;
+      }
+    },
+    [load, toggleStatus]
+  );
+  const snapshot = useMemo(() => {
+    const activeList = Array.from(activeStatuses);
+    if (state.kind === "loading") {
+      return { status: "loading", goals: [], activeStatuses: activeList };
+    }
+    if (state.kind === "error") {
+      return {
+        status: "error",
+        goals: [],
+        activeStatuses: activeList,
+        error: state.message
+      };
+    }
+    return { status: "ready", goals: state.goals, activeStatuses: activeList };
+  }, [state, activeStatuses]);
+  return /* @__PURE__ */ jsx(SpatialSurface, { children: /* @__PURE__ */ jsx(GoalsSpatialView, { snapshot, onAction }) });
+}
+var GoalsView_default = GoalsView;
+export {
+  GoalsView,
+  GoalsView_default as default
+};
+//# sourceMappingURL=GoalsView.js.map