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

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,qDAAwB,CAAC;AAEjD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B/B,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAezB,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGhB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,mBAAmB,CAAC,YAAY,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,YAAY,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,61 @@
+import { index, pgSchema, text, unique } from "drizzle-orm/pg-core";
+const goalsSchema = pgSchema("app_goals");
+const lifeGoalDefinitions = goalsSchema.table(
+  "life_goal_definitions",
+  {
+    id: text("id").primaryKey(),
+    agentId: text("agent_id").notNull(),
+    domain: text("domain").notNull().default("user_lifeops"),
+    subjectType: text("subject_type").notNull().default("owner"),
+    subjectId: text("subject_id").notNull(),
+    visibilityScope: text("visibility_scope").notNull().default("owner_only"),
+    contextPolicy: text("context_policy").notNull().default("explicit_only"),
+    title: text("title").notNull(),
+    description: text("description").notNull().default(""),
+    cadenceJson: text("cadence_json"),
+    supportStrategyJson: text("support_strategy_json").notNull().default("{}"),
+    successCriteriaJson: text("success_criteria_json").notNull().default("{}"),
+    status: text("status").notNull().default("active"),
+    reviewState: text("review_state").notNull().default("pending"),
+    metadataJson: text("metadata_json").notNull().default("{}"),
+    createdAt: text("created_at").notNull(),
+    updatedAt: text("updated_at").notNull()
+  },
+  (t) => [
+    index("idx_life_goal_definitions_agent_status").on(t.agentId, t.status),
+    index("idx_life_goal_definitions_subject").on(
+      t.agentId,
+      t.domain,
+      t.subjectType,
+      t.subjectId,
+      t.status
+    )
+  ]
+);
+const lifeGoalLinks = goalsSchema.table(
+  "life_goal_links",
+  {
+    id: text("id").primaryKey(),
+    agentId: text("agent_id").notNull(),
+    goalId: text("goal_id").notNull(),
+    linkedType: text("linked_type").notNull(),
+    linkedId: text("linked_id").notNull(),
+    createdAt: text("created_at").notNull()
+  },
+  (t) => [
+    unique().on(t.agentId, t.goalId, t.linkedType, t.linkedId),
+    index("idx_life_goal_links_goal").on(t.goalId),
+    index("idx_life_goal_links_linked").on(t.linkedType, t.linkedId)
+  ]
+);
+const goalsDbSchema = {
+  lifeGoalDefinitions,
+  lifeGoalLinks
+};
+export {
+  goalsDbSchema,
+  goalsSchema,
+  lifeGoalDefinitions,
+  lifeGoalLinks
+};
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/schema.ts"],"sourcesContent":["import { index, pgSchema, text, unique } from \"drizzle-orm/pg-core\";\n\n/**\n * Drizzle schema for plugin-goals.\n *\n * The goal tables (`life_goal_definitions`, `life_goal_links`) were carved out\n * of `@elizaos/plugin-personal-assistant`'s `app_lifeops` schema into\n * `app_goals`, owned by this plugin. Table + column names (and column order) are\n * preserved verbatim so the non-destructive `GoalsMigrationService` can copy\n * existing `app_lifeops` rows across on first boot. The runtime registers this\n * schema through `@elizaos/plugin-sql`.\n */\nexport const goalsSchema = pgSchema(\"app_goals\");\n\nexport const lifeGoalDefinitions = goalsSchema.table(\n  \"life_goal_definitions\",\n  {\n    id: text(\"id\").primaryKey(),\n    agentId: text(\"agent_id\").notNull(),\n    domain: text(\"domain\").notNull().default(\"user_lifeops\"),\n    subjectType: text(\"subject_type\").notNull().default(\"owner\"),\n    subjectId: text(\"subject_id\").notNull(),\n    visibilityScope: text(\"visibility_scope\").notNull().default(\"owner_only\"),\n    contextPolicy: text(\"context_policy\").notNull().default(\"explicit_only\"),\n    title: text(\"title\").notNull(),\n    description: text(\"description\").notNull().default(\"\"),\n    cadenceJson: text(\"cadence_json\"),\n    supportStrategyJson: text(\"support_strategy_json\").notNull().default(\"{}\"),\n    successCriteriaJson: text(\"success_criteria_json\").notNull().default(\"{}\"),\n    status: text(\"status\").notNull().default(\"active\"),\n    reviewState: text(\"review_state\").notNull().default(\"pending\"),\n    metadataJson: text(\"metadata_json\").notNull().default(\"{}\"),\n    createdAt: text(\"created_at\").notNull(),\n    updatedAt: text(\"updated_at\").notNull(),\n  },\n  (t) => [\n    index(\"idx_life_goal_definitions_agent_status\").on(t.agentId, t.status),\n    index(\"idx_life_goal_definitions_subject\").on(\n      t.agentId,\n      t.domain,\n      t.subjectType,\n      t.subjectId,\n      t.status,\n    ),\n  ],\n);\n\nexport const lifeGoalLinks = goalsSchema.table(\n  \"life_goal_links\",\n  {\n    id: text(\"id\").primaryKey(),\n    agentId: text(\"agent_id\").notNull(),\n    goalId: text(\"goal_id\").notNull(),\n    linkedType: text(\"linked_type\").notNull(),\n    linkedId: text(\"linked_id\").notNull(),\n    createdAt: text(\"created_at\").notNull(),\n  },\n  (t) => [\n    unique().on(t.agentId, t.goalId, t.linkedType, t.linkedId),\n    index(\"idx_life_goal_links_goal\").on(t.goalId),\n    index(\"idx_life_goal_links_linked\").on(t.linkedType, t.linkedId),\n  ],\n);\n\nexport const goalsDbSchema = {\n  lifeGoalDefinitions,\n  lifeGoalLinks,\n} as const;\n\nexport type GoalDefinitionRow = typeof lifeGoalDefinitions.$inferSelect;\nexport type GoalLinkRow = typeof lifeGoalLinks.$inferSelect;\n"],"mappings":"AAAA,SAAS,OAAO,UAAU,MAAM,cAAc;AAYvC,MAAM,cAAc,SAAS,WAAW;AAExC,MAAM,sBAAsB,YAAY;AAAA,EAC7C;AAAA,EACA;AAAA,IACE,IAAI,KAAK,IAAI,EAAE,WAAW;AAAA,IAC1B,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA,IAClC,QAAQ,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,cAAc;AAAA,IACvD,aAAa,KAAK,cAAc,EAAE,QAAQ,EAAE,QAAQ,OAAO;AAAA,IAC3D,WAAW,KAAK,YAAY,EAAE,QAAQ;AAAA,IACtC,iBAAiB,KAAK,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,YAAY;AAAA,IACxE,eAAe,KAAK,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,eAAe;AAAA,IACvE,OAAO,KAAK,OAAO,EAAE,QAAQ;AAAA,IAC7B,aAAa,KAAK,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE;AAAA,IACrD,aAAa,KAAK,cAAc;AAAA,IAChC,qBAAqB,KAAK,uBAAuB,EAAE,QAAQ,EAAE,QAAQ,IAAI;AAAA,IACzE,qBAAqB,KAAK,uBAAuB,EAAE,QAAQ,EAAE,QAAQ,IAAI;AAAA,IACzE,QAAQ,KAAK,QAAQ,EAAE,QAAQ,EAAE,QAAQ,QAAQ;AAAA,IACjD,aAAa,KAAK,cAAc,EAAE,QAAQ,EAAE,QAAQ,SAAS;AAAA,IAC7D,cAAc,KAAK,eAAe,EAAE,QAAQ,EAAE,QAAQ,IAAI;AAAA,IAC1D,WAAW,KAAK,YAAY,EAAE,QAAQ;AAAA,IACtC,WAAW,KAAK,YAAY,EAAE,QAAQ;AAAA,EACxC;AAAA,EACA,CAAC,MAAM;AAAA,IACL,MAAM,wCAAwC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM;AAAA,IACtE,MAAM,mCAAmC,EAAE;AAAA,MACzC,EAAE;AAAA,MACF,EAAE;AAAA,MACF,EAAE;AAAA,MACF,EAAE;AAAA,MACF,EAAE;AAAA,IACJ;AAAA,EACF;AACF;AAEO,MAAM,gBAAgB,YAAY;AAAA,EACvC;AAAA,EACA;AAAA,IACE,IAAI,KAAK,IAAI,EAAE,WAAW;AAAA,IAC1B,SAAS,KAAK,UAAU,EAAE,QAAQ;AAAA,IAClC,QAAQ,KAAK,SAAS,EAAE,QAAQ;AAAA,IAChC,YAAY,KAAK,aAAa,EAAE,QAAQ;AAAA,IACxC,UAAU,KAAK,WAAW,EAAE,QAAQ;AAAA,IACpC,WAAW,KAAK,YAAY,EAAE,QAAQ;AAAA,EACxC;AAAA,EACA,CAAC,MAAM;AAAA,IACL,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ;AAAA,IACzD,MAAM,0BAA0B,EAAE,GAAG,EAAE,MAAM;AAAA,IAC7C,MAAM,4BAA4B,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ;AAAA,EACjE;AACF;AAEO,MAAM,gBAAgB;AAAA,EAC3B;AAAA,EACA;AACF;","names":[]}

