@geminixiang/mama 0.2.0-beta.0 → 0.2.0-beta.1

package/dist/config.d.ts

@@ -1,14 +1,41 @@
 export interface AgentConfig {
-    provider: string;
-    model: string;
+    provider?: string;
+    model?: string;
     thinkingLevel?: string;
     sessionScope?: "thread" | "channel";
     logFormat?: "console" | "json";
     logLevel?: "trace" | "debug" | "info" | "warn" | "error";
     sentryDsn?: string;
 }
-export declare function loadAgentConfig(workspaceDir: string): AgentConfig;
+export declare function loadAgentConfig(stateDir: string): AgentConfig;
+/**
+ * Ensure settings.json exists in stateDir.
+ * If missing, writes a default template and returns it.
+ * If it already exists, loads and returns the current config.
+ */
+export declare function ensureSettingsFile(stateDir: string): {
+    created: boolean;
+    config: AgentConfig;
+};
 export declare function resolveWorkspaceDirFromArgv(args?: string[]): string | undefined;
-export declare function resolveSentryDsn(workspaceDir?: string): string | undefined;
-export declare function saveAgentConfig(workspaceDir: string, config: Partial<AgentConfig>): void;
+export declare function resolveSentryDsn(stateDir: string): string | undefined;
+/**
+ * Externally-visible base URL of the link/OAuth server, e.g.
+ * `https://mama.example.com` (no trailing slash). Read from `MOM_LINK_URL`,
+ * the same env var the bot uses to build `/link?token=...` invitations.
+ *
+ * Used by the link server to build OAuth `redirect_uri` values that must
+ * match the registered callback URL at the identity provider. When unset,
+ * the link server falls back to deriving the base from request headers
+ * (Host / X-Forwarded-*), which is insecure in production because those
+ * headers are client-controlled.
+ */
+export declare function resolveLinkBaseUrl(): string | undefined;
+/**
+ * Resolve Sentry DSN from settings.json, checking both the new stateDir location
+ * (default: ~/.mama/settings.json) and the legacy workspace location for backwards compatibility.
+ * Returns undefined if not found in either location.
+ */
+export declare function resolveSentryDsnFromConfig(stateDir: string, workingDir?: string): string | undefined;
+export declare function saveAgentConfig(stateDir: string, config: AgentConfig): void;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA+BD,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,CAYjE;AAED,wBAAgB,2BAA2B,CAAC,IAAI,WAAwB,GAAG,MAAM,GAAG,SAAS,CAuB5F;AAED,wBAAgB,gBAAgB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS1E;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAwBxF","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\n\nexport interface AgentConfig {\n  provider: string;\n  model: string;\n  thinkingLevel?: string;\n  sessionScope?: \"thread\" | \"channel\";\n  logFormat?: \"console\" | \"json\";\n  logLevel?: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n  sentryDsn?: string;\n}\n\nconst DEFAULTS: AgentConfig = {\n  provider: \"anthropic\",\n  model: \"claude-sonnet-4-5\",\n  thinkingLevel: \"off\",\n  sessionScope: \"thread\",\n  logFormat: \"console\",\n  logLevel: \"info\",\n};\n\nfunction loadRawAgentConfig(workspaceDir: string): Partial<AgentConfig> {\n  const settingsPath = join(workspaceDir, \"settings.json\");\n\n  if (!existsSync(settingsPath)) {\n    return {};\n  }\n\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      return parsed as Partial<AgentConfig>;\n    }\n  } catch {\n    // Ignore parse errors, fall through to env/defaults\n  }\n\n  return {};\n}\n\nexport function loadAgentConfig(workspaceDir: string): AgentConfig {\n  const fromFile = loadRawAgentConfig(workspaceDir);\n\n  const provider = fromFile.provider || process.env.MOM_AI_PROVIDER || DEFAULTS.provider;\n  const model = fromFile.model || process.env.MOM_AI_MODEL || DEFAULTS.model;\n  const thinkingLevel = fromFile.thinkingLevel ?? DEFAULTS.thinkingLevel;\n  const sessionScope = fromFile.sessionScope ?? DEFAULTS.sessionScope;\n  const logFormat = fromFile.logFormat ?? DEFAULTS.logFormat;\n  const logLevel = fromFile.logLevel ?? DEFAULTS.logLevel;\n  const sentryDsn = fromFile.sentryDsn ?? process.env.SENTRY_DSN;\n\n  return { provider, model, thinkingLevel, sessionScope, logFormat, logLevel, sentryDsn };\n}\n\nexport function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)): string | undefined {\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === \"--sandbox\" || arg === \"--download\") {\n      i += 1;\n      continue;\n    }\n\n    if (arg === \"--version\" || arg === \"-v\" || arg === \"-V\") {\n      continue;\n    }\n\n    if (arg.startsWith(\"--sandbox=\") || arg.startsWith(\"--download=\")) {\n      continue;\n    }\n\n    if (!arg.startsWith(\"-\")) {\n      return arg;\n    }\n  }\n\n  return undefined;\n}\n\nexport function resolveSentryDsn(workspaceDir?: string): string | undefined {\n  if (workspaceDir) {\n    const fromFile = loadRawAgentConfig(workspaceDir);\n    if (fromFile.sentryDsn) {\n      return fromFile.sentryDsn;\n    }\n  }\n\n  return process.env.SENTRY_DSN;\n}\n\nexport function saveAgentConfig(workspaceDir: string, config: Partial<AgentConfig>): void {\n  const settingsPath = join(workspaceDir, \"settings.json\");\n\n  let existing: Partial<AgentConfig> = {};\n  if (existsSync(settingsPath)) {\n    try {\n      const raw = readFileSync(settingsPath, \"utf-8\");\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        existing = parsed as Partial<AgentConfig>;\n      }\n    } catch {\n      // Start fresh if file is malformed\n    }\n  }\n\n  const merged = { ...existing, ...config };\n\n  const dir = dirname(settingsPath);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  writeFileSync(settingsPath, JSON.stringify(merged, null, 2), \"utf-8\");\n}\n"]}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAa7D;AAUD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAQ9F;AAED,wBAAgB,2BAA2B,CAAC,IAAI,WAAwB,GAAG,MAAM,GAAG,SAAS,CAuB5F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAgB3E","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\n\nexport interface AgentConfig {\n  provider?: string;\n  model?: string;\n  thinkingLevel?: string;\n  sessionScope?: \"thread\" | \"channel\";\n  logFormat?: \"console\" | \"json\";\n  logLevel?: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n  sentryDsn?: string;\n}\n\nconst SETTINGS_TEMPLATE: AgentConfig = {\n  provider: \"anthropic\",\n  model: \"claude-sonnet-4-6\",\n  thinkingLevel: \"off\",\n  sessionScope: \"thread\",\n  logFormat: \"console\",\n  logLevel: \"info\",\n};\n\nexport function loadAgentConfig(stateDir: string): AgentConfig {\n  const settingsPath = join(stateDir, \"settings.json\");\n  let fromFile: AgentConfig = {};\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      fromFile = parsed as AgentConfig;\n    }\n  } catch {\n    // File missing or malformed\n  }\n  return applyEnvOverrides(fromFile);\n}\n\nfunction applyEnvOverrides(config: AgentConfig): AgentConfig {\n  return {\n    ...config,\n    provider: process.env.MOM_AI_PROVIDER ?? config.provider,\n    model: process.env.MOM_AI_MODEL ?? config.model,\n  };\n}\n\n/**\n * Ensure settings.json exists in stateDir.\n * If missing, writes a default template and returns it.\n * If it already exists, loads and returns the current config.\n */\nexport function ensureSettingsFile(stateDir: string): { created: boolean; config: AgentConfig } {\n  const settingsPath = join(stateDir, \"settings.json\");\n  if (!existsSync(settingsPath)) {\n    mkdirSync(stateDir, { recursive: true });\n    writeFileSync(settingsPath, JSON.stringify(SETTINGS_TEMPLATE, null, 2) + \"\\n\", \"utf-8\");\n    return { created: true, config: applyEnvOverrides(SETTINGS_TEMPLATE) };\n  }\n  return { created: false, config: loadAgentConfig(stateDir) };\n}\n\nexport function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)): string | undefined {\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === \"--sandbox\" || arg === \"--download\") {\n      i += 1;\n      continue;\n    }\n\n    if (arg === \"--version\" || arg === \"-v\" || arg === \"-V\") {\n      continue;\n    }\n\n    if (arg.startsWith(\"--sandbox=\") || arg.startsWith(\"--download=\")) {\n      continue;\n    }\n\n    if (!arg.startsWith(\"-\")) {\n      return arg;\n    }\n  }\n\n  return undefined;\n}\n\nexport function resolveSentryDsn(stateDir: string): string | undefined {\n  return loadAgentConfig(stateDir).sentryDsn;\n}\n\n/**\n * Externally-visible base URL of the link/OAuth server, e.g.\n * `https://mama.example.com` (no trailing slash). Read from `MOM_LINK_URL`,\n * the same env var the bot uses to build `/link?token=...` invitations.\n *\n * Used by the link server to build OAuth `redirect_uri` values that must\n * match the registered callback URL at the identity provider. When unset,\n * the link server falls back to deriving the base from request headers\n * (Host / X-Forwarded-*), which is insecure in production because those\n * headers are client-controlled.\n */\nexport function resolveLinkBaseUrl(): string | undefined {\n  const raw = process.env.MOM_LINK_URL?.trim();\n  if (!raw) return undefined;\n  return raw.replace(/\\/+$/, \"\");\n}\n\n/**\n * Resolve Sentry DSN from settings.json, checking both the new stateDir location\n * (default: ~/.mama/settings.json) and the legacy workspace location for backwards compatibility.\n * Returns undefined if not found in either location.\n */\nexport function resolveSentryDsnFromConfig(\n  stateDir: string,\n  workingDir?: string,\n): string | undefined {\n  // First check the new stateDir location\n  const stateDirDsn = resolveSentryDsn(stateDir);\n  if (stateDirDsn) {\n    return stateDirDsn;\n  }\n  // Fall back to legacy workspace location for backwards compatibility\n  return workingDir ? resolveSentryDsn(workingDir) : undefined;\n}\n\nexport function saveAgentConfig(stateDir: string, config: AgentConfig): void {\n  const settingsPath = join(stateDir, \"settings.json\");\n\n  let existing: AgentConfig = {};\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      existing = parsed as AgentConfig;\n    }\n  } catch {\n    // Start fresh if file is missing or malformed\n  }\n\n  mkdirSync(dirname(settingsPath), { recursive: true });\n  writeFileSync(settingsPath, JSON.stringify({ ...existing, ...config }, null, 2), \"utf-8\");\n}\n"]}

package/dist/config.js

