JuliusBrussee/caveman · error

cave_memory_value_invalid

Error message

cave_memory_value_invalid

What it means

Error "cave_memory_value_invalid" thrown in JuliusBrussee/caveman.

Source

Thrown at packages/agent/src/runtime.ts:3166

        if (used + item.entry.text.length > maxChars) continue;
        hits.push(item.entry.text);
        used += item.entry.text.length;
      }
      return {
        content: [{ type: "text", text: JSON.stringify({ hits, basis: "inferred", namespace: definition.namespace }) }],
        details: { namespace: definition.namespace, recallTokensEstimated: Math.ceil(used / 4) },
      };
    },
  };
  const remember: AgentTool<TSchema> = {
    name: "cave_memory_remember",
    label: "cave_memory_remember",
    description: "Remember one explicit fact in declared local namespace.",
    parameters: Type.Object({ text: Type.String() }),
    executionMode: "sequential",
    async execute(_toolCallId, params) {
      const text = (params as { text: string }).text.trim();
      if (text.length === 0 || text.length > 8_192) throw new Error("cave_memory_value_invalid");
      await mutateMemories(filePath, (entries) => {
        const next: MemoryEntry[] = entries.some((entry) => entry.text === text)
          ? entries
          : [...entries, { text, createdAt: Date.now() }];
        return next.length > 1_000 ? next.slice(next.length - 1_000) : next;
      });
      return {
        content: [{ type: "text", text: JSON.stringify({ remembered: true, basis: "inferred" }) }],
        details: { namespace: definition.namespace },
      };
    },
  };
  return [recall, remember];
}

function tokenize(value: string): string[] {
  return value.toLowerCase().match(/[a-z0-9]{2,}/g) ?? [];
}

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Store a valid memory value: a non-empty string within the configured size limits.

When it happens

Trigger: Thrown at packages/agent/src/runtime.ts:3166 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of JuliusBrussee/caveman@27d5a3981a (2026-08-15). Data as JSON: /api/errors/395332f111d5e0c3. Report an issue: GitHub.