package/dist/db/sql.d.ts

@@ -0,0 +1,32 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Self-contained raw-SQL helpers for the goals back-end. Copied verbatim from
+ * the PA LifeOps sql helpers (renamed error prefixes) so this plugin carries no
+ * dependency on `@elizaos/plugin-personal-assistant`. Keep in sync only when a
+ * correctness fix applies to both; do not add goals-specific logic here.
+ */
+export type RawSqlQuery = {
+    queryChunks: Array<{
+        value?: unknown;
+    }>;
+};
+export type RuntimeDb = {
+    execute: (query: RawSqlQuery) => Promise<unknown>;
+};
+export declare function asObject(value: unknown): Record<string, unknown> | null;
+export declare function toText(value: unknown, fallback?: string): string;
+export declare function toNumber(value: unknown, fallback?: number): number;
+export declare function toBoolean(value: unknown, fallback?: boolean): boolean;
+export declare function parseJsonValue<T>(value: unknown, fallback: T): T;
+export declare function parseJsonRecord(value: unknown): Record<string, unknown>;
+export declare function parseJsonArray<T>(value: unknown): T[];
+export declare function extractRows(result: unknown): Array<Record<string, unknown>>;
+export declare function getRuntimeDb(runtime: IAgentRuntime): RuntimeDb;
+export declare function executeRawSql(runtime: IAgentRuntime, sqlText: string): Promise<Array<Record<string, unknown>>>;
+export declare function sqlQuote(value: string): string;
+export declare function sqlText(value: string | null | undefined): string;
+export declare function sqlInteger(value: number | null | undefined): string;
+export declare function sqlNumber(value: number | null | undefined): string;
+export declare function sqlBoolean(value: boolean): string;
+export declare function sqlJson(value: unknown): string;
+//# sourceMappingURL=sql.d.ts.map

package/dist/db/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/db/sql.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD,CAAC;AAIF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGvE;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAI5D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAI,GAAG,MAAM,CAO7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,UAAQ,GAAG,OAAO,CASnE;AAMD,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAchE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMvE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAKrD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAa3E;AAWD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAM9D;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAKzC;AAMD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAInE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAIlE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE9C"}

package/dist/db/sql.js