@@ -1,40 +1,48 @@
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
-const DEFAULTS = {
+const SETTINGS_TEMPLATE = {
     provider: "anthropic",
-    model: "claude-sonnet-4-5",
+    model: "claude-sonnet-4-6",
     thinkingLevel: "off",
     sessionScope: "thread",
     logFormat: "console",
     logLevel: "info",
 };
-function loadRawAgentConfig(workspaceDir) {
-    const settingsPath = join(workspaceDir, "settings.json");
-    if (!existsSync(settingsPath)) {
-        return {};
-    }
+export function loadAgentConfig(stateDir) {
+    const settingsPath = join(stateDir, "settings.json");
+    let fromFile = {};
     try {
         const raw = readFileSync(settingsPath, "utf-8");
         const parsed = JSON.parse(raw);
         if (parsed && typeof parsed === "object") {
-            return parsed;
+            fromFile = parsed;
         }
     }
     catch {
-        // Ignore parse errors, fall through to env/defaults
+        // File missing or malformed
     }
-    return {};
+    return applyEnvOverrides(fromFile);
 }
-export function loadAgentConfig(workspaceDir) {
-    const fromFile = loadRawAgentConfig(workspaceDir);
-    const provider = fromFile.provider || process.env.MOM_AI_PROVIDER || DEFAULTS.provider;
-    const model = fromFile.model || process.env.MOM_AI_MODEL || DEFAULTS.model;
-    const thinkingLevel = fromFile.thinkingLevel ?? DEFAULTS.thinkingLevel;
-    const sessionScope = fromFile.sessionScope ?? DEFAULTS.sessionScope;
-    const logFormat = fromFile.logFormat ?? DEFAULTS.logFormat;
-    const logLevel = fromFile.logLevel ?? DEFAULTS.logLevel;
-    const sentryDsn = fromFile.sentryDsn ?? process.env.SENTRY_DSN;
-    return { provider, model, thinkingLevel, sessionScope, logFormat, logLevel, sentryDsn };
+function applyEnvOverrides(config) {
+    return {
+        ...config,
+        provider: process.env.MOM_AI_PROVIDER ?? config.provider,
+        model: process.env.MOM_AI_MODEL ?? config.model,
+    };
+}
+/**
+ * Ensure settings.json exists in stateDir.
+ * If missing, writes a default template and returns it.
+ * If it already exists, loads and returns the current config.
+ */
+export function ensureSettingsFile(stateDir) {
+    const settingsPath = join(stateDir, "settings.json");
+    if (!existsSync(settingsPath)) {
+        mkdirSync(stateDir, { recursive: true });
+        writeFileSync(settingsPath, JSON.stringify(SETTINGS_TEMPLATE, null, 2) + "\n", "utf-8");
+        return { created: true, config: applyEnvOverrides(SETTINGS_TEMPLATE) };
+    }
+    return { created: false, config: loadAgentConfig(stateDir) };
 }
 export function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)) {
     for (let i = 0; i < args.length; i++) {
@@ -55,35 +63,54 @@ export function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)) {
     }
     return undefined;
 }
