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

package/dist/services/migration.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Non-destructive data migration for the goal tables carved out of
+ * @elizaos/plugin-personal-assistant.
+ *
+ * The two goal tables (`life_goal_definitions`, `life_goal_links`) used to live
+ * in the `app_lifeops` PostgreSQL schema, created by plugin-personal-assistant.
+ * They now live in `app_goals`, created by this plugin's drizzle schema.
+ * Existing installs still hold the owner's goal rows in `app_lifeops`, so on
+ * first boot we copy them across — once, idempotently, and WITHOUT ever touching
+ * the source.
+ *
+ * Guards (per table, independently):
+ *   1. Skip if the source table does not exist (fresh install / already dropped).
+ *   2. Skip if the target table is non-empty (migration already ran, or the
+ *      plugin owns live data).
+ *   3. Otherwise copy every source row that is not already present in the target
+ *      (a doubly-safe NOT EXISTS guard on the primary key).
+ *
+ * The source table is NEVER dropped or altered. The source and target share the
+ * exact column shape (PA's `app_lifeops` drizzle def and this plugin's
+ * `app_goals` def are column-identical), so the `SELECT s.*` copy is safe.
+ *
+ * Definitions are copied before links so a reader observing mid-copy never sees
+ * a link to a not-yet-copied definition.
+ */
+import { type IAgentRuntime, Service } from "@elizaos/core";
+export declare const GOALS_MIGRATION_LOG_PREFIX = "[Goals]";
+export declare const GOALS_MIGRATION_SERVICE_TYPE = "goals_migration";
+export declare const MIGRATED_GOAL_TABLES: readonly ["life_goal_definitions", "life_goal_links"];
+export type MigratedGoalTable = (typeof MIGRATED_GOAL_TABLES)[number];
+export type SqlExecutor = (sql: string) => Promise<Array<Record<string, unknown>>>;
+export interface TableMigrationResult {
+    table: MigratedGoalTable;
+    outcome: "copied" | "source-missing" | "target-non-empty";
+}
+export declare function migrateGoalTable(exec: SqlExecutor, table: MigratedGoalTable): Promise<TableMigrationResult>;
+export declare function migrateGoalTables(exec: SqlExecutor): Promise<TableMigrationResult[]>;
+/**
+ * Service whose `start()` performs the one-time, guarded, non-destructive copy
+ * of the owner's goal rows from `app_lifeops` into `app_goals`.
+ */
+export declare class GoalsMigrationService extends Service {
+    static readonly serviceType = "goals_migration";
+    capabilityDescription: string;
+    static start(runtime: IAgentRuntime): Promise<GoalsMigrationService>;
+    private run;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=migration.d.ts.map

package/dist/services/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/services/migration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAU,OAAO,EAAE,MAAM,eAAe,CAAC;AAEpE,eAAO,MAAM,0BAA0B,YAAY,CAAC;AACpD,eAAO,MAAM,4BAA4B,oBAAoB,CAAC;AAK9D,eAAO,MAAM,oBAAoB,uDAGvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,WAAW,GAAG,CACxB,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,iBAAiB,CAAC;IACzB,OAAO,EAAE,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;CAC3D;AA0BD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAOjC;AAmCD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,OAAO;IAChD,gBAAyB,WAAW,qBAAgC;IAE3D,qBAAqB,SACoF;WAErG,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAM5D,GAAG;IAqBF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CACrC"}

package/dist/services/migration.js

@@ -0,0 +1,113 @@
+import { logger, Service } from "@elizaos/core";
+const GOALS_MIGRATION_LOG_PREFIX = "[Goals]";
+const GOALS_MIGRATION_SERVICE_TYPE = "goals_migration";
+const SOURCE_SCHEMA = "app_lifeops";
+const TARGET_SCHEMA = "app_goals";
+const MIGRATED_GOAL_TABLES = [
+  "life_goal_definitions",
+  "life_goal_links"
+];
+function quoteIdent(name) {
+  return `"${name.replace(/"/g, '""')}"`;
+}
+async function sourceTableExists(exec, table) {
+  const rows = await exec(
+    `SELECT to_regclass('${SOURCE_SCHEMA}.${table}') IS NOT NULL AS present`
+  );
+  return rows[0]?.present === true || rows[0]?.present === "true";
+}
+async function targetTableIsEmpty(exec, table) {
+  const rows = await exec(
+    `SELECT NOT EXISTS (SELECT 1 FROM ${TARGET_SCHEMA}.${quoteIdent(table)}) AS empty`
+  );
+  return rows[0]?.empty === true || rows[0]?.empty === "true";
+}
+async function migrateGoalTable(exec, table) {
+  if (!await sourceTableExists(exec, table)) {
+    return { table, outcome: "source-missing" };
+  }
+  if (!await targetTableIsEmpty(exec, table)) {
+    return { table, outcome: "target-non-empty" };
+  }
+  const target = `${TARGET_SCHEMA}.${quoteIdent(table)}`;
+  const source = `${SOURCE_SCHEMA}.${quoteIdent(table)}`;
+  await exec(
+    `INSERT INTO ${target}
+       SELECT s.* FROM ${source} AS s
+       WHERE NOT EXISTS (
+         SELECT 1 FROM ${target} AS t WHERE t.id = s.id
+       )`
+  );
+  return { table, outcome: "copied" };
+}
+async function migrateGoalTables(exec) {
+  await exec(`CREATE SCHEMA IF NOT EXISTS ${TARGET_SCHEMA}`);
+  const results = [];
+  for (const table of MIGRATED_GOAL_TABLES) {
+    results.push(await migrateGoalTable(exec, table));
+  }
+  return results;
+}
+function getRuntimeDb(runtime) {
+  const db = runtime.db;
+  if (!db || typeof db.execute !== "function") {
+    throw new Error(
+      `${GOALS_MIGRATION_LOG_PREFIX} runtime.db is unavailable \u2014 @elizaos/plugin-sql must be loaded before @elizaos/plugin-goals.`
+    );
+  }
+  return db;
+}
+function extractRows(result) {
+  if (Array.isArray(result)) {
+    return result.filter(
+      (row) => typeof row === "object" && row !== null && !Array.isArray(row)
+    );
+  }
+  if (result && typeof result === "object" && "rows" in result) {
+    const rows = result.rows;
+    if (Array.isArray(rows)) {
+      return rows.filter(
+        (row) => typeof row === "object" && row !== null && !Array.isArray(row)
+      );
+    }
+  }
+  return [];
+}
+class GoalsMigrationService extends Service {
+  static serviceType = GOALS_MIGRATION_SERVICE_TYPE;
+  capabilityDescription = "Non-destructive one-time copy of goal rows from app_lifeops into app_goals during the plugin-goals carve-out.";
+  static async start(runtime) {
+    const service = new GoalsMigrationService(runtime);
+    await service.run();
+    return service;
+  }
+  async run() {
+    const db = getRuntimeDb(this.runtime);
+    const { sql } = await import("drizzle-orm");
+    const exec = async (statement) => extractRows(await db.execute(sql.raw(statement)));
+    const results = await migrateGoalTables(exec);
+    const copied = results.filter((r) => r.outcome === "copied");
+    if (copied.length > 0) {
+      logger.info(
+        { tables: copied.map((r) => r.table) },
+        `${GOALS_MIGRATION_LOG_PREFIX} copied ${copied.length} goal table(s) from ${SOURCE_SCHEMA} to ${TARGET_SCHEMA}`
+      );
+    } else {
+      logger.debug(
+        { results },
+        `${GOALS_MIGRATION_LOG_PREFIX} no goal tables required copying (already migrated or fresh install)`
+      );
+    }
+  }
+  async stop() {
+  }
+}
+export {
+  GOALS_MIGRATION_LOG_PREFIX,
+  GOALS_MIGRATION_SERVICE_TYPE,
+  GoalsMigrationService,
+  MIGRATED_GOAL_TABLES,
+  migrateGoalTable,
+  migrateGoalTables
+};
+//# sourceMappingURL=migration.js.map

package/dist/services/migration.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/migration.ts"],"sourcesContent":["/**\n * Non-destructive data migration for the goal tables carved out of\n * @elizaos/plugin-personal-assistant.\n *\n * The two goal tables (`life_goal_definitions`, `life_goal_links`) used to live\n * in the `app_lifeops` PostgreSQL schema, created by plugin-personal-assistant.\n * They now live in `app_goals`, created by this plugin's drizzle schema.\n * Existing installs still hold the owner's goal rows in `app_lifeops`, so on\n * first boot we copy them across — once, idempotently, and WITHOUT ever touching\n * the source.\n *\n * Guards (per table, independently):\n *   1. Skip if the source table does not exist (fresh install / already dropped).\n *   2. Skip if the target table is non-empty (migration already ran, or the\n *      plugin owns live data).\n *   3. Otherwise copy every source row that is not already present in the target\n *      (a doubly-safe NOT EXISTS guard on the primary key).\n *\n * The source table is NEVER dropped or altered. The source and target share the\n * exact column shape (PA's `app_lifeops` drizzle def and this plugin's\n * `app_goals` def are column-identical), so the `SELECT s.*` copy is safe.\n *\n * Definitions are copied before links so a reader observing mid-copy never sees\n * a link to a not-yet-copied definition.\n */\n\nimport { type IAgentRuntime, logger, Service } from \"@elizaos/core\";\n\nexport const GOALS_MIGRATION_LOG_PREFIX = \"[Goals]\";\nexport const GOALS_MIGRATION_SERVICE_TYPE = \"goals_migration\";\n\nconst SOURCE_SCHEMA = \"app_lifeops\";\nconst TARGET_SCHEMA = \"app_goals\";\n\nexport const MIGRATED_GOAL_TABLES = [\n  \"life_goal_definitions\",\n  \"life_goal_links\",\n] as const;\n\nexport type MigratedGoalTable = (typeof MIGRATED_GOAL_TABLES)[number];\n\nexport type SqlExecutor = (\n  sql: string,\n) => Promise<Array<Record<string, unknown>>>;\n\nexport interface TableMigrationResult {\n  table: MigratedGoalTable;\n  outcome: \"copied\" | \"source-missing\" | \"target-non-empty\";\n}\n\nfunction quoteIdent(name: string): string {\n  return `\"${name.replace(/\"/g, '\"\"')}\"`;\n}\n\nasync function sourceTableExists(\n  exec: SqlExecutor,\n  table: MigratedGoalTable,\n): Promise<boolean> {\n  const rows = await exec(\n    `SELECT to_regclass('${SOURCE_SCHEMA}.${table}') IS NOT NULL AS present`,\n  );\n  return rows[0]?.present === true || rows[0]?.present === \"true\";\n}\n\nasync function targetTableIsEmpty(\n  exec: SqlExecutor,\n  table: MigratedGoalTable,\n): Promise<boolean> {\n  const rows = await exec(\n    `SELECT NOT EXISTS (SELECT 1 FROM ${TARGET_SCHEMA}.${quoteIdent(table)}) AS empty`,\n  );\n  return rows[0]?.empty === true || rows[0]?.empty === \"true\";\n}\n\nexport async function migrateGoalTable(\n  exec: SqlExecutor,\n  table: MigratedGoalTable,\n): Promise<TableMigrationResult> {\n  if (!(await sourceTableExists(exec, table))) {\n    return { table, outcome: \"source-missing\" };\n  }\n  if (!(await targetTableIsEmpty(exec, table))) {\n    return { table, outcome: \"target-non-empty\" };\n  }\n\n  const target = `${TARGET_SCHEMA}.${quoteIdent(table)}`;\n  const source = `${SOURCE_SCHEMA}.${quoteIdent(table)}`;\n  await exec(\n    `INSERT INTO ${target}\n       SELECT s.* FROM ${source} AS s\n       WHERE NOT EXISTS (\n         SELECT 1 FROM ${target} AS t WHERE t.id = s.id\n       )`,\n  );\n  return { table, outcome: \"copied\" };\n}\n\nexport async function migrateGoalTables(\n  exec: SqlExecutor,\n): Promise<TableMigrationResult[]> {\n  await exec(`CREATE SCHEMA IF NOT EXISTS ${TARGET_SCHEMA}`);\n  const results: TableMigrationResult[] = [];\n  for (const table of MIGRATED_GOAL_TABLES) {\n    results.push(await migrateGoalTable(exec, table));\n  }\n  return results;\n}\n\ntype RuntimeDb = {\n  execute: (query: unknown) => Promise<unknown>;\n};\n\nfunction getRuntimeDb(runtime: IAgentRuntime): RuntimeDb {\n  const db = runtime.db as RuntimeDb | undefined;\n  if (!db || typeof db.execute !== \"function\") {\n    throw new Error(\n      `${GOALS_MIGRATION_LOG_PREFIX} runtime.db is unavailable — @elizaos/plugin-sql must be loaded before @elizaos/plugin-goals.`,\n    );\n  }\n  return db;\n}\n\nfunction extractRows(result: unknown): Array<Record<string, unknown>> {\n  if (Array.isArray(result)) {\n    return result.filter(\n      (row): row is Record<string, unknown> =>\n        typeof row === \"object\" && row !== null && !Array.isArray(row),\n    );\n  }\n  if (result && typeof result === \"object\" && \"rows\" in result) {\n    const rows = (result as { rows: unknown }).rows;\n    if (Array.isArray(rows)) {\n      return rows.filter(\n        (row): row is Record<string, unknown> =>\n          typeof row === \"object\" && row !== null && !Array.isArray(row),\n      );\n    }\n  }\n  return [];\n}\n\n/**\n * Service whose `start()` performs the one-time, guarded, non-destructive copy\n * of the owner's goal rows from `app_lifeops` into `app_goals`.\n */\nexport class GoalsMigrationService extends Service {\n  static override readonly serviceType = GOALS_MIGRATION_SERVICE_TYPE;\n\n  override capabilityDescription =\n    \"Non-destructive one-time copy of goal rows from app_lifeops into app_goals during the plugin-goals carve-out.\";\n\n  static async start(runtime: IAgentRuntime): Promise<GoalsMigrationService> {\n    const service = new GoalsMigrationService(runtime);\n    await service.run();\n    return service;\n  }\n\n  private async run(): Promise<void> {\n    const db = getRuntimeDb(this.runtime);\n    const { sql } = await import(\"drizzle-orm\");\n    const exec: SqlExecutor = async (statement) =>\n      extractRows(await db.execute(sql.raw(statement)));\n\n    const results = await migrateGoalTables(exec);\n    const copied = results.filter((r) => r.outcome === \"copied\");\n    if (copied.length > 0) {\n      logger.info(\n        { tables: copied.map((r) => r.table) },\n        `${GOALS_MIGRATION_LOG_PREFIX} copied ${copied.length} goal table(s) from ${SOURCE_SCHEMA} to ${TARGET_SCHEMA}`,\n      );\n    } else {\n      logger.debug(\n        { results },\n        `${GOALS_MIGRATION_LOG_PREFIX} no goal tables required copying (already migrated or fresh install)`,\n      );\n    }\n  }\n\n  override async stop(): Promise<void> {}\n}\n"],"mappings":"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","names":[]}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Public types for @elizaos/plugin-goals.
+ *
+ * These mirror (and will eventually replace) the action contracts currently
+ * declared inside `plugins/plugin-personal-assistant/src/actions/owner-surfaces.ts`.
+ * During the decomposition phase the action handlers below remain stubs and
+ * delegate (via TODO comments) to the LifeOps implementations.
+ */
+export declare const GOALS_CONTEXTS: readonly ["goals", "self_care", "owner"];
+export type GoalsContext = (typeof GOALS_CONTEXTS)[number];
+export declare const GOAL_ACTIONS: readonly ["create", "update", "delete", "review"];
+export type GoalActionName = (typeof GOAL_ACTIONS)[number];
+export declare const ROUTINE_ACTIONS: readonly ["create", "update", "delete", "complete", "skip", "snooze", "review"];
+export type RoutineActionName = (typeof ROUTINE_ACTIONS)[number];
+export declare const REMINDER_ACTIONS: readonly ["create", "update", "delete", "complete", "snooze", "list"];
+export type ReminderActionName = (typeof REMINDER_ACTIONS)[number];
+export declare const ALARM_ACTIONS: readonly ["create", "update", "delete", "snooze", "dismiss", "list"];
+export type AlarmActionName = (typeof ALARM_ACTIONS)[number];
+export interface GoalsScope {
+    agentId: string;
+    entityId: string;
+    roomId?: string;
+}
+export declare const GOALS_CHECKIN_SERVICE_TYPE: "goals_checkin";
+export declare const GOALS_LOG_PREFIX: "[plugin-goals]";
+/** Lifecycle status of a goal (mirrors LIFEOPS_GOAL_STATUSES by value). */
+export declare const GOAL_STATUSES: readonly ["active", "paused", "archived", "satisfied"];
+export type GoalStatus = (typeof GOAL_STATUSES)[number];
+/** Progress signal a goal review assigns (mirrors LIFEOPS_REVIEW_STATES). */
+export declare const GOAL_REVIEW_STATES: readonly ["idle", "needs_attention", "on_track", "at_risk"];
+export type GoalReviewState = (typeof GOAL_REVIEW_STATES)[number];
+/** A goal flattened for display. Mapped from a `LifeOpsGoalRecord` at fetch. */
+export interface GoalItem {
+    id: string;
+    title: string;
+    /** Empty string when the goal carries no description. */
+    description: string;
+    status: GoalStatus;
+    reviewState: GoalReviewState;
+    /** Cadence kind (e.g. "daily" / "weekly"), or null when the goal is ad-hoc. */
+    cadenceKind: string | null;
+    /** Human-readable target / next-due from successCriteria, or null. */
+    target: string | null;
+    /** Count of linked occurrences / tasks / entities backing the goal. */
+    linkedCount: number;
+    /** ISO timestamp of the last update to the goal. */
+    updatedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,cAAc,0CAA2C,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,YAAY,mDAAoD,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,eAAe,iFAQlB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,uEAOnB,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,aAAa,sEAOhB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,EAAG,eAAwB,CAAC;AACnE,eAAO,MAAM,gBAAgB,EAAG,gBAAyB,CAAC;AAoB1D,2EAA2E;AAC3E,eAAO,MAAM,aAAa,wDAKhB,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,kBAAkB,6DAKrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;IAC7B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1,53 @@
+const GOALS_CONTEXTS = ["goals", "self_care", "owner"];
+const GOAL_ACTIONS = ["create", "update", "delete", "review"];
+const ROUTINE_ACTIONS = [
+  "create",
+  "update",
+  "delete",
+  "complete",
+  "skip",
+  "snooze",
+  "review"
+];
+const REMINDER_ACTIONS = [
+  "create",
+  "update",
+  "delete",
+  "complete",
+  "snooze",
+  "list"
+];
+const ALARM_ACTIONS = [
+  "create",
+  "update",
+  "delete",
+  "snooze",
+  "dismiss",
+  "list"
+];
+const GOALS_CHECKIN_SERVICE_TYPE = "goals_checkin";
+const GOALS_LOG_PREFIX = "[plugin-goals]";
+const GOAL_STATUSES = [
+  "active",
+  "paused",
+  "archived",
+  "satisfied"
+];
+const GOAL_REVIEW_STATES = [
+  "idle",
+  "needs_attention",
+  "on_track",
+  "at_risk"
+];
+export {
+  ALARM_ACTIONS,
+  GOALS_CHECKIN_SERVICE_TYPE,
+  GOALS_CONTEXTS,
+  GOALS_LOG_PREFIX,
+  GOAL_ACTIONS,
+  GOAL_REVIEW_STATES,
+  GOAL_STATUSES,
+  REMINDER_ACTIONS,
+  ROUTINE_ACTIONS
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Public types for @elizaos/plugin-goals.\n *\n * These mirror (and will eventually replace) the action contracts currently\n * declared inside `plugins/plugin-personal-assistant/src/actions/owner-surfaces.ts`.\n * During the decomposition phase the action handlers below remain stubs and\n * delegate (via TODO comments) to the LifeOps implementations.\n */\n\nexport const GOALS_CONTEXTS = [\"goals\", \"self_care\", \"owner\"] as const;\nexport type GoalsContext = (typeof GOALS_CONTEXTS)[number];\n\nexport const GOAL_ACTIONS = [\"create\", \"update\", \"delete\", \"review\"] as const;\nexport type GoalActionName = (typeof GOAL_ACTIONS)[number];\n\nexport const ROUTINE_ACTIONS = [\n  \"create\",\n  \"update\",\n  \"delete\",\n  \"complete\",\n  \"skip\",\n  \"snooze\",\n  \"review\",\n] as const;\nexport type RoutineActionName = (typeof ROUTINE_ACTIONS)[number];\n\nexport const REMINDER_ACTIONS = [\n  \"create\",\n  \"update\",\n  \"delete\",\n  \"complete\",\n  \"snooze\",\n  \"list\",\n] as const;\nexport type ReminderActionName = (typeof REMINDER_ACTIONS)[number];\n\nexport const ALARM_ACTIONS = [\n  \"create\",\n  \"update\",\n  \"delete\",\n  \"snooze\",\n  \"dismiss\",\n  \"list\",\n] as const;\nexport type AlarmActionName = (typeof ALARM_ACTIONS)[number];\n\nexport interface GoalsScope {\n  agentId: string;\n  entityId: string;\n  roomId?: string;\n}\n\nexport const GOALS_CHECKIN_SERVICE_TYPE = \"goals_checkin\" as const;\nexport const GOALS_LOG_PREFIX = \"[plugin-goals]\" as const;\n\n// ---------------------------------------------------------------------------\n// View display DTOs.\n//\n// `GoalsView` reads `GET {base}/api/lifeops/goals`, which returns\n// `{ goals: LifeOpsGoalRecord[] }` where each record is\n// `{ goal: LifeOpsGoalDefinition; links: LifeOpsGoalLink[] }`\n// (see LifeOpsGoalDefinition / LifeOpsGoalLink in\n// packages/shared/src/contracts/personal-assistant.ts, served by the\n// `/api/lifeops/goals` branch of\n// plugins/plugin-personal-assistant/src/routes/lifeops-routes.ts).\n//\n// These display DTOs are the flat shape the view renders after mapping each\n// wire record at the fetch boundary. The wire DTOs themselves are declared\n// locally inside GoalsView.tsx; this plugin MUST NOT import the PA contract\n// types. The status / review-state literals below mirror the real enums\n// (LIFEOPS_GOAL_STATUSES / LIFEOPS_REVIEW_STATES) by value.\n// ---------------------------------------------------------------------------\n\n/** Lifecycle status of a goal (mirrors LIFEOPS_GOAL_STATUSES by value). */\nexport const GOAL_STATUSES = [\n  \"active\",\n  \"paused\",\n  \"archived\",\n  \"satisfied\",\n] as const;\nexport type GoalStatus = (typeof GOAL_STATUSES)[number];\n\n/** Progress signal a goal review assigns (mirrors LIFEOPS_REVIEW_STATES). */\nexport const GOAL_REVIEW_STATES = [\n  \"idle\",\n  \"needs_attention\",\n  \"on_track\",\n  \"at_risk\",\n] as const;\nexport type GoalReviewState = (typeof GOAL_REVIEW_STATES)[number];\n\n/** A goal flattened for display. Mapped from a `LifeOpsGoalRecord` at fetch. */\nexport interface GoalItem {\n  id: string;\n  title: string;\n  /** Empty string when the goal carries no description. */\n  description: string;\n  status: GoalStatus;\n  reviewState: GoalReviewState;\n  /** Cadence kind (e.g. \"daily\" / \"weekly\"), or null when the goal is ad-hoc. */\n  cadenceKind: string | null;\n  /** Human-readable target / next-due from successCriteria, or null. */\n  target: string | null;\n  /** Count of linked occurrences / tasks / entities backing the goal. */\n  linkedCount: number;\n  /** ISO timestamp of the last update to the goal. */\n  updatedAt: string;\n}\n"],"mappings":"AASO,MAAM,iBAAiB,CAAC,SAAS,aAAa,OAAO;AAGrD,MAAM,eAAe,CAAC,UAAU,UAAU,UAAU,QAAQ;AAG5D,MAAM,kBAAkB;AAAA,EAC7B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,MAAM,6BAA6B;AACnC,MAAM,mBAAmB;AAqBzB,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,MAAM,qBAAqB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/views/bundle.js

@@ -0,0 +1,304 @@
+import { client as e } from "@elizaos/ui";
+import { Button as t, Card as n, HStack as r, List as i, SpatialSurface as a, Text as o, VStack as s } from "@elizaos/ui/spatial";
+import { useCallback as c, useEffect as l, useMemo as u, useRef as d, useState as f } from "react";
+import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
+//#region src/types.ts
+var g = [
+	"active",
+	"paused",
+	"archived",
+	"satisfied"
+], _ = {
+	active: "Active",
+	paused: "Paused",
+	archived: "Archived",
+	satisfied: "Achieved"
+}, v = {
+	idle: "not reviewed",
+	on_track: "on track",
+	at_risk: "at risk",
+	needs_attention: "needs attention"
+}, y = {
+	idle: "○",
+	on_track: "●",
+	at_risk: "x",
+	needs_attention: "x"
+}, b = {
+	idle: "muted",
+	on_track: "success",
+	at_risk: "danger",
+	needs_attention: "danger"
+};
+function x(e) {
+	let t = new Date(e);
+	return Number.isNaN(t.getTime()) ? e : t.toLocaleDateString(void 0, {
+		month: "short",
+		day: "numeric",
+		year: "numeric"
+	});
+}
+function S(e) {
+	let t = e.filter((e) => e.reviewState === "at_risk" || e.reviewState === "needs_attention").length;
+	return t === 0 ? null : t === 1 ? "1 goal needs a review." : `${t} goals need a review.`;
+}
+function C({ snapshot: e, onAction: t }) {
+	let r = (e) => () => t?.(e), i = new Set(e.activeStatuses);
+	return /* @__PURE__ */ m(n, {
+		gap: 1,
+		padding: 1,
+		children: e.status === "loading" ? /* @__PURE__ */ m(o, {
+			tone: "muted",
+			style: "caption",
+			children: "Loading goals"
+		}) : e.status === "error" ? /* @__PURE__ */ m(w, {
+			error: e.error,
+			dispatch: r
+		}) : /* @__PURE__ */ m(T, {
+			snapshot: e,
+			active: i,
+			dispatch: r
+		})
+	});
+}
+function w({ error: e, dispatch: n }) {
+	return /* @__PURE__ */ h(p, { children: [
+		/* @__PURE__ */ m(o, {
+			bold: !0,
+			children: "Could not load goals"
+		}),
+		e ? /* @__PURE__ */ m(o, {
+			tone: "muted",
+			style: "caption",
+			children: e
+		}) : null,
+		/* @__PURE__ */ m(r, {
+			gap: 1,
+			children: /* @__PURE__ */ m(t, {
+				agent: "retry",
+				onPress: n("retry"),
+				children: "Retry"
+			})
+		})
+	] });
+}
+function T({ snapshot: e, active: n, dispatch: i }) {
+	let a = S(e.goals);
+	if (e.goals.length === 0) return /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m(o, {
+		bold: !0,
+		children: "None"
+	}), /* @__PURE__ */ m(r, {
+		gap: 1,
+		children: /* @__PURE__ */ m(t, {
+			agent: "new",
+			onPress: i("new"),
+			children: "Set a goal"
+		})
+	})] });
+	let s = g.map((t) => ({
+		status: t,
+		goals: e.goals.filter((e) => e.status === t)
+	})).filter((e) => e.goals.length === 0 ? !1 : n.size === 0 ? !0 : n.has(e.status));
+	return /* @__PURE__ */ h(p, { children: [
+		a ? /* @__PURE__ */ m(o, {
+			tone: "muted",
+			style: "caption",
+			children: a
+		}) : null,
+		/* @__PURE__ */ m(r, {
+			gap: 1,
+			wrap: !0,
+			children: g.map((e) => /* @__PURE__ */ m(t, {
+				variant: n.has(e) ? "solid" : "outline",
+				tone: n.has(e) ? "primary" : "default",
+				agent: `filter:${e}`,
+				onPress: i(`filter:${e}`),
+				children: _[e]
+			}, e))
+		}),
+		s.length === 0 ? /* @__PURE__ */ m(o, {
+			tone: "muted",
+			align: "center",
+			style: "caption",
+			children: "None"
+		}) : s.map((e) => /* @__PURE__ */ m(E, { group: e }, e.status))
+	] });
+}
+function E({ group: e }) {
+	return /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ h(o, {
+		style: "caption",
+		tone: "muted",
+		children: [
+			_[e.status],
+			" (",
+			e.goals.length,
+			")"
+		]
+	}), /* @__PURE__ */ m(i, {
+		gap: 0,
+		children: e.goals.map((e) => /* @__PURE__ */ m(D, { goal: e }, e.id))
+	})] });
+}
+function D({ goal: e }) {
+	let t = [];
+	return e.cadenceKind && t.push(e.cadenceKind), e.target && t.push(e.target), e.linkedCount > 0 && t.push(`${e.linkedCount} linked`), /* @__PURE__ */ h(r, {
+		gap: 1,
+		align: "center",
+		children: [
+			/* @__PURE__ */ m(o, {
+				tone: b[e.reviewState],
+				wrap: !1,
+				children: y[e.reviewState]
+			}),
+			/* @__PURE__ */ h(s, {
+				gap: 0,
+				grow: 1,
+				children: [/* @__PURE__ */ m(o, {
+					bold: !0,
+					wrap: !1,
+					children: e.title
+				}), t.length > 0 ? /* @__PURE__ */ m(o, {
+					style: "caption",
+					tone: "muted",
+					wrap: !1,
+					children: t.join(" · ")
+				}) : null]
+			}),
+			/* @__PURE__ */ h(s, {
+				gap: 0,
+				children: [/* @__PURE__ */ m(o, {
+					style: "caption",
+					tone: b[e.reviewState],
+					wrap: !1,
+					align: "end",
+					children: v[e.reviewState]
+				}), /* @__PURE__ */ m(o, {
+					style: "caption",
+					tone: "muted",
+					wrap: !1,
+					align: "end",
+					children: x(e.updatedAt)
+				})]
+			})
+		]
+	});
+}
+//#endregion
+//#region src/components/goals/GoalsView.tsx
+async function O() {
+	let t = await fetch(`${e.getBaseUrl()}/api/lifeops/goals`);
+	if (!t.ok) throw Error(`Goals request failed (${t.status})`);
+	return await t.json();
+}
+var k = { fetchGoals: O }, A = new Set(g), j = new Set([
+	"idle",
+	"needs_attention",
+	"on_track",
+	"at_risk"
+]);
+function M(e) {
+	return A.has(e) ? e : "active";
+}
+function N(e) {
+	return j.has(e) ? e : "idle";
+}
+function P(e) {
+	return e && typeof e.kind == "string" && e.kind.length > 0 ? e.kind : null;
+}
+function F(e) {
+	let t = e.targetText ?? e.target ?? e.summary ?? e.deadline ?? e.dueAt;
+	return typeof t == "string" && t.length > 0 ? t : typeof t == "number" ? String(t) : null;
+}
+function I(e) {
+	let { goal: t, links: n } = e;
+	return {
+		id: t.id,
+		title: t.title,
+		description: t.description ?? "",
+		status: M(t.status),
+		reviewState: N(t.reviewState),
+		cadenceKind: P(t.cadence),
+		target: F(t.successCriteria ?? {}),
+		linkedCount: n.length,
+		updatedAt: t.updatedAt
+	};
+}
+function L() {
+	e.sendChatMessage?.("Help me set a goal to head toward this quarter.");
+}
+function R(e = {}) {
+	let t = e.fetchers ?? k, [n, r] = f({ kind: "loading" }), [i, o] = f(() => /* @__PURE__ */ new Set()), s = d(t);
+	s.current = t;
+	let p = c(() => {
+		let e = !1;
+		return r({ kind: "loading" }), s.current.fetchGoals().then((t) => {
+			e || r({
+				kind: "ready",
+				goals: t.goals.map(I)
+			});
+		}).catch((t) => {
+			e || r({
+				kind: "error",
+				message: t instanceof Error ? t.message : "Could not load goals."
+			});
+		}), () => {
+			e = !0;
+		};
+	}, []);
+	l(() => {
+		let e = p(), t = !0, n = setInterval(() => {
+			s.current.fetchGoals().then((e) => {
+				t && r({
+					kind: "ready",
+					goals: e.goals.map(I)
+				});
+			}).catch(() => {});
+		}, 2e4);
+		return () => {
+			t = !1, clearInterval(n), e();
+		};
+	}, [p]);
+	let h = c((e) => {
+		o((t) => {
+			let n = new Set(t);
+			return n.has(e) ? n.delete(e) : n.add(e), n;
+		});
+	}, []), g = c((e) => {
+		if (e.startsWith("filter:")) {
+			let t = e.slice(7);
+			A.has(t) && h(t);
+			return;
+		}
+		switch (e) {
+			case "retry":
+				p();
+				return;
+			case "new":
+				L();
+				return;
+		}
+	}, [p, h]);
+	return /* @__PURE__ */ m(a, { children: /* @__PURE__ */ m(C, {
+		snapshot: u(() => {
+			let e = Array.from(i);
+			return n.kind === "loading" ? {
+				status: "loading",
+				goals: [],
+				activeStatuses: e
+			} : n.kind === "error" ? {
+				status: "error",
+				goals: [],
+				activeStatuses: e,
+				error: n.message
+			} : {
+				status: "ready",
+				goals: n.goals,
+				activeStatuses: e
+			};
+		}, [n, i]),
+		onAction: g
+	}) });
+}
+//#endregion
+export { R as GoalsView };
+
+//# sourceMappingURL=bundle.js.map