@@ -0,0 +1,130 @@
+let cachedSqlRaw = null;
+function asObject(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+  return value;
+}
+function toText(value, fallback = "") {
+  if (typeof value === "string") return value;
+  if (value === null || value === void 0) return fallback;
+  return String(value);
+}
+function toNumber(value, fallback = 0) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string") {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return fallback;
+}
+function toBoolean(value, fallback = false) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number") return value !== 0;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized)) return true;
+    if (["0", "false", "no", "off"].includes(normalized)) return false;
+  }
+  return fallback;
+}
+function isMissingJsonValue(value) {
+  return value === null || value === void 0 || value === "";
+}
+function parseJsonValue(value, fallback) {
+  if (isMissingJsonValue(value)) return fallback;
+  if (typeof value !== "string") {
+    if (typeof value === "object") return value;
+    throw new Error(
+      `[GoalsSql] Expected JSON string or object, received ${typeof value}`
+    );
+  }
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`[GoalsSql] Invalid JSON value: ${message}`);
+  }
+}
+function parseJsonRecord(value) {
+  if (isMissingJsonValue(value)) return {};
+  const parsed = parseJsonValue(value, null);
+  const object = asObject(parsed);
+  if (object) return object;
+  throw new Error("[GoalsSql] Expected JSON object");
+}
+function parseJsonArray(value) {
+  if (isMissingJsonValue(value)) return [];
+  const parsed = parseJsonValue(value, null);
+  if (Array.isArray(parsed)) return parsed;
+  throw new Error("[GoalsSql] Expected JSON array");
+}
+function extractRows(result) {
+  if (Array.isArray(result)) {
+    return result.map((row) => asObject(row)).filter((row) => row !== null);
+  }
+  const object = asObject(result);
+  if (!object) return [];
+  const rows = object.rows;
+  if (!Array.isArray(rows)) return [];
+  return rows.map((row) => asObject(row)).filter((row) => row !== null);
+}
+async function getSqlRaw() {
+  if (cachedSqlRaw) return cachedSqlRaw;
+  const drizzle = await import("drizzle-orm");
+  cachedSqlRaw = drizzle.sql.raw;
+  return cachedSqlRaw;
+}
+function getRuntimeDb(runtime) {
+  const db = runtime.adapter.db;
+  if (!db || typeof db.execute !== "function") {
+    throw new Error("runtime database adapter unavailable");
+  }
+  return db;
+}
+async function executeRawSql(runtime, sqlText2) {
+  const raw = await getSqlRaw();
+  const db = getRuntimeDb(runtime);
+  const result = await db.execute(raw(sqlText2));
+  return extractRows(result);
+}
+function sqlQuote(value) {
+  return `'${value.replace(/'/g, "''")}'`;
+}
+function sqlText(value) {
+  if (value === null || value === void 0) return "NULL";
+  return sqlQuote(value);
+}
+function sqlInteger(value) {
+  if (value === null || value === void 0) return "NULL";
+  if (!Number.isFinite(value)) throw new Error("invalid numeric SQL literal");
+  return String(Math.trunc(value));
+}
+function sqlNumber(value) {
+  if (value === null || value === void 0) return "NULL";
+  if (!Number.isFinite(value)) throw new Error("invalid numeric SQL literal");
+  return String(value);
+}
+function sqlBoolean(value) {
+  return value ? "TRUE" : "FALSE";
+}
+function sqlJson(value) {
+  return sqlQuote(JSON.stringify(value ?? null));
+}
+export {
+  asObject,
+  executeRawSql,
+  extractRows,
+  getRuntimeDb,
+  parseJsonArray,
+  parseJsonRecord,
+  parseJsonValue,
+  sqlBoolean,
+  sqlInteger,
+  sqlJson,
+  sqlNumber,
+  sqlQuote,
+  sqlText,
+  toBoolean,
+  toNumber,
+  toText
+};
+//# sourceMappingURL=sql.js.map

package/dist/db/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/db/sql.ts"],"sourcesContent":["import type { IAgentRuntime } from \"@elizaos/core\";\n\n/**\n * Self-contained raw-SQL helpers for the goals back-end. Copied verbatim from\n * the PA LifeOps sql helpers (renamed error prefixes) so this plugin carries no\n * dependency on `@elizaos/plugin-personal-assistant`. Keep in sync only when a\n * correctness fix applies to both; do not add goals-specific logic here.\n */\n\nexport type RawSqlQuery = {\n  queryChunks: Array<{ value?: unknown }>;\n};\n\nexport type RuntimeDb = {\n  execute: (query: RawSqlQuery) => Promise<unknown>;\n};\n\nlet cachedSqlRaw: ((query: string) => RawSqlQuery) | null = null;\n\nexport function asObject(value: unknown): Record<string, unknown> | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) return null;\n  return value as Record<string, unknown>;\n}\n\nexport function toText(value: unknown, fallback = \"\"): string {\n  if (typeof value === \"string\") return value;\n  if (value === null || value === undefined) return fallback;\n  return String(value);\n}\n\nexport function toNumber(value: unknown, fallback = 0): number {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\") {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return fallback;\n}\n\nexport function toBoolean(value: unknown, fallback = false): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"number\") return value !== 0;\n  if (typeof value === \"string\") {\n    const normalized = value.trim().toLowerCase();\n    if ([\"1\", \"true\", \"yes\", \"on\"].includes(normalized)) return true;\n    if ([\"0\", \"false\", \"no\", \"off\"].includes(normalized)) return false;\n  }\n  return fallback;\n}\n\nfunction isMissingJsonValue(value: unknown): boolean {\n  return value === null || value === undefined || value === \"\";\n}\n\nexport function parseJsonValue<T>(value: unknown, fallback: T): T {\n  if (isMissingJsonValue(value)) return fallback;\n  if (typeof value !== \"string\") {\n    if (typeof value === \"object\") return value as T;\n    throw new Error(\n      `[GoalsSql] Expected JSON string or object, received ${typeof value}`,\n    );\n  }\n  try {\n    return JSON.parse(value) as T;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    throw new Error(`[GoalsSql] Invalid JSON value: ${message}`);\n  }\n}\n\nexport function parseJsonRecord(value: unknown): Record<string, unknown> {\n  if (isMissingJsonValue(value)) return {};\n  const parsed = parseJsonValue<Record<string, unknown> | null>(value, null);\n  const object = asObject(parsed);\n  if (object) return object;\n  throw new Error(\"[GoalsSql] Expected JSON object\");\n}\n\nexport function parseJsonArray<T>(value: unknown): T[] {\n  if (isMissingJsonValue(value)) return [];\n  const parsed = parseJsonValue<T[] | null>(value, null);\n  if (Array.isArray(parsed)) return parsed;\n  throw new Error(\"[GoalsSql] Expected JSON array\");\n}\n\nexport function extractRows(result: unknown): Array<Record<string, unknown>> {\n  if (Array.isArray(result)) {\n    return result\n      .map((row) => asObject(row))\n      .filter((row): row is Record<string, unknown> => row !== null);\n  }\n  const object = asObject(result);\n  if (!object) return [];\n  const rows = object.rows;\n  if (!Array.isArray(rows)) return [];\n  return rows\n    .map((row) => asObject(row))\n    .filter((row): row is Record<string, unknown> => row !== null);\n}\n\nasync function getSqlRaw(): Promise<(query: string) => RawSqlQuery> {\n  if (cachedSqlRaw) return cachedSqlRaw;\n  const drizzle = (await import(\"drizzle-orm\")) as {\n    sql: { raw: (query: string) => RawSqlQuery };\n  };\n  cachedSqlRaw = drizzle.sql.raw;\n  return cachedSqlRaw;\n}\n\nexport function getRuntimeDb(runtime: IAgentRuntime): RuntimeDb {\n  const db = runtime.adapter.db as RuntimeDb | undefined;\n  if (!db || typeof db.execute !== \"function\") {\n    throw new Error(\"runtime database adapter unavailable\");\n  }\n  return db;\n}\n\nexport async function executeRawSql(\n  runtime: IAgentRuntime,\n  sqlText: string,\n): Promise<Array<Record<string, unknown>>> {\n  const raw = await getSqlRaw();\n  const db = getRuntimeDb(runtime);\n  const result = await db.execute(raw(sqlText));\n  return extractRows(result);\n}\n\n// ---------------------------------------------------------------------------\n// SQL value encoders\n// ---------------------------------------------------------------------------\n\nexport function sqlQuote(value: string): string {\n  return `'${value.replace(/'/g, \"''\")}'`;\n}\n\nexport function sqlText(value: string | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  return sqlQuote(value);\n}\n\nexport function sqlInteger(value: number | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  if (!Number.isFinite(value)) throw new Error(\"invalid numeric SQL literal\");\n  return String(Math.trunc(value));\n}\n\nexport function sqlNumber(value: number | null | undefined): string {\n  if (value === null || value === undefined) return \"NULL\";\n  if (!Number.isFinite(value)) throw new Error(\"invalid numeric SQL literal\");\n  return String(value);\n}\n\nexport function sqlBoolean(value: boolean): string {\n  return value ? \"TRUE\" : \"FALSE\";\n}\n\nexport function sqlJson(value: unknown): string {\n  return sqlQuote(JSON.stringify(value ?? null));\n}\n"],"mappings":"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","names":["sqlText"]}