-export function resolveSentryDsn(workspaceDir) {
-    if (workspaceDir) {
-        const fromFile = loadRawAgentConfig(workspaceDir);
-        if (fromFile.sentryDsn) {
-            return fromFile.sentryDsn;
-        }
+export function resolveSentryDsn(stateDir) {
+    return loadAgentConfig(stateDir).sentryDsn;
+}
+/**
+ * Externally-visible base URL of the link/OAuth server, e.g.
+ * `https://mama.example.com` (no trailing slash). Read from `MOM_LINK_URL`,
+ * the same env var the bot uses to build `/link?token=...` invitations.
+ *
+ * Used by the link server to build OAuth `redirect_uri` values that must
+ * match the registered callback URL at the identity provider. When unset,
+ * the link server falls back to deriving the base from request headers
+ * (Host / X-Forwarded-*), which is insecure in production because those
+ * headers are client-controlled.
+ */
+export function resolveLinkBaseUrl() {
+    const raw = process.env.MOM_LINK_URL?.trim();
+    if (!raw)
+        return undefined;
+    return raw.replace(/\/+$/, "");
+}
+/**
+ * Resolve Sentry DSN from settings.json, checking both the new stateDir location
+ * (default: ~/.mama/settings.json) and the legacy workspace location for backwards compatibility.
+ * Returns undefined if not found in either location.
+ */
+export function resolveSentryDsnFromConfig(stateDir, workingDir) {
+    // First check the new stateDir location
+    const stateDirDsn = resolveSentryDsn(stateDir);
+    if (stateDirDsn) {
+        return stateDirDsn;
     }
-    return process.env.SENTRY_DSN;
+    // Fall back to legacy workspace location for backwards compatibility
+    return workingDir ? resolveSentryDsn(workingDir) : undefined;
 }
-export function saveAgentConfig(workspaceDir, config) {
-    const settingsPath = join(workspaceDir, "settings.json");
+export function saveAgentConfig(stateDir, config) {
+    const settingsPath = join(stateDir, "settings.json");
     let existing = {};
-    if (existsSync(settingsPath)) {
-        try {
-            const raw = readFileSync(settingsPath, "utf-8");
-            const parsed = JSON.parse(raw);
-            if (parsed && typeof parsed === "object") {
-                existing = parsed;
-            }
-        }
-        catch {
-            // Start fresh if file is malformed
+    try {
+        const raw = readFileSync(settingsPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object") {
+            existing = parsed;
         }
     }
-    const merged = { ...existing, ...config };
-    const dir = dirname(settingsPath);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
+    catch {
+        // Start fresh if file is missing or malformed
     }
-    writeFileSync(settingsPath, JSON.stringify(merged, null, 2), "utf-8");
+    mkdirSync(dirname(settingsPath), { recursive: true });
+    writeFileSync(settingsPath, JSON.stringify({ ...existing, ...config }, null, 2), "utf-8");
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAYrC,MAAM,QAAQ,GAAgB;IAC5B,QAAQ,EAAE,WAAW;IACrB,KAAK,EAAE,mBAAmB;IAC1B,aAAa,EAAE,KAAK;IACpB,YAAY,EAAE,QAAQ;IACtB,SAAS,EAAE,SAAS;IACpB,QAAQ,EAAE,MAAM;CACjB,CAAC;AAEF,SAAS,kBAAkB,CAAC,YAAoB;IAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAEzD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,MAA8B,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAElD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACvF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,QAAQ,CAAC,KAAK,CAAC;IAC3E,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC;IACvE,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,YAAY,CAAC;IACpE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;IAC3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IACxD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAE/D,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YAChD,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QAED,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACxD,SAAS;QACX,CAAC;QAED,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClE,SAAS;QACX,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,YAAqB;IACpD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,OAAO,QAAQ,CAAC,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,YAAoB,EAAE,MAA4B;IAChF,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IAEzD,IAAI,QAAQ,GAAyB,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzC,QAAQ,GAAG,MAA8B,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mCAAmC;QACrC,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IAE1C,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\n\nexport interface AgentConfig {\n  provider: string;\n  model: string;\n  thinkingLevel?: string;\n  sessionScope?: \"thread\" | \"channel\";\n  logFormat?: \"console\" | \"json\";\n  logLevel?: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n  sentryDsn?: string;\n}\n\nconst DEFAULTS: AgentConfig = {\n  provider: \"anthropic\",\n  model: \"claude-sonnet-4-5\",\n  thinkingLevel: \"off\",\n  sessionScope: \"thread\",\n  logFormat: \"console\",\n  logLevel: \"info\",\n};\n\nfunction loadRawAgentConfig(workspaceDir: string): Partial<AgentConfig> {\n  const settingsPath = join(workspaceDir, \"settings.json\");\n\n  if (!existsSync(settingsPath)) {\n    return {};\n  }\n\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      return parsed as Partial<AgentConfig>;\n    }\n  } catch {\n    // Ignore parse errors, fall through to env/defaults\n  }\n\n  return {};\n}\n\nexport function loadAgentConfig(workspaceDir: string): AgentConfig {\n  const fromFile = loadRawAgentConfig(workspaceDir);\n\n  const provider = fromFile.provider || process.env.MOM_AI_PROVIDER || DEFAULTS.provider;\n  const model = fromFile.model || process.env.MOM_AI_MODEL || DEFAULTS.model;\n  const thinkingLevel = fromFile.thinkingLevel ?? DEFAULTS.thinkingLevel;\n  const sessionScope = fromFile.sessionScope ?? DEFAULTS.sessionScope;\n  const logFormat = fromFile.logFormat ?? DEFAULTS.logFormat;\n  const logLevel = fromFile.logLevel ?? DEFAULTS.logLevel;\n  const sentryDsn = fromFile.sentryDsn ?? process.env.SENTRY_DSN;\n\n  return { provider, model, thinkingLevel, sessionScope, logFormat, logLevel, sentryDsn };\n}\n\nexport function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)): string | undefined {\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === \"--sandbox\" || arg === \"--download\") {\n      i += 1;\n      continue;\n    }\n\n    if (arg === \"--version\" || arg === \"-v\" || arg === \"-V\") {\n      continue;\n    }\n\n    if (arg.startsWith(\"--sandbox=\") || arg.startsWith(\"--download=\")) {\n      continue;\n    }\n\n    if (!arg.startsWith(\"-\")) {\n      return arg;\n    }\n  }\n\n  return undefined;\n}\n\nexport function resolveSentryDsn(workspaceDir?: string): string | undefined {\n  if (workspaceDir) {\n    const fromFile = loadRawAgentConfig(workspaceDir);\n    if (fromFile.sentryDsn) {\n      return fromFile.sentryDsn;\n    }\n  }\n\n  return process.env.SENTRY_DSN;\n}\n\nexport function saveAgentConfig(workspaceDir: string, config: Partial<AgentConfig>): void {\n  const settingsPath = join(workspaceDir, \"settings.json\");\n\n  let existing: Partial<AgentConfig> = {};\n  if (existsSync(settingsPath)) {\n    try {\n      const raw = readFileSync(settingsPath, \"utf-8\");\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        existing = parsed as Partial<AgentConfig>;\n      }\n    } catch {\n      // Start fresh if file is malformed\n    }\n  }\n\n  const merged = { ...existing, ...config };\n\n  const dir = dirname(settingsPath);\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  writeFileSync(settingsPath, JSON.stringify(merged, null, 2), \"utf-8\");\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { dirname, join } from \"path\";\n\nexport interface AgentConfig {\n  provider?: string;\n  model?: string;\n  thinkingLevel?: string;\n  sessionScope?: \"thread\" | \"channel\";\n  logFormat?: \"console\" | \"json\";\n  logLevel?: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\";\n  sentryDsn?: string;\n}\n\nconst SETTINGS_TEMPLATE: AgentConfig = {\n  provider: \"anthropic\",\n  model: \"claude-sonnet-4-6\",\n  thinkingLevel: \"off\",\n  sessionScope: \"thread\",\n  logFormat: \"console\",\n  logLevel: \"info\",\n};\n\nexport function loadAgentConfig(stateDir: string): AgentConfig {\n  const settingsPath = join(stateDir, \"settings.json\");\n  let fromFile: AgentConfig = {};\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      fromFile = parsed as AgentConfig;\n    }\n  } catch {\n    // File missing or malformed\n  }\n  return applyEnvOverrides(fromFile);\n}\n\nfunction applyEnvOverrides(config: AgentConfig): AgentConfig {\n  return {\n    ...config,\n    provider: process.env.MOM_AI_PROVIDER ?? config.provider,\n    model: process.env.MOM_AI_MODEL ?? config.model,\n  };\n}\n\n/**\n * Ensure settings.json exists in stateDir.\n * If missing, writes a default template and returns it.\n * If it already exists, loads and returns the current config.\n */\nexport function ensureSettingsFile(stateDir: string): { created: boolean; config: AgentConfig } {\n  const settingsPath = join(stateDir, \"settings.json\");\n  if (!existsSync(settingsPath)) {\n    mkdirSync(stateDir, { recursive: true });\n    writeFileSync(settingsPath, JSON.stringify(SETTINGS_TEMPLATE, null, 2) + \"\\n\", \"utf-8\");\n    return { created: true, config: applyEnvOverrides(SETTINGS_TEMPLATE) };\n  }\n  return { created: false, config: loadAgentConfig(stateDir) };\n}\n\nexport function resolveWorkspaceDirFromArgv(args = process.argv.slice(2)): string | undefined {\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i];\n\n    if (arg === \"--sandbox\" || arg === \"--download\") {\n      i += 1;\n      continue;\n    }\n\n    if (arg === \"--version\" || arg === \"-v\" || arg === \"-V\") {\n      continue;\n    }\n\n    if (arg.startsWith(\"--sandbox=\") || arg.startsWith(\"--download=\")) {\n      continue;\n    }\n\n    if (!arg.startsWith(\"-\")) {\n      return arg;\n    }\n  }\n\n  return undefined;\n}\n\nexport function resolveSentryDsn(stateDir: string): string | undefined {\n  return loadAgentConfig(stateDir).sentryDsn;\n}\n\n/**\n * Externally-visible base URL of the link/OAuth server, e.g.\n * `https://mama.example.com` (no trailing slash). Read from `MOM_LINK_URL`,\n * the same env var the bot uses to build `/link?token=...` invitations.\n *\n * Used by the link server to build OAuth `redirect_uri` values that must\n * match the registered callback URL at the identity provider. When unset,\n * the link server falls back to deriving the base from request headers\n * (Host / X-Forwarded-*), which is insecure in production because those\n * headers are client-controlled.\n */\nexport function resolveLinkBaseUrl(): string | undefined {\n  const raw = process.env.MOM_LINK_URL?.trim();\n  if (!raw) return undefined;\n  return raw.replace(/\\/+$/, \"\");\n}\n\n/**\n * Resolve Sentry DSN from settings.json, checking both the new stateDir location\n * (default: ~/.mama/settings.json) and the legacy workspace location for backwards compatibility.\n * Returns undefined if not found in either location.\n */\nexport function resolveSentryDsnFromConfig(\n  stateDir: string,\n  workingDir?: string,\n): string | undefined {\n  // First check the new stateDir location\n  const stateDirDsn = resolveSentryDsn(stateDir);\n  if (stateDirDsn) {\n    return stateDirDsn;\n  }\n  // Fall back to legacy workspace location for backwards compatibility\n  return workingDir ? resolveSentryDsn(workingDir) : undefined;\n}\n\nexport function saveAgentConfig(stateDir: string, config: AgentConfig): void {\n  const settingsPath = join(stateDir, \"settings.json\");\n\n  let existing: AgentConfig = {};\n  try {\n    const raw = readFileSync(settingsPath, \"utf-8\");\n    const parsed = JSON.parse(raw);\n    if (parsed && typeof parsed === \"object\") {\n      existing = parsed as AgentConfig;\n    }\n  } catch {\n    // Start fresh if file is missing or malformed\n  }\n\n  mkdirSync(dirname(settingsPath), { recursive: true });\n  writeFileSync(settingsPath, JSON.stringify({ ...existing, ...config }, null, 2), \"utf-8\");\n}\n"]}

package/dist/context.d.ts

@@ -1,9 +1,9 @@
 /**
  * Context management for mama.
  *
- * Mama uses two files per channel:
- * - context.jsonl: Structured API messages for LLM context (same format as coding-agent sessions)
- * - log.jsonl: Human-readable channel history for grep (no tool results)
+ * Mama uses two data sources per conversation:
+ * - sessions/*.jsonl: Structured session history for the agent context
+ * - log.jsonl: Human-readable conversation history for grep (no tool results)
  *
  * This module provides:
  * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager
@@ -33,16 +33,16 @@ export interface ThreadFilter {
 /**
  * Sync user messages from log.jsonl to SessionManager.
  *
- * This ensures that messages logged while mama wasn't running (channel chatter,
+ * This ensures that messages logged while mama wasn't running (conversation chatter,
  * backfilled messages, messages while busy) are added to the LLM context.
  *
  * @param sessionManager - The SessionManager to sync to
- * @param channelDir - Path to channel directory containing log.jsonl
+ * @param conversationDir - Path to the conversation directory containing log.jsonl
  * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)
  * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)
  * @param threadFilter - Optional thread filter to scope sync to a specific thread
  * @returns Number of messages synced
  */
-export declare function syncLogToSessionManager(sessionManager: SessionManager, channelDir: string, excludeSlackTs?: string, timeRange?: TimeRange, threadFilter?: ThreadFilter): Promise<number>;
+export declare function syncLogToSessionManager(sessionManager: SessionManager, conversationDir: string, excludeSlackTs?: string, timeRange?: TimeRange, threadFilter?: ThreadFilter): Promise<number>;
 export declare function createMamaSettingsManager(_workspaceDir: string): SettingsManager;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,KAAK,cAAc,EAEnB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AASvC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAiBD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,SAAS,EACrB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,MAAM,CAAC,CAyGjB;AASD,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAEhF","sourcesContent":["/**\n * Context management for mama.\n *\n * Mama uses two files per channel:\n * - context.jsonl: Structured API messages for LLM context (same format as coding-agent sessions)\n * - log.jsonl: Human-readable channel history for grep (no tool results)\n *\n * This module provides:\n * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager\n * - createMamaSettingsManager: Creates a SettingsManager backed by workspace settings.json\n */\n\nimport type { UserMessage } from \"@mariozechner/pi-ai\";\nimport {\n  type SessionManager,\n  type SessionMessageEntry,\n  SettingsManager,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\n\n// ============================================================================\n// Sync log.jsonl to SessionManager\n// ============================================================================\n\n/**\n * Time range for filtering log messages\n */\nexport interface TimeRange {\n  start: number; // Unix timestamp in ms\n  end: number;\n}\n\n/**\n * Default number of days to sync when no time range is specified\n */\nconst DEFAULT_SYNC_DAYS = 10;\n\ninterface LogMessage {\n  date?: string;\n  ts?: string;\n  threadTs?: string;\n  user?: string;\n  userName?: string;\n  text?: string;\n  isBot?: boolean;\n}\n\n/**\n * Thread filter for scoping log sync to a specific thread session.\n * When provided, only messages belonging to this thread are synced,\n * preventing cross-thread context contamination.\n */\nexport interface ThreadFilter {\n  /** Filter mode: a specific thread, or top-level messages only for persistent channel/chat sessions */\n  scope?: \"thread\" | \"top-level\";\n  /** The root message timestamp (user's original message ts, derived from sessionKey) */\n  rootTs: string;\n  /** The thread anchor timestamp (bot's first reply ts, used as thread_ts by Slack replies) */\n  threadTs?: string;\n}\n\n/**\n * Sync user messages from log.jsonl to SessionManager.\n *\n * This ensures that messages logged while mama wasn't running (channel chatter,\n * backfilled messages, messages while busy) are added to the LLM context.\n *\n * @param sessionManager - The SessionManager to sync to\n * @param channelDir - Path to channel directory containing log.jsonl\n * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)\n * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)\n * @param threadFilter - Optional thread filter to scope sync to a specific thread\n * @returns Number of messages synced\n */\nexport async function syncLogToSessionManager(\n  sessionManager: SessionManager,\n  channelDir: string,\n  excludeSlackTs?: string,\n  timeRange?: TimeRange,\n  threadFilter?: ThreadFilter,\n): Promise<number> {\n  // Calculate default time range (last 10 days) if not provided\n  const now = Date.now();\n  const defaultStart = now - DEFAULT_SYNC_DAYS * 24 * 60 * 60 * 1000;\n  const range = timeRange ?? { start: defaultStart, end: now };\n  const logFile = join(channelDir, \"log.jsonl\");\n\n  if (!existsSync(logFile)) return 0;\n\n  // Build set of existing timestamps from session entries\n  // We use ts (Slack timestamp) as the unique key instead of message content\n  const existingTimestamps = new Set<string>();\n  for (const entry of sessionManager.getEntries()) {\n    if (entry.type === \"message\") {\n      const msgEntry = entry as SessionMessageEntry;\n      // SessionMessageEntry has a timestamp field (number, Unix ms)\n      if (msgEntry.timestamp) {\n        existingTimestamps.add(msgEntry.timestamp.toString());\n      }\n    }\n  }\n\n  // Read log.jsonl and find user messages not in context\n  const logContent = await readFile(logFile, \"utf-8\");\n  const logLines = logContent.trim().split(\"\\n\").filter(Boolean);\n\n  const newMessages: Array<{ timestamp: number; message: UserMessage }> = [];\n\n  for (const line of logLines) {\n    try {\n      const logMsg: LogMessage = JSON.parse(line);\n\n      const slackTs = logMsg.ts;\n      const date = logMsg.date;\n      if (!slackTs || !date) continue;\n\n      // Skip the current message being processed (will be added via prompt())\n      if (excludeSlackTs && slackTs === excludeSlackTs) continue;\n\n      // Skip bot messages - added through agent flow\n      if (logMsg.isBot) continue;\n\n      // Thread filtering: only sync messages belonging to this session's thread\n      if (threadFilter) {\n        if (threadFilter.scope === \"top-level\") {\n          // Persistent channel/chat sessions should only ingest top-level messages.\n          // This avoids pulling in unrelated replies from other threads.\n          if (logMsg.threadTs) {\n            continue;\n          }\n        } else {\n          if (logMsg.threadTs) {\n            // Thread reply: only include if threadTs matches our thread anchor or rootTs\n            if (\n              logMsg.threadTs !== threadFilter.threadTs &&\n              logMsg.threadTs !== threadFilter.rootTs\n            ) {\n              continue;\n            }\n          } else {\n            // Top-level message: only include if it's this session's root message\n            if (slackTs !== threadFilter.rootTs) {\n              continue;\n            }\n          }\n        }\n      }\n\n      // Skip if this Slack timestamp is already in the session (dedupe by ts, not content)\n      // Convert Slack ts (e.g., \"1234567890.123456\") to Unix ms for comparison\n      const slackTsMs = Math.floor(parseFloat(slackTs) * 1000).toString();\n      if (existingTimestamps.has(slackTsMs)) continue;\n\n      // Build the message text as it would appear in context\n      const threadContext = logMsg.threadTs ? ` [in-thread:${logMsg.threadTs}]` : \"\";\n      const messageText = `[${logMsg.userName || logMsg.user || \"unknown\"}]${threadContext}: ${logMsg.text || \"\"}`;\n\n      const msgTime = new Date(date).getTime() || Date.now();\n\n      // Skip messages outside the time range\n      if (msgTime < range.start || msgTime > range.end) continue;\n\n      const userMessage: UserMessage = {\n        role: \"user\",\n        content: [{ type: \"text\", text: messageText }],\n        timestamp: msgTime,\n      };\n\n      newMessages.push({ timestamp: msgTime, message: userMessage });\n      existingTimestamps.add(slackTsMs); // Track to avoid duplicates within this sync\n    } catch {\n      // Skip malformed lines\n    }\n  }\n\n  if (newMessages.length === 0) return 0;\n\n  // Sort by timestamp and add to session\n  newMessages.sort((a, b) => a.timestamp - b.timestamp);\n\n  for (const { message } of newMessages) {\n    sessionManager.appendMessage(message);\n  }\n\n  return newMessages.length;\n}\n\n// ============================================================================\n// Settings manager for mama\n// ============================================================================\n\n// Mama manages model/provider config through its own config.ts / settings.json.\n// We use an in-memory SettingsManager so AgentSession has valid defaults\n// without interfering with coding-agent's global settings files.\nexport function createMamaSettingsManager(_workspaceDir: string): SettingsManager {\n  return SettingsManager.inMemory();\n}\n"]}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,KAAK,cAAc,EAEnB,eAAe,EAChB,MAAM,+BAA+B,CAAC;AASvC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAiBD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,KAAK,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,MAAM,EACvB,cAAc,CAAC,EAAE,MAAM,EACvB,SAAS,CAAC,EAAE,SAAS,EACrB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,MAAM,CAAC,CAyGjB;AASD,wBAAgB,yBAAyB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAEhF","sourcesContent":["/**\n * Context management for mama.\n *\n * Mama uses two data sources per conversation:\n * - sessions/*.jsonl: Structured session history for the agent context\n * - log.jsonl: Human-readable conversation history for grep (no tool results)\n *\n * This module provides:\n * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager\n * - createMamaSettingsManager: Creates a SettingsManager backed by workspace settings.json\n */\n\nimport type { UserMessage } from \"@mariozechner/pi-ai\";\nimport {\n  type SessionManager,\n  type SessionMessageEntry,\n  SettingsManager,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\n\n// ============================================================================\n// Sync log.jsonl to SessionManager\n// ============================================================================\n\n/**\n * Time range for filtering log messages\n */\nexport interface TimeRange {\n  start: number; // Unix timestamp in ms\n  end: number;\n}\n\n/**\n * Default number of days to sync when no time range is specified\n */\nconst DEFAULT_SYNC_DAYS = 10;\n\ninterface LogMessage {\n  date?: string;\n  ts?: string;\n  threadTs?: string;\n  user?: string;\n  userName?: string;\n  text?: string;\n  isBot?: boolean;\n}\n\n/**\n * Thread filter for scoping log sync to a specific thread session.\n * When provided, only messages belonging to this thread are synced,\n * preventing cross-thread context contamination.\n */\nexport interface ThreadFilter {\n  /** Filter mode: a specific thread, or top-level messages only for persistent channel/chat sessions */\n  scope?: \"thread\" | \"top-level\";\n  /** The root message timestamp (user's original message ts, derived from sessionKey) */\n  rootTs: string;\n  /** The thread anchor timestamp (bot's first reply ts, used as thread_ts by Slack replies) */\n  threadTs?: string;\n}\n\n/**\n * Sync user messages from log.jsonl to SessionManager.\n *\n * This ensures that messages logged while mama wasn't running (conversation chatter,\n * backfilled messages, messages while busy) are added to the LLM context.\n *\n * @param sessionManager - The SessionManager to sync to\n * @param conversationDir - Path to the conversation directory containing log.jsonl\n * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)\n * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)\n * @param threadFilter - Optional thread filter to scope sync to a specific thread\n * @returns Number of messages synced\n */\nexport async function syncLogToSessionManager(\n  sessionManager: SessionManager,\n  conversationDir: string,\n  excludeSlackTs?: string,\n  timeRange?: TimeRange,\n  threadFilter?: ThreadFilter,\n): Promise<number> {\n  // Calculate default time range (last 10 days) if not provided\n  const now = Date.now();\n  const defaultStart = now - DEFAULT_SYNC_DAYS * 24 * 60 * 60 * 1000;\n  const range = timeRange ?? { start: defaultStart, end: now };\n  const logFile = join(conversationDir, \"log.jsonl\");\n\n  if (!existsSync(logFile)) return 0;\n\n  // Build set of existing timestamps from session entries\n  // We use ts (Slack timestamp) as the unique key instead of message content\n  const existingTimestamps = new Set<string>();\n  for (const entry of sessionManager.getEntries()) {\n    if (entry.type === \"message\") {\n      const msgEntry = entry as SessionMessageEntry;\n      // SessionMessageEntry has a timestamp field (number, Unix ms)\n      if (msgEntry.timestamp) {\n        existingTimestamps.add(msgEntry.timestamp.toString());\n      }\n    }\n  }\n\n  // Read log.jsonl and find user messages not in context\n  const logContent = await readFile(logFile, \"utf-8\");\n  const logLines = logContent.trim().split(\"\\n\").filter(Boolean);\n\n  const newMessages: Array<{ timestamp: number; message: UserMessage }> = [];\n\n  for (const line of logLines) {\n    try {\n      const logMsg: LogMessage = JSON.parse(line);\n\n      const slackTs = logMsg.ts;\n      const date = logMsg.date;\n      if (!slackTs || !date) continue;\n\n      // Skip the current message being processed (will be added via prompt())\n      if (excludeSlackTs && slackTs === excludeSlackTs) continue;\n\n      // Skip bot messages - added through agent flow\n      if (logMsg.isBot) continue;\n\n      // Thread filtering: only sync messages belonging to this session's thread\n      if (threadFilter) {\n        if (threadFilter.scope === \"top-level\") {\n          // Persistent top-level sessions should only ingest top-level messages.\n          // This avoids pulling in unrelated replies from other threads.\n          if (logMsg.threadTs) {\n            continue;\n          }\n        } else {\n          if (logMsg.threadTs) {\n            // Thread reply: only include if threadTs matches our thread anchor or rootTs\n            if (\n              logMsg.threadTs !== threadFilter.threadTs &&\n              logMsg.threadTs !== threadFilter.rootTs\n            ) {\n              continue;\n            }\n          } else {\n            // Top-level message: only include if it's this session's root message\n            if (slackTs !== threadFilter.rootTs) {\n              continue;\n            }\n          }\n        }\n      }\n\n      // Skip if this Slack timestamp is already in the session (dedupe by ts, not content)\n      // Convert Slack ts (e.g., \"1234567890.123456\") to Unix ms for comparison\n      const slackTsMs = Math.floor(parseFloat(slackTs) * 1000).toString();\n      if (existingTimestamps.has(slackTsMs)) continue;\n\n      // Build the message text as it would appear in context\n      const threadContext = logMsg.threadTs ? ` [in-thread:${logMsg.threadTs}]` : \"\";\n      const messageText = `[${logMsg.userName || logMsg.user || \"unknown\"}]${threadContext}: ${logMsg.text || \"\"}`;\n\n      const msgTime = new Date(date).getTime() || Date.now();\n\n      // Skip messages outside the time range\n      if (msgTime < range.start || msgTime > range.end) continue;\n\n      const userMessage: UserMessage = {\n        role: \"user\",\n        content: [{ type: \"text\", text: messageText }],\n        timestamp: msgTime,\n      };\n\n      newMessages.push({ timestamp: msgTime, message: userMessage });\n      existingTimestamps.add(slackTsMs); // Track to avoid duplicates within this sync\n    } catch {\n      // Skip malformed lines\n    }\n  }\n\n  if (newMessages.length === 0) return 0;\n\n  // Sort by timestamp and add to session\n  newMessages.sort((a, b) => a.timestamp - b.timestamp);\n\n  for (const { message } of newMessages) {\n    sessionManager.appendMessage(message);\n  }\n\n  return newMessages.length;\n}\n\n// ============================================================================\n// Settings manager for mama\n// ============================================================================\n\n// Mama manages model/provider config through its own config.ts / settings.json.\n// We use an in-memory SettingsManager so AgentSession has valid defaults\n// without interfering with coding-agent's global settings files.\nexport function createMamaSettingsManager(_workspaceDir: string): SettingsManager {\n  return SettingsManager.inMemory();\n}\n"]}

package/dist/context.js

@@ -1,9 +1,9 @@
 /**
  * Context management for mama.
  *
- * Mama uses two files per channel:
- * - context.jsonl: Structured API messages for LLM context (same format as coding-agent sessions)
- * - log.jsonl: Human-readable channel history for grep (no tool results)
+ * Mama uses two data sources per conversation:
+ * - sessions/*.jsonl: Structured session history for the agent context
+ * - log.jsonl: Human-readable conversation history for grep (no tool results)
  *
  * This module provides:
  * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager
@@ -20,22 +20,22 @@ const DEFAULT_SYNC_DAYS = 10;
 /**
  * Sync user messages from log.jsonl to SessionManager.
  *
- * This ensures that messages logged while mama wasn't running (channel chatter,
+ * This ensures that messages logged while mama wasn't running (conversation chatter,
  * backfilled messages, messages while busy) are added to the LLM context.
  *
  * @param sessionManager - The SessionManager to sync to
- * @param channelDir - Path to channel directory containing log.jsonl
+ * @param conversationDir - Path to the conversation directory containing log.jsonl
  * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)
  * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)
  * @param threadFilter - Optional thread filter to scope sync to a specific thread
  * @returns Number of messages synced
  */
-export async function syncLogToSessionManager(sessionManager, channelDir, excludeSlackTs, timeRange, threadFilter) {
+export async function syncLogToSessionManager(sessionManager, conversationDir, excludeSlackTs, timeRange, threadFilter) {
     // Calculate default time range (last 10 days) if not provided
     const now = Date.now();
     const defaultStart = now - DEFAULT_SYNC_DAYS * 24 * 60 * 60 * 1000;
     const range = timeRange ?? { start: defaultStart, end: now };
-    const logFile = join(channelDir, "log.jsonl");
+    const logFile = join(conversationDir, "log.jsonl");
     if (!existsSync(logFile))
         return 0;
     // Build set of existing timestamps from session entries
@@ -70,7 +70,7 @@ export async function syncLogToSessionManager(sessionManager, channelDir, exclud
             // Thread filtering: only sync messages belonging to this session's thread
             if (threadFilter) {
                 if (threadFilter.scope === "top-level") {
-                    // Persistent channel/chat sessions should only ingest top-level messages.
+                    // Persistent top-level sessions should only ingest top-level messages.
                     // This avoids pulling in unrelated replies from other threads.
                     if (logMsg.threadTs) {
                         continue;

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context management for mama.\n *\n * Mama uses two files per channel:\n * - context.jsonl: Structured API messages for LLM context (same format as coding-agent sessions)\n * - log.jsonl: Human-readable channel history for grep (no tool results)\n *\n * This module provides:\n * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager\n * - createMamaSettingsManager: Creates a SettingsManager backed by workspace settings.json\n */\n\nimport type { UserMessage } from \"@mariozechner/pi-ai\";\nimport {\n  type SessionManager,\n  type SessionMessageEntry,\n  SettingsManager,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\n\n// ============================================================================\n// Sync log.jsonl to SessionManager\n// ============================================================================\n\n/**\n * Time range for filtering log messages\n */\nexport interface TimeRange {\n  start: number; // Unix timestamp in ms\n  end: number;\n}\n\n/**\n * Default number of days to sync when no time range is specified\n */\nconst DEFAULT_SYNC_DAYS = 10;\n\ninterface LogMessage {\n  date?: string;\n  ts?: string;\n  threadTs?: string;\n  user?: string;\n  userName?: string;\n  text?: string;\n  isBot?: boolean;\n}\n\n/**\n * Thread filter for scoping log sync to a specific thread session.\n * When provided, only messages belonging to this thread are synced,\n * preventing cross-thread context contamination.\n */\nexport interface ThreadFilter {\n  /** Filter mode: a specific thread, or top-level messages only for persistent channel/chat sessions */\n  scope?: \"thread\" | \"top-level\";\n  /** The root message timestamp (user's original message ts, derived from sessionKey) */\n  rootTs: string;\n  /** The thread anchor timestamp (bot's first reply ts, used as thread_ts by Slack replies) */\n  threadTs?: string;\n}\n\n/**\n * Sync user messages from log.jsonl to SessionManager.\n *\n * This ensures that messages logged while mama wasn't running (channel chatter,\n * backfilled messages, messages while busy) are added to the LLM context.\n *\n * @param sessionManager - The SessionManager to sync to\n * @param channelDir - Path to channel directory containing log.jsonl\n * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)\n * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)\n * @param threadFilter - Optional thread filter to scope sync to a specific thread\n * @returns Number of messages synced\n */\nexport async function syncLogToSessionManager(\n  sessionManager: SessionManager,\n  channelDir: string,\n  excludeSlackTs?: string,\n  timeRange?: TimeRange,\n  threadFilter?: ThreadFilter,\n): Promise<number> {\n  // Calculate default time range (last 10 days) if not provided\n  const now = Date.now();\n  const defaultStart = now - DEFAULT_SYNC_DAYS * 24 * 60 * 60 * 1000;\n  const range = timeRange ?? { start: defaultStart, end: now };\n  const logFile = join(channelDir, \"log.jsonl\");\n\n  if (!existsSync(logFile)) return 0;\n\n  // Build set of existing timestamps from session entries\n  // We use ts (Slack timestamp) as the unique key instead of message content\n  const existingTimestamps = new Set<string>();\n  for (const entry of sessionManager.getEntries()) {\n    if (entry.type === \"message\") {\n      const msgEntry = entry as SessionMessageEntry;\n      // SessionMessageEntry has a timestamp field (number, Unix ms)\n      if (msgEntry.timestamp) {\n        existingTimestamps.add(msgEntry.timestamp.toString());\n      }\n    }\n  }\n\n  // Read log.jsonl and find user messages not in context\n  const logContent = await readFile(logFile, \"utf-8\");\n  const logLines = logContent.trim().split(\"\\n\").filter(Boolean);\n\n  const newMessages: Array<{ timestamp: number; message: UserMessage }> = [];\n\n  for (const line of logLines) {\n    try {\n      const logMsg: LogMessage = JSON.parse(line);\n\n      const slackTs = logMsg.ts;\n      const date = logMsg.date;\n      if (!slackTs || !date) continue;\n\n      // Skip the current message being processed (will be added via prompt())\n      if (excludeSlackTs && slackTs === excludeSlackTs) continue;\n\n      // Skip bot messages - added through agent flow\n      if (logMsg.isBot) continue;\n\n      // Thread filtering: only sync messages belonging to this session's thread\n      if (threadFilter) {\n        if (threadFilter.scope === \"top-level\") {\n          // Persistent channel/chat sessions should only ingest top-level messages.\n          // This avoids pulling in unrelated replies from other threads.\n          if (logMsg.threadTs) {\n            continue;\n          }\n        } else {\n          if (logMsg.threadTs) {\n            // Thread reply: only include if threadTs matches our thread anchor or rootTs\n            if (\n              logMsg.threadTs !== threadFilter.threadTs &&\n              logMsg.threadTs !== threadFilter.rootTs\n            ) {\n              continue;\n            }\n          } else {\n            // Top-level message: only include if it's this session's root message\n            if (slackTs !== threadFilter.rootTs) {\n              continue;\n            }\n          }\n        }\n      }\n\n      // Skip if this Slack timestamp is already in the session (dedupe by ts, not content)\n      // Convert Slack ts (e.g., \"1234567890.123456\") to Unix ms for comparison\n      const slackTsMs = Math.floor(parseFloat(slackTs) * 1000).toString();\n      if (existingTimestamps.has(slackTsMs)) continue;\n\n      // Build the message text as it would appear in context\n      const threadContext = logMsg.threadTs ? ` [in-thread:${logMsg.threadTs}]` : \"\";\n      const messageText = `[${logMsg.userName || logMsg.user || \"unknown\"}]${threadContext}: ${logMsg.text || \"\"}`;\n\n      const msgTime = new Date(date).getTime() || Date.now();\n\n      // Skip messages outside the time range\n      if (msgTime < range.start || msgTime > range.end) continue;\n\n      const userMessage: UserMessage = {\n        role: \"user\",\n        content: [{ type: \"text\", text: messageText }],\n        timestamp: msgTime,\n      };\n\n      newMessages.push({ timestamp: msgTime, message: userMessage });\n      existingTimestamps.add(slackTsMs); // Track to avoid duplicates within this sync\n    } catch {\n      // Skip malformed lines\n    }\n  }\n\n  if (newMessages.length === 0) return 0;\n\n  // Sort by timestamp and add to session\n  newMessages.sort((a, b) => a.timestamp - b.timestamp);\n\n  for (const { message } of newMessages) {\n    sessionManager.appendMessage(message);\n  }\n\n  return newMessages.length;\n}\n\n// ============================================================================\n// Settings manager for mama\n// ============================================================================\n\n// Mama manages model/provider config through its own config.ts / settings.json.\n// We use an in-memory SettingsManager so AgentSession has valid defaults\n// without interfering with coding-agent's global settings files.\nexport function createMamaSettingsManager(_workspaceDir: string): SettingsManager {\n  return SettingsManager.inMemory();\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Context management for mama.\n *\n * Mama uses two data sources per conversation:\n * - sessions/*.jsonl: Structured session history for the agent context\n * - log.jsonl: Human-readable conversation history for grep (no tool results)\n *\n * This module provides:\n * - syncLogToSessionManager: Syncs messages from log.jsonl to SessionManager\n * - createMamaSettingsManager: Creates a SettingsManager backed by workspace settings.json\n */\n\nimport type { UserMessage } from \"@mariozechner/pi-ai\";\nimport {\n  type SessionManager,\n  type SessionMessageEntry,\n  SettingsManager,\n} from \"@mariozechner/pi-coding-agent\";\nimport { existsSync } from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\n\n// ============================================================================\n// Sync log.jsonl to SessionManager\n// ============================================================================\n\n/**\n * Time range for filtering log messages\n */\nexport interface TimeRange {\n  start: number; // Unix timestamp in ms\n  end: number;\n}\n\n/**\n * Default number of days to sync when no time range is specified\n */\nconst DEFAULT_SYNC_DAYS = 10;\n\ninterface LogMessage {\n  date?: string;\n  ts?: string;\n  threadTs?: string;\n  user?: string;\n  userName?: string;\n  text?: string;\n  isBot?: boolean;\n}\n\n/**\n * Thread filter for scoping log sync to a specific thread session.\n * When provided, only messages belonging to this thread are synced,\n * preventing cross-thread context contamination.\n */\nexport interface ThreadFilter {\n  /** Filter mode: a specific thread, or top-level messages only for persistent channel/chat sessions */\n  scope?: \"thread\" | \"top-level\";\n  /** The root message timestamp (user's original message ts, derived from sessionKey) */\n  rootTs: string;\n  /** The thread anchor timestamp (bot's first reply ts, used as thread_ts by Slack replies) */\n  threadTs?: string;\n}\n\n/**\n * Sync user messages from log.jsonl to SessionManager.\n *\n * This ensures that messages logged while mama wasn't running (conversation chatter,\n * backfilled messages, messages while busy) are added to the LLM context.\n *\n * @param sessionManager - The SessionManager to sync to\n * @param conversationDir - Path to the conversation directory containing log.jsonl\n * @param excludeSlackTs - Slack timestamp of current message (will be added via prompt(), not sync)\n * @param timeRange - Optional time range to filter log entries (defaults to last 10 days)\n * @param threadFilter - Optional thread filter to scope sync to a specific thread\n * @returns Number of messages synced\n */\nexport async function syncLogToSessionManager(\n  sessionManager: SessionManager,\n  conversationDir: string,\n  excludeSlackTs?: string,\n  timeRange?: TimeRange,\n  threadFilter?: ThreadFilter,\n): Promise<number> {\n  // Calculate default time range (last 10 days) if not provided\n  const now = Date.now();\n  const defaultStart = now - DEFAULT_SYNC_DAYS * 24 * 60 * 60 * 1000;\n  const range = timeRange ?? { start: defaultStart, end: now };\n  const logFile = join(conversationDir, \"log.jsonl\");\n\n  if (!existsSync(logFile)) return 0;\n\n  // Build set of existing timestamps from session entries\n  // We use ts (Slack timestamp) as the unique key instead of message content\n  const existingTimestamps = new Set<string>();\n  for (const entry of sessionManager.getEntries()) {\n    if (entry.type === \"message\") {\n      const msgEntry = entry as SessionMessageEntry;\n      // SessionMessageEntry has a timestamp field (number, Unix ms)\n      if (msgEntry.timestamp) {\n        existingTimestamps.add(msgEntry.timestamp.toString());\n      }\n    }\n  }\n\n  // Read log.jsonl and find user messages not in context\n  const logContent = await readFile(logFile, \"utf-8\");\n  const logLines = logContent.trim().split(\"\\n\").filter(Boolean);\n\n  const newMessages: Array<{ timestamp: number; message: UserMessage }> = [];\n\n  for (const line of logLines) {\n    try {\n      const logMsg: LogMessage = JSON.parse(line);\n\n      const slackTs = logMsg.ts;\n      const date = logMsg.date;\n      if (!slackTs || !date) continue;\n\n      // Skip the current message being processed (will be added via prompt())\n      if (excludeSlackTs && slackTs === excludeSlackTs) continue;\n\n      // Skip bot messages - added through agent flow\n      if (logMsg.isBot) continue;\n\n      // Thread filtering: only sync messages belonging to this session's thread\n      if (threadFilter) {\n        if (threadFilter.scope === \"top-level\") {\n          // Persistent top-level sessions should only ingest top-level messages.\n          // This avoids pulling in unrelated replies from other threads.\n          if (logMsg.threadTs) {\n            continue;\n          }\n        } else {\n          if (logMsg.threadTs) {\n            // Thread reply: only include if threadTs matches our thread anchor or rootTs\n            if (\n              logMsg.threadTs !== threadFilter.threadTs &&\n              logMsg.threadTs !== threadFilter.rootTs\n            ) {\n              continue;\n            }\n          } else {\n            // Top-level message: only include if it's this session's root message\n            if (slackTs !== threadFilter.rootTs) {\n              continue;\n            }\n          }\n        }\n      }\n\n      // Skip if this Slack timestamp is already in the session (dedupe by ts, not content)\n      // Convert Slack ts (e.g., \"1234567890.123456\") to Unix ms for comparison\n      const slackTsMs = Math.floor(parseFloat(slackTs) * 1000).toString();\n      if (existingTimestamps.has(slackTsMs)) continue;\n\n      // Build the message text as it would appear in context\n      const threadContext = logMsg.threadTs ? ` [in-thread:${logMsg.threadTs}]` : \"\";\n      const messageText = `[${logMsg.userName || logMsg.user || \"unknown\"}]${threadContext}: ${logMsg.text || \"\"}`;\n\n      const msgTime = new Date(date).getTime() || Date.now();\n\n      // Skip messages outside the time range\n      if (msgTime < range.start || msgTime > range.end) continue;\n\n      const userMessage: UserMessage = {\n        role: \"user\",\n        content: [{ type: \"text\", text: messageText }],\n        timestamp: msgTime,\n      };\n\n      newMessages.push({ timestamp: msgTime, message: userMessage });\n      existingTimestamps.add(slackTsMs); // Track to avoid duplicates within this sync\n    } catch {\n      // Skip malformed lines\n    }\n  }\n\n  if (newMessages.length === 0) return 0;\n\n  // Sort by timestamp and add to session\n  newMessages.sort((a, b) => a.timestamp - b.timestamp);\n\n  for (const { message } of newMessages) {\n    sessionManager.appendMessage(message);\n  }\n\n  return newMessages.length;\n}\n\n// ============================================================================\n// Settings manager for mama\n// ============================================================================\n\n// Mama manages model/provider config through its own config.ts / settings.json.\n// We use an in-memory SettingsManager so AgentSession has valid defaults\n// without interfering with coding-agent's global settings files.\nexport function createMamaSettingsManager(_workspaceDir: string): SettingsManager {\n  return SettingsManager.inMemory();\n}\n"]}

package/dist/events.d.ts

@@ -3,12 +3,15 @@ export interface ImmediateEvent {
     type: "immediate";
     platform: string;
     channelId: string;
+    /** Creator userId — routes tool execution to the sandbox's vault selection for that user when fired. */
+    userId?: string;
     text: string;
 }
 export interface OneShotEvent {
     type: "one-shot";
     platform: string;
     channelId: string;
+    userId?: string;
     text: string;
     at: string;
 }
@@ -16,6 +19,7 @@ export interface PeriodicEvent {
     type: "periodic";
     platform: string;
     channelId: string;
+    userId?: string;
     text: string;
     schedule: string;
     timezone: string;

package/dist/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAY,MAAM,cAAc,CAAC;AAOlD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAUD,qBAAa,aAAa;IAStB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IATxB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAA0B;IAE5C,YACU,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAG5C;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAkBZ;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CA2BX;IAED;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,EAAE,CAyBvC;IAED,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;YAcT,UAAU;IA6CxB,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,OAAO;IAkDf,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,aAAa,CAGf","sourcesContent":["import { Cron } from \"croner\";\nimport {\n  existsSync,\n  type FSWatcher,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  watch,\n} from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport type { Bot, BotEvent } from \"./adapter.js\";\nimport * as log from \"./log.js\";\n\n// ============================================================================\n// Event Types\n// ============================================================================\n\nexport interface ImmediateEvent {\n  type: \"immediate\";\n  platform: string;\n  channelId: string;\n  text: string;\n}\n\nexport interface OneShotEvent {\n  type: \"one-shot\";\n  platform: string;\n  channelId: string;\n  text: string;\n  at: string; // ISO 8601 with timezone offset\n}\n\nexport interface PeriodicEvent {\n  type: \"periodic\";\n  platform: string;\n  channelId: string;\n  text: string;\n  schedule: string; // cron syntax\n  timezone: string; // IANA timezone\n}\n\nexport type MamaEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  channelId: string;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null; // ISO 8601\n}\n\n// ============================================================================\n// EventsWatcher\n// ============================================================================\n\nconst DEBOUNCE_MS = 100;\nconst MAX_RETRIES = 3;\nconst RETRY_BASE_MS = 100;\n\nexport class EventsWatcher {\n  private timers: Map<string, NodeJS.Timeout> = new Map();\n  private crons: Map<string, Cron> = new Map();\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n  private startTime: number;\n  private watcher: FSWatcher | null = null;\n  private knownFiles: Set<string> = new Set();\n\n  constructor(\n    private eventsDir: string,\n    private botsByPlatform: Record<string, Bot>,\n  ) {\n    this.startTime = Date.now();\n  }\n\n  /**\n   * Start watching for events. Call this after platform bots are initialized.\n   */\n  start(): void {\n    // Ensure events directory exists\n    if (!existsSync(this.eventsDir)) {\n      mkdirSync(this.eventsDir, { recursive: true });\n    }\n\n    log.logInfo(`Events watcher starting, dir: ${this.eventsDir}`);\n\n    // Scan existing files\n    this.scanExisting();\n\n    // Watch for changes\n    this.watcher = watch(this.eventsDir, (_eventType, filename) => {\n      if (!filename || !filename.endsWith(\".json\")) return;\n      this.debounce(filename, () => this.handleFileChange(filename));\n    });\n\n    log.logInfo(`Events watcher started, tracking ${this.knownFiles.size} files`);\n  }\n\n  /**\n   * Stop watching and cancel all scheduled events.\n   */\n  stop(): void {\n    // Stop fs watcher\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n\n    // Cancel all debounce timers\n    for (const timer of this.debounceTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.debounceTimers.clear();\n\n    // Cancel all scheduled timers\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer);\n    }\n    this.timers.clear();\n\n    // Cancel all cron jobs\n    for (const cron of this.crons.values()) {\n      cron.stop();\n    }\n    this.crons.clear();\n\n    this.knownFiles.clear();\n    log.logInfo(\"Events watcher stopped\");\n  }\n\n  /**\n   * Return all active periodic (cron) events with their next run time.\n   */\n  getPeriodicEvents(): PeriodicEventInfo[] {\n    const results: PeriodicEventInfo[] = [];\n    for (const [filename, cron] of this.crons) {\n      const filePath = join(this.eventsDir, filename);\n      try {\n        const content = readFileSync(filePath, \"utf-8\");\n        const data = this.parseEvent(content, filename);\n        if (!data || data.type !== \"periodic\") {\n          continue;\n        }\n        const next = cron.nextRun();\n        results.push({\n          filename,\n          platform: data.platform,\n          channelId: data.channelId,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n          nextRun: next?.toISOString() ?? null,\n        });\n      } catch {\n        // File may have been deleted or corrupted, skip\n      }\n    }\n    return results;\n  }\n\n  private debounce(filename: string, fn: () => void): void {\n    const existing = this.debounceTimers.get(filename);\n    if (existing) {\n      clearTimeout(existing);\n    }\n    this.debounceTimers.set(\n      filename,\n      setTimeout(() => {\n        this.debounceTimers.delete(filename);\n        fn();\n      }, DEBOUNCE_MS),\n    );\n  }\n\n  private scanExisting(): void {\n    let files: string[];\n    try {\n      files = readdirSync(this.eventsDir).filter((f) => f.endsWith(\".json\"));\n    } catch (err) {\n      log.logWarning(\"Failed to read events directory\", String(err));\n      return;\n    }\n\n    for (const filename of files) {\n      this.handleFile(filename);\n    }\n  }\n\n  private handleFileChange(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n\n    if (!existsSync(filePath)) {\n      // File was deleted\n      this.handleDelete(filename);\n    } else if (this.knownFiles.has(filename)) {\n      // File was modified - cancel existing and re-schedule\n      this.cancelScheduled(filename);\n      this.handleFile(filename);\n    } else {\n      // New file\n      this.handleFile(filename);\n    }\n  }\n\n  private handleDelete(filename: string): void {\n    if (!this.knownFiles.has(filename)) return;\n\n    log.logInfo(`Event file deleted: ${filename}`);\n    this.cancelScheduled(filename);\n    this.knownFiles.delete(filename);\n  }\n\n  private cancelScheduled(filename: string): void {\n    const timer = this.timers.get(filename);\n    if (timer) {\n      clearTimeout(timer);\n      this.timers.delete(filename);\n    }\n\n    const cron = this.crons.get(filename);\n    if (cron) {\n      cron.stop();\n      this.crons.delete(filename);\n    }\n  }\n\n  private async handleFile(filename: string): Promise<void> {\n    const filePath = join(this.eventsDir, filename);\n\n    // Parse with retries\n    let event: MamaEvent | null = null;\n    let lastError: Error | null = null;\n\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        event = this.parseEvent(content, filename);\n        break;\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n        if (i < MAX_RETRIES - 1) {\n          await this.sleep(RETRY_BASE_MS * 2 ** i);\n        }\n      }\n    }\n\n    if (!event) {\n      log.logWarning(\n        `Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`,\n        lastError?.message,\n      );\n      this.deleteFile(filename);\n      return;\n    }\n\n    this.knownFiles.add(filename);\n\n    // Schedule based on type\n    switch (event.type) {\n      case \"immediate\":\n        this.handleImmediate(filename, event);\n        break;\n      case \"one-shot\":\n        this.handleOneShot(filename, event);\n        break;\n      case \"periodic\":\n        this.handlePeriodic(filename, event);\n        break;\n    }\n  }\n\n  private parseEvent(content: string, filename: string): MamaEvent | null {\n    const data = JSON.parse(content);\n\n    if (!data.type || !data.channelId || !data.text) {\n      throw new Error(`Missing required fields (type, channelId, text) in ${filename}`);\n    }\n\n    const platform = this.resolvePlatform(data.platform, filename);\n\n    switch (data.type) {\n      case \"immediate\":\n        return { type: \"immediate\", platform, channelId: data.channelId, text: data.text };\n\n      case \"one-shot\":\n        if (!data.at) {\n          throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n        }\n        return {\n          type: \"one-shot\",\n          platform,\n          channelId: data.channelId,\n          text: data.text,\n          at: data.at,\n        };\n\n      case \"periodic\":\n        if (!data.schedule) {\n          throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n        }\n        if (!data.timezone) {\n          throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n        }\n        return {\n          type: \"periodic\",\n          platform,\n          channelId: data.channelId,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n        };\n\n      default:\n        throw new Error(`Unknown event type '${data.type}' in ${filename}`);\n    }\n  }\n\n  private resolvePlatform(platformValue: unknown, filename: string): string {\n    const availablePlatforms = Object.keys(this.botsByPlatform);\n\n    if (typeof platformValue === \"string\" && platformValue.trim().length > 0) {\n      const platform = platformValue.trim().toLowerCase();\n      if (!this.botsByPlatform[platform]) {\n        throw new Error(\n          `Unknown platform '${platformValue}' in ${filename}. Expected one of: ${availablePlatforms.join(\", \")}`,\n        );\n      }\n      return platform;\n    }\n\n    if (availablePlatforms.length === 1) {\n      return availablePlatforms[0];\n    }\n\n    throw new Error(\n      `Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(\", \")}`,\n    );\n  }\n\n  private handleImmediate(filename: string, event: ImmediateEvent): void {\n    const filePath = join(this.eventsDir, filename);\n\n    // Check if stale (created before harness started)\n    try {\n      const stat = statSync(filePath);\n      if (stat.mtimeMs < this.startTime) {\n        log.logInfo(`Stale immediate event, deleting: ${filename}`);\n        this.deleteFile(filename);\n        return;\n      }\n    } catch {\n      // File may have been deleted\n      return;\n    }\n\n    log.logInfo(`Executing immediate event: ${filename}`);\n    this.execute(filename, event);\n  }\n\n  private handleOneShot(filename: string, event: OneShotEvent): void {\n    const atTime = new Date(event.at).getTime();\n    const now = Date.now();\n\n    if (atTime <= now) {\n      // Past - delete without executing\n      log.logInfo(`One-shot event in the past, deleting: ${filename}`);\n      this.deleteFile(filename);\n      return;\n    }\n\n    const delay = atTime - now;\n    log.logInfo(`Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s`);\n\n    const timer = setTimeout(() => {\n      this.timers.delete(filename);\n      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\n  }\n\n  private handlePeriodic(filename: string, event: PeriodicEvent): void {\n    try {\n      const cron = new Cron(event.schedule, { timezone: event.timezone }, () => {\n        log.logInfo(`Executing periodic event: ${filename}`);\n        this.execute(filename, event, false); // Don't delete periodic events\n      });\n\n      this.crons.set(filename, cron);\n\n      const next = cron.nextRun();\n      log.logInfo(\n        `Scheduled periodic event: ${filename}, next run: ${next?.toISOString() ?? \"unknown\"}`,\n      );\n    } catch (err) {\n      log.logWarning(`Invalid cron schedule for ${filename}: ${event.schedule}`, String(err));\n      this.deleteFile(filename);\n    }\n  }\n\n  private execute(filename: string, event: MamaEvent, deleteAfter: boolean = true): void {\n    // Format the message\n    let scheduleInfo: string;\n    switch (event.type) {\n      case \"immediate\":\n        scheduleInfo = \"immediate\";\n        break;\n      case \"one-shot\":\n        scheduleInfo = event.at;\n        break;\n      case \"periodic\":\n        scheduleInfo = event.schedule;\n        break;\n    }\n\n    const message = `[EVENT:${filename}:${event.type}:${scheduleInfo}] ${event.text}`;\n    const bot = this.botsByPlatform[event.platform];\n\n    if (!bot) {\n      log.logWarning(`No bot configured for event platform '${event.platform}'`, filename);\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n      return;\n    }\n\n    // Create synthetic BotEvent - use channelId as ts for stable session key\n    const syntheticEvent: BotEvent = {\n      type: \"mention\",\n      channel: event.channelId,\n      user: \"EVENT\",\n      text: message,\n      ts: event.channelId, // Stable key: same channel uses same ts for all events\n    };\n\n    // Enqueue for processing\n    const enqueued = bot.enqueueEvent(syntheticEvent);\n\n    if (enqueued && deleteAfter) {\n      // Delete file after successful enqueue (immediate and one-shot)\n      this.deleteFile(filename);\n    } else if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      // Still delete immediate/one-shot even if discarded\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n    }\n  }\n\n  private deleteFile(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n    try {\n      unlinkSync(filePath);\n    } catch (err) {\n      // ENOENT is fine (file already deleted), other errors are warnings\n      if (err instanceof Error && \"code\" in err && err.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(err));\n      }\n    }\n    this.knownFiles.delete(filename);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create an events watcher for all configured platforms.\n */\nexport function createEventsWatcher(\n  workspaceDir: string,\n  botsByPlatform: Record<string, Bot>,\n): EventsWatcher {\n  const eventsDir = join(workspaceDir, \"events\");\n  return new EventsWatcher(eventsDir, botsByPlatform);\n}\n"]}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,GAAG,EAAY,MAAM,cAAc,CAAC;AAOlD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wGAAwG;IACxG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAUD,qBAAa,aAAa;IAStB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IATxB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAA0B;IAE5C,YACU,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAG5C;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAkBZ;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,CA2BX;IAED;;OAEG;IACH,iBAAiB,IAAI,iBAAiB,EAAE,CAyBvC;IAED,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;YAcT,UAAU;IA6CxB,OAAO,CAAC,UAAU;IAwDlB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,aAAa;IAuBrB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,OAAO;IAwDf,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,KAAK;CAGd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAClC,aAAa,CAGf","sourcesContent":["import { Cron } from \"croner\";\nimport {\n  existsSync,\n  type FSWatcher,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  unlinkSync,\n  watch,\n} from \"fs\";\nimport { readFile } from \"fs/promises\";\nimport { join } from \"path\";\nimport type { Bot, BotEvent } from \"./adapter.js\";\nimport * as log from \"./log.js\";\n\n// ============================================================================\n// Event Types\n// ============================================================================\n\nexport interface ImmediateEvent {\n  type: \"immediate\";\n  platform: string;\n  channelId: string;\n  /** Creator userId — routes tool execution to the sandbox's vault selection for that user when fired. */\n  userId?: string;\n  text: string;\n}\n\nexport interface OneShotEvent {\n  type: \"one-shot\";\n  platform: string;\n  channelId: string;\n  userId?: string;\n  text: string;\n  at: string; // ISO 8601 with timezone offset\n}\n\nexport interface PeriodicEvent {\n  type: \"periodic\";\n  platform: string;\n  channelId: string;\n  userId?: string;\n  text: string;\n  schedule: string; // cron syntax\n  timezone: string; // IANA timezone\n}\n\nexport type MamaEvent = ImmediateEvent | OneShotEvent | PeriodicEvent;\n\nexport interface PeriodicEventInfo {\n  filename: string;\n  platform: string;\n  channelId: string;\n  text: string;\n  schedule: string;\n  timezone: string;\n  nextRun: string | null; // ISO 8601\n}\n\n// ============================================================================\n// EventsWatcher\n// ============================================================================\n\nconst DEBOUNCE_MS = 100;\nconst MAX_RETRIES = 3;\nconst RETRY_BASE_MS = 100;\n\nexport class EventsWatcher {\n  private timers: Map<string, NodeJS.Timeout> = new Map();\n  private crons: Map<string, Cron> = new Map();\n  private debounceTimers: Map<string, NodeJS.Timeout> = new Map();\n  private startTime: number;\n  private watcher: FSWatcher | null = null;\n  private knownFiles: Set<string> = new Set();\n\n  constructor(\n    private eventsDir: string,\n    private botsByPlatform: Record<string, Bot>,\n  ) {\n    this.startTime = Date.now();\n  }\n\n  /**\n   * Start watching for events. Call this after platform bots are initialized.\n   */\n  start(): void {\n    // Ensure events directory exists\n    if (!existsSync(this.eventsDir)) {\n      mkdirSync(this.eventsDir, { recursive: true });\n    }\n\n    log.logInfo(`Events watcher starting, dir: ${this.eventsDir}`);\n\n    // Scan existing files\n    this.scanExisting();\n\n    // Watch for changes\n    this.watcher = watch(this.eventsDir, (_eventType, filename) => {\n      if (!filename || !filename.endsWith(\".json\")) return;\n      this.debounce(filename, () => this.handleFileChange(filename));\n    });\n\n    log.logInfo(`Events watcher started, tracking ${this.knownFiles.size} files`);\n  }\n\n  /**\n   * Stop watching and cancel all scheduled events.\n   */\n  stop(): void {\n    // Stop fs watcher\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n\n    // Cancel all debounce timers\n    for (const timer of this.debounceTimers.values()) {\n      clearTimeout(timer);\n    }\n    this.debounceTimers.clear();\n\n    // Cancel all scheduled timers\n    for (const timer of this.timers.values()) {\n      clearTimeout(timer);\n    }\n    this.timers.clear();\n\n    // Cancel all cron jobs\n    for (const cron of this.crons.values()) {\n      cron.stop();\n    }\n    this.crons.clear();\n\n    this.knownFiles.clear();\n    log.logInfo(\"Events watcher stopped\");\n  }\n\n  /**\n   * Return all active periodic (cron) events with their next run time.\n   */\n  getPeriodicEvents(): PeriodicEventInfo[] {\n    const results: PeriodicEventInfo[] = [];\n    for (const [filename, cron] of this.crons) {\n      const filePath = join(this.eventsDir, filename);\n      try {\n        const content = readFileSync(filePath, \"utf-8\");\n        const data = this.parseEvent(content, filename);\n        if (!data || data.type !== \"periodic\") {\n          continue;\n        }\n        const next = cron.nextRun();\n        results.push({\n          filename,\n          platform: data.platform,\n          channelId: data.channelId,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n          nextRun: next?.toISOString() ?? null,\n        });\n      } catch {\n        // File may have been deleted or corrupted, skip\n      }\n    }\n    return results;\n  }\n\n  private debounce(filename: string, fn: () => void): void {\n    const existing = this.debounceTimers.get(filename);\n    if (existing) {\n      clearTimeout(existing);\n    }\n    this.debounceTimers.set(\n      filename,\n      setTimeout(() => {\n        this.debounceTimers.delete(filename);\n        fn();\n      }, DEBOUNCE_MS),\n    );\n  }\n\n  private scanExisting(): void {\n    let files: string[];\n    try {\n      files = readdirSync(this.eventsDir).filter((f) => f.endsWith(\".json\"));\n    } catch (err) {\n      log.logWarning(\"Failed to read events directory\", String(err));\n      return;\n    }\n\n    for (const filename of files) {\n      this.handleFile(filename);\n    }\n  }\n\n  private handleFileChange(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n\n    if (!existsSync(filePath)) {\n      // File was deleted\n      this.handleDelete(filename);\n    } else if (this.knownFiles.has(filename)) {\n      // File was modified - cancel existing and re-schedule\n      this.cancelScheduled(filename);\n      this.handleFile(filename);\n    } else {\n      // New file\n      this.handleFile(filename);\n    }\n  }\n\n  private handleDelete(filename: string): void {\n    if (!this.knownFiles.has(filename)) return;\n\n    log.logInfo(`Event file deleted: ${filename}`);\n    this.cancelScheduled(filename);\n    this.knownFiles.delete(filename);\n  }\n\n  private cancelScheduled(filename: string): void {\n    const timer = this.timers.get(filename);\n    if (timer) {\n      clearTimeout(timer);\n      this.timers.delete(filename);\n    }\n\n    const cron = this.crons.get(filename);\n    if (cron) {\n      cron.stop();\n      this.crons.delete(filename);\n    }\n  }\n\n  private async handleFile(filename: string): Promise<void> {\n    const filePath = join(this.eventsDir, filename);\n\n    // Parse with retries\n    let event: MamaEvent | null = null;\n    let lastError: Error | null = null;\n\n    for (let i = 0; i < MAX_RETRIES; i++) {\n      try {\n        const content = await readFile(filePath, \"utf-8\");\n        event = this.parseEvent(content, filename);\n        break;\n      } catch (err) {\n        lastError = err instanceof Error ? err : new Error(String(err));\n        if (i < MAX_RETRIES - 1) {\n          await this.sleep(RETRY_BASE_MS * 2 ** i);\n        }\n      }\n    }\n\n    if (!event) {\n      log.logWarning(\n        `Failed to parse event file after ${MAX_RETRIES} retries: ${filename}`,\n        lastError?.message,\n      );\n      this.deleteFile(filename);\n      return;\n    }\n\n    this.knownFiles.add(filename);\n\n    // Schedule based on type\n    switch (event.type) {\n      case \"immediate\":\n        this.handleImmediate(filename, event);\n        break;\n      case \"one-shot\":\n        this.handleOneShot(filename, event);\n        break;\n      case \"periodic\":\n        this.handlePeriodic(filename, event);\n        break;\n    }\n  }\n\n  private parseEvent(content: string, filename: string): MamaEvent | null {\n    const data = JSON.parse(content);\n\n    if (!data.type || !data.channelId || !data.text) {\n      throw new Error(`Missing required fields (type, channelId, text) in ${filename}`);\n    }\n\n    const platform = this.resolvePlatform(data.platform, filename);\n\n    const userId = typeof data.userId === \"string\" ? data.userId : undefined;\n\n    switch (data.type) {\n      case \"immediate\":\n        return {\n          type: \"immediate\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n        };\n\n      case \"one-shot\":\n        if (!data.at) {\n          throw new Error(`Missing 'at' field for one-shot event in ${filename}`);\n        }\n        return {\n          type: \"one-shot\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n          at: data.at,\n        };\n\n      case \"periodic\":\n        if (!data.schedule) {\n          throw new Error(`Missing 'schedule' field for periodic event in ${filename}`);\n        }\n        if (!data.timezone) {\n          throw new Error(`Missing 'timezone' field for periodic event in ${filename}`);\n        }\n        return {\n          type: \"periodic\",\n          platform,\n          channelId: data.channelId,\n          userId,\n          text: data.text,\n          schedule: data.schedule,\n          timezone: data.timezone,\n        };\n\n      default:\n        throw new Error(`Unknown event type '${data.type}' in ${filename}`);\n    }\n  }\n\n  private resolvePlatform(platformValue: unknown, filename: string): string {\n    const availablePlatforms = Object.keys(this.botsByPlatform);\n\n    if (typeof platformValue === \"string\" && platformValue.trim().length > 0) {\n      const platform = platformValue.trim().toLowerCase();\n      if (!this.botsByPlatform[platform]) {\n        throw new Error(\n          `Unknown platform '${platformValue}' in ${filename}. Expected one of: ${availablePlatforms.join(\", \")}`,\n        );\n      }\n      return platform;\n    }\n\n    if (availablePlatforms.length === 1) {\n      return availablePlatforms[0];\n    }\n\n    throw new Error(\n      `Missing required field 'platform' in ${filename}. Available platforms: ${availablePlatforms.join(\", \")}`,\n    );\n  }\n\n  private handleImmediate(filename: string, event: ImmediateEvent): void {\n    const filePath = join(this.eventsDir, filename);\n\n    // Check if stale (created before harness started)\n    try {\n      const stat = statSync(filePath);\n      if (stat.mtimeMs < this.startTime) {\n        log.logInfo(`Stale immediate event, deleting: ${filename}`);\n        this.deleteFile(filename);\n        return;\n      }\n    } catch {\n      // File may have been deleted\n      return;\n    }\n\n    log.logInfo(`Executing immediate event: ${filename}`);\n    this.execute(filename, event);\n  }\n\n  private handleOneShot(filename: string, event: OneShotEvent): void {\n    const atTime = new Date(event.at).getTime();\n    const now = Date.now();\n\n    if (atTime <= now) {\n      // Past - delete without executing\n      log.logInfo(`One-shot event in the past, deleting: ${filename}`);\n      this.deleteFile(filename);\n      return;\n    }\n\n    const delay = atTime - now;\n    log.logInfo(`Scheduling one-shot event: ${filename} in ${Math.round(delay / 1000)}s`);\n\n    const timer = setTimeout(() => {\n      this.timers.delete(filename);\n      log.logInfo(`Executing one-shot event: ${filename}`);\n      this.execute(filename, event);\n    }, delay);\n\n    this.timers.set(filename, timer);\n  }\n\n  private handlePeriodic(filename: string, event: PeriodicEvent): void {\n    try {\n      const cron = new Cron(event.schedule, { timezone: event.timezone }, () => {\n        log.logInfo(`Executing periodic event: ${filename}`);\n        this.execute(filename, event, false); // Don't delete periodic events\n      });\n\n      this.crons.set(filename, cron);\n\n      const next = cron.nextRun();\n      log.logInfo(\n        `Scheduled periodic event: ${filename}, next run: ${next?.toISOString() ?? \"unknown\"}`,\n      );\n    } catch (err) {\n      log.logWarning(`Invalid cron schedule for ${filename}: ${event.schedule}`, String(err));\n      this.deleteFile(filename);\n    }\n  }\n\n  private execute(filename: string, event: MamaEvent, deleteAfter: boolean = true): void {\n    // Format the message\n    let scheduleInfo: string;\n    switch (event.type) {\n      case \"immediate\":\n        scheduleInfo = \"immediate\";\n        break;\n      case \"one-shot\":\n        scheduleInfo = event.at;\n        break;\n      case \"periodic\":\n        scheduleInfo = event.schedule;\n        break;\n    }\n\n    const message = `[EVENT:${filename}:${event.type}:${scheduleInfo}] ${event.text}`;\n    const bot = this.botsByPlatform[event.platform];\n\n    if (!bot) {\n      log.logWarning(`No bot configured for event platform '${event.platform}'`, filename);\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n      return;\n    }\n\n    // Create synthetic BotEvent. Keep a stable channel session key so recurring\n    // reminders share context, but use a unique synthetic message id because\n    // some adapters treat `ts`/message id as a reply target.\n    // `user` falls back to \"EVENT\" when the event file omits a creator; vault\n    // routing then resolves to an empty auto-created entry or shared container vault\n    // with no credentials configured yet.\n    const syntheticEvent: BotEvent = {\n      type: \"mention\",\n      conversationId: event.channelId,\n      user: event.userId ?? \"EVENT\",\n      text: message,\n      ts: `event:${filename}`,\n      sessionKey: event.channelId,\n    };\n\n    // Enqueue for processing\n    const enqueued = bot.enqueueEvent(syntheticEvent);\n\n    if (enqueued && deleteAfter) {\n      // Delete file after successful enqueue (immediate and one-shot)\n      this.deleteFile(filename);\n    } else if (!enqueued) {\n      log.logWarning(`Event queue full, discarded: ${filename}`);\n      // Still delete immediate/one-shot even if discarded\n      if (deleteAfter) {\n        this.deleteFile(filename);\n      }\n    }\n  }\n\n  private deleteFile(filename: string): void {\n    const filePath = join(this.eventsDir, filename);\n    try {\n      unlinkSync(filePath);\n    } catch (err) {\n      // ENOENT is fine (file already deleted), other errors are warnings\n      if (err instanceof Error && \"code\" in err && err.code !== \"ENOENT\") {\n        log.logWarning(`Failed to delete event file: ${filename}`, String(err));\n      }\n    }\n    this.knownFiles.delete(filename);\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n\n/**\n * Create an events watcher for all configured platforms.\n */\nexport function createEventsWatcher(\n  workspaceDir: string,\n  botsByPlatform: Record<string, Bot>,\n): EventsWatcher {\n  const eventsDir = join(workspaceDir, \"events\");\n  return new EventsWatcher(eventsDir, botsByPlatform);\n}\n"]}