package/dist/goal-grounding.d.ts

@@ -0,0 +1,54 @@
+import type { LifeOpsGoalReviewState } from "@elizaos/shared";
+export declare const GOAL_GROUNDING_STATES: readonly ["grounded", "partial", "ungrounded"];
+export type GoalGroundingState = (typeof GOAL_GROUNDING_STATES)[number];
+export interface GoalGroundingMetadata {
+    version: 1;
+    groundingState: GoalGroundingState;
+    summary: string | null;
+    targetDomain: string | null;
+    groundedAt: string | null;
+    confidence: number | null;
+    missingCriticalFields: string[];
+    evidenceSignals: string[];
+    reviewCadenceKind: string | null;
+}
+export interface GoalSemanticSuggestionMetadata {
+    kind: string | null;
+    title: string;
+    detail: string;
+}
+export interface GoalSemanticReviewMetadata {
+    reviewedAt: string;
+    reviewState: LifeOpsGoalReviewState;
+    progressScore: number | null;
+    confidence: number | null;
+    explanation: string;
+    evidenceSummary: string | null;
+    missingEvidence: string[];
+    suggestions: GoalSemanticSuggestionMetadata[];
+}
+export declare function buildGoalGroundingMetadata(args: {
+    confidence?: number | null;
+    evidenceSignals?: string[];
+    groundedAt?: string | null;
+    groundingState: GoalGroundingState;
+    missingCriticalFields?: string[];
+    reviewCadenceKind?: string | null;
+    summary?: string | null;
+    targetDomain?: string | null;
+}): GoalGroundingMetadata;
+export declare function mergeGoalGroundingMetadata(metadata: Record<string, unknown>, grounding: GoalGroundingMetadata): Record<string, unknown>;
+export declare function readGoalGroundingMetadata(value: unknown): GoalGroundingMetadata | null;
+export declare function buildGoalSemanticReviewMetadata(args: {
+    confidence?: number | null;
+    evidenceSummary?: string | null;
+    explanation: string;
+    missingEvidence?: string[];
+    progressScore?: number | null;
+    reviewState: LifeOpsGoalReviewState;
+    reviewedAt: string;
+    suggestions?: GoalSemanticSuggestionMetadata[];
+}): GoalSemanticReviewMetadata;
+export declare function mergeGoalSemanticReviewMetadata(metadata: Record<string, unknown>, review: GoalSemanticReviewMetadata): Record<string, unknown>;
+export declare function readGoalSemanticReviewMetadata(value: unknown): GoalSemanticReviewMetadata | null;
+//# sourceMappingURL=goal-grounding.d.ts.map

package/dist/goal-grounding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-grounding.d.ts","sourceRoot":"","sources":["../src/goal-grounding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG9D,eAAO,MAAM,qBAAqB,gDAIxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,cAAc,EAAE,kBAAkB,CAAC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,sBAAsB,CAAC;IACpC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,8BAA8B,EAAE,CAAC;CAC/C;AAkCD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,kBAAkB,CAAC;IACnC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,qBAAqB,CAuBxB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,EAAE,qBAAqB,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,qBAAqB,GAAG,IAAI,CAuB9B;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE;IACpD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,sBAAsB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,8BAA8B,EAAE,CAAC;CAChD,GAAG,0BAA0B,CA6B7B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,0BAA0B,GAAG,IAAI,CA6CnC"}

package/dist/goal-grounding.js

@@ -0,0 +1,148 @@
+import { LIFEOPS_REVIEW_STATES } from "@elizaos/shared";
+const GOAL_GROUNDING_STATES = [
+  "grounded",
+  "partial",
+  "ungrounded"
+];
+function asText(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function asFiniteNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  return null;
+}
+function asStringArray(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+}
+function asRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+}
+function buildGoalGroundingMetadata(args) {
+  return {
+    version: 1,
+    groundingState: args.groundingState,
+    summary: args.summary ?? null,
+    targetDomain: args.targetDomain ?? null,
+    groundedAt: args.groundedAt ?? null,
+    confidence: typeof args.confidence === "number" && Number.isFinite(args.confidence) ? Math.max(0, Math.min(1, args.confidence)) : null,
+    missingCriticalFields: Array.from(
+      new Set((args.missingCriticalFields ?? []).filter(Boolean))
+    ),
+    evidenceSignals: Array.from(
+      new Set((args.evidenceSignals ?? []).filter(Boolean))
+    ),
+    reviewCadenceKind: typeof args.reviewCadenceKind === "string" && args.reviewCadenceKind.trim().length > 0 ? args.reviewCadenceKind.trim() : null
+  };
+}
+function mergeGoalGroundingMetadata(metadata, grounding) {
+  return {
+    ...metadata,
+    goalGrounding: grounding
+  };
+}
+function readGoalGroundingMetadata(value) {
+  const record = asRecord(value);
+  const candidate = asRecord(record?.goalGrounding ?? value);
+  if (!candidate) {
+    return null;
+  }
+  const groundingState = asText(candidate.groundingState);
+  if (!groundingState || !GOAL_GROUNDING_STATES.includes(groundingState)) {
+    return null;
+  }
+  return buildGoalGroundingMetadata({
+    confidence: asFiniteNumber(candidate.confidence),
+    evidenceSignals: asStringArray(candidate.evidenceSignals),
+    groundedAt: asText(candidate.groundedAt),
+    groundingState,
+    missingCriticalFields: asStringArray(candidate.missingCriticalFields),
+    reviewCadenceKind: asText(candidate.reviewCadenceKind),
+    summary: asText(candidate.summary),
+    targetDomain: asText(candidate.targetDomain)
+  });
+}
+function buildGoalSemanticReviewMetadata(args) {
+  return {
+    reviewedAt: args.reviewedAt,
+    reviewState: args.reviewState,
+    progressScore: typeof args.progressScore === "number" && Number.isFinite(args.progressScore) ? Math.max(0, Math.min(1, args.progressScore)) : null,
+    confidence: typeof args.confidence === "number" && Number.isFinite(args.confidence) ? Math.max(0, Math.min(1, args.confidence)) : null,
+    explanation: args.explanation.trim(),
+    evidenceSummary: args.evidenceSummary ?? null,
+    missingEvidence: Array.from(
+      new Set((args.missingEvidence ?? []).filter(Boolean))
+    ),
+    suggestions: (args.suggestions ?? []).map((suggestion) => ({
+      kind: asText(suggestion.kind),
+      title: suggestion.title.trim(),
+      detail: suggestion.detail.trim()
+    })).filter(
+      (suggestion) => suggestion.title.length > 0 && suggestion.detail.length > 0
+    )
+  };
+}
+function mergeGoalSemanticReviewMetadata(metadata, review) {
+  return {
+    ...metadata,
+    goalSemanticReview: review
+  };
+}
+function readGoalSemanticReviewMetadata(value) {
+  const record = asRecord(value);
+  const candidate = asRecord(record?.goalSemanticReview ?? value);
+  if (!candidate) {
+    return null;
+  }
+  const reviewedAt = asText(candidate.reviewedAt);
+  const reviewState = asText(candidate.reviewState);
+  const explanation = asText(candidate.explanation);
+  if (!reviewedAt || !reviewState || !LIFEOPS_REVIEW_STATES.includes(reviewState) || !explanation) {
+    return null;
+  }
+  return buildGoalSemanticReviewMetadata({
+    confidence: asFiniteNumber(candidate.confidence),
+    evidenceSummary: asText(candidate.evidenceSummary),
+    explanation,
+    missingEvidence: asStringArray(candidate.missingEvidence),
+    progressScore: asFiniteNumber(candidate.progressScore),
+    reviewState,
+    reviewedAt,
+    suggestions: Array.isArray(candidate.suggestions) ? candidate.suggestions.map((entry) => {
+      const suggestion = asRecord(entry);
+      const title = asText(suggestion?.title);
+      const detail = asText(suggestion?.detail);
+      if (!title || !detail) {
+        return null;
+      }
+      return {
+        kind: asText(suggestion?.kind),
+        title,
+        detail
+      };
+    }).filter(
+      (entry) => entry !== null
+    ) : []
+  });
+}
+export {
+  GOAL_GROUNDING_STATES,
+  buildGoalGroundingMetadata,
+  buildGoalSemanticReviewMetadata,
+  mergeGoalGroundingMetadata,
+  mergeGoalSemanticReviewMetadata,
+  readGoalGroundingMetadata,
+  readGoalSemanticReviewMetadata
+};
+//# sourceMappingURL=goal-grounding.js.map

package/dist/goal-grounding.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/goal-grounding.ts"],"sourcesContent":["import type { LifeOpsGoalReviewState } from \"@elizaos/shared\";\nimport { LIFEOPS_REVIEW_STATES } from \"@elizaos/shared\";\n\nexport const GOAL_GROUNDING_STATES = [\n  \"grounded\",\n  \"partial\",\n  \"ungrounded\",\n] as const;\n\nexport type GoalGroundingState = (typeof GOAL_GROUNDING_STATES)[number];\n\nexport interface GoalGroundingMetadata {\n  version: 1;\n  groundingState: GoalGroundingState;\n  summary: string | null;\n  targetDomain: string | null;\n  groundedAt: string | null;\n  confidence: number | null;\n  missingCriticalFields: string[];\n  evidenceSignals: string[];\n  reviewCadenceKind: string | null;\n}\n\nexport interface GoalSemanticSuggestionMetadata {\n  kind: string | null;\n  title: string;\n  detail: string;\n}\n\nexport interface GoalSemanticReviewMetadata {\n  reviewedAt: string;\n  reviewState: LifeOpsGoalReviewState;\n  progressScore: number | null;\n  confidence: number | null;\n  explanation: string;\n  evidenceSummary: string | null;\n  missingEvidence: string[];\n  suggestions: GoalSemanticSuggestionMetadata[];\n}\n\nfunction asText(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 asFiniteNumber(value: unknown): number | null {\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return value;\n  }\n  return null;\n}\n\nfunction asStringArray(value: unknown): string[] {\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 asRecord(value: unknown): Record<string, unknown> | null {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    return null;\n  }\n  return value as Record<string, unknown>;\n}\n\nexport function buildGoalGroundingMetadata(args: {\n  confidence?: number | null;\n  evidenceSignals?: string[];\n  groundedAt?: string | null;\n  groundingState: GoalGroundingState;\n  missingCriticalFields?: string[];\n  reviewCadenceKind?: string | null;\n  summary?: string | null;\n  targetDomain?: string | null;\n}): GoalGroundingMetadata {\n  return {\n    version: 1,\n    groundingState: args.groundingState,\n    summary: args.summary ?? null,\n    targetDomain: args.targetDomain ?? null,\n    groundedAt: args.groundedAt ?? null,\n    confidence:\n      typeof args.confidence === \"number\" && Number.isFinite(args.confidence)\n        ? Math.max(0, Math.min(1, args.confidence))\n        : null,\n    missingCriticalFields: Array.from(\n      new Set((args.missingCriticalFields ?? []).filter(Boolean)),\n    ),\n    evidenceSignals: Array.from(\n      new Set((args.evidenceSignals ?? []).filter(Boolean)),\n    ),\n    reviewCadenceKind:\n      typeof args.reviewCadenceKind === \"string\" &&\n      args.reviewCadenceKind.trim().length > 0\n        ? args.reviewCadenceKind.trim()\n        : null,\n  };\n}\n\nexport function mergeGoalGroundingMetadata(\n  metadata: Record<string, unknown>,\n  grounding: GoalGroundingMetadata,\n): Record<string, unknown> {\n  return {\n    ...metadata,\n    goalGrounding: grounding,\n  };\n}\n\nexport function readGoalGroundingMetadata(\n  value: unknown,\n): GoalGroundingMetadata | null {\n  const record = asRecord(value);\n  const candidate = asRecord(record?.goalGrounding ?? value);\n  if (!candidate) {\n    return null;\n  }\n  const groundingState = asText(candidate.groundingState);\n  if (\n    !groundingState ||\n    !GOAL_GROUNDING_STATES.includes(groundingState as GoalGroundingState)\n  ) {\n    return null;\n  }\n  return buildGoalGroundingMetadata({\n    confidence: asFiniteNumber(candidate.confidence),\n    evidenceSignals: asStringArray(candidate.evidenceSignals),\n    groundedAt: asText(candidate.groundedAt),\n    groundingState: groundingState as GoalGroundingState,\n    missingCriticalFields: asStringArray(candidate.missingCriticalFields),\n    reviewCadenceKind: asText(candidate.reviewCadenceKind),\n    summary: asText(candidate.summary),\n    targetDomain: asText(candidate.targetDomain),\n  });\n}\n\nexport function buildGoalSemanticReviewMetadata(args: {\n  confidence?: number | null;\n  evidenceSummary?: string | null;\n  explanation: string;\n  missingEvidence?: string[];\n  progressScore?: number | null;\n  reviewState: LifeOpsGoalReviewState;\n  reviewedAt: string;\n  suggestions?: GoalSemanticSuggestionMetadata[];\n}): GoalSemanticReviewMetadata {\n  return {\n    reviewedAt: args.reviewedAt,\n    reviewState: args.reviewState,\n    progressScore:\n      typeof args.progressScore === \"number\" &&\n      Number.isFinite(args.progressScore)\n        ? Math.max(0, Math.min(1, args.progressScore))\n        : null,\n    confidence:\n      typeof args.confidence === \"number\" && Number.isFinite(args.confidence)\n        ? Math.max(0, Math.min(1, args.confidence))\n        : null,\n    explanation: args.explanation.trim(),\n    evidenceSummary: args.evidenceSummary ?? null,\n    missingEvidence: Array.from(\n      new Set((args.missingEvidence ?? []).filter(Boolean)),\n    ),\n    suggestions: (args.suggestions ?? [])\n      .map((suggestion) => ({\n        kind: asText(suggestion.kind),\n        title: suggestion.title.trim(),\n        detail: suggestion.detail.trim(),\n      }))\n      .filter(\n        (suggestion) =>\n          suggestion.title.length > 0 && suggestion.detail.length > 0,\n      ),\n  };\n}\n\nexport function mergeGoalSemanticReviewMetadata(\n  metadata: Record<string, unknown>,\n  review: GoalSemanticReviewMetadata,\n): Record<string, unknown> {\n  return {\n    ...metadata,\n    goalSemanticReview: review,\n  };\n}\n\nexport function readGoalSemanticReviewMetadata(\n  value: unknown,\n): GoalSemanticReviewMetadata | null {\n  const record = asRecord(value);\n  const candidate = asRecord(record?.goalSemanticReview ?? value);\n  if (!candidate) {\n    return null;\n  }\n  const reviewedAt = asText(candidate.reviewedAt);\n  const reviewState = asText(candidate.reviewState);\n  const explanation = asText(candidate.explanation);\n  if (\n    !reviewedAt ||\n    !reviewState ||\n    !LIFEOPS_REVIEW_STATES.includes(reviewState as LifeOpsGoalReviewState) ||\n    !explanation\n  ) {\n    return null;\n  }\n  return buildGoalSemanticReviewMetadata({\n    confidence: asFiniteNumber(candidate.confidence),\n    evidenceSummary: asText(candidate.evidenceSummary),\n    explanation,\n    missingEvidence: asStringArray(candidate.missingEvidence),\n    progressScore: asFiniteNumber(candidate.progressScore),\n    reviewState: reviewState as LifeOpsGoalReviewState,\n    reviewedAt,\n    suggestions: Array.isArray(candidate.suggestions)\n      ? candidate.suggestions\n          .map((entry) => {\n            const suggestion = asRecord(entry);\n            const title = asText(suggestion?.title);\n            const detail = asText(suggestion?.detail);\n            if (!title || !detail) {\n              return null;\n            }\n            return {\n              kind: asText(suggestion?.kind),\n              title,\n              detail,\n            };\n          })\n          .filter(\n            (entry): entry is GoalSemanticSuggestionMetadata => entry !== null,\n          )\n      : [],\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/goal-normalize.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Self-contained input-normalization helpers for the goals back-end.
+ *
+ * These mirror the small subset of `@elizaos/plugin-personal-assistant`'s
+ * `service-normalize` / `service-helpers-misc` helpers that the goal CRUD code
+ * actually used. They are reproduced here (rather than imported) so
+ * `@elizaos/plugin-goals` carries no dependency on plugin-personal-assistant.
+ * `fail` throws a {@link GoalsServiceError} carrying an HTTP status, which the
+ * action and route layers map to client-facing responses.
+ */
+import type { IAgentRuntime } from "@elizaos/core";
+/** Error carrying an HTTP status for goals back-end failures. */
+export declare class GoalsServiceError extends Error {
+    readonly status: number;
+    readonly code?: string | undefined;
+    constructor(status: number, message: string, code?: string | undefined);
+}
+export declare function goalsErrorMessage(error: unknown): string;
+export declare function fail(status: number, message: string, code?: string): never;
+export declare function requireAgentId(runtime: IAgentRuntime): string;
+export declare function requireNonEmptyString(value: unknown, field: string): string;
+export declare function normalizeOptionalString(value: unknown): string | undefined;
+export declare function normalizeEnumValue<T extends string>(value: unknown, field: string, allowed: readonly T[], fallback?: T): T;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function cloneRecord(value: unknown): Record<string, unknown>;
+export declare function requireRecord(value: unknown, field: string): Record<string, unknown>;
+export declare function normalizeOptionalRecord(value: unknown, field: string): Record<string, unknown> | undefined;
+export declare function normalizeNullableRecord(value: unknown, field: string): Record<string, unknown> | null | undefined;
+export declare function mergeMetadata(current: Record<string, unknown>, updates?: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=goal-normalize.d.ts.map

package/dist/goal-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-normalize.d.ts","sourceRoot":"","sources":["../src/goal-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,iEAAiE;AACjE,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,MAAM,EAAE,MAAM;aAEd,IAAI,CAAC,EAAE,MAAM;gBAFb,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAE1E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAM7D;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI1E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,QAAQ,CAAC,EAAE,CAAC,GACX,CAAC,CAYH;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnE;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAI5C;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezB"}

package/dist/goal-normalize.js

@@ -0,0 +1,99 @@
+class GoalsServiceError extends Error {
+  constructor(status, message, code) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "GoalsServiceError";
+  }
+  status;
+  code;
+}
+function goalsErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function fail(status, message, code) {
+  throw new GoalsServiceError(status, message, code);
+}
+function requireAgentId(runtime) {
+  const agentId = runtime.agentId;
+  if (typeof agentId !== "string" || agentId.trim().length === 0) {
+    fail(500, "agent runtime is missing agentId");
+  }
+  return agentId;
+}
+function requireNonEmptyString(value, field) {
+  if (typeof value !== "string") {
+    fail(400, `${field} must be a string`);
+  }
+  const normalized = value.trim();
+  if (normalized.length === 0) {
+    fail(400, `${field} is required`);
+  }
+  return normalized;
+}
+function normalizeOptionalString(value) {
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function normalizeEnumValue(value, field, allowed, fallback) {
+  if (fallback !== void 0 && (value === void 0 || value === null || value === "")) {
+    return fallback;
+  }
+  const text = requireNonEmptyString(value, field);
+  if (!allowed.includes(text)) {
+    fail(400, `${field} must be one of: ${allowed.join(", ")}`);
+  }
+  return text;
+}
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function cloneRecord(value) {
+  if (!isRecord(value)) return {};
+  return { ...value };
+}
+function requireRecord(value, field) {
+  if (!isRecord(value)) {
+    fail(400, `${field} must be an object`);
+  }
+  return { ...value };
+}
+function normalizeOptionalRecord(value, field) {
+  if (value === void 0) return void 0;
+  return requireRecord(value, field);
+}
+function normalizeNullableRecord(value, field) {
+  if (value === void 0) return void 0;
+  if (value === null) return null;
+  return requireRecord(value, field);
+}
+function mergeMetadata(current, updates) {
+  const merged = {
+    ...current,
+    ...cloneRecord(updates)
+  };
+  if (typeof merged.privacyClass !== "string" || merged.privacyClass.trim().length === 0) {
+    merged.privacyClass = "private";
+  }
+  if (merged.privacyClass === "private") {
+    merged.publicContextBlocked = true;
+  }
+  return merged;
+}
+export {
+  GoalsServiceError,
+  cloneRecord,
+  fail,
+  goalsErrorMessage,
+  isRecord,
+  mergeMetadata,
+  normalizeEnumValue,
+  normalizeNullableRecord,
+  normalizeOptionalRecord,
+  normalizeOptionalString,
+  requireAgentId,
+  requireNonEmptyString,
+  requireRecord
+};
+//# sourceMappingURL=goal-normalize.js.map

package/dist/goal-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/goal-normalize.ts"],"sourcesContent":["/**\n * Self-contained input-normalization helpers for the goals back-end.\n *\n * These mirror the small subset of `@elizaos/plugin-personal-assistant`'s\n * `service-normalize` / `service-helpers-misc` helpers that the goal CRUD code\n * actually used. They are reproduced here (rather than imported) so\n * `@elizaos/plugin-goals` carries no dependency on plugin-personal-assistant.\n * `fail` throws a {@link GoalsServiceError} carrying an HTTP status, which the\n * action and route layers map to client-facing responses.\n */\n\nimport type { IAgentRuntime } from \"@elizaos/core\";\n\n/** Error carrying an HTTP status for goals back-end failures. */\nexport class GoalsServiceError extends Error {\n  constructor(\n    public readonly status: number,\n    message: string,\n    public readonly code?: string,\n  ) {\n    super(message);\n    this.name = \"GoalsServiceError\";\n  }\n}\n\nexport function goalsErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function fail(status: number, message: string, code?: string): never {\n  throw new GoalsServiceError(status, message, code);\n}\n\nexport function requireAgentId(runtime: IAgentRuntime): string {\n  const agentId = runtime.agentId;\n  if (typeof agentId !== \"string\" || agentId.trim().length === 0) {\n    fail(500, \"agent runtime is missing agentId\");\n  }\n  return agentId;\n}\n\nexport function requireNonEmptyString(value: unknown, field: string): string {\n  if (typeof value !== \"string\") {\n    fail(400, `${field} must be a string`);\n  }\n  const normalized = value.trim();\n  if (normalized.length === 0) {\n    fail(400, `${field} is required`);\n  }\n  return normalized;\n}\n\nexport function normalizeOptionalString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") return undefined;\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : undefined;\n}\n\nexport function normalizeEnumValue<T extends string>(\n  value: unknown,\n  field: string,\n  allowed: readonly T[],\n  fallback?: T,\n): T {\n  if (\n    fallback !== undefined &&\n    (value === undefined || value === null || value === \"\")\n  ) {\n    return fallback;\n  }\n  const text = requireNonEmptyString(value, field) as T;\n  if (!allowed.includes(text)) {\n    fail(400, `${field} must be one of: ${allowed.join(\", \")}`);\n  }\n  return text;\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === \"object\" && !Array.isArray(value);\n}\n\nexport function cloneRecord(value: unknown): Record<string, unknown> {\n  if (!isRecord(value)) return {};\n  return { ...value };\n}\n\nexport function requireRecord(\n  value: unknown,\n  field: string,\n): Record<string, unknown> {\n  if (!isRecord(value)) {\n    fail(400, `${field} must be an object`);\n  }\n  return { ...value };\n}\n\nexport function normalizeOptionalRecord(\n  value: unknown,\n  field: string,\n): Record<string, unknown> | undefined {\n  if (value === undefined) return undefined;\n  return requireRecord(value, field);\n}\n\nexport function normalizeNullableRecord(\n  value: unknown,\n  field: string,\n): Record<string, unknown> | null | undefined {\n  if (value === undefined) return undefined;\n  if (value === null) return null;\n  return requireRecord(value, field);\n}\n\nexport function mergeMetadata(\n  current: Record<string, unknown>,\n  updates?: Record<string, unknown>,\n): Record<string, unknown> {\n  const merged = {\n    ...current,\n    ...cloneRecord(updates),\n  };\n  if (\n    typeof merged.privacyClass !== \"string\" ||\n    merged.privacyClass.trim().length === 0\n  ) {\n    merged.privacyClass = \"private\";\n  }\n  if (merged.privacyClass === \"private\") {\n    merged.publicContextBlocked = true;\n  }\n  return merged;\n}\n"],"mappings":"AAcO,MAAM,0BAA0B,MAAM;AAAA,EAC3C,YACkB,QAChB,SACgB,MAChB;AACA,UAAM,OAAO;AAJG;AAEA;AAGhB,SAAK,OAAO;AAAA,EACd;AAAA,EANkB;AAAA,EAEA;AAKpB;AAEO,SAAS,kBAAkB,OAAwB;AACxD,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAC9D;AAEO,SAAS,KAAK,QAAgB,SAAiB,MAAsB;AAC1E,QAAM,IAAI,kBAAkB,QAAQ,SAAS,IAAI;AACnD;AAEO,SAAS,eAAe,SAAgC;AAC7D,QAAM,UAAU,QAAQ;AACxB,MAAI,OAAO,YAAY,YAAY,QAAQ,KAAK,EAAE,WAAW,GAAG;AAC9D,SAAK,KAAK,kCAAkC;AAAA,EAC9C;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,OAAgB,OAAuB;AAC3E,MAAI,OAAO,UAAU,UAAU;AAC7B,SAAK,KAAK,GAAG,KAAK,mBAAmB;AAAA,EACvC;AACA,QAAM,aAAa,MAAM,KAAK;AAC9B,MAAI,WAAW,WAAW,GAAG;AAC3B,SAAK,KAAK,GAAG,KAAK,cAAc;AAAA,EAClC;AACA,SAAO;AACT;AAEO,SAAS,wBAAwB,OAAoC;AAC1E,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,aAAa,MAAM,KAAK;AAC9B,SAAO,WAAW,SAAS,IAAI,aAAa;AAC9C;AAEO,SAAS,mBACd,OACA,OACA,SACA,UACG;AACH,MACE,aAAa,WACZ,UAAU,UAAa,UAAU,QAAQ,UAAU,KACpD;AACA,WAAO;AAAA,EACT;AACA,QAAM,OAAO,sBAAsB,OAAO,KAAK;AAC/C,MAAI,CAAC,QAAQ,SAAS,IAAI,GAAG;AAC3B,SAAK,KAAK,GAAG,KAAK,oBAAoB,QAAQ,KAAK,IAAI,CAAC,EAAE;AAAA,EAC5D;AACA,SAAO;AACT;AAEO,SAAS,SAAS,OAAkD;AACzE,SAAO,QAAQ,KAAK,KAAK,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEO,SAAS,YAAY,OAAyC;AACnE,MAAI,CAAC,SAAS,KAAK,EAAG,QAAO,CAAC;AAC9B,SAAO,EAAE,GAAG,MAAM;AACpB;AAEO,SAAS,cACd,OACA,OACyB;AACzB,MAAI,CAAC,SAAS,KAAK,GAAG;AACpB,SAAK,KAAK,GAAG,KAAK,oBAAoB;AAAA,EACxC;AACA,SAAO,EAAE,GAAG,MAAM;AACpB;AAEO,SAAS,wBACd,OACA,OACqC;AACrC,MAAI,UAAU,OAAW,QAAO;AAChC,SAAO,cAAc,OAAO,KAAK;AACnC;AAEO,SAAS,wBACd,OACA,OAC4C;AAC5C,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,UAAU,KAAM,QAAO;AAC3B,SAAO,cAAc,OAAO,KAAK;AACnC;AAEO,SAAS,cACd,SACA,SACyB;AACzB,QAAM,SAAS;AAAA,IACb,GAAG;AAAA,IACH,GAAG,YAAY,OAAO;AAAA,EACxB;AACA,MACE,OAAO,OAAO,iBAAiB,YAC/B,OAAO,aAAa,KAAK,EAAE,WAAW,GACtC;AACA,WAAO,eAAe;AAAA,EACxB;AACA,MAAI,OAAO,iBAAiB,WAAW;AACrC,WAAO,uBAAuB;AAAA,EAChC;AACA,SAAO;AACT;","names":